Bekannte Probleme bei OCI GoldenGate-Verbindungen

Erfahren Sie mehr über bekannte Probleme im Zusammenhang mit Verbindungen und wie Sie diese umgehen.

Oracle AI Data Platform: Resource Principal-Authentifizierung

Bei der Resource Principal-Authentifizierung für Oracle AI Data Platform-Verbindungen ist der folgende Fehler aufgetreten:

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].

Problemumgehung: Bearbeiten Sie die Verbindung, und wählen Sie eine andere Authentifizierungsmethode aus. Beispiel: Aktuellen Mandanten und Benutzer verwenden oder Anderen Mandanten und Benutzer angeben.

Fehler bei der Verwendung von Verbindungen mit Secrets

Konnektivitätsfehler können auftreten, wenn Sie Verbindungen mit Secrets und Vaults in den folgenden Versionen von OCI GoldenGate verwenden:

Problemumgehung: Erstellen Sie die Verbindung neu, ohne OCI Vault Secrets zu verwenden:

  1. Blenden Sie auf der Seite "Verbindung erstellen" unten auf der Seite Erweiterte Optionen ein.

  2. Erweitern Sie unter "Erweiterte Optionen" die Option Einstellungen.

  3. Heben Sie die Auswahl von Secrets in Vault verwenden auf.

  4. Wählen Sie Erstellen.

Wenn die erweiterten Optionen in Ihrer Verbindung nicht verfügbar sind, versuchen Sie, eine frühere Version des Deployments zu verwenden.

Oracle Object Storage-Replikationsfehler bei Verwendung von Resource Principal

Wenn Ihre Oracle Object Storage-Verbindung die Resource Principal-Authentifizierung verwendet, verläuft das Replicat mit dem folgenden Fehler nicht erfolgreich:

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

Problemumgehung: Um dieses Problem zu umgehen, bearbeiten Sie die Verbindung, und wählen Sie dann eine andere Authentifizierungsmethode aus.

Authentifizierungsfehler bei Apache Iceberg-Verbindung zum AI Data Catalog-Service

Apache Iceberg-Verbindungen zum AI Data Catalog-Service laufen aufgrund eines Authentifizierungsfehlers ab, der durch Tokenablauf verursacht wird. Falls dieses Problem auftritt, wenden Sie sich an Oracle Support.

Apache Iceberg NoSuchFileException-Fehler

Wenn bei der Verwendung von Apache Iceberg-Verbindungen der folgende Fehler auftritt, öffnen Sie ein Supportticket, geben Sie die Details und die Fehlermeldung weiter:

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

Java.net.UnknownHostException-Fehler bei Amazon S3- und Google Cloud-Speicherverbindungen

Bei Amazon S3- und Google Cloud Storage-Verbindungen mit gemeinsam genutzten Endpunkten treten Java.net.UnknownHostException-Fehler auf.

Problemumgehung: Bearbeiten Sie die Verbindung, und ändern Sie die Traffic-Routingmethode in Dediziert, oder wählen Sie Dediziert aus, wenn Sie Amazon S3- und Google Cloud Storage-Verbindungen erstellen.

Problem mit Amazon S3-Verbindungen in OCI GoldenGate

Wenn bei der Verwendung von Amazon S3-Verbindungen der folgende Fehler auftritt, öffnen Sie ein Supportticket, geben Sie die Details und die Fehlermeldung weiter.

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

Workaround:

  1. Verbindung zu Cloud Shell herstellen.

  2. Erstellen Sie eine neue Amazon S3-Verbindung mit dem folgenden CLI-Beispiel:

    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. Weisen Sie die Verbindung zu Ihrem Deployment zu.

  4. Replicat für Amazon S3 hinzufügen und ausführen

Wenn Sie keinen öffentlichen Zugriff verwenden möchten, konfigurieren Sie alternativ die Buckets Ihrer Amazon S3-Verbindung für die Verwendung von AWS VPC-Endpunkten. Damit OCI GoldenGate mit VPC-Endpunkten auf Ihren S3-Bucket zugreifen kann, müssen Sie auch ein IPsec-VPN zwischen Ihrem VCN und der AWS VPC konfigurieren.

Um den Endpunkt für Amazon S3 festzulegen, fügen Sie die Eigenschaft gg.eventhandler.s3.url der Replicat-Eigenschaftendatei hinzu, und geben Sie den Endpunkt für die private Verbindung an.

MongoDB Verbindungsproblem testen

Bei der Verwendung der Testverbindung mit MongoDB-Verbindungen ist möglicherweise ein Fehler aufgetreten. Sie können diesen Fehler ignorieren und MongoDB-Verbindungen in der OCI GoldenGate-Deployment-Konsole testen. Öffnen Sie in der Deployment-Konsole das Navigationsmenü für den Administrationsservice, und wählen Sie Konfiguration aus. Die MongoDB-Verbindung muss als Zugangsdaten aufgeführt werden. Hier können Sie **Verbindung mit ** herstellen, um die Verbindung zu testen.

Aktion erforderlich für autonome AI-Datenbankverbindungen, die mTLS-Authentifizierung verwenden

Wenn ein autonomes AI-Datenbank-Wallet rotiert wird, muss die OCI GoldenGate-Verbindung zu dieser Datenbank aktualisiert werden, um die neuesten Wallet-Informationen abzurufen.

Weitere Informationen finden Sie im My Oracle Support-(MOS-)Dokument 2911553.1.

So aktualisieren Sie eine autonome KI-Datenbankverbindung: Bearbeiten und speichern Sie die Verbindung zur autonomen KI-Datenbank (Autonomous AI Transaction Processing oder Autonomous AI Lakehouse). Beim Speichern der Verbindung wird das Wallet automatisch heruntergeladen und aktualisiert. Es sind keine weiteren Änderungen an der Verbindung erforderlich.

Überprüfen Sie:

  1. Starten Sie die Deployment-Konsole für ein Deployment, das die autonome KI-Datenbankverbindung verwendet.

  2. Öffnen Sie in der Deployment-Konsole das Navigationsmenü, und wählen Sie Konfiguration aus.

  3. Prüfen Sie auf dem Bildschirm "Zugangsdaten" die Verbindungszeichenfolge der autonomen KI-Datenbank.

    Bevor das Wallet aktualisiert wird, sieht die Verbindungszeichenfolge wie folgt aus:

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

    Nachdem das Wallet aktualisiert wurde, wird die Verbindungszeichenfolge wie folgt aktualisiert:

    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-Datenbanken werden nicht in der Liste "Zugangsdatenalias" angezeigt

MySQL-Datenbankbenutzernamen, die ein "@"-Symbol enthalten, werden beim Erstellen eines Extract in der OCI GoldenGate-Deployment-Konsole nicht in der Liste "Zugangsdatenalias" angezeigt.

Problemumgehung: Wählen Sie in der Liste einen anderen Alias aus, und aktualisieren sie dann die Parameterdatei auf der nächsten Seite manuell.

Netzwerktimeouts wirken sich auf Datenbankverbindungen mit privaten Endpunkten

Wenn Sie mit einem privaten Endpunkt eine Verbindung zu einer Datenbank herstellen, kann es beim Starten oder Stoppen der Extract-Prozesse zu Netzwerktimeouts kommen.

Problemumgehung: Sie können eine der folgenden Aktionen ausführen:

SCAN-Proxys unterstützen TLS nicht

OCI GoldenGate unterstützt zwar Oracle Single Client Access Name-(SCAN-)Hosts und -IPs, doch der SCAN-Proxy unterstützt kein TLS.

Workaround: Sie können mit der Datenbankknoten-IP eine Verbindung zu einer RAC-Datenbank herstellen.

Nicht übereinstimmende Benutzer-OCID in Oracle Object Storage-Verbindung (nur föderierte Benutzer)

Wenn ein föderierter Benutzer beim Erstellen einer Oracle Object Storage-Verbindung die Option Aktuelle Benutzer verwenden auswählt, stimmt seine OCID nicht mit der vom System erfassten OCIDs überein.

Problemumgehung: Stellen Sie beim Erstellen einer Oracle Object Storage-Verbindung sicher, dass Sie Anderen Benutzer angeben auswählen und dann die OCID des föderierten Benutzers eingeben.

Wenn Sie die Benutzer-OCID suchen möchten, wählen Sie im globalen Header der Oracle Cloud-Konsole die Option Profil aus, und wählen Sie dann den Benutzernamen. Wählen Sie auf der Seite "Benutzerdetails" unter "Benutzerinformationen" die Option Anzeigen für die OCID aus.