首批通过分布式安全可靠测评，为关键业务系统打造
创建单机
更新时间：2026-01-31 17:04:25
编辑
分享
单机是指 OceanBase 数据库部署在单个服务器或计算机上的数据库系统，所有核心组件（如数据库引擎、存储、事务处理等）均运行于同一台物理或虚拟主机上。本文将为您介绍如何创建单机。
背景信息
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。
步骤五：配置集群参数
在 参数设置 模块，您可自定义配置集群参数。
单击 添加启动参数，可逐个添加启动参数项，并为其配置参数值。
单击 选择模板自动填充，可在下拉列表中选择一个参数模板，系统会将模板中的参数配置自动填充到此处。
系统提供如下 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参数的默认配置来修改此用户，该参数的修改仅在 创建分布式集群、创建单机、创建 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。 租户名称 默认与租户模式保持一致，支持自定义。
