Conexión a Apache Iceberg

Descubra cómo crear una conexión a Apache Iceberg en OCI GoldenGate.

Antes de empezar

Antes de crear la conexión, asegúrese de lo siguiente:

Creación de la conexión

Para crear una conexión a Apache Iceberg:
  1. En la página Visión general de OCI GoldenGate, haga clic en Conexiones.
    También puede hacer clic en Crear conexión en la sección Introducción y saltar al paso 3.
  2. En la página Conexiones, haga clic en Crear conexión.
  3. 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 en 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 Tipo, en Big Data, seleccione Apache Iceberg.
    6. Seleccione un tipo de catálogo en la lista desplegable y, a continuación, complete los campos de catálogo relevantes:
      1. En Glue, introduzca el ID de pegamento.
      2. Para Hadoop, no se necesita información adicional.
      3. Para Nessie, especifique:
        • URI: introduzca el URI del catálogo de Nessie.
        • Sucursal: introduzca el nombre de sucursal activo desde el que Nessie lee y escribe los metadatos de la tabla.
      4. Para Polaris, especifique:
        • URI: introduzca el URI del catálogo de Polaris.
        • Nombre: introduzca el nombre en el que Polaris registra las tablas Iceberg.
        • ID de cliente: introduzca el ID de cliente de OAuth que se utilizará para la autenticación.
        • Secreto de cliente: seleccione el secreto de cliente o haga clic en Crear secreto de cliente para crear uno nuevo. Si decide crear un nuevo secreto de cliente, proporcione la siguiente información:
          • Nombre
          • (Opcional) Descripción
          • Seleccione el compartimento en el que reside el secreto de propiedades.
          • Seleccione el almacén en el que desea almacenar el secreto de propiedades.
          • Seleccione la clave de descifrado que desea utilizar.
          • Introduzca la contraseña de usuario y, a continuación, confirme la contraseña de usuario.
        • Rol principal: introduzca el rol de copo de nieve utilizado para acceder a Polaris.
      5. Para Restaurar, especifique:
        • URI: introduzca la URL base para la API de catálogo de REST.
        • Secreto de propiedades: seleccione el secreto de propiedades o haga clic en Crear secreto de propiedades para crear uno nuevo. Si decide crear un nuevo secreto de propiedades, proporcione la siguiente información:
          • Nombre
          • (Opcional) Descripción
          • Seleccione el compartimento en el que reside el secreto de propiedades.
          • Seleccione el almacén en el que desea almacenar el secreto de propiedades.
          • Seleccione la clave de descifrado que desea utilizar.
          • Cargue el ID de secreto de propiedades.
    7. Seleccione un tipo de almacenamiento en la lista desplegable y, a continuación, complete los campos de almacenamiento relevantes:
  4. Amplíe Mostrar opciones avanzadas. Puede configurar las siguientes opciones:
    • Seguridad
      • Anule la selección de Usar secretos de almacén si prefiere 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.

        Note:

        • 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.
    • 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.
  5. Haga clic en Create.
Una vez creada la conexión, esta aparecerá en la lista Conexión. Asegúrese de asignar la conexión a un despliegue para utilizarla en un proceso de replicación de datos.

Incidencias conocidas

Problema con las conexiones de Apache Iceberg en OCI GoldenGate

Si encuentra el siguiente error al utilizar conexiones de Apache Iceberg, abra un ticket de soporte, comparta los detalles y el mensaje de error:

ERROR 2025-07-08 13:34:09.000481 [main] -  Parameter [awsSecretKey] is missing in the
      connection payload. Parameter [awsSecretKey] is missing in the connection payload.