Répliquer des données depuis YugabyteDB vers Autonomous AI Transaction Processing

Avant de commencer

Pour réussir ce démarrage rapide, assurez-vous d'avoir :

Une installation de YugabyteDB pour servir de base de données source
Instance de traitement des transactions d'intelligence artificielle autonome servant de base de données cible.
YugabyteDB préparé pour Oracle GoldenGate

Configurer YugabyteDB

Pour configurer votre instance YugabyteDB :

Si vous utilisez Oracle Cloud Compute pour héberger YugabyteDB, ouvrez le port 5433 :

sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload 
sudo firewall-cmd --list-all

Ouvrez le port 5433 dans la liste de sécurité de votre VCN.
Se connecter à YugabyteDB.
Basculer les données-échantillons.
Exécutez les commandes suivantes pour configurer l'utilisateur. Assurez-vous de remplacer le paramètre fictif <password> par un mot de passe réel.
```
create user ggadmin with password '<password>'; 
alter user ggadmin with SUPERUSER; 
GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin; 
```

Configuration de l'environnement : Traitement des transactions d'IA autonome (DAV)

Téléchargez et décompressez l'exemple de schéma de base de données.
Déverrouillez l'utilisateur GGADMIN.
1. Dans la console Oracle Cloud, sélectionnez votre instance ATP dans la page Base de données d'IA autonome pour en voir les détails et accéder à Database Actions.
2. Cliquez sur Database Actions, puis sur Database Users (Utilisateurs de base de données).
3. Localisez GGADMIN, puis cliquez sur le menu points de suspension associé (points de suspension) (trois points) et sélectionnez Modifier.
4. Dans le panneau Modifier l'utilisateur, entrez le mot de passe de GGADMIN, confirmez-le, puis désélectionnez Le compte est verrouillé.
5. Cliquez sur appliquer les modifications.
Chargez l'exemple de schéma et les données cibles.
1. Dans le menu Actions de base de données, sélectionnez SQL.
2. Cliquez et collez le script à partir de OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql dans la feuille de calcul SQL.
3. Cliquez sur exécuter le script. L'onglet Sortie du script affiche des messages de confirmation.
4. Supprimez la feuille de calcul SQL, puis copiez et collez le code SQL à partir de OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql.
5. Pour vérifier que les tables ont été créées, fermez la fenêtre SQL et rouvrez-la. Dans l'onglet Navigateur, recherchez le schéma SRC_OCIGGLL, puis sélectionnez des tables dans les listes déroulantes correspondantes.

Tâche 1 : Créer des ressources GoldenGate pour OCI

Cet exemple de démarrage rapide nécessite des déploiements et des connexions pour la source et la cible.

Créez un déploiement pour la base de données PostgreSQL source.
Créez un déploiement pour l'instance Autonomous AI Transaction Processing cible.
Créez une connexion à la base de données PostgreSQL source.
1. Pour Type, assurez-vous de sélectionner YugabyteDB.
2. Pour Nom de la base de données, entrez le nom YugabyteDB.
3. Pour Hôte, entrez l'adresse IP publique de l'instance de calcul sur laquelle YugabyteDB s'exécute.
4. Pour Port, entrez 5433.
5. Pour Nom d'utilisateur, entrez ggadmin.
6. Pour Mot de passe, entrez un mot de passe.
7. Pour Protocole de sécurité, sélectionnez Plain.
Créez une connexion pour l'instance Autonomous AI Transaction Processing cible.
Créez une connexion à GoldenGate, puis assignez cette connexion au déploiement PostgreSQL source.
Affectez la connexion source au déploiement PostgreSQL source.
Affectez la connexion cible au déploiement Oracle cible.

Tâche 2 : Activer la journalisation supplémentaire

Pour activer la journalisation supplémentaire :

Lancez la console de déploiement de GoldenGate pour PostgreSQL :
1. Dans la page Déploiements, sélectionnez le déploiement PostgreSQL pour en afficher les détails.
2. Dans la page des détails du déploiement PostgreSQL, cliquez sur Lancer la console.
3. Dans la page de connexion à la console de déploiement, entrez les données d'identification de l'administrateur GoldenGate indiquées précédemment lors de la création du déploiement.
  
  Note :
  La connexion est requise si le service IAM n'a pas été sélectionné comme magasin de données d'identification lors de la création d'un déploiement.
Dans GoldenGate 26ai, cliquez sur Connexions à la base de données dans le menu de navigation de gauche, puis sur la base de données YugabyteDB source, puis sur Trandata.
Dans la page TRANDATA, à côté de Informations TRANDATA, cliquez sur Ajouter TRANDATA (icône plus).
Dans le panneau Trandata, pour Nom du schéma, entrez src_ociggll.*, puis cliquez sur Soumettre.

Note :
Utilisez le champ de recherche pour rechercher src_ociggll et vérifier que les tables ont été ajoutées.

Tâche 3 : Créer les extraits

Ajoutez Change Data Capture Extract :
1. Dans le menu de navigation de gauche, cliquez sur Extraits,
2. Dans la page Extractions, cliquez sur Ajouter Extraire (icône plus), puis remplissez les champs comme suit :
  - Dans la page Extract Information :
    1. Pour le type Extraire, sélectionnez Extraire la saisie de modification des données.
    2. Pour Nom du processus, entrez un nom pour l'extraction, par exemple ECDC.
    3. Cliquez sur Suivant.
  - Dans la page Options d'extraction :
    1. Pour les données d'identification sources, sélectionnez Oracle GoldenGate dans la liste déroulante Domaine
    2. Sélectionnez la base de données PostgreSQL source dans la liste déroulante Alias.
    3. Pour le nom de la piste Extraire, entrez un nom de piste à deux caractères, par exemple C1.
    4. Cliquez sur Suivant.
  - Dans la page Paramètres d'extraction, remplacez MAP *.*, TARGET *.*; par ce qui suit :
```
TABLE SRC_OCIGGLL.*;
```
3. Cliquez sur Créer et exécuter.
Ajoutez le chargement initial Extraire :
1. Dans la page Extractions, cliquez sur Ajouter Extraire, puis remplissez le formulaire Ajouter Extraire comme suit :
  - Dans la page Extraire des informations :
    1. Pour le type Extraire, sélectionnez Chargement initial Extraire.
    2. Pour Nom du processus, entrez un nom, par exemple EIL.
    3. Cliquez sur Suivant.
  - Dans la page Options d'extraction :
    1. Pour les données d'identification sources, sélectionnez Oracle GoldenGate dans la liste déroulante Domaine.
    2. Sélectionnez YugabyteDB dans la liste déroulante Alias.
    3. Pour Nom de la piste d'extraction, entrez un nom de piste à deux caractères, par exemple I1.
    4. Cliquez sur Suivant.
  - Dans la page Paramètres d'extraction, remplacez le contenu de la zone de texte par ce qui suit :
```
EXTRACT EIL
USERIDALIAS YugabyteDB_Compute, DOMAIN OracleGoldenGate
EXTFILE I1, PURGE
TABLE src_ociggll.*;
```
    Note :
    Assurez-vous de supprimer le paramètre SOURCEDB devant USERIDALIAS avant de passer à autre chose.
2. Cliquez sur Créer et exécuter.

Vous revenez à la page Extractions, où vous pouvez observer le démarrage de l'extraction.

Tâche 4 : Créer Distribution Path pour Initial Load Extraire

Dans la page Déploiements, sélectionnez le déploiement Oracle cible.
Dans la page des détails du déploiement, cliquez sur Lancer la console, puis connectez-vous en tant qu'utilisateur administrateur.
Si vous utilisez le magasin de données d'identification IAM, passez à l'étape Créer un fichier Distribution Path. Si vous utilisez le magasin de données d'identification GoldenGate, créez un utilisateur avec lequel GoldenGate source se connecte à GoldenGate cible.
1. Dans le menu de navigation, cliquez sur Administration des utilisateurs.
2. Cliquez sur Ajouter un utilisateur (icône plus), remplissez les champs comme suit, puis cliquez sur Soumettre :
  - Pour Nom d'utilisateur, entrez ggsnet.
  - Pour Rôle, sélectionnez Opérateur.
  - Entrez deux fois le mot de passe pour vérification.
Dans la console de déploiement PostgreSQL de la source, créez une connexion de chemin pour l'utilisateur créé à l'étape précédente.
1. Dans le menu de navigation, cliquez sur Connexions de chemin.
2. Cliquez sur Ajouter une connexion de chemin (icône plus), remplissez les champs comme suit, puis cliquez sur Soumettre :
  - Pour l'alias de données d'identification, entrez dpuser.
  - Pour l'ID utilisateur, entrez ggsnet
  - Pour Mot de passe, entrez le même mot de passe que celui utilisé à l'étape précédente.
Créez un Distribution Path.
1. Dans la barre de menus du service, cliquez sur Distribution Service, puis sur Ajouter Distribution Path (icône plus).
2. Remplissez le formulaire Add Path comme suit :
  - Dans la page Path Information :
    1. Dans Nom du chemin, entrez un nom pour le chemin.
    2. Cliquez sur Suivant.
  - Dans la page Source Options :
    1. Pour Source Extract, laissez ce champ vide.
    2. Pour Nom de la piste, entrez le nom de la piste Initial Load Extract (I1).
    3. Cliquez sur Suivant.
  - Dans la page Target Options :
    1. Pour Protocole cible, sélectionnez wss.
    2. Pour Hôte cible, entrez l'URL de déploiement cible, sans https :// ou les barres obliques de fin.
    3. Pour Numéro de port, entrez 443.
    4. Pour Nom de la piste, entrez I1.
    5. Pour Méthode d'authentification cible, sélectionnez OAuth.
      
      Note :
      Sélectionnez Alias d'ID utilisateur si GoldenGate a été sélectionné comme magasin de données d'identification lors de la création d'un déploiement. Sinon, sélectionnez OAuth.
    6. Pour Domaine, entrez le nom du domaine créé à l'étape précédente.
    7. Pour Alias, entrez l'alias créé à l'étape précédente (dpuser).
    8. Cliquez sur Suivant.
3. Cliquez sur Créer et exécuter.
Vous retournez à la page Distribution Service où vous pouvez vérifier le chemin créé.
Dans la console de déploiement Oracle cible, vérifiez le chemin récepteur créé après le chemin de répartition :
1. Cliquez sur Receiver Service.
2. Vérifiez les détails de Distribution Path.

Tâche 5 : Ajouter un Replicat pour Initial Load

Dans le déploiement Oracle cible, ajoutez un tableau Checkpoint.
1. Dans le menu de navigation, cliquez sur Connexions à la base de données
2. Sélectionnez l'instance Base de données d'IA autonome cible, puis Checkpoints.
3. Dans la page Checkpoints, cliquez sur Ajouter un point de vérification (icône plus).
4. Dans le panneau Checkpoint, pour Table de schéma, entrez SRCMIRROR_OCIGGLL.CHECKTABLE.
5. Cliquez sur Soumettre.
Ajoutez Replicat.
1. Dans le menu de navigation, cliquez sur Replicats.
2. Dans la page Replicats, cliquez sur Ajouter Replicat (icône plus), puis remplissez les champs Ajouter Replicat comme suit :
  - Dans la page Replicat Information :
    1. Pour le type Replicat, sélectionnez Nonintegrated Replicat.
    2. Pour Nom du processus, entrez un nom, par exemple RIL.
    3. Cliquez sur Suivant
  - Dans la page Options Replicat :
    1. Pour Replicat Nom de la piste, entrez le nom de la piste de la tâche 2 (I1).
    2. Pour Données d'identification cibles, sélectionnez le domaine et l'alias pour la connexion à la base de données d'intelligence artificielle autonome.
    3. Pour Table de points de vérification, sélectionnez la table que vous avez créée à l'étape 1.
    4. Cliquez sur Suivant.
  - Dans la page Fichier de paramètres, remplacez MAP *.*, TARGET *.*; par ce qui suit :
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Cliquez sur Créer et exécuter.
  Vous retournez à la page Replicats, où vous pouvez consulter les détails Replicat.
Sélectionnez Replicat (FIL) et consultez ses informations détaillées.
Cliquez sur Statistiques et vérifiez le nombre d'insertion. Actualisez la page.
- Si le nombre d'insertions ne change pas, tous les enregistrements de Initial Load ont été chargés et vous pouvez arrêter Replicat (RIL)
- Si le nombre d'insertion continue d'augmenter, continuez d'actualiser la page jusqu'à ce que les enregistrements Initial Load soient tous chargés avant de continuer.
Vérifiez Initial Load.
1. Dans la console Oracle Cloud, dans la page des détails de la base de données d'intelligence artificielle autonome, cliquez sur Actions de base de données, puis sur SQL.
2. Dans l'outil SQL, entrez chacun des énoncés suivants dans la feuille de calcul et cliquez sur exécuter l'énoncé :
```
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
```
La sortie doit retourner les données chargées dans les tables de la base de données cible à la suite de Initial Load.

Tâche 6 : Créer un fichier Distribution Path pour Change Data Capture Extract

Dans la console du déploiement PostgreSQL source, cliquez sur Distribution Service.
Cliquez sur Ajouter Distribution Path.
Remplissez le formulaire Add Path comme suit :
1. Dans la page Path Information :
  1. Pour Nom du chemin, entrez un nom.
  2. Cliquez sur Suivant.
2. Dans la page Source Options :
  1. Pour Source Extract, sélectionnez Change Data Capture Extract (ECDC)).
  2. Pour Nom de la piste, sélectionnez le fichier de piste Change Data Capture (C1).
  3. Cliquez sur Suivant.
3. Dans la page Target Options :
  1. Pour Cible, sélectionnez wss.
  2. Pour Hôte cible, entrez l'URL de la console de déploiement cible (vous pouvez le trouver dans la page des détails du déploiement, sans https :// ni barre oblique de fin).
  3. Pour Numéro de port, entrez 443.
  4. Pour Nom de la piste, entrez C1.
  5. Pour Méthode d'authentification cible, sélectionnez OAuth.
    
    Note :
    Sélectionnez Alias d'ID utilisateur si GoldenGate a été sélectionné comme magasin de données d'identification lors de la création d'un déploiement. Sinon, sélectionnez OAuth.
  6. Pour Domaine, entrez le nom du domaine.
  7. Pour Alias, entrez l'alias.
4. Cliquez sur Créer un chemin et exécuter.
Dans la console de déploiement Oracle cible, cliquez sur Service récepteur, puis vérifiez le chemin récepteur créé.

Tâche 7 : Ajouter une valeur Replicat pour Change Data Capture

Dans la console de déploiement Oracle cible, ajoutez un Replicat.
1. Dans le menu de navigation du service d'administration, cliquez sur Replicats.
2. Dans la page Replicats, cliquez sur Ajouter Replicat (icône plus), puis remplissez le formulaire Ajouter Replicat comme suit :
  - Dans la page Replicat Information :
    1. Pour le type Replicat, sélectionnez Nonintegrated Replicat.
    2. Pour Nom du processus, entrez un nom, par exemple RCDC.
    3. Cliquez sur Suivant.
  - Dans la page Options Replicat :
    1. Pour Replicat Nom de la piste, entrez le nom de la piste de la tâche 3 (C1).
    2. Pour Données d'identification cibles, sélectionnez le domaine et l'alias pour la connexion à la base de données d'intelligence artificielle autonome.
    3. Pour Table de points de vérification, sélectionnez la table de points de vérification.
  - Dans la page Paramètres Replicat, remplacez MAP *.*, TARGET *.*; par le mappage suivant :
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Cliquez sur Créer. N'exécutez pas Replicat.
Dans la page Replicats, sélectionnez Replicat pour Initial Load (RIL) et consultez ses détails.
Cliquez sur Statistiques et vérifiez le nombre d'insertion. Actualisez la page.
- Si le nombre d'insertions ne change pas, tous les enregistrements de Initial Load ont été chargés et vous pouvez arrêter Replicat (RIL)
- Si le nombre d'insertion continue d'augmenter, continuez d'actualiser la page jusqu'à ce que les enregistrementsInitial Load soient tous chargés avant de continuer.
Note :
Si vous ne voyez aucune insertion, cliquez sur Service de mesures de performance, sélectionnez Extraire, puis cliquez sur Statistiques de la base de données.
Retournez à la page Replicats, puis lancez Replicat pour Change Data Capture (RCDC).
Après avoir lancé Replicat pour Change Data Capture, vérifiez ses Détails et ses statistiques pour voir le nombre d'insertions.

Vérifier la réplication :

Exécutez le script suivant pour effectuer des insertions dans la base de données PostgreSQL :

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

Dans la console de déploiement PostgreSQL source, sélectionnez Change Data Capture Extract (ECDC), puis cliquez sur Statistiques. Vérifiez que src_ociggll.src_city comporte 10 insertions.

Note :
Si Extract n'a saisi aucune insertion, redémarrez ECDC Extract.
Dans la console de déploiement Oracle cible, sélectionnez le nom Replicat (RCDC), consultez ses détails, puis cochez Statistiques. Vérifiez que SRCMIRROR_OCIGGLL.SRC_CITY comporte 10 insertions.