CREATE TABLE AS — Définir une nouvelle table à partir des résultats d'une requête
+CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ]nom_table
[ (nom_colonne
[, ...] ) ] [ USINGmethod
] [ WITH (parametre_stockage
[=valeur
] [, ... ] ) | WITHOUT OIDS ] [ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ] [ TABLESPACEnom_espace_logique
] ASrequête
[ WITH [ NO ] DATA ]
CREATE TABLE AS
crée une table et y insère les
données récupérées par une commande SELECT
. Les
colonnes de la table ont les noms et les types de
données associés aux colonnes en sortie du SELECT
(les noms des colonnes peuvent toutefois être surchargés).
CREATE TABLE AS
semble posséder des similitudes avec la création
d'une vue mais est, en fait, assez différente : elle crée une nouvelle
table et n'évalue la requête qu'une seule fois, pour le chargement initial de la nouvelle table.
Les modifications ultérieures de la table source ne sont pas prises en compte. Au contraire,
une vue réévalue l'instruction SELECT
de définition à chaque appel.
CREATE TABLE AS
nécessite le droit
CREATE
sur le schéma utilisé par la table.
GLOBAL
ou LOCAL
Ignoré. Ces mots clés sont obsolètes, ils ne sont conservés que pour la compatibilité (cf. CREATE TABLE).
TEMPORARY
ou TEMP
Si spécifié, la table est temporaire (cf. CREATE TABLE).
UNLOGGED
Si spécifié, la table est créée comme une table non tracée dans les journaux de transactions. Voir CREATE TABLE pour plus de détails.
IF NOT EXISTS
Ne renvoie pas une erreur si une relation de même nom existe déjà. Un message d'avertissement est renvoyé dans ce cas et la table n'est pas modifiée.
nom_table
Le nom de la table à créer (éventuellement qualifié du nom du schéma).
nom_colonne
Le nom d'une colonne dans la nouvelle table. Si les noms de colonnes ne sont pas précisés, ils sont issus des noms des colonnes en sortie de la requête.
USING méthode
Cette clause optionnelle indique la méthode d'accès à la table à utiliser
pour stocker le contenu de la nouvelle table ; la méthode doit être
une méthode d'accès de type TABLE
. Voir Chapitre 63 pour plus d'informations. Si cette option n'est pas spécifiée,
la méthode d'accès par défaut à la table est choisie pour la nouvelle table.
Voir default_table_access_method
pour plus d'informations.
WITH ( paramètre_stockage
[= valeur
] [, ... ] )
Cette clause indique les paramètres de stockage optionnels pour la
nouvelle table ; voir Paramètres de stockage pour plus d'informations.
Par souci de rétrocompatibilité, la clause WITH
pour une
table peut aussi inclure OIDS=FALSE
pour spécifier que
les lignes de la table ne doivent pas comporter d'OID (object identifiers),
OIDS=TRUE
n'étant plus supporté.
WITHOUT OIDS
Cette clause est une syntaxe rétrocompatible pour déclarer une table
WITHOUT OIDS
. La création d'une table WITH
OIDS
n'est plus supportée.
ON COMMIT
Le comportement des tables temporaires à la fin d'un bloc de transaction
est contrôlable en utilisant ON COMMIT
. Voici les
trois options :
PRESERVE ROWS
Aucune action spéciale n'est effectuée à la fin de la transaction. C'est le comportement par défaut.
DELETE ROWS
Toutes les lignes de la table temporaire seront supprimées à la fin de
chaque bloc de transaction. Habituellement, un TRUNCATE
automatique est
effectué à chaque COMMIT.
DROP
La table temporaire sera supprimée à la fin du bloc de transaction en cours.
TABLESPACE nom_espace_logique
L'nom_espace_logique
est le nom
du tablespace dans lequel est créée la nouvelle table. S'il n'est
pas indiqué, default_tablespace est consulté, sauf
si la table est temporaire auquel cas temp_tablespaces
est utilisé.
requête
Une commande SELECT
,
TABLE
, ou
VALUES
,
voire un EXECUTE
qui exécute un
SELECT
préparé, TABLE
ou une
requête VALUES
.
WITH [ NO ] DATA
Cette clause indique si les données produites par la requêtes doivent être copiées dans la nouvelle table. Si non, seule la structure de la table est copiée. La valeur par défaut est de copier les données.
Cette commande est fonctionnellement équivalente à
SELECT INTO. Elle lui est
cependant préférée car elle présente moins de risques de confusion avec les autres utilisations
de la syntaxe SELECT INTO
. De plus,
CREATE TABLE AS
offre plus de fonctionnalités
que SELECT INTO
.
Créer une table films_recent
contenant les
entrées récentes de la table films
:
CREATE TABLE films_recent AS SELECT * FROM films WHERE date_prod >= '2006-01-01';
Pour copier une table complètement, la forme courte utilisant la clause
TABLE
peut aussi être utilisée :
CREATE TABLE films2 AS TABLE films;
Créer une nouvelle table temporaire films_recents
consistant
des seules entrées récentes provenant de la table films
en
utilisant une instruction préparée. La nouvelle table sera
supprimée à la validation (COMMIT) :
PREPARE films_recents(date) AS SELECT * FROM films WHERE date_prod > $1; CREATE TEMP TABLE films_recents ON COMMIT DROP AS EXECUTE films_recents('2002-01-01');
CREATE TABLE AS
est conforme au standard
SQL. The following are nonstandard extensions :
Le standard requiert des parenthèses autour de la clause de la sous-requête ; elles sont optionnelles dans PostgreSQL.
Dans le standard, la clause WITH [ NO ] DATA
est requise
alors que PostgreSQL la rend optionnelle.
PostgreSQL gère les tables temporaires d'une façon bien différente de celle du standard ; voir CREATE TABLE pour les détails.
La clause WITH
est une extension
PostgreSQL ; les paramètres de stockage
ne sont dans le standard.
Le concept PostgreSQL des tablespaces ne
fait pas partie du standard. Du coup, la clause TABLESPACE
est une extension.