Use the settings in the following table to connect ColdFusion to Microsoft Access data sources:
Setting |
Description |
---|---|
CF Data Source Name |
The data source name (DSN) used by ColdFusion to connect to the data source. |
Database File |
The file that contains the database. |
System Database File |
To secure access to the specified database file, click Browse Server to locate and enter a database that contains database security information. The system database is usually located in the same directory as the MDB file or in the windows\system32\system.mdw directory. |
Use Default Username |
If selected, ColdFusion does not pass a user name or password when requesting a connection. The Microsoft Access driver uses the default user name and password. |
ColdFusion Username |
The user name that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a user name (for example, in a cfquery tag). |
ColdFusion Password |
The password that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a password (for example, in a cfquery tag). |
Description |
(Optional) A description for this connection. |
Page Timeout |
The number of milliseconds before a request for a ColdFusion page times out. The default is 600. If you observe excessive network activity when using this driver, increase the page time-out value. |
Max Buffer Size |
The size of the internal buffer, in kilobytes, that Access uses to transfer data to and from the disk. The default buffer size is 2048 KB. Specify an integer value divisible by 256. |
Connection String |
A field that passes database-specific parameters, such as login credentials, to the data source. |
Default Username |
The user name that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a user name (for example, in a cfquery tag). |
Default Password |
The password that ColdFusion passes to the JDBC driver to connect to the data source if a ColdFusion application does not supply a password (for example, in a cfquery tag). |
Return Timestamp as String |
Enable this setting if your application retrieves Date/Time data and then reuses it in SQL statements without applying formatting (using functions such as DateFormat, TimeFormat, and CreateODBCDateTime). |
Limit Connections |
Specifies whether ColdFusion limits the number of database connections for the data source. If you enable this option, use the Restrict Connections To field to specify the maximum. |
Restrict Connections To |
Specifies the maximum number of database connections for the data source. To use this restriction, you must enable the Limit Connections option. |
Maintain Connections |
ColdFusion establishes a connection to a data source for every operation that requires one. Enable this option to improve performance by caching the data source connection. |
Timeout (min) |
The number of minutes that ColdFusion MX maintains an unused connection before destroying it. |
Interval (min) |
The time (in minutes) that the server waits between cycles to check for expired data source connections to close. |
Disable Connections |
If selected, suspends all client connections. |
Login Timeout (sec) |
The number of seconds before ColdFusion times out the data source connection login attempt. |
CLOB |
Returns the entire contents of any CLOB/ Text columns in the database for this data source. If not selected, ColdFusion retrieves the number of characters specified in the Long Text Buffer setting. |
BLOB |
Returns the entire contents of any BLOB/ Image columns in the database for this data source. If unchecked, ColdFusion retrieves the number of characters specified in the BLOB Buffer setting. |
LongText Buffer |
The default buffer size, used if the CLOB option is not selected. The default value is 64000 bytes. |
BLOB Buffer |
The default buffer size, used if the BLOB option is not selected. The default value is 64000 bytes. |
Allowed SQL |
The SQL operations that can interact with the current data source. |
Validation query |
Called when a connection from the pool is resued. This can slow query response time because an additional query is generated. You should specify this just before restarting the database to verify all connections, but remove the validation query after restarting the database to avoid any performance loss. |