OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Developer Center

V4.3.3
  • Overview
    • What is ODC?
    • Features
    • Architecture
    • Limitations
    • ODC console
  • Quick Start
    • Client ODC
      • Overview
      • Install Client ODC
      • Use Client ODC
    • Web ODC
      • Overview
      • Deploy Web ODC
      • Use Web ODC
  • Data Source Management
    • Create a data source
    • Data sources and project collaboration
    • Database O&M
      • Session management
      • Global variable management
      • Recycle bin management
  • SQL Development
    • SQL editing and execution
    • Perform PL compilation and debugging
    • Use the command-line window
    • Edit and export the result set of an SQL statement
    • Execution analysis
    • Generate test data
    • Database objects
      • Table objects
        • Overview
        • Create a table
      • View objects
        • Overview
        • Create a view
        • Manage views
      • Function objects
        • Overview
        • Create a function
        • Manage functions
      • Stored procedure objects
        • Overview
        • Create a stored procedure
        • Manage stored procedures
      • Sequence objects
        • Overview
        • Create a sequence
        • Manage sequences
      • Package objects
        • Overview
        • Create a program package
        • Manage program packages
      • Trigger objects
        • Overview
        • Create a trigger
        • Manage triggers
      • Type objects
        • Overview
        • Create a type
        • Manage types
      • Synonym objects
        • Overview
        • Create a synonym
        • Manage synonyms
  • Import and Export
    • Import schemas and data
    • Export schemas and data
  • Database Change Management
    • User Permission Management
      • Users and roles
      • Automatic authorization
    • Project collaboration management
    • Risk levels, risk identification rules, and approval processes
    • SQL check specifications
    • SQL window specification
    • Database change management
    • Logical database change management
    • Batch database change management
    • Online schema changes
    • Synchronize shadow tables
    • Schema comparison
  • Data Lifecycle Management
    • Archive data
    • Clean up data
    • Partitioning Plan Management
      • Manage partitioning plans
      • Set partitioning strategies
      • Examples
    • SQL plan task
  • Data Desensitization and Auditing
    • Desensitize data
    • Operation records
  • Notification Management
    • Overview
    • View notification records
    • Manage Notification Channel
      • Create a notification channel
      • View, edit, and delete a notification channel
      • Configure a custom channel
    • Manage notification rules
  • System Integration
    • Login integration
    • Approval integration
    • SQL approval integration
    • Bastion host integration
  • Deployment Guide
    • Deployment overview
    • Preparations before deployment
    • Deploy ODC in single-node mode
    • Deploy ODC in high-availability mode
    • Deployment verification
  • Upgrade Guide
    • Upgrade Overview
    • Preparations before upgrade
    • Update single-node ODC
    • Update high-avaliability ODC
    • Upgrade verification
    • Rollback after upgrade failed
  • Troubleshooting
    • ODC troubleshooting process
    • Collect Message
      • View the runtime environment and version information
      • View web ODC logs
      • View client ODC logs
      • View end-to-end ODC-related logs
      • View ODC MetaDB data
      • Query the index status in OceanBase Database V4.x
      • Query the index status in OceanBase Database V1.4.x to V3.2.x
      • Collect JVM runtime information
      • Use tcpdump to capture packets
    • FAQ
      • Installation of client ODC
      • Web ODC deployment and startup
      • Connection Information
      • Command-line window
      • DDL statement display
  • Release Note
    • V4.3
      • ODC V4.3.3
      • ODC V4.3.2
      • ODC V4.3.1
      • ODC V4.3.0
    • V4.2
      • ODC V4.2.4
      • ODC V4.2.3
      • ODC V4.2.2
      • ODC V4.2.1
      • ODC V4.2.0
    • V4.1
      • ODC V4.1.3
      • ODC V4.1.2
      • ODC V4.1.1
      • ODC V4.1.0
    • V4.0
      • ODC V4.0.2
      • ODC V4.0.0
    • V3.4
      • ODC V3.4.0
    • V3.3
      • ODC V3.3.3
      • ODC V3.3.2
      • ODC V3.3.1
      • ODC V3.3.0
    • V3.2
      • ODC V3.2.3
      • ODC V3.2.2
      • ODC V3.2.1
      • ODC V3.2.0

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase Developer Center
  3. V4.3.3

Logical database change management

Last Updated:2026-09-03 09:10:53

Background information
Considerations
Create a logical database change task
View a logical database change task
Task information
Task process
Execution records
Task logs
References

Background information

ODC V4.3.2 and later versions support making changes to data in logical databases. You can run time-consuming SQL statements through a logical database change task to avoid statement execution timeout.

Note

  • If you do not have logical database permissions, you can apply for them via Apply for Database Permissions in the project/ticket section.
  • For information on logical databases and physical databases, see Logical Database Management.

Considerations

  • Only OceanBase MySQL and MySQL data sources are supported.

  • Only DDL changes are supported.

  • SQL check specifications and SQL window specifications in ODC security guidelines are not supported.

Create a logical database change task

  1. In Project/Ticket, click Logical Database Change.

    • Create a logical database change from the project entry.

    • Create a logical database change from the ticket entry.

  2. On the Create Logical Database Change page, enter the following information.

    Information Item
    Description
    Logical Database Select the logical database to be changed.
    SQL Content Select SQL Entry: SQL entry is the default method, allowing you to directly enter the SQL script in the editing area.

    Note

    • In SQL entry, a maximum of 500,000 characters are allowed. If exceeded, you can upload an attachment.
    • Click IN Value Conversion to convert batch copied data into the in('A','B') format.
    • Column value separator is a line break character.
    • Row value separator is a space or TAB character.
    Separator Supports Delimiter as the separator.
    Task Settings Select Immediate Execution / Scheduled Execution to set the task execution method.
    Execution Timeout Enter a number in the Execution Timeout text box to specify the statement execution timeout, in hours (default timeout is 48 hours, with a maximum of 480 hours).
    Description You can enter up to 200 characters of descriptive information in the Ticket Description text box. This item is optional.
  3. Click Create to complete creating the logical database change.

  4. After the task is generated, you can view its information in the Ticket > Logical Database Change list.

View a logical database change task

Task information

  1. In the logical database change list on the Ticket page, as shown above, click the View button under the Actions column for the task you want to view.

  2. In the task details panel that appears, click the Basic Information tab to view information such as the logical database, task type, risk level, and SQL content.

  3. Click Initiate Again to re-initiate the logical database change task.

Task process

In the task details panel, click the Workflow tab to view information such as the task initiation status, approval status, execution status, and execution result.

Execution records

In the task details panel, click the Execution Records tab to view the task execution status.

Task logs

In the task details panel, click the Logs tab to view all logs and alert logs of the task.

Information Item
Description
All Logs All logs display the full information of tasks, including INFO, ERROR, and WARN logs. You can click the Find, Download, or Copy button to search for information, download, or copy all log information.
Alert Log The alert log displays only the ERROR and WARN logs of a task. When a task fails, you can view the error information in the alert log. Click the Find, Download, or Copy button to search for information, download, or copy the alert log.

References

  • SQL editing and execution

  • PL compilation and debugging

  • Command-line window

  • Result editing and exporting

  • Execution analysis

  • Generate test data

  • Partition management

  • Shadow table synchronization

  • Lock-free schema change

Previous topic

Database change management
Last

Next topic

Batch database change management
Next
on this page
Background information
Considerations
Create a logical database change task
View a logical database change task
Task information
Task process
Execution records
Task logs
References