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

Découvrez comment configurer la connexion à la base de données, le système et les paramètres pour Oracle GoldenGate for SQL Server.

Oracle GoldenGate for SQL Server se connecte aux bases de données SQL Server à 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 à l'interface Web du service d'administration ou via le client d'administration.

Configuration d'une connexion DSN sous Linux

Les étapes suivantes montrent comment créer une connexion DSN sous Linux à l'aide d'un fichier odbc.ini.

Pour les versions d'Oracle GoldenGate antérieures à la version 23.6, vous devez d'abord ajouter une nouvelle variable d'environnement ODBCINI pour le déploiement SQL Server en suivant les étapes ci-dessous. Les versions commençant par la version 23.6 définissent automatiquement cette variable lors de la création du déploiement.
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 déploiement Oracle GoldenGate SQL Server. 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_HOME)/msodbc/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.
Dans le dossier msodbc de l'installation d'Oracle GoldenGate, créez manuellement un fichier odbc.ini et ajoutez des sources de données dans ce fichier à l'aide des informations et de l'exemple suivants.

Exemple pour les versions d'Oracle GoldenGate antérieures à la version 23.6, où Driver doit être défini sur 'Pilote ODBC 18 pour SQL Server'
```
[mssql_source]
Driver = ODBC Driver 18 for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```
Exemple pour les versions 23.6 ou ultérieures d'Oracle GoldenGate, où Driver doit être défini sur "Pilote ODBC Microsoft pour SQL Server"
```
[mssql_source]
Driver = Microsoft ODBC Driver for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```

Remarque : pour obtenir la liste complète des options de connexion disponibles, consultez la documentation Microsoft à l'adresse suivante : https://learn.microsoft.com/en-us/sql/connect/odbc/dsn-connection-string-attribute?view=sql-server-ver16

Enregistrez et fermez le fichier odbc.ini.
Afin de créer la connexion de base de données pour le déploiement, reportez-vous à Ajout de connexions de base de données.

Configuration d'une connexion DSN sous Windows

Avant de créer une connexion de base de données pour les processus Oracle GoldenGate exécutés sous Windows, installez la dernière version du pilote Microsoft ODBC 17 pour SQL Server ou du pilote Microsoft ODBC 18 pour SQL Server.

Suivez ces étapes pour créer un DSN système sur le serveur Windows sur lequel Oracle GoldenGate est installé.

Pour créer un DSN SQL Server :

Ouvrez l'application ODBC Data Sources (64 bits).
Dans la boîte de dialogue Administrateur de source de données ODBC, sélectionnez l'onglet DSN système, puis cliquez sur Ajouter.
Sous Créer une source de données, sélectionnez le pilote ODBC {version} pour SQL Server, puis cliquez sur Terminer. L'assistant Create a New Data Source to SQL Server apparaît.
Entrez les détails suivants, puis cliquez sur Suivant :
- Nom : Peut être de votre choix. Dans un cluster Windows, utilisez un nom sur tous les noeuds du cluster.
- Description : (Facultatif) Saisissez une description de cette source de données.
- Serveur : saisissez la chaîne de connexion ou le nom d'instance du serveur SQL Server. Pour les connexions Always On, utilisez le nom d'instance du processus d'écoute du groupe Always On Availability.
Pour l'authentification de connexion, sélectionnez Authentification SQL Server, indiquez l'ID de connexion et le mot de passe, puis cliquez sur Suivant.
Si vous configurez une connexion à l'aide du pilote Microsoft ODBC Driver 18 pour SQL Server, cliquez à nouveau sur Suivant pour accéder à la dernière page de configuration. Sélectionnez l'option Certificat de serveur sécurisé, puis cliquez sur Précédent pour continuer car vous devez d'abord activer le certificat de serveur sécurisé avant de sélectionner la base de données par défaut à l'étape suivante.
Sélectionnez Modifier la base de données par défaut en, puis sélectionnez la base de données source ou cible dans la liste. Activez les paramètres Utiliser ANSI, puis cliquez sur Suivant.
Laissez la page suivante de l'assistant telle quelle et cliquez sur Terminer.
Cliquez sur Tester la source de données pour tester la connexion.
Si le test réussit, fermez la case de confirmation et la case Créer une nouvelle source de données.
Répétez cette procédure pour chaque base de données source et cible SQL Server, où le processus Oracle GoldenGate se connectera.

Connexion au processus d'écoute d'une configuration SQL Server Always On

Le processus Extract et le processus Replicat peuvent se connecter au processus d'écoute d'une configuration Always On ou directement à la réplique principale en cours du groupe.

L'avantage de la création de la connexion au processus d'écoute est que le processus Extract ou le processus Replicat peuvent se reconnecter à la nouvelle réplique principale lors du basculement sans avoir à reconfigurer la chaîne de connexion vers la nouvelle réplique principale.

Une extraction peut également être configurée pour acheminer ses requêtes en lecture seule vers une réplique secondaire en mode synchrone et lisible disponible. Par défaut, si le processus d'extraction se connecte à un processus d'écoute, tous les traitements sont effectués sur la réplique principale, mais si un processus d'extraction est configuré avec le paramètre TRANLOGOPTIONS ALWAYSONREADONLYROUTING, ses requêtes en lecture seule sont acheminées par le processus d'écoute vers une réplique secondaire en lecture disponible.

Pour plus d'informations, reportez-vous à TRANLOGOPTIONS et à Récapitulatif des exigences pour la capture et la distribution des bases de données dans un groupe Toujours sur disponibilité.

Si vous créez le DSN pour vous connecter à un processus d'écoute d'une configuration Always On, activez l'option de basculement multi-sous-réseau lors de la création d'un DSN. Pour les connexions DSN Linux, utilisez l'option MultiSubnetFailover=Yes dans l'entrée DSN.