Module 2.2 · Microressource 3

Créer une table et choisir les types de champs

Outil 15 min
Objectif pédagogique

Concevoir une table adaptée aux données.

La base formation existe, mais elle est vide. Nous allons y créer la table utilisateurs et la remplir de données de test. Le travail d'écriture reviendra à Claude Code — le vôtre, et c'est le plus important, consiste à décider de la forme et à vérifier le résultat.

1. Pourquoi le type d'une colonne compte

Créer une table, c'est déclarer ses colonnes. Et pour chacune, MySQL demande une chose que le tableur ne demande jamais : quel genre de valeur y mettra-t-on ? Un nombre, du texte court, du texte long, une date.

Ce n'est pas une formalité. Le type conditionne trois choses :

  • Ce que la base accepte

    Une colonne déclarée « nombre » refusera du texte. C'est la promesse faite à la microressource 1 : la base refuse les données incohérentes, là où le tableur avale tout.

  • Le classement

    Des nombres se trient 2, 10, 100. Les mêmes valeurs rangées en texte se trient 10, 100, 2 — parce que « 1 » vient avant « 2 ». Une erreur de type se paie au moment du tri, souvent des mois plus tard.

  • La place occupée

    Réserver 255 caractères pour un rôle qui en fait neuf, multiplié par des milliers de lignes, finit par peser. On choisit au plus juste, sans être à l'étroit.

2. Les quatre types qui suffisent

MySQL en propose des dizaines. Quatre couvrent l'immense majorité des besoins, et vous n'aurez pas besoin des autres dans cette formation.

TypePour quoiExemple
INTUn nombre entier : un identifiant, une durée, un nombre de places42
VARCHAR(n)Du texte court, dont on annonce la longueur maximale nClaire Durand
TEXTDu texte long, sans limite à annoncer : une description, un commentaireun paragraphe entier
DATEUne date, au format AAAA-MM-JJ2026-09-22
VARCHAR ou TEXT ? La question revient toujours. VARCHAR dès qu'on peut estimer une longueur maximale raisonnable — un nom, un code, un titre. TEXT quand on ne peut pas, ou quand le contenu se compte en paragraphes. Dans le doute pour un champ court : VARCHAR.

3. Notre table, colonne par colonne

Reprenons les quatre colonnes annoncées à la microressource précédente, et décidons de chaque type avant de demander quoi que ce soit. C'est la partie qui vous revient : Claude Code écrira le code, mais il ne peut pas décider de la forme de vos données à votre place.

ColonneType retenuPourquoi
id INT, clé primaire, auto-incrémenté Un numéro que MySQL attribue tout seul, jamais deux fois le même
nom VARCHAR(100) Du texte court ; 100 caractères laissent de la marge pour un nom composé
code VARCHAR(50) Court et de longueur connue ; c'est du texte, jamais un nombre
role VARCHAR(20) Deux valeurs possibles, formateur ou apprenant

Deux mots sur id, la seule colonne un peu particulière. Auto-incrémenté signifie que vous ne le remplirez jamais : à chaque nouvelle ligne, MySQL prend le dernier numéro utilisé et ajoute 1. Clé primaire signifie que la base garantit son unicité — elle refusera deux lignes portant le même id.

Pour aller plus loin, si le cœur vous en dit Le type ENUM('formateur','apprenant') ferait mieux que VARCHAR(20) : la base refuserait alors toute autre valeur, y compris une faute de frappe comme « formatuer ». Nous restons sur VARCHAR, plus simple et plus souple si un troisième rôle apparaît un jour.

4. Faire écrire le SQL à Claude Code

Les décisions sont prises ; la traduction en code est une corvée d'écriture. Ouvrez votre projet dans VS Code et copiez cette demande :

Écris un fichier utilisateurs.sql pour MySQL. Il doit créer une table utilisateurs avec exactement quatre colonnes : id (entier, clé primaire, auto-incrémenté), nom (texte court, 100 caractères), code (texte court, 50 caractères), role (texte court, 20 caractères). N'ajoute aucune autre colonne. Ajoute ensuite six lignes de test : un formateur et cinq apprenants, avec des noms français et des codes sur le modèle Prenom@ADIUT75. Commente chaque partie en français. Ne te connecte à aucune base : produis seulement le fichier.

Vous obtiendrez un fichier de cette forme :

utilisateurs.sql
-- création de la table
CREATE TABLE utilisateurs (
  id    INT AUTO_INCREMENT PRIMARY KEY,
  nom   VARCHAR(100) NOT NULL,
  code  VARCHAR(50)  NOT NULL,
  role  VARCHAR(20)  NOT NULL
);

-- données de test
INSERT INTO utilisateurs (nom, code, role) VALUES
  ('Claire Durand',  'Claire@ADIUT75',  'formateur'),
  ('Marc Lefèvre',   'Marc@ADIUT75',    'apprenant'),
  ('Sofia Benali',   'Sofia@ADIUT75',   'apprenant'),
  ('Thomas Roy',     'Thomas@ADIUT75',  'apprenant'),
  ('Inès Martin',    'Ines@ADIUT75',    'apprenant'),
  ('Hugo Petit',     'Hugo@ADIUT75',    'apprenant');
Remarquez ce qui n'est pas là La ligne INSERT ne mentionne pas id, et aucune valeur n'est fournie pour lui. C'est normal : il est auto-incrémenté, MySQL le remplira seul. Vos six lignes porteront les numéros 1 à 6.

5. Exécuter, relire, vérifier

  1. Sélectionner la base d'abord

    Dans phpMyAdmin, cliquez sur formation dans la colonne de gauche avant d'aller plus loin. Sans cela, l'exécution échouera avec un « aucune base sélectionnée » — l'erreur la plus fréquente du débutant.

  2. Coller et exécuter

    Ouvrez l'onglet SQL, collez le contenu du fichier, cliquez sur Exécuter. Deux messages verts s'affichent : la table créée, puis les six lignes insérées.

  3. Vérifier la forme

    Onglet Structure : quatre colonnes, les bons types, et une clé sur id. C'est le plan de votre table, tel que vous l'aviez décidé.

  4. Vérifier le contenu

    Onglet Parcourir : six lignes, numérotées de 1 à 6, avec un formateur et cinq apprenants. Les accents de « Lefèvre » et « Inès » doivent s'afficher correctement — si ce n'est pas le cas, l'interclassement de la base n'est pas en utf8mb4.

Relisez le SQL avant de l'exécuter La règle posée depuis le module 1.1 ne change pas ici, et elle compte davantage : une commande SQL agit sur des données, et certaines sont irréversibles. Vérifiez au minimum qu'il n'y a que les quatre colonnes demandées, et qu'aucune instruction DROP — qui supprime — ne s'est glissée dans le fichier.
Ce qu'il faut avoir compris
  • Chaque colonne a un type : il décide de ce que la base accepte, du tri et de la place.
  • Quatre types suffisent : INT, VARCHAR(n), TEXT, DATE.
  • La clé primaire auto-incrémentée se remplit toute seule : on ne l'écrit jamais.
  • C'est vous qui décidez de la forme ; l'assistant ne fait que l'écrire.
  • Toujours sélectionner la base avant d'exécuter du SQL dans phpMyAdmin.
Et maintenant

Votre table est créée et peuplée. La microressource suivante apprend à l'interroger : retrouver une personne, filtrer sur un rôle, trier une liste.

Microressource 4 — Requêtes SQL de base →