Pacchetto DBMS_CLOUD_LINK_ADMIN

Il package DBMS_CLOUD_LINK_ADMIN consente all'utente ADMIN di abilitare un utente del database a registrare i data set o ad accedere ai data set registrati per una determinata istanza di Autonomous Database, fatte salve le limitazioni di accesso definite con l'ambito concesso.

È inoltre possibile disabilitare i privilegi per un utente che dispone dei privilegi impostati per registrare i data set o accedere ai data set registrati.

DBMS_CLOUD_LINK_ADMIN Panoramica

Descrive l'uso del pacchetto DBMS_CLOUD_LINK_ADMIN.

Cloud Links forniscono un metodo basato sul cloud per accedere in remoto ai dati di sola lettura su un'istanza di Autonomous Database. Il pacchetto DBMS_CLOUD_LINK_ADMIN utilizza i meccanismi di accesso a Oracle Cloud Infrastructure per rendere i data set accessibili all'interno di un ambito specifico e, inoltre, è disponibile un passo di autorizzazione facoltativo.

Riepilogo dei sottoprogrammi DBMS_CLOUD_LINK_ADMIN

La tabella seguente contiene un riepilogo dei sottoprogrammi inclusi nel pacchetto DBMS_CLOUD_LINK_ADMIN.

Programma secondario descrizione;

ADD_SERVICE_MAPPING Procedura

La procedura associa un database consumer Cloud Links a un servizio di database.

GRANT_AUTHORIZE Procedura

Concede a un utente l'autorizzazione per richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

GRANT_READ Procedura

Consente a un utente di leggere i set di dati registrati, fatte salve le limitazioni di accesso imposte ai set di dati al momento della registrazione.

GRANT_REGISTER Procedura

Consente a un utente di registrare un data set per l'accesso remoto.

REMOVE_SERVICE_MAPPING Procedura

Rimuovere un mapping di servizi per un database specificato.

REVOKE_AUTHORIZE Procedura

Revoca l'autorizzazione di un utente per richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

REVOKE_READ Procedura

Non consente a un utente di accedere ai data set registrati dell'istanza di Autonomous Database.

REVOKE_REGISTER Procedura

Non consente a un utente di registrare i data set per l'accesso remoto. I data set già registrati dall'utente non sono interessati.

ADD_SERVICE_MAPPING Procedura

La procedura DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING associa un database consumer a un servizio di database.

Sintassi

DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING(
      database_id        IN   VARCHAR2,
      service_name       IN   VARCHAR2
);

Parametri

Parametro descrizione;

database_id

Specifica l'ID database per un'istanza di Autonomous Database che è un consumer Cloud Link. Utilizzare DBMS_CLOUD_LINK.GET_DATABASE_ID per ottenere l'ID del database.

Il valore "ANY" associa il valore service_name specificato a tutti i database consumer che non dispongono di una voce corrispondente all'identificativo del database. Cioè, qualsiasi database_id il cui service_name non è stato impostato con DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valori validi: un ID di database o "ANY".

service_name

Specifica il nome servizio del database. I valori validi dipendono dal tipo di carico di lavoro:

  • Data warehouse: i valori validi sono: HIGH, MEDIUM, LOW

  • Elaborazione delle transazioni, Database JSON o APEX: i valori validi sono: TP, TPURGENT, HIGH, MEDIUM, LOW

Note per uso

  • Solo l'utente ADMIN e gli schemi con ruolo PDB_DBA possono eseguire DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

  • È necessario eseguire DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING sull'istanza di Autonomous Database del proprietario del data set.

GRANT_AUTHORIZE Procedura

La procedura concede a un utente l'autorizzazione per richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintassi

DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE(
      username        IN   VARCHAR2
);

Parametri

Parametro descrizione;

username

Specifica un nome utente.

Note per uso

  • Per abilitare l'autorizzazione per un data set con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, è necessario aver concesso il privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Ciò vale anche per l'utente ADMIN. Tuttavia, l'utente ADMIN può concedere questo privilegio a se stesso.

GRANT_READ Procedura

La procedura consente a un utente di leggere i set di dati registrati, fatte salve le restrizioni di accesso imposte ai set di dati quando un set di dati viene registrato utilizzando DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.

Sintassi

DBMS_CLOUD_LINK_ADMIN.GRANT_READ(
      username        IN   VARCHAR2
);

Parametri

Parametro descrizione;

username

Specifica un nome utente.

Note per uso

  • Per leggere i data set, è necessario aver concesso il privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Ciò vale anche per l'utente ADMIN. Tuttavia, l'utente ADMIN può concedere questo privilegio a se stesso.

  • Un utente può eseguire una query su SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') per verificare se sono abilitati per l'accesso READ a un data set.

    Ad esempio, la query seguente:

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

    Restituisce 'YES' o 'NO'.

GRANT_REGISTER Procedura

La procedura consente a un utente di registrare un data set per l'accesso remoto.

Sintassi

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

Parametri

Parametro descrizione;

username

Specifica l'ID di un utente.

scope

Specifica l'ambito in cui devono essere concesse le autorizzazioni di pubblicazione all'utente specificato.

Valori validi:

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

Note per l'uso

  • Per registrare i data set, è necessario aver concesso il privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Ciò vale anche per l'utente ADMIN. Tuttavia, l'utente ADMIN può concedere questo privilegio a se stesso.

  • Un utente può eseguire una query su SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') per verificare se sono abilitati per la registrazione dei data set.

    Ad esempio, la query seguente:

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

    Restituisce 'YES' o 'NO'.

REMOVE_SERVICE_MAPPING Procedura

La procedura DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING rimuove un mapping di servizi per un database specificato.

Sintassi

DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING(
      database_id        IN   VARCHAR2
);

Parametri

Parametro descrizione;

database_id

Specifica l'ID database per un'istanza Autonomous Database. Utilizzare DBMS_CLOUD_LINK.GET_DATABASE_ID per ottenere l'ID del database.

Il valore "ANY" rimuove qualsiasi valore service_name specificato con tutti i database consumer che non dispongono di una voce corrispondente all'identificativo del database. Cioè, qualsiasi database_id il cui service_name non è stato impostato con DBMS_CLOUD_LINK_ADMIN.ADD_SERVICE_MAPPING.

Valori validi: un ID di database o "ANY".

Nota per l'uso

Solo l'utente ADMIN e gli schemi con ruolo PDB_DBA possono eseguire DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING.

REVOKE_AUTHORIZE Procedura

Questa procedura impedisce a un utente di richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Sintassi

DBMS_CLOUD_LINK_ADMIN.REVOKE_AUTHORIZE(
      username        IN   VARCHAR2
);

Parametri

Parametro descrizione;

username

Specifica un nome utente.

REVOKE_READ Procedura

Questa procedura non consente a un utente di accedere ai data set registrati nell'istanza di Autonomous Database.

Sintassi

DBMS_CLOUD_LINK_ADMIN.REVOKE_READ(
      username        IN   VARCHAR2
);

Parametri

Parametro descrizione;

username

Specifica un nome utente.

Nota per l'uso

  • Un utente può eseguire una query su SYS_CONTEXT('USERENV', 'CLOUD_LINK_READ_ENABLED') per verificare se sono abilitati per l'accesso READ a un data set.

    Ad esempio, la query seguente:

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

    Restituisce 'YES' o 'NO'.

REVOKE_REGISTER Procedura

La procedura impedisce a un utente di registrare i data set per l'accesso remoto. I data set già registrati dall'utente non sono interessati.

Sintassi

DBMS_CLOUD_LINK_ADMIN.REVOKE_REGISTER(
      username        IN   VARCHAR2
);

Parametri

Parametro descrizione;

username

Specifica l'ID di un utente.

Nota per l'uso

  • Un utente può eseguire una query su SYS_CONTEXT('USERENV', 'CLOUD_LINK_REGISTER_ENABLED') per verificare se sono abilitati per la registrazione dei data set.

    Ad esempio, la query seguente:

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

    Restituisce 'YES' o 'NO'.