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 相同的选项。 |