DROP CATALOG

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

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

Синтаксис

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

Параметры

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

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

• catalog_name:

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

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

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

• КАСКАД

  При указании удаляет все связанные базы данных (схемы) и объекты внутри них рекурсивно.

  Note

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

Примеры

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

Связанные статьи

• CREATE CATALOG
• DESCRIBE CATALOG
• SHOW CATALOGS
• Жизненный цикл хранилища объектов в каталоге Unity