DROP SERVER

remove a foreign server descriptor

Syntax

DROP SERVER [ 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.

DROP SERVER removes an existing foreign server descriptor. To execute this command, the current user must be the owner of the server.

IF EXISTS: Do not throw an error if the server does not exist. A notice is issued in this case.
name: The name of an existing server.
CASCADE: Automatically drop objects that depend on the server (such as user mappings), and in turn all objects that depend on those objects (see Section 5.15).
RESTRICT: Refuse to drop the server if any objects depend on it. This is the default.

Drop a server foo if it exists:

DROP SERVER IF EXISTS foo;

DROP SERVER conforms to ISO/IEC 9075-9 (SQL/MED). The IF EXISTS clause is a PostgreSQL extension.

Definition snapshot: 2026-09-14T13:14:25.700916+00:00@99e6866c · English manual source