Leggere in inglese

Condividi tramite

DROP CATALOG

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì Solo Unity Catalog

Elimina un catalogo. Viene generata un'eccezione se il catalogo non esiste nel metastore. Per eliminare un catalogo, è necessario avere il privilegio MANAGE sul catalogo o esserne il proprietario.

Sintassi

DROP CATALOG [ IF EXISTS ] catalog_name [ RESTRICT | CASCADE ]

Parametri

  • IF EXISTS

    Se specificato, non viene generata alcuna eccezione quando il catalogo non esiste.

  • catalog_name:

    Nome di un catalogo esistente nel metastore. Se il nome non esiste, viene generata un'eccezione.

  • RESTRICT

    Se specificato, limita l'eliminazione di un catalogo non vuoto. Abilitato per impostazione predefinita.

  • CASCADE

    Se specificato, elimina tutti i database associati (schemi) e gli oggetti all'interno di essi, in modo ricorsivo. In Unity Catalog, l'eliminazione di un catalogo tramite CASCADE comporta l'eliminazione non definitiva delle tabelle: i file delle tabelle gestite verranno eliminati dopo 30 giorni, ma i file esterni non vengono eliminati.

Esempi

-- Create a `vaccine` catalog
> CREATE CATALOG vaccine COMMENT 'This catalog is used to maintain information about vaccines';

-- Drop the catalog and its schemas
> DROP CATALOG vaccine CASCADE;

-- Drop the catalog using IF EXISTS and only if it is empty.
> DROP CATALOG IF EXISTS vaccine RESTRICT;