HSCAN

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

フィールド(field)、メンバー(member)を一定件数ずつ取得

使い方は hscan key cursor です。
フィールドが多い場合はカーソル(cursor)を指定して繰り返し取得します。すべて取得した場合 next cursor は 0 です。
hmget key f1, f2 を使って繰り返し取得するのに似ています。
Example ではフィールド数が多くないので一度にすべて取得されました。

Example

コマンド>hmset myhash f1 v1 f2 v2 f3 v3 c4 v4 c5 v5 c6 v6
結果>OK
コマンド>hscan myhash 0
結果>next cursor -> 0
0) f1 -> v1
1) f2 -> v2
2) f3 -> v3
3) c4 -> v4
4) c5 -> v5
5) c6 -> v6


count を使用可能

使い方は hscan key cursor count 5 です。
取得されるフィールド数が指定した count と常にちょうど一致するわけではありません。処理時間を考慮して件数を調整します。

Example

コマンド>hscan myzip 0 count 5
結果>next cursor -> 0
0) f1 -> v1
1) f2 -> v2
2) f3 -> v3
3) c4 -> v4
4) c5 -> v5
5) c6 -> v6


パターン(pattern)を使用可能

使い方は hscan key cursor match pattern です。
パターンはフィールドに適用されます。GLOB style pattern です。

Example

コマンド>hscan myset 0 match c*
結果>next cursor -> 0
0) c4 -> v4
1) c5 -> v5
2) c6 -> v6


構文

HSCAN key cursor [MATCH pattern] [COUNT count]

  • このコマンドは version 2.8.0 から使用できます。
  • 時間計算量は 1回の実行あたり O(1) です。
関連コマンド HMGET
Clients for Java Jedis, Lettuce, Redisson
Clients for C Hiredis

<< HSETNX HSCAN HRANDFIELD >>

Email 返事がかかってなれば、メールでお知らせします。