CONSISTENCY

整合性レベルを設定して表示します。非軽量トランザクション（非LWT）を適切に処理するためにコーディネーター・ノードが応答する必要があるレプリカ・ノードの数は、整合性レベルによって決まります。

CQLシェルは、整合性レベルがSERIALまたはLOCAL_SERIALに設定されている場合、読み取り要求（SELECT文）のみをサポートします。詳細については、ドキュメントの「Data consistency」を参照してください。

構文

CONSISTENCY [ consistency_level ]

consistency_level

整合性レベル。有効なレベルの一覧とその説明については、該当するドキュメントを参照してください。詳しく説明されています。

現在の整合性レベルの表示

現在の整合性レベルを表示するには、CONSISTENCYコマンドをオプションなしで使用してください。

CONSISTENCY

Current consistency level is ONE.

デフォルトの整合性レベルはONEです。

整合性レベルの設定

整合性レベルによって、CQLシェル・セッション時のトランザクションのデータ可用性とデータの精度が決まります。設定によっては、ALLやSERIALなど、クラスター内で発生するその他のトランザクションに大きな影響を与える可能性があります。CQLシェル設定は、整合性レベルのグローバル設定をオーバーライドします。

トランザクションをCQLシェルから開始するとき、コーディネーター・ノードは通常、cqlshを起動したノードになります。リモート・ホストに接続した場合は、リモート・ノードがコーディネーターになります。

例

CONSISTENCY QUORUMレベルを設定して過半数のノードが応答するように強制します。

CONSISTENCY QUORUM

LWT読み取り要求に対してレベルをSERIALに設定します。

CONSISTENCY SERIAL

Consistency level set to SERIAL.

SELECT *
FROM cycling.race_winners;

@ Row 1
---------------+--------------------------------------------------
 race_name     | National Championships South Africa WJ-ITT (CN)
 race_position | 1
 cyclist_name  | {firstname: 'Frances', lastname: 'DU TOUT'}

@ Row 2
---------------+--------------------------------------------------
 race_name     | National Championships South Africa WJ-ITT (CN)
 race_position | 2
 cyclist_name  | {firstname: 'Lynette', lastname: 'BENSON'}

@ Row 3
---------------+--------------------------------------------------
 race_name     | National Championships South Africa WJ-ITT (CN)
 race_position | 3
 cyclist_name  | {firstname: 'Anja', lastname: 'GERBER'}

@ Row 4
---------------+--------------------------------------------------
 race_name     | National Championships South Africa WJ-ITT (CN)
 race_position | 4
 cyclist_name  | {firstname: 'Ame', lastname: 'VENTER'}

@ Row 5
---------------+--------------------------------------------------
 race_name     | National Championships South Africa WJ-ITT (CN)
 race_position | 5
 cyclist_name  | {firstname: 'Danielle', lastname: 'VAN NIEKERK'}

(5 rows)

LWTは、IF EXISTSまたはIF NOT EXISTS文を含む書き込み要求です。LWTの整合性レベルを設定するには、「SERIAL CONSISTENCY」を参照してください。LWTを使用する場合は、CONSISTENCYとSERIAL CONSISTENCYレベルの両方が設定されている必要があります。CONSISTENCYをSERIALまたはLOCAL_SERIALに設定することはできません。これらを設定できるのはSERIAL CONSISTENCYだけです。

次の例は、LWTの障害シナリオを示しています。CONSISTENCY SERIALでのLWTの挿入に失敗します。

CONSISTENCY SERIAL

INSERT INTO cycling.race_winners (
  race_name, 
  race_position,
  cyclist_name 
) VALUES (
  'National Championships South Africa WJ-ITT (CN)',
  7,
  { firstname: 'Joe', lastname: 'Anderson' } 
) 
IF NOT EXISTS;

InvalidRequest: Error from server: code=2200 [Invalid query]
message="SERIAL is not supported as conditional update commit
consistency. Use ANY if you mean "make sure it is accepted but I don't
care how many replicas commit it for non-SERIAL reads""

CONSISTENCY SERIALでのLWTの更新も失敗します。

CONSISTENCY SERIAL

UPDATE cycling.race_winners SET 
  cyclist_name = { firstname: 'JOHN', lastname: 'DOE' } 
WHERE 
  race_name='National Championships South Africa WJ-ITT (CN)' 
  AND race_position = 6
IF EXISTS;

InvalidRequest: Error from server: code=2200 [Invalid query]
message="SERIAL is not supported as conditional update commit
consistency. Use ANY if you mean "make sure it is accepted but I don't
care how many replicas commit it for non-SERIAL reads""

IF句を省略すると、エラーが生成されます。また、CONSISTENCY LOCAL_SERIALを使用すると、その整合性レベルが無効な要求になるため、エラーが生成されます。