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 extraites et les traces sont envoyées.

Avant de commencer

Veillez à créer des connexions GoldenGate pour chaque déploiement auquel vous voulez vous connecter, puis à les affecter au déploiement à partir duquel le chemin provient. 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 (23ai)

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. Cliquez sur Ajouter un nouvel utilisateur, puis effectuez les opérations suivantes :
    • 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 le 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. Cliquez sur Ajouter une connexion de chemin, puis effectuez les opérations suivantes :
    • Alias d'informations d'identification : saisissez un alias.
    • ID utilisateur : saisissez le nom de l'utilisateur créé à l'étape 2.
    • Password et Verify Password : saisissez le mot de passe associé à cet utilisateur à partir de l'étape 2.
  5. Cliquez sur Soumettre.
Pour ajouter un chemin de distribution dans GoldenGate 23ai, procédez comme suit :
  1. In the OCI GoldenGate deployment console, click Distribution Service.
  2. Sur la page d'accueil, cliquez sur Ajouter un chemin de distribution (icône Plus).
  3. Dans le panneau Ajouter un chemin, renseignez les champs Informations sur le chemin selon vos besoins, puis cliquez sur Suivant :
    1. Saisissez le nom de chemin, puis le chemin.
    2. (Facultatif) Entrez une description pour décrire l'objectif de ce chemin et répertorier les processus d'extraction et de réplication impliqués.
  4. Sur la page Options source, entrez les champs nécessaires, puis cliquez sur Suivant :
    • Sélectionnez l'extraction source dans la liste déroulante.
    • Entrez le nom de trace
    • Entrez le sous-répertoire, si vous pensez que la trace se trouve à un emplacement autre que celui par défaut.
    • L'URI source généré est généré automatiquement en fonction des informations fournies. Cliquez sur Modifier (icône en forme de 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émarrer, 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 d'adresse d'octet relative.
  5. Sur la page Options cible, renseignez les champs selon vos besoins, puis cliquez sur 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 (ogg Target Protocol 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 du fichier de trace cible.
    • Entrez le sous-répertoire, si la trace se trouve à un endroit autre que 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 la modification de l'algorithme de cryptage.
    • L'URI cible généré est généré automatiquement en fonction des informations fournies. Cliquez sur Modifier (icône en forme de crayon) pour modifier l'URI, si nécessaire.
    • Sélectionnez une méthode d'authentification cible (protocole de cible CSS uniquement)
      • Alias d'ID utilisateur

        Remarques :

        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. Assurez-vous que l'utilisateur existe dans le stripe d'identité IAM.
      • OAuth

        Remarques :

        Dans les locations activées par IAM, sélectionnez OAuth lors de la connexion à un autre déploiement activé par IAM.
      • Certificat
    • Sélectionner un domaine.
    • Sélectionnez l'alias contenant le UserID et le mot de passe Oracle GoldenGate.
    • Sélectionnez un type de cible :
      • GGFormat (par défaut)
      • SQL
      • XML
      • Texte brut
  6. Sur la page Options avancées, renseignez les champs selon vos besoins, puis cliquez sur Suivant :
    • Activez Activer la compression du réseau pour définir le seuil de compression.
    • Sélectionnez Délai EOF.

      Remarques :

      Sur les plates-formes Linux, vous pouvez conserver les paramètres par défaut. 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 dotés de paramètres de qualité de service (QoS) (DSCP et Time of 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).
    • Saisissez les octets vidés TCP (en octets).
    • Saisissez la seconde de vidage TCP (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 la réception des données.
    • Activez TCP_CORK pour autoriser l'utilisation de l'option de blocage de l'algorithme de Nagle.
    • Entrez la taille système du tampon d'envoi pour définir la valeur de la taille du tampon d'envoi pour le contrôle de flux.
    • Entrez la taille système du tampon de réception afin de définir la valeur de la taille du tampon de réception pour le contrôle de flux.
    • Définissez le délai d'expiration pour Keep Alive.
  7. Sur la page Options de filtrage, renseignez les champs suivants si nécessaire, puis cliquez sur Suivant :
    • Entrer le nom d'une règle.
    • Sélectionnez une action associée à la règle :
      • L'option Exclure filtre les données en fonction des options sélectionnées.
      • Inclure inclut des données en fonction des options spécifié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 base de données Conteneur, 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 container, schema et object. La convention en 2 parties comprend schema et object name.
      • Nom de fonctionnalité de procédure : sélectionnez cette option pour filtrer en fonction du nom de fonctionnalité de procédure existant.
      • Basé sur une colonne : si vous sélectionnez cette option, vous pouvez saisir le nom de la table et de la colonne auxquelles la règle s'applique. Vous pouvez filtrer à l'aide de la valeur de colonne avec les 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, mais les détails ne peuvent pas être modifiés.
    • Sélectionnez Négocier pour annuler une règle existante.
    • Cliquez sur Ajouter pour ajouter la règle.
  8. Sur la page Options gérées, renseignez les champs facultatifs selon vos besoins.
    • Activez Critique pour configurer ce chemin pour la haute disponibilité.
    • Activez Redémarrage automatique pour ajuster les nouvelles tentatives de redémarrage automatique et les options de délai de redémarrage automatique.
  9. Cliquez sur Créer et exécuter pour exécuter immédiatement le chemin. Cliquez sur Créer pour exécuter le chemin manuellement ultérieurement.
Vous revenez à la page d'accueil où vous pouvez consulter le statut du processus de chemin.

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

Ajoutez des informations d'identification qui permettent à un déploiement source (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 de navigation.
  2. Cliquez sur Ajouter un utilisateur, puis créez un utilisateur que le déploiement source peut utiliser pour se connecter au déploiement cible. Attignez à 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, cliquez sur Ajouter des informations d'identification, puis remplissez les champs suivants :
    • Credential Domain : 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.
    • Password et Verify Password : saisissez le mot de passe associé à cet utilisateur à partir de l'étape 2.
  5. Cliquez sur Soumettre.
Pour ajouter un chemin de distribution, procédez comme suit :
  1. Dans la console de déploiement OCI GoldenGate, cliquez sur Service de distribution.
  2. Sur la page de présentation du service de distribution, cliquez sur Ajouter un chemin (icône Plus).
  3. Sur la page Ajouter un chemin, renseignez les champs comme suit :
    1. Dans Nom du chemin, saisissez le nom du chemin.
    2. (Facultatif) Dans Description, entrez une brève description de l'objectif du 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é, l'URI est généré automatiquement en fonction des informations d'extraction fournies. Cliquez sur Modifier (icône en forme de 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 IAM est activé sur les déploiements source et cible. Cette option utilise les informations d'identification client pour l'authentification du service de distribution au service de destinataire.

        Remarques :

        Dans les locations activées par IAM, sélectionnez OAuth lors de la connexion à un autre déploiement activé par IAM.
      • UserID Alias : cette option utilise un alias UserID que vous pouvez créer sur l'instance Oracle GoldenGate cible pour établir une connexion.

        Remarques :

        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. Assurez-vous que l'utilisateur existe dans le stripe d'identité IAM.
    8. Dans Cible, sélectionnez un protocole de transfert de 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 vous sélectionnez cette option, 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 vous sélectionnez cette option, 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. Cliquez sur Modifier (icône en forme de 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. Sélectionnez l'option Activer la compression du réseau afin de définir le seuil de compression.
    12. Dans Longueur de séquence, entrez la longueur du numéro de séquence de trace.
    13. Dans Taille de trace, entrez la taille maximale d'un fichier dans une trace.
    14. Activez l'option Configurer le format de trace si vous souhaitez configurer le format du fichier de trace, puis renseignez les champs supplémentaires si nécessaire.
  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 Date de 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 de fichier de trace.
    6. Dans Source RBA Offset, entrez l'adresse d'octets 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. Affectez la valeur True à l'option Redémarrage automatique si vous souhaitez que le chemin de distribution redémarre automatiquement s'il prend fin.
    9. Dans Options de redémarrage automatique, indiquez le nombre de tentatives de redémarrage du processus de chemin et le délai entre les tentatives.
  5. Sous Configuration du jeu de règles, renseignez les champs suivants si nécessaire :
    1. For Enable Filtering, if selected, click Add Rule, and then complete the additional fields.
  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 un 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. Cliquez sur Créer et exécuter.
Vous revenez à la page de présentation dans laquelle vous pouvez consulter le statut du processus de chemin.

En savoir plus

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

Problèmes recensés

Pour créer des chemins de distribution afin d'envoyer des données à Oracle Cloud Infrastructure GoldenGate ou d'en extraire des données, veillez à ajouter le certificat racine à la gestion des certificats ou au portefeuille client.

Pour envoyer des données à OCI GoldenGate ou en extraire des données, vous devez créer un chemin de serveur de distribution ou un chemin lancé à partir de la cible sur le serveur de destinataire dans votre instance Oracle GoldenGate sur site ou Marketplace, respectivement. Vous devez également ajouter le certificat racine ou le certificat auto-signé OCI GoldenGate à la gestion des certificats Oracle GoldenGate (Oracle GoldenGate 21c ou version ultérieure) ou au portefeuille client (Oracle GoldenGate 19c). Cette opération crée une connexion sécurisée entre les déploiements Oracle GoldenGate et OCI GoldenGate. Seul le protocole WSS (WebSocket Secure) est pris en charge pour les chemins de serveur de distribution et de destinataire entre Oracle GoldenGate et OCI GoldenGate.

Une modification du certificat racine OCI GoldenGate entraîne l'échec du chemin du serveur de distribution ou d'un chemin lancé à partir de la cible sur le serveur de destinataire dans votre instance Oracle GoldenGate sur site ou Marketplace, et génère l'erreur suivante :

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

Solution de contournement : pour résoudre ce problème, mettez à jour le certificat dans le portefeuille client ou sur l'écran Gestion des certificats du gestionnaire de services afin d'utiliser le certificat racine de la console de déploiement OCI GoldenGate. Dans certains cas, lorsque le certificat du déploiement OCI GoldenGate n'est pas signé directement par le certificat racine, mais par des certificats intermédiaires, par exemple, il peut être nécessaire d'ajouter également les certificats d'autorité de certification intermédiaires.

En savoir plus :

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.