连接信息部署

ODBC 客户端连接信息通常以 ODBC 数据源形式部署。您可以按照下列方式之一来部署 ODBC 数据源：

编程方式 将数据源的说明添加到最终用户的注册表或 ODBC 初始化文件中。
手动向最终用户提供说明，以便他们能够在自己的计算机上创建相应的数据源。
在 Windows 上，应使用 [ODBC 数据源管理器] 中的 [用户 DSN] 选项卡或 [系统 DSN] 选项卡手动创建数据源。SQL Anywhere ODBC 驱动程序显示用于输入设置的配置窗口。数据源设置包括数据库文件的位置、数据库服务器的名称以及任何启动参数和其它选项。可通过单击 [帮助] 按钮来访问上下文相关帮助。帮助文本是使用 sacshelp12.chm 在本地提供的。如果此文件不存在，则会使用系统的缺省 Internet 浏览器访问 DocCommentXchange，通过 Internet 来提供帮助。

在 Unix 平台上，可以使用 SQL Anywhere 的 dbdsn 实用程序来手动创建数据源。数据源设置包括数据库文件的位置、数据库服务器的名称以及任何启动参数和其它选项。

对于每种方式，本节都向您提供需要了解的信息。

数据源类型 (Windows)

有三种数据源：用户数据源、系统数据源和文件数据源。

用户数据源定义被存储在注册表的某个位置，其中包含当前登录到系统的特定用户的设置。
但是，系统数据源对于所有用户和 Windows 服务可用，无论用户是否登录到系统，Windows 服务都运行。给定一个名为 MyApp 的正确配置的系统数据源，任何用户都可以通过在 ODBC 连接字符串中提供 DSN=MyApp 来使用该 ODBC 数据源。
文件数据源不保留在注册表中，而是存储在磁盘上。连接字符串必须提供 FileDSN 连接参数才能使用文件数据源。文件数据源的缺省位置由 HKEY_CURRENT_USER\Software\ODBC\odbc.ini\ODBC File DSN\DefaultDSNDir 注册表条目或 HKEY_LOCAL_MACHINE\Software\ODBC\odbc.ini\ODBC File DSN\DefaultDSNDir 注册表条目（如果前者未定义）指定。路径可包括在 FileDSN 连接参数中，以便在文件数据源位于其它位置时定位该数据源。

数据源注册表条目 (Windows)

用户和系统数据源定义存储在 Windows 注册表中。确保可以为数据源定义创建正确的注册表条目最简单的方法是使用 SQL Anywhere dbdsn 实用程序进行创建。

否则，您必须在特定的注册表项中创建一组注册表值。

对于用户数据源，该注册表项如下所示：

HKEY_CURRENT_USER\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            user-data-source-name

对于系统数据源，该注册表项如下所示：

HKEY_LOCAL_MACHINE\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            system-data-source-name

该项包含一组注册表值，每个值都与一个连接参数相对应（Driver 字符串除外）。当使用 Microsoft ODBC 数据源管理器或 dbdsn 实用程序创建数据源时，Driver 字符串由 Microsoft ODBC 驱动程序管理器自动添加到注册表。例如，SQL Anywhere 12 Demo 项对应于包含以下设置（适用于 32 位 Windows）的 SQL Anywhere 12 Demo 系统数据源名称 (DSN)：

值的名称	值的类型	值的数据
AutoStop	字符串	YES
DatabaseFile	字符串	C:\Users\Public\Documents\SQL Anywhere 12\Samples\demo.db
Description	字符串	SQL Anywhere 12 Sample Database
Driver	字符串	C:\Program Files\SQL Anywhere 12\bin32\dbodbc12.dll
Password	字符串	sql
ServerName	字符串	demo12
StartLine	字符串	C:\Program Files\SQL Anywhere 12\bin32\dbeng12.exe
UserID	字符串	DBA

注意

建议在所部署应用程序的连接字符串中包含 ServerName 参数。这样可确保当计算机运行多个 SQL Anywhere 数据库服务器时，应用程序可连接到正确的服务器，并且还有助于防止出现与计时相关的连接故障。

在这些条目中，对于 64 位 Windows，bin32 应替换为 bin64。

在 64 位 Windows 上，只有一个用户数据源的注册表条目供 64 位和 32 位应用程序共享。对于这些数据源类型，建议删除 Driver 字符串中的路径。如果该路径指定 64 位 ODBC 驱动程序，则使用 Microsoft ODBC 驱动程序管理器时，经常连接/断开连接的 32 位应用程序将导致性能降低（以及内存泄漏）。类似地，如果该路径指定 32 位 ODBC 驱动程序，经常连接/断开连接的 64 位应用程序将导致类似的性能降低。在本书编写时，这是 Microsoft ODBC 驱动程序管理器中的一个缺陷。出于此原因，64 位 Windows 系统最好选择系统数据源。

另外，您必须将数据源名添加到注册表中的数据源列表中。对于用户数据源，使用以下注册表项：

HKEY_CURRENT_USER\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            ODBC Data Sources

对于系统数据源，使用以下项：

HKEY_LOCAL_MACHINE\
   SOFTWARE\
      ODBC\
         ODBC.INI\
            ODBC Data Sources

该值将每个数据源与一个 ODBC 驱动程序相关联。值的名称是数据源的名称，值的数据是 ODBC 驱动程序的名称。例如，由 SQL Anywhere 安装的系统数据源名为 SQL Anywhere 12 Demo，其值如下所示：

值的名称	值的类型	值的数据
SQL Anywhere 12 Demo	字符串	SQL Anywhere 12

小心

ODBC 数据源名称设置很方便查看。用户数据源配置可以包含敏感的数据库设置（如用户的 ID 和口令）。这些设置以纯文本形式存储在注册表中，可使用由 Microsoft 随操作系统提供的 Windows 注册表编辑器 regedit.exe 或 regedt32.exe, 来查看。您可以选择加密口令或要求用户在连接时输入口令。

必需的和可选的连接参数

可通过以下方式在 ODBC 连接字符串中标识数据源名称：

DSN=UserDataSourceName

在 Windows 上，如果在连接字符串中提供了 DSN 参数，则首先在 Windows 注册表中搜索用户数据源定义，然后再搜索系统数据源。只有在 ODBC 连接字符串中提供了 FileDSN 时才搜索文件数据源。

下表阐释了当数据源存在且以 DSN 或 FileDSN 参数形式包括在应用程序的连接字符串中时，用户和应用程序开发人员应该注意的一些问题。

当数据源……	连接字符串还必须标识……	用户必须提供……
包含 ODBC 驱动程序的名称和位置；数据库文件/服务器的名称；启动参数；用户 ID 和口令。	无额外信息	无额外信息。
包含 ODBC 驱动程序的名称和位置；数据库文件/服务器的名称；启动参数。	无额外信息	用户 ID 和口令（如果未在 ODBC 数据源中提供）。
只包含 ODBC 驱动程序的名称和位置。	数据库文件的名称 (DBF=) 和/或数据库服务器的名称 (SERVER=)。或者，它可能包含其它连接参数，例如，Userid (UID=) 和 PASSWORD (PWD=)。	用户 ID 和口令（如果未在 ODBC 数据源或 ODBC 连接字符串中提供）。
不存在	要使用的 ODBC 驱动程序名称 (Driver=) 和数据库名称 (DBN=)、数据库文件 (DBF=) 和/或数据库服务器 (SERVER=)。或者，它可能包含其它连接参数，例如，Userid (UID=) 和 PASSWORD (PWD=)。	用户 ID 和口令（如果未在 ODBC 连接字符串中提供）。

另请参见

使用DocCommentXchange讨论此页。