Daten von PostgreSQL in autonome KI-Transaktionsverarbeitung replizieren

Hier erfahren Sie, wie Sie mit OCI GoldenGate Daten von einer PostgreSQL-Serverdatenbank in Autonomous AI Transaction Processing replizieren.

Bevor Sie beginnen

Um diesen Schnellstart erfolgreich abzuschließen, benötigen Sie Folgendes:

Eine PostgreSQL-Installation als Quelldatenbank (siehe Setup der Umgebung)
Port 5432 in der Sicherheitsliste Ihres VCN öffnen
Eine Autonomous AI Transaction Processing-Instanz, die als Zieldatenbank dient

Umgebung eingerichtet: PostgreSQL

So richten Sie die Umgebung für diesen Schnellstart ein:

Führen Sie die folgenden Befehle zur Installation von PostgreSQL aus.
1. PostgreSQL-Server installieren:
```
sudo yum install postgresql-server
```
2. Installieren Sie das postgresql-contrib-Modul, um diese SQL-Ausnahme zu vermeiden:
```
sudo yum install postgresql-contrib
```
3. Erstellen Sie ein neues PostgreSQL-Datenbankcluster:
```
sudo postgresql-setup --initdb
```
4. Aktivieren Sie postgresql.service:
```
sudo systemctl enable postgresql.service
```
5. Starten Sie postgresql.service:
```
sudo systemctl start postgresql.service
```
Standardmäßig sind in PostgreSQL nur lokale Verbindungen zulässig. Remotekonnektivität zu PostgreSQL zulassen.
1. Bereiten Sie unter /var/lib/pgsql/data/postgresql.conf die Datenbank für die Replikation vor.
2. Suchen und entfernen Sie die Kommentarzeichen listen_addresses = 'localhost', und ändern Sie localhost in ein Sternchen (`):
```
listen_addresses = '*'
```
3. Legen Sie die folgenden Parameter wie folgt fest:
  - wal_level = logical
  - max_replication_slots = 1
  - max_wal_senders = 1
  - track_commit_timestamp = on
  Hinweis:
  
  Konfigurieren Sie /var/lib/pgsql/data/pg_hba.conf, um sicherzustellen, dass die Clientauthentifizierung so festgelegt ist, dass Verbindungen von einem Oracle GoldenGate-Host zulässig sind. Beispiel: Fügen Sie Folgendes hinzu:
```
#Allow connections from remote hosts

host all all 0.0.0.0/0 md5
```
  Weitere Informationen finden Sie unter Die Datei pg_hba.conf.
  1. PostgreSQL-Server neu starten:
```
sudo systemctl restart postgresql.service
```
  1. Wenn Sie Oracle Cloud Compute zum Hosten von PostgreSQL verwenden, öffnen Sie Port 5432:
```
sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
```
4. Öffnen Sie Port 5432 in der Sicherheitsliste Ihres VCN.
5. Verbindung zu PostgreSQL herstellen.
```
> sudo su - postgres
> psql
```
  Hinweis: Alternativ können Sie sudo su - postgres psql eingeben, wenn das obige Beispiel nicht funktioniert.
6. PostgreSQL einrichten.
  1. Laden Sie seedSRCOCIGGLL_PostgreSQL.sql herunter, und führen Sie es aus, um die Datenbank einzurichten und die Beispieldaten zu laden.
  2. Führen Sie die folgenden Befehle aus, um den Benutzer einzurichten (stellen Sie sicher, dass Sie <password> durch ein tatsächliches Kennwort ersetzen):
```
create user ggadmin with password '<password>';
alter user ggadmin with SUPERUSER;
GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin;
```

Einrichtung der Umgebung: Autonomous AI Transaction Processing (ATP)

Laden Sie das Beispieldatenbankschema herunter, und dekomprimieren Sie es.
Entsperren Sie den GGADMIN-Benutzer.
1. Wählen Sie in der Oracle Cloud-Konsole in der Seite "Autonome KI-Datenbanken" die ATP-Instanz aus, um ihre Details anzuzeigen und auf Database Actions zuzugreifen.
2. Wählen Sie Database Actions aus, und wählen Sie Database Users aus.
3. Suchen Sie GGADMIN, wählen Sie das zugehörige Auslassungsmenü (drei Punkte) aus, und wählen Sie Bearbeiten aus.
4. Geben Sie im Bereich "Benutzer bearbeiten" das GGADMIN-Passwort ein, bestätigen Sie das Passwort, und heben Sie die Auswahl von Account ist gesperrt auf.
5. Wählen Sie Apply Changes aus.
Laden Sie das Beispielschema und die Daten des Ziels.
1. Wählen Sie im Menü "Database Actions" die Option SQL.
2. Kopieren Sie das Skript von OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql, und fügen Sie das Skript in das SQL-Arbeitsblatt hinzu.
3. Wählen Sie Skript ausführen aus. Auf der Registerkarte "Skriptausgabe" werden Bestätigungsmeldungen angezeigt.
4. Löschen Sie das SQL-Arbeitsblatt, kopieren Sie das SQL-Skript von OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql, und fügen Sie es ein.
5. Um zu prüfen, ob die Tabellen erfolgreich erstellt wurden, schließen Sie das SQL-Fenster, und öffnen Sie es erneut. Suchen Sie auf der Registerkarte "Navigator" nach dem Schema SRC_OCIGGLL, und wählen Sie dann Tabellen aus den entsprechenden Dropdown-Listen aus.

Aufgabe 1: OCI GoldenGate-Ressourcen erstellen

Für dieses Schnellstartbeispiel sind Deployments und Verbindungen sowohl für die Quelle als auch für das Ziel erforderlich.

Erstellen Sie ein Deployment für die PostgreSQL-Quelldatenbank.
Erstellen Sie ein Deployment für die Instanz der autonomen KI-Zieltransaktionsverarbeitung.
Verbindung zur PostgreSQL-Quelldatenbank erstellen.
1. Stellen Sie unter Typ sicher, dass Sie PostgreSQL-Server auswählen.
2. Geben Sie unter Datenbankname ociggll ein.
3. Geben Sie unter Host die öffentliche IP der Compute-Instanz ein, auf der PostgreSQL ausgeführt wird.
4. Geben Sie unter Port die Nummer 5432 ein.
5. Geben Sie unter Username ggadmin ein.
6. Geben Sie unter Kennwort ein Kennwort ein.
7. Wählen Sie unter Sicherheitsprotokoll die Option Nur aus.
Erstellen Sie eine Verbindung für die autonome AI-Zieltransaktionsverarbeitungsinstanz.
Erstellen Sie eine Verbindung zu GoldenGate. Weisen Sie diese Verbindung dem PostgreSQL-Quell-Deployment zu.
Weisen sie die Quellverbindung dem PostgreSQL-Quell-Deployment zu.
Weisen sie die Zielverbindung dem Oracle-Ziel-Deployment zu.

Aufgabe 2: Zusätzliches Logging aktivieren

So aktivieren Sie zusätzliches Logging:

Starten Sie die PostgreSQL GoldenGate-Deployment-Konsole:
1. Wählen Sie auf der Seite "Deployments" das PostgreSQL-Deployment aus, um die zugehörigen Details anzuzeigen.
2. Wählen Sie auf der Detailseite des PostgreSQL-Deployments die Option Konsole starten aus.
3. Geben Sie auf der Anmeldeseite der Deployment-Konsole die GoldenGate-Admin-Zugangsdaten ein, die in Aufgabe 1, Schritt 1 angegeben sind.
  
  Hinweis: Eine Anmeldung ist erforderlich, wenn IAM beim Erstellen eines Deployments nicht als Zugangsdatenspeicher ausgewählt wurde.
Wählen Sie in der Deployment-Konsole in der linken Navigationsleiste die Option DB-Verbindungen, dann die PostgreSQL-Quelldatenbank und dann Trandata aus.
Wählen Sie auf der Seite "TRANDATA" neben "TRANDATA-Informationen" die Option TRANDATA hinzufügen (Plussymbol).
Geben Sie im Bereich "Trandata" unter Schemaname src_ociggll ein, und wählen Sie Weiterleiten aus.

Hinweis: Mit dem Suchfeld können Sie nach src_ociggll suchen und prüfen, ob die Tabellen hinzugefügt wurden.

Aufgabe 3: Extracts erstellen

Fügen Sie den Change Data Capture Extract hinzu:
1. Wählen Sie in der linken Navigationsleiste die Option Extracts aus.
2. Wählen Sie auf der Seite "Extracts" die Option Extract hinzufügen (Plussymbol), und füllen Sie die Felder wie folgt aus:
  - Auf der Seite "Daten extrahieren":
    1. Wählen Sie unter Extract-Typ die Option Change Data Capture Extract aus.
    2. Geben Sie unter Prozessname einen Namen wie ECDC für den Extract an.
    3. Wählen Sie Weiter.
  - Gehen Sie auf der Seite "Exportoptionen" wie folgt vor:
    1. Wählen Sie für Quellzugangsdaten in der Dropdown-Liste Domain die Option Oracle GoldenGate aus
    2. Wählen Sie in der Dropdown-Liste Alias die PostgreSQL-Quelldatenbank aus.
    3. Geben Sie unter "Trailname extrahieren" einen aus zwei Zeichen stehenden Trailnamen wie C1 ein.
    4. Wählen Sie Weiter.
  - Ersetzen Sie auf der Seite "Parameter extrahieren" MAP *.*, TARGET *.*; durch Folgendes:
```
TABLE SRC_OCIGGLL.*;
```
3. Wählen Sie Erstellen und ausführen aus.
Fügen Sie den Extract für das erstmalige Laden hinzu:
1. Wählen Sie auf der Seite "Extracts" die Option Extract hinzufügen aus, und füllen Sie das Formular "Extract hinzufügen" wie folgt aus:
  - Auf der Seite "Daten extrahieren":
    1. Wählen Sie für den Extract-Typ die Option Initial Load Extract aus.
    2. Geben Sie unter Prozessname einen Namen wie EIL ein.
    3. Wählen Sie Weiter.
  - Gehen Sie auf der Seite "Exportoptionen" wie folgt vor:
    1. Wählen Sie für Quellzugangsdaten in der Dropdown-Liste Domain die Option Oracle GoldenGate aus.
    2. Wählen Sie in der Dropdown-Liste Alias die PostgreSQL-Datenbank aus.
    3. Geben Sie unter Trailname extrahieren einen aus zwei Zeichen stehenden Trailnamen wie I1 ein.
    4. Wählen Sie Weiter.
  - Ersetzen Sie auf der Seite "Extract-Parameter" den Inhalt des Textbereichs durch Folgendes:
```
EXTRACT EIL
USERIDALIAS PostgreSQL_Compute, DOMAIN OracleGoldenGate
EXTFILE I1, PURGE
TABLE src_ociggll.*;
```
    Hinweis: Stellen Sie sicher, dass Sie den Parameter SOURCEDB vor USERIDALIAS entfernen, bevor Sie fortfahren.
2. Wählen Sie Erstellen und ausführen aus.

Sie kehren zur Seite "Extracts" zurück, auf der Sie den Extract-Start beobachten können.

Aufgabe 4: Verteilungspfad für den Extract der erstmaligen Ladung erstellen

Wählen Sie auf der Seite "Deployments" das Oracle-Deployment Ziel aus.
Wählen Sie auf der Seite "Deployment-Details" die Option Konsole starten aus, und melden Sie sich als Admin-Benutzer an.
Wenn Sie den IAM-Zugangsdatenspeicher verwenden, fahren Sie mit dem Schritt "Verteilungspfad erstellen" fort. Wenn Sie den GoldenGate-Zugangsdatenspeicher verwenden, erstellen Sie einen Benutzer, mit dem die Quelle GoldenGate eine Verbindung zum GoldenGate-Ziel herstellt.
1. Wählen Sie im Navigationsmenü die Option Benutzeradministration aus.
2. Wählen Sie Neuen Benutzer hinzufügen (Plussymbol), füllen die Felder wie folgt auf, und wählen Sie Weiterleiten aus:
  - Geben Sie unter Benutzername ggsnet ein.
  - Wählen Sie unter Rolle die Option Operator aus.
  - Geben Sie das Kennwort zur Bestätigung zweimal ein.
Erstellen Sie in der Quell-PostgreSQL-Deployment-Konsole eine Pfadverbindung für den im vorherigen Schritt erstellten Benutzer.
1. Wählen Sie im Navigationsmenü die Option Pfadverbindungen.
2. Wählen Sie Pfadverbindung hinzufügen (Plussymbol), füllen Sie die Felder wie folgt aus, und wählen Sie Weiterleiten aus:
  - Geben Sie als Zugangsdatenalias dpuser ein.
  - Geben Sie unter "Benutzer-ID" ggsnet ein.
  - Geben Sie unter "Kennwort" dasselbe Kennwort ein, das im vorherigen Schritt verwendet wurde.
Verteilungspfad erstellen.
1. Wählen Sie in der Servicemenüleiste Pfade und dann Verteilungspfad hinzufügen (Plussymbol).
2. Füllen Sie das Formular "Pfad hinzufügen" wie folgt aus:
  - Gehen Sie auf der Seite "Pfadinformationen" wie folgt vor:
    1. Geben Sie unter Pfadname einen Namen für diesen Pfad an.
    2. Wählen Sie Weiter.
  - Gehen Sie auf der Seite {\b Source Options} wie folgt vor:
    1. Geben Sie unter Quellextrakt keinen Wert ein.
    2. Geben Sie unter Trailname den Trailnamen für den Extract des erstmaligen Ladens (I1) ein.
    3. Wählen Sie Weiter.
  - Gehen Sie auf der Seite "Zieloptionen" wie folgt vor:
    1. Wählen Sie unter Ziel die Option wss aus.
    2. Geben Sie unter Zielhost die Ziel-Deployment-URL ohne https:// oder abschließende Schrägstriche an.
    3. Geben Sie unter Portnummer 443 ein.
    4. Geben Sie unter Trailname I1 ein.
    5. Wählen Sie unter Zielauthentifizierungsmethode die Option UserID-Alias.
    6. Geben Sie unter Domain den Domainnamen an, der im vorherigen Schritt erstellt wurde.
    7. Geben Sie unter Alias den im vorherigen Schritt erstellten Alias ein (dpuser).
    8. Wählen Sie Weiter.
3. Wählen Sie Erstellen und ausführen aus.
Sie kehren zur Seite "Verteilungsservice" zurück, auf der Sie den erstellten Pfad prüfen können.
Prüfen Sie in der Ziel-Deployment-Konsole den Empfangspfad, der als Ergebnis des Verteilungspfades erstellt wurde:
1. Wählen Sie Pfade aus.
2. Prüfen Sie die Pfadinformationen.

Aufgabe 5: Replicat der erstmaligen Ladung hinzufügen

Fügen Sie im Oracle-Deployment Ziel eine Checkpoint-Tabelle hinzu.
1. Wählen Sie im Navigationsmenü DB-Verbindungen aus
2. Wählen Sie die autonome KI-Zieldatenbankinstanz und dann Checkpoints aus.
3. Wählen Sie auf der Seite "Checkpoints" die Option Checkpoint hinzufügen (Plussymbol).
4. Geben Sie im Checkpoint-Bereich unter Schematabelle SRCMIRROR_OCIGGLL.CHECKTABLE ein.
5. Klicken Sie auf Weiterleiten.
Fügen Sie das Replicat hinzu.
1. Wählen Sie im Navigationsmenü Replicats.
2. Wählen Sie auf der Seite "Replicats" die Option Replicat hinzufügen (Plussymbol) aus, und füllen Sie die Felder "Replicat hinzufügen" wie folgt aus:
  - Auf der Seite "Replicat-Informationen":
    1. Wählen Sie unter Replicat-Typ die Option Nicht integriertes Replicat aus.
    2. Geben Sie unter Prozessname einen Namen wie RIL ein.
    3. Wählen Sie Weiter aus
  - Gehen Sie auf der Seite {\b Replicat Options} wie folgt vor:
    1. Geben Sie unter Replicat-Trailname den Namen des Trails aus Aufgabe 2 (I1) ein.
    2. Wählen Sie unter Zieldaten die Domain und den Alias für die autonome KI-Datenbankverbindung aus.
    3. Wählen Sie unter Checkpoint-Tabelle die Checkpoint-Tabelle aus, die Sie in Schritt 1 erstellt haben.
    4. Wählen Sie Weiter.
  - Ersetzen Sie auf der Seite "Parameterdatei" MAP *.*, TARGET *.*; durch Folgendes:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Wählen Sie Erstellen und ausführen aus.
Sie kehren zur Seite "Replicats" zurück, auf der Sie die Replicat-Details prüfen können.
Wählen Sie das Replicat (RIL) aus, und zeigen Sie die zugehörigen Details an.
Wählen Sie Statistiken aus, und prüfen Sie die Anzahl der Einfügevorgänge. Aktualisieren Sie die Seite.
- Wenn sich die Anzahl der Einfügevorgänge nicht ändert, wurden alle Datensätze aus der erstmaligen Ladung geladen, und Sie können das Replicat (RIL) stoppen
- Wenn die Anzahl der Einfügevorgänge weiter zunimmt, aktualisieren Sie die Seite so lange, bis alle Datensätze der erstmaligen Ladung geladen sind, bevor Sie fortfahren.
Erstmalige Ladung prüfen
1. Wählen Sie in der Oracle Cloud-Konsole auf der Detailseite der autonomen KI-Datenbank die Option Datenbankaktionen und dann SQL aus.
2. Geben Sie im SQL-Tool jede der folgenden Anweisungen in das Arbeitsblatt ein, und wählen Sie Anweisung ausführen:
```
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
```
  Die Ausgabe sollte die Daten zurückgeben, die als Ergebnis des erstmaligen Ladevorgangs in die Zieldatenbanktabellen geladen wurden.

Aufgabe 6: Verteilungspfad für Change Data Capture-Extrakt erstellen

Wählen Sie in der Quell-PostgreSQL-Deployment-Konsole die Option Verteilungsservice aus.
Wählen Sie Verteilungspfad hinzufügen aus.
Füllen Sie das Formular "Pfad hinzufügen" wie folgt aus:
1. Gehen Sie auf der Seite "Pfadinformationen" wie folgt vor:
  1. Geben Sie unter Pfadname einen Namen ein.
  2. Wählen Sie Weiter.
2. Gehen Sie auf der Seite {\b Source Options} wie folgt vor:
  1. Wählen Sie unter Quellextrakt den Change Data Capture Extract (ECDC) aus.
  2. Wählen Sie unter Trailname die Traildatei für den Change Data Capture-Extrakt (C1).
  3. Wählen Sie Weiter.
3. Gehen Sie auf der Seite "Zieloptionen" wie folgt vor:
  1. Wählen Sie unter Ziel die Option wss aus.
  2. Geben Sie unter Zielhost die Ziel-Deployment-Konsolen-URL ein (Sie finden diese auf der Seite mit den Deployment-Details ohne https:// oder abschließende Schrägstriche).
  3. Geben Sie unter Portnummer 443 ein.
  4. Geben Sie unter Trailname C1 ein.
  5. Wählen Sie unter Zielauthentifizierungsmethode die Option UserID-Alias.
  6. Geben Sie unter Domain den Domainnamen ein.
  7. Geben Sie unter Alias den Alias ein.
4. Wählen Sie Pfad erstellen und ausführen aus.
Wählen Sie in der Oracle-Zielbereitstellungskonsole die Option Empfängerservice aus, und prüfen Sie den erstellten Empfangspfad.

Aufgabe 7: Replicat für Change Data Capture hinzufügen

Fügen Sie in der Oracle-Deployment-Konsole für das Ziel ein Replicat hinzu.
1. Wählen Sie im Navigationsmenü "Administration Service" die Option "Replicats".
2. Wählen Sie auf der Seite {\b Replicats} die Option {\b Add Replicat} (Plussymbol), und füllen Sie das Formular {\b Add Replicat} wie folgt aus:
  - Auf der Seite "Replicat-Informationen":
    1. Wählen Sie unter Replicat-Typ die Option Nicht integriertes Replicat aus.
    2. Geben Sie unter Prozessname einen Namen wie RCDC ein.
    3. Wählen Sie Weiter.
  - Gehen Sie auf der Seite {\b Replicat Options} wie folgt vor:
    1. Geben Sie unter Replikat-Trailname den Namen des Trails aus Aufgabe 3 (C1) ein.
    2. Wählen Sie unter Zieldaten die Domain und den Alias für die autonome KI-Datenbankverbindung aus.
    3. Wählen Sie unter Checkpoint-Tabelle die Checkpoint-Tabelle aus.
  - Ersetzen Sie MAP *.*, TARGET *.*; auf der Seite "Replicat-Parameter" durch die folgende Zuordnung:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Wählen Sie Erstellen. Führen Sie das Replicat nicht aus.
Wählen Sie auf der Seite "Replicats" das Replicat des erstmaligen Ladevorgangs (RIL) aus, und zeigen Sie die zugehörigen Details an.
Wählen Sie Statistiken aus, und prüfen Sie die Anzahl der Einfügevorgänge. Aktualisieren Sie die Seite.
- Wenn sich die Anzahl der Einfügevorgänge nicht ändert, wurden alle Datensätze aus der erstmaligen Ladung geladen. Sie können das Replicat (RIL) stoppen.
- Wenn die Anzahl der Einfügevorgänge weiter zunimmt, aktualisieren Sie die Seite solange, bis alle Datensätze des erstmaligen Ladens geladen sind, bevor Sie fortfahren.
  
  Hinweis: Wenn keine Einfügevorgänge angezeigt werden, wählen Sie Performancemetrikservice, Extrahieren und dann Datenbankstatistiken aus.
Kehren Sie zur Seite "Replicats" zurück, und starten Sie das Replicat für Change Data Capture (RCDC).
Nachdem das Replicat für Change Data Capture gestartet wurde, prüfen Sie seine Details und Statistiken, um die Anzahl der Einfügevorgänge anzuzeigen.

Replikation prüfen:

Führen Sie das folgende Skript aus, um Einfügungen in die PostgreSQL-Datenbank auszuführen:

Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);

Wählen Sie in der PostgreSQL-Deployment-Quellkonsole den Change Data Capture Extract (ECDC) aus, und wählen Sie Statistiken aus. Stellen Sie sicher, dass src_ociggll.src_city 10 Insert-Vorgänge enthält.

Hinweis: Wenn der Extract keine Einfügevorgänge erfasst hat, starten Sie den Extract ECDC neu.
Wählen Sie in der Oracle-Ziel-Deployment-Konsole den Replicat-Namen (RCDC), zeigen Sie die zugehörigen Details an, und prüfen Sie Statistiken. Stellen Sie sicher, dass SRCMIRROR_OCIGGLL.SRC_CITY 10 Einfügungen enthält.