DROP SCHEMA
Область применения: Databricks SQL
Databricks Runtime
Удаляет схему и каталог, связанный со схемой, из файловой системы. Если схема не существует в системе, возникает исключение. Чтобы удалить схему, необходимо иметь права MANAGE
для схемы или быть его владельцем.
Хотя использование SCHEMA
и DATABASE
является взаимозаменяемым, лучше использовать SCHEMA
.
Синтаксис
DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]
Параметры
IF EXISTS
Если этот параметр задан, то в случае несуществующей схемы исключение не создается.
-
Имя существующих схем в системе. Если указанное имя не существует, создается исключение.
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;