---
title: "配置管理介绍 | OceanBase 文档中心"
description: 配置管理介绍 OceanBase 数据库通过设置配置项和系统变量来完成配置管理。 配置项 配置项主要用于运维，常用于控制机器及其以上级别的系统行为。可以作为 OBServer 启动参数和租户创建参数，也可以在 OBServer 运行时进行修改以调整系统行为。 有关配置项的详细介绍请参见 设置参数 。 系统变量 系统变…
---
切换语言

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

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

# 配置管理介绍

更新时间：2026-06-26 14:23:48

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.5/zh-CN/100.users-guide/600.basic-database-management/200.configuration-management/100.introduction-to-configuration-management.md)  

OceanBase 数据库通过设置配置项和系统变量来完成配置管理。

## 配置项

配置项主要用于运维，常用于控制机器及其以上级别的系统行为。可以作为 OBServer 启动参数和租户创建参数，也可以在 OBServer 运行时进行修改以调整系统行为。 有关配置项的详细介绍请参见 [设置参数](https://www.oceanbase.com/docs/community-observer-cn-10000000001879710)。

## 系统变量

系统变量通常和用户 Session 绑定，用于控制 Session 级别的 SQL 行为。

支持设置 Global 和 Session 级别的变量。设置 Global 级别的系统变量后，当前 Session 上不会生效，新建的任何 Session 都能读到新的变量值。设置 Session 级别的系统变量后，仅对当前 Session 生效。

有关系统变量的详细介绍请参见 [设置变量](https://www.oceanbase.com/docs/community-observer-cn-10000000001879711)。

## 系统配置项和系统变量对比

| **对比项** | **系统配置项** | **系统变量** |
| --- | --- | --- |
| 生效范围 | 集群、租户、Zone、机器。 | 租户的 Global 级别或 Session 级别。 |
| 生效方式 | - 动态生效：`edit_level` 为`dynamic_effective`。 - 重启生效：`edit_level` 为 `static_effective`。 | - 设置 Session 级别的变量仅对当前 Session 有效，对其他 Session 无效。 - 设置 Global 级别的变量对当前 Session 无效，需要重新登录建立新的 Session 才会生效。 |
| 修改方式 | - 支持通过 SQL 语句修改，示例如下：     `unknow obclient> Alter SYSTEM SET schema_history_expire_time='1h'` 具体请参见 [设置参数](https://www.oceanbase.com/docs/community-observer-cn-10000000001879710)。 - 支持通过启动参数修改，示例如下：     `unknow cd /home/admin && ./bin/observer -o "schema_history_expire_time='1h'"` | 仅支持通过 SQL 语句修改，示例如下：    MySQL 模式 `sql obclient> SET ob_query_timeout = 20000000; obclient> SET GLOBAL ob_query_timeout = 20000000;` 具体请参见 [设置变量](https://www.oceanbase.com/docs/community-observer-cn-10000000001879711)。 |
| 持久化 | 持久化到内部表与配置文件，可以在 `/home/admin/oceanbase/etc/observer.config.bin` 与 `/home/admin/oceanbase/etc/observer.config.bin.history` 文件中查询该配置项。 | 仅 GLOBAL 级别的变量会持久化到内部表，SESSION 级别的变量不会进行持久化。 |
| 生命周期 | 长，从进程启动到退出。 | 短，需要租户的 Schema 创建成功以后才生效。 |
| 查询方式 | 可以使用 `SHOW PARAMETERS` 语句查询。 | 可以使用 `SHOW [GLOBAL] VARIABLES` 或 `SELECT` 语句查询。 |

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