为租户开启仲裁服务

您可以在创建租户时即为租户开启仲裁服务，创建租户并开启仲裁服务的相关操作请参见 创建租户。如果未开启仲裁服务，也可以待租户创建成功后，为租户开启仲裁服务。本节主要介绍如何为已有租户开启仲裁服务。

前提条件

• 请确认当前集群中已部署仲裁服务，部署仲裁服务的详细操作，请参见 部署两副本加仲裁服务的 OceanBase 集群。

• 开启仲裁服务前，需要确认待开启仲裁服务的租户的 Locality 为 2F 或 4F，当前仅支持 Locality 为 2F 或 4F 的租户开启仲裁服务。

  说明

  开启仲裁服务仅对租户 Locality 中的 F 副本个数有要求，对租户 Locality 中的 R 副本无限制。例如，租户的 Locality 为 F@z1,F@z2 或 F@z1,F@z2,R@z3 均可以开启仲裁服务。

操作步骤

1. 使用 root 用户登录到集群的 sys 租户。

   连接示例如下，连接数据库时请以实际环境为准。

   obclient -h10.xx.xx.xx -P2883 -uroot@sys#obdemo -p***** -A
   

   有关更加详细的连接数据库的操作指引，参见 连接数据库概述（MySQL 模式） 和 连接数据库概述（Oracle 模式）。

2. 执行以下命令，查看集群中各节点的联通状态。

   SELECT * FROM oceanbase.GV$OB_ARBITRATION_SERVICE_STATUS;
   

   查询结果如下。

   +----------------+----------+-----------------------------+----------+
   | SVR_IP         | SVR_PORT | ARBITRATION_SERVICE_ADDRESS | STATUS   |
   +----------------+----------+-----------------------------+----------+
   | xx.xx.xx.197   |     2882 | xx.xx.xx.192:2882           | ACTIVE   |
   | xx.xx.xx.194   |     2882 | xx.xx.xx.192:2882           | ACTIVE   |
   +----------------+----------+-----------------------------+----------+
   2 rows in set
   

   根据查询结果中 STATUS 字段的值来判断各节点与仲裁服务的联通状态：

   • ACTIVE：表示仲裁服务与该节点通信正常。所有节点均通信正常才可以为租户开启仲裁服务。
   • INACTIVE：表示仲裁服务与该节点无法通信。无法为租户开启仲裁服务，需要排查节点与仲裁服务之间的网络通信情况。

3. 执行以下命令，查看租户的仲裁服务状态。

   SELECT * FROM oceanbase.DBA_OB_TENANTS WHERE tenant_name = 'oracle001'\G
   

   查询结果如下。

   *************************** 1. row ***************************
                    TENANT_ID: 1004
                  TENANT_NAME: oracle001
                  TENANT_TYPE: USER
                  CREATE_TIME: 2023-06-26 19:40:21.457857
                  MODIFY_TIME: 2023-06-27 13:51:47.053502
                 PRIMARY_ZONE: zone1;zone2
                     LOCALITY: FULL{1}@zone1, FULL{1}@zone2
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: ORACLE
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: 1687845116605766616
               REPLAYABLE_SCN: 1687845116605766616
                 READABLE_SCN: 1687845116605766616
           RECOVERY_UNTIL_SCN: 4611686018427387903
                     LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: DISABLED
                     UNIT_NUM: 1
                   COMPATIBLE: 4.2.0.0
   1 row in set
   

   租户的仲裁服务主要有以下几种状态：

   • ENABLED：表示租户已开启仲裁服务。

   • DISABLED：表示租户已关闭仲裁服务。

   • ENABLING：表示租户正在开启仲裁服务。

   • DISABLING：表示租户正在关闭仲裁服务。

   根据查询结果可知，ARBITRATION_SERVICE_STATUS 列为 DISABLED，表示该租户已关闭仲裁服务。

   有关 DBA_OB_TENANTS 视图的更多介绍，请参见 DBA_OB_TENANTS。

4. 执行以下命令，为租户开启仲裁服务。

   语句如下：

   ALTER TENANT tenant_name [SET] ENABLE_ARBITRATION_SERVICE = true;
   

   其中，tenant_name 为待开启仲裁服务的租户名；SET 关键字为可选。

   为租户 oracle001 开启仲裁服务的示例如下：

   ALTER TENANT oracle001 ENABLE_ARBITRATION_SERVICE = true;
   

5. 命令执行成功后，再次查询 DBA_OB_TENANTS 视图来确认租户的仲裁服务是否已开启。

   SELECT * FROM oceanbase.DBA_OB_TENANTS WHERE tenant_name = 'oracle001'\G
   

   查询结果如下。

   *************************** 1. row ***************************
                    TENANT_ID: 1004
                  TENANT_NAME: oracle001
                  TENANT_TYPE: USER
                  CREATE_TIME: 2023-06-26 19:40:21.457857
                  MODIFY_TIME: 2023-06-27 13:54:29.486203
                 PRIMARY_ZONE: zone1;zone2
                     LOCALITY: FULL{1}@zone1, FULL{1}@zone2
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: ORACLE
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: 1687845307275557916
               REPLAYABLE_SCN: 1687845307275557916
                 READABLE_SCN: 1687845307131393135
           RECOVERY_UNTIL_SCN: 4611686018427387903
                     LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: ENABLED
                     UNIT_NUM: 1
                   COMPATIBLE: 4.2.0.0
   1 row in set
   

   根据查询结果可知，ARBITRATION_SERVICE_STATUS 列为 ENABLED，表示该租户已开启仲裁服务。

6. 成功开启仲裁服务后，租户依然可能存在缺少仲裁成员的日志流，这种日志流无法正常执行升降级操作，您可以通过如下流程进行确认。

   租户的仲裁服务开启成功表示该租户在开启时刻已创建的日志流均可以使用仲裁服务，但开启仲裁服务后新创建的日志流可能缺少仲裁成员，这是因为创建日志流是非严格模式执行的，不能保证仲裁成员一定会创建成功，故针对该场景，可以通过以下语句确认该租户的所有日志流是否都有仲裁成员。

   语句如下：

   (SELECT distinct ls_id FROM GV$OB_LOG_STAT WHERE tenant_id = tenantid) EXCEPT
   (SELECT ls_id FROM GV$OB_LOG_STAT WHERE tenant_id = tenantid AND role = 'LEADER' AND arbitration_member = 'arb_server_ip:arb_server_port');
   

   相关参数说明如下：

   • tenantid：表示开启仲裁服务的租户的租户 ID。

   • arb_server_ip：表示仲裁服务的 IP。

   • arb_server_port：表示仲裁服务的 RPC 端口，默认为 2882。

   示例如下：

   (SELECT distinct ls_id FROM GV$OB_LOG_STAT WHERE tenant_id = 1004) EXCEPT
   (SELECT ls_id FROM GV$OB_LOG_STAT where tenant_id = 1004 and role = 'LEADER' and arbitration_member = '100.xx.xx.xx:2882');
   

   如果查询结果为空，则表示所有日志流都有仲裁成员，仲裁服务可用；如果查询结果不为空，此时 Root Service 会在后台为这些日志流补仲裁成员，您可以通过 CDB_OB_LS_ARB_REPLICA_TASKS 视图进一步确认是否有正在执行补仲裁成员的任务，如果确认补仲裁成员的任务存在且正在执行，需要等待任务执行完成。

   待补仲裁成员的任务执行完成后，您可以查询 CDB_OB_LS_ARB_REPLICA_TASK_HISTORY 视图确认任务的执行结果，如果任务执行成功，则表示日志流补仲裁成员成功，仲裁服务可用；如果任务执行失败，需要联系技术支持人员协助处理。

   有关 GV$OB_LOG_STAT 视图字段的详细介绍，请参见 GV$OB_LOG_STAT。

相关文档

更多仲裁服务相关的操作，请参见以下信息：

• 部署两副本加仲裁服务的 OceanBase 集群

• 为租户关闭仲裁服务

• 修改日志流降级控制时间

• 为集群替换仲裁服务

• 为集群删除仲裁服务