---
title: "BOOTSTRAP | OceanBase 文档中心"
description: BOOTSTRAP 描述 该语句用于自举 OceanBase 集群。 该命令仅需要在 OceanBase 数据库初次启动时执行，每个集群仅能执行一次该命令。如果该命令执行失败，不能重新运行该命令，需要重新搭建 OceanBase 数据库集群。 在执行该命令前，请确保指定的各 OBServer 都已正常启动。 语法 a…
---
切换语言

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

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

# BOOTSTRAP

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

## 描述

该语句用于自举 OceanBase 集群。

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

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

## 语法

```javascript
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 机器列表进行进行系统自举。

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

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

  ```javascript
  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 拆分成多个语句执行。
 - 备集群进行系统自举。

  ```javascript
  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';

  ```

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