---
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 3.2.3.5 企业版

# 支持动态修改的参数

更新时间：2026-07-22 12:15:51

本文介绍支持动态修改的 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 压缩协议的传输协议）进行传输。 |

 上一篇 下一篇 ![有帮助](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) 咨询热线