BOOTSTRAP | OceanBase 文档中心

BOOTSTRAP

更新时间：2026-06-07 17:05:05

描述

该语句用于自举 OceanBase 集群。

该命令仅需要在 OceanBase 数据库初次启动时执行，每个集群仅能执行一次该命令。如果该命令执行失败，不能重新运行该命令，需要重新搭建 OceanBase 数据库集群。

在执行该命令前，请确保指定的各 OBServer 都已正常启动。

语法

alter_system_bootstrap_stmt_primary:
    ALTER SYSTEM BOOTSTRAP [CLUSTER PRIMARY] region_zone_server_list;

alter_system_bootstrap_stmt_standby: 
    ALTER SYSTEM BOOTSTRAP CLUSTER STANDBY region_zone_server_list primary_cluster_id primary_rootservice_list;
 
region_zone_server_list:
    region_zone_server [, region_zone_server ...]

primary_cluster_id:
    PRIMARY_CLUSTER_ID [=] cluster_id 

primary_rootservice_list:
    PRIMARY_ROOTSERVICE_LIST server_list;

region_zone_server:
    [region] zone server

region:
    REGION [=] region_name

zone:
    ZONE [=] zone_name

server:
    SERVER [=] ip_port

ip_port:
    'STR_VALUE:INT_VALUE'

参数解释

参数	描述
PRIMARY \| STANDBY	指定主备库。系统启动时需要指定主备库，如果不指定，默认采用主集群启动。
primary_cluster_id	备集群自举时，需要指定主集群的 `cluster_id`。
primary_rootservice_list	备集群自举时，需要指定主集群的 RootService List。
region	指定 RootService 所在的地域，通过在"多地多中心"部署时指定。
zone	指定 RootService 所属的 Zone。
ip	指定 RootService 的 IP 地址。
port	指定 RootService 的 RPC 端口号。

示例

指定 RootService 机器列表进行进行系统自举。

obclient> ALTER SYSTEM BOOTSTRAP ZONE 'xxxx1' SERVER 'xxx.xxx.xx.xx1:xxxx';

RootService 机器列表包含多台 OBServer 时，需要以逗号（,）分隔。

obclient> ALTER SYSTEM BOOTSTRAP ZONE 'xxxx1' SERVER 'xxx.xxx.xx.xx1:xxxx', ZONE 'xxxx2' SERVER 'xxx.xxx.xx.xx2:xxxx', ZONE 'xxxx3' SERVER 'xxx.xxx.xx.xx3:xxxx';

注意

不能将上述 SQL 拆分成多个语句执行。

备集群进行系统自举。

obclient> ALTER SYSTEM BOOTSTRAP CLUSTER STANDBY ZONE 'xxxx1' SERVER 'xxx.xxx.xx.xx4:2882' PRIMARY_CLUSTER_ID 1 PRIMARY_ROOTSERVICE_LIST 'xxx.xxx.xx.xx1:2882';