新建主租户

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

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

• 在租户总览页面创建主租户。

• 在指定集群的租户管理页面创建主租户。

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

前提条件

• 需要创建租户的集群为主集群，且状态为运行中。

• 当前登录用户具备系统管理员角色、OCP 租户管理员角色或其他拥有管理该集群权限的角色。

• （可选）已参考 租户参数模板管理 创建好参数模板。

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

• 在选择为租户开启仲裁服务前，您需要确认以下信息：

  • 租户所属集群已添加仲裁服务且仲裁服务处于 RUNNING 状态。

  • 待开启仲裁服务的租户的 Locality 为 2F（F：即全功能副本） 或 4F。

  • 仲裁服务所在主机的剩余资源满足资源要求。

    该资源要求可在系统参数中根据实际情况进行修改，需修改的参数如下，操作详情可参见 修改系统参数。

    • 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. 在 租户列表 页面，单击 新建租户 。

   

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	与字符集对应的详细排序规则。
   备注	可选，备注说明信息。

   

5. 填写 副本设置 。

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

   配置	描述
   副本类型	有以下选项： 全能型副本 只读型副本 日志型副本 请选择多个全功能副本类型，确保全功能副本类型占多数派。 说明 当租户所属数据库为 单机集中式 时，副本类型仅支持 全能型副本。
   Unit 规格	OCP 内置了一套 Unit 规格，请参考 OCP 资源单元规格列表 进行选择，或者您也可以在列表下方单击 新增规格 按钮新增自定义规格。 注意 建议为全能型副本设置相同的 Unit 规格与数量，不同的 Unit 规格与数量可能造成性能或稳定性问题。 当租户所属集群为 V4.0.0 及以上版本时： CPU 不支持配置 1C 以下规格。 集群默认对内存规格的最小值进行限制，您可通过 __min_full_resource_pool_memory 参数来进行调整。以 V4.1.0 的集群为例，参数修改步骤可参考 修改集群项配置。
   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 为第一优先级。
   开启仲裁服务	选择是否为租户开启仲裁服务，该功能默认关闭。

   

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 将无法管理此租户。

   

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

   • 您可通过如图 ① 处，逐个添加启动参数项并为其配置值。

   • 也可通过如图 ② 处，单击 选择参数模板，选择一个参数模板，系统会将模板中的参数连同配置自动填充到此处。在未创建租户参数模板的情况下，您可单击 新建租户模板，为租户创建参数模板，详情可参考 租户参数模板管理。

     系统提供如下 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 定义的参数，那么您需在使用模板填充后，手动删除这些参数。

   

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

   • 若您想查看任务详情，可单击 查看任务详情 按钮，查看新建租户任务的详细执行进度。

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

     

   说明

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