MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 189 / 608

Chapter 1: ColdFusion Tags 165
CFQUERY
CFQUERY passes SQL statements for any purpose to your data source. Not limited to
queries.
Syntax
<CFQUERY NAME="query_name"
DATASOURCE="ds_name"
DBTYPE="type"
DBSERVER="dbms"
DBNAME="database name"
USERNAME="username"
PASSWORD="password"
MAXROWS="number"
BLOCKFACTOR="blocksize"
TIMEOUT="milliseconds"
CACHEDAFTER="date"
CACHEDWITHIN="timespan"
PROVIDER="COMProvider"
PROVIDERDSN="datasource"
DEBUG="Yes/No">
SQL statements
</CFQUERY>
NAME
Required. The name you assign to the query. Query names must begin with a letter
and may consist of letters, numbers, and the underscore character (spaces are not
allowed). The query name is used later in the page to reference the query’s record
set.
DATASOURCE
Required. The name of the data source from which this query should retrieve data.
DBTYPE
Optional. The database driver type:
•
ODBC (default) — ODBC driver.
•
Oracle73 — Oracle 7.3 native database driver. Using this option, the ColdFusion
Server computer must have Oracle 7.3.4.0.0 (or greater) client software
installed.
•
Oracle80 —Oracle 8.0 native database driver. Using this option, the ColdFusion
Server computer must have Oracle 8.0 (or greater) client software installed.
•
Sybase11 —Sybase System 11 native database driver. Using this option, the
ColdFusion Server computer must have Sybase 11.1.1 (or greater) client
software installed. Sybase patch ebf 7729 is recommended.
•
OLEDB —OLE DB provider. If specified, this database provider overrides the
driver type specified in the ColdFusion Administrator.