DROP FOREIGN TABLE — Supprime une table distante
DROP FOREIGN TABLE [ IF EXISTS ] nom
[, ...] [ CASCADE | RESTRICT ]
DROP FOREIGN TABLE
supprime une table distante.
Vous devez être propriétaire de la table distante pour utiliser DROP FOREIGN TABLE
.
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.
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.
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.