Supported versions: Current (18) / 17 / 16 / 15 / 14

Development versions: 19 / 20devel

Unsupported versions: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1

Historical version. PostgreSQL 9.1 has reached end of support. 2016-10-27. See the current manual.

DROP FOREIGN TABLE

Name

DROP FOREIGN TABLE -- remove a foreign table

Synopsis

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

Description

DROP FOREIGN TABLE removes a foreign table. Only the owner of a foreign table can remove it.

Parameters

IF EXISTS: Do not throw an error if the foreign table does not exist. A notice is issued in this case.
name: The name (optionally schema-qualified) of the foreign table to drop.
CASCADE: Automatically drop objects that depend on the foreign table (such as views).
RESTRICT: Refuse to drop the foreign table if any objects depend on it. This is the default.

Examples

To destroy two foreign tables, films and distributors:

DROP FOREIGN TABLE films, distributors;

Compatibility

This command conforms to the ISO/IEC 9075-9 (SQL/MED), except that the standard only allows one foreign table to be dropped per command, and apart from the IF EXISTS option, which is a PostgreSQL extension.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current manual.