Répliquer des données d'une instance gérée Azure SQL vers Autonomous Transaction Processing

Voyez comment répliquer des données à partir d'une instance gérée Azure SQL vers une base de données Autonomous Database à l'aide d'OCI GoldenGate.

Avant de commencer

Pour terminer ce démarrage rapide, vous devez :
  1. Créez une ressource d'instance gérée Azure SQL.
  2. Configurez l'instance gérée SQL Azure pour autoriser les connexions publiques.
  3. Connectez-vous à l'instance gérée SQL Azure à l'aide d'un client SQL, puis effectuez les étapes suivantes :
    1. Créez un utilisateur GGADMIN :
      CREATE login GGADMIN with password = 'W3lcome@1234'
Create user GGADMIN for login GGADMIN
ALTER SERVER ROLE sysadmin ADD MEMBER GGADMIN

      Note :

      Le rôle sysadmin n'est requis que pour ajouter TRANDATA et Heartbeat tables. Vous pouvez ensuite supprimer les privilèges sysadmin et utiliser db_owner: ALTER ROLE db_owner ADD MEMBER GGADMIN;
    2. Créer une base de données :
      Create database SRC_OCIGGLL
    3. Déconnectez-vous et reconnectez-vous en tant qu'utilisateur nouvellement créé (GGADMIN) et base de données (SRC_OCIGGLL).
    4. Activez la capture des modifications de données (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.
  4. Configurer Autonomous Transaction Processing :
    1. Téléchargez et décompressez l'exemple de schéma de base de données.
    2. Dans la console Oracle Cloud, sélectionnez votre instance ATP dans la page des bases de données autonomes pour en voir les détails.
    3. Cliquez sur Database Actions.
    4. Déverrouillez l'utilisateur GGADMIN :
      1. Sous Administration, cliquez sur Utilisateurs de base de données.
      2. Localisez GGADMIN, puis cliquez sur le menu des points de suspension associé et sélectionnez Modifier.
      3. Dans le panneau Modifier l'utilisateur, entrez le mot de passe de GGADMIN, confirmez-le, puis désélectionnez Le compte est verrouillé.
      4. Cliquez sur Appliquer les modifications.
    5. Chargez les exemples de schéma et de données cibles :
      1. Dans le menu Database Actions, sous Développement, sélectionnez SQL.
      2. Copiez 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. Effacez la feuille de calcul SQL, puis copiez et collez-la à 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 OCI GoldenGate

Cet exemple de démarrage rapide nécessite des déploiements et des connexions pour la source et la cible.
  1. Créez des déploiements pour le serveur SQL source et la base de données Oracle cible.
  2. Créez une connexion d'instance gérée Azure pour une base de données Azure SQL, à l'aide des valeurs suivantes :
    1. Pour Base de données, entrez SRC_OCIGGLL.
    2. Pour Port, entrez 3342 pour les points d'extrémité publics.
    3. Pour Hôte, utilisez le nom du serveur à partir de la page des détails de l'instance gérée 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 de l'utilisateur GGADMIN.
    6. Pour Protocole de sécurité, sélectionnez Limpide dans la liste déroulante.
  3. Affectez la connexion d'instance de gestion Azure au déploiement SQL Server.
  4. Créez une connexion GoldenGate, puis affectez-la au déploiement SQL Server.
  5. Créez une connexion à une base de données Autonomous Transaction Processing (ATP).
  6. Affectez la connexion ATP au déploiement Oracle.

Tâche 2 : Créer les processus d'extraction

Créez Initial Load et Change Data Capture Extracts.
  1. Dans la page Deployments, sélectionnez le déploiement SQL Server créé au cours de la tâche 1.
  2. Dans la page Détails du déploiement, cliquez sur Lancer la console.
  3. Connectez-vous à la console du déploiement SQL Server source à l'aide des données d'identification d'administrateur spécifiées lors de la tâche 1.
  4. Ajoutez des informations sur les transactions
    1. Dans le menu de navigation, cliquez sur Connexions à la base de données, puis sur la base de données source, puis sur TRANDATA.
    2. Dans la page TRANDATA, cliquez sur Ajouter TRANDATA (icône plus).
    3. Dans le panneau Ajouter un trandata, pour Nom du schéma, entrez SRC_OCIGGLL, puis cliquez sur Soumettre.

      Conseil :

      L'écran n'est pas actualisé lors de la soumission. Pour vérifier que TRANDATA a été ajouté, entrez SRC_OCIGGLL dans le champ de recherche, puis cliquez sur Rechercher. SRC_OCIGGLL est retourné et 6 tables sont préparées pour l'instanciation.
  5. Ensuite, dans le menu de navigation, sélectionnez Tâches, puis Purge Change Data et effectuez les opérations suivantes :
    1. Cliquez sur Ajouter des données d'épuration de modification (icône d'ajout).
    2. Entrez un nom.
    3. Cliquez sur Soumettre.
  6. Ajoutez Initial Load Extract.
    1. Dans la page Extracts, cliquez sur Add Extract (icône plus), puis remplissez le formulaire comme suit :
      • Dans la page Informations sur Extract :
        1. Pour Type Extract, sélectionnez Initial Load.
        2. Pour Nom du processus, entrez EIL.
        3. Cliquez sur Suivant.
      • Dans la page Paramter File, remplacez MAP *.*, TARGET *.*; par ce qui suit : 
        TABLE SRC_OCIGGLL.*;
    2. Cliquez sur 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 le fichier de rapport. Il répertorie toutes les tables et le nombre d'enregistrements exportés pour chacune.
  7. Ajoutez Integrated Extract.
    1. Dans le menu de navigation, cliquez sur Extracts.
    2. Dans la page Extracts, cliquez sur Add Extract (icône plus), puis remplissez le formulaire comme suit :
      • Dans la page Informations sur Extract :
        1. Pour Type Extract, sélectionnez Change Data Capture.
        2. Pour Nom du processus, entrez ECDC.
        3. Cliquez sur Suivant.
      • Dans la page Extract Options :
        1. Pour Données d'identification sources, sélectionnez la femme et les alias de la base de données source.
        2. Pour Extract Trail Nom, entrez un nom à deux caractères, par exemple C1.
        3. Cliquez sur Suivant.
      • Dans la page Paramter File, remplacez MAP *.*, TARGET *.*; par ce qui suit : 
        TABLE SRC_OCIGGLL.*;
    3. Cliquez sur Créer et exécuter.

Tâche 3 : Créer Distribution Paths

  1. Si vous utilisez le magasin de données d'identification GoldenGate, créez un utilisateur pour Distribution Path dans le déploiement Oracle cible et une connexion de chemin dans le déploiement SQL Server source. Si vous utilisez le magasin de données d'identification IAM, ignorez cette étape.
  2. Dans la console de déploiement GoldenGate de l'instance gérée SQL Azure source, créez Distribution Path pour Initial Load Extract. Dans notre exemple, nous nommons Initial Load Extract, EIL.
  3. Créez Distribution Path pour Change Data Capture Extract. Dans notre exemple, nous nommons Change Data Capture Extract, ECDC.

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

  1. Lancez la console de déploiement Oracle et connectez-vous à celle-ci créée à la tâche 1.
  2. Ouvrez le menu de navigation, puis cliquez sur Connexions à la base de données.
  3. Cliquez sur Se connecter à la base de données.
  4. Ajoutez une valeur Checkpoint table :
    1. Dans le menu de navigation, cliquez sur Checkpoint.
    2. Dans la page Checkpoint, cliquez sur Ajouter Checkpoint (icône plus).
    3. Pour Checkpoint Table, entrez SRCMIRROR_OCIGGLL.CHECKTABLE.
    4. Cliquez sur Soumettre.
      La nouvelle Checkpoint table apparaît dans la liste.
  5. Ajoutez une valeur Replicat pour Initial Load Extract :
    1. Cliquez sur Service d'administration, puis sur Replicats.
    2. Dans la page Replicats, cliquez sur Ajouter Replicat (icône plus), puis remplissez le formulaire comme suit :
      1. Dans les informations Replicat, remplissez les champs suivants du formulaire, puis cliquez sur Suivant :
        1. Pour type Replicat, sélectionnez Nonintegrated Replicat.
        2. Pour Nom du processus, entrez un nom, par exemple RIL.
      2. Dans la page Options Replicat, remplissez les champs suivants du formulaire, puis cliquez sur Suivant :
        1. Pour Nom, entrez le nom de la piste de la tâche 2 (I1).
        2. Pour Domaine, sélectionnez le domaine de la connexion à Autonomous Database.
        3. Pour Alias, sélectionnez l'alias de la connexion Autonomous Database.
        4. Pour Checkpoint table, sélectionnez Checkpoint table que vous avez créé à l'étape 4.
      3. Dans la page Paramètres, ajoutez le mappage suivant, puis cliquez sur Créer et exécuter :
        MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;

      Vous retournez à la page Aperçu, où vous pouvez consulter les détails de Replicat.

    3. Sélectionnez Replicat (RIL) et consultez ses Détails.
    4. Cliquez sur Statistiques et vérifiez le nombre d'insertions. Actualisez la page.
      • Si le nombre d'insertion 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.
  6. Ajoutez une valeur Replicat pour Change Data Capture :
    1. Dans la page Replicats, cliquez sur Ajouter Replicat (icône plus), puis remplissez le formulaire comme suit :
      1. Dans les informations Replicat, remplissez les champs suivants du formulaire, puis cliquez sur Suivant :
        1. Pour type Replicat, sélectionnez Réplication non intégrée.
        2. Pour Nom du processus, entrez un nom, par exemple RCDC.
      2. Dans la page Options Replicat, remplissez les champs suivants du formulaire, puis cliquez sur Suivant :
        1. Pour Nom de la piste, entrez le nom de la piste de la tâche 2 (C1).
        2. Pour Domaine, sélectionnez le domaine de la connexion à Autonomous Database.
        3. Pour Alias, sélectionnez l'alias de la connexion Autonomous Database.
        4. Pour Checkpoint table, sélectionnez Checkpoint table que vous avez créé à l'étape 4.
      3. Dans la page Paramètres, ajoutez le mappage suivant :
        MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
    2. Cliquez sur Créer. Ne pas exécuter Replicat.
    3. Dans la page Replicats, sélectionnez Replicat pour Initial Load (RIL) et consultez ses Détails.
    4. Cliquez sur Statistiques et vérifiez le nombre d'insertions. Actualisez la page.
      • Si le nombre d'insertion 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.

        Note :

        Si vous ne voyez aucune insertion, cliquez sur Performance Metrics Service, sélectionnez Extract, puis cliquez sur Statistiques de la base de données.
    5. Retournez à la page Administration Service Replicats, puis démarrez RCDC Replicat.
    6. Après avoir démarré RCDC, vérifiez ses détails et ses statistiques pour voir le nombre d'insertion.