Note
This view is available starting with V4.2.0.
Overview
The CDB_OB_BALANCE_JOB_HISTORY view displays the history of all load balancing jobs performed by a tenant.
Columns
Column |
Type |
Is NULL |
Description |
|---|---|---|---|
| TENANT_ID | bigint(20) | NO | Tenant ID
|
| 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
|
| JOB_TYPE | varchar(64) | NO | The task type.
|
| 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. Valid values:
|
| COMMENT | longtext | YES | Comments |
| MAX_END_TIME | timestamp(6) | YES | Maximum End Time of Load Balancing Task
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 load balancing operation history of all tenants.
obclient [oceanbase]> SELECT * FROM oceanbase.CDB_OB_BALANCE_JOB_HISTORY;
The query result is as follows:
+-----------+---------+----------------------------+----------------------------+-------------------------+------------+-----------------+-------------------------+-----------+--------------------------------------------------------------------------------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| TENANT_ID | 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 |
+-----------+---------+----------------------------+----------------------------+-------------------------+------------+-----------------+-------------------------+-----------+--------------------------------------------------------------------------------+--------------+--------------------+----------------------------------------------------------------------------------------------+
| 1008 | 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 |
| 1008 | 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 |
| 1008 | 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 current load balancing jobs at the log stream level for all tenants: CDB_OB_BALANCE_JOBS
View the load balancing tasks at the log stream level for all tenants:
View load balancing tasks at the tablet level for all tenants:
View all tenant transfer partition tasks:
For more information about data load balancing, see Data load balancing.