Paquete DBMS_CLOUD

El paquete DBMS_CLOUD_LINK permite a un usuario registrar una tabla o una vista como un juego de datos para el acceso de solo lectura con enlaces en la nube.

Visión general de DBMS_CLOUD_LINK

Describe el uso del paquete DBMS_CLOUD_LINK.

El paquete DBMS_CLOUD_LINK proporciona el procedimiento REGISTER que permite registrar una tabla o una vista como un juego de datos para su uso con enlaces en la nube. Para poder registrar un juego de datos, el usuario ADMIN debe otorgar un permiso de usuario para registrar un juego de datos mediante el procedimiento DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Después de que ADMIN ejecute GRANT_REGISTER, un usuario puede registrar una tabla o una vista de la que es propietario como juego de datos registrado (o registrar un objeto en otro esquema si el usuario tiene el privilegio READ WITH GRANT OPTION en el objeto). Los juegos de datos registrados proporcionan acceso remoto al objeto registrado con enlaces en la nube, según el ámbito especificado con el procedimiento REGISTER.

Para ejecutar DBMS_CLOUD_LINK.REGISTER, DBMS_CLOUD_LINK.UPDATE_REGISTRATION o DBMS_CLOUD_LINK.UNREGISTER, debe tener el privilegio de ejecución en el paquete DBMS_CLOUD_LINK, además de haber ejecutado previamente DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Por defecto, solo el usuario ADMIN y los esquemas con el rol PDB_DBA tienen privilegios de ejecución en DBMS_CLOUD_LINK.

Resumen de Subprogramas DBMS_CLOUD_LINK

Muestra una tabla con un resumen de los subprogramas incluidos en el paquete DBMS_CLOUD_LINK.

Subprograma Descripción

Función DESCRIBE

Esta función recupera la descripción de un juego. La descripción se proporciona cuando un juego de datos se registra con DBMS_CLOUD_LINK.REGISTER.

FIND Procedimiento

Recupera el espacio de nombres, el nombre y la descripción de los juegos de datos que coinciden con la cadena de búsqueda. Los juegos de datos coincidentes solo se muestran si el usuario puede acceder a ellos en función de las restricciones de acceso.

Función GET_DATABASE_ID

Devuelve un identificador único para la instancia de Autonomous Database. Las llamadas repetidas a DBMS_CLOUD_LINK.GET_DATABASE_ID en la misma instancia siempre devuelven el mismo valor.

GRANT_AUTHORIZATION Procedimiento

Otorga autorización a una base de datos especificada para acceder al juego de datos especificado.

Procedimiento REGISTER

Registra una tabla o vista como juego de datos.

REVOKE_AUTHORIZATION Procedimiento

Revoca la autorización para que una base de datos especificada acceda al juego de datos especificado.

Procedimiento UNREGISTER

Elimina un juego de datos registrado.

UPDATE_REGISTRATION Procedimiento

Actualiza los atributos de un juego de datos que se ha registrado mediante DBMS_CLOUD_LINK.REGISTER.

Función DESCRIBE

Esta función recupera la descripción de un juego. La descripción se proporciona cuando un juego de datos se registra con DBMS_CLOUD_LINK.REGISTER.

Sintaxis

DBMS_CLOUD_LINK.DESCRIBE(
      namespace        IN   VARCHAR2,
      name             IN   VARCHAR2
) return CLOB;

Parámetros

Parámetro Descripción

namespace

Especifica el espacio de nombres del juego de datos registrado.

name

Especifica el nombre de un juego de datos registrado.

Nota de uso

Puede utilizar esta función sujeta a las restricciones de acceso impuestas en el momento del registro con DBMS_CLOUD_LINK.REGISTER. Si una base de datos no puede acceder a un juego de datos, no se recuperará su descripción.

FIND Procedimiento

Este procedimiento recupera el espacio de nombres, el nombre y la descripción de los juegos de datos que coinciden con la cadena de búsqueda. Los juegos de datos coincidentes solo se muestran si el usuario puede acceder a ellos en función de las restricciones de acceso.

Sintaxis

DBMS_CLOUD_LINK.FIND(
      search_string        IN   VARCHAR2,
      search_result        OUT   CLOB
);

Parámetros

Parámetro Descripción

search_string

Especifica la cadena de búsqueda. La cadena de búsqueda no distingue entre mayúsculas y minúsculas.

search_result

Documento JSON que incluye los valores de espacio de nombres, nombre y descripción para el juego de datos.

Nota de uso

La cadena de búsqueda no distingue entre mayúsculas y minúsculas y el paquete utiliza la búsqueda de texto libre mediante Oracle Text.

Función GET_DATABASE_ID

La función devuelve un identificador único para la instancia de Autonomous Database. Las llamadas repetidas a DBMS_CLOUD_LINK.GET_DATABASE_ID en la misma instancia siempre devuelven el mismo valor.

Puede llamar a esta función en una base de datos que accede a un juego de datos registrado de forma remota para obtener el ID de base de datos. Esto le permite proporcionar la base de datos iD para que el propietario de un juego de datos pueda aprovechar un control de acceso de datos más detallado, por ejemplo con VPD, basado en un ID de base de datos especificado de sitios remotos.

Un ID de base de datos identifica cada base de datos remota que accede a un juego de datos registrado, para realizar un seguimiento y auditar el acceso en las V$CLOUD_LINK_ACCESS_STATS y GV$CLOUD_LINK_ACCESS_STATS Views de la base de datos que posee un juego de datos registrado.

Sintaxis

DBMS_CLOUD_LINK.GET_DATABASE_ID()
  RETURN VARCHAR2;

Notas de uso

Los enlaces en la nube utilizan el identificador único que devuelve DBMS_CLOUD_LINK.GET_DATABASE_ID para identificar bases de datos individuales que acceden a un juego de datos de forma remota. La base de datos propietaria del juego de datos registrado realiza un seguimiento y audita el ID de base de datos como un registro del origen para el acceso al juego de datos en las V$CLOUD_LINK_ACCESS_STATS y GV$CLOUD_LINK_ACCESS_STATS Views.

El identificador DBMS_CLOUD_LINK.GET_DATABASE_ID está disponible como valor SYS_CONTEXT para que pueda obtener mediante programación esta información sobre una sesión remota de conexión mediante SYS_CONTEXT, con el fin de restringir y controlar aún más a qué datos específicos pueden acceder de forma remota las instancias individuales de Autonomous Database con bases de datos privadas virtuales (VPD).

Valores de Retorno

Identificador único de la instancia de Autonomous Database de VARCHAR2.

GRANT_AUTHORIZATION Procedimiento

Este procedimiento otorga autorización a una base de datos especificada para acceder al juego de datos especificado.

Sintaxis

DBMS_CLOUD_LINK.GRANT_AUTHORIZATION(
      database_id        IN   VARCHAR2,
      namespace          IN   VARCHAR2 DEFAULT,
      name               IN   VARCHAR2
);

Parámetros

Parámetro Descripción

database_id

Especifica el ID de base de datos para una instancia de Autonomous Database. Utilice DBMS_CLOUD_LINK.GET_DATABASE_ID para obtener el identificador de base de datos.

namespace

Especifica el espacio de nombres de juego de datos para otorgar autorización de acceso para el database_id especificado.

name

Especifica el nombre del juego de datos para otorgar autorización de acceso para el database_id especificado.

Procedimiento REGISTER

El procedimiento registra una tabla o una vista como un juego de datos para permitir el acceso remoto de solo lectura, sujeto a las restricciones impuestas por el parámetro scope.

Sintaxis

DBMS_CLOUD_LINK.REGISTER(
     schema_name      IN VARCHAR2,
     schema_object    IN VARCHAR2,
     namespace        IN VARCHAR2,
     name             IN VARCHAR2,
     description      IN CLOB,
     scope            IN CLOB,
     auth_required    IN BOOLEAN DEFAULT,
     data_set_owner   IN VARCHAR2 DEFAULT,
     offload_targets  IN CLOB DEFAULT

);

Parámetros

Parámetro Descripción

schema_name

Especifica el propietario de la tabla o vista especificada con el parámetro schema_object.

schema_object

Especifica el nombre de una tabla o vista. Los objetos válidos son:

  • Tablas (incluidas pilas, externas o híbridas)
  • Vistas
  • Vistas Materializadas
  • Tablas en la nube

No se admiten otros objetos, como vistas analíticas o sinónimos.

namespace

Especifica el espacio de nombres para el juego de datos.

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

name

Especifica el nombre para el conjunto de datos.

description

Especifica el texto para describir los datos.

scope

Describe quién tiene permiso para acceder al juego de datos. El valor es una lista separada por comas que consta de una o más de las siguientes opciones:

  • OCID de la base de datos: se permite el acceso al juego de datos para las instancias específicas de Autonomous Database identificadas por el OCID.

  • OCID del compartimento: se permite el acceso al juego de datos para las bases de datos en los compartimentos identificados por el OCID del compartimento.

  • OCID del arrendamiento: se permite el acceso al juego de datos para las bases de datos en los arrendamientos identificados por el OCID del arrendamiento.

  • Nombre de región: se permite el acceso al juego de datos para las bases de datos de la región identificada por la región con nombre. Por ámbito, el acceso a enlaces en la nube está limitado a una sola región y no es entre regiones. Un consumidor de una región diferente solo puede acceder a un juego de datos cuando existe una clonación de refrescamiento entre regiones de la base de datos que es el propietario del juego de datos en la región de la base de datos de consumidor.

    Consulte Registro o anulación del registro de un juego de datos en una región diferente para obtener más información.

  • MY$COMPARTMENT: se permite el acceso al juegos de datos para las bases de datos del mismo compartimento que el del propietario de juego.

  • MY$TENANCY: se permite el acceso al juegos de datos para las bases de datos del mismo arrendamiento que el del propietario de juego.

  • MY$REGION: se permite el acceso al juegos de datos para las bases de datos de la misma región que el del propietario de juego.

  • Lista de regiones: se permite el acceso al juego de datos para las bases de datos de las regiones especificadas

    Por ejemplo:

    scope   =>  'us-phoenix-1,us-ashburn-1',

    Un consumidor de una región diferente solo puede acceder a un juego de datos cuando existe una clonación de refrescamiento entre regiones de la base de datos que es el propietario del juego de datos en la región de la base de datos de consumidor.

Los valores de ámbito, MY$REGION, MY$TENANCY y MY$COMPARTMENT son variables que actúan como macros de conveniencia y se resuelven en OCID.

auth_required

Especifica que se necesita una autorización adicional para que las bases de datos lean desde el juego de datos. Los casos posibles son los siguientes:

  • Las bases de datos que se encuentran dentro del SCOPE especificado y se han autorizado con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION pueden ver filas del juego de datos.

  • Las bases de datos que estén dentro del SCOPE especificado pero no se hayan autorizado con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION no pueden ver las filas del juego de datos. En este caso, los consumidores sin autorización ven el juego de datos como vacío.

  • Las bases de datos que no están dentro del SCOPE especificado muestran un error al intentar acceder al juego de datos.

data_set_owner

Especifica el propietario del juego de datos. Indica a quién pertenece el conjunto de datos o quién es el responsable de actualizar y mantener el conjunto de datos. Por ejemplo, puede definir data_set_owner en la dirección de correo electrónico de la persona que registró el 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 se registra el juego 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.

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 con la palabra clave ANY, cualquier solicitud de acceso se descarga en la clonación de refrescamiento identificada con OFFLOAD_TARGET en el JSON proporcionado (excepto las solicitudes que tienen una entrada explícita 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 una entrada ANY:

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

DBMS_CLOUD_LINK.REGISTER informa de un error si el OCID proporcionado como valor OFFLOAD_TARGET no es un OCID de una clonación de refrescamiento en la misma región.

Consulte Uso de clonaciones de refrescamiento con Autonomous Database para obtener información sobre el uso de clonaciones de refrescamiento.

Notas de uso

  • Después de registrar un objeto, puede que los usuarios tengan que esperar hasta diez (10) minutos para acceder al objeto con enlaces en la nube.

  • Utilice el procedimiento DBMS_CLOUD_LINK.UPDATE_REGISTRATION para cambiar los atributos de un juego de datos existente.

    El tiempo de espera para que se complete la actualización puede ser de hasta 10 minutos para que un cambio de registro se propague y se pueda acceder a él a través de enlaces en la nube. Este retraso puede afectar a la precisión de los datos en las vistas DBA_CLOUD_LINK_REGISTRATIONS y DBA_CLOUD_LINK_ACCESS.

  • Puede registrar una tabla o vista que resida en el esquema de otro usuario cuando tenga privilegios READ WITH GRANT OPTION para la tabla o vista.

  • El ámbito que define al registrar un juego de datos solo se respeta cuando coincide o es más restrictivo que el valor definido con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Por ejemplo, supongamos que el ADMIN ha otorgado el ámbito 'MY$TENANCY' con GRANT_REGISTER y el usuario especifica 'MY$REGION' cuando registra un juego de datos con DBMS_CLOUD_LINK.REGISTER. En este caso, verían un error como el siguiente:

    ORA-20001: Share privileges are not enabled for current user or it is enabled but not for scope MY$REGION
  • Algunas comprobaciones de validez jerárquica para el registro no pueden realizarse en el momento del registro. Las inscripciones no válidas no serán visibles, detectables ni siquiera accesibles para nadie.

  • Para utilizar DBMS_CLOUD_LINK.REGISTER, debe tener el privilegio de ejecución en el paquete DBMS_CLOUD_LINK, además del privilegio de registro asignado con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Solo el usuario ADMIN y los esquemas con PDB_DBA tienen este privilegio por defecto.

  • Al registrar un juego de datos en una clonación de refrescamiento en una región remota, la llamada de DBMS_CLOUD_LINK.REGISTER en la clonación de región remota debe utilizar los mismos parámetros con los mismos valores que en la base de datos de origen, con la excepción del parámetro offload_targets.

    Por ejemplo, al ejecutar DBMS_CLOUD_LINK.REGISTER con el ámbito definido en MY$COMPARTMENT en la instancia de Autonomous Database de origen, vuelva a ejecutar el procedimiento en la clonación de refrescamiento entre regiones con el mismo valor de parámetro de ámbito (MY$COMPARTMENT).

  • Si especifica el parámetro offload_targets con DBMS_CLOUD_LINK.REGISTER en el origen, debe omitir este parámetro al registrar el juego de datos en una clonación de refrescamiento entre regiones.

REVOKE_AUTHORIZATION Procedimiento

Este procedimiento revoca la autorización para que una base de datos especificada acceda al juego de datos especificado.

Sintaxis

DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION(
      database_id        IN   VARCHAR2,
      namespace          IN   VARCHAR2 DEFAULT,
      name               IN   VARCHAR2
);

Parámetros

Parámetro Descripción

database_id

Especifica el ID de base de datos para una instancia de Autonomous Database. Utilice DBMS_CLOUD_LINK.GET_DATABASE_ID para obtener el identificador de base de datos.

namespace

Especifica el espacio de nombres del juego de datos para revocar la autorización de acceso para el database_id especificado.

name

Especifica el nombre del juego de datos para revocar la autorización de acceso para el database_id especificado.

Procedimiento UNREGISTER

El procedimiento permite a un usuario que ha registrado previamente una tabla o una vista con el procedimiento REGISTER anular el registro de la tabla o vista para que ya no esté disponible para el acceso remoto.

Sintaxis

DBMS_CLOUD_LINK.UNREGISTER(
      namespace        IN   VARCHAR2,
      name             IN   VARCHAR2
);

Parámetros

Parámetro Descripción

namespace

Especifica un nombre de usuario.

name

Especifica el nombre para el conjunto de datos.

Nota de uso

DBMS_CLOUD_LINK.UNREGISTER también puede tardar hasta diez (10) minutos en propagarse por completo, después de lo cual se puede acceder a los datos de forma remota.

UPDATE_REGISTRATION Procedimiento

El procedimiento actualiza uno o más de los atributos de un juego de datos registrado mediante DBMS_CLOUD_LINK.REGISTER.

Sintaxis

DBMS_CLOUD_LINK.UPDATE_REGISTRATION(
     namespace        IN VARCHAR2,
     name             IN VARCHAR2,
     description      IN CLOB      DEFAULT,
     scope            IN CLOB      DEFAULT,
     auth_required    IN BOOLEAN   DEFAULT,
     data_set_owner   IN VARCHAR2  DEFAULT,
     offload_targets  IN CLOB      DEFAULT

);

Parámetros

Parámetro Descripción
namespace

Especifica el espacio de nombres del juego de datos que se va a actualizar.

name

especifica el nombre del juego de datos que se va a actualizar.

description

Especifica el texto actualizado para describir los datos.

Si se transfiere NULL para este valor de parámetro, el atributo no se modifica.

Por defecto, no se actualiza este atributo.

scope

Actualice el ámbito con el valor especificado. El ámbito describe quién tiene permiso para acceder al juego de datos. El valor es una lista separada por comas que consta de una o más de las siguientes opciones:

  • OCID de la base de datos: se permite el acceso al juego de datos para las instancias específicas de Autonomous Database identificadas por el OCID.

  • OCID del compartimento: se permite el acceso al juego de datos para las bases de datos en los compartimentos identificados por el OCID del compartimento.

  • OCID del arrendamiento: se permite el acceso al juego de datos para las bases de datos en los arrendamientos identificados por el OCID del arrendamiento.

  • Nombre de región: se permite el acceso al juego de datos para las bases de datos de la región identificada por la región con nombre. Por ámbito, el acceso a enlaces en la nube está limitado a una sola región y no es entre regiones. Un consumidor de una región diferente solo puede acceder a un juego de datos cuando existe una clonación de refrescamiento entre regiones de la base de datos que es el propietario del juego de datos en la región de la base de datos de consumidor.

    Consulte Registro o anulación del registro de un juego de datos en una región diferente para obtener más información.

  • MY$COMPARTMENT: se permite el acceso al juegos de datos para las bases de datos del mismo compartimento que el del propietario de juego.

  • MY$TENANCY: se permite el acceso al juegos de datos para las bases de datos del mismo arrendamiento que el del propietario de juego.

  • MY$REGION: se permite el acceso al juegos de datos para las bases de datos de la misma región que el del propietario de juego.

  • Lista de regiones: se permite el acceso al juego de datos para las bases de datos de las regiones especificadas

    Por ejemplo:

    scope   =>  'us-phoenix-1,us-ashburn-1',

    Un consumidor de una región diferente solo puede acceder a un juego de datos cuando existe una clonación de refrescamiento entre regiones de la base de datos que es el propietario del juego de datos en la región de la base de datos de consumidor.

Los valores de ámbito, MY$REGION, MY$TENANCY y MY$COMPARTMENT son variables que actúan como macros de conveniencia y se resuelven en OCID.

Si se transfiere NULL para este valor de parámetro, el atributo no se modifica.

Por defecto, no se actualiza este atributo.

auth_required

Especifica que se necesita una autorización adicional para que las bases de datos lean desde el juego de datos. Los casos posibles son los siguientes:

  • Las bases de datos que se encuentran dentro del SCOPE especificado y se han autorizado con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION pueden ver filas del juego de datos.

  • Las bases de datos que estén dentro del SCOPE especificado pero no se hayan autorizado con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION no pueden ver las filas del juego de datos. En este caso, los consumidores sin autorización ven el juego de datos como vacío.

  • Las bases de datos que no están dentro del SCOPE especificado muestran un error al intentar acceder al juego de datos.

Si se transfiere NULL para este valor de parámetro, el atributo no se modifica.

Por defecto, no se actualiza este atributo.

data_set_owner

Especifica el propietario del juego de datos. Indica a quién pertenece el conjunto de datos o quién es el responsable de actualizar y mantener el conjunto de datos. Por ejemplo, puede definir data_set_owner en la dirección de correo electrónico de la persona que registró el juego de datos.

Si se transfiere NULL para este valor de parámetro, el atributo no se modifica.

Por defecto, no se actualiza este atributo.

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 se registra el juego 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.

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 con la palabra clave ANY, cualquier solicitud de acceso se descarga en la clonación de refrescamiento identificada con OFFLOAD_TARGET en el JSON proporcionado (excepto las solicitudes que tienen una entrada explícita 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 una entrada ANY:

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

DBMS_CLOUD_LINK.REGISTER informa de un error si el OCID proporcionado como valor OFFLOAD_TARGET no es un OCID de una clonación de refrescamiento en la misma región.

Consulte Uso de clonaciones de refrescamiento con Autonomous Database para obtener información sobre el uso de clonaciones de refrescamiento.

Si se transfiere NULL para este valor de parámetro, el atributo no se modifica.

Por defecto, no se actualiza este atributo.

Notas de uso

  • Los atributos schema_name y schema_object de un juego de datos no se pueden actualizar.

  • Después de actualizar el registro de un objeto, puede que los usuarios tengan que esperar hasta diez (10) minutos para acceder al objeto mediante los atributos actualizados con enlaces en la nube.

  • Puede actualizar el registro de una tabla o vista que reside en el esquema de otro usuario cuando tiene privilegios READ WITH GRANT OPTION para la tabla o vista.

  • El ámbito que define al actualizar el registro de un juego de datos solo se respeta cuando coincide o es más restrictivo que el valor definido con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Por ejemplo, supongamos que el administrador ha otorgado el ámbito 'MY$TENANCY' con GRANT_REGISTER y que el usuario especifica 'MY$REGION' cuando actualiza el registro para el juego de datos con DBMS_CLOUD_LINK.UPDATE_REGISTRATION. En este caso, verían un error como el siguiente:

    ORA-20001: Share privileges are not enabled for current user or it is enabled but not for scope MY$REGION
  • No se pueden realizar ciertas comprobaciones de validez jerárquica para un registro actualizado cuando se actualiza el registro. Las inscripciones no válidas no serán visibles, detectables ni siquiera accesibles para nadie.

  • El usuario que ha registrado un juego de datos puede actualizar sus atributos con DBMS_CLOUD_LINK.UPDATE_REGISTRATION. Además, debe tener el privilegio de ejecución en el paquete DBMS_CLOUD_LINK y el privilegio de registro asignado con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Solo el usuario ADMIN y los esquemas con PDB_DBA tienen este privilegio por defecto.

  • Al actualizar el registro de un juego de datos en una clonación de refrescamiento en una región remota, la llamada de DBMS_CLOUD_LINK.UPDATE_REGISTRATION en la clonación de región remota debe utilizar los mismos parámetros con los mismos valores que en la base de datos de origen, con la excepción del parámetro offload_targets.

    Por ejemplo, al ejecutar DBMS_CLOUD_LINK.UPDATE_REGISTRATION con el ámbito definido en MY$COMPARTMENT en la instancia de Autonomous Database de origen, vuelva a ejecutar el procedimiento en la clonación de refrescamiento entre regiones con el mismo valor de parámetro de ámbito (MY$COMPARTMENT).

  • Si especifica el parámetro offload_targets con DBMS_CLOUD_LINK.REGISTER en el origen, debe omitir este parámetro al registrar el juego de datos en una clonación de refrescamiento entre regiones.