---
title: 编组
description: 新建租户 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建租户。 新建租户有以下两种方式： 在租户概览页面创建租户。 在指定集群的租户管理页面创建租户。 本文档为您展示在租户概览页面创建租户的操作步骤。 前提条件 需要创建租户的集群为主集群…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.0.3 企业版

# 新建租户

更新时间：2023-08-16 15:51:32

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

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

- 在租户概览页面创建租户。
 - 在指定集群的租户管理页面创建租户。

本文档为您展示在租户概览页面创建租户的操作步骤。

## 前提条件

- 需要创建租户的集群为主集群，且状态为运行中。
 - 当前登录用户具备系统管理员角色、OCP 租户管理员角色或其他拥有管理该集群权限的角色。
 - （可选）已参考 [租户参数模板管理](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001542145) 创建好参数模板。

  需要创建多个参数配置相同的租户时，可提前建好参数模板，这样可避免重复配置相同的一批参数。

## 操作步骤

1. 登录 OCP。
 2. 单击左侧导航栏的 **租户** 。
 3. 在租户概览页面的左侧导航栏上，单击 **新建租户** 。

   ![10140956](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E6%96%B0%E5%BB%BA%E7%A7%9F%E6%88%B7%E6%9B%B4%E6%96%B01.png)
 4. 填写 **基本信息** 。

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

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

   ![10](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E6%96%B0%E5%BB%BA%E7%A7%9F%E6%88%B7%E5%9F%BA%E6%9C%AC%E8%AE%BE%E7%BD%AE1.png)
 5. 填写 **副本设置** 。

      - 当所选集群为 V4.0 及以上版本时，不支持按 Zone 级别单独设置 Unit 数量，所有 Zone 的 Unit 数量需保持一致（默认为 1）。

       ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%89%AF%E6%9C%AC%E8%AE%BE%E7%BD%AE3.png)
      - 当所选集群版本为 V4.0 以下时，多个 Zone 可以设置不同的 Unit 数量。

       ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%89%AF%E6%9C%AC%E8%AE%BE%E7%BD%AE4.png)

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

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

      - 所有 IP 都可访问：所有的 IP 都可访问该租户。

#### 注意

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

- 自定义：指定允许登陆的客户端列表，支持的格式有 IP 地址、子网/掩码、模糊匹配、多种格式混合和特殊说明。示例如下：

  | 格式 | 示例 |
  | --- | --- |
  | IP 地址 | xxx.xxx.xxx.1,xxx.xxx.xxx.2 |
  | 子网/掩码 | xxx.xxx.xxx.1/24 |
  | 模糊匹配 | xxx.xxx.xxx.% 或 xxx.xxx.xxx._ |
  | 多种格式混合 | xxx.xxx.xxx.1,xxx.xxx.xxx.2,xxx.xxx.xxx.%,xxx.xxx.xxx._,xxx.xxx.xxx.1/24 |
  | 特殊说明 | % 表示所有客户端都可以连接 |

#### 注意

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

![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E5%AE%89%E5%85%A8%E8%AE%BE%E7%BD%AE1.png)

7. 打开 **参数设置** 模块，并配置租户参数。

      - 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。
      - 也可通过如图 ② 处，单击 **选择参数模板**，选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。

#### 说明

- 如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。
 - 在未创建租户参数模板的情况下，您可单击 **新建租户参数模板**，为租户创建参数模板，详情可参考 [租户参数模板管理](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001542145)。

```
   ![1201](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/401/%E7%A7%9F%E6%88%B7%E5%8F%82%E6%95%B0%E6%A8%A1%E6%9D%BF1.png)

```

8. 单击 **提交** 。 页面会提示 **新建租户任务提交成功**，您可在该页面查看任务的简要信息。

      - 若您想查看任务详情，可单击 **查看任务详情** 按钮，查看新建租户任务的详细执行进度。
      - 您也可单击 **返回租户列表** 按钮，返回租户列表页面。在租户列表页面，您可查看新建租户的创建状态和任务详情，并支持对创建失败的租户进行删除。

       ![1201](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%88%9B%E5%BB%BA%E7%A7%9F%E6%88%B7%E4%BB%BB%E5%8A%A1%E6%8F%90%E4%BA%A4%E6%88%90%E5%8A%9F.png)

#### 说明

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

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