常规选项

路由选项

元数据缓存选项

记录选项

HTTP 服务器选项

MySQL Router 配置文件选项说明

--core-file

如果mysqlrouter死了， 写一个核心文件。核心文件的名称和位置取决于系统。在 Linux 上，一个名为 的核心文件 被写入进程的当前工作目录。 表示服务器进程的进程 ID。在 macOS 上，如果进程具有 授权，则会将名为的核心文件 写入目录。在 Solaris 上，使用coreadm 命令指定核心文件的写入位置以及命名方式。在 Windows 上，一个名为 的小型转储文件 被写入进程的当前工作目录。 core.pidpidcore.pid/corescom.apple.security.get-task-allowmysqlrouter.{pid}.dmp

event_source_name

仅限 Microsoft Windows 平台。定义 MySQL Router 在 Microsoft Windows 上作为服务运行时使用的服务名称。这使您能够在运行多个 MySQL 路由器实例时区分服务，并在事件日志中区分它们的消息。

例如：

[DEFAULT]
event_source_name = MySQLRouterService

logging_folder

MySQL Router 日志文件目录的路径。日志文件名为 mysqlrouter.log，如果此文件已存在，则会生成或附加到该文件。

设置logging_folder为空值会将消息发送到控制台 ( stdout )。

将日志发送到的示例 /var/log/mysqlrouter/mysqlrouter.log：

[DEFAULT]
logging_folder = /var/log/mysqlrouter

当使用--directory bootstrap 选项时，生成的配置文件将其设置为 $directory/log/。

plugin_folder

MySQL Router 插件的路径。此文件夹必须与 MySQL Router 安装目录相匹配。只有在插件不在标准安装位置的自定义安装中才应设置此项。

默认值： /usr/local/lib/mysqlrouter

runtime_folder

MySQL Router 运行时文件的路径。

默认值： /run/mysqlrouter

master-key-writer

从 STDIN 读取主密钥的脚本。使用 --master-key-writer 命令行引导选项进行设置。

master-key-reader

将主密钥返回到 STDOUT 的脚本。使用 --master-key-reader 命令行引导选项进行设置。

config_folder

MySQL Router 配置文件的路径。

默认值： /usr/local/etc/mysqlrouter

sinks

将定义的日志级别发送到的接收器（不同的日志记录方法）。

支持的接收器值是：consolelog、、 filelog（eventlog在 Windows 上）和syslog（在基于 Unix 的系统上）。使用逗号分隔的列表来定义多个值。

默认值：filelog 如果logging_folder“[DEFAULT]”部分中的选项不为空，否则 consolelog。

例如，要将记录器配置为使用文件、控制台和事件日志，每个都使用 [logger]部分中配置的调试日志级别：

[logger]
level=debug
sinks=consolelog,eventlog,filelog

keyring_path

指向密钥环文件的位置。

系统范围的引导程序不会将此选项添加到生成的配置文件中，并假定密钥环文件位于系统范围的运行时状态目录中。如果 --directory还使用，则密钥环文件存储在该实例的运行时状态目录下，run/在指定目录下。

如果未定义此选项，则使用系统范围的默认路径。

用法示例：

keyring_path = /opt/myrouter/data/keyring
master_key_path = /opt/myrouter/mysqlrouter.key

master_key_path

主密钥文件的位置。此选项允许无人值守解密，否则在启动时会请求其位置。

如果未指定此选项，则使用系统范围的默认路径。

用法示例：

keyring_path = /opt/myrouter/data/keyring
master_key_path = /opt/myrouter/mysqlrouter.key

unknown_config_option

确定 MySQL Router 处理未知配置选项的行为，例如拼写错误。

警告是默认行为，引导程序将其定义为 生成的配置文件中的错误。8.0.29 之前的 MySQL Router 版本忽略未知的配置选项。警告记录警告消息但不会停止，而错误表示路由器无法初始化并退出。

[DEFAULT]
unknown_config_option=warning

user (system)

以具有名称 或数字用户 ID 的用户身份 运行mysqlrouter。“用户”在此上下文中是指系统登录帐户，而不是授权表中列出的 MySQL 用户。这也可以在运行时使用 命令行选项进行分配。 user_nameuser_id--user

在 Linux 上，使用官方 DEB 或 RPM 包安装 Router 会在主机上创建一个名为“mysqlrouter”的本地系统用户和组，MySQL Router 默认以该用户运行。该帐户没有 shell 访问权限，其主目录指向存储默认配置文件的目录。

此选项的目的是将 MySQL Router 作为具有受限系统权限的用户运行。如果用户在系统中不存在，或者如果尝试以 root 身份启动 Router，则会发出错误并退出 Router。

MySQL Router 可以在任何操作系统用户下引导和执行，除了对其自身文件的读写访问之外不需要特殊权限。它访问的文件包括插件（读取/执行）、配置文件、日志、UNIX 域套接字文件（如果启用）等。

默认情况下，配置和日志文件写入系统范围的位置，例如/etc和 /var/log。--directory或者，可以使用该选项将路由器引导到它自己的独立目录。例如：

$> sudo mysqlrouter --bootstrap localhost:3310 --directory /a/path/myrouter --user snoopy

在本例中，Router 在这里创建 /a/path/myrouter并添加了所有生成的文件和目录，这些文件和目录只能由系统用户写入snoopy。此外，user在生成的配置文件中定义 /a/path/myrouter/mysqlrouter.conf：

[DEFAULT]
user=snoopy

ssl_ca

连接到元数据服务器时用于验证服务器证书的 SSL CA 文件的路径。

可以选择使用--ssl-ca bootstrap 选项进行设置。

ssl_capath

包含 SSL CA 文件的目录路径，用于在连接到元数据服务器时验证服务器的证书。

可以选择使用--ssl-capath bootstrap 选项进行设置。

ssl_crl

连接到元数据服务器并验证其 SSL 证书时要使用的 SSL CRL 文件的路径。

可以选择使用--ssl-crl bootstrap 选项进行设置。

ssl_crlpath

包含连接到元数据服务器并验证其 SSL 证书时使用的 SSL CRL 文件的目录路径。

可以选择使用--ssl-crlpath bootstrap 选项进行设置。

tls_version

如果启用了 SSL，则以逗号分隔的要请求的 TLS 版本列表，例如“TLSv1.2,TLSv1.3”。

可以选择使用--tls-version bootstrap 选项进行设置。

bind_address

可选 bind_address选项的相关资料：

用法示例：

bind_address = 127.0.0.1:7001

bind_port

或者，您可以定义默认端口以 bind_address使用 bind_port. 如果端口未在中配置bind_address，则bind_port需要并使用。

（可选）使用 --conf-base-portbootstrap 选项设置这些值。

以下三个示例均导致bind_address = 127.0.0.1:7001

[routing:example_1]
bind_port = 7001

[routing:example_2]
bind_port = 7001
bind_address = 127.0.0.1

[routing:example_3]
bind_address = 127.0.0.1:7001

socket

使用 socket选项启用套接字，可以使用或不使用 TCP bind_port和 bind_address选项来指定。一个例子：

[routing]
socket = /tmp/mysqlrouter.sock
destinations = a.example.com:3306,b.example.com:3307

启动 MySQL Router 时，如果 socket 文件已经存在或无法写入，Router 将拒绝运行。

相对路径是可以接受的，并且基于启动路由器的当前工作目录。

路由器可以同时监听 TCP 套接字和 Unix 套接字。例如，以下 [routing]配置示例是有效的，并将路由器配置为侦听 localhost:1234和 上的连接/tmp/mysqlrouter.sock：

[routing:my_redirect]
bind_address = localhost:1234
socket = /tmp/mysqlrouter.sock
mode = read-write
destinations = localhost:57121, localhost:57122, localhost:57123

protocol

连接到目标 MySQL 服务器时由路由插件使用，可以设置为“经典”（默认）或“x”（X 协议）。

用法示例：

[routing:basic_failover]
bind_port = 7001
mode = read-write
destinations = 10.20.200.1:33060, 10.20.200.2:33060
protocol = x

该protocol选项还会影响每个目标使用的默认端口。如果未配置目标端口，则“经典”（默认）的默认端口为 3306，“x”（X 协议）的默认端口为 33060。

pid_file

设置 PID 文件的位置。这可以通过三种不同的方式设置（按优先顺序）： --pid-file 命令行选项，pid_file 在路由器的配置文件中设置此选项，或定义 ROUTER_PID环境变量。

如果--bootstrap指定，则pid_file忽略 ROUTER_PID 定义。这与--pid-file 导致路由器失败的命令行选项不同。

如果--bootstrap未指定，则以下原因会导致 Router 失败：--pid-file 已存在，pid_file 或 ROUTER_PID 已设置但为空，或者 Router 无法写入 PID 文件。

connect_timeout

连接到目标 MySQL 服务器时 MySQL 路由器使用的超时值。该值不能是无限制的，无效的值会导致配置错误。有效范围在 1 到 65536 之间。您应该保持较低的值。

例如，使用read-write模式时，该值可以稍微高一点，以等待 PRIMARY 可用。当使用read-onlymode 进行辅助连接时，较低的值更有意义，因为 Router 在连接路由期间选择新服务器。

用法示例：

[routing]
connect_timeout = 5

可以在引导程序中使用 --conf-set-option=routing.connect_timeout.

connect_timeout

连接到 MySQL 元数据服务器时 MySQL 路由器使用的超时值。

用法示例：

[DEFAULT]
connect_timeout = 5

可以在引导程序中使用 --connect-timeout或 进行设置--conf-set-option=DEFAULT.connect_timeout。

read_timeout

从 MySQL 元数据服务器读取时 MySQL 路由器使用的超时值。默认值为 30 秒。

用法示例：

[DEFAULT]
read_timeout = 30

destinations

提供用于建立连接的主机信息。它接受以逗号分隔的目标地址列表或指向 InnoDB 集群的元数据缓存链接。

特定主机的示例用法（静态路由）：

destinations = a.example.com,b.example.com,c.example.com

InnoDB 集群元数据缓存的示例用法：

destinations=metadata-cache://mycluster/default?role=PRIMARY

metadata-cacheURI 选项是 ：

dynamic_state

此选项跟踪和存储活动的 MySQL InnoDB 集群元数据服务器地址，并在路由器重新启动时加载它们。此功能由已弃用的静态选项激活， --bootstrap并且优先于已弃用的静态 bootstrap_server_addresses 选项。

Bootstrapping 定义文件中 [DEFAULT] 部分下的dynamic_state选项。mysqlrouter.conf该值是名为 的 JSON 文件的路径，该文件 state.json是在引导路由器时创建的。使用state.jsonInnoDB Cluster 元数据服务器地址和 Group Replication ID（InnoDB Cluster 返回的 group_replication_name）进行初始化；在路由器运行时添加和更新附加信息。

示例mysqlrouter.conf条目：

[DEFAULT]
dynamic_state=/opt/myrouter/data/state.json

state.json生成的 示例--bootstrap：

{
    "metadata-cache": {
        "group-replication-id": "4b9e817a-0254-11e9-9cc0-080027bb5030",
        "cluster-metadata-servers": [
            "mysql://localhost:3310",
            "mysql://localhost:3320",
            "mysql://localhost:3330"
        ]
    },
    "version": "1.0.0"
}

不能同时设置deprecated 和dynamic_statedeprecated 选项。bootstrap_server_addresses为了向后兼容，如果仅 bootstrap_server_addresses设置，那么它的功能与以前的路由器版本中一样，并且不使用此动态配置功能。

这个选项是在 MySQL Router 8.0.14 中添加的。

mode

deprecated mode 选项设置 Router 的调度，支持的两个 mode 值是：

或者，前面的 destinations示例可以使用元数据缓存来利用动态配置主机信息的 InnoDB 集群的元数据缓存。例如：。

[routing:ro_route]
bind_port = 7002
destinations=metadata-cache://myCluster/default?role=SECONDARY
routing_strategy=round-robin

routing_strategy

路由策略定义了 MySQL Router 如何选择要连接的 MySQL 服务器。

可用策略：

无法到达的目的地会被隔离和跳过，并且每隔 unreachable_destination_refresh_interval 几秒就会探测一次可用性。next-available除利用此行为外的所有路由策略 。此功能是在 v8.0.29 中添加的。

role默认值和可用组合 ：

unreachable_destination_refresh_interval

隔离机制跟踪无法到达的目的地，然后在它们重新联机时探测它们的可用性。此选项确定在将每个无法到达的候选目标添加回轮换之前对其可用性进行探测的频率（以秒为单位）。

[DEFAULT]
unreachable_destination_refresh_interval = 1

next-available除利用此行为 外的所有路由策略 。

max_connections

每个路由可以限制路由或连接的数量。一种可能的用途是帮助防止可能的拒绝服务 (DOS) 攻击。默认值为 512，有效范围为 1 到 65536。

这类似于MySQL 服务器的 max_connections服务器系统变量。

[routing:mycluster_default_rw]
max_connections = 512

或者，使用更新的 max_total_connections配置选项为所有路由器部分组合设置一个值。

MySQL Router 8.0.22 引入了将并发连接限制从大约 5,000 增加到 50,000 的功能。最大值取决于系统的轮询（或 linux_epoll）限制和可用 CPU 内核/线程的数量。另请参阅 [IO] backend 和 threads 配置选项。

max_connections部分中的 可选设置[DEFAULT]为每个路由目标设置默认值。

max_total_connections

路由器处理的最大客户端连接数，以帮助防止文件描述符用完。

这类似于MySQL 服务器的 max_connections服务器系统变量。

[DEFAULT]
max_total_connections = 512

默认值为 512，它在该 [DEFAULT]部分下设置。这个选项是在 MySQL Router 8.0.27 中添加的。

thread_stack_size

为每个线程分配的堆栈大小。它以千字节为单位，默认为 64。

[DEFAULT]
thread_stack_size=128

net_buffer_length

设置net_buffer_length MySQL 服务器选项。

max_connect_errors

默认值为 100，有效范围为 1 到 2^32（4294967295，无符号整数）。

这类似于 MySQL 服务器的 max_connect_errors服务器系统变量。

如果应用程序执行频繁的重新连接，这可能会导致轻微的性能损失，因为 MySQL Router 会尝试发现是否存在与连接相关的错误。

成功的连接会重置错误计数器（自 8.0.14 起）。

每个路由都有自己的阻止主机列表。被阻止的客户端会收到 MySQL 服务器错误 1129 代码和稍微不同的错误消息：“1129：来自 fail.example.com 的连接错误太多”。路由器日志包含有关被阻止客户端的额外信息，例如： INFO [...] fail.example.com 的 1 个身份验证错误（最多 100） WARNING [...] 阻止客户端主机 fail.example.com

max_connect_errors = 100

client_connect_timeout

这类似于MySQL 服务器的 connect_timeout服务器系统变量。

默认值为 9，比 MySQL 5.7 默认值小 1。有效范围介于 2 和 31536000 之间。

client_connect_timeout = 9

auth_cache_refresh_interval

授权缓存刷新尝试之间的时间（以秒为单位）。默认为 2。该值必须小于 auth_cache_ttl和大于ttl否则路由器将不会启动。

如果 http_auth_backend部分的 backend 选项设置为metadata_cache ，则应用此选项；这是路由器 REST API 功能。

auth_cache_ttl

如果不刷新缓存变为无效的时间（以秒为单位）。默认为 -1（无限）。该值必须大于 auth_cache_refresh_interval ，ttl否则 Router 将无法启动。

如果 http_auth_backend部分的 backend 选项设置为metadata_cache ，则应用此选项；这是路由器 REST API 功能。

router_id

MySQL 路由器 ID。

server_ssl_curves

默认为 SSL 曲线的安全列表。将此字符串格式化为以冒号分隔的曲线名称列表。

server_ssl_cipher

默认为 SSL 密码的安全列表。将此字符串格式化为冒号分隔的密码名称列表。

server_ssl_verify

SSL 验证默认设置为禁用。

server_ssl_mode

SSL 模式默认设置为 AS_CLIENT。另见 第 4.4 节，“TLS 配置”。

client_ssl_dh_params

如果指定且不为空，则使用此文件中的 DH 参数而不是内部默认 DH 参数。将 DH 参数文件格式化为 PEM 格式。

client_ssl_curves

客户端和 MySQL Router 之间允许哪些曲线，默认为 SSL 曲线的安全列表。将此字符串格式化为以冒号分隔的曲线名称列表。

client_ssl_cipher

客户端和 MySQL Router 之间允许使用哪些密码，默认为 SSL 密码的安全列表。将此字符串格式化为冒号分隔的密码名称列表。

client_ssl_mode

控制从 client 到 MySQL Router 的连接是否必须加密。另见 第 4.4 节，“TLS 配置”。

ssl_mode

用于连接到 MySQL 元数据服务器的 SSL 模式。PREFERRED如果未设置 ，则默认为。

当设置为 PREFERRED（默认值）时，引导程序将在未使用 SSL 且与元数据服务器的连接未加密时发出警告。

可用值为 DISABLED、PREFERRED、REQUIRED、VERIFY_CA 和 VERIFY_IDENTITY。对于mysql 客户端，此值不区分大小写。

还有一个用于引导的运行时选项；看 --ssl-mode。

bootstrap_server_addresses

指向具有可以连接到的元数据的 MySQL 服务器列表。访问元数据后，元数据缓存切换到主 ReplicaSet 中存在的服务器来获取元数据。它们也称为引导服务器。

此选项在 MySQL Router 8.0.14 中已弃用，并且不再由引导程序生成。相反，该 dynamic_state选项是作为替代品添加的。

user (MySQL)

生成的 MySQL 用户具有访问 MySQL 服务器元数据模式的权限。该用户的密码是自动生成的并存储在加密的 密钥环中。默认情况下，此密钥环的加密密钥存储在 配置文件中定义的读保护主密钥存储文件中。最常见的是，此用户和关联的密码是在引导过程中自动生成的。相关的命令行选项是 --force-password-validation 和--password-retries。默认情况下，生成的密码通过 STRONG validate_password 强度。

密码完全由 Router 管理，从不公开，并使用运行 MySQL Router 的操作系统帐户存储在本地密钥环系统中。然后 Router 可以使用它连接到 InnoDB Cluster 并检索当前的拓扑信息。默认情况下，路由器和元数据服务器之间的会话使用 SSL 加密。

生成的密钥环文件的存储位置取决于引导程序的配置方式。对于自包含安装（使用时 --directory），它存储run/在自包含目录下。对于系统范围的安装，它存储在系统范围的运行时状态目录中，并且该路径是特定于平台的。有关其他信息，请参阅 master_key_path和 keyring_path

此用户被分配（并需要）以下权限：

Privileges needed by the Router account:

	On Metadata Server:

		SELECT ON mysql_innodb_cluster_metadata.*

	On Target Replica Sets:

		SELECT ON performance_schema.replication_group_members
		SELECT ON performance_schema.replication_group_member_stats

生成的用户名遵循以下模式： mysql_router_[0-9]{1,6} _ [0-9a-z]{12}，其中[0-9]{1,6}是数字路由器 ID，[0-9a-z]{12}是 12 个随机小写字母数字字符。router id 如果已经存在则重复使用，mysqlrouter.conf并且其长度不能超过 6 位。

metadata_cluster

InnoDB 集群的名称。

use_gr_notifications

启用组复制通知。启用后，路由器会异步收到有关大多数集群更改的通知。它可以在引导程序mysqlrouter.conf中使用 --conf-use-gr-notifications 命令行选项手动启用或在那里启用。

当 Router 从 Group Replication 收到以下任何通知时，它会刷新集群元数据：

启用后，Group Replication 通知功能允许更高的ttl值，因为按时间间隔执行的元数据刷新 ttl成为一种额外的保护措施，而不是使有关集群状态的信息保持最新的主要方式。禁用时，建议使用较低的ttl值（例如 0.5s，默认值）以避免重新连接到实例并经常查询它们的元数据更改的开销。

ttl

元数据缓存中信息的生存时间（以秒为单位）。

接受整数或浮点值。粒度限制为毫秒，其中 0.001 等于一毫秒。精度被截断到支持的范围；例如TTL=0.0119被视为 11 毫秒。值为0表示元数据缓存模块在紧密循环中连续查询元数据。

该值必须小于 auth_cache_refresh_interval ，auth_cache_ttl否则 Router 将不会启动。

唯一支持的小数点分隔符是“.” （一个句点）无论语言环境如何，都支持科学记数法，例如 TTL=1.6E-2。

MySQL Router 8.0.12 中添加了浮点支持。

destination

将控制台日志输出定向到此设备目标；在 [consolelog] 部分下设置。默认为 /dev/stderr，空值使用默认值。

可用值有：/dev/stdout、 /dev/stderr和 /dev/null；或者CON和 NUL在 Windows 上。

[DEFAULT]
logging_folder=

[consolelog]
destination=/dev/null

filename

filename将日志输出重定向到 目录中 名为的特定文件 logging_folder。它必须定义为文件名而不是文件路径，并且与 [logger] 和 [filelog] 部分一起使用。

与 [logger] 一起使用filename来定义 [filelog] 部分的默认值，它还将路由器的日志文件从更改mysqlrouter.log为这个新值。

[DEFAULT]
logging_folder=/path/to/logs/

[logger]
filename = router_error.log

如果在 [logger] 下设置了文件名但没有使用基于文件的记录器，路由器不会报告错误。

filename与 [文件日志] 一起 使用：

[DEFAULT]
logging_folder=/path/to/logs/

[filelog:a]
filename = a_router_error.log

[filelog:b]
filename = b_router_error.log

如果 filename 为空或未在 [filelog] 下设置，则使用 [logger] 下的文件名定义；mysqlrouter.log如果未在 [logger] 下设置文件名， 则使用默认日志文件 ( )。

相关的，将控制台输出定向到 /dev/null：

[DEFAULT]
logging_folder=

[consolelog]
destination=/dev/null

level

使用记录器插件记录通知、错误和调试信息。可用的日志级别为 DEBUG、NOTE、 INFO（默认）、 WARNING、ERROR、 SYSTEM和FATAL。这些值不区分大小写。

INFO级别 显示所有信息性消息、警告和错误消息。DEBUG级别显示来自路由器代码的附加诊断信息，包括成功的路由 。 SYSTEM包括诸如启动消息之类的消息。

[logger]
level = DEBUG

输出行为取决于 logging_folder选项。设置logging_folder为文件夹会保存一个以该文件夹命名的日志文件 mysqlrouter.log。设置 logging_folder为空值，或不设置，都会将日志输出到控制台。它在[DEFAULT]部分中设置。

--config引导程序接受使用记录器级别定义 的配置文件 。

timestamp_precision

记录器时间戳精度；具有示例值的可用定义是：

port

监听 HTTP 请求的 TCP 端口；它默认为 8881。

bind_address

绑定到 HTTP 的 IP 地址port；它默认为 0.0.0.0。

static_folder

静态文件请求的基本目录；默认情况下它是空的。空值表示不提供静态文件。

require_realm

[http_auth_realm] 实例的名称。

ssl

值 1 启用 SSL，0 禁用它。需要支持 TLSv1.2 或更高版本的 TLS 客户端。这是在 [http_server] 部分下定义的。

ssl_cert

PEM 格式的证书及其链证书的文件名；如果 ssl=1，则需要。这是在 [http_server] 部分下定义的。

ssl_key

PEM 格式的密钥文件名；如果 ssl=1，则需要。这是在 [http_server] 部分下定义的。

ssl_cipher

密码规范（参见 openssl 的“密码”列表）。默认为所有已批准密码的逗号分隔列表。未知的密码被默默地忽略。如果密码列表为空且 ssl=1，则失败。这是在 [http_server] 部分下定义的。

ssl_dh_param

以 PEM 格式从该文件中读取 DH 参数。如果 ssl=1，则默认使用 RFC 5114 中的 dh-param。这是在 [http_server] 部分下定义的。

backend

处理异步操作的 IO 后端。通用轮询后端在所有平台上都可用，而每个平台都可以提供替代后端。

选项是 poll（所有平台）和 linux_epoll (Linux)。在 Linux 上默认为 linux_epoll。

[io]
backend=linux_epoll
threads=32

路由器有三个“后端”选项，每个选项在不同的 [section] 中具有不同的含义。有“ [io] backend”（用于异步操作）、“ [http_auth_realm] backend”（为与特定领域关联的后端定义自定义名称）和“ [http_auth_backend] backend”（身份验证后端的类型）。为了帮助避免混淆，下面是一个演示所有这三者的示例：

threads

处理连接的 IO 线程数。

默认为 0（使用所有可用的 CPU 核心/线程），但也接受 1 到 1024 之间的数字。在运行时，系统可能会限制上限超过此值。

[io]
backend=linux_epoll
threads=32

idle_timeout

在关闭连接池之前将空闲连接保留在连接池中的秒数。这在 [connection_pool] 部分中设置，并影响连接池中的所有路由。默认为 5，接受 1 到 4294967296 之间的值。

这个选项是在 MySQL Router 8.0.29 中添加的。

max_idle_server_connections

客户端断开后连接池中保持打开的连接；并在 [connection_pool] 部分中设置。默认为 0，接受 0 到 4294967296 之间的值。

这个选项是在 MySQL Router 8.0.29 中添加的。

backend

[http_auth_backend] 部分的名称。

路由器有三个“后端”选项，每个选项在不同的 [section] 中具有不同的含义。有“ [io] backend”（用于异步操作）、“ [http_auth_realm] backend”（为与特定领域关联的后端定义自定义名称）和“ [http_auth_backend] backend”（身份验证后端的类型）。

method

HTTP认证方式；默认为基本。

name

呈现给身份验证用户的领域名称。

require

要求用户通过身份验证后端进行验证；默认为有效用户，启用此检查。

backend

后端实现的名称；可接受的值为“文件”（默认）或“元数据缓存”。

[http_auth_backend:name]
backend=metadata_cache

[metadata_cache]
auth_cache_refresh_interval=2
auth_cache_ttl=-1

路由器有三个“后端”选项，每个选项在不同的 [section] 中具有不同的含义。有“ [io] backend”（用于异步操作）、“ [http_auth_realm] backend”（为与特定领域关联的后端定义自定义名称）和“ [http_auth_backend] backend”（身份验证后端的类型）。

filename

后端存储文件名，相对于 data_folder目录。

cluster_type

引导路由器的 AdminAPI 对象的类型，它是 InnoDB ReplicaSet (rs) 或 InnoDB Cluster (gr)。将“gr”用于群集集。

引导评估目标实例并在生成的配置文件中相应地设置此选项。

MySQL Router 8.0.19 新增此选项；添加了相同版本的 InnoDB ReplicaSet 支持。