MySQL 协议（非常详细适合小白学习）

MySQL 查询过程

---

MySQL 查询过程大致如下：

1）客户端与服务器端建立连接；

2）客户端登陆 MySQL；

3）客户端向服务器端发起一条请求；

4）服务器端先检查查询缓存，如果命中缓存，则直接返回结果；否则交给下一阶段；

5）服务器进行 SQL 解析并生成解析树及执行计划（初始执行计划）；

6）服务器对解析树进行查询优化（RBO、CBO）并生成最终执行计划；

7）MySQL 根据执行计划，调用相应 API，以进行数据的读取；

8）将从存储引擎读取的结果返回给客户端，并缓存查询结果。

客户端与服务端交互过程

---

MySQL 客户端与服务器的交互主要分为三个阶段：握?认证、命令执?、挥?断开连接。MySQL客户端与服务器的完整交互过程如下：

握手认证阶段

---

握手认证阶段在客户端与服务器建立连接后进行（即在三次握手后进行），交互过程如下：

1）服务器 ===> 客户端：握手初始化消息；由 MySQL 服务器主动发送一个认证的握手数据包；

2）客户端 ===> 服务端：登陆认证消息；客户端收到握手数据包后，将用户的信息（用户名、密码、数据库等信息）打包发送给 MySQL 服务器；

3）服务端 ===> 客户端：认证结果消息；MySQL 服务端认证，返回认证结果给客户端；

• 认证成功：如果服务器通过认证，则发送一个 Ok_pack 包给客户端；
• 认证失败：如果服务器没有通过认证，，则发送一个 error_pack 包；

注：此处握手和三次握手不是一回事；

问题一：MySQL 客户端与服务器连接过程中，进行了 TCP/IP 的三次握手后，为什么还需要握手认证阶段，这两次握手分别起着什么样的作用？

进行 TCP/IP 三次握手是为了确保客户端和服务器的网络层正确建立连接，并协商传输层使用的端口和通信协议。通过三次握手，客户端和服务器能够确认双方的发送和接收能力，并避免由于网络问题导致的连接错误。然而，仅仅进行 TCP/IP 三次握手并不能保证客户端的身份是可信的。因此，在建立了可靠的连接之后，还需要进行握手认证阶段。在这个阶段，客户端需要向服务器提供身份验证信息，如用户名、密码等，以证明自己的身份。服务器会验证客户端提供的身份验证信息，并决定是否允许该客户端建立连接。

问题二：在握手认证阶段，为什么服务器会主动发送一个认证的握手数据包？

这个握手数据包包含了服务器用于身份验证的信息，如：协议版本号、服务器版本号、服务器权能标志等（即握手初始化报文中的信息）。这些信息用于告诉客户端服务器的身份和所使用的协议版本，以便客户端能够进行正确的身份验证和后续的通信。

在握手过程中，客户端也会发送自己的身份验证信息，如：用户名、数据库名和密码等，来证明自己的身份。客户端和服务器之间会进行双向的身份验证，确保连接的安全性。

命令执行阶段

---

客户端认证成功后，会进入命令执行阶段，交互过程如下：

1）客户端 ===> 服务端：执行命令消息；客户端认证成功后，接下来就可以给 MySQL 服务器发送命令操作数据库，这里用到命令数据包格式；

2）服务器 ===> 客户端：命令执行结果；当 MySQL 服务器成功执行命令后，根据命令类型返回响应结果，并将结果发送给客户端；

• 返回命令执行状态：诸如 insert、delect、update 命令，若执行成功，则返回 ok_pack，反之返回 error_pack；
• 返回结果集：诸如 select 命令，若执行成功，则返回 ResultSetPacket 数据包，反之返回 error_pack；

挥手断开连接阶段

---

当客户端执行完命令，需要断开连接时，会主动给服务器发送一个 COM_CLOSE 数据包，接下来就是四次挥手结束连接过程；

基本数据类型

---

MySQL 协议中的基本数据类型主要包括：整型和字符串；

二进制数据（长度编码）（Length Coded Binary）

---

无论是整型还是字符串，在二进制状态下都需要前导的长度字段来标识数据所占用的长度。为了节约空间，长度字段使用变长方式编码。

由于数据长度不固定，长度值由数据的前 1-9 个字节决定，其中长度值所占的字节数不定，字节数由第 1 个字节决定。

同上，根据上下文的不同，第一个字节也可能具有其它含义，具体如下表：

第一个字节值	后续字节数	长度值说明
0-250（0x00~0xfa）	0	第一个字节值即为数据的真实长度
251（0xfb）	0	空数据，数据的真实长度为零
252（0xfc）	2	后续额外2个字节标识了数据的真实长度
253（0xfd）	3	后续额外3个字节标识了数据的真实长度
254（0xfe）	8	后续额外8个字节标识了数据的真实长度
255（0xff）	0	表示该数据包为 1 个 ERR_Packet

整型类型

---

MySQL 报文中整型值使用小端字节序传输，具体分为两种类型：定长整型（Fixed-Length Integer Types）和带长度编码整型（Length-Encoded Integer Type）：

1）定长整型（Fixed-Length Integer Types）：一个固定长度的无符号整数，将其值存储在一系列字节中，具体固定字节数可以是：1，2，3，4，5，6，7，8；

2）带长度编码整型（Length-Encoded Integer Type）：存储需要的字节数取决于第一个字节数值的大小，具体可以参照如下：

• 如果该值 < 251，则将其存储为一个字节整数；
• 如果该值 ≥ 251，则将其存储为 fc + 2 字节整数；
• 如果该值 ≥ 2^16 且 < 2^24，则将其存储为 fd + 3 字节整数；
• 如果该值 >= 2^24 且 < 2^64，则它将存储为 fe + 8 字节整数；

如果要将长度编码的整数转换为其数值，需要先检查第一个字节：

• 如果它是
• 如果它是 0xfc（252），则它后面跟着一个 2 个字节的整数；
• 如果它是 0xfd（253），则它后面跟着一个 3 字节的整数；
• 如果它是 0xfe（254），则它后面跟着一个 8 字节的整数；

注：如果数据包的第一个字节是长度编码的整数且其字节值为 0xfe（254），则必须检查数据包的长度以验证它是否有足够的空间存储 8 个字节的整数，若不足以存储 8 字节的整数，则可能是一个 EOF_Packet 包；

字符串类型

---

字符串类型主要包括：FixedLengthString，NullTerminatedString，VariableLengthString， LengthEncodedString和RestOfPacketString 5种；

1）定长字符串（FixedLengthString）：固定长度的字符串具有已知的硬编码长度，比如：ERR_Packet 的 SQL 状态，它总是 5 个字节长；

2）以 NULL 结尾的字符串（NullTerminatedString）：字符串?度不固定，当遇到 'NULL'（0x00）字符时结束；

3）可变长度字符串（VariableLengthString）：字符串的?度由另?个字段决定，且在运?时计算，?如 int + value，分别为?度和指定?度的字节数；

4）长度编码字符串（LengthEncodedString）：以描述字符串?度的?度编码的整数作为前缀的字符串，是 VariableLengthString 指定的 int+value?式；

5）剩余包字符串（RestOfPacketString）：如果?个字符串是数据包的最后?个组件，它的?度可以从整个数据包?度减去当前位置来计算；

报文结构

---

报文分为消息头和消息体两部分，其中消息头占用固定的 4 个字节，消息体长度由消息头中的长度字段决定，报文结构如下：

消息头

---

消息头由报文长度和序号组成，具体如下：

1）报文长度：用于标记当前请求消息的实际数据长度值，以字节为单位，占用3个字节，最大值为 0xFFFFFF，即接近 16 MB 大小（比16MB少1个字节）；

2）序号：在一次完整的请求/响应交互过程中，用于保证消息顺序的正确，每次客户端发起请求时，序号值都会从 0 开始计算。

注：?个 MySQL 消息的最??度为16MB，超过该?度需要拆包，每次拆包后，序号 +1；每?次执? sql，packet_number 清零（sql/net_serv.c:net_clear）；

消息体

---

消息体用于存放请求的内容及响应的数据，长度由消息头中的长度值决定。

报文类型

---

报文类型大致包含以下几种：handshake、auth、ok|error、resultset（header、field、eof、row）、command packet，下面对其逐一展开介绍。

登陆认证交互报文

---

握手初始化报文（服务器 ===> 客户端）

1）协议版本号：指的是客户端与服务器端之间使用的 MySQL 协议的版本。这个版本号用于确保客户端和服务器段能够正确地解析和通信。该值由 PROTOCOL_VERSION 宏定义决定（参考 MySQL 源代码 /include/mysql_version.h 头文件定义）；

2）服务器版本信息：用于告诉客户端服务器所使用的 MySQL 版本，以便客户端能够根据服务器版本的不同采取不同的处理方式或使用不同的协议特性。服务器版本信息通常是一个字符串，包含了 MySQL 的版本号、构建日期、操作系统等信息。该值为字符串，由 MYSQL_SERVER_VERSION 宏定义决定（参考 MySQL 源代码 /include/mysql_version.h 头文件定义）；

3）服务器线程 ID：服务器为当前连接所创建的线程 ID；

4）挑战随机数：MySQL 数据库用户认证采用的是挑战/应答的方式，服务器生成该挑战数并发送给客户端，由客户端进行处理并返回相应结果，然后服务器检查是否与预期的结果相同，从而完成用户认证的过程；（挑战随机数是一个随机生成的字节序列，用于验证客户端的身份。当客户端连接到服务器时，服务器会生成一个挑战随机数，并将其发送给客户端。客户端收到挑战随机数后，需要使用之前协商好的密码或其他凭据对挑战随机数进行加密或散列处理，然后将结果发送给服务器。服务器使用相同的密码或其他凭据对挑战随机数进行同样的处理，并与客户端发送的结果进行比较。如果结果相同，则验证客户端的身份成功，否则验证失败。）

注：通过使用挑战随机数，可以增加暴力破解或重放攻击的难度，提高 MySQL 通信的安全性。同时，挑战随机数也可以用于防止中间人攻击，确保客户端和服务器之间的通信不被窃听或篡改。

5）服务器权能标志：用于与客户端协商通讯方式的标志位集合。这些标志位包含了服务器所支持的各种功能和参数，以便客户端能够根据自身需求和服务器的能力进行协商。该标志用于与客户端协商通讯的方式，各标志位含义如下（参考 MySQL 源代码 /include/mysql_com.h 中的宏定义）：

标志位名称	标志位	说明
CLIENT_LONG_PASSWORD	0x0001	new more secure passwords
CLIENT_FOUND_ROWS	0x0002	Found instead of affected rows
CLIENT_LONG_FLAG	0x0004	Get all column flags
CLIENT_CONNECT_WITH_DB	0x0008	One can specify db on connect
CLIENT_NO_SCHEMA	0x0010	Do not allow database.table.column
CLIENT_COMPRESS	0x0020	Can use compression protocol
CLIENT_ODBC	0x0040	Odbc client
CLIENT_LOCAL_FILES	0x0080	Can use LOAD DATA LOCAL
CLIENT_IGNORE_SPACE	0x0100	Ignore spaces before '('
CLIENT_PROTOCOL_41	0x0200	New 4.1 protocol
CLIENT_INTERACTIVE	0x0400	This is an interactive client
CLIENT_SSL	0x0800	Switch to SSL after handshake
CLIENT_IGNORE_SIGPIPE	0x1000	IGNORE sigpipes
CLIENT_TRANSACTIONS	0x2000	Client knows about transactions
CLIENT_RESERVED	0x4000	Old flag for 4.1 protocol
CLIENT_SECURE_CONNECTION	0x8000	New 4.1 authentication
CLIENT_MULTI_STATEMENTS	0x0001 0000	Enable/disable multi-stmt support
CLIENT_MULTI_RESULTS	0x0002 0000	Enable/disable multi-results

6）字符编码：标识服务器所使用的字符集；

7）服务器状态：服务器状态指的是服务器当前所处的状态信息，这些状态信息用于向客户端提供服务器的运行状况和配置情况。状态值定义如下（参考MySQL源代码 /include/mysql_com.h 中的宏定义）；

状态名称	状态值
SERVER_STATUS_IN_TRANS	0x0001
SERVER_STATUS_AUTOCOMMIT	0x0002
SERVER_STATUS_CURSOR_EXISTS	0x0040
SERVER_STATUS_LAST_ROW_SENT	0x0080
SERVER_STATUS_DB_DROPPED	0x0100
SERVER_STATUS_NO_BACKSLASH_ESCAPES	0x0200
SERVER_STATUS_METADATA_CHANGED	0x0400

登陆认证报文（客户端 ===> 服务端）

MySQL 4.1 之前版本

MySQL 4.1 之后版本

1）客户端权能标志：用于与客户端协商通讯方式，标志位含义与握手初始化报文中的相同。客户端收到服务器发来的初始化报文后，会对服务器发送的权能标志进行修改，保留自身所支持的功能，然后将权能标志返回给服务器，从而保证服务器与客户端通讯的兼容性；

2）最大消息长度：客户端发送请求报文时所支持的最大消息长度值；

3）字符编码：标识通讯过程中使用的字符编码，与服务器在认证初始化报文中发送的相同；

4）用户名：客户端登陆用户的用户名称；

5）挑战认证数据：客户端用户密码使用服务器发送的挑战随机数进行加密后，生成挑战认证数据，然后返回给服务器，用于对用户身份的认证；

6）数据库名称：当客户端的权能标志位 CLIENT_CONNECT_WITH_DB 被置位时，该字段必须出现；

客户端命令请求报文（客户端 ===> 服务端）

---

1）命令：用于标识当前请求消息的类型，例如切换数据库（0x02）、查询命令（0x03）等。命令值的取值范围及说明如下表（参考 MySQL 源代码 /include/mysql_com.h 头文件中的定义）：

类型值	命令	功能	关联函数
0x00	COM_SLEEP	（内部线程状态）	（无）
0x01	COM_QUIT	关闭连接	mysql_close
0x02	COM_INIT_DB	切换数据库	mysql_select_db
0x03	COM_QUERY	SQL查询请求	mysql_real_query
0x04	COM_FIELD_LIST	获取数据表字段信息	mysql_list_fields
0x05	COM_CREATE_DB	创建数据库	mysql_create_db
0x06	COM_DROP_DB	删除数据库	mysql_drop_db
0x07	COM_REFRESH	清除缓存	mysql_refresh
0x08	COM_SHUTDOWN	停止服务器	mysql_shutdown
0x09	COM_STATISTICS	获取服务器统计信息	mysql_stat
0x0A	COM_PROCESS_INFO	获取当前连接的列表	mysql_list_processes
0x0B	COM_CONNECT	（内部线程状态）	（无）
0x0C	COM_PROCESS_KILL	中断某个连接	mysql_kill
0x0D	COM_DEBUG	保存服务器调试信息	mysql_dump_debug_info
0x0E	COM_PING	测试连通性	mysql_ping
0x0F	COM_TIME	（内部线程状态）	（无）
0x10	COM_DELAYED_INSERT	（内部线程状态）	（无）
0x11	COM_CHANGE_USER	重新登陆（不断连接）	mysql_change_user
0x12	COM_BINLOG_DUMP	获取二进制日志信息	（无）
0x13	COM_TABLE_DUMP	获取数据表结构信息	（无）
0x14	COM_CONNECT_OUT	（内部线程状态）	（无）
0x15	COM_REGISTER_SLAVE	从服务器向主服务器进行注册	（无）
0x16	COM_STMT_PREPARE	预处理SQL语句	mysql_stmt_prepare
0x17	COM_STMT_EXECUTE	执行预处理语句	mysql_stmt_execute
0x18	COM_STMT_SEND_LONG_DATA	发送BLOB类型的数据	mysql_stmt_send_long_data
0x19	COM_STMT_CLOSE	销毁预处理语句	mysql_stmt_close
0x1A	COM_STMT_RESET	清除预处理语句参数缓存	mysql_stmt_reset
0x1B	COM_SET_OPTION	设置语句选项	mysql_set_server_option
0x1C	COM_STMT_FETCH	获取预处理语句的执行结果	mysql_stmt_fetch

2）参数：内容是用户在 MySQL 客户端输入的命令（不包括每行命令结尾的";"分号）。另外这个字段的字符串不是以 NULL 字符结尾，而是通过消息头中的长度值计算而来；

例如：当我们在 MySQL 客户端中执行 use hutaow; 命令时（切换到 hutaow 数据库），发送的请求报文数据会是下面的样子：

0x02 0x68 0x75 0x74 0x61 0x6f 0x77

其中，0x02 为请求类型值 COM_INIT_DB，后面的 0x68 0x75 0x74 0x61 0x6f 0x77 为 ASCII 字符 hutaow。

COM_QUIT 消息报文

功能：关闭当前连接（客户端退出），无参数。

COM_INIT_DB 消息报文

功能：切换数据库，对应的 SQL 语句为 USE 。

字节	说明
n	数据库名称（字符串到达消息尾部时结束，无结束符）

COM_QUERY 消息报文

功能：最常见的请求消息类型，当用户执行 SQL 语句时发送该消息。

字节	说明
n	SQL语句（字符串到达消息尾部时结束，无结束符）

COM_FIELD_LIST 消息报文

功能：查询某表的字段（列）信息，等同于 SQL 语句 SHOW [FULL] FIELDS FROM ...。

字节	说明
n	表格名称（Null-Terminated String）
n	字段（列）名称或通配符（可选）

示例如下：

COM_CREATE_DB 消息报文

功能：创建数据库，该消息已过时，而被 SQL 语句 CREATE DATABASE 代替。

字节	说明
n	数据库名称（字符串到达消息尾部时结束，无结束符）

COM_DROP_DB 消息报文

功能：删除数据库，该消息已过时，而被 SQL 语句 DROP DATABASE 代替。

字节	说明
n	数据库名称（字符串到达消息尾部时结束，无结束符）

COM_REFRESH 消息报文

功能：清除缓存，等同于 SQL 语句 FLUSH，或是执行 mysqladmin flush-foo 命令时发送该消息。

字节	说明
1	清除缓存选项（位图方式存储，各标志位含义如下）
	0x01: REFRESH_GRANT
	0x02: REFRESH_LOG
	0x04: REFRESH_TABLES
	0x08: REFRESH_HOSTS
	0x10: REFRESH_STATUS
	0x20: REFRESH_THREADS
	0x40: REFRESH_SLAVE
	0x80: REFRESH_MASTER

COM_SHUTDOWN 消息报文

功能：停止 MySQL 服务，执行 mysqladmin shutdown 命令时发送该消息。

字节	说明
1	停止服务选项
	0x00: SHUTDOWN_DEFAULT
	0x01: SHUTDOWN_WAIT_CONNECTIONS
	0x02: SHUTDOWN_WAIT_TRANSACTIONS
	0x08: SHUTDOWN_WAIT_UPDATES
	0x10: SHUTDOWN_WAIT_ALL_BUFFERS
	0x11: SHUTDOWN_WAIT_CRITICAL_BUFFERS
	0xFE: KILL_QUERY
	0xFF: KILL_CONNECTION

COM_STATISTICS 消息报文

功能：查看 MySQL 服务的统计信息（例如运行时间、每秒查询次数等）。执行 mysqladmin status 命令时发送该消息，无参数。

COM_PROCESS_INFO 消息报文

功能：获取当前活动的线程（连接）列表。等同于 SQL 语句 SHOW PROCESSLIST，或是执行 mysqladmin processlist 命令时发送该消息，无参数。

示例结果：

COM_PROCESS_KILL 消息报文

功能：要求服务器中断某个连接。等同于 SQL 语句 KILL 。

字节	说明
4	连接ID号（小字节序）

COM_DEBUG 消息报文

功能：要求服务器将调试信息保存下来，保存的信息多少依赖于编译选项设置（debug=no|yes|full）。执行 mysqladmin debug 命令时发送该消息，无参数。

COM_PING 消息报文

功能：该消息用来测试连通性，同时会将服务器的无效连接（超时）计数器清零。执行 mysqladmin ping 命令时发送该消息，无参数。

COM_CHANGE_USER 消息报文

功能：在不断连接的情况下重新登陆，该操作会销毁 MySQL 服务器端的会话上下文（包括临时表、会话变量等）。有些连接池用这种方法实现清除会话上下文。

字节	说明
n	用户名（字符串以NULL结尾）
n	密码（挑战数）
	MySQL 3.23 版本：Null-Terminated String（长度9字节）
	MySQL 4.1 版本：Length Coded String（长度1+21字节）
n	数据库名称（Null-Terminated String）
2	字符编码

COM_BINLOG_DUMP 消息报文

功能：该消息是备份连接时由从服务器向主服务器发送的最后一个请求，主服务器收到后，会响应一系列的报文，每个报文都包含一个二进制日志事件。如果主服务器出现故障时，会发送一个 EOF 报文。

字节	说明
4	二进制日志数据的起始位置（小字节序）
4	二进制日志数据标志位（目前未使用，永远为0x00）
4	从服务器的服务器ID值（小字节序）
n	二进制日志的文件名称（可选，默认值为主服务器上第一个有效的文件名）

COM_TABLE_DUMP 消息报文

功能：将数据表从主服务器复制到从服务器中，执行 SQL 语句 LOAD TABLE ... FROM MASTER 时发送该消息。目前该消息已过时，不再使用。

字节	说明
n	数据库名称（Length Coded String）
n	数据表名称（Length Coded String）

COM_REGISTER_SLAVE 消息报文

功能：在从服务器 report_host 变量设置的情况下，当备份连接时向主服务器发送的注册消息。

字节	说明
4	从服务器ID值（小字节序）
n	主服务器IP地址（Length Coded String）
n	主服务器用户名（Length Coded String）
n	主服务器密码（Length Coded String）
2	主服务器端口号
4	安全备份级别（由MySQL服务器 rpl_recovery_rank 变量设置，暂时未使用）
4	主服务器ID值（值恒为0x00）

COM_PREPARE 消息报文

功能：预处理 SQL 语句，使用带有"?"占位符的 SQL 语句时发送该消息。

字节	说明
n	带有"?"占位符的SQL语句（字符串到达消息尾部时结束，无结束符）

COM_EXECUTE 消息报文

功能：执行预处理语句。

字节	说明
4	预处理语句的ID值
1	标志位
	0x00: CURSOR_TYPE_NO_CURSOR
	0x01: CURSOR_TYPE_READ_ONLY
	0x02: CURSOR_TYPE_FOR_UPDATE
	0x04: CURSOR_TYPE_SCROLLABLE
4	保留（值恒为0x01）
如果参数数量大于0
n	空位图（Null-Bitmap，长度 = (参数数量 + 7) / 8 字节）
1	参数分隔标志
如果参数分隔标志值为1
n	每个参数的类型值（长度 = 参数数量 * 2 字节）
n	每个参数的值

COM_LONG_DATA 消息报文

该消息报文有两种形式，一种用于发送二进制数据，另一种用于发送文本数据。

功能：用于发送二进制（BLOB）类型的数据（调用 mysql_stmt_send_long_data 函数）。

字节	说明
4	预处理语句的ID值（小字节序）
2	参数序号（小字节序）
n	数据负载（数据到达消息尾部时结束，无结束符）

功能：用于发送超长字符串类型的数据（调用mysql_send_long_data函数）。

字节	说明
4	预处理语句的ID值（小字节序）
2	参数序号（小字节序）
2	数据类型（未使用）
n	数据负载（数据到达消息尾部时结束，无结束符）

COM_CLOSE_STMT 消息报文

功能：销毁预处理语句。

字节	说明
4	预处理语句的ID值（小字节序）

COM_RESET_STMT 消息报文

功能：将预处理语句的参数缓存清空。多数情况和 COM_LONG_DATA 一起使用。

字节	说明
4	预处理语句的ID值（小字节序）

COM_SET_OPTION 消息报文

功能：设置语句选项，选项值为 /include/mysql_com.h 头文件中定义的 enum_mysql_set_option 枚举类型：

• MYSQL_OPTION_MULTI_STATEMENTS_ON
• MYSQL_OPTION_MULTI_STATEMENTS_OFF

字节	说明
2	选项值（小字节序）

COM_FETCH_STMT 消息报文

功能：获取预处理语句的执行结果（一次可以获取多行数据）。

字节	说明
4	预处理语句的ID值（小字节序）
4	数据的行数（小字节序）

服务器响应报文（服务器 ===> 客户端）

---

当客户端发起认证请求或命令请求后，服务器会返回相应的执行结果给客户端。客户端在收到响应报文后，需要首先检查第 1 个字节的值，来区分响应报文的类型。

响应报文类型	第1个字节取值范围
OK 响应报文	0x00
Error 响应报文	0xFF
Result Set 报文	0x01 - 0xFA
Field 报文	0x01 - 0xFA
Row Data 报文	0x01 - 0xFA
EOF 报文	0xFE

注：响应报文的第 1 个字节在不同类型中含义不同，比如在 OK 报文中，该字节并没有实际意义，值恒为 0x00；而在 Result Set 报文中，该字节又是长度编码的二进制数据结构（Length Coded Binary）中的第 1 字节。

OK 响应报文

功能：客户端的命令执行正确时，服务器会返回 OK 响应报文。

MySQL 4.0 及之前的版本

字节	说明
1	OK 报文，值恒为 0x00
1-9	受影响行数（Length Coded Binary）
1-9	索引 ID 值（Length Coded Binary）
2	服务器状态
n	服务器消息（字符串到达消息尾部时结束，无结束符）

MySQL 4.1 及之后的版本

字节	说明
1	OK报文，值恒为0x00
1-9	受影响行数（Length Coded Binary）
1-9	索引ID值（Length Coded Binary）
2	服务器状态
2	告警计数
n	服务器消息（字符串到达消息尾部时结束，无结束符，可选）

1）受影响行数：当执行 INSERT/UPDATE/DELETE 语句时所影响的数据行数。

2）索引 ID 值：该值为 AUTO_INCREMENT 索引字段生成，如果没有索引字段，则为 0x00。注意：当 INSERT 插入语句为多行数据时，该索引 ID 值为第一个插入的数据行索引值，而非最后一个。

3）服务器状态：客户端可以通过该值检查命令是否在事务处理中。

4）告警计数：告警发生的次数。

5）服务器消息：服务器返回给客户端的消息，一般为简单的描述性字符串，可选字段。

Error 响应报文

MySQL 4.0 及之前的版本

字节	说明
1	Error 报文，值恒为 0xFF
2	错误编号（小字节序）
n	服务器消息

MySQL 4.1 及之后的版本

字节	说明
1	Error 报文，值恒为 0xFF
2	错误编号（小字节序）
1	服务器状态标志，恒为'#'字符
5	服务器状态（5个字符）
n	服务器消息

1）错误编号：错误编号值定义在源代码 /include/mysqld_error.h 头文件中。

2）服务器状态：服务器将错误编号通过 mysql_errno_to_sqlstate 函数转换为状态值，状态值由 5 字节的 ASCII 字符组成，定义在源代码 /include/sql_state.h 头文件中。

3）服务器消息：错误消息字符串到达消息尾时结束，长度可以由消息头中的长度值计算得出。消息长度为 0-512 字节。

Result Set 消息

功能：当客户端发送查询请求后，在没有错误的情况下，服务器会返回结果集（Result Set）给客户端。

Result Set 消息分为五部分，结构如下：

结构	说明
[Result Set Header]	列数量
[Field]	列信息（多个）
[EOF]	列结束
[Row Data]	行数据（多个）
[EOF]	数据结束

Result Set Header 结构

字节	说明
1-9	Field结构计数（Length Coded Binary）
1-9	额外信息（Length Coded Binary）

1）Field 结构计数：用于标识 Field 结构的数量，取值范围 0x00-0xFA。

2）额外信息：可选字段，一般情况下不应该出现。只有像 SHOW COLUMNS 这种语句的执行结果才会用到额外信息（标识表格的列数量）。

Field 结构

功能：Field 为数据表的列信息，在 Result Set 中，Field 会连续出现多次，次数由 Result Set Header 结构中的 IField 结构计数值决定。

MySQL 4.0 及之前的版本

字节	说明
n	数据表名称（Length Coded String）
n	列（字段）名称（Length Coded String）
4	列（字段）长度（Length Coded String）
2	列（字段）类型（Length Coded String）
2	列（字段）标志（Length Coded String）
1	整型值精度
n	默认值（Length Coded String）

MySQL 4.1 及之后的版本

字节	说明
n	目录名称（Length Coded String）
n	数据库名称（Length Coded String）
n	数据表名称（Length Coded String）
n	数据表原始名称（Length Coded String）
n	列（字段）名称（Length Coded String）
4	列（字段）原始名称（Length Coded String）
1	填充值
2	字符编码
4	列（字段）长度
1	列（字段）类型
2	列（字段）标志
1	整型值精度
2	填充值（0x00）
n	默认值（Length Coded String）

1）目录名称：在 4.1 及之后的版本中，该字段值为"def"。

2）数据库名称：数据库名称标识。

3）数据表名称：数据表的别名（AS 之后的名称）。

4）数据表原始名称：数据表的原始名称（AS 之前的名称）。

5）列（字段）名称：列（字段）的别名（AS 之后的名称）。

6）列（字段）原始名称：列（字段）的原始名称（AS 之前的名称）。

7）字符编码：列（字段）的字符编码值。

8）列（字段）长度：列（字段）的长度值，真实长度可能小于该值，例如 VARCHAR(2) 类型的字段实际只能存储 1 个字符。

9）列（字段）类型：列（字段）的类型值，取值范围如下（参考源代码 /include/mysql_com.h 头文件中的 enum_field_type 枚举类型定义）：

类型值	名称
0x00	FIELD_TYPE_DECIMAL
0x01	FIELD_TYPE_TINY
0x02	FIELD_TYPE_SHORT
0x03	FIELD_TYPE_LONG
0x04	FIELD_TYPE_FLOAT
0x05	FIELD_TYPE_DOUBLE
0x06	FIELD_TYPE_NULL
0x07	FIELD_TYPE_TIMESTAMP
0x08	FIELD_TYPE_LONGLONG
0x09	FIELD_TYPE_INT24
0x0A	FIELD_TYPE_DATE
0x0B	FIELD_TYPE_TIME
0x0C	FIELD_TYPE_DATETIME
0x0D	FIELD_TYPE_YEAR
0x0E	FIELD_TYPE_NEWDATE
0x0F	FIELD_TYPE_VARCHAR (new in MySQL 5.0)
0x10	FIELD_TYPE_BIT (new in MySQL 5.0)
0xF6	FIELD_TYPE_NEWDECIMAL (new in MYSQL 5.0)
0xF7	FIELD_TYPE_ENUM
0xF8	FIELD_TYPE_SET
0xF9	FIELD_TYPE_TINY_BLOB
0xFA	FIELD_TYPE_MEDIUM_BLOB
0xFB	FIELD_TYPE_LONG_BLOB
0xFC	FIELD_TYPE_BLOB
0xFD	FIELD_TYPE_VAR_STRING
0xFE	FIELD_TYPE_STRING
0xFF	FIELD_TYPE_GEOMETRY

10）列（字段）标志：各标志位定义如下（参考源代码 /include/mysql_com.h 头文件中的宏定义）：

标志位	名称
0x0001	NOT_NULL_FLAG
0x0002	PRI_KEY_FLAG
0x0004	UNIQUE_KEY_FLAG
0x0008	MULTIPLE_KEY_FLAG
0x0010	BLOB_FLAG
0x0020	UNSIGNED_FLAG
0x0040	ZEROFILL_FLAG
0x0080	BINARY_FLAG
0x0100	ENUM_FLAG
0x0200	AUTO_INCREMENT_FLAG
0x0400	TIMESTAMP_FLAG
0x0800	SET_FLAG

11）数值精度：该字段对 DECIMAL 和 NUMERIC 类型的数值字段有效，用于标识数值的精度（小数点位置）。

12）默认值：该字段用在数据表定义中，普通的查询结果中不会出现。

13）附：Field 结构的相关处理函数：

• 客户端：/client/client.c 源文件中的 unpack_fields 函数
• 服务器：/sql/sql_base.cc 源文件中的 send_fields 函数

EOF 结构

功能：EOF 结构用于标识 Field 和 Row Data 的结束，在预处理语句中，EOF 也被用来标识参数的结束。

MySQL 4.0 及之前的版本

字节	说明
1	EOF值（0xFE）

MySQL 4.1 及之后的版本

字节	说明
1	EOF值（0xFE）
2	告警计数
2	状态标志位

1）告警计数：服务器告警数量，在所有数据都发送给客户端后该值才有效。

2）状态标志位：包含类似 SERVER_MORE_RESULTS_EXISTS 这样的标志位。

3）注：由于 EOF 值与其它 Result Set 结构共用 1 字节，所以在收到报文后需要对 EOF 包的真实性进行校验，校验条件为：

• 第 1 字节值为 0xFE
• 包长度小于 9 字节

4）附：EOF 结构的相关处理函数：

• 服务器：protocol.cc 源文件中的 send_eof 函数

Row Data 结构

功能：在 Result Set 消息中，会包含多个 Row Data 结构，每个 Row Data 结构又包含多个字段值，这些字段值组成一行数据。

字节	说明
n	字段值（Length Coded String）
...	（一行数据中包含多个字段值）

1）字段值：行数据中的字段值，字符串形式。

2）附：Row Data结构的相关处理函数：

• 客户端：/client/client.c 源文件中的 read_rows 函数

Row Data 结构（二进制数据）

功能：该结构用于传输二进制的字段值，既可以是服务器返回的结果，也可以是由客户端发送的（当执行预处理语句时，客户端使用Result Set 消息来发送参数及数据）。

字节	说明
1	结构头（0x00）
(列数量 + 7 + 2) / 8	空位图
n	字段值
...	（一行数据中包含多个字段值）

1）空位图：前2个比特位被保留，值分别为0和1，以保证不会和OK、Error包的首字节冲突。在MySQL 5.0及之后的版本中，这2个比特位的值都为0。

2）字段值：行数据中的字段值，二进制形式。

PREPARE_OK 响应报文（Prepared Statement）

功能：用于响应客户端发起的预处理语句报文，组成结构如下：

结构	说明
[PREPARE_OK]	PREPARE_OK结构
如果参数数量大于0
[Field]	与Result Set消息结构相同
[EOF]
如果列数大于0
[Field]	与Result Set消息结构相同
[EOF]

其中 PREPARD_OK 的结构如下：

字节	说明
1	OK报文，值为0x00
4	预处理语句ID值
2	列数量
2	参数数量
1	填充值（0x00）
2	告警计数

Parameter 响应报文（Prepared Statement）

功能：预处理语句的值与参数正确对应后，服务器会返回 Parameter 报文。

字节	说明
2	类型
2	标志
1	数值精度
4	字段长度

1）类型：与 Field 结构中的字段类型相同。

2）标志：与 Field 结构中的字段标志相同。

3）数值精度：与 Field 结构中的数值精度相同。

4）字段长度：与 Field 结构中的字段长度相同。