Documentazione dell'infrastruttura Oracle Cloud

Pacchetto DBMS_CLOUD_LINK_ADMIN

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

I privilegi possono essere disabilitati anche per un utente con i privilegi impostati per registrare i data set o accedere ai data set registrati.

Argomento padre: Riferimento del package fornito per Autonomous Database

Panoramica di DBMS_CLOUD_LINK_ADMIN

Descrive l'uso del pacchetto DBMS_CLOUD_LINK_ADMIN.

I collegamenti cloud forniscono un metodo basato su 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 di Oracle Cloud Infrastructure per rendere i data set accessibili all'interno di un ambito specifico e, inoltre, esiste un passo di autorizzazione facoltativo.

Riepilogo dei sottoprogrammi DBMS_CLOUD_LINK_ADMIN

La tabella riportata di seguito riassume i sottoprogrammi inclusi nel pacchetto DBMS_CLOUD_LINK_ADMIN.

Sottoprogramma Descrizione

Procedura ADD_SERVICE_MAPPING

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

Consente a un utente di richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.

Procedura GRANT_READ

Consente a un utente di leggere i set di dati registrati, soggetti alle restrizioni di accesso imposte ai set di dati al momento della registrazione.

Procedura GRANT_REGISTER

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

Procedura REMOVE_SERVICE_MAPPING

Rimuovere un mapping di servizi per un database specificato.

Procedura REVOKE_AUTHORIZE

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

Procedura REVOKE_READ

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

Procedura REVOKE_REGISTER

Impedisce a un utente di registrare i set di dati per l'accesso remoto. I set di dati 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.
  • GRANT_AUTHORIZE Procedura
    La procedura concede a un utente l'autorizzazione a richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • GRANT_READ Procedura
    La procedura consente a un utente di leggere i set di dati registrati, fatte salve le limitazioni di accesso imposte ai set di dati quando un set di dati viene registrato utilizzando DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER.
  • GRANT_REGISTER Procedura
    La procedura consente a un utente di registrare un data set per l'accesso remoto.
  • REMOVE_SERVICE_MAPPING Procedura
    La procedura DBMS_CLOUD_LINK_ADMIN.REMOVE_SERVICE_MAPPING rimuove un mapping di servizio per un database specificato.
  • REVOKE_AUTHORIZE Procedura
    Questa procedura impedisce a un utente di richiamare le procedure DBMS_CLOUD_LINK.GRANT_AUTHORIZATION e DBMS_CLOUD_LINK.REVOKE_AUTHORIZATION.
  • REVOKE_READ Procedura
    Questa procedura non consente a un utente di accedere ai data set registrati nell'istanza di Autonomous Database.
  • REVOKE_REGISTER Procedura
    La procedura impedisce a un utente di registrare i data set per l'accesso remoto. I set di dati già registrati dall'utente non sono interessati.

Argomento padre: Pacchetto DBMS_CLOUD_LINK_ADMIN

Procedura ADD_SERVICE_MAPPING

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 del database per un'istanza di Autonomous Database che è un consumer di Cloud Link. Usare 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: ID database o "ANY".

service_name

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

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

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

Note sull'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.

Procedura GRANT_AUTHORIZE

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 sull'uso

  • Per abilitare l'autorizzazione per un set di dati con DBMS_CLOUD_LINK.GRANT_AUTHORIZATION, è necessario aver concesso il privilegio con DBMS_CLOUD_LINK_ADMIN.GRANT_AUTHORIZE. Questo è vero anche per l'utente ADMIN; tuttavia l'utente ADMIN può concedere questo privilegio a se stesso.

Procedura GRANT_READ

La procedura consente all'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 sull'uso

  • Per leggere i data set, è necessario disporre del privilegio DBMS_CLOUD_LINK_ADMIN.GRANT_READ. Questo è vero 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'.

Procedura GRANT_REGISTER

La procedura consente a un utente di registrare un set di dati 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 le autorizzazioni da pubblicare devono essere concesse all'utente specificato.

I valori validi sono i seguenti:

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

Note sull'uso

  • Per registrare i set di dati, è necessario disporre del privilegio DBMS_CLOUD_LINK_ADMIN.GRANT_REGISTER. Questo è vero 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'.

Procedura REMOVE_SERVICE_MAPPING

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 del database per un'istanza di Autonomous Database. Usare 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: ID 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.

Procedura REVOKE_AUTHORIZE

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.

Procedura REVOKE_READ

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'.

Procedura REVOKE_REGISTER

La procedura impedisce a un utente di registrare i set di dati per l'accesso remoto. I set di dati 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'.