AUTH password
- 通过设置配置文件中
requirepass
项的值(使用命令CONFIG SET requirepass password
),可以使用密码来保护 Redis 服务器。 - 如果开启了密码保护的话,在每次连接 Redis 服务器之后,就要使用
AUTH
命令解锁,解锁之后才能使用其他 Redis 命令。 CONFIG SET requirepass secret_password
将密码设置为 secret_passwordCONFIG GET requirepass
获取配置文件中的信息
QUIT
- 请求服务器关闭与当前客户端的连接
- 一旦所有等待中的回复(如果有的话)顺利写入到客户端,连接就会被关闭
INFO [section]
-
以一种易于解释(parse)且易于阅读的格式,返回关于 Redis 服务器的各种信息和统计数值
-
通过给定可选的参数
section
,可以让命令只返回某一部分的信息:-
server
部分记录了 Redis 服务器的信息,它包含以下域:redis_version
: Redis 服务器版本redis_git_sha1
: Git SHA1redis_git_dirty
: Git dirty flagos
: Redis 服务器的宿主操作系统arch_bits
: 架构(32 或 64 位)multiplexing_api
: Redis 所使用的事件处理机制 epollgcc_version
: 编译 Redis 时所使用的 GCC 版本process_id
: 服务器进程的 PIDrun_id
: Redis 服务器的随机标识符(用于 Sentinel 和集群)tcp_port
: TCP/IP 监听端口uptime_in_seconds
: 自 Redis 服务器启动以来,经过的秒数uptime_in_days
: 自 Redis 服务器启动以来,经过的天数lru_clock
: 以分钟为单位进行自增的时钟,用于 LRU 管理
-
clients
部分记录了已连接客户端的信息,它包含以下域:connected_clients
: 已连接客户端的数量(不包括通过从属服务器连接的客户端)client_longest_output_list
: 当前连接的客户端当中,最长的输出列表client_longest_input_buf
: 当前连接的客户端当中,最大输入缓存blocked_clients
: 正在等待阻塞命令(BLPOP、BRPOP、BRPOPLPUSH)的客户端的数量
-
memory
部分记录了服务器的内存信息,它包含以下域:used_memory
: 由 Redis 分配器分配的内存总量,以字节(byte)为单位used_memory_human
: 以人类可读的格式返回 Redis 分配的内存总量used_memory_rss
: 从操作系统的角度,返回 Redis 已分配的内存总量(俗称常驻集大小)。这个值和top
、ps
等命令的输出一致。used_memory_peak
: Redis 的内存消耗峰值(以字节为单位)used_memory_peak_human
: 以人类可读的格式返回 Redis 的内存消耗峰值used_memory_lua
: Lua 引擎所使用的内存大小(以字节为单位)mem_fragmentation_ratio
:used_memory_rss
和used_memory
之间的比率mem_allocator
: 在编译时指定的, Redis 所使用的内存分配器。可以是 libc 、 jemalloc 或者 tcmalloc 。
在理想情况下,
used_memory_rss
的值应该只比used_memory
稍微高一点儿。当
rss > used
,且两者的值相差较大时,表示存在(内部或外部的)内存碎片。内存碎片的比率可以通过
mem_fragmentation_ratio
的值看出。当
used > rss
时,表示 Redis 的部分内存被操作系统换出到交换空间了,在这种情况下,操作可能会产生明显的延迟。当 Redis 释放内存时,分配器可能会,也可能不会,将内存返还给操作系统。
如果 Redis 释放了内存,却没有将内存返还给操作系统,那么
used_memory
的值可能和操作系统显示的 Redis 内存占用并不一致。查看
used_memory_peak
的值可以验证这种情况是否发生。 -
persistence
部分记录了跟RDB
持久化和AOF
持久化有关的信息,它包含以下域:loading
: 一个标志值,记录了服务器是否正在载入持久化文件。rdb_changes_since_last_save
: 距离最近一次成功创建持久化文件之后,经过了多少秒。rdb_bgsave_in_progress
: 一个标志值,记录了服务器是否正在创建 RDB 文件。rdb_last_save_time
: 最近一次成功创建 RDB 文件的 UNIX 时间戳。rdb_last_bgsave_status
: 一个标志值,记录了最近一次创建 RDB 文件的结果是成功还是失败。rdb_last_bgsave_time_sec
: 记录了最近一次创建 RDB 文件耗费的秒数。rdb_current_bgsave_time_sec
: 如果服务器正在创建 RDB 文件,那么这个域记录的就是当前的创建操作已经耗费的秒数。aof_enabled
: 一个标志值,记录了 AOF 是否处于打开状态。aof_rewrite_in_progress
: 一个标志值,记录了服务器是否正在创建 AOF 文件。aof_rewrite_scheduled
: 一个标志值,记录了在 RDB 文件创建完毕之后,是否需要执行预约的 AOF 重写操作。aof_last_rewrite_time_sec
: 最近一次创建 AOF 文件耗费的时长。aof_current_rewrite_time_sec
: 如果服务器正在创建 AOF 文件,那么这个域记录的就是当前的创建操作已经耗费的秒数。aof_last_bgrewrite_status
: 一个标志值,记录了最近一次创建 AOF 文件的结果是成功还是失败。
如果 AOF 持久化功能处于开启状态,那么这个部分还会加上以下域:
aof_current_size
: AOF 文件目前的大小。aof_base_size
: 服务器启动时或者 AOF 重写最近一次执行之后,AOF 文件的大小。aof_pending_rewrite
: 一个标志值,记录了是否有 AOF 重写操作在等待 RDB 文件创建完毕之后执行。aof_buffer_length
: AOF 缓冲区的大小。aof_rewrite_buffer_length
: AOF 重写缓冲区的大小。aof_pending_bio_fsync
: 后台 I/O 队列里面,等待执行的fsync
调用数量。aof_delayed_fsync
: 被延迟的fsync
调用数量
-
stats
部分记录了一般统计信息,它包含以下域:total_connections_received
: 服务器已接受的连接请求数量。total_commands_processed
: 服务器已执行的命令数量。instantaneous_ops_per_sec
: 服务器每秒钟执行的命令数量。rejected_connections
: 因为最大客户端数量限制而被拒绝的连接请求数量。expired_keys
: 因为过期而被自动删除的数据库键数量。evicted_keys
: 因为最大内存容量限制而被驱逐(evict)的键数量。keyspace_hits
: 查找数据库键成功的次数。keyspace_misses
: 查找数据库键失败的次数。pubsub_channels
: 目前被订阅的频道数量。pubsub_patterns
: 目前被订阅的模式数量。latest_fork_usec
: 最近一次fork()
操作耗费的毫秒数。
-
replication
: 主/从复制信息role
: 如果当前服务器没有在复制任何其他服务器,那么这个域的值就是master
;否则的话,这个域的值就是slave
。注意,在创建复制链的时候,一个从服务器也可能是另一个服务器的主服务器。
如果当前服务器是一个从服务器的话,那么这个部分还会加上以下域:
master_host
: 主服务器的 IP 地址。master_port
: 主服务器的 TCP 监听端口号。master_link_status
: 复制连接当前的状态,up
表示连接正常,down
表示连接断开。master_last_io_seconds_ago
: 距离最近一次与主服务器进行通信已经过去了多少秒钟。master_sync_in_progress
: 一个标志值,记录了主服务器是否正在与这个从服务器进行同步
如果同步操作正在进行,那么这个部分还会加上以下域:
master_sync_left_bytes
: 距离同步完成还缺少多少字节数据。master_sync_last_io_seconds_ago
: 距离最近一次因为 SYNC 操作而进行 I/O 已经过去了多少秒。
如果主从服务器之间的连接处于断线状态,那么这个部分还会加上以下域:
master_link_down_since_seconds
: 主从服务器连接断开了多少秒。
以下是一些总会出现的域:
connected_slaves
: 已连接的从服务器数量。
对于每个从服务器,都会添加以下一行信息:
slaveXXX
: ID、IP 地址、端口号、连接状态
-
cpu
部分记录了 CPU 的计算量统计信息,它包含以下域:used_cpu_sys
: Redis 服务器耗费的系统 CPU 。used_cpu_user
: Redis 服务器耗费的用户 CPU 。used_cpu_sys_children
: 后台进程耗费的系统 CPU 。used_cpu_user_children
: 后台进程耗费的用户 CPU
-
commandstats
部分记录了各种不同类型的命令的执行统计信息,比如命令执行的次数、命令耗费的 CPU 时间、执行每个命令耗费的平均 CPU 时间等等。对于每种类型的命令,这个部分都会添加一行以下格式的信息:cmdstat_XXX:calls=XXX,usec=XXX,usecpercall=XXX
-
cluster
部分记录了和集群有关的信息,它包含以下域:cluster_enabled
: 一个标志值,记录集群功能是否已经开启。
-
keyspace
部分记录了数据库相关的统计信息,比如数据库的键数量、数据库已经被删除的过期键数量等。对于每个数据库,这个部分都会添加一行以下格式的信息:dbXXX:keys=XXX,expires=XXX
-
除上面给出的这些值以外,
section
参数的值还可以是下面这两个:all
: 返回所有信息default
: 返回默认选择的信息
-
SHUTDOWN [SAVE|NOSAVE]
-
SHUTDOWN
命令执行以下操作:- 停止所有客户端
- 如果有至少一个保存点在等待,执行
[SAVE]
命令 - 如果 AOF 选项被打开,更新 AOF 文件
- 关闭 redis 服务器(server)
如果持久化被打开的话,
SHUTDOWN
命令会保证服务器正常关闭而不丢失任何数据。
TIME
- 返回当前服务器时间。
- 返回值:一个包含两个字符串的列表: 第一个字符串是当前时间(以 UNIX 时间戳格式表示),而第二个字符串是当前这一秒钟已经逝去的微秒数。
CLIENT SETNAME connection-name
- 为当前连接分配一个名字, 新创建的连接默认是没有名字的。
- 这个名字会显示在
CLIENT LIST
命令的结果中, 用于识别当前正在与服务器进行连接的客户端。 - 要移除一个连接的名字, 可以将连接的名字设为空字符串
""
。 - 使用
CLIENT GETNAME
命令可以取出连接的名字。
CLIENT GETNAME
- 返回
CLIENT SETNAME
命令为连接设置的名字。 - 因为新创建的连接默认是没有名字的, 对于没有名字的连接,
CLIENT GETNAME
返回空白回复。
CLIENT KILL ip:port
- 关闭地址为
ip:port
的客户端。 ip:port
应该和CLIENT LIST
命令输出的其中一行匹配。- 因为 Redis 使用单线程设计,所以当 Redis 正在执行命令的时候,不会有客户端被断开连接。
- 如果要被断开连接的客户端正在执行命令,那么当这个命令执行之后,在发送下一个命令的时候,它就会收到一个网络错误,告知它自身的连接已被关闭。
CLIENT LIST
- 以人类可读的格式,返回所有连接到服务器的客户端信息和统计数据。
- 返回值中的属性:
addr
: 客户端的地址和端口fd
: 套接字所使用的文件描述符age
: 以秒计算的已连接时长idle
: 以秒计算的空闲时长flags
: 客户端 flagO
: 客户端是 MONITOR 模式下的附属节点(slave)S
: 客户端是一般模式下(normal)的附属节点M
: 客户端是主节点(master)x
: 客户端正在执行事务b
: 客户端正在等待阻塞事件i
: 客户端正在等待 VM I/O 操作(已废弃)d
: 一个受监视(watched)的键已被修改,EXEC
命令将失败c
: 在将回复完整地写出之后,关闭链接u
: 客户端未被阻塞(unblocked)A
: 尽可能快地关闭连接N
: 未设置任何 flag
db
: 该客户端正在使用的数据库 IDsub
: 已订阅频道的数量psub
: 已订阅模式的数量multi
: 在事务中被执行的命令数量qbuf
: 查询缓冲区的长度(字节为单位,0
表示没有分配查询缓冲区)qbuf-free
: 查询缓冲区剩余空间的长度(字节为单位,0
表示没有剩余空间)obl
: 输出缓冲区的长度(字节为单位,0
表示没有分配输出缓冲区)oll
: 输出列表包含的对象数量(当输出缓冲区没有剩余空间时,命令回复会以字符串对象的形式被入队到这个队列里)omem
: 输出缓冲区和输出列表占用的内存总量events
: 文件描述符事件(见下文)r
: 客户端套接字(在事件 loop 中)是可读的(readable)w
: 客户端套接字(在事件 loop 中)是可写的(writeable)
cmd
: 最近一次执行的命令
CONFIG SET parameter value
CONFIG SET
命令可以动态地调整 Redis 服务器的配置(configuration)而无须重启。CONFIG SET
修改的配置参数可以使用命令CONFIG GET *
来列出
CONFIG GET parameter
-
CONFIG GET
命令用于取得运行中的 Redis 服务器的配置参数 -
CONFIG GET
接受单个参数parameter
作为搜索关键字,查找所有匹配的配置参数,其中参数和值以“键-值对”(key-value pairs)的方式排列:比如执行
CONFIG GET s*
命令,服务器就会返回所有以s
开头的配置参数及参数 -
所有被
CONFIG SET
所支持的配置参数都可以在配置文件 redis.conf 中找到,不过CONFIG GET
和CONFIG SET
使用的格式和 redis.conf 文件所使用的格式有以下两点不同:10kb
、2gb
这些在配置文件中所使用的储存单位缩写,不可以用在CONFIG
命令中,CONFIG SET
的值只能通过数字值显式地设定。像
CONFIG SET xxx 1k
这样的命令是错误的,正确的格式是CONFIG SET xxx 1000
-
save
选项在 redis.conf 中是用多行文字储存的,但在CONFIG GET
命令中,它只打印一行文字。
CONFIG RESETSTAT
- 重置
INFO
命令中的某些统计数据,包括:- Keyspace hits (键空间命中次数)
- Keyspace misses (键空间不命中次数)
- Number of commands processed (执行命令的次数)
- Number of connections received (连接服务器的次数)
- Number of expired keys (过期key的数量)
- Number of rejected connections (被拒绝的连接数量)
- Latest fork(2) time(最后执行 fork(2) 的时间)
- The
aof_delayed_fsync
counter(aof_delayed_fsync
计数器的值)
CONFIG REWRITE
CONFIG REWRITE
命令对启动 Redis 服务器时所指定的redis.conf
文件进行改写: 因为CONFIG SET
命令可以对服务器的当前配置进行修改, 而修改后的配置可能和redis.conf
文件中所描述的配置不一样,CONFIG REWRITE
的作用就是通过尽可能少的修改, 将服务器当前所使用的配置记录到redis.conf
文件中。- 重写会以非常保守的方式进行:
- 原有
redis.conf
文件的整体结构和注释会被尽可能地保留。 - 如果一个选项已经存在于原有
redis.conf
文件中 , 那么对该选项的重写会在选项原本所在的位置(行号)上进行。 - 如果一个选项不存在于原有
redis.conf
文件中, 并且该选项被设置为默认值, 那么重写程序不会将这个选项添加到重写后的redis.conf
文件中。 - 如果一个选项不存在于原有
redis.conf
文件中, 并且该选项被设置为非默认值, 那么这个选项将被添加到重写后的redis.conf
文件的末尾。 - 未使用的行会被留白。 比如说, 如果你在原有
redis.conf
文件上设置了数个关于save
选项的参数, 但现在你将这些save
参数的一个或全部都关闭了, 那么这些不再使用的参数原本所在的行就会变成空白的。
- 原有
- 即使启动服务器时所指定的
redis.conf
文件已经不再存在,CONFIG REWRITE
命令也可以重新构建并生成出一个新的redis.conf
文件。 - 另一方面, 如果启动服务器时没有载入
redis.conf
文件, 那么执行CONFIG REWRITE
命令将引发一个错误。 - 对
redis.conf
文件的重写是原子性的, 并且是一致的: 如果重写出错或重写期间服务器崩溃, 那么重写失败, 原有redis.conf
文件不会被修改。 如果重写成功, 那么redis.conf
文件为重写后的新文件。
PING
- 使用客户端向 Redis 服务器发送一个
PING
,如果服务器运作正常的话,会返回一个PONG
。 - 通常用于测试与服务器的连接是否仍然生效,或者用于测量延迟值
ECHO message
- 打印一个特定的信息
message
,测试时使用。 ECHO "Hello Moto"