Replicat für Google Cloud Spanner hinzufügen

Erfahren Sie mehr über die erforderlichen Konfigurationen, bevor Sie ein Replicat für Google Cloud Spanner in einem Oracle GoldenGate-Deployment hinzufügen, sowie über die Schritte zum Hinzufügen eines Replicats.

Vor dem Hinzufügen eines Replicats

Sie müssen eine Datenbankverbindung zu Google Cloud konfigurieren, die Checkpoint-Tabelle einrichten und eine Datenbankverbindung zu Google Cloud herstellen, bevor Sie mit dem Hinzufügen eines Replicats beginnen. Optional können Sie auch die Heartbeat-Tabelle erstellen.

Stellen Sie außerdem sicher, dass Sie die Liste der unterstützten Datentypen, Objekte und Vorgänge durchgehen. Weitere Informationen finden Sie unter Google Spanner: Unterstützte Datentypen, Objekte und Vorgänge.

Erfahren Sie, wie Sie Google Cloud für Oracle GoldenGate Replicat konfigurieren.

Verbindung zu Google Cloud mit IAM authentifizieren

Google Spanner ist eine vollständig verwaltete, Cloud-native verteilte Datenbank. Für Oracle GoldenGate Replicat for Google Spanner ist die kennwortlose Authentifizierung implementiert.

Die Authentifizierung in Google Cloud Spanner unterscheidet sich grundlegend von herkömmlichen relationalen Datenbanken wie MySQL, PostgreSQL oder SQL Server, da es sich nicht um einen eigenständigen Datenbankserver handelt, der direkt angemeldet ist.

Spanner verwendet Google Cloud IAM (Identity and Access Management) und die Authentifizierung erfolgt auf Cloud-Plattformebene, nicht innerhalb von Google Spanner.

Im Folgenden werden die Schritte für die Authentifizierung einer Verbindung zu Google Cloud über IAM beschrieben:

  1. Die Benutzeranwendung wird mit Serviceaccountzugangsdaten in der JSON-Datei in Google Cloud authentifiziert.

    Serviceaccount muss die Rollen roles/Spanner.databaseUser und roles/spanner.databaseAdmin aufweisen.

  2. Zugangsdatendatei herunterladen:

    1. Melden Sie sich bei Ihrem Google-Konto unter cloud.google.com an.

    2. Klicken Sie auf Konsole, und gehen Sie zum Dashboard, in dem Sie Ihr Projekt auswählen können.

    3. Klicken Sie im Navigationsmenü auf APIs & Services, und wählen Sie Zugangsdaten aus.

    4. Wählen Sie im Menü "Zugangsdaten erstellen" die Option "Serviceaccountschlüssel".

    5. Wählen Sie den JSON-Schlüsseltyp aus, um die JSON-Zugangsdatendatei für Ihr System herunterzuladen. Diese JSON-Zugangsdatendatei muss als Eingabe beim Hinzufügen der Datenbankverbindung in der Weboberfläche angegeben werden.

    Spanner unterstützt nur die https_proxy und http_proxy nicht. Wenn Sie eine Verbindung zu Spanner hinter einem Proxyserver herstellen, muss https_proxy festgelegt werden, und http_server darf nicht festgelegt werden. Die https_proxy kann in der Umgebungsvariablen für die Konfiguration des Service Managers festgelegt werden.

Datenbankverbindung, Checkpoint-Tabelle und Heartbeat-Tabelle hinzufügen

Der Prozess zum Hinzufügen eines Replicats für Google Cloud Spanner entspricht dem Hinzufügen eines Replicats. Richten Sie die folgenden Konfigurationen ein, bevor Sie mit dem Hinzufügen eines Replicats beginnen:

  1. Hinzufügen einer Datenbankverbindung.

Datenbankverbindung auf dem Ziel hinzufügen

  1. Melden Sie sich bei der Datenbank an, nachdem Sie den Datenbankalias erstellt haben, um sicherzustellen, dass die Verbindung erfolgreich verläuft. Nachdem sich die Datenbank angemeldet hat, können Sie die Checkpoint-Tabelle hinzufügen.

  2. Klicken Sie auf das Pluszeichen neben dem Checkpoint, um das Fenster "Checkpoint hinzufügen" zu öffnen und den Namen der Checkpointtabelle im Format schema.table_name anzugeben.

    Checkpoint-Tabelle hinzufügen

  3. Klicken Sie auf Weiterleiten. Die Checkpoint-Tabelle wird hinzugefügt.

  4. Prüfen Sie im linken Navigationsbereich unter der verbundenen Datenbank die Heartbeat-Tabelle. Die Taktüberwachungstabelle ist aktiviert, um die Taktüberwachung zu überprüfen.

Heartbeat-Tabelle wird wie für Spanner-Replikat aktiviert angezeigt

Replicat für Google Spanner hinzufügen

Bevor Sie mit dem Hinzufügen eines Replicats beginnen, stellen Sie sicher, dass Sie die Datenbankverbindungen eingerichtet und die Checkpoint-Tabelle erstellt haben. Weitere Informationen finden Sie unter Datenbankverbindung hinzufügen, Checkpoint-Tabelle und Heartbeat-Tabelle.

Verwenden Sie die folgenden Schritte, um ein klassisches oder koordiniertes Replicat für Google Spanner zu erstellen:

  1. Öffnen Sie den Assistenten Replicat hinzufügen und wählen Sie Klassisches Replicat für Spanner.

    Classic Replicat für Google Spanner hinzufügen

  2. Geben Sie den Replicat-Namen an, und klicken Sie auf {\b Next}.

  3. Geben Sie die Replicat-Optionen an, wie Trailname, Zielzugangsdaten und Checkpoint-Tabellenname.

    Replicat-Optionen wie Traildateiname und Checkpoint-Tabellenname angeben

  4. Geben Sie im Fenster "Parameterdatei" die Details MAP und TARGET an, und klicken Sie auf Erstellen und ausführen. Dadurch wird das Spanner Replicat erstellt.

    Geben Sie die MAP- und TARGET-Werte in der Replicat-Parameterdatei an.

Hinweis: Wenn der nicht qualifizierte Tabellenname in der MAP-Anweisung des Replicat-Parameters verwendet wird, wird der Schemaname von GGSCHEMA übernommen, der in der GLOBALS-Datei angegeben ist. Wenn GGSCHEMA nicht im GLOBALS-Parameter definiert ist, wird das Standardschema (unbenannt) für die Replikation verwendet.

Wenn alle Spezifikationen korrekt konfiguriert sind, wird das Replicat erfolgreich ausgeführt.

GoldenGate Replicat für Google Spanner im Status "Wird ausgeführt"

Replicat mit dem Admin-Client hinzufügen

Bevor Sie mit dem Hinzufügen eines Replicats beginnen, stellen Sie sicher, dass Sie die Datenbankverbindungen eingerichtet und die Checkpoint-Tabelle und Heartbeattable erstellt haben. Weitere Informationen finden Sie unter Datenbankverbindung hinzufügen, Checkpoint-Tabelle und Heartbeat-Tabelle.

Verwenden Sie die folgenden Schritte, um ein klassisches oder koordiniertes Replicat für Google Spanner vom Admin-Client zu erstellen:

  1. Stellen Sie über die Eingabeaufforderung des Admin-Clients eine Verbindung zum Deployment her.

  2. Führen Sie den folgenden Befehl durch, um eine Datenbankverbindung zu erstellen:

    ALTER CREDENTIALSTORE ADD USER "oggh-440221@xxxxxx/srcdb;client_secrets=/scratch/creds.json" nopassword alias spanner

  3. Melden Sie sich bei den Datenbankzugangsdaten an, die Sie im vorherigen Schritt erstellt haben:

    DBLOGIN USERIDALIAS spanner

  4. Führen Sie den Kommad aus, um das Replicat hinzuzufügen:

    ADD REPLICAT nrep, classic, EXTTRAIL ea, checkpointtable ggadmin.ckpt1

    Die Ausgabe bestätigt, ob das Replicat erfolgreich hinzugefügt wurde.

  5. Mit dem Befehl EDIT PARAMS können Sie weitere Parameter für das Replicat in der Replicat-Parameterdatei hinzufügen.

    EDIT PARAMS nrep

    Geben Sie die erforderlichen Parameter in der Replicat-Parameterdatei an. Im Folgenden finden Sie ein Beispiel für eine Replicat-Parameterdatei:

    DDL EXCLUDE ALL
DDLERROR default discard
REPERROR (default,discard)
DDLOPTIONS REPORT
SOURCECATALOG spanner MAP hr.*, TARGET hr.*;

  6. Starten Sie Replicat, und stellen Sie sicher, dass es erfolgreich ausgeführt wird.

    START REPLICAT nrep

    ### Zusätzliche Referenzen {#GUID-C737B199-8182-47BC-986C-088BC1171863}

Weitere Informationen zur Fehlerbehandlung in Replicat für Google Cloud Spanner finden Sie unter Transiente und dauerhafte Fehler in Replicat für Google Cloud Spanner behandeln.