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