LLI Wiki — My Digital Knowledge Base

Corriger des données en production par un processus contrôlé

Scripts dans git, relecture, pipeline qui exécute en transaction avec contrôle du nombre de lignes, sortie conservée, jamais à la main depuis un portable.

Tout DBA connaît la situation : une correction de données est nécessaire en production, le script fait dix lignes, et le plus rapide est de le coller dans une fenêtre de requête depuis un portable. C'est exactement comme cela qu'un WHERE oublié finit dans un rapport d'incident. J'ai déplacé les corrections de données vers un processus contrôlé : le script est relu dans git, un pipeline l'exécute avec la même identité et les mêmes garde-fous à chaque fois, et la sortie est conservée.

La règle

Personne n'exécute une correction à la main sur la production. Une correction est un fichier dans un dépôt. Elle passe par une pull request, est approuvée par quelqu'un d'autre, et seul le pipeline (ou un exécuteur planifié) la lance.

flowchart LR
    A["Script dans git (branche)"] --> B["Pull request + revue"]
    B --> C["Fusion dans main"]
    C --> D["Pipeline : validation"]
    D --> E["Approbation manuelle (production)"]
    E --> F["Exécuteur : exécution en transaction"]
    F --> G{"Nombre de lignes attendu ?"}
    G -->|"oui"| H["COMMIT"]
    G -->|"non"| I["ROLLBACK"]
    H --> J["Sortie sauvegardée en artefact"]
    I --> J
    J --> K["Rapport"]

À quoi ressemble un script de correction

J'impose une forme fixe pour qu'un relecteur le lise en une minute : un en-tête avec l'objectif et le nombre de lignes attendu, puis la modification, qui refuse de valider si le compte est faux.

-- Objectif : remettre le statut des lignes bloquées en 'PENDING' depuis le bug d'import
-- Lignes attendues : 42
SET XACT_ABORT ON;
BEGIN TRANSACTION;

UPDATE dbo.Orders
SET    Status = 'NEW'
WHERE  Status = 'PENDING'
  AND  ImportBatchId = 1234;

DECLARE @n int = @@ROWCOUNT;
IF @n <> 42
BEGIN
    ROLLBACK TRANSACTION;
    THROW 50001, 'Nombre de lignes inattendu', 1;
END

COMMIT TRANSACTION;

Attention : @@ROWCOUNT est remis à zéro par chaque instruction, donc on le copie dans une variable juste après l'UPDATE. L'idée reste la même : le script lui-même refuse de valider quand le compte est mauvais.

Le pipeline

L'exécuteur fait ce que l'auteur ne doit pas oublier de faire :

  1. Valider : le fichier est dans le bon dossier, la convention de nommage est respectée, l'encodage est correct, aucune instruction interdite (par exemple DROP, TRUNCATE) sauf si le fichier est explicitement marqué.
  2. Approuver : pour la production, une porte d'approbation d'environnement dans le pipeline.
  3. Exécuter avec une identité managée ou un principal de service, pas le compte d'une personne, via Invoke-Sqlcmd. L'exécuteur peut aussi envelopper le script dans sa propre transaction si le fichier n'en gère pas, avec un délai maximal et un arrêt à la première erreur (-ErrorAction Stop, SET XACT_ABORT ON).
  4. Capturer toute la sortie (messages, lignes affectées, erreurs) dans un fichier texte, publié comme artefact de pipeline ou déposé là où le demandeur peut le lire.
  5. Rapporter : un mail avec statut, durée et fichier de sortie. Un script en échec ne se termine jamais en silence.
$result = Invoke-Sqlcmd -ServerInstance $server -Database $db -AccessToken $token `
            -InputFile $scriptPath -QueryTimeout 600 -Verbose 4>&1
$result | Out-File -FilePath $outputPath -Encoding utf8

File d'attente ou déclencheur de pipeline

Deux conceptions fonctionnent. Dans la première, la correction est demandée depuis un outil de tickets ou de livraison et arrive dans une file ; un exécuteur planifié prend le script suivant, le marque « en cours », l'exécute, envoie la sortie, le marque « exécuté ». Dans la seconde, la fusion dans main déclenche le pipeline. Je préfère la file quand le demandeur n'est pas développeur, et le pipeline quand l'équipe vit déjà dans git.

Pièges

Retour d'expérience

Le gain n'est pas la vitesse, c'est la confiance. Chaque changement en production a un auteur, un relecteur, une approbation, une sortie et une date, et le même script peut être répété d'abord sur une copie restaurée. Les correctifs urgents restent possibles, ils passent simplement par le même chemin court.

Mastodon LLIMastodon SocialFosstodon