Réplication de données d'Azure SQL Managed Instance vers Autonomous AI Transaction Processing

Découvrez comment répliquer des données d'une instance gérée par Azure SQL vers un traitement des transactions d'IA autonome à l'aide d'OCI GoldenGate.

Configuration de l'environnement : instance gérée Azure SQL

Pour mener à Bien ce démarrage rapide, vous devez :

Créez une ressource d'instance gérée SQL Azure.
Configurez l'instance gérée Azure SQL pour autoriser les connexions publiques.
Connectez-vous à l'instance gérée par SQL Azure à l'aide d'un client SQL, puis procédez comme suit :
1. Créez un utilisateur GGADMIN :
```
CREATE login GGADMIN with password = '<password>'
Create user GGADMIN for login GGADMIN
ALTER SERVER ROLE sysadmin ADD MEMBER GGADMIN
```
  Remarque : le rôle sysadmin est uniquement requis pour ajouter des tables TRANDATA et Heartbeat. Vous pouvez ensuite supprimer les privilèges sysadmin et utiliser db_owner: ALTER ROLE db_owner ADD MEMBER GGADMIN; à la place
2. Créer une base de données:
```
Create database SRC_OCIGGLL
```
3. Déconnectez-vous et reconnectez-vous en tant que nouvel utilisateur (GGADMIN) et base de données (SRC_OCIGGLL).
4. Activez la capture des données de modification (CDC) au niveau de la base de données :
```
EXECUTE sys.sp_cdc_enable_db
```
5. Créez le schéma :
```
Create schema GGADMIN
```
6. Exécutez le script SQL.

Configuration de l'environnement : traitement des transactions Autonomous AI

Téléchargez et décompressez le schéma échantillon de base de données.
Déverrouillez l'utilisateur GGADMIN.
1. Dans la console Oracle Cloud, sélectionnez votre instance ATP sur la page Bases de données autonomes pour en visualiser les détails et accéder aux actions de base de données.
2. Sélectionnez Database Actions, puis Database Users (Utilisateurs de base de données).
3. Localisez GGADMIN, puis sélectionnez son menu représentant des points de suspension (trois points) et sélectionnez Modifier.
4. Dans le panneau Modifier l'utilisateur, entrez le mot du passe GGADMIN, confirmez le mot du passe, puis désélectionnez Compte verrouillé.
5. Sélectionnez Apply Changes (Appliquer les modifications).
Chargez l'exemple de schéma et de données cible.
1. Dans le menu Database Actions, sélectionnez SQL.
2. Copiez le script d'OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql et collez- le dans la feuille d'exécution SQL.
3. Sélectionnez Exécuter le script. L'onglet Sortie de script affiche des messages de confirmation.
4. Effacez la feuille SQL, puis copiez et collez le code SQL à partir du script OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql.
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 des tables dans les listes déroulantes correspondantes.

Tâche 1 : création des 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 des déploiements pour le traitement des transactions Autonomous AI source et cible SQL Server.
Créez une connexion d'instance gérée Azure SQL pour la base de données Azure SQL à l'aide des valeurs suivantes :
1. Dans Base de données, entrez SRC_OCIGGLL.
2. Pour Port, entrez 3342 pour les adresses publiques.
3. Pour Hôte, utilisez le nom de serveur à partir de la page de détails de l'instance gérée SQL Azure dans la console Azure (par exemple, xyz.database.windows.net).
4. Pour Utilisateur, entrez GGADMIN.
5. Pour Mot de passe, entrez le mot de passe utilisateur GGADMIN.
6. Pour Protocole de sécurité, sélectionnez Plain dans la liste déroulante.
Affectez la connexion d'instance gérée SQL Azure au déploiement SQL Server.
Créez une connexion GoldenGate, puis affectez-la au déploiement SQL Server.
Créez une connexion ATP (Autonomous AI Transaction Processing).
Affectez la connexion ATP au déploiement Oracle.

Tâche 2 : créer les extractions

Créez les extractions de chargement initial et de capture des données de modification.

Sur la page Déploiements, sélectionnez le déploiement SQL Server créé dans la tâche 1.
Sur la page Détails du déploiement, sélectionnez Lancer la console.
Connectez-vous à la console source de déploiement SQL Server à l'aide des informations d'identification d'administrateur indiquées lorsque vous avez créé le déploiement dans le tâche 1.
Ajouter des informations sur la transaction
1. Dans le menu de navigation, sélectionnez Connexions de base de données, puis la base de données source et TRANDATA.
2. Sur la page TRANDATA, sélectionnez Ajouter des données de transaction (icône Plus).
3. Dans le panneau Ajouter Trandata, dans Nom du schéma, entrez SRC_OCIGGLL, puis sélectionnez Soumettre.
  
  Conseil : l'écran n'est pas actualisé lors de la soumission. Pour confirmer l'ajout des données de transaction, entrez SRC_OCIGGLL dans le champ de recherche, puis sélectionnez Rechercher. SRC_OCIGGLL est renvoyé et 6 tables sont préparées pour l'instanciation.
Ensuite, dans le menu de navigation, sélectionnez Tâches, puis Purger les données de modification et effectuez les opérations suivantes :
1. Sélectionnez l'icône Ajouter des données de modification de purge.
2. Entrez un nom.
3. Sélectionnez Soumettre.
Ajoutez l'extraction de chargement initial.
1. Sur la page Extractions, sélectionnez Ajouter une extraction (icône Plus), puis remplissez le formulaire comme suit :
  - Dans la page Extract Information :
    1. Pour Type d'extraction, sélectionnez Chargement initial.
    2. Dans Nom du processus, entrez EIL.
    3. Sélectionnez Suivant.
  - Dans la page Paramter File, remplacez MAP *.*, TARGET *.*; par ce qui suit :
```
TABLE SRC_OCIGGLL.*;
```
2. Sélectionnez Créer et exécuter.
Vous revenez à la page Extractions, où le démarrage de l'extraction peut prendre un certain temps. Vous pouvez ensuite sélectionner l'extraction pour vérifier ses détails et consulter le fichier d'état. Il répertorie toutes les tables et le nombre d'enregistrements exportés pour chacune.
Ajoutez l'extraction de capture de données de modification.
1. Dans le menu de navigation, sélectionnez Extractions.
2. Sur la page Extractions, sélectionnez Ajouter une extraction (icône Plus), puis remplissez le formulaire comme suit :
  - Dans la page Extract Information :
    1. Pour Type d'extraction, sélectionnez Capture des données de modification.
    2. Dans Nom du processus, entrez ECDC.
    3. Sélectionnez Suivant.
  - Dans la page Extract Options :
    1. Pour Informations d'identification source, sélectionnez le domaine et l'alias de la base de données source.
    2. Pour Nom de trace d'extraction, entrez un nom à deux caractères, par exemple C1.
    3. Sélectionnez Suivant.
  - Dans la page Parameter File, remplacez MAP *.*, TARGET *.*; par ce qui suit :
```
TABLE SRC_OCIGGLL.*;
```
3. Sélectionnez Créer et exécuter.

Tâche 3 : créer les chemins 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 Oracle cible et une connexion de chemin dans le déploiement SQL Server source. Si vous utilisez la banque d'informations d'identification IAM, ignorez cette étape.
Dans la console de déploiement GoldenGate d'instance gérée SQL Azure source, créez un chemin de distribution pour l'extraction de chargement initial. Dans notre exemple, nous nommons notre extraction de charge initiale, EIL.
Créer un chemin de distribution pour l'extraction de capture des données de modification. Dans notre exemple, nous nommons notre extraction de capture de données de modification, ECDC.

Tâche 4 : Créer les répliques

Lancez la console de déploiement Oracle créée à la tâche 1 et connectez-vous.
Ouvrez le menu de navigation, puis sélectionnez Connexions de base de données.
Sélectionnez Connexion à la base de données.
Ajoutez une table de points de reprise :
1. Dans le menu de navigation, sélectionnez Point de reprise.
2. Sur la page Point de reprise, sélectionnez Ajouter un point de reprise (icône Plus).
3. Dans Table de point de reprise, entrez SRCMIRROR_OCIGGLL.CHECKTABLE.
4. Sélectionnez Soumettre.
  
  La nouvelle table de points de reprise apparaît dans la liste.
Ajouter une réplication pour le chargement initial - Extraction :
1. Sélectionnez Service d'administrateur, puis Réplications.
2. Sur la page Répliques, sélectionnez Ajouter une réplication (icône Plus), puis remplissez le formulaire comme suit :
  1. Dans les informations de réplication, renseignez les champs de formulaire suivants, puis sélectionnez Suivant :
    1. Pour Type de réplication, sélectionnez Réplication non intégrée.
    2. Dans Nom de processus, entrez un nom, tel que RIL.
  2. Sur la page Options de réplication, renseignez les champs du formulaire suivants, puis sélectionnez Suivant :
    1. Dans Nom, saisissez le nom de l'élément de trace dans la tâche 2 (I1).
    2. Pour Domaine, sélectionnez le domaine pour la connexion à la base de données Autonomous AI.
    3. Pour Alias, sélectionnez l'alias de la connexion à la base de données Autonomous AI.
    4. Dans Table de points de reprise, sélectionnez cette table que vous avez créée à l'étape 4.
  3. Sur la page Paramètres, ajoutez le mapping suivant, puis sélectionnez Créer et exécuter :
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
  Vous retournez à la page de présentation, dans laquelle vous pouvez consulter les détails de la réplication.
3. Sélectionnez la réplication (RIL) et affichez les détails correspondants.
4. Sélectionnez Statistiques et vérifiez le nombre d'insertions. Actualisez la page.
  - Si le nombre d'insertions ne change pas, tous les enregistrements du chargement initial ont été chargés et vous pouvez arrêter la réplication (RIL).
  - Si le nombre d'insertions continue d'augmenter, actualisez la page jusqu'à ce que tous les enregistrements du chargement initial soient chargés avant de continuer.
Ajouter une réplication pour la capture des données de modification :
1. Sur la page Répliques, sélectionnez Ajouter une réplication (icône Plus), puis remplissez le formulaire comme suit :
  1. Dans les informations de réplication, renseignez les champs de formulaire suivants, puis sélectionnez Suivant :
    1. Pour Type de réplication, sélectionnez Réplication non intégrée.
    2. Dans Nom de processus, entrez un nom, tel que RCDC.
  2. Sur la page Options de réplication, renseignez les champs du formulaire suivants, puis sélectionnez Suivant :
    1. Dans Nom de traçabilité, saisissez le nom de l'élément de traçabilité de l'étape 2 (C1).
    2. Pour Domaine, sélectionnez le domaine pour la connexion à la base de données Autonomous AI.
    3. Pour Alias, sélectionnez l'alias de la connexion à la base de données Autonomous AI.
    4. Dans Table de points de reprise, sélectionnez cette table que vous avez créée à l'étape 4.
  3. Dans la page Paramètres, ajoutez le mapping suivant :
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
2. Choisissez Créer. N'exécutez pas la réplication.
3. Sur la page Réplications, sélectionnez la réplication pour la charge initiale (RIL) et consultez ses détails.
4. Sélectionnez Statistiques et vérifiez le nombre d'insertions. Actualisez la page.
  - Si le nombre d'insertions ne change pas, tous les enregistrements du chargement initial ont été chargés et vous pouvez arrêter la réplication (RIL).
  - Si le nombre d'insertions continue d'augmenter, actualisez la page jusqu'à ce que tous les enregistrements du chargement initial soient chargés avant de continuer.
  Remarque : si vous ne voyez aucune insertion, sélectionnez Service de mesures de performances, Extraire, puis Statistiques de base de données.
5. Revenez à la page Réplicats du service d'administration, puis démarrez la réplication RCDC.
6. Après avoir démarré RCDC, consultez ses détails et ses statistiques afin de visualiser le nombre d'insertions.