新建租户 | OceanBase 文档中心

新建租户

更新时间：2026-04-14 15:15:53

租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建租户。

新建租户有以下两种方式：

本文档为您展示指定集群的租户管理页面创建租户的操作步骤。

前提条件

填写 基础信息 。需要完成的基本设置及其相关说明如下表所示。

配置	描述
集群	租户所属集群，默认为当前集群。说明当您通过租户概览页面创建租户时，需为租户选择所属集群。
租户模式	当前支持 MySQL 租户模式。
租户名	租户名称支持英文大小写字母、数字和下划线，长度为 2~64 字符。
管理员初始密码	租户管理员账号的密码，支持随机生成。对于 MySQL 模式，其管理员账号为 root。密码格式要求如下：长度为 8~32 个字符支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个支持的特殊字符为 ~!@#%^&*_-+=`\|(){}[]:;',.?/
字符集与编码	对于 MySQL 模式，可选字符集有 utf8mb4、binary、gbk 和 gb18030；默认为 utf8mb4。
Collation	与字符集对应的详细排序规则。
备注	可选，备注说明信息。

填写 副本设置 。

默认系统会根据所选集群的 Zone 信息显示可配置的 Zone 列表，对于无需做副本分布的 Zone，可以单击后面的删除按钮删除该 Zone 条目。需要配置的 Zone 信息及其相关说明如下表所示。

配置	描述
副本类型	有以下选项：全能型副本只读型副本日志型副本请选择多个全功能副本类型，确保全功能副本类型占多数派。
Unit 规格	OCP 内置了一套 Unit 规格，请参考 OCP 资源单元规格列表进行选择，或者您也可以在列表下方单击新增规格按钮新增自定义规格。
Unit 数量	指定该 Zone下的 Unit 数量。Unit 数量不能超过该 Zone下 Server 个数。
Zone 优先级排序	Zone的优先级排序。该优先级顺序影响 sys 租户的 Primary Zone 的优先级顺序。左边的列表框中显示了当前集群的所有 Zone。您可以在左侧列表框中选择一个或多个 Zone 添加到右侧的列表框中，默认先选择的 Zone 的优先级高于后选择的 Zone，一次选中的多个 Zone 的优先级相同。移动到右侧的列表框中后，您也可以在右侧的列表框中通过拖拽调整顺序，列表框上方的 Zone 的优先级高于下方的 Zone。

此方式存在访问安全风险，请谨慎操作。

自定义：用于指定该租户允许登录的客户端列表。如果不指定，则默认配置为 % ，表示允许所有客户端链接。自定义白名单列表时需要注意，OCP 机器地址以及所依赖的 OBProxy 地址必须在此名单中，否则 OCP 将无法管理此租户。白名单格式说明如下：
- IP地址示例：xxx.xxx.xxx.1，xxx.xxx.xxx.2。
- 子网/掩码示例：xxx.xxx.xxx.0/24。
- 模糊匹配示例：xxx.xxx.xxx.% 或 xxx.xxx.xxx._。
- 多种格式混合示例：xxx.xxx.xxx.1，xxx.xxx.xxx.2，xxx.xxx.xxx.%，xxx.xxx.xxx._，xxx.xxx.xxx.0/24。

OCP 机器地址以及所依赖的 OBProxy 地址必须在此名单中，否则 OCP 将无法管理此租户。

打开 参数配置 模块，并配置租户参数。
- 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。
- 也可通过如图 ② 处，将鼠标悬停于 选择参数模板 字样上，然后选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。
  
  如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。
单击提交。页面会提示 新建租户任务提交成功，您可在该页面查看任务的简要信息。
- 若您想查看任务详情，可单击 查看任务详情 按钮，查看新建租户任务的详细执行进度。
- 您也可单击 返回租户列表 按钮，返回租户列表页面。在租户列表页面，您可查看新建租户的创建状态和任务详情，并支持对创建失败的租户进行删除。

当任务状态为完成，且集群 租户管理 页的 租户列表 中该新建租户的状态为 运行中 时，表示租户新建成功。