Adición de una ruta de distribución

Una ruta de distribución envía la transacción de datos de un Extract a un Replicat.

Cuándo utilizar una ruta de distribución

Utilice una ruta de distribución cuando necesite replicar datos en un entorno de despliegue distribuido. Una ruta de distribución envía la transacción de datos del Extract al Replicat. Cuando se crea y ejecuta una ruta de distribución, se crea automáticamente una ruta de receptor en el servicio de receptor del despliegue de destino. La ruta del receptor recibe la transacción de datos del servicio de distribución del despliegue de origen.

El despliegue de origen es el despliegue en el que se crea la ruta de distribución. El despliegue de destino es el despliegue al que se envían los datos extraídos y las pistas.

Antes de empezar

Asegúrese de crear conexiones GoldenGate para cada despliegue al que desee conectarse y, a continuación, asígnelas al despliegue desde el que se origina la ruta de acceso. Por ejemplo, el despliegue en el que se crea la ruta de distribución o la ruta de receptor iniciada por el destino.

De lo contrario, en los despliegues activados para IAM, encontrará el error:

The network connection could not be established: 'OGG-08654' - 'Invalid or missing OAuth
      resource - audiencescope in Client application'.

Creación y ejecución de una ruta de distribución (26ai)

Si utiliza el almacén de credenciales de GoldenGate, debe agregar un usuario con el que se utilice el despliegue de origen para conectarse a un despliegue de destino. Si utiliza el almacén de credenciales de IAM, omita estos pasos.

  1. En la consola de despliegue de destino, conéctese y, a continuación, acceda a la página Administración de usuarios desde la navegación izquierda.

  2. Seleccione Agregar nuevo usuario y, a continuación, complete lo siguiente:

    • Autenticado por: seleccione Contraseña en la lista desplegable.

    • Rol: seleccione Operador en la lista desplegable.

    • Nombre de usuario: introduzca su nombre de usuario.

    • Contraseña y Verificar contraseña: introduzca la contraseña asociada a este usuario.

  3. Abra la consola de despliegue de origen y, a continuación, navegue hasta Conexiones de ruta en el menú de navegación de la izquierda.

  4. Seleccione Agregar conexión de ruta y, a continuación, complete lo siguiente:

    • Alias de credencial: introduzca un alias.

    • User ID (ID de usuario): introduzca el nombre del usuario creado en la etapa 2.

    • Password (Contraseña) y Verify Password (Verificar contraseña): introduzca la contraseña asociada a este usuario del paso 2.

  5. Seleccione Enviar.

Para agregar una ruta de distribución en GoldenGate 26ai:

  1. En la página inicial de la consola de despliegue de OCI GoldenGate, seleccione Crear (icono más) para las rutas de distribución.

  2. En el panel Agregar ruta, complete los campos Información de ruta según sea necesario y, a continuación, seleccione Siguiente:

    1. Introduzca el Nombre de la ruta e introduzca un nombre para la ruta.

    2. (Opcional) Introduzca una descripción para describir la finalidad de esta ruta y mostrar los Extract y Replicats implicados.

  3. En la página Opciones de origen, introduzca los campos según sea necesario y, a continuación, seleccione Siguiente:

    • Seleccione el Extracto de origen en la lista desplegable.

    • Introduzca el nombre de pista.

    • Introduzca el subdirectorio si espera que la pista esté en una ubicación distinta de la predeterminada.

    • El URI de origen generado se genera automáticamente en función de la información proporcionada. Seleccione Editar (icono del lápiz) para modificar el URI, si es necesario.

    • Seleccione un Perfil de cifrado. El perfil Cartera local está seleccionado por defecto si no se ha creado un perfil de cifrado.

    • En Iniciar, seleccione el punto de inicio para procesamiento de datos:

      • Posición en log

      • Now

      • Hora personalizada

      • CSN (en o después de)

    • Introduzca el Número de secuencia.

    • Introduzca RBA Offset (Desplazamiento de RBA).

  4. En la página Opciones de destino, complete los campos según sea necesario y, a continuación, seleccione Siguiente:

    • Seleccione un protocolo de destino:

      • ws

      • WSS

      • ogg

    • (Opcional) Active Proxy inverso activado para conectarse al destino mediante un proxy inverso.

    • Tipo de destino (solo protocolo de destino OGG)

      • Gestor

      • Recopilador

      • Servicio de receptor

    • Introduzca el host de destino.

    • Introduzca el número de puerto del despliegue de destino.

    • Introduzca el Nombre de pista para el archivo de pista de origen.

    • Introduzca el subdirectorio si la pista se encuentra en otro lugar que no sea la ubicación por defecto.

    • Introduzca el Tamaño de pista máximo.

    • Seleccione un algoritmo de cifrado de destino que se utilice para enviar la pista al despliegue de destino:

      • NONE

      • AES128

      • AES192

      • AES256

    • Active Cambiar cifrado para permitir cambios en el algoritmo de cifrado.

    • El URI de destino generado se genera automáticamente en función de la información proporcionada. Seleccione Editar (icono del lápiz) para modificar el URI, si es necesario.

    • Seleccione un método de autenticación de destino (solo protocolo de destinowss)

      • Alias de ID de usuario

        Nota: Cree una credencial mediante el usuario de IAM al conectarse a un despliegue activado para IAM desde un despliegue de almacén de credenciales de GoldenGate. Asegúrese de que el usuario existe en el segmento de identidad de IAM.

      • OAuth

        Nota: En los arrendamientos activados para IAM, seleccione OAuth al conectarse a otro despliegue activado para IAM.

      • Certificado

    • Seleccione un dominio.

    • Seleccione el alias que tiene el ID de usuario y la contraseña de Oracle GoldenGate.

    • Seleccione un tipo de objetivo:

      • GGFormat (predeterminado)

      • SQL

      • XML

      • Texto sin formato

  5. En la página Opciones avanzadas, complete los campos según sea necesario y, a continuación, seleccione Siguiente:

    • Active Activar compresión de red para definir el umbral de compresión.

    • Seleccione EOF Delay (Retraso de EOF).

      Nota: En plataformas Linux, se puede mantener la configuración por defecto. Sin embargo, en plataformas que no son Linux, es posible que necesite ajustar esta configuración para el ancho y las redes que tengan configuración de calidad de servicio (QoS) (DSCP y tiempo de servicio [ToS])

    • Seleccione la frecuencia de punto de control para definir la frecuencia de la ruta que toma el punto de control (en segundos).

    • Introduzca los Bytes de vaciado de TCP (en bytes).

    • Introduzca los segundos de vaciado de TCP (en segundos).

    • Seleccione el punto de código de servicios diferenciados (DSCP).

    • Seleccione el tipo de servicio (TOS).

    • Active TCP_NODELAY para evitar retrasos al utilizar la opción de Nagle.

    • Active ACK rápido para enviar acuse de recibo rápido después de recibir datos.

    • Active TCP_CORK para permitir el uso de la opción de corcho de algoritmo de Nagle.

    • Introduzca el valor System Send Buffer Size (Tamaño del búfer de envío del sistema) para definir el valor del tamaño del búfer de envío del control de flujo.

    • Introduzca el valor de System Receive Buffer Size (Tamaño de búfer de recepción del sistema) para definir el valor del tamaño del búfer de recepción del control de flujo.

    • Defina el timeout para Mantener activo.

  6. En la página Opciones de filtro, complete los siguientes campos según sea necesario y, a continuación, seleccione Siguiente:

    • Introduzca un nombre de regla.

    • Seleccione una acción de regla:

      • Excluir filtra los datos en función de las opciones seleccionadas.

      • Incluir incluye datos basados en las opciones especificadas.

    • Seleccione un tipo de filtro:

      • Tipo de objeto: seleccione entre tres tipos de objeto: DML, DDL y Procedimiento

      • Object Names (Nombres de objeto): seleccione esta opción para proporcionar un nombre del objeto existente. Una convención de nomenclatura en tres partes depende de si utiliza CDB. Con CDB, debe utilizar una convención de nomenclatura de 3 partes; en caso contrario, se necesita una convención de 2 partes. La convención de 3 partes incluye container, schema, object. La convención de 2 partes incluye schema, object name.

      • Nombre de característica del procedimiento: seleccione esta opción para filtrar, en función del nombre del procedimiento existente.

      • Basado en Columna: si selecciona esta opción, aparecerá la opción para introducir el nombre de tabla y columna a la que se aplica la regla. Puede filtrar utilizando el valor de columna con la condición LT, GT, EQ, LE, GE y NE. También puede especificar si desea que la imagen esté antes o después en los datos filtrados.

      • Etiqueta: seleccione esta opción para definir el filtro basado en etiquetas.

      • ID de fragmento: muestra los detalles de configuración de las particiones horizontales del base de datos; sin embargo, los detalles no se pueden editar.

    • Seleccione Negate para negar cualquier regla existente.

    • Seleccione Agregar para agregar la regla.

  7. En la página Opciones gestionadas, complete los campos opcionales según sea necesario.

    • Active Critical (Crítico) para configurar esta ruta de acceso para alta disponibilidad.

    • Active Reinicio automático para ajustar los reintentos de reinicio automático y las opciones de retraso de reinicio automático.

  8. Seleccione Crear y ejecutar para ejecutar la ruta de acceso inmediatamente. Seleccione Crear para ejecutar la ruta de acceso manualmente más tarde.

Volverá a la página de inicio, donde podrá ver el estado del proceso Ruta.

Creación y ejecución de una ruta de distribución (21c)

Agregue una credencial que permita que un despliegue de origen (el despliegue en el que crea esta ruta) se conecte a un despliegue de destino:

  1. En la consola de despliegue de destino, conéctese a la página Administrator (Administrador) y, a continuación, acérquese a la página desde el menú.

  2. Seleccione Agregar usuario y, a continuación, cree un usuario que pueda utilizar el despliegue de origen para conectarse al despliegue de destino. Asigne a este usuario el rol Operador.

  3. Abra la consola de despliegue de origen y, a continuación, navegue a la página Configuración.

  4. En el separador Base de datos, seleccione Agregar credencial y, a continuación, complete lo siguiente:

    • Dominio de credenciales: introduzca un nombre para esta conexión

    • Alias de credencial: introduzca un alias

    • User ID (ID de usuario): introduzca el nombre del usuario creado en la etapa 2.

    • Password (Contraseña) y Verify Password (Verificar contraseña): introduzca la contraseña asociada a este usuario del paso 2.

  5. Seleccione Enviar.

Para agregar una ruta de distribución:

  1. En la Consola de Despliegue de OCI GoldenGate, seleccione Servicio de Distribución.

  2. En la página Visión General del Servicio de Distribución, seleccione Agregar ruta (icono de signo mas).

  3. En la página Agregar ruta, complete los campos de la siguiente forma:

    1. En Nombre de la ruta, introduzca un nombre para la ruta.

    2. (Opcional) En Descripción, introduzca una breve descripción de la finalidad de esta ruta.

    3. (Opcional) Active Proxy inverso activado para conectarse al destino mediante un proxy inverso.

    4. En Origen, seleccione el nombre del Extract en la lista desplegable.

    5. En Nombre de la pista, seleccione la pista del Extract en la lista desplegable.

    6. En URI de origen generado, el URI se genera automáticamente en función de la información de Extract proporcionada. Seleccione Editar (icono del lápiz) para modificar el URI, si es necesario.

    7. En Método de autenticación de destino, seleccione el método de autenticación para el URI de destino:

      • OAuth: seleccione esta opción si los despliegues de origen y destino están activados para IAM. Esta opción utiliza las credenciales de cliente para la autenticación del servicio de distribución al servicio de receptor.

        Nota: En los arrendamientos con IAM activado, seleccione OAuth al conectarse a otro despliegue con IAM activado.

      • Alias de ID del usuario: esta opción utiliza un alias de ID de usuario que puede crear en el destino Oracle GoldenGate para establecer una conexión.

        Nota: Cree una credencial mediante el usuario de IAM al conectarse a un despliegue activado para IAM desde un despliegue de almacén de credenciales de GoldenGate. Asegúrese de que el usuario existe en el segmento de identidad de IAM.

    8. En Destino, seleccione un protocolo de transferencia del dato en la lista desplegable:

      • wss: el socket web seguro es la opción por defecto. Si está seleccionada, debe completar los siguientes campos:

        • Host de Destino

        • Número de puerto

        • Nombre de pista

        • Nombre de despliegue (proxy inverso activado)

        • Ruta de URI (proxy inverso activado)

        • Dominio

        • Alias

      • ogg: si selecciona esta opción, debe completar los siguientes campos:

        • Host de Destino

        • Número de puerto

        • Nombre de pista

        • Nombre de despliegue (proxy inverso activado)

        • Ruta de URI (proxy inverso activado)

      • ws: si selecciona esta opción, debe completar los siguientes campos:

        • Host de Destino

        • Número de puerto

        • Nombre de pista

        • Nombre de despliegue (proxy inverso activado)

        • Ruta de URI (proxy inverso activado)

        • Dominio

        • Alias

    9. En URI de destino generado, el URI se rellena automáticamente a partir de la información proporcionada. Seleccione Editar (icono del lápiz) para modificar el URI, si es necesario.

    10. En Algoritmo de cifrado de destino, seleccione un algoritmo de cifrado para la pista de destino:

      • ninguno

      • AES128

      • AES192

      • AES256

    11. Para Activar compresión de red, seleccione esta opción para definir el límite de compresión.

    12. En Longitud de Secuencia, introduzca la longitud del número del orden de pista.

    13. En Tamaño de Pista (MB), introduzca el tamaño máximo de un archivo en una pista.

    14. Para Configurar Formato de Pista, active esta opción si desea configurar el formato del archivo de pista y, a continuación, complete los campos adicionales según sea necesario.

  4. En la sección Perfil de cifrado, complete los siguientes campos según sea necesario:

    1. Nombre del perfil

    2. Tipo de perfil de cifrado

    3. Nombre de clave maestra

    4. En Inicio, seleccione dónde desea registrar los datos:

      • Now

      • Hora personalizada

      • Posición en log (valor por defecto)

    5. Para Número de secuencia del origen, seleccione el número de secuencia del Extract del despliegue del archivo del origen de pista.

    6. En Desfase de RBA de origen, introduzca la Dirección de byte relativa (RBA) del archivo de pista donde desea que se inicie el proceso.

    7. En Crítico, defina esta opción en Verdadero si la ruta de distribución es esencial para el despliegue. El valor por defecto es Falso.

    8. Para Reinicio automático, defina esta opción en Verdadero si desea que la ruta de distribución la reinicie automáticamente si se ha terminado.

    9. En Opciones de reinicio automático, indique el número de reintentos para reiniciar la ruta de acceso y el intervalo en la duración del retraso entre reintentos.

  5. En Configuración de juego de reglas, complete los siguientes campos según sea necesario:

    1. En Activar filtrado, si se ha seleccionado, seleccione Agregar regla y, a continuación, complete los campos adicionales.

  6. En Más opciones, rellene los siguientes campos según sea necesario:

    1. Retraso de EOF: retraso de fin de archivo antes de buscar datos de origen

    2. Frecuencia de punto de control: frecuencia en segundos para puntos de control de rutina

    3. Opciones de aplicación

      • Bytes de vaciado de TCP: tamaño de vaciado

      • Segundos de vaciado de TCP: intervalo de vaciado

    4. Opciones de TCP

      • DSCP: servicios diferenciados de red

      • Condiciones de servicio TOS

      • TCP_NODELAY: desactiva el uso del algoritmo de Nagle si está activado

      • ACK rápido: envía acuse de recepción si está activado

      • TCP_CORK: activa el uso del algoritmo de Nagle

      • Tamaño de buffer de envío del sistema

      • Tamaño de buffer de recepción del sistema

      • Mantenimiento de conexiones: timeout del mantenimiento de conexiones

  7. Seleccione Crear y ejecutar.

Volverá a la página Visión general, donde podrá ver el estado del proceso Ruta.

Más información

¿Está interesado en obtener más información sobre el proceso de ruta de distribución? Consulte los siguientes recursos:

Incidencias conocidas

Las rutas de distribución y receptor pueden fallar después de actualizar los despliegues de la versión 21.x a la versión 21.17

A partir de las versiones 21.17 y 26ai de Oracle GoldenGate, las rutas utilizan el nombre de dominio reservado por defecto, "Red", por lo que las rutas existentes que utilizan cualquier otro nombre de dominio fallan con el siguiente error informado:

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

Solución alternativa: en la consola de despliegue de OCI GoldenGate, edite cada ruta y cambie el nombre de dominio a "Red" y, a continuación, reinicie la ruta. Para verificarlo, compruebe el dominio del usuario de autenticación de ruta de acceso en la sección Almacén de credenciales de la página Configuración.

Si prefiere utilizar el cliente de administración, ejecute los siguientes comandos para actualizar el nombre de dominio. Asegúrese de sustituir los marcadores de posición <path_name> y <alias>:

Para rutas iniciadas por el origen:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

Para rutas iniciadas en el destino:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Actualmente solo está soportada la autenticación de resumen

Oracle Cloud Infrastructure GoldenGate no soporta actualmente la autenticación basada en certificados cuando se utiliza Oracle Cloud Infrastructure GoldenGate como destino de ruta de distribución.

Solución alternativa: ninguna.