CREATE FOREIGN TABLE |
Crée une table étrangère |
|---|---|
| PostgreSQL | |
Syntaxe
|
CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name ( [ { column_name data_type [ OPTIONS ( option 'value' [, ... ] ) ] [ COLLATE collation ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] ] ) [ INHERITS ( parent_table [, ... ] ) ] SERVER server_name [ OPTIONS ( option 'value' [, ... ] ) ] |
|
CREATE FOREIGN TABLE [ IF NOT EXISTS ] table_name PARTITION OF parent_table [ ( { column_name [ WITH OPTIONS ] [ column_constraint [ ... ] ] | table_constraint } [, ... ] ) ] partition_bound_spec SERVER server_name [ OPTIONS ( option 'value' [, ... ] ) ] où column_constraint est : [ CONSTRAINT constraint_name ] { NOT NULL | NULL | CHECK ( expression ) [ NO INHERIT ] | DEFAULT default_expr } et table_constraint est : [ CONSTRAINT constraint_name ] CHECK ( expression ) [ NO INHERIT ] |
Paramètres
| Nom | Description |
|---|---|
| IF NOT EXISTS | Ce paramètre permet d'indiquer s'il n'existe pas. Ne renvoie pas d'erreur si une relation du même nom existe déjà. Un avis est émis dans ce cas. Notez qu'il n'y a aucune garantie que la relation existante ressemble à celle ayant été créée. |
| table_name | Ce paramètre permet d'indiquer le nom (éventuellement qualifié par le schéma) de la table à créer. |
| column_name | Ce paramètre permet d'indiquer le nom d'une colonne à créer dans la nouvelle table. |
| data_type | Ce paramètre permet d'indiquer le type de données de la colonne. Cela peut inclure des spécificateurs de tableau. |
| COLLATE collation | Ce paramètre permet d'indiquer le classement. La clause COLLATE affecte un classement à la colonne (qui doit être d'un type de données pouvant être classé). S'il n'est pas spécifié, le classement par défaut du type de données de colonne est utilisé. |
| INHERITS (parent_table [, ... ]) | Ce paramètre permet d'indiquer la clause facultative INHERITS spécifie une liste de tables dont la nouvelle table étrangère hérite automatiquement de toutes les colonnes. Les tables parents peuvent être des tables simples ou des tables étrangères. |
| PARTITION OF parent_table FOR VALUES partition_bound_spec | Ce paramètre permet de créer la table étrangère en tant que partition de la table parent donnée avec des valeurs liées à la partition spécifiées. |
| CONSTRAINT constraint_name | Ce paramètre permet d'indiquer un nom facultatif pour une contrainte de colonne ou de table. Si la contrainte est violée, le nom de la contrainte est présent dans les messages d'erreur, donc les noms de contrainte comme col doit être positif peuvent être utilisés pour communiquer des informations de contrainte utiles aux applications clientes. (Les guillemets doubles sont nécessaires pour spécifier les noms de contraintes contenant des espaces.) Si aucun nom de contrainte n'est spécifié, le système génère un nom. |
| NOT NULL | Ce paramètre permet d'indiquer la colonne n'est pas autorisée à contenir des valeurs nulles. |
| NULL | Ce paramètre permet d'indiquer que la colonne est autorisée à contenir des valeurs nulles. C'est la valeur par défaut. Cette clause n'est fournie qu'à des fins de compatibilité avec les bases de données SQL non standard. Son utilisation est déconseillée dans les nouvelles applications. |
| CHECK ( expression ) [ NO INHERIT ] | Ce paramètre permet d'indiquer l'expression à vérifier. La clause CHECK spécifie une expression produisant un résultat booléen que chaque ligne de la table étrangère est censée satisfaire ; c'est-à-dire que l'expression doit produire TRUE ou UNKNOWN, jamais FALSE, pour toutes les lignes de la table étrangère. Une contrainte de vérification spécifiée en tant que contrainte de colonne doit référencer uniquement la valeur de cette colonne, tandis qu'une expression apparaissant dans une contrainte de table peut référencer plusieurs colonnes. Actuellement, les expressions CHECK ne peuvent pas contenir de sous-requêtes ni faire référence à des variables autres que les colonnes de la ligne actuelle. La tableoïde de la colonne système peut être référencée, mais aucune autre colonne système. Une contrainte marquée NO INHERIT ne se propagera pas aux tables enfants. |
| DEFAULT default_expr | Ce paramètre permet d'indiquer les expressions par défaut. La clause DEFAULT attribue une valeur de données par défaut à la colonne dont la définition de colonne apparaît. La valeur est toute expression sans variable (les sous-requêtes et les références croisées à d'autres colonnes de la table actuelle ne sont pas autorisées). Le type de données de l'expression par défaut doit correspondre au type de données de la colonne. L'expression par défaut sera utilisée dans toute opération d'insertion ne spécifiant pas de valeur pour la colonne. S'il n'y a pas de valeur par défaut pour une colonne, la valeur par défaut est null. |
| server_name | Ce paramètre permet d'indiquer le nom d'un serveur étranger existant à utiliser pour la table étrangère. |
| OPTIONS ( option 'value' [, ...] ) | Ce paramètre permet d'indiquer les options à associer à la nouvelle table étrangère ou à l'une de ses colonnes. Les noms et valeurs d'option autorisés sont spécifiques à chaque enveloppe de données étrangères et sont validés à l'aide de la fonction de validation de l'enveloppe de données étrangères. Les noms d'option en double ne sont pas autorisés (bien qu'il soit acceptable qu'une option de table et une option de colonne aient le même nom). |
Description
Cette instruction permet de définir une nouvelle table étrangère.
Dernière mise à jour : Jeudi, le 14 Octobre 2021