DROP FOREIGN DATA WRAPPER
Read PG 18 manual ↗remove a foreign-data wrapper
Syntax
DROP FOREIGN DATA WRAPPER [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]
Syntax diagrams
Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.
Description
DROP FOREIGN DATA WRAPPER removes an existing foreign-data wrapper. To execute this command, the current user must be the owner of the foreign-data wrapper.
Parameters
IF EXISTSDo not throw an error if the foreign-data wrapper does not exist. A notice is issued in this case.
nameThe name of an existing foreign-data wrapper.
CASCADEAutomatically drop objects that depend on the foreign-data wrapper (such as foreign tables and servers), and in turn all objects that depend on those objects (see Section 5.15).
RESTRICTRefuse to drop the foreign-data wrapper if any objects depend on it. This is the default.
Examples
Drop the foreign-data wrapper dbi:
DROP FOREIGN DATA WRAPPER dbi;
Compatibility
DROP FOREIGN DATA WRAPPER conforms to ISO/IEC 9075-9 (SQL/MED). The IF EXISTS clause is a PostgreSQL extension.
See Also
CREATE FOREIGN DATA WRAPPER, ALTER FOREIGN DATA WRAPPERVersion history 4
- PG 19 → 20changed
- PG 18 → 19changed
- PG 16 → 17changed
- PG 11 → 12changed
Related entries
Definition snapshot: 2026-09-14T13:14:25.700916+00:00@99e6866c · English manual source