Cours MariaDB / Ajouter une ou plusieurs lignes avec INSERT
Dans MariaDB, INSERT ajoute de nouvelles lignes à une table. Indiquez les colonnes de destination, puis une ou plusieurs listes de valeurs entre parenthèses après VALUES ; contrôlez ensuite le nombre de lignes ajoutées et les valeurs réellement enregistrées. Chaque valeur correspond à la colonne située à la même position dans la liste.
Faire correspondre les colonnes et les valeurs
Dans cet exercice, un produit occupe une ligne. Son numéro, son nom, sa catégorie, son prix, son stock et sa note occupent des colonnes distinctes. Le serveur ne devine pas leur sens : intervertir le prix et le stock peut produire une ligne techniquement valide mais incorrecte pour votre application. Commencez par examiner la structure définie avec CREATE TABLE, puis relisez les valeurs dans les colonnes attendues après l’insertion.
| Élément | Exemple | Contrôle à effectuer |
|---|---|---|
| Table | products_13_lab |
Travailler dans la base de formation shopcourse. |
| Liste des colonnes | product_name, price |
Fournir deux valeurs dans le même ordre. |
| Chaîne | '노트' |
Entourer le texte d’apostrophes simples ; ce mot signifie « carnet ». |
| Nombre | 3500.00 |
Utiliser le point décimal, sans unité ni virgule de groupement. |
| Valeur absente | NULL |
La distinguer de la chaîne de quatre lettres 'NULL'. |
Une liste explicite de colonnes rend l’instruction plus facile à vérifier. Sans cette liste, les valeurs dépendent de l’ordre complet des colonnes dans la table : une modification du schéma peut rendre l’instruction invalide ou changer sa signification. La référence MariaDB de INSERT décrit les formes avec une ou plusieurs listes VALUES.
Pour une apostrophe contenue dans une chaîne littérale, doublez-la, comme dans 'O''Brien'. Cette écriture est utile dans un fichier SQL que vous contrôlez. Dans un programme recevant des saisies externes, utilisez les requêtes paramétrées de votre connecteur : assembler directement une instruction avec ces saisies expose à des erreurs d’échappement et à l’injection SQL.
Exécuter le fichier complet : un produit, puis cinq autres
Connectez-vous au serveur de formation avec course_user et préparez la base shopcourse. Utilisez le client MariaDB, et non l’invite de commandes du système, pour saisir le SQL. Le guide du client et des fichiers SQL UTF-8 explique la connexion et la commande SOURCE. Le compte doit pouvoir créer, consulter, remplir et supprimer les tables de cette base.
Avant de commencer, vérifiez le serveur et la base avec SELECT VERSION(), DATABASE();. Sélectionnez shopcourse, puis recherchez un objet existant avec SHOW TABLES LIKE 'products_13_lab';. Si cette table existe déjà, inspectez sa définition et ses lignes avant toute suppression. L’exercice emploie une table indépendante et ne modifie pas la table products des leçons précédentes.
Enregistrez le bloc suivant dans un fichier UTF-8 nommé lesson13-insert.sql. Dans le client, exécutez SOURCE C:/mariadb-lab/lesson13-insert.sql; en remplaçant le chemin par celui de votre fichier. La définition de la table précède les insertions. Les six premiers numéros sont fournis explicitement pour rendre les résultats comparables ; nous testerons ensuite la génération automatique séparément.
USE shopcourse;
CREATE TABLE products_13_lab (
product_id INT NOT NULL AUTO_INCREMENT,
product_name VARCHAR(100) NOT NULL,
category VARCHAR(30) NOT NULL,
price DECIMAL(10,2) NOT NULL,
stock INT NOT NULL DEFAULT 0,
note VARCHAR(100) NULL DEFAULT NULL,
PRIMARY KEY (product_id),
CONSTRAINT ck_p13_price CHECK (price >= 0),
CONSTRAINT ck_p13_stock CHECK (stock >= 0)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_13_lab
(product_id, product_name, category, price, stock, note)
VALUES (1, '노트', '문구', 3500.00, 20, NULL);
SELECT ROW_COUNT() AS inserted_rows;
INSERT INTO products_13_lab
(product_id, product_name, category, price, stock, note)
VALUES
(2, '볼펜', '문구', 1500.00, 0, ''),
(3, '머그컵', '생활', 8000.00, 12, '선물 포장'),
(4, '스탠드', '생활', 25000.00, 5, NULL),
(5, '파일', '문구', 1500.00, 50, ''),
(6, '케이블', '전자', 8000.00, 0, '호환 확인');
SELECT ROW_COUNT() AS inserted_rows;
Les chaînes coréennes d’origine sont conservées pour que le fichier et les résultats permettent de vérifier le même encodage UTF-8. Recopiez-les telles quelles. Les identifiants 1 à 6 désignent respectivement un carnet, un stylo, un mug, une lampe, un dossier et un câble. Les catégories 문구, 생활 et 전자 signifient papeterie, maison et électronique.
Le premier INSERT contient une seule liste de valeurs. Le second contient cinq listes séparées par des virgules, mais une seule terminaison par point-virgule. Chaque liste doit fournir les six valeurs correspondant aux six colonnes indiquées.
Les deux appels immédiats à ROW_COUNT() renvoient successivement 1 et 5. Cette fonction concerne l’instruction précédente, pas le nombre total de lignes de la table. Une requête intermédiaire changerait l’instruction observée ; consultez ce résultat juste après l’écriture.
Avec autocommit=1, les deux INSERT sont validés séparément. L’échec du second n’annule pas automatiquement le premier produit déjà enregistré. Si plusieurs écritures doivent réussir ou échouer ensemble, une transaction explicite sur des tables transactionnelles demande de traiter l’ensemble et ses erreurs comme une seule opération. La documentation des transactions MariaDB précise le rôle de START TRANSACTION, COMMIT et ROLLBACK.
Relire les six lignes et distinguer NULL d’une chaîne vide
Exécutez la requête suivante après le fichier de préparation. ORDER BY permet de comparer les produits dans l’ordre de leurs numéros, sans dépendre de l’ordre de lecture choisi par le serveur.
SELECT product_id, product_name, category, price, stock, note FROM products_13_lab ORDER BY product_id;
| ID | Sens du nom | Prix | Stock | État ou sens de la note |
|---|---|---|---|---|
| 1 | Carnet | 3500.00 | 20 | NULL |
| 2 | Stylo | 1500.00 | 0 | Chaîne vide |
| 3 | Mug | 8000.00 | 12 | Emballage cadeau |
| 4 | Lampe | 25000.00 | 5 | NULL |
| 5 | Dossier | 1500.00 | 50 | Chaîne vide |
| 6 | Câble | 8000.00 | 0 | Vérifier la compatibilité |
Les descriptions françaises du tableau traduisent le sens des chaînes du script ; les valeurs stockées restent en coréen. Comparez les prix, les catégories et les stocks aux colonnes attendues plutôt que de vous contenter du message de réussite. Par exemple, les produits 2 et 6 ont tous deux un stock nul, mais leurs prix et leurs notes diffèrent.
Une note NULL signifie une valeur absente ; '' est une chaîne présente de longueur zéro. Si le client les affiche de façon peu distincte, l’expression note IS NULL donne 1 pour les produits 1 et 4, et 0 pour les autres. Le guide de NULL et des contraintes de saisie explique pourquoi ces deux états ne sont pas interchangeables. Si les caractères sont illisibles, vérifiez l’encodage UTF-8 du fichier et le jeu de caractères du client avant de réinsérer les mêmes lignes.
Vérifier les colonnes omises et le numéro généré
Exécutez maintenant ce bloc entier dans la même connexion. Il ouvre une transaction, insère un produit en omettant son numéro, son stock et sa note, consulte ce qui a été enregistré, puis annule uniquement cette insertion.
START TRANSACTION;
INSERT INTO products_13_lab (product_name, category, price)
VALUES ('연습 상품', '문구', 2000.00);
SELECT LAST_INSERT_ID() AS generated_id;
SELECT product_id, stock, note IS NULL AS note_is_null
FROM products_13_lab WHERE product_id = LAST_INSERT_ID();
ROLLBACK;
SELECT COUNT(*) AS remaining_rows FROM products_13_lab;
Sur une table fraîche, après les six lignes initiales et avec les réglages usuels d’incrément et de décalage à 1, generated_id vaut 7. Le SELECT suivant affiche 7, 0, 1 : le numéro produit, le stock par défaut 0 et le test confirmant que la note vaut NULL. Après ROLLBACK, remaining_rows vaut 6. La table utilise InnoDB, qui permet l’annulation de cette modification de données.
L’omission applique ici DEFAULT 0 à stock et DEFAULT NULL à note. Fournir explicitement NULL à une colonne NOT NULL est une autre opération et ne revient pas à demander automatiquement sa valeur par défaut. LAST_INSERT_ID() lit l’identifiant généré dans la connexion courante ; ne changez pas de connexion entre l’insertion et sa consultation.
Après d’autres essais, notamment des insertions annulées ou en échec, le numéro observé peut différer de 7. Vérifiez alors la ligne avec le numéro réellement renvoyé et contrôlez ses valeurs par défaut. Comme expliqué dans le cours sur les clés et AUTO_INCREMENT, un compteur automatique peut conserver des trous : annuler la ligne ne promet pas de réutiliser son numéro à l’insertion suivante.
Tester les erreurs une instruction à la fois
Gardez les essais suivants hors du fichier normal de préparation et lancez chaque instruction séparément. Le premier tente de réutiliser la clé primaire 1, le deuxième fournit une valeur pour deux colonnes, et le troisième fournit NULL comme nom obligatoire.
INSERT INTO products_13_lab (product_id, product_name, category, price)
VALUES (1, '중복 상품', '문구', 1000);
INSERT INTO products_13_lab (product_name, price) VALUES ('값 부족');
INSERT INTO products_13_lab (product_name, category, price)
VALUES (NULL, '문구', 1000);
| Essai | Résultat attendu | Correction à envisager |
|---|---|---|
| Identifiant 1 déjà présent | Erreur 1062, doublon de clé primaire. | Pour un nouveau produit, omettre le numéro afin de le laisser générer. |
| Deux colonnes, une valeur | Erreur 1136, nombre de valeurs incorrect. | Faire correspondre chaque colonne à sa valeur, dans l’ordre. |
| Nom de produit NULL | Erreur 1048, colonne qui ne peut pas être NULL. | Fournir un nom conforme aux règles de l’application. |
Après chacun de ces rejets, exécutez SELECT COUNT(*) FROM products_13_lab; : le résultat doit rester 6. Un message d’erreur explique pourquoi l’instruction a été refusée ; il ne suffit pas de le supprimer pour que les données deviennent correctes. Ne remplacez pas l’instruction par INSERT IGNORE ou REPLACE pour faire disparaître le problème : leur traitement des conflits et leurs effets sur les données sont différents.
Le comportement d’un fichier qui rencontre une erreur dépend aussi des options du client : des instructions suivantes peuvent ne pas être exécutées. En séparant préparation valide et erreurs volontaires, vous savez quel résultat appartient à chaque essai et vous pouvez vérifier l’état réel avant de continuer.
Consulter les avertissements et recommencer proprement
Les valeurs de prix et de stock de l’exemple respectent leurs types et leurs contraintes. Pour une valeur incorrecte ou hors plage, le mode SQL peut influencer la différence entre rejet et conversion accompagnée d’un avertissement. Si le client signale un avertissement, exécutez SHOW WARNINGS; juste après l’instruction concernée, avant qu’une autre opération ne remplace les informations utiles.
Un INSERT contenant plusieurs lignes réduit les échanges avec le serveur par rapport à une succession d’INSERT individuels. Il reste cependant soumis aux limites de taille des instructions et des communications. Importer un gros fichier demande aussi de vérifier son format, son encodage et les erreurs ; l’exemple de cinq lignes ne constitue pas une procédure complète d’importation en masse.
Pour repartir de zéro, contrôlez SELECT DATABASE();, SHOW CREATE TABLE products_13_lab; et les lignes présentes. Conservez une sauvegarde de toute donnée utile. Si cette table contient uniquement les données jetables de cet exercice, supprimez-la avec la commande ciblée suivante :
DROP TABLE shopcourse.products_13_lab;
DROP TABLE enlève la définition et les lignes ; un simple ROLLBACK ne peut pas annuler cette suppression. Gardez donc cette opération hors de l’essai transactionnel précédent. La commande ne supprime pas shopcourse.products. Vous pouvez ensuite relancer le fichier de préparation complet et vérifier à nouveau les deux nombres 1 et 5, puis les six lignes enregistrées.




