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


DROP SCHEMA

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

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

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

Синтаксис

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

Параметры

  • IF EXISTS

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

  • schema_name

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

  • RESTRICT

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

  • CASCADE

    При указании удаляет все связанные таблицы и функции рекурсивно. В каталоге Unity удаление схемы с помощью CASCADE приводит к мягкому удалению таблиц: управляемые файлы таблиц будут очищены через 30 дней, но внешние файлы не будут удалены. Предупреждение. Если схема управляется хранилищем метаданных 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;