DROP CATALOG

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 10.4 LTS и более поздней проверка помечены да версии каталога Unity

Удаляет каталог. Если каталог не существует в хранилище метаданных, создается исключение. Чтобы удалить каталог, необходимо быть его владельцем.

Синтаксис

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

Параметры

  • IF EXISTS

    Если этот параметр задан, то в случае несуществующего каталога исключение не создается.

  • catalog_name:

    Имя существующего каталога в хранилище метаданных. Если указанное имя не существует, создается исключение.

  • RESTRICT

    При указании ограничивает удаление непустого каталога. Включено по умолчанию.

  • CASCADE

    При указании удаляет все связанные базы данных (схемы) и объекты внутри них рекурсивно. В каталоге Unity удаление каталога с помощью CASCADE таблиц обратимого удаления: файлы управляемых таблиц будут удалены через 30 дней, но внешние файлы не удаляются.

Примеры

-- 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;