Gérer des pipelines

Découvrez les tâches de gestion de pipeline essentielles pour utiliser OCI GoldenGate Pipelines.

Afficher les détails du pipeline

Sélectionnez un pipeline dans la page Pipelines pour en visualiser les détails. Sur la page de détails du pipeline, vous pouvez visualiser le statut du pipeline, qui peut être l'un des suivants :

• Création

• Actif (arrêté)

• Actif (en cours d'exécution)

• Mise à jour

• Attention requise

• Echec

Vous pouvez également modifier le pipeline ou utiliser le menu Actions pour effectuer d'autres actions telles que :

• Modifier

• Démarrer ou Arrêter

• Collecte de diagnostics

• Déplacer la ressource

• Ajouter des balises

• Supprimer

Basculez sur un autre onglet pour afficher d'autres informations relatives au pipeline.

Informations sur le pipeline

La page d'informations sur le pipeline affiche des informations générales sur cette ressource, telles que son OCID, le compartiment dans lequel elle réside, la date de sa création et de sa dernière mise à jour, etc.

Règles de mise en correspondance

Ajoutez, enlevez ou prévisualisez des règles de mise en correspondance qui modifient la mise en correspondance un à un par défaut des tables et schémas source vers la cible.

Initialisation

Visualiser les étapes d'initialisation qui affichent le statut en cours des étapes de pipeline. Vous pouvez sélectionner n'importe quelle étape pour afficher ses détails.

Exécution

Affichez le statut et la latence de l'exécution.

Surveillance

Affichez les mesures de pipeline, activez ou désactivez les journaux d'événements critiques, et créez et visualisez des notifications.

Demandes de travail

Afficher le statut des demandes de travail du pipeline. Les opérations de pipeline qui créent des demandes de travail sont les suivantes :

• Créer

• Début

• Arrêter

• Mise à jour

• Suppression

• Déplacement

• Collecte de diagnostics

Balises

Les balises vous aident à localiser les ressources dans votre location. Vous pouvez ajouter et visualiser les balises d'un pipeline à partir de la page Pipelines et de la page de détails du pipeline. Reportez-vous à gestion des balises.

Modification d'un pipeline

Pour modifier un pipeline, sélectionnez Modifier sur la page de détails du pipeline. Dans le panneau d'édition, vous pouvez modifier :

• Nom

• Description

• Options de processus:

  Remarque : vous devez redémarrer le pipeline pour que les modifications prennent effet.

  • 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 de :

    • Truncate : supprime les lignes existantes, puis charge les lignes de la source.

    • Remplacer : supprime la table existante, puis crée et charge la table à partir de la source.

    • Ajouter : laisse les lignes existantes inchangées et charge les lignes de la source.

    • Ignorer : permet de quitter la table telle quelle et de passer à l'objet suivant.

  • Remplacer les modifications de schéma (DDL) : 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 rejet 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 :

    • Interrompre

    • Annuler

    • Ignorer

  • 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 de la mise en correspondance par défaut : démarre le pipeline immédiatement après sa création avec les règles de mise en correspondance 1:1 par défaut. Si cette option n'est pas sélectionnée, vous pouvez configurer les mappings de règle après leur création, puis démarrer manuellement le pipeline.

Démarrer un pipeline

Pour démarrer un pipeline, sélectionnez Démarrer dans le menu Actions d'un pipeline inactif sur sa page de détails. Sélectionnez Démarrer dans la boîte de dialogue Démarrer le pipeline pour confirmer cette action. Le pipeline s'exécute ensuite via les étapes d'initialisation en fonction des options de processus sélectionnées lors de la création (ou lorsqu'elles sont mises à jour si vous avez modifié le pipeline) avant de démarrer les processus Capture et Apply.

Suspendre un pipeline

Vous pouvez mettre un pipeline en pause pour arrêter temporairement les processus de capture et de livraison. La mise en pause d'un pipeline n'interrompt pas la facturation de ces ressources. Pendant la pause d'un pipeline, vous pouvez modifier le pipeline, ses règles de mise en correspondance et prévisualiser les règles de mise en correspondance.

Remarque : pour arrêter la facturation, vous devez arrêter le pipeline.

Pour suspendre un pipeline, sélectionnez Mettre en pause dans le menu Actions du pipeline.

Lorsque vous êtes prêt à poursuivre le pipeline, sélectionnez Démarrer dans le menu Actions du pipeline.

Pour arrêter complètement le pipeline, sélectionnez Arrêter.

Arrêter un pipeline

Pour arrêter un pipeline, sélectionnez Arrêter dans le menu Actions d'un pipeline actif sur sa page de détails. Sélectionnez Arrêter dans la boîte de dialogue Arrêter le pipeline pour confirmer cette action.

L'arrêt d'un pipeline arrête également la facturation de ces ressources. Vous ne pouvez pas modifier le pipeline, ses mappings ou prévisualiser les mappings lorsqu'un pipeline est arrêté et à l'état Inactif.

Pour redémarrer le pipeline, sélectionnez Démarrer dans le menu Actions du pipeline.

Cloner un pipeline

Vous pouvez cloner un pipeline dont l'état est Actif, Inactif ou Attention requise.

Pour cloner un pipeline :

• Sur la page Pipelines, sélectionnez Cloner dans le menu Actions d'un pipeline, puis suivez les étapes ci-dessous.

• Sur la page de détails d'un pipeline, sélectionnez Cloner dans le menu Actions.

  1. Dans le panneau Cloner le pipeline, entrez le nom du clone de pipeline.

  2. (Facultatif) Entrez la description du clone de pipeline.

  3. Sélectionnez le compartiment dans lequel créer le clone de pipeline.

  4. (Facultatif) Renseignez les options avancées selon vos besoins.

  5. Sélectionnez Cloner.

Collecte de diagnostics

Collectez des diagnostics pour analyser ou partager des informations sur le pipeline OCI GoldenGate. Le fichier de diagnostic contient des enregistrements supprimés, le cas échéant, pour les processus Capture et Apply.

Pour collecter des diagnostics sur votre pipeline, procédez comme suit :

1. Sur la page de détails du pipeline, dans le menu Actions, sélectionnez Collecter des diagnostics.

2. Dans le panneau Collecter les diagnostics, sélectionnez le compartiment et le bucket dans lesquels enregistrer le fichier de diagnostics.

3. Entrez un préfixe de nom pour le fichier de diagnostic.

4. Sélectionnez Collecter des diagnostics.

Une fois le processus de collecte terminé, vous pouvez télécharger le fichier de diagnostics à partir de la page de détails du pipeline.

Surveiller les mesures de pipeline

Sur la page de détails du pipeline, sélectionnez Monitoring pour visualiser les mesures de pipeline telles que l'utilisation de l'UC, la consommation d'OCPU, l'utilisation de la mémoire et l'état général du pipeline. Pour plus d'informations sur les mesures disponibles, voir :

• Surveillance des performances

• Mesures OCI GoldenGate

Gérer les règles de mappage

Pour prévisualiser, ajouter ou supprimer des règles de mappage :

1. Sur la page Informations sur le pipeline, sélectionnez Règles de mise en correspondance.

2. Dans la liste Règles de mise en correspondance, vous pouvez vérifier ou modifier les règles de mise en correspondance en cours et :

   • Aperçu : vérifiez l'impact des règles de mappage sur les schémas et les tables inclus dans la réplication.

   • Ajouter : identifiez les tables et schémas à inclure ou à exclure. Vous pouvez utiliser le nom d'objet qualifié 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.

Afficher les étapes d'initialisation

Si vous êtes familiarisé avec les processus GoldenGate, un pipeline est une abstraction d'un processus de réplication de données. Lorsque vous démarrez le pipeline, les étapes d'initialisation sont effectuées de manière linéaire, en créant toutes les ressources nécessaires et en préparant les bases de données pour la réplication de données en fonction des informations collectées lors de la création. Les étapes d'initialisation sont les suivantes :

• Vérifier les bases de données cible et source

• Préparer les objets de base de données pour l'extraction

• Crée une table de signal d'activité

• Crée et exécute l'extraction (Capture)

• Vérifier que les tables et schémas cible existent

• Crée la table de points de reprise

• Crée et exécute le processus Replicat (Apply)

Vous pouvez sélectionner Afficher les détails dans le menu Actions de chaque étape d'initialisation pour vérifier le statut et les messages système correspondant à chaque étape.

Exécution

Lorsque le pipeline est actif et en cours d'exécution, vous pouvez visualiser le statut et la latence des processus Capture et Apply dans la section Runtime de la page de détails du pipeline. Vous pouvez utiliser ces informations pour observer l'état de ces processus et prendre des mesures si nécessaire.

Configurer des notifications

Vous pouvez configurer des notifications à tenir au courant des événements de pipeline.

Pour configurer des notifications d'événement de pipeline :

1. Sur la page de détails du pipeline, sélectionnez Surveillance.

2. Sur la page Surveillance, faites défiler la page jusqu'à Notifications, puis sélectionnez Créer une notification.

3. Dans la page Créer une notification, vous pouvez sélectionner :

   • Démarrage rapide, puis sélection dans un modèle de configurations de notification préconfigurées.

   • Notification d'événement avancée, puis sélectionnez les règles d'événement qui déclenchent des actions pour différentes conditions d'événement.

   • Notification d'alarme avancée, puis sélectionnez les mesures à suivre et à déclencher pour le déclenchement de l'alarme.

4. Pour Sujet et abonnements :

   1. Créez un sujet ou sélectionnez un sujet existant.

   2. Confirmer les abonnements pour recevoir des messages.

5. (Facultatif) Pour la notification d'alarme avancée, développez Options avancées, puis configurez le corps de l'alarme (corps du message) et le format du message de la notification.

6. Sélectionnez Soumettre.

Gérer les journaux de pipeline

Activez ou désactivez les journaux des événements critiques pour les pipelines OCI GoldenGate.

Pour activer les journaux des événements critiques, procédez comme suit :

1. Sur la page de détails du pipeline, sélectionnez Surveillance.

2. Dans la page Monitoring, faites défiler la page jusqu'à Logs.

3. Dans le menu Actions des événements critiques, sélectionnez Activer le journal.

4. Dans le panneau Activer le journal, renseignez les champs suivants, puis sélectionnez Activer le journal :

   1. Dans Nom de journal, entrez le nom du journal.

   2. Dans la liste déroulante Compartiment, sélectionnez le compartiment dans lequel créer le journal.

   3. Sélectionnez un groupe de journaux ou sélectionnez Créer un groupe.

   4. Sélectionnez une durée de conservation de journal.

Déplacer un pipeline

Vous pouvez déplacer un pipeline d'un compartiment vers un autre.

Pour déplacer un pipeline, procédez comme suit :

1. Dans la page Pipelines, sélectionnez le pipeline à déplacer.

2. Dans le menu Actions de la page de détails du pipeline, sélectionnez Déplacer la ressource.

3. Dans la boîte de dialogue Déplacer la ressource vers un autre compartiment, sélectionnez le compartiment vers lequel déplacer le pipeline.

4. Sélectionnez Déplacer la ressource.

Gérer les balises d'un pipeline

Vous pouvez ajouter et afficher les balises d'un pipeline à partir de la page Pipelines et de la page de détails du pipeline.

Sur la page Pipelines, dans le menu Actions d'un pipeline, sélectionnez Ajouter des balises ou Afficher les balises.

Sur la page de détails du pipeline, vous pouvez sélectionner Balises dans le menu Actions ou sélectionner l'onglet Balises pour visualiser et gérer les balises.

En savoir plus sur le balisage.

Supprimer un pipeline

Assurez-vous que le pipeline est arrêté et qu'il est inactif avant de le supprimer.

Pour supprimer un pipeline, procédez comme suit :

1. Dans la page Pipelines, sélectionnez le pipeline à supprimer.

2. Dans le menu Actions de la page de détails du pipeline, sélectionnez Supprimer.

3. Dans la boîte de dialogue Supprimer le pipeline, confirmez la suppression de ce pipeline, puis sélectionnez Supprimer.

Cette action ne peut pas être annulée.