redis2_raw_query
redis2_raw_query 指令在 NGINX 配置中将原始查询字符串发送到 Redis 服务器。
NGINX upstream module for the Redis 2.0 protocol
·
locationif in location
语法redis2_raw_query string;
默认值none
上下文location, if in location
参数1
说明
redis2_raw_query 指令允许直接从 NGINX 配置提交原始、预格式化的 Redis 命令。对于需要构造复杂 Redis 命令、这些命令可能无法与传统方法调用对齐,或当您希望在配置层使用现有命令语法而无需额外解析时,这很有用。通过指定该指令,用户可以以 Redis 识别的格式编写查询(可能包括 multi-bulk 命令),并将它们不做任何修改地直接发送到 Redis 服务器。
该指令接受一个参数,即包含 Redis 命令的字符串。该命令必须遵循标准 Redis 协议格式,包括适当的 CRLF(回车和换行)序列。例如,检索一个值的基本命令可以写成 get key\r\n。这种直接方式对需要高级命令实现或优化的情况尤为有利,在这些情况下使用原生 Redis 命令比传统的 NGINX API 调用更为合适。
配置示例
location = /bar {
redis2_raw_query 'get one
';
redis2_pass 127.0.0.1:6379;
}⚠
请确保命令字符串根据 Redis 协议正确格式化;否则,Redis 会返回错误。
⚠
该命令必须以 CRLF 序列结尾,才能被 Redis 服务器识别为有效。
⚠
如果错误使用此指令,可能会导致意外行为,因为命令以原始字符串的形式发送。