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 lebatchJDBC. 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'
INSERTpour des millions de lignes — c'est l'outil des imports.
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.