#### 20.5.6.2 X 插件选项和系统变量

要控制 X 插件的激活，请使用此选项：

-   [](<>) [`--mysqlx[=值]`](x-plugin-options-system-variables.html#option_mysqld_mysqlx)

     [](<>)[](<>)

    | 命令行格式 | `--mysqlx[=值]` |
    | ----- | -------------- |
    | 类型 | 枚举 |
    | 默认值 | `在` |
    | 有效值 | `在`<br/><br/>`离开`<br/><br/>`力量`<br/><br/>`FORCE_PLUS_PERMANENT` |

    此选项控制服务器在启动时如何加载 X 插件。在 MySQL 8.0 中，X Plugin 默认是启用的，但是这个选项可以用来控制它的激活状态。

    选项值应该是可用于插件加载选项的选项之一，如中所述[第 5.6.1 节，“安装和卸载插件”](plugin-loading.html).

    如果启用了 X 插件，它会公开几个允许控制其操作的系统变量：

-   [](<>) [`mysqlx_bind_address`](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-bind-address=addr` |
    | ----- | ---------------------------- |
    | 系统变量 | `[mysqlx_bind_address](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `*` |

    X Plugin 侦听 TCP/IP 连接的网络地址。此变量不是动态的，只能在启动时配置。这是 X 插件等价于[`绑定地址`](server-system-variables.html#sysvar_bind_address)系统变量；有关更多信息，请参阅该变量描述。

    默认情况下，X Plugin 接受所有服务器主机 IPv4 接口上的 TCP/IP 连接，如果服务器主机支持 IPv6，则接受所有 IPv6 接口上的 TCP/IP 连接。如果[`mysqlx_bind_address`](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)已指定，其值必须满足以下要求：

    -   在 MySQL 8.0.21 之前，[`mysqlx_bind_address`](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)接受单个地址值，它可以指定单个非通配符 IP 地址（IPv4 或 IPv6）、主机名或允许侦听多个网络接口的通配符地址格式之一（`*`,`0.0.0.0`， 要么`::`）。

    -   从 MySQL 8.0.21 开始，[`mysqlx_bind_address`](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)接受刚刚描述的单个值，或逗号分隔值的列表。当变量命名多个值的列表时，每个值必须指定一个非通配符 IP 地址（IPv4 或 IPv6）或主机名。通配符地址格式 (`*`,`0.0.0.0`， 要么`::`) 不允许出现在值列表中。

    -   从 MySQL 8.0.22 开始，该值可能包含网络命名空间说明符。

        IP 地址可以指定为 IPv4 或 IPv6 地址。对于作为主机名的任何值，X 插件将名称解析为 IP 地址并绑定到该地址。如果一个主机名解析为多个 IP 地址，X Plugin 使用第一个 IPv4 地址（如果有），否则使用第一个 IPv6 地址。

        X Plugin 处理不同类型的地址如下：

    -   如果地址是`*`, X Plugin 接受所有服务器主机 IPv4 接口上的 TCP/IP 连接，如果服务器主机支持 IPv6，则接受所有 IPv6 接口上的 TCP/IP 连接。使用此地址允许 X 插件的 IPv4 和 IPv6 连接。此值为默认值。如果变量指定了多个值的列表，则不允许使用此值。

    -   如果地址是`0.0.0.0`, X Plugin 接受所有服务器主机 IPv4 接口上的 TCP/IP 连接。如果变量指定了多个值的列表，则不允许使用此值。

    -   如果地址是`::`, X Plugin 接受所有服务器主机 IPv4 和 IPv6 接口上的 TCP/IP 连接。如果变量指定了多个值的列表，则不允许使用此值。

    -   如果地址是 IPv4 映射地址，X Plugin 接受该地址的 TCP/IP 连接，采用 IPv4 或 IPv6 格式。例如，如果 X 插件绑定到`::ffff:127.0.0.1`, MySQL Shell 等客户端可以使用`--主机=127.0.0.1`要么`--主机=::ffff:127.0.0.1`.

    -   如果地址是“常规”IPv4 或 IPv6 地址（例如`127.0.0.1`要么`::1`)，X 插件仅接受该 IPv4 或 IPv6 地址的 TCP/IP 连接。

        这些规则适用于为地址指定网络命名空间：

    -   可以为 IP 地址或主机名指定网络名称空间。

    -   不能为通配符 IP 地址指定网络命名空间。

    -   对于给定的地址，网络命名空间是可选的。如果给出，它必须被指定为`/*`ns`*`紧跟地址的后缀。

    -   没有的地址`/*`ns`*`suffix 使用主机系统全局命名空间。因此全局命名空间是默认的。

    -   一个地址`/*`ns`*`suffix 使用命名空间命名*`ns`*.

    -   主机系统必须支持网络命名空间，并且每个命名的命名空间都必须事先设置。命名一个不存在的命名空间会产生错误。

    -   如果变量值指定多个地址，它可以包括全局命名空间、命名命名空间或混合中的地址。

        有关网络命名空间的更多信息，请参阅[第 5.1.14 节，“网络命名空间支持”](network-namespace-support.html).

    重要的

    因为 X Plugin 不是强制插件，所以如果指定的地址或地址列表出现错误，它不会阻止服务器启动（就像 MySQL Server 对[`绑定地址`](server-system-variables.html#sysvar_bind_address)错误）。使用 X Plugin，如果列出的地址之一无法解析或 X Plugin 无法绑定到它，则会跳过该地址，记录一条错误消息，并且 X Plugin 会尝试绑定到剩余的每个地址。X 插件[`Mysqlx_address`](x-plugin-status-variables.html#statvar_Mysqlx_address)status 变量仅显示绑定成功的列表中的那些地址。如果列出的地址都没有成功绑定，或者单个指定的地址失败，X Plugin 会记录错误消息[`ER_XPLUGIN_FAILED_TO_PREPARE_IO_INTERFACES`](https://dev.mysql.com/doc/mysql-errors/8.0/en/server-error-reference.html#error_er_xplugin_failed_to_prepare_io_interfaces)声明不能使用 X 协议。[`mysqlx_bind_address`](x-plugin-options-system-variables.html#sysvar_mysqlx_bind_address)不是动态的，因此要解决任何问题，您必须停止服务器，更正系统变量值，然后重新启动服务器。

-   [](<>) [`mysqlx_compression_algorithms`](x-plugin-options-system-variables.html#sysvar_mysqlx_compression_algorithms)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-压缩算法=值` |
    | ----- | ----------------- |
    | 介绍 | 8.0.19 |
    | 系统变量 | `[mysqlx_compression_algorithms](x-plugin-options-system-variables.html#sysvar_mysqlx_compression_algorithms)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 放 |
    | 默认值 | `deflate_stream,lz4_message,zstd_stream` |
    | 有效值 | `放气流`<br/><br/>`lz4_message`<br/><br/>`zstd_stream` |

    允许在 X 协议连接上使用的压缩算法。默认情况下，Deflate、LZ4 和 zstd 算法都是允许的。要禁止任何算法，请设置[`mysqlx_compression_algorithms`](x-plugin-options-system-variables.html#sysvar_mysqlx_compression_algorithms)仅包括您允许的那些。算法名称`放气流`,`lz4_message`， 和`zstd_stream`可以任意组合指定，顺序和大小写无关紧要。如果将系统变量设置为空字符串，则不允许使用压缩算法，并且只使用未压缩的连接。使用特定于算法的系统变量来调整每个允许算法的默认和最大压缩级别。有关 X 协议的连接压缩如何与 MySQL 服务器的等效设置相关的更多详细信息和信息，请参阅[第 20.5.5 节，“使用 X 插件进行连接压缩”](x-plugin-connection-compression.html).

-   [](<>) [`mysqlx_connect_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_connect_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-连接超时=#` |
    | ----- | ----------------- |
    | 系统变量 | `[mysqlx_connect_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_connect_timeout)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `30` |
    | 最小值 | `1` |
    | 最大值 | `1000000000` |

    X Plugin 等待从新连接的客户端接收到第一个数据包的秒数。这是 X 插件等价于[`连接超时`](server-system-variables.html#sysvar_connect_timeout);有关更多信息，请参阅该变量描述。

-   [](<>) [`mysqlx_deflate_default_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_deflate_default_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_deflate_default_compression_level=#` |
    | ----- | ---------------------------------------------- |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_deflate_default_compression_level](x-plugin-options-system-variables.html#sysvar_mysqlx_deflate_default_compression_level)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `3` |
    | 最小值 | `1` |
    | 最大值 | `9` |

    服务器在 X 协议连接上用于 Deflate 算法的默认压缩级别。将级别指定为从 1（最低压缩努力）到 9（最高努力）的整数。如果客户端在能力协商期间不请求压缩级别，则使用此级别。如果您不指定此系统变量，则服务器使用级别 3 作为默认值。有关详细信息，请参阅[第 20.5.5 节，“使用 X 插件进行连接压缩”](x-plugin-connection-compression.html).

-   [](<>) [`mysqlx_deflate_max_client_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_deflate_max_client_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_deflate_max_client_compression_level=#` |
    | ----- | ------------------------------------------------- |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_deflate_max_client_compression_level](x-plugin-options-system-variables.html#sysvar_mysqlx_deflate_max_client_compression_level)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `5` |
    | 最小值 | `1` |
    | 最大值 | `9` |

    服务器在 X 协议连接上允许 Deflate 算法的最大压缩级别。该范围与该算法的默认压缩级别相同。如果客户端请求比此更​​高的压缩级别，则服务器使用您在此处设置的级别。如果不指定此系统变量，则服务器将最大压缩级别设置为 5。

-   [](<>) [`mysqlx_document_id_unique_prefix`](x-plugin-options-system-variables.html#sysvar_mysqlx_document_id_unique_prefix)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-document-id-unique-prefix=#` |
    | ----- | -------------------------------------- |
    | 系统变量 | `[mysqlx_document_id_unique_prefix](x-plugin-options-system-variables.html#sysvar_mysqlx_document_id_unique_prefix)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `0` |
    | 最小值 | `0` |
    | 最大值 | `65535` |

    设置将文档添加到集合时服务器生成的文档 ID 的前 4 个字节。通过将此变量设置为每个实例的唯一值，您可以确保文档 ID 在实例之间是唯一的。看[了解文档 ID](https://dev.mysql.com/doc/x-devapi-userguide/en/understanding-automatic-document-ids.html).

-   [](<>) [`mysqlx_enable_hello_notice`](x-plugin-options-system-variables.html#sysvar_mysqlx_enable_hello_notice)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-enable-hello-notice[={OFF|ON}]` |
    | ----- | ----------------------------------------- |
    | 系统变量 | `[mysqlx_enable_hello_notice](x-plugin-options-system-variables.html#sysvar_mysqlx_enable_hello_notice)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 布尔值 |
    | 默认值 | `在` |

    控制发送到试图通过 X 协议连接的经典 MySQL 协议客户端的消息。启用后，尝试连接到服务器 X 协议端口的不支持 X 协议的客户端会收到错误消息，说明他们使用了错误的协议。

-   [](<>) [`mysqlx_idle_worker_thread_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_idle_worker_thread_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-idle-worker-thread-timeout=#` |
    | ----- | --------------------------------------- |
    | 系统变量 | `[mysqlx_idle_worker_thread_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_idle_worker_thread_timeout)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `60` |
    | 最小值 | `0` |
    | 最大值 | `3600` |

    空闲工作线程终止后的秒数。

-   [](<>) [`mysqlx_interactive_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_interactive_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-交互式超时=#` |
    | ----- | ------------------ |
    | 系统变量 | `[mysqlx_interactive_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_interactive_timeout)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `28800` |
    | 最小值 | `1` |
    | 最大值 | `2147483` |

    的默认值[`mysqlx_wait_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_wait_timeout)交互式客户端的会话变量。（等待交互式客户端超时的秒数。）

-   [](<>) [`mysqlx_lz4_default_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_lz4_default_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_lz4_default_compression_level=#` |
    | ----- | ------------------------------------------ |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_lz4_default_compression_level](x-plugin-options-system-variables.html#sysvar_mysqlx_lz4_default_compression_level)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `2` |
    | 最小值 | `0` |
    | 最大值 | `16` |

    服务器在 X 协议连接上用于 LZ4 算法的默认压缩级别。将级别指定为从 0（最低压缩努力）到 16（最高努力）的整数。如果客户端在能力协商期间不请求压缩级别，则使用此级别。如果不指定此系统变量，服务器将使用级别 2 作为默认值。有关详细信息，请参阅[第 20.5.5 节，“使用 X 插件进行连接压缩”](x-plugin-connection-compression.html).

-   [](<>) [`mysqlx_lz4_max_client_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_lz4_max_client_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_lz4_max_client_compression_level=#` |
    | ----- | --------------------------------------------- |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_lz4_max_client_compression_level](x-plugin-options-system-variables.html#sysvar_mysqlx_lz4_max_client_compression_level)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `8` |
    | 最小值 | `0` |
    | 最大值 | `16` |

    服务器允许 LZ4 算法在 X 协议连接上的最大压缩级别。该范围与该算法的默认压缩级别相同。如果客户端请求比此更​​高的压缩级别，则服务器使用您在此处设置的级别。如果不指定此系统变量，则服务器将最大压缩级别设置为 8。

-   [](<>) [`mysqlx_max_allowed_pa​​cket`](x-plugin-options-system-variables.html#sysvar_mysqlx_max_allowed_packet)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-max-allowed-packet=#` |
    | ----- | ------------------------------- |
    | 系统变量 | `[mysqlx_max_allowed_pa​​cket](x-plugin-options-system-variables.html#sysvar_mysqlx_max_allowed_pa​​cket)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `67108864` |
    | 最小值 | `512` |
    | 最大值 | `1073741824` |

    X Plugin 可以接收的最大网络数据包大小。此限制也适用于对连接使用压缩的情况，因此在解压缩消息后网络数据包必须小于此大小。这是 X 插件等价于[`max_allowed_pa​​cket`](server-system-variables.html#sysvar_max_allowed_packet);有关更多信息，请参阅该变量描述。

-   [](<>) [`mysqlx_max_connections`](x-plugin-options-system-variables.html#sysvar_mysqlx_max_connections)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-max-connections=#` |
    | ----- | ---------------------------- |
    | 系统变量 | `[mysqlx_max_connections](x-plugin-options-system-variables.html#sysvar_mysqlx_max_connections)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `100` |
    | 最小值 | `1` |
    | 最大值 | `65535` |

    X Plugin 可以接受的最大并发客户端连接数。这是 X 插件等价于[`最大连接数`](server-system-variables.html#sysvar_max_connections);有关更多信息，请参阅该变量描述。

    对于此变量的修改，如果新值小于当前连接数，则仅对新连接考虑新限制。

-   [](<>) [`mysqlx_min_worker_threads`](x-plugin-options-system-variables.html#sysvar_mysqlx_min_worker_threads)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-min-worker-threads=#` |
    | ----- | ------------------------------- |
    | 系统变量 | `[mysqlx_min_worker_threads](x-plugin-options-system-variables.html#sysvar_mysqlx_min_worker_threads)` |
    | 范围 | 全球的 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `2` |
    | 最小值 | `1` |
    | 最大值 | `100` |

    X Plugin 用于处理客户端请求的最小工作线程数。

-   [](<>) [`mysqlx_port`](x-plugin-options-system-variables.html#sysvar_mysqlx_port)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-port=port_num` |
    | ----- | ------------------------ |
    | 系统变量 | `[mysqlx_port](x-plugin-options-system-variables.html#sysvar_mysqlx_port)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `33060` |
    | 最小值 | `1` |
    | 最大值 | `65535` |

    X Plugin 侦听 TCP/IP 连接的网络端口。这是 X 插件等价于[`港口`](server-system-variables.html#sysvar_port);有关更多信息，请参阅该变量描述。

-   [](<>) [`mysqlx_port_open_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_port_open_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-port-open-timeout=#` |
    | ----- | ------------------------------ |
    | 系统变量 | `[mysqlx_port_open_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_port_open_timeout)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `0` |
    | 最小值 | `0` |
    | 最大值 | `120` |

    X 插件等待 TCP/IP 端口空闲的秒数。

-   [](<>) [`mysqlx_read_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_read_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-读取超时=#` |
    | ----- | ----------------- |
    | 系统变量 | `[mysqlx_read_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_read_timeout)` |
    | 范围 | 会议 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `30` |
    | 最小值 | `1` |
    | 最大值 | `2147483` |

    X 插件等待阻塞读取操作完成的秒数。超过此时间后，如果读取操作不成功，X Plugin 将关闭连接并返回警告通知，错误代码为 ER_IO\_读\_客户端应用程序出错。

-   [](<>) [`mysqlx_socket`](x-plugin-options-system-variables.html#sysvar_mysqlx_socket)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-socket=文件名` |
    | ----- | --------------------- |
    | 系统变量 | `[mysqlx_socket](x-plugin-options-system-variables.html#sysvar_mysqlx_socket)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `/tmp/mysqlx.sock` |

    X 插件用于连接的 Unix 套接字文件的路径。此设置仅在 Unix 操作系统上运行时由 MySQL 服务器使用。客户端可以使用此套接字使用 X 插件连接到 MySQL 服务器。

    默认[`mysqlx_socket`](x-plugin-options-system-variables.html#sysvar_mysqlx_socket)路径和文件名基于 MySQL 服务器的主套接字文件的默认路径和文件名，并添加了一个`x`附加到文件名。主套接字文件的默认路径和文件名是`/tmp/mysql.sock`，因此 X Plugin 套接字文件的默认路径和文件名是`/tmp/mysqlx.sock`.

    如果您在服务器启动时使用[`插座`](server-system-variables.html#sysvar_socket)系统变量，这不会影响 X Plugin 套接字文件的默认值。在这种情况下，如果要将两个套接字存储在一个路径中，则必须设置[`mysqlx_socket`](x-plugin-options-system-variables.html#sysvar_mysqlx_socket)系统变量也是如此。例如在配置文件中：

    ```
    socket=/home/sockets/mysqld/mysql.sock
    mysqlx_socket=/home/sockets/xplugin/xplugin.sock
    ```

    如果您在编译时使用[`MYSQL_UNIX_ADDR`](source-configuration-options.html#option_cmake_mysql_unix_addr)compile 选项，这确实会影响 X Plugin 套接字文件的默认值，该文件是通过附加一个`x`到[`MYSQL_UNIX_ADDR`](source-configuration-options.html#option_cmake_mysql_unix_addr)文件名。如果要在编译时为 X Plugin 套接字文件设置不同的默认值，请使用[`MYSQLX_UNIX_ADDR`](source-configuration-options.html#option_cmake_mysqlx_unix_addr)编译选项。

    这`MYSQLX_UNIX_PORT`环境变量也可用于在服务器启动时为 X 插件套接字文件设置默认值（请参阅[第 4.9 节，“环境变量”](environment-variables.html)）。如果设置此环境变量，它会覆盖已编译的[`MYSQLX_UNIX_ADDR`](source-configuration-options.html#option_cmake_mysqlx_unix_addr)值，但被[`mysqlx_socket`](x-plugin-options-system-variables.html#sysvar_mysqlx_socket)价值。

-   [](<>) [`mysqlx_ssl_ca`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_ca)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-ca=file_name` |
    | ----- | --------------------------- |
    | 系统变量 | `[mysqlx_ssl_ca](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_ca)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_ca`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_ca)系统变量就像[`ssl_ca`](server-system-variables.html#sysvar_ssl_ca), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_capath`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_capath)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-capath=dir_name` |
    | ----- | ------------------------------ |
    | 系统变量 | `[mysqlx_ssl_capath](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_capath)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 目录名称 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_capath`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_capath)系统变量就像[`ssl_capath`](server-system-variables.html#sysvar_ssl_capath), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_cert`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cert)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-cert=文件名` |
    | ----- | ----------------------- |
    | 系统变量 | `[mysqlx_ssl_cert](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cert)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_cert`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cert)系统变量就像[`ssl_cert`](server-system-variables.html#sysvar_ssl_cert), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_cipher`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cipher)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-cipher=名称` |
    | ----- | ------------------------ |
    | 系统变量 | `[mysqlx_ssl_cipher](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cipher)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 细绳 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_cipher`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_cipher)系统变量就像[`ssl_cipher`](server-system-variables.html#sysvar_ssl_cipher), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_crl`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crl)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-crl=文件名` |
    | ----- | ---------------------- |
    | 系统变量 | `[mysqlx_ssl_crl](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crl)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_crl`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crl)系统变量就像[`ssl_crl`](server-system-variables.html#sysvar_ssl_crl), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_crlpath`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crlpath)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-crlpath=dir_name` |
    | ----- | ------------------------------- |
    | 系统变量 | `[mysqlx_ssl_crlpath](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crlpath)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 目录名称 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_crlpath`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_crlpath)系统变量就像[`ssl_crlpath`](server-system-variables.html#sysvar_ssl_crlpath), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_ssl_key`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_key)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-ssl-key=文件名` |
    | ----- | ---------------------- |
    | 系统变量 | `[mysqlx_ssl_key](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_key)` |
    | 范围 | 全球的 |
    | 动态的 | 不 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 文件名 |
    | 默认值 | `空值` |

    这[`mysqlx_ssl_key`](x-plugin-options-system-variables.html#sysvar_mysqlx_ssl_key)系统变量就像[`ssl_key`](server-system-variables.html#sysvar_ssl_key), 只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅[第 20.5.3 节，“通过 X 插件使用加密连接”](x-plugin-encrypted-connections.html).

-   [](<>) [`mysqlx_wait_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_wait_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-等待超时=#` |
    | ----- | ----------------- |
    | 系统变量 | `[mysqlx_wait_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_wait_timeout)` |
    | 范围 | 会议 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `28800` |
    | 最小值 | `1` |
    | 最大值 | `2147483` |

    X 插件等待连接活动的秒数。在此时间之后，如果读取操作不成功，X Plugin 将关闭连接。如果客户端是非交互的，则会话变量的初始值从全局复制[`mysqlx_wait_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_wait_timeout)多变的。对于交互式客户端，初始值是从会话中复制的[`mysqlx_interactive_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_interactive_timeout).

-   [](<>) [`mysqlx_write_timeout`](x-plugin-options-system-variables.html#sysvar_mysqlx_write_timeout)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx-写超时=#` |
    | ----- | ---------------- |
    | 系统变量 | `[mysqlx_write_timeout](x-plugin-options-system-variables.html#sysvar_mysqlx_write_timeout)` |
    | 范围 | 会议 |
    | 动态的 | 是的 |
    | [`SET_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `60` |
    | 最小值 | `1` |
    | 最大值 | `2147483` |

    X 插件等待阻塞写入操作完成的秒数。在此时间之后，如果写入操作不成功，X Plugin 将关闭连接。

-   [](<>) [`mysqlx_zstd_default_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_zstd_default_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_zstd_默认_压缩_级别=#` |
    | ----- | -------------------------- |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_zstd_default_compression_level]（x-plugin-options-system-variables.html#sysvar_mysqlx_zstd_default_compression_level）` |
    | 范围 | 全球的 |
    | 动态 | 对 |
    | [`集_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `3.` |
    | 最小值 | `-131072` |
    | 最大值 | `22` |

    服务器在X协议连接上用于zstd算法的默认压缩级别。对于1.4.0版本的zstd库，可以将正值从1设置为22（最高压缩效果），也可以将负值设置为逐渐降低效果。将值0转换为值1。对于早期版本的zstd库，只能指定值3。如果客户端在能力协商期间未请求压缩级别，则使用此级别。如果未指定此系统变量，服务器将使用级别3作为默认值。有关更多信息，请参阅[第20.5.5节，“使用X插件的连接压缩”](x-plugin-connection-compression.html).

-   [](<>) [`mysqlx_zstd_max_client_compression_level`](x-plugin-options-system-variables.html#sysvar_mysqlx_zstd_max_client_compression_level)

    [](<>)[](<>)

    | 命令行格式 | `--mysqlx_zstd_max_client_compression_level=#` |
    | ----- | ---------------------------------------------- |
    | 介绍 | 8.0.20 |
    | 系统变量 | `[mysqlx_zstd_max_client_compression_level]（x-plugin-options-system-variables.html#sysvar_mysqlx_zstd_max_client_compression_level）` |
    | 范围 | 全球的 |
    | 动态 | 对 |
    | [`集_VAR`](optimizer-hints.html#optimizer-hints-set-var)提示适用 | 不 |
    | 类型 | 整数 |
    | 默认值 | `11` |
    | 最小值 | `-131072` |
    | 最大值 | `22` |

    服务器允许在X协议连接上使用zstd算法的最大压缩级别。该范围与此算法的默认压缩级别相同。如果客户端请求的压缩级别高于此级别，服务器将使用您在此处设置的级别。如果未指定此系统变量，服务器将最大压缩级别设置为11。
