From 04602f3c196b6a8c2f0c46c4de9c559981f19eff Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 14:41:56 +0800 Subject: [PATCH 1/7] Update 2.match.md --- .../3.ngql-guide/7.general-query-statements/2.match.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index 757c7053b5b..c08ad46fa56 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -32,7 +32,7 @@ MATCH [] RETURN []; - 当遍历所有点边时，例如`MATCH (v) RETURN v LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 -- 当遍历指定 Tag 的点或指定 Edge Type 的边时，例如`MATCH (v:player) RETURN v LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 +- 当遍历指定 Tag 的点或指定 Edge Type 的边时，例如`MATCH (v:player) RETURN v LIMIT N`或`MATCH ()-[e:follow]->() RETURN e LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 !!! note @@ -41,6 +41,11 @@ MATCH [] RETURN []; !!! compatibility "历史版本兼容性" 从 3.0.0 版本开始，为了区别不同 Tag 的属性，返回属性时必须额外指定 Tag 名称。即从`RETURN <变量名>.<属性名>`改为`RETURN <变量名>..<属性名>`。 + +!!! caution + + 在不创建索引的情况下，可能会出现不符合直觉的返回结果，建议使用`Match`语句时创建**至少**一个[索引](../14.native-index-statements/1.create-native-index.md)。 + ## 示例 From ab17e22b294f5f676aac6a0ea13334f17ebf7e82 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 14:51:21 +0800 Subject: [PATCH 2/7] Update 2.match.md --- docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index c08ad46fa56..bd10e327eae 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -36,15 +36,13 @@ MATCH [] RETURN []; !!! note - 目前 MATCH 语句无法查询到悬挂边。 + - 目前 MATCH 语句无法查询到悬挂边。 + - 不支持没有索引时同时遍历指定的 Tag 或 EdgeType，例如执行`MATCH (v:player)-[e:follow]->() RETURN e LIMIT N`会报错。 !!! compatibility "历史版本兼容性" 从 3.0.0 版本开始，为了区别不同 Tag 的属性，返回属性时必须额外指定 Tag 名称。即从`RETURN <变量名>.<属性名>`改为`RETURN <变量名>..<属性名>`。 - -!!! caution - 在不创建索引的情况下，可能会出现不符合直觉的返回结果，建议使用`Match`语句时创建**至少**一个[索引](../14.native-index-statements/1.create-native-index.md)。 ## 示例 From af28959ac09fe8d60c2c2b7c1e9c5aa573bd5b55 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 14:52:31 +0800 Subject: [PATCH 3/7] Update 2.match.md --- docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index bd10e327eae..babd908b803 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -37,7 +37,7 @@ MATCH [] RETURN []; !!! note - 目前 MATCH 语句无法查询到悬挂边。 - - 不支持没有索引时同时遍历指定的 Tag 或 EdgeType，例如执行`MATCH (v:player)-[e:follow]->() RETURN e LIMIT N`会报错。 + - 不支持没有索引时同时遍历指定的 Tag 和 Edge Type，例如执行`MATCH (v:player)-[e:follow]->() RETURN e LIMIT N`会报错。 !!! compatibility "历史版本兼容性" From 345665155daa22d8cfd39d8b8ac04c2abf565fe4 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 14:57:43 +0800 Subject: [PATCH 4/7] Update 2.match.md --- docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index babd908b803..e56bd076f1f 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -32,7 +32,7 @@ MATCH [] RETURN []; - 当遍历所有点边时，例如`MATCH (v) RETURN v LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 -- 当遍历指定 Tag 的点或指定 Edge Type 的边时，例如`MATCH (v:player) RETURN v LIMIT N`或`MATCH ()-[e:follow]->() RETURN e LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 +- 当遍历指定 Tag 的点或指定方向及 Edge Type 的边时，例如`MATCH (v:player) RETURN v LIMIT N`或`MATCH ()-[e:follow]->() RETURN e LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 !!! note From 395f57f2485bb46345e852f7767f146465cee1a0 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 15:43:32 +0800 Subject: [PATCH 5/7] Update 2.match.md --- .../3.ngql-guide/7.general-query-statements/2.match.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index e56bd076f1f..8e3b4f09686 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -26,13 +26,15 @@ MATCH [] RETURN []; ## 注意事项 -除以下三种情况之外，请确保 `MATCH` 语句有**至少**一个[索引](../14.native-index-statements/1.create-native-index.md)可用。 +未创建[索引](../14.native-index-statements/1.create-native-index.md)时，仅以下情况支持使用`MATCH`查询。当`MATCH`语句出现报错时，用户可以创建并重建索引后执行该语句。 - `MATCH`语句中`WHERE`子句使用 id() 函数指定了点的 VID，不需要创建索引即可执行。 -- 当遍历所有点边时，例如`MATCH (v) RETURN v LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 +- 当遍历所有点或边时，例如`MATCH (v) RETURN v LIMIT N`、`MATCH ()-[e]->() RETURN e LIMIT N`。 -- 当遍历指定 Tag 的点或指定方向及 Edge Type 的边时，例如`MATCH (v:player) RETURN v LIMIT N`或`MATCH ()-[e:follow]->() RETURN e LIMIT N`，不需要创建索引，但必须使用`LIMIT`限制输出结果数量。 +- 当遍历指定 Tag 的点，例如`MATCH (v:player) RETURN v LIMIT N`。 + +- 当遍历指定 Edge Type 并指定边的方向，例如`MATCH ()-[e:follow]->() RETURN e LIMIT N`。 !!! note From f4883ce84c26bfa6fe4451a78cefb128bba7ab20 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 15:48:59 +0800 Subject: [PATCH 6/7] Update 2.match.md --- docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index 8e3b4f09686..f3ec81247e3 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -26,7 +26,7 @@ MATCH [] RETURN []; ## 注意事项 -未创建[索引](../14.native-index-statements/1.create-native-index.md)时，仅以下情况支持使用`MATCH`查询。当`MATCH`语句出现报错时，用户可以创建并重建索引后执行该语句。 +未创建[索引](../14.native-index-statements/1.create-native-index.md)时，仅以下情况支持使用`MATCH`查询。当`MATCH`语句出现报错时，用户可以创建并重建索引后执行查询语句。 - `MATCH`语句中`WHERE`子句使用 id() 函数指定了点的 VID，不需要创建索引即可执行。 From b44c134215dcc59215a2f71868d951a970252960 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 14 Dec 2022 16:04:21 +0800 Subject: [PATCH 7/7] Update 2.match.md --- docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index f3ec81247e3..8e8d90101cb 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -24,9 +24,9 @@ MATCH [] RETURN []; - `clause_2`：支持`ORDER BY`、`LIMIT`子句。 -## 注意事项 +## 使用限制 -未创建[索引](../14.native-index-statements/1.create-native-index.md)时，仅以下情况支持使用`MATCH`查询。当`MATCH`语句出现报错时，用户可以创建并重建索引后执行查询语句。 +未创建[索引](../14.native-index-statements/1.create-native-index.md)时，仅以下情况支持使用`MATCH`查询。当使用`MATCH`语句出现报错时，用户可以创建并重建索引后执行查询语句。 - `MATCH`语句中`WHERE`子句使用 id() 函数指定了点的 VID，不需要创建索引即可执行。