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 :
- 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é. - Approuver : pour la production, une porte d'approbation d'environnement dans le pipeline.
- 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). - 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.
- 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
- Statut bloqué sur « en cours ». Si l'exécuteur plante entre « en cours » et « exécuté », l'élément reste en cours pour toujours. Décider ce que fait un run de ces éléments, et les surveiller.
- Erreurs qui ne lèvent pas d'exception. Certaines erreurs SQL (violation de contrainte dans un lot) sont signalées sans arrêter l'appel PowerShell. Utiliser
SET XACT_ABORT ON, lire la sortie et faire échouer le run à toute ligne d'erreur. - Le script n'est pas validé par l'exécuteur. Si le seul contrôle est la relecture, elle doit être réelle. Ajouter des contrôles automatiques des motifs dangereux plutôt que d'espérer.
- Résolution de la cible. L'exécuteur déduit la base d'un identifiant de la demande ; un identifiant inconnu doit arrêter le run avant toute exécution.
- Grosses sorties. Limiter ce qui va dans le mail ; joindre le fichier complet et un court extrait.
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.