---
title: "系统变量总览 - OceanBase 数据库 V4.3.2 | OceanBase 文档中心"
description: 系统变量总览 本文根据系统变量的功能，详细地罗列了 OceanBase 数据库的系统变量。 Global 级别 安全相关 变量名 功能描述 validate_password_check_user_name 用于设置用户密码是否可以和用户名相同。 validate_password_length 用于设置用户密码最小…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.2

# 系统变量总览

更新时间：2025-09-05 15:51:54

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.2/zh-CN/700.reference/800.configuration-items-and-system-variables/200.system-variable/200.system-variable-overview.md)  

本文根据系统变量的功能，详细地罗列了 OceanBase 数据库的系统变量。

## Global 级别

### 安全相关

| 变量名 | 功能描述 |
| --- | --- |
| [validate_password_check_user_name](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052744) | 用于设置用户密码是否可以和用户名相同。 |
| [validate_password_length](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052730) | 用于设置用户密码最小长度。 |
| [validate_password_mixed_case_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052776) | 用于设置用户密码至少包含的大写字母个数以及至少包含的小写字母个数。 |
| [validate_password_number_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052752) | 用于设置用户密码至少包含的数字个数。 |
| [validate_password_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052714) | 用于设置密码检查策略。 |
| [validate_password_special_char_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052824) | 用于设置用户密码至少包含的特殊字符个数。 |
| [ob_tcp_invited_nodes](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052825) | 用于设置租户的 IP 白名单，支持百分号（%） 、短横线（_） 和 IP（多个 IP 之间用逗号分隔），支持 IP 列表匹配、掩码匹配和模糊匹配。 |
| [default_password_lifetime](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052823) | 用于设置密码的过期时间。 |
| [block_encryption_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052829) | 用于指定在函数 aes_encrypt 和 aes_decrypt 中使用的加密算法。 |
| [sql_safe_updates](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052732) | 用于设置是否启用 MySQL 的 SQL 安全模式，默认为关闭。 |

### 版本信息相关

| 变量名 | 功能描述 |
| --- | --- |
| [version_comment](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052783) | 用于查看 OBServer 节点的版本信息。 |
| [version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052761) | 用于查看服务器的版本号。 |
| [ob_last_schema_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052667) | 用于设置该 session 中最新使用的 Schema 版本号。 |
| [ob_proxy_global_variables_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052835) | 用于设置 OBServer 节点返回给 OBproxy 所需的全局变量的最新版本信息。 |
| [ob_enable_transmission_checksum](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052693) | 用于设置 obproxy 和 OBServer 节点之间是否进行数据包校验和，设置后实时生效。 |
| [ob_compatibility_control](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052757) | 用于控制 MYSQL5.7、 MYSQL8.0 有兼容性冲突时的行为模式。 |
| [ob_compatibility_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052826) | 用于控制产品行为发生变更的功能兼容的 OceanBase 数据库版本。 |
| [ob_security_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052743) | 用于控制安全功能兼容的 OceanBase 数据库版本。在创建租户时指定兼容版本，且在租户创建后无法修改。 |

### Debug 相关

| 变量名 | 功能描述 |
| --- | --- |
| debug | 用于设置调试选项，其默认值为 `d:t:i:o,/tmp/mysqld.trace`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| debug_sync | 用于在 Debug 时设置同步点，其默认值为 `空字符串`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |

### 大小写相关

| 变量名 | 功能描述 |
| --- | --- |
| [lower_case_table_names](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052797) | 用于设置是否对大小写敏感。 |

### 读写/查询相关

| 变量名 | 功能描述 |
| --- | --- |
| [query_cache_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052698) | 用于设置分配给存储历史查询结果的内存，即尚未使用的内存。 |
| [query_cache_type](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052706) | 用于查询缓存类型。 |
| [ob_query_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052694) | 用于设置查询超时时间。 |
| [is_result_accurate](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052660) | 当查询带有 `topk` 提示时，`is_result_accurate` 表示结果是否正确。 |
| [net_buffer_length](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052815) | 用于设置 OBServer 节点能接受的 SQL Query 的大小。 |
| [read_only](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052813) | 用于设置租户是否为只读模式。 |
| [ob_read_consistency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052793) | 用于设置读一致性级别。 |
| [ob_max_read_stale_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052778) | 弱读取查询的最大延迟阈值（us）。 |
| [net_read_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052746) | 用于中断读之前等待连接的其它数据的秒数。 |
| [net_write_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052764) | 用于设置中断写之前等待块写入连接的秒数。 |
| [ob_enable_index_direct_select](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052817) | 用于设置是否允许用户直接查询索引表。 |
| [ob_enable_aggregation_pushdown](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052807) | 用于设置是否允许聚合操作下压。 |
| [ob_enable_jit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052749) | 用于设置 JIT 执行引擎模式。 |
| [sql_throttle_network](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052707) | 用于指定请求排队时间，如果请求排队时间大于或等于该值，则不允许执行查询。 |
| [parallel_servers_target](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052719) | 用于设置每个 Server 上的大查询排队条件。 |
| [cte_max_recursion_depth](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052832) | 用于设置公共表表达式（CTE）的最大递归深度。服务器会终止执行任何超过此 CTE 值的操作。 |
| [regexp_stack_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052686) | 用于正则表达式匹配操作的内部堆栈的最大可用内存。 |
| [regexp_time_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052831) | 用于正则表达式匹配操作的时间限制。 |
| [long_query_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001950468) | 用于设置慢查询的阈值。 |

### 调度程序相关

| 变量名 | 功能描述 |
| --- | --- |
| [event_scheduler](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052775) | 用于确定事件调度程序是否在服务器上启用和运行。 |

### 外键相关

| 变量名 | 功能描述 |
| --- | --- |
| [foreign_key_checks](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052809) | 用于设置是否在 DML/DDL 中检查外建约束。 |

### 副本相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_create_table_strict_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052798) | 用于设置建表的严格模式。 |
| [ob_default_replica_num](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052822) | 用于设置每个集群中表的默认副本数。 |

### 回收站相关

| 变量名 | 功能描述 |
| --- | --- |
| [recyclebin](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052777) | 用于设置是否开启回收站功能。 |
| [ob_enable_truncate_flashback](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052796) | 用于设置是否启用表截断的闪回。 |

### 缓存相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_enable_plan_cache](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052754) | 用于设置是否打开 Plan Cache。 |
| [ob_plan_cache_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052750) | 用于设置计划缓存可使用内存占租户内存的百分比。 |
| [ob_plan_cache_evict_high_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052723) | 用于设置触发计划缓存淘汰的内存大小占内存上限绝对值的百分比。 |
| [ob_plan_cache_evict_low_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052816) | 用于设置停止淘汰计划缓存的内存大小占内存上限绝对值的百分比。 |
| [ob_bnl_join_cache_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052781) | 用于设置 Batch Nest Loop Join 一次 Cache 多少数据做一次 Batch。 |
| stored_program_cache | 用于设置存储过程和函数的缓存数量，其默认值为 `256`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |

### 函数相关

| 变量名 | 功能描述 |
| --- | --- |
| [interactive_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052760) | 用于设置服务器关闭交互式连接前等待活动的秒数。 |
| [wait_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052786) | 用于设置服务器关闭非交互连接之前等待活动的秒数。 |
| [group_concat_max_len](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052739) | 用于设置允许的 `GROUP_CONCAT()` 函数结果的最大长度。 |

### InnoDB 存储引擎相关

| 变量名 | 功能描述 |
| --- | --- |
| innodb_change_buffering_debug | 用于设置更改 InnoDB 缓冲区的调试级别，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_compress_debug | 用于调整和控制压缩行为的调试级别，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_disable_resize_buffer_pool_debug | 用于是否开启 InnoDB 缓冲池的大小调整，其默认值为 `1`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_fil_make_page_dirty_debug | 用于在调试 InnoDB 中弄脏指定的页面数，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_limit_optimistic_insert_debug | 用于设置每个 B-tree 页面的记录数，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_merge_threshold_set_all_debug | 用于设置索引页面的页满百分比，其默认值为 `50`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_saved_page_number_debug | 用于设置在调试 InnoDB 中保存的页码数，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_trx_purge_view_update_only_debug | 用于控制事务清理过程中仅更新清理视图的调试级别，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| innodb_trx_rseg_n_slots_debug | 用于指定事务回滚段（transaction rollback segment）中的槽数量。每个槽用于存储事务的回滚信息，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| [innodb_stats_persistent](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052773) | 用于控制是否将 InnoDB 索引统计信息持久化到磁盘上。 |

### 集群相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_capability_flag](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052668) | 是 OBServer 节点能够提供的能力，用于和 Proxy 连接时进行能力协商，告知 Proxy 当前 OBServer 节点支持哪些功能，不支持哪些功能。 |
| [ob_compatibility_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052685) | 用于指定租户的兼容模式。 |
| [ob_route_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052741) | 用于设置 OBServer 节点内部选择数据副本的路由策略。 |
| [performance_schema](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052794) | 用于向客户端声明是否支持 Performance 信息的查询，其默认值为 `OFF`。   #### 说明    该变量仅用于兼容 MySQL 8.0，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| [resource_manager_plan](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052702) | 用于激活资源管理计划。指定不同计划，会使用不同 CPU 的额度来限定资源组下的用户活动。 |
| [license](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052770) | 用于查看 license 的类型。 |
| [ob_proxy_partition_hit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052676) | 用于设置 obproxy 是否将 SQL 语句请求的数据发送到这些数据主 Partition 所在的 OBServer 节点上。 |
| [ob_org_cluster_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052662) | 用于设置 OceanBase 集群的 `CLUSTER_ID`。 |
| [server_uuid](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052691) | 用于查看 OBServer 节点 UUID。 |
| [default_storage_engine](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052733) | 用于查看 OBServer 节点的默认存储引擎。 |

### 目录路径相关

| 变量名 | 功能描述 |
| --- | --- |
| [datadir](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052740) | 用于查看数据存储的本地磁盘路径。 |
| [plugin_dir](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052818) | 用于查看存放插件 DLL 的路径。 |
| [secure_file_priv](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052763) | 控制导入或导出到文件时可以访问的路径。 |
| [ob_enable_hash_group_by](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052774) | 用于设置是否打开 Hash Group by 的路径。 |

### 内存相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_sql_work_area_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052768) | 用于 SQL 执行的租户内存百分比限制。 |
| [ob_sql_audit_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052701) | 用于设置 SQL Audit 内存上限占当前租户内存的百分比。 |
| [ob_reserved_meta_memory_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052737) | 用于设置租户预留内存的比例，主要存储 Meta 相关的结构信息。 |
| [ob_temp_tablespace_size_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052692) | 用于租户磁盘中临时表空间大小的百分比限制。 |

### 系统日志相关

| 变量名 | 功能描述 |
| --- | --- |
| [binlog_row_image](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052799) | 用于控制是否记录全列日志。 |
| [ob_enable_show_trace](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052669) | 用于设置是否使用 Trace 日志。 |
| [ob_log_level](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052804) | 用于设置 session 级的日志级别，如果不指定则使用系统中的日志级别。 |
| [tracefile_identifier](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052661) | 用于在日志中增加指定内容，便于筛选行迭代跟踪日志。 |

### Runtime Filter 相关

| 变量名 | 功能描述 |
| --- | --- |
| [runtime_filter_type](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052820) | 用于设置租户级别的 Runtime Filter 类型。 |
| [runtime_filter_wait_time_ms](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052765) | 用于设置 Runtime Filter 的最大等待时间。 |
| [runtime_filter_max_in_num](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052828) | 用于设置 Runtime In Filter 的 NDV （某个列中不同值的个数）个数。 |
| [runtime_bloom_filter_max_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052827) | 用于设置 Runtime Bloom Filter 的最大使用内存，单位为字节。 |

### 时区和日期相关

| 变量名 | 功能描述 |
| --- | --- |
| [time_zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052790) | 用于设置当前租户会话使用的时区，支持 `'+08:00'` 的 Offset 形式和 `Asia/Shanghai` 的地域形式取值。 |
| [timestamp](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052666) | `TIMESTAMP` 是时间戳，单位为秒，该变量影响 `select now(6)`的结果。 |
| [system_time_zone](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052725) | 用于设置服务器机器系统时区。 |
| [error_on_overlap_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052728) | 用于设置夏令时重叠区时间发生歧义时是否作报错处理。 |
| [nls_language](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052672) | 表示数据库国际化支持中的默认语言，用于提示信息、日期、月份名以及 `NLS_SORT` 和`NLS_DATE_LANGUAGE` 的默认值。 |
| [nls_territory](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052688) | 表示数据库国际化支持中的当前地域，与 `nls_language` 结合使用。 |
| [nls_date_language](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052736) | 表示数据库国际化支持中的日期默认语言。 |
| [nls_calendar](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052710) | 用于控制数据库使用的日历系统。 |
| [ob_timestamp_service](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052782) | 用于指定使用何种时间戳服务。 |

### 事务及事务日志相关

| 变量名 | 功能描述 |
| --- | --- |
| [autocommit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052748) | 用于设置是否自动提交事务。 |
| [tx_isolation](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052800) | 用于设置事务隔离级别。 |
| [ob_proxy_set_trx_executed](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052677) | 用于设置用户是否通过 obproxy 发送 `START TRANSACTION Syntax` 给 OBServer。 |
| [ob_early_lock_release](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052697) | 用于控制事务是否开启提前解锁（ ELR ）功能。   #### 说明    该变量从 V2.2.30 版本开始废弃。ELR 产品行为调整为受租户级别配置项 `enable_early_lock_release` 控制。 |
| [ob_trx_idle_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052684) | 用于设置事务空闲超时时间，即事务中两条语句之间的执行间隔超过该值时超时。 |
| [transaction_isolation](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052716) | 用于设置事务的隔离级别。 |
| [transaction_read_only](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052715) | 用于控制是否只允许开启只读事务。 |
| [ob_trx_lock_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052767) | 用于设置事务的等锁超时时长。 |
| [tx_read_only](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052830) | 用于设置是否为只读事务。 |
| [ob_trx_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052745) | 用于设置事务超时时间。 |
| [ob_trace_info](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052675) | 用于透传 Trace 信息，该信息最终可透持久化到 REDO 日志中。 |

### 审计相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_enable_sql_audit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052819) | 用于控制当前租户是否开启 SQL Audit 功能。 |

### 数据类型相关

| 变量名 | 功能描述 |
| --- | --- |
| [nls_length_semantics](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052811) | 表示 CHAR、VARCHAR2 类型的 Length 语义。 |
| [nls_nchar_conv_excp](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052718) | 用于控制 NCHAR/NVARCHAR2 与 CHAR/VARCHAR2 之间转换丢失数据时是否报错。 |
| [nls_numeric_characters](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052814) | 用于控制 Number 和字符串转换中字符串中小数分隔符和千分位分隔符的字符。 |
| [nls_currency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052771) | 用于设置数字格式元素 `L` 的本地货币符号。 |
| [nls_iso_currency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052689) | 用于设置数字格式元素 `C` 的本地货币符号。 |
| [nls_dual_currency](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052726) | 用于设置数字格式元素 `U` 的本地货币符号。 |
| [nls_date_format](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052721) | 用于控制 date 类型转 str 的格式，以及 str 隐式转 date 的格式。 |
| [nls_timestamp_format](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052812) | 用于控制 Timestamp 或 Timestamp 中 ltz 类型转 str 的格式，以及 str 隐式转 Timestamp 或 Timestamp 中 ltz 的格式。 |
| [nls_timestamp_tz_format](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052717) | 用于控制 Timestamp tz 类型转 str 的格式，以及 str 隐式转 Timestamp tz 的格式。 |
| [explicit_defaults_for_timestamp](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052803) | 用于指定 timestamp 数据类型在处理默认值和空值时是否启用非标准行为。 |
| [log_row_value_options](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052699) | 用于控制 Lob 是否使用部分更新。 |
| [ob_default_lob_inrow_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052729) | 用于指定建表时，表中 LOB 字段的默认行内存储阈值。 |

### SQL/PL 相关

| 变量名 | 功能描述 |
| --- | --- |
| [connect_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052705) | 用于设置连接超时时间。 |
| [ob_pl_block_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052720) | 用于设置 PL 的最大超时时间。 |
| [cursor_sharing](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052738) | 用于判断处理 SQL 时是否进行参数化。 |
| have_profiling | 用于检测是否支持查询性能分析，其默认值为 `NO`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询，但无法设置。 |
| profiling | 用于启用或禁用语句分析功能，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| profiling_history_size | 用于设置保存查询性能信息的历史记录数量，其默认值为 `15`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| [innodb_strict_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052734) | 用于设置特定语法的 SQL 检查模式。 |
| [max_connections](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052735) | 用于设置整个租户的最大连接数。 |
| [sql_mode](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052801) | 用于设置 SQL 模式，不同的 SQL 模式对于插入等行为有很大影响。 |
| [sql_quote_show_create](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052766) | 用于设置是否为 `SHOW CREATE TABLE` 和 `SHOW CREATE DATABASE` 语句启动引用标识符。 |
| [ob_enable_rich_error_msg](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052806) | 用于控制 SQL 执行出错时是否显示 svr_ip、time、trace_id 等信息。 |
| [sql_throttle_current_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052808) | 用于设置限流优先级，只有 `sql_throttle_current_priority` 小于 `sql_throttle_priority` 的那些 session 上的请求才会被限流。 |
| [sql_throttle_priority](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052708) | 用于设置限流优先级。 |
| [sql_throttle_rt](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052731) | 用于指定 RT 值。 |
| [max_allowed_packet](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052780) | 用于设置最大网络包大小。 |
| [max_user_connections](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052747) | 用于指定单个用户可以向 OBServer 节点建立的连接数，设置为 `0` 时表示不限制连接数。 |
| [max_sp_recursion_depth](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052791) | 用于设置可以递归调用任一指定存储过程的最大层次。 |
| [sql_select_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052713) | 用于设置一个 Select 查询允许返回的最大行数。 |
| [max_connections](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052735) | 用于设置整个租户的最大连接数。 |
| [ob_enable_blk_nestedloop_join](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052712) | 用于设置是否允许打开 block nested loop join。 |
| [parallel_max_servers](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052805) | 用于设置每台 Server 上并行执行（Parallel eXecution，PX）线程池中的最大线程数。 |

### 优化器相关

| 变量名 | 功能描述 |
| --- | --- |
| [optimizer_use_sql_plan_baselines](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052784) | 用于控制优化器是否会使用 Plan Baseline 计划。 |
| [optimizer_capture_sql_plan_baselines](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052722) | 用于控制是否自动捕获新计划到 Plan Baseline。 |
| [parallel_degree_policy](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052696) | 用于设置并行度选择策略。 |
| [parallel_degree_limit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052753) | 用于设置在使用 Auto DOP 策略时，优化器选择并行度的上限值。 |
| [parallel_min_scan_time_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052756) | 设置对基表扫描进行并行处理的最小评估执行时间。 |
| [optimizer_dynamic_sampling](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052772) | 用于控制动态采样的等级。 |
| [optimizer_features_enable](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052759) | 用于启用不同 OceanBase 版本优化器功能。 |
| [ob_enable_transformation](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052758) | 用于设置是否开启 SQL 优化器的改写功能。 |

### 自增列相关

| 变量名 | 功能描述 |
| --- | --- |
| [auto_increment_increment](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052751) | 用于设置自增步长，仅用于 MySQL 客户端登录。 |
| [auto_increment_offset](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052810) | 用于确定 `AUTO_INCREMENT` 列值的起点。 |
| [last_insert_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052663) | 用于返回本 session 最后一次插入的自增字段值。 |
| [sql_auto_is_null](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052836) | 用于控制是否获取最后插入行的自增列值。 |
| [auto_increment_cache_size](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052789) | 用于设置缓存的自增值个数。 |
| [div_precision_increment](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052802) | 用于设置除法结果精度在被除数精度基础上的增量，是 MySQL 兼容功能。 |

### 字符集和字符串相关

| 变量名 | 功能描述 |
| --- | --- |
| [character_set_client](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052779) | 用于设置客户端发送语句的字符集。 |
| [character_set_connection](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052690) | 用于设置收到语句后应转换的字符集。 |
| [character_set_database](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052788) | 用于设置默认数据库的字符集。 |
| [character_set_results](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052682) | 用于设置服务器在将结果集或错误消息发送回客户端之前应转换为的字符集。 |
| [character_set_server](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052821) | 用于设置服务器字符集。 |
| [character_set_system](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052785) | 用于查看服务器使用的字符集。 |
| [collation_connection](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052755) | 用于设置连接使用的字符集和字符序。 |
| [collation_database](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052711) | 用于设置创建数据库默认字符集和字符序。 |
| [collation_server](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052709) | 用于设置服务器默认字符集和字符序。 |
| [character_set_filesystem](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052787) | 用于设置文件系统字符集类型。 |
| [sql_warnings](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052792) | 用于在出现告警时控制单行 INSERT 语句是否生成信息字符串。 |
| [init_connect](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052742) | 用于设置服务器为每个连接的客户端执行的字符串，该字符串由一条或多条 SQL 语句组成，用分号分隔。 |
| [nls_sort](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052687) | 表示字符串值的排序规则。 |
| [nls_comp](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052762) | 表示字符串值的比较规则。 |
| [nls_characterset](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052703) | 用于查看数据库中 CHAR、VARCHAR2、CLOB 等数据类型的默认字符集。 |
| [nls_nchar_characterset](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052683) | 表示数据库默认字符集，用于 NCHAR、NVARCHAR2、NCLOB 等数据类型。 |

## Session 级别

### 版本信息相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_last_schema_version](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052667) | 用于设置该 session 中最新使用的 Schema 版本号。 |

### 读写/查询相关

| 变量名 | 功能描述 |
| --- | --- |
| [is_result_accurate](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052660) | 当查询带有 `topk` 提示时，`is_result_accurate` 表示结果是否正确。 |
| [long_query_time](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001950468) | 用于设置慢查询的阈值。 |

### Debug 相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_global_debug_sync](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003874112) | 用于 Debug 时设置同步点，与 `debug_sync` 不同，设置此变量会影响所有 session。 |

### 集群相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_capability_flag](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052668) | 是 OBServer 节点能够提供的能力，用于和 Proxy 连接时进行能力协商，告知 Proxy 当前 OBServer 节点支持哪些功能，不支持哪些功能。 |
| [ob_proxy_partition_hit](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052676) | 用于设置 obproxy 是否将 SQL 语句请求的数据发送到这些数据主 Partition 所在的 OBServer 节点上。 |
| [ob_org_cluster_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052662) | 用于设置 OceanBase 集群的 `CLUSTER_ID`。 |

### 系统日志相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_enable_show_trace](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052669) | 用于设置是否使用 Trace 日志。 |
| [tracefile_identifier](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052661) | 用于在日志中增加指定内容，便于筛选行迭代跟踪日志。 |

### 时区和日期相关

| 变量名 | 功能描述 |
| --- | --- |
| [timestamp](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052666) | `TIMESTAMP` 是时间戳，单位为秒，该变量影响 `select now(6)`的结果。 |
| [nls_language](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052672) | 表示数据库国际化支持中的默认语言，用于提示信息、日期、月份名以及 `NLS_SORT` 和`NLS_DATE_LANGUAGE` 的默认值。 |

### 事务及事务日志相关

| 变量名 | 功能描述 |
| --- | --- |
| [ob_proxy_set_trx_executed](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052677) | 用于设置用户是否通过 obproxy 发送 `START TRANSACTION Syntax` 给 OBServer。 |
| [ob_trace_info](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052675) | 用于透传 Trace 信息，该信息最终可透持久化到 REDO 日志中。 |

### 自增列相关

| 变量名 | 功能描述 |
| --- | --- |
| [last_insert_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052663) | 用于返回本 session 最后一次插入的自增字段值。 |
| [identity](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003874113) | `identity` 和变量 `last_insert_id` 是同义词，可以通过 `select @@identity` 查询。 |

### SQL/PL 相关

| 变量名 | 功能描述 |
| --- | --- |
| have_profiling | 用于检测是否支持查询性能分析，其默认值为 `NO`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询，但无法设置。 |
| profiling | 用于启用或禁用语句分析功能，其默认值为 `0`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |
| profiling_history_size | 用于设置保存查询性能信息的历史记录数量，其默认值为 `15`。   #### 说明    该变量仅用于兼容 MySQL 5.7，相关功能并不支持，可以查询及设置，设置行为不报错但不生效。 |

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