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:
|
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.
|
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 before restarting
the database to verify all connections, but remove the validation
query after restarting the database to avoid any performance loss.
|
