Gestire i cataloghi

Questo articolo illustra come visualizzare, aggiornare ed eliminare cataloghi in Unity Catalog. Un catalogo contiene schemi (database) e uno schema contiene tabelle, viste, volumi, modelli e funzioni.

Per altre informazioni sui cataloghi, vedere Che cosa sono i cataloghi in Azure Databricks? e Creare cataloghi. Per informazioni su come concedere e revocare l'accesso a un catalogo, vedere Privilegi del catalogo Unity e oggetti a protezione diretta.

Per informazioni su come gestire un catalogo esterno, un oggetto Catalogo Unity che esegue il mirroring di un database in un sistema dati esterno, vedere Gestire e usare cataloghi esterni.

Requisiti

Per visualizzare, aggiornare o eliminare un catalogo:

• È necessario disporre di un metastore del catalogo Unity collegato all'area di lavoro in cui si esegue l'attività.

• Il cluster usato per eseguire un notebook per gestire un catalogo deve usare una modalità di accesso conforme al catalogo unity. Vedere Modalità di accesso usata.

  I warehouse SQL supportano sempre il catalogo Unity.

Le autorizzazioni necessarie variano in base all'attività e vengono fornite in ogni sezione seguente.

Visualizzare i dettagli del catalogo

Autorizzazione richiesta: gli utenti possono visualizzare i metadati per tutti i cataloghi di cui sono proprietari o in cui sono stati assegnati l'autorizzazione USE CATALOG o BROWSE .

Per visualizzare informazioni su un catalogo, è possibile usare Esplora cataloghi o un comando SQL.

Esplora cataloghi

1. Accedere a un'area di lavoro collegata al metastore.

2. Fare clic su Catalogo.

3. Nel riquadro Catalogo trovare il catalogo e fare clic sul relativo nome.

   Alcuni dettagli sono elencati nella parte superiore della pagina. Altri utenti possono essere visualizzati nelle schede Schemi, Dettagli, Autorizzazioni e Aree di lavoro .

SQL

Eseguire SHOW CATALOGS in un notebook o nell'editor di query SQL per elencare tutti i cataloghi in un metastore o quelli che corrispondono a un'espressione regolare.

Eseguire il comando SQL seguente per ottenere informazioni dettagliate su un catalogo. Gli elementi tra parentesi sono facoltativi. Sostituire il segnaposto <catalog-name>.

DESCRIBE CATALOG <catalog-name>;

Usare CATALOG EXTENDED per ottenere i dettagli completi.

Per altre informazioni, vedere DESCRIBE CATALOG.

Aggiornare un catalogo

Per aggiornare o modificare un catalogo, è possibile usare Esplora cataloghi o un comando SQL.

Autorizzazioni necessarie: le autorizzazioni necessarie per aggiornare un catalogo dipendono dall'aggiornamento:

• Per modificare il proprietario, è necessario essere il proprietario o avere MANAGE e USE CATALOG nel catalogo.
• Per rinominare il catalogo, è necessario essere il proprietario o avere MANAGE e USE CATALOG nel catalogo.
• Per aggiungere o aggiornare un commento o tag, è necessario essere il proprietario o avere MANAGE o MODIFY e USE CATALOG nel catalogo.
• Per concedere e revocare le autorizzazioni per il catalogo, è necessario essere il proprietario del catalogo, un amministratore del metastore o disporre di MANAGE e USE CATALOG nel catalogo.

Esplora cataloghi

1. Accedere a un'area di lavoro collegata al metastore del catalogo Unity.
2. Fare clic su Catalogo.
3. Nel riquadro Catalogo a sinistra fare clic sul catalogo da aggiornare.
4. Usare gli elementi di pagina seguenti nella pagina dei dettagli del catalogo per aggiornare il catalogo:
   • Scheda Panoramica : aggiornare il proprietario, aggiungere o aggiornare i tag, aggiungere o aggiornare i commenti. Vedere Gestire la proprietà degli oggetti del catalogo Unity, Applicare tag a oggetti a protezione diretta di Unity Catalog e Aggiungere commenti ai dati e agli asset di intelligenza artificiale.
   • Scheda Autorizzazioni : concedere e revocare privilegi nel catalogo. Vedere Gestire i privilegi in Unity Catalog.
   • Menu kebab: rinominare il catalogo.
   • Pulsante Crea schema : aggiungere uno schema al catalogo. Vedere Creare schemi.

SQL

• Per modificare il proprietario, aggiungere o aggiornare i tag e gestire l'ottimizzazione predittiva nelle tabelle di un catalogo, eseguire il ALTER CATALOG comando in un notebook o nell'editor di query SQL. Vedere ALTER CATALOG.
• Per concedere o revocare privilegi, usare il GRANT comando o REVOKE . Vedere GRANT e REVOKE.
• Per aggiungere schemi al catalogo, vedere Che cosa sono gli schemi in Azure Databricks?.
• Per rinominare un catalogo usando SQL, è necessario creare un nuovo catalogo e spostare tutti gli asset nel nuovo catalogo.

Eliminare un catalogo

Per eliminare o eliminare un catalogo, è possibile usare Esplora cataloghi o un comando SQL.

Autorizzazione richiesta: proprietario del catalogo o MANAGE e USE CATALOG associati al catalogo.

Esplora cataloghi

È necessario eliminare tutti gli schemi nel catalogo tranne information_schema prima di poter eliminare un catalogo. Questo include lo schema creato automaticamente default .

1. Accedere a un'area di lavoro collegata al metastore.
2. Fare clic su Catalogo.
3. Nel riquadro Catalogo, a sinistra, fare clic sul catalogo da eliminare.
4. Nel riquadro dei dettagli fare clic sul menu kebab a sinistra del pulsante Crea database e selezionare Elimina.
5. Nella finestra di dialogo Elimina catalogo fare clic su Elimina.

SQL

Eseguire il comando SQL seguente in un notebook o in un editor SQL di Databricks. Gli elementi tra parentesi sono facoltativi. Sostituire il segnaposto <catalog-name>.

Per le descrizioni dei parametri, vedere DROP CATALOG.

Se si usa DROP CATALOG senza l'opzione CASCADE , è necessario eliminare tutti gli schemi nel catalogo tranne information_schema prima di poter eliminare il catalogo. Questo include lo schema creato automaticamente default .

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Ad esempio, per eliminare un catalogo denominato vaccine e i relativi schemi:

DROP CATALOG vaccine CASCADE