87
CONFIGURING AND ADMINISTERING COLDFUSION 10
Data Source Management
L
ast
u
p
dated
7/9/2
01
2
Connecting to Oracle
To see a list of Oracle versions that ColdFusion supports, go to
www.adobe.com/go/learn_cfu_cfsysreqs_en
. Use the
settings in the following table to connect ColdFusion to Oracle data sources:
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.
Return Timestamp as String
Enable this option if your application retrieves Date/Time data and then reuses it in SQL statements
without applying formatting (using functions such as
DateFormat
,
TimeFormat
, and
CreateODBCDateTime
).
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.
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. Configure this just before restarting the database to verify all
connections, but remove the validation query after restarting the database to avoid any performance
loss.
Setting
Description