mykit-db-sync 数据库同步工具使用教程

项目介绍

mykit-db-sync 是一个基于 Java 开发的功能强大、配置灵活的数据库同步工具。它支持 MySQL、SQL Server 和 Oracle 数据库之间的数据同步。该工具旨在解决手工操作效率低、容易遗漏或出错、难以应对频繁变更数据表或字段等问题，从而将人力从重复、无意义的工作中解脱出来。

项目快速启动

环境准备

• Java 8 或更高版本
• 支持的数据库：MySQL、SQL Server、Oracle

克隆项目

git clone https://github.com/sunshinelyz/mykit-db-sync.git

配置数据库连接

在项目目录中找到 config 文件夹，编辑 application.properties 文件，配置源数据库和目标数据库的连接信息。

# 源数据库配置
source.db.url=jdbc:mysql://localhost:3306/source_db
source.db.username=root
source.db.password=123456

# 目标数据库配置
target.db.url=jdbc:mysql://localhost:3306/target_db
target.db.username=root
target.db.password=123456

运行项目

使用 Maven 构建并运行项目：

mvn clean install
java -jar target/mykit-db-sync-1.0.0.jar

应用案例和最佳实践

案例一：定期同步两个 MySQL 数据库

假设有两个 MySQL 数据库 db1 和 db2，需要定期将 db1 的数据同步到 db2。

1. 配置 application.properties：

# db1 配置
source.db.url=jdbc:mysql://localhost:3306/db1
source.db.username=root
source.db.password=123456

# db2 配置
target.db.url=jdbc:mysql://localhost:3306/db2
target.db.username=root
target.db.password=123456

2. 设置定时任务，例如每天凌晨 2 点执行同步：

import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class SyncScheduler {
    @Scheduled(cron = "0 0 2 * * ?")
    public void syncData() {
        // 调用同步方法
    }
}

案例二：实时同步 Oracle 数据库到 MySQL

假设有一个 Oracle 数据库 oracle_db 和一个 MySQL 数据库 mysql_db，需要实时同步数据。

1. 配置 application.properties：

# oracle_db 配置
source.db.url=jdbc:oracle:thin:@localhost:1521:xe
source.db.username=system
source.db.password=oracle

# mysql_db 配置
target.db.url=jdbc:mysql://localhost:3306/mysql_db
target.db.username=root
target.db.password=123456

2. 使用 Logminer 实现实时同步：

import org.springframework.stereotype.Component;

@Component
public class RealTimeSync {
    public void startSync() {
        // 启动 Logminer 实时同步
    }
}

典型生态项目

mykit-db-common

提供通用的工具类，用于支持数据库同步过程中的各种通用操作。

mykit-db-transfer

实现 MySQL 和 SQL Server 数据库之间的数据互传功能，支持表结构变化的传输。

mykit-db-oracle

基于 Logminer 实现 Oracle 数据库之间的数据传输，支持表结构变化的传输。

通过这些模块的组合使用，可以构建出适应不同场景的数据库同步解决方案。