新增 OCI 物件儲存的 Replicat

瞭解如何新增和設定 OCI Object Storage 目標的 Replicat 處理作業。

相關主題

開始之前

在新增 Replicat 之前，請確定您具有下列項目：

區間 OCID
秘訣：
您可以在「區間詳細資訊」頁面找到區間 OCID。
1. 開啟 Oracle Cloud 主控台導覽功能表，選取識別，然後選取區間。
2. 從清單中選取您的區間以存取「區間詳細資訊」頁面。
3. 從「區間資訊」區段複製區間 OCID。
如需詳細資訊，請參閱尋找區間的 OCID 。
OCI Object Storage 儲存桶名稱
秘訣：
Oracle 建議您建立自己的 OCI Object Storage 貯體。
1. 開啟 Oracle Cloud 主控台導覽功能表，選取儲存，然後選取儲存桶。
2. 按一下建立儲存桶。
3. 在「建立儲存桶」面板中，輸入名稱，然後按一下建立。
如需詳細資訊，請參閱使用主控台建立儲存桶。

新增 Replicat (23ai)

開始前

請確定複查此目標類型的特定先決條件。

若要在 GoldenGate 23ai 中新增 Replicat ，請執行下列動作：

在 OCI GoldenGate 部署主控台的管理服務首頁上，按一下新增 Replicat (加圖示)。
在「新增 Replicat 」面板的 Replicat 資訊頁面上，視需要完成欄位，然後按一下下一步：
- 選取 Replicat 類型：
  - 一般 Replicat
  - 協調的 Replicat
- 請輸入程序名稱，長度不可超過 5 個字元。
- 輸入描述，以協助區分此處理與其他處理。
在「Replicat 選項」頁上，視需要完成欄位，然後按「下一步」：
- Replicat 歷程檔：
  - 輸入名稱。
  - 如果您預期歷程檔位於預設以外的位置，請輸入子目錄。
  - 選取一個加密設定檔。如果未建立加密設定檔，預設會選取本機公事包。
  - 對於開始，請選取資料處理的起點：
    - 日誌中的位置 (預設)
    - Now
    - 自訂時間
- 歷程檔位置：
  - 輸入順序編號。
  - 輸入 RBA 偏移量。
  - 從下拉式清單中選取您的目標。
    
    附註：
    視您的目標選擇而定，您可能會有其他選項，例如「串流處理」、「暫存與合併」，以及「暫存」位置。
- 目標證明資料：
  - 選取網域。
  - 選取指定網域內的別名。
  - 選取檢查點表格。保留預設選項，或選取您為目標部署建立的檢查點表格。
  - 選取繫線數目上限 (僅限協調複製 )。
在受管理選項頁面上，視需要完成選擇性欄位，然後按下一步：
- 選取「基本資料名稱」(若有的話)。
- 對部署狀況啟用「嚴重」。
- 啟用並設定「自動啟動」設定值。
在參數檔頁面上，您可以新增參數以進一步設定您的 Replicat 。例如：
```
table source.table1;
```
如果使用協調式 Replicat ，請將 TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties 新增至參數檔。
附註：

GoldenGate 預設使用格林威治標準時間 (GMT)。使用 SETENV 覆寫此 Replicat 處理的預設設定。此變更不適用於部署。舉例而言：
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
在「特性檔」頁面上，視需要設定「檔案處理程式」和「OCI 事件處理程式」特性，然後按一下下一步。要考慮修改的部分特性包括：
1. gg.handler.name.format：選取輸出資料的格式。可用的選項包括：
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row
  - avro_op
  - avro_row_ocf
  - avro_op_ocf
  對於鑲木，您必須套用其他性質。請參閱 OCI Object Storage 的 Parquet 瞭解詳細資訊。
2. gg.handler.name.fileNameMappingTemplate：使用範本關鍵字動態產生檔案名稱。
3. gg.handler.name.inactivityRollInterval：GoldenGate 會建立檔案並保持開啟以供寫入。此特性會在指定的無活動期間 (沒有內送交易) 之後關閉檔案，然後載入 OCI Object Storage 。
4. gg.eventhandler.name.compartmentID：輸入區間 OCID。
5. gg.eventhandler.name.bucketMappingTemplate：輸入物件儲存的儲存桶名稱。
進一步瞭解檔案寫入器處理程式和 OCI 事件處理程式組態特性。

附註：
您也可以視需要新增可插式格式製作器。如需詳細資訊，請參閱可插式格式製作器。
按一下建立並執行。如果您按一下建立，則可以稍後從管理服務首頁手動啟動 Replicat 。

新增 Replicat (21c)

新增 OCI Object Storage 目標的 Replicat：

在 OCI GoldenGate 部署主控台的「管理服務總覽」頁面中，按一下新增 Replicat (加上圖示)。
在「新增 Replicat」頁面上，選取一個 Replicat 類型，然後按一下下一步。
Replicat 的類型包括：
- 一般 Replicat
- 協調式 Replicat
在「Replicat 選項」頁面上，完成下列欄位，然後按一下下一步：
1. 在「程序名稱」中，輸入 Replicat 處理程序的名稱。
2. (選用) 針對「摘要」，輸入簡短描述以區分此處理程序與其他處理程序。
3. 針對「歷程檔名稱」，輸入兩個字元的歷程檔名稱。
4. 如果是目標，請從下拉式清單中選取 Oracle Object Storage 。
5. 對於 OCI 的可用別名，請從下拉式清單中選取您的別名。
在「參數檔」頁面上，視需要新增並設定 Replicat 參數，然後按一下下一步。
附註：
- 如果使用協調式 Replicat，請在「參數檔」的第二行新增下列參數：
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties
```
  若使用協調式 Replicat，將會建立多個檔案。
  
  如果省略，將會發生下列錯誤：
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
```
- GoldenGate 預設使用格林威治標準時間 (GMT)。使用 SETENV 以置換預設設定。舉例而言：
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
  深入瞭解 SETENV 。
在「特性檔」頁面上，視需要設定「檔案處理程式」和「OCI 事件處理程式」特性，然後按一下下一步。要考慮修改的部分特性包括：
1. gg.handler.name.format：選取輸出資料的格式。可用的選項包括：
  - delimitedtext
  - json
  - json_row
  - xml
  - avro_row
  - avro_op
  - avro_row_ocf
  - avro_op_ocf
  對於鑲木，您必須套用其他性質。請參閱 OCI Object Storage 的 Parquet 瞭解詳細資訊。
2. gg.handler.name.fileNameMappingTemplate：使用範本關鍵字動態產生檔案名稱。
3. gg.handler.name.inactivityRollInterval：GoldenGate 會建立檔案並保持開啟以供寫入。此特性會在指定的無活動期間 (沒有內送交易) 之後關閉檔案，然後載入 OCI Object Storage 。
4. gg.eventhandler.name.compartmentID：輸入區間 OCID。
5. gg.eventhandler.name.bucketMappingTemplate：輸入物件儲存的儲存桶名稱。
進一步瞭解檔案寫入器處理程式和 OCI 事件處理程式特性。

附註：
您也可以視需要新增可插式格式製作器。如需詳細資訊，請參閱使用可插式格式製作器。
按一下新增並執行。

您會返回「管理服務總覽」頁面，您可以在此監督 Replicat 處理作業的狀態。按一下處理程序名稱以檢視其詳細資料並存取報告。

已知問題

使用資源主體時發生 OCI 物件儲存複寫錯誤

如果使用「資源主體」進行認證，Replicat 將會失敗，並發生下列錯誤：

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

OCI 物件儲存連線中的使用者 OCID 不相符 (僅限同盟使用者)

同盟使用者如果在建立 OCI 物件儲存連線時選取「使用目前的使用者」，則其 OCID 與系統所選取的 OCID 不符。

解決方法：建立 OCI 物件儲存連線時，請確定選擇指定其他使用者，然後輸入聯合使用者的 OCID。

若要尋找使用者 OCID，請按一下 Oracle Cloud 主控台全域標頭中的設定檔，然後選取使用者名稱。在「使用者詳細資訊」頁面的「使用者資訊」底下，按一下 OCID 的顯示。

標題與著作權資訊

Oracle 和 (或) 其關係企業。