Section courante

A propos

Section administrative du site

ALTER FOREIGN TABLE

Modifie la table étrangère
PostgreSQL

Syntaxe

ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] action [, ... ]
ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] name [ * ] RENAME [ COLUMN ] column_name TO new_column_name
ALTER FOREIGN TABLE [ IF EXISTS ] name RENAME TO new_name
ALTER FOREIGN TABLE [ IF EXISTS ] name
SET SCHEMA new_schema

où l'action est l'une des suivantes :

ADD [ COLUMN ] column_name data_type [ COLLATE collation ] [ column_constraint [ ... ] ]
DROP [ COLUMN ] [ IF EXISTS ] column_name [ RESTRICT | CASCADE ]
ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type [ COLLATE collation ]
ALTER [ COLUMN ] column_name SET DEFAULT expression
ALTER [ COLUMN ] column_name DROP DEFAULT
ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL
ALTER [ COLUMN ] column_name SET STATISTICS integer
ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] )
ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )
ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ALTER [ COLUMN ] column_name OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ])
ADD table_constraint [ NOT VALID ]
VALIDATE CONSTRAINT constraint_name
DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ]
DISABLE TRIGGER [ trigger_name | ALL | USER ]
ENABLE TRIGGER [ trigger_name | ALL | USER ]
ENABLE REPLICA TRIGGER trigger_name
ENABLE ALWAYS TRIGGER trigger_name
SET WITH OIDS
SET WITHOUT OIDS
INHERIT parent_table
NO INHERIT parent_table
OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ])

Paramètres

Nom Description
name Ce paramètre permet d'indiquer le nom (éventuellement qualifié par le schéma) d'une table étrangère existante à modifier. Si ONLY est spécifié avant le nom de la table, seule cette table est modifiée. Si ONLY n'est pas spécifié, la table et toutes ses tables descendantes (le cas échéant) sont modifiées. Facultativement, * peut être spécifié après le nom de la table pour indiquer explicitement que les tables descendantes sont incluses.
column_name Ce paramètre permet d'indiquer le nom d'une colonne nouvelle ou existante.
new_column_name Ce paramètre permet d'indiquer le nouveau nom pour une colonne existante.
new_name Ce paramètre permet d'indiquer le nouveau nom pour la table.
data_type Ce paramètre permet d'indiquer le type de données de la nouvelle colonne ou nouveau type de données pour une colonne existante.
table_constraint Ce paramètre permet d'indiquer la nouvelle contrainte de table pour la table étrangère.
constraint_name Ce paramètre permet d'indiquer le nom d'une contrainte existante à supprimer.
CASCADE Ce paramètre permet de supprimer automatiquement les objets dépendant de la colonne ou de la contrainte supprimée (par exemple, les vues référençant la colonne), et à leur tour tous les objets dépendant de ces objets.
RESTRICT Ce paramètre permet de refuser de supprimer la colonne ou la contrainte s'il existe des objets dépendants. Ceci est le comportement par défaut.
trigger_name Ce paramètre permet d'indiquer le nom d'un seul déclencheur à désactiver ou à activer.
ALL Ce paramètre permet de désactiver ou d'activer tous les déclencheurs appartenant à la table étrangère. (Cela nécessite des privilèges de superutilisateur si l'un des déclencheurs est un déclencheur généré en interne. Le système principal n'ajoute pas de tels déclencheurs aux tables étrangères, mais le code complémentaire pourrait le faire.)
USER Ce paramètre permet de désactiver ou d'activer tous les déclencheurs appartenant à la table étrangère, à l'exception des déclencheurs générés en interne.
parent_table Ce paramètre permet d'indiquer une table parente à associer ou désassocier à cette table étrangère.
new_owner Ce paramètre permet d'indiquer le nom d'utilisateur du nouveau propriétaire de la table.
new_schema Ce paramètre permet d'indiquer le nom du schéma vers lequel la table sera déplacée.

Description

Cette instruction permet de changer la définition d'une table étrangère.



Dernière mise à jour : Jeudi, le 14 Octobre 2021