--- title: "新建租户 - 云平台 OCP V4.3.5 | OceanBase 文档中心" description: 新建租户 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建主租户。 前提条件 请确保当前登录 OCP 的用户具备如下权限： 集群维护 资源权限。 租户 概览 菜单权限。 需要创建租户的集群为主集群，且状态为运行中。 （可选）已参考 租户参数… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.3.5 # 新建租户 更新时间：2026-04-27 15:25:51 [编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/500.quickstart/600.quickstart-create-a-tenant.md) 租户（Tenant）既是各类数据库对象的容器，又是资源（CPU、Memory、IO 等）的容器。您可以根据业务需求在集群中创建主租户。 ## 前提条件 - 请确保当前登录 OCP 的用户具备如下权限： - **集群维护** 资源权限。 - 租户 **概览** 菜单权限。 - 需要创建租户的集群为主集群，且状态为运行中。 - （可选）已参考 [租户参数模板管理](https://www.oceanbase.com/docs/common-ocp-1000000002380701) 创建好参数模板。 需要创建多个参数配置相同的租户时，可提前建好参数模板，这样可避免重复配置相同的一批参数。 - 在选择为租户开启仲裁服务前，您需要确认以下信息： - 租户所属集群已添加仲裁服务且仲裁服务处于 **RUNNING** 状态。 - 待开启仲裁服务的租户的 Locality 为 2F（F：即全功能副本） 或 4F。 - 仲裁服务所在主机的剩余资源满足资源要求。 该资源要求可在系统参数中根据实际情况进行修改，需修改的参数如下，操作详情可参见 [修改系统参数](https://www.oceanbase.com/docs/common-ocp-1000000002380951)。 - `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。 - 当租户所属 OceanBase 集群为如下版本时，在使用 RHEL 8 及以上高版本 Linux 内核的情况下，创建租户时需保证 OBServer 所在的主机已创建 Python 的软链接，创建命令可参考 `ln -s /usr/bin/python3 /usr/bin/python` 。 - (-∞, V4.2.1.7) - [V4.2.2, V4.2.4) - [V4.3.0, V4.3.2) ## 操作步骤 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~32 个字符。 | | **管理员初始密码** | 租户管理员账号的密码，支持随机生成。 - 对于 MySQL 模式，其管理员账号为 root。 - 对于 Oracle 模式，其管理员账号为 SYS。 密码格式要求如下： - 长度为 8~32 个字符 - 至少包含数字（0~9）、大写字母（A~Z）、小写字母（a~z）和特殊字符四种类型中的三种，支持的特殊字符为 `~!@#%^&*_-+=\|(){}[]:;,.?/`。 | | **字符集与编码** | - 对于 MySQL 模式，可选字符集有 binary、utf8mb4、gbk、gb18030、latin1、gb18030_2022、ascii 和 tis620，默认为 utf8mb4。 - 对于 Oracle 模式，可选字符集有 utf8mb4、gbk 和 gb18030，默认为 utf8mb4。 | | **Collation** | 与字符集对应的详细排序规则。 | | **服务名** | 可选。服务名是 OceanBase 提供的一种新的数据库访问方式，可以视其为集群名和租户名的别名，实现应用程序通过服务名的方式访问数据库。关于服务名的更多介绍，可参见 [管理服务名](https://www.oceanbase.com/docs/common-ocp-1000000002380971)。 - 服务名以英文字母开头，可包含英文、数字和下划线，且长度为 2~64 个字符。 - 需同时满足如下版本要求，方可为租户配置服务名： - OceanBase：[V4.2.1.9, V4.2.2.0)、[V4.2.4.0, V4.3.0.0)、[V4.3.3.0, +∞)。 - OBProxy：[V4.3.1.0, +∞)。 | | **备注** | 可选，备注说明信息。 | | **负载类型** | 支持为租户选择负载类型。为避免影响数据库运行性能指数，请根据您的实际负载选择对应的负载类型，具体负载类型说明如下： - **Express OLTP**：适用于贸易、支付核心系统、互联网高吞吐量应用程序等工作负载。没有外键等限制，没有存储过程，没有长交易，没有大交易，没有复杂的联接，没有复杂的子查询。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **HTAP**：适用于混合 OLAP 和 OLTP 工作负载。通常用于从活动运营数据、欺诈检测和个性化建议中获取即时见解。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **OLAP**：用于实时数据仓库分析场景。 版本限制：适用于 OceanBase V4.3.0 及以上版本。 - **Complex OLTP**：适用于银行、保险系统等工作负载。它们通常具有复杂的联接、复杂的相关子查询、用 PL 编写的批处理作业，以及长事务和大事务。有时对短时间运行的查询使用并行执行。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 - **OBKV**：用于键值工作负载和类似 hbase 的宽列工作负载，这些工作负载通常具有非常高的吞吐量并且对延迟敏感。 版本限制：适用于 OceanBase V4.2.5 及以上版本。 #### 说明 建议租户与所在集群的负载类型保持一致。 | ![10](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/432/%E7%A7%9F%E6%88%B7%E8%B4%9F%E8%BD%BD%E7%B1%BB%E5%9E%8B.png) 5. 填写 **副本设置** 。 默认系统会根据所选集群的 Zone 信息显示可配置的 Zone 列表，对于无需做副本分布的 Zone，可以单击后面的删除按钮删除该 Zone 条目。需要配置的 Zone 信息及其相关说明如下表所示。 | **配置** | **描述** | | --- | --- | | **副本类型** | 请选择多个全能型副本类型，确保全能型副本类型占多数派。 - 全能型副本：目前支持的普通副本，拥有事务日志、MemTable 和 SSTable等全部完整的数据和功能。它可以随时快速切换为 Leader 以对外提供服务。 - 只读型副本：包含完整的日志、MemTable 和 SSTable 等。不作为 Paxos 成员参与日志的投票，而是作为一个观察者实时追赶 Paxos 成员的日志，并在本地回放。 - 日志型副本：只包含日志的副本，没有 MemTable 和 SSTable。它参与日志投票并对外提供日志服务，可以参与其他副本的恢复，但自己不能变为主提供数据库服务。 - 只读列存型副本：不参与 Paxos 投票，所有用户表的基线数据全部只存储为列存格式，仅支持读操作，适应 TP 增强混合负载（准实时决策分析）。 当您选择只读列存型副本时，当前 OceanBase 集群需至少关联两个 OBProxy 集群，以保证存在一个独立的 OBProxy 集群专门用于转发客户端关于只读列存的相关请求，且该 OBProxy 集群须为 V4.3.2 及以上版本并已完成如下参数配置： - `alter proxyconfig set route_target_replica_type='ColumnStore';` - `alter proxyconfig set proxy_route_policy='TARGET_REPLICA_TYPE_FOLLOWER_ONLY';` - `alter proxyconfig set init_sql='set @@ob_route_policy = COLUMN_STORE_ONLY';` - `alter proxyconfig set obproxy_read_only=0;` - `alter proxyconfig set obproxy_read_consistency=1;` #### 说明 - 当集群为 V4.3.3 及以上版本的分布式集群时，支持 **全能型副本**、**只读型副本** 和 **只读列存型副本**。 - 当集群为 V4.2.0 及以上、V4.3.3 以下版本的分布式集群时，支持 **全能型副本** 和 **只读型副本**。 - 当集群为 V4.0.0 及以上、V4.2.0 以下版本的分布式集群时，仅支持 **全能型副本**。 - 当集群为 V3.x 版本的分布式集群时，支持 **全能型副本**、**只读型副本** 和 **日志型副本**。 - 当租户所属数据库为 **单机集中式** 时，仅支持 **全能型副本**。 | | **Unit 规格** | OCP 内置了一套 Unit 规格，请参考 [OCP 资源单元规格列表](https://www.oceanbase.com/docs/common-ocp-1000000002380695) 进行选择，或者您也可以在列表下方单击 **新增规格** 按钮新增自定义规格。 #### 注意 - 建议为全能型副本设置相同的 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-1000000002380701)。 系统提供如下 4 种内置模板，模板中包含了常用的参数设置，您可直接应用该模板进行集群的初始化设置。关于系统内置模板，具体说明如下。 | 模板 | 说明 | | --- | --- | | COMPLEX_OLTP 默认参数模板 | 对应 **Complex OLTP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | HTAP 默认参数模板 | 对应 **HTAP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | | OLAP 默认参数模板 | 对应 **OLAP** 负载类型，该模板仅适用于 OceanBase V4.3.0 及以上版本。 | | EXPRESS_OLTP 默认参数模板 | 对应 **Express OLTP** 负载类型，该模板仅适用于 OceanBase V4.2.5 及以上版本。 | #### 说明 如果您的租户模式为 MySQL，且选择的参数模板中包含仅支持 Oracle 定义的参数，那么您需在使用模板填充后，手动删除这些参数。 ![1201](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/431/%E5%8F%82%E6%95%B0%E6%A8%A1%E6%9D%BF.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) 咨询热线