PING

返回服务器的活跃度响应。

语法

PING [message]

引入版本:1.0.0

复杂度摘要:O(1)

如果未提供参数,此命令将返回简单字符串 PONG,否则它将返回所提供的 message 的副本作为批量字符串。

该命令可用于: 1. 测试连接是否仍然有效。 1. 验证服务器提供数据的能力 - 如果情况并非如此(例如,从持久性数据加载或访问过时的副本期间),则会返回错误。 1. 测量延迟。

如果 RESP2 客户端订阅了通道、模式或分片通道,PING 将返回一个二元素数组。第一个元素是批量字符串 pong(小写)。第二个是 message 的副本(如果您提供),或者是空的批量字符串(如果您不提供)。无论是否订阅,RESP3 客户端都会收到标准回复。

可选参数

message

返回一条消息而不是PONG。

示例

redis> PING
PONG
redis> PING "hello world"
"hello world"

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
✅ 标准
✅ 主动-主动
✅ 标准
✅ 主动-主动

返回值

RESP2

以下任意一项: * 简单字符串回复:未提供参数时为 PONG。 * 批量字符串回复:提供的参数。 * 数组回复:当客户端处于订阅模式时,“pong”以及提供的参数或空的批量字符串。

RESP3

以下任意一项: * 简单字符串回复:未提供参数时为 PONG。 * 批量字符串回复:提供的参数。

资料来源:Redis 官方 PING 文档;中文内容参考 Redis 文档许可。