MySQL Router 项目启动与配置教程

1. 项目目录结构及介绍

MySQL Router 是一个轻量级的中介代理，它允许您将客户端请求路由到一个或多个后端 MySQL 服务器。以下是项目的目录结构及其简要介绍：

mysql-router/
├── cmake             # CMake 构建系统文件
├── ci                # 持续集成配置文件
├── client            # MySQL Router 客户端代码
├── include           # 头文件目录
├── libmysqlrouter    # MySQL Router 核心库代码
├── benchmarks        # 性能测试代码
├── doc              # 文档目录
├── packaging         # 打包脚本和配置文件
├── plugins           # 插件代码
├── scripts           # 脚本文件
├── sql               # SQL 脚本目录
├── support           # 辅助文件和工具
└── tests             # 测试代码

• cmake: 包含了构建项目所需的 CMake 配置文件。
• ci: 持续集成（CI）配置文件，用于自动化测试和构建。
• client: 包含了 MySQL Router 客户端代码。
• include: 包含了项目需要的头文件。
• libmysqlrouter: 包含了 MySQL Router 的核心库代码。
• benchmarks: 包含了性能测试的代码。
• doc: 文档目录，包含了项目的文档。
• packaging: 包含了打包脚本和配置文件。
• plugins: 包含了 MySQL Router 插件代码。
• scripts: 包含了项目的脚本文件。
• sql: 包含了项目需要的 SQL 脚本。
• support: 包含了辅助文件和工具。
• tests: 包含了测试代码。

2. 项目的启动文件介绍

MySQL Router 的启动通常是通过命令行进行的。以下是一些基本的启动命令：

# 启动 MySQL Router
mysqlrouter --config=/path/to/config/file.toml

# 启动 MySQL Router 并指定日志文件
mysqlrouter --config=/path/to/config/file.toml --log-file=/path/to/logfile.log

# 启动 MySQL Router 并指定日志等级
mysqlrouter --config=/path/to/config/file.toml --log-level=DEBUG

在命令中，--config 参数用于指定配置文件的路径。--log-file 用于指定日志文件的路径，而 --log-level 用于指定日志等级。

3. 项目的配置文件介绍

MySQL Router 的配置文件通常是采用 TOML 格式。配置文件定义了 MySQL Router 的路由规则、监听端口、后端服务器信息等。

以下是一个基本的配置文件示例：

[mysqlrouter]
router_name = "myrouter"

[logger]
level = "INFO"
[logger.console]
target = "stdout"

[devices]
router = {
    "bind_address": ":33060",
    "destination_address": ":3306"
}

[destinations]
cluster1 = {
    "host": "127.0.0.1",
    "port": 3306,
    "user": "root",
    "password": "password"
}

在这个配置文件中：

• [mysqlrouter] 部分设置了路由器的名称。
• [logger] 和 [logger.console] 部分定义了日志的等级和输出目标。
• [devices] 部分定义了路由器的前端和后端监听地址和端口。
• [destinations] 部分定义了后端 MySQL 服务器的连接信息，包括地址、端口、用户名和密码。

请根据您的具体需求调整配置文件中的内容。