CANCEL TRANSFER PARTITION

Purpose

This statement is used to cancel a running Transfer Partition task.

Limitations and considerations

• If you want to cancel a Transfer Partition task for a specific partition, you cannot cancel the task if it is in the DOING state. However, you can cancel the task if it is in the WAITING or INIT state.

• If you want to cancel all Transfer Partition tasks in a tenant, the operation is not atomic. That is, if some tasks are in the DOING state, they cannot be canceled.

• This statement can only be executed on the primary database.

Privilege requirements

The current user has the ALTER SYSTEM privilege.

Syntax

Syntax 1: Cancel a Transfer Partition task for a specific partition

ALTER SYSTEM CANCEL TRANSFER PARTITION TABLE_ID [=] table_id, OBJECT_ID [=] object_id [TENANT = 'tenant_name'];

Syntax 2: Cancel all Transfer Partition tasks in a tenant

ALTER SYSTEM CANCEL TRANSFER PARTITION ALL [TENANT = 'tenant_name'];

Parameters

Examples

• Cancel a Transfer Partition task for a specific partition.

  1. Query the Transfer Partition tasks in the tenant by executing the following statement:

     SELECT T.TENANT_NAME, S.TENANT_ID, S.TABLE_ID, S.OBJECT_ID, S.TASK_ID, S.STATUS
     FROM oceanbase.CDB_OB_TRANSFER_PARTITION_TASKS S, oceanbase.DBA_OB_TENANTS T
     WHERE S.TENANT_ID = T.TENANT_ID;
     

     The result set is as follows:

     +-------------+-----------+----------+-----------+---------+---------+
     | TENANT_NAME | TENANT_ID | TABLE_ID | OBJECT_ID | TASK_ID | STATUS  |
     +-------------+-----------+----------+-----------+---------+---------+
     | oracle001   |      1004 |   500061 |    500064 |       9 | WAITING |
     +-------------+-----------+----------+-----------+---------+---------+
     1 row in set
     

  2. Execute the following statement to cancel the Transfer Partition task for a specific partition in the oracle001 tenant.

     ALTER SYSTEM CANCEL TRANSFER PARTITION TABLE_ID = 500061, OBJECT_ID = 500064 TENANT = 'oracle001';
     

• Cancel all Transfer Partition tasks in the oracle001 tenant.

  ALTER SYSTEM CANCEL TRANSFER PARTITION ALL TENANT = 'oracle001';
  

References

• TRANSFER PARTITION

• oceanbase.CDB_OB_TRANSFER_PARTITION_TASKS

• oceanbase.DBA_OB_TENANTS