配置文件参数
在 xSQL 启动选项中，我们详细介绍了多种配置参数，这些参数能够决定 xSQL 的行为。为了帮助您更好地理解和使用这些配置，以下表格列出了可以在配置文件中指定的选项。配置文件采用 JSON 格式，并支持一些额外的功能：
- 支持十六进制（如 0x[0-9A-F]）、八进制（如 0[0-7]）和十进制数字。
- 数字可以带有后缀“k”、“K”（千）、“m”、“M”（兆）和“g”、“G”（吉），方便表示大数值（例如，100m 表示 100 * 1024 * 1024）。
- 对于不含空格或特殊符号的字符串，您可以省略引号。
- 井号（#）后面的字符将被视为注释，直到行尾。
默认情况下，xSQL 会在工作目录中查找名为 xsql.cfg 的配置文件。如果您需要使用其他配置文件，可以通过命令行中的 -c 选项来指定。
对于某些由多个标志组合而成的参数值，您可以选择将其定义为数组或单个标志值。例如：
“flags : value1” 表示 “flags = value1”
title: 更多命令
description: xSQL Miscellaneous Commands
order: 2“flags : []” 表示 “flags = 0”
下表列出了配置文件中的不同部分及其对应的 C API 结构。您可以点击相关链接查看每个部分的详细描述。
| 配置结构 | 描述 |
|---|---|
| runtime_configuration : {...} | 运行时配置（启动时加载的库集） |
| runtime_options : {...} | 全局运行时选项（mco_runtime_setoption()） |
| [devices : [{...}]](Devices) | 设备描述（mco_device_t）和“快捷方式”参数数组 |
| schema | 数据库模式定义 |
| db_paras: {...} | 数据库参数（mco_db_params_t） |
| SQL 参数 | 影响 SQL 操作的参数 |
| tl_params : {...} | 事务日志参数（mco_TL_start_data_t） |
| ha_params: {...} | 高可用性参数（mco_HA_master_params_t 和 mco_HA_replica_params_t） |
| cluster_params : {...} | 集群参数（mco_cluster_params_t） |
| iot_params: {...} | 活动复制参数 |
| ssl_params : {...} | OpenSSL 参数（mco_ssl_params_t） |
| rest : {...} | 运行嵌入式 REST 服务器并公开 Web 服务 REST API |
| xlog_params : {...} | 统计日志记录参数 |
| trace_params: {...} | 跟踪框架参数 |
| 更多参数 | 影响运行时操作的杂项参数 |
| [持久媒体 IO](持久媒体 IO) | 异步 I/O 和不同的多文件格式选项 |
配置文件的设置与传递给 C API 函数 mco_db_open_dev()、mco_cluster_db_open()、mco_HA_attach_master() 和 mco_HA_attach_replica() 的结构相对应。例如：
- devices 部分对应 mco_device_t 结构数组
- db_params 部分对应 mco_db_params_t 参数
- cluster_params 部分对应 mco_cluster_params_t 设置
命令行选项优先于配置文件中的参数，命令行中指定的值将覆盖配置文件中的相同设置。