GQL Syntax

GQL Language Spec

Syntax

A condition is a string which provides the property, operator and value in the form property:operatorvalue:

property - a path representing the key to filter on
: - separator between property and an operator-value expression operator is optional, so : on its own is roughly =

Matches: [a-zA-Z_][a-zA-Z0-9_.]

Filter expressions can be combined using the following:

Can be one of the following:

null
true
false
a number (integer or decimal)
a literal
- Any character string which follows these rules:
- Cannot contain any of these symbols: ,+ unless they are escaped
- Also cannot contain these symbols when inside an IN clause: ] unless they are escaped
- Literals can be date values in any format provided that the special characters ,+[] are properly escaped.
a string surrounded by single quotes
- Any character except a single quote
- Single quotes MUST be escaped
- Strings can be date values in any format provided that single quotes are properly escaped.

Conditions can be negated using ! before the property.

Whitespace is not permitted inside of a property.
Whitespace is allowed inside both strings and literals though leading and trailing space is ignored.
Everywhere else, whitespace is ignored and therefore becomes optional.

This allows for whitespace to be used to improve readability if necessary, as any of the following are equivalent and will be accepted.