Note
This view is available starting with V4.2.0.
Purpose
This view displays the load balancing jobs that are currently being executed for the tenant. Each tenant can have only one load balancing job running at a time. Each load balancing job generates multiple load balancing tasks (TASK) to perform the specific load balancing operations.
Columns
Column |
Type |
Nullable |
Description |
|---|---|---|---|
| JOB_ID | bigint(20) | NO | The ID of the load balancing job. |
| CREATE_TIME | timestamp(6) | YES | The time when the job was created. |
| MODIFY_TIME | timestamp(6) | YES | The time when the information was last updated. |
| BALANCE_STRATEGY | varchar(64) | NO | The name of the balancing strategy. Valid values:
|
| JOB_TYPE | varchar(64) | NO | The type of the task. Valid values:
|
| TARGET_UNIT_NUM | bigint(20) | NO | The number of units to be changed in each zone.
Note
|
| TARGET_PRIMARY_ZONE_NUM | bigint(20) | NO | The number of primary zones to be changed. |
| STATUS | varchar(64) | NO | The status of the task. Valid values:
|
| COMMENT | longtext | YES | The comment. |
| MAX_END_TIME | timestamp(6) | YES | The maximum end time of the load balancing tasks.
NoteFor V4.3.x, this view is available starting from V4.3.4. For V4.2.x, this column is available starting from V4.2.4. |
| ZONE_UNIT_NUM_LIST | varchar(4096) | NO | The number of units in each zone of the tenant.
Note
|
| PARAMETER_LIST | longtext | NO | The parameters of the balancing-related configurations.
Note
|
Sample query
Query the load balancing jobs that are currently being executed for the tenant.
obclient(root@mysql001)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_BALANCE_JOBS;
The query result is as follows:
+---------+----------------------------+----------------------------+------------------------+------------+-----------------+-------------------------+--------+---------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| JOB_ID | CREATE_TIME | MODIFY_TIME | BALANCE_STRATEGY | JOB_TYPE | TARGET_UNIT_NUM | TARGET_PRIMARY_ZONE_NUM | STATUS | COMMENT | MAX_END_TIME | ZONE_UNIT_NUM_LIST | PARAMETER_LIST |
+---------+----------------------------+----------------------------+------------------------+------------+-----------------+-------------------------+--------+---------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| 6083968 | 2026-01-16 17:23:18.070731 | 2026-01-16 17:23:18.070731 | LS group count balance | LS_BALANCE | NULL | 2 | DOING | NULL | NULL | z1:2,z2:2,z3:3 | ls_scale_out_factor:1,enable_rebalance:true,enable_transfer:true,enable_gts_standalone:false |
+---------+----------------------------+----------------------------+------------------------+------------+-----------------+-------------------------+--------+---------+--------------+--------------------+----------------------------------------------------------------------------------------------+
1 row in set
References
Query the history of log stream-level load balancing jobs (Job) for the tenant: DBA_OB_BALANCE_JOB_HISTORY
Query the log stream-level load balancing tasks (Task) for the tenant:
Query the tablet-level load balancing tasks (Task) for the tenant:
Query the Transfer Partition tasks (Task) for the tenant:
For more information about data load balancing, see Data load balancing.