Ajout d'une extraction

Découvrez les conditions préalables et les éléments à prendre en compte pour l'ajout d'une extraction.

Avant de commencer à ajouter une extraction, assurez-vous que les paramètres suivants sont configurés :

Vous êtes maintenant prêt à ajouter une extraction pour votre déploiement.

Remarques concernant la création d'une extraction lorsqu'il existe des fichiers trace d'extraction précédents

Ecran Informations sur l'extraction

Une fois connecté à la page d'accueil des microservices, cliquez sur le signe + dans la colonne Créer pour ouvrir l'assistant Ajouter des extractions.

Dans l'écran Extraire les informations, sélectionnez le type d'extraction. Selon la plate-forme de base de données, les types d'extraction disponibles peuvent être Extraction intégrée, Extraction de capture de données de modification et Extraction de chargement initiale.

Si vous devez configurer l'extraction en aval pour Oracle AI Database, activez le commutateur d'extraction en aval.

Sélectionnez le type d'extraction à créer et indiquez les éléments suivants :

Cliquez sur Suivant.

Ecran Inscrire l'extraction - Bases de données PostgreSQL et Yugabyte

Remarque : le processus Extract Oracle GoldenGate pour Oracle, les différents types PostgreSQL et la base de données Yugabyte doivent être inscrits. Toutefois, les options de configuration permettant d'enregistrer le processus Extract sont affichées sur différents écrans lors de l'ajout du processus Extract.

Remarque : Voir aussi Instructions et limites pour le type de plug-in PGOUTPUT.

Dans l'écran Inscrire l'extraction, configurez les options suivantes et cliquez sur Inscrire :

Cliquez sur Suivant une fois l'enregistrement d'extraction réussi.

Un message indique que l'extraction a été enregistrée avec succès.

Cliquez sur Suivant.

Inscrire l'extraction pour les bases de données PostgreSQL et Yugabyte à partir du client d'administration

Une extraction pour PostgreSQL doit être inscrite auprès de la base de données et disposer d'un emplacement de réplication réservé. Les emplacements de réplication sont alloués via le paramètre de configuration de base de données max_replication_slots et peuvent être configurés comme indiqué dans la section Database Configuration.

Suivez ces instructions pour enregistrer une extraction. L'enregistrement d'extraction doit être effectué avant la création d'une extraction. Pour plus d'informations, reportez-vous à REGISTER EXTRACT dans Référence de l'interface de ligne de commande pour Oracle GoldenGate.

  1. Connectez-vous au déploiement, puis à l'alias d'informations d'identification de la base de données source.

    CONNECT http*s*://*remotehost*:*srvmgrport* DEPLOYMENT

          *deployment_name* AS *deployment_user* PASSWORD *deployment_password*
    OGG (https://*remotehost*:*16000**postgresql_source*)> DBLOGIN USERIDALIAS *alias*

  2. Enregistrez le processus Extract, qui crée en interne un emplacement de réplication pour ce processus. Les noms d'extraction ne peuvent pas comporter plus de 8 caractères alphanumériques.

    REGISTER EXTRACT *extname*

    Pour inscrire explicitement l'extraction auprès du module d'extension pgoutput, vous devez indiquer le type de module d'extension pgoutput :

    REGISTER EXTRACT *extname* PGPLUGINTYPE pgoutput;

Vous pouvez également enregistrer une extraction à partir de l'interface Web d'Oracle GoldenGate MA. Reportez-vous à Ajouter une extraction.

Instructions et limites pour le type de plug-in PGOUTPUT

Instructions de configuration du type de plug-in PGOUTPUT

Suivez les instructions suivantes lors de la définition du type de module d'extension pour PostgreSQL :

Limites

Les restrictions suivantes s'appliquent lors de la sélection d'un type de module d'extension pour PostgreSQL :

Ecran Options d'extraction

Remarque : cet écran fournit des options permettant d'inscrire l'extraction pour Oracle AI Database. Si vous ajoutez une extraction pour PostgreSQL, l'inscription de l'extraction est terminée dans l'écran Inscrire l'extraction.

Dans l'écran Options d'extraction, configurez les paramètres suivants :

Inscrire l'extraction pour Oracle à partir du client Admin

Suivez ces instructions pour enregistrer une extraction. L'enregistrement d'extraction doit être effectué avant la création d'une extraction.

Vérifiez que vous êtes connecté à la base de données à l'aide de la commande DBLOGIN.

Pour plus d'informations, reportez-vous à [REGISTER EXTRACT](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GCLIR-GUID-5E42DB9E-EFDF-40C0-89D7-88413496B8A3) dans la référence de l'interface de ligne de commande pour Oracle GoldenGate.

  1. A l'aide du client d'administration, connectez-vous au déploiement, puis à l'alias d'informations d'identification de la base de données source.

    OGG> CONNECT https://*remotehost*:*srvmgrport* DEPLOYMENT *deployment_name* AS *deployment_user* PASSWORD *deployment_password*

    Lors de l'exécution de la commande CONNECT, l'invite de commande passe de "non connecté" à "https://servername:port deployment_name", comme indiqué dans l'exemple suivant :

    OGG (https://*pdbeast.vcn.oracle.com*:*16000**depl_east*)>

  2. Connectez-vous à la base de données en utilisant la commande DBLOGIN :

    OGG (https://*remotehost*:*port**oracle_source*)> DBLOGIN USERIDALIAS *alias*

  3. Enregistrez l'extraction. Les noms d'extraction ne peuvent pas comporter plus de 8 caractères alphanumériques.

    OGG (https://*remotehost*:*port**oracle_source*)> REGISTER EXTRACT *extname* DATABASE

Vous pouvez également inscrire une extraction en arrière-plan lors de la création d'une extraction à partir de l'interface Web d'Oracle GoldenGate MA. Pour plus d'informations, reportez-vous à Ajouter une extraction.

Ecran Capture en aval

Valide pour Oracle uniquement.

Si vous avez sélectionné Capture en aval dans l'écran Extraire les informations, l'écran des options Capture en aval s'affiche. Configurez la connexion à la base de données d'exploration en aval pour l'extraction en aval à l'aide de cet écran.

Remarque : la capture en aval avec ADG ne prend pas en charge l'extraction par base de données pluggable.

Cliquez sur Suivant.

Ecran Options gérées

Sur l'écran Options gérées, configurez les options de démarrage automatique et de redémarrage automatique pour le processus d'extraction. Le tableau suivant fournit ces options :

Le tableau suivant fournit ces options :

Option Description
Nom de profil

Fournit le nom du profil de démarrage et de redémarrage automatique. Vous pouvez sélectionner les options par défaut ou personnalisées.

Si vous avez déjà créé un profil, vous pouvez également le sélectionner. Si vous sélectionnez l'option Personnalisé, vous pouvez configurer un nouveau profil à partir de cette section.
Critique pour l'état du déploiement

(Oracle uniquement) Activez cette option si le profil est essentiel pour l'état du déploiement.

Remarque :

Cette option apparaît uniquement lorsque vous créez l'extraction ou la réplication, et non lorsque vous configurez les processus gérés dans la page Profils.

Démarrage automatique Active le démarrage automatique du processus.
Délai de démarrage Temps d'attente (en secondes) avant de démarrer le processus
Redémarrage automatique Configure le mode de redémarrage du processus s'il prend fin.
Nombre maximal de nouvelles tentatives Indique le nombre maximal de tentatives de démarrage du processus.
Délai entre deux tentatives Délai lors d'une tentative de démarrage du processus.
Fenêtre de nouvelles tentatives Intervalle de temps nécessaire lors d'une tentative de démarrage du processus.
Redémarrer en cas d'échec uniquement Si elle a la valeur True, la tâche est uniquement redémarrée en cas d'échec.
Désactiver la tâche une fois le nombre maximal de nouvelles tentatives atteint Si la valeur est True, la tâche est désactivée après avoir épuisé toutes les tentatives de redémarrage du processus.

Cliquez sur Suivant.

Ecran Fichier de paramètres d'extraction

Sur l'écran Fichier de paramètres, vous pouvez modifier ce fichier dans la zone de texte pour répertorier les détails de table qui vous intéressent. Voici un exemple de fichier de paramètres Extract :

EXTRACT exte
USERIDALIAS ggeast DOMAIN OracleGoldenGate
EXTTRAIL east/ea
DDL INCLUDE MAPPED
TABLE hr.*;

Cliquez sur Créer et exécuter pour créer et démarrer l'extraction. Si vous sélectionnez Créer, l'extraction est créée, mais vous devez le démarrer à l'aide des options d'extraction.

Vous revenez à la page d'accueil du service d'administration ou à la page Extract dans laquelle toutes les extractions créées sont répertoriées.

Créer un fichier de paramètres pour l'extraction

Suivez ces instructions pour créer un fichier de paramètres pour une extraction.

  1. (MySQL uniquement) Lors de l'exécution d'Oracle GoldenGate pour MySQL sur un serveur Windows et sur un serveur Linux (pour OGG version inférieure à 23.10.x) qui se trouve sur un hôte distant à partir de le serveur de base de données, assurez-vous que leurs fuseaux horaires sont identiques et, dans le cas contraire, utilisez le paramètre SETENV(TZ) dans le processus Extract et définissez-le sur le fuseau horaire du serveur de base de données.

    Pour plus d'informations sur le format TZ, reportez-vous au paramètre SETENV dans le guide de référence Paramètres et fonctions.

    Reportez-vous aux liens suivants pour référence :

    https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tzset?view=msvc-170#remarks

    https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html

  2. Sur le système source, exécutez la commande suivante :

    EDIT PARAMS extract_name

    Où :

    extract_name est soit le nom de l'extraction que vous avez créée avec la commande ADD EXTRACT, soit le nom qualifié complet du fichier de paramètres si vous avez défini un autre emplacement lors de la création du groupe.

  3. Entrez les paramètres dans l'ordre indiqué dans le tableau suivant, en commençant par une nouvelle ligne pour chaque instruction de paramètre. Certains paramètres s'appliquent uniquement à certaines configurations.

    Paramètre Description
    EXTRACT group
    • group est le nom du groupe Extract que vous avez créé avec la commande ADD EXTRACT.
    		Configure l'extraction en tant que processus en ligne avec des points de reprise.
    [, USERIDALIAS alias options ] Reportez-vous à [USERIDALIAS](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=GWURF-GUID-530D7773-B66D-4499-A509-EF5BB9CE9B05) pour indiquer les informations d'identification de base de données.
    ENCRYPTTRAIL algorithm Chiffre toutes les traces indiquées après cette entrée.
    SOURCECATALOG Indique un conteneur par défaut dans une base de données Conteneur colocative Oracle ou des instructions SEQUENCE. Permet d'utiliser des noms en deux parties (schema.object) où des noms en trois parties seraient autrement requis pour ces bases de données. Vous pouvez utiliser plusieurs instances de ce paramètre pour indiquer différents conteneurs ou catalogues par défaut pour différents ensembles de paramètres TABLE ou SEQUENCE.
    TABLE [container. \| catalog.]owner.object \| schema.object \| library/file \| library/file(member);

    Spécifie le nom qualifié complet d'un objet ou une spécification complète avec caractères génériques pour plusieurs objets. Si la base de données est une base de données Conteneur colocative Oracle, le nom de l'objet doit inclure le nom du conteneur ou du catalogue, sauf si SOURCECATALOG est utilisé.

    • schema est le nom du schéma ou un ensemble de schémas avec caractères génériques.

    • object est le nom de la table ou un ensemble de tables avec caractères génériques.

    • library est le nom de la bibliothèque IBM i ou un ensemble de bibliothèques avec caractères génériques.

    • file est le nom de fichier physique IBM i ou un ensemble de fichiers physiques avec caractères génériques.

    • member est le nom de membre du fichier physique IBM i ou un ensemble de noms de membre avec caractères génériques. Lorsque vous utilisez le format de nom natif IBM i (bibliothèque/fichier avec membre facultatif), les seuls caractères génériques valides sont un nom avec au moins un caractère valide suivi d'un astérisque de fin (*) ou *ALL qui correspond à n'importe quel nom.

    Remarque :

    Le nom de membre est facultatif et doit être indiqué si les noms de membre doivent être écrits dans la trace dans le nom de l'objet. Sans les noms de membre, tous les membres d'un fichier physique sont implicitement fusionnés en tant qu'objet unique dans la trace.

    Reportez-vous aux instructions Spécification de noms d'objet dans l'entrée Oracle GoldenGate pour spécifier des noms d'objet dans les fichiers de paramètres.

    SCHEMAEXCLUDE

    TABLEEXCLUDE

    EXCLUDEWILDCARDOBJECTSONLY

    		 Paramètres qui peuvent être utilisés conjointement les uns avec les autres pour exclure des objets spécifiques d'une spécification générique dans l'instruction TABLE associée.

  4. Entrez les paramètres d'extraction facultatifs appropriés répertoriés dans les paramètres Oracle GoldenGate.

  5. Enregistrez et fermez le fichier de paramètres.

L'exemple de fichier de paramètres Extract suivant explique les différents paramètres et options de configuration du processus Extract :

ADD EXTRACT *extract_name*
{, datasource}
{, BEGIN start_point} | {position_point}
[, PARAMS pathname]
[, REPORT pathname]
[, DESC 'description']

Options de paramètre supplémentaires pour l'extraction

Découvrez les paramètres supplémentaires qui peuvent être requis pour votre configuration Extract.

Le processus Extract utilise un serveur de journalisation de la base de données pour extraire le flux de données de journalisation de la base source. Vous pouvez définir des paramètres propres au serveur de journalisation en utilisant le paramètre TRANLOGOPTIONS avec l'option INTEGRATEDPARAMS dans le fichier de paramètres d'extraction.

Remarque : pour obtenir des informations détaillées et des conseils d'utilisation sur ces paramètres, reportez-vous à la section "DBMS_CAPTURE_ADM" du guide Oracle AI Database PL/SQL Packages and Types Reference.

Les paramètres suivants peuvent être définis avec INTEGRATEDPARAMS :

Reportez-vous à Gestion des ressources de serveur.