OCI GoldenGate 中已知的問題

一般

瞭解適用於整個服務的一般已知問題，以及如何解決這些問題。

升級為 Oracle GoldenGate 23.26.x 之後，部署主控台存取可能會發生 502 個無效的閘道錯誤，或者登入後無法列出 GoldenGate 處理作業

從舊版標籤升級至 23.26.x 版本，或在 23.26.x 部署上執行停止 / 啟動作業之後，Oracle Cloud Infrastructure GoldenGate 23.26 部署可能會變得狀況不佳。

解決方法：將受影響的 Oracle 部署升級為 oggoracle:23.26.1.0.0_260331 標籤，以修正此問題。

針對大數據和其他非 Oracle 標籤，我們將盡快發布修正。請聯絡支援中心以取得臨時手動緩解措施，以防止影響。

AdminClient：資訊設定檔命令發生問題

在 AdminClient 中使用 info profile 指令會傳回錯誤 302。

解決方法：使用下列 REST API 命令：

GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default

將 21.x 部署升級至 21.17 之後，分配路徑和接收器路徑可能會失敗

從 Oracle GoldenGate 版本 21.17 和 26ai 開始，「路徑」使用預設保留的網域名稱「網路」，因此使用任何其他網域名稱的現有「路徑」失敗，並報告下列錯誤：

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

解決方法：在 OCI GoldenGate 部署主控台中，編輯每個「路徑」並將網域名稱變更為「網路」，然後重新啟動「路徑」。若要驗證，請在「組態」頁面的「證明資料存放區」段落中，檢查「路徑」認證使用者的網域。

如果您偏好使用「管理從屬端」，請執行下列命令來更新網域名稱。請確定您已取代 <path_name> 和 <alias> 預留位置：

對於來源起始的路徑：

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

針對目標起始的路徑：

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

升級至 Oracle GoldenGate 21.17 for Big Data 的問題

從 Oracle GoldenGate 版本 21.14、21.15 或 21.16 升級為版本 21.17 且已設定信任存放區和 (或) 金鑰存放區連線特性的使用者失敗，報告的錯誤如下：

Caused by: oracle.goldengate.util.GGException: An exception occurred when creating the Kafka Producer object.
Caused by: org.apache.kafka.common.KafkaException: Failed to construct kafka producer
Caused by: org.apache.kafka.common.KafkaException: Failed to load SSL  keystore /u02/connections/<connection OCID>/trustStore of type JKS
Caused by: java.io.IOException: keystore password was incorrect

解決方法：

將 JKS 信任存放區和金鑰存放區轉換成 PKCS12。

若為金鑰存放區，應提示輸入密碼。Keytool 是 JDK 中的公用程式。

keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]

對於信任存放區，應提示輸入密碼。

keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]

在 Kafka 產生器特性檔中，設定下列項目：
```
ssl.truststore.type=PKCS12
ssl.keystore.type=PKCS12
```

從 21.15 或 23.x 組建倒回至 21.14 時發生問題

嘗試將 21.15 或 23.x 組建倒回至下列其中一個組建時：

Oracle (21.14.0.0.0_240525)
大數據 (21.14.0.0.0_240515)
MySQL (21.14.0.0.0_240404)
MSSQL (21.14.0.0.0_240404)

您可能會遇到下列其中一個問題：

新的公事包加密功能自 21.15 起引進，因此遺漏連線 / 證明資料問題。

解決方法：您必須將現有連線取消指定並重新指定給部署，並重新建立任何使用中的「分配」或「接收者」路徑所需的遺漏使用者。
「服務管理程式」無法啟動，因為從 23.x 倒回至 21.14 的「效能度量服務」發生問題。如果您遇到此問題，請聯絡 Oracle Support。
Oracle GoldenGate 處理作業失敗，錯誤為「OGG-02431 checkpoint 檔案中找到無效的記錄標頭 .」

解決方法：將部署升級至系列中最新的 21.14 組建。如果持續發生問題，請聯絡 Oracle Support。

嘗試使用 IP 存取已啟用 IAM 的部署時發生重導 URL 錯誤

嘗試使用部署的 IP 位址存取已啟用 IAM 的部署時，發生下列錯誤：

{"error":"invalid_redirect_uri","error_description":"Client
        xxxxxxxx1ocioraclecloudcom_APPID requested an invalid redirect URL: https://192.x.x.x/services/adminsrvr/v2/authorization. ECID:
        xxxx"}

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

選項 1 ：將部署 IP 位址新增至您的「識別網域應用程式」。若要進行這項變更，您必須是指派給應用程式之使用者群組的一部分。

在 Oracle Cloud 導覽功能表中，選取識別與安全性，然後在「識別」底下，選取網域。
從「網域」清單中選取您的網域。
從網域的識別網域資源功能表中，選取 Oracle Cloud Services 。
從 Oracle Cloud Services 清單中選取您的應用程式。例如，部署 ID：< 部署 OCID> 的 GGS INFRA 應用程式。
在應用程式頁面的 OAuth 組態底下，選取編輯 OAuth 組態。
在重新導向 URL 中，輸入部署的主控台 URL 與部署的 IP，以取代網域。例如：https://<deployment-ip>/services/adminsrvr/v2/authorization。
儲存所做的變更。

選項 2：在從屬端主機檔案中新增項目，以將 127.0.0.1 對應至您的部署 FQDN (將 <region> 取代為適當的區域)。舉例而言：

127.0.0.1 xx.deployment.goldengate.<region>.oci.oraclecloud.com

無法更新 IAM 部署的自訂憑證

此服務會禁止更新 FQDN，因為它會影響跨區域存取，而且需要更新目標區域中的 IAM 資源。

解決方法：若要解決此問題，請建立新的部署以使用更新的 FQDN。

Oracle GoldenGate REST API 會傳回 302 次重導至索引頁面

您可以使用 GoldenGate REST API 管理 OCI GoldenGate 部署。對於熟悉 Oracle GoldenGate 的人員，請注意，OCI GoldenGate 中不會顯示 Service Manager，而對 Service Manager 進行的任何呼叫將無法返回。

AdminClient：無法協商：找不到相符的主機金鑰類型

在 Cloud Shell 中使用 AdminClient 連線部署時，可能會出現下列訊息：

FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Action completed. Waiting until the work request has entered state: ('SUCCEEDED',)
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Cannot create ssh tunnelnel

解決方法：完成下列步驟：

開啟新的 Cloud Shell 階段作業。
使用下列命令建立檔案：
```
cat .ssh/config
```

在 .ssh/config 檔案中輸入下列內容，然後儲存：

HostkeyAlgorithms ssh-rsa,ssh-ed25519
PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa

如果已經有 .ssh/known_hosts 檔案，請將它刪除。
關閉 Cloud Shell 階段作業。
在您的部署詳細資料頁面上選取啟動管理用戶端。

連線

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

Oracle AI Data Platform：資源主體認證

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

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

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

OCI GoldenGate 中的 Apache Iceberg 連線問題

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

ERROR 2025-07-08 13:34:09.000481 [main] -  Parameter [awsSecretKey] is missing in the
      connection payload. Parameter [awsSecretKey] is missing in the connection payload.

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 Single Client Access Name (SCAN) 主機和 IP，但 SCAN 代理主機不支援 TLS。

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

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

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

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

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

部署控制台

探索與 OCI GoldenGate 部署主控台相關的已知問題。

無法載入部署主控台

如果您輸入最後一個部分超過 11 個字元的完整網域名稱 (FQDN)，則無法載入部署主控台。

解決方法：將 FQDN 的最後一個部分保留在 11 個字元以內。

OCI GoldenGate 部署主控台與 Safari Web 瀏覽器不相容

使用 Safari Web 瀏覽器存取時，Oracle Cloud Infrastructure GoldenGate 部署主控台將無法正確顯示。

解決方法：改用 Chrome 或 FireFox 瀏覽器。

連線至證明資料可能需要數分鐘的時間

當您嘗試連線至證明資料時，在建置主控台的「組態」畫面中，可能需要數分鐘才能順利連線。重新整理畫面只會增加連線處理作業的時間。

解決方法：這是 GoldenGate 組建版本 oggoracle：21.8.0.0.0_221119.1258_663 中解決的已知問題。

GoldenGate 處理程序

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

MongoDB、DocumentDB 及 Oracle JSON 集合 TLS 安全協定

如果 MongoDB Replicat、DocumentDB Replicat 或 Oracle JSON 集合連線因報表檔案中的下列錯誤而失敗：

Error: Caused by: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

解決方法：將下列特性新增至您的「特性」檔案，使用您的連線 OCID 更新 <connection_ocid>，並保持原狀。

jvm.bootoptions=-Djavax.net.ssl.trustStore=/u02/connections/<connection_ocid>/truststore.pkcs12 -Djavax.net.ssl.trustStorePassword=Welcome123

錯誤 37518857：OGGDAA GGS Snowflake Streaming Replicat 錯誤

Snowflake Streaming 處理程式失敗，網址為：Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

解決方法：將下列內容新增至您的 Replicat 特性檔：

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true

OCI GoldenGate 部署主控台無法顯示自訂 / 非預設的 Discard 檔案

依預設，捨棄檔案遵循命名慣例 <process-name>.dsc。除非您重新命名捨棄檔案，否則您可以在 OCI GoldenGate 部署主控台中查看所有捨棄檔案。部署主控台不會顯示自訂命名的捨棄檔案。

解決方法：使用建置詳細資訊頁面中的「收集診斷」工具來存取捨棄檔。

使用 BINARY_JSON_FORMAT 從 MongoDB Extract 使用歷程檔時，Replicat 失敗

當 Replicat 在 Extract 參數檔中使用以 BINARY_JSON_FORMAT 產生的 MongoDB Extract 歷程檔時，Replicat 會因下列錯誤而失敗：

ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
java.nio.charset.MalformedInputException: Input length = 1 at
java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
[ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread "main"
oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)

解決方法：從 Extract 參數移除 BINARY_JSON_FORMAT 時，Replicat 會順利執行，並以 Extended JSON 格式表示文件。

啟用 GTID 之資料庫的遠端變更資料擷取擷取失敗

當您針對使用全域異動 ID (GTID) 的 MySQL 資料庫啟用「遠端」選項來建立「變更資料擷取擷取」處理程序時，「擷取」處理程序會失敗，並報告下列錯誤：

ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

解決方法：在「變更資料擷取擷取」的「參數」檔案畫面上，移除行 TRANLOGOPTIONS ALTLOGDEST REMOTE。

如需詳細資訊，請參閱使用 Oracle GoldenGate for MySQL 。

分送路徑：新增根憑證至「憑證管理」或您的從屬端公事包

若要將資料傳送至 OCI GoldenGate 或從 OCI GoldenGate 提取資料，您必須分別在您的內部部署或市集 Oracle GoldenGate 的接收端伺服器上建立分送伺服器路徑或目標起始路徑。您還必須將 OCI GoldenGate 根憑證或自行簽署憑證新增至您的 Oracle GoldenGate 憑證管理 (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 部署主控台根憑證。在某些情況下，當 OCI GoldenGate 部署的憑證不是由根憑證直接簽署，而是透過中介憑證簽署時，可能也需要新增中介 CA 憑證。

進一步瞭解：

若為 Oracle GoldenGate 19 c 使用者，請參閱建立分送伺服器路徑使用者憑證。
對於 Oracle GoldenGate 21 c 或更新版本的使用者，請參閱在 Oracle GoldenGate 和 OCI GoldenGate 之間建立信任的連線。

目前只支援摘要認證

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

解決方法：無。

GoldenGate @ Oracle AI Database@Azure

資源定錨擱置中或失敗

確認您的 Azure 帳戶在目標資源群組中具有提供者角色，而且 Oracle AI Database@Azure 資源提供者已在 Azure、訂閱以及資源提供者下註冊。

網路錨點因子網路委派錯誤而失敗

您必須先將子網路委派給 Oracle AI Database@Azure，才能建立「網路錨點」。在 Azure 入口網站中，選取「虛擬網路」、「子網路」，然後選取「委派」並確認已設定正確的委派。

建立資源定錨點後看不到 OCI 區間

等待最多 5 分鐘進行傳輸。如果仍未顯示，請確認「資源定錨」在 Azure 入口網站中顯示「作用中」。如果顯示「失敗」，請刪除並重新建立。

odbaa-goldengate-administrators 群組不存在

您的租用戶可能在 2025 年 10 月 7 日之前佈建。在步驟 3 中執行 Cloud Shell 自動化命令檔，以一個步驟建立群組和原則。

建立部署時發生常見的問題

如果未正確套用動態群組 goldengate-deployments，則在建立部署期間，您可能會遇到下列一或多個問題：

Azure 可用性區域值與網路錨點不符 (區域不符 — 最常見)
目標區域已達保存庫、金鑰、加密密碼或負載平衡器的服務配額
保存庫加密密碼或加密金鑰位於沒有跨區間原則的其他區間中

因授權錯誤而封鎖部署

確認動態群組 goldengate-deployments 存在。在 Oracle Cloud 導覽功能表中，選取身分識別與安全、動態群組，然後檢查其比對規則是否正確。確認授予群組管理加密密碼系列、保存庫和金鑰之存取權的原則範圍已設為正確的區間。

部署停滯於建立狀態或失敗

在部署詳細資料頁面上，切換至「工作要求」頁籤並複查錯誤訊息。一般原因包括：

區域不相符 — 邏輯可用性區域與網路錨點不相符。重新建立具有正確區域的網路錨點，然後重新建立部署。
已達負載平衡器配額 — 請使用 OCI 搜尋列來搜尋限制、配額和用量，然後依 ORACLEDBATAZURE 篩選，並視需要要求增加。
無法存取保存庫加密密碼或金鑰 — 請確認加密密碼和金鑰與部署位於相同的區間，或是該跨區間原則存在。

Azure Portal 中未見到部署

已在建立期間選取 ORACLEDBATAZURE 以外的訂閱。刪除部署，然後使用正確的訂閱重新建立部署。

純文字密碼被拒絕

密碼必須至少有 8 個字元，並且包含一個大寫字母、一個小寫字母、一個數字，以及一個特殊字元。不得包含使用者名稱。

無法存取保存庫加密密碼

確認加密密碼狀態為「作用中」。在 Oracle Cloud 導覽功能表中，依序選取「身分識別與安全」和「加密密碼管理」。無法使用待刪除的加密密碼。

連線無法存取資料庫

確認在 Azure NSG 和網路錨點對應子網路上的 OCI 安全清單中開啟必要的資料庫連接埠。如果使用主機名稱，請驗證已根據作業 1 步驟 2 中連結之網路錨點文件的 DNS 解析設定 DNS 解析。

資料轉換

資料轉換部署不會備份一般連線

指派給「資料轉換」部署的一般連線不會包含在備份程序中。

已回復的資料轉換部署會移除差異資料集

資料轉換在還原資料轉換部署期間和之後建立的資料集將會遺失。

管線

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

目前不支援啟用自治式資料保全的自治式 AI 資料庫連線

OCI GoldenGate 管線目前不支援啟用自治式資料保全的自治式 AI 資料庫連線。

解決方法：關閉 Autonomous Data Guard (ADG) 或使用其他 Autonomous AI 資料庫。如果關閉 ADG 以更新 OCI GoldenGate 所使用的連線字串，請重新整理您的連線。

如果目標資料庫時區檔案版本低於來源資料庫的版本，Oracle Data Pump 就會失敗

管線選項「在開始複製之前將現有資料複製到目標資料庫」使用 Oracle Data Pump。如果目標資料庫的時區檔案版本低於來源資料庫的時區檔案版本，Oracle Data Pump 就會失敗。

解決方法：若要解決此問題，您必須升級目標資料庫的時區版本。請參閱管理 Autonomous AI Database 的時區檔案更新。