89
CONFIGURING AND ADMINISTERING COLDFUSION 10
Data Source Management
L
ast
u
p
dated
7/9/2
01
2
Connecting to other data sources
Use the settings in the following table to connect ColdFusion to data sources through JDBC drivers that do not appear
in the drop-down list of drivers:
Client Hostname
The host name from where the query is executed.
Client Username
The user name if the user is logged in using the <cflogin> tag.
Application Name
The application name specified in the application.cfc.
Prefix
If specified, the value is prefixed with the application name specified in application.cfc.
Enable connection validation
Check if to validate the connection.
Setting
Description
CF Data Source Name
The data source name (DSN) that ColdFusion uses to connect to the data source.
JDBC URL
The JDBC connection URL for this data source.
Driver Class
The fully qualified class name of the driver. For example, com.inet.tds.TdsDriver. The JAR file that
contains this class must be in a directory defined in the ColdFusion classpath.
Driver Name
(Optional) The name of the driver.
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.
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.
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.
Setting
Description