基于湖库一体架构,统一管理结构化、半结构化与非结构化等多模态数据,一个系统承载事务处理、实时分析与 AI 工作负载。
创建集中式集群
更新时间:2026-08-03 16:09:20
单机是指 OceanBase 数据库部署在单个服务器或计算机上的数据库系统,所有核心组件(如数据库引擎、存储、事务处理等)均运行于同一台物理或虚拟主机上。本文将为您介绍如何创建单机。
说明
OCP 还支持创建其他类型的集群:
背景信息
OceanBase 单机版专为中小规模业务场景设计,高度兼容 MySQL 和 Oracle 协议,可无缝迁移现有应用,原生多租户功能允许多个业务共享同一套单机实例,实现资源隔离按需使用,同时具有出色的单机性能。
前提条件
当前登录 OCP 的用户为 ADMIN 角色或 ORG_ADMIN 角色。
仅支持创建 V4.1.0 及以上版本的单机。
操作步骤
进入创建集群页面
登录 OCP 后,在左侧导航栏单击 集群 ,进入 集群 总览页面。根据实际业务场景,找到新建集群的入口。
如果您没有可管理的集群,系统会在 集群列表 页签中提示您新建集群,直接在提示信息中单击 创建集群 。
如果您已经有可管理的集群,则在 集群列表 页签的右上角,单击 创建集群 。
在 创建集群 页面,选择 集中式 。
配置集群基本信息
创建单机需填写的基本信息如下:
| 参数 | 说明 |
|---|---|
| 集群名称 | 自定义待管理的集群的名称,集群名称必须以英文字母开头、英文或数字结尾,可包含英文、数字和下划线,且长度为 2 ~ 32 个字符。 |
| root@sys 密码 | 支持自定义或随机生成,密码需要满足以下复杂度条件:
|
| OceanBase 版本 | 从列表中选择已有的 OceanBase 集群版本,若列表中缺少所需版本,可以单击列表下方的 添加版本 进行上传。 |
| Zone 名称 | 可保持默认也可自定义,Zone 名称必须以英文字母开头、英文或数字结尾,可包含英文、数字和下划线,且长度为 2 ~ 32 个字符。 |
| 主机 | 选择与 OceanBase 版本 架构一致的主机,仅可选择一台主机作为 OBServer & rootserver。当下拉列表中无可选主机时,可进行 添加主机 的操作。 |
| 负载类型 | 支持为集群选择负载类型。负载类型主要影响 SQL 类查询判断时间(参数:large_query_threshold),对 OLTP 类型负载的 RT 可能存在较大影响,您需谨慎选择。OCP 共支持 5 种集群负载类型,具体说明如下。
|
开启 Cgroup
Cgroup 主要用于 OceanBase 集群内租户之间以及租户内的 CPU 资源隔离,您可根据实际业务类型选择是否为集群开启 Cgroup,以实现更强的 CPU/IOPS 隔离性。
- 开启 Cgroup 会造成大约 7% 的性能下降,若您的业务场景为单租户、小规格(<14C)以及需要更高的数据库性能时,建议您关闭 Cgroup。
- 若主机的操作系统内核版本低于 5.1.0,建议关闭集群 Cgroup,否则可能会引起系统性能下降或不稳定。
- 若主机的操作系统内核版本低于 4.1.9,集群将无法创建租户,此时系统将默认关闭 Cgroup 且不显示 Cgroup 开关。
配置 CPU 超卖额度
当不同业务场景的负载出现交叠,OceanBase 集群在运行过程中可能会产生负载过载等情况,会出现不同租户间进行线程竞争 CPU 的现象,进而导致实际业务场景变慢。为保证系统不同的租户负载可以有控制地交错运行,配置 CPU 资源时可以进行超卖设置来提升资源利用率。
在 CPU 超卖设置 模块,您可通过滑动块或输入框配置超卖比例,默认值为 120%,取值范围为 101%~200%。
说明
CPU 超卖功能依赖 Cgroup,在配置 CPU 超卖额度前,请先为集群开启 Cgroup。
配置 JVM 环境依赖服务
开启 JVM 环境依赖服务,OBServer 可通过 JNI(Java Native Interface)框架对接外表、Java UDF、ODPS 远程访问等功能。
注意
- 仅 OceanBase V4.3.5.1 及其以上版本支持配置 JVM 环境依赖服务。
- 请参考 部署 OceanBase 数据库 JAVA SDK 环境,提前通过 上传软件包 功能上传服务依赖的 JAR 包库,确保 OBServer 可正常加载使用。
- 此服务依赖 Java 环境,若集群下存在机器尚未配置 Java 环境,请自行配置:
- 若主机为 arrch64 架构,需确保 OpenJDK 为 15 及以上版本;
- 若主机为其它架构,需确保 OpenJDK 为 11 及以上版本。
配置服务类型。
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 种服务类型均默认开启,不支持关闭。
配置 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 配置 JAVA_HOME 路径。
开启 JVM 环境依赖服务后,需手动填写 JAVA_HOME 路径,请务必确保集群内全部 OBServer 的 JAVA_HOME 路径完全一致。
配置集群参数
在 参数设置 模块,您可自定义配置集群参数。
单击 添加启动参数,可逐个添加启动参数项,并为其配置参数值。
单击 选择模板自动填充,可在下拉列表中选择一个参数模板,系统会将模板中的参数配置自动填充到此处。
系统提供如下 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 官网 集群配置项总览。配置用户、路径及端口
在 自定义设置 模块,支持您执行集群级别的用户配置(如操作系统属主用户)、路径设置(如软件安装路径、数据盘路径、日志盘路径)以及端口设置(如 SQL 端口、RPC 端口)。
配置操作系统所属主用户:
该用户为配置安装、运行 OBServer 的操作系统用户,不支持编辑。您可通过调整
ocp.operation.default.os.user参数的默认配置来修改此用户,该参数的修改仅在 创建分布式集群、创建单机、创建 AI 集群、创建 OBProxy 集群 和 创建仲裁服务 时产生影响,不影响已有集群的其它配置。配置相关路径:
配置 描述 软件安装路径 - 当 操作系统所属主用户 为 admin 时,软件安装路径 默认为
/home/admin/oceanbase,支持自定义。 - 当 操作系统所属主用户 为非 admin 时,软件安装路径 默认为
/opt/oceanbase/oceanbase,支持自定义。
数据盘路径 默认为 /data/1,支持自定义。日志盘路径 默认为 /data/log1,支持自定义。生产环境下,OceanBase 数据库建议日志盘空间为主机内存空间的三倍以及以上;同时,为了避免出现性能问题,不建议数据目录和日志目录挂载在同一块磁盘上。说明
从 OCP 4.3.0 BP1 开始,当创建的 OceanBase 集群为 [V4.2.4.0, V4.3.0.0)、[V4.3.1.0, +∞) 版本时,slog 目录将置于日志盘中,不再与数据盘绑定。此时若配置log_disk_size=0,会被视为 clog 独占,即默认log_disk_percentage为 90%;当 slog 与 clog 所在磁盘的大小小于 40GiB,为 slog 预留的空间则不足 4GiB,此时可能会影响 slog 的写入。更多 slog 相关说明,请参见 OBServer 节点安装目录结构。- 当 操作系统所属主用户 为 admin 时,软件安装路径 默认为
配置相关端口:
配置 描述 SQL 端口 默认为 2881,支持自定义。 RPC 端口 默认为 2882,支持自定义。 配置完成后,单击 测试,校验所填路径及端口是否可用。
- 若测试通过,单击 新建 。
- 若测试不通过,可根据提示信息进行排查处理。
确认集群信息
在右侧面板中确认所配置的集群信息是否无误,单击 下一步 。
执行创建前预检查
执行创建前的预检查,系统将验证您的环境是否满足创建单机的最低要求。若检查项执行失败,可根据提示进行如下操作:
- 上传:仅特定检查项失败时展示。请根据提示信息,单击 上传 手动上传所需软件包。
- 跳过:此操作将跳过当前检查项(专为特殊场景设计),请务必确保相关检查项已满足产品规范要求,否则可能导致后续流程执行失败。跳过后,该检查项的状态将变更为 警告。
- 重试:根据失败原因和优化建议对问题进行排查修复,修复后单击 重试,重新运行失败的检查项。
- 全部重试:待所有问题均排查修复后,单击 全部重试,重新运行所有失败的检查项。
待不存在执行失败的检查项后,单击 新建。
创建租户
在弹出的 创建租户提醒 对话框中,选择是否需要创建一个普通租户。
若不需要创建租户,可单击 跳过。此时将仅创建集群而不创建租户,后续您可参考 新建租户 自行创建普通租户。
若需要创建租户,则需配置租户模式及租户名。配置完成后单击 创建并提交,您可在 任务中心 中查看相关任务的执行进度。
相关配置信息如下:
配置 描述 租户模式 提供切换租户模式的选择,支持 Oracle 和 MySQL 两种模式,默认为 MySQL。 租户名称 默认与租户模式保持一致,支持自定义。