--- title: "创建分布式集群 - 云平台 OCP V4.5.0 | OceanBase 文档中心" description: 创建分布式集群 分布式集群是 OceanBase 的企业级原生分布式数据库架构，分布式集群具备金融级高可用以及平滑扩缩容能力，高度兼容 Oracle/MySQL 模式，适用于对数据安全要求较高的核心业务系统。 您可以根据业务需要创建待管理的分布式主集群。 说明 OCP 还支持创建其他类型的集群： 创建集中式 ：基于集… image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.5.0 # 创建分布式集群 更新时间：2026-08-03 16:09:20 [编辑](https://github.com/oceanbase/ocp-doc/edit/V4.5.0/zh-CN/600.cluster-functions/200.create-a-cluster/100.create-a-distributed-cluster.md) 分布式集群是 OceanBase 的企业级原生分布式数据库架构，分布式集群具备金融级高可用以及平滑扩缩容能力，高度兼容 Oracle/MySQL 模式，适用于对数据安全要求较高的核心业务系统。 您可以根据业务需要创建待管理的分布式主集群。 #### 说明 OCP 还支持创建其他类型的集群： - [创建集中式](https://www.oceanbase.com/docs/common-ocp-1000000006644352)：基于集中式分布式一体化架构，适用于中小规模业务场景。 - [创建 AI 集群](https://www.oceanbase.com/docs/common-ocp-1000000006644353)：存算分离架构，以对象存储作为数据持久化介质，专为 AI 时代工作负载打造。 #### 功能适用性 OCP 社区版仅支持新建主集群。 ## 背景信息 - 当集群 **部署模式** 为单 Zone 多主机时，仅会扩展 OceanBase 服务的计算能力，不具备多副本高可用能力，适用于开发测试环境。 - 当集群 **部署模式** 为偶数 Zone 时，将无法满足数据高可用的要求，存在数据安全风险。建议您调整配置，保持奇数的可用区配置或者为集群/租户开启仲裁服务。 ## 前提条件 - 当前登录 OCP 的用户为 **ADMIN** 角色或 **ORG_ADMIN** 角色。 - （可选）如您创建的是多副本 OceanBase 集群，则需当前 OCP 中已存在可用的 OBProxy 集群，您可参考如下链接新增 OBProxy 集群。 - [创建 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000006644055) - [接管 OBProxy](https://www.oceanbase.com/docs/common-ocp-1000000006644433) ## 操作步骤 ### 进入创建集群页面 1. 登录 OCP 后，在左侧导航栏单击 **集群** ，进入 **集群** 总览页面。根据实际业务场景，找到新建集群的入口。 1. 如果您没有可管理的集群，系统会在 **集群列表** 页签中提示您新建集群，直接在提示信息中单击 **创建集群** 。 2. 如果您已经有可管理的集群，则在 **集群列表** 页签的右上角，单击 **创建集群** 。 2. 在 **创建集群** 页面，选择 **分布式集群** 模式。 ### 配置集群基本信息 创建分布式集群需填写的基础信息如下： | 配置 | 描述 | | --- | --- | | **集群类型** | 选择 **主集群** 。 | | **集群名称** | 自定义待管理的集群的名称。集群名称必须以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2 ~ 32 个字符。 | | **root@sys 密码** | 支持自定义或随机生成。 密码需要满足以下复杂度条件： - 长度为 8~32 个字符 - 至少包含数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符四种类型中的三种，支持的特殊字符为 `~!@#%^&*_-+=\|(){}[]:;,.?/`。 | | **OceanBase 版本** | 可以从列表中选择已有的 OceanBase 集群版本，也可以在列表下方单击 **添加版本** ，上传一个 OceanBase 的版本。 | | **关联 OBProxy 集群** | 如您创建的是多副本的 OceanBase 集群，建议您打开关联 OBProxy 集群开关，为该 OceanBase 集群关联 OBProxy 集群。 关联后您的业务涉及的 SQL 请求将会被精准转发到相应的副本，使您对 OceanBase 数据库的访问效果能够媲美访问单机数据库。 1. 默认使用 proxyro 用户关联，您无需填写用户名和密码。 2. 在下拉框中选择要关联的 OBProxy 集群。如下拉框中没有可关联的 OBProxy 集群，请参考本文 **前提条件** 中的描述添加 OBProxy 集群。 对于待关联的 OBProxy 集群，有以下限制条件： - 仅可选择与 OceanBase 集群网络一致且非空的 OBProxy 集群。 - 当 OceanBase 集群版本为 V4.0 及以上版本时，仅支持关联 V4.0.0 及以上版本的 OBProxy 集群。 | | **负载类型** | 支持为集群选择负载类型。负载类型主要影响 SQL 类查询判断时间（参数：large_query_threshold），对 OLTP 类型负载的 RT 可能存在较大影响，您需谨慎选择。OCP 共支持 5 种集群负载类型，具体说明如下。 - **Express OLTP**：适用于贸易、支付核心系统、互联网高吞吐量应用程序等工作负载。没有外键等限制，没有存储过程，没有长交易，没有大交易，没有复杂的联接，没有复杂的子查询。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **HTAP**：适用于混合 OLAP 和 OLTP 工作负载。通常用于从活动运营数据、欺诈检测和个性化建议中获取即时见解。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **OLAP**：用于实时数据仓库分析场景。 版本限制：适用于 OceanBase V4.3.0 及以上版本。 - **Complex OLTP**：适用于银行、保险系统等工作负载。它们通常具有复杂的联接、复杂的相关子查询、用 PL 编写的批处理作业，以及长事务和大事务。有时对短时间运行的查询使用并行执行。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **OBKV**：用于键值工作负载和类似 hbase 的宽列工作负载，这些工作负载通常具有非常高的吞吐量并且对延迟敏感。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 | ![Image 175](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/432/%E9%9B%86%E7%BE%A4%E8%B4%9F%E8%BD%BD%E7%B1%BB%E5%9E%8B.png) ### 配置集群的部署模式 默认添加 3 个 Zone 的信息，如果您希望部署的集群 Zone 的个数大于 3 个，您可以在下方单击 **新增 Zone** 按钮，增加 Zone 信息。如果部署的集群 Zone 的个数小于 3 个，您可以单击 Zone 后面的删除图标。 ![10](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E9%83%A8%E7%BD%B2%E6%A8%A1%E5%BC%8F1.png) 每个 Zone 需要设置的信息及其说明如下表所示。 | 配置 | 描述 | | --- | --- | | **Zone 名称** | 可保持默认也可自定义。 Zone 名称必须以英文字母开头，支持大小写字母、数字和下划线，长度为 2~32。 部署多 Zone 的 OceanBase 集群必须有一个 Zone 与主 Zone 的 Region 相同。 | | **机房** | Zone 所在的机房，一个 Zone 只能存在于一个机房。 | | **机型** | 可选项。如果选择了机型，后面主机列表会根据机型进行过滤。 | | **CPU 架构** | 当选择的 **OceanBase 版本** 中存在多个不同架构的安装包时，需选择匹配此软件包的主机硬件架构。 > **注意** > > > - 默认架构类型为第一个安装包的架构类型，支持切换。切换指定架构后，**主机** 列表中即展示该架构的主机。 > - 若为不同的 Zone 设置不同的架构时，混合架构部署模式可能存在稳定性与性能问题，请谨慎操作。 | | **主机** | 您可以选择多个主机，或进行添加主机的操作。 | | **Root Service 位置** | 您需选择一个 IP 作为 Root Service 所在的机器。多副本的 OceanBase 集群，其每个 Zone 都需指定一个 root Service。 | | **Zone 优先级排序** | 选择是否为集群 sys 租户的主副本分布指定优先级。 - 如指定，最高优先级的 Zone 会被视为 Primary Zone，且只能有一个。 排序方法如下： 1. 勾选左侧列表框中的一个或多个 Zone。 左侧列表框中显示了当前集群中所有可选的 Zone。 2. 单击中间的 > 按钮。 此时勾选的 Zone 就会被移动到 **Zone 优先级排序** 列表中。同时勾选的多个 Zone 具有相同的优先级。 3. 重复 a、b 动作，添加低一优先级的 Zone。 4. 如需调整优先级，可在 **Zone 优先级排序** 列表中拖拽以调整顺序。 列表中从上到下，优先级依次递减。 - 如不指定，则默认 primary_zone=RANDOM（随机分布）。 | | **添加仲裁服务** | 选择是否为集群添加仲裁服务。您可在服务下拉列表中选择需要添加的服务，或单击 **新建服务** 为集群新创建仲裁服务，详情参见 [添加仲裁服务](https://www.oceanbase.com/docs/common-ocp-1000000006645093)。 > **说明** > 仅支持为 V4.1.0 及以上版本的主集群添加仲裁服务。 | ### 配置 Cgroup Cgroup 主要用于 OceanBase 集群内租户之间以及租户内的 CPU 资源隔离，您可根据实际业务类型选择是否为集群开启 Cgroup，以实现更强的 CPU/IOPS 隔离性。当您创建的 OceanBase 集群为 V4.0 及以上版本时，系统会默认开启 Cgroup。 - 开启 Cgroup 会造成大约 7% 的性能下降，若您的业务场景为单租户、小规格（<14C）以及需要更高的数据库性能时，建议您关闭 Cgroup。 - 若主机的操作系统内核版本低于 5.1.0，建议关闭集群 Cgroup，否则可能会引起系统性能下降或不稳定。 - 若主机的操作系统内核版本低于 4.1.9，集群将无法创建租户，此时系统将默认关闭 Cgroup 且不显示 Cgroup 开关。 ### 配置 CPU 超卖额度 当不同业务场景的负载出现交叠，OceanBase 集群在运行过程中可能会产生负载过载等情况，会出现不同租户间进行线程竞争 CPU 的现象，进而导致实际业务场景变慢。为保证系统不同的租户负载可以有控制地交错运行，配置 CPU 资源时可以进行超卖设置来提升资源利用率。 #### 说明 - 仅 OceanBase V4.0 及其以上版本支持对 CPU 进行超卖分配，在合理配置下，您可以充分地利用硬件资源。 - CPU 超卖功能依赖 Cgroup，在配置 CPU 超卖额度前，请先为集群开启 Cgroup。 在 **CPU 超卖设置** 模块，您可通过滑动块或输入框配置超卖比例，默认值为 120%，取值范围为 101%~200%。 ### 配置 JVM 环境依赖服务 开启 **JVM 环境依赖服务**，OBServer 可通过 JNI（Java Native Interface）框架对接外表、Java UDF、ODPS 远程访问等功能。 #### 注意 - 仅 OceanBase V4.3.5.1 及其以上版本支持配置 JVM 环境依赖服务。 - 请参考 [部署 OceanBase 数据库 JAVA SDK 环境](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000003976539)，提前通过 [上传软件包](https://www.oceanbase.com/docs/common-ocp-1000000006643991) 功能上传服务依赖的 JAR 包库，确保 OBServer 可正常加载使用。 - 此服务依赖 Java 环境，若集群下存在机器尚未配置 Java 环境，请自行配置： - 若主机为 arrch64 架构，需确保 OpenJDK 为 15 及以上版本； - 若主机为其它架构，需确保 OpenJDK 为 11 及以上版本。 1. 配置服务类型。 OCP 支持 ODPS 外表、HDFS 外表、Java UDF、ODPS Catalog 和 MySQL 外表插件 5 种服务，不同服务对 OceanBase 集群版本的要求有所不同，详情可参考下表。 | 服务类型 | OceanBase 版本要求 | | --- | --- | | ODPS 外表 | [V4.3.5.1, +∞) | | HDFS 外表 | [V4.3.5.1, +∞) | | Java UDF | [V4.3.5.1, +∞) | | ODPS Catalog | [V4.4.0, +∞) | | MySQL 外表插件 | [V4.4.1, +∞) | #### 说明 配置服务类型时，ODPS 外表、HDFS 外表、Java UDF、ODPS Catalog 4 种服务类型均默认开启，不支持关闭。 2. 配置 JVM 内存。 合理的 JVM 内存配置对 Java 应用的稳定性和性能具有直接影响，您可通过对 JVM 内存进行设置，确保 Java 应用程序在 OceanBase 集群中的基本运行需要。根据 OBServer 节点的不同内存规格，提供预定义的 JVM 内存配置选项如下： | OBServer 内存节点 | -Xmx/-Xms | -Dio.netty.maxDirectMemory | JVM 内存总计 | | --- | --- | --- | --- | | 16 GiB | 512 MiB | 512 MiB | 1 GiB | | 32 GiB | 1 GiB | 1 GiB | 2 GiB | | 70 GiB | 3 GiB | 3 GiB | 6 GiB | 3. 配置 JAVA_HOME 路径。 开启 JVM 环境依赖服务后，需手动填写 JAVA_HOME 路径，请务必确保集群内全部 OBServer 的 JAVA_HOME 路径完全一致。 ### 配置集群参数 打开 **参数设置** 模块，您可自定义配置集群参数。 - 当您在 **基本设置** 中配置了负载类型时，系统将默认选择与负载类型对应的参数模板。 - 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。 - 也可通过如图 ② 处，单击 **选择参数模板** ，然后选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。在未创建集群参数模板的情况下，您可单击 **新建集群模板**，为集群创建参数模板，详情可参考 [管理集群参数模板](https://www.oceanbase.com/docs/common-ocp-1000000006644032)。 ![09161737](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/430/%E5%8F%82%E6%95%B0%E6%A8%A1%E6%9D%BF.png) 系统提供如下 6 种内置模板，模板中包含了常用的参数设置，您可直接应用该模板进行集群的初始化设置。关于系统内置模板，具体说明如下。 | 模板 | 说明 | | --- | --- | | COMPLEX_OLTP 默认参数模板 | 对应 **Complex OLTP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | HTAP 默认参数模板 | 对应 **HTAP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | KV 默认参数模板 | 对应 **OBKV** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | EXPRESS_OLAP 默认参数模板 | 对应 **Express OLAP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | OLAP 默认参数模板 | 对应 **OLAP** 负载类型，该模板仅适用于 OceanBase V4.3.0 及以上版本。 | | 2.2.77 默认参数模板 | OceanBase 集群 V2.2.77 版本推荐使用的参数设置，供生产环境使用。 | #### 说明 如您对集群级别的 CPU、内存、数据盘以及日志盘的使用有定制化变更诉求，请设置参数：`cpu_count`、 `memory_limit_percentage`、`system_memory`、 `data_disk_usage_limit_percentage`、`datafile_size`、`clog_disk_usage_limit_percentage`、`log_disk_size`，具体参数说明请参考 OceanBase 官网 [集群配置项总览](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000640281)。 ### 配置用户、路径及端口 在 **自定义设置** 模块，支持您执行集群级别用户配置（如操作系统属主用户）、路径设置（如软件安装路径、数据盘路径、日志盘路径）以及端口设置（如 SQL 端口、RPC 端口）。 1. 配置操作系统所属主用户： 该用户为配置安装、运行 OBServer 的操作系统用户，不支持编辑。您可通过调整 `ocp.operation.default.os.user` 参数的默认配置来修改此用户，该参数的修改仅在创建分布式集群、[创建单机](https://www.oceanbase.com/docs/common-ocp-1000000006644352)、[创建 AI 集群](https://www.oceanbase.com/docs/common-ocp-1000000006644353)、[创建 OBProxy 集群](https://www.oceanbase.com/docs/common-ocp-1000000006644055) 和 [创建仲裁服务](https://www.oceanbase.com/docs/common-ocp-1000000006644397) 时产生影响，不影响已有集群的其他配置。 2. 配置相关路径： | 配置 | 描述 | | --- | --- | | **软件安装路径** | - 当 **操作系统所属主用户** 为 admin 时，**软件安装路径** 默认为 `/home/admin/oceanbase`，支持自定义。 - 当 **操作系统所属主用户** 为非 admin 时，**软件安装路径** 默认为 `/opt/oceanbase/oceanbase`，支持自定义。 | | **数据盘路径** | 默认为 `/data/1`，支持自定义。 | | **日志盘路径** | 默认为 `/data/log1`，支持自定义路径。生产环境下，OceanBase 数据库建议日志盘空间为主机内存空间的三倍以及以上；同时，为了避免出现磁盘占用采集问题，建议将数据目录、安装目录和日志目录挂载在不同磁盘。 #### 说明 从 OCP 4.3.0 BP1 开始，当创建如下版本的 OceanBase 集群时，slog 目录将置于日志盘中，不再与数据盘绑定。此时若配置 `log_disk_size=0`，会被视为 clog 独占，即默认 `log_disk_percentage` 为 90%。如果 slog 与 clog 所在磁盘的大小小于 40GiB，此时为 slog 预留的空间则不足 4GiB，可能会影响 slog 的写入。 - V4.2.4.0 ≤ OceanBase < V4.3.0.0 - OceanBase ≥ V4.3.1.0更多 slog 相关说明，请参见 [OBServer 节点安装目录结构](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000819002)。 | 3. 配置端口： | 配置 | 描述 | | --- | --- | | **SQL 端口** | 默认为 2881，支持自定义。 | | **RPC 端口** | 默认为 2882，支持自定义。 | 4. 配置完成后，单击 **测试**，校验所填路径及端口是否可用。 - 若测试通过，单击 **新建** 。 - 若测试不通过，可根据提示信息进行排查处理。 ### 确认配置信息 1. 在右侧面板中确认所配置的集群信息是否无误，单击 **下一步** 。 2. 执行创建前的预检查，系统将验证您的环境是否满足创建分布式主集群的最低要求。若检查项执行失败，可根据提示进行如下操作： - **上传**：仅特定检查项失败时展示。请根据提示信息，单击 **上传** 手动上传所需软件包。 - **跳过**：此操作将跳过当前检查项（专为特殊场景设计），请务必确保相关检查项已满足产品规范要求，否则可能导致后续流程执行失败。跳过后，该检查项的状态将变更为 **警告**。 - **重试**：根据失败原因和优化建议对问题进行排查修复，修复后单击 **重试**，重新运行失败的检查项。 - **全部重试**：待所有问题均排查修复后，单击 **全部重试**，重新运行所有失败的检查项。 3. 待不存在执行失败的检查项后，单击 **新建**。 提交新建集群任务后，您可在 **任务中心** 中查看该任务的执行进度。 上一篇 下一篇 ![有帮助](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) 咨询热线