ワークロードグループのクエリの一貫性ポリシーを使用すると、クエリの 整合性モードを制御するオプションを指定できます。
ポリシー オブジェクト
各オプションは下記のもので構成されています。
- 型指定された
Value
- 制限の値です。 -
IsRelaxable
- 要求の 要求プロパティの一部として、呼び出し元がオプションを緩和できるかどうかを定義するブール値。 既定値はtrue
です。
次の制限を構成できます。
名前 | 種類 | 説明 | サポート状況の値 | 規定値 | 一致するクライアント要求プロパティ |
---|---|---|---|---|---|
クエリ一貫性 | QueryConsistency |
使用する整合性モード。 |
Strong 、Weak 、WeakAffinitizedByQuery または WeakAffinitizedByDatabase |
Strong |
queryconsistency |
CachedResultsMaxAge (キャッシュされた結果マックスエイジ) | timespan |
返される可能性がある、キャッシュされたクエリ結果の最大有効期間。 | 負以外のtimespan |
null |
query_results_cache_max_age |
注
既定値は、次の場合に適用されます。
- ポリシーが定義されておらず、クライアント要求オプションが設定されていない。
- ポリシーが定義されていて、オプションが定義されておらず、クライアント要求オプションが設定されていない。
- ポリシーが定義されていて、オプションが
null
としてValue
で定義されていて、クライアント要求オプションが設定されていない。
例
このポリシー構成では、クエリの整合性が弱く、キャッシュされた結果の最大有効期間が 5 分に設定されます。
"QueryConsistencyPolicy": {
"QueryConsistency": {
"IsRelaxable": true,
"Value": "Weak"
},
"CachedResultsMaxAge": {
"IsRelaxable": true,
"Value": "00:05:00"
}
}
監視
Weak consistency latency
メトリックを使用して、弱い整合性サービス ヘッドとして機能するノードでのメタデータ スナップショットの有効期間の待機時間を監視できます。 詳細については、「 Query メトリック」を参照してください。
関連するコンテンツ
- ワークロード グループ を
する - クエリの整合性
- .alter-merge workload_groupの
- .create-or-alter workload_group コマンド
- .drop workload_groupを
する - .show workload_group コマンド