#ODBC驱动安装（Linux）

本文以Centos 7.3.1为例，介绍YashanDB ODBC驱动在该环境下的安装配置过程。

# 步骤1：安装unixODBC

yum install unixODBC-devel
yum install unixODBC

# 步骤2：下载C驱动安装包

参考YashanDB软件包清单获取YashanDB客户端安装包。
将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。安装包解压后可得到以下文件夹：
- bin：C驱动的可执行文件（目前包括yasql）。
- include：C驱动的头文件。
- lib：C驱动的库文件。

# 步骤3：设置动态库依赖路径

将/home/yasdb-driver-c/lib设置到Linux LD_LIBRARY_PATH中，具体操作为：

编辑bashrc文件：
```
vi ~/.bashrc
```

新起一行增加LD_LIBRARY_PATH搜索路径：

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/yasdb-driver-c/lib

保存并退出。
刷新系统变量配置。
```
source ~/.bashrc
```

# 步骤4：安装ODBC驱动

参考YashanDB软件包清单获取YashanDB ODBC驱动安装包。
将ODBC驱动安装包下载并解压到本地路径，例如/home/yashandb_odbc/。

安装ODBC驱动（so路径仅为示例，请使用实际的libyas_odbc.so路径）。

vi /etc/odbcinst.ini

[YashanDB]
Description     = ODBC for YashanDB
Driver          = /home/yashandb_odbc/libyas_odbc.so
Setup           = /home/yashandb_odbc/libyas_odbc.so
Driver64        = /home/yashandb_odbc/libyas_odbc.so
Setup64         = /home/yashandb_odbc/libyas_odbc.so
FileUsage       = 1

# 步骤5：配置数据源

vi /etc/odbc.ini

[YASTEST]
Description  = YashanTest
Driver       = YashanDB
SERVER       = 127.0.0.1
PORT         = 1688
USER         = sys
PWD          = sys

此处可进行字符集设置（前提是使用ANSI驱动，linux默认ANSI ODBC字符集是UTF8），可使用以下数据源配置设置字符集：

# 目前支持的字符集有：ASCII、ISO88591、GBK、UTF8、UTF16、GB18030
CHARACTER_SET = UTF8

# 步骤6：测试连接

# yastest是数据源的名称
isql yastest -v
# 查看数据源名称
odbcinst -q -s
# 查看驱动名称
odbcinst -q -d
# 查看驱动配置
odbcinst -j

# 步骤7：（可选）使用yasodbc自带test程序测试连接

执行yasodbctest，这里的yastest代表数据源名称。

./yasodbctest yastest sys sys
# 或者
./yasodbctest yastest

使用exit退出。