Preparar conexión a base de datos

Oracle GoldenGate para Yugabyte (variante PostgreSQL) se conecta a bases de datos de Yugabyte 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 a la base de datos desde la interfaz web o desde el cliente de administración.

Nota: PgBouncer no está soportado para las conexiones de Oracle GoldenGate.

Nota: Oracle GoldenGate no soporta conexiones a Yugabyte que utilicen Pgpool.

Después de realizar los pasos indicados a continuación para crear las entradas DSN o planea utilizar conexiones directas, continúe con el tema Agregar conexiones de base de datos para saber cómo crear conexiones de base de datos.

Configurar una conexión basada en DSN

Para crear una conexión DSN para los procesos de Oracle GoldenGate, primero deberá agregar una variable de entorno para el despliegue de Oracle GoldenGate para Yugabyte y, a continuación, crear un archivo odbc.ini para almacenar los atributos de conexión.

1. Inicie sesión en la interfaz web de Service Manager.

2. En el panel de navegación de la izquierda, haga clic en Deployments y, a continuación, seleccione el nombre de despliegue para Yugabyte. 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:

   Environment Variable Name (Nombre de variable de ambiente) = ODBCINI

   Valor de variable de entorno = /ogg/deployment/yugabyte/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.

6. En la carpeta deployment de la instalación de Oracle GoldenGate, cree manualmente un archivo odbc.ini y agregue orígenes de datos en este archivo.

Utilice los siguientes valores mínimos al crear el archivo DSN:

• Data Source Name: nombre definido por el usuario de una conexión de base de datos de origen o destino a la que harán referencia los procesos de Oracle GoldenGate, como Extract o Replicat. Los nombres DSN tienen un máximo de 32 caracteres alfanuméricos y solo pueden incluir guiones bajos (_) y guiones (-) de caracteres especiales.

• IANAAppCodePage=4: es el valor por defecto, pero se puede modificar según la orientación especificada en la página https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 cuando el juego de caracteres de la base de datos no es Unicode.

• InstallDir: es el nombre de la ruta del controlador del protocolo de transferencia PostgreSQL de Oracle GoldenGate y puede utilizar una ruta relativa, como: InstallDir =./datadirect

• Driver: es el nombre del archivo de controlador de protocolo de transferencia electrónica PostgreSQL de Oracle GoldenGate y puede utilizar una ruta relativa, como: Driver=./datadirect/lib/ggpsql25.so.

• Database: nombre de la base de datos de origen o destino.

• Hostname: dirección IP o nombre de host del host de la base de datos.

• PortNumber: puerto de recepción de la base de datos.

• Oracle GoldenGate para Yugabyte admite varios hosts y puertos para conexiones de Yugabyte. Esta función es útil en la configuración de alta disponibilidad (HA) de Oracle GoldenGate. En una configuración de alta disponibilidad de Yugabyte, hay un servidor principal y varios servidores en espera. Puede configurar el formato de cadena de conexión para especificar varios hosts:

  Cadena de conexión	Descripción
  db-user@host1,host2,host3/db-name	Las conexiones se intentarían utilizando el puerto de base de datos Yugabyte 5433 por defecto para todos los hosts (host1, host2, host3).
  db-user@host1:1234,host2:2345,host3:3456/db-name	Las conexiones se intentarían utilizando los puertos asociados con cada host especificado en la cadena de conexión.
  db-user@host1,host2,host3:1234/db-name	Todos los hosts que utilizan el mismo número de puerto (1234) en todos los hosts (host1, host2, host3). Las conexiones se intentarían mediante el puerto 1234 para todos los hosts (host1, host2, host3).
  db-user@host1,host2,host3:1234/db-name	Todos los hosts que utilizan el mismo número de puerto (1234) en todos los hosts (host1, host2, host3). Las conexiones se intentarían utilizando el puerto 1234 para todos los hosts.
  db-user@host1:3456,host2,host3:1234/db-name	Si la cadena de conexión se especifica en otros formatos en los que el número de puerto se especifica para algunos hosts mientras que los otros hosts se especifican sin puertos, se utilizará la última especificación de puerto o la más a la derecha como número de puerto para todos los hosts que no tienen un número de puerto especificado en la cadena de conexión. Como se muestra en la cadena de conexión: db-user@host1:3456,host2,host3:1234/db-name El número de puerto para host2 sería 1234, que es el número de puerto más a la derecha especificado en la cadena de conexión.

• También puede proporcionar un valor LogonID y Password para el usuario Extract o Replicat, pero estos se almacenarán en texto no cifrado. Se recomienda dejar estos campos fuera del DSN y, en su lugar, almacenarlos en la cartera de Oracle GoldenGate como alias de credencial y hacer referencia a ellos con el parámetro USERIDALIAS en Extract y Replicat.

A continuación, se muestra un archivo odbc.ini de ejemplo con dos entradas DSN. Los nombres de origen de datos utilizados en el ejemplo siguiente son PG_src y 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. Guarde y cierre el archivo odbc.ini.

2. Para configurar la conexión a la base de datos desde Oracle GoldenGate para un despliegue de Yugabyte, consulte Agregar conexiones a base de datos.