Cours MariaDB / Définir et vérifier une table avec CREATE TABLE

CREATE TABLE crée une table en définissant ses colonnes, leurs types, leurs contraintes et leurs clés. Pour vérifier que la création correspond réellement au besoin, examinez ensuite les colonnes avec DESCRIBE, la déclaration avec SHOW CREATE TABLE et les valeurs d’une première ligne enregistrée.

Choisir le rôle de chaque colonne

Le schéma désigne ici la définition de la structure des données. Une ligne représente un produit ; l’identifiant, le nom, la catégorie, le prix et le stock occupent des colonnes distinctes. Les réunir dans un seul texte obligerait à découper ce texte pour calculer un montant, trier des prix ou contrôler les valeurs.

Information Définition choisie Justification
Identifiant product_id INT, clé primaire, AUTO_INCREMENT Distinguer les lignes, même si les noms sont identiques
Nom product_name VARCHAR(100) NOT NULL Conserver un texte de longueur variable sans valeur NULL
Catégorie category VARCHAR(30) NOT NULL Enregistrer un libellé simple
Prix price DECIMAL(10,2) NOT NULL Stocker un montant décimal exact à deux décimales
Stock stock INT NOT NULL DEFAULT 0 Utiliser zéro si la colonne est omise à l’insertion

Les limites de 100 et 30 caractères sont des choix d’exercice, pas une règle valable pour tous les catalogues. Déterminez les longueurs à partir des saisies attendues et des règles du service. NOT NULL interdit le marqueur de valeur manquante ; il n’interdit pas à lui seul une chaîne vide.

DECIMAL(10,2) réserve dix chiffres au total, dont deux après la virgule. Le type INT choisi pour le stock est signé : sélectionner ce type ne suffit pas à interdire les quantités négatives. Une règle métier de ce genre demande une validation supplémentaire, par exemple une contrainte CHECK adaptée. Définissez séparément le type, la valeur par défaut et les conditions autorisées.

Vérifier la connexion et le nom de la table

Utilisez une instance d’apprentissage, avec la base shopcourse et le compte course_user préparés dans les cours précédents. Ce compte doit pouvoir créer une table, insérer et lire ses données dans cette base. Le cours sur le client en ligne de commande et les fichiers SQL explique la connexion et la commande SOURCE. Saisissez les commandes suivantes dans le client MariaDB, et non dans PowerShell ou le terminal du système :

SELECT VERSION() AS server_version, DATABASE() AS selected_database;
USE shopcourse;
SELECT DATABASE() AS selected_database;

La première ligne de résultat indique la version et la base éventuellement sélectionnée au départ ; NULL est possible dans une nouvelle session. Après USE, la base sélectionnée doit être shopcourse. Si elle n’existe pas, terminez d’abord le cours pour créer et vérifier la base de travail.

Conservez la table products du premier exercice de création et de lecture de produits. Nous utilisons ici un nom distinct, products_schema_lab. Vérifiez sa disponibilité dans la même session :

SHOW TABLES LIKE 'products_schema_lab';

Avant la première création, le résultat doit être vide. Si la table existe déjà, examinez sa définition et ses données avant de décider de la réinitialiser. Les caractères _ ont un sens de joker dans un motif LIKE : si un autre nom proche apparaît, comparez le nom retourné exactement avec celui de la table prévue.

Utilisez les minuscules et les traits de soulignement de manière cohérente et évitez les mots réservés. Cette convention réduit les confusions liées au traitement des noms selon le système et les réglages du serveur. Les noms de tables ne sont pas des valeurs textuelles : les apostrophes de l’exemple entourent les valeurs du produit.

Exécuter un exemple complet de CREATE TABLE

Enregistrez ce bloc dans un fichier UTF-8 lesson07-create-table.sql, puis lancez-le avec SOURCE suivi de son chemin local réel, selon les instructions du client. Vous pouvez aussi saisir chaque instruction dans l’ordre. Conservez tous les points-virgules et n’incluez pas les essais d’erreur dans ce fichier initial.

USE shopcourse;
CREATE TABLE products_schema_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,
  PRIMARY KEY (product_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
INSERT INTO products_schema_lab (product_name, category, price)
VALUES ('Notebook', 'Stationery', 3500.00);
SHOW TABLES LIKE 'products_schema_lab';
DESCRIBE products_schema_lab;
SHOW CREATE TABLE products_schema_lab;
SELECT product_id, product_name, price, stock FROM products_schema_lab;

Dans les parenthèses de CREATE TABLE, les virgules séparent les définitions et les contraintes. Aucune virgule ne doit suivre la dernière définition. PRIMARY KEY (product_id) impose une clé pour identifier les lignes ; AUTO_INCREMENT génère un identifiant lorsque sa valeur est omise à l’insertion. L’unicité de l’identifiant n’empêche pas deux produits d’avoir le même nom.

Le moteur de stockage est le composant qui enregistre et traite les données de la table. L’exemple choisit explicitement InnoDB, qui permet notamment l’utilisation de transactions. Le jeu de caractères utf8mb4 et la collation utf8mb4_unicode_ci rendent les paramètres du texte explicites ; cette collation d’exemple n’est pas présentée comme le meilleur choix pour toutes les règles de recherche.

L’insertion fournit le nom, la catégorie et le prix. Le serveur génère l’identifiant et applique le stock par défaut, égal à zéro. Les valeurs Notebook et Stationery signifient respectivement carnet et papeterie ; elles sont conservées pour reproduire exactement le fichier et son résultat. Le prix est fictif et utilise le point comme séparateur décimal SQL.

Lire la définition et contrôler la première ligne

Le fichier exécute déjà les contrôles de structure et la lecture du produit. Ne vous arrêtez pas au message de succès de la création : l’insertion peut échouer indépendamment. Vérifiez les éléments suivants :

Commande Résultat à examiner
SHOW TABLES Le nom products_schema_lab apparaît
DESCRIBE Cinq colonnes ; product_id avec PRI et auto_increment ; stock avec Default égal à 0
SHOW CREATE TABLE Déclaration des colonnes, clé primaire, moteur InnoDB et paramètres utf8mb4
SELECT product_id : 1 ; product_name : Notebook ; price : 3500.00 ; stock : 0

L’identifiant 1 suppose une table neuve et les paramètres usuels d’auto-incrémentation. Une table déjà utilisée ou une configuration différente peut donner un autre numéro. Dans DESCRIBE, les colonnes de résultat Field, Type, Null, Key, Default et Extra décrivent les propriétés des colonnes de votre table. La référence DESCRIBE détaille ce rôle.

Le serveur peut afficher un entier sous la forme int(11). Ce nombre n’indique ni la limite maximale de l’entier ni sa taille en octets. La présentation normalisée peut changer avec la version et le mode SQL : comparez la signification des propriétés, sans exiger un affichage identique caractère par caractère.

SHOW CREATE TABLE fournit la déclaration de création ; certains détails affichés dépendent du mode SQL. Ce résultat ne constitue pas une sauvegarde des lignes et ne remplace pas toutes les métadonnées internes du moteur. Consultez la documentation SHOW CREATE TABLE pour interpréter ses limites.

Comprendre ce que conserve IF NOT EXISTS

Une seconde création sous le même nom provoque normalement l’erreur Table already exists. IF NOT EXISTS évite cette erreur en conservant la table présente ; il ne compare pas ses colonnes avec celles de la nouvelle déclaration pour les transformer automatiquement. Après l’exemple initial, lancez séparément :

CREATE TABLE IF NOT EXISTS products_schema_lab (only_column INT);
SHOW WARNINGS;
DESCRIBE products_schema_lab;

SHOW WARNINGS doit signaler que la table existe déjà, généralement avec la note 1050. DESCRIBE affiche toujours les cinq colonnes du produit : aucune colonne only_column n’a été créée. Le produit enregistré reste également présent. Ne rejouez pas le fichier complet pour cet essai, car il contient aussi une insertion.

Pour une modification réelle de structure, préparez une migration, par exemple avec ALTER TABLE, en tenant compte des données existantes. CREATE OR REPLACE TABLE peut supprimer la table existante avant sa recréation : ce n’est pas une solution anodine à une erreur de nom déjà utilisé. La référence CREATE TABLE décrit ces variantes.

Diagnostiquer les erreurs et recommencer

Symptôme Vérification
No database selected Exécuter USE shopcourse dans cette connexion et vérifier DATABASE()
Table already exists Examiner la définition et les lignes de la table existante
Erreur de syntaxe Contrôler les virgules, les parenthèses et les points-virgules
Erreur de permission Vérifier le compte, l’hôte, le port et les droits sur shopcourse

Si une erreur interrompt le fichier, inspectez ce qui a déjà été exécuté avant de recommencer. L’option de connexion --abort-source-on-error arrête la lecture d’un fichier sur erreur ; elle ne supprime pas une table déjà créée et n’annule pas une insertion antérieure.

Pour reprendre l’exercice depuis le début, confirmez avec SELECT DATABASE(); la connexion de travail, puis avec SHOW CREATE TABLE shopcourse.products_schema_lab; et une lecture des lignes que la cible est bien cette table d’apprentissage. Sauvegardez les données à conserver. Seulement après ces vérifications, exécutez :

DROP TABLE shopcourse.products_schema_lab;

Cette instruction supprime uniquement shopcourse.products_schema_lab, avec sa définition et ses lignes. La table products reste en dehors de cette réinitialisation. Pour cette table ordinaire, DROP TABLE entraîne une validation implicite et un ROLLBACK ne restaure pas les données supprimées ; la référence sur les instructions entraînant un commit implicite précise les exceptions, notamment les tables temporaires.

Relancez ensuite une seule fois le fichier complet. Vous devez retrouver les cinq colonnes et la ligne Notebook avec le stock par défaut égal à zéro. Vous pouvez répéter l’essai IF NOT EXISTS pour vérifier à nouveau que la structure et cette ligne sont conservées.