System information

CONFIGURING AND ADMINISTERING COLDFUSION 9

Data Source Management

Last updated 2/21/2012

Setting Description

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

Database The database to which this data source connects.

Server The name of the server that hosts the database that you want to use. If the database is local, enclose the word

local in parentheses. If you are running SQL Server locally (or using MSDE), specify 127.0.0.1 for the

server name instead of the actual instance name.

Port The number of the TCP/IP port that the server monitors for connections.

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

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.

Select Method Determines whether server cursors are used for SQL queries.

• The Direct method provides more efficient retrieval of data when you retrieve recordsets in a forward-only

direction and you limit your SQL Server connection to a single open SQL statement at a time. This is typical for

ColdFusion applications.

• The Cursor method lets you have multiple open SQL statements on a connection. This is not typical for

ColdFusion applications, unless you use pooled statements.

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.

String Format Enable this option if your application uses Unicode data in DBMS-specific Unicode data types, such as National

Character or nchar.

Max Pooled Statements Enables reuse of prepared statements (that is, stored procedures and queries that use the cfqueryparam tag).

Although you tune this setting based on your application, start by setting it to the sum of the following:

• Unique cfquery tags that use the cfqueryparam tag

• Unique cfstoredproc tags

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 Enable Long Text Retrieval (CLOB) is not selected. The default value is 64000 bytes.