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


DROP SCHEMA

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

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

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

Синтаксис

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

Parameters

  • IF EXISTS

    Если задано, исключение не возникает, если schema не существует.

  • schema_name

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

  • RESTRICT

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

  • CASCADE

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

Примеры

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