Paquete DBMS_CLOUD_LINK_ADMIN

El paquete DBMS_CLOUD_LINK_ADMIN permite al usuario ADMIN permitir a un usuario de base de datos registrar juegos de datos o acceder a juegos de datos registrados para una instancia de Autonomous Database determinada, según las restricciones de acceso definidas con el ámbito otorgado.

Los privilegios también se pueden desactivar para un usuario que tenga los privilegios definidos para registrar juegos de datos o acceder a juegos de datos registrados.

Visión general de DBMS_CLOUD_LINK_ADMIN

Describe el uso del paquete DBMS_CLOUD_LINK_ADMIN.

Los enlaces de nube proporcionan un método basado en la nube para acceder de forma remota a datos de solo lectura en una instancia de Autonomous Database. El paquete DBMS_CLOUD_LINK_ADMIN aprovecha los mecanismos de acceso de Oracle Cloud Infrastructure para que los juegos de datos estén accesibles en un ámbito específico y, además, hay un paso de autorización opcional.

Resumen de los subprogramas DBMS_CLOUD_LINK_ADMIN

En esta tabla, se resumen los subprogramas incluidos en el paquete DBMS_CLOUD_LINK_ADMIN.

Subprograma Descripción
Procedimiento GRANT_AUTHORIZE

Permite al usuario ADMIN revocar el permiso de un usuario para invocar los procedimientos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION y DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Procedimiento GRANT_READ

Permite a un usuario leer juegos de datos registrados, sujetos a las restricciones de acceso impuestas a los juegos de datos en el registro.

Procedimiento GRANT_REGISTER

Permite a un usuario registrar un juego de datos para el acceso remoto.

Procedimiento REVOKE_AUTHORIZE

Permite al usuario ADMIN revocar el permiso de un usuario para invocar los procedimientos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION y DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Procedimiento REVOKE_READ

No permite que un usuario acceda a juegos de datos registrados de la instancia de Autonomous Database.

Procedimiento REVOKE_REGISTER

No permite que un usuario registre juegos de datos para el acceso remoto. Los juegos de datos ya registrados por el usuario no se ven afectados.

Procedimiento GRANT_AUTHORIZE

El procedimiento otorga un permiso de usuario para llamar a los procedimientos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION y DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE(
      username        IN   VARCHAR2
);

Parámetros

parámetro Descripción

username

Especifica un nombre de usuario.

Notas de Uso

  • Para activar la autorización para un juego de datos con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, debe haber otorgado el privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Esto también es cierto para el usuario ADMIN; sin embargo, el usuario ADMIN puede otorgar este privilegio a sí mismo.

Procedimiento GRANT_READ

El procedimiento permite a un usuario leer juegos de datos registrados, según las restricciones de acceso impuestas a los juegos de datos cuando se registra un juego de datos mediante DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Parámetros

parámetro Descripción

username

Especifica un nombre de usuario.

Notas de Uso

  • Para leer juegos de datos, debe haber otorgado el privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Esto también es cierto para el usuario ADMIN; sin embargo, el usuario ADMIN puede otorgar este privilegio a sí mismo.

  • Un usuario puede consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') para comprobar si está activado para el acceso READ a un juego de datos.

    Por ejemplo, la siguiente consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Devuelve 'YES' o 'NO'.

Procedimiento GRANT_REGISTER

El procedimiento permite a un usuario registrar un juego de datos para el acceso remoto.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER(
      username        IN   VARCHAR2,
      scope           IN   CLOB
);

Parámetros

parámetro Descripción

username

Especifica el nombre de un usuario.

scope

Especifica el ámbito en el que se otorgarán permisos para publicar al usuario especificado.

Los valores válidos son:

  • 'MY$REGION'
  • 'MY$TENANCY'
  • 'MY$COMPARTMENT'

Notas de Uso

  • Para registrar juegos de datos, debe haber otorgado el privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Esto también es cierto para el usuario ADMIN; sin embargo, el usuario ADMIN puede otorgar este privilegio a sí mismo.

  • Un usuario puede consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') para comprobar si están activados para registrar juegos de datos.

    Por ejemplo, la siguiente consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Devuelve 'YES' o 'NO'.

Procedimiento REVOKE_AUTHORIZE

Este procedimiento no permite que un usuario llame a los procedimientos DBMS_CLOUD_LINK.GRANT_AUTHORIZATION y DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.REVOKE_AUTHORIZE(
      username        IN   VARCHAR2
);

Parámetros

parámetro Descripción

username

Especifica un nombre de usuario.

Procedimiento REVOKE_READ

Este procedimiento no permite que un usuario acceda a juegos de datos registrados en la instancia de Autonomous Database.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Parámetros

parámetro Descripción

username

Especifica un nombre de usuario.

Nota de Uso

  • Un usuario puede consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') para comprobar si está activado para el acceso READ a un juego de datos.

    Por ejemplo, la siguiente consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') FROM DUAL;

    Devuelve 'YES' o 'NO'.

Procedimiento REVOKE_REGISTER

El procedimiento no permite que un usuario registre juegos de datos para el acceso remoto. Los juegos de datos ya registrados por el usuario no se ven afectados.

Sintaxis

DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER(
      username        IN   VARCHAR2
);

Parámetros

parámetro Descripción

username

Especifica el nombre de un usuario.

Nota de Uso

  • Un usuario puede consultar SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') para comprobar si están activados para registrar juegos de datos.

    Por ejemplo, la siguiente consulta:

    SELECT SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') FROM DUAL;

    Devuelve 'YES' o 'NO'.