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 desea conectarse y, a continuación, asígnelas al despliegue desde el que se origina la ruta. Por ejemplo, el despliegue en el que crea la ruta de distribución o la ruta de receptor iniciada por el destino.

De lo contrario, en despliegues activados para IAM, se mostrará 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 (23ai)

Si utiliza el almacén de credenciales 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. Haga clic en 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 el nombre de usuario.
    • Contraseña y Verify Password: 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. Haga clic en Agregar conexión de ruta de acceso y, a continuación, complete lo siguiente:
    • Alias de credencial: introduzca un alias.
    • ID de usuario: introduzca el nombre del usuario creado en el paso 2.
    • Contraseña y Comprobar Contraseña: introduzca la contraseña asociada a este usuario en el paso 2.
  5. Haga clic en Ejecutar.
Para agregar una ruta de distribución en GoldenGate 23ai:
  1. En la consola de despliegue GoldenGate de OCI, haga clic en Servicio de distribución.
  2. En la página de inicio, haga clic en Agregar ruta de distribución (icono de más).
  3. En el panel Agregar ruta, complete los campos Información de ruta según sea necesario y, a continuación, haga clic en Siguiente:
    1. Introduzca el nombre de ruta, 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.
  4. En la página Opciones de origen, introduzca los campos según sea necesario y, a continuación, haga clic en 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 que no sea la ubicación por defecto.
    • El URI de Origen Generado se genera automáticamente en función de la información proporcionada. Haga clic en Editar (icono de 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 el procesamiento de datos:
      • Posición en log
      • Now
      • Hora personalizada
      • CSN (en o después de)
    • Introduzca el número de secuencia.
    • Introduzca el Desplazamiento de RBA.
  5. En la página Opciones de destino, complete los campos según sea necesario y, a continuación, haga clic en 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 (sólo protocolo de destino de 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 destino.
    • Introduzca el subdirectorio si la pista está ubicada en un lugar distinto de la ubicación por defecto.
    • Introduzca el tamaño de pista máximo.
    • Seleccione un algoritmo de cifrado de destino utilizado 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. Haga clic en Editar (icono de lápiz) para modificar el URI, si es necesario.
    • Seleccione un método de autenticación de destino (sólo protocolo de destinowss)
      • Alias de ID de usuario

        Note:

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

        Note:

        En los arrendamientos activados para IAM, seleccione OAuth al conectarse a otro despliegue activado para IAM.
      • Certificado
    • Seleccionar un dominio.
    • Seleccione el Alias que tiene Oracle GoldenGate UserID y la contraseña.
    • Seleccione un tipo de destino:
      • GGFormat (valor por defecto)
      • SQL
      • XML
      • Texto sin formato
  6. En la página Opciones avanzadas, complete los campos según sea necesario y, a continuación, haga clic en Siguiente:
    • Active Activar compresión de red para definir el Umbral de compresión.
    • Seleccione EOF Delay.

      Note:

      En plataformas Linux, se pueden mantener la configuración por defecto. Sin embargo, en plataformas que no sean Linux, puede que necesite ajustar esta configuración para el ancho de banda alto, las redes de alta latencia o las redes que tengan configuración de Calidad del 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 TCP Flush Bytes (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 un reconocimiento rápido después de recibir los datos.
    • Active TCP_CORK para permitir el uso de la opción cork del algoritmo de Nagle.
    • Introduzca el Tamaño de buffer de envío del sistema para definir el valor del tamaño del buffer de envío para el control de flujo.
    • Introduzca el System Receive Buffer Size para definir el valor del tamaño del buffer de recepción para el control de flujo.
    • Defina el timeout para Mantenimiento de conexiones.
  7. En la página Opciones de filtrado, complete los siguientes campos según sea necesario y, a continuación, haga clic en Siguiente:
    • Introduzca un nombre de regla.
    • Seleccione una acción de regla:
      • Excluir filtra los datos según las opciones seleccionadas.
      • Incluir incluye datos según las opciones especificadas.
    • Seleccione un tipo de filtro:
      • Tipo de objeto: seleccione entre tres tipos de objeto: DML, DDL y Procedimiento
      • Nombres de objeto: seleccione esta opción para proporcionar un nombre de 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; de lo contrario, es obligatoria 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 de procedimiento: seleccione esta opción para filtrar, en función del nombre de característica de procedimiento existente.
      • Basado en Columnas: 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 las condiciones 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 fragmentos de la base de datos; sin embargo, los detalles no se pueden editar.
    • Seleccione Negate (Negar) para denegar cualquier regla existente.
    • Haga clic en Agregar para agregar la regla.
  8. En la página Opciones gestionadas, rellene los campos opcionales según sea necesario.
    • Active Critical (Crítico) para configurar esta ruta para alta disponibilidad.
    • Active Auto Restart para ajustar los reintentos de reinicio automático y las opciones de retraso de reinicio automático.
  9. Haga clic en Crear y ejecutar para ejecutar la ruta de acceso inmediatamente. Haga clic en Crear para ejecutar la ruta manualmente más adelante.
Vuelva a la página inicial, donde puede ver el estado del proceso Path.

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

Agregue una credencial que permita a un despliegue de origen (el despliegue en el que crea esta ruta) conectarse a un despliegue de destino:
  1. En la consola de despliegue de destino, conéctese y, a continuación, acceda a la página Administrador desde el menú de navegación.
  2. Haga clic en Agregar usuario y, a continuación, cree un usuario que el despliegue de origen pueda utilizar 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, haga clic en 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
    • ID de usuario: introduzca el nombre del usuario creado en el paso 2.
    • Contraseña y Comprobar Contraseña: introduzca la contraseña asociada a este usuario en el paso 2.
  5. Haga clic en Ejecutar.
Para agregar una ruta de distribución:
  1. En la consola de despliegue de OCI GoldenGate, haga clic en Servicio de distribución.
  2. En la página Visión general del servicio de distribución, haga clic en Agregar ruta (icono de signo más).
  3. En la página Agregar ruta, complete los campos de la siguiente forma:
    1. En Nombre de 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 pista, seleccione la pista del extracto 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. Haga clic en Editar (icono de lápiz) para modificar el URI, si es necesario.
    7. En Método de autenticación del destino, seleccione el método de autenticación para el URI de destino:
      • OAuth: seleccione esta opción si los despliegue 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.

        Note:

        En los arrendamientos activados para IAM, seleccione OAuth al conectarse a otro despliegue activado para IAM.
      • UserID Alias: esta opción utiliza un alias UserID que puede crear en el destino Oracle GoldenGate para establecer una conexión.

        Note:

        Cree una credencial mediante el usuario de IAM al conectarse a un despliegue activado para IAM desde un despliegue de almacén de credenciales GoldenGate. Asegúrese de que el usuario existe en el segmento de identidad de IAM.
    8. En Destino, seleccione un protocolo de transferencia de datos 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. Haga clic en Editar (icono de 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. En Activar compresión de red, seleccione esta opción para definir el umbral de compresión.
    12. En Longitud de secuencia, introduzca la longitud del número de secuencia 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 de 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 de origen, seleccione el número de secuencia del despliegue de origen del archivo de pista Extract.
    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 se reinicie automáticamente si se ha terminado.
    9. En Opciones de reinicio automático, indique el número de intentos para reiniciar el proceso de ruta y el intervalo de duración del retraso entre intentos.
  5. En Configuración de juego de reglas, complete los siguientes campos según sea necesario:
    1. En Activar filtrado, si está seleccionado, haga clic en 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 recibo 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. Click Create and Run.
Vuelva a la página Overview, donde puede ver el estado del proceso Path.

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

Para crear rutas de distribución a las que enviar datos o de las que extraer datos desde Oracle Cloud Infrastructure GoldenGate, asegúrese de agregar el certificado raíz a la gestión de certificados o a la cartera de cliente

Para enviar datos o extraer datos desde OCI GoldenGate, debe crear una ruta de servidor de distribución o una ruta iniciada por el destino en el servidor del receptor en su instancia de Oracle GoldenGate local o de Marketplace, respectivamente. También debe agregar el certificado raíz de OCI GoldenGate o el certificado autofirmado a la gestión de certificados de Oracle GoldenGate (Oracle GoldenGate 21c o superior) o a la cartera de cliente (Oracle GoldenGate 19c). Esto crea una conexión de confianza entre los despliegues de Oracle GoldenGate y OCI GoldenGate. Solo está soportado el protocolo WebSocket Secure (WSS) para las rutas de servidor de distribución y de receptor entre Oracle GoldenGate y OCI GoldenGate.

Un cambio en el certificado raíz de OCI GoldenGate provocará que falle la ruta del servidor de distribución o una ruta iniciada por el destino en el servidor del receptor de su instancia de Oracle GoldenGate local o de Marketplace y que genere el siguiente error:

ERROR   OGG-10390  Oracle GoldenGate Receiver Service:  Generic error -1 noticed for endpoint
      wss://<deployment URL>:443/services/v2/sources?trail=<trail name>. Error description - SSL
      connection unexpectedly closed.

Solución alternativa: para solucionar esta incidencia, actualice el certificado en la cartera de cliente o en la pantalla Gestión de certificados del Gestor de servicios para utilizar el certificado raíz de la consola de despliegue GoldenGate de OCI. En algunos casos, cuando el certificado del despliegue de OCI GoldenGate no está firmado directamente por el certificado raíz, sino por uno o varios intermedios, por ejemplo, puede que sea necesario agregar también los certificados de CA intermedios.

Más información:

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.