System information

CONFIGURING AND ADMINISTERING COLDFUSION 9

Data Source Management

Last updated 2/21/2012

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.

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,

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.

Query Timeout (seconds) The default query timeout values for a DSN. This settings is only applicable for MySQL DataDirect driver.

A new argument

qtimeout has been added to the following methods in the Administrator API:

• setDB2()

• setMySQL_DD()

• setOracle()

• setSybase()

• setInformix()

• setMSSQL

For details on MySQL DataDirect driver upgrade, see “New querytimeout connection option” on

page 48 in Developing ColdFusion Applications.

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 Enable Long Text Retrieval (CLOB) 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.

Setting Description