Analytics SAQL Reference
Summer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Newer Version Available
SAQL Basic Elements
Basic elements are the building blocks of your SAQL query.
-
Statements
A SAQL query loads input data, operates on it, and outputs the result data. A query is made up of statements. Each SAQL statement has an input stream, an operation, and an output stream. -
Keywords
Keywords are case-sensitive and must be lowercase. -
Identifiers
SAQL identifiers are case-sensitive and must be enclosed in single quotation marks ('). -
Number Literals
A number literal represents a number in your script. -
String Literals
A string is a set of characters inside double quotes ("). -
Boolean Literals
A boolean literal represents true or false (yes or no) in your script. -
Quoted String Escape Sequences
Strings can be escaped with the backslash character. -
Special Characters
Certain characters have special meanings in SAQL. -
Comments
Two sequential hyphens (--) indicate the beginning of a single-line comment in SAQL.