Apache Ignite JDBC驱动详解：轻量级分布式SQL访问方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00224/article/details/148523959

Apache Ignite JDBC驱动详解：轻量级分布式SQL访问方案

ignite Apache Ignite 项目地址: https://gitcode.com/gh_mirrors/ignite16/ignite

概述

Apache Ignite作为一个分布式内存计算平台，提供了完整的SQL查询能力。通过JDBC驱动，开发者可以使用标准SQL语句（如SELECT、INSERT、UPDATE、DELETE）直接操作分布式数据。Ignite目前支持两种JDBC驱动：轻量级的JDBC Thin驱动和基于客户端节点的JDBC Client驱动。本文将重点介绍JDBC Thin驱动的使用方法和最佳实践。

JDBC Thin驱动架构

JDBC Thin驱动是Ignite提供的默认轻量级驱动，只需将ignite-core-{version}.jar添加到应用类路径即可使用。其工作流程如下：

驱动连接到集群中的一个节点
所有查询被转发到该节点执行
节点负责查询分发和结果聚合
最终结果返回给客户端应用

这种架构简化了客户端部署，同时保持了分布式查询能力。

连接字符串配置

JDBC连接字符串支持两种格式：URL查询参数格式和分号分隔格式。

基本语法

// URL查询参数格式
jdbc:ignite:thin://<主机和端口范围0>[,<主机和端口范围1>]...[/schema][?参数1=值1&参数2=值2...]

// 分号分隔格式  
jdbc:ignite:thin://<主机和端口范围0>[,<主机和端口范围1>]...[;schema=模式名][;参数1=值1]...

其中：

主机：必需，集群节点主机地址
端口范围：格式为port_from..port_to，默认10800
模式：要访问的数据库模式，默认为PUBLIC
参数：可选配置参数

连接示例

// 基本连接
Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50");

// 带认证的连接
Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50;user=myUser;password=myPass");

// 启用分布式连接
Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50?distributedJoins=true");

关键配置参数

| 参数 | 描述 | 默认值 | |------|------|--------| | user | SQL连接用户名 | ignite | | password | SQL连接密码 | ignite | | distributedJoins | 是否启用非共置分布式连接 | false | | enforceJoinOrder | 是否强制保持查询中的表连接顺序 | false | | collocated | 当GROUP BY主键或关联键时设为true可优化性能 | false | | partitionAwareness | 启用分区感知(实验性功能) | false | | sslMode | SSL模式(require/disable) | disable |

高级特性

多端点连接

通过指定多个节点地址，驱动可实现自动故障转移：

Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50,192.168.0.51..192.168.0.55");

驱动会随机选择地址连接，失败时自动尝试其他地址。

分区感知（实验性）

分区感知让驱动能识别数据分区位置，直接将查询发送到数据所在节点：

Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50,192.168.0.51;partitionAwareness=true");

注意事项：

需提供所有服务器节点地址
新节点加入需重新连接
目前仅支持默认关联函数

集群端配置

节点通过ClientConnectorConfiguration配置JDBC连接：

<bean class="org.apache.ignite.configuration.IgniteConfiguration">
  <property name="clientConnectorConfiguration">
    <bean class="org.apache.ignite.configuration.ClientConnectorConfiguration">
      <property name="port" value="10800"/>
      <property name="portRange" value="100"/>
    </bean>
  </property>
</bean>

关键参数包括端口范围、线程池大小、空闲超时等。

SSL安全连接

配置SSL需要集群端和驱动端同时设置：

Connection conn = DriverManager.getConnection(
    "jdbc:ignite:thin://192.168.0.50?sslMode=require" +
    "&sslClientCertificateKeyStoreUrl=client.jks" +
    "&sslClientCertificateKeyStorePassword=123456" +
    "&sslTrustCertificateKeyStoreUrl=trust.jks" +
    "&sslTrustCertificateKeyStorePassword=123456");