Neo4j 备忘清单

节点	节点通常用于表示数据中的 实体 或 事物。例如，一个 Person（人） 或 Movie（电影）。
关系	关系用于将两个节点连接在一起，并将数据组织成结构。例如，一个人 acted in（出演） 一部电影。关系有一个 类型 和 方向，尽管在查询时可以忽略方向。
标签	标签用于将节点分组到不同的类别中。例如，一个人可以有 Person(人) 和 Actor(演员) 标签。
关系类型	每个关系都有一个类型。关系允许您在图中探索较小的部分。
属性	节点和关系都可以设置属性。属性是 名称-值对。

[USE] // (使用)
[MATCH WHERE] //  (匹配条件)
[OPTIONAL MATCH WHERE] //  (可选匹配条件)
//  (传递结果并进行排序、跳过或限制)
[WITH [ORDER BY] [SKIP] [LIMIT]]
// (返回结果并进行排序、跳过或限制)
RETURN [ORDER BY] [SKIP] [LIMIT] 

[USE] // (使用)
(CREATE | MERGE)* // (创建或合并节点和关系)
// (设置、删除、移除或循环操作)
[SET|DELETE|REMOVE|FOREACH]* 
// (返回结果并进行排序、跳过或限制)
[RETURN [ORDER BY] [SKIP] [LIMIT] 

[USE]       // (使用)
[MATCH WHERE]          //  (匹配条件)
[OPTIONAL MATCH WHERE] // (可选匹配条件)
// (传递结果并进行排序、跳过或限制)
[WITH [ORDER BY] [SKIP] [LIMIT]]
(CREATE | MERGE)* // (创建或合并节点和关系)
// (设置、删除、移除或循环操作)
[SET|DELETE|REMOVE|FOREACH]* 
// (返回结果并进行排序、跳过或限制)
[RETURN [ORDER BY] [SKIP] [LIMIT] 

MATCH (n:Person)-[:KNOWS]->(m:Person)
WHERE n.name = 'Alice'

节点模式可以包含标签和属性

MATCH (n)-->(m)

在 MATCH 中可以使用任何模式

MATCH (n {name: 'Alice'})-->(m)

带有节点属性的模式

MATCH p = (n)-->(m)

将路径分配给 p

OPTIONAL MATCH (n)-[r]->(m)

可选模式：缺失部分将使用空值

WHERE n.property <> $value

使用谓词进行过滤。请注意，WHERE 总是作为 MATCH、OPTIONAL MATCH 或 WITH 子句的一部分。在查询中的其他子句之后放置它将改变它的作用

WHERE EXISTS {
  MATCH (n)-->(m) WHERE n.age = m.age
}

使用存在性子查询进行过滤。

MATCH (user)-[:FRIEND]-(friend)
WHERE user.name = $name
WITH user, count(friend) AS friends
WHERE friends > 10
RETURN user

WITH 语法类似于 RETURN。它明确地分隔查询部分，允许您声明要传递到下一部分的变量

MATCH (user)-[:FRIEND]-(friend)
WITH user, count(friend) AS friends
ORDER BY friends DESC
  SKIP 1
  LIMIT 3
RETURN user

ORDER BY、SKIP 和 LIMIT 也可以与 WITH 一起使用

MATCH (a)-[:KNOWS]->(b)
RETURN b.name
UNION
MATCH (a)-[:LOVES]->(b)
RETURN b.name

返回所有查询结果的唯一并集。结果列的类型和名称必须匹配

MATCH (a)-[:KNOWS]->(b)
RETURN b.name
UNION ALL
MATCH (a)-[:LOVES]->(b)
RETURN b.name

返回所有查询结果的并集，包括重复行

CREATE (n {name: $value})

创建具有指定属性的节点

CREATE (n $map)

创建具有指定属性的节点

UNWIND $listOfMaps AS properties
CREATE (n) SET n = properties

创建具有指定属性的节点

CREATE (n)-[r:KNOWS]->(m)

创建具有指定类型和方向的关系；将变量绑定到它

CREATE (n)-[:LOVES {since: $value}]->(m)

创建具有指定类型、方向和属性的关系

SET n.property1 = $value1,
    n.property2 = $value2

更新或创建属性

SET n = $map

设置所有属性。这将删除任何现有属性

SET n += $map

添加和更新属性，同时保留现有属性

SET n:Person

向节点添加一个标签 Person

MERGE (n:Person {name: $value})
  ON CREATE SET n.created = timestamp()
  ON MATCH SET
    n.counter = coalesce(n.counter, 0) + 1,
    n.accessTime = timestamp()

匹配模式或在不存在时创建它。使用 ON CREATE 和 ON MATCH 进行条件更新

MATCH (a:Person {name: $value1}),
      (b:Person {name: $value2})
MERGE (a)-[r:LOVES]->(b)

MERGE 查找或创建节点之间的关系

MATCH (a:Person {name: $value1})
MERGE
  (a)-[r:KNOWS]->(b:Person {name: $value3})

MERGE 查找或创建与节点关联的路径

DELETE n, r

删除一个节点和一个关系

DETACH DELETE n

删除一个节点以及与其连接的所有关系

MATCH (n)
DETACH DELETE n

从数据库中删除所有节点和关系

REMOVE n:Person

从 n 中移除一个标签

REMOVE n.property

移除一个属性

FOREACH (r IN relationships(path) |
  SET r.marked = true)

对路径中的每个关系执行一个变异操作。

FOREACH (value IN coll |
 CREATE (:Person {name: value}))

对列表中的每个元素执行一个变异操作。

通用	DISTINCT, ., []
数学	+, -, *, /, %, ^
比较	=, <>, <, >, <=, >=, IS NULL, IS NOT NULL
布尔	AND, OR, XOR, NOT
字符串	+
列表	+, IN, [x], [x .. y]
正则表达式	=~
字符串匹配	STARTS WITH, ENDS WITH, CONTAINS

• null 用于表示缺失/未定义的值。
• null 不等于 null。不知道两个值是否相等并不意味着它们是相同的值。因此，表达式 null = null 得到的是 null 而不是 true。要检查表达式是否为 null，请使用 IS NULL。
• 算术表达式、比较和函数调用（除了 coalesce）将返回 null 如果任何参数为 null。
• 尝试访问列表中缺失的元素或不存在的属性将得到 null。
• 在 OPTIONAL MATCH 子句中，缺失部分的模式将使用 null。

USE myDatabase

选择 myDatabase 来执行查询，或针对其执行查询的部分

USE neo4j
MATCH (n:Person)-[:KNOWS]->(m:Person)
WHERE n.name = 'Alice'

针对 Neo4j 数据库执行的 MATCH 查询

SHOW FUNCTIONS

列出所有可用函数

SHOW PROCEDURES EXECUTABLE YIELD name

列出当前用户可以执行的所有过程，并仅返回过程的名称

CREATE (n:Person {name: $value})

创建一个带有标签和属性的节点

MERGE (n:Person {name: $value})

匹配或创建具有该标签和属性的唯一节点

SET n:Spouse:Parent:Employee

向节点添加标签

MATCH (n:Person)

匹配标记为“Person”的节点

MATCH (n:Person)
WHERE n.name = $value

匹配具有给定名称的标记为“Person”的节点

WHERE (n:Person)

检查节点上标签的存在

labels(n)

节点的标签

REMOVE n:Person

从节点中移除标签

CASE n.eyes
  WHEN 'blue' THEN 1
  WHEN 'brown' THEN 2
  ELSE 3
END

从匹配的 WHEN 值返回 THEN 值。ELSE 值是可选的，如果缺失，则替换为 null

CASE
  WHEN n.eyes = 'blue' THEN 1
  WHEN n.age < 40 THEN 2
  ELSE 3
END

从第一个评估为 true 的 WHEN 谓词返回 THEN 值。谓词按顺序进行评估

size($list)

列表中的元素数量

reverse($list)

反转列表中元素的顺序

head($list), last($list), tail($list)

head() 返回列表的第一个元素，last() 返回列表的最后一个元素。tail() 返回除第一个元素外的所有元素。对于空列表，所有函数返回 null

[x IN list | x.prop]

对原始列表中每个元素的表达式值组成的列表

[x IN list WHERE x.prop <> $value]

过滤出谓词为 true 的元素组成的列表

[x IN list WHERE x.prop <> $value | x.prop]

对列表进行过滤，并从每个符合条件的元素中提取表达式的值

reduce(s = "", x IN list | s + x.prop)

对列表中的每个元素求值，并累积结果

coalesce(n.property, $defaultValue)

返回第一个非空表达式

timestamp()

自1970年1月1日UTC午夜以来的毫秒数

id(nodeOrRelationship)

关系或节点的内部ID

toInteger($expr)

将给定的输入转换为整数（如果可能），否则返回 null

toFloat($expr)

将给定的输入转换为浮点数（如果可能），否则返回 null

toBoolean($expr)

将给定的输入转换为布尔值（如果可能），否则返回 null

keys($expr)

返回节点、关系或映射的属性名称的字符串表示形式列表

properties($expr)

返回包含节点或关系的所有属性的映射

length(path)

路径中的关系数量。

nodes(path)

路径中的节点列表。

relationships(path)

路径中的关系列表。

[x IN nodes(path) | x.prop]

从路径中的节点中提取属性。

duration("P1Y2M10DT12H45M30.25S")

返回 1 年、2 个月、10 天、12 小时、45 分钟和 30.25 秒的持续时间。

duration.between($date1,$date2)

返回两个时间实例之间的持续时间。

WITH duration("P1Y2M10DT12H45M") AS d
RETURN d.years, d.months, d.days, d.hours, d.minutes

返回 1 年、14 个月、10 天、12 小时和 765 分钟。

WITH duration("P1Y2M10DT12H45M") AS d
RETURN d.years, d.monthsOfYear, d.days, d.hours, d.minutesOfHour

返回 1 年、2 个月、10 天、12 小时和 45 分钟。

date("2015-01-01") + duration("P1Y1M1D")

返回 2016-02-02 的日期。也可以从时间实例中减去持续时间。

duration("PT30S") * 10

返回 5 分钟的持续时间。也可以将持续时间除以一个数字。

type(a_relationship)

关系类型的字符串表示。

startNode(a_relationship)

关系的起始节点。

endNode(a_relationship)

关系的结束节点。

id(a_relationship)

关系的内部ID

toString($expression)

表达式的字符串表示。

replace($original, $search, $replacement)

用 replacement 替换所有出现的 search。所有参数都必须是表达式。

substring($original, $begin, $subLength)

获取字符串的部分。subLength 参数是可选的。

left($original, $subLength),
  right($original, $subLength)

字符串的前部分。字符串的后部分。

trim($original), lTrim($original),
  rTrim($original)

修剪所有空格，或在左侧或右侧。

toUpper($original), toLower($original)

大写和小写。

split($original, $delimiter)

将字符串拆分为字符串列表。

reverse($original)

反转字符串。

size($string)

计算字符串中的字符数。

count(*)

匹配行的数量。

count(variable)

非空值的数量。

count(DISTINCT variable)

所有聚合函数也接受 DISTINCT 运算符，它从值中去除重复项。

collect(n.property)

从值中创建列表，忽略 null 值。

sum(n.property)

求数值的总和。类似的函数有 avg()、min()、max()。

percentileDisc(n.property, $percentile)

离散百分位数。连续百分位数是 percentileCont()。百分位数参数范围从 0.0 到 1.0。

stDev(n.property)

样本标准差。对于整个总体，请使用 stDevP()。

• 尽可能使用参数而不是文字常量。这样可以让 Cypher 重用你的查询，而不必解析和构建新的执行计划。
• 始终为你的变长模式设置一个上限。有可能一个查询会因为错误而无限制地访问图中的所有节点。
• 只返回你需要的数据。避免返回整个节点和关系，而是选择你需要的数据并只返回那部分。
• 使用 PROFILE / EXPLAIN 来分析你的查询性能。查看查询调优了解更多关于这些以及其他主题的信息。

CREATE OR REPLACE DATABASE myDatabase

(★) 创建一个名为 myDatabase 的数据库。如果已存在同名数据库，则删除现有数据库并创建一个新的。

STOP DATABASE myDatabase

(★) 停止名为 myDatabase 的数据库。

START DATABASE myDatabase

(★) 启动名为 myDatabase 的数据库。

SHOW DATABASES

列出系统中所有数据库及其相关信息。

SHOW DATABASES
YIELD name, currentStatus
WHERE name CONTAINS 'my' AND currentStatus = 'online'

列出数据库的信息，根据名称和在线状态进行筛选，并进一步根据这些条件进行细分。

SHOW DATABASE myDatabase

显示有关数据库 myDatabase 的信息。

SHOW DEFAULT DATABASE

显示默认数据库的信息。

SHOW HOME DATABASE

显示当前用户的主数据库的信息。

DROP DATABASE myDatabase IF EXISTS

(★) 删除数据库 myDatabase，如果存在的话。

CREATE ROLE my_role

创建一个角色。

CREATE ROLE my_second_role IF NOT EXISTS AS COPY OF my_role

创建一个名为 my_second_role 的角色，除非它已经存在，作为现有 my_role 的副本。

RENAME ROLE my_second_role TO my_other_role

将名为 my_second_role 的角色重命名为 my_other_role。

GRANT ROLE my_role, my_other_role TO alice

将角色分配给用户。

REVOKE ROLE my_other_role FROM alice

从用户中删除指定的角色。

SHOW ROLES

列出系统中的所有角色。

SHOW ROLES
YIELD role
WHERE role CONTAINS 'my'

列出角色，根据角色名称进行过滤，并进一步根据名称是否包含 'my' 进行筛选。

SHOW POPULATED ROLES WITH USERS

列出系统中至少分配给一个用户的所有角色，以及分配给这些角色的用户。

DROP ROLE my_role

删除一个角色。

GRANT CREATE ON GRAPH * NODES Label TO my_role

将创建权限授予角色对所有图中具有指定标签的所有节点。

DENY DELETE ON GRAPH neo4j TO my_role

拒绝角色对指定图中的所有节点和关系的删除权限。

REVOKE SET LABEL Label ON GRAPH * FROM my_role

撤销对角色在所有图中设置指定标签的权限。

GRANT REMOVE LABEL * ON GRAPH foo TO my_role

将删除标签权限授予角色对指定图中的所有标签。

DENY SET PROPERTY {prop} ON GRAPH foo RELATIONSHIPS Type TO my_role

拒绝角色对指定图中具有指定类型的所有关系的特定属性的设置权限。

GRANT MERGE {*} ON GRAPH * NODES Label TO my_role

将合并权限授予角色对所有图中具有指定标签的所有节点的所有属性。

REVOKE WRITE ON GRAPH * FROM my_role

撤销对角色在所有图中的写入权限。

DENY ALL GRAPH PRIVILEGES ON GRAPH foo TO my_role

拒绝角色对指定图的所有图权限。

SHOW PRIVILEGES AS COMMANDS

以Cypher命令的形式列出系统中的所有权限。

SHOW PRIVILEGES

列出系统中的所有权限，以及它们所分配的角色。

SHOW PRIVILEGES
YIELD role, action, access
WHERE role = 'my_role'

列出关于权限的信息，根据角色、操作和访问进行筛选，并进一步根据角色名称进行细化。

SHOW ROLE my_role PRIVILEGES AS COMMANDS

以Cypher命令的形式列出分配给角色的所有权限。

SHOW ROLE my_role, my_second_role PRIVILEGES AS COMMANDS

以Cypher命令的形式列出分配给多个角色的所有权限。

SHOW USER alice PRIVILEGES AS COMMANDS

以Cypher命令的形式列出用户的所有权限，以及他们所分配的角色。

SHOW USER PRIVILEGES AS COMMANDS

以Cypher命令的形式列出当前登录用户的所有权限，以及他们所分配的角色。

GRANT CREATE ROLE ON DBMS TO my_role

将创建角色的权限授予角色。

GRANT RENAME ROLE ON DBMS TO my_role

将重命名角色的权限授予角色。

GRANT DROP ROLE ON DBMS TO my_role

将删除角色的权限授予角色。

DENY ASSIGN ROLE ON DBMS TO my_role

拒绝将角色分配给用户的权限授予角色。

DENY REMOVE ROLE ON DBMS TO my_role

拒绝从用户中删除角色的权限授予角色。

REVOKE DENY SHOW ROLE ON DBMS FROM my_role

从角色撤销对显示角色的权限的拒绝。

GRANT ROLE MANAGEMENT ON DBMS TO my_role

将管理角色的所有权限授予角色。