System information

CONFIGURING AND ADMINISTERING COLDFUSION 9

Data Source Management

Last updated 2/21/2012

Note: This driver uses the Microsoft Jet list of reserved words, including the word Last. For a complete list, see

http://support.microsoft.com/?kbid=248738.

Connecting to Microsoft SQL Server

To see a list of SQL Server versions that ColdFusion supports, go to www.adobe.com/go/learn_cfu_cfsysreqs_en. Use

the settings in the following table to connect ColdFusion to SQL Server:

Setting Description

CF Data Source Name The data source name (DSN) that ColdFusion uses to connect to the data source.

Database File The file that contains the database.

Description (Optional) A description for this connection.

ColdFusion User name 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).

Page Timeout The time (in tenths of a second) before a request for a ColdFusion page times out.

Max Buffer Size The size of the internal buffer, in kilobytes, used by Microsoft Access to transfer data to and from the disk. Can be

any integer value divisible by 256.

Connection String A field that passes database-specific parameters, such as login credentials, to the data source.

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, 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.

CLOB Select to return 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 Select to return the entire contents of any BLOB/Image columns in the database for this data source. If not

selected, 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. Specify the validation query just before restarting the database to verify all connections, but remove

the validation query after restarting the database to avoid any performance loss.