Post­greSQL INSERT INTO : insérer des lignes

La commande INSERT INTO dans Post­greSQL permet d’ajouter une ou plusieurs nouvelles lignes dans une table existante. Les valeurs doivent être spé­ci­fiées lors de l’insertion

Qu’est-ce que Post­greSQL INSERT INTO ?

La commande Post­greSQL INSERT INTO permet d’insérer de nouvelles lignes dans une table. Vous pouvez insérer une seule ligne ou plusieurs lignes en une seule commande. Dans le cadre de l’uti­li­sa­tion de Post­greSQL INSERT, les colonnes définies lors de la création de la table doivent être spé­ci­fiées di­rec­te­ment dans la commande.

Post­greSQL INSERT : syntaxe et fonc­tion­ne­ment

La syntaxe de base de Post­greSQL INSERT INTO est la suivante :

INSERT INTO nom_de_la_table (colonne1, colonne2, colonne3, ..., colonneN)
VALUES (valeur1, valeur2, valeur3, ..., valeurN);

Si vous utilisez Post­greSQL INSERT INTO, vous indiquez donc d’abord la table dans laquelle vous souhaitez effectuer vos ajus­te­ments. Viennent ensuite les dif­fé­rentes colonnes, bien que vous puissiez omettre cette liste si vous four­nis­sez des valeurs pour toutes les colonnes de la table. Dans ce cas, la syntaxe est la suivante :

INSERT INTO nom_de_la_table
VALUES (valeur1, valeur2, valeur3, …, valeurN);

Dans tous les cas, vous devez stocker les dif­fé­rentes valeurs dans le bon ordre. Elles sont insérées dans les dif­fé­rentes colonnes de gauche à droite.

Exemple de la commande Post­greSQL INSERT INTO

La meilleure façon d’illustrer comment Post­greSQL INSERT INTO fonc­tionne dans la pratique est de donner un exemple concret. Pour cela, nous créons une table appelée « Liste des clients » avec Post­greSQL CREATE TABLE. Celle-ci contient quatre colonnes in­ti­tu­lées « ID », « Nom », « Ville » et « Adresse ». Voici à quoi ressemble le code cor­res­pon­dant :

CREATE TABLE liste_des_clients (
    ID SERIAL PRIMARY KEY,
    Nom VARCHAR(50) NOT NULL,
    Ville VARCHAR(50),
    Adresse VARCHAR(255)
);

Pour insérer une ligne, nous utilisons Post­greSQL INSERT :

INSERT INTO liste_des_clients (ID, Nom, Ville, Adresse)
VALUES (1, 'Madiot', 'Lyon', '1, rue du Commerce');

Dans l’exemple suivant, nous ne con­nais­sons pas l’adresse d’un client et laissons ce champ vide lors de la saisie. Il reçoit alors la valeur par défaut définie dans le tableau. Si aucune valeur n’a été définie, la valeur est NULL. Voici le code :

INSERT INTO liste_des_clients (ID, NOM, VILLE) 
VALUES (2, 'Wirth', 'Toulouse');

Insérer plusieurs lignes en même temps avec Post­greSQL INSERT

Il est également possible d’ajouter plusieurs lignes en même temps dans Post­greSQL avec INSERT INTO. Dans le code suivant, nous insérons deux clients sup­plé­men­taires :

INSERT INTO liste_des_clients (ID, Nom, Ville, Adresse)
VALUES 
    (3, 'Bourrat', 'Strasbourg', '17, rue du Bac'), 
    (4, 'Sambat', 'Montpellier', '73, place de la République');

Les lignes sont mises entre pa­ren­thèses et séparées par des virgules.