首页 > 数据库 >Redis协议规范简介

Redis协议规范简介

时间:2024-06-19 17:28:18浏览次数:28  
标签:返回 错误 简介 RESP Redis 规范 字符串 客户端

Redis客户端使用为名为RESP(Redis序列化协议)的协议与Redis服务器进行通信。虽然该协议是专门为Redis设计的,但它也可以用于其他的CS软件项目的通信协议。

RESP可以序列化不同的数据类型,如整型,字符串,数组。 还有⼀种特定的错误类型。 请求将要执行的
命令作为字符串数组从Redis客户端发送到Redis服务器。Redis使用特定数据类型的命令进行回复。
RESP是二进制安全的,不需要处理从⼀个进程传输到另⼀个进程的批量数据,因为它使用前缀长度来传输
批量数据。

注:该协议仅用于客户端——服务器通信。 Redis Cluster使用不同的二进制协议,以便在节点之间交换信息。

网络层

客户端通过TCP连接到端口6379,虽然RESP在技术上是非TCP特定的,但是在Redis上下文中,协议仅用于TCP连接。

请求——相应模型

Redis接受不同参数组成的命令。这是最简单的模型,但有两个例外:

  • Redis支持流水线操作。因此,客户端可以一次发送多个命令,并等待稍后的回复。
  • Redis客户端处于Pub/Sub时,协议会更改语义并成为推送协议,即客户端不再发送命令,因为服务器会在它们接收到命令时自动向客户端发送新消息。

RESP协议描述

RESP协议在Redis1.2中引入,在2.0中称为Redis服务器通信的标准方式。

支持以下类型:单行字符串、错误信息、整型、多行字符串和数组。

RESP根据通过数据的第一个字节判断它的类型:

  • 单行(Simple Strings)回复:“+”
  • 错误(Errors)信息:“-”
  • 整型数字(Integers):“:”
  • 多行字符串(Bulk Strings): “$”
  • 数组(Arrays): “*”

RESP中,协议的不同部分始终以"\r\n"结束。

注:执行同样的命令,错误和正确的返回类型可能相同也可能不相同。

  • SETNX错误和正确的返回类型一致(Integers),都是以整数的形式返回。
  • INCR错误的时候返回错误信息(Errors),正确的时候返回整型(Integers)。

RESP 单行字符串(+ Simple Strings)

简单字符串按以下方式编码:+号字符,后跟不能包含CR或LF字符的字符串(不允许换行),由CRLF终
止(即“\ r \ n”,对应十六进制 0x0D,0x0A)。

Simple Strings用于以最小的开销传输非⼆进制安全字符串。 例如,很多Redis命令成功回复时只
有“OK”,因为RESP 单行字符串使用以下5个字节进行编码:

"+OK\r\n"

RESP 错误信息(- Errors)

RESP中单行字符串和错误之间的真正区别在于客户端将错误视为异常,组成错误类型的字符串是错误消息
本身。

基本格式如下:

"-Error message\r\n"

错误回复仅在发生错误时发送,例如,如果您尝试对错误的数据类型执⾏操作,或者命令不存在等等。 收
到错误回复时,客户端应将异常抛出。

以下是错误回复的实例:

-ERR unknown command 'foobar'
-WRONGTYPE Operation against a key holding the wrong kind of value

“-”之后的第⼀个单词,直到第⼀个空格或换行符,表示返回的错误类型。 这只是Redis使用的约定,不是
RESP错误格式的⼀部分。
例如,ERR是⼀般错误,而WRONGTYPE是⼀个更具体的错误,意味着客户端尝试对错误的数据类型执行
操作。 这称为错误前缀,是⼀种允许客户端理解服务器返回的错误类型的方法,而不依赖于给定的确切消
息,这可能随时间而变化。
客户端实现可以针对不同的错误返回不同类型的异常,或者可以通过直接将错误名称作为字符串提供给调
用者来提供捕获错误的通用方法。
但是,这样的功能不应该被认为是至关重要的,因为它很少有用,并且有限的客户端实现可能只返回通用
的错误条件,例如false。

127.0.0.1:6379> SET teacher darren
OK
127.0.0.1:6379> INCR teacher
(error) ERR value is not an integer or out of range

在这里插入图片描述

RESP 整型数据(: Integers)

此类型只是⼀个CRLF终止的字符串,表示⼀个以“:”字节为前缀的整数。 例如“:0\r\n”或“:1000\r\n”是整数回复。

许多Redis命令返回RESP 整型,如INCR, LLEN 和LASTSAVE。返回的整数没有特殊含义,它只是INCR的增量值,LASTSAVE的UNIX时间等等。 但是,返回的整数应保证在有符号的64位整数范围内。

整数回复也被广泛使用,以便返回真或假。 例如,EXISTS或SISMEMBER之类的命令将返回1表示true,0表示false。如果实际执行操作,其他命令(如SADD,SREM和SETNX)将返回1,否则返回0。
以下命令将回复整数回复:SETNX,DEL,EXISTS,INCR,INCRBY,DECR,DECRBY,DBSIZE,LASTSAVE,RENAMENX,MOVE,LLEN,SADD,SREM,SISMEMBER,SCARD。

RESP 多行字符串($ Bulk Strings)

多行字符串用于表示长度最大为512MB的单个二进制安全字符串。

多行字符串按照以下方式编码:

  • 一个"$"字节后跟组成字符串的字节数(一个前缀长度),由CRLF终止。
  • 字符串数据。
  • 最终的CRLF。

示例如下:

"$6\r\nfoobar\r\n"
"$0\r\n\r\n"
"$-1\r\n"

最后一种特殊格式表示Null值,不存在。

RESP 数组(* Arrays)

客户端使⽤RESP 数组将命令发送到Redis服务器。 类似地,某些Redis命令将元素集合返回给客户端使用RESP 数组是回复类型。 ⼀个例子是LRANGE命令,它返回列表的元素。

RESP数组使用以下格式发送:

  • *字符作为第一个字节,后跟数组中的元素个数作为十进制数,后跟CRLF。
  • 数组的每个元素的附加RESP类型。
"*0\r\n"
"*2\r\n$3\r\nfoo\r\n$3\r\nbar\r\n"
"*3\r\n:1\r\n:2\r\n:3\r\n"

发送命令到Redis服务端

  • 客户端向Redis服务器发送仅有Bulk Strings组成的RESP阵列。
  • Redis服务器回复发送任何有效的RESP数据类型作为客户端的恢复。

比如客户端发送命令LLEN mylist以获取存储在密钥mylist中的列表长度,服务器回复一个Integer如下所示:C是客户端,S是服务器

C: *2\r\n
C: $4\r\n
C: LLEN\r\n
C: $6\r\n
C: mylist\r\n
S: :48293\r\n

通常我们将协议的不同部分与换行符分开以化简,但是实际的交互是客户端发送* 2 \ r \ n $ 4 \ r \n LLEN \ r \ n $ 6 \ r \ nmylist \ r \ n整体。

最后给大家推荐一个LinuxC/C++高级架构系统教程的学习资源与课程,可以帮助你有方向、更细致地学习C/C++后端开发,具体内容请见 https://xxetb.xetslk.com/s/1o04uB

标签:返回,错误,简介,RESP,Redis,规范,字符串,客户端
From: https://blog.csdn.net/Faya__/article/details/139803796

相关文章

  • 开发Prometheus的redis bigkey exporter,完善k8s下redis容器的性能监控
      好久没来博客园写技术总结了,回顾这些年的职业路径,从自动化测试到python后端到golang后端直到现在的devops,确实积累了很多心得,可惜都没时间来写写这些心得(主要是懒)。自从转为devops后确实有比较多的时间了(主要是加班少:)),看来以后还是要多写写技术总结:)。   废话不......
  • Redis(缓存)
    Redis(缓存)1、Redis是什么?Redis(RemoteDictionaryServer)是一种开源(BSD许可)的内存数据结构存储系统。它可以用作数据库、缓存和消息代理。以下是Redis的一些关键特性:数据结构丰富:支持字符串(strings)、哈希(hashes)、列表(lists)、集合(sets)、有序集合(sortedsets)、位图(bitmaps)、H......
  • 接口设计规范
    前言在实际工作中,我们需要经常跟第三方平台打交道,可能会对接第三方平台API接口,或者提供API接口给第三方平台调用。那么问题来了,如何设计一个优雅的API接口,能够满足:安全性、可重复调用、稳定性、好定位问题等多方面需求?今天跟大家一起聊聊设计API接口时,需要注意的一些地方,希......
  • [转帖]Redis中删除过期Key的三种策略
    Redis对于过期键有三种清除策略被动删除:当读/写一个已经过期的key时,会触发惰性删除策略,直接删除掉这个过期key主动删除:由于惰性删除策略无法保证冷数据被及时删掉,所以Redis会定期主动随机淘汰一批已过期的key当前已用内存超过maxmemory限定时,触发主动清理策......
  • Redis 缓存
    文章目录安装redis启动redis简单使用redis安装Redis-Desktop-Manager配置pom文件配置application.properties配置Redis缓存管理器配置service层运行项目安装redis下载地址:https://github.com/tporadowski/redis/releases教程:https://blog.csdn.net/m0_62617719/article......
  • 代码规范性思考
    表命名和设计业务模块前缀;下划线分隔,体现业务含义;数据库字符集、字段名、类型、长度、默认值;一对一、一对多、多对多建表;注释清晰;良好的索引;接口文档swagger增强工具swagger-bootstrap-ui、Knife4j通用出入参包装类RestRequest<T>、RestResponse<T>入参校验@Validated注......
  • redis——P2:对P1的思考
    到P1结束,redis都已经是一个不错的服务了,具体体现在缓存应用程序需要的数据,甚至在内存爆满的条件下还可以提供服务,似乎目的已经达成。但是实际上可能会遇到一些极端的情况,比如宕机。如果redis宕机了怎么办?目前所有的数据都存储在内存当中,宕机意为着失去所有缓存的数据。前面说过我......
  • redis——P3:持久化
    虽然缓存功能已经实现,但是作为对外提供服务的软件开发者,不能只关注是否提供了正确的服务,稳定和快速恢复等等指标是同样非常非常重要的。考虑这样一个问题,redis确实因为不可抗力宕机了(假设我喜欢黑框框打开,然后手贱按了^C),于是瞬间redis里所有缓存全没了?这对于一个追求高性能、高可......
  • redis——基础服务
    首先为什么要做一个redis出来?数据库不够用了吗?考虑到原本的应用程序是客户端访问服务端,服务端访问业务数据需要去数据库去拿,而数据库是个持久化的应用程序,是需要磁盘IO的,这就导致了速度会慢,并且如果存在大量的访问,会导致数据库崩溃。除去导致崩溃这样严重且极端的情况,这点性能虽然......
  • python 注册nacos 进行接口规范定义
    背景:一般场景python服务经常作为java下游的算法服务或者数据处理服务但是使用http去调用比较不灵活,通过注册到nacos上进行微服务调用才是比较爽的1.定义feginapi的接口定义java端定义接口请求和响应主要关注CommonResult结构和python要一直,不然序列号是有问题的Co......