redis commands streams xrange

XRANGE

Redis 開発者教育の申込	Redis 定期点検/技術サポート Redis Technical Support	Redis エンタープライズサーバー Redis Enterprise Server

データ照会

使い方は XRANGE key start end です。

- + は該当キー(ストリーム)のすべてのデータを照会します。
ID を指定して照会でき、その場合は指定した ID を含めて照会します。

• XRANGE sensor-1234 1538319053569-10 1538319053569-99
• XRANGE sensor-1234 - 1538319053569
• XRANGE sensor-1234 1538319053569 +
• XRANGE sensor-1234 1538319053569 1538319053569

この場合 ID の sequenceNumber は省略できます。sequenceNumber を省略すると前の ID は 0 で埋められ、 後ろの ID は 18,446,744,073,709,551,615 で埋められます。この数字は Unsigned 8バイト整数の最大値です。

• XRANGE sensor-1234 1538319053569-0 1538319053569-18446744073709551615

フィールドが複数ある場合、入力された順に照会されます。

ID を含めない照会(exclusive range)

デフォルトでは指定した ID を含めて照会します。 含めない場合は ID の前に '(' を入力してください。
XRANGE sensor-1234 (1538319053569 (1538319059570
この機能は version 6.2 で追加されました。

COUNT オプション

照会するデータ件数を指定するには COUNT オプションを使います。 この場合、前に指定した ID 以上のデータが照会されます。

繰り返し実行

照会された ID に 1 を足してコマンドを繰り返すと、続けて次のデータを照会できます。 これは他のデータ型の SCAN コマンドと同じ効果があります。

構文

XRANGE key start end [COUNT count] |

• このコマンドは version 5.0.0 から使用できます。
• version 6.2 で start, end ID を含めずに照会する '(' オプションが追加されました。
• 時間計算量は O(log(N)+M) です。N はストリームに保存されているエントリ(ID)の個数、M は返されるエントリの個数です。