CREATE TABLE AS |
Crée une table à |
|---|---|
| PostgreSQL | |
Syntaxe
|
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] table_name [ (column_name [, ...] ) ] [ WITH ( storage_parameter [= value] [, ... ] ) | WITH OIDS | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ TABLESPACE tablespace_name ] AS query [ WITH [ NO ] DATA ] |
Paramètres
| Nom | Description | |
|---|---|---|
| GLOBAL | Ce paramètre permet d'indiquer global. Ce paramètre est ignoré pour la compatibilité. L'utilisation de ces mots-clefs est obsolète. | |
| LOCAL | Ce paramètre permet d'indiquer local. Ce paramètre est ignoré pour la compatibilité. L'utilisation de ces mots-clefs est obsolète. | |
| TEMP | Ce paramètre permet d'indiquer une tabler temporaire. Si spécifié, la table est créée en tant que table temporaire. | |
| TEMPORARY | Ce paramètre permet d'indiquer une tabler temporaire. Si spécifié, la table est créée en tant que table temporaire. | |
| UNLOGGED | Ce paramètre permet d'indiquer, si spécifié, la table est créée en tant que table non journalisée. | |
| 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. | |
| 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 dans la nouvelle table. Si les noms de colonnes ne sont pas fournis, ils sont extraits des noms de colonnes de sortie de la requête. | |
| WITH ( storage_parameter [= value] [, ... ] ) | Ce paramètre permet d'indiquer les paramètres d'entreposage facultatifs pour la nouvelle table. La clause WITH peut également inclure OIDS=TRUE (ou simplement OIDS) pour spécifier que les lignes de la nouvelle table doivent avoir des OID (identificateurs d'objet) leur étant affectés, ou OIDS=FALSE pour spécifier que les lignes ne doivent pas avoir d'OID. | |
| WITH OIDS WITHOUT OIDS |
Ce sont des syntaxes obsolètes équivalentes à WITH (OIDS) et WITH (OIDS=FALSE), respectivement. Si vous souhaitez donner à la fois un paramètre OIDS et des paramètres d'entreposage, vous devez utiliser la syntaxe WITH ( ... ). | |
| ON COMMIT | Ce paramètre permet d'indiquer le comportement des tables temporaires à la fin d'un bloc de transaction peut être contrôlé à l'aide de ON COMMIT. Les trois options sont : | |
| Option | Description | |
| PRESERVE ROWS | Cette option permet d'indiquer qu'aucune action particulière n'est prise à la fin des transactions. Ceci est le comportement par défaut. | |
| DELETE ROWS | Cette option permet d'indiquer que toutes les lignes de la table temporaire seront supprimées à la fin de chaque bloc de transaction. Essentiellement, un TRUNCATE automatique est effectué à chaque commit. | |
| DROP | Cette option permet d'indiquer que la table temporaire sera supprimée à la fin du bloc de transaction en cours. | |
| TABLESPACE tablespace_name | Ce paramètre permet d'indiquer le tablespace_name est le nom du tablespace dans lequel la nouvelle table doit être créée. Si non spécifié, default_tablespace est consulté, ou temp_tablespaces si la table est temporaire. | |
| query | Ce paramètre permet d'indiquer une commande SELECT, TABLE ou VALUES, ou une commande EXECUTE exécutant une requête SELECT, TABLE ou VALUES préparée. | |
| WITH [ NO ] DATA | Ce paramètre permet d'indiquer si les données produites par la requête doivent être copiées ou non dans la nouvelle table. Sinon, seule la structure de la table est copiée. La valeur par défaut consiste à copier les données. | |
Description
Cette instruction permet de définir une nouvelle table à partir des résultats d'une requête.
Dernière mise à jour : Jeudi, le 14 Octobre 2021