Réplication de données d'Autonomous AI Transaction Processing vers Oracle Object Storage

L'exemple de démarrage rapide ci-dessous montre comment répliquer les données d'Autonomous AI Transaction Processing vers Oracle Object Storage avec OCI GoldenGate.

Ces modes de démarrage rapide sont également disponibles sous la forme de tutoriel LiveLab. Voir l'atelier

Avant de commencer

Pour mener à Bien ce démarrage rapide, vous devez disposer des éléments suivants :

Une clé d'API créée et téléchargée à partir de la page de détails des utilisateurs de la console Oracle Cloud
Une instance Autonomous AI Transaction Processing source
Votre OCID de compartiment

Configuration de l'environnement : traitement des transactions Autonomous AI

Si aucune base de données source n'est configurée pour la réplication, procédez comme suit afin de charger un schéma échantillon à utiliser avec le démarrage rapide. Ce démarrage rapide utilise le traitement des transactions Autonomous AI pour la base de données source.

Pour configurer le traitement des transactions Autonomous AI source, procédez comme suit :

Téléchargez et décompressez le schéma échantillon de base de données.
Dans la console Oracle Cloud, sélectionnez votre instance Autonomous AI Transaction Processing (ATP) sur la page des bases de données Autonomous AI pour en visualiser les détails et accéder à Database Actions.
Déverrouillez l'utilisateur GGADMIN :
1. Sélectionnez Database actions, puis Database Users (Utilisateurs de base de données).
2. Localisez GGADMIN, puis sélectionnez son menu représentant des points de suspension (trois points) et sélectionnez Modifier.
3. Dans le panneau Modifier l'utilisateur, entrez le mot du passe GGADMIN, confirmez le mot du passe, puis désélectionnez Compte verrouillé.
4. Sélectionnez Apply Changes (Appliquer les modifications).
Chargez le schéma échantillon source et les données :
1. Dans le menu Actions Database, sous Développement, sélectionnez SQL.
2. Copiez le script d'OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql et collez- le dans la feuille SQL Worksheet.
3. Sélectionnez Exécuter le script. L'onglet Sortie de script affiche des messages de confirmation.
4. Effacez la feuille SQL Worksheet, puis copiez et collez le script SQL à partir de OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.
  
  A savoir : Vous devrez peut- être exécuter chaque instruction séparément pour que l'outil SQL parvien à exécuter les scripts.
5. Pour vérifier que les tables ont bien été créées, fermez la fenêtre SQL et rouvrez-la. Dans l'onglet Navigateur, recherchez le schéma SRC_OCIGGLL, puis sélectionnez les tables de leurs listes déroulantes respectives.
Activez la journalisation supplémentaire :
1. Effacez la feuille de calcul SQL.
2. Entrez l'instruction suivante, puis sélectionnez Exécuter l'instruction :
```
ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;
```

Tâche 1 : créer les ressources OCI GoldenGate

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 Oracle pour l'instance Autonomous AI Transaction Processing source.
Créez un déploiement Big Data pour le bucket Oracle Object Storage cible.
Créez une connexion pour l'instance Autonomous AI Transaction Processing source.
Créez une connexion pour le stockage Oracle Object Storage cible.
Créez une connexion à GoldenGate, puis affectez cette connexion au déploiement Oracle source.
Affectez la connexion Autonomous AI Transaction Processing au déploiement Oracle source.
Affectez la connexion à Oracle Object Storage au déploiement Big Data cible.

Tâche 2 : ajouter l'extraction

Sur la page Déploiements, sélectionnez le déploiement Autonomous AI Transaction Processing source.
Sur la page de détails du déploiement, sélectionnez Lancer la console.
Connectez-vous avec le nom utilisateur et le mot de passe de l'administrateur du déploiement source.
Ajoutez une extraction.

Tâche 3 : ajouter et exécuter le chemin de distribution

Si vous utilisez la banque d'informations d'identification GoldenGate, créez un utilisateur pour le chemin de distribution dans le déploiement Big Data de la cible, sinon passez à l'étape 3.
Dans la console de déploiement GoldenGate source, ajoutez une connexion de chemin pour l'utilisateur créé à l'étape 1.
1. Dans la console de déploiement GoldenGate source, sélectionnez Connexions de chemin dans la navigation de gauche.
2. Sélectionnez Ajouter une connexion de chemin (icône Plus), puis procédez comme suit :
  1. Dans Alias d'informations d'identification, entrez GGSNetwork.
  2. Saisissez le nom de l'utilisateur créé à l'étape 1 dans ID utilisateur.
  3. Indiquez le mot de passe de l'utilisateur à deux reprises pour vérification.
3. Sélectionnez Soumettre.
  
  La connexion par chemin apparaît dans la liste Connexions par chemin.
Dans la console de déploiement source, ajoutez un chemin de distribution avec les valeurs suivantes :
1. Sur la page Options source :
  - Dans Extraction source, sélectionnez l'extraction créée dans la tâche 2.
  - Dans Nom de la trace, saisissez un Nom à deux caractères, tel que E1
2. Sur la page Options cible :
  - Dans Hôte cible, entrez le domaine hôte du déploiement cible.
  - Dans Numéro de port, saisissez 443.
  - Dans Nom de la trace, saisissez un Nom à deux caractères, tel que E1
  - Dans Alias, entrez l'alias d'informations d'identification créé à l'étape 2.
Dans la console de déploiement Big Data de la cible cible, vérifiez le Chemin de destinataire créé consécutivements au chemin de distribution.
1. Dans la console de déploiement Big Data cible, sélectionnez Service de destinataire.
2. Consultez les détails du chemin. Ce chemin a été créé consécutivement à la création du chemin de distribution, à l'étape précédente.

Tâche 4 : ajouter et exécuter la réplication

Dans le menu de navigation de la console de déploiement Big Data cible, sélectionnez Réplications.
Sur la page Répliques, sélectionnez Ajouter une réplication (icône Plus), puis remplissez le formulaire comme suit :
1. Dans la page Replicat Information :
  1. Pour Type de réplication, sélectionnez Réplication classique.
  2. Dans Nom de processus, entrez un nom, tel que REP
2. Dans la page Replicat Options :
  1. Dans Nom de piste de réplication, saisissez un nom à deux caractères, tel que E1.
  2. Dans Cible, sélectionnez Oracle Object Storage.
3. Dans la page Parameter File, remplacez MAP *.*, TARGET *.*; par :
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
4. Sur la page Fichier de biens, configurez des propriétés de gestionnaire d'événements OCI selon vos besoins.
  
  Propriétés requises :
  - gg.eventhandler.oci.compartmentID : OCID du compartiment dans lequel réside le bucket Oracle Object Storage.
  - gg.handler.oci.fileNameMappingTemplate : génère des noms de fichier de manière dynamique à l'aide de mots-clés de modèle.
  Les propriétés que vous pouvez envisager de modifier sont par exemple les suivantes :
  - gg.handler.oci.format : sélectionnez le format de la sortie. json_row est le paramètre par défaut. Les options disponibles sont les suivantes :
    - delimitedtext
    - json
    - json_row
    - xml
    - avro_row_ocf
    - avro_op_ocf
      
      A savoir : Afin d'utiliser la propriété de formatage pour Oracle Object Storage, remplacez name par oci. Par exemple, gg.handler.name.format devient gg.handler.oci.format.
  - gg.handler.oci.inactivityRollInterval : GoldenGate crée un fichier et le garde ouvert pour écriture. Cette propriété ferme le fichier après la période d'inactivité indiquée (pas de transaction entrante), puis le charge dans Oracle Object Storage. Par défaut, elle est définie sur 5 secondes. Vous pouvez spécifier une durée en millisecondes (ms), secondes (s), minutes (m) ou heures (h). Par exemple, gg.handler.oci.inactivityRollInterval=10m.
  - gg.handler.oci.maxFileSize : le gestionnaire de processus d'écriture de fichier ouvre le fichier et le garde ouvert jusqu'à ce qu'il atteigne la taille de fichier maximale, en supposant qu'aucune modification de métadonnées n'ait lieu. Par défaut, la taille de fichier maximale est de 1 Go, mais vous pouvez la modifier à l'aide de cette propriété. Lorsque la taille est atteinte, le fichier est fermé et un nouveau fichier est généré. Par exemple, gg.handler.oci.maxFileSize=500m.
  - gg.handler.oci.rollOnShutdown : la valeur par défaut est True. Si cette propriété est définie sur True, GoldenGate ferme le fichier ouvert lorsque vous arrêtez le processus de réplication. Par défaut, le gestionnaire de processus d'écriture de fichier garde le fichier ouvert même si la réplication s'arrête et continue d'écrire dans ce fichier au redémarrage de la réplication. Par exemple, gg.handler.oci.rollOnShutdown=false.
  - gg.handler.oci.fileRollInterval : indique la durée pendant laquelle garder le fichier ouvert avant sa fermeture et le passage à un nouveau fichier. Par défaut, cette propriété est définie sur 7 minutes. Vous pouvez spécifier une durée en millisecondes (ms), secondes (s), minutes (m) ou heures (h). Par exemple, gg.handler.oci.fileRollInterval=10m.
  - gg.eventhandler.oci.bucketMappingTemplate : entrez le nom de bucket Oracle Object Storage.
5. Sélectionnez Créer et exécuter.

Tâche 5 : vérifier la réplication

Effectuez des mises à jour de l'instance Autonomous AI Transaction Processing source pour vérifier la réplication vers Oracle Object Storage.

Dans la console Oracle Cloud, ouvrez le menu De navigation, sélectionnez Oracle AI Database, puis Traitement des transactions par IA autonome.
Dans la liste des instances Autonomous AI Transaction Processing, sélectionnez votre instance source pour en visualiser les détails.
Sur la page de détails de la base de données, sélectionnez Database actions (Actions de base de données).

Remarque : Vous devez être connecté automatiquement. Sinon, connectez-vous avec les informations d'identification de base de données.
Sur la page d'accueil des actions Database, sélectionnez SQL.

Entrez ce qui suit dans la feuille de calcul et cliquez sur Exécuter le script.

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 du déploiement ATP source, sélectionnez le nom de l'extraction, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.
Dans la console de déploiement Big Data OCI GoldenGate cible, sélectionnez le nom de réplication, puis cliquez sur Statistiques. Vérifiez que SRC_OCIGGLL.SRC_CITY comporte 10 insertions.
Dans la console Oracle Cloud, accédez au bucket Oracle Object Storage et vérifiez son contenu.

Tâche 6 : surveiller les processus et en assurer la maintenance

En savoir plus

En savoir plus sur les détails de configuration et les formats de fichier pris en charge.