PD 配置文件描述
PD 配置文件比命令行参数支持更多的选项。你可以在 conf/config.toml 找到默认的配置文件。
本文档只阐述未包含在命令行参数中的参数,命令行参数参见 PD 配置参数。
name
- PD 节点名称。
- 默认值:
"pd"
- 如果你需要启动多个 PD,一定要给 PD 使用不同的名字。
data-dir
- PD 存储数据路径。
- 默认值:
"default.${name}"
client-urls
- PD 监听的客户端 URL 列表。
- 默认值:
"http://127.0.0.1:2379"
- 如果部署一个集群,client URLs 必须指定当前主机的 IP 地址,例如
"http://192.168.100.113:2379"
,如果是运行在 Docker 则需要指定为"http://0.0.0.0:2379"
。
advertise-client-urls
- 用于外部访问 PD 的 URL 列表。
- 默认值:
"${client-urls}"
- 在某些情况下,例如 Docker 或者 NAT 网络环境,客户端并不能通过 PD 自己监听的 client URLs 来访问到 PD,这时候,你就可以设置 advertise URLs 来让客户端访问。
- 例如,Docker 内部 IP 地址为
172.17.0.1
,而宿主机的 IP 地址为192.168.100.113
并且设置了端口映射-p 2379:2379
,那么可以设置为advertise-client-urls="http://192.168.100.113:2379"
,客户端可以通过http://192.168.100.113:2379
来找到这个服务。
peer-urls
- PD 节点监听其他 PD 节点的 URL 列表。
- 默认:
"http://127.0.0.1:2380"
- 如果部署一个集群,peer URLs 必须指定当前主机的 IP 地址,例如
"http://192.168.100.113:2380"
,如果是运行在 Docker 则需要指定为"http://0.0.0.0:2380"
。
advertise-peer-urls
- 用于其他 PD 节点访问某个 PD 节点的 URL 列表。
- 默认值:
"${peer-urls}"
- 在某些情况下,例如 Docker 或者 NAT 网络环境,其他节点并不能通过 PD 自己监听的 peer URLs 来访问到 PD,这时候,你就可以设置 advertise URLs 来让其他节点访问
- 例如,Docker 内部 IP 地址为
172.17.0.1
,而宿主机的 IP 地址为192.168.100.113
并且设置了端口映射-p 2380:2380
,那么可以设置为advertise-peer-urls="http://192.168.100.113:2380"
,其他 PD 节点可以通过http://192.168.100.113:2380
来找到这个服务。
initial-cluster
- 初始化 PD 集群配置。
- 默认值:
"{name}=http://{advertise-peer-url}"
- 例如,如果 name 是 "pd",并且
advertise-peer-urls
是"http://192.168.100.113:2380"
,那么initial-cluster
就是"pd=http://192.168.100.113:2380"
。 - 如果启动三台 PD,那么
initial-cluster
可能就是pd1=http://192.168.100.113:2380, pd2=http://192.168.100.114:2380, pd3=192.168.100.115:2380
。
initial-cluster-state
- 集群初始状态
- 默认值:"new"
initial-cluster-token
- 用于在集群初始化阶段标识不同的集群。
- 默认值:"pd-cluster"
- 如果先后部署多个集群,且多个集群有相同配置的节点,应指定不同的 token 来隔离不同的集群。
lease
- PD Leader Key 租约超时时间,超时系统重新选举 Leader。
- 默认值:3
- 单位:秒
quota-backend-bytes
- 元信息数据库存储空间的大小,默认 8GiB。
- 默认值:8589934592
auto-compaction-mod
- 元信息数据库自动压缩的模式,可选项为 periodic(按周期),revision(按版本数)。
- 默认值:periodic
auto-compaction-retention
- compaction-mode 为 periodic 时为元信息数据库自动压缩的间隔时间;compaction-mode 设置为 revision 时为自动压缩的版本数。
- 默认值:1h
force-new-cluster
- 强制让该 PD 以一个新集群启动,且修改 raft 成员数为 1。
- 默认值:false
tso-update-physical-interval
- TSO 物理时钟更新周期。
- 在默认的一个 TSO 物理时钟更新周期内 (50ms),PD 最多提供 262144 个 TSO。如果需要更多的 TSO,可以将这个参数调小。最小值为
1ms
。 - 缩短这个参数会增加 PD 的 CPU 消耗。根据测试,相比
50ms
更新周期,更新周期为1ms
时,PD 的 CPU 占用率 (CPU usage) 将增加约 10%。 - 默认值:50ms
- 最小值:1ms
pd-server
pd-server 相关配置项。
flow-round-by-digit
从 v5.1 版本开始引入
- 默认值:3
- PD 会对流量信息的末尾数字进行四舍五入处理,减少 Region 流量信息变化引起的统计信息更新。该配置项用于指定对 Region 流量信息的末尾进行四舍五入的位数。例如流量
100512
会归约到101000
。默认值为3
。该配置替换了trace-region-flow
。
min-resolved-ts-persistence-interval
从 v6.0.0 版本开始引入
- 设置 PD leader 对集群中 Resolved TS 最小值进行持久化的间隔时间。如果该值设置为
0
,表示禁用该功能。 - 默认值:在 v6.3.0 之前版本中为
"0s"
,在 v6.3.0 及之后的版本中为"1s"
,即最小正值。 - 最小值:
"0s"
- 单位:秒
security
安全相关配置项。
cacert-path
- CA 文件路径
- 默认值:""
cert-path
- 包含 X509 证书的 PEM 文件路径
- 默认值:""
key-path
- 包含 X509 key 的 PEM 文件路径
- 默认值:""
redact-info-log
从 v5.0 版本开始引入
- 控制 PD 日志脱敏的开关
- 该配置项值设为 true 时将对 PD 日志脱敏,遮蔽日志中的用户信息。
- 默认值:false
log
日志相关的配置项。
level
- 指定日志的输出级别。
- 可选值:"debug","info","warn","error","fatal"
- 默认值:"info"
format
- 日志格式。
- 可选值:"text","json"
- 默认值:"text"
disable-timestamp
- 是否禁用日志中自动生成的时间戳。
- 默认值:false
log.file
日志文件相关的配置项。
max-size
- 单个日志文件最大大小,超过该值系统自动切分成多个文件。
- 默认值:300
- 单位:MiB
- 最小值为 1
max-days
- 日志保留的最长天数。
- 如果未设置本参数或把本参数设置为默认值
0
,PD 不清理日志文件。 - 默认:0
max-backups
- 日志文件保留的最大个数。
- 如果未设置本参数或把本参数设置为默认值
0
,PD 会保留所有的日志文件。 - 默认:0
metric
监控相关的配置项。
interval
- 向 Prometheus 推送监控指标数据的间隔时间。
- 默认:15s
schedule
调度相关的配置项。
max-merge-region-size
- 控制 Region Merge 的 size 上限,当 Region Size 大于指定值时 PD 不会将其与相邻的 Region 合并。
- 默认:20
- 单位:MiB
max-merge-region-keys
- 控制 Region Merge 的 key 上限,当 Region key 大于指定值时 PD 不会将其与相邻的 Region 合并。
- 默认:200000
patrol-region-interval
- 控制 replicaChecker 检查 Region 健康状态的运行频率,越短则运行越快,通常状况不需要调整
- 默认:10ms
split-merge-interval
- 控制对同一个 Region 做 split 和 merge 操作的间隔,即对于新 split 的 Region 一段时间内不会被 merge。
- 默认:1h
max-snapshot-count
- 控制单个 store 最多同时接收或发送的 snapshot 数量,调度受制于这个配置来防止抢占正常业务的资源。
- 默认:64
max-pending-peer-count
- 控制单个 store 的 pending peer 上限,调度受制于这个配置来防止在部分节点产生大量日志落后的 Region。
- 默认值:64
max-store-down-time
- PD 认为失联 store 无法恢复的时间,当超过指定的时间没有收到 store 的心跳后,PD 会在其他节点补充副本。
- 默认值:30m
max-store-preparing-time
从 v6.1.0 版本开始引入
- 控制 store 上线阶段的最长等待时间。在 store 的上线阶段,PD 可以查询该 store 的上线进度。当超过该配置项指定的时间后,PD 会认为该 store 已完成上线,无法再次查询这个 store 的上线进度,但是不影响 Region 向这个新上线 store 的迁移。通常用户无需修改该配置项。
- 默认值:48h
leader-schedule-limit
- 同时进行 leader 调度的任务个数。
- 默认值:4
region-schedule-limit
- 同时进行 Region 调度的任务个数
- 默认值:2048
hot-region-schedule-limit
- 控制同时进行的 hot Region 任务。该配置项独立于 Region 调度。
- 默认值:4
hot-region-cache-hits-threshold
- 设置识别热点 Region 所需的分钟数。只有当 Region 处于热点状态持续时间超过此分钟数时,PD 才会参与热点调度。
- 默认值:3
replica-schedule-limit
- 同时进行 replica 调度的任务个数。
- 默认值:64
merge-schedule-limit
- 同时进行的 Region Merge 调度的任务,设置为 0 则关闭 Region Merge。
- 默认值:8
high-space-ratio
- 设置 store 空间充裕的阈值。当节点的空间占用比例小于该阈值时,PD 调度时会忽略节点的剩余空间,主要根据实际数据量进行均衡。此配置仅在
region-score-formula-version = v1
时生效。 - 默认值:0.7
- 最小值:大于 0
- 最大值:小于 1
low-space-ratio
- 设置 store 空间不足的阈值。当某个节点的空间占用比例超过该阈值时,PD 会尽可能避免往该节点迁移数据,同时主要根据节点剩余空间大小进行调度,避免对应节点的磁盘空间被耗尽。
- 默认值:0.8
- 最小值:大于 0
- 最大值:小于 1
tolerant-size-ratio
- 控制 balance 缓冲区大小。
- 默认值:0(为 0 为自动调整缓冲区大小)
- 最小值:0
enable-cross-table-merge
- 设置是否开启跨表 merge。
- 默认值:true
region-score-formula-version
从 v5.0 版本开始引入
- 设置 Region 算分公式版本。
- 默认值:v2
- 可选值:v1,v2。v2 相比于 v1,变化会更平滑,空间回收引起的调度抖动情况会得到改善。
enable-joint-consensus
从 v5.0 版本开始引入
- 是否使用 Joint Consensus 进行副本调度。关闭该特性时,PD 将采用一次调度一个副本的方式进行调度。
- 默认值:true
enable-diagnostic
从 v6.3.0 版本开始引入
- 是否开启诊断功能。开启特性时,PD 将会记录调度中的一些状态来帮助诊断。开启时会略微影响调度速度,在 Store 数量较多时会消耗较大内存。
- 默认值:false
hot-regions-write-interval
从 v5.4.0 版本开始引入
- 设置 PD 存储 Hot Region 信息时间间隔。
- 默认值:10m
hot-regions-reserved-days
从 v5.4.0 版本开始引入
- 设置 PD 保留的 Hot Region 信息的最长时间。单位为天。
- 默认值: 7
replication
副本相关的配置项。
max-replicas
- 所有副本数量,即 leader 与 follower 数量之和。默认为
3
,即 1 个 leader 和 2 个 follower。当此配置被在线修改后,PD 会在后台通过调度使得 Region 的副本数量符合配置。 - 默认值:3
location-labels
- TiKV 集群的拓扑信息。
- 默认值:[]
- 配置集群拓扑
isolation-level
- TiKV 集群的最小强制拓扑隔离级别。
- 默认值:""
- 配置集群拓扑
strictly-match-label
- 打开强制 TiKV Label 和 PD 的 location-labels 是否匹配的检查
- 默认值:false
enable-placement-rules
- 打开
placement-rules
- 默认值:true
- 参考 Placement Rules 使用文档
label-property(已废弃)
标签相关的配置项,只支持 reject-leader
类型。
key
(已废弃)
- 拒绝 leader 的 store 带有的 label key。
- 默认值:""
value
(已废弃)
- 拒绝 leader 的 store 带有的 label value。
- 默认值:""
dashboard
PD 中内置的 TiDB Dashboard 相关配置项。
tidb-cacert-path
- CA 根证书文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
- 默认值:""
tidb-cert-path
- SSL 证书文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
- 默认值:""
tidb-key-path
- SSL 私钥文件路径。可配置该路径来使用 TLS 连接 TiDB 的 SQL 服务。
- 默认值:""
public-path-prefix
- 通过反向代理访问 TiDB Dashboard 时,配置反向代理提供服务的路径前缀。
- 默认值:"/dashboard"
- 若不通过反向代理访问 TiDB Dashboard,请勿配置该项,否则可能导致 TiDB Dashboard 无法正常访问。关于该配置的详细使用场景,参见通过反向代理使用 TiDB Dashboard。
enable-telemetry
- 是否启用 TiDB Dashboard 遥测功能。
- 默认值:对于 TiDB v6.5.0,默认值为 true;对于 v6.5.1 以及之后的 v6.5.x 版本,默认值为 false。
- 参阅遥测了解该功能详情。