DROP SERVER

Remove a server definition. This command deletes the connection details for a remote server used by the FEDERATED or SPIDER storage engines.

Syntax

DROP SERVER [ IF EXISTS ] server_name

Description

Drops the server definition for the server named server_name. The corresponding row within the mysql.servers table will be deleted. This statement requires the SUPER privilege or, from MariaDB 10.5.2, the FEDERATED ADMIN privilege.

Dropping a server for a table does not affect any FederatedX, FEDERATED, Connect or Spider tables that used this connection information when they were created.

DROP SERVER is not written to the binary log, irrespective of the binary log format being used. From MariaDB 10.1.13, Galera replicates the CREATE SERVER, ALTER SERVER and DROP SERVER statements.

IF EXISTS

If the IF EXISTS clause is used, MariaDB will not return an error if the server does not exist. Unlike all other statements, DROP SERVER IF EXISTS does not issue a note if the server does not exist. See MDEV-9400.

Examples

DROP SERVER s;

IF EXISTS:

DROP SERVER s;
ERROR 1477 (HY000): The foreign server name you are trying to reference 
  does not exist. Data source error:  s

DROP SERVER IF EXISTS s;
Query OK, 0 rows affected (0.00 sec)

See Also

• CREATE SERVER

• ALTER SERVER

• Spider Storage Engine

• FederatedX Storage Engine

• Connect Storage Engine

• mysql.servers table

_{This page is licensed: GPLv2, originally from fill_help_tables.sql}