Use the settings in the following table to connect ColdFusion to MySQL data sources. For information on support for specific versions, see www.adobe.com/go/sysreqscf.
Option |
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. |
Port |
The number of the TCP/IP port that the server monitors for connections. |
Username |
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. |
A field that passes database-specific parameters, such as login credentials, to the data source. |
|
Limit Connections |
If selected, limits the number of data source connections to the value entered in the Restrict Connections To field. |
Restrict Connections To |
The maximum number of data source connections; used with the Limit Connections option. |
Maintain Connections |
ColdFusion establishes a connection to a data source for every operation that requires one. Select this option to improve performance by caching the data source connection. |
Max Pooled Statements |
(MySQL DataDirect only) 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 maintains an unused connection before destroying it. |
Query Timeout (seconds) |
The querytimeout connection option sets the default query timeout values for a DSN. |
Log Activity |
(MySQL DataDirect only) Select this option to enable logging of database activity.
|
Log database calls to |
(MySQL DataDirect only) Specify the file and directory on the server in which you want to save database logging information. |
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 data source connection login attempt. |
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 amount 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 amount specified in the BLOB Buffer setting. |
Long Text 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. |
Disable Autogenerated Keys |
Disables the autogeneration of keys for data sources |
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. You should specify this just before restarting the database to verify all connections, but remove the validation query after restarting the database to avoid any performance loss. |