EngineeringMigrations de données

Migrations de données

Faire évoluer la mémoire canonique sans indisponibilité ni perte de provenance.

Principe

Les migrations sont des opérations produit, pas seulement SQL.

Une migration peut affecter :

  • tables ;
  • index vectoriels ;
  • blobs ;
  • relations ;
  • scores ;
  • embeddings ;
  • schemas d’Espaces ;
  • Context Packs ;
  • coûts CU.

Pattern recommandé

Expand → Backfill → Verify → Switch → Contract

Expand

Ajouter les nouvelles structures sans casser les lecteurs existants.

Backfill

Migrer par lots, avec checkpoints et idempotence.

Verify

Comparer compteurs, checksums, invariants et échantillons.

Switch

Basculer les lectures/écritures.

Contract

Supprimer l’ancien format seulement après stabilité observée.

Rollback

Toute migration non triviale doit documenter ce qui est réversible et ce qui ne l’est pas.