Redisコマンドラインツールの使用方法

単一のコマンドを実行する

通常、Redis サーバーにアクセスするときは、redis-cli を使用して対話モードに入り、質問と応答によってサーバーの読み取りと書き込みを行います。その「インタラクティブ」モデル」。もう 1 つの「ダイレクト モード」があります。これは、コマンド パラメーターを redis-cli に直接渡すことによってコマンドを実行し、出力結果を取得します。

$ redis-cli incrby foo 5<br/>(integer) 5<br/>$ redis-cli incrby foo 5<br/>(integer) 10<br/>

出力コンテンツが大きい場合は、出力を外部ファイルにリダイレクトすることもできます

$ redis-cli info &gt; info.txt<br/>$ wc -l info.txt<br/>     120 info.txt<br/>

上記のコマンドが指すサーバーは、デフォルトのサーバー アドレスです. If you want to point 特定のサーバーはこのようなバッチでコマンドを実行できます

// -n 2 表示使用第2个库，相当于 select 2<br/>$ redis-cli -h localhost -p 6379 -n 2 ping<br/>PONG<br/>

日々のオンライン開発プロセスでは、データを手動で作成して Redis にインポートすることが避けられない場合があります。通常、これを行うためのスクリプトを作成します。ただし、別のより便利な方法があります。それは、redis-cli を直接使用して一連の命令をバッチで実行することです。

$ cat cmds.txt<br/>set foo1 bar1<br/>set foo2 bar2<br/>set foo3 bar3<br/>......<br/>$ cat cmds.txt | redis-cli<br/>OK<br/>OK<br/>OK<br/>...<br/>

上記のコマンドは、Unix パイプを使用して cat コマンドの標準出力を redis-cli の標準入力に接続します。実際、入力リダイレクトを直接使用して命令をバッチで実行することもできます。

$ redis-cli &lt; cmds.txt<br/>OK<br/>OK<br/>OK<br/>...<br/>

set multi-line string

文字列に複数の行があり、それを set コマンドに渡したい場合、redis-cli はどのように行うのでしょうか? -x オプションを使用すると、標準入力の内容が最後の引数として使用されます。

$ cat str.txt<br/>Ernest Hemingway once wrote,<br/>&quot;The world is a fine place and worth fighting for.&quot;<br/>I agree with the second part.<br/>$ redis-cli -x set foo &lt; str.txt<br/>OK<br/>$ redis-cli get foo<br/>&quot;Ernest Hemingway once wrote,\n\&quot;The world is a fine place and worth fighting for.\&quot;\nI agree with the second part.\n&quot;<br/>

命令の繰り返し実行

redis-cli は、命令の複数回の繰り返し実行もサポートしています。各命令の実行間隔を設定すると、特定の命令の出力内容を観察できます。時間をかけて指導します。

// 间隔1s，执行5次，观察qps的变化<br/>$ redis-cli -r 5 -i 1 info | grep ops<br/>instantaneous_ops_per_sec:43469<br/>instantaneous_ops_per_sec:47460<br/>instantaneous_ops_per_sec:47699<br/>instantaneous_ops_per_sec:46434<br/>instantaneous_ops_per_sec:47216<br/>

回数を-1にすると無数に繰り返され永久に実行されます。 -i パラメーターが指定されていない場合、間隔はなく、実行は継続的に繰り返されます。インタラクティブ モードでは、命令を繰り返し実行することもできます。形式はかなり奇妙です。命令の前に回数を追加します。

127.0.0.1:6379&gt; 5 ping<br/>PONG<br/>PONG<br/>PONG<br/>PONG<br/>PONG<br/># 下面的指令很可怕，你的屏幕要愤怒了<br/>127.0.0.1:6379&gt; 10000 info<br/>.......<br/>

Export csv

Redis データベース全体を実行することはできませんが、 CSV形式にエクスポートする場合は、単一項目をエクスポートできます。コマンドの結果はCSV形式で出力されます。

$ redis-cli rpush lfoo a b c d e f g<br/>(integer) 7<br/>$ redis-cli --csv lrange lfoo 0 -1<br/>&quot;a&quot;,&quot;b&quot;,&quot;c&quot;,&quot;d&quot;,&quot;e&quot;,&quot;f&quot;,&quot;g&quot;<br/>$ redis-cli hmset hfoo a 1 b 2 c 3 d 4<br/>OK<br/>$ redis-cli --csv hgetall hfoo<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>

もちろん、このエクスポート関数は比較的弱く、カンマで区切られた文字列の集まりにすぎません。ただし、コマンドのバッチ実行を組み合わせて、複数の命令のエクスポート効果を確認することができます。

$ redis-cli --csv -r 5 hgetall hfoo<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>&quot;a&quot;,&quot;1&quot;,&quot;b&quot;,&quot;2&quot;,&quot;c&quot;,&quot;3&quot;,&quot;d&quot;,&quot;4&quot;<br/>

これを見た読者は、--csv パラメータの効果は、出力を一度変換してカンマで区切るだけであり、それ以上のものではないことを理解するはずです。

lua スクリプトの実行

lua スクリプト セクションでは、eval 命令を使用してスクリプト文字列を実行します。毎回、スクリプトの内容を 1 行の文字列に圧縮してから、 eval 命令は非常に面倒で、可読性も非常に悪いです。 redis-cli はこれを考慮して、スクリプト ファイルを直接実行できます。

127.0.0.1:6379&gt; eval &quot;return redis.pcall(&#39;mset&#39;, KEYS[1], ARGV[1], KEYS[2], ARGV[2])&quot; 2 foo1 foo2 bar1 bar2<br/>OK<br/>127.0.0.1:6379&gt; eval &quot;return redis.pcall(&#39;mget&#39;, KEYS[1], KEYS[2])&quot; 2 foo1 foo2<br/>1) &quot;bar1&quot;<br/>2) &quot;bar2&quot;<br/>

以下では、上記の命令をスクリプト形式で実行します。パラメータの形式が異なります。KEY と ARGV はカンマで区切る必要があり、KEY の数を指定する必要はありません。パラメータ

$ cat mset.txt<br/>return redis.pcall(&#39;mset&#39;, KEYS[1], ARGV[1], KEYS[2], ARGV[2])<br/>$ cat mget.txt<br/>return redis.pcall(&#39;mget&#39;, KEYS[1], KEYS[2])<br/>$ redis-cli --eval mset.txt foo1 foo2 , bar1 bar2<br/>OK<br/>$ redis-cli --eval mget.txt foo1 foo2<br/>1) &quot;bar1&quot;<br/>2) &quot;bar2&quot;<br/>

lua スクリプトが長すぎる場合は、--eval が役立ちます。

サーバーのステータスを監視する

--stat パラメーターを使用してサーバーのステータスをリアルタイムで監視し、1 秒ごとにリアルタイムで出力できます。

$ redis-cli --stat<br/>------- data ------ --------------------- load -------------------- - child -<br/>keys       mem      clients blocked requests            connections<br/>2          6.66M    100     0       11591628 (+0)       335<br/>2          6.66M    100     0       11653169 (+61541)   335<br/>2          6.66M    100     0       11706550 (+53381)   335<br/>2          6.54M    100     0       11758831 (+52281)   335<br/>2          6.66M    100     0       11803132 (+44301)   335<br/>2          6.66M    100     0       11854183 (+51051)   335<br/>

間隔が長すぎる、または短すぎると思われる場合は、-i パラメーターを使用して出力間隔を調整できます。

大きなキーをスキャン

この機能は非常に実用的で、オンラインで何度も試しました。 Redis で時折発生する遅延の問題に遭遇するたびに、インスタンスに大きな KEY があるかどうかが最初に思い浮かびますが、メモリの拡張と大きな KEY の解放により、メイン スレッドの遅延が発生します。中に大きなKEYがあるかどうかがわかれば、それをスキャンするプログラムを自分で書くこともできますが、これは面倒すぎます。 redis-cli は、メモリ内の大きな KEY をすばやくスキャンするための --bigkeys パラメータを提供します。スキャン コマンドによってサーバーの ops アラームが突然増加することを避けるために、-i パラメータを使用してスキャン間隔を制御します。

$ ./redis-cli --bigkeys -i 0.01<br/># Scanning the entire keyspace to find biggest keys as well as<br/># average sizes per key type.  You can use -i 0.1 to sleep 0.1 sec<br/># per 100 SCAN commands (not usually needed).<br/><br/>[00.00%] Biggest zset   found so far &#39;hist:aht:main:async_finish:20180425:17&#39; with 1440 members<br/>[00.00%] Biggest zset   found so far &#39;hist:qps:async:authorize:20170311:27&#39; with 2465 members<br/>[00.00%] Biggest hash   found so far &#39;job:counters:6ya9ypu6ckcl&#39; with 3 fields<br/>[00.01%] Biggest string found so far &#39;rt:aht:main:device_online:68:{-4}&#39; with 4 bytes<br/>[00.01%] Biggest zset   found so far &#39;machine:load:20180709&#39; with 2879 members<br/>[00.02%] Biggest string found so far &#39;6y6fze8kj7cy:{-7}&#39; with 90 bytes<br/>

redis-cli は、各オブジェクト タイプの最大長の KEY を記録します。オブジェクト タイプごとに、最も長いレコードを更新すると、すぐに出力されます。 Top1 の長さの KEY の出力は保証できますが、Top2 や Top3 などの KEY をスキャンできる保証はありません。一般的なアプローチは、複数のスキャンを実行するか、最も優先度の高いキーワードを削除してから再度スキャンして、優先度の低いキーワードがまだあるかどうかを確認することです。

サンプリング サーバーの手順

現在、OPS が高すぎる Redis サーバーがオンラインにあります。多くのビジネス モジュールがこの Redis を使用しています。どのビジネスが異常に高い OPS を引き起こしているのかを特定するにはどうすればよいですか?このとき、オンラインサーバーの命令をサンプリングすることができ、それを観察することでOPSの割合が高い業務ポイントを大まかに分析することができます。サーバーによって実行されたすべての命令を一度に表示するには、monitor コマンドを使用します。なお、使用する際は強制的に中断したい場合でもCtrl Cを押さないとディスプレイに指示が多すぎて一瞬でパチパチになってしまいます。

$ redis-cli --host 192.168.x.x --port 6379 monitor<br/>1539853410.458483 [0 10.100.90.62:34365] &quot;GET&quot; &quot;6yax3eb6etq8:{-7}&quot;<br/>1539853410.459212 [0 10.100.90.61:56659] &quot;PFADD&quot; &quot;growth:dau:20181018&quot; &quot;2klxkimass8w&quot;<br/>1539853410.462938 [0 10.100.90.62:20681] &quot;GET&quot; &quot;6yax3eb6etq8:{-7}&quot;<br/>1539853410.467231 [0 10.100.90.61:40277] &quot;PFADD&quot; &quot;growth:dau:20181018&quot; &quot;2kei0to86ps1&quot;<br/>1539853410.470319 [0 10.100.90.62:34365] &quot;GET&quot; &quot;6yax3eb6etq8:{-7}&quot;<br/>1539853410.473927 [0 10.100.90.61:58128] &quot;GET&quot; &quot;6yax3eb6etq8:{-7}&quot;<br/>1539853410.475712 [0 10.100.90.61:40277] &quot;PFADD&quot; &quot;growth:dau:20181018&quot; &quot;2km8sqhlefpc&quot;<br/>1539853410.477053 [0 10.100.90.62:61292] &quot;GET&quot; &quot;6yax3eb6etq8:{-7}&quot;<br/>

诊断服务器时延

通常我们使用Unix的ping命令来测量两台计算机的延迟。Redis 也提供了时延诊断指令，不过它的原理不太一样，它是诊断当前机器和 Redis 服务器之间的指令(PING指令)时延，它不仅仅是物理网络的时延，还和当前的 Redis 主线程是否忙碌有关。如果你发现 Unix 的 ping 指令时延很小，而 Redis 的时延很大，那说明 Redis 服务器在执行指令时有微弱卡顿。

$ redis-cli --host 192.168.x.x --port 6379 --latency<br/>min: 0, max: 5, avg: 0.08 (305 samples)<br/>

时延单位是 ms。redis-cli 还能显示时延的分布情况，而且是图形化输出。

$ redis-cli --latency-dist<br/>

这个图形的含义作者没有描述，读者们可以尝试破解一下。

远程 rdb 备份

执行下面的命令就可以将远程的 Redis 实例备份到本地机器，远程服务器会执行一次bgsave操作，然后将 rdb 文件传输到客户端。远程 rdb 备份让我们有一种“秀才不出门，全知天下事”的感觉。

$ ./redis-cli --host 192.168.x.x --port 6379 --rdb ./user.rdb<br/>SYNC sent to master, writing 2501265095 bytes to &#39;./user.rdb&#39;<br/>Transfer finished with success.<br/>

模拟从库

如果你想观察主从服务器之间都同步了那些数据，可以使用 redis-cli 模拟从库。

$ ./redis-cli --host 192.168.x.x --port 6379 --slave<br/>SYNC with master, discarding 51778306 bytes of bulk transfer...<br/>SYNC done. Logging commands from master.<br/>...<br/>

从库连上主库的第一件事是全量同步，所以看到上面的指令卡顿这很正常，待首次全量同步完成后，就会输出增量的 aof 日志。

以上がRedisコマンドラインツールの使用方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。