Créer des ressources de pipeline

Voyez comment créer les ressources nécessaires pour utiliser les pipelines.

Créer des connexions

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

Note :

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

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

Créer des pipelines

Avant de commencer :
Veillez à :
  • Vérifiez vos versions de base de données source et cible. La version de la base de données cible doit être une version supérieure à celle de la base de données source.
  • Vérifiez et configurez l'unicité des rangées dans les tables de base de données pour é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 rangée dans une table de base de données. Voir Garantir l'unicité des rangées dans les tables source et cible.
  • En tant qu'utilisateur disposant de privilèges d'administrateur 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 non Autonomous AI Database, 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 la saisie et l'application dans des bases de données non autonomes d'IA, consultez Préparer les utilisateurs de base de données et les privilèges pour Oracle.
  • Vérifiez la vue DBA_GOLDENGATE_SUPPORT_MODE dans 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 politiques minimales requises pour les pipelines GoldenGate.

Note :

Si vous répliquez des données d'une base de données d'IA autonome vers une base de données d'IA autonome non autonome, vous devez désactiver GLOBAL_NAMES sur votre base de données d'IA autonome non autonome. Exécutez la commande suivante :
ALTER SYSTEM SET GLOBAL_NAMES = FALSE;

Voir l'étape 4 de Créer des liens de base de données à partir d'autres bases de données vers une base de données d'IA autonome pour en savoir plus.

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

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

  2. Dans la page Pipelines, cliquez sur Créer un pipeline.
  3. Dans le panneau Créer un pipeline, remplissez les champs de la façon suivante, puis cliquez sur Créer un pipeline :
    1. Dans Nom, entrez un nom pour le pipeline.
    2. (Facultatif) Pour Description, entrez une description qui vous aidera à distinguer ce pipeline des autres.
    3. Pour 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.

      Note :

      • Si vous n'avez pas encore créé de connexions, cliquez sur Créer une connexion pour commencer.
      • Si vous utilisez une connexion avec un point d'extrémité partagé 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 rangées existantes, puis charge les rangées de la source.
        • Remplacer : Supprime la table existante, puis la crée et la charge à partir de la source.
        • Ajouter : laisse les rangées existantes inchangées et charge les rangées de la source.
        • Ignorer : laisse la table telle quelle et passe à l'objet suivant.
      • Remplacer les modifications de schéma (LDD) : Lorsque cette option est sélectionnée, sélectionnez l'action à effectuer sur les schémas existants lorsque le processus rencontre une erreur :
        • Mettre fin : Repositionnez la transaction et arrêtez le traitement.
        • Abandonner : enregistrez l'erreur dans le fichier d'abandon et poursuivez le traitement.
        • Ignorer : Ignorez l'erreur et poursuivez 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
        • Abandonner
        • Ignorer
      • Redémarrer après l'échec : sélectionnez cette option pour activer le redémarrage automatique dans le cas où le processus s'arrête pour quelque raison que ce soit.
      • Démarrer le pipeline à l'aide du mappage par défaut : Démarre le pipeline immédiatement après sa création avec les règles de mappage 1:1 par défaut. Si cette option n'est pas sélectionnée, vous pouvez configurer les mappages de règle après leur création, puis démarrer manuellement le pipeline.

Ajouter des règles de mappage

Pour prévisualiser, ajouter ou supprimer des règles de mappage :
  1. Dans la page d'informations sur le pipeline, sélectionnez Règles de mappage.
  2. Dans la liste des règles de mappage, vous pouvez vérifier ou modifier les règles de mappage courantes et :
    • Prévisualiser : Vérifiez l'incidence de vos règles de mappage 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 les caractères génériques à la place de n'importe quelle partie du nom d'objet. Pour plus d'informations, voir Utilisation de caractères génériques dans les noms d'objet de base de données.
    • Supprimer : supprimez les règles de mappage.

Activer les journaux de pipeline

  1. Dans la page Pipelines, sélectionnez le pipeline pour lequel vous voulez activer la journalisation.
  2. Dans 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 :
    1. Pour Nom du journal, entrez un nom.
    2. Dans la liste déroulante Compartiment, sélectionnez un compartiment.
    3. Pour Groupe de journaux, vous pouvez :
      • Sélectionner un groupe dans la liste déroulante
      • Créer un groupe
      • Laissez-le vide et un groupe par défaut est automatiquement affecté
    4. Pour Conservation des journaux, 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 :
  1. Dans le menu Actions de la page des détails du pipeline, sélectionnez Démarrer.
  2. Dans la page des détails du pipeline, sélectionnez Initialisation.

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

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

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

Problèmes connus

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 dans la base de données cible avant de lancer 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 rechange : Pour contourner ce problème, vous devez mettre à niveau la version du fuseau horaire de la base de données cible. Voir Gérer les mises à jour des fichiers de fuseau horaire dans Autonomous Database.