DROP TABLE
DROP TABLE — удалить таблицу
Синтаксис
DROP TABLE [ IF EXISTS ] имя [, ...] [ CASCADE | RESTRICT ]Описание
DROP TABLE удаляет таблицы из базы данных. Удалить таблицу может только её владелец, владелец схемы или суперпользователь. Чтобы опустошить таблицу, не удаляя её саму, вместо этой команды следует использовать DELETE или TRUNCATE.
DROP TABLE всегда удаляет все индексы, правила, триггеры и ограничения, существующие в целевой таблице. Однако чтобы удалить таблицу, на которую ссылается представление или ограничение внешнего ключа в другой таблице, необходимо дополнительно указать CASCADE. (С указанием CASCADE зависимое представление удаляется полностью, тогда как в случае с ограничением внешнего ключа удаляется именно это ограничение, а не вся таблица, к которой оно относится.)
Параметры
IF EXISTSНе считать ошибкой, если таблица не существует. В этом случае будет выдано замечание.
имяИмя (возможно, дополненное схемой) таблицы, подлежащей удалению.
CASCADEАвтоматически удалять объекты, зависящие от данной таблицы (например, представления), и, в свою очередь, все зависящие от них объекты (см. Раздел 5.13).
RESTRICTОтказать в удалении таблицы, если от неё зависят какие-либо объекты. Это поведение по умолчанию.
Примеры
Удаление таблиц films и distributors:
DROP TABLE films, distributors;
Совместимость
Эта команда соответствует стандарту SQL, но возможность удалять в одной команде несколько таблиц и указание IF EXISTS являются расширениями Postgres Pro.
См. также
ALTER TABLE, CREATE TABLESPI_freetuptable
SPI_freetuptable — free a row set created by SPI_execute or a similar function
Synopsis
void SPI_freetuptable(SPITupleTable * tuptable)
Description
SPI_freetuptable frees a row set created by a prior SPI command execution function, such as SPI_execute. Therefore, this function is often called with the global variable SPI_tuptable as argument.
This function is useful if an SPI-using C function needs to execute multiple commands and does not want to keep the results of earlier commands around until it ends. Note that any unfreed row sets will be freed anyway at SPI_finish. Also, if a subtransaction is started and then aborted within execution of an SPI-using C function, SPI automatically frees any row sets created while the subtransaction was running.
Beginning in PostgreSQL 9.3, SPI_freetuptable contains guard logic to protect against duplicate deletion requests for the same row set. In previous releases, duplicate deletions would lead to crashes.
Arguments
SPITupleTable *tuptablepointer to row set to free, or NULL to do nothing