DROP SCHEMA

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

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

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

Permissions

Чтобы разместить схему в Unity Catalog, вы должны иметь MANAGE право на схему или быть её владельцем, а также USE CATALOG в каталоге, где находится схема.

Для иерархии объектов владелец родительского каталога и пользователей с MANAGE родительским каталогом также может выполнять эту операцию.

Синтаксис

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;
  • Last updated on