Déplacer des données d'Azure SQL vers Azure Database for MySQL Flexible Server
Conception en reconstruction complète, correspondance des types, chargement par lots, vérification et pièges d'une migration Azure SQL vers MySQL.
Alimenter un Azure Database for MySQL Flexible Server à partir d'une base Azure SQL est une migration hétérogène : les types, les collations et plusieurs objets n'ont pas d'équivalent exact. Voici l'approche « reconstruire à chaque exécution » que j'utilise pour des bases de référence consommées par des applications MySQL, avec le choix de conception, la correspondance des types et les pièges rencontrés.
Conception : supprimer et reconstruire
Chaque exécution supprime et recrée les tables cibles. La cible reflète ainsi fidèlement la source au moment du lancement, sans logique de synchronisation incrémentale à maintenir. C'est adapté à des volumes modérés et à des données qui se rechargent entièrement ; pour de gros volumes évolutifs, il faut un autre outil.
flowchart LR
A["Azure SQL Database"] --> B["Introspection du schéma"]
B --> C["Traduction en DDL MySQL"]
C --> D["DROP + CREATE (clé primaire seule)"]
A --> E["Lecture des données par lots"]
E --> F["Chargement (INSERT multi-lignes ou LOAD DATA)"]
D --> F
F --> G["Index secondaires + clés étrangères"]
G --> H["Vérification des comptages"]
I["Key Vault"] -.->|"identifiants"| F
Les étapes :
- Lire le catalogue de la source (tables, colonnes, clés primaires, index, clés étrangères).
- Traduire en
CREATE TABLEMySQL. - Désactiver les contrôles de clés étrangères, supprimer et recréer les tables avec seulement la clé primaire.
- Charger les données table par table.
- Créer ensuite les index secondaires et les clés étrangères (nettement plus rapide qu'avant le chargement), puis réactiver les contrôles.
- Vérifier et produire un rapport.
Correspondance des types
| SQL Server | MySQL | Remarque |
|---|---|---|
int, bigint, smallint |
INT, BIGINT, SMALLINT |
|
tinyint |
TINYINT UNSIGNED |
0 à 255 côté SQL Server |
bit |
TINYINT(1) |
|
decimal(p,s) |
DECIMAL(p,s) |
|
money |
DECIMAL(19,4) |
|
datetime2(n) |
DATETIME(n) |
|
nvarchar(n) |
VARCHAR(n) |
LONGTEXT si MAX |
uniqueidentifier |
CHAR(36) |
|
varbinary(max) |
LONGBLOB |
|
datetimeoffset |
DATETIME (UTC) ou VARCHAR |
Décalage perdu : à décider |
geography, hierarchyid, sql_variant |
pas d'équivalent direct | Approximation, avertissement |
Les identifiants MySQL sont limités à 64 caractères, il faut donc raccourcir les noms d'index de façon déterministe.
Chargement par lots
Deux chemins selon la taille de la table :
- Petites tables :
INSERTmulti-lignes paramétrés, par lots de quelques milliers de lignes. - Grosses tables : chargement en masse (
LOAD DATA LOCAL INFILE, ou la classe de copie en masse du pilote .NET MySqlConnector). Cela exige le paramètre serveurlocal_infile = ONsur le Flexible Server.
-- Côté MySQL : avant et après le chargement
SET FOREIGN_KEY_CHECKS = 0;
-- ... DROP / CREATE / chargement ...
ALTER TABLE `Orders` ADD INDEX `ix_Orders_1` (`CustomerId`);
ALTER TABLE `Orders` ADD CONSTRAINT `fk_Orders_Customer`
FOREIGN KEY (`CustomerId`) REFERENCES `Customer`(`CustomerId`);
SET FOREIGN_KEY_CHECKS = 1;
Les identifiants d'accès MySQL sont lus dans un coffre Key Vault au moment de l'exécution, jamais dans un fichier de configuration versionné. Le Flexible Server impose TLS.
Vérification
Le minimum : comptage de lignes table par table, source contre cible, avec un rapport. Pour les tables critiques, j'ajoute un agrégat (somme d'une colonne numérique, min/max d'une date) des deux côtés.
Pièges et retour d'expérience
- Collation : une collation insensible à la casse et aux accents côté MySQL peut fusionner silencieusement des clés qui ne diffèrent que par la casse ou l'accent (par exemple « Butgenbach » et « Bütgenbach »). Le chargement signale alors moins de lignes insérées que copiées. J'utilise une collation
utf8mb4sensible à la casse et aux accents pour ne jamais perdre de lignes. - Valeurs par défaut (
GETDATE(),NEWID()) : non portables, à recréer à la main. - Vues, procédures, déclencheurs, colonnes calculées : non migrés. Cette approche déplace des tables et leurs données, rien d'autre.
IDENTITYversAUTO_INCREMENT: seulement si la colonne est la clé primaire à colonne unique.- Précision des dates :
datetimede SQL Server a une granularité particulière ; choisir une précision fractionnaire explicite côté MySQL. - Pilote : choisir un pilote maintenu et testé ; le chargement en masse doit être vérifié sur la première exécution réelle (les booléens, notamment).
- Rejouabilité : comme tout est recréé, une exécution interrompue se relance simplement. C'est la principale vertu de cette conception.