redis

redis は Redis に接続し、キーと値の確認、対象を絞った変更、データのエクスポート、ネイティブ Redis コマンド、バイナリ安全なバックアップを扱います。

データベースバージョン 1.1.4安定版
lil-terminal

概要

redis でキー空間の確認、値のプレビューと検索、部分更新、ネイティブ Redis コマンド、PHP だけでのバイナリ安全な論理バックアップを行えます。

テーブルではなくキー

Redis はリレーショナルな table ストアではなく、サーバー上の keyspace です。key には string、hash、list、set、sorted set、stream などを格納でき、期限を持つこともあります。変更前に key の型を確認し、特殊な Redis 操作は : の後でネイティブコマンドを使うのが安全です。

構文

lil-terminal
redis [options] · redis : <command>

リファレンス

redis

現在の Redis 接続を表示

redis -c <host> [user] [database] [-p <port>] [-n] [-m [name]]

接続する;-n を使わない場合はパスワードを別入力で要求

-use <database>

別の数値データベースを選択

-l

Redis INFO keyspace が報告するデータベースを表示

-t [mask]

キーを一覧表示;* と ? は Redis glob ワイルドカード

-s <key>

キーの型、TTL、メモリ情報を表示

-n <key> [items]

キー値をプレビュー

-f <mask> [text] [keys]

一致するキーを探すか、その名前と値を横断して文字列を検索する

-o <key> [file] [-f]

1つのキーを JSON でエクスポート

-w <key> : <value>

文字列値を書き込み

-d <key>

キーを削除

-m [name]

現在の接続を .lil.key に保存。既定名は Redis のデータベース番号

-M <name>

保存済み接続を削除

-k [name]

保存済み接続を一覧表示、またはパスワードを表示せずに1件確認

-K <name>

保存済み接続を使って接続

-e

切断して接続情報を消去

redis : <command>

ネイティブ Redis コマンドを実行

redis dump [file.json] [-f]

バイナリ安全な論理ダンプを作成

redis load <file.json>

lil Redis ダンプを復元

使い方

redis [options] · redis : <command>

まず安全に確認

redis -c localhost で接続し、パスワードは別途入力します。-t "product:*" はキー一覧、-s product:1001 は型と TTL、-n は値を表示します。-f "product:*" shoe 10 で件数を制限して検索できます。: の後に Redis のネイティブコマンドを指定します。

データを変更する前に

-w は文字列のみを書き込みます。hash/list はネイティブコマンドで変更し、-d はキーを削除します。dump は Redis DUMP のバイナリデータと TTL を lil JSON に保存するもので、RDB/AOF バックアップではありません。復元前にデータベース番号を確認してください。PHP Redis 拡張が必要です。

操作モデル

よく使う形式はローカルリファレンスにまとまっています。短縮操作は確認と小規模な変更を担当し、高度な操作では各データベースのネイティブ構文をそのまま使えます。

バックアップと復元

dump/load の形式はドライバーごとに異なります。エンジンの全機能を含む完全なバックアップが必要な場合は、サーバー側のネイティブツールを使ってください。

安全性

パスワードは非表示入力で受け取り、コマンド履歴には保存しません。可能な限り権限を限定したアカウントを利用してください。

応答性を保つためプレビューには上限があります。1 キーが 100000 項目を超えるエクスポートや、100000 キーを超えるダンプは、黙って切り詰めず拒否します。

保存済み接続

-m を使わない限り、接続データは現在の PHP セッションだけに保持されます。-m [name] はプロファイルを保護された .lil.key(0600)へ明示的に保存し、-K <name> はそれを使って再接続、-k は保存済みパスワードを表示せずに一覧または詳細を確認し、-M <name> は1件削除します。kill は他のコア状態とともに .lil.key を削除します。任意保存したプロファイルにはデータベース認証情報が含まれる場合があるため、このファイルは機密として扱ってください。

インタラクティブな sandbox プレビュー

用意された例をページ上でそのまま実行できます。結果は事前に生成されてブラウザに表示され、サーバーではターミナルコマンドを実行しません。

キーと値を確認

インストールと管理

現在の互換バージョンをインストールします。全機能は Base、縮小版は Minimum を選び、すでに導入済みのモジュール更新には upgrade を使います。

Base と Minimum は同じ現在のモジュールリリースの二つのパッケージです。

Base パッケージ

ローカル参照と公開済みの全モードを含む完全パッケージをインストールします。

install redis
Minimum パッケージ

縮小パッケージをインストールします。ローカルリファレンスは含まれず、help <cmd> -i で現在のサーバーリファレンスを開きます。

install redis -m
正確な公開版

この公開済みバージョンを正確に指定してインストールします。

install redis -v 1.1.4
確認または更新

upgrade が互換性を確認し、必要な場合だけブロックを置換します。

upgrade redis
モジュールを削除

コアや他のモジュールに触れず拡張ブロックを削除します。

install redis -u

例

例はコピーできますが、サイトは実行しません。実プロジェクトではパス、権限、破壊的オプションを確認してください。

キーと値を確認
redis
学習用の例 — 実際の接続なし
A connection is required; the status view names the server and selected database.
Redis · localhost
redis -c localhost -n
学習用の例 — 実際の接続なし
Connection example: server and database will be shown after a successful connection.
Redis · localhost
redis -c localhost demo 0
学習用の例 — 実際の接続なし
Password is requested separately; connection details depend on the server.
Redis · localhost
redis -c localhost -p 6380 -n
学習用の例 — 実際の接続なし
Connection example: server and database will be shown after a successful connection.
別の数値データベースを選択
redis -use 0
学習用の例 — 実際の接続なし
Selected database: 0 (requires an active connection)
Redis INFO keyspace が報告するデータベースを表示
redis -l
学習用の例 — 実際の接続なし
db0: keys=4
キーを一覧表示;* と ? は Redis glob ワイルドカード
redis -t
学習用の例 — 実際の接続なし
inventory  hash
product:1001  string
product:1002  string
product:1003  string
キーを一覧表示;* と ? は Redis glob ワイルドカード
redis -t "product:*"
学習用の例 — 実際の接続なし
product:1001  string
product:1002  string
product:1003  string
キーの型、TTL、メモリ情報を表示
redis -s product:1001
学習用の例 — 実際の接続なし
Key  product:1001
Type  string
TTL  -1 (in this teaching snapshot)
Bytes  depends on Redis version
キー値をプレビュー
redis -n product:1001
学習用の例 — 実際の接続なし
City shoe
キー値をプレビュー
redis -n inventory 2
学習用の例 — 実際の接続なし
{"SHOE-1": 18, "SHOE-2": 7}
一致するキーを探すか、その名前と値を横断して文字列を検索する
redis -f "product:*"
学習用の例 — 実際の接続なし
product:1001  string
product:1002  string
product:1003  string
存在しないキーを扱う
redis -f "product:*" shoe 10
学習用の例 — 実際の接続なし
product:1001  string  City shoe
product:1002  string  Trail shoe
1つのキーを JSON でエクスポート
redis -o product:1001
学習用の例 — 実際の接続なし
{
  "key": "product:1001",
  "type": "string",
  "value": "City shoe"
}
1つのキーを JSON でエクスポート
redis -o product:1001 tmp/product.json
学習用の例 — 実際の接続なし
Saved  sandbox/tmp/product.json (if the destination does not exist)
Redis · json
redis -o product:1001 tmp/product.json -f
学習用の例 — 実際の接続なし
Saved  sandbox/tmp/product.json (replace existing file only with -f)
文字列値を書き込み
redis -w product:1004 : Travel bag
学習用の例 — 実際の接続なし
+ (sets one string key)
キーを削除
redis -d product:1004
学習用の例 — 実際の接続なし
Deleted  0 (the independent snapshot has no product:1004)
ネイティブ Redis コマンドを実行
redis : GET product:1001
学習用の例 — 実際の接続なし
City shoe
ネイティブ Redis コマンドを実行
redis : DBSIZE
学習用の例 — 実際の接続なし
4
バイナリ安全な論理ダンプを作成
redis dump tmp/redis-backup.json
学習用の例 — 実際の接続なし
Saved  sandbox/tmp/redis-backup.json
Format  lil-redis-dump (logical data export, not server backup)
Redis · dump
redis dump tmp/redis-backup.json -f
学習用の例 — 実際の接続なし
Saved  sandbox/tmp/redis-backup.json
Format  lil-redis-dump (logical data export, not server backup)
lil Redis ダンプを復元
redis load tmp/redis-backup.json
学習用の例 — 実際の接続なし
Redis RESTORE reads a lil dump file; this file must exist and existing keys may be replaced.
現在の接続を .lil.key に保存。既定名は Redis のデータベース番号
redis -m cache-demo
学習用の例 — 実際の接続なし
Saved  cache-demo (stores a sensitive profile in .lil.key)
保存済み接続を一覧表示、またはパスワードを表示せずに1件確認
redis -k
学習用の例 — 実際の接続なし
No saved connections (unless a profile has already been saved)
保存済み接続を一覧表示、またはパスワードを表示せずに1件確認
redis -k cache-demo
学習用の例 — 実際の接続なし
Saved connection not found: cache-demo (unless saved earlier)
保存済み接続を使って接続
redis -K unknown
学習用の例 — 実際の接続なし
Saved connection not found: unknown
保存済み接続を削除
redis -M unknown
学習用の例 — 実際の接続なし
Saved connection not found: unknown
切断して接続情報を消去
redis -e
学習用の例 — 実際の接続なし
+
キー値をプレビュー
redis -n missing:key
学習用の例 — 実際の接続なし
Key not found
別の数値データベースを選択
redis -use wrong
学習用の例 — 実際の接続なし
Numeric Redis database required
文字列値を書き込み
redis -w product:1004
学習用の例 — 実際の接続なし
Value required after :

この例で使うファイル: sandbox/db/redis.txt

例では、保護されたドキュメント用 /sandbox/ ワークスペースのファイルまたはディレクトリを使います。

SET product:1001 "City shoe"
SET product:1002 "Trail shoe"
SET product:1003 "Canvas bag"
HSET inventory SHOE-1 18 SHOE-2 7 BAG-1 24

関連ドキュメント

現在の公開版

v1.1.42026-11-01

プロダクション向け調整

redis の現在の安定版。redis は Redis に接続し、キーと値の確認、対象を絞った変更、データのエクスポート、ネイティブ Redis コマンド、バイナリ安全なバックアップを扱います。