DROP SCHEMA

Область применения: Databricks SQL Databricks Runtime

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

Хотя использование SCHEMA и DATABASE является взаимозаменяемым, лучше использовать SCHEMA.

Синтаксис

DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]

Параметры

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

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

• schema_name

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

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

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

• КАСКАД

  При указании удаляет все связанные таблицы и функции рекурсивно.

  Note

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

  Предупреждение. Если схема управляется хранилищем метаданных Hive на уровне рабочей области, удаление схемы с помощью CASCADE рекурсивно удаляет все файлы в указанном расположении, независимо от типа таблицы (управляемая или внешняя).

Примеры

-- Create `inventory_schema` Database
> CREATE SCHEMA inventory_schema COMMENT 'This schema is used to maintain Inventory';

-- Drop the schema and its tables
> DROP SCHEMA inventory_schema CASCADE;

-- Drop the schema using IF EXISTS
> DROP SCHEMA IF EXISTS inventory_schema CASCADE;

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

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