Replicat für Oracle Object Storage hinzufügen

Hier erfahren Sie, wie Sie einen Replicat-Prozess für ein Oracle Object Storage-Ziel hinzufügen und konfigurieren.

Bevor Sie beginnen

Bevor Sie das Replicat hinzufügen, müssen Sie Folgendes sicherstellen:

Replicat hinzufügen (26ai)

Prüfen Sie die für diesen Zieltyp spezifischen Voraussetzungen.

  1. Wählen Sie im Navigationsmenü der OCI GoldenGate-Deployment-Konsole die Option Replikat.

  2. Wählen Sie auf der Seite "Replicat" Replicat hinzufügen aus.

  3. Füllen Sie im Bereich "Replicat hinzufügen" auf der Seite Replicat-Informationen die Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Wählen Sie einen Replikattyp aus:

      • Klassisches Replicat

      • Koordiniertes Replicat

    • Geben Sie einen Prozessnamen ein, der nicht länger als 5 Zeichen ist.

    • Geben Sie eine Beschreibung ein, um diesen Prozess von anderen zu unterscheiden.

  4. Füllen Sie auf der Seite Replikationsoptionen die Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Replicat-Trail:

      • Geben Sie einen Namen ein.

      • Geben Sie ein Unterverzeichnis ein, wenn Sie erwarten, dass sich die Traildatei an einem anderen Speicherort als dem Standardverzeichnis befindet.

      • Wählen Sie ein Verschlüsselungsprofil aus. Wenn kein Verschlüsselungsprofil erstellt wurde, wird standardmäßig das lokale Wallet ausgewählt.

      • Wählen Sie unter Beginn den Ausgangspunkt für das Verarbeiten aus:

        • Position in Log (Standard)

        • Now

        • Benutzerdefinierte Zeit

    • Trailposition:

      • Geben Sie die Lfd Nr ein.

      • Geben Sie den RBA-Offset ein.

      • Wählen Sie Ihr Ziel aus der Dropdown-Liste aus.

        Hinweis: Je nach Ihrer Zielauswahl stehen Ihnen möglicherweise weitere Optionen zur Verfügung, z.B. Streaming-, Staging- und Merge- und Staging-Speicherorte.

    • Zielzugangsdaten:

      • Wählen Sie eine Domain aus.

      • Wählen Sie einen Alias innerhalb der angegebenen Domain aus.

      • Wählen Sie eine Checkpoint-Tabelle aus. Übernehmen Sie die Standardauswahl, oder wählen sie die Checkpointtabelle aus, die Sie für das Ziel-Deployment erstellt haben.

      • Wählen Sie die Max. Anzahl Threads aus (nur koordinierte Replicats).

  5. Füllen Sie auf der Seite Verwaltete Optionen die optionalen Felder nach Bedarf aus, und wählen Sie Weiter aus:

    • Wählen Sie einen Profilnamen aus, sofern verfügbar.

    • Kritisch für den Deployment-Zustand aktivieren.

    • Einstellungen für den automatischen Start aktivieren und konfigurieren.

  6. Auf der Seite Parameterdatei können Sie Parameter zur weiteren Konfiguration von Replicat hinzufügen. Beispiel:

    table source.table1;

    Hinweis:

    GoldenGate verwendet standardmäßig Greenwich Mean Time (GMT). Verwenden Sie SETENV, um die Standardeinstellung für Replicat außer Kraft zu setzen. Diese Änderung gilt nicht für Deployments. Beispiel:

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

  7. Konfigurieren Sie die Eigenschaften "Datei-Handler" und " OCI Event Handler" auf der Seite "Eigenschaftendatei" nach Bedarf, und klicken Sie dann auf Weiter. Beispiele für eventuell zu ändernde Eigenschaften:

    1. gg.handler.name.format: Wählen Sie aus, wie die Ausgabedaten formatiert werden sollen. Verfügbare Optionen:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Für Parkett müssen Sie zusätzliche Eigenschaften anwenden. Weitere Informationen finden Sie unter Parquet für Oracle Object Storage.

    2. gg.handler.name.fileNameMappingTemplate: Generiert Dateinamen dynamisch mit Vorlagenschlüsselwörtern.

    3. gg.handler.name.inactivityRollInterval: GoldenGate erstellt eine Datei und hält sie zum Schreiben geöffnet. Diese Eigenschaft schließt die Datei nach dem angegebenen Inaktivitätszeitraum (keine eingehenden Transaktionen) und lädt dann in Oracle Object Storage.

    4. gg.eventhandler.name.compartmentID: Geben Sie die Compartment-OCID an.

    5. gg.eventhandler.name.bucketMappingTemplate: Geben Sie den Objektspeicher-Bucketnamen ein.

    Weitere Informationen zu Datei-Writer-Handler und OCI Event-Handler-Konfiguration.

    Hinweis: Sie können nach Bedarf auch integrierbare Formatierer hinzufügen. Weitere Informationen finden Sie unter Pluggable Formatters.

  8. Wählen Sie Erstellen und ausführen aus. Wenn Sie Erstellen auswählen, können Sie das Replicat später auf der Seite "Replicats" manuell starten.

Replicat hinzufügen (21c)

  1. Wählen Sie in der OCI GoldenGate-Deployment-Konsole auf der Seite "Überblick" des Administrationsservice die Option Replicat hinzufügen (Plussymbol).

  2. Wählen Sie in der Seite "Replicat hinzufügen" einen Replicat-Typ, und wählen Sie Weiter.

    Es gibt folgende Typen von Replicats:

    • Klassisches Replicat

    • Koordiniertes Replicat

  3. Füllen Sie die folgenden Felder auf der Seite "Replicat-Optionen" aus, und wählen Sie Weiter:

    1. Geben Sie unter "Prozessname" einen Namen für den Replicat-Prozess ein.

    2. (Optional) Geben Sie unter "Beschreibung" eine kurze Beschreibung ein, mit der Sie diesen Prozess von anderen unterscheiden können.

    3. Geben Sie unter "Trailname" einen aus zwei Zeichen bestehenden Trailnamen ein.

    4. Wählen Sie unter "Ziel" im Dropdown-Menü die Option Oracle Object Storage aus.

    5. Wählen Sie für "Verfügbare Aliasnamen für OCI" den Alias in der Dropdown-Liste aus.

  4. Fügen Sie auf der Seite "Parameterdatei" Replicat-Parameter nach Bedarf hinzu, und konfigurieren Sie sie. Wählen Sie dann Weiter aus.

    table source.table1;

    Hinweis:

    GoldenGate verwendet standardmäßig Greenwich Mean Time (GMT). Verwenden Sie SETENV, um die Standardeinstellung für den Extract zu überschreiben. Diese Änderung gilt nur für den Extract-Prozess und nicht für das Deployment.

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

  5. Konfigurieren Sie die Eigenschaften "Datei-Handler" und " OCI Event Handler" auf der Seite "Eigenschaftendatei" nach Bedarf, und klicken Sie dann auf Weiter. Beispiele für eventuell zu ändernde Eigenschaften:

    1. gg.handler.name.format: Wählen Sie aus, wie die Ausgabedaten formatiert werden sollen. Verfügbare Optionen:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Für Parkett müssen Sie zusätzliche Eigenschaften anwenden. Weitere Informationen finden Sie unter Parquet für Oracle Object Storage.

    2. gg.handler.name.fileNameMappingTemplate: Generiert Dateinamen dynamisch mit Vorlagenschlüsselwörtern.

    3. gg.handler.name.inactivityRollInterval: GoldenGate erstellt eine Datei und hält sie zum Schreiben geöffnet. Diese Eigenschaft schließt die Datei nach dem angegebenen Inaktivitätszeitraum (keine eingehenden Transaktionen) und lädt dann in Oracle Object Storage.

    4. gg.eventhandler.name.compartmentID: Geben Sie die Compartment-OCID an.

    5. gg.eventhandler.name.bucketMappingTemplate: Geben Sie den Objektspeicher-Bucketnamen ein.

    Weitere Informationen zu den Eigenschaften Datei-Writer-Handler und OCI Event-Handler.

    Hinweis: Sie können nach Bedarf auch integrierbare Formatierer hinzufügen. Weitere Informationen finden Sie unter Integrierbare Formatierer verwenden.

  6. Wählen Sie Hinzufügen und ausführen aus.

Sie kehren zur Seite "Überblick" des Administrationsservice zurück, auf der Sie den Status des Replicat-Prozesses überwachen können. Wählen Sie den Prozessnamen aus, um die zugehörigen Details anzuzeigen und auf Berichte zuzugreifen.

Verwandte Inhalte

Bekannte Probleme bei Oracle Object Storage-Verbindungen

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.

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.