Uso del enlace de nube para el acceso a datos de solo lectura en Autonomous Database

Autonomous Database determina la accesibilidad de los juegos de datos registrados de la siguiente manera:

• El usuario ADMIN especifica un ámbito para un usuario que permite al usuario registrar juegos de datos según el ámbito proporcionado.

• Un usuario al que se le han otorgado privilegios para registrar juegos de datos especifica un ámbito al registrar un juego de datos.

• De manera opcional, al registrar un juego de datos, un usuario al que se le hayan otorgado privilegios de autorización puede especificar que se requiera un paso de autorización para acceder a un juego de datos. Este paso de autorización se suma a la autorización de acceso de nivel de ámbito.

ORA-20001: Share privileges are not enabled for current user or it is enabled but not for scope MY$REGION

El usuario ADMIN puede revocar el registro para impedir que un usuario registre juegos de datos para el acceso remoto. El usuario ADMIN también puede revocar privilegios o usuarios de base de datos para acceder a los juegos de datos registrados.

1. Como usuario ADMIN, revoque los privilegios de un usuario para registrar juegos de datos.

   Por ejemplo:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER('DB_USER1');

   Esto revoca los privilegios para registrar juegos de datos para el usuario, DB_USER1.

   La ejecución de DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER no afecta a los juegos de datos que ya están registrados. Utilice DBMS_CLOUD_LINK.UNREGISTER para eliminar el acceso a un juego de datos registrado.

   Consulte Procedimiento REVOKE_REGISTER y Procedimiento UNREGISTER para obtener más información.

2. Como usuario ADMIN, revoque el acceso a los juegos de datos registrados.

   Por ejemplo:

   EXEC DBMS_CLOUD_LINK_ADMIN.REVOKE_READ('LWARD');

   Esto revoca el acceso a los juegos de datos de enlaces en la nube para el usuario LWARD.

   Consulte REVOKE_READ Procedure para obtener más información.

Puede registrar una tabla o ver su propiedad como un juego de datos registrado. Cuando desee eliminar o sustituir el juego de datos, debe anular el registro. Después de registrar un juego de datos, puede cambiar los valores de los atributos de un juego de datos.

1. Obtenga privilegios de registro de otorgamiento del usuario ADMIN.

   Consulte Otorgamiento de acceso de enlaces a la nube para usuarios de base de datos para obtener más información.

2. Registre uno o más juegos de datos.

   Por ejemplo, suponiendo que haya un esquema CLOUDLINK en la instancia de Autonomous Database, puede registrar dos objetos, SALES_VIEW_AGG y SALES_ALL, y proporcionar diferentes parámetros scope para determinar cómo se accede a los objetos.

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Los parámetros son:

   • schema_name: es el nombre del esquema (el propietario del objeto).

   • schema_object: es el nombre del objeto. Los objetos válidos son:

     • Tablas (incluidas pilas, externas o híbridas)
     • Vistas
     • Vistas Materializadas
     • Tablas en la nube (consulte Uso de tablas en la nube para almacenar información de registro y diagnóstico para obtener más información).
     Nota
     
     Otros objetos, como vistas analíticas o sinónimos, no están soportados.

   • namespace: es el espacio de nombres que proporciona como nombre para el acceso con enlaces en la nube (una parte del FQN de enlace en la nube).

     Un valor NULL especifica un valor namespace generado por el sistema, único para la instancia de Autonomous Database.

   • name: es el nombre que proporciona para el acceso a los enlaces en la nube (una parte del FQN de enlace en la nube).

   • description: especifica el texto para describir los datos.

   • scope: especifica el ámbito. Puede utilizar una de las variables: MY$REGION, MY$TENANCY o MY$COMPARTMENT, o bien especificar uno o más OCID.

     Consulte Ámbito de juego de datos, control de acceso y autorización para obtener más información.

   • auth_required: valor booleano que especifica si la autorización de nivel de base de datos es necesaria para el juego de datos, además del control de acceso de ámbito. Cuando se define en TRUE, el juego de datos aplica un paso de autorización adicional. Consulte Registro de un juego de datos con autorización necesaria para obtener más información.

   • data_set_owner: el valor de texto especifica información sobre la persona responsable del juego de datos o un contacto para preguntas sobre el juego de datos. Por ejemplo, puede proporcionar una dirección de correo electrónico para el propietario del juego de datos.

   Consulte Procedimiento REGISTER para obtener más información.

   Para este ejemplo, una vez que el registro finaliza, el ámbito de los dos objetos registrados es diferente, según el parámetro de ámbito proporcionado con DBMS_CLOUD_LINK.REGISTER:

   • MY$TENANCY: especifica el ámbito de nivel de arrendamiento para REGIONAL_SALES.SALES_AGG.

   • MY$COMPARTMENT: especifica el ámbito de nivel de compartimento más restrictivo en el arrendamiento para TRUSTED_COMPARTMENT.SALES.

BEGIN
   DBMS_CLOUD_LINK.UNREGISTER(
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

• Notas para registrar o anular el registro de un juego de datos
  Proporciona notas para registrar un juego de datos con DBMS_CLOUD_LINK.REGISTER y anular el registro de un juego de datos con DBMS_CLOUD_LINK.UNREGISTER.

Puede utilizar enlaces en la nube en varias regiones, donde la región de origen contiene la base de datos de origen del juego de datos y una o más regiones remotas contienen clonaciones de refrescamiento de la base de datos de origen.

Descripción de la ilustración cloud-links-cross-region-refreshable-clone.png

Para utilizar enlaces en la nube con un juego de datos en una región diferente:

1. Cree una clonación de refrescamiento entre regiones de la base de datos origen en una región remota.

   Consulte Creación de una clonación de refrescamiento entre arrendamientos o entre regiones para obtener información sobre la adición de una clonación de refrescamiento entre regiones.

2. En la base de datos origen, registre el juego de datos.

   Consulte Registro o Anulación del Registro de un Juego de Datos para obtener más información.

3. Refresque la clonación de refrescamiento.

   Consulte Refrescamiento de una clonación de refrescamiento en Autonomous Database para obtener más información.

4. En la clonación de refrescamiento remota, registre el juego de datos con los mismos argumentos que utilizó para registrar el juego de datos en la región de origen.

   Por ejemplo, suponiendo que haya un esquema CLOUDLINK en la instancia de Autonomous Database, después de registrar SALES_ALL en la base de datos de origen, registre SALES_ALL en la clonación de refrescamiento:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_ALL',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES',
       description    => 'Trusted Compartment, only accessible within my compartment. Early sales data.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  FALSE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Los parámetros son:

   • schema_name: es el nombre del esquema (el propietario del objeto).

   • schema_object: es el nombre del objeto. Los objetos válidos son:

     • Tablas (incluidas pilas, externas o híbridas)
     • Vistas
     • Vistas Materializadas
     Nota
     
     Otros objetos, como vistas analíticas o sinónimos, no están soportados.

   • namespace: es el espacio de nombres que proporciona como nombre para el acceso con enlaces en la nube (una parte del FQN de enlace en la nube).

     Un valor NULL especifica un valor namespace generado por el sistema, único para la instancia de Autonomous Database.

   • name: es el nombre que proporciona para el acceso a los enlaces en la nube (una parte del FQN de enlace en la nube).

   • description: especifica el texto para describir los datos.

   • scope: especifica el ámbito. Puede utilizar una de las variables: MY$REGION, MY$TENANCY o MY$COMPARTMENT, o bien especificar uno o más OCID.

     Consulte Ámbito de juego de datos, control de acceso y autorización para obtener más información.

   • auth_required: valor booleano que especifica si la autorización de nivel de base de datos es necesaria para el juego de datos, además del control de acceso de ámbito. Cuando se define en TRUE, el juego de datos aplica un paso de autorización adicional. Consulte Registro de un juego de datos con autorización necesaria para obtener más información.

   • data_set_owner: el valor de texto especifica información sobre la persona responsable del juego de datos o un contacto para preguntas sobre el juego de datos. Por ejemplo, puede proporcionar una dirección de correo electrónico para el propietario del juego de datos.

   Consulte Procedimiento REGISTER para obtener más información.

   Una vez finalizado el registro en la clonación de refrescamiento, el ámbito del objeto registrado es MY$COMPARTMENT: especifica el ámbito de nivel de compartimento más restrictivo para mi compartimento dentro de mi arrendamiento para TRUSTED_COMPARTMENT.SALES.

• Notas para Registrar o Anular el Registro de un Juego de Datos en una Región Remota
  Proporciona notas para registrar un juego de datos en una región remota.

Opcionalmente, al registrar un juego de datos, además del ámbito, puede especificar que la autorización de nivel de base de datos es necesaria para acceder a un juego de datos.

1. Utilice DBMS_CLOUD_LINK.REGISTER para registrar los datos con la autorización necesaria.

   Suponiendo que haya un esquema CLOUDLINK en la instancia de Autonomous Database y registre el objeto SALES_VIEW_AGG y defina auth_required en TRUE, además de definir el ámbito, debe realizar pasos adicionales para determinar cómo se accede al objeto.

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name    => 'CLOUDLINK',
       schema_object  => 'SALES_VIEW_AGG',
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Aggregated regional sales information.',
       scope          => 'MY$TENANCY',
       auth_required  =>  TRUE,
       data_set_owner =>  'amit@example.com' );
   END;
   /

   Los parámetros son:

   • schema_name: es el nombre del esquema (el propietario del objeto).

   • schema_object: es el nombre del objeto. Los objetos válidos son:

     • Tablas (incluidas pilas, externas o híbridas)
     • Vistas
     • Vistas Materializadas
     Nota
     
     Otros objetos, como vistas analíticas o sinónimos, no están soportados.

   • namespace: es el espacio de nombres que proporciona como nombre para el acceso con enlaces en la nube (una parte del FQN de enlace en la nube).

     Un valor NULL especifica un valor namespace generado por el sistema, único para la instancia de Autonomous Database.

   • name: es el nombre que proporciona para el acceso a los enlaces en la nube (una parte del FQN de enlace en la nube).

   • scope: especifica el ámbito. Puede utilizar una de las variables: MY$REGION, MY$TENANCY o MY$COMPARTMENT, o bien especificar uno o más OCID.

     Consulte Ámbito de juego de datos, control de acceso y autorización para obtener más información.

   • auth_required: valor booleano que especifica si la autorización de nivel de base de datos es necesaria para el juego de datos, además del control de acceso de ámbito. Cuando se define en TRUE, el juego de datos aplica un paso de autorización adicional.

   • data_set_owner: el valor de texto especifica información sobre la persona responsable del juego de datos o un contacto para preguntas sobre el juego de datos. Por ejemplo, puede proporcionar una dirección de correo electrónico para el propietario del juego de datos.

2. Obtenga el ID de la base de datos a la que desea otorgar autorización (para permitir que la base de datos acceda al juego de datos).

   En el sistema al que desea otorgar acceso al juego de datos:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Utilice el ID de base de datos que ha obtenido para otorgar autorización a un juego de datos especificado.

   Solo puede otorgar autorización y ejecutar DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, como se muestra en este paso, si está autorizado. El administrador otorga la autorización con DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE.

   BEGIN
      DBMS_CLOUD_LINK.GRANT_AUTHORIZATION(
       database_id    => '120xxxxxxx8506029999',
       namespace      => 'TRUSTED_COMPARTMENT', 
       name           => 'SALES');
   END;
   /

   Realice estos pasos varias veces si desea autorizar bases de datos adicionales.

BEGIN
   DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION(
    database_id    => '120xxxxxxx8506029999',
    namespace      => 'TRUSTED_COMPARTMENT', 
    name           => 'SALES');
END;
/

Si lo desea, al registrar un juego de datos, puede descargar el acceso al juego de datos en una o más instancias de Autonomous Database que son clonaciones de refrescamiento.

Utilice el parámetro opcional offload_targets con DBMS_CLOUD_LINK.REGISTER para especificar que el acceso se descarga en las clonaciones de refrescamiento. La base de datos origen para cada clonación de refrescamiento es la instancia de Autonomous Database en la que se registra el juego de datos (editor de datos).

El valor offload_targets es un documento JSON que define uno o más pares de valores de clave CLOUD_LINK_DATABASE_ID y OFFLOAD_TARGET:

• CLOUD_LINK_DATABASE_ID es uno de los siguientes:

  • Un ID de base de datos: especifica un ID de base de datos para el consumidor del juego de datos cuya solicitud se descarga en la clonación de refrescamiento correspondiente especificada con el valor OFFLOAD_TARGET.

    Obtenga el identificador de base de datos ejecutando DBMS_CLOUD_LINK.GET_DATABASE_ID. Consulte GET_DATABASE_ID Function para obtener más información.

  • ANY: especifica que cualquier solicitud del consumidor del juego de datos se descarga en el destino de descarga correspondiente. La solicitud de juego de datos de un consumidor se enrutará al destino de descarga correspondiente.

    Si especifica ANY sin especificar los ID de base de datos, todas las solicitudes de juegos de datos de los consumidores se descargan en la clonación de refrescamiento especificada con el valor OFFLOAD_TARGET.

    Si especifica tanto los ID de base de datos como ANY, las solicitudes de juegos de datos de los consumidores que no coinciden con un ID de base de datos se descargan en la clonación de refrescamiento especificada con el valor OFFLOAD_TARGET.

• OFFLOAD_TARGET es el OCID de una instancia de Autonomous Database que es una clonación de refrescamiento.

En la siguiente figura, se ilustra el uso de destinos de descarga.

Descripción de la ilustración cloud-links-offload-targets-any-keyword.eps

Cuando un consumidor de juego de datos solicita acceso a un juego de datos que se registra con offload_targets y el identificador de base de datos de la instancia de Autonomous Database coincide con el valor especificado en CLOUD_LINK_DATABASE_ID, el acceso se descarga a la clonación de refrescamiento identificada con OFFLOAD_TARGET en el JSON proporcionado.

Por ejemplo, a continuación se muestra un ejemplo de JSON con tres pares de valores OFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID:

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx69708978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfabc"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx89898978",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

Cuando un consumidor de juego de datos solicita acceso a un juego de datos que se registra con offload_targets que incluye la palabra clave ANY, el acceso se descarga en la clonación de refrescamiento identificada con OFFLOAD_TARGET en el JSON proporcionado (excepto las solicitudes de los consumidores que tienen una entrada de ID de base de datos coincidente en el JSON proporcionado).

Por ejemplo, a continuación se muestra un ejemplo de JSON con un par de valores OFFLOAD_TARGET/CLOUD_LINK_DATABASE_ID explícito y un valor ANY con un valor OFFLOAD_TARGET correspondiente:

{
  "OFFLOAD_TARGETS": [
    {
      "CLOUD_LINK_DATABASE_ID": "ANY",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfdef"
    },
    {
      "CLOUD_LINK_DATABASE_ID": "34xxxxx4755680",
      "OFFLOAD_TARGET":
"ocid1.autonomousdatabase.oc1..xxxxx3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
    }
  ]
}

Para registrar un juego de datos y especificar destinos de descarga, haga lo siguiente:

1. Obtenga el OCID para una o más clonaciones de refrescamiento en las que desee descargar el acceso al juego de datos. Los OCID de clonación de refrescamiento están disponibles en la consola de Oracle Cloud Infrastructure en una clonación de refrescamiento.
   Nota
   
   Puede tardar hasta 10 minutos en crear una clonación de refrescamiento para que la clonación de refrescamiento esté visible como destino de descarga. Esto significa que puede que tenga que esperar hasta 10 minutos después de crear una clonación de refrescamiento para que la clonación de refrescamiento esté disponible para el registro de descarga de enlaces en la nube.
2. Obtenga el ID de base de datos de una o más instancias de Autonomous Database a las que desea acceder al juego de datos mediante los datos proporcionados por la clonación de refrescamiento.

   En el sistema al que desea acceder al juego de datos desde una clonación de refrescamiento, ejecute el comando:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

3. Registre un juego de datos y especifique el parámetro offload_targets.

   Por ejemplo, suponiendo que haya un esquema CLOUDLINK en la instancia de Autonomous Database, puede registrar SALES_VIEW_AGG y especificar las clonaciones de refrescamiento que proporcionan acceso al juego de datos:

   BEGIN
      DBMS_CLOUD_LINK.REGISTER(
       schema_name     => 'CLOUDLINK',
       schema_object   => 'SALES_VIEW_AGG',
       namespace       => 'REGIONAL_SALES', 
       name            => 'SALES_AGG',
       description     => 'Aggregated regional sales information.',
       scope           => 'MY$TENANCY',
       auth_required   =>  FALSE,
       data_set_owner  =>  'amit@example.com',
       offload_targets => '{
     "OFFLOAD_TARGETS": [
       {
         "CLOUD_LINK_DATABASE_ID": "34xxxx754755680",
         "OFFLOAD_TARGET":
   "ocid1.autonomousdatabase.oc1..xxxxxaaba3pv6wkcr4jqae5f44n2b2m2yt2j6rx32uzr4h25vqstifsfghi"
       }
     ]
   }');
   END;
   /

   Los parámetros son:

   • schema_name: es el nombre del esquema (el propietario del objeto).

   • schema_object: es el nombre del objeto. Los objetos válidos son:

     • Tablas (incluidas pilas, externas o híbridas)
     • Vistas
     • Vistas Materializadas
     Nota
     
     Otros objetos, como vistas analíticas o sinónimos, no están soportados.

   • namespace: es el espacio de nombres que proporciona como nombre para el acceso con enlaces en la nube (una parte del FQN de enlace en la nube).

     Un valor NULL especifica un valor namespace generado por el sistema, único para la instancia de Autonomous Database.

   • name: es el nombre que proporciona para el acceso a los enlaces en la nube (una parte del FQN de enlace en la nube).

   • scope: especifica el ámbito. Puede utilizar una de las variables: MY$REGION, MY$TENANCY o MY$COMPARTMENT, o bien especificar uno o más OCID.

     Consulte Ámbito de juego de datos, control de acceso y autorización para obtener más información.

   • auth_required: valor booleano que especifica si la autorización de nivel de base de datos es necesaria para el juego de datos, además del control de acceso de ámbito. Cuando se define en TRUE, el juego de datos aplica un paso de autorización adicional. Consulte Registro de un juego de datos con autorización necesaria para obtener más información.

   • data_set_owner: el valor de texto especifica información sobre la persona responsable del juego de datos o un contacto para preguntas sobre el juego de datos. Por ejemplo, puede proporcionar una dirección de correo electrónico para el propietario del juego de datos.

   • offload_targets: especifica uno o más OCID de Autonomous Database de clonaciones de refrescamiento en las que se descarga el acceso a los juegos de datos desde la instancia de Autonomous Database en la que está registrado el juego de datos.

     Para cada consumidor de juego de datos, una de las siguientes opciones puede coincidir para descargar la solicitud en una clonación de refrescamiento:

     • Cuando hay coincidencia con el valor de cloud_link_database_id especificado, es decir, los valores coinciden con el identificador de base de datos del consumidor, el acceso se descarga en la clonación de refrescamiento identificada por el OCID especificado en offload_target.

     • Cuando se especifica la palabra clave ANY, si no hay ninguna coincidencia con el valor de un cloud_link_database_id especificado, el acceso se descarga en la clonación de refrescamiento identificada con la entrada ANY por el OCID especificado en el offload_target correspondiente.

   Nota
   
   Si el editor de datos es un líder de pool elástico o un miembro de pool elástico, como alternativa a la configuración de los detalles de destino de descarga con offload_targets, puede utilizar la función de descarga de consulta unificada. En este caso, el editor permite la descarga de consultas ProxySQL para descargar consultas (lecturas) en cualquier número de clonaciones de refrescamiento sin necesidad de configurar los destinos. Consulte Uso de descarga de consultas unificadas con enlaces en la nube para obtener más información.

   Puede obtener más información en los siguientes enlaces:

   • Procedimiento REGISTER

   • UPDATE_REGISTRATION Procedimiento

   • Uso del refrescamiento de clonaciones con Autonomous Database

   • Uso de descarga de consultas unificadas con enlaces en la nube

Después de registrar un juego de datos, puede actualizar algunos atributos de juego de datos. No puede actualizar el nombre de esquema, el objeto de esquema, el espacio de nombres ni los atributos de nombre.

1. El usuario que ha registrado un juego de datos puede actualizar sus atributos con DBMS_CLOUD_LINK.UPDATE_REGISTRATION.

   Si no tiene privilegios para actualizar los atributos del juego de datos, debe obtener privilegios de registro de otorgamiento del usuario ADMIN.

   Consulte Otorgamiento de acceso de enlaces a la nube para usuarios de base de datos para obtener más información.

2. Actualice uno o más atributos para un juego de datos.

   Por ejemplo, utilice DBMS_CLOUD_LINK.UPDATE_REGISTRATION para actualizar los atributos description, scope y auth_required para el juego de datos en el espacio de nombres REGIONAL_SALES con el nombre SALES_AGG:

   BEGIN
      DBMS_CLOUD_LINK.UPDATE_REGISTRATION(
       namespace      => 'REGIONAL_SALES', 
       name           => 'SALES_AGG',
       description    => 'Updated description for aggregated regional sales information.',
       scope          => 'MY$COMPARTMENT',
       auth_required  =>  TRUE );
   END;
   /

   Los parámetros requeridos son:

   • namespace: es el espacio de nombres del juego de datos que ha proporcionado al registrar el juego de datos.

   • name: es el nombre del juego de datos que ha proporcionado al registrar el juego de datos.

   A continuación se muestra una lista de los parámetros opcionales. Si se transfiere NULL para un valor de parámetro opcional, el atributo no se modifica.

   • description: especifica el texto actualizado para describir los datos.

   • scope: especifica el ámbito. Puede utilizar una de las variables: MY$REGION, MY$TENANCY o MY$COMPARTMENT, o bien especificar uno o más OCID.

     Consulte Ámbito de juego de datos, control de acceso y autorización para obtener más información.

   • auth_required: valor booleano que especifica si la autorización de nivel de base de datos es necesaria para el juego de datos, además del control de acceso de ámbito. Cuando se define en TRUE, el juego de datos aplica un paso de autorización adicional. Consulte Registro de un juego de datos con autorización necesaria para obtener más información.

   • data_set_owner: el valor de texto especifica información sobre la persona responsable del juego de datos o un contacto para preguntas sobre el juego de datos. Por ejemplo, puede proporcionar una dirección de correo electrónico para el propietario del juego de datos.

   • offload_targets: especifica uno o más OCID de Autonomous Database de clonaciones de refrescamiento en las que se descarga el acceso a los juegos de datos desde la instancia de Autonomous Database en la que está registrado el juego de datos. Consulte Registro de un Juego de Datos con Destinos de Descarga para el Acceso al Juego de Datos para obtener más información.

   No puede actualizar los atributos schema_name o schema_object.

   Consulte UPDATE_REGISTRATION Procedure para obtener más información.

Puede definir la asignación de nombre de servicio que se utilizará cuando los consumidores de enlaces en la nube accedan a los datos de un propietario de juego de datos.

Los enlaces en la nube se basan en recursos de base de datos en la instancia de Autonomous Database que es el productor de juegos de datos, o los recursos de una clonación de refrescamiento, para acceder a los datos compartidos. Por defecto, la conectividad remota para que los consumidores accedan a los datos de enlaces en la nube utiliza el servicio de base de datos MEDIUM.

Utilice DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING para definir la asignación de servicio de base de datos para un consumidor. En este procedimiento, debe proporcionar un ID de base de datos o la palabra clave ANY para especificar la asignación de servicio al consumidor. Por ejemplo, en la siguiente figura se muestra una asignación para el consumidor A al servicio HIGH, el consumidor B al servicio MEDIUM, el consumidor C al servicio LOW y una asignación para ANY al servicio TP, lo que significa que todos los demás consumidores acceden a los enlaces de nube mediante el servicio TP.

Descripción de la ilustración autonomous-cloud-links-service-mapping.png

Consulte Nombres de servicio de base de datos para Autonomous Database para obtener más información sobre las características de los servicios de base de datos.

Realice los siguientes pasos para definir el servicio de base de datos que se utilizará para un consumidor de enlaces en la nube:

1. Obtenga el ID de la base de datos para la que desea definir una asignación de servicio.

   En la base de datos del consumidor, ejecute GET_DATABASE_ID para obtener el ID de base de datos del consumidor. Por ejemplo:

   SELECT DBMS_CLOUD_LINK.GET_DATABASE_ID FROM DUAL:

   Consulte GET_DATABASE_ID Function para obtener más información.

2. En la instancia de Autonomous Database del propietario del juego de datos, especifique una asignación de servicio.

   Realice este paso en la instancia de Autonomous Database del propietario del juego de datos (es decir, en la base de datos del productor).

   BEGIN
      DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
       database_id      => 'database_id', 
       service_name     => 'HIGH');
   END;
   /

   Donde el valor del parámetro database_id es el ID de base de datos que ha obtenido en el paso 1.

   Especifique el valor ANY para que database_id utilice el service_name especificado con todas las bases de datos de consumidores que no tengan un service_name asociado a su database_id. Es decir, cualquier database_id cuyo service_name no se haya definido con DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

   Consulte ADD_SERVICE_MAPPING Procedure para obtener más información.

   Solo el usuario ADMIN y los esquemas con el rol PDB_DBA pueden ejecutar DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

3. Verifique los ID de base de datos y la asignación de servicios enumerando las asignaciones de servicio de enlaces en la nube.

   Por ejemplo:

   SELECT * FROM  DBA_CLOUD_LINK_SERVICE_MAPPINGS;

   Consulte DBA_CLOUD_LINK_SERVICE_MAPPINGS View para obtener más información.

• Definición de asignación de nombre de servicio de base de datos para consumidores de enlaces en la nube en regiones remotas
  Se puede acceder a un juego de datos registrado en una región de origen con enlaces en la nube desde una región remota al crear clonación de refrescamiento entre regiones en la región remota.

Puede activar el almacenamiento en caché en un consumidor de juegos de datos para los resultados de una consulta o para un fragmento de consulta que acceda a los datos de Cloud Link.

1. En una consulta, especifique la indicación RESULT_CACHE con la opción SHELFLIFE.

   Por ejemplo:

   SELECT /*+ RESULT_CACHE (SHELFLIFE=120) */ * FROM FOREST.TREE_DATA@cloud$link;

   Este valor RESULT_CACHE especifica un valor SHELFLIFE de 120. Esto indica que el resultado se debe almacenar en caché en la memoria durante 120 segundos. Después de 120 segundos, el resultado almacenado en caché se marca como no válido.

   El Valor SHELFLIFE debe ser un entero positivo. El valor máximo de SHELFLIFE es 4294967295.

2. Si el resultado de la consulta es grande y no cabe en la memoria, utilice las opciones SHELFLIFE y TEMP para indicar que el resultado se debe escribir en el disco del tablespace temporal.

   SELECT /*+ RESULT_CACHE (TEMP=true SHELFLIFE=360) */ * FROM FOREST.TREE_DATA@cloud$link;

Puede compartir enlaces en la nube cuando un juego de datos reside en una instancia de Autonomous Database de solo lectura.

1. Cambiar el modo de base de datos al modo de lectura/escritura.
   Consulte Change Autonomous Database Operation Mode to Read/Write Read-Only or Restricted para obtener más información.
2. Con la base de datos en modo de lectura/escritura, realice los pasos necesarios para registrar un juego de datos.
   1. Otorgar acceso a enlaces de nube para usuarios de base de datos
   2. Registro o anulación del registro de un juego de datos
3. Después de registrar uno o más juegos de datos, cambie la base de datos al modo de solo lectura.
   Consulte Change Autonomous Database Operation Mode to Read/Write Read-Only or Restricted para obtener más información.