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 中使用包含密钥和 Vault 的连接时，可能会遇到连接错误：

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 密钥重新创建连接：

在“创建连接”页中，展开该页底部的高级选项。
在“高级”选项下，展开设置。
取消选择 Use secrets in vault 。
选择创建。

或者，如果您的连接中没有“高级”选项，请尝试使用早期版本的部署。

使用资源主用户时出现 Oracle 对象存储复制错误

如果 Oracle 对象存储连接使用资源主用户验证，则复制将失败，并显示以下错误：

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

解决方法：要解决此问题，请编辑连接，然后选择其他验证方法。

Apache Iceberg 与 AI 数据目录服务验证错误的连接

与 AI 数据目录服务的 Apache Iceberg 连接因令牌到期导致的验证错误而过期。如果您遇到此问题，请与 Oracle 技术支持联系。

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 中的 Amazon S3 连接出现问题 GoldenGate

如果您在使用 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 添加并运行复制。

或者，如果您不希望使用公共访问，请将 Amazon S3 连接的存储桶配置为使用 AWS VPC 端点。要使 OCI GoldenGate 使用 VPC 端点访问 S3 存储桶，还必须在 VCN 和 AWS VPC 之间配置 IPsec VPN。

要设置 Amazon S3 的端点，请将 gg.eventhandler.s3.url 属性添加到 Replicat Properties File，并为专用连接提供端点。

MongoDB 测试连接问题

将测试连接与 MongoDB 连接一起使用时，可能会遇到错误。您可以在 OCI GoldenGate 部署控制台中忽略此错误并测试 MongoDB 连接。在部署控制台中，打开管理服务的导航菜单，选择配置。您的 MongoDB 连接应列为身份证明，您可以在其中选择 ** 连接到 ** 以测试连接。

使用 mTLS 验证的自治 AI 数据库连接所需的操作

轮换自治 AI 数据库 wallet 时，必须刷新与此数据库的 OCI GoldenGate 连接以检索最新的 wallet 信息。

有关更多信息，请参见 My Oracle Support (MOS) Document 2911553.1 。

刷新 Autonomous AI Database 连接：编辑并保存与 Autonomous AI Database（Autonomous AI Transaction Processing 或 Autonomous AI Lakehouse）的连接。保存连接会自动下载并刷新 Wallet。不需要对连接进行其他更改。

要验证：

为使用自治 AI 数据库连接的部署启动部署控制台。
在部署控制台中，打开导航菜单，然后选择配置。

在“Credentials（身份证明）”屏幕上，观察 Autonomous AI Database 连接字符串。

刷新 wallet 之前，连接字符串如下所示：

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")))

刷新 wallet 后，连接字符串将更新为如下所示：

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 部署控制台中创建提取时，包含 '@' 符号的 MySQL 数据库用户名不会显示在“身份证明别名”列表中。

解决方法：从列表中选择其他别名，然后在下一个屏幕上手动更新参数文件。

网络超时会影响使用专用端点的数据库连接

如果您使用专用端点连接到数据库，则在启动或停止提取进程时可能会遇到网络超时。

解决方法：您可以执行以下操作之一：

应用部署详细信息页中的最新补丁程序。在 Deployment Information（部署信息）部分的 GoldenGate 下，为 Version（版本）选择 Upgrade（升级）。
如果您此时无法应用最新补丁程序，则可以更新连接字符串以包括 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 对象存储连接中的用户 OCID 不匹配（仅限联合用户）

如果联合用户在创建 Oracle 对象存储连接时选择“使用当前用户”，则其 OCID 与系统选取的 OCID 不匹配。

解决方法：创建 Oracle 对象存储连接时，请确保选择指定其他用户，然后输入联合用户的 OCID。

要查找用户 OCID，请在 Oracle Cloud 控制台全局标题中选择概要文件，然后选择用户名。在“用户详细信息”页的“用户信息”下，为 OCID 选择显示。