Documentation PostgreSQL 14.22 » Référence » Commandes SQL » DROP FOREIGN TABLE

Précédent | Niveau supérieur | Suivant
DROP FOREIGN DATA WRAPPER | Sommaire | DROP FUNCTION

## DROP FOREIGN TABLE

DROP FOREIGN TABLE — Supprime une table distante

## Synopsis

    DROP FOREIGN TABLE [ IF EXISTS ] nom [, ...] [ CASCADE | RESTRICT ]

## Description

`DROP FOREIGN TABLE` supprime une table distante.

Vous devez être propriétaire de la table distante pour utiliser `DROP FOREIGN TABLE`.

## Paramètres

`IF EXISTS`

  Permet de ne pas retourner d'erreur si la table distante n'existe pas. Une simple notice est alors rapportée.

`nom`

  Le nom de la table distante à supprimer. Il est aussi possible de spécifier le schéma qui contient cette table.

`CASCADE`

  Supprime automatiquement les objets qui dépendent de cette table distante (comme les vues par exemple), ainsi que tous les objets dépendants de ces objets (voir Section 5.14).

`RESTRICT`

  Permet de spécifier que la table distante ne sera pas supprimée si des objets en dépendent. Il s'agit du comportement par défaut.

## Exemples

Pour supprimer deux tables distantes, `films` et `distributeurs`:

    DROP FOREIGN TABLE films, distributeurs;

Cette commande va échouer s'il existe des objets qui dépendent de `films` ou `distributeurs`. Par exemple, si des contraintes sont liées à des colonnes de `films`. Dans ce cas de figure, ajoutez l'option cascade `CASCADE` pour forcer la suppression de ces objets.

## Compatibilité

Cette commande est conforme avec le standard ISO/IEC 9075-9 (SQL/MED), aux exceptions prêtes que ce standard n'accepte la suppression que d'une table distante par commande, et de l'option `IF EXISTS`, qui est une spécificité de PostgreSQL.

## Voir aussi

ALTER FOREIGN TABLE, CREATE FOREIGN TABLE