---
title: "支持动态修改的参数 | OceanBase 文档中心"
description: "支持动态修改的参数 本文介绍支持动态修改的 ODP 参数。 参数 默认值 取值范围 说明 proxy_info_check_interval 60s [1s, 1h] ODP 检测配置更新的间隔时间。 cache_cleaner_clean_interval 20s [1s, 1d] cache cleaner 清理…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*nSAhQbrBXKwAAAAAAAAAAAAADiGDAQ/original) 数据库代理 V 4.2.0 社区版

# 支持动态修改的参数

更新时间：2026-07-22 14:20:57

[编辑](https://github.com/oceanbase/oceanbase-proxy-doc/edit/V4.2.0/zh-CN/400.configuration-management/200.parameters-that-can-be-dynamically-modified.md)  

本文介绍支持动态修改的 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`** | True | / | 控制 ODP 和 OceanBase 数据库之间是否开启 OceanBase 2.0 协议（OceanBase 自研的基于 MySQL 压缩协议的传输协议）进行传输。   #### 注意    在 ODP 4.x 版本中不允许将该配置项配置为 False，否则会有功能缺失。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线