GQL 函数、运算符和谓词

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息。
适用于： ✅ Azure 数据资源管理器

本文列出了 GQL （图形查询语言）中支持的标量函数、运算符和谓词。

这些示例使用“创建图形”中的电影图G()并设置图形引用：Person节点（、NameBorn节点（MovieTitle、Description、）Year和ACTED_IN / DIRECTED边缘（）。Role

访问运算符

使用这些运算符从节点、边缘、映射、列表或路径读取属性或元素。

match () limit 1 return [10, 20, 30][1] as byIndex, {a: 1, b: 2}.a as byDot, {a: 1, b: 2}['b'] as byKey

字符串函数

字符串谓词：

match () limit 1 return upper("abc") as result

match () limit 1 return trim(leading 'a' from 'aabc') as result

match () limit 1 return string_join(["a", "bc"], "") as result

MATCH (p :Person)
WHERE p.Name starts with 'T'
RETURN p.Name as actorName

数值函数

数字与算术运算符 +、 -、 *和 /：

match () limit 1 return 2 + 3 * 4 as a, 10 - 6 as b, mod(10, 4) as c, abs(-7) as d

match () limit 1 return sqrt(9) as `sqrt`, 9 / 3 as divideResult

条件表达式

CASE

CASE 根据条件（计算独立谓词）或简单形式（将一个表达式与一系列值进行比较）返回一个值。

搜索的表单依次评估每个 WHEN 谓词：

match (m:Movie)
return m.Title as Title, case when m.Year < 2000 then 'C' else 'M' end as Era

简单窗体将一个表达式与每个 WHEN 值进行比较：

match (m:Movie)
return m.Title as Title,
    case m.Title
        when 'T1' then 'A'
        when 'T3' then 'G'
        else 'O'
    end as Name

类型转换

CAST

CAST(value AS type)将值转换为另一种类型，例如string。 int64 这在两种常见情况下是必需的。

嵌套属性访问。 当通过嵌套表达式或索引表达式（如路径的元素或映射成员）到达某个属性时，结果是一个 dynamic 事先不知道其类型的值。 在比较或计算它之前，将其强制转换为预期类型。

请参阅 此处 支持的类型。

match p = (a:Person)-[:ACTED_IN]->(m:Movie)
return m.Title as Title, cast(nodes(p)[0].Born as int) as ActorBorn

MATCH (p:Person)
RETURN p.Name || ', ' || CAST(p.Born as string) as nameAndYear

聚合对象键。 聚合键不能是对象（dynamic如节点、边缘或属性映射）。 首先 to_json_string(...) 使用或 CAST(... AS string). 将对象值转换为字符串。

match (p:Person)->(m:Movie)
return to_json_string(p), count(m) as participatedInMoviesCount

JSON 函数

MATCH (n:Person {Name: 'Julia'})
RETURN TO_JSON_STRING(n) AS `json`

MATCH (p:Person)
limit 1
RETURN parse_json_string('{"a":"Michael", "b":"John"}'.a as string) AS name

MATCH (p:Person)
limit 1
RETURN cast(parse_json_string('{"a":1, "b":2}').a as integer) AS a

MATCH () limit 1 RETURN PARSE_JSON_STRING('[1,2,3]')[1] as second

列出和映射函数和谓词

match () limit 1 return ["a", "b", "c"][1] as second

match () limit 1 return size([1, 2, 3]) as `size`

match () limit 1 return keys({"a":1, "b":2}) as my_keys

MATCH (p:Person)
WHERE p.Name IN ['Tom', 'Kevin']
RETURN p.Name as actor

match () limit 1 return ["a"] || ["b"] as lst

日期和时间函数

match () limit 1 return duration ({minutes: 5}) as "5min"

match () limit 1 return duration ({minutes: 5, seconds:25}) as "5min25sec"

如果图形中的节点具有 event_timestamp等属性，则可以查找包含过去 10 分钟内发生的事件的所有图形节点，该事件从现在开始或从特定时间戳进行测量：

MATCH (n) where n.event_timestamp < CURRENT_TIMESTAMP - duration({minutes:10}) return n

MATCH (n) where n.event_timestamp < zoned_datetime('2025-09-15 09:00:00.0') - duration({minutes:10}) return n

MATCH () limit 1
RETURN DURATION_BETWEEN(zoned_datetime('2025-09-15 09:00:00.0'), zoned_datetime()) AS Elapsed

图形和路径函数

match (m: Movie) limit 1 return labels(m) as lbls

match p = (n:Person)-[e: ACTED_IN]->(m: Movie) return p, path_length(p), nodes(p), edges(p)

Aggregations

聚合函数汇总匹配的行。 当聚合出现在非聚合表达式旁边时，这些表达式将成为分组键。

MATCH (p:Person)
RETURN COUNT(*) AS people, MIN(p.Born) AS earliest, MAX(p.Born) AS latest, SUM(p.Born) AS bornSum, AVG(p.Born) AS bornAvg

统计每个电影中的演员：

MATCH (p:Person)-[:ACTED_IN]->(m:Movie)
RETURN m.Title as Movie, COUNT(*) AS ActorsCount

MATCH (n:Person)-[:ACTED_IN]->(m:Movie)
RETURN collect_list(distinct n.Name) as actors

查找每个演员参与的电影数量：

MATCH (n:Person)-[:ACTED_IN]->(m:Movie)
RETURN TO_JSON_STRING(n) as actor, count(m) as moviesCount

有关详细信息，请参阅 GQL 指南中的 聚合 。

谓词

比较运算符比较两个标量值并返回布尔值。 它们适用于标量值，不适用于节点或边缘。

其他运算符：

match (p:Person)
where p.Name in ['Tom', 'Julia']
return p.Name as name

将测试除以 NOT 仅保留列表中缺少的值：

match (p:Person)
where not p.Name in ['Tom', 'Kevin', 'Ron']
return p.Name as name

其他谓词：

MATCH (p:Person)
WHERE p.Name IN ['Tom', 'Kevin'] AND p.Born IS NOT NULL
RETURN p.Name as name

可以使用 IS TRUE 或 IS FALSE 测试布尔表达式的结果：

MATCH (p:Person)
WHERE (p.Born > 1960) IS TRUE
RETURN p.Name

相关内容

• GQL （图形查询语言）
• GQL 指南
• GQL 子句
• 创建图形并设置图形引用