新建主租户

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

前提条件

• 请确保当前登录 OCP 的用户具备如下权限：

  • 集群维护 资源权限。
  • 租户 概览 菜单权限。

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

• 同一集群内租户名称不可相同。

• 单机默认仅支持创建一个租户。若想在单机中创建多个主租户，需购买对应的功能选件，并重新 导入 License。

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

  • 租户所属集群已添加仲裁服务且仲裁服务处于 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。

• 在使用 AL 8 及以上高版本 Linux 内核的情况下，创建租户时需保证 OBServer 所在的主机已创建 Python 的软链接，创建命令可参考 ln -s /usr/bin/python3 /usr/bin/python 。同时，OceanBase 部分版本已对 Python3 进行适配，当租户所属集群为 V4.2.1.10、V4.2.5.1、V4.3.5 或 V4.4.x 版本时，无需您再手动创建 Python3 软链接。

• 在使用 RHEL 8 及以上高版本 Linux 内核的情况下，当主机仅支持以 Python3 方式导入时：

  • 若所部署的 OceanBase（el7/el8/al8）RPM 包支持 Python3 和 Python2 两种方式，仅如下 OceanBase 版本使用 Python3 方式导入：
    • (V4.2.1.7, V4.2.2)
    • (V4.2.4, V4.2.5.2)
    • (V4.3.2, V4.3.5.2)
  • 若所部署的 OceanBase（el7/el8/al8）RPM 包仅支持 Python2 方式，如下 OceanBase 版本将无法导入，此时需要您将主机替换为支持 Python2 的主机。
    • [V4.0.0, V4.2.1.7]
    • [V4.2.2, V4.2.4]
    • [V4.3.0, V4.3.2]

操作步骤

1. 登录 OCP。

2. 在左侧导航栏选择 租户 ，系统默认进入 租户列表 页签。

3. 在 租户列表 页面，单击 新建租户 。

   

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 提供的一种新的数据库访问方式，可以视其为集群名和租户名的别名，实现应用程序通过服务名的方式访问数据库。关于服务名的更多介绍，可参见 管理服务名。 服务名以英文字母开头，可包含英文、数字和下划线，且长度为 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 及以上版本。 说明 建议租户与所在集群的负载类型保持一致。

   

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 资源单元规格列表 进行选择，或者您也可以在列表下方单击 新增规格 按钮新增自定义规格。 注意 建议为全能型副本设置相同的 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 默认参数模板	对应 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 定义的参数，那么您需在使用模板填充后，手动删除这些参数。

   

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

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

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

     

   说明

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