Can Contain | The RAQL query to execute, unless the query is specified in the query attribute. |
Allowed In | mashup | catch | else | elseif | for | foreach | if | macro | operation | sequence | try | while |
Name | Required | Description |
query | conditional | The RAQL query to execute. This query may use the dataset stream from the snapshotquery or from the variable, and optional path, specified in the From clause. You must specify the RAQL query either as a simple text inside the <raql> element or in this attribute. See The
RAQL
Query Syntax for general information. See RAQL
Queries for links to examples of the syntax variations for each clause that you may use. |
snapshotquery | An optional SQL query to execute to retrieve snapshots from the Presto Snapshot Repository. The results of this query then become the dataset stream used in the RAQL query. Specifying a snapshot query in this attribute creates a dataset stream in an implicit variable named snapshots that is local to this <raql> statement. You can instead created a named variable for snapshot datasets using the <snapshot> extension statement. See <snapshot> for information on valid SQL queries for Presto snapshots. See Load Snapshot Data with <snapshot> or <raql> for examples. | |
condition | Defines a condition that must be met to run this query. This is equivalent to using <raql> within an EMML <if> statement. | |
stream | If true, the query output remains a dataset stream that can be used in other RAQL statements, such as another <raql> statement or <storeto>. If false (the default) or if omitted, the query output becomes a document type variable that can be used in other EMML statements including <output> to define the results of the mashup. You can also define streaming access on the <variable> used as the output variable. See The Stream/Document Boundary for more information. | |
outputvariable | The name of the variable to receive the results of this query. This must be a document-type variable. If this variable has already been declared with stream="true", query results use streaming to populate this variable. See RAQL
Extensions to
EMML
Statements for Streaming for more information. |