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でシークレットおよびボールトとの接続を使用すると、接続エラーが発生する可能性があります:

回避策: OCI Vaultシークレットを使用せずに接続を再作成します:

  1. 「接続の作成」ページで、ページの下部にある「拡張オプション」を展開します。

  2. 「詳細オプション」で、「設定」を展開します。

  3. 「ボールトでのシークレットの使用」の選択を解除します。

  4. 「作成」を選択します。

または、接続で拡張オプションを使用できない場合は、以前のバージョンのデプロイメントを使用してみます。

リソース・プリンシパル使用時の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

回避方法:

  1. Cloud Shellに接続します。

  2. 次の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>

  3. 接続をデプロイに割り当てます。

  4. Amazon S3のReplicatを追加して実行します。

または、パブリックアクセスを使用しない場合は、AWS VPCエンドポイントを使用するように Amazon S3接続のバケットを構成します。OCI GoldenGateがVPCエンドポイントを使用してS3バケットにアクセスするには、VCNとAWS VPCの間にIPsec VPNも構成する必要があります。

Amazon S3のエンドポイントを設定するには、Replicatプロパティ・ファイルにgg.eventhandler.s3.urlプロパティを追加し、プライベート接続のエンドポイントを指定します。

MongoDB接続の問題のテスト

MongoDB接続でテスト接続を使用すると、エラーが発生することがあります。このエラーを無視して、OCI GoldenGateデプロイメント・コンソールでMongoDB接続をテストできます。デプロイメント・コンソールで、管理サービスのナビゲーション・メニューを開き、「構成」を選択します。MongoDB接続が資格証明としてリストされ、**「接続」**を選択して接続をテストできます。

mTLS認証を使用するAutonomous AI Database接続に必要なアクション

Autonomous AI Databaseウォレットをローテーションする場合、このデータベースへのOCI GoldenGate接続をリフレッシュして、最新のウォレット情報を取得する必要があります。

詳細は、My Oracle Support (MOS) Document 2911553.1を参照してください。

Autonomous AI Database接続をリフレッシュするには: Autonomous AI Database (Autonomous AI Transaction ProcessingまたはAutonomous AI Lakehouse)への接続を編集および保存します。接続を保存すると、ウォレットが自動的にダウンロードおよびリフレッシュされます。接続に対するその他の変更は必要ありません。

確認する手順は、次のとおりです。

  1. Autonomous AI Database接続を使用するデプロイメントのデプロイメント・コンソールを起動します。

  2. デプロイメント・コンソールで、ナビゲーション・メニューを開き、「構成」を選択します。

  3. 「資格証明」画面で、Autonomous AI 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)))

MySQLデータベースが「資格証明別名」リストに表示されない

OCI GoldenGateデプロイメント・コンソールでExtractを作成するときに、@記号を含むMySQLデータベース・ユーザー名が「資格証明別名」リストに表示されません。

回避策:リストから別の別名を選択し、次の画面でパラメータ・ファイルを手動で更新します。

ネットワーク・タイムアウトはプライベート・エンドポイントを使用するデータベース接続に影響を与えます

プライベート・エンドポイントを使用してデータベースに接続している場合、Extractプロセスを起動または停止するときにネットワーク・タイムアウトが発生する可能性があります。

回避方法:次のいずれかを実行できます。

SCANプロキシはTLSをサポートしていません

OCI GoldenGateはOracle Single Client Access Name (SCAN)ホストおよびIPをサポートしますが、SCANプロキシはTLSをサポートしません。

回避策:データベース・ノードIPを使用してRACデータベースに接続できます。

Oracleオブジェクト・ストレージ接続のユーザーOCIDが一致しない(フェデレーテッド・ユーザーのみ)

フェデレーテッド・ユーザーがOracleオブジェクト・ストレージ接続の作成時に「現在のユーザーを使用」を選択した場合、そのOCIDがシステムによって取得されたOC IDと一致しません。

回避策: Oracleオブジェクト・ストレージ接続を作成する場合は、必ず「別のユーザーの指定」を選択し、フェデレーテッド・ユーザーのOCIDを入力してください。

ユーザーOCIDを検索するには、Oracle Cloudコンソールのグローバル・ヘッダーで「プロファイル」を選択し、ユーザー名を選択します。「ユーザーの詳細」ページの「ユーザー情報」で、OCIDの「表示」を選択します。