Configurer l'extraction pour Oracle Autonomous AI Database

Pour configurer une extraction à capturer à partir d'une base de données Autonomous AI, procédez comme suit :

Installez Oracle GoldenGate pour votre instance de base de données Autonomous AI.
Créez un déploiement pour l'environnement Oracle GoldenGate. Il s'agit du déploiement dans lequel l'extraction qui capture les données de l'instance de base de données Autonomous AI sera créée. Reportez-vous à Ajouter un déploiement.
Obtenez les informations d'identification du client de base de données Autonomous AI.

Pour établir une connexion à votre instance de base de données Autonomous AI, téléchargez le fichier d'informations d'identification client. Pour télécharger les informations d'identification client, vous pouvez utiliser la console Oracle Cloud Infrastructure Console ou la fenêtre de lancement Database Actions. Reportez-vous à Téléchargement des informations d'identification client (portefeuilles).

Remarque : si vous ne disposez pas d'un accès administrateur à la base de données Autonomous AI, vous devez demander à l'administrateur de service de télécharger et de vous fournir les fichiers d'informations d'identification.

Les étapes suivantes utilisent la panneau de lancement Database Actions pour télécharger les informations d'identification client.

Connectez-vous à votre compte Autonomous AI Database.

a. Sur la page Instance de base de données, cliquez sur Database Actions. La fenêtre de lancement Database Actions s'ouvre. La fenêtre de lancement tente de vous connecter à la base de données en tant qu'utilisateur ADMIN. En cas d'échec, vous êtes invité à saisir le nom utilisateur et le mot de passe ADMIN de la base de données.

b. Dans la fenêtre de lancement Database Actions, sous Administration, cliquez sur Télécharger les informations d'identification client (portefeuilles).

c. Entrez un mot de passe pour sécuriser le fichier ZIP d'informations d'identification client et cliquez sur Télécharger.

Remarque : le mot de passe que vous fournissez lorsque vous téléchargez le portefeuille protège le portefeuille d'informations d'identification client téléchargé.

d. Enregistrez le fichier d'informations d'identification zip sur le système local.
```
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`
```
Reportez-vous aux fichiers sqlnet.ora et tnsnames.ora et mettez-les à jour (si nécessaire) lors de la configuration d'Oracle GoldenGate pour qu'il fonctionne avec l'instance de base de données Autonomous AI.

Configurez le serveur sur lequel Oracle GoldenGate est exécuté pour se connecter à l'instance de base de données Autonomous AI.

a. Connectez-vous au serveur sur lequel Oracle GoldenGate a été installé.

b. Transférez le fichier d'informations d'identification zip que vous avez téléchargé à partir de l'instance Autonomous AI Database vers le serveur Oracle GoldenGate.

c. Sur le serveur Oracle GoldenGate, décompressez le fichier d'informations d'identification dans un nouveau répertoire, par exemple : /u02/data/adwc_credentials. Il s'agit de votre répertoire clé.

d. Pour configurer les détails de connexion, ouvrez le fichier tnsnames.ora à partir de l'emplacement du client Oracle dans l'instance Oracle GoldenGate.

e. Utilisez la chaîne de connexion avec le groupe de consommateurs de ressources LOW dbname_low, par exemple graphdb1_low, et déplacez-la vers le fichier tnsnames.ora local.

 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.

Remarque :

Le fichier fourni avec le fichier d'informations d'identification contient trois noms de service de base de données identifiables comme suit :

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

Oracle recommande d'utiliser ADWC_Database_Name_low avec Oracle GoldenGate. Reportez-vous à Noms de service de base de données prédéfinis pour la base de données Autonomous AI dans le guide Utilisation d'Oracle Autonomous AI Database sans serveur ou à Services de base de données prédéfinis dans la documentation Autonomous AI Database on Dedicated Exadata Infrastructure.

f. Modifiez le fichier tnsnames.ora dans l'instance Oracle GoldenGate afin d'inclure les détails de connexion disponibles dans le fichier tnsnames.ora dans votre répertoire de clés (répertoire dans lequel vous avez décompressé le fichier d'informations d'identification zip téléchargé à partir de la base de données Autonomous AI).

<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. Pour configurer le portefeuille, créez un fichier sqlnet.ora à l'emplacement du client Oracle dans l'instance Oracle GoldenGate.

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. Modifiez ce fichier sqlnet.ora pour inclure votre répertoire de clés.

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

Utilisez le client d'administration pour vous connecter au déploiement Oracle GoldenGate, selon que vous utilisez des microservices.
Créez des informations d'identification pour stocker l'utilisateur et le mot de passe GGADMIN. Cet utilisateur sera utilisé pour se connecter à la base de données Autonomous AI à partir de la ligne de commande, afin d'exécuter des commandes nécessitant une connexion à la base de données. Elle sera également utilisée dans le paramètre USERIDALIAS pour la connexion à la base de données d'extraction.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
Vous pouvez également utiliser la commande suivante avec high dans la chaîne de connexion, mais elle se connectera toujours avec low :
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
Connectez-vous à la base de données en utilisant DBLOGIN. L'utilisateur DBLOGIN doit être le compte utilisateur adb_alias.
```
 DBLOGIN USERIDALIAS adb_alias
```
Configurez la journalisation supplémentaire sur les tables, que vous souhaitez capturer à l'aide de ADD TRANDATA ou ADD SCHEMATRANDATA. N'oubliez pas que vous êtes connecté directement à l'instance de base de données. Il n'est donc pas nécessaire d'inclure le nom de la base de données dans ces commandes. Voici un exmaple :
```
 ADD TRANDATA HR.EMP
```
ou
```
 ADD SCHEMATRANDATA HR
```

Reportez-vous à Activation de la journalisation supplémentaire minimale dans Oracle Autonomous AI Database pour l'extraction Oracle GoldenGate.

Ajouter une table de signal d'activité
```
 ADD HEARTBEATTABLE
```
Ajoutez et configurez une extraction à capturer à partir de l'instance de base de données Autonomous AI. Pour connaître les étapes de création d'une extraction, reportez-vous à Ajouter une extraction.

L'extraction Oracle GoldenGate est conçue pour fonctionner avec l'instance de base de données Autonomous AI afin de garantir qu'elle ne capture qu'à partir d'une instance de base de données spécifique. Cela signifie que le nom d'instance de base de données n'est pas nécessaire pour les instructions TABLE ou MAP.

L'exemple suivant crée une extraction (nécessaire pour la capture à partir d'une base de données Autonomous AI) nommée exte et lui indique de commencer maintenant.

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

Pour capturer des tables spécifiques, utilisez les deux noms d'objet partie. Par exemple, pour effectuer une capture à partir de la table HR.EMP, dans votre instance de base de données Autonomous AI, utilisez cette entrée dans le fichier de paramètres d'extraction.

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

Pour répliquer HR.EMP dans COUNTRY.EMPLOYEE, l'instruction de carte doit se présenter comme suit :

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

Inscrire l'extraction auprès de l'instance de base de données Autonomous AI. Par exemple, pour inscrire une extraction nommée exte, utilisez la commande suivante :
```
 REGISTER EXTRACT exte DATABASE
```
Vous pouvez maintenant démarrer l'extraction et effectuer la réplication de données vers l'instance de base de données Autonomous AI. Voici un exemple :
```
 START EXTRACT exte
```
Le processus de configuration d'une extraction pour une base de données Autonomous AI est terminé et vous pouvez l'utiliser comme n'importe quel autre processus d'extraction.