required向服务器请求压缩连接，如果服务器不支持压缩或无法与 MySQL Shell 就压缩协议达成一致，则连接失败。

preferred从服务器请求压缩连接，如果服务器不支持压缩或不能与 MySQL Shell 就压缩协议达成一致，则回退到未压缩连接。这是 X 协议连接的默认值。

disabled请求未压缩的连接，如果服务器仅允许压缩连接，则连接失败。这是经典 MySQL 协议连接的默认设置。

如果您从命令行启动 MySQL Shell 并使用单独的命令选项指定连接参数，请使用 --compress ( -C) 选项，指定连接是否需要、首选或禁用压缩。例如：

$> mysqlsh --mysqlx -u user -h localhost -C required

( ) 选项与早期版本的 MySQL Shell（回到 MySQL 8.0.14）兼容，并且仍然接受这些版本的布尔设置--compress 。-C从 MySQL Shell 8.0.20 开始，如果您只指定 --compress ( -C) 而没有参数，则连接需要压缩。

上面的 X 协议连接示例按照优先顺序向服务器建议 zlib、LZ4 和 zstd 算法。如果您更喜欢压缩算法的替代组合，您可以通过使用 --compression-algorithms选项指定一个字符串来指定它，该字符串包含以逗号分隔的允许算法列表。对于 X 协议连接，您可以 按任意组合和优先顺序使用zlib、lz4和 。zstd对于经典的 MySQL 协议连接，您可以使用 zlib和zstd以任何组合和优先顺序。以下经典 MySQL 协议连接示例仅允许 zstd 算法：

$> mysqlsh --mysql -u user -h localhost -C preferred --compression-algorithms=zstd

您也可以 --compression-algorithms不使用 --compress ( -C) 选项来请求压缩。在这种情况下，uncompressed如果您想允许未压缩的连接，请将其添加到算法列表中，或者如果您不想允许它们，请将其省略。这种连接压缩控制方式与其他 MySQL 客户端（如mysql 和mysqlbinlog ）兼容。以下经典 MySQL 协议连接示例与上面的示例具有相同的效果，其中preferred被指定为一个单独的选项，即建议使用 zstd 算法进行压缩，但回退到未压缩的连接：

$> mysqlsh --mysql -u user -h localhost --compression-algorithms=zstd,uncompressed

--compression-level您可以使用或 选项 配置压缩级别 --zstd-compression-level，这些选项已针对经典 MySQL 协议连接进行验证，但不适用于 X 协议连接。 --compression-level为 X 协议连接的任何算法或仅在经典 MySQL 协议连接上的 zstd 算法指定压缩级别的整数。 --zstd-compression-levelzstd算法的压缩级别指定1到22的整数，兼容mysql、 mysqlbinlog等其他MySQL客户端. 例如，X 协议连接的这些连接参数指定全局会话需要压缩并且必须使用 LZ4 或 zstd 算法，请求的压缩级别为 5：

$> mysqlsh --mysqlx -u user -h localhost -C required --compression-algorithms=lz4,zstd --compression-level=5

如果您使用类似 URI 的连接字符串来指定连接参数，无论是从命令行，还是使用 MySQL Shell 的\connect命令，或者使用shell.connect(), shell.openSession(), mysqlx.getSession(), mysql.getSession(), 或 mysql.getClassicSession()函数，请使用compression查询字符串中的参数来指定是否需要压缩、首选或禁用。例如：

mysql-js> \connect user@example.com?compression=preferred

$> mysqlsh mysqlx://user@localhost:33060?compression=disabled

与命令行选项一样，使用参数 选择压缩算法 compression-algorithms，并使用参数选择压缩级别 。compression-level（对于类似 URI 的连接字符串，没有特定于 zstd 的压缩级别参数。）您也可以使用 compression-algorithms不带参数的compression参数，包括或省略uncompressed 允许或禁止未压缩连接的选项。例如，这两组连接参数都指定压缩是首选但允许未压缩的连接，zlib 和 zstd 算法是可接受的，并且应该使用 4 的压缩级别：

mysql-js> \connect user@example.com:33060?compression=preferred&compression-algorithms=zlib,zstd&compression-level=4

mysql-js> \connect user@example.com:33060?compression-algorithms=zlib,zstd,uncompressed&compression-level=4

如果您使用键值对指定连接参数，无论是使用 MySQL Shell 的 \connect命令还是使用 shell.connect()、 shell.openSession()、 mysqlx.getSession()、 mysql.getSession()或 mysql.getClassicSession()函数，请使用compression选项字典中的参数来指定压缩是必需的、首选的还是禁用的。例如：

mysql-js>  var s1=mysqlx.getSession({host: 'localhost',
                                     user: 'root',
                                     password: 'password',
                                     compression: 'required'});

Select compression algorithms using the compression-algorithms parameter, and a compression level using the compression-level parameter, as for the command line and URI-like connection string methods. (There is no zstd-specific compression level parameter for key-value pairs.) You can also use the compression-algorithms parameter without the compression parameter, including or omitting the uncompressed option to allow or disallow uncompressed connections.