Cours MariaDB / Créer et sélectionner une base avec CREATE DATABASE, USE et utf8mb4

CREATE DATABASE crée une base de données, tandis que USE choisit la base par défaut de la connexion en cours. Pour les exercices, indiquez explicitement utf8mb4 et une collation adaptée, puis contrôlez les réglages réellement enregistrés : IF NOT EXISTS ne met pas à jour les valeurs par défaut d’une base existante.

Vérifier le compte d’exercice et son périmètre

Connectez-vous avec course_user en suivant la procédure du client en ligne de commande et des fichiers SQL. Les guides d’installation accordent à ce compte des privilèges sur shopcourse.*. Ce périmètre lui permet de créer et d’utiliser la base d’exercice sans recevoir le droit de créer n’importe quelle autre base du serveur.

Conservez le nom shopcourse dans le cours. Si vous choisissez un autre nom, les autorisations et les exemples SQL qui l’emploient doivent être adaptés ensemble. N’utilisez pas une base système telle que mysql pour vos tables d’apprentissage. Avant de créer quoi que ce soit, vérifiez le compte authentifié et ses autorisations dans le client :

SELECT CURRENT_USER() AS privilege_account;
SHOW GRANTS;

Le compte attendu est course_user@127.0.0.1. Une valeur différente peut indiquer une connexion avec un autre utilisateur ou une autre règle d’hôte. Dans SHOW GRANTS, recherchez les droits sur shopcourse.*. Une ligne USAGE ON *.* n’est pas, à elle seule, un octroi de privilèges sur toutes les bases. Si les droits attendus manquent, revenez à la création du compte dans le guide Windows ou le guide Ubuntu, plutôt que de travailler systématiquement avec root.

Créer shopcourse et inspecter les réglages enregistrés

Enregistrez l’exemple complet dans un fichier texte UTF-8 nommé lesson05-create-database.sql, ou saisissez les instructions dans cet ordre à l’intérieur du client connecté :

CREATE DATABASE IF NOT EXISTS shopcourse
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

SHOW WARNINGS;
USE shopcourse;
SELECT DATABASE() AS current_database;
SHOW CREATE DATABASE shopcourse;

SELECT SCHEMA_NAME, DEFAULT_CHARACTER_SET_NAME, DEFAULT_COLLATION_NAME
FROM information_schema.SCHEMATA
WHERE SCHEMA_NAME = 'shopcourse';

Si vous utilisez un fichier, exécutez-le avec SOURCE et son véritable chemin sur le poste du client. Par exemple, un fichier enregistré dans C:\mariadb-course\ se lance avec SOURCE C:/mariadb-course/lesson05-create-database.sql;. Sous Ubuntu, utilisez votre chemin réel, par exemple SOURCE /home/yourname/mariadb-course/lesson05-create-database.sql; après avoir remplacé yourname. Ces chemins sont des alternatives, pas deux commandes à exécuter successivement.

Sur une base nouvellement créée, SELECT DATABASE() doit renvoyer shopcourse. La requête sur les schémas doit ensuite afficher les trois valeurs suivantes :

SCHEMA_NAME DEFAULT_CHARACTER_SET_NAME DEFAULT_COLLATION_NAME
shopcourse utf8mb4 utf8mb4_unicode_ci

SHOW WARNINGS doit suivre immédiatement l’instruction dont vous voulez lire les messages. Ne déplacez pas ce contrôle après une série de requêtes sans rapport. SHOW CREATE DATABASE montre la définition enregistrée par le serveur ; la mise en forme, les guillemets et les commentaires de version affichés peuvent varier. La ligne de la table information_schema.SCHEMATA permet de contrôler les valeurs indépendamment de cette présentation.

Ce script crée le conteneur de la base ; il ne crée pas encore la table products. Les références CREATE DATABASE et SHOW CREATE DATABASE précisent la création et la consultation de la définition.

Comprendre ce que fait IF NOT EXISTS

Quand la base existe déjà, IF NOT EXISTS évite l’erreur « base déjà existante », conserve la base en place et signale cette situation par un message que SHOW WARNINGS permet de lire. Cette clause ne vide pas les données et ne remplace ni le jeu de caractères ni la collation déjà définis.

Si le premier lancement a créé une base neuve, relancez le même fichier : les réglages doivent rester identiques et le message indique que la base existe. Si shopcourse existait avant l’exercice avec d’autres réglages, ceux-ci peuvent au contraire rester différents des valeurs demandées dans le script. Une commande terminée sans erreur bloquante ne prouve donc pas que la définition demandée vient d’être appliquée.

Examinez l’existant avant de décider d’une modification. N’utilisez pas DROP DATABASE pour forcer la sortie d’un exercice à correspondre à une illustration. Si des tables utiles existent, préservez-les et examinez leurs définitions. Le besoin de modifier une valeur par défaut et le besoin de convertir des colonnes déjà remplies sont deux opérations distinctes.

Distinguer jeu de caractères, collation et connexion

Un jeu de caractères définit la représentation des caractères ; une collation définit les règles de comparaison et de tri des chaînes. utf8mb4 permet de représenter les caractères UTF-8 qui nécessitent jusqu’à quatre octets. Le nom plus court utf8 a historiquement servi d’alias dont le comportement dépend de la version et de la configuration : utilisez le nom explicite dans ces exercices.

Réglage Rôle
Valeurs par défaut de la base Valeurs reprises par les tables créées ensuite lorsqu’elles ne les redéfinissent pas.
Définition de la table ou de la colonne Règles effectivement indiquées ou héritées pour le texte stocké.
Jeu de caractères de connexion Réglages de l’échange de texte entre le client et le serveur.
Collation Règles employées par une comparaison ou un tri de texte.

Le cours choisit utf8mb4_unicode_ci comme exemple largement disponible. Cela ne signifie pas qu’il s’agit de la collation la plus récente ou de la valeur par défaut de toutes les versions. La documentation des jeux de caractères et des collations explique les niveaux de configuration et leur héritage.

Pour observer une différence précise de comparaison, exécutez l’exemple suivant dans le client :

SELECT
  _utf8mb4'A' COLLATE utf8mb4_unicode_ci =
  _utf8mb4'a' COLLATE utf8mb4_unicode_ci AS case_insensitive,
  _utf8mb4'A' COLLATE utf8mb4_bin =
  _utf8mb4'a' COLLATE utf8mb4_bin AS binary_comparison;
case_insensitive binary_comparison
1 0

1 signifie que la comparaison est vraie et 0 qu’elle est fausse. Ici, la collation insensible à la casse considère les lettres ASCII A et a comme égales ; la collation binaire les distingue. Le préfixe _utf8mb4 fixe le jeu de caractères de ces littéraux et COLLATE choisit la règle pour la comparaison. Ce petit test ne change pas la collation de la base et ne décrit pas toutes les règles de tri d’une langue.

Choisissez une collation selon les comparaisons que l’application doit effectuer. Ne concluez pas qu’un changement du client en utf8mb4 modifie automatiquement les définitions de toutes les colonnes : l’encodage de connexion et les règles du texte stocké se contrôlent séparément.

Sélectionner la base pour la connexion courante

Dans le client, sélectionnez la base et contrôlez le résultat ainsi que les tables présentes :

USE shopcourse;
SELECT DATABASE() AS current_database;
SHOW TABLES;

USE choisit la base par défaut de cette connexion uniquement. Ce choix reste valable pour les instructions suivantes dans cette connexion, mais ne fixe pas une base permanente pour tous les clients ou les connexions futures. La référence de USE décrit cette portée de session.

Dans une base neuve, SHOW TABLES renvoie un ensemble vide puisque le script de création de base n’a défini aucune table. Ce résultat est normal. Si des tables apparaissent, examinez-les : la base n’était peut-être pas vide avant cet exercice. Il ne faut pas les supprimer pour reproduire artificiellement un ensemble vide.

Une fois la table créée, un nom qualifié comme shopcourse.products indique explicitement la base et la table. Le nom court products dépend au contraire de la base sélectionnée. Vous pouvez ainsi comprendre pourquoi une connexion réussie peut encore produire « No database selected » lorsqu’une instruction utilise un nom non qualifié sans USE préalable.

Diagnostiquer les droits, la sélection et les réglages de texte

  • Création refusée : contrôlez CURRENT_USER() et SHOW GRANTS, puis le périmètre de base autorisé pour ce compte.
  • Unknown database : vérifiez le nom exact de la base et le serveur réellement ciblé par l’adresse et le port de connexion.
  • No database selected : exécutez USE shopcourse avant un nom de table non qualifié, ou utilisez un nom qualifié approprié.
  • Collation inattendue : inspectez une base existante ; IF NOT EXISTS ne réécrit pas ses valeurs par défaut.
  • Texte incorrect : vérifiez le fichier source, les réglages de connexion et les définitions réelles des tables et colonnes.

Modifier les valeurs par défaut d’une base ne convertit pas les colonnes de texte déjà présentes dans ses tables. Avant de changer une définition, conservez la définition d’origine et évaluez séparément la conversion de table ou de colonne éventuellement nécessaire. La référence de ALTER DATABASE décrit les caractéristiques modifiables au niveau de la base.

Il n’est pas nécessaire de supprimer une base pour diagnostiquer un problème de connexion ou de sélection. Relevez les réglages actuels, identifiez le niveau responsable du problème et ne modifiez que ce qui est nécessaire, en conservant les données et les définitions qui doivent rester en place.