©
本文档使用
php.cn手册 发布
SHUTDOWN [NOSAVE|SAVE]
自1.0.0起可用。
命令行为如下:
停止所有的客户端。
如果至少配置了一个保存点,则执行阻塞保存。
如果启用了 AOF ,请刷新仅附加文件。
退出服务器。
如果启用了持久性,则此命令可确保 Redis 在不丢失任何数据的情况下关闭。如果客户端仅使用 SAVE ,然后退出,则不能保证,因为其他客户端可能会更改这两个命令之间的数据库数据。
注意:配置为不保存在磁盘上的 Redis 实例(未配置 AOF ,也未配置 “save” 指令)不会将 RDB 文件转储到 SHUTDOWN 上,因为通常不希望 Redis 实例仅用于缓存以阻止关闭。
可以指定一个可选的修饰符来改变命令的行为。特别:
即使未配置保存点,SHUTDOWN SAVE 也会强制执行 DB 保存操作。
即使配置了一个或多个保存点,SHUTDOWN NOSAVE 也会阻止数据库保存操作。(你可以把这个变种看作是一个假设的 ABORT 命令,它只是停止服务器)。
当仅附加文件启用时,关机可能失败,因为系统处于不允许安全立即保留在磁盘上的状态。
通常情况下,如果有一个 AOF 子进程执行 AOF 重写,则 Redis 将简单地杀死它并退出。但是,有两种情况不安全,因此 SHUTDOWN 命令将被拒绝并返回错误。发生这种情况时:
用户刚打开 AOF ,服务器触发了第一次AOF重写,以创建初始 AOF 文件。在这种情况下,停止将导致完全丢失数据集:一旦重新启动,服务器可能会启用 AOF ,而根本没有任何 AOF 文件。
启用了 AOF 的从站,与其主站重新连接,执行完全重新同步,并重新启动 AOF 文件,触发初始 AOF 创建过程。在这种情况下,不完成 AOF 重写是很危险的,因为从主设备收到的最新数据集将丢失。新的主服务器实际上可以是一个不同的实例(如果 SLAVEOF 命令用于重新配置从服务器),所以重要的是完成 AOF 重写并在服务器启动时使用表示内存中数据集的正确数据集被终止。
有条件的时候,我们只想尽快终止一个 Redis 实例,不管它的内容是什么。在这种情况下,命令的正确组合是发送 CONFIG 附加否,然后是 SHUTDOWN NOSAVE 。如果需要,第一个命令将关闭 AOF ,如果有一个活动的话,将终止 AOF 重写子。由于 AOF 不再被启用,第二个命令不会执行任何问题。
简单的字符串回复错误。成功后,服务器退出并关闭连接后不会返回任何内容。