新增分配路徑

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

相關主題

分配路徑的使用時機

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

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

開始之前

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

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

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

建立並執行分送路徑 (23ai)

如果使用 GoldenGate 證明資料存放區，您必須新增來源部署用來連線至目標部署的使用者。如果使用 IAM 證明資料存放區，請略過這些步驟。
  1. 在目標部署主控台中，登入，然後從左側導覽功能表存取使用者管理頁面。
  2. 按一下新增使用者，然後完成下列作業：
    • 認證者：從下拉式清單中選取密碼。
    • 角色：從下拉式清單中選取運算子。
    • 使用者名稱：輸入您的使用者名稱。
    • 密碼和驗證密碼：輸入與此使用者關聯的密碼。
  3. 開啟來源部署主控台，然後瀏覽至左側導覽功能表中的路徑連線。
  4. 按一下新增路徑連線，然後完成下列項目：
    • 證明資料別名：輸入別名。
    • 使用者 ID ：輸入在步驟 2 中建立的使用者名稱。
    • 密碼和驗證密碼：從步驟 2 輸入與此使用者關聯的密碼。
  5. 按一下送出。
若要在 GoldenGate 23ai 中新增「分送路徑」，請執行下列動作：
  1. 在 OCI GoldenGate 部署主控台中，按一下分送服務。
  2. 在首頁上，按一下新增分送路徑 (加號圖示)。
  3. 在「新增路徑」面板中，視需要完成路徑資訊欄位，然後按下一步：
    1. 輸入路徑名稱，輸入路徑的名稱。
    2. (選擇性) 輸入描述，以描述此路徑的用途，並列出相關的 Extract 和 Replicats。
  4. 在來源選項頁面上，視需要輸入欄位，然後按下一步：
    • 從下拉式清單中選取來源擷取。
    • 輸入歷程檔名稱
    • 如果您預期「歷程檔」位於預設以外的位置，請輸入子目錄。
    • 產生的來源 URI 會根據提供的資訊自動產生。如有需要，請按一下「編輯」(鉛筆圖示) 來修改 URI。
    • 選取一個加密設定檔。如果未建立加密設定檔，預設會選取「本機公事包」設定檔。
    • 對於開始，請選取資料處理的開始點：
      • 日誌中的位置
      • Now
      • 自訂時間
      • CSN (當時或之後)
    • 輸入序號。
    • 輸入 RBA 偏移。
  5. 在目標選項頁面上，視需要完成欄位，然後按下一步：
    • 選取目標協定：
      • ws
      • wss
      • ogg
    • (選用) 啟用啟用反向代理主機，以使用反向代理主機連線至目標。
    • 目標類型 (僅限「ogg 目標協定」)
      • 主管
      • 收集器
      • 接收端服務
    • 輸入目標主機。
    • 輸入目標部署的連接埠號碼。
    • 輸入目標「歷程檔」的歷程檔名稱。
    • 如果「歷程檔」位於預設位置以外的地方，請輸入子目錄。
    • 輸入歷程檔大小上限。
    • 選取用來將歷程檔傳送至目標部署的目標加密演算法：
      • NONE
      • AES128
      • AES192
      • AES256
    • 啟用變更加密以允許變更加密演算法。
    • 產生的目標 URI 會根據提供的資訊自動產生。如有需要，請按一下「編輯」(鉛筆圖示) 來修改 URI。
    • 選取目標認證方法 (僅限「wss 目標協定」)
      • UserID 別名

        附註：

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

        附註：

        在啟用 IAM 的租用戶中，於連線至其他啟用 IAM 的部署時選取 OAuth。
      • 憑證
    • 選取網域。
    • 選取含有 Oracle GoldenGate UserID 和密碼的別名。
    • 選取目標類型：
      • GGFormat (預設)
      • SQL
      • XML
      • 純文字
  6. 在進階選項頁面上，視需要完成欄位，然後按下一步：
    • 啟用啟用網路壓縮以設定壓縮臨界值。
    • 選取 EOF 延遲。

      附註：

      在 Linux 平台上，可以保留預設值。不過，在非 Linux 平台上，您可能需要針對高頻寬、高延遲網路或具有「服務品質 (QoS)」設定值 (DSCP 和服務時間 (ToS)) 的網路調整這項設定
    • 選取檢查點頻率，即可設定檢查點的路徑頻率 (秒)。
    • 輸入 TCP 清除位元組 (位元組)。
    • 輸入 TCP 清除秒數 (秒)。
    • 選取差異化服務代碼點 (DSCP)。
    • 選取「服務類型」( 服務條款 )。
    • 啟用 TCP_NODELAY ，以避免在使用 Nagle 選項時延遲。
    • 啟用快速認可，以在接收資料後傳送快速認可。
    • 啟用 TCP_CORK ，即可使用 Nagle 演算法 cork 選項。
    • 輸入系統傳送緩衝區大小，以設定流量控制的傳送緩衝區大小值。
    • 輸入系統接收緩衝區大小，以設定流量控制的接收緩衝區大小值。
    • 設定持續作用的逾時。
  7. 在篩選選項頁面上，視需要完成下列欄位，然後按下一步：
    • 輸入規則名稱。
    • 選取規則動作：
      • 排除會根據選取的選項篩選出資料。
      • 包括：包含以指定選項為基礎的資料。
    • 選取篩選類型：
      • 物件類型：從三種物件類型中選取：DML、DDL 和程序
      • 物件名稱：選取此選項即可提供現有的物件名稱。3 部分的命名慣例取決於您是使用 CDB。使用 CDB 時，您必須使用 3 部分的命名慣例，否則必須使用 2 部分的慣例。3 部分的慣例包括 container、schema、object。2 部分的慣例包括 schema、object name。
      • 程序功能名稱：選取此選項即可根據現有的程序功能名稱進行篩選。
      • 以資料欄為基礎：如果選取此選項，會顯示選項，讓您輸入套用規則的表格和資料欄名稱。您可以使用包含 LT、GT、EQ、LE、GE、NE 條件的資料欄值進行篩選。您也可以指定要在影像之前或在篩選資料中的影像之後。
      • 標記：選取此選項即可根據標記設定篩選。
      • 區塊 ID ：顯示資料庫分區的組態詳細資訊，但無法編輯詳細資訊。
    • 選取否定，以否定任何現有規則。
    • 按一下新增以新增規則。
  8. 在受管理選項頁面上，視需要完成選擇性欄位。
    • 啟用重要以設定此路徑的高可用性。
    • 啟用自動重新啟動以調整「自動重新啟動重試」和「自動重新啟動延遲」選項。
  9. 按一下建立並執行，即可立即執行您的「路徑」。按一下建立，以稍後手動執行您的「路徑」。
您可返回首頁，檢視「路徑」處理程序的狀態。

建立和執行分配路徑 (21 c)

新增允許來源部署 (您建立此路徑的部署) 連線至目標部署的證明資料：
  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. 對於來源序號，請選取歷程檔來源部署擷取的序號。
    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. 按一下建立並執行。
您可返回「概述」頁面，檢視「路徑」處理程序的狀態。

深入瞭解

想要深入瞭解配銷路徑流程嗎？請參閱下列資源：

已知問題

若要建立傳送資料至 Oracle Cloud Infrastructure GoldenGate 或從中提取資料的「分送路徑」，請確定已將根憑證新增至「憑證管理」或從屬端公事包

若要傳送資料至 OCI GoldenGate 或從中提取資料，您必須分別在您的內部部署或市集 Oracle GoldenGate 的「接收端伺服器」上建立「分送伺服器路徑」或目標起始路徑。您還必須將 OCI GoldenGate 根憑證或自行簽署憑證新增至您的 Oracle GoldenGate Certificate Management (Oracle GoldenGate 21 c 或更新版本) 或從屬端公事包 (Oracle GoldenGate 19 c)。這會在您的 Oracle GoldenGate 與 OCI GoldenGate 部署之間建立信任的連線。Oracle GoldenGate 與 OCI GoldenGate 之間的「分送」與「接收端伺服器路徑」只支援 WebSocket Secure (WSS) 協定。

變更 OCI GoldenGate 根憑證會導致「分送伺服器路徑」或您內部部署或市集 Oracle GoldenGate 之「接收端伺服器」上的目標起始路徑失敗，並產生下列錯誤： 

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

解決方法：若要修正此問題，請在從屬端公事包或服務管理程式的「憑證管理」畫面中更新憑證，以使用 OCI GoldenGate Deployment Console 根憑證。在某些情況下，當 OCI GoldenGate 部署的憑證不是由根憑證直接簽署，而是透過中介憑證 (例如，可能也需要新增中介 CA 憑證) 時。

進一步瞭解：

目前只支援「摘要認證」

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

解決方法：無。