Formations — 1 037 leçons en français

Accueil › SQL & bases de données › INSERT : ajouter des lignes

INSERT : ajouter des lignes

Modifier les donnéesdebutant

INSERT INTO produit (nom, prix, categorie)
VALUES ('Clavier mécanique', 89.90, 'claviers')
RETURNING id;

Deux réflexes valent pour toutes les insertions :

Nommer les colonnes. Sans liste, la correspondance se fait par position : une migration qui insère une colonne au milieu décale toutes les valeurs, sans erreur si les types restent compatibles.

Utiliser RETURNING pour récupérer ce que la base a généré — identifiant, valeur par défaut, colonne calculée — sans seconde requête.

Pour insérer plusieurs lignes, une seule instruction suffit :

INSERT INTO produit (nom, prix) VALUES
    ('Souris sans fil', 29.50),
    ('Tapis XL',        19.00),
    ('Casque USB',      59.90);

Quand la ligne peut déjà exister, ON CONFLICT règle le problème de façon atomique :

INSERT INTO stock (produit_id, quantite) VALUES (1, 10)
ON CONFLICT (produit_id) DO UPDATE SET quantite = stock.quantite + EXCLUDED.quantite;

Enfin, pour un import massif, COPY est l'outil adapté — pas une boucle d'INSERT.

Les termes à connaître

INSERT INTO … VALUES

Ajoute une ou plusieurs lignes. Nommer explicitement les colonnes (INSERT INTO produit (nom, prix) VALUES …) rend l'instruction insensible à l'ajout ou au déplacement d'une colonne.

INSERT … SELECT

Insère le résultat d'une requête : copie, archivage, alimentation d'une table de travail. Bien plus rapide qu'une boucle d'insertions unitaires.

RETURNING

Clause PostgreSQL qui fait renvoyer à l'instruction les lignes écrites : INSERT … RETURNING id. Elle évite un aller-retour supplémentaire pour récupérer l'identifiant généré.

ON CONFLICT (upsert)

INSERT … ON CONFLICT (colonne) DO UPDATE SET … : insérer, ou mettre à jour si la ligne existe déjà. L'opération est atomique, contrairement à un « SELECT puis INSERT » applicatif.

Insertion par lot

Insérer N lignes en une instruction (VALUES (…), (…), (…)) ou via le batch JDBC. Le gain vient de la réduction des allers-retours réseau et du nombre de validations.

COPY

Commande PostgreSQL de chargement en masse depuis un fichier ou un flux. D'un ordre de grandeur plus rapide qu'INSERT pour des millions de lignes — c'est l'outil des imports.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.