Documentation Home
MySQL 5.7 参考手册

19.4.2.2 X 插件选项和系统变量

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

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

  • mysqlx_bind_address

    命令行格式 --mysqlx-bind-address=addr
    介绍 5.7.17
    系统变量 mysqlx_bind_address
    范围 全球的
    动态的 不
    类型 细绳
    默认值 *

    X 插件侦听 TCP/IP 连接的网络地址。此变量不是动态的，只能在启动时配置。这是bind_address系统变量的 X 插件等价物；有关详细信息，请参阅该变量描述。

    mysqlx_bind_address接受单个地址值，该值可以指定单个非通配符 IP 地址或主机名，或允许在多个网络接口（ 、 或 ）上侦听的通配符地址*格式 0.0.0.0之一::。

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

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

    • 如果地址是*，X Plugin 在所有服务器主机 IPv4 接口上接受 TCP/IP 连接，如果服务器主机支持 IPv6，则在所有 IPv6 接口上。使用此地址允许 X 插件的 IPv4 和 IPv6 连接。此值为默认值。

    • 如果地址是0.0.0.0，则 X 插件接受所有服务器主机 IPv4 接口上的 TCP/IP 连接。

    • 如果地址是::，则 X 插件接受所有服务器主机 IPv4 和 IPv6 接口上的 TCP/IP 连接。

    • 如果地址是 IPv4 映射地址，X Plugin 接受该地址的 TCP/IP 连接，采用 IPv4 或 IPv6 格式。例如，如果 X Plugin 绑定到::ffff:127.0.0.1，则 MySQL Shell 等客户端可以使用 --host=127.0.0.1或 进行连接--host=::ffff:127.0.0.1。

    • 如果地址是“常规” IPv4 或 IPv6 地址（例如127.0.0.1或 ::1），X Plugin 仅接受该 IPv4 或 IPv6 地址的 TCP/IP 连接。

    如果绑定到地址失败，X Plugin 会产生错误，服务器不会加载它。

  • mysqlx_connect_timeout

    命令行格式 --mysqlx-connect-timeout=#
    介绍 5.7.12
    系统变量 mysqlx_connect_timeout
    范围 全球的
    动态的 是的
    类型 整数
    默认值 30
    最小值 1
    最大值 1000000000
    单元 秒

    X 插件等待从新连接的客户端接收到第一个数据包的秒数。这是 X 插件等同于 connect_timeout；有关详细信息，请参阅该变量描述。

  • mysqlx_idle_worker_thread_timeout

    命令行格式 --mysqlx-idle-worker-thread-timeout=#
    介绍 5.7.12
    系统变量 mysqlx_idle_worker_thread_timeout
    范围 全球的
    动态的 是的
    类型 整数
    默认值 60
    最小值 0
    最大值 3600
    单元 秒

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

  • mysqlx_max_allowed_packet

    命令行格式 --mysqlx-max-allowed-packet=#
    介绍 5.7.12
    系统变量 mysqlx_max_allowed_packet
    范围 全球的
    动态的 是的
    类型 整数
    默认值 67108864
    最小值 512
    最大值 1073741824
    单元 字节

    X Plugin 可以接收的网络数据包的最大大小。这是 X 插件等同于 max_allowed_packet；有关详细信息，请参阅该变量描述。

  • mysqlx_max_connections

    命令行格式 --mysqlx-max-connections=#
    介绍 5.7.12
    系统变量 mysqlx_max_connections
    范围 全球的
    动态的 是的
    类型 整数
    默认值 100
    最小值 1
    最大值 65535

    X Plugin 可以接受的最大并发客户端连接数。这是 X 插件等同于 max_connections；有关详细信息，请参阅该变量描述。

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

  • mysqlx_min_worker_threads

    命令行格式 --mysqlx-min-worker-threads=#
    介绍 5.7.12
    系统变量 mysqlx_min_worker_threads
    范围 全球的
    动态的 是的
    类型 整数
    默认值 2
    最小值 1
    最大值 100

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

  • mysqlx_port

    命令行格式 --mysqlx-port=port_num
    介绍 5.7.12
    系统变量 mysqlx_port
    范围 全球的
    动态的 不
    类型 整数
    默认值 33060
    最小值 1
    最大值 65535

    X 插件侦听 TCP/IP 连接的网络端口。这是 X 插件等同于 port；有关详细信息，请参阅该变量描述。

  • mysqlx_port_open_timeout

    命令行格式 --mysqlx-port-open-timeout=#
    介绍 5.7.17
    系统变量 mysqlx_port_open_timeout
    范围 全球的
    动态的 不
    类型 整数
    默认值 0
    最小值 0
    最大值 120
    单元 秒

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

  • mysqlx_socket

    命令行格式 --mysqlx-socket=file_name
    介绍 5.7.15
    系统变量 mysqlx_socket
    范围 全球的
    动态的 不
    类型 细绳
    默认值 /tmp/mysqlx.sock

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

    默认mysqlx_socket 路径和文件名基于 MySQL Server 主套接字文件的默认路径和文件名，并x在文件名后附加一个。主套接字文件/tmp/mysql.sock的默认路径和文件名是，因此 X 插件套接字文件的默认路径和文件名是 /tmp/mysqlx.sock。

    如果在服务器启动时使用 socket系统变量为主套接字文件指定替代路径和文件名，这不会影响 X 插件套接字文件的默认值。在这种情况下，如果要将两个套接字存储在一个路径中，则还必须设置 mysqlx_socket系统变量。例如在一个配置文件中： 

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

    如果您在编译时使用编译选项更改主套接字文件的默认路径和文件名 MYSQL_UNIX_ADDR，这确实会影响 X 插件套接字文件的默认值，该文件是通过 x在 MYSQL_UNIX_ADDR文件名后附加 an 形成的。如果要在编译时为 X 插件套接字文件设置不同的默认值，请使用 MYSQLX_UNIX_ADDR编译选项。

    MYSQLX_UNIX_PORT环境变量也可用于在服务器启动时为 X 插件套接字文件设置默认值（请参阅 第4.9 节，“环境变量”）。如果您设置此环境变量，它会覆盖编译后的 MYSQLX_UNIX_ADDR值，但会被该 mysqlx_socket值覆盖。

  • mysqlx_ssl_ca

    命令行格式 --mysqlx-ssl-ca=file_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_ca
    范围 全球的
    动态的 不
    类型 文件名
    默认值 NULL

    系统mysqlx_ssl_ca变量类似ssl_ca，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_capath

    命令行格式 --mysqlx-ssl-capath=dir_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_capath
    范围 全球的
    动态的 不
    类型 目录名称
    默认值 NULL

    系统mysqlx_ssl_capath 变量类似 ssl_capath，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_cert

    命令行格式 --mysqlx-ssl-cert=file_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_cert
    范围 全球的
    动态的 不
    类型 文件名
    默认值 NULL

    系统mysqlx_ssl_cert变量类似ssl_cert，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_cipher

    命令行格式 --mysqlx-ssl-cipher=name
    介绍 5.7.12
    系统变量 mysqlx_ssl_cipher
    范围 全球的
    动态的 不
    类型 细绳
    默认值 NULL

    系统mysqlx_ssl_cipher 变量类似 ssl_cipher，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_crl

    命令行格式 --mysqlx-ssl-crl=file_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_crl
    范围 全球的
    动态的 不
    类型 文件名
    默认值 NULL

    系统mysqlx_ssl_crl变量类似ssl_crl，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_crlpath

    命令行格式 --mysqlx-ssl-crlpath=dir_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_crlpath
    范围 全球的
    动态的 不
    类型 目录名称
    默认值 NULL

    系统mysqlx_ssl_crlpath 变量类似 ssl_crlpath，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。

  • mysqlx_ssl_key

    命令行格式 --mysqlx-ssl-key=file_name
    介绍 5.7.12
    系统变量 mysqlx_ssl_key
    范围 全球的
    动态的 不
    类型 文件名
    默认值 NULL

    系统mysqlx_ssl_key变量类似ssl_key，只是它适用于 X Plugin 而不是 MySQL Server 主连接接口。有关为 X 插件配置加密支持的信息，请参阅 第 19.4.1 节，“使用 X 插件的加密连接”。