--- title: "新建租户 | OceanBase 文档中心" description: 新建租户 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建租户。 新建租户有以下两种方式： 在租户概览页面创建租户。 在指定集群的租户管理页面创建租户。 本文档为您展示指定集群的租户管理页面创建租户的操作步骤。 前提条件 需要创建租户的集群… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 3.3.3 企业版 # 新建租户 更新时间：2023-08-15 19:21:26 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建租户。 新建租户有以下两种方式： - 在租户概览页面创建租户。 - 在指定集群的租户管理页面创建租户。 本文档为您展示指定集群的租户管理页面创建租户的操作步骤。 ## 前提条件 - 需要创建租户的集群为主集群，且状态为运行中。 - 当前登录用户具备系统管理员角色、OCP 租户管理员角色或其他拥有管理该集群权限的角色。 - （可选）已参考 [租户参数模板管理](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000001464562) 创建好参数模板。 需要创建多个参数配置相同的租户时，可提前建好参数模板，这样可避免重复配置相同的一批参数。 ## 操作步骤 1. 登录 OCP。 2. 单击左侧导航栏的 **集群** 。 3. 在 **集群列表** 区域选择待操作的集群并单击其集群名。 4. 在显示的页面的左侧导航栏上，单击 **租户管理** 。 5. 在页面右上角单击 **新建租户** 。 ![16310527](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2840112261/p278265.png) 6. 填写 **基础信息** 。需要完成的基本设置及其相关说明如下表所示。 | **配置** | **描述** | | --- | --- | | **集群** | 租户所属集群，默认为当前集群。 | | **租户模式** | 当前支持 MySQL 和 Oracle 两种租户模式。 需要注意的是，当所选集群的 OceanBase 版本在 V2.1 及以上时才支持 Oracle 租户模式。 | | **租户名** | 租户名称支持英文大小写字母、数字和下划线，长度为 2~64 字符。 | | **管理员初始密码** | 租户管理员账号的密码，支持随机生成。 - 对于 MySQL 模式，其管理员账号为 root。 - 对于 Oracle 模式，其管理员账号为 SYS。 密码格式要求如下： - 长度为 8~32 个字符 - 支持字母、数字和特殊字符，且至少包含大、小写字母、数字和特殊字符各 2 个 - 支持的特殊字符为 ~!@#%^&*_-+=`\|(){}[]:;',.?/ | | **字符集与编码** | - 对于 MySQL 模式，可选字符集有 utf8mb4、binary、gbk 和 gb18030；默认为 utf8mb4。 - 对于 Oracle 模式，可选字符集有utf8mb4、gbk 和 gb18030，默认为 utf8mb4。 | | **Collation** | 与字符集对应的详细排序规则。 | | **备注** | 可选，备注说明信息。 | ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%9F%BA%E7%A1%80%E4%BF%A1%E6%81%AF.png) 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. 对 IP 地址白名单进行配置。 IP 地址白名单用于指定该租户允许登录的客户端列表，可选择默认配置或自定义。 - 若选择默认配置，表示允许所有客户端链接。 - 若选择自定义白名单列表，白名单格式说明如下： - 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。 - 特殊说明：% 表示所有客户端均可连接。 #### 注意 OCP 机器地址以及所依赖的 OBProxy 地址必须在此名单中，否则 OCP 将无法管理此租户。 ![Image 173](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E5%AE%89%E5%85%A8%E8%AE%BE%E7%BD%AE.png) 9. 打开 **参数配置** 模块，并配置租户参数。 - 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。 - 也可通过如图 ② 处，将鼠标悬停于 **选择参数模板** 字样上，然后选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。 如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。 ![1201](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2107238361/p361159.png) 10. 单击 **提交** 。 您可通过弹出框中的 **查看任务** 按钮，查看新建租户任务的执行进度。 当任务状态为 **完成** ，且集群 **租户管理** 页的 **租户列表** 中该新建租户的状态为 **运行中** 时，表示租户新建成功。 上一篇 下一篇 ![有帮助](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) 咨询热线