动态构建Azure SQL查询：Spring生态及替代方案咨询

Spring 内置可选方案 #

• Spring Data JPA Specifications + Criteria API
  虽然Spring Data JPA默认偏向静态查询，但结合CriteriaBuilder和CriteriaQuery可以实现高度动态的查询构造，无需预先定义投影接口。你可以灵活指定查询列、关联表和查询条件：

  CriteriaBuilder cb = entityManager.getCriteriaBuilder();
  CriteriaQuery<Object[]> query = cb.createQuery(Object[].class);
  Root<Order> orderRoot = query.from(Order.class);
  
  // 动态关联表
  Join<Order, Customer> customerJoin = orderRoot.join("customer", JoinType.INNER);
  // 动态选择查询列
  query.select(cb.array(orderRoot.get("id"), customerJoin.get("name")));
  // 动态添加过滤条件
  Predicate statusCondition = cb.equal(orderRoot.get("status"), "PAID");
  query.where(statusCondition);
  
  List<Object[]> results = entityManager.createQuery(query).getResultList();
  

  缺点是需要手动处理结果映射，但胜在属于Spring生态原生方案，无需额外引入依赖。

• Spring JDBC Template / NamedParameterJdbcTemplate
  完全基于原生JDBC的方式，自由度最高，能直接动态拼接SQL语句来控制查询列、表关联和条件：

  StringBuilder sql = new StringBuilder("SELECT ");
  // 动态注入选中的列
  sql.append(String.join(",", selectedColumns));
  sql.append(" FROM orders o INNER JOIN customers c ON o.customer_id = c.id");
  
  // 动态添加过滤条件
  List<Object> params = new ArrayList<>();
  if (StringUtils.hasText(status)) {
      sql.append(" WHERE o.status = ?");
      params.add(status);
  }
  
  List<Map<String, Object>> results = jdbcTemplate.queryForList(sql.toString(), params.toArray());
  

  注意用占位符避免SQL注入，适配Azure SQL只需保证SQL语法符合其规范即可。

替代工具库（除JOOQ外） #

• QueryDSL
  支持类型安全的动态查询，和JOOQ定位类似，可灵活指定查询列、表关联，无需预定义投影。它支持JPA、JDBC等多数据源，适配Azure SQL可通过配置对应的SQL方言实现，能自动生成符合Azure SQL语法的查询语句。

• MyBatis Dynamic SQL
  MyBatis的动态SQL特性天生适合动态查询场景，不管是XML还是注解方式，都能轻松拼接查询列、表关联和条件。适配Azure SQL只需在配置中指定对应的方言即可，上手成本低，生态成熟。

适配Azure SQL Dialect的关键注意点 #

• 方言配置：Spring Data JPA可指定spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.SQLServer2012Dialect（Azure SQL兼容SQL Server方言）；JOOQ新版本已支持专门的AzureSQLDialect，旧版本可复用SQLServerDialect。
• 语法适配：手动拼接SQL时注意Azure SQL特有的语法，比如分页用OFFSET ... FETCH NEXT ...而非LIMIT，工具库一般会自动处理这类差异。

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