Use the settings in the following table to connect ColdFusion to Apache Derby Embedded:
Setting |
Description |
---|---|
CF Data Source Name |
The data source name (DSN) that ColdFusion uses to connect to the data source. |
Database folder |
The folder where the database is located. |
Create Database |
Select this option to create a database. The new database exists in the path specified in the Database Folder. If the database already exists, a SQL warning is generated, and a connection to the existing database is established. |
Description |
(Optional) A description for this connection. |
ColdFusion Username |
The username you use to log in to the ColdFusion Administrator. |
ColdFusion Password |
The password you use to log in to the ColdFusion Administrator. |
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. |
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 |
Select this option to reuse 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. |
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 unchecked, ColdFusion retrieves the number of characters specified in the Long Text Buffer setting. For UDB 7.1 and 7.2, there is a 32K limit on CLOBs. |
BLOB |
Returns the entire contents of any BLOB/Image columns in the database for this data source. If unchecked, 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. 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. |