為 Amazon S3 新增 Replicat

瞭解如何在 OCI GoldenGate 中建立 Amazon S3 目標的 Replicat 處理作業。

開始之前

在新增和執行 Amazon S3 的 Replicat 之前，請確定您有：

已建立並指定給目標大數據部署的 Amazon S3 連線
Amazon Web Services (AWS) 區域
Amazon S3 的組態考量和最佳實務審查

新增 Replicat (26ai)

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

若要在 GoldenGate 26ai 中新增 Replicat：

在 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")
```
在「特性檔」頁面中，設定下列 Amazon S3 特性：
- gg.eventhandler.s3.region 提供目標 S3 儲存桶的 AWS 區域。
- gg.eventhandler.s3.bucketMappingTemplate: 提供目標 S3 儲存桶名稱。如果儲存桶不存在，則可以由 OCI GoldenGate 自動建立。您可以提供靜態儲存桶名稱，或使用樣板關鍵字動態指定儲存桶名稱。
  
  注意：請確定儲存桶名稱只包含小寫字元。大寫字元可能會導致 Replicat 失敗。
- (選擇性) gg.handler.abs.format：選取輸出格式的方式。JSON 是預設設定。可用的選項包括：
- 分隔文字
- json
- json_row
- xml
- 中文 (繁體)
- 中文 (繁體)
對於鑲木，您必須套用其他性質。請參閱 Parquet for Amazon S3 以瞭解詳細資訊。

如需此目標特性的相關資訊，請參閱 Oracle GoldenGate for Distributed Applications and Analytics 手冊中的 Amazon S3 。
選取建立並執行。如果您選取建立，則稍後可以從 Replicat 頁面手動啟動 Replicat。

新增 Replicat (21c)

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

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

依照預設，GoldenGate 使用格林威治標準時間 (GMT)。使用 SETENV 來置換 Extract 的預設設定。此變更僅適用於「擷取」處理，不適用於部署。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
在「特性檔」頁面中，設定下列 Amazon S3 特性：
- gg.eventhandler.s3.region 提供目標 S3 儲存桶的 AWS 區域。
- gg.eventhandler.s3.bucketMappingTemplate: 提供目標 S3 儲存桶名稱。如果儲存桶不存在，則可以由 OCI GoldenGate 自動建立。您可以提供靜態儲存桶名稱，或使用樣板關鍵字動態指定儲存桶名稱。
注意：請確定儲存桶名稱只包含小寫字元。大寫字元可能會導致 Replicat 失敗。
- (選擇性) gg.handler.abs.format：選取輸出格式的方式。JSON 是預設設定。可用的選項包括：
- 分隔文字
- json
- json_row
- xml
- 中文 (繁體)
- 中文 (繁體)
對於鑲木，您必須套用其他性質。請參閱 Parquet for Amazon S3 以瞭解詳細資訊。
選取建立並執行。如果您選取建立，之後可以從「管理服務總覽」頁面手動啟動 Replicat。

您可以返回「管理服務總覽」頁面，檢視 Replicat 處理作業的建立及存取 Replicat 動作。

Amazon S3 目標詳細資訊

Amazon S3 已知問題

Amazon S3 和共用端點的 Google Cloud Storage 連線發生 Java.net.UnknownHostException 錯誤

將 Amazon S3 和 Google Cloud Storage 連線與共用端點搭配使用時，可能會發生 Java.net.UnknownHostException 錯誤。

解決方法：編輯連線並將流量路由方法變更為專用，或是在建立 Amazon S3 和 Google Cloud Storage 連線時選取專用。

OCI GoldenGate 中的 Amazon S3 連線發生問題

如果使用 Amazon S3 連線時發生下列錯誤，請開啟支援回報項目，共用詳細資訊和錯誤訊息。

ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
      [ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com

解決方法：

連線至 Cloud Shell。

使用下列 CLI 範例建立新的 Amazon S3 連線：

oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret> --connection-region <amazon_s3_bucket_region>

指定部署的連線。
新增並執行 Amazon S3 的 Replicat。

或者，如果您偏好不使用公用存取，請將 Amazon S3 連線的儲存桶設定為使用 AWS VPC 端點。若要讓 OCI GoldenGate 使用 VPC 端點存取您的 S3 儲存桶，您還必須在 VCN 與 AWS VPC 之間設定 IPsec VPN。

若要設定 Amazon S3 的端點，請將 gg.eventhandler.s3.url 特性新增至 Replicat 特性檔，然後提供專用連線的端點。