redis commands common ls-use-sql

LS   (list) - old version

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

---

Key を照会 - old (use-sql) version 参照用説明ページ(現在未使用)

使い方は ls または ls pattern です。
ls はすべてのキーを照会します。
このコマンドは Enterprise サーバーで redis.conf use-sql yes に設定したときに使用できます。

glob-style pattern を使用できます。

• * : すべての文字にマッチ(match): h*llo -> hllo, heeeello, etc
• ? : 1文字にマッチ(match): h?llo -> hallo, hello, hxllo, etc
• [alphabet] : 角括弧内の文字にマッチ(match): h[ae]llo -> hallo, hello
  
• [^e] : 角括弧内の文字を 除外して マッチ(match): h[^e]llo -> hallo, hbllo, ... ただし hello は除外されます。
  
• [a-c] : 角括弧内の文字範囲でマッチ(match): h[a-c]llo -> hallo, hbllo, hcllo
• \ : 上で使った特殊文字(*?[^])をそのまま使うには前に \ を付けてください。

Data type 指定

データタイプ(data type)を指定して該当キーだけを照会できます。 指定できるデータタイプは string, list, set, zset, hash, stream です。

• データタイプを指定すると全体キー集合から探すのではなく データタイプ別に別管理される Sorted Set から該当部分のキーを照会するので 速度が速くサーバーに負担をかけません。
  B1 B2 B3 C1 C2 C3 D1 D2 D3
                    \__C*__/
• データタイプを指定すると sort オプションを使わなくてもソートされて照会されます。
• "ls user* string" のように使うと user で始まるキーに直接アクセスして照会します。
• データタイプを複数指定するとタイプ別にソートされたキーリストが照会されます。

オプション指定

• TYPE: キーのデータタイプを表示します。
• ENCODING: キーの内部データタイプを表示します。
• VALUE or VAL: String のとき値を表示します。このオプションは String のときだけ適用されます。
• STRLEN: String のとき文字列の長さを表示します。このオプションは String のときだけ適用されます。
• LEN: キーの長さ(メンバー数)を表示します。 List は llen、Set は scard、ZSet は zcard、Hash は hlen、Stream は xlen コマンドを 実行したのと同じです。 String は 1 が表示されます。
• MEMORY or MEM: 使用メモリを表示します。 これは memory usage key を実行したのと同じです。
• TTL: 有効期限(expire time)を秒単位で表示します。有効期限が設定されていなければ -1 を表示します。
• PTTL: 有効期限(expire time)を 1/1000秒(millisecond)単位で表示します。有効期限が設定されていなければ -1 を表示します。
• IDLETIME: キーを参照した後の経過時間を秒で表示します。 最近このキーを使ったか、どれくらい長くこのキーを使っていないかを確認できます。
• SLOT: キーのスロット(slot)を表示します。Cluster はもちろん Standalone でも出ます。
• TIME: キーの update_mstime(作成日時または最終更新日時)を表示します。
• EXPIRE_KEYS: メンバー(member)に有効期限(expire time)が設定されたキーを照会します。   TTL と組み合わせるとメンバーに設定された最大の expire time を照会します。
• DEFAULT or DF: type, len, table オプションを適用します。

• Data type とオプションを同時に指定できます。

ソートオプション指定

• SORT/ASC/DESC: 結果をソートします。

COUNT/TOP オプション指定

• COUNT integer: 取得するキー個数を制限します。照会時間を減らせます。
• TOP integer: ソート後に表示するキー個数を制限します。

TABLE オプション指定

• table: テーブル形式で表示します。

構文

LS   [pattern]   [string|list|set|zset|hash|stream]
  [type|encoding|value|strlen|len|memory|ttl|pttl|idletime|slot|time|expire_keys|default]
  [table]
  [sort|asc|desc]
  [count <integer>] [top <integer>]

• このコマンドは Enterprise version 6.1.0 から使用できます。
• 時間計算量は Datatype を指定した場合 O(log(N)+M) です。 N はデータタイプに属するキー個数、M は返すキー個数です。
  指定しない場合: O(N) です。N は返されたキー個数ではなくデータベースにあるすべてのキー個数です。

関連コマンド

SCAN, DBSIZE

---