LLI Wiki — My Digital Knowledge Base

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 :

  1. Lire le catalogue de la source (tables, colonnes, clés primaires, index, clés étrangères).
  2. Traduire en CREATE TABLE MySQL.
  3. Désactiver les contrôles de clés étrangères, supprimer et recréer les tables avec seulement la clé primaire.
  4. Charger les données table par table.
  5. 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.
  6. 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 :

-- 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

Mastodon LLIMastodon SocialFosstodon