Using the database change management capability of ODC (OceanBase Developer Center), OAgent supports creating database change tickets, querying approval progress, and viewing execution results directly within the dialogue. Change execution is handled by the ODC approval process, ensuring that changes are controllable and auditable.
When to use
- After obtaining a solution through SQL diagnostics or parameter governance, directly create a change ticket in the dialogue for approval.
- Need to trace the approval nodes, execution status, and failure reasons of a specific change ticket.
- Parameter changes, data repairs, and more can all be managed through change tickets.
Prerequisites
A product connection to ODC has been configured for creating change tickets and querying progress. For details, see Create a product connection.
The target cluster and tenant have been selected with
@in the session.
Note
OAgent only creates tickets and queries progress; it does not bypass approval to directly execute changes. After approval, ODC executes the changes on the database.
Procedure
In the session where the changed SQL has been identified, enter the request to create a ticket, for example:
Help me create a change ticket for the parameter change SQL above. Create a database change ticket for this index DDL.Press Enter to send the request, and wait for the Agent to call ODC to create the ticket.
The Agent submits information such as the change SQL, target tenant and database, and change type to ODC, and returns the ticket number and approval link.
Track the progress in the approval process.
You can query the ticket progress at any time in the dialogue:
Check the approval progress of the ticket I just created. What is the current status of ticket CHG2026090200001?The Agent will return information such as the current approval node, approver, and execution status.
Verify the result after the change is completed.
- Repeat the verification steps from the previous solution to confirm the change takes effect. See Parameter check and change governance.
Ticket status description
Status |
Meaning |
|---|---|
| Pending Approval | The ticket has been submitted and is awaiting processing at the corresponding approval stage. |
| Approved | Approval completed. Waiting for execution or already in progress. |
| Executing | ODC is executing the change SQL statement. |
| Completed | The change was executed successfully. |
| Rejected/Execution failed | If the approval fails or an error occurs during execution, you can view the error details. |
What to do next
If the ticket fails, you can paste the error details in the session for the agent to locate the cause.
To verify the effect of the change, you can check the metric trends. For more information, see Query resource metrics and task status.