Apache Ignite ODBC驱动使用指南

Apache Ignite ODBC驱动使用指南

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

概述

Apache Ignite作为一个分布式内存计算平台，提供了ODBC驱动支持，允许开发者通过标准SQL查询和原生ODBC API来访问和修改分布式缓存中的数据。本文将全面介绍Ignite ODBC驱动的配置、构建、安装和使用方法。

核心特性

Ignite ODBC驱动具有以下关键特性：

• 实现了ODBC 3.0 API规范
• 支持标准SQL语法
• 通过TCP协议与集群通信
• 提供线程安全连接
• 支持Windows和Linux平台

集群端配置

在Ignite集群端，需要通过ClientConnectorConfiguration来配置ODBC连接参数。以下是关键配置项及其说明：

| 参数名称 | 描述 | 默认值 | |---------|------|-------| | host | 绑定的主机名或IP地址 | null (localhost) | | port | 绑定的TCP端口 | 10800 | | portRange | 端口尝试范围 | 100 | | maxOpenCursorsPerConnection | 单个连接最大游标数 | 128 | | threadPoolSize | 请求处理线程数 | MAX(8, CPU核心数) | | socketSendBufferSize | TCP发送缓冲区大小 | 0 (系统默认) | | socketReceiveBufferSize | TCP接收缓冲区大小 | 0 (系统默认) | | tcpNoDelay | 是否启用TCP_NODELAY | true | | idleTimeout | 客户端空闲超时时间(毫秒) | 0 (禁用) | | isOdbcEnabled | 是否启用ODBC访问 | true |

配置示例（Java方式）：

IgniteConfiguration cfg = new IgniteConfiguration();
ClientConnectorConfiguration clientConnectorCfg = new ClientConnectorConfiguration();

clientConnectorCfg.setHost("127.0.0.1");
clientConnectorCfg.setPort(12345);
clientConnectorCfg.setPortRange(2);
clientConnectorCfg.setMaxOpenCursorsPerConnection(512);

cfg.setClientConnectorConfiguration(clientConnectorCfg);

线程安全说明

当前版本的Ignite ODBC驱动在连接级别提供线程安全保证。这意味着：

• 不应在多个线程中共享同一连接而不进行额外同步
• 可以为每个线程创建独立连接并同时使用

构建ODBC驱动

Windows平台构建

前置条件：

• MS Visual C++ 10.0或更高版本
• OpenSSL (32位或64位)
• CMake 3.6+
• WiX Toolset

构建步骤：

1. 进入%IGNITE_HOME%\platforms\cpp目录
2. 执行以下命令之一：

64位驱动：

mkdir cmake-build-release-64
cmake .. -DWITH_CORE=OFF -DWITH_ODBC=ON -DWITH_ODBC_MSI=ON -DCMAKE_GENERATOR_PLATFORM=x64 -DOPENSSL_ROOT_DIR=<openssl 64-bit install dir> -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=..\install\amd64
cmake --build . --target install --config Release

32位驱动：

mkdir cmake-build-release-32
cmake .. -DWITH_CORE=OFF -DWITH_ODBC=ON -DWITH_ODBC_MSI=ON -DCMAKE_GENERATOR_PLATFORM=Win32 -DOPENSSL_ROOT_DIR=<openssl 32-bit install dir> -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=..\install\x86
cmake --build . --target install --config Release

构建完成后，安装包将生成在相应目录中。

Linux平台构建

前置条件：

• g++ 4.4.0或更高版本
• CMake
• UnixODBC

构建步骤：

cd ${CPP_BUILD_DIR}
cmake -DCMAKE_BUILD_TYPE=Release -DWITH_CORE=OFF -DWITH_ODBC=ON ${IGNITE_HOME}/platforms/cpp -DCMAKE_INSTALL_PREFIX=${CPP_INSTALL_DIR}
make
sudo make install

安装ODBC驱动

Windows安装

使用安装包：

1. 确保已安装Microsoft Visual C++ 2010 Redistributable Package
2. 运行对应版本的MSI安装包：
   • 32位：ignite-odbc-x86.msi
   • 64位：ignite-odbc-amd64.msi

手动安装：

1. 将驱动DLL放置到选定目录
2. 确保所有依赖项可用
3. 运行安装脚本（需要管理员权限）

32位：

install_x86 <absolute_path_to_32_bit_driver>

64位：

install_amd64 <absolute_path_to_64_bit_driver> [<absolute_path_to_32_bit_driver>]

Linux安装

1. 检查依赖项：

ldd /usr/local/lib/libignite-odbc.so

2. 修改ignite-odbc-install.ini文件，确保Driver参数指向正确的驱动位置

3. 执行安装命令：

odbcinst -i -d -f ${IGNITE_HOME}/platforms/cpp/odbc/install/ignite-odbc-install.ini

使用建议

1. 性能调优：

   • 根据应用需求调整maxOpenCursorsPerConnection
   • 合理设置threadPoolSize以匹配服务器资源
   • 考虑启用tcpNoDelay减少延迟

2. 连接管理：

   • 为长时间空闲连接设置idleTimeout
   • 在高并发场景中，为每个线程创建独立连接

3. 平台选择：

   • 生产环境推荐使用64位驱动
   • 兼容性需求考虑同时安装32位和64位驱动

通过以上配置和使用方法，开发者可以充分利用Apache Ignite ODBC驱动实现高效的数据访问和操作。

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