Conexión al almacenamiento de objetos de Oracle

Descubra cómo crear una conexión a Oracle Object Storage para utilizarla como destino con OCI GoldenGate.

Antes de empezar

Si desea utilizar entidades de recurso para autenticarse y conectarse a un recurso de OCI, asegúrese de lo siguiente:

Crear 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. Por ejemplo:
```
ALL {resource.type = 'goldengatedeployment', resource.compartment.id = 'compartment_ocid'}
```

Agregue las políticas necesarias para el grupo dinámico. Por ejemplo:

allow dynamic-group <dynamic-group-name> to manage object-family in tenancy

Si desea utilizar Vault y Secrets, asegúrese de agregar las políticas para activar el acceso, 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.

Creación de la conexión

Para crear una conexión de Oracle Object Storage:

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 Tipo, seleccione Oracle Object Storage.
6. En Región, seleccione la región de Oracle Object Storage.
7. En Usuario, seleccione una de las siguientes opciones:
  - Usar arrendamiento y usuario actuales y, a continuación, introduzca la siguiente información:
    1. Seleccione el secreto de clave privada. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
    2. (Opcional) Seleccione el secreto de contraseña de clave privada. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
    3. En Huella de clave pública, introduzca la clave de API creada para el usuario.
  - Utilice la entidad de recurso para autenticar y acceder a otros recursos de OCI.
  - Especifique otro arrendamiento y usuario y, a continuación, introduzca la siguiente información:
    1. Introduzca el OCID de arrendamiento.
    2. Introduzca el OCID de Usuario.
    3. Seleccione el secreto de clave privada. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
    4. Seleccione el secreto de frase de contraseña para clave privada. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
    5. En Huella de clave pública, introduzca la clave de API creada para el usuario.
  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é.
8. 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.
  - 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 destino en una replicación.

Pasos siguientes

Incidencias conocidas

Error de replicación de Oracle Object Storage al utilizar la entidad de recurso

Si su conexión a Oracle Object Storage utiliza la autenticación de la entidad de recurso, el Replicat falla con el siguiente error:

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Solución alternativa: para solucionar este problema, edite la conexión y, a continuación, seleccione un método de autenticación diferente.

El OCID del usuario no coincide en la conexión de Oracle Object Storage (solo para usuarios federados)

Si un usuario federado selecciona Usar usuario actual al crear una conexión a Oracle Object Storage, su OCID no coincidirá con el OCID seleccionado por el sistema.

Solución alternativa: al crear una conexión a Oracle Object Storage, asegúrese en Especificar otro usuario y, a continuación, introduzca el OCID del usuario federado.

Para buscar el OCID del usuario, seleccione Perfil en la cabecera global de la consola de Oracle Cloud y, a continuación, seleccione el nombre de usuario. En la página Detalles de usuario, en Información de usuario, seleccione Mostrar en OCID.