OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Migration Service

V4.3.2Enterprise Edition

  • OMS Documentation
  • OMS Introduction
    • What is OMS
    • Terms
    • OMS HA
    • Principles of Store
    • Principles of Full-Import and Incr-Sync
    • Data verification principles
    • Architecture
      • Hierarchical functional system
      • Overview
      • Basic components
    • OMS Oracle full migration design and impact
    • Limitations
  • Quick Start
    • Data migration process
    • Data synchronization process
  • Deploy OMS
    • Environment preparations
    • Memory and disk requirements
    • Scale down deployment
    • Deployment types
    • Check the deployment
    • Scale out
    • Deploy OMS on multiple nodes in multiple regions
    • System and network requirements
    • Deploy OMS on multiple nodes in a single region
    • Deploy OMS on a single node
    • Deploy a time-series database (Optional)
  • OMS console
    • Overview
    • Log in to the OMS console
    • User center
      • Change your login password
      • Log out
      • Configure user information
  • Data migration
    • Migrate data from a PostgreSQL database to the Oracle compatible mode of OceanBase Database
    • Migrate data from an Oracle database to the Oracle compatible mode of OceanBase Database
    • Migrate data from a MySQL-compatible tenant of OceanBase Database to a DB2 LUW database
    • Migrate data from a PostgreSQL database to the MySQL compatible mode of OceanBase Database
    • Migrate incremental data from an Oracle-compatible tenant of OceanBase Database to a MySQL database
    • Overview
    • Migrate data from an Oracle database to the MySQL compatible mode of OceanBase Database
    • Migrate data from a Milvus database to a MySQL-compatible tenant of OceanBase Database
    • Migrate data from a TiDB database to a MySQL-compatible tenant of OceanBase Database
    • Configure a bidirectional synchronization task
    • Migrate data from a PolarDB-X 1.0 database to a MySQL-compatible tenant of OceanBase Database
    • Migrate data from a MySQL-compatible tenant of OceanBase Database to a MySQL database
    • Migrate data between OceanBase databases of the same tenant type
    • Migrate data from an OBSharding database to a MySQL-compatible tenant of OceanBase Database
    • Migrate data from a DB2 LUW database to a MySQL-compatible tenant of OceanBase Database
    • Migrate data from the Oracle compatible mode of OceanBase Database to an Oracle database
    • Migrate data from a DB2 LUW database to an Oracle-compatible tenant of OceanBase Database
    • Migrate data from a MySQL database to a MySQL-compatible tenant of OceanBase Database
    • Migrate data from an Oracle-compatible tenant of OceanBase Database to a DB2 LUW database
    • Supported DDL operations and limits for synchronization
      • Synchronize DDL operations from the MySQL compatible mode of OceanBase Database to a MySQL database
      • Synchronize DDL operations from a DB2 LUW database to an Oracle-compatible tenant of OceanBase Database
      • Synchronize DDL operations between MySQL-compatible tenants of OceanBase Database
      • Synchronize DDL operations from a DB2 LUW database to a MySQL-compatible tenant of OceanBase Database
      • Synchronize DDL operations from a PostgreSQL database to the MySQL compatible mode of OceanBase Database
      • Synchronize DDL operations between Oracle-compatible tenants of OceanBase Database
      • Synchronize DDL operations from the Oracle compatible mode of OceanBase Database to an Oracle database
      • Synchronize DDL operations from an OBSharding database to the Oracle compatible mode of OceanBase Database
      • Synchronize DDL operations from the MySQL compatible mode of OceanBase Database to a DB2 LUW database
      • Synchronize DDL operations from the Oracle compatible mode of OceanBase Database to a DB2 LUW database
      • Synchronize DDL operations from a PostgreSQL database to the Oracle compatible mode of OceanBase Database
      • DDL operations for synchronizing data from an Oracle database to an Oracle-compatible tenant of OceanBase Database
        • Overview of DDL synchronization from Oracle to OceanBase Database Oracle compatible mode
        • DROP TABLE
        • DROP INDEX
        • TRUNCATE TABLE
        • RENAME OBJECT
        • ALTER TABLE
          • Modify, drop, and add constraints
          • Modify, drop, and add table attributes
          • Overview
          • Column attribute management
            • Add columns and column attributes
            • Drop columns
            • Modify, drop, and add column attributes
            • Modify column attributes
            • Rename a column
          • Partition management
            • Drop a subpartition
            • Modify partitions
            • Drop a partition
            • Drop partition data
            • Modify, drop, and add partitions
            • Add partitions and subpartitions
        • CREATE TABLE
          • Virtual columns
          • Regular columns
          • Overview for CREATE TABLE
          • Constraints
            • Overview
            • Inline constraints
            • Out-of-line constraints
          • Create partitions
            • Custom partitioning
            • Composite partitioning
            • Overview for creating partitions
            • Subpartition templates
            • Subpartitioning
            • Partitioning
          • Create a relational table
            • Create a relational table
            • Define columns of a relational table
        • DDL incompatibilities between an Oracle database and an Oracle-compatible tenant of OceanBase Database
          • Overview
          • Incompatibilities of CREATE TABLE
          • Incompatibilities in table modification operations
            • Incompatibilities of ALTER TABLE
            • Change the type of an unconstrained column
            • Change the length of an unconstrained column
            • Change the type of a constrained column
            • Change the length of a constrained column
        • CREATE INDEX
          • Overview
          • Regular table indexes
      • Synchronize DDL operations from a MySQL database to a MySQL-compatible tenant of OceanBase Database
        • TRUNCATE TABLE
        • RENAME TABLE
        • Data type conversion
        • DROP TABLE
        • Overview of DDL synchronization from MySQL to OceanBase Database's MySQL compatible mode
        • DROP INDEX
        • CREATE INDEX
        • DDL incompatibilities between a MySQL database and a MySQL-compatible tenant of OceanBase Database
          • Overview
          • Incompatibilities of DROP INDEX operations
          • Incompatibilities of the ALTER TABLE statement
            • Delete a constrained column
            • Incompatibilities of ALTER TABLE
            • Change the length of a constrained column
            • Change the type of a constrained column
            • Change the length of an unconstrained column
            • Change the type of an unconstrained column
          • Incompatibilities of the CREATE TABLE statement
            • Incompatibilities of CREATE TABLE
            • Column types that are supported to create indexes or constraints
        • ALTER TABLE
          • Modify tables
          • Operations on columns
          • Partition operations
          • Operations on constraints and indexes
        • CREATE TABLE
          • Create partitions
          • Create indexes or constraints
          • Create a column
          • Create a table
    • Manage data migration tasks
      • Start and pause a data migration task
      • Use tags to Manage data migration tasks
      • Download and import settings of migration objects
      • Download a conflict log file
      • View and modify migration objects
      • View and modify migration parameters
      • Rename a data migration task
      • End and delete a data migration task
      • View details of a data migration task
      • Perform batch operations on data migration tasks
  • Data synchronization
    • Overview
    • Synchronize data from OceanBase Database to a Kafka instance
    • Synchronize data from OceanBase Database to a RocketMQ instance
    • Synchronize data from OceanBase Database to a DataHub instance
    • Synchronize data from an ODP logical table to a DataHub instance
    • Synchronize data from an IDB logical table to a MySQL-compatible tenant of OceanBase Database
    • Synchronize data from an IDB logical table to a DataHub instance
    • Synchronize data from an Oracle database to a DataHub instance
    • Synchronize data from a MySQL database to a DataHub instance
    • Synchronize data from an ODP logical table to a physical table in a MySQL-compatible tenant of OceanBase Database
    • Manage data synchronization tasks
      • View details of a data synchronization task
      • Download and import the settings of synchronization objects
      • View and modify the parameter configurations of a data synchronization task
      • View and modify synchronization objects
      • End and delete a data synchronization task
      • Start and pause a data synchronization task
      • Perform batch operations on data synchronization tasks
      • Change the name of a data synchronization task
      • Use tags to Manage data synchronization tasks
  • Data validation
    • Create a data validation task
    • Overview
    • Manage data validation tasks
      • View and modify validation objects
      • View details of a data validation task
      • Clone a data validation task
      • Delete a data validation task
      • Start, stop, and resume a data validation task
      • Manage data validation tasks by using tags
      • Import validation objects
      • Change the name of a data validation task
      • View and modify validation parameters
  • Create and manage data sources
    • Create a database user
    • Enable binlogs for the MySQL database
    • Minimum privileges required when an Oracle database serves as the source
    • User privileges
    • Create data sources
      • Create a RocketMQ data source
      • Create an OBSharding data source
      • Create an Oracle data source
      • Create a DB2 LUW data source
      • Create a TiDB data source
      • Create a PostgreSQL data source
      • Create a Kafka data source
      • Create a Milvus data source
      • Create a PolarDB-X 1.0 data source
      • Create a DataHub data source
      • Create a MySQL data source
      • Create an OceanBase data source
        • Create a standalone OceanBase data source
        • Create an ODP data source
        • Create an IDB data source
        • Create a public cloud OceanBase data source
        • Create a physical OceanBase data source
    • Manage data sources
      • Copy a data source
      • Delete a data source
      • Edit a data source
      • View data source information
  • OPS & Monitoring
    • Go to the overview page
    • O&M overview
    • Components
      • Incr-Verification
        • Update an Incr-Verification component
        • View details of the Incr-Verification component
        • Pause an Incr-Verification component
        • Rerun and resume an Incr-Verification component
      • Full-Import
        • Rerun and resume a Full-Import component
        • Pause a Full-Import component
        • Delete a Full-Import component
        • View details of a Full-Import component
        • Update the configurations of a Full-Import component
      • Full-Verification
        • View details of a Full-Verification component
        • Rerun and resume a Full-Verification component
        • Update the configurations of a Full-Verification component
        • Pause a Full-Verification component
      • Incr-Sync
        • Update the configurations of an Incr-Sync component
        • View details of an Incr-Sync component
        • Migrate an Incr-Sync component
        • Delete an Incr-Sync component
        • Start and pause an Incr-Sync component
        • Batch O&M
      • Store
        • Add a Store component
        • Start and pause a Store component
        • Update the configurations of a Store component
        • Delete a Store component
        • View details of a Store component
      • Row-Verification
        • View details of a Row-Verification component
    • Server
      • Update the quota
      • View server logs
      • View server information
      • Manage resource groups
    • Parameter Template
      • Overview
      • Component parameters
        • Incr-Verification component parameters
        • Full-Import component parameters
        • Parameters of the Row-Verification component
        • Store component parameters
        • Full-Verification component parameters
        • Supervisor component parameters
        • Incr-Sync component parameters
        • CM component parameters
      • Component Template
        • Delete a component template
        • Copy and export a component template
        • View and edit component templates
        • Create a component template
      • Task Template
        • Create a task template
        • Copy and export a task template
        • View and edit task templates
        • Delete a task template
    • O&M Task
      • Retry a task or subtask
      • Skip a task or subtask
      • View O&M tasks
  • System management
    • Manage access keys
    • Operation audit
    • Associate with OCP
    • System parameters
      • Modify HA configurations
      • oblogproxy parameters
      • Modify system parameters
    • Permission Management
      • Manage departments
      • Manage users
      • Overview
    • Alert center
      • Manage alert settings
      • View system alerts
      • View task alerts
  • Troubleshooting Guide
    • OMS logs
    • Set throttling
    • Store performance diagnostics
    • Manage OMS services
    • Component tuning
      • Oracle store tuning
      • Incr-Sync/Full-Import tuning
    • Component O&M
      • CLI-based O&M for the Connector component
      • O&M operations for the Supervisor component
      • O&M operations for the Store component
  • Reference Guide
    • Change the log level for a PostgreSQL database instance
    • Configure Milvus topics
    • Online DDL tools
    • Create a trigger
    • Supplemental logging in Oracle databases
    • OMS error codes
    • SQL statements for querying database objects
    • Features
      • Change a topic
      • Hidden column mechanisms
      • Column filtering and column mapping
      • Rename databases and tables
      • Configure DDL/DML synchronization
      • Configure matching rules for migration or synchronization objects
      • Data formats
      • Configure matching rules for validation objects
      • Use SQL conditions to filter data
      • DDL synchronization scope
      • Instructions on schema migration
      • Set the incremental synchronization start timestamp
      • Create and update a heartbeat table
      • Wildcard patterns supported for matching rules
    • API Reference
      • StopProject
      • Overview
      • ListProjects
      • CreateOceanBaseODPDataSource
      • DescribeProjectStepMetric
      • Download schema conversion information
      • UpdateProjectConfig
      • ListProjectFullVerifyResult
      • DeleteProject
      • AdvanceProject
      • ResumeProject
      • DescribeProject
      • CreateMysqlDataSource
      • DeleteDataSource
      • CreateOceanBaseDataSource
      • CreateLabel
      • ListProjectModifyRecords
      • ListAllLabels
      • CreateProjectModifyRecords
      • CancelProjectModifyRecord
      • ResetIncrStartTimestamp
      • DescribeProjectSteps
      • ListDataSource
      • StartProjectsByLabel
      • ReleaseProject
      • RetryProjectModifyRecords
      • StartProject
      • DescribeRegions
      • CreatePolarDBDataSource
      • DescribeProjectProgress
      • StopProjectsByLabel
      • DescribeProjectComponents
      • CreateProject
      • GetPreCheckResult
      • DownloadConflictData
      • StopProjectModifyRecords
      • SubmitPreCheck
      • ListConflictData
      • CreateMilvusDataSource
    • SSO
      • Access Microsoft Entra ID using OMS SAML 2.0
      • Integrate the OIDC protocol to OMS to implement SSO
      • Integrate the SAML 2.0 protocol to OMS to implement SSO
    • Alert Reference
      • oms_host_down_migrate_resource
      • oms_sync_status_inconsistent
      • oms_host_threshold
      • oms_migration_delay
      • oms_host_down
      • oms_sync_delay
      • oms_migration_failed
      • oms_sync_failed
  • Upgrade Guide
    • Overview
    • Upgrade OMS in single-node deployment mode
    • Upgrade OMS in multi-node deployment mode
    • FAQ
  • FAQ
    • Data migration
      • Incremental synchronization
        • How do I migrate an Oracle database object whose name exceeds 30 bytes in length?
        • How do I update whitelists and blacklists?
        • What are the application scope and limits of ETL?
        • How do I skip DDL statements?
      • Full migration
        • How do I query the ID of a checker?
        • How do I query log files of the Checker component of OMS?
        • What do I do if garbled characters cannot be written into OceanBase Database V3.1.2?
        • What can I do when the full migration failed due to LOB fields?
        • What do I do if the target table does not exist?
        • How do I query the verification result files of the Checker component of OMS?
      • User privileges
        • What privileges do I need to grant to a user during data migration to or from an Oracle database?
    • Task diagnostics
      • What do I do when a store does not have data of the timestamp requested by the downstream?
      • What do I do when OceanBase Store failed to access an OceanBase cluster through RPC?
      • How do I troubleshoot common problems with Oracle Store?
      • How do I use LogMiner to pull data from an Oracle database?
      • How do I perform performance tuning for Oracle Store?
      • What do I do when Oracle Store reports an error at the isUpdatePK stack?
    • OPS & monitoring
      • What are the alert rules?
    • General O&M
      • Deploy InfluxDB for OMS
      • Increase the disk space of the OMS host
      • How do I modify the resource quotas of an OMS container?
      • How do I troubleshoot the OMS server down issue?
    • Data synchronization
      • FAQ about synchronization to a message queue
        • What are the strategies for ensuring the message order in incremental data synchronization to Kafka
    • Installation and deployment
      • How do I upgrade Store?
  • Release Note
    • Release Note
      • Version number rules
      • V4.0
        • OMS V4.0.1
        • OMS V4.0.2
      • V2.1
        • OMS V2.1.0
        • OMS V2.1.2
      • V3.1
        • OMS V3.1.0
      • V3.4
        • OMS V3.4.0
      • V3.2
        • OMS V3.2.2
        • OMS V3.2.1
      • V4.3
        • OMS V4.3.0
        • OMS V4.3.1
        • OMS V4.3.2
      • V4.2
        • OMS V4.2.3
        • OMS V4.2.5
        • OMS V4.2.4
        • OMS V4.2.0
        • OMS V4.2.1
        • OMS V4.2.2
      • V3.3
        • OMS V3.3.0
        • OMS V3.3.1
      • V4.1
        • OMS V4.1.0

Download PDF

OMS Documentation What is OMS Terms OMS HA Principles of Store Principles of Full-Import and Incr-Sync Data verification principles Hierarchical functional system Overview Basic components OMS Oracle full migration design and impact Limitations Data migration process Data synchronization process Environment preparations Memory and disk requirements Scale down deployment Deployment types Check the deployment Scale out Deploy OMS on multiple nodes in multiple regions System and network requirements Deploy OMS on multiple nodes in a single region Deploy OMS on a single node Deploy a time-series database (Optional) Overview Log in to the OMS console Change your login password Log out Configure user information Migrate data from a PostgreSQL database to the Oracle compatible mode of OceanBase Database Migrate data from an Oracle database to the Oracle compatible mode of OceanBase Database Migrate data from a MySQL-compatible tenant of OceanBase Database to a DB2 LUW database Migrate data from a PostgreSQL database to the MySQL compatible mode of OceanBase Database Migrate incremental data from an Oracle-compatible tenant of OceanBase Database to a MySQL database Overview Migrate data from an Oracle database to the MySQL compatible mode of OceanBase Database Migrate data from a Milvus database to a MySQL-compatible tenant of OceanBase Database Migrate data from a TiDB database to a MySQL-compatible tenant of OceanBase Database Configure a bidirectional synchronization task Migrate data from a PolarDB-X 1.0 database to a MySQL-compatible tenant of OceanBase Database Migrate data from a MySQL-compatible tenant of OceanBase Database to a MySQL database Migrate data between OceanBase databases of the same tenant type Migrate data from an OBSharding database to a MySQL-compatible tenant of OceanBase Database Migrate data from a DB2 LUW database to a MySQL-compatible tenant of OceanBase Database Migrate data from the Oracle compatible mode of OceanBase Database to an Oracle database Migrate data from a DB2 LUW database to an Oracle-compatible tenant of OceanBase Database Migrate data from a MySQL database to a MySQL-compatible tenant of OceanBase Database Migrate data from an Oracle-compatible tenant of OceanBase Database to a DB2 LUW database Synchronize DDL operations from the MySQL compatible mode of OceanBase Database to a MySQL database Synchronize DDL operations from a DB2 LUW database to an Oracle-compatible tenant of OceanBase Database Synchronize DDL operations between MySQL-compatible tenants of OceanBase Database Synchronize DDL operations from a DB2 LUW database to a MySQL-compatible tenant of OceanBase Database Synchronize DDL operations from a PostgreSQL database to the MySQL compatible mode of OceanBase Database Synchronize DDL operations between Oracle-compatible tenants of OceanBase Database Synchronize DDL operations from the Oracle compatible mode of OceanBase Database to an Oracle database Synchronize DDL operations from an OBSharding database to the Oracle compatible mode of OceanBase Database Synchronize DDL operations from the MySQL compatible mode of OceanBase Database to a DB2 LUW database Synchronize DDL operations from the Oracle compatible mode of OceanBase Database to a DB2 LUW database Synchronize DDL operations from a PostgreSQL database to the Oracle compatible mode of OceanBase Database Start and pause a data migration task Use tags to Manage data migration tasks Download and import settings of migration objects Download a conflict log file View and modify migration objects View and modify migration parameters Rename a data migration task End and delete a data migration task View details of a data migration task Perform batch operations on data migration tasks Overview Synchronize data from OceanBase Database to a Kafka instance Synchronize data from OceanBase Database to a RocketMQ instance Synchronize data from OceanBase Database to a DataHub instance Synchronize data from an ODP logical table to a DataHub instance Synchronize data from an IDB logical table to a MySQL-compatible tenant of OceanBase Database Synchronize data from an IDB logical table to a DataHub instance Synchronize data from an Oracle database to a DataHub instance Synchronize data from a MySQL database to a DataHub instance Synchronize data from an ODP logical table to a physical table in a MySQL-compatible tenant of OceanBase Database View details of a data synchronization task Download and import the settings of synchronization objects View and modify the parameter configurations of a data synchronization task View and modify synchronization objects End and delete a data synchronization task Start and pause a data synchronization task Perform batch operations on data synchronization tasks Change the name of a data synchronization task Use tags to Manage data synchronization tasks Create a data validation task Overview View and modify validation objects View details of a data validation task Clone a data validation task Delete a data validation task Start, stop, and resume a data validation task Manage data validation tasks by using tags Import validation objects Change the name of a data validation task View and modify validation parameters
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & CertificationTicket
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Migration Service
  3. V4.3.2
iconOceanBase Migration Service
V 4.3.2Enterprise Edition
Databases
  • OceanBase Database
  • OceanBase Cloud
  • OceanBase Tugraph
  • Interactive Tutorials
  • OceanBase Best Practices
Tools
  • OceanBase Cloud Platform
  • OceanBase Migration Service
  • OceanBase Developer Center
  • OceanBase Migration Assessment
  • OceanBase Admin Tool
  • OceanBase Loader and Dumper
  • OceanBase Deployer
  • Kubernetes operator for OceanBase
  • OceanBase Diagnostic Tool
  • OceanBase Binlog Service
Connectors and Middleware
  • OceanBase Database Proxy
  • Embedded SQL in C for OceanBase
  • OceanBase Call Interface
  • OceanBase Connector/C
  • OceanBase Connector/J
  • OceanBase Connector/ODBC
  • OceanBase Connector/NET
Enterprise Edition
  • V 4.3.2
  • V 4.3.1
  • V 4.3.0
  • V 4.2.5
  • V 4.2.4
  • V 4.2.3
  • V 4.0.2
  • V 3.4.0
Community Edition
  • V 4.2.13
  • V 4.2.12
  • V 4.2.11
  • V 4.2.10
  • V 4.2.9
  • V 4.2.8
  • V 4.2.7
  • V 4.2.6
  • V 4.2.5
  • V 4.2.4
  • V 4.2.3
  • V 4.2.1
  • V 4.2.0
  • V 4.0.0
  • V 3.3.1

Configure matching rules for validation objects

Last Updated:2026-04-01 02:56:22  Updated
Share
What is on this page
Background information
Limitations
Considerations
Configure a matching rule

folded

Share

This topic describes the background information, limitations, and configuration methods of matching rules for validation objects.

Background information

When you create a data validation task, you can specify the validation objects by specifying objects, importing a CSV file, or configuring matching rules. When you configure matching rules, you can specify the validation objects by using wildcard rules and configure the object mapping logic between the source and the target. This way, you can easily and efficiently match the validation objects, thereby reducing the configuration complexity when you have a large number of validation objects.

The following table describes the wildcard rules supported for data validation.

Category
Supported wildcard rule
Example
Description
Consistent source and target tables *.* kd_test*.person* Verifies all tables in all databases that start with person in the source/target database that starts with kd_test.
Consistent source and target tables *.<source table> kd_test*.person Verifies all tables named person in all databases that start with kd_test in the source/target database that starts with kd_test.
Consistent source and target tables <source database>.* kd_test.person* Verifies all tables in the database named kd_test in the source/target database that start with person.
Consistent source and target tables <source database>.<source table> kd_test.person Verifies the table named person in the database named kd_test in the source/target database.
Renamed source and target tables <source database>.<source table>=<target database>.<target table> kd_test.person=kd_test_new.person_new Verifies the table named person in the database named kd_test in the source database with the table named person_new in the database named kd_test_new in the target database.
Renamed source and target tables <source database>.*=<target database>.* kd_test.person*=kd_test_new.person* Verifies all tables that start with person in the database named kd_test in the source database with all tables that start with person in the database named kd_test_new in the target database.
Renamed source and target tables *.<source table>=*.<target table> kd_test*.person=kd_test_new*.person_new Verifies all tables named person in all databases that start with kd_test in the source database with all tables named person_new in all databases that start with kd_test_new in the target database.
Aggregated source and target tables <source database>.*=<target database>.<target table> kd_test.person*=kd_test.person_all Verifies all tables that start with person in the database named kd_test in the source database with the table named person_all in the database named kd_test in the target database.
Aggregated source and target tables *.<source table>=<target database>.<target table> kd_test*.person=kd_test_all.person Verifies all tables named person in all databases that start with kd_test in the source database with the table named person in the database named kd_test_all in the target database.
Aggregated source and target tables *.*=<target database>.<target table> kd_test*.person*=kd_test_all.person_all Verifies all tables that start with person in all databases that start with kd_test in the source database with the table named person_all in the database named kd_test_all in the target database.
Aggregated source and target tables *.*=<target database>.* kd_test*.person*=kd_test_all.person* Verifies all tables that start with person in all databases that start with kd_test in the source database with all tables that start with person in the database named kd_test_all in the target database.
Aggregated source and target tables *.*=*.<target table> kd_test*.person*=kd_test*.person_all Verifies all tables that start with person in all databases that start with kd_test in the source database with all tables named person_all in all databases that start with kd_test in the target database.

The following rules apply to wildcard rules:

  • The target database name and table name cannot both use wildcard rules. For example, kd_test*.person*=kd_test*.person*.

  • If both the source and target databases use wildcard rules, the database-level expressions must be exactly the same.

  • If both the source and target tables use wildcard rules, the table-level expressions must be exactly the same.

  • If the target database uses a wildcard rule, the source database must use a wildcard rule.

  • If the target table uses a wildcard rule, the source table must use a wildcard rule.

Limitations

  • You can specify multiple rules for data validation. However, each rule must not contain line breaks or spaces.

  • The validation object rule cannot be empty, but the object exclusion rules can be empty.

  • When you select a validation object by using a matching rule, the table name cannot contain special characters (spaces, line breaks, or .|"'`()=;/&*?[][!]).

  • Data validation does not support mapping tables in the same database at the source to different databases at the target by using multiple matching rules. For example, a.a* = b.a* & a.b* = c.b*.

Considerations

  • After you configure the validation object rules and the object exclusion rules, if the source table name is in the difference set between the validation object rule and the object exclusion rules, the object can be selected.

    Note

    The difference set is a new set that contains all elements that exist in the first set but do not exist in the second set.

  • If a table is configured with a renaming mapping rule, the renaming is prioritized. For example, if both a.b[0-3] and a.b[3-5]=a.c exist, the table a.b3 is renamed to a.c.

Configure a matching rule

  1. Create a data validation task and configure it to the Select Type & Objects step.

    For more information, see Create a data validation task.

  2. In the Select Type & Objects step, select the validation type and validation object.

    You can select validation objects through two methods: Specify Objects and Match by Rule. This topic describes how to configure a matching rule.

    1. In the Validation Objects section, select Match by Rule.

    2. Enter Validation Object Rule and Object Exclusion Rules (optional). For more information about supported wildcard patterns, see Wildcards.

    3. Click Verify.

      After the validation is completed, you can click Preview to view the matching result. The wildcard validation object rules and the object exclusion rules that you specify apply only to tables. Matching Results contains the final objects, added objects, and reduced objects.

      Objects
      Description
      Final The validation object that is finally matched by the configured matching rule.
      Added The validation object that is newly added in the final matching result compared with the matching result configured in the previous step.
      Reduced The validation object that is reduced in the final matching result compared with the matching result configured in the previous step.
  3. Complete the subsequent task configuration as prompted.

Previous topic

Configure matching rules for migration or synchronization objects
Last

Next topic

Wildcard patterns supported for matching rules
Next
What is on this page
Background information
Limitations
Considerations
Configure a matching rule