Oceanbase数据库—基于社区版本的数据库集群管理

1 单机版本集群的特性

本次是基于社区版本的数据库集群的单机版。单机版本特性如下：

OceanBase 数据库单机版是一款基于单机分布式一体化架构的数据库产品，专为中小规模业务场景设计。OceanBase 数据库单机版是一款单节点数据库，其所有业务逻辑和数据处理集中在一台物理服务器上，这个数据库单元在 OceanBase 数据库中称为 OceanBase 集群。

对于 OceanBase 数据库单机版，OceanBase 集群由一个 Zone 组成。Zone 是一个逻辑概念，是对节点进行管理的容器，对于单机版，一个 Zone 仅包含一个节点。从物理层面来讲，一个 Zone 通常是一个独立的物理部署单元，可以是一个数据中心（IDC）或者云上的一个可用区，也可以是一个单独的机架（Rack）。

OceanBase 数据库是单进程软件，进程名为 observer。通常一台物理或者虚拟服务器运行一个 observer 进程，由 IP 和端口作为唯一标识，我们称之为节点，也可以用 OBServer 节点表示。observer 进程作为 OceanBase 数据库最核心的组件，负责几乎所有数据库内核功能，包括 SQL 引擎、存储引擎和事务引擎。

2 集群日常操作

2.1 节点查看

OceanBase 数据库是单进程软件，进程名为 observer。通常一台物理或者虚拟服务器运行一个 observer 进程，由 IP 和端口作为唯一标识，称之为节点。

查看节点
查询 DBA_OB_SERVERS 视图，获取集群中的所有节点信息。

bash 复制代码

obclient(root@sys)[(none)]> SELECT * FROM oceanbase.DBA_OB_SERVERS;
+--------------+----------+------+-------+----------+-----------------+--------+----------------------------+-----------+-----------------------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------+-------------------+
| SVR_IP       | SVR_PORT | ID   | ZONE  | SQL_PORT | WITH_ROOTSERVER | STATUS | START_SERVICE_TIME         | STOP_TIME | BLOCK_MIGRATE_IN_TIME | CREATE_TIME                | MODIFY_TIME                | BUILD_VERSION                                                                             | LAST_OFFLINE_TIME |
+--------------+----------+------+-------+----------+-----------------+--------+----------------------------+-----------+-----------------------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------+-------------------+
| 192.168.6.63 |     2882 |    1 | zone1 |     2881 | YES             | ACTIVE | 2025-11-17 14:04:04.643038 | NULL      | NULL                  | 2025-11-17 09:21:31.203213 | 2025-11-17 14:04:06.190607 | 4.4.1.0_100000032025101610-70824e90816ed333c56f3dd1af34ffec43d0fa88(Oct 16 2025 10:13:47) | NULL              |
+--------------+----------+------+-------+----------+-----------------+--------+----------------------------+-----------+-----------------------+----------------------------+----------------------------+-------------------------------------------------------------------------------------------+-------------------+
1 row in set (0.003 sec)

查询结果中的相关字段说明如下：

字段	描述
SVR_IP	节点 IP。
SVR_PORT	节点的 RPC 端口。
ZONE	节点所在的 Zone。
SQL_PORT	节点的 SQL 端口，可以使用该端口通过直连方式连接 OceanBase 数据库。
WITH_ROOTSERVER	该节点是否为集群 RS（RootServer），RS 负责处理集群管理操作。
STATUS	节点的状态。
ACTIVE	表示该节点为可用状态。
INACTIVE	表示该节点为宕机状态。
DELETING	表示该节点正在被删除。
STOP_TIME	用户主动停止节点服务的时间点。如果值为 NULL，表示节点服务正常运行。
START_SERVICE_TIME	节点进程启动后，可以对外提供服务的时间点。如果值为 NULL，表示节点进程未启动或节点状态不可用。
BLOCK_MIGRATE_IN_TIME	禁止迁入数据的开始时间点。如果为 NULL，表示数据正常迁入。
BUILD_VERSION	OceanBase 数据库软件的版本号。

2.2 节点重启

重启节点的主要流程为：转储 -> 关闭进程 -> 启动进程。
1，使用 root 用户登录到集群的 sys 租户。

bash 复制代码

[admin@centos7 etc]$ obclient -h192.168.6.63 -P2881 -uroot@sys -p -c -A
Enter password: 
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 3221527997
Server version: OceanBase_CE 4.4.1.0 (r100000032025101610-70824e90816ed333c56f3dd1af34ffec43d0fa88) (Built Oct 16 2025 10:13:47)

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient(root@sys)[(none)]>

2，执行以下命令，对待重启的节点进行转储操作，以便缩短重启后回放 Redo Log 的时间，加速重启。

bash 复制代码

ALTER SYSTEM MINOR FREEZE SERVER = ('svr_ip:svr_port');

3 集群配置项相关

3.1 集群的配置项

OceanBase 数据库的 observer 进程首次启动时需要指定某些必需配置项。除了必需配置项以外，如果没有指定，则使用系统指定的 Default 值。进程启动成功后，参数值将持久化到 /home/admin/observer/etc/observer.config.bin （本机的对应目录）文件中，可以通过 strings observer.config.bin 命令来查看文件中的内容。非首次启动时，系统会读取持久化文件中的配置项，如果无需修改，则无需再次指定任何配置项。

3.1.1配置项级别

OceanBase 数据库的配置项分为集群级配置项和租户级配置项。

集群级配置项：作用范围为整个集群所有租户。

租户级配置项：作用范围为当前租户。

名称以 "_" 开头的配置项称为隐藏配置项，如：_ob_max_thread_num。仅供开发人员在故障排查或紧急运维时使用。本文不对隐藏配置项进行详细介绍，下文中的配置项均不包含隐藏配置项。

租户类型	参数查看	参数设置
系统租户	集群级配置项、租户级配置项说明：SHOW PARAMETERS 语句通过指定 TENANT 关键字来查看指定租户的配置项信息。	集群级配置项、租户级配置项说明：通过指定 TENANT 关键字来修改全部或指定租户的租户级配置项。
普通租户	集群级配置项和本租户的租户级配置项	本租户的租户级配置项

3.1.2 配置项的级别和生效方式

配置项一般分为动态生效和重启生效两种方式，大部分配置项为动态生效方式，即不需要重启 OBServer 即可生效。

查询某个配置项的方式如下：'

bash 复制代码

[admin@centos7 etc]$ obclient -h192.168.6.63 -P2881 -uroot@sys -p -c -A
Enter password: 
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 3221527997
Server version: OceanBase_CE 4.4.1.0 (r100000032025101610-70824e90816ed333c56f3dd1af34ffec43d0fa88) (Built Oct 16 2025 10:13:47)

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient(root@sys)[(none)]>
obclient(root@sys)[(none)]> SHOW PARAMETERS LIKE 'max_syslog_file_count';
+-------+----------+--------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone  | svr_type | svr_ip       | svr_port | name                  | data_type | value | info                                                                                                                                                                                                                                             | section  | scope   | source  | edit_level        | default_value | isdefault |
+-------+----------+--------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone1 | observer | 192.168.6.63 |     2882 | max_syslog_file_count | INT       | 4     | specifies the maximum number of the log files that can co-exist before the log file recycling kicks in. Each log file can occupy at most 256MB disk space. When this value is set to 0, no log file will be removed. Range: [0, +∞) in integer   | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | 0             |         0 |
+-------+----------+--------------+----------+-----------------------+-----------+-------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
1 row in set (0.005 sec)

scope 列表示该配置项的级别，如果对应的值为 CLUSTER，则表示该配置项为集群级别；如果对应的值为 TENANT，则表示该配置项为租户级别。

edit_level 列表示该配置项的生效方式，一般分为动态生效和重启生效两种方式，dynamic_effective 表示动态生效；static_effective 表示重启生效。大部分配置项为动态生效方式，即不需要重启 OBServer 即可生效。

3.2 查看集群配置项

查看集群配置项主要有以下几种方式：

3.2.1 通过 SHOW 语句查看集群配置项

可以查看集群中除隐藏配置项（_xx_xx 格式的配置项）以外的所有配置项及其所有属性描述。此外，如果隐藏配置项的值已经被修改为非默认值，则也可以使用 SHOW 语句查看。

通过 GV$OB_PARAMETERS 视图查看集群配置项

与 SHOW 语句不同，通过 GV$OB_PARAMETERS 视图可以查看集群中的所有配置项（含隐藏配置项，即 _xx_xx 格式的配置项）及其所有属性描述。

执行以下命令，查看集群配置项。

bash 复制代码

obclient [xxx]> SHOW PARAMETERS [SHOW_PARAM_OPTS] [TENANT = tenant_name];

其中:

[SHOW_PARAM_OPTS] 可指定为 [LIKE 'pattern' | WHERE expr]，WHERE expr 中可以指定的列属性与 SHOW PARAMETERS 返回结果中的列属性一致。

指定 TENANT 关键字可以查看指定租户的配置项信息。

系统租户或用户租户查询配置项的示例如下。

bash 复制代码

obclient(root@sys)[(none)]> SHOW PARAMETERS LIKE '%syslog_level%';
+-------+----------+--------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone  | svr_type | svr_ip       | svr_port | name         | data_type | value | info                                                                                                                         | section  | scope   | source  | edit_level        | default_value | isdefault |
+-------+----------+--------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone1 | observer | 192.168.6.63 |     2882 | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | WDIAG         |         1 |
+-------+----------+--------------+----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
1 row in set (0.037 sec)

系统租户查询指定租户的配置项的示例如下。

bash 复制代码

SHOW PARAMETERS LIKE '%syslog_level%' TENANT = mysql001;

mysql001为租户名

查询结果中各列的含义如下表所示

列名	含义
zone	所在的 Zone。
svr_type	服务器类型。
svr_ip	服务器 IP。
svr_port	服务器的端口。
name	配置项名。
data_type	配置项的数据类型，包括 STRING、CAPACITY 等。
value	配置项的值。
info	配置项的说明信息。
section	配置项所属的分类： SSTABLE：表示 SSTable 相关的配置项。 OBSERVER：表示 OBServer 相关的配置项。 ROOT_SERVICE：表示 Root Service 相关的配置项。 TENANT：表示租户相关的配置项。 TRANS：表示事务相关的配置项。 LOAD_BALANCE：表示负载均衡相关的配置项。 DAILY_MERGE：表示合并相关的配置项。 CLOG：表示 clog 相关的配置项。 LOCATION_CACHE：表示 Location Cache 相关的配置项。 CACHE：表示缓存相关的配置项。 RPC：表示 RPC 相关的配置项。
scope	配置项范围属性： TENANT：表示该配置项为租户级别的配置项。 CLUSTER：表示该配置项为集群级别的配置项。
source	当前值来源： TENANT CLUSTER CMDLINE OBADMIN FILE、DEFAULT
edit_level	定义该配置项的修改行为： READONLY：表示该参数不可修改。 STATIC_EFFECTIVE：表示该参数可修改但需要重启 OBServer 才会生效。 DYNAMIC_EFFECTIVE：表示该参数可修改且修改后动态生效。
default_value	配置项的默认值。
isdefault	当前值是否为默认值。 0：表示当前值不是默认值。 1：表示当前值是默认值。

3.2.2 通过 GV$OB_PARAMETERS 视图查看集群配置项

系统租户或用户租户登录到集群，进入 oceanbase 数据库执行以下命令，查看集群配置项。

bash 复制代码

SELECT * FROM GV$OB_PARAMETERS WHERE NAME LIKE '%syslog_level%';

bash 复制代码

[admin@centos7 observer]$ obclient -h192.168.6.63 -P2881 -uroot@sys -p -c -A
Enter password: 
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 3221541692
Server version: OceanBase_CE 4.4.1.0 (r100000032025101610-70824e90816ed333c56f3dd1af34ffec43d0fa88) (Built Oct 16 2025 10:13:47)

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient(root@sys)[(none)]> use oceanbase;
Database changed
obclient(root@sys)[oceanbase]> SELECT * FROM GV$OB_PARAMETERS WHERE NAME LIKE '%syslog_level%';
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
| SVR_IP       | SVR_PORT | ZONE  | SCOPE   | TENANT_ID | NAME         | DATA_TYPE | VALUE | INFO                                                                                                                         | SECTION  | EDIT_LEVEL        | DEFAULT_VALUE | ISDEFAULT |
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
| 192.168.6.63 |     2882 | zone1 | CLUSTER |      NULL | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | DYNAMIC_EFFECTIVE | WDIAG         | YES       |
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
1 row in set (0.007 sec)

obclient(root@sys)[oceanbase]>

3.3 修改集群配置项

系统租户（即 sys 租户），可以查看和设置集群级配置项，用户租户只能查看集群级配置项，无法设置集群级配置项。

执行以下命令，修改集群配置项的值。

查看集群配置项的值。

bash 复制代码

obclient(root@sys)[oceanbase]> SELECT * FROM GV$OB_PARAMETERS WHERE NAME LIKE '%syslog_level%';
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
| SVR_IP       | SVR_PORT | ZONE  | SCOPE   | TENANT_ID | NAME         | DATA_TYPE | VALUE | INFO                                                                                                                         | SECTION  | EDIT_LEVEL        | DEFAULT_VALUE | ISDEFAULT |
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
| 192.168.6.63 |     2882 | zone1 | CLUSTER |      NULL | syslog_level | STRING    | WDIAG | specifies the current level of logging. There are DEBUG, TRACE, WDIAG, EDIAG, INFO, WARN, ERROR, seven different log levels. | OBSERVER | DYNAMIC_EFFECTIVE | WDIAG         | YES       |
+--------------+----------+-------+---------+-----------+--------------+-----------+-------+------------------------------------------------------------------------------------------------------------------------------+----------+-------------------+---------------+-----------+
1 row in set (0.007 sec)

修改语句如下：

bash 复制代码

ALTER SYSTEM [SET] parameter_name = expression 
    [SCOPE = {SPFILE | BOTH}]
    [SERVER [=] 'svr_ip:svr_port' | ZONE [=] 'zone' | TENANT [=] {all | all_user | all_meta | tenant_name}];

列名	含义
expression	用于指定修改后该配置项的值。
SCOPE	用于指定本次配置项修改的生效范围，默认值为 BOTH。 SPFILE：表示仅修改配置表中的配置项值，当 OBServer 节点重启以后才生效。 BOTH：表示既修改配置表，又修改内存值，修改后立即生效，且 OBServer 节点重启以后配置值仍然生效。
TENANT	用于系统租户修改所有用户租户、所有 Meta 租户或指定租户的租户级配置项。 all 和 all_user：所有用户租户。 OceanBase 数据库从 V4.2.1 版本开始，TENANT = all_user 与 TENANT = all 语义相同，推荐使用 TENANT = all_user，后续 TENANT = all 将废弃。 all_meta：所有 Meta 租户。 tenant_name：指定租户的租户名。
SERVER 和 ZONE	SERVER 表示指定集群中要修改的 OBServer 服务器。ZONE 表示指定集群中要修改的 Zone。此处指定的 Zone 和 Server 为唯一值，具体值可在第二步查看配置项中获取。 ALTER SYSTEM 语句不能同时指定 Zone 和 Server。如果修改集群级配置项时，不指定 Zone 也不指定 Server，则表示修改在整个集群内生效。

3.4 重置集群配置项

注意事项

系统租户（即 sys 租户）可以查看及重置集群级配置项，用户租户只能查看集群级配置项，无法重置集群级配置项。
系统租户和用户租户均可以查看和重置租户级配置项。
不支持重置指定 Server 以及指定 Zone 上的配置项值。

查看集群配置项的值。

bash 复制代码

obclient(root@sys)[oceanbase]> SHOW PARAMETERS LIKE '%enable_sql_audit%';   
+-------+----------+--------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone  | svr_type | svr_ip       | svr_port | name             | data_type | value | info                                                                                                          | section  | scope   | source  | edit_level        | default_value | isdefault |
+-------+----------+--------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
| zone1 | observer | 192.168.6.63 |     2882 | enable_sql_audit | BOOL      | True  | specifies whether SQL audit is turned on. The default value is TRUE. Value: TRUE: turned on FALSE: turned off | OBSERVER | CLUSTER | DEFAULT | DYNAMIC_EFFECTIVE | true          |         1 |
+-------+----------+--------------+----------+------------------+-----------+-------+---------------------------------------------------------------------------------------------------------------+----------+---------+---------+-------------------+---------------+-----------+
1 row in set (0.036 sec)

修改配置项的值。

语句如下：

bash 复制代码

ALTER SYSTEM RESET
    parameter_name [SCOPE = {SPFILE | BOTH}]
         [TENANT [=] all | all_user | all_meta | tenant_name ];

列名	含义
SCOPE	用于指定重置配置项的生效范围，默认值为 BOTH。其中： SPFILE：表示仅重置配置表中的配置项值，当 OBServer 节点重启以后才生效。 BOTH：表示既重置配置表，又重置内存值，修改后立即生效，且 OBServer 节点重启以后配置值仍然生效。
TENANT	用于系统租户重置所有用户租户、所有 Meta 租户或指定租户的租户级配置项。 all 和 all_user：所有用户租户。说明：OceanBase 数据库从 V4.2.1 版本开始，TENANT = all_user 与 TENANT = all 语义相同，推荐使用 TENANT = all_user，后续 TENANT = all 将废弃。 all_meta：所有 Meta 租户。 tenant_name ：指定租户的租户名。