Analytics SAQL Developer Guide
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. -
Multivalue Field
A multivalue field contains more than one value. -
Quoted String Escape Sequences
Strings can be escaped with the backslash character. -
Special Characters
Certain characters have special meanings in SAQL. -
Comments
To add a single-line comment in SAQL, preface your comment with two hyphens (--). To add a multi-line comment, start your comment with a forward slash and asterisk (/*) and end it with an asterisk and forward slash (*/).