SQLConfigDataSource（Access 驱动程序）

  • 项目

注意

本主题提供特定于访问驱动程序的信息。 有关此函数的一般信息，请参阅 ODBC API 参考下的相应主题。

用于添加、修改或删除数据源的 SQLConfigDataSource 函数动态使用以下关键字。

关键字 说明
COLLATINGSEQUENCE 字段的排序顺序。

这将设置与设置对话框中的 “排序顺序 ”相同的选项。
COMPACT_DB 对数据库文件执行数据压缩。 采用以下格式：COMPACT_DB=<path_name><optionaL_sort_order><可选的 ENCRYPT 关键字 (keyword) >。

在具有 DSN 关键字 (keyword) 的同一语句中使用COMPACT_DB 关键字 (keyword) 时，此驱动程序会忽略 DSN 关键字 (keyword) 。 因此，压缩数据库和指定 DSN 的过程分为两步。
CREATE_DB 创建数据库文件。 采用以下格式：CREATE_DB=<path_name><optional_sort顺序><optional_ENCRYPT 关键字 (keyword) >，其中路径名称是 Microsoft Access 数据库的完整路径。 如果路径名称指定了现有数据库，则将返回错误。 在“Microsoft Access 设置”对话框中按下“创建”按钮时，排序顺序将在显示的“新建数据库”对话框中设置。 如果未指定排序顺序，则使用“常规”。

在具有 DSN 关键字 (keyword) 的同一语句中使用CREATE_DB 关键字 (keyword) 时，此驱动程序会忽略 DSN 关键字 (keyword) 。 因此，创建数据库和指定 DSN 的过程分为两步。使用 CREATE_DB 关键字 (keyword) 时，如果要创建的 Microsoft Access 数据库的路径名包含一个或多个空格，则必须用双引号将整个路径名括起来，如以下示例所示：

“C：\PROGRAM FILES\COMMON FILES\ MyAccess.mdb”

“C：\PROGRAM FILES\Access2.mdb”

CREATE_DB=C：\TEMP\test.mdb (不需要引号)
CREATE_SYSDB 创建系统数据库文件。 采用以下格式：CREATE_SYSDB=<path-name><optional-sort-order>，其中路径名称是 Microsoft Access 数据库的完整路径。 如果路径名称指定了现有数据库，则将返回错误。 在“ODBC Microsoft Access 设置”对话框中单击“创建”按钮时，排序顺序将在显示的“新建数据库”对话框中设置。 如果未指定排序顺序，则使用“常规”。
CREATE_V2DB 创建与 Microsoft Access 2.0 兼容的数据库文件。 采用以下格式：CREATE_V2DB=<path-name><optional-sort-order>，其中路径名称是 Microsoft Access 数据库的完整路径。 如果路径名称指定了现有数据库，则将返回错误。 在“Microsoft Access 设置”对话框中按下“创建”按钮时，排序顺序将在显示的“新建数据库”对话框中设置。 如果未指定排序顺序，则使用“常规”。

在具有 DSN 关键字 (keyword) 的同一语句中使用CREATE_V2DB 关键字 (keyword) 时，此驱动程序会忽略 DSN 关键字 (keyword) 。 因此，创建数据库和指定 DSN 的过程分为两步。

使用 CREATE_V2DB 关键字 (keyword) 时，如果要创建的 Microsoft Access 数据库的路径名包含一个或多个空格，则必须用双引号将整个路径名括起来，如以下示例所示：

“C：\PROGRAM FILES\COMMON FILES\ MyAccess.mdb”

“C：\PROGRAM FILES\Access2.mdb”

CREATE_V2DB=C：\TEMP\test.mdb (不需要引号)
DBQ 数据库文件的名称。

这将设置与设置对话框中 的“数据库 ”相同的选项。
DEFAULTDIR 数据库文件的路径规范。
DESCRIPTION 数据源中数据的说明。

这将设置与设置对话框中 的“说明 ”相同的选项。
DRIVER 驱动程序 DLL 的路径规范。
DRIVERID 驱动程序的整数 ID。 25 (Microsoft Access)
FIL 适用于 Microsoft Access 的文件类型 MS Access
IMPLICITCOMMITSYNC 确定 Microsoft Access 驱动程序是异步执行内部提交还是隐式提交。 此值最初设置为“是”，这意味着 Microsoft Access 驱动程序将等待内部/隐式事务中的提交完成。

如果不仔细考虑后果，则不应更改此选项的值。 有关选项的详细信息，请参阅 Microsoft Jet 数据库引擎程序员指南。

这将设置与设置对话框中 的 ImplicitCommitSync 相同的选项。
MAXBUFFERSIZE Microsoft Access 用来将数据传入磁盘和从磁盘传输数据的内部缓冲区的大小（以 KB 为单位）。 默认缓冲区大小为 2048 KB (显示为 2048) 。 可以使用任何可被 256 整除的整数值。 这将设置与设置对话框中的 “缓冲区大小 ”相同的选项。
MAXSCANROWS 基于现有数据设置列的数据类型时要扫描的行数。

可以为要扫描的行输入 1 到 16 的数字。 该值默认为 8;如果设置为 0，则扫描所有行。 (超出限制的数字将返回 error。)

这会在设置对话框中设置与 “要扫描的行 ”相同的选项。
PAGETIMEOUT 指定页面 (（如果未使用）的时间段（以毫秒为单位），) 在删除之前保留在缓冲区中。 默认值为十分之五秒 (0.5 秒) 。 请注意，此选项适用于使用 ODBC 驱动程序的所有数据源。

这将设置与设置对话框中 的“页面超时 ”相同的选项。
PWD 密码。
READONLY 如果为 TRUE，则文件为只读;如果为 FALSE，则使文件不为只读。

这将设置与设置对话框中的 “只读 ”相同的选项。
REPAIR_DB 修复因提交过程中发生的故障而损坏的数据库。

将 REPAIR_DB 关键字 (keyword) 与 DSN 关键字 (keyword) 一起使用时，此驱动程序会忽略 DSN 关键字 (keyword) 。 因此，修复数据库和指定 DSN 是一个两步过程。
SYSTEMDB 对于 Microsoft Access 驱动程序，为系统数据库文件的路径规范。

这将设置与“设置”对话框中 的“系统数据库” 相同的选项。
线程 引擎要使用的后台线程数。 此值默认为 3，但可以更改。

这将设置与设置对话框中的 “线程 ”相同的选项。
UID 对于 Microsoft Access 驱动程序，为用于登录的用户 ID 名称。
USERCOMMITSYNC 确定 Microsoft Access 驱动程序是否会异步执行用户定义的事务。 此值最初设置为“是”，这意味着 Microsoft Access 驱动程序将等待用户定义事务中的提交完成。

如果不仔细考虑后果，则不应更改此选项的值。 有关选项的详细信息，请参阅 Microsoft Jet 数据库引擎程序员指南。

这将设置与设置对话框中 的 UserCommitSync 相同的选项。