...
Eroare System Design · Replicare, sharding și consistență

Cannot achieve consistency level QUORUM (factor de replicare 2)

Pe scurt

Cu factorul de replicare 2, majoritatea (QUORUM) înseamnă tot 2 replici, deci căderea oricărui nod care ține o copie face operațiile imposibile. Mărește factorul de replicare la 3: QUORUM devine 2 din 3 și tolerează un nod căzut.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

QUORUM înseamnă floor(RF / 2) + 1 replici. Pentru RF = 3, sunt 2; pentru RF = 2, sunt tot 2. Mulți aleg RF = 2 ca să economisească spațiu, gândindu-se că „o copie de rezervă” ajunge, apoi folosesc QUORUM pentru consistență. Rezultatul: fiecare nod devine critic, iar la primul restart apare Cannot achieve consistency level QUORUM (cu required: 2, alive: 1).

E o greșeală de aritmetică, nu de configurare a aplicației. Factorul de replicare 3 e standardul în bazele distribuite tocmai pentru că e cel mai mic număr care permite o majoritate ce supraviețuiește unei căderi.

Mesajul poate apărea și cu RF = 3 dacă două noduri care țin aceeași partiție sunt jos, sau dacă folosești QUORUM în loc de LOCAL_QUORUM într-un cluster cu mai multe centre de date și legătura dintre ele e întreruptă.

De ce apare: cauzele frecvente

1RF 2 cu QUORUM

Greșit
CREATE KEYSPACE comenzi WITH replication = {'class': 'NetworkTopologyStrategy', 'dc1': 2};
-- interogări la QUORUM
Corect
ALTER KEYSPACE comenzi WITH replication = {'class': 'NetworkTopologyStrategy', 'dc1': 3};
-- apoi: nodetool repair

Cu 3 replici, majoritatea e 2 și rămâne disponibilă când un nod pică. După schimbare, repair creează copiile noi.

2QUORUM global în mai multe centre de date

Greșit
setConsistencyLevel(DefaultConsistencyLevel.QUORUM)   // 2 DC × RF 3 = 4 din 6
Corect
setConsistencyLevel(DefaultConsistencyLevel.LOCAL_QUORUM)   // 2 din 3 în DC-ul local

LOCAL_QUORUM nu depinde de legătura cu celălalt centru de date.

Repară tu

Repară eroarea, direct în pagină

Baza NoSQL a comenzilor are 3 noduri, factor de replicare 2 și consistență cvorum. Când pică un nod, comenzile dau Cannot achieve consistency level QUORUM. Repară configurarea astfel încât căderea unui nod să fie tolerată, fără să renunți la cvorum.

Indiciu

Calculează majoritatea pentru 2 replici, apoi pentru 3.

Alte forme ale mesajului

  • UnavailableException: Not enough replicas available for query at consistency QUORUM (2 required but only 1 alive)

Cum o eviți pe viitor

  • Folosește factor de replicare 3 pentru date importante.
  • Calculează majoritatea înainte să alegi nivelul de consistență.
  • În clustere cu mai multe centre de date, folosește LOCAL_QUORUM.
  • Rulează nodetool repair regulat și după schimbări de replicare.

Întrebări frecvente

Pot folosi ONE ca să evit eroarea?

Da, dar pierzi garanția că citești ultima scriere. Pentru date unde contează (stoc, plăți), corect e RF 3 + QUORUM.

Costă mult RF 3?

Spațiu cu 50% mai mult decât RF 2 și scrieri pe 3 noduri. E prețul obișnuit pentru o bază distribuită care tolerează căderea unui nod fără să piardă consistența.

Erori înrudite

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață System Design de la zero, cu exerciții la fiecare lecție

Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.