支持动态修改的参数 | OceanBase 文档中心

支持动态修改的参数

更新时间：2024-11-13 10:20:58

本文介绍支持动态修改的 ODP 参数。

参数	默认值	取值范围	说明
`proxy_info_check_interval`	60s	[1s, 1h]	ODP 检测配置更新的间隔时间。
`cache_cleaner_clean_interval`	20s	[1s, 1d]	cache cleaner 清理缓存的间隔时间。
`server_state_refresh_interval`	20s	(10ms, 1h]	刷新 OceanBase 数据库进程状态的时间间隔。
`metadb_server_state_refresh_interval`	60s	[10ms, 1h]	刷新 MetaDB 的时间间隔。
`config_server_refresh_interval`	60s	[10s, 1d]	刷新 config server 的时间间隔。
`idc_list_refresh_interval`	2h	[10s, 1d]	刷新 IDC 信息的时间间隔。
`stat_dump_interval`	6000s	[0s, 1d]	转储统计全局统计信息任务的时间间隔。
`stat_table_sync_interval`	60s	[0s,1d]	更新内部表全局统计项任务的时间间隔。
`cluster_count_high_water_mark`	256	[2, 102400]	允许创建的最大集群资源。
`cluster_expire_time`	1d	[0, +∞)	集群元数据空闲超时时间。
`fetch_proxy_bin_random_time`	300s	[1s, 1h]	ODP 执行热升级时，在获取新二进制文件之前需要等待的最长随机时间。
`hot_upgrade_rollback_timeout`	24h	[1s, 30d]	热升级之后, 执行回滚的默认等待时间。
`hot_upgrade_failure_retries`	5	[1, 20]	热升级失败后重试次数。
`fetch_proxy_bin_timeout`	120s	[1s, 1200s]	热升级获取新二进制文件的超时时间。
`delay_exit_time`	100ms	[100ms, 500ms]	ODP 延迟退出的时间。
`log_file_percentage`	80	[0, 100]	ODP 日志文件占用可用空间的百分比阈值。日志占用空间超过 `min(log_dir_size_threshold, 日志文件夹可用空间*log_file_percentage)` 值后进行日志清理，取值为 `0` 时表示忽略此限制。
`log_cleanup_interval`	1m	[5s, 30d]	执行清理任务的时间间隔。
`log_dir_size_threshold`	64GB	[256MB, 1T]	ODP 日志所在目录的最大可用空间阈值。当日志占用空间超过 `min(log_dir_size_threshold, 日志文件夹可用空间*log_file_percentage)` 值后进行日志清理。
`max_log_file_size`	256MB	[1MB, 1G]	单个日志文件的最大尺寸。
`long_async_task_timeout`	60s	[1s, 1h]	长异步任务超时时间。
`short_async_task_timeout`	5s	[1s, 1h]	短异步任务超时时间。
`client_max_connections`	8192	[0, +∞]	ODP 支持的最大客户端连接数。
`observer_query_timeout_delta`	20s	[1s, 30s]	OceanBase 数据库进程的 `ob_query_timeout` 增量值。
`enable_cluster_checkout`	true	/	判断是否校验集群名称。
`enable_client_ip_checkout`	true	/	判断是否校验客户端 IP。
`connect_observer_max_retries`	3	[2, 5]	ODP 重连 OceanBase 数据库的最大次数。
`net_config_poll_timeout`	1ms	[0, +∞)	网络事件超时时间。
`default_inactivity_timeout`	180000s	[1s, 30d]	TCP 连接的默认超时时间。
`sock_send_buffer_size_out`	0	[0, 8MB]	socket 的发送缓冲区大小。
`sock_recv_buffer_size_out`	0	[0, 8MB]	socket 的接收缓冲区大小。
`sock_option_flag_out`	3	[0, +∞]	socket flag 参数。
`sock_packet_mark_out`	0	[0, +∞]	socket mark 参数。
`sock_packet_tos_out`	0	[0, +∞]	socket tos 参数。
`server_tcp_init_cwnd`	0	[0, 64]	新建 Server 连接时设置 TCP 初始拥塞窗口值。
`server_tcp_keepidle`	5	[0, 7200]	ODP 与 OceanBase 数据库连接的 TCP 存活空闲时间。
`server_tcp_keepintvl`	5	[0, 75]	ODP 与 OceanBase 数据库连接的 TCP 存活时间间隔。
`server_tcp_keepcnt`	5	[0, 9]	ODP 与 OceanBase 数据库连接的 TCP 存活 probe count。
`server_tcp_user_timeout`	0	[0, 20]	ODP 与 OceanBase 数据库连接的 TCP 用户超时时间。
`client_sock_option_flag_out`	2	[0, +∞)	ODP 与客户端的 socket flag 参数。
`client_tcp_keepidle`	5	[0, 7200]	ODP 与客户端连接的 TCP 存活空闲时间。
`client_tcp_keepintvl`	5	[0, 75]	ODP 与客户端连接的 TCP 存活时间间隔。
`client_tcp_keepcnt`	5	[0, 9]	ODP 与客户端连接的 TCP 存活 probe count。
`client_tcp_user_timeout`	0	[0, 20]	ODP 与客户端连接的 TCP 用户超时时间。
`proxy_mem_limited`	2G	[100MB, 100G]	ODP 运行时内存上限。超过上限 ODP 即自动退出。
`routing_cache_mem_limited`	128M	[1KB, 100G]	PL/SQL 路由缓存内存上限。
`enable_flow_control`	true	/	判断是否在 tunnel 中开启流量控制。
`flow_high_water_mark`	64k	[0, 16MB]	tunnel 中流量控制的上限。
`flow_low_water_mark`	64k	[0, 16MB]	tunnel 中流量控制的下限。
`flow_consumer_reenable_threshold`	256	[0, 131072]	tunne 流量控制配置数据转发次数阈值。
`flow_event_queue_threshold`	5	[0, 20]	tunnel 流量控制配置工作线程队列中任务数阈值。
`tunnel_request_size_threshold`	8KB	(0, 16MB]	ODP 接收请求次数的阈值。当请求次数超过该阈值时, ODP 直接使用 tunnel 转发客户端请求, 且不解析请求。
`request_buffer_length`	4KB	[1KB, 16MB]	请求 buffer 大小。
`default_buffer_water_mark`	32KB	[4B, 64KB]	默认的 buffer water mark。
`enable_trans_detail_stats`	true	/	判断是否开启事务状态统计。
`enable_sync_all_stats`	true	/	判断是否开启同步所有统计。
`enable_report_session_stats`	false	/	判断是否开启 session 级别统计项汇报到内部表。
`enable_strict_stat_time`	true	/	判断是否开启 strict statistic time。
`enable_trace_stats`	false	/	判断是否开启 MySQL 追踪统计。
`slow_transaction_time_threshold`	1s	[0s, 30d]	事务执行时间阈值。超过阈值即打印一条告警日志。
`slow_proxy_process_time_threshold`	2ms	[0s, 30d]	ODP 预执行请求执行时间阈值。超过阈值即打印一条告警日志。
`query_digest_time_threshold`	100ms	[0s, 30d]	请求执行时间阈值，超过阈值即打印一条日志到 `obproxy_digest.log` 文件。
`slow_query_time_threshold`	500ms	[0s, 30d]	慢请求执行时间阈值。超过阈值即打印一条日志到 `obproxy_slow.log` 文件。
`ignore_local_config`	true	/	判断是否忽略本地配置文件。
`congestion_failure_threshold`	5	[0, +∞)	判断是否将 OceanBase 数据库服务器列入黑名单。在`congestion_fail_window` 周期内，当 OceanBase 数据库服务器出错次数超过该值时，ODP 将这台服务器加入黑名单。
`min_keep_congestion_interval`	20s	[1s, 1d]	黑名单中的 OceanBase 数据库服务器在洗白之前需要等待的最短时间。
`congestion_fail_window`	120s	[1s, 1h]	OceanBase 数据库服务器出错统计周期，与`congestion_failure_threshold` 配合使用。
`congestion_retry_interval`	20s	[1s, 1h]	存活却不可用黑名单中 OceanBase 数据库服务器的重试时间间隔。
`min_congested_connect_timeout`	100ms	[1ms, 1h]	存活却不可用的最小超时时间。
`enable_congestion`	true	/	判断是否开启黑名单。
`enable_bad_route_reject`	false	/	判断开启黑名单时，是否拒绝无法路由的请求。
`enable_partition_table_route`	true	/	判断是否开启 partition table 路由。
`enable_reroute`	false	/	判断是否开启二次路由。
`enable_pl_route`	true	/	判断否开启过程化程序语言（PL）路由。
`syslog_level`	INFO	DEBUG, TRACE, INFO, WARN, USER_ERR, ERROR	日志级别。
`monitor_log_level`	INFO	DEBUG, TRACE, INFO, WARN, USER_ERR, ERROR	监控日志级别。
`xflush_log_level`	INFO	DEBUG, TRACE, INFO, WARN, USER_ERR, ERROR	xflush 日志级别。
`enable_async_log`	true	/	判断是否开启异步日志。
`enable_ob_protocol_v2`	False	/	控制 ODP 和 OceanBase 数据库之间是否开启 OceanBase 2.0 协议（OceanBase 自研的基于 MySQL 压缩协议的传输协议）进行传输。