Replicat für Snowflake hinzufügen

Hier erfahren Sie, wie Sie einen Replicat-Prozess für ein Snowflake-Ziel in einer OCI GoldenGate-Datenreplikation hinzufügen.

Bevor Sie beginnen

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:

    1. Für 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

    2. Für Trail-Position:

      • Geben Sie die Lfd Nr ein.

      • Geben Sie den RBA-Offset ein.

    3. Wählen Sie unter Ziel in der Dropdown-Liste die Option Snowflake aus, und wählen Sie eine der folgenden Optionen aus:

      1. Streaming

      2. Bereitstellen und Zusammenführen, und wählen Sie einen verfügbaren Bereitstellungsort aus

    4. Für 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. (Optional) Prüfen Sie auf der Seite "Properties File" die Eigenschaft:

    • jvm.bootoptions: Erhöhen Sie den -Xmx-Wert, wenn Sie der Replicat JVM mehr Speicher hinzufügen müssen (-Xmx16g, um bis zu 16 GB Arbeitsspeicher zu belegen, -Xmx32g für bis zu 32 GB usw.).

      Hinweis: Ein bekanntes Problem im Zusammenhang mit dem Snowflake Streaming Handler ist mit dem Fehler Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper" nicht erfolgreich. Um dieses Problem zu umgehen, fügen Sie der Replicat-Eigenschaftendatei Folgendes hinzu:

      jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true

    Informationen zu den Eigenschaften dieses Ziels sowie die Unterschiede zwischen Staging- und Merge- und Streaming-Handlern finden Sie unter Snowflake in der Dokumentation Oracle GoldenGate for Distributed Applications and Analytics.

  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)

So fügen Sie ein Replicat für Snowflake in Oracle GoldenGate 21c hinzu:

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

    2. Geben Sie unter Trailname einen aus zwei Zeichen bestehenden Trailnamen an.

    3. Wählen Sie unter Ziel in der Dropdown-Liste die Zielverbindung Snowflake aus.

    4. Wählen Sie unter Verfügbare Aliasnamen Ihren Alias aus der Dropdown-Liste aus.

    5. (Optional) Externen Speicher aktivieren, um eine verfügbare Staging Area aus der Dropdown-Liste auszuwählen.

  4. Fügen Sie auf der Seite "Replicat-Parameter" die erforderlichen Mappings hinzu, und wählen Sie Weiter aus:

    Hinweis:

    • Wenn Sie Coordinated Replicat verwenden, fügen Sie die folgenden Parameter in der zweiten Zeile der Parameterdatei hinzu:
    TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/.properties

    Durch die Verwendung von koordiniertem Replicat werden mehrere Dateien erstellt. Wenn diese Option ausgelassen wird, tritt folgender Fehler auf:

    OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file "/u02/Deployment/etc/conf/ogg/001.properties" (error 2, No such file or directory).

    • Wenn es in Snowflake lang andauernde Zusammenführungsvorgänge gibt und eine hohe Anzahl von Sperren beobachtet wird, stellen Sie sicher, dass keine anderen Tabellen dieselbe Tabelle ändern. Verwenden Sie auch koordiniertes Replicat mit Vorsicht, da dies zu einer hohen Anzahl von Tabellensperren führen kann.

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

    Weitere Informationen zu SETENV.

  5. (Optional) Prüfen Sie auf der Seite "Properties File" die folgenden Eigenschaften:

    Hinweis: Diese Eigenschaften werden beim Erstellen der Verbindung festgelegt und sollten hier nicht geändert werden.

    • ggs.eventhandler.snowflake.connectionURL: JDBC-URL für die Verbindung zu Snowflake.

    • ggs.eventhandler.snowflake.UserName: Benutzername der Snowflake-Datenbank.

    • ggs.eventhandler.snowflake.Password: Kennwort für den Snowflake-Datenbankbenutzer.

    • ggs.eventhandler.snowflake.storageIntegration: Die Zugangsdaten für Snowflake Data Warehouse für den Zugriff auf die jeweiligen Objektspeicherdateien. Weitere Informationen finden Sie unter Snowflake Storage-Integration.

    • jvm.bootoptions: Erhöhen Sie den -Xmx-Wert, wenn Sie der Replicat JVM mehr Speicher hinzufügen müssen (-Xmx16g, um bis zu 16 GB Arbeitsspeicher zu belegen, -Xmx32g für bis zu 32 GB usw.)

  6. Wählen Sie Erstellen und ausführen aus. Wenn Sie Erstellen wählen, können Sie das Replicat später manuell auf der Seite "Überblick" des Administrationsservice starten.

Kehren Sie zur Seite "Überblick" des Administrationsservices zurück, auf dem Sie die Erstellung des Replicat-Prozesse anzeigen und auf Replicat-Aktionen zugreifen können.

Verwandte Inhalte

Bekannte Probleme

Fehler 37518857: OGGDAA GGS Snowflake Streaming Replicat-Fehler

Snowflake Streaming Handler nicht erfolgreich mit: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Problemumgehung: Fügen Sie der Replicat-Eigenschaftendatei Folgendes hinzu:

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true