Extract für Oracle Autonomous AI Database konfigurieren

So konfigurieren Sie einen Extract für die Erfassung aus einer autonomen KI-Datenbank:

Installieren Sie Oracle GoldenGate für Ihre autonome KI-Datenbankinstanz.
Deployment für die Oracle GoldenGate-Umgebung erstellen Dies ist das Deployment, bei dem der Extract erstellt wird, der Daten aus der Instanz der autonomen KI-Datenbank erfasst. Siehe Deployment hinzufügen.
Rufen Sie Zugangsdaten für den Autonomous AI Database-Client ab.

Um eine Verbindung zur Instanz der autonomen KI-Datenbank herzustellen, laden Sie die Clientzugangsdatendatei herunter. Um Clientzugangsdaten herunterzuladen, können Sie die Oracle Cloud Infrastructure Console oder das Database Actions Launchpad verwenden. Siehe Clientzugangsdaten (Wallets) herunterladen.

Hinweis: Wenn Sie keinen Administratorzugriff auf die autonome KI-Datenbank haben, bitten Sie den Serviceadministrator, die Zugangsdatendateien herunterzuladen und an Sie weiterzugeben.

Mit den folgenden Schritten können Sie die Clientzugangsdaten mit dem Database Actions Launchpad herunterladen.

Melden Sie sich bei Ihrem Autonomous AI Database-Account an.

a. Klicken Sie auf der Seite Database Instance auf Database Actions. Dadurch wird das Launchpad für Database Actions gestartet. Das Launchpad versucht, Sie als ADMIN bei der Datenbank anzumelden. Wenn dies nicht erfolgreich ist, werden Sie zur Eingabe Ihres ADMIN-Benutzernamens und -Kennworts für die Datenbank aufgefordert.

b. Klicken Sie im Launchpad von Database Actions unter Administration auf Clientzugangsdaten (Wallets) herunterladen.

c. Geben Sie ein Kennwort zum Sichern der ZIP-Datei mit den Clientzugangsdaten ein, und klicken Sie auf Herunterladen.

Hinweis: Das Kennwort, das Sie beim Herunterladen des Wallets angeben, schützt das heruntergeladene Clientzugangsdaten-Wallet.

d. Speichern Sie die Zugangsdatendatei zip in Ihrem lokalen System.
```
The credentials `zip` file contains the following files:

- `cwallet.sso`

- `ewallet.p12`

- `keystore.jks`

- `ojdbc.properties`

- `sqlnet.ora`

- `tnsnames.ora`

- `truststore.jks`

- `ewallet.pem`

- `README.txt`
```
Rufen Sie die Dateien sqlnet.ora und tnsnames.ora auf, und aktualisieren Sie sie (falls erforderlich), während Sie Oracle GoldenGate so konfigurieren, dass es mit der Instanz der autonomen KI-Datenbank funktioniert.

Konfigurieren Sie den Server, auf dem Oracle GoldenGate ausgeführt wird, um eine Verbindung zur Instanz der autonomen KI-Datenbank herzustellen.

a. Melden Sie sich bei dem Server an, auf dem Oracle GoldenGate installiert wurde.

b. Übertragen Sie die Datei mit den Zugangsdaten zip, die Sie von der Instanz der autonomen KI-Datenbank heruntergeladen haben, an den Oracle GoldenGate-Server.

c. Dekomprimieren Sie die Zugangsdatendatei auf dem Oracle GoldenGate-Server in ein neues Verzeichnis. Beispiel: /u02/data/adwc_credentials. Dies ist Ihr Schlüsselverzeichnis.

d. Um die Verbindungsdetails zu konfigurieren, öffnen Sie die Datei tnsnames.ora im Speicherort des Oracle-Clients in der Oracle GoldenGate-Instanz.

e. Verwenden Sie die Verbindungszeichenfolge mit der LOW-Nutzungsgruppe dbname_low, z.B. graphdb1_low, und verschieben Sie sie in die lokale Datei tnsnames.ora.

 The connections for the default `ggadmin` user happens only with `low`, although `high` is used in the connection string, for example `graphdb1_high`.

 See *Local Naming Parameters in the tnsnames.ora File* chapter in the *Oracle AI Database Net Services Reference* guide.

Hinweis:

Die mit der Zugangsdatendatei bereitgestellte Datei enthält drei Datenbankservicenamen, die als:

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

Oracle empfiehlt, ADWC_Database_Name_low mit Oracle GoldenGate zu verwenden. Siehe Vordefinierte Datenbankservicenamen für autonome KI-Datenbank in der Dokumentation Oracle Autonomous AI Database Serverless verwenden oder Vordefinierte Datenbankservices in der autonomen KI-Datenbank auf dedizierter Exadata-Infrastruktur.

f. Bearbeiten Sie die Datei tnsnames.ora in der Oracle GoldenGate-Instanz, um die Verbindungsdetails einzuschließen, die in der Datei tnsnames.ora in Ihrem Schlüsselverzeichnis verfügbar sind (das Verzeichnis, in dem Sie die Datei mit den Zugangsdaten zip dekomprimiert haben, die aus der autonomen KI-Datenbank heruntergeladen wurde).

<div class="infoboxnote" markdown="1">

**Note:**
Allows connections on ports 1521 and 1522. However, the Oracle GoldenGate connection only works with the port 1522. This is mandatory. If you use 1521, you get the following error:

   <pre class="copy"><code>Login failed. OCI Error ORA (status = 24459-ORA-24459: OCISessionGet() timed out waiting for pool to create new connections\n)&quot;, &quot;code&quot;: &quot;OGG-08110&quot;</code></pre>

</div>

 <pre class="copy"><code> Sample Connection String   adw1_low. = (description=                  (retry_count=20)(retry_delay=3)                  (address=(protocol=tcps)(port=1522)(host=adb-preprod.us-phoenix-1.oraclecloud.com))                  (connect_data=(service_name=okd2ybgcz4mjx94_graphdb1_low.adb.oraclecloud.com))                  (security=(ssl_server_cert_dn=&quot;CN=adwc-preprod.uscom-east-1.oraclecloud.com,OU=Oracle BMCS US,O=Oracle Corporation,L=Redwood City,ST=California,C=US&quot;))                )</code></pre>

 If the database is within a firewall protected environment, you might not have direct access to the database. With an existing HTTP Proxy, you can pass the firewall with the following modifications to the `sqlnet.ora` and `tnsnames.ora`:

 - `sqlnet parameters`

 - `address modification of tns_alias`

 If Extract becomes unresponsive due to a network timeout or connection loss, then you can add the following into the connection profile in the `tnsnames.ora` file:

(DESCRIPTION) = (RECV_TIMEOUT=30) (ADDRESS_LIST =

      (LOAD_BALANCE=off)(FAILOVER=on)(CONNECT_TIMEOUT=3)(RETRY_COUNT=3) (ADDRESS = (PROTOCOL = TCP)(HOST = adb-preprod.us-phoenix-1.oraclecloud.com)(PORT = 1522))

g. Um das Wallet zu konfigurieren, erstellen Sie eine sqlnet.ora-Datei im Oracle-Clientverzeichnis in der Oracle GoldenGate-Instanz.

cd /u02/data/oci/network/admin
ls
sqlnet.ora tnsnames.ora

 See [Autonomous AI Database Client Credentials](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=OGGMP-GUID-565DF23A-2E9D-4B57-B181-DC1165B31C97) in *Using Oracle GoldenGate on Oracle Cloud Marketplace*.

h. Bearbeiten Sie diese Datei sqlnet.ora, um das Schlüsselverzeichnis aufzunehmen.

 <pre class="copy"><code>WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=&quot;/u02/data/adwc_credentials&quot;))) SSL_SERVER_DN_MATCH=yes</code></pre>

Melden Sie sich mit dem Admin-Client beim Oracle GoldenGate-Deployment an, je nachdem, ob Sie Microservices verwenden.
Erstellen Sie Zugangsdaten, um den Benutzer GGADMIN und das Kennwort zu speichern. Dieser Benutzer wird verwendet, um über die Befehlszeile eine Verbindung zur autonomen KI-Datenbank herzustellen und Befehle auszuführen, die eine Datenbankverbindung erfordern. Er wird auch im Parameter USERIDALIAS für die Extract-Datenbankverbindung verwendet.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
Sie können auch den folgenden Befehl mit high in der Verbindungszeichenfolge verwenden, aber er stellt weiterhin eine Verbindung mit low her:
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
Stellen Sie mit DBLOGIN eine Verbindung zur Datenbank her. Der Benutzer DBLOGIN muss der Accountbenutzer adb_alias sein.
```
 DBLOGIN USERIDALIAS adb_alias
```
Konfigurieren Sie zusätzliches Logging für die Tabellen, die Sie mit ADD TRANDATA oder ADD SCHEMATRANDATA erfassen möchten. Denken Sie daran, dass Sie direkt bei der Datenbankinstanz angemeldet sind. Daher müssen Sie den Datenbanknamen nicht in diese Befehle aufnehmen. Hier ein Exmaple:
```
 ADD TRANDATA HR.EMP
```
oder
```
 ADD SCHEMATRANDATA HR
```

Siehe Minimal Supplemental Logging in Oracle Autonomous AI Database for Oracle GoldenGate Extract aktivieren.

Taktbeat-Tabelle hinzufügen.
```
 ADD HEARTBEATTABLE
```
Fügen Sie einen Extract hinzu, der aus der autonomen KI-Datenbankinstanz erfasst werden soll, und konfigurieren Sie ihn. Schritte zum Erstellen eines Extract finden Sie unter Extract hinzufügen.

Oracle GoldenGate Extract wurde für die Zusammenarbeit mit der autonomen KI-Datenbankinstanz entwickelt, um sicherzustellen, dass sie nur von einer bestimmten Datenbankinstanz erfasst wird. Das bedeutet, dass der Datenbankinstanzname für keine TABLE- oder MAP-Anweisungen erforderlich ist.

Im folgenden Beispiel wird ein Extract (erforderlich für die Erfassung aus einer autonomen KI-Datenbank) mit dem Namen exte erstellt, und der Extract wird angewiesen, jetzt zu beginnen.

<pre class="copy"><code>ADD EXTRACT exte, INTEGRATED TRANLOG, BEGIN NOW</code></pre>

Um bestimmte Tabellen zu erfassen, verwenden Sie die beiden Teileobjektnamen. Beispiel: Um aus der Tabelle HR.EMP in der Instanz der autonomen KI-Datenbank zu erfassen, verwenden Sie diesen Eintrag in der Extract-Parameterdatei.

<pre class="copy"><code> TABLE HR.EMP;</code></pre>

Wenn Sie HR.EMP in COUNTRY.EMPLOYEE replizieren möchten, sieht Ihre Map-Anweisung wie folgt aus:

<pre class="copy"><code> MAP HR.EMP, TARGET COUNTRY.EMPLOYEE;</code></pre>

Registrieren Sie Extract bei der Instanz der autonomen KI-Datenbank. Beispiel: Um einen Extract mit dem Namen exte zu registrieren, verwenden Sie den folgenden Befehl:
```
 REGISTER EXTRACT exte DATABASE
```
Sie können jetzt den Extract starten und die Datenreplikation in der Instanz der autonomen KI-Datenbank ausführen. Beispiel:
```
 START EXTRACT exte
```
Damit ist der Prozess zum Konfigurieren eines Extract für eine autonome KI-Datenbank abgeschlossen, und Sie können ihn wie jeden anderen Extract-Prozess verwenden.