--- title: "新建主租户 - 云平台 OCP V4.3.0 | OceanBase 文档中心" description: 新建主租户 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建主租户。 新建主租户有以下两种方式： 在租户总览页面创建主租户。 在指定集群的租户管理页面创建主租户。 本文档为您展示在租户总览页面创建主租户的操作步骤。 前提条件 需要创建租户的… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.3.0 # 新建主租户 更新时间：2026-04-14 11:55:54 [编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.0/zh-CN/700.tenant-functions/300.create-a-tenant.md) 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建主租户。 新建主租户有以下两种方式： - 在租户总览页面创建主租户。 - 在指定集群的租户管理页面创建主租户。 本文档为您展示在租户总览页面创建主租户的操作步骤。 ## 前提条件 - 需要创建租户的集群为主集群，且状态为运行中。 - 当前登录用户具备系统管理员角色、OCP 租户管理员角色或其他拥有管理该集群权限的角色。 - （可选）已参考 [租户参数模板管理](https://www.oceanbase.com/docs/common-ocp-1000000000826464) 创建好参数模板。 需要创建多个参数配置相同的租户时，可提前建好参数模板，这样可避免重复配置相同的一批参数。 - 在选择为租户开启仲裁服务前，您需要确认以下信息： - 租户所属集群已添加仲裁服务且仲裁服务处于 **RUNNING** 状态。 - 待开启仲裁服务的租户的 Locality 为 2F（F：即全功能副本） 或 4F。 - 仲裁服务所在主机的剩余资源满足资源要求。 该资源要求可在系统参数中根据实际情况进行修改，需修改的参数如下，操作详情可参见 [修改系统参数](https://www.oceanbase.com/docs/common-ocp-1000000000826686)。 - `ocp.arbitration.min.remain.disk.size`：开启租户仲裁时，仲裁服务主机 CLOG 盘剩余最小值，单位为 MB。数据格式 (a,b) 表示租户副本分别为 2F、4F 时的值，默认为 [12,24]。 - `ocp.arbitration.max.cpu.used.percentage`：开启租户仲裁时，仲裁服务主机最大 CPU 使用率，单位为 %，默认值为 90。 - `ocp.arbitration.max.memory.used.percentage`：开启租户仲裁时，仲裁服务主机最大内存可用率，单位为 %，默认值为 90。 ## 操作步骤 1. 登录 OCP。 2. 在左侧导航栏选择 **租户** ，系统默认进入 **租户列表** 页签。 3. 在 **租户列表** 页面，单击 **新建租户** 。 ![16310527](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/430/%E6%96%B0%E5%BB%BA%E7%A7%9F%E6%88%B7.png) 4. 填写 **基础信息** 。需要完成的基本设置及其相关说明如下表所示。 | **配置** | **描述** | | --- | --- | | **租户类型** | 选择 **主租户**。 > **说明** > 当租户所属集群为 V4.2 以下版本时，不支持选择租户类型，默认为主租户。 | | **集群** | 为租户选择所属集群。 > **说明** > 当您通过指定集群的租户管理页面创建主租户时，则默认为当前集群。 | | **租户名** | 租户名称支持英文大小写字母、数字和下划线，长度为 2~64 字符。 | | **管理员初始密码** | 租户管理员账号的密码，支持随机生成。 - 对于 MySQL 模式，其管理员账号为 root。 - 对于 Oracle 模式，其管理员账号为 SYS。 密码格式要求如下： - 长度为 8~32 个字符 - 至少包含数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符四种类型中的三种，支持的特殊字符为 `~!@#%^&*_-+=\|(){}[]:;,.?/`。 | | **字符集与编码** | - 对于 MySQL 模式，可选字符集有 utf8mb4、binary、gbk、gb18030 和 latin1；默认为 utf8mb4。 - 对于 Oracle 模式，可选字符集有 utf8mb4、gbk 和 gb18030，默认为 utf8mb4。 | | **Collation** | 与字符集对应的详细排序规则。 | | **备注** | 可选，备注说明信息。 | ![10](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/420/%E4%B8%BB%E7%A7%9F%E6%88%B7-%E5%9F%BA%E6%9C%AC%E8%AE%BE%E7%BD%AE.png) 5. 填写 **副本设置** 。 默认系统会根据所选集群的 Zone 信息显示可配置的 Zone 列表，对于无需做副本分布的 Zone，可以单击后面的删除按钮删除该 Zone 条目。需要配置的 Zone 信息及其相关说明如下表所示。 | **配置** | **描述** | | --- | --- | | **副本类型** | 有以下选项： - 全能型副本 - 只读型副本 - 日志型副本 请选择多个全功能副本类型，确保全功能副本类型占多数派。 #### 说明 当租户所属数据库为 **单机集中式** 时，副本类型仅支持 **全能型副本**。 | | **Unit 规格** | OCP 内置了一套 Unit 规格，请参考 [OCP 资源单元规格列表](https://www.oceanbase.com/docs/common-ocp-1000000000826459) 进行选择，或者您也可以在列表下方单击 **新增规格** 按钮新增自定义规格。 #### 注意 - 建议为全能型副本设置相同的 Unit 规格与数量，不同的 Unit 规格与数量可能造成性能或稳定性问题。 - 当租户所属集群为 V4.0.0 及以上版本时： - CPU 不支持配置 1C 以下规格。 - 集群默认对内存规格的最小值进行限制，您可通过 `__min_full_resource_pool_memory` 参数来进行调整。以 V4.1.0 的集群为例，参数修改步骤可参考 [修改集群项配置](https://www.oceanbase.com/docs/common-oceanbase-database-cn-10000000001697240)。 | | **Unit 数量** | 指定该 Zone 下的 Unit 数量。Unit 数量不能超过该 Zone 下 Server 个数。 - 当所选集群为 V4.0 及以上版本时，不支持按 Zone 级别单独设置 unit 数量，所有 Zone 的 Unit 数量需保持一致（默认为 1）。 - 当所选集群为 V4.0 以下版本时，多个 Zone 可以设置不同的 Unit 数量。 #### 说明 当租户所属数据库为 **单机集中式** 时，Unit 数量默认为 **1**，不支持修改。 | | **Zone 优先级排序** | 选择是否为租户指定 Zone 的优先级排序，该优先级顺序将影响当前租户的 Primary Zone 的优先级顺序。 - 若打开 “Zone 优先级排序” 后未配置任何 Zone 优先级，则为 random 优先级。 - 若需配置 Zone 优先级，您可以在左侧列表框中选择一个或多个 Zone 添加到右侧的列表框中，左边的列表框中显示了当前集群的所有 Zone。默认先选择的 Zone 的优先级高于后选择的 Zone，一次选中的多个 Zone 的优先级相同。 移动到右侧的列表框中后，您也可以在右侧的列表框中通过拖拽调整顺序，列表框上方的 Zone 的优先级高于下方的 Zone。 #### 说明 当租户所属数据库为 **单机集中式** 时，Zone 优先级排序不展示，默认 Zone1 为第一优先级。 | | **开启仲裁服务** | 选择是否为租户开启仲裁服务，该功能默认关闭。 | ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/420/%E5%89%AF%E6%9C%AC%E8%AE%BE%E7%BD%AE.png) 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. 打开 **参数配置** 模块，并配置租户参数。 - 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。 - 也可通过如图 ② 处，单击 **选择参数模板**，选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。在未创建租户参数模板的情况下，您可单击 **新建租户模板**，为租户创建参数模板，详情可参考 [租户参数模板管理](https://www.oceanbase.com/docs/common-ocp-1000000000826464)。 系统提供如下 4 种内置模板，模板中包含了常用的参数设置，您可直接应用该模板进行集群的初始化设置。关于系统内置模板，具体说明如下。 | 模板 | 参数配置 | 说明 | | --- | --- | --- | | COMPLEX_OLTP 默认参数模板 | `_rowsets_max_rows:4` | 适用于银行、保险系统等工作负载。他们通常具有复杂的联接、复杂的相关子查询、用 PL 编写的批处理作业，以及长事务和大事务。有时对短时间运行的查询使用并行执行。 该模板适用于 OceanBase V4.3.0 及以上版本。 | | HTAP 默认参数模板 | `_rowsets_max_rows:32` | 适用于混合 OLAP 和 OLTP 工作负载。通常用于从活动运营数据、欺诈检测和个性化建议中获取即时见解。 该模板适用于 OceanBase V4.3.0 及以上版本。 | | OLAP 默认参数模板 | `default_table_store_format:column` `ob_query_timeout:604800000000` `ob_sql_work_area_percentage:30` `ob_trx_timeout:604800000000` `parallel_min_scan_time_threshold:10` `_rowsets_max_rows:256` | 用于实时数据仓库分析场景。 该模板适用于 OceanBase V4.3.0 及以上版本。 | | EXPRESS_OLTP 默认参数模板 | `_rowsets_max_rows:1` | 适用于贸易、支付核心系统、互联网高吞吐量应用程序等工作负载。没有外键等限制、没有存储过程、没有长交易、没有大交易、没有复杂的连接、没有复杂的子查询。 该模板适用于 OceanBase V4.3.0 及以上版本。 | #### 说明 如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。 ![1201](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/430/%E7%A7%9F%E6%88%B7%E5%8F%82%E6%95%B0%E8%AE%BE%E7%BD%AE.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) 咨询热线