tencent cloud

Tencent Cloud Distributed Cache (Redis OSS-Compatible)

streamファミリー

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

コマンドの紹介

Stream系コマンドは、永続化メッセージストリーム(append-only log)の書き込み、読み取り、および消費管理に使用され、Pub/Subのステートフルな拡張バージョンです。このコマンド群は、メッセージキュー、イベントソーシング(Event Sourcing)、ログ集約など、メッセージの永続化と消費確認が必要なシナリオに適しています。そのコアコマンドは機能別に以下の4種類に分類できます:
メッセージの書き込みと読み取り
XADD:ストリームの末尾にメッセージを追加し、一意のメッセージIDを返します(自動生成*または明示的な指定をサポートします)。
XREAD:1つまたは複数のストリームからメッセージを読み取り、指定IDまたはストリームの先頭/末尾から開始できます。
XRANGE / XREVRANGE:ID範囲の順序/逆順でメッセージを検索します。
XLEN:ストリーム内のメッセージ数を返します。
コンシューマーグループ管理(複数コンシューマーによる協調)
XGROUP CREATE / XGROUP DESTROY / XGROUP SETID / XGROUP CREATECONSUMER:コンシューマーグループの作成、破棄、消費進行度の設定またはリセット、コンシューマーの登録を行います。
XREADGROUP:コンシューマーグループ内のコンシューマーが、自分に割り当てられた未処理メッセージを読み取ります。
XACK:メッセージが処理済みであることを確認し、未処理リストから削除します。
XPENDING:コンシューマーグループ内の未処理(未確認)メッセージの詳細情報を表示します。
XCLAIM / XAUTOCLAIM(Redis 6.2+):タイムアウトで未確認のメッセージを他のコンシューマーに移転してフェイルオーバーを実現します。XAUTOCLAIMは自動スキャンと取得をサポートします。
メッセージとストリームのライフサイクル管理
XDEL:メッセージIDを指定して該当メッセージを削除します。
XTRIM:条件に応じてストリーム長をトリミングします(MAXLEN / MINID)。~ による近似トリミングをサポートし、パフォーマンスオーバーヘッドを低減します。
メタ情報の照会
XINFO:ストリーム(GROUPS / CONSUMERS / STREAM)またはコンシューマーグループの詳細メタ情報を表示します。
詳細については、Valkey公式ドキュメントのStreamコマンドグループを参照してください。

コマンドサポート概要

基本コマンド:xinfo、xadd、xtrim、xdel、xrange、xrevrange、xlen、xread、xgroup、xreadgroup、xack、xclaim、xpendingは、Redis 5.0、6.2、7.0バージョンおよびValkey 8.0、9.0の標準アーキテクチャとクラスタアーキテクチャでのみサポートされています。
xautoclaimコマンド:Redis 6.2、7.0バージョンおよびValkey 8.0、9.0バージョンのみサポートされています。
Redis 4.0および2.8バージョン:Streamファミリーの全コマンドはサポートされていません。
クロスSlot制限:クラスタアーキテクチャでは、xread、xreadgroupはクロスSlot操作をサポートしていません。

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

Stream系コマンドの各バージョンおよびアーキテクチャにおけるサポート状況は以下の表の通りです(✓はサポート、✗は非サポート、—は該当コマンドにクロスSlotアクセスシーンが存在しないことを示します)。
コマンド
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スタンダードアーキテクチャ
クラスタアーキテクチャのクロススロット対応
xinfo
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xadd
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xtrim
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xdel
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xrange
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xrevrange
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xlen
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xread
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
✗
xgroup
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xreadgroup
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
✗
xack
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xclaim
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xpending
✓
✓
✓
✓
✓
✓
✓
✓
✗
✗
✗
—
xautoclaim
✓
✓
✓
✓
✓
✓
✗
✗
✗
✗
✗
—

ヘルプとサポート

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

フィードバック