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

Note:

YashanDB ODBC驱动依赖C基础开发库，因此应用端还需安装C编译工具，例如gcc、visual studio等。

步骤1：安装YashanDB C驱动

下载C驱动安装包

1. 从YashanDB官网下载中心 (opens new window)，或者联系我们的技术支持获取对应的软件包。

2. 将YashanDB客户端安装包下载并解压到本地路径，例如/home/yasdb-driver-c/。

   安装包解压后可得到C驱动所需文件：

   • C驱动的头文件：位于include文件夹中。

   • C驱动的库文件：位于lib文件夹中。

设置环境变量

将C驱动的库文件所在文件夹设置到Windows环境变量PATH中，具体操作为：

1. 右键单击系统桌面上的【此电脑】图标，选择【属性】。

2. 单击【高级系统设置】。

3. 单击【环境变量】。

4. 在【系统变量】区域，选中【Path】项，单击下方的【编辑】。

5. 单击【新建】，输入C驱动的库文件所在文件夹，例如D:\yasdb-driver-c\lib。

6. 单击【确定】保存配置。

步骤2：安装YashanDB ODBC驱动

1. 从YashanDB官网下载中心 (opens new window)，或者联系我们的技术支持获取对应的软件包。

2. 将ODBC驱动安装包下载并解压到本地路径，例如D:\yasdb-driver-odbc。

3. 确认install.bat、uninstall.bat和yas_odbc.dll在相同路径下。

   D:\yasdb-driver-odbc>dir
   2022/11/10  10:18    <DIR>          .
   2022/11/10  10:18    <DIR>          ..
   2022/11/09  05:43             1,041 install.bat
   2022/11/09  05:43               183 README.md
   2022/11/09  05:43               181 uninstall.bat
   2022/11/09  05:43            41,984 yasodbctest.exe
   2022/11/09  05:43           144,896 yas_odbc.dll
   

4. 运行install.bat，此操作需以管理员身份运行，如下：

   

5. 成功后按任意键退出安装。

步骤3（可选）：检查依赖项（32位）

仅在安装32位驱动时，需要执行本操作。

1. 检查C:\Windows\SysWOW64文件夹中是否包含32位的ucrtbased.dll和vcruntime140d.dll。

   • 若无，需先自行获取ucrtbased.dll和vcruntime140d.dll文件并保存至C:\Windows\SysWOW64文件夹中，例如可以通过安装Visual Studio等方式获取。

   • 若有，则可直接执行后续操作。

步骤4：配置数据源

通过Windows自带的ODBC数据源管理器进行YashanDB ODBC数据源配置。

1. 进入ODBC数据源管理器，添加用户数据源。

   • 64位：【控制面板 > 系统和安全 > 管理工具 > ODBC数据源管理程序（64位）】，此处以64位为例。

   • 32位：【控制面板 > 系统和安全 > 管理工具 > ODBC数据源管理程序（32位）】

   

​ 仅当成功安装YashanDB ODBC驱动后才会出现YashanDB选项。

2. 填写数据源信息。

   

   参数说明：

   • Data Source Name：ODBC数据源名称，唯一标识一个数据源 （必填项）

   • Description：数据源描述，等价于注释（选填项）

   • Server：数据源所在连接IP地址，即服务端IP地址（选填项）

   • Port：数据源端口，即服务端当前监听的IP端口（选填项）

   • Url：数据源的完整URL（选填项，配置URL参数后，Server和Port参数将不会再生效），URL格式如下：
     * 单IP： host:port[/pdb_name]
     * 多IP：serverType:host:port,host:port,host:port,host:port[/pdb_name]，多个地址间采用,分隔，连接时根据serverType配置对相应节点进行轮询连接。
     * 多IP组：serverType:host:port,host:port;host:port,host:port[/pdb_name]，多个IP组间采用;分隔，连接时先在组内根据serverType配置对相应节点进行轮询连接，当组内所有连接均失败后按顺序优先级（越靠前优先级越高）访问下一组。
     参数含义：
     * host:port[/pdb_name]：服务端的监听地址，如需连接部署为容器数据库的YashanDB时，必须使用v23.5.1.100及以上版本的ODBC驱动并指定正确的目标容器名称，省略则默认连接至根容器。
     * serverType：连接模式，可选项包括[primary|standby|loadBalance|primaryLoadBalance|standbyLoadBalance]。

   • User Name：当前连接用户（选填项）

   • PassWord：当前连接密钥（选填项）

   按钮说明：

   • OK：保存当前数据源信息，具体保存地址可见注册表：HKEY_CURRENT_USER\SOFTWARE\ODBC\ODBC.INI。

   • Cancel：取消当前所有修改。

   • Test Connection：测试当前连接，测试结果会弹出对话框提示。

3. 单击【OK】保存数据源信息，后续如需修改，单击【配置】即可修改当前数据源信息。

4. 单击【Test Connection】且测试连接正常后，表示安装完成。

   用户即可开始使用YashanDB ODBC驱动开发自己的客户端程序。