Nebula教程

https://docs.nebula-graph.com.cn/3.8.0/nebula-studio/quick-start/draft/#schema_5

Nebula PDF下载链接：https://docs.nebula-graph.com.cn/3.8.0/pdf/NebulaGraph-CN.pdf

 

Nebula通用查询语句

MATCH

MATCH <pattern> [<clause_1>]  RETURN <output>  [<clause_2>];
模式 示例 说明
匹配点 (v) 用户可以在一对括号中使用自定义变量来表示模式中的点。例如(v)。
匹配 Tag MATCH (v:player) RETURN v 用户可以在点的右侧用:<tag_name>表示模式中的 Tag。
匹配多 Tag MATCH (v:player:team) RETURN v 用户可以用英文冒号（:）匹配多 Tag 的点。
匹配点的属性 MATCH (v:player{name:"Tim Duncan"}) RETURN v

MATCH (v) WITH v, properties(v) as props, keys(properties(v)) as kk WHERE [i in kk where props[i] == "Tim Duncan"] RETURN v		 用户可以在 Tag 的右侧用{<prop_name>: <prop_value>}表示模式中点的属性；或者不指定 Tag 直接匹配点的属性。
匹配单点 ID MATCH (v) WHERE id(v) == 'player101' RETURN v 用户可以使用点 ID 去匹配点。id()函数可以检索点的 ID。
匹配多点 ID MATCH (v:player { name: 'Tim Duncan' })--(v2) WHERE id(v2) IN ["player101", "player102"] RETURN v2 要匹配多个点的 ID，可以用WHERE id(v) IN [vid_list]。
匹配连接的点 MATCH (v:player{name:"Tim Duncan"})--(v2) RETURN v2.player.name AS Name 用户可以使用--符号表示两个方向的边，并匹配这些边连接的点。用户可以在--符号上增加<或>符号指定边的方向。
匹配路径 MATCH p=(v:player{name:"Tim Duncan"})-->(v2) RETURN p 连接起来的点和边构成了路径。用户可以使用自定义变量命名路径。
匹配边 MATCH (v:player{name:"Tim Duncan"})-[e]-(v2) RETURN e
MATCH ()<-[e]-() RETURN e		 除了用--、-->、<--表示未命名的边之外，用户还可以在方括号中使用自定义变量命名边。例如-[e]-。
匹配 Edge type MATCH ()-[e:follow]->() RETURN e 和点一样，用户可以用:<edge_type>表示模式中的 Edge type，例如-[e:follow]-。
匹配边的属性 MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) RETURN e

MATCH ()-[e]->() WITH e, properties(e) as props, keys(properties(e)) as kk WHERE [i in kk where props[i] == 90] RETURN e		 用户可以用{<prop_name>: <prop_value>}表示模式中 Edge type 的属性，例如[e:follow{likeness:95}]；或者不指定 Edge type 直接匹配边的属性。
匹配多个 Edge type MATCH (v:player{name:"Tim Duncan"})-[e:follow | :serve]->(v2) RETURN e 使用|可以匹配多个 Edge type，例如[e:follow | :serve]。第一个 Edge type 前的英文冒号（:）不可省略，后续 Edge type 前的英文冒号可以省略，例如[e:follow | serve]。
匹配多条边 MATCH (v:player{name:"Tim Duncan"})-[]->(v2)<-[e:serve]-(v3) RETURN v2, v3 用户可以扩展模式，匹配路径中的多条边。
匹配定长路径 MATCH p=(v:player{name:"Tim Duncan"})-[e:follow*2]->(v2) RETURN DISTINCT v2 AS Friends 用户可以在模式中使用:<edge_type>*<hop>匹配定长路径。hop必须是一个非负整数。e的数据类型是列表。
匹配变长路径 MATCH p=(v:player{name:"Tim Duncan"})-[e:follow*1..3]->(v2) RETURN v2 AS Friends minHop：可选项。表示路径的最小长度。minHop必须是一个非负整数，默认值为 1。
maxHop：可选项。表示路径的最大长度。maxHop必须是一个非负整数，默认为无穷大。e的数据类型是列表。
匹配多个 Edge type 的变长路径 MATCH p=(v:player{name:"Tim Duncan"})-[e:follow | serve*2]->(v2) RETURN DISTINCT v2 用户可以在变长或定长模式中指定多个 Edge type。hop、minHop和maxHop对所有 Edge type 都生效。e的数据类型是列表。
检索点或边的信息 MATCH (v:player{name:"Tim Duncan"}) RETURN v
MATCH (v:player{name:"Tim Duncan"})-[e]->(v2) RETURN e		 使用RETURN {<vertex_name> | <edge_name>}检索点或边的所有信息。
检索点 ID MATCH (v:player{name:"Tim Duncan"}) RETURN id(v) 使用id()函数检索点 ID。
检索 Tag MATCH (v:player{name:"Tim Duncan"}) RETURN labels(v) 使用labels()函数检索点上的 Tag 列表。
检索列表labels(v)中的第 N 个元素，可以使用labels(v)[n-1]。
检索点或边的单个属性 MATCH (v:player{name:"Tim Duncan"}) RETURN v.player.age 使用RETURN {<vertex_name> | <edge_name>}.<property>检索单个属性。
使用AS设置属性的别名。
检索点或边的所有属性 MATCH p=(v:player{name:"Tim Duncan"})-[]->(v2) RETURN properties(v2) 使用properties()函数检索点或边的所有属性。
检索 Edge type MATCH p=(v:player{name:"Tim Duncan"})-[e]->() RETURN DISTINCT type(e) 使用type()函数检索匹配的 Edge type。
检索路径 MATCH p=(v:player{name:"Tim Duncan"})-[*3]->() RETURN p 使用RETURN <path_name>检索匹配路径的所有信息。
检索路径中的点 MATCH p=(v:player{name:"Tim Duncan"})-[]->(v2) RETURN nodes(p) 使用nodes()函数检索路径中的所有点。
检索路径中的边 MATCH p=(v:player{name:"Tim Duncan"})-[]->(v2) RETURN relationships(p) 使用relationships()函数检索路径中的所有边。
检索路径长度 MATCH p=(v:player{name:"Tim Duncan"})-[*..2]->(v2) RETURN p AS Paths, length(p) AS Length 使用length()函数检索路径的长度。

 

OPTIONAL MATCH

模式 示例 说明
作为MATCH语句的可选项去匹配图数据库中的模式 MATCH (m)-[]->(n) WHERE id(m)=="player100" OPTIONAL MATCH (n)-[]->(l) RETURN id(m),id(n),id(l) 如果图数据库中没有对应的模式，对应的列返回NULL。

LOOKUP

LOOKUP ON {<vertex_tag> | <edge_type>} 
[WHERE <expression> [AND <expression> ...]] 
YIELD <return_list> [AS <alias>]
模式 示例 说明
检索点 LOOKUP ON player WHERE player.name == "Tony Parker" YIELD player.name AS name, player.age AS age 返回 Tag 为player且name为Tony Parker的点。
检索边 LOOKUP ON follow WHERE follow.degree == 90 YIELD follow.degree 返回 Edge type 为follow且degree为90的边。
通过 Tag 列出所有点 LOOKUP ON player YIELD properties(vertex),id(vertex) 查找所有 Tag 为player的点 VID。
通过 Edge type 列出边 LOOKUP ON follow YIELD edge AS e 查找 Edge type 为follow的所有边的信息。
统计点 LOOKUP ON player YIELD id(vertex)| YIELD COUNT(*) AS Player_Count 统计 Tag 为player的点。
统计边 LOOKUP ON follow YIELD edge as e | YIELD COUNT(*) AS Like_Count 统计 Edge type 为follow的边。

GO

GO [[<M> TO] <N> {STEP|STEPS} ] FROM <vertex_list>
OVER <edge_type_list> [{REVERSELY | BIDIRECT}]
[ WHERE <conditions> ]
YIELD [DISTINCT] <return_list>
[{SAMPLE <sample_list> | LIMIT <limit_list>}]
[| GROUP BY {col_name | expr | position} YIELD <col_name>]
[| ORDER BY <expression> [{ASC | DESC}]]
[| LIMIT [<offset_value>,] <number_rows>]
示例 说明
GO FROM "player102" OVER serve YIELD dst(edge) 返回 player102 所属队伍。
GO 2 STEPS FROM "player102" OVER follow YIELD dst(edge) 返回距离 player102 两跳的朋友。
GO FROM "player100", "player102" OVER serve WHERE properties(edge).start_year > 1995 YIELD DISTINCT properties($$).name AS team_name, properties(edge).start_year AS start_year, properties($^).name AS player_name 添加过滤条件。
GO FROM "player100" OVER follow, serve YIELD properties(edge).degree, properties(edge).start_year 遍历多个 Edge type。属性没有值时，会显示NULL。
GO FROM "player100" OVER follow REVERSELY YIELD src(edge) AS destination 返回 player100 入方向的邻居点。
GO FROM "player100" OVER follow REVERSELY YIELD src(edge) AS id | GO FROM $-.id OVER serve WHERE properties($^).age > 20 YIELD properties($^).name AS FriendOf, properties($$).name AS Team 查询 player100 的朋友和朋友所属队伍。
GO FROM "player102" OVER follow YIELD dst(edge) AS both 返回 player102 所有邻居点。
GO 2 STEPS FROM "player100" OVER follow YIELD src(edge) AS src, dst(edge) AS dst, properties($$).age AS age | GROUP BY $-.dst YIELD $-.dst AS dst, collect_set($-.src) AS src, collect($-.age) AS age 根据年龄分组。

  • FETCH

    • 获取点的属性值

      FETCH PROP ON {<tag_name>[, tag_name ...] | *} 
<vid> [, vid ...] 
YIELD <return_list> [AS <alias>]
      示例 说明
      FETCH PROP ON player "player100" YIELD properties(vertex) 在FETCH语句中指定 Tag 获取对应点的属性值。
      FETCH PROP ON player "player100" YIELD player.name AS name 使用YIELD子句指定返回的属性。
      FETCH PROP ON player "player101", "player102", "player103" YIELD properties(vertex) 指定多个点 ID 获取多个点的属性值，点之间用英文逗号（,）分隔。
      FETCH PROP ON player, t1 "player100", "player103" YIELD properties(vertex) 在FETCH语句中指定多个 Tag 获取属性值。Tag 之间用英文逗号（,）分隔。
      FETCH PROP ON * "player100", "player106", "team200" YIELD properties(vertex) 在FETCH语句中使用*获取当前图空间所有标签里，点的属性值。

    • 获取边的属性值

      FETCH PROP ON <edge_type> <src_vid> -> <dst_vid>[@<rank>] [, <src_vid> -> <dst_vid> ...]
YIELD <output>;
      示例 说明
      FETCH PROP ON serve "player100" -> "team204" YIELD properties(edge) 获取连接 player100 和 team204 的边 serve 的所有属性值。
      FETCH PROP ON serve "player100" -> "team204" YIELD serve.start_year 使用YIELD子句指定返回的属性。
      FETCH PROP ON serve "player100" -> "team204", "player133" -> "team202" YIELD properties(edge) 指定多个边模式 (<src_vid> -> <dst_vid>[@<rank>]) 获取多个边的属性值。模式之间用英文逗号（,）分隔。
      FETCH PROP ON serve "player100" -> "team204"@1 YIELD properties(edge) 要获取 rank 不为 0 的边，请在 FETCH 语句中设置 rank。
      GO FROM "player101" OVER follow YIELD follow._src AS s, follow._dst AS d | FETCH PROP ON follow $-.s -> $-.d YIELD follow.degree 返回从点 player101 开始的 follow 边的 degree 值。
      $var = GO FROM "player101" OVER follow YIELD follow._src AS s, follow._dst AS d; FETCH PROP ON follow $var.s -> $var.d YIELD follow.degree 自定义变量构建查询。

  • SHOW

    语句 语法 示例 说明
    SHOW CHARSET SHOW CHARSET SHOW CHARSET 显示当前的字符集。
    SHOW COLLATION SHOW COLLATION SHOW COLLATION 显示当前的排序规则。
    SHOW CREATE SPACE SHOW CREATE SPACE <space_name> SHOW CREATE SPACE basketballplayer 显示指定图空间的创建语句。
    SHOW CREATE TAG/EDGE SHOW CREATE {TAG <tag_name> | EDGE <edge_name>} SHOW CREATE TAG player 显示指定 Tag/Edge type 的基本信息。
    SHOW HOSTS SHOW HOSTS [GRAPH | STORAGE | META] SHOW HOSTS
    SHOW HOSTS GRAPH    		 显示 Graph、Storage、Meta 服务主机信息、版本信息。
    SHOW INDEX STATUS SHOW {TAG | EDGE} INDEX STATUS SHOW TAG INDEX STATUS 重建原生索引的作业状态，以便确定重建索引是否成功。
    SHOW INDEXES SHOW {TAG | EDGE} INDEXES SHOW TAG INDEXES 列出当前图空间内的所有 Tag 和 Edge type（包括属性）的索引。
    SHOW PARTS SHOW PARTS [<part_id>] SHOW PARTS 显示图空间中指定分片或所有分片的信息。
    SHOW ROLES SHOW ROLES IN <space_name> SHOW ROLES in basketballplayer 显示分配给用户的角色信息。
    SHOW SNAPSHOTS SHOW SNAPSHOTS SHOW SNAPSHOTS 显示所有快照信息。
    SHOW SPACES SHOW SPACES SHOW SPACES 显示现存的图空间。
    SHOW STATS SHOW STATS SHOW STATS 显示最近STATS作业收集的图空间统计信息。
    SHOW TAGS/EDGES SHOW TAGS | EDGES SHOW TAGS、SHOW EDGES 显示当前图空间内的所有 Tag/Edge type。
    SHOW USERS SHOW USERS SHOW USERS 显示用户信息。
    SHOW SESSIONS SHOW SESSIONS SHOW SESSIONS 显示所有会话信息。
    SHOW SESSIONS SHOW SESSION <Session_Id> SHOW SESSION 1623304491050858 指定会话 ID 进行查看。
    SHOW QUERIES SHOW [ALL] QUERIES SHOW QUERIES 查看当前 Session 中正在执行的查询请求信息。
    SHOW META LEADER SHOW META LEADER SHOW META LEADER 显示当前 Meta 集群的 leader 信息。

子句和选项

子句 语法 示例 说明
GROUP BY GROUP BY <var> YIELD <var>, <aggregation_function(var)> GO FROM "player100" OVER follow BIDIRECT YIELD $$.player.name as Name | GROUP BY $-.Name YIELD $-.Name as Player, count(*) AS Name_Count 查找所有连接到 player100 的点，并根据他们的姓名进行分组，返回姓名的出现次数。
LIMIT YIELD <var> [| LIMIT [<offset_value>,] <number_rows>] GO FROM "player100" OVER follow REVERSELY YIELD $$.player.name AS Friend, $$.player.age AS Age | ORDER BY $-.Age, $-.Friend | LIMIT 1, 3 从排序结果中返回第 2 行开始的 3 行数据。
SKIP RETURN <var> [SKIP <offset>] [LIMIT <number_rows>] MATCH (v:player{name:"Tim Duncan"}) --> (v2) RETURN v2.player.name AS Name, v2.player.age AS Age ORDER BY Age DESC SKIP 1 用户可以单独使用SKIP <offset>设置偏移量，后面不需要添加LIMIT <number_rows>。
SAMPLE <go_statement> SAMPLE <sample_list>; GO 3 STEPS FROM "player100" OVER * YIELD properties($$).name AS NAME, properties($$).age AS Age SAMPLE [1,2,3]; 在结果集中均匀取样并返回指定数量的数据。
ORDER BY <YIELD clause> ORDER BY <expression> [ASC | DESC] [, <expression> [ASC | DESC] ...] FETCH PROP ON player "player100", "player101", "player102", "player103" YIELD player.age AS age, player.name AS name | ORDER BY $-.age ASC, $-.name DESC ORDER BY子句指定输出结果的排序规则。
RETURN RETURN {<vertex_name>|<edge_name>|<vertex_name>.<property>|<edge_name>.<property>|...} MATCH (v:player) RETURN v.player.name, v.player.age LIMIT 3 返回点的属性为name和age的前三行值。
TTL CREATE TAG <tag_name>(<property_name_1> <property_value_1>, <property_name_2> <property_value_2>, ...) ttl_duration= <value_int>, ttl_col = <property_name> CREATE TAG t2(a int, b int, c string) ttl_duration= 100, ttl_col = "a" 创建 Tag 并设置 TTL 选项。
WHERE WHERE {<vertex|edge_alias>.<property_name> {>|==|<|...} <value>...} MATCH (v:player) WHERE v.player.name == "Tim Duncan" XOR (v.player.age < 30 AND v.player.name == "Yao Ming") OR NOT (v.player.name == "Yao Ming" OR v.player.name == "Tim Duncan") RETURN v.player.name, v.player.age WHERE子句可以根据条件过滤输出结果，通常用于GO和LOOKUP语句，MATCH和WITH语句。
YIELD YIELD [DISTINCT] <col> [AS <alias>] [, <col> [AS <alias>] ...] [WHERE <conditions>]; GO FROM "player100" OVER follow YIELD dst(edge) AS ID | FETCH PROP ON player $-.ID YIELD player.age AS Age | YIELD AVG($-.Age) as Avg_age, count(*)as Num_friends 查找 player100 关注的 player，并计算他们的平均年龄。
WITH MATCH $expressions WITH {nodes()|labels()|...} MATCH p=(v:player{name:"Tim Duncan"})--() WITH nodes(p) AS n UNWIND n AS n1 RETURN DISTINCT n1 WITH子句可以获取并处理查询前半部分的结果，并将处理结果作为输入传递给查询的后半部分。
UNWIND UNWIND <list> AS <alias> <RETURN clause> UNWIND [1,2,3] AS n RETURN n 拆分列表。

图空间语句

语句 语法 示例 说明
CREATE SPACE CREATE SPACE [IF NOT EXISTS] <graph_space_name> ( [partition_num = <partition_number>,] [replica_factor = <replica_number>,] vid_type = {FIXED_STRING(<N>) | INT[64]} ) [COMMENT = '<comment>'] CREATE SPACE my_space_1 (vid_type=FIXED_STRING(30)) 创建一个新的图空间。
CREATE SPACE CREATE SPACE <new_graph_space_name> AS <old_graph_space_name> CREATE SPACE my_space_4 as my_space_3 克隆现有图空间的 Schema。
USE USE <graph_space_name> USE space1 指定一个图空间，或切换到另一个图空间，将其作为后续查询的工作空间。
SHOW SPACES SHOW SPACES SHOW SPACES 列出 NebulaGraph 示例中的所有图空间。
DESCRIBE SPACE DESC[RIBE] SPACE <graph_space_name> DESCRIBE SPACE basketballplayer 显示指定图空间的信息。
CLEAR SPACE CLEAR SPACE [IF EXISTS] <graph_space_name> 清空图空间中的点和边，但不会删除图空间本身以及其中的 Schema 信息。  
DROP SPACE DROP SPACE [IF EXISTS] <graph_space_name> DROP SPACE basketballplayer 删除指定图空间的所有内容。

TAG 语句

语句 语法 示例 说明
CREATE TAG CREATE TAG [IF NOT EXISTS] <tag_name> ( <prop_name> <data_type> [NULL | NOT NULL] [DEFAULT <default_value>] [COMMENT '<comment>'] [{, <prop_name> <data_type> [NULL | NOT NULL] [DEFAULT <default_value>] [COMMENT '<comment>']} ...] ) [TTL_DURATION = <ttl_duration>] [TTL_COL = <prop_name>] [COMMENT = '<comment>'] CREATE TAG woman(name string, age int, married bool, salary double, create_time timestamp) TTL_DURATION = 100, TTL_COL = "create_time" 通过指定名称创建一个 Tag。
DROP TAG DROP TAG [IF EXISTS] <tag_name> DROP TAG test; 删除当前工作空间内所有点上的指定 Tag。
ALTER TAG ALTER TAG <tag_name> <alter_definition> [, alter_definition] ...] [ttl_definition [, ttl_definition] ... ] [COMMENT = '<comment>'] ALTER TAG t1 ADD (p3 int, p4 string) 修改 Tag 的结构。例如增删属性、修改数据类型，也可以为属性设置、修改 TTL（Time-To-Live)。
SHOW TAGS SHOW TAGS SHOW TAGS 显示当前图空间内的所有 Tag 名称。
DESCRIBE TAG DESC[RIBE] TAG <tag_name> DESCRIBE TAG player 查看指定 Tag 的详细信息，例如字段名称、数据类型等。
DELETE TAG DELETE TAG <tag_name_list> FROM <VID> DELETE TAG test1 FROM "test" 删除指定点上的指定 Tag。

Edge type 语句

语句 语法 示例 说明
CREATE EDGE CREATE EDGE [IF NOT EXISTS] <edge_type_name> ( <prop_name> <data_type> [NULL | NOT NULL] [DEFAULT <default_value>] [COMMENT '<comment>'] [{, <prop_name> <data_type> [NULL | NOT NULL] [DEFAULT <default_value>] [COMMENT '<comment>']} ...] ) [TTL_DURATION = <ttl_duration>] [TTL_COL = <prop_name>] [COMMENT = '<comment>'] CREATE EDGE e1(p1 string, p2 int, p3 timestamp) TTL_DURATION = 100, TTL_COL = "p2" 指定名称创建一个 Edge type。
DROP EDGE DROP EDGE [IF EXISTS] <edge_type_name> DROP EDGE e1 删除当前工作空间内的指定 Edge type。
ALTER EDGE ALTER EDGE <edge_type_name> <alter_definition> [, alter_definition] ...] [ttl_definition [, ttl_definition] ... ] [COMMENT = '<comment>'] ALTER EDGE e1 ADD (p3 int, p4 string) 修改 Edge type 的结构。
SHOW EDGES SHOW EDGES SHOW EDGES 显示当前图空间内的所有 Edge type 名称。
DESCRIBE EDGE DESC[RIBE] EDGE <edge_type_name> DESCRIBE EDGE follow 查看指定 Edge type 的详细信息，例如字段名称、数据类型等。

点语句

语句 语法 示例 说明
INSERT VERTEX INSERT VERTEX [IF NOT EXISTS] [tag_props, [tag_props] ...] VALUES <vid>: ([prop_value_list]) INSERT VERTEX t2 (name, age) VALUES "13":("n3", 12), "14":("n4", 8) 在 NebulaGraph 实例的指定图空间中插入一个或多个点。
DELETE VERTEX DELETE VERTEX <vid> [, <vid> ...] DELETE VERTEX "team1" 删除点，以及点关联的出边和入边。
UPDATE VERTEX UPDATE VERTEX ON <tag_name> <vid> SET <update_prop> [WHEN <condition>] [YIELD <output>] UPDATE VERTEX ON player "player101" SET age = age + 2 修改点上 Tag 的属性值。
UPSERT VERTEX UPSERT VERTEX ON <tag> <vid> SET <update_prop> [WHEN <condition>] [YIELD <output>] UPSERT VERTEX ON player "player667" SET age = 31 结合UPDATE和INSERT，如果点存在，会修改点的属性值；如果点不存在，会插入新的点。

边语句

语句 语法 示例 说明
INSERT EDGE INSERT EDGE [IF NOT EXISTS] <edge_type> ( <prop_name_list> ) VALUES <src_vid> -> <dst_vid>[@<rank>] : ( <prop_value_list> ) [, <src_vid> -> <dst_vid>[@<rank>] : ( <prop_value_list> ), ...] INSERT EDGE e2 (name, age) VALUES "11"->"13":("n1", 1) 在 NebulaGraph 实例的指定图空间中插入一条或多条边。
DELETE EDGE DELETE EDGE <edge_type> <src_vid> -> <dst_vid>[@<rank>] [, <src_vid> -> <dst_vid>[@<rank>] ...] DELETE EDGE serve "player100" -> "team204"@0 删除边。一次可以删除一条或多条边。
UPDATE EDGE UPDATE EDGE ON <edge_type> <src_vid> -> <dst_vid> [@<rank>] SET <update_prop> [WHEN <condition>] [YIELD <output>] UPDATE EDGE ON serve "player100" -> "team204"@0 SET start_year = start_year + 1 修改边上 Edge type 的属性。
UPSERT EDGE UPSERT EDGE ON <edge_type> <src_vid> -> <dst_vid> [@rank] SET <update_prop> [WHEN <condition>] [YIELD <properties>] UPSERT EDGE on serve "player666" -> "team200"@0 SET end_year = 2021 结合UPDATE和INSERT，如果边存在，会更新边的属性；如果边不存在，会插入新的边。

索引

  • 原生索引

    索引配合LOOKUP和MATCH语句使用。

    语句 语法 示例 说明
    CREATE INDEX CREATE {TAG | EDGE} INDEX [IF NOT EXISTS] <index_name> ON {<tag_name> | <edge_name>} ([<prop_name_list>]) [COMMENT = '<comment>'] CREATE TAG INDEX player_index on player() 对 Tag、EdgeType 或其属性创建原生索引。
    SHOW CREATE INDEX SHOW CREATE {TAG | EDGE} INDEX <index_name> show create tag index index_2 创建 Tag 或者 Edge type 时使用的 nGQL 语句，其中包含索引的详细信息，例如其关联的属性。
    SHOW INDEXES SHOW {TAG | EDGE} INDEXES SHOW TAG INDEXES 列出当前图空间内的所有 Tag 和 Edge type（包括属性）的索引。
    DESCRIBE INDEX DESCRIBE {TAG | EDGE} INDEX <index_name> DESCRIBE TAG INDEX player_index_0 查看指定索引的信息，包括索引的属性名称（Field）和数据类型（Type）。
    REBUILD INDEX REBUILD {TAG | EDGE} INDEX [<index_name_list>] REBUILD TAG INDEX single_person_index 重建索引。索引功能不会自动对其创建之前已存在的存量数据生效。
    SHOW INDEX STATUS SHOW {TAG | EDGE} INDEX STATUS SHOW TAG INDEX STATUS 查看索引名称和对应的状态。
    DROP INDEX DROP {TAG | EDGE} INDEX [IF EXISTS] <index_name> DROP TAG INDEX player_index_0 删除当前图空间中已存在的索引。

  • 全文索引

    语法 示例 说明
    SIGN IN TEXT SERVICE [(<elastic_ip:port> [,<username>, <password>]), (<elastic_ip:port>), ...] SIGN IN TEXT SERVICE (127.0.0.1:9200) NebulaGraph 的全文索引是基于 Elasticsearch 实现，部署 Elasticsearch 集群之后，可以使用SIGN IN语句登录 Elasticsearch 客户端。
    SHOW TEXT SEARCH CLIENTS SHOW TEXT SEARCH CLIENTS 列出文本搜索客户端。
    SIGN OUT TEXT SERVICE SIGN OUT TEXT SERVICE 退出所有文本搜索客户端。
    CREATE FULLTEXT {TAG | EDGE} INDEX <index_name> ON {<tag_name> | <edge_name>} (<prop_name> [,<prop_name>]...) [ANALYZER="<analyzer_name>"] CREATE FULLTEXT TAG INDEX nebula_index_1 ON player(name) 创建全文索引。
    SHOW FULLTEXT INDEXES SHOW FULLTEXT INDEXES 显示全文索引。
    REBUILD FULLTEXT INDEX REBUILD FULLTEXT INDEX 重建全文索引。
    DROP FULLTEXT INDEX <index_name> DROP FULLTEXT INDEX nebula_index_1 删除全文索引。
    LOOKUP ON {<tag> | <edge_type>} WHERE ES_QUERY(<index_name>, "<text>") YIELD <return_list> [| LIMIT [<offset>,] <number_rows>] LOOKUP ON player WHERE ES_QUERY(fulltext_index_1,"Chris") YIELD id(vertex) 使用查询选项。

子图和路径

类型 语法 示例 说明
子图 GET SUBGRAPH [WITH PROP] [<step_count> {STEP|STEPS}] FROM {<vid>, <vid>...} [{IN | OUT | BOTH} <edge_type>, <edge_type>...] YIELD [VERTICES AS <vertex_alias>] [,EDGES AS <edge_alias>] GET SUBGRAPH 1 STEPS FROM "player100" YIELD VERTICES AS nodes, EDGES AS relationships 指定 Edge type 的起始点可以到达的点和边的信息，返回子图信息。
路径 FIND { SHORTEST | ALL | NOLOOP } PATH [WITH PROP] FROM <vertex_id_list> TO <vertex_id_list> OVER <edge_type_list> [REVERSELY | BIDIRECT] [<WHERE clause>] [UPTO <N> {STEP|STEPS}] YIELD path as <alias> [| ORDER BY $-.path] [| LIMIT <M>] FIND SHORTEST PATH FROM "player102" TO "team204" OVER * YIELD path as p 查找指定起始点和目的点之间的路径。返回的路径格式类似于(<vertex_id>)-[:<edge_type_name>@<rank>]->(<vertex_id)。

查询调优

类型 语法 示例 说明
EXPLAIN EXPLAIN [format="row" | "dot"] <your_nGQL_statement> EXPLAIN format="row" SHOW TAGS
EXPLAIN format="dot" SHOW TAGS		 输出 nGQL 语句的执行计划，但不会执行 nGQL 语句。
PROFILE PROFILE [format="row" | "dot"] <your_nGQL_statement> PROFILE format="row" SHOW TAGS
PROFILE format="dot" SHOW TAGS		 执行 nGQL 语句，然后输出执行计划和执行概要。
posted @ 2026-01-06 22:23  BlogMemory  阅读(2)  评论(0)    收藏  举报