Ajout d'un chemin de distribution

Un chemin de distribution envoie la transaction des données d'une extraction à une réplication.

Utilisation d'un chemin de distribution

Utilisez un chemin de distribution lorsque vous devez répliquer des données dans un environnement de déploiement distribué. Un chemin de distribution envoie la transaction des données de l'extraction à la réplication. La création et l'exécution d'un chemin de distribution créent automatiquement un chemin de destinataire dans le service de destinataire du déploiement cible. Le chemin de destinataire reçoit la transaction de données du service de distribution du déploiement source.

Le déploiement source est le déploiement dans lequel vous créez le chemin de distribution. Le déploiement cible est le déploiement auquel les données et les traces extraites sont envoyées.

Avant de commencer

Veillez à créer des connexions GoldenGate pour chaque déploiement auquel vous souhaitez vous connecter, puis à les affecter au déploiement d'où provient le chemin. Par exemple, le déploiement dans lequel vous créez le chemin de distribution ou le chemin de destinataire lancé par la cible.

Sinon, dans les déploiements compatibles IAM, vous rencontrerez l'erreur suivante :

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

Création et exécution d'un chemin de distribution (26ai)

Si vous utilisez la banque d'informations d'identification GoldenGate, vous devez ajouter un utilisateur avec lequel le déploiement source utilise pour se connecter à un déploiement cible. Si vous utilisez la banque d'informations d'identification IAM, ignorez ces étapes.

  1. Dans la console de déploiement cible, connectez-vous, puis accédez à la page Administration des utilisateurs à partir de la navigation de gauche.

  2. Sélectionnez Ajouter un nouvel utilisateur, puis procédez comme suit :

    • Authentifié par : sélectionnez Mot de passe dans la liste déroulante.

    • Rôle : sélectionnez Opérateur dans la liste déroulante.

    • Nom utilisateur : entrez votre nom utilisateur.

    • Mot de passe et Vérifier un mot de passe : saisissez le mot de passe associé à cet utilisateur.

  3. Ouvrez la console de déploiement source, puis accédez à Connexions de chemin dans le menu de navigation de gauche.

  4. Sélectionnez Ajouter une connexion de chemin, puis procédez comme suit :

    • Alias d'informations d'identification : saisissez un alias.

    • ID utilisateur : saisissez le nom de l'utilisateur créé à l'étape 2.

    • Mot de passe et Vérifier un mot de passe : saisissez le mot de passe associé à cet utilisateur à l'étape 2.

  5. Sélectionnez Soumettre.

Pour ajouter un chemin de distribution dans GoldenGate 26ai, procédez comme suit :

  1. Sur la page d'accueil de la console de déploiement OCI GoldenGate, sélectionnez Créer (icône Plus) pour les chemins de distribution.

  2. Dans le panneau Ajouter un chemin, renseignez les champs Informations sur le chemin selon vos besoins, puis sélectionnez Suivant :

    1. Entrez le nom du parcours, puis le nom du parcours.

    2. (Facultatif) Entrez une description pour décrire l'objectif de ce chemin et répertorier les processus Extract et Replicat impliqués.

  3. Sur la page Options source, entrez les champs nécessaires, puis sélectionnez Suivant :

    • Sélectionnez l'extraction source dans la liste déroulante.

    • Entrez le nom de trace.

    • Entrez le sous-répertoire, si vous prévoyez que la trace se trouve à un autre emplacement que celui par défaut.

    • L'URI source généré est généré automatiquement en fonction des informations fournies. Sélectionnez Modifier (icône en forme d'un crayon) pour modifier l'URI, si nécessaire.

    • Sélectionnez un profil de cryptage. Le profil Portefeuille local est sélectionné par défaut si aucun profil de cryptage n'a été créé.

    • Dans Début, sélectionnez le point de départ du traitement des données :

      • Position dans le journal

      • Now

      • Heure personnalisée

      • CSN (à ou après)

    • Entrez le numéro de séquence.

    • Entrez le décalage RBA.

  4. Sur la page Options cible, renseignez les champs selon vos besoins, puis sélectionnez Suivant :

    • Sélectionnez un protocole cible :

      • ws

      • wss

      • OGG

    • (Facultatif) Activez Proxy inverse activé pour vous connecter à la cible à l'aide d'un proxy inverse.

    • Type de cible (protocole cible OGG uniquement)

      • Gestionnaire

      • Collecteur

      • Service de destinataire

    • Entrez l'hôte cible.

    • Entrez le numéro de port du déploiement cible.

    • Entrez le nom de trace pour le fichier de trace de la cible.

    • Entrez le sous-répertoire, si la trace se trouve ailleurs que dans l'emplacement par défaut.

    • Entrez la taille de trace maximale.

    • Sélectionnez un algorithme de cryptage cible utilisé pour envoyer la trace au déploiement cible :

      • NONE

      • AES-128

      • AES-192

      • AES-256

    • Activez Modifier le cryptage pour autoriser les modifications de l'algorithme de cryptage.

    • L'URI cible généré est généré automatiquement en fonction des informations fournies. Sélectionnez Modifier (icône en forme d'un crayon) pour modifier l'URI, si nécessaire.

    • Sélectionnez une méthode d'authentification cible (protocole cible CSS uniquement)

      • Alias d'ID utilisateur

        Remarque : créez des informations d'identification à l'aide de l'utilisateur IAM lors de la connexion à un déploiement compatible IAM à partir d'un déploiement de banque d'informations d'identification GoldenGate. Vérifiez que l'utilisateur existe dans le stripe d'identité IAM.

      • OAuth

        Remarque : dans les locations activées pour IAM, sélectionnez OAuth lors de la connexion à un autre déploiement activé pour IAM.

      • Certificat

    • Sélectionnez un domaine.

    • Sélectionnez l'alias qui contient l'ID utilisateur et le mot de passe Oracle GoldenGate.

    • Sélectionnez un type de cible :

      • GGFormat (par défaut)

      • SQL

      • XML

      • Texte brut

  5. Sur la page Options avancées, renseignez les champs selon vos besoins, puis sélectionnez Suivant :

    • Activez l'option Activer la compression réseau pour définir le seuil de compression.

    • Sélectionnez Délai de fin.

      Remarque : sur les plates-formes Linux, les paramètres par défaut peuvent être conservés. Toutefois, sur les plates-formes non Linux, vous devrez peut-être ajuster ce paramètre pour les réseaux à bande passante élevée et à latence élevée, ou pour les réseaux qui ont des paramètres de qualité de service (QoS) (DSCP et heure de service (ToS))

    • Sélectionnez la fréquence de point de reprise pour définir la fréquence du chemin qui prend le point de reprise (en secondes).

    • Entrez les octets de vidage TCP (en octets).

    • Entrez la valeur TCP Flush Seconds (en secondes).

    • Sélectionnez le point de code de services différenciés (DSCP).

    • Sélectionnez le type de service (TOS).

    • Activez TCP_NODELAY pour éviter tout retard lors de l'utilisation de l'option de Nagle.

    • Activez l'option Accusé de réception rapide pour envoyer un accusé de réception rapide après réception des données.

    • Activez TCP_CORK pour autoriser l'utilisation de l'option de liège de l'algorithme de Nagle.

    • Entrez la taille du tampon d'envoi du système pour définir la valeur de la taille du tampon d'envoi pour le contrôle de flux.

    • Entrez la taille du tampon de réception du système pour définir la valeur de la taille du tampon de réception pour la commande de flux.

    • Définissez le délai d'expiration pour le maintien des connexions.

  6. Sur la page Options de filtrage, renseignez les champs suivants selon vos besoins, puis sélectionnez Suivant :

    • Entrez un nom de règle.

    • Sélectionnez une action de règle :

      • L'option Exclure filtre les données en fonction des options sélectionnées.

      • L'option Inclure inclut les données en fonction des options indiquées.

    • Sélectionnez un type de filtre :

      • Type d'objet : sélectionnez l'un des trois types d'objet suivants : LMD, LDD et procédure.

      • Noms d'objet : sélectionnez cette option pour fournir un nom d'objet existant. Une convention de dénomination en trois parties varie selon que vous utilisez ou non une base de données Conteneur. Avec la CDB, vous devez utiliser une Convention de dénomination en 3 parties. Sinon, une Convention en 2 parties est obligatoire. La Convention en 3 parties comprend le conteneur container, schema et object. La Convention en 2 parties comprend schema et object name.

      • Nom de la fonction de procédure : sélectionnez cette option pour filtrer en fonction du nom de la fonction de procédure existante.

      • Basé sur la colonne : si vous sélectionnez cette option, vous obtenez l'option permettant de saisir le nom de la table et de la colonne auxquelles la règle s'applique. Vous pouvez filtrer à l'aide de l'option de valeur de colonne avec des conditions LT, GT, EQ, LE, GE et NE. Vous pouvez également indiquer si vous souhaitez disposer d'une image avant ou après dans les données filtrées.

      • Balise : sélectionnez cette option pour définir le filtre en fonction des balises.

      • ID de bloc : affiche les détails de configuration des shards de base de données. Toutefois, les détails ne peuvent pas être modifiés.

    • Sélectionnez Négocier pour annuler toute règle existante.

    • Sélectionnez Ajouter pour ajouter la règle.

  7. Sur la page Options gérées, renseignez les champs facultatifs si nécessaire.

    • Activez Critical pour configurer ce chemin pour la haute disponibilité.

    • Activez Redémarrage automatique pour ajuster les options Redémarrage automatique et Délai de redémarrage automatique.

  8. Sélectionnez Créer et exécuter pour exécuter le chemin immédiatement. Sélectionnez Créer pour exécuter le chemin manuellement ultérieurement.

Vous revenez à la page d'accueil où vous pouvez consulter le statut du processus Chemin.

Création et exécution d'un chemin de distribution (21c)

Ajoutez des informations d'identification qui permettent à un déploiement source (le déploiement dans lequel vous créez ce chemin) de se connecter à un déploiement cible :

  1. Dans la console de déploiement cible, connectez-vous, puis accédez à la page Administrateur à partir du menu d'accès.

  2. Sélectionnez Ajouter une personne, puis créez un utilisateur que le déploiement source peut utiliser pour se connecter au déploiement cible. Attribuez à cet utilisateur le rôle d'opérateur.

  3. Ouvrez la console de déploiement source, puis accédez à la page Configuration.

  4. Sous l'onglet Base de données, sélectionnez Ajouter des informations d'identification, puis effectuez les opérations suivantes :

    • Domaine d'informations d'identification : saisissez un nom pour cette connexion

    • Alias d'informations d'identification : saisissez un alias

    • ID utilisateur : saisissez le nom de l'utilisateur créé à l'étape 2.

    • Mot de passe et Vérifier un mot de passe : saisissez le mot de passe associé à cet utilisateur à l'étape 2.

  5. Sélectionnez Soumettre.

Pour ajouter un chemin de distribution, procédez comme suit :

  1. Dans la console du déploiement OCI GoldenGate, sélectionnez Service de distribution.

  2. Sur la page d'aperçu du service de distribution, sélectionnez Ajouter le chemin (icône Plus).

  3. Sur la page Ajouter un chemin, renseignez les champs comme suit :

    1. Dans Nom du parcours, saisissez un nom pour le chemin.

    2. (Facultatif) Dans Description, entrez une brève description de l'objectif de ce chemin.

    3. (Facultatif) Activez Proxy inverse activé pour vous connecter à la cible à l'aide d'un proxy inverse.

    4. Dans Source, sélectionnez le nom de l'extraction dans la liste déroulante.

    5. Dans Nom de trace, sélectionnez la trace d'extraction dans la liste déroulante.

    6. Dans URI source générée, l'URI est généré automatiquement en fonction des informations d'extraction fournies. Sélectionnez Modifier (icône en forme d'un crayon) pour modifier l'URI, si nécessaire.

    7. Dans Méthode d'authentification cible, sélectionnez la méthode d'authentification de l'URI cible :

      • OAuth : sélectionnez cette option si les déploiements source et cible sont activés sur IAM. Cette option utilise les informations d'identification client pour l'authentification du service de distribution au service de destinataire.

        Remarque : dans les locations activées pour IAM, sélectionnez OAuth lors de la connexion à un autre déploiement activé pour IAM.

      • Alias d'ID utilisateur : cette option utilise un alias d'ID utilisateur que vous pouvez créer sur l'instance Oracle GoldenGate cible pour établir une connexion.

        Remarque : créez des informations d'identification à l'aide de l'utilisateur IAM lors de la connexion à un déploiement compatible IAM à partir d'un déploiement de banque d'informations d'identification GoldenGate. Vérifiez que l'utilisateur existe dans le stripe d'identité IAM.

    8. Dans Cible, sélectionnez un protocole de transfert des données dans la liste déroulante :

      • wss : le socket Web sécurisé est l'option par défaut. Si cette option est sélectionnée, vous devez renseigner les champs suivants :

        • Hôte cible

        • N° port

        • Nom de trace

        • Nom de déploiement (proxy inverse activé)

        • Chemin d'URI (proxy inverse activé)

        • Domaine

        • Un alias

      • ogg : si cette option est sélectionnée, vous devez remplir les champs suivants :

        • Hôte cible

        • N° port

        • Nom de trace

        • Nom de déploiement (proxy inverse activé)

        • Chemin d'URI (proxy inverse activé)

      • ws : si cette option est sélectionnée, vous devez remplir les champs suivants :

        • Hôte cible

        • N° port

        • Nom de trace

        • Nom de déploiement (proxy inverse activé)

        • Chemin d'URI (proxy inverse activé)

        • Domaine

        • Un alias

    9. Dans URI cible généré, l'URI est automatiquement renseigné à partir des informations fournies. Sélectionnez Modifier (icône en forme d'un crayon) pour modifier l'URI, si nécessaire.

    10. Dans Algorithme de cryptage cible, sélectionnez un algorithme de cryptage pour la trace cible :

      • aucun

      • AES-128

      • AES-192

      • AES-256

    11. Pour Activer la compression réseau, sélectionnez cette option afin de définir le niveau de compression.

    12. Dans Longueur de la séquence, entrez la longueur du numéro d'ordre de trace.

    13. Dans Taille de traces (Mo), entrez la taille maximale d'un fichier dans une trace.

    14. Pour Configurer les formats de trace, activez cette option si vous souhaitez configurer le format de fichier de trace, puis renseignez les champs supplémentaires selon vos besoins.

  4. Dans la section Profil de cryptage, renseignez les champs suivants selon vos besoins :

    1. Nom de profil

    2. Type de profil de cryptage

    3. Nom de clé maître

    4. Dans Début, sélectionnez l'emplacement de journalisation des données :

      • Now

      • Heure personnalisée

      • Position dans le journal (valeur par défaut)

    5. Dans Numéro de séquence source, sélectionnez le numéro de séquence de l'extraction de déploiement source du fichier trace.

    6. Dans Position de RBA source, entrez l'adresse d'octet relative (RBA) dans le fichier de trace où vous souhaitez que le processus démarre.

    7. Définissez l'option Critique sur True si le chemin de distribution est critique pour le déploiement. La valeur par défaut est False.

    8. Définissez l'option Redémarrage automatique sur True si vous souhaitez que le chemin de distribution redémarre automatiquement s'il prend fin.

    9. Pour Options de démarrage automatique, indiquez le nombre de tentatives de redémarrer le processus du chemin et le délai entre les tentatives.

  5. Sous Configuration du jeu de règles, renseignez les champs suivants si nécessaire :

    1. Dans Activer le filtrage, si cette option est sélectionnée, sélectionnez Ajouter la règle, puis renseignez les champs supplémentaires.

  6. Sous Plus d'options, renseignez les champs suivants si nécessaire :

    1. Délai EOF : délai de fin de fichier avant la recherche des données source

    2. Fréquence de point de reprise : fréquence en secondes des points de reprise de routine

    3. Options d'application

      • Octets vides TCP : taille de vidage

      • Vidage TCP (en secondes) : intervalle de vidage

    4. Options TCP

      • DSCP : services différenciés de réseau

      • TOS : condition d'utilisation du service

      • TCP_NODELAY : si activé, désactive l'utilisation de l'algorithme de Nagle

      • accusé de réception rapide : si activé, envoie l'accusé de réception

      • TCP_CORK : active l'utilisation de l'algorithme de Nagle

      • Taille système de tampon d'envoi

      • Taille système de tampon de réception

      • Maintien des connexions : délai de maintien des connexions

  7. Sélectionnez Créer et exécuter.

Vous retournez à la page de présentation, où vous pouvez consulter le statut du processus de parcours.

En savoir plus

Vous souhaitez en savoir plus sur le processus du chemin de distribution ? Reportez-vous aux ressources suivantes :

Problèmes recensés

Les chemins de distribution et de destinataire peuvent échouer après la mise à niveau des déploiements 21.x vers la version 21.17

A partir des versions 21.17 et 26ai d'Oracle GoldenGate, les chemins utilisent le nom de domaine réservé par défaut, "Réseau", de sorte que les chemins existants qui utilisent un autre nom de domaine échouent avec l'erreur suivante signalée :

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Solution de contournement : dans la console de déploiement OCI GoldenGate, modifiez chaque chemin, remplacez le nom de domaine par "Réseau", puis redémarrez le chemin. Pour vérifier, vérifiez le domaine de l'utilisateur auth du chemin dans la section Credential store de la page Configuration.

Si vous préférez utiliser le client Admin, exécutez les commandes suivantes pour mettre à jour le nom de domaine. Veillez à remplacer les espaces réservés <path_name> et <alias> :

Pour les chemins initiés par la source :

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Pour les chemins initiés par la cible :

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Seule l'authentification Digest est actuellement prise en charge.

Oracle Cloud Infrastructure GoldenGate ne prend actuellement pas en charge l'authentification basée sur un certificat lorsque vous utilisez Oracle Cloud Infrastructure GoldenGate comme cible de chemin de distribution.

Solution : aucune.