♻️ Rendre un script SQL rejouable

Ce que « rejouable » veut dire

Un script est rejouable — on dit aussi idempotent — lorsque l'exécuter deux fois laisse la base dans le même état que l'exécuter une fois. C'est ce qu'exige tout déploiement sérieux : un import interrompu doit pouvoir être relancé sans devoir d'abord réparer à la main ce que la première tentative a déjà écrit.

Les scripts produits par phpMyAdmin ou mysqldump ne le sont pas. Ils supposent une base vide. Relancés sur une base déjà remplie, ils échouent sur le premier CREATE TABLE, ou pire, dupliquent silencieusement des lignes.

Ce que l'outil transforme

• CREATE TABLE, CREATE DATABASE, CREATE INDEX → ajout de IF NOT EXISTS
• DROP de toute nature → ajout de IF EXISTS
• CREATE VIEW → CREATE OR REPLACE VIEW
• Procédures, fonctions et déclencheurs → précédés d'un DROP … IF EXISTS
• ALTER TABLE à clauses multiples → éclaté en instructions séparées, chacune protégée
• INSERT → conditionné sur la clé primaire ou une contrainte unique lue dans le fichier

La limite, dite franchement

Rendre un INSERT rejouable suppose de savoir ce qui identifie une ligne. Aucune analyse du texte ne peut le deviner : « la même ligne » est une notion métier, pas grammaticale. L'outil s'en tire parce qu'un export contient presque toujours la réponse — le CREATE TABLE et la clé primaire voyagent avec les données.

Quand la clé reste introuvable, ou qu'elle est auto-incrémentée et absente des valeurs insérées, l'instruction est recopiée telle quelle et signalée « à reprendre ». Un INSERT transformé sur une mauvaise clé écraserait des données : mieux vaut échouer visiblement que deviner.

Les trois stratégies d'insertion

N'insérer que si la ligne est absente — l'option par défaut. Elle produit un INSERT … SELECT … WHERE NOT EXISTS. Son avantage : elle ne réclame aucun index unique en base, seulement une colonne sur laquelle tester. Elle fonctionne donc même sur une table dont la contrainte n'a pas encore été créée.

INSERT INTO clients (id, nom)
SELECT 1 AS id, 'Dupont' AS nom FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM clients WHERE clients.id = 1);

INSERT IGNORE — plus court, mais il exige une contrainte unique réellement déclarée, et il fait taire au passage les troncatures de données et les violations de clé étrangère. Une erreur réelle passe alors inaperçue.

Insérer ou mettre à jour — ajoute un ON DUPLICATE KEY UPDATE. Le rejeu écrase les valeurs existantes : c'est ce qu'on veut pour un jeu de référence, c'est gênant si la ligne a pu être modifiée depuis.

Questions fréquentes