Redis深刻系列-0x010：redis-cli--Redis命令行接口（上）

0x001 redis-cli--Redis命令行接口

redis是一个简单的命令行接口程序，他容许你在终端直接向Redis发送命令，而且读取Redis返回的数据。

它有两种模式：

- 交互模式（`REPL`）：用户输入命令，获取结果。
- 参数模式：命令做为`redis-cli`的参数传输，执行，而且以标准输出流输出

在交互模式中，redis-cli的只能提示提供了一个很是好的输入体验。

然而，redis-cli不只仅能作到这样，它有很是多的选项让你选择，能够经过不一样的选项让他进入某种特殊的模式。因此，redis-cli确定是能够作很是复杂的任务的，好比模拟master复制到slave的数据同步，而且将同步流点出来。检查Redis服务端的潜在危险而且做出统计，设置能够以ASCII-art形式显示潜在危险案例和几率，初次以外还有许多功能。

这个指南将会从最简单的特性开始，而且以将会以高级特性结束，覆盖了redis-cli各个不一样的方面。

若是你想普遍使用Redis，又或者你已经在这么作了，那么这篇文章将有很大的可能让你获得这种机会。花一些时间熟悉这些特性多是一个很是好的注意，若是你知道redis-cli命令行接口诀窍，你将会看到如何更有效的使用Redis。

0x002 命令行使用

将命令当作redis-cli分离的参数来执行命令很是的简单，同时它能够在屏幕上以标准输出命令执行的结果

$ redis-cli incr mycounter
(integer) 7

命令的返回值是7，由于Redis的返回值是类型化的（strings、arrays、integers、NULL、errors等），你将会在返回结果中看到类型，他们在两个括号之间，因此讲Redis的返回值做为另外一个命令的输入值不是一个好主意，除非咱们想将结果重定向到文件中。

一般状况下，redis-cli若是在ttf模式中，将会显示一些而外的消息，以加强阅读性。在其余模式中，将会自动使用原始输出，就像接下来的例子

$ redis-cli incr mycounter > ./output
$ cat ./output 
2

此时，(integer)将会被忽略，由于redis-cli发现并非在终端上输出，固然，咱们也能够强制在终端上直接显示原始信息，使用--raw参数

$ redis-cli --raw incr mycounter
3

同理，你能够强制在输入文件或者其余管道中启用加强模式，使用--no-raw

$ redis-cli --no-raw incr mycounter > ./output
FollowWinter:~ FollowWinter$ cat output 
(integer) 4

0x003 主机，端口，密码，数据库

默认状况下，redis-cli连接的服务端主机地址是127.0.0.1:6379，就像你想的那样，经过命令行，你能够简单的修改这些参数，去指定一个不一样的主机名字或者IP，使用-h，指定不一样的端口，使用-p。

$ redis-cli -h redis15.localnet.org -p 6390 ping
PONG

若是你的实例是受密码保护的，-a <password>选项将会实现认证，明企鹅不须要再显示的调用AUTH命令。

$ redis-cli -a myUnguessablePazzzzzword123 ping
PONG

最后，不使用默认的0号数据库而使用其余数据库也是可能的，可使用 -n <dbnum>选项：

$ redis-cli flushall
OK
$ redis-cli -n 1 incr a
(integer) 1
$ redis-cli -n 1 incr a
(integer) 2
$ redis-cli -n 2 incr a
(integer) 1

这些信息也能够以URI的形式给出，使用 -u <uri>选项

$ redis-cli -u redis://p%40ssw0rd@redis-16379.hosted.com:16379/0 ping
PONG

0x004 从其余输入获取输入数据

有两种方式能够从其余程序获取数据（通常从标准输入）。一种方式是将从标准输入读取的数据装载到redis-cli的最后一个选项。好比，我想将我电脑上的/etc/services文件内容做为一个key的值，我可使用-x选项：

$ redis-cli -x set foo < /etc/services
OK
$ redis-cli getrange foo 0 50
"#\n# Network services, Internet style\n#\n# Note that "

就想你再上面的对话中的第一行看到的，SET命令的最后一个选项并无指定。这个参数并无直接把key设置成我想要设置的值。

做为替代，-x选项指定了一个文件，并被重定向为CLI的标准输入，因此，输入被读取，而且被当作命令的最后一个参数，这对脚本很颇有用。

另外一种方式是将一长串的命令写入文件，直接喂给redis-cli

$ cat /tmp/commands.txt
set foo 100
incr foo
append foo xxx
get foo
$ cat /tmp/commands.txt | redis-cli
OK
(integer) 101
(integer) 6
"101xxx"

全部在这个文件中的命将会一个接着一个的执行，就像是用户输入同样。字符串在必要的时候，可使用引号包裹，因此可使用特殊的符号，好比空格、换行或者其余特殊字符：

$ cat /tmp/commands.txt
set foo "This is a single argument"
strlen foo
$ cat /tmp/commands.txt | redis-cli
OK
(integer) 25

0x005 连续执行屡次相同命令

在执行时用户连续屡次执行相同的命令是颇有可能的。在不一样的上下文中，这是很是有用的，好比当咱们须要连续监控一些key的内容或者输出内容，或者咱们须要模拟一些重复写入事件（好比每5s向一个list推入数据）

这个特性受控于两个选项：-r <count>和-i <delay>。第一个标明要执行多少次，第二个配置两次命令执行的延迟事件，单位是秒（可是也能够指定像0.1这样的小数，用来表示100毫秒）。

默认延迟是0，因此命令会尽量快的执行

$ redis-cli -r 5 incr foo
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5

若是要永远执行某个命令，count选项值为-1，若是为了一直监控RSS的内存大小，或许能够这样使用命令：

$ redis-cli -r -1 -i 1 INFO | grep rss_human
used_memory_rss_human:1.38M
used_memory_rss_human:1.38M
used_memory_rss_human:1.38M
... a new line will be printed each second ...

0x006 使用redis-cli插入混合的数据

使用redis-cli插入混合的数据是一个重要的课题，将会在独立的文章说明，请阅读混合数据插入指南

0x007 导出CSV文件

有时候，你须要使用redis-cli快速的导出Redis中的数据给其余程序使用，可使用CSV输出特性：

$ redis-cli lpush mylist a b c d
(integer) 4
$ redis-cli --csv lrange mylist 0 -1
"d","c","b","a"

此时不可能把整个数据项这样导出，可是只有一个简单的命令就能够作到导出数据到csv文件。

0x008 执行lua脚本

从Redis 3.2开始，咱们就普遍的支持使用新的Lua调试器来调试和编写Lua脚本，关于这个特性，能够查阅Redis Lua 调试文档。

然而，就算没有使用调试器，你也可使用redis-cli从一个文件执行脚本，比在shell交互中输入脚本或者做为参数舒服多了

$ cat /tmp/script.lua
return redis.call('set',KEYS[1],ARGV[1])
$ redis-cli --eval /tmp/script.lua foo , bar
OK

Redis的EVAL命令携带了脚本须要用到的key，另外一个却没有key参数,当调用EVAL的时候，你以数字的方式提供了一个key的数字。然而在前面redis-cli使用--eval选项的时候，不须要特地指定key的序号。它性惯性的使用逗号分隔的key序列做为替代。这就是为何你再前面看到foo, bar做为参数。

因此 foo将会由KSYS数组组成，bar由ARGV数组组成
So foo will populate the KEYS array, and bar the ARGV array.

--eval选项在编写简单脚本的时候特别有用。其余复杂的工做，使用Lua调试器将会更加温馨，这两种方式能够混合使用，由于调试器也是执行外部脚本文件。