Поделиться через

DROP CATALOG

  • Статья

Область применения:флажок Databricks SQL флажок Databricks Runtime 10.4 LTS и более поздних версий флажок только Unity Catalog

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

Синтаксис

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

Параметры

  • ЕСЛИ СУЩЕСТВУЕТ

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

  • catalog_name:

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

  • ОГРАНИЧИВАТЬ

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

  • КАСКАД

    При указании удаляет все связанные базы данных (схемы) и объекты внутри них рекурсивно. В Unity Catalog удаление каталога с использованием CASCADE осуществляет обратимое удаление таблиц: файлы управляемых таблиц будут очищены в течение 7–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;