GaussDB Linux下配置数据源

GaussDB Linux下配置数据源

ODBC连接数据库之前需要准备好所需资源。连接数据库是通过配置ODBC数据源，使用ODBC API或者相应的驱动程序，实现应用程序与数据库之间的通信和交互。本节介绍如何在Linux系统下配置数据源并连接到数据库。

操作步骤

安装unixODBC（默认unixODBC源码包已在环境准备中获取）。如果机器上已经安装了其他版本的unixODBC，可以直接覆盖安装。
以unixODBC-2.3.7版本为例，在客户端执行如下命令安装unixODBC。
tar zxvf unixODBC-2.3.7.tar.gz
cd unixODBC-2.3.7

./configure --enable-gui=no #如果要在ARM服务器上编译，请追加一个configure参数： --build=aarch64-unknown-linux-gnu 
make

安装可能需要root权限

make install

说明：
目前不支持unixODBC-2.2.1版本。
默认安装到“/usr/local”目录下，生成数据源文件到 “/usr/local/etc”目录下，库文件生成在“/usr/local/lib”目录。
通过编译带有--enable-fastvalidate=yes选项的unixODBC来获得更高性能。但此选项可能会导致向ODBC API传递无效句柄的应用程序发生故障，而不是返回SQL_INVALID_HANDLE错误。
替换客户端GaussDB驱动程序。
将GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Odbc.tar.gz解压。解压后会得到两个文件夹：lib与odbc，在odbc文件夹中还会有一个lib文件夹。将解压后得到的/lib文件夹与/odbc/lib文件夹中的所有动态库都复制到“/usr/local/lib”目录下。

配置数据源。
配置ODBC驱动文件。
在“/usr/local/etc/odbcinst.ini”文件中追加以下内容。

[GaussMPP]
Driver64=/usr/local/lib/gsqlodbcw.so
setup=/usr/local/lib/gsqlodbcw.so

odbcinst.ini文件中的配置参数说明如表1所示。

配置数据源文件。
在“/usr/local/etc/odbc.ini”文件中追加以下内容。

[gaussdb]
Driver=GaussMPP
Servername=127.0.0.1 #数据库Server IP
Database=db1  #数据库名
Username=omm  #数据库用户名
Password=  #数据库用户密码
Port=8000  #数据库侦听端口
Sslmode=allow

在客户端配置环境变量。
vim ~/.bashrc

在配置文件中追加以下内容。

export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
export ODBCSYSINI=/usr/local/etc
export ODBCINI=/usr/local/etc/odbc.ini

执行如下命令使设置生效。

source ~/.bashrc

测试连接。
安装后/usr/bin下面会存放生成的二进制，可执行isql -v gaussdb（数据源名称）命令。

如果显示如下信息，表明配置正确，连接成功。

+---------------------------------------+
| Connected!                            |
|                                       |
| sql-statement                         |
| help [tablename]                      |
| quit                                  |
|                                       |
+---------------------------------------+

若显示ERROR信息，则表明配置错误。请检查上述配置步骤是否正确执行。
若是集群环境，需要在所有机器上都复制配置一份unixODBC。