Cosmos DB : les cinq niveaux de cohérence expliqués simplement
Strong, bounded staleness, session, consistent prefix et eventual, avec tableau comparatif, conseils pratiques et notions de distribution globale.
Chez SQL Server, la cohérence est « forte » par défaut : après un COMMIT, tout le monde voit la donnée (hors réplicas secondaires lisibles). Cosmos DB propose cinq niveaux de cohérence entre deux extrêmes, parce que la donnée est répliquée, y compris entre régions. Voici comment je les retiens, sans jargon.
Les cinq niveaux, du plus fort au plus faible
| Niveau | Ce que je comprends | Exemple parlant |
|---|---|---|
| Strong | On lit toujours la dernière écriture validée (linéarisabilité) | Solde bancaire |
| Bounded staleness | On peut lire du « retard », mais borné : au plus K versions ou T secondes | Tableau de bord quasi à jour entre régions |
| Session | Dans ma session : je lis mes propres écritures (read-your-writes) | Utilisateur qui modifie son profil |
| Consistent prefix | Jamais de lecture dans le désordre ; on peut être en retard | Fil d'événements ordonnés |
| Eventual | Aucune garantie d'ordre, on converge « un jour » | Compteurs de « likes » |
Quelques précisions de la doc :
- Session est le niveau le plus utilisé, en région unique comme en multi-régions. Il repose sur un session token renvoyé après chaque écriture et conservé par le client. Si le client est recréé, son cache de jetons est perdu et ses lectures se comportent comme en eventual jusqu'à de nouvelles écritures.
- Bounded staleness : le retard est borné entre régions (pas à l'intérieur d'une région). Les valeurs minimales de K et T sont de 10 écritures ou 5 secondes en région unique, et 100 000 écritures ou 300 secondes en multi-régions.
- Consistent prefix : les écritures groupées dans une transaction sont visibles ensemble.
- Le niveau se règle au niveau du compte (appliqué à toutes les bases et tous les conteneurs) et peut être assoupli pour une requête précise côté SDK. Redémarrer l'application après un changement de niveau par défaut.
Comparaison pratique
| Niveau | Lecture (quorum) | Coût RU des lectures | Perte de données possible en panne régionale (RPO), plusieurs régions, une région d'écriture |
|---|---|---|---|
| Strong | Minorité locale (2 réplicas) | x2 | 0 |
| Bounded staleness | Minorité locale (2 réplicas) | x2 | K et T |
| Session | Un réplica | x1 | moins de 15 min |
| Consistent prefix | Un réplica | x1 | moins de 15 min |
| Eventual | Un réplica | x1 | moins de 15 min |
Pour la même quantité de RU, le débit en lecture de strong et bounded staleness est la moitié des autres niveaux. La latence en lecture et en écriture est garantie sous 10 ms au 99e centile pour tous les niveaux, sauf strong sur un compte multi-régions où l'écriture dépend de la latence réseau entre les régions les plus éloignées.
Conseils pratiques
- Par défaut : Session. Cela couvre la plupart des applications centrées sur l'utilisateur.
- Strong seulement si le métier l'exige vraiment, en acceptant l'impact sur la latence d'écriture. Il est bloqué par défaut pour les comptes dont les régions sont distantes de plus de 8 000 km (5 000 miles) et incompatible avec l'écriture multi-régions.
- Bounded staleness convient aux applications globales à une seule région d'écriture qui veulent un « presque fort ». Pour de l'écriture multi-régions, la doc le qualifie d'anti-pattern.
- Dans un compte multi-régions, la métrique Probabilistically Bounded Staleness du portail montre à quel point le niveau choisi est en pratique plus fort qu'annoncé.
- Une application qui lit et écrit toujours dans la même région est moins sensible au niveau.
Distribution globale et écriture multi-régions en bref
flowchart LR
A["Application (région A)"] --> B["Région d'écriture A"]
B -->|"réplication asynchrone"| C["Région de lecture B"]
B -->|"réplication asynchrone"| D["Région de lecture C"]
E["Application (région B)"] --> C
- On ajoute ou retire des régions à tout moment ; les données sont répliquées automatiquement. Modifier la liste des régions se fait séparément de tout autre changement du compte.
- Par défaut, une seule région accepte les écritures ; les autres sont en lecture. Le basculement automatique (
--enable-automatic-failover) choisit une nouvelle région d'écriture selon les priorités de basculement. - L'écriture multi-régions s'active sur un compte existant, sans interruption :
az cosmosdb update --ids <id> --enable-multiple-write-locations true. Elle introduit la notion de résolution de conflits, avec une politique configurable par conteneur (par exemple « dernier écrivain gagne » sur un chemin donné). - Les RU provisionnées sont disponibles dans chaque région, donc le coût suit le nombre de régions.
Retour d'expérience
- Choisir le niveau selon le coût d'une lecture périmée pour le métier, pas par principe.
- Tester le comportement de session si plusieurs instances d'application doivent partager un jeton.
- Documenter le niveau retenu avec l'estimation du RPO en cas de panne régionale.