Documentazione dell'infrastruttura Oracle Cloud

Pacchetto DBMS_CATALOG

Il pacchetto DBMS_CATALOG include una vasta gamma di sottoprogrammi per la gestione dei cataloghi, raggruppati per funzionalità.

  • Installazione e disinstallazione del catalogo:

    È possibile aggiungere un nuovo catalogo ad Autonomous AI Database eseguendo il MOUNT di una connessione esistente (ad esempio un database link esistente a un database) oppure aggiungendo una nuova connessione e registrando il sistema esterno come nuovo catalogo.

    È possibile abilitare o disabilitare un catalogo.
    Nota

    I cataloghi disabilitati conservano i dettagli di connessione e gli eventuali metadati correnti, ma non vengono aggiornati e non sono accessibili né dalle interfacce utente né dalle API.

    Rimuovere o scollegare un catalogo da Autonomous AI Database.

  • Gestione delle proprietà del catalogo:
    I sottoprogrammi menzionati qui consentono di recuperare e aggiornare varie proprietà di cataloghi, schemi e tabelle all'interno del sistema. In particolare, fornisce funzioni per:

    • Recupera il valore di una proprietà per un catalogo, uno schema o una tabella, incluse le opzioni per gestire valori di testo di grandi dimensioni in formato CLOB.

    • Aggiornare il valore delle proprietà per cataloghi, schemi o tabelle, con il supporto per i tipi di dati normali e CLOB.

  • Gestione credenziali:
    Un catalogo attivato avrà zero o più credenziali obbligatorie. Si tratta di credenziali che devono essere specificate prima di poter utilizzare il catalogo. I cataloghi Iceberg, ad esempio, hanno in genere due credenziali richieste.
    • ICEBERG_CREDENTIAL: credenziale utilizzata per chiamare gli endpoint del catalogo REST di Iceberg. In genere si tratta di una credenziale token bearer.
    • DATA_STORAGE_CREDENTIAL: credenziale utilizzata per accedere ai file Iceberg nel bucket.
    È possibile pensare a credenziale obbligatoria come a un parametro da specificare. Una credenziale locale è un oggetto CREDENTIAL effettivo nello schema dell'utente che svolge il ruolo di una delle credenziali richieste. È possibile specificare le credenziali localiquando si attiva il catalogo utilizzando argomenti quali catalog_credential e data_storage_credential in DBMS_CATALOG.MOUNT_ICEBERG. È inoltre possibile specificarli in un secondo momento chiamando SET_LOCAL_CREDENTIAL.
    BEGIN
  -- Create a new credential
  DBMS_CLOUD.CREATE_CREDENTIAL('BUCKET_CREDENTIAL', ...);

  -- Make the new credential play the role of the required 'DATA_STORAGE_CREDENTIAL'
  DBMS_CATALOG.SET_LOCAL_CREDENTIAL(
    catalog_name => 'iceberg_cat',
    required_credential => 'DATA_STORAGE_CREDENTIAL',
    local_credential => 'BUCKET_CREDENTIAL');
END;
    È possibile visualizzare il mapping corrente tra le credenziali obbligatorie e locali con la funzione GET_LOCAL_CREDENTIAL_MAP.
    SELECT
   JSON_QUERY(dbms_catalog.get_local_credential_map('iceberg_cat'), '$' PRETTY)
FROM dual;
  2    3  
JSON_QUERY(DBMS_CATALOG.GET_LOCAL_CREDENTIAL_MAP('ICEBERG_CAT'),'$'PRETTY)
------------------------------------------------------------------------------------------------------------------------
{
  "DATA_STORAGE_CREDENTIAL" : "BUCKET_CREDENTIAL",
  "ICEBERG_CREDENTIAL" : "UNITY_CRED"
}
  • Gestione entità catalogo:
    I sottoprogrammi elencati qui fanno riferimento alla gestione di varie entità all'interno di un catalogo, tra cui la creazione, il recupero e l'eliminazione di collegamenti di storage, schemi, tabelle e altri oggetti del catalogo. Fornisce funzioni per:

    • Crea ed elimina i collegamenti di storage cloud collegati ai cataloghi.

    • Consente di creare ed eliminare tabelle esterne all'interno dei cataloghi.

    • Creare ed eliminare gli schemi e i relativi contenuti.

    • Recupera liste di tabelle, schemi e altri oggetti catalogo con filtro facoltativo.

  • Accesso ai dati e inserimento nella cache:
    Questa sezione comprende le funzioni che gestiscono l'esecuzione di query sui dati, la gestione dei cursori dei risultati e il controllo dell'inserimento dei metadati nella cache all'interno dei cataloghi. Include funzionalità per:

    • Generare istruzioni SELECT per le tabelle logiche con opzioni personalizzabili.

    • Aprire i cursori per recuperare i dati dalle tabelle logiche.

    • Svuota e precompila la cache dei metadati per consentire ai cataloghi di mantenere aggiornati i dati.

  • Sincronizzazione e condivisione:
    In questa sezione sono elencate le funzioni che consentono la gestione e la manutenzione di cataloghi e schemi coerenti e aggiornati in sistemi o ambienti diversi. Fornisce le funzioni riportate di seguito.
    • CREATE_SYNCHRONIZED_SCHEMAS: crea schemi locali nel database sincronizzati con le definizioni dei cataloghi remoti, assicurando che l'ambiente locale rifletta l'origine remota.
    • DROP_SYNCHRONIZED_SCHEMAS: Rimuove uno o più schemi sincronizzati in precedenza.
    • UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY: modifica le proprietà degli schemi sincronizzati, ad esempio la registrazione delle modifiche o il funzionamento della sincronizzazione, aggiornando le proprietà con nuovi valori in formato CLOB.
    • GRANT_TO_RECIPIENT & REVOKE_FROM_RECIPIENT: consente di gestire le autorizzazioni di accesso concedendo o revocando l'accesso ai cataloghi per destinatari di condivisione specifici, controllando chi può visualizzare o modificare i dati del catalogo.
    ​