Note
This view is available starting with V4.2.0.
Overview
The DBA_OB_BALANCE_JOB_HISTORY view displays the history of all load balancing jobs executed for a tenant.
Columns
Column |
Type |
Is NULL |
Description |
|---|---|---|---|
| JOB_ID | bigint(20) | NO | CLB Work ID |
| CREATE_TIME | timestamp(6) | NO | Job Creation Time |
| FINISH_TIME | timestamp(6) | NO | Job completion time, including success and cancellation times |
| BALANCE_STRATEGY | varchar(64) | NO | Load balancing strategy name. Valid values:
|
| JOB_TYPE | varchar(64) | NO | Task type. Valid values:
|
| TARGET_UNIT_NUM | bigint(20) | NO | Number of Units in Each Zone Where Target Changes
NoteFor version V4.2.5, the value of this field has been changed to always be |
| TARGET_PRIMARY_ZONE_NUM | bigint(20) | NO | Number of Changed Primary Zones |
| STATUS | varchar(64) | NO | Task Status
|
| COMMENT | longtext | YES | Comments |
| MAX_END_TIME | timestamp(6) | YES | Maximum End Time of Load Balancing Tasks
NoteFor V4.2.x, this field is available starting from V4.2.4. For V4.3.x, this view is available starting from V4.3.4. |
| ZONE_UNIT_NUM_LIST | varchar(4096) | NO | Number of Units in Each Zone of Tenant
NoteThis field is available starting from V4.2.5 BP5 for version V4.2.5. |
| PARAMETER_LIST | longtext | NO | Load balancing related parameters
NoteFor V4.2.5, this field is available starting from V4.2.5 BP5. |
Sample query
View the history of all load balancing tasks executed for the current tenant.
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_BALANCE_JOB_HISTORY;
The query result is as follows:
+---------+----------------------------+----------------------------+-------------------------+------------+-----------------+-------------------------+-----------+--------------------------------------------------------------------------------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| JOB_ID | CREATE_TIME | FINISH_TIME | BALANCE_STRATEGY | JOB_TYPE | TARGET_UNIT_NUM | TARGET_PRIMARY_ZONE_NUM | STATUS | COMMENT | MAX_END_TIME | ZONE_UNIT_NUM_LIST | PARAMETER_LIST |
+---------+----------------------------+----------------------------+-------------------------+------------+-----------------+-------------------------+-----------+--------------------------------------------------------------------------------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| 6038754 | 2025-06-16 13:48:52.919970 | 2025-06-16 13:49:23.124313 | unit list balance | LS_BALANCE | NULL | 1 | COMPLETED | NULL | NULL | z1:2,z2:2,z3:3 | ls_scale_out_factor:1,enable_rebalance:true,enable_transfer:true,enable_gts_standalone:false |
| 6039266 | 2025-06-16 13:50:43.491205 | 2025-06-16 13:50:53.539887 | LS count balance | LS_BALANCE | NULL | 2 | COMPLETED | NULL | NULL | z1:2,z2:2,z3:3 | ls_scale_out_factor:1,enable_rebalance:true,enable_transfer:true,enable_gts_standalone:false |
| 6041716 | 2025-06-16 14:00:35.214859 | 2025-06-16 14:01:05.369658 | LS group count balance | LS_BALANCE | NULL | 2 | COMPLETED | NULL | NULL | z1:2,z2:2 | ls_scale_out_factor:1,enable_rebalance:true,enable_transfer:true,enable_gts_standalone:false |
+---------+----------------------------+----------------------------+-------------------------+------------+-----------------+-------------------------+-----------+--------------------------------------------------------------------------------+--------------+--------------------+----------------------------------------------------------------------------------------------+
3 rows in set
References
View the log stream-level load balancing jobs currently running in the tenant: DBA_OB_BALANCE_JOBS
View the load balancing tasks at the log stream level for the current tenant:
View tablet-level load balancing tasks for the current tenant:
View the transfer partition tasks of the current tenant:
For more information about data load balancing, see Data load balancing.