OCI GoldenGate 連線已知問題

探索與連線相關的已知問題，以及如何解決這些問題。

Oracle AI Data Platform：資源主體認證

Oracle AI Data Platform 連線的「資源主體」認證發生下列錯誤：

JDBCMDP-00034 Current attempt to connect failed with error: [[JDBC Driver]Could not find private key: /tmp/ogg/ocid1.goldengateconnection.oc1.phx.amaa...lqabqqxq/privateKeyFile].

解決方法：編輯連線並選取其他認證方法，例如使用目前的租用戶和使用者或指定其他租用戶和使用者。

使用加密密碼連線時發生錯誤

在下列版本的 OCI GoldenGate 中使用含有加密密碼和保存庫的連線時，可能會發生連線錯誤：

oggbigdata:23.8.0.0.0_250428.1314_1246
oggbigdata:23.8.0.0.0_250523.1247_1247
oggbigdata:23.8.0.0.0_250523.1247_1253
oggbigdata:21.18.0.0.0_250416.1417_1253
oggmysql:23.8.0.0.0_250412.2241_1246
oggmysql:23.8.0.0.0_250412.2241_1237
oggmysql:23.8.0.0.0_250412.2241_12211
oggpostgresql:23.8.0.0.0_250517.1921_1248
oggpostgresql:23.8.0.0.0_250412.2241_1246
oggpostgresql:23.8.0.0.0_250412.2241_1237
oggdb2zos:23.8.0.0.0_250412.2241_1253
oggdb2zos:23.8.0.0.0_250412.2241_1246
oggdb2i:23.8.0.0.0_250524.0756_1253
oggdb2i:23.8.0.0.0_250524.0756_1246

解決方法：在不使用 OCI Vault 加密密碼的情況下重新建立連線：

在「建立連線」頁面中，展開頁面底端的進階選項。
在「進階」選項下，展開設定值。
取消選取使用保存庫中的加密密碼。
選取建立。

或者，如果連線中沒有「進階」選項，請嘗試使用較早版本的部署。

使用資源主體時發生 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

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

與 AI 資料目錄服務認證錯誤的 Apache Iceberg 連線

與 AI 資料目錄服務的 Apache Iceberg 連線因權杖到期所造成的認證錯誤而到期。如果發生此問題，請聯絡 Oracle Support。

Apache Iceberg NoSuchFileException 錯誤

如果在使用 Apache Iceberg 連線時遇到下列錯誤，請開啟支援回報項目，分享詳細資訊和錯誤訊息：

Caused by: java.nio.file.NoSuchFileException: /tmp/ogg/ocid1.goldengateconnection.oc1...../restCatalogProperties

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 特性檔，然後提供專用連線的端點。

MongoDB 測試連線問題

使用與 MongoDB 連線的「測試」連線時發生錯誤。您可以忽略此錯誤，並在 OCI GoldenGate 部署主控台中測試 MongoDB 連線。在建置主控台中，開啟「管理服務」的導覽功能表，選取組態。您的 MongoDB 連線應列為證明資料，供您選取 ** 連線至 ** 以測試連線。

使用 mTLS 認證的自治式 AI 資料庫連線所需的動作

輪換自治式 AI 資料庫公事包時，必須重新整理與此資料庫的 OCI GoldenGate 連線，才能擷取最新的公事包資訊。

如需詳細資訊，請參閱 My Oracle Support (MOS) Document 2911553.1 。

若要重新整理自治式 AI 資料庫連線：請編輯並儲存自治式 AI 資料庫 (自治式 AI 異動處理或自治式 AI 湖倉一體) 連線。儲存連線會自動下載並重新整理公事包。不需要對連線進行其他變更。

若要驗證：

啟動使用「自治式 AI 資料庫」連線之部署的部署主控台。
在建置主控台中，開啟導覽功能表，然後選取組態。

在「證明資料」畫面中，觀察「自治式 AI 資料庫」連線字串。

重新整理公事包之前，連線字串的外觀如下：

ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))

重新整理公事包之後，連線字串就會更新成如下所示：

ggadmin@(DESCRIPTION=(TRANSPORT_CONNECT_TIMEOUT=3)(CONNECT_TIMEOUT=60)(RECV_TIMEOUT=120)(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(CONNECT_DATA=(COLOCATION_TAG=ogginstance)(FAILOVER_MODE=(TYPE=SESSION)(METHOD=BASIC)(OVERRIDE=TRUE))(service_name=<adb-servicename>_low.adb.oraclecloud.com))(security=(MY_WALLET_DIRECTORY="/u02/connections/ocid1.goldengateconnection.oc1.phx.<ocid>/wallet")(SSL_SERVER_DN_MATCH=TRUE)(ssl_server_dn_match=yes)))

MySQL 資料庫未出現在「證明資料別名」清單中

在 OCI GoldenGate 部署主控台中建立 Extract 時，包含 '@' 符號的 MySQL 資料庫使用者名稱不會顯示在「證明資料別名」清單中。

解決方法：從清單中選取不同的別名，然後在下一個畫面手動更新「參數檔」。

網路逾時會影響使用專用端點的資料庫連線

如果您使用專用端點連線至資料庫，啟動或停止 Extract 處理作業時可能會發生網路逾時。

解決方法：您可以執行下列其中一項作業：

從您的部署詳細資訊頁面套用最新的修正程式。在部署資訊區段的 GoldenGate 下，針對版本，選取升級。
如果您目前無法套用最新的修正程式，可以將連線字串更新為包含 EXPIRE_TIME=1。依照預設，Oracle GoldenGate 中可能會有簡易連線字串。必須將「Oracle GoldenGate 證明資料」中的這個連線字串更新為長連線字串，如下所示：
```
<username>@//<hostname>:1521/<service_name>
<username> @(DESCRIPTION = (EXPIRE_TIME=1)(ADDRESS_LIST = (ADDRESS = (COMMUNITY = tcp)(PROTOCOL = TCP)(Host = <hostname>)(Port = 1521))) (CONNECT_DATA = (SERVICE_NAME = <service_name>)))
```

SCAN 代理主機不支援 TLS

雖然 OCI GoldenGate 支援 Oracle 單一從屬端存取名稱 (SCAN) 主機和 IP，但 SCAN 代理主機不支援 TLS。

解決方法：您可以使用資料庫節點 IP 連線至 RAC 資料庫。

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

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

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

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