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

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

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

# 新建租户

更新时间：2023-08-15 19:21:43

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

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

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

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

## 前提条件

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

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

## 操作步骤

1. 登录 OCP。
 2. 单击左侧导航栏的 **集群** 。
 3. 在 **集群列表** 区域选择待操作的集群并单击其集群名。
 4. 在显示的页面的左侧导航栏上，单击 **租户管理** 。
 5. 在页面右上角单击 **新建租户** 。 ![16310527](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2840112261/p278265.png) ![10140956](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/1657914361/p338584.png)
 6. 填写 **基础信息** 。

      1. 集群默认为当前集群。
      2. 请输入 **租户名称** 。租户名称支持英文大小写字母、数字和下划线，长度为 2~64 字符。
 7. 填写 **Zone 信息** 。

   默认系统会根据所选集群的 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。 |
 8. 填写 **基本设置** 。需要完成的基本设置及其相关说明如下表所示。

   | **配置** | **描述** |
   | --- | --- |
   | **管理员初始密码** | 租户管理员账号的密码，支持随机生成。 对于 MySQL 模式，其管理员账号为 root。 对于 Oracle 模式，其管理员账号为 SYS。 密码格式要求如下：长度为 8~32 个字符，支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个，支持的特殊字符为 ~!@#%^&*_-+=`\|(){}[]:;',.?/ |
   | **租户模式** | 当前支持 MySQL 和 Oracle 两种租户模式。 需要注意的是，当所选集群的 OB 版本在 2.1 及以上时才支持 Oracle 租户模式。 社区版 OCP 仅支持 MySQL 模式，如需支持 Oracle 模式，建议联系官方人员获取企业版 OCP。 |
   | **字符集与编码** | 对于 MySQL 模式，可选字符集有utf8mb4、binary、gbk 和 gb18030；默认为 utf8mb4。 对于 Oracle 模式，可选字符集有utf8mb4、gbk 和 gb18030，默认为 utf8mb4。 |
   | **备注** | 可选，备注说明信息。 |
   | **IP 地址白名单** | 用于指定该租户允许登录的客户端列表。如果不指定，则默认配置为 **%** ，表示允许所有客户端链接。 自定义白名单列表时需要注意，OCP 机器地址以及所依赖的 OBProxy 地址必须在此名单中，否则 OCP 将无法管理此租户。 白名单格式说明如下： * IP地址示例：10.10.10.10，10.10.10.11。 * 子网/掩码示例：10.10.10.0/24。 * 模糊匹配示例：10.10.10.% 或 10.10.10.*。 * 多种格式混合示例：10.10.10.10，10.10.10.11，10.10.10.%，10.10.10.*，10.10.10.0/24。 |
 9. 打开 **参数配置** 模块，并配置租户参数。

- 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。
 - 也可通过如图 ② 处，将鼠标悬停于 **选择参数模板** 字样上，然后选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。

  如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。

  ![1201](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2107238361/p361159.png)

11. 单击 **提交** 。

    您可通过弹出框中的 **查看任务** 按钮，查看新建租户任务的执行进度。

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

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