MySQL 9.0 发行说明
X 插件支持压缩通过 X 协议连接发送的消息。如果服务器和客户端就相互支持的压缩算法达成一致，则可以压缩连接。启用压缩可以减少通过网络发送的字节数，但会增加服务器和客户端用于压缩和解压缩操作的额外 CPU 成本。因此，压缩的好处主要体现在网络带宽较低、网络传输时间在压缩和解压缩操作成本中占主导地位以及结果集较大时。
注意
不同的 MySQL 客户端以不同的方式实现对连接压缩的支持；有关详细信息，请参阅您的客户端文档。例如，对于经典 MySQL 协议连接，请参阅第 6.2.8 节“连接压缩控制”。
默认情况下，X 插件支持 zstd、LZ4 和 Deflate 压缩算法。使用 Deflate 算法的压缩是使用 zlib 软件库执行的，因此 X 协议连接的 deflate_stream 压缩算法设置等效于经典 MySQL 协议连接的 zlib 设置。
在服务器端，您可以通过设置 mysqlx_compression_algorithms 系统变量以仅包含允许的算法来禁止任何压缩算法。算法名称 zstd_stream、lz4_message 和 deflate_stream 可以以任何组合指定，顺序和大小写不重要。如果系统变量值为字符串，则不允许使用任何压缩算法，并且连接未压缩。
下表比较了不同压缩算法的特性，并显示了它们分配的优先级。默认情况下，服务器选择服务器和客户端共同允许的最高优先级算法；客户端可以按照稍后所述更改优先级。客户端在指定算法时可以使用算法的简短形式别名。
表 22.1 X 协议压缩算法特性
| 算法 | 别名 | 压缩率 | 吞吐量 | CPU 成本 | 默认优先级 |
|---|---|---|---|---|---|
zsth_stream |
zstd |
高 | 高 | 中等 | 第一 |
lz4_message |
lz4 |
低 | 高 | 最低 | 第二 |
deflate_stream |
deflate |
高 | 低 | 最高 | 第三 |
X 协议允许的压缩算法集（无论是用户指定的还是默认的）独立于 MySQL 服务器为经典 MySQL 协议连接允许的压缩算法集，后者由 protocol_compression_algorithms 服务器系统变量指定。如果您没有指定 mysqlx_compression_algorithms 系统变量，则 X 插件不会回退到使用经典 MySQL 协议连接的压缩设置。相反，它的默认值是允许 表 22.1“X 协议压缩算法特性” 中显示的所有算法。这与 TLS 上下文的情况不同，如果未设置 X 插件系统变量，则使用 MySQL 服务器设置，如 第 22.5.3 节“将加密连接与 X 插件一起使用” 中所述。有关经典 MySQL 协议连接压缩的信息，请参阅 第 6.2.8 节“连接压缩控制”。
在客户端，X 协议连接请求可以指定多个用于压缩控制的参数
压缩模式。
压缩级别。
按优先顺序排列的允许压缩算法列表。
注意
某些客户端或连接器可能不支持给定的压缩控制功能。例如，仅 MySQL Shell 支持为 X 协议连接指定压缩级别，而其他 MySQL 客户端或连接器不支持。有关受支持功能以及如何使用它们的详细信息，请参阅特定产品的文档。
连接模式具有以下允许值
disabled：连接未压缩。preferred：服务器和客户端协商以找到它们都允许的压缩算法。如果没有通用的算法可用，则连接未压缩。如果没有明确指定，则这是默认模式。required：压缩算法协商与preferred模式相同，但如果没有通用的算法可用，则连接请求将终止并显示错误。
除了就每个连接的压缩算法达成一致外，服务器和客户端还可以就适用于 agreed 算法的数字范围内的压缩级别达成一致。随着算法压缩级别的增加，数据压缩率也会增加，这减少了将消息发送到客户端所需的网络带宽和传输时间。但是，数据压缩所需的工作量也会增加，从而占用服务器上的时间、CPU 和内存资源。压缩工作量的增加与压缩率的增加没有线性关系。
客户端可以在与服务器进行 X 协议连接的能力协商期间请求特定的压缩级别。
MySQL 9.0 中 X 插件使用的默认压缩级别是通过性能测试选择的，在压缩时间和网络传输时间之间取得了良好的平衡。这些默认值不一定与每个算法的库默认值相同。如果客户端没有为算法请求压缩级别，则它们适用。默认压缩级别最初设置为 zstd 为 3，LZ4 为 2，Deflate 为 3。您可以使用 mysqlx_zstd_default_compression_level、mysqlx_lz4_default_compression_level 和 mysqlx_deflate_default_compression_level 系统变量调整这些设置。
为了防止服务器上的过度资源消耗，X 插件为每个算法设置了服务器允许的最大压缩级别。如果客户端请求的压缩级别超过此设置，则服务器将使用其允许的最大压缩级别（仅 MySQL Shell 支持客户端的压缩级别请求）。最大压缩级别最初设置为 zstd 为 11，LZ4 为 8，Deflate 为 5。您可以使用 mysqlx_zstd_max_client_compression_level、mysqlx_lz4_max_client_compression_level 和 mysqlx_deflate_max_client_compression_level 系统变量调整这些设置。
如果服务器和客户端允许多个共同的算法，则在协商期间选择算法的默认优先级顺序如 表 22.1“X 协议压缩算法特性” 所示。对于支持指定压缩算法的客户端，连接请求可以包含客户端允许的算法列表，使用算法名称或其别名指定。列表中这些算法的顺序被服务器视为优先级顺序。在这种情况下使用的算法是客户端列表中第一个也是服务器端允许的算法。但是，压缩算法的选项取决于压缩模式
如果压缩模式为
disabled，则忽略压缩算法选项。如果压缩模式为
preferred，但服务器端不允许客户端允许的任何算法，则连接未压缩。如果压缩模式为
required，但客户端允许的算法在服务器端不允许，则会发生错误。
要监控消息压缩的效果，请使用 监控 X 插件的连接压缩 中描述的 X 插件状态变量。您可以使用这些状态变量来计算使用当前设置进行消息压缩的好处，并使用该信息来调整您的设置。
X 协议连接压缩按以下行为和边界运行
算法名称中的
_stream和_message后缀指的是两种不同的操作模式：在流模式下，单个连接中的所有 X 协议消息都被压缩成一个连续的流，并且必须以相同的方式解压缩——按照它们被压缩的顺序，并且不跳过任何消息。在消息模式下，每条消息都被单独和独立地压缩，并且不需要按照它们被压缩的顺序解压缩。此外，消息模式并不要求所有压缩的消息都被解压缩。压缩不适用于在身份验证成功之前发送的任何消息。
压缩不适用于控制流消息，例如
Mysqlx.Ok、Mysqlx.Error和Mysqlx.Sql.StmtExecuteOk消息。如果服务器和客户端在功能协商期间就相互允许的压缩算法达成一致，则所有其他 X 协议消息都可以被压缩。如果客户端在该阶段没有请求压缩，则客户端和服务器都不会对消息应用压缩。
当通过 X 协议连接发送的消息被压缩时，
mysqlx_max_allowed_packet系统变量指定的限制仍然适用。在消息有效负载被解压缩后，网络数据包必须小于此限制。如果超过限制，X 插件将返回解压缩错误并关闭连接。以下几点与客户端的压缩级别请求有关，这仅由 MySQL Shell 支持
压缩级别必须由客户端指定为整数。如果提供了任何其他类型的值，则连接将关闭并显示错误。
如果客户端指定了算法但没有指定压缩级别，则服务器将对该算法使用其默认压缩级别。
如果客户端请求的算法压缩级别超过服务器允许的最大级别，则服务器将使用允许的最大级别。
如果客户端请求的算法压缩级别低于服务器允许的最小级别，则服务器将使用允许的最小级别。
您可以使用 X 插件状态变量来监控消息压缩的效果。当使用消息压缩时，会话 Mysqlx_compression_algorithm 状态变量显示当前 X 协议连接正在使用哪种压缩算法，Mysqlx_compression_level 显示选择的压缩级别。
X 插件状态变量可用于计算所选压缩算法的效率（数据压缩率）以及使用消息压缩的整体效果。使用以下计算中状态变量的会话值，可以查看使用已知压缩算法的特定会话的消息压缩的好处。或者使用状态变量的全局值来检查服务器上所有使用 X 协议连接的会话的消息压缩的整体好处，包括用于这些会话的所有压缩算法，以及所有未使用消息压缩的会话。然后，您可以通过调整允许的压缩算法、最大压缩级别和默认压缩级别来调整消息压缩，如 配置 X 插件的连接压缩 中所述。
当使用消息压缩时，Mysqlx_bytes_sent 状态变量显示从服务器发送的字节总数，包括压缩后的消息有效负载（在压缩后测量）、压缩消息中未压缩的任何项目（如 X 协议标头）以及任何未压缩的消息。 Mysqlx_bytes_sent_compressed_payload 状态变量显示作为压缩消息有效负载发送的字节总数（在压缩后测量），Mysqlx_bytes_sent_uncompressed_frame 状态变量显示相同消息有效负载的字节总数，但在压缩前测量。因此，可以使用以下表达式计算压缩率，该比率显示压缩算法的效率
mysqlx_bytes_sent_uncompressed_frame / mysqlx_bytes_sent_compressed_payload服务器发送的 X 协议消息的压缩有效性可以使用以下表达式计算
(mysqlx_bytes_sent - mysqlx_bytes_sent_compressed_payload + mysqlx_bytes_sent_uncompressed_frame) / mysqlx_bytes_sent对于服务器从客户端接收到的消息，Mysqlx_bytes_received_compressed_payload 状态变量显示作为压缩消息有效负载接收的字节总数（在解压缩前测量），Mysqlx_bytes_received_uncompressed_frame 状态变量显示相同消息有效负载的字节总数，但在解压缩后测量。 Mysqlx_bytes_received 状态变量包括在解压缩前测量的压缩消息有效负载、压缩消息中任何未压缩的项目以及任何未压缩的消息。