为租户开启仲裁服务

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

前提条件

• 请确认当前集群中已部署仲裁服务，部署仲裁服务的详细操作，请参见 部署两副本加仲裁服务的 OceanBase 集群 中的 步骤四：启动、添加仲裁服务。

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

操作步骤

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

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

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

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

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

   示例如下：

   obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS WHERE tenant_name = 'oracle001'\G
   *************************** 1. row ***************************
                    TENANT_ID: 1004
                  TENANT_NAME: oracle001
                  TENANT_TYPE: USER
                  CREATE_TIME: 2023-02-06 13:38:27.626314
                  MODIFY_TIME: 2023-02-06 13:38:45.005930
                 PRIMARY_ZONE: zone1
                     LOCALITY: FULL{1}@zone1
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: ORACLE
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: 1677665769026296752
               REPLAYABLE_SCN: 1677665769026296752
                 READABLE_SCN: 1677665768858323118
           RECOVERY_UNTIL_SCN: 4611686018427387903
                     LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: DISABLED
   1 row in set
   

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

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

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

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

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

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

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

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

   语句如下：

   ALTER TENANT tenant_name [SET] ENABLE_ARBITRATION_SERVICE = true;
   

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

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

   obclient [oceanbase]> ALTER TENANT oracle001 ENABLE_ARBITRATION_SERVICE = true;
   Query OK, 0 rows affected
   

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

   示例如下：

   obclient [oceanbase]> SELECT * FROM DBA_OB_TENANTS WHERE tenant_name = 'oracle001'\G
   *************************** 1. row ***************************
                    TENANT_ID: 1004
                  TENANT_NAME: oracle001
                  TENANT_TYPE: USER
                  CREATE_TIME: 2023-02-06 13:38:27.626314
                  MODIFY_TIME: 2023-02-06 13:38:45.005930
                 PRIMARY_ZONE: zone1
                     LOCALITY: FULL{1}@zone1
            PREVIOUS_LOCALITY: NULL
           COMPATIBILITY_MODE: ORACLE
                       STATUS: NORMAL
                IN_RECYCLEBIN: NO
                       LOCKED: NO
                  TENANT_ROLE: PRIMARY
            SWITCHOVER_STATUS: NORMAL
             SWITCHOVER_EPOCH: 0
                     SYNC_SCN: 1677665769026296752
               REPLAYABLE_SCN: 1677665769026296752
                 READABLE_SCN: 1677665768858323118
           RECOVERY_UNTIL_SCN: 4611686018427387903
                     LOG_MODE: NOARCHIVELOG
   ARBITRATION_SERVICE_STATUS: ENABLED
   1 row in set
   

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

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

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

   语句如下：

   (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。

   示例如下：

   obclient [oceanbase]> (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');
   Empty set
   

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

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

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

相关文档

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

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

• 为租户关闭仲裁服务

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

• 为集群替换仲裁服务

• 为集群删除仲裁服务