所有运算符

属性引用

.（句点）可用来引用图元素的属性。

MATCH (n)
RETURN n._id LIMIT 10

逻辑运算符

AND

将两个或多个条件结合在一起，当所有条件判断为真时，整个表达式判断为真。

AND运算符的真值表：

本条查询返回age大于30，且incomeGroup为4的用户：

MATCH (n:User)
WHERE n.age > 30 AND n.incomeGroup = 4
RETURN n

OR

将两个或多个条件结合在一起，只需满足其中一个条件，整个表达式判断为真。

OR运算符的真值表：

本条查询返回age大于30，或incomeGroup为4的用户：

MATCH (n:Person)
WHERE n.age > 30 OR n.incomeGroup = 4
RETURN n

XOR

将两个或多个条件结合在一起，每次对两个条件执行逻辑运算。若表达式只有两个条件，则有且仅有一个条件为真时，整个表达式判断为真。若两个条件均为真或均为假，则最终结果为假。若表达式涉及多个条件，XOR先判断前两个条件，并将判断结果与下一个条件进行比较，以此类推，直至对全部条件判断完毕。

XOR运算符的真值表：

本条查询返回age大于30或incomeGroup为4的用户，但会剔除同时满足两个条件的用户：

MATCH (n:User)
WHERE n.age > 30 XOR n.incomeGroup = 4
RETURN n

NOT

对条件进行否定，当条件为假时，返回结果为真，反之亦然。

NOT运算符的真值表：

本条查询返回age不等于30的用户：

MATCH (n:Person)
WHERE NOT n.age = 30
RETURN n

算术运算符

对数值进行算术运算。GQL支持以下算术运算符：

• 加：+
• 减：-
• 乘：*
• 除：/
• 取余：%
• 取幂：^

RETURN (2+8)%3

结果：

比较运算符

比较两个值或表达式，返回真或假。GQL支持以下比较运算符：

• 等于：=
• 不等于：<>
• 大于：>
• 小于：<
• 大于等于：>=
• 小于等于：<=
• 属于： IN（参看判断包含关系）

本条查询返回age不等于30的用户：

MATCH (n:User)
WHERE n.age <> 30
RETURN n

字符运算符

字符串联

||（串联运算符）可将多个字符串按顺序合并成单个字符串。

RETURN "data" || "base"

结果：

字符匹配

CONTAINS操作符可用来判断一个字符串是否包含另一个字符串（大小写敏感）。

查询aboutMe属性中含有字符串“graph database”的user点：

MATCH (n:user WHERE n.aboutMe CONTAINS "graph database")
RETURN n

为进行大小写不敏感的匹配，可先将所有字符转换成大写或小写：

MATCH (n:user WHERE lower(n.aboutMe) CONTAINS "graph database")
RETURN n

CONTAINS操作符也可用来精确或模糊匹配指定的关键词与全文索引的词元。详见使用全文索引。

使用全文索引prodDesc查找含有graph和database词元的点：

MATCH (n WHERE ~prodDesc CONTAINS "graph database")
RETURN n

规范化谓词

判断字符串是否规范化。GQL支持以下规范化谓词：

• IS [ <normal form> ] NORMALIZED
• IS NOT [ <normal form> ] NORMALIZED

详情

• <normal form>规范化形式默认为NFC。其他可用规范化形式包括NFD，NFKC和NFKD。

RETURN "Å" IS NORMALIZED AS normRes

结果：

RETURN "Å" IS NFD NORMALIZED AS normRes

结果：

列表运算符

构建列表

在[]内放置逗号分隔的元素来创建列表。

LET items = [1,2,3]
RETURN items

结果：

[]也可用来构建嵌套列表：

LET items = [[1,2],[2,3]]
RETURN items

结果：

访问元素

使用[]可通过索引来访问列表中的元素。列表索引从0开始，即第一个元素的索引为0。

LET items = ["a", 1, "b"]
RETURN items[0]

结果：

判断包含关系

IN用来判断特定元素是否在列表中存在。

本条查询返回_id值包含在列表["U01", "U02"]中的点：

MATCH (n) WHERE n._id IN ["U01", "U02"]
RETURN n

列表串联

串联运算符||将多个列表按顺序合并成单个列表。

RETURN [1,2,3] || [3,4,5] AS newList

结果：

路径运算符

构建路径

PATH[]通过按顺序枚举点和边创建路径。

<path value constructor> ::= "PATH[" <path element list> "]"

<path element list> ::= <node reference> [ <path element list step>... ]

<path element list step> ::= "," <edge reference> "," <node reference>

详情

• 如果<path element list>包含null值或未识别出路径，则会引发异常：路径格式错误。

MATCH (n1 {_id: "U01"}), (n2 {_id: "U02"}), -[e {_uuid:39}]->
RETURN PATH[n2, e, n1]

路径串联

串联运算符||将多个路径连结成单个连续路径，即前一条路径的终点和后一条路径的起点相同时，两条路径会合并成一条。若前后路径不符合该条件，则会引发异常：路径格式错误。

MATCH p1 = ({_id: "U01"})->(n), p2 = (n)->()
RETURN p1 || p2

记录运算符

构建记录

RECORD{}通过指定字段创建记录。

<record constructor> ::=
  [ "RECORD" ] "{" [ <field> [ { "," <field> }... ] ] "}"

<field> ::= <field name> ":" <value expression>

LET rec = RECORD{length: 20, width: 59, height: 10}
RETURN rec.length

结果：

引用字段

.（句点）可用来引用记录的字段。

LET rec = RECORD{length: 20, width: 59, height: 10}
RETURN rec.length * rec.width * rec.height AS capacity

结果：

去重

DISTINCT可用来执行去重操作，仅保留唯一值。

本条查询返回用户不包含重复的age值：

MATCH (n:User)
RETURN DISTINCT n.age

Exists谓词

EXISTS谓词用来判断指定的图模式或查询是否有结果返回。如果发现匹配数据，谓词判断结果为真，否则为假。请注意，MATCH语句不支持使用EXISTS。

<exists predicate> ::= 
  "EXISTS" {
      "{" <graph pattern> "}"
    | "(" <graph pattern> ")"
    | "{" { <match statement>... } "}"
    | "(" { <match statement>... } ")"
    | <nested query specification>
  }
           
<nested query specification> ::= "{" <query specification> "}"

本条查询判断图中是否存在以点A为起点的路径，并以布尔值返回判断结果：

RETURN EXISTS {({_id:"A"})->()}

本条查询判断图中是否存在这样一条路径，其起点为A，终点为B，边的score值大于2，并以布尔值返回判断结果：

RETURN EXISTS {
  MATCH ({_id: "A"})-[e]->({_id: "B"})
  WHERE e.score > 2
}

本条查询判断列表中是否有元素大于3，并以布尔值返回判断结果：

RETURN EXISTS {
  FOR item in [1,2,3]
  FILTER item > 3
  RETURN item
}

Null谓词

用来测试是否为null值。GQL支持以下null谓词：

• IS NULL
• IS NOT NULL

本条查询获取每个点:Paper的title，前提是title属性值非空；若无符合条件的点，则返回信息为TITLE NOT FOUND。

MATCH (n:Paper)
RETURN CASE 
  WHEN n.title IS NOT NULL THEN n.title
  ELSE "TITLE NOT FOUND"
END

值类型谓词

用来确认值是否符合某个特定类型。GQL支持以下值类型谓词：

• IS TYPED <value type>
• IS NOT TYPED <value type>

详情

• 目前<value type>支持以下数据类型关键字：STRING，BOOL。

RETURN "a" IS TYPED BOOL AS typeCheck

结果：

标签谓词

用来确认图元素是否满足标签表达式。GQL支持以下值类型谓词：

• IS LABELED
• IS NOT LABELED
• :

MATCH (n) WHERE n IS NOT LABELED Paper
RETURN n

MATCH (n) WHERE n:Paper
RETURN n

起/终谓词

确认点是否为边的起点或终点。GQL支持以下起/终谓词：

• <node reference> IS SOURCE OF <edge reference>
• <node reference> IS NOT SOURCE OF <edge reference>
• <node reference> IS DESTINATION OF <edge reference>
• <node reference> IS NOT DESTINATION OF <edge reference>

MATCH (n {_id: "P1"}), ()-[e:Cites]->() WHERE n IS SOURCE OF e
RETURN e

有向谓词

有向谓词用来确认边变量是否与右向边绑定。GQL支持以下有向谓词：

• IS DIRECTED
• IS NOT DIRECTED

详情

• 嬴图数据库中创建的所有边均为有向边。

MATCH ()-[e]-()
RETURN e IS DIRECTED

结果：

布尔值谓词

用来判断布尔表达式或变量是否真实，即判断其为真还是为假。GQL支持一下布尔值谓词：

• IS TRUE
• IS FALSE

RETURN 1 > 2 IS TRUE

结果：