CREATE TABLE name (column type constraints, ...) crée une table. Chaque colonne reçoit un nom et un type de données, puis des contraintes facultatives comme PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE ou CHECK.
La colonne id se numérote toute seule, plan prend 'free' quand l'insertion ne la renseigne pas, et created_at enregistre l'heure de l'insertion. La page sur les types de données liste les types de colonnes courants.
Contraintes de colonne
| Contrainte | Effet |
|---|---|
PRIMARY KEY | Unique et non nulle ; une par table |
NOT NULL | La colonne doit avoir une valeur |
DEFAULT expr | Valeur utilisée quand une insertion omet la colonne |
UNIQUE | Deux lignes ne peuvent pas avoir la même valeur (plusieurs NULL sont permis) |
CHECK (expr) | Rejette les lignes où l'expression est fausse |
REFERENCES t (col) | Clé étrangère vers une autre table |
Depuis PostgreSQL 15, UNIQUE NULLS NOT DISTINCT traite les NULL comme égaux, donc une seule ligne peut avoir un NULL dans cette colonne.
Règles qui portent sur plusieurs colonnes
Une contrainte sur plus d'une colonne se place sur sa propre ligne, après les colonnes. La nommer avec CONSTRAINT name rend les messages d'erreur lisibles et permet de la supprimer par son nom plus tard.
La requête liste les trois contraintes. Celles sans nom ont reçu des noms générés, bookings_guests_check et bookings_pkey.
Créer une table seulement si elle n'existe pas
IF NOT EXISTS transforme le second CREATE TABLE en simple avertissement au lieu d'une erreur. Il ne vérifie que le nom. Si une table logs existe déjà avec d'autres colonnes, rien ne change.
Créer une table à partir d'une requête ou d'une autre table
CREATE TABLE ... AS crée une table à partir du résultat d'un SELECT, avec les colonnes et les types de ce résultat. LIKE copie la définition d'une autre table sans ses lignes, et INCLUDING ALL reprend aussi ses valeurs par défaut, ses contraintes, son identity et ses index.
big_orders contient une ligne. orders_archive a les colonnes et les contraintes de orders et aucune ligne.
Colonnes générées
Une colonne générée est calculée à partir d'autres colonnes de la même ligne, et une insertion ne peut pas y écrire. Dans PostgreSQL 17, elle doit être STORED : la valeur est calculée à l'écriture et enregistrée sur le disque.
Les totaux valent 13.5 et 20.
Tables temporaires et unlogged
CREATE TEMP TABLE crée une table que seule la session en cours voit, supprimée à la fin de la session. Elle convient aux résultats intermédiaires d'un long script. CREATE UNLOGGED TABLE saute le journal d'écriture anticipée (WAL), donc les écritures sont plus rapides. La table est vidée après un crash et n'est pas copiée sur les réplicas, alors réservez-la aux données que vous pouvez reconstruire.
CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);
Pour modifier une table qui existe déjà, utilisez ALTER TABLE. Toutes les options sont listées dans la référence de CREATE TABLE.
Questions fréquentes
Les noms de table PostgreSQL sont-ils sensibles à la casse ?
Les noms sans guillemets sont convertis en minuscules, donc CREATE TABLE Users crée users. Un nom entre guillemets comme "Users" garde sa casse et doit ensuite être mis entre guillemets dans chaque requête, c'est pourquoi les noms en snake_case minuscule sont la norme.
Comment voir la structure d'une table dans PostgreSQL ?
Dans psql, \d table_name affiche les colonnes, les types, les valeurs par défaut, les index et les contraintes. En SQL, interrogez information_schema.columns WHERE table_name = 'table_name'.
Comment copier une table dans PostgreSQL ?
CREATE TABLE copy AS TABLE original; copie les colonnes et les lignes, mais ni les contraintes ni les index. CREATE TABLE copy (LIKE original INCLUDING ALL); copie la structure avec les valeurs par défaut, les contraintes et les index, mais aucune ligne.
Comment supprimer une table dans PostgreSQL ?
DROP TABLE table_name; supprime la table et ses données. DROP TABLE IF EXISTS table_name; évite l'erreur quand elle n'existe pas, et CASCADE supprime aussi les vues et les clés étrangères qui en dépendent.