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
解決方法:
- 在「建立連線 (Create Connection)」頁面中,展開頁面底部的進階選項 (Advanced options) 。
- 在「進階」選項下,展開設定值。
- 取消選取使用保存庫中的加密密碼。
- 完成建立沒有保存庫加密密碼的連線。
或者,如果連線中沒有「進階」選項,請嘗試使用較舊版本的部署。
在 21.x 部署升級至 21.17 之後,分配與接收者路徑可能會失敗
從 Oracle GoldenGate 版本 21.17 和 23ai 開始,路徑會使用預設的保留網域名稱 "Network",因此使用任何其他網域名稱的現有路徑會失敗,並報告下列錯誤:
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]
- 若為金鑰存放區,則應提示您輸入密碼。Keytool 是 JDK 中的公用程式。
- 在 Kafka 產生器特性檔中,設定下列項目:
ssl.truststore.type=PKCS12 ssl.keystore.type=PKCS12
從 21.15 或 23.x 建置版本倒回至 21.14 時發生問題
嘗試將 21.15 或 23.x 組建倒回至:
- Oracle (21.14.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 在檢查點檔案中找到無效的記錄標頭 .」
解決方法:將部署升級至系列中最新的 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:
<deployment OCID>
的 GGS INFRA 應用程式。 - 在應用程式頁面的 OAuth 組態底下,按一下編輯 OAuth 組態。
- 若為重新導向 URL ,請以部署的 IP 輸入部署的主控台 URL 來取代網域。例如:
https://<deployment-ip>/services/adminsrvr/v2/authorization
。 - 儲存所做的變更。
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 的使用者,請注意 Service Manager 不會顯示在 OCI GoldenGate 中,任何對 Service Manager 的呼叫都將無法返回。
AdminClient: Unable to negotiate with <ip-address> port 22: no matching host key type found.
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 階段作業。
- 按一下部署詳細資訊頁面中的啟動管理從屬端。
連線
瞭解與人脈關係相關的已知問題,以及如何解決這些問題。
使用資源主體時發生 OCI 物件儲存複寫錯誤
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 連線時選取專用。
OCI GoldenGate MongoDB 連線不支援 mongdb+srv 連線字串。
解決方法:使用 MongoDB 連線字串。
- 在 MongoDB Atlas 中,按一下連線。
- 選取驅動程式。
- 選取 Java 。
- 若為「版本」,請選取 3.4 或更新版本。
- 您可以使用提供的 mongodb 字串。舉例而言:
mongodb://<user_name>:<db_password>@cluster0-shard-00-00.abc.mongodb.net:27017,cluster0-shard-00-01.abc.mongodb.net:27017,cluster0-shard-00-02.abc.mongodb.net:27017/?ssl=true&replicaSet=atlas-3grqh1-shard-0&authSource=admin&retryWrites=true&w=majority&appName=Cluster0
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>
- 指定部署的連線。
- 為 Amazon S3 新增並執行 Replicat。
或者,如果您不想使用公用存取,請將 Amazon S3 連線的儲存桶設定為使用 AWS VPC Endpoints。若要讓 OCI GoldenGate 使用 VPC Endpoints 存取您的 S3 儲存桶,您還必須在 VCN 與 AWS VPC 之間設定 IPsec VPN。
若要設定 Amazon S3 的端點,請將 gg.eventhandler.s3.url
特性新增至 Replicat 特性檔,然後提供專用連線的端點。
MongoDB 測試連線發生問題
將 Test connection 與 MongoDB 連線搭配使用時,可能會發生錯誤。您可以忽略此錯誤,並在 OCI GoldenGate 部署主控台中測試 MongoDB 連線。在部署主控台中,開啟 Administration Service 的導覽功能表,按一下組態。您的 MongoDB 連線應該列為證明資料,您可以在此按一下連線至 <alias> 來測試連線。
使用 mTLS 認證的自治式資料庫需要採取動作
輪換 Autonomous Database 公事包時,必須重新整理與此資料庫的 OCI GoldenGate 連線,以擷取最新的公事包資訊。
如需更多資訊,請參閱 My Oracle Support (MOS) 文件 2911553.1 。
若要重新整理 Autonomous Database 連線,請執行下列步驟:編輯並儲存與 Autonomous Database (Autonomous Transaction Processing 或 Autonomous Data Warehouse) 的連線。儲存連線會自動下載並重新整理公事包。不需要對連線進行其他變更。
若要驗證:
- 啟動使用 Autonomous Database 連線之部署的部署主控台。
- 在部署主控台中,開啟導覽功能表,然後按一下組態。
- 在「證明資料」畫面上,觀察 Autonomous Database 連線字串。
重新整理公事包之前,連線字串看起來如下:
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)))
在 OCI GoldenGate 部署主控台中建立 Extract 時,MySQL 資料庫使用者名稱 (包含 '@' 符號) 不會出現在 Credential Alias 清單中
若為 MySQL 資料庫,在 OCI GoldenGate 部署主控台中建立 Extracts 時,會從 Credential Alias 清單中省略包含 @ 符號的使用者名稱。
解決方法:從清單中選取其他別名,然後在下一個畫面上手動更新 Parameter File。
網路逾時會影響使用專用端點的資料庫連線。
如果您使用專用端點來連線資料庫,則在啟動或停止 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。
解決方法:您可以使用 Database Node IP 連線至 RAC database。
OCI 物件儲存連線中的使用者 OCID 不符 (僅限同盟使用者)
如果同盟使用者在建立 OCI 物件儲存連線時選取「使用目前的使用者」,則其 OCID 與系統所選取的 OCID 不符。
解決方法:建立 OCI 物件儲存連線時,請確定選擇指定其他使用者,然後輸入同盟使用者的 OCID。
若要尋找使用者 OCID,請按一下 Oracle Cloud 主控台全域標頭中的設定檔,然後選取使用者名稱。在「使用者詳細資訊」頁面的「使用者資訊」底下,按一下 OCID 的顯示。
部署主控台
部署主控台無法載入
如果您輸入最後一個部分超過 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 Collection TLS 安全協定
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 Handler 失敗於:Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"
jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true
OCI GoldenGate 部署主控台無法顯示自訂 / 非預設的「捨棄」檔案
依照預設,捨棄檔案會遵循命名慣例 <process-name>.dsc
。除非您重新命名檔案,否則您可以在 OCI GoldenGate 部署主控台中看到所有捨棄檔案。部署主控台不會顯示自訂指定的捨棄檔。
解決方法:使用部署詳細資訊頁面中的「收集診斷」工具來存取您的捨棄檔案。
將 MongoDB Extract 中的 Trail file 與 BINARY_JSON_FORMAT 搭配使用時,Replicats 會失敗
當 Replicat 使用從 MongoDB Extract 產生的 Trail file,並在 Extract 參數檔中使用 BINARY_JSON_FORMAT 時,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 之資料庫的遠端變更資料擷取 Extracts 失敗
ERROR OGG-25192 Trail file '<trail name>' is remote. Only local trail allowed for this extract.
解決方法:在 Change Data Capture Extract 的「參數檔」畫面上,移除行 TRANLOGOPTIONS ALTLOGDEST REMOTE
。
如需詳細資訊,請參閱使用 Oracle GoldenGate 進行 MySQL 。
若要建立 Distribution Paths 以傳送資料至 Oracle Cloud Infrastructure GoldenGate 或從中提取資料,請確定將根憑證新增至「憑證管理」或從屬端公事包
若要傳送資料至 OCI GoldenGate 或從中提取資料,您必須分別在內部部署的 Receiver Server 或 Marketplace Oracle GoldenGate 中的 Distribution Server 路徑或目標起始路徑。您還必須將 OCI GoldenGate 根憑證或自行簽署憑證新增至您的 Oracle GoldenGate Certificate Management (Oracle GoldenGate 21 c 或更新版本) 或從屬端公事包 (Oracle GoldenGate 19 c)。這會在您的 Oracle GoldenGate 與 OCI GoldenGate 部署之間建立信任的連線。Oracle GoldenGate 與 OCI GoldenGate 之間的 Distribution 與 Receiver Server Paths 僅支援 WebSocket Secure (WSS) 通訊協定。
變更 OCI GoldenGate 根憑證會導致 Distribution Server Path 或目標起始路徑 (位於內部部署的 Receiver Server) 或 Marketplace 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.
解決方法:若要修正此問題,請在從屬端公事包或 Service Manager 的「憑證管理」畫面中更新憑證,以使用 OCI GoldenGate Deployment Console 根憑證。在某些情況下,當 OCI GoldenGate 部署的憑證不是由根憑證直接簽署,而是透過中介憑證 (例如,可能也需要新增中介 CA 憑證) 時。
進一步瞭解:
- 如需 Oracle GoldenGate 19 c 使用者的詳細資訊,請參閱建立分送伺服器路徑使用者憑證。
- 對於 Oracle GoldenGate 21 c 或更新版本的使用者,請參閱 Create a Trusted Connection Between Oracle GoldenGate and OCI GoldenGate 。
目前只支援「摘要認證」
當您使用 Oracle Cloud Infrastructure GoldenGate 作為 Distribution Path 目標時,Oracle Cloud Infrastructure GoldenGate 目前不支援憑證型驗證。
解決方法:無。
管線
瞭解與管線有關的已知問題,以及如何解決這些問題。
ZeroETL 鏡射管線套用處理作業失敗
Error mapping from ADMIN.DBTOOLS$EXECUTION_HISTORY to <ADB ID>.ADMIN.DBTOOLS$EXECUTION_HISTORY.
解決方法:使用 ADMIN.*
建立「排除」規則,然後重新啟動管線。
如果目標資料庫時區檔案版本低於來源資料庫,Oracle Data Pump 會失敗
管線選項「開始複製之前先將現有資料複製到目標資料庫」使用 Oracle Data Pump。如果目標資料庫的時區檔案版本低於來源資料庫的時區檔案版本,Oracle Data Pump 會失敗。
解決方法:若要解決此問題,您必須升級目標資料庫的時區版本。請參閱管理 Autonomous Database 的時區檔案更新。