Conexión a OCI Streaming

Descubra cómo crear una conexión a OCI Streaming para utilizarla como origen o destino con OCI GoldenGate Data Replacement y Stream Analytics.

Antes de empezar

Asegúrese de que:

Consulte cómo se conecta OCI GoldenGate a su origen y destinos.
Configure las políticas necesarias para permitir el acceso seguro a Vault y Secrets, como el uso de secretos, el uso de almacenes y la lectura de paquetes secretos. Para obtener más información, consulte Políticas mínimas recomendadas.
Si utiliza entidades de recurso para autenticar el acceso a OCI Streaming, debe:
1. Cree un grupo dinámico para el despliegue. Puede autorizar un único despliegue o todos los despliegues en un compartimento o arrendamiento. Consulte Escritura de reglas de coincidencia para definir los grupos dinámicos.
2. Agregar las políticas necesarias para el grupo dinámico
Obtenga el nombre de usuario del pool de flujos:
1. En el menú del navegador de la consola de Oracle Cloud, seleccione Flujo y, a continuación, Pools de Streams.
2. En la página Pools de flujos, seleccione el pool para ver los detalles.
3. En la página de detalles de pool de flujos, en Recursos, seleccione Configuración de conexión de Kafk.
4. Copie el nombre de usuario de Cadenas de conexión de SASL.
  
  Nota: Si utiliza el servicio Oracle Identity Cloud, debe agregar OracleIdentityCloudService a su nombre de usuario. Por ejemplo, <tenancy-name>/OracleIdentityCloudService/<username>/<streampool-ocid>
5. Cree un token de autenticación:
  1. En la cabecera global de la consola de Oracle Cloud, seleccione Perfil y, a continuación, seleccione Configuración de usuario.
  2. En la página Detalles de usuario, en Recursos, seleccione Tokens de autenticación y, a continuación, Generar token.
  3. En el cuadro de diálogo Generar token, introduzca una descripción y, a continuación, seleccione Generar token.
  4. Copie el token de autenticación del cuadro a una ubicación segura desde donde pueda recuperarlo más tarde y, a continuación, seleccione Cerrar.
Se introducirán el nombre de usuario y el token de autenticación del Pool de flujos en el nombre de usuario y la contraseña de la conexión de flujo.

Crear la conexión de origen

Para crear una conexión de OCI Streaming de origen:

En la página Visión general de OCI GoldenGate, seleccione Conexiones.

También puede seleccionar Crear conexión en la sección Introducción y saltar al paso 3.
En la página Conexiones, seleccione Crear conexión.
En la página Crear conexión, complete los campos como se indica a continuación:
1. En Nombre, introduzca un nombre para la conexión.
2. (Opcional) En Descripción, introduzca una descripción que le ayude a distinguir esta conexión de otras.
3. (Solo para GoldenGate en multinube) Seleccione su suscripción y, a continuación, complete los siguientes campos.
  1. En la lista desplegable Compartimento, seleccione el compartimento en el que reside el anclaje de recursos.
  2. Seleccione la región de socios multinube.
  3. Seleccione su zona de disponibilidad de partners. Las opciones disponibles se rellenan en función de la región de socio multinube seleccionada.
4. En Compartimento, seleccione el compartimento en que desea crear la conexión.
5. En la lista desplegable Tipo, seleccione OCI Streaming.
6. Para obtener los detalles del pool de flujos, puede elegir:
  - Seleccione un pool de flujos en la lista desplegable o seleccione Cambiar compartimento para seleccionar uno en un compartimento diferente.
  - Introduzca la información del pool de flujos para introducir manualmente el Host y el Puerto del servidor de inicialización de datos.
    
    Nota: Si introduce una IP privada, OCI GoldenGate reescribe la IP privada con el formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
7. Para Usuario, seleccione cómo autenticar y acceder al pool de flujos:
  - Nombre de usuario y contraseña: introduzca el nombre de usuarios del pool de flujos que han copiado de la configuración de conexión SASL en los pasos previos anteriores.
  - Usar entidad de recurso: se autentica mediante la entidad de recurso para acceder a otros recursos de OCI.
8. Seleccione el Secreto de contraseña de usuario de base de Datos. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
  Nota:
  - Los secretos son credenciales como contraseñas, certificados, claves SSH o tokens que se utilizan con los servicios de OCI. Para crear un secreto, consulte Creación de un secreto. Asegúrese de que:
    - Seleccione Generación manual de secretos.
    - Pegue las credenciales en Contenido secreto.
  - Si prefiere no utilizar secretos de contraseña, asegúrese de anular la selección de Usar secretos en almacén en la sección Seguridad de Opciones avanzadas, situada en la parte inferior de este formulario.
  - Cuando necesite actualizar el contenido del secreto, asegúrese de lo siguiente:
    - Cree una nueva versión del secreto mediante la plantilla de texto sin formato y proporcione el contenido actualizado. Para obtener más información, consulte Actualización del contenido de un secreto.
    - Refresque la conexión para borrar el contenido secreto almacenado en caché.
9. Amplíe Mostrar opciones avanzadas. Puede configurar las siguientes opciones:
  - Seguridad
    - Anule la selección de Usar secretos de almacén que prefiera no utilizar secretos de contraseña para esta conexión. Si no está seleccionado:
      - Seleccione Usar clave de cifrado gestionada por Oracle para dejar toda la gestión de claves de cifrado en Oracle.
      - Seleccione Usar clave de cifrado gestionada por el cliente para seleccionar una clave de cifrado específica almacenada en OCI Vault para cifrar las credenciales de conexión.
  - Conectividad de Red
    - Punto final compartido, para compartir un punto final con el despliegue asignado. Debe permitir la conectividad desde la IP de entrada del despliegue.
    - Punto final dedicado, para el tráfico de red a través de un punto final dedicado en la subred asignada de la VCN. Debe permitir la conectividad desde las IP de entrada de esta conexión.
      Nota:
      
      Si una conexión dedicada permanece sin asignar durante siete días, el servicio la convierte en una conexión compartida.
      
      Obtenga más información sobre la conectividad de Oracle GoldenGate.
  - Valores
    
    Para capturar desde OCI Streaming, cree un archivo consumer.properties con uno de los siguientes deserializadores o convertidores y, a continuación, arrastre y suelte el archivo en Propiedades de consumidor:
    - Propiedades de consumidor de Kafka para el deserializador JSON:
```
key.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
value.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
```
    - Propiedades de consumidor de Kafka para el conversor de JSON:
```
key.converter=org.apache.kafka.connect.json.JsonConverter
value.converter=org.apache.kafka.connect.json.JsonConverter
```
    - Kafka Propiedades de consumo para convertidor Avro:
```
key.converter=io.confluent.connect.avro.AvroConverter
value.converter=io.confluent.connect.avro.AvroConverter
```
  - Atributos de seguridad: agregue atributos de seguridad para controlar el acceso a esta conexión mediante Enrutamiento de paquetes de confianza cero (ZPR).
  - Etiquetas: agregue etiquetas para organizar los recursos.
Seleccione Crear.

Una vez creada la conexión, esta aparecerá en la lista Conexiones. Asegúrese de asignar la conexión a un despliegue para utilizarla como origen o destino en una replicación.

Crear la conexión de destino

Para crear una conexión de OCI Streaming de destino:

En la página Visión general de OCI GoldenGate, seleccione Conexiones.

También puede seleccionar Crear conexión en la sección Introducción y saltar al paso 3.
En la página Conexiones, seleccione Crear conexión.
En la página Crear conexión, complete los campos como se indica a continuación:
1. En Nombre, introduzca un nombre para la conexión.
2. (Opcional) En Descripción, introduzca una descripción que le ayude a distinguir esta conexión de otras.
3. (Solo para GoldenGate en multinube) Seleccione su suscripción y, a continuación, complete los siguientes campos.
  1. En la lista desplegable Compartimento, seleccione el compartimento en el que reside el anclaje de recursos.
  2. Seleccione la región de socios multinube.
  3. Seleccione su zona de disponibilidad de partners. Las opciones disponibles se rellenan en función de la región de socio multinube seleccionada.
4. En Compartimento, seleccione el compartimento en que desea crear la conexión.
5. En la lista desplegable Tipo, seleccione OCI Streaming.
6. Para obtener los detalles del pool de flujos, puede elegir:
  - Seleccionar un pool de flujos
    1. Seleccione un pool de flujos de la lista desplegable o seleccione Cambiar compartimento para seleccionar uno en un compartimento diferente.
  - Introduzca la información de pool de flujos para introducir manualmente la información de pool de flujos.
    1. Introduzca el Host y el Puerto del servidor de inicialización de datos.
    Nota: Si introduce una IP privada, OCI GoldenGate reescribe la IP privada con el formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
7. Para Usuario, seleccione cómo autenticar y acceder al pool de flujos:
  - Nombre de usuario y contraseña: introduzca el nombre de usuarios del pool de flujos que han copiado de la configuración de conexión SASL en los pasos previos anteriores.
  - Usar entidad de recurso: se autentica mediante la entidad de recurso para acceder a otros recursos de OCI.
8. Seleccione el Secreto de contraseña de usuario de base de Datos. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
  Nota:
  - Los secretos son credenciales como contraseñas, certificados, claves SSH o tokens que se utilizan con los servicios de OCI. Para crear un secreto, consulte Creación de un secreto. Asegúrese de que:
    - Seleccione Generación manual de secretos.
    - Pegue las credenciales en Contenido secreto.
  - Si prefiere no utilizar secretos de contraseña, asegúrese de anular la selección de Usar secretos en almacén en la sección Seguridad de Opciones avanzadas, situada en la parte inferior de este formulario.
  - Cuando necesite actualizar el contenido del secreto, asegúrese de lo siguiente:
    - Cree una nueva versión del secreto mediante la plantilla de texto sin formato y proporcione el contenido actualizado. Para obtener más información, consulte Actualización del contenido de un secreto.
    - Refresque la conexión para borrar el contenido secreto almacenado en caché.
9. Amplíe Mostrar opciones avanzadas. Puede configurar las siguientes opciones:
  - Seguridad
    - Anule la selección de Usar secretos de almacén que prefiera no utilizar secretos de contraseña para esta conexión. Si no está seleccionado:
      - Seleccione Usar clave de cifrado gestionada por Oracle para dejar toda la gestión de claves de cifrado en Oracle.
      - Seleccione Usar clave de cifrado gestionada por el cliente para seleccionar una clave de cifrado específica almacenada en OCI Vault para cifrar las credenciales de conexión.
  - Conectividad de Red
    - Punto final compartido, para compartir un punto final con el despliegue asignado. Debe permitir la conectividad desde la IP de entrada del despliegue.
    - Punto final dedicado, para el tráfico de red a través de un punto final dedicado en la subred asignada de la VCN. Debe permitir la conectividad desde las IP de entrada de esta conexión.
      Nota:
      
      Si una conexión dedicada permanece sin asignar durante siete días, el servicio la convierte en una conexión compartida.
      
      Obtenga más información sobre la conectividad de Oracle GoldenGate.
  - Configuración: para utilizar la compresión Snappy en la replicación de Kafka, arrastre y suelte o seleccione Propiedades del productor y cambie la configuración de replicación como se describe en Uso de la replicación de Kafka de Compression OCI GoldenGate (Confluent).
  - Atributos de seguridad: agregue atributos de seguridad para controlar el acceso a esta conexión mediante Enrutamiento de paquetes de confianza cero (ZPR).
  - Etiquetas: agregue etiquetas para organizar los recursos.
Seleccione Crear.

Una vez creada la conexión, esta aparecerá en la lista Conexiones. Asegúrese de asignar la conexión a un despliegue para utilizarla como origen o destino en una replicación.

Conexión a OCI Streaming

Antes de empezar

Crear la conexión de origen

Crear la conexión de destino

Pasos siguientes