新增 Oracle Object Storage 的 Replicat

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

開始之前

新增 Replicat 之前，請確定您具有：

已複查 Oracle Object Storage 組態考量和最佳做法
區間 OCID
秘訣：您可以在「區間詳細資訊」頁面找到區間 OCID。
1. 開啟 Oracle Cloud 主控台導覽功能表，選取識別，然後選取區間。
2. 從清單中選取您的區間，以存取區間詳細資訊頁面。
3. 從「區間資訊」區段複製區間 OCID。
如需詳細資訊，請參閱尋找區間的 OCID 。
Oracle Object Storage 貯體名稱
提示：Oracle 建議您建立自己的 Oracle Object Storage 貯體。
1. 開啟 Oracle Cloud 主控台導覽功能表，依序選取儲存體和儲存設定 (Bucket) 。
2. 選取建立儲存桶。
3. 在「建立儲存桶」面板中，輸入名稱，然後選取建立。
如需詳細資訊，請參閱使用主控台建立儲存桶。

新增 Replicat (26ai)

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

在 OCI GoldenGate 部署主控台導覽功能表中，選取 Replicat 。
在 Replicat 頁面上，選取新增 Replicat 。
在「新增 Replicat」面板的 Replicat 資訊頁面中，視需要完成欄位，然後選取下一步：
- 選取複製類型：
  - 一般 Replicat
  - 協調式 Replicat
- 輸入長度不超過 5 個字元的程序名稱。
- 輸入描述，以協助區分此處理與其他處理。
在複製選項頁面上，視需要完成欄位，然後選取下一步：
- Replicat 歷程檔：
  - 輸入名稱。
  - 如果您預期「歷程檔」位於預設以外的位置，請輸入子目錄。
  - 選取一個加密設定檔。如果未建立加密設定檔，預設會選取「本機公事包」。
  - 針對開始，選取資料處理的起點：
    - 日誌中的位置 (預設)
    - Now
    - 自訂時間
- 歷程檔位置：
  - 輸入序號。
  - 輸入 RBA 沖銷。
  - 從下拉式清單中選取您的目標。
    
    注意：視您的目標選擇而定，您可能會有其他選項，例如「串流處理」、「暫存」和「合併」以及「暫存」位置。
- 目標證明資料：
  - 選取一個網域。
  - 選取指定網域內的別名。
  - 選取檢查點表格。請保留預設選擇，或選取您為目標部署建立的檢查點表格。
  - 選取繫線數目上限 (僅限協調式 Replicat)。
在受管理選項頁面上，視需要完成選擇性欄位，然後選取下一步：
- 若有可用的「基本資料名稱」，請選取「基本資料名稱」。
- 對部署狀況啟用「重要」。
- 啟用並設定自動啟動設定。
在參數檔頁面中，您可以新增參數以進一步設定 Replicat。舉例而言：
```
table source.table1;
```
注意：

依照預設，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
  對於鑲木，您必須套用其他性質。如需詳細資訊，請參閱 Parquet for Oracle Object Storage 。
2. gg.handler.name.fileNameMappingTemplate：使用範本關鍵字動態產生檔案名稱。
3. gg.handler.name.inactivityRollInterval：GoldenGate 會建立檔案並保持開啟以供寫入。此特性會在指定的無活動期間 (無內送交易) 之後關閉檔案，然後載入 Oracle Object Storage。
4. gg.eventhandler.name.compartmentID：輸入區間 OCID。
5. gg.eventhandler.name.bucketMappingTemplate：輸入物件儲存的儲存桶名稱。
進一步瞭解檔案寫入器處理程式和 OCI 事件處理程式組態特性。

注意：您也可以視需要新增可插式格式製作器。如需詳細資訊，請參閱可插式格式製作器。
選取建立並執行。如果您選取建立，則稍後可以從 Replicat 頁面手動啟動 Replicat。

新增 Replicat (21c)

在 OCI GoldenGate 部署主控台的「管理服務總覽」頁面中，選取新增 Replicat (加上圖示)。
在「新增 Replicat」頁面上，選取一個 Replicat 類型，然後選取下一步。

Replicat 的類型包括：
- 一般 Replicat
- 協調式 Replicat
在「Replicat 選項」頁面上，完成下列欄位，然後選取下一步：
1. 在「程序名稱」中，輸入 Replicat 程序的名稱。
2. (選用) 在「描述」中，輸入簡短描述以區別此處理程序與其他處理程序。
3. 在「歷程檔名稱」中輸入兩個字元的歷程檔名稱。
4. 若為目標，請從下拉式清單中選取 Oracle Object Storage 。
5. 對於 OCI 的可用別名，請從下拉式清單中選取您的別名。
在「參數檔」頁面上，視需要新增和設定 Replicat 參數，然後選取下一步。
```
table source.table1;
```
注意：

依照預設，GoldenGate 使用格林威治標準時間 (GMT)。使用 SETENV 來置換 Extract 的預設設定。此變更僅適用於「擷取」處理，不適用於部署。
```
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
  對於鑲木，您必須套用其他性質。如需詳細資訊，請參閱 Parquet for Oracle Object Storage 。
2. gg.handler.name.fileNameMappingTemplate：使用範本關鍵字動態產生檔案名稱。
3. gg.handler.name.inactivityRollInterval：GoldenGate 會建立檔案並保持開啟以供寫入。此特性會在指定的無活動期間 (無內送交易) 之後關閉檔案，然後載入 Oracle Object Storage。
4. gg.eventhandler.name.compartmentID：輸入區間 OCID。
5. gg.eventhandler.name.bucketMappingTemplate：輸入物件儲存的儲存桶名稱。
進一步瞭解檔案寫入器處理程式和 OCI 事件處理程式特性。

注意：您也可以視需要新增可插式格式製作器。如需詳細資訊，請參閱使用可插式格式製作器。
選取新增並執行。

您會返回「管理服務總覽」頁面，您可以在此監督 Replicat 處理作業的狀態。選取處理名稱以檢視其明細與存取報表。

Oracle Object Storage 目標詳細資訊

Oracle Object Storage 連線已知問題

使用資源主體時發生 Oracle Object Storage 複製錯誤

如果您的 Oracle Object Storage 連線使用「資源主體」認證，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

解決方法：若要解決此問題，請編輯連線，然後選取其他認證方法。

Oracle Object Storage 連線中的使用者 OCID 不相符 (僅限同盟使用者)

同盟使用者如果在建立 Oracle Object Storage 連線時選取「使用目前的使用者」，則其 OCID 與系統挑選的 OCID 不符。

解決方法：當您建立 Oracle Object Storage 連線時，請確定選擇指定其他使用者，然後輸入聯合使用者的 OCID。

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