Перейти к основному содержимому

DROP TABLE

примечание

Эта страница переведена при помощи нейросети GigaChat.

DROP TABLE - удаление таблицы.

Синтаксис

DROP TABLE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

Описание

DROP TABLE удаляет таблицы из базы данных. Выполнить эту операцию могут только владелец таблицы, владелец схемы или суперпользователь. Если нужно просто очистить таблицу от данных, но сохранить ее структуру, используйте DELETE или TRUNCATE.

При удалении таблицы с помощью DROP TABLE также автоматически удаляются все связанные с ней индексы, правила, триггеры и ограничения. Однако если таблица используется во внешних ключах других таблиц или задействована в представлениях, необходимо указать CASCADE. В этом случае:

  • представления, зависящие от таблицы, будут удалены полностью;
  • во внешних ключах будет удалено только соответствующее ограничение, но не таблица, на которую ссылаются.

Параметры

IF EXISTS
Подавляет ошибку, если указанная таблица не существует, вместо этого выводится уведомление.
name
Задает имя существующей таблицы, при необходимости дополненное схемой, которая должна быть удалена.
CASCADE
Автоматически удаляет объекты, которые зависят от таблицы (например, представления), а также все объекты, зависящие от этих объектов.
RESTRICT
Запрещает удаление таблицы, если какие-либо объекты зависят от нее. Это значение по умолчанию.

Примеры

Удаление двух таблиц films и distributors:

DROP TABLE films, distributors;

Совместимость

Эта команда соответствует стандарту SQL, за исключением того, что стандарт позволяет удалять только одну таблицу за один раз, а также параметр IF EXISTS является расширением PostgreSQL.

Смотрите также

ALTER TABLE, CREATE TABLE