新增擷取

瞭解新增 Extract 的先決條件和考量。

在您開始新增 Extract 之前，請確定已設定下列設定值：

現在，您已準備好為部署新增 Extract。

先前有 Extract 歷程檔時建立 Extract 的考量

擷取資訊畫面

登入 Microservices 首頁之後，請按一下「建立」資料欄中的 + 登入，以開啟新增擷取精靈。

在擷取資訊畫面上，選取「擷取」類型。視資料庫平台而定，可用的擷取類型可能是整合式擷取、變更資料擷取擷取及初始載入擷取。

如果您需要設定 Oracle AI Database 的下游擷取，請啟用下游擷取切換開關。

選取要建立的 Extract 類型，並指定下列各項：

按下一步。

註冊擷取畫面 - PostgreSQL 和 Yugabyte 資料庫

注意：必須註冊 Oracle GoldenGate Extract for Oracle、不同的 PostgreSQL Flavors 和 Yugabyte Database。不過，在新增 Extract 時，登錄 Extract 的組態選項會顯示在不同的畫面上。

注意：另請參閱 PGOUTPUT Plugin 類型的準則和限制。

在註冊擷取畫面上，設定下列選項，然後按一下註冊：

擷取註冊成功後，按一下下一步。

顯示擷取已順利註冊的訊息。

按下一步。

從管理從屬端註冊 PostgreSQL 和 Yugabyte 資料庫的 Extract

PostgreSQL 的 Extract 必須在資料庫中註冊，並被授予保留的複製槽位。複製插槽是透過資料庫組態設定值 max_replication_slots 配置，而且可以如資料庫組態中所述來設定。

請依照下列指示註冊 Extract。擷取註冊必須在建立 Extract 之前完成。如需詳細資訊，請參閱 Oracle GoldenGate 命令行介面參照中的 REGISTER EXTRACT 。

  1. 連線至部署，然後連線至來源資料庫的證明資料別名。

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. 註冊 Extract，此 Extract 會在內部建立 Extract 的複製槽位。擷取名稱不得超過 8 個英數字元。

    REGISTER EXTRACT *extname*

    若要使用 pgoutput Plugin 明確註冊 Extract，您必須指定 pgoutput Plugin 類型：

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

您也可以從 Oracle GoldenGate MA Web 介面註冊 Extract。請參閱新增擷取。

PGOUTPUT 外掛程式類型的準則和限制

設定 PGOUTPUT 外掛程式類型的準則

設定 PostgreSQL 的外掛程式類型時，請遵循下列準則：

限制

選取 PostgreSQL 的 Plugin 類型時，會套用下列限制：

擷取選項畫面

注意：此畫面提供註冊 Extract for Oracle AI Database 的選項。如果您正在新增 PostgreSQL 的 Extract，則會在註冊擷取畫面上完成 Extract 註冊。

在擷取選項畫面中設定下列設定值：

從管理用戶端登錄 Oracle 的擷取

請依照下列指示註冊 Extract。擷取註冊必須在建立 Extract 之前完成。

確定您使用 DBLOGIN 命令與資料庫連線。

如需詳細資訊，請參閱 Oracle GoldenGate 命令行介面參照中的 [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3)。

  1. 使用「管理從屬端」連線至部署，然後連線至來源資料庫的證明資料別名。

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    執行 CONNECT 命令時，命令提示字元會從「未連線」變更為「https://servername:port deployment_name」，如下列範例所示：

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. 使用 DBLOGIN 命令連線至資料庫：

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. 登錄 Extract。Extract 名稱不能超過 8 個文數字字元。

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

您也可以在從 Oracle GoldenGate MA Web 介面建立 Extract 時，於背景註冊 Extract。請參閱新增擷取以取得詳細資料。

下游擷取畫面

僅適用於 Oracle。

如果您在擷取資訊畫面上選取下游擷取，則會顯示下游擷取選項畫面。使用此畫面設定順流 Extract 的順流探勘資料庫連線。

注意：使用 ADG 進行下游擷取不支援每一 PDB 擷取。

按下一步。

受管理選項畫面

在受管理選項畫面上，設定 Extract 處理作業的自動啟動和自動重新啟動選項。下表提供這些選項：

下表提供這些選項：

選項 說明
設定檔名稱

提供自動啟動和自動啟動設定檔的名稱。您可以選取預設或自訂選項。

若您已建立設定檔，則您也可選取該設定檔。如果您選取「自訂」選項，則您可以從此區段本身設定新資料檔。
對於部署狀況具有重大影響

(僅限 Oracle) 如果設定檔對建置狀況至關重要，請啟用此選項。

備註：

此選項只有在建立 Extract 或 Replicat 時才會顯示，而不是在「設定檔」頁面中設定受管理處理作業時才會顯示。

自動啟動 啟用自動啟動處理。
啟動延遲 啟動處理作業前應等待的時間 (秒)
自動重新啟動 設定重新開始處理 (若終止) 的方式
重試次數上限 指定嘗試啟動處理的重試次數上限
重試延遲 嘗試啟動處理的延遲時間
重試時段 嘗試啟動處理的持續時間間隔
失敗時重新啟動條件 若為 true 作業只會在失敗時重新啟動.
重試次數用完後停用作業 若為 true，則會在用盡所有重新啟動處理作業的嘗試後停用作業。

按下一步。

擷取參數檔畫面

在參數檔畫面中，您可以編輯文字區域中的參數檔，列出想要擷取的表格詳細資訊。以下是 Extract 參數檔範例：

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

按一下建立並執行以建立並開始擷取。如果您選取建立，則會建立擷取，但您需要使用擷取選項來開始擷取。

您可以返回「管理服務」首頁或「擷取」頁面，其中列出所有建立的 Extract。

建立要擷取的參數檔

請遵循這些指示來建立「摘錄」的參數檔。

  1. (僅限 MySQL) 在 Windows 伺服器和 Linux 伺服器 (針對低於 23.10.x 的 OGG 版本) 上執行 Oracle GoldenGate for MySQL 時 (位於遠端主機上) 資料庫伺服器，確保其時區相同，如果不相同，請使用 Extract 中的 SETENV(TZ) 參數，並將其設為資料庫伺服器的時區。

    如需 TZ 格式及更多詳細資訊，請參閱 Parameters and Functions Reference Guide 中的 SETENV 參數。

    請參閱下列連結以供參考：

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. 在來源系統上，發出下列命令：

    EDIT PARAMS extract_name

    其中：

    extract_name 是您使用 ADD EXTRACT 命令建立的 Extract 名稱，如果您在建立群組時定義了替代位置，則為參數檔的完整名稱。

  3. 依下表所示的順序輸入參數，對每個參數陳述式開始一行。部分參數僅適用於特定組態。

    參數 說明
    EXTRACT group
    • 群組是您使用 ADD EXTRACT 命令建立的 Extract 群組名稱。
    		將 Extract 設定為含有檢查點的線上處理。
    [, USERIDALIAS alias options ] 請參閱 [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05)，以指定資料庫證明資料。
    ENCRYPTTRAIL algorithm 加密此項目之後指定的所有歷程檔。
    SOURCECATALOG 指定 Oracle 多雲端用戶容器資料庫或 SEQUENCE 敘述句中的預設容器。啟用兩部分名稱 (schema.object)，這些資料庫需要另外三個部分名稱。您可以使用此參數的多個執行處理，為不同的 TABLE 或 SEQUENCE 參數集指定不同的預設容器或目錄。
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    指定物件的完整名稱，或指定多個物件的完整萬用字元規格。如果資料庫是 Oracle 多雲端用戶容器資料庫，除非使用 SOURCECATALOG，否則物件名稱必須包含容器或目錄的名稱。

    • schema 是綱要名稱或一組萬用字元的綱要。

    • object 是表格名稱或一組萬用字元表格。

    • library 是 IBM i 程式庫名稱或一組萬用字元的程式庫。

    • file 是 IBM i 實體檔案名稱或一組萬用字元的實體檔案。

    • member 是 IBM i 實體檔案成員名稱或一組萬用字元的成員名稱。使用 IBM i 原生名稱格式 (具有選擇性成員的程式庫 / 檔案) 時，唯一有效的萬用字元是至少包含一個有效字元的名稱，後面接著一個星號 (*) 或 *ALL，其符合任何名稱。

    備註：

    成員名稱是選擇性的，如果需要在歷程檔中寫入成員名稱作為物件名稱的一部分，則必須提供成員名稱。如果沒有成員名稱，實體檔案中的所有成員都會隱含地合併為歷程檔中的單一物件。

    請參閱在 Oracle GoldenGate 輸入中指定物件名稱準則，以在參數檔中指定物件名稱。

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 可與另一個參數搭配使用，以將特定物件從關聯之 TABLE 敘述句中的萬用字元設定排除。

  4. 輸入 Oracle GoldenGate 參數中所列的任何適當選擇性 Extract 參數。

  5. 儲存並關閉參數檔。

下列範例 Extract 參數檔說明 Extract 的各種組態參數和選項：

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

擷取的其他參數選項

瞭解擷取組態可能需要的其他參數。

Extract 使用探勘資料庫中的資料庫日誌探勘伺服器來探勘來源資料庫的重做串流。您可以使用 TRANLOGOPTIONS 參數搭配 Extract 參數檔中的 INTEGRATEDPARAMS 選項，來設定日誌探勘伺服器特定的參數。

注意：如需這些參數的詳細資訊和使用指南，請參閱 Oracle AI Database PL/SQL Packages and Types Reference 中的 "DBMS_CAPTURE_ADM" 小節。

您可以使用 INTEGRATEDPARAMS 設定下列參數：

請參閱管理伺服器資源。