安装 openGauss ODBC
安装包安装方式
1、下载对应平台的openGauss-5.0.1-ODBC(目前仅支持CentOS_x86_64、OpenEuler_aarch64、OpenEuler_x84_64)。
下载地址:https://opengauss.org/zh/download/
下载界面如下图所示。
2、替换客户端 openGauss 驱动程序
解压 openGauss-5.0.1-ODBC.tar.gz, 将解压后 lib 目录下的库拷贝到/usr/local/lib
目录下。
编译安装方式
1、下载ODBC驱动源码
地址如下:https://gitee.com/opengauss/openGauss-connector-odbc
2、修改configure文件如下(红色框为增加内容):
3、执行如下命令进行编译:
sh ./build.sh -bd $GAUSSHOME
4、解压output目录下的GaussDB-Kernel-XXX-odbc.tar.gz,然后将output/odbc/lib
目录下的库拷贝到/usr/local/lib
目录下。
配置环境变量
安装openGauss ODBC后,配置环境变量。
vim ~/.bashrc
在配置文件中添加以下内容。有关ODBCINI
的详细信息,请参见下文配置数据源章节。
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
export ODBCSYSINI=/usr/local/etc
export ODBCINI=/usr/local/etc/odbc.ini
执行以下命令使配置生效。
source ~/.bashrc
配置驱动文件
1、配置 ODBC 驱动文件。 在“/usr/local/etc/odbcinst.ini” 文件中添加以下内容。
vim /usr/local/etc/odbcinst.ini
内容 | 说明 |
---|---|
[VastbaseMPP] | # 驱动器名称, 对应数据源 DSN 中的驱动名 |
Driver64=/usr/local/lib/psqlodbcw.so | # 驱动动态库的路径 |
setup=/usr/local/lib/psqlodbcw.so | # 驱动安装路径, 与 Driver64 中动态库的路径一致 |
2、配置数据源文件,在 /usr/local/etc/odbc.ini
文件中添加以下内容。
该步骤并不是必须的,是否进行配置取决于获取连接的方式,详见连接数据库 章节。
内容 | 说明 |
---|---|
[Test] Description=Test Driver=VastbaseMPP | # 数据源的名称 # 数据源说明 # 驱动名, 对应 odbcinst.ini 中的 DriverName |
Servername=172.16.12.57 | # 服务器的 IP 地址 |
Database=postgres Username=yuntu | # 要连接的数据库的名称 # 数据库用户名称 |
Password= Ttest@123 | # 数据库用户密码 |
Port=5432 | # 服务器的端口号 |
Sslmode=allow | # 开启 SSL 模式: disable 否, allow 可能 , prefer 可能, requrie 是,verify-ca 是, verify-full 是 |
测试数据源配置
上述配置中该数据源的 DSN 为 Test,可以通过 isql 来验证配置是否正确,命令如下。
isql -v Test
如果数据源配置中未指定用户名和密码,则用 isql 测试连接时需要指定用户密码:
isql -v Test yuntu Ttest@123
如果显示以下信息,表示配置正确,连接成功。
如果显示查找不到psqlodbcw.so动态库,如图:
在确认动态库确实存在之后,该错误可能是由于当前机器上缺少odbc驱动库的依赖库造成的,可以使用ldd命令观察缺失的动态库后安装对应的依赖库。