---
title: "集群扩容 - OceanBase 数据库 V4.3.0 | OceanBase 文档中心"
description: 集群扩容 本文介绍如何通过 obshell-sdk-python 对集群进行扩容。 说明 建议先查看 obshell-sdk-python 快速上手 内容，了解如何使用 obshell-sdk-python。 注意事项 对集群进行扩容前，需注意以下要求： 请求的 client 对应的节点需在待扩容的集群中。 obsh…
---
切换语言

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

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

# 集群扩容

更新时间：2026-04-10 11:58:35

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.0/zh-CN/700.reference/1500.Components-and-Tools/100.manage/100.obshell/500.obshell-sdk-reference/100.python/1400.scale-out-of-python.md)  

本文介绍如何通过 obshell-sdk-python 对集群进行扩容。

#### 说明

建议先查看 [obshell-sdk-python 快速上手](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000904110) 内容，了解如何使用 obshell-sdk-python。

## 注意事项

对集群进行扩容前，需注意以下要求：

- 请求的 client 对应的节点需在待扩容的集群中。
 - obshell 需正常运行。
 - 待添加到集群中的扩容节点从未加入过任何集群。

## 示例代码

    任务同步执行   任务异步执行

```python
from obshell import ClientSet
from obshell.auth import PasswordAuth

# 创建 client 实例，节点地址为 '10.10.10.1'，端口为 2886。
# 所在集群的 root@sys 密码为 '****'。
client = ClientSet("10.10.10.1", 2886, PasswordAuth("****"))

configs = {
    "datafile_size": "24G", "log_disk_size": "24G",
    "cpu_count": "16", "memory_limit": "16G", "system_memory": "8G",
    "enable_syslog_recycle": "true", "enable_syslog_wf": "true"}
# 向集群添加节点 '10.10.10.4:2886'，OBServer 节点位于 zone3，配置为 configs。
client.v1.scale_out_sync("10.10.10.4", 2886, "zone3", configs)

```

# 创建 client 实例，节点地址为 '10.10.10.1'，端口为 2886。
# 所在集群的 root@sys 密码为 '****'。
client = ClientSet("10.10.10.1", 2886, PasswordAuth("****"))

configs = {
    "datafile_size": "24G", "log_disk_size": "24G",
    "cpu_count": "16", "memory_limit": "16G", "system_memory": "8G",
    "enable_syslog_recycle": "true", "enable_syslog_wf": "true"}
# 向集群添加节点 '10.10.10.4:2886'，OBServer 节点位于 zone3，配置为 configs。
dag = client.v1.scale_out("10.10.10.4", 2886, "zone3", configs)
# 等待任务完成。
client.v1.wait_dag_succeed(dag.generic_id)

```

## 相关文档

- 集群扩容的 API 接口说明可参见 [集群扩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000694615)。
 - 通过 obshell-sdk-go 请求 API 方法的介绍可参见 [集群扩容](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000904142)。

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