Overview
enable_agent_db_background_task specifies whether to enable background deletion tasks for logical tables.
Privilege requirements
Query parameters
Both the
systenant and all user tenants can query this parameter using theSHOW PARAMETERSstatement or theGV$OB_PARAMETERSview.Modify parameters
Both the
systenant and user tenants can modify this parameter.
Attributes
Attribute |
Description |
|---|---|
| Parameter type | Bool |
| Default Value | True |
| Value range |
|
| Modifiable | Yes, you can use theALTER SYSTEM SETStatement modification. |
| Whether to restart the OBServer node for the change to take effect | No, the setting takes effect immediately. |
Usage instructions
- When enabled, the system performs background physical data deletion for
DROP NAMESPACEandDROP LTABLEoperations executed by users. When disabled, no new background deletion tasks for logical tables are initiated. - This parameter helps prevent system jitter caused by a large number of delete tasks.
- This parameter does not control the cleanup of the TTL task for hot namespaces.
Configuration example
The system tenant cancels the background deletion task for the logical table of the specified user tenant.
obclient(root@sys)[(none)]> ALTER SYSTEM SET enable_agent_db_background_task = False TENANT = tenant_name;The user tenant initiates a background deletion task for the logical table in the current tenant.
obclient> ALTER SYSTEM SET enable_agent_db_background_task = True;