JQuick-SQL 与关系型数据库集成：应用层读取后注册查询

Meta 描述：说明 jquick-sql 与 MySQL、PostgreSQL 等 RDBMS 的正确集成边界：应用层读取并映射为 JQuickDataSet，再使用 registerTable 查询。

标签：jquick-sql、RDBMS 集成、JDBC、Java 跨库查询、异构数据源联邦查询、JQuickDataSet、轻量级 SQL 引擎

官网示例：

FORMULAS 示例页：https://www.jquick.org/jquick-sql

github 地址：https://github.com/paohaijiao/jquick-sql

前言

许多团队希望在已有 MySQL、PostgreSQL 或 Oracle 业务库之上增加统一分析能力。jquick-sql 可以承担注册数据集上的 SQL 计算，但它本身不提供 JDBC 数据库驱动、方言层或数据库直连 API。正确集成方式是复用应用已有 JDBC/ORM/DAO 能力取数，再映射为 jquick-sql 数据模型。

正确的 RDBMS 接入边界

应用层通过连接池、JDBC Template、ORM 或 jquick-connector 查询数据库，负责认证、事务、分页、超时和重试。随后将结果行转换为 JQuickRow，为字段建立 JQuickColumnMeta，组装为 JQuickDataSet 或直接通过列与行注册。

因此，jquick-sql 不会替代数据库，也不会自动执行远程 SQL 下推。它在内存中的已注册表上提供统一的 JOIN、过滤、聚合和排序能力。

跨库查询的低成本路径

当订单在一个库、客户在另一个库时，可分别在应用层拉取所需字段并注册为两张表，再在 jquick-sql 中关联。为控制成本，应只抽取分析窗口所需列和行，尽量在源库完成基础范围过滤，减少 JVM 内存压力。

跨库前还应统一主键类型、金额精度、时区和空值策略。SQL 层的结果正确性依赖这些前置口径。

查询刷新与一致性取舍

这种 Java 跨库查询方式适合运营报表、对账和临时分析，但不等价于分布式事务。若来源系统的更新时点不同，应将数据批次时间、提取条件和结果口径记录在应用日志或任务元数据中。

对实时性敏感的场景，可缩小读取窗口并增加刷新频率；对稳定维度，可缓存并按计划更新。

代码案例

java 复制代码

import com.github.paohaijiao.engine.JQuickSQL;
import com.github.paohaijiao.statement.JQuickColumnMeta;
import com.github.paohaijiao.statement.JQuickDataSet;
import com.github.paohaijiao.statement.JQuickRow;
import java.util.Arrays;
import java.util.List;

public class RdbmsIntegrationDemo {
    public static void main(String[] args) {
        // 伪代码：loadOrdersFromJdbc/loadCustomersFromJdbc 由应用层实现，
        // 并非 jquick-sql 的 JDBC API。
        List<JQuickRow> orderRows = Arrays.asList(
            row("customer_id", 1L, "amount", 500.0),
            row("customer_id", 2L, "amount", 240.0)
        );
        List<JQuickRow> customerRows = Arrays.asList(
            row("id", 1L, "region", "华东"),
            row("id", 2L, "region", "华南")
        );

        JQuickSQL sql = JQuickSQL.embedded();
        try {
            sql.registerTable("db_orders", Arrays.asList(
                new JQuickColumnMeta("customer_id", Long.class, "db_orders"),
                new JQuickColumnMeta("amount", Double.class, "db_orders")
            ), orderRows);
            sql.registerTable("db_customers", Arrays.asList(
                new JQuickColumnMeta("id", Long.class, "db_customers"),
                new JQuickColumnMeta("region", String.class, "db_customers")
            ), customerRows);

            JQuickDataSet result = sql.execute(
                "SELECT c.region, SUM(o.amount) AS revenue " +
                "FROM db_orders o JOIN db_customers c ON o.customer_id = c.id " +
                "GROUP BY c.region"
            );
            result.printTable();
        } finally {
            sql.shutdown();
        }
    }

    private static JQuickRow row(Object... values) {
        JQuickRow row = new JQuickRow();
        for (int i = 0; i < values.length; i += 2) row.put((String) values[i], values[i + 1]);
        return row;
    }
}

常见问题

**能否写 sql.registerJdbc(...)？**不能。项目没有这样的 jquick-sql 公共 API，JDBC 查询应由应用层或 jquick-connector 完成。

**能否直接 JOIN 两个远程数据库表？**不能直接连接。应先读取、转换并分别 registerTable。

**是否适合全库同步？**通常不适合。该模型更适合按分析需求提取必要数据集。

总结与拓展

RDBMS 集成的重点不是让 jquick-sql 替代 JDBC，而是用既有数据库访问层完成可靠取数，再用轻量级 SQL 引擎统一业务逻辑。这样既能保留现有运维体系，也能以较低成本构建异构数据源联邦查询流程。

Core Advantage

Keeps JDBC ownership in the application while providing one SQL layer over normalized datasets.

Applicable Scenarios

Cross-database reporting, reconciliation, post-query aggregation, and embedded analytics for existing Java systems.