Help Center/ GaussDB/ Developer Guide(Distributed_V2.0-8.x)/ SQL Reference/ SQL Syntax/ D/ DROP FOREIGN TABLE
Updated on 2025-08-19 GMT+08:00
View PDF

DROP FOREIGN TABLE

Description

Drops a foreign table.

Precautions

DROP FOREIGN TABLE forcibly deletes a specified table. After a table is deleted, all indexes that depend on the table are deleted, and the functions and stored procedures using this table cannot be executed.

Syntax

1
 
DROP FOREIGN TABLE [ IF EXISTS ] table_name [, ...] [ CASCADE | RESTRICT ];

Parameters

  • IF EXISTS

    Reports a notice instead of an error if the specified table does not exist.

  • table_name

    Specifies the name of the table to be deleted.

    Value range: an existing table name

  • CASCADE | RESTRICT
    • CASCADE: automatically deletes the objects (such as views) that depend on the table.
    • RESTRICT: refuses to drop the table if any objects depend on it. This is the default action.

Examples

For details, see Examples.

Helpful Links

CREATE FOREIGN TABLE

Parent topic: D