MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE Reference page 191

Chapter 1: ColdFusion Tags
When specifying a date value as a string, make sure it is enclosed in quotes.
CACHEDWITHIN
Optional. Enter a timespan using the ColdFusion
Cached query data will be used if the original query date falls within the time span
you define. The CreateTimeSpan function is used to define a period of time from
the present backwards. Effective only if query caching has been enabled in the
ColdFusion Administrator. To use cached data, the current query must use the
same SQL statement, data source, query name, user name, password, and
DBTYPE. Additionally, for native drivers it must have the same DBSERVER and
DBNAME (Sybase only).
PROVIDER
Optional. COM provider (OLE-DB only).
PROVIDERDSN
Optional. Data source name for the COM provider (OLE-DB only).
DEBUG
Optional. Used for debugging queries. Specifying this attribute causes the SQL
statement actually submitted to the data source and the number of records
returned from the query to be output.
Usage
In addition to returning data from a ColdFusion data source, the CFQUERY tag also
returns informations about the query. CFQUERY.ExecutionTime returns the time it
took the query to execute in milliseconds.
CFQUERY creates a query object, providing you information in three query variables as
described in the following table.
CFQUERY Variables
Variable Name
query_name.RecordCount
query_name.CurrentRow
query_name.ColumnList
You can cache query results and execute stored procedures. For information about
caching CFQUERY results, executing stored procedures, and displaying CFQUERY
output, see Developing Web Applications with ColdFusion.
Description
The total number of records returned by
the query.
The current row of the query being
processed by CFOUTPUT.
Returns a comma-delimited list of the
query columns.
CreateTimeSpan function.
167