如何使用SQLcl Bridge命令连接H2数据库并迁移指定表数据

1. 先确保SQLcl能加载H2 JDBC驱动 #

SQLcl默认仅内置Oracle驱动，必须手动添加H2驱动包：

• 下载对应版本的h2.jar
• 将jar包放到SQLcl安装目录的lib子文件夹，或启动SQLcl时通过-cp参数指定驱动路径：

  sql -cp /path/to/h2.jar oracle_username/oracle_password@oracle_db_address
  

2. 正确构造Bridge命令的H2连接参数 #

SQLcl的Bridge命令有固定格式，不能直接照搬H2的JDBC URL，需明确指定驱动类、连接地址、用户名和密码：

-- 创建基于文件存储的H2桥接连接（推荐测试用，避免内存模式会话丢失数据）
CREATE BRIDGE H2_FILE_CONN
  DRIVER 'org.h2.Driver'
  URL 'jdbc:h2:file:./local_h2_demo'
  USER 'sa' -- H2默认用户名
  PASSWORD ''; -- H2默认密码为空

如果用内存模式测试，需添加参数防止会话关闭时数据库销毁：

CREATE BRIDGE H2_MEM_CONN
  DRIVER 'org.h2.Driver'
  URL 'jdbc:h2:mem:test;DB_CLOSE_DELAY=-1'
  USER 'sa'
  PASSWORD '';

3. 使用Bridge复制表数据 #

连接成功后，可通过COPY命令同步Oracle表到H2：

-- 复制单张表
COPY EMPLOYEE TO BRIDGE H2_FILE_CONN.EMPLOYEE;

-- 批量复制指定表（用SQLcl循环语法处理20张表）
BEGIN
  FOR tbl IN (SELECT table_name FROM user_tables WHERE table_name IN ('EMPLOYEE','DEPARTMENT','...')) LOOP
    EXECUTE IMMEDIATE 'COPY ' || tbl.table_name || ' TO BRIDGE H2_FILE_CONN.' || tbl.table_name;
  END LOOP;
END;
/

4. 常见错误排查 #

• 语法错误：检查Bridge命令的关键字（DRIVER/URL/USER等）是否规范，确保字符串用单引号包裹。
• 凭据无效：确认H2的用户名和密码是否匹配（默认sa/空密码），若修改过默认配置需对应调整。
• 驱动找不到：验证h2.jar已被SQLcl加载，启动时无"找不到驱动类"的报错。

5. 额外优化建议 #

• 万级数据量的表，复制前可关闭H2的约束检查（SET REFERENTIAL_INTEGRITY FALSE;），完成后再开启，提升同步效率。
• 若Oracle表包含CLOB/BLOB等复杂类型，提前确认H2的类型映射支持，必要时手动指定字段类型。

内容的提问来源于stack exchange，提问作者metatron