新建备租户

如果您有一个主租户或备租户，您可以为当前租户创建一个备租户。OCP 支持对一个主租户创建多个备租户（一对多）、支持对备租户创建备租户（级联）两种场景。

背景信息

OceanBase 自 V4.1.0 版本开始，物理备库的产品形态变更为租户级主备，即主或备的角色信息属于租户，分为主租户和备租户，集群不再有主备角色的概念，而只是承载租户的容器。主租户是用户创建的业务租户，支持完整的数据库服务能力，包括：查询、DML、DDL 等；备租户则仅提供容灾和只读服务的能力。一个主租户和若干备租户共同组成了租户级的物理备库高可用解决方案。

前提条件

• 仅支持 OceanBase V4.2 及以上版本配置租户级主备库。

• 当创建低于 OceanBase V4.2.1.8 版本的备租户时，请勿使用 30 天之前的基线备份数据恢复物理备库，其可能造成物理备库功能异常，影响租户合并。

• 备租户所属集群状态为运行中。

• 当前登录用户具备系统管理员角色、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。

操作步骤

新建备租户有以下四个入口：

• 入口一：登录 OCP，进入 租户 页面，单击右上角 新建租户。

• 入口二：登录 OCP，进入集群 概览 页面，单击右上角 新建租户。

• 入口三：登录 OCP，进入集群 概览 页面，在左侧导航栏选择 租户管理，单击右上角 新建租户。

• 入口四：登录 OCP，进入租户 概览 页面，单击右上角更多图标，选择 新建租户。

以下操作步骤以 入口一 为例。

1. 登录 OCP。

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

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

   

4. 填写 基本设置 。

   需要完成的基本设置及其相关说明如下表所示。

   配置	描述
   租户类型	选择 备租户。 说明 当您通过指定租户的概览页面创建备租户时，不支持选择租户类型，默认为备租户。
   主租户所属 OCP	多集群模式 下，需选择主租户所属 OCP。 说明 当您通过指定租户的概览页面创建备租户时，无需配置此信息。
   主租户所属集群	选择主租户的所属集群。 说明 当您通过指定租户的概览页面创建备租户时，默认为当前集群，不支持修改。
   主租户	选择备租户所属的主租户。 说明 当您通过指定租户的概览页面创建备租户时，主租户默认为当前租户，不支持修改。
   备租户所属集群	选择备租户的所属集群。 说明 当您通过指定集群的租户管理页面创建备租户时，默认为当前集群，不支持修改。
   备租户名称	备租户名称以英文字母开头、英文或数字结尾，可包含英文、数字和下划线，且长度为 2~32 个字符。
   服务名	可选。服务名是 OceanBase 提供的一种新的数据库访问方式，可以视其为集群名和租户名的别名，实现应用程序通过服务名的方式访问数据库。服务名以英文字母开头，可包含英文、数字和下划线，且长度为 2~64 个字符。 当满足如下版本要求时，方可为租户配置服务名： 租户所属集群为 V4.2.4 及以上、V4.3.0 以下版本。 OBProxy 为 V4.3.1 及以上版本。 说明 如果主租户已设置 服务名，则自动填充原主租户服务名。
   主备同步方式	支持 基于网络 和 基于归档 两种同步方式。 基于网络 是通过 OBServer 之间的 RPC 网络同步日志，备租户可直接通过 ip + port 读取主租户的日志。系统默认选择 基于网络 方式作为主备租户同步方式。 基于归档 是通过共享存储同步日志，主租户将日志写到网络磁盘或者 OSS 存储中，备租户从共享存储中读取数据。基于归档 方式需保证当前租户已开启归档，否则将无法基于归档同步数据。关于 OCP 开启归档的相关信息，可参考 立即进行租户备份。 说明 当已存在主备关系（级联、一对多），默认选择已使用的主备同步方式且不支持修改。

   

5. 填写 恢复备租户设置，设置备份集信息。您可根据不同的使用场景，选择是否为备租户设置独立的存储目录。

   说明

   当 主备同步方式 为 基于网络 且主租户 Redo 日志完整时，无需额外配置 恢复备租户设置。同时，您也可单击 使用备份集恢复 配置备份集信息，选择通过备份集来恢复备租户。

   • 设置独立的存储目录

     适用于当您未使用 OCP 的租户备份功能且已黑屏备份了租户，或您已将主租户的外部备份文件复制到一个共享存储中、想通过该备份文件恢复一个备租户的场景。

     配置	描述
     备份集存储类型	选择备份文件存储介质，取值范围： File：本地文件存储，一般为 NFS。 OSS：阿里云 OSS 对象存储，仅 OceanBase V2.2.76 及以上版本支持。 COS：腾讯云 COS 对象存储，仅 OceanBase V2.2.76 及以上、V4.0.0 以下版本或者 OceanBase V4.2.1 及以上版本支持。
     数据备份目录	填写备份文件在当前介质上的数据存储目录。
     日志备份目录	填写备份文件在当前介质上的日志存储目录。
     访问域名	填写备份集云存储端的域名。 当 备份集存储类型 为 OSS 时，填写备份文件阿里云存储端的域名。支持在域名后添加端口号，如：oss.ap-shanghai.myqcloud.com:8080。 当 备份集存储类型 选择 COS 时展示，填写访问腾讯云 COS 存储桶中对象的域名。如：cos.ap-beijing.myqcloud.com。
     访问用户	当 备份集存储类型 为 OSS 时展示，填写访问阿里云存储端的用户 AccessKey ID。
     资源标识（APPID）	当 备份集存储类型 为 COS 时展示，开发者访问 COS 服务时拥有的用户维度唯一资源标识，可在对应产品的 API 秘钥管理页面获取。
     项目身份识别 ID	当 备份集存储类型 为 COS 时展示，填写开发者拥有的项目身份识别 ID，可在对应产品的 API 秘钥管理页面获取。
     访问密钥	当 备份集存储类型 为 OSS 或 COS 时展示，填写访问阿里云或腾讯云存储端的用户 AccessKey Secret。

   • 不设置独立存储目录

     当您已在 OCP 中通过备份恢复功能对租户进行了备份，您可选择不设置独立存储目录，此时系统会自动填写存储目录的相关配置信息，且不支持修改。

     配置	描述
     存储目录	填写备份文件在当前介质上的存储目录。
     访问域名	填写备份集云存储端的域名。 当 备份集存储类型 为 OSS 时，填写备份文件阿里云存储端的域名。支持在域名后添加端口号，如：oss.ap-shanghai.myqcloud.com:8080。 当 备份集存储类型 选择 COS 时，填写访问腾讯云 COS 存储桶中对象的域名。如：cos.ap-beijing.myqcloud.com。

   

   单击 备份集校验，系统将对当前的备份集的目录备租户所在集群是否可访问、以及当前的备份集的最大可恢复时间与当前主租户的时间是否存在日志缺失进行检查。若检查不通过，您可通过提示信息进行排查和处理。

6. 填写 备租户副本设置 。

   说明

   备租户的副本规格建议与主租户保持一致。

   默认系统会根据所选集群的 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 为第一优先级。
   开启仲裁服务	选择是否为租户开启仲裁服务，该功能默认关闭。

   

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. 单击 提交 。

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

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

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

     

   说明

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