Créer des ressources de pipeline

Découvrez comment créer les ressources nécessaires à l'utilisation des pipelines.

Rubriques connexes

Création de connexions

Les pipelines OCI GoldenGate prennent en charge les connexions Oracle Database. Avant de créer un pipeline, veillez à préparer la base de données pour GoldenGate, puis à créer des connexions aux bases de données source et cible.

Remarques :

Si vous effectuez une réplication à partir d'une source de base de données AI autonome vers une cible qui n'est pas une base de données AI autonome, vous devez décompresser le portefeuille de base de données AI autonome source vers /u01/targetwallet sur la base de données cible. DBLINK est créé de la base de données cible vers la base de données source.

Vous pouvez également créer des connexions source et cible de connexion dans le workflow Créer un pipeline.

Créer des pipelines

Avant de commencer :
Effectuez les opérations suivantes :
  • Vérifiez les versions de base de données source et cible. La version de base de données cible doit être supérieure à celle de la base de données source.
  • Vérifiez et configurez l'unicité des lignes dans les tables de base de données afin d'éviter les problèmes de clé primaire avec la mise en miroir ZeroETL. Les clés primaires identifient de manière unique un enregistrement ou une ligne dans une table de base de données. Reportez-vous à Vérification de l'unicité des lignes dans les tables source et cible.
  • En tant qu'utilisateur disposant de privilèges d'administration pour la base de données cible, accordez les privilèges suivants à l'utilisateur GGADMIN pour la mise en miroir ZeroETL :
    GRANT DWROLE TO GGADMIN;
GRANT DATAPUMP_CLOUD_EXP TO GGADMIN;
GRANT DATAPUMP_CLOUD_IMP TO GGADMIN;
GRANT EXECUTE ON DBMS_CLOUD_ADMIN TO GGADMIN;
GRANT CREATE DATABASE LINK TO GGADMIN;
    En outre, pour les bases de données sans Autonomous AI, ajoutez les éléments suivants pour le chargement initial :
    GRANT DATAPUMP_EXP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT DATAPUMP_IMP_FULL_DATABASE TO GGADMIN CONTAINER=CURRENT;
GRANT CREATE DATABASE LINK TO GGADMIN CONTAINER=CURRENT;
    Pour Capturer et appliquer dans des bases de données autres que Autonomous AI Database, reportez-vous à Préparation des utilisateurs et des privilèges de base de données pour Oracle.
  • Vérifiez la vue DBA_GOLDENGATE_SUPPORT_MODE sur la base de données source qui affiche des informations sur le niveau de prise en charge du processus de capture Oracle GoldenGate pour les tables de la base de données.
  • Ajoutez les stratégies minimales requises pour les pipelines GoldenGate.

Remarques :

If replicating data from Autonomous AI Database to a non-Autonomous AI Database, you must turn off GLOBAL_NAMES on your non-Autonomous AI Database. Exécutez la commande suivante :
ALTER SYSTEM SET GLOBAL_NAMES = FALSE;

Pour en savoir plus, reportez-vous à l'étape 4 de Création de liens de base de données à partir d'autres bases de données vers une base de données d'IA autonome.

Pour créer un pipeline, procédez comme suit :
  1. Sur la page Aperçu d'OCI GoldenGate, dans le menu GoldenGate, cliquez sur Pipelines.

    Vous pouvez également cliquer sur Data Fabric, puis sur Créer un pipeline.

  2. Sur la page Pipelines, cliquez sur Créer un pipeline.
  3. Dans le panneau Créer un pipeline, renseignez les champs suivants, puis cliquez sur Créer un pipeline :
    1. Dans Nom, saisissez le nom du pipeline.
    2. (Facultatif) Dans Description, entrez une description permettant de distinguer ce pipeline des autres.
    3. Dans Compartiment, sélectionnez le compartiment dans lequel créer le pipeline.
    4. Sélectionnez un type de licence.
    5. Sélectionnez vos connexions source et cible dans les listes déroulantes.

      Remarques :

      • Si vous n'avez pas encore créé de connexion, cliquez sur Créer une connexion pour commencer.
      • Si vous utilisez une connexion avec une adresse partagée comme source ou cible, vous devez également sélectionner un sous-réseau.
    6. (Facultatif) Cliquez sur Afficher les options avancées pour configurer les options de processus :
      • Copier les données existantes avant la réplication en cours : sélectionnez cette option pour effectuer un chargement initial des données. Pour les tables existantes, vous pouvez choisir :
        • Tronquer : supprime les lignes existantes, puis charge les lignes à partir de la source.
        • Remplacer : supprime la table existante, puis la crée et la charge à partir de la source.
        • Ajouter : laisse les lignes existantes inchangées et charge les lignes à partir de la source.
        • Ignorer : permet de quitter la table telle quelle et de passer à l'objet suivant.
      • Remplacer les modifications de schéma : lorsque cette option est sélectionnée, choisissez l'action à effectuer sur les schémas existants lorsque le processus rencontre une erreur :
        • Mettre fin : annulez la transaction et arrêtez le traitement.
        • Annuler : consignez l'erreur dans le fichier de rebut et poursuivez le traitement.
        • Ne pas prendre en compte : ignore l'erreur et poursuit le traitement.
      • Action en cas d'erreur LMD : sélectionnez l'action à effectuer sur les données existantes lorsque le processus rencontre une erreur LMD :
        • Mettre fin
        • Annuler
        • Ne pas prendre en compte
      • Redémarrer après l'échec : sélectionnez cette option pour activer le redémarrage automatique si le processus s'arrête pour une raison quelconque.
      • Démarrer le pipeline à l'aide du mapping par défaut : démarre le pipeline immédiatement après sa création avec les règles de mapping 1:1 par défaut. Si cette option n'est pas sélectionnée, vous pouvez configurer les mises en correspondance de règles après leur création, puis démarrer manuellement le pipeline.

Ajouter des règles de mise en correspondance

Pour prévisualiser, ajouter ou supprimer des règles de mappage :
  1. Sur la page d'informations Pipeline, sélectionnez Règles de mise en correspondance.
  2. Dans la liste des règles de mise en correspondance, vous pouvez vérifier ou modifier les règles de mise en correspondance actuelles et :
    • Aperçu : vérifiez l'impact des règles de mise en correspondance sur les schémas et les tables inclus dans la réplication.
    • Ajouter : identifiez les tables et les schémas à inclure ou à exclure. Vous pouvez utiliser le nom d'objet complet ou des caractères génériques à la place de n'importe quelle partie du nom d'objet. Pour plus d'informations, reportez-vous à Utilisation de caractères génériques dans les noms d'objet de base de données.
    • Enlever : enlevez les règles de mise en correspondance.

Activer les journaux de pipeline

  1. Sur la page Pipelines, sélectionnez le pipeline pour lequel activer la journalisation.
  2. Sur la page Détails des pipelines, sélectionnez Journaux.
  3. Dans la liste des journaux de pipeline, sélectionnez Activer le journal dans le menu Actions des événements critiques.
  4. Dans le panneau Activer le journal, procédez comme suit :
    1. Dans Nom de journal, saisissez un nom.
    2. Dans la liste déroulante Compartiment, sélectionnez un compartiment.
    3. Pour Groupe de journaux, vous pouvez effectuer les opérations suivantes :
      • Sélectionner un groupe dans la liste déroulante
      • Créez un groupe
      • Laissez-la vide et un groupe par défaut est automatiquement affecté
    4. Dans Conservation de journal, sélectionnez le nombre de mois dans la liste déroulante.
    5. Cliquez sur Activer le journal.
Attendez que le statut devienne Actif.

Démarrer le pipeline

Pour démarrer le pipeline, procédez comme suit :
  1. Sur la page de détails du pipeline, dans le menu Actions, sélectionnez Démarrer.
  2. Sur la page de détails du pipeline, sélectionnez Initialisation.

    Les étapes d'initialisation affichent le statut en cours des étapes de pipeline. Pour chaque étape, vous pouvez sélectionner Visualiser les détails dans son menu Actions et vérifier les messages correspondants.

  3. Une fois que le pipeline a le statut Actif (En cours d'exécution), sélectionnez Exécution.

    Les processus d'exécution affichent l'état et la latence des processus Capture et Apply.

Problèmes recensés

Oracle Data Pump échoue si la version du fichier de fuseau horaire de la base de données cible est inférieure à celle de la base de données source

L'option de pipeline "Copier les données existantes vers la base de données cible avant de démarrer la réplication" utilise Oracle Data Pump. Oracle Data Pump échoue si la version du fichier de fuseau horaire de la base de données cible est inférieure à celle de la base de données source.

Solution de contournement : pour contourner ce problème, vous devez mettre à niveau la version de fuseau horaire de la base de données cible. Reportez-vous à Gestion des mises à jour de fichier de fuseau horaire sur Autonomous Database.