Menu

PostgreSQL CREATE TABLE : syntaxe et exemples

CREATE TABLE définit les colonnes, les types et les contraintes d'une table. Clés identity, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS et LIKE.

Cette page contient des éditeurs exécutables. Modifiez, exécutez et voyez la sortie instantanément.

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

ContrainteEffet
PRIMARY KEYUnique et non nulle ; une par table
NOT NULLLa colonne doit avoir une valeur
DEFAULT exprValeur utilisée quand une insertion omet la colonne
UNIQUEDeux 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.

Illustration des langages de programmation de Coddy

Apprendre à coder avec Coddy

Commencer