Préparer la connexion à la base de données

Oracle GoldenGate pour Yugabyte (variante PostgreSQL) se connecte aux bases de données Yugabyte à l'aide d'un pilote ODBC prêtes à l'emploi. Les connexions peuvent être établies à l'aide d'un nom de source de données (DSN) ou à l'aide d'une connexion directe et en fournissant l'hôte, le port, la base de données et d'autres informations du serveur de base de données.

L'utilisation de connexions DSN nécessite que les détails de connexion soient répertoriés dans un fichier odbc.ini, tandis que les entrées directes sont saisies manuellement lors de l'ajout d'une connexion de base de données à partir de l'interface Web ou du client d'administration.

Remarque : PgBouncer n'est pas pris en charge pour les connexions Oracle GoldenGate.

Remarque : Oracle GoldenGate ne prend pas en charge les connexions au nombre d'octets qui utilisent Pgpool.

Après avoir effectué les étapes indiquées ci-dessous pour créer les entrées DSN ou pour utiliser des connexions directes, passez à la rubrique Ajouter des connexions de base de données pour savoir comment créer des connexions de base de données.

Configurer une connexion basée sur DSN

Pour créer une connexion DSN pour les processus Oracle GoldenGate, vous devez d'abord ajouter une variable d'environnement pour le déploiement Oracle GoldenGate for Yugabyte, puis créer un fichier odbc.ini pour stocker les attributs de connexion.

1. Connectez-vous à l'interface Web de Service Manager.

2. Dans le panneau de navigation de gauche, cliquez sur Déploiements, puis sélectionnez le nom du déploiement pour Yugabyte. Les différents paramètres du déploiement sont développés.

3. Cliquez sur Configuration, puis sur le signe plus (+) en regard de Variables d'environnement.

4. Fournissez les informations suivantes dans les deux champs disponibles. Pour le champ Valeur de variable d'environnement, assurez-vous qu'il s'agit du chemin absolu du fichier odbc.ini :

   Nom de variable d'environnement = ODBCINI

   Valeur de variable d'environnement = /ogg/deployment/yugabyte/odbc.ini

5. Cliquez sur Soumettre pour créer la variable, puis redémarrez le déploiement à partir du panneau Déploiements pour que les modifications prennent effet.

6. Dans le dossier deployment de l'installation d'Oracle GoldenGate, créez manuellement un fichier odbc.ini et ajoutez des sources de données dans ce fichier.

Utilisez les paramètres minimum suivants lors de la création du fichier DSN :

• Data Source Name : nom défini par l'utilisateur d'une connexion de base de données source ou cible qui sera référencée par les processus Oracle GoldenGate, tels que l'extraction ou la réplication. Les noms DSN peuvent comporter jusqu'à 32 caractères alphanumériques et ne peuvent inclure que des traits de soulignement (_) et un tiret (-) à partir de caractères spéciaux.

• IANAAppCodePage=4 : paramètre par défaut, mais il peut être modifié en fonction des instructions indiquées sur la page https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 lorsque le jeu de caractères de la base de données n'est pas Unicode.

• InstallDir : nom du chemin du pilote de protocole de connexion PostgreSQL d'Oracle GoldenGate. Il peut utiliser un chemin relatif, tel que : InstallDir =./datadirect

• Driver : nom du fichier de pilote Oracle GoldenGate PostgreSQL Wire Protocol et peut utiliser un chemin relatif, tel que Driver=./datadirect/lib/ggpsql25.so.

• Database : nom de la base de données source ou cible.

• Hostname : adresse IP ou nom d'hôte de la base de données.

• PortNumber : port d'écoute de la base de données.

• Oracle GoldenGate pour Yugabyte prend en charge plusieurs hôtes et ports pour les connexions Yugabyte. Cette fonctionnalité est utile dans la configuration de la haute disponibilité d'Oracle GoldenGate. Dans une configuration HA Yugabyte, il existe un serveur principal et plusieurs serveurs de secours. Vous pouvez configurer le format de chaîne de connexion pour indiquer plusieurs hôtes :

  Chaîne de connexion	Description
  db-user@host1,host2,host3/db-name	Les connexions doivent être tentées en utilisant le port de base de données Yugabyte par défaut 5433 pour tous les hôtes (host1, host2, host3).
  db-user@host1:1234,host2:2345,host3:3456/db-name	Les connexions doivent être tentées à l'aide des ports associés à chaque hôte spécifié dans la chaîne de connexion.
  db-user@host1,host2,host3:1234/db-name	Tous les hôtes utilisant le même numéro de port (1234) sur tous les hôtes (host1, host2, host3). Les connexions sont tentées à l'aide du port 1234 pour tous les hôtes (host1, host2, host3).
  db-user@host1,host2,host3:1234/db-name	Tous les hôtes utilisant le même numéro de port (1234) sur tous les hôtes (host1, host2, host3). Les connexions seraient tentées à l'aide du port 1234 pour tous les hôtes.
  db-user@host1:3456,host2,host3:1234/db-name	Si la chaîne de connexion est spécifiée dans d'autres formats où le numéro de port est spécifié pour certains hôtes alors que les autres hôtes sont spécifiés sans aucun port, la dernière spécification de port ou la spécification la plus à droite sera utilisée comme numéro de port pour tous les hôtes qui n'ont pas de numéro de port spécifié dans la chaîne de connexion. Comme indiqué dans la chaîne de connexion : db-user@host1:3456,host2,host3:1234/db-name Le numéro de port pour host2 est 1234, qui est le numéro de port le plus à droite spécifié dans la chaîne de connexion.

• Vous pouvez également fournir des valeurs LogonID et Password pour l'utilisateur Extract ou Replicat, mais celles-ci seront stockées en texte clair. Il est recommandé de laisser ces champs hors du DSN et de les stocker dans le portefeuille Oracle GoldenGate en tant qu'alias d'informations d'identification, et de les référencer avec le paramètre USERIDALIAS dans le processus Extract et Replicat.

Voici un exemple de fichier odbc.ini avec deux entrées DSN. Les noms de source de données utilisés dans l'exemple ci-dessous sont PG_src et PG_tgt.

#[ODBC Data Sources] [ODBC] IANAAppCodePage=4 InstallDir=/datadirect

[PG_src] Driver= ./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=sourcedb HostName=remotehost PortNumber=5432

| — |

[PG_tgt] Driver=./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=targetdb HostName=remotehost PortNumber=5432

1. Enregistrez et fermez le fichier odbc.ini.

2. Afin de configurer la connexion de base de données à partir d'Oracle GoldenGate pour un déploiement d'un kilo-octet, reportez-vous à Ajout de connexions de base de données.