
92
CONFIGURING AND ADMINISTERING COLDFUSION 10
Data Source Management
L
ast
u
p
dated
7/9/2
01
2
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. This name must be either a fully qualified domain name (resolvable through
DNS) or an IP address. It cannot be a netbios name (even if you are running NBT), or an alias you set up
using the client connectivity wizard (both of these approaches worked in earlier ColdFusion versions).
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 Sybase 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.
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.
Login Timeout (sec)
The number of seconds before ColdFusion times out the attempt to log in to the data source
connection.
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.