INSERT

version 11

INSERT INTO {nom_sql | chaîne_sql}

[(ref_colonne, ..., ref_colonne)]

{VALUES({expression_arithmétique |NULL}, ..., {expression_arithmétique |NULL}) |sous_requête}

La commande INSERT permet d'ajouter des données dans une table existante. La table dans laquelle les données sont insérées est désignée via un argument de type nom_sql ou chaîne_sql. Les arguments facultatifs ref_colonne permettent de définir les colonnes dans lesquelles insérer les valeurs. Si aucune ref_colonne n'est passée, les valeurs seront insérées dans l'ordre des colonnes de la base (la première valeur passée sera insérée dans la première colonne, la deuxième dans la deuxième colonne, et ainsi de suite).

Le mot-clé VALUES permet de passer la ou les valeur(s) à insérer dans la ou les colonne(s) spécifiée(s). Vous pouvez passer soit une expression_arithmétique, soit NULL. Alternativement, une sous_requête peut être passée au mot-clé VALUES afin d'insérer une sélection de données en tant que valeurs.

Le nombre de valeurs passées via le mot-clé VALUES doit correspondre au nombre de colonnes défini par le ou les argument(s) ref_colonne. En outre, le type des données insérées doit correspondre à celui des colonnes de la table, ou au moins pouvoir être converti dans ce type.

La commande INSERT est utilisable dans les requêtes mono et multi-lignes. En revanche, une requête INSERT multi-lignes ne permet pas d'effectuer d'opérations UNION et JOIN.

1. Cet exemple simple permet d'insérer une sélection de la table2 dans la table1 :

   INSERT INTO table1 (SELECT * FROM table2) 

2. Cet exemple crée une table et insère des valeurs :

   CREATE TABLE ACTEUR_FANS
      (ID INT32, Nom VARCHAR);
   INSERT INTO ACTEUR_FANS
      (ID, Nom)
       VALUES (1, 'Francis');

DELETE, expression_arithmétique, ref_colonne, sous_requête.