编写连接字符串

ODBC连接字符串由形如key=value的键值对构成，多个键值对以英文分号（;）分隔。虚谷ODBC连接串支持的参数见本文档第四章注册数据源参数说明，此表格中列举了所有驱动支持的属性名及取值。若在连接串中填写了除此之外的属性，驱动将其忽略。若部分属性未填写，驱动将使用默认值。连接串中的属性除了传递到驱动中以实现差异性的功能外，还有部分属性在连接数据库前发挥重要作用，它们分别是DSN、Driver和FileDSN。驱动管理器管理各种ODBC驱动，驱动管理器正是通过上述三个属性实现了应用程序和对应驱动的映射。所以连接串可以有三种写法，如下所示：

• DSN=XuguDB;UID= SYSDBA;PWD= SYSDBA
• Driver=XuguSQL 11.2;Server=127.0.0.1;Port=5138;UID=SYSDBA;PWD=SYSDBA
• FileDSN=C:\ XuguDB.dsn

使用DSN属性则需要先配置DSN，DSN中包含驱动名等其它所有属性。若DSN中属性完整，则连接串仅需 DSN=XuguDB即可，若此时连接串中提供了其它驱动支持的属性，则驱动使用连接串中提供的属性。

使用Driver属性则无需配置DSN，Driver指定驱动名，所有需要的属性均需填写至连接串。

使用FileDSN则需要先配置文件DSN，文件DSN与DSN类似，文件DSN中包含驱动名等其它所有属性。若文件DSN中属性完整，则连接串仅需 FileDSN=C:\ XuguDB.dsn 即可，若此时连接串中提供了其它驱动支持的属性，则驱动使用连接串中提供的属性。

说明：

虚谷ODBC驱动为SQLDriverConnect提供了配置文件，配置文件由换行符分隔的形如key=value的键值对构成。配置文件支持的属性与连接串完全相同。配置文件中的属性拥有最高的优先级，若配置文件存在，SQLDriverConnect将使用配置文件中提供的属性值。在Windows下，驱动在C:\和D:\搜索xuguodbc.cfg；在 Linux下，驱动在用户目录搜索.xuguodbc.cfg。