09 协议解析 命令阶段

在命令阶段，客户端发送command packet，其sequence-id为[00]：

13 00 00 00 03 53 ...
01 00 00 00 01
            ^^- command-byte
         ^^---- sequence-id == 0

payload的第一个字节描述了命令类型，如下：

这些command属于：

• Text Protocol
• Utility Commands
• Prepared Statements
• Stored Programs

Text Protocol

COM_QUERY

发送基于文本协议的SQL查询，执行立即开始。响应COM_QUERY Response。

有效负载如下：

示例：

21 00 00 00 03 73 65 6c    65 63 74 20 40 40 76 65    !....select @@ve
72 73 69 6f 6e 5f 63 6f    6d 6d 65 6e 74 20 6c 69    rsion_comment li
6d 69 74 20 31                                        mit 1

COM_QUERY Response

查询响应数据包是一个元数据包，可以是以下之一：

• ERR_Packet
• OK_Packet
• LOCAL INFILE Request
• Text Resultset

注意：如果打开CLIENT_DEPRECATE_EOF，则发送OK_Packet而不是实际的EOF_Packet数据包。

Prepared Statements

COM_STMT_EXECUTE

COM_STMT_EXECUTE要求服务器执行由stmt_id标识的准备好的语句。

它以Binary Protocol Value形式发送准备好的语句的占位符的值（如果包含）。每个参数的类型由两个字节组成：

• 在Protocol::ColumnType中的类型
• 如果类型是无符号的，则标志字节的最高位被设置[80]

用于此数据包的num_params必须与相应的准备好的语句的COM_STMT_PREPARE_OK的num_params匹配。

响应COM_STMT_EXECUTE Response

COM_STMT_EXECUTE:

COM_STMT_EXECUTE
  execute a prepared statement

  direction: client -> server
  response: COM_STMT_EXECUTE Response

  payload:
    1              [17] COM_STMT_EXECUTE
    4              stmt-id
    1              flags
    4              iteration-count
      if num-params > 0:
    n              NULL-bitmap, length: (num-params+7)/8
    1              new-params-bound-flag
      if new-params-bound-flag == 1:
    n              type of each parameter, length: num-params * 2
    n              value of each parameter

  example:
    12 00 00 00 17 01 00 00    00 00 01 00 00 00 00 01    ................
    0f 00 03 66 6f 6f                                     ...foo

iteration-count总是为1。

flags如下：

null_bitmap就像Binary Protocol Resultset Row的NULL-bitmap一样，只是它的bit_offset为0。

COM_STMT_EXECUTE Response

与COM_QUERY响应类似，COM_STMT_EXECUTE返回以下之一：

• OK_Packet
• ERR_Packet
• Binary Protocol Resultset