PostgreSQL 8.4.22lts6 Documentation
PrevFast BackwardFast ForwardNext

DROP SERVER

Name

DROP SERVER -- remove a foreign server descriptor

Synopsis

DROP SERVER [ IF EXISTS ] servername [ CASCADE | RESTRICT ]

Description

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

Parameters

IF EXISTS

Do not throw an error if the server does not exist. A notice is issued in this case.

servername

The name of an existing server.

CASCADE

Automatically drop objects that depend on the server (such as user mappings).

RESTRICT

Refuse to drop the server if any objects depend on it. This is the default.

Examples

Drop a server foo if it exists: 

DROP SERVER IF EXISTS foo;

Compatibility

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

See Also

CREATE SERVER, ALTER connections to rmin Massa, Bruce)

  • Add backslash commands for listing schemas, casts, and conversions (Christopher)

  • \encoding now changes based on the server parameter client_encoding (Tom)

    In previous versions, \encoding was not aware of encoding changes made using SET client_encoding.

  • Save editor buffer into readline history (Ross)

    When \e is used to edit a query, the result is saved in the readline history for retrieval using the up arrow.

  • Improve \d<