Preparar conexión a base de datos

Obtenga información sobre la configuración de la conexión de base de datos, el sistema y los valores de parámetros para Oracle GoldenGate para SQL Server.

Oracle GoldenGate para SQL Server se conecta a las bases de datos de SQL Server mediante un controlador ODBC preempaquetado. Las conexiones se pueden establecer mediante un nombre de origen de datos (DSN) o mediante una conexión directa y proporcionando el host, el puerto, la base de datos y otra información del servidor de base de datos.

El uso de conexiones DSN necesita que los detalles de conexión se muestren en un archivo odbc.ini, mientras que las entradas directas se introducen manualmente al agregar una conexión de base de datos a la interfaz web del servicio de administración o mediante el cliente de administración.

Configuración de una conexión DSN en Linux

En los siguientes pasos se muestra cómo crear una conexión DSN en Linux mediante un archivo odbc.ini.

Para las versiones de Oracle GoldenGate anteriores a la versión 23.6, primero debe agregar una nueva variable de entorno ODBCINI para el despliegue de SQL Server mediante los siguientes pasos. Las versiones que comienzan con la versión 23.6 definen automáticamente esta variable durante la creación del despliegue.
1. Inicie sesión en la interfaz web de Service Manager.
2. En el panel de navegación de la izquierda, haga clic en Despliegues y, a continuación, seleccione el despliegue de Oracle GoldenGate SQL Server. Esto amplía los distintos valores para el despliegue.
3. Haga clic en Configuración y, a continuación, haga clic en el signo más (+) junto a Variables de entorno.
4. Proporcione la siguiente información en los dos campos disponibles. Para el campo Valor de variable de entorno, asegúrese de que sea la ruta absoluta del archivo odbc.ini:
  
  Nombre de Variable de Entorno = ODBCINI
  
  Valor de variable de entorno = ${OGG_HOME)/msodbc/odbc.ini
5. Haga clic en Enviar para crear la nueva variable y, a continuación, reinicie el despliegue desde el panel Despliegues para que se apliquen los cambios.
En la carpeta msodbc de la instalación de Oracle GoldenGate, cree manualmente un archivo odbc.ini y agregue orígenes de datos en este archivo mediante la siguiente información y ejemplo.

Ejemplo para versiones de Oracle GoldenGate anteriores a la versión 23.6, donde Driver se debe definir en 'Controlador 18 de ODBC para SQL Server'
```
[mssql_source]
Driver = ODBC Driver 18 for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```
Ejemplo para las versiones 23.6 o posterior de Oracle GoldenGate, donde Driver se debe definir en 'Controlador ODBC de Microsoft para SQL Server'
```
[mssql_source]
Driver = Microsoft ODBC Driver for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```

Nota: Para obtener una lista completa de las opciones de conexión disponibles, consulte la documentación de Microsoft en el siguiente enlace: https://learn.microsoft.com/en-us/sql/connect/odbc/dsn-connection-string-attribute?view=sql-server-ver16

Guarde y cierre el archivo odbc.ini.
Para crear la conexión de base de datos para el despliegue, consulte Agregar conexiones de base de datos.

Configuración de una conexión DSN en Windows

Antes de crear una conexión de base de datos para los procesos de Oracle GoldenGate que se ejecutan en Windows, instale la última versión del controlador Microsoft ODBC 17 para SQL Server o del controlador Microsoft ODBC 18 para SQL Server.

Siga estos pasos para crear un DSN de sistema en el servidor Windows en el que está instalado Oracle GoldenGate.

Para crear un DSN de SQL Server:

Abra la aplicación ODBC Data Sources (64 bits).
En el cuadro de diálogo Administrador de origen de datos ODBC, seleccione el separador DSN de sistema y, a continuación, haga clic en Agregar.
En Crear nuevo origen de datos, seleccione el controlador ODBC {version} para SQL Server y, a continuación, haga clic en Finalizar. Aparece el asistente Crear un nuevo origen de datos en SQL Server.
Introduzca los siguientes detalles y haga clic en Siguiente:
- Nombre: Puede ser de su elección. En un cluster de Windows, utilice un nombre en todos los nodos del cluster.
- Descripción: (opcional) escriba una descripción de este origen de datos.
- Servidor: escriba la cadena de conexión de SQL Server o el nombre de la instancia del servidor. Para las conexiones Always On, utilice el nombre de la instancia\listener del grupo de disponibilidad Always On.
Para la autenticación de conexión, seleccione Autenticación de SQL Server, especifique la información de ID de conexión y Contraseña y, a continuación, haga clic en Siguiente.
Si está configurando una conexión con el controlador 18 de Microsoft ODBC para SQL Server, vuelva a hacer clic en Siguiente para ir a la última página de configuración. Seleccione la opción para Certificado de servidor de confianza y, a continuación, haga clic en Atrás para continuar, ya que primero debe activar el certificado de servidor de confianza antes de seleccionar la base de datos por defecto en el siguiente paso.
Seleccione Cambiar la base de datos por defecto a y, a continuación, seleccione la base de datos de origen o de destino de la lista. Active la configuración de Usar ANSI y haga clic en Siguiente.
Deje la siguiente página del asistente tal cual y haga clic en Terminar.
Haga clic en Probar Origen de Datos para probar la conexión.
Si la prueba se realiza correctamente, cierre el cuadro de confirmación y el cuadro Crear un nuevo origen de datos.
Repita este procedimiento para cada base de datos de origen y destino de SQL Server, a la que se conectará el proceso de Oracle GoldenGate.

Conexión al Listener de una Configuración Always On de SQL Server

Extract y Replicat pueden conectarse al listener de una configuración Always On o directamente a la réplica principal actual del grupo.

La ventaja de crear la conexión al listener es que Extract o Replicat se pueden volver a conectar a la nueva réplica principal en caso de failover sin tener que volver a configurar la cadena de conexión en la nueva principal.

Un Extract también se puede configurar para enrutar sus consultas de solo lectura a una réplica secundaria de modo síncrono legible disponible. Por defecto, si Extract se conecta a un listener, todo el procesamiento se realizará en la réplica principal, pero si se configura un Extract con el parámetro TRANLOGOPTIONS ALWAYSONREADONLYROUTING, el listener enruta sus consultas de solo lectura a una réplica secundaria legible disponible.

Consulte TRANLOGOPTIONS y Resumen de requisitos para la captura y entrega de bases de datos en un grupo de disponibilidad Always On para obtener más información.

Si está creando el DSN para conectarse a un listener de una configuración Always On, active la opción de failover de varias subredes al crear un DSN. Para las conexiones DSN de Linux, utilice la opción MultiSubnetFailover=Yes en la entrada DSN.