CF Data Source Name
|
The data source name (DSN) that ColdFusion
uses to connect to the data source.
|
Database
|
The name of the database.
|
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.
|
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).
The
user name must have CREATE PACKAGE privileges for the database,
or the database administrator must create a package. Consult the
database administrator when configuring this type of data source.
|
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, 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
|
Returns the entire contents of any CLOB/Text
columns in the database for this data source. If deselected, ColdFusion
retrieves the number of characters specified in the Long Text Buffer
setting. For UDB 7.1 and 7.2, a 32K limit on CLOBs exits.
|
BLOB
|
Returns the entire contents of any BLOB/Image
columns in the database for this data source. If deselected, ColdFusion
retrieves the number of characters specified in the BLOB Buffer
setting. BLOBs are not supported on UDB 7.1 and 7.2.
|
LongText Buffer (chr)
|
The default buffer size, used if the CLOB
option is not selected. The default value is 64000 bytes.
|
BLOB Buffer (bytes)
|
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.
|