新增分送路徑

分送路徑會將資料異動從 Extract 傳送至 Replicat。

使用分送路徑的時機

當您需要在分散式部署環境中複製資料時,請使用「分送路徑」。「分送路徑」會將資料異動從 Extract 傳送至 Replicat。建立和執行「分送路徑」會自動在目標部署的「接收者」服務中建立「接收者路徑」。接收端路徑會從來源部署的分配服務接收資料異動。

來源部署是您建立「分送路徑」的部署。目標部署是將擷取的資料和歷程檔傳送到的部署。

開始之前

請確定為要連線的每個部署建立 GoldenGate 連線,然後將它們指派給路徑來源的部署。例如,在其中建立「分送路徑」或目標起始的「接收者路徑」的部署。

否則,在啟用 IAM 的部署中,將會發生錯誤:

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

建立並執行分配路徑 (26ai)

如果使用 GoldenGate 證明資料存放區,您必須新增來源部署用來連線至目標部署的使用者。如果使用 IAM 證明資料存放區,請略過這些步驟。

  1. 目標建置主控台中,登入,然後從左側導覽存取使用者管理頁面。

  2. 選取新增使用者,然後完成下列作業:

    • 認證者:從下拉式清單中選取密碼

    • 角色:從下拉式清單中選取運算子

    • 使用者名稱:輸入您的使用者名稱。

    • 密碼驗證密碼:輸入與此使用者關聯的密碼。

  3. 開啟來源建置主控台,然後瀏覽至左側導覽功能表中的路徑連線

  4. 選取新增路徑連線,然後完成下列作業:

    • 證明資料別名:輸入別名。

    • 使用者 ID :輸入在步驟 2 中建立的使用者名稱。

    • 密碼驗證密碼:從步驟 2 輸入與此使用者關聯的密碼。

  5. 選取提交

在 GoldenGate 26ai 中新增分送路徑:

  1. 在 OCI GoldenGate 部署主控台首頁上,選取「分送路徑」的建立 (加上圖示)。

  2. 在「新增路徑」面板中,視需要完成路徑資訊欄位,然後選取下一步

    1. 輸入路徑名稱,輸入路徑的名稱。

    2. (選擇性) 輸入描述,以描述此路徑的用途,並列出相關的「擷取」和「複製」。

  3. 來源選項頁面上,視需要輸入欄位,然後選取下一步

    • 從下拉式清單中選取來源擷取

    • 輸入歷程檔名稱

    • 如果您預期「歷程檔」位於預設以外的位置,請輸入子目錄

    • 產生的來源 URI 會根據提供的資訊自動產生。視需要選取「編輯」(鉛筆圖示) 來修改 URI。

    • 選取一個加密設定檔。如果未建立加密設定檔,預設會選取本機公事包設定檔。

    • 針對開始,選取資料處理的起點:

      • 日誌中的位置

      • Now

      • 自訂時間

      • CSN (當時或之後)

    • 輸入序號

    • 輸入 RBA 沖銷

  4. 目標選項頁面上,視需要完成欄位,然後選取下一步

    • 選取目標協定

      • ws

      • wss

      • ogg

    • (選用) 啟用啟用反向代理主機以使用反向代理主機連線至目標。

    • 目標類型 (僅限「目標協定」)

      • 主管

      • 收集器

      • 接收端服務

    • 輸入目標主機

    • 輸入目標建置的連接埠號碼

    • 輸入目標歷程檔的歷程檔名稱

    • 如果「歷程檔」位於預設位置以外的地方,請輸入子目錄

    • 輸入歷程檔大小上限。

    • 選取用來將「歷程檔」傳送至目標部署的目標加密演算法

      • NONE

      • AES128

      • AES192

      • AES256

    • 啟用變更加密以允許變更加密演算法。

    • 產生的目標 URI 會根據提供的資訊自動產生。視需要選取「編輯」(鉛筆圖示) 來修改 URI。

    • 選取目標認證方法 (僅限 wss 目標協定)

      • UserID 別名

        注意:從 GoldenGate 證明資料存放區部署連線至啟用 IAM 的部署時,請使用 IAM 使用者建立證明資料。確定使用者存在於 IAM 識別分割中。

      • OAuth

        注意:在啟用 IAM 的租用戶中,連線至另一個啟用 IAM 的部署時,請選取 OAuth。

      • 憑證

    • 選取一個網域

    • 選取具有 Oracle GoldenGate 使用者 ID 和密碼的別名

    • 選取目標類型

      • GGFormat (預設)

      • SQL

      • XML

      • 純文字

  5. 進階選項頁面上,視需要完成欄位,然後選取下一步

    • 啟用啟用網路壓縮,以設定壓縮臨界值

    • 選取 EOF 延遲

      注意:在 Linux 平台上,可以保留預設值。不過,在非 Linux 平台上,您可能需要針對高頻寬、高延遲網路,或針對具有服務品質 (QoS) 設定 (DSCP 與服務時間 (ToS)) 的網路調整這項設定

    • 選取檢查點頻率,即可設定檢查點所採取之路徑的頻率 (秒)。

    • 輸入 TCP 清除位元組 (位元組)。

    • 輸入 TCP 排清秒數 (秒)。

    • 選取差異化服務代碼點 ( DSCP)。

    • 選取「服務類型」( TOS)。

    • 啟用 TCP_NODELAY ,以避免在使用 Nagle 選項時出現延遲。

    • 啟用快速確認,即可在接收資料後傳送快速確認。

    • 啟用 TCP_CORK ,以允許使用 Nagle 的演算法軟木選項。

    • 輸入系統傳送緩衝區大小,以設定流量控制的傳送緩衝區大小值。

    • 輸入系統接收緩衝區大小,以設定流量控制之接收緩衝區大小的值。

    • 設定持續作用的逾時。

  6. 篩選選項頁面上,視需要完成下列欄位,然後選取下一步

    • 輸入規則名稱

    • 選取規則動作

      • 排除會根據選取的選項篩選出資料。

      • 包含包含以指定選項為基礎的資料。

    • 選取篩選類型

      • 物件類型:從下列三種物件類型中選取:DML、DDL 和程序

      • 物件名稱:選取此選項即可提供現有的物件名稱。3 部分命名慣例取決於您是否使用 CDB。對於 CDB,您必須使用 3 個部分的命名慣例,否則必須使用 2 個部分的慣例。3 個部分的慣例包括 containerschemaobject。2 個部分的慣例包括 schemaobject name

      • 程序功能名稱:選取此選項即可根據現有的程序功能名稱進行篩選。

      • 以資料欄為基礎:如果您選取此選項,系統會顯示選項,讓您輸入要套用規則的表格和資料欄名稱。您可以使用具有 LT、GT、EQ、LE、GE、NE 條件的資料欄值進行篩選。您也可以指定要在影像之前或影像之後的篩選資料。

      • 標記:選取此選項可根據標記設定篩選。

      • 區塊 ID :顯示資料庫分區的組態詳細資訊,但無法編輯詳細資訊。

    • 選取否定,以否定任何現有規則。

    • 選取新增來新增規則。

  7. 受管理選項頁面上,視需要完成選擇性欄位。

    • 啟用重要,以設定此路徑的高可用性。

    • 啟用自動重新啟動以調整自動重新啟動重試和自動重新啟動延遲選項。

  8. 選取建立並執行,即可立即執行路徑。選取建立,以在稍後手動執行路徑。

您可返回「首頁」,檢視「路徑」處理程序的狀態。

建立並執行分送路徑 (21c)

新增允許來源部署 (建立此路徑的部署) 連線至目標部署的證明資料:

  1. 在目標建置主控台中,登入,然後從導覽功能表存取管理員頁面。

  2. 選取新增使用者,然後建立可供來源部署用來連線至目標部署的使用者。將 Operator 角色指派給此使用者。

  3. 開啟來源建置主控台,然後瀏覽至組態頁面。

  4. 在「資料庫」頁籤下,選取新增證明資料,然後完成下列作業:

    • 證明資料網域:輸入此連線的名稱

    • 憑證別名:輸入別名

    • 使用者 ID :輸入在步驟 2 中建立的使用者名稱。

    • 密碼驗證密碼:從步驟 2 輸入與此使用者關聯的密碼。

  5. 選取提交

新增分送路徑:

  1. 在 OCI GoldenGate 部署主控台中,選取分配服務

  2. 在「分送服務總覽」頁面上,選取新增路徑 (加號)。

  3. 在「新增路徑」頁面上,依下列方式完成欄位:

    1. 路徑名稱中,輸入路徑的名稱。

    2. (選用) 在說明中,輸入此路徑目的的簡短說明。

    3. (選用) 啟用啟用反向代理主機以使用反向代理主機連線至目標。

    4. 對於來源,請從下拉式清單中選取「擷取」名稱。

    5. 對於歷程檔名稱,請從下拉式清單中選取擷取歷程檔。

    6. 對於產生的來源 URI ,系統會根據提供的擷取資訊自動產生 URI。視需要選取「編輯」(鉛筆圖示) 來修改 URI。

    7. 若為目標認證方法,請選取目標 URI 的認證方法:

      • OAuth :如果來源和目標部署已啟用 IAM,請選取此選項。此選項使用從屬端證明資料從「分配服務至接收端服務」進行認證。

        注意:在啟用 IAM 的租用戶中,於連線至其他啟用 IAM 的部署時,選取 OAuth

      • UserID 別名:此選項使用您可以在目標 Oracle GoldenGate 上建立的 UserID 別名來建立連線。

        注意:從 GoldenGate 證明資料存放區部署連線至啟用 IAM 的部署時,請使用 IAM 使用者建立證明資料。確定使用者存在於 IAM 識別分割中。

    8. 若為目標,請從下拉式清單中選取資料傳輸協定:

      • wss :Web 通訊埠安全是預設選項。如果選取,您必須完成下列欄位:

        • 目標主機

        • 連接埠號碼

        • 歷程檔名稱

        • 部署名稱 (啟用反向代理主機)

        • URI 路徑 (啟用反向代理主機)

        • 網域

        • 別名

      • ogg :如果選取,您必須完成下列欄位:

        • 目標主機

        • 連接埠號碼

        • 歷程檔名稱

        • 部署名稱 (啟用反向代理主機)

        • URI 路徑 (啟用反向代理主機)

      • ws :如果選取,您必須完成下列欄位:

        • 目標主機

        • 連接埠號碼

        • 歷程檔名稱

        • 部署名稱 (啟用反向代理主機)

        • URI 路徑 (啟用反向代理主機)

        • 網域

        • 別名

    9. 對於產生的目標 URI ,系統會從提供的資訊自動填入 URI。視需要選取「編輯」(鉛筆圖示) 來修改 URI。

    10. 對於「目標加密演算法」,請選取目標歷程檔的加密演算法:

      • 無。

      • AES128

      • AES192

      • AES256

    11. 若為啟用網路壓縮,請選取此選項以設定壓縮臨界值。

    12. 順序長度中,輸入歷程檔序號的長度。

    13. 歷程檔大小 (MB) 中,輸入歷程檔中檔案的大小上限。

    14. 針對設定歷程檔格式,若要設定歷程檔格式,請啟用此選項,然後視需要完成其他欄位。

  4. 在「加密設定檔」區段中,視需要完成下列欄位:

    1. 設定檔名稱

    2. 加密設定檔類型

    3. 主要金鑰名稱

    4. 針對開始,選取記錄資料的位置:

      • Now

      • 自訂時間

      • 日誌中的位置 (預設)

    5. 針對來源序號,選取歷程檔來源部署 Extract 的序號。

    6. 對於來源 RBA 偏移量,請在要開始處理的歷程檔中輸入相對位元組位址 (RBA)。

    7. 對於嚴重,如果分送路徑對部署而言很重要,請將此選項設為 True。預設值為偽。

    8. 如果要讓分送路徑在終止時自動重新啟動,請針對自動重新啟動,將此選項設為 True。

    9. 若為自動重新啟動選項,請指示要重新啟動路徑處理作業的重試次數,以及重試之間的延遲持續時間間隔。

  5. 在「規則集組態」下,視需要完成下列欄位:

    1. 對於啟用篩選,如果選取,請選取新增規則,然後完成其他欄位。
  6. 在「更多選項」下,視需要完成下列欄位:

    1. EOF 延遲:搜尋來源資料前的檔案延遲結束

    2. 檢查點頻率:例行檢查點的頻率 (秒)

    3. App 選項

      • TCP 清除位元組:排清大小

      • TCP 清除秒數:清除間隔

    4. TCP 選項

      • DSCP:網路差異化服務

      • 服務條款服務條款

      • TCP_NODELAY:啟用時停用 Nagle 演算法

      • 快速確認:如果啟用,則傳送確認

      • TCP_CORK:啟用 Nagle 演算法

      • 系統發送緩衝區的大小

      • 系統接收緩衝區大小

      • 持續作用:持續作用時發生逾時

  7. 選取建立並執行

您可返回「概述」頁面,檢視「路徑」處理程序的狀態。

深入瞭解

想要深入瞭解分配路徑流程嗎?請參閱下列資源:

已知問題

將 21.x 部署升級至 21.17 之後,分配路徑和接收器路徑可能會失敗

從 Oracle GoldenGate 版本 21.17 和 26ai 開始,「路徑」使用預設保留的網域名稱「網路」,因此使用任何其他網域名稱的現有「路徑」失敗,並報告下列錯誤:

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

解決方法:在 OCI GoldenGate 部署主控台中,編輯每個「路徑」並將網域名稱變更為「網路」,然後重新啟動「路徑」。若要驗證,請在「組態」頁面的「證明資料存放區」段落中,檢查「路徑」認證使用者的網域。

如果您偏好使用「管理從屬端」,請執行下列命令來更新網域名稱。請確定您已取代 <path_name><alias> 預留位置:

對於來源起始的路徑:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

針對目標起始的路徑:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

目前只支援摘要認證

當您使用 Oracle Cloud Infrastructure GoldenGate 作為分配路徑目標時,Oracle Cloud Infrastructure GoldenGate 目前不支援憑證型驗證。

解決方法:無。