Créer des ressources de pipeline

Création de connexions

Actuellement, les pipelines OCI GoldenGate prennent uniquement en charge les bases de données autonomes Oracle avec des adresses dédiées. Pour obtenir de meilleurs résultats, utilisez Autonomous Transaction Processing en tant que base de données source et Autonomous Data Warehouse en tant que base de données cible.

Avant de créer un pipeline, veillez à créer des connexions aux bases de données source et cible. Reportez-vous à Connexion aux bases de données autonomes Oracle.

Créer des pipelines

Avant de commencer :

Effectuez les opérations suivantes :

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
```
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.
Les connexions source et cible que vous utilisez pour le pipeline ont des adresses dédiées.

Pour créer un pipeline, procédez comme suit :

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.
Sur la page Pipelines, cliquez sur Créer un pipeline.
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 :
  Actuellement, les pipelines ne prennent en charge que les connexions avec des adresses dédiées.
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 :

Sur la page d'informations Pipeline, sélectionnez Règles de mise en correspondance.
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

Sur la page Pipelines, sélectionnez le pipeline pour lequel activer la journalisation.
Sur la page Détails des pipelines, sélectionnez Journaux.
Dans la liste des journaux de pipeline, sélectionnez Activer le journal dans le menu Actions des événements critiques.
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 :

Sur la page de détails du pipeline, dans le menu Actions, sélectionnez Démarrer.
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.
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.