tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

cluster ファミリー

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-20 18:29:13
AI翻訳

コマンドの紹介

Clusterファミリーコマンドは、クラスタモードにおけるシャードトポロジーの照会に使用されます。分散キャッシュデータベースのクラスタアーキテクチャでは、データは16384個のハッシュスロット(Hash Slot)に従って複数のシャードに分散され、Clusterファミリーコマンドはクライアントによるインテリジェントルーティングとクラスタ状態の認識を支援します。その主要コマンドは機能別に以下の2種類に分類できます:
クラスタトポロジーと状態照会
CLUSTER NODES:クラスタ内のすべてのノードのID、アドレス、役割(マスター/スレーブ)、状態、およびスロット割り当て情報を返します。
CLUSTER INFO:クラスタ全体の状態サマリーを返します。これには、クラスタ状態(ok/fail)、割り当て済みスロット数、既知ノード数などの主要指標が含まれます。
CLUSTER SLOTS:スロット範囲とノードのマッピング関係を返し、クライアントルーティングテーブル構築の主要コマンドです。
CLUSTER SHARDS(Redis 7.0+ / Valkey 8.0+):シャード単位でトポロジー情報を返し、マスター/スレーブ関係とシャード境界の識別がより容易になります。
スロット計算とルーティング
CLUSTER KEYSLOT:指定されたKeyが属するハッシュスロット番号(0 - 16383)を返します。クライアントはこれに基づいてリクエストを正しいシャードノードにルーティングします。
CLUSTER COUNTKEYSINSLOT:指定されたスロット内のキー数(ローカルノードのみ)を返します。CLUSTER GETKEYSINSLOT:指定されたスロット内のキー名リストを返します。
詳細については、Valkey公式ドキュメントのClusterコマンドグループを参照してください。

コマンドサポートの概要

スロット照会コマンド:cluster keyslot、cluster countkeysinslot、cluster getkeysinslot、cluster slots、cluster shards。このうち、cluster shardsはRedis 7.0およびValkey 8.0、9.0の標準アーキテクチャとクラスタアーキテクチャのみでサポートされています。残り4つはRedis 4.0以降の各バージョンのクラスタアーキテクチャでサポートされており、標準アーキテクチャではサポートされていません。cluster slotsはスロットとノードのマッピングを返し、cluster shardsはスロットとシャードのマッピングを返します(7.0+の改良版です)。
クラスタ情報照会コマンド:cluster nodes、cluster info。Redis 4.0以降の各バージョンのクラスタアーキテクチャでサポートされており、標準アーキテクチャではサポートされていません。
クロスSlot制限:Clusterファミリーコマンドはクラスタメタデータ(スロット、ノード情報)を操作し、ユーザーデータキーは操作しません。そのため、クロスSlotアクセスシナリオは存在しません。

コマンド互換性マトリクス

この系コマンドの各バージョンおよびアーキテクチャにおけるサポート状況は以下の表の通りです(✓はサポート、✗は非サポート、—は該当コマンドにクロスSlotアクセスシーンが存在しないことを示します)。
説明:
標準アーキテクチャでは、すべてのclusterコマンドは適用されません(✗)。クラスタアーキテクチャでは、スロット照会(cluster keyslot、cluster countkeysinslot、cluster getkeysinslot、cluster slots、cluster shards)およびクラスタ情報照会(cluster nodes、cluster info)のサブコマンドのみがサポートされ、その他のトポロジー変更に関わる運用管理コマンドは全体的に利用できません。cluster shardsはcluster slotsの改良版(Redis 7.0+で導入)であり、シャード単位で集約されたスロットマッピング情報を提供します。
コマンド
Valkey 9.0スタンダードアーキテクチャ
Valkey 9.0クラスタアーキテクチャ
Redis 7.0 / Valkey 8.0スタンダードアーキテクチャ
Redis 7.0 / Valkey 8.0クラスタアーキテクチャ
Redis 6.2スタンダードアーキテクチャ
Redis 6.2クラスタアーキテクチャ
Redis 5.0スタンダードアーキテクチャ
Redis 5.0クラスタアーキテクチャ
Redis 4.0スタンダードアーキテクチャ
Redis 4.0クラスタアーキテクチャ
Redis 2.8スタンダードアーキテクチャ
クラスタアーキテクチャのクロススロット対応
cluster keyslot
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—
cluster countkeysinslot
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—
cluster getkeysinslot
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—
cluster slots
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—
cluster shards
✓
✓
✓
✓
✗
✗
✗
✗
✗
✗
✗
—
cluster nodes
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—
cluster info
✗
✓
✗
✓
✗
✓
✗
✓
✗
✓
✗
—

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック