Merge 3.3 to master (#2387)

* Merge to v3.3.0 * Update mkdocs.yml * Update deploy.yaml * update * Update deploy.yaml * Update 0.FAQ.md (#2290) * Update mkdocs.yml * Update mkdocs.yml * Update deploy.yaml * Update mkdocs.yml * chore: enable algolia search (#2293) * Update mkdocs.yml * Fix favicon * Fix favicon (#2295) * fix: missing file causing doc search issue (#2296) * Update 1.what-is-dashboard.md * Update 2.deploy-dashboard.md * Update 4.use-dashboard.md * Update 2.deploy-dashboard.md * Update 2.deploy-connect-dashboard-ent.md * Update 4.use-dashboard.md * Update 2.monitor.md * Update ex-ug-deploy.md * Update nebula-analytics.md * Update ex-ug-connect.md * Update nebula-analytics.md * add notice for nebulagraph algorithm sink:nebula (#2292) * Update nebula-algorithm.md * Update nebula-algorithm.md * Update nebula-comm-release-note.md (#2297) * Update ex-ug-what-is-explorer.md * Update ex-ug-what-is-exchange.md * Update explorer-release-note.md * Update 2.deploy-connect-dashboard-ent.md * Update 2.deploy-connect-dashboard-ent.md * Update ex-ug-deploy.md * Update st-ug-limitations.md * add note for multiple data storage directories (#2298) * add note for multiple data storage directories * comment fix * Update 0.FAQ.md * Update mkdocs.yml * Update mkdocs.yml (#2299) * Update 6.eco-tool-version.md (#2300) * update dashboard and explorer (#2302) * Update ex-ug-connect.md * Update ex-ug-what-is-exchange.md (#2303) * Update 3.vid.md (#2304) * Update 1.prepare-resources.md (#2305) * Update 1.prepare-resources.md * Update 1.prepare-resources.md * highlight on bulk edge where filtering expression * highlight on bulk edge where filtering expression (#2306) * explorer removes dependence on studio (#2311) * add-usage-for-length()-and-size() (#2312) * Update 6.cheatsheet-for-ngql-command.md (#2313) * subgraph: add filter condition example (#2310) * subgraph: add filter condition example * chore: spacing fix * format: line break added * Update 10.create-schema.md * Update 11.import-data.md * update workflow (#2314) * Update ex-ug-deploy.md * Update ex-ug-deploy.md * Update ex-ug-deploy.md * dashboard update create cluster (#2316) * Update 2.balance-syntax.md (#2318) * Update error-code.md (#2319) * fixed full-text index prefix (#2320) * Add-collect()-examples (#2321) * move std() sum() to aggregating functions (#2322) * Modify tagless (#2323) * add hdfs error for dag (#2326) * Update error-code.md * Add hdfs error for dag (#2327) * add hdfs error for dag * update * Update 1.prepare-resources.md * update ngql template (#2329) * Update ngql-template.md * Update ex-ug-connect.md * Update optional-match.md (#2331) * merge helm in studio doc (#2333) * Update st-ug-deploy.md * Update source_manage-service.md (#2334) * fix link * update * wrong link of snapshot * br-release-3.3.0 (#2335) * Remove docker (#2337) * remove docker from local deployment * Update source_ngql_for_quick_start.md * Update docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md Co-authored-by: abby.huang <[email protected]> * update Co-authored-by: abby.huang <[email protected]> * fix links (#2338) * Fix links 2 (#2339) * fix links * update * Update group-by.md (#2336) * Update group-by.md * add example for group by to explain its implicit usage * Update group-by.md * Update group-by.md * Update group-by.md * Update group-by.md * Update group-by.md * Update group-by.md * Update group-by.md * update TIMESTAMP (#2341) * add-example-for-getting-vertex/edge-without-specifying-tag/edge-type (#2340) * add-example-for-getting-vertex/edge-without-specifying-tag/edge-type * Update 6.cheatsheet-for-ngql-command.md * Update 6.cheatsheet-for-ngql-command.md * Add example for getting vertex/edge without specifying tag/edge type (#2342) * add-example-for-getting-vertex/edge-without-specifying-tag/edge-type * Update 6.cheatsheet-for-ngql-command.md * Update 6.cheatsheet-for-ngql-command.md * Update 2.match.md * Update 2.deploy-connect-dashboard-ent.md (#2343) * Update 2.deploy-connect-dashboard-ent.md * Dashboard update 3.2.2 (#2345) * dashboard update 3.2.2 * update * add-note-for-arm (#2348) * update-cloud-for-quick-start (#2347) * Br community opts (#2351) * br-community-opts * Update 3.br-backup-data.md * Update 2.compile-br.md * mistake in rebuild index config it should be rebuild_index_batch_size instead of snapshot_batch_size * why-space-0-not-found (#2352) * Why space 0 not found (#2353) * why-space-0-not-found * Update upgrade-nebula-graph-to-latest.md * Br community opts (#2354) * br-community-opts * Update 3.br-backup-data.md * Update 2.compile-br.md * Update 1.what-is-br.md * Update upgrade-nebula-from-300-to-latest.md * Update README.md (#2355) * startNode()-&-endNode()-don't-return-prop-via-edges- (#2358) * Add release notes on the default page (#2361) * Update README.md * Update README.md * Update README.md * Update 1.resource-preparations.md (#2356) * Update 1.resource-preparations.md * list supporting operating systems * Update 3.go.md (#2362) * Update 4.schema.md (#2365) * Wording revision of schema related functions (#2366) * Update 4.schema.md * comments fix * dashboard release 3.2.3 (#2367) * Update ex-ug-deploy.md * timestamp()-supports-int (#2368) * timestamp()-supports-int * Update 4.date-and-time.md * Update 1.resource-preparations.md (#2372) * Update 5.lookup.md (#2373) * Update 10.create-schema.md * Update source_connect-to-nebula-graph.md (#2374) * Update ex-ug-what-is-explorer.md * exchange update faq (#2376) * Update 2.compile-br.md (#2377) * dashboard release 3.2.4 (#2378) * explorer release 3.2.1 (#2379) * Update algorithm-description.md (#2380) * Fix broken link * Let it snow * Stop snowing * Update nebula-analytics.md * Update 1.get-subgraph.md (#2382) * Update 4.schema.md (#2384) * Update 4.schema.md * Update docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md Co-authored-by: cooper-lzy <[email protected]> * Update docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md Co-authored-by: cooper-lzy <[email protected]> * Update 4.schema.md Co-authored-by: cooper-lzy <[email protected]> * Update 3.connect-dashboard.md * Update 3.go.md (#2383) * Update 2.match.md (#2385) * Update 2.match.md * Update 2.match.md * Update 2.match.md * Update 2.match.md * Update 2.match.md * Update 2.match.md * Update 2.match.md * Unified dashboard directory structure (#2386) * Update 3.connect-dashboard.md * update Co-authored-by: abby.huang <[email protected]> Co-authored-by: cooper-lzy <[email protected]> Co-authored-by: Wey Gu <[email protected]> Co-authored-by: randomJoe211 <[email protected]> Co-authored-by: Jerry Liang <[email protected]> Co-authored-by: jingchun.xia <[email protected]>
vesoft-inc · Dec 15, 2022 · ef9459f · ef9459f
1 parent 015c04e
commit ef9459f
Show file tree

Hide file tree

Showing 81 changed files with 1,201 additions and 775 deletions.
diff --git a/docs-2.0/1.introduction/3.nebula-graph-architecture/4.storage-service.md b/docs-2.0/1.introduction/3.nebula-graph-architecture/4.storage-service.md
@@ -80,7 +80,7 @@ NebulaGraph 使用自行开发的 KVStore，而不是其他开源 KVStore，原
 
 - 点数据存储格式
 
-  相比 NebulaGraph 2.x 版本，3.x 版本的每个点多了一个不含 TagID 字段并且无 value 的 key，用于支持无 Tag 的点。
+  相比 NebulaGraph 2.x 版本，3.x 版本在开启**无 Tag** 的点配置后，每个点多了一个不含 TagID 字段并且无 value 的 key。
 
     ![The vertex format of storage service](https://docs-cdn.nebula-graph.com.cn/figures/3.0-vertex-key.png)
 

diff --git a/docs-2.0/1.introduction/3.vid.md b/docs-2.0/1.introduction/3.vid.md
@@ -24,9 +24,9 @@
 
 - NebulaGraph 1.x 只支持 VID 类型为`INT64`，从 2.x 开始支持`INT64`和`FIXED_STRING(<N>)`。在`CREATE SPACE`中通过参数`vid_type`可以指定 VID 类型。
 
-- 可以使用`id()`函数，指定或引用该点的 VID；
+- 可以使用`id()`函数，指定或引用该点的 VID。
 
-- 可以使用`LOOKUP`或者`MATCH`语句，来通过属性索引查找对应的 VID;
+- 可以使用`LOOKUP`或者`MATCH`语句，来通过属性索引查找对应的 VID。
 
 - 性能上，直接通过 VID 找到点的语句性能最高，例如`DELETE xxx WHERE id(xxx) == "player100"`，或者`GO FROM "player100"`等语句。通过属性先查找 VID，再进行图操作的性能会变差，例如`LOOKUP | GO FROM $-.ids`等语句，相比前者多了一次内存或硬盘的随机读（`LOOKUP`）以及一次序列化（`|`）。
 
@@ -38,7 +38,7 @@ VID 的生成工作完全交给应用端，有一些通用的建议：
 
 - 通过有唯一性的属性组合来生成 VID，属性访问依赖于属性索引。
 
-- 通过 snowflake 等算法生成 VID，属性访问依赖于属性索引；
+- 通过 snowflake 等算法生成 VID，属性访问依赖于属性索引。
 
 - 如果个别记录的主键特别长，但绝大多数记录的主键都很短的情况，不要将`FIXED_STRING(<N>)`的`N`设置成超大，这会浪费大量内存和硬盘，也会降低性能。此时可通过 BASE64，MD5，hash 编码加拼接的方式来生成。
 

diff --git a/docs-2.0/2.quick-start/2.quick-start-on-cloud/2.connect-to-nebulagraph-on-cloud.md b/docs-2.0/2.quick-start/2.quick-start-on-cloud/2.connect-to-nebulagraph-on-cloud.md
@@ -19,12 +19,12 @@
 
 3. 在实例列表中，单击目标实例的**服务实例ID**，或其右侧**操作**列的**详情**。
 
-4. 在**概览**页签的**基本信息**区域，查看**graph_private_ip**及**explorer_portal**信息。
+4. 在**概览**页签的**基本信息**区域，查看**nebula_private_ip**及**explorer_portal**信息。
 
 5. 单击**explorer_portal**对应链接，进入 NebulaGraph Explorer 登录页面。
 6. 填写登录信息，单击**登录**。
 
-  - **Host**：`graph_private_ip地址:9669`，例如`192.168.98.160:9669`。
+  - **Host**：`nebula_private_ip地址:9669`，例如`192.168.98.160:9669`。
   - **用户名**：`root`。
   - **密码**：任意密码。
 

diff --git a/docs-2.0/2.quick-start/6.cheatsheet-for-ngql-command.md b/docs-2.0/2.quick-start/6.cheatsheet-for-ngql-command.md
@@ -31,7 +31,7 @@
   | bit_and()                               | 逐位做 AND 操作。                                              |
   | bit_or()                                | 逐位做 OR 操作。                                               |
   | bit_xor()                               | 逐位做 XOR 操作。                                              |
-  | int size()                              | 返回列表或映射中元素的数量。                                 |
+  | int size()                              | 返回列表或映射中元素的数量，或字符串的长度。                                 |
   | int range(int start, int end, int step) | 返回`[start,end]`中指定步长的值组成的列表。步长`step`默认为 1。 |
   | int sign(double x)                      | 返回 x 的正负号。 如果 x 为`0`，则返回`0`。 如果 x 为负数，则返回`-1`。 如果 x 为正数，则返回`1`。 |
   | double e()                              | 返回自然对数的底 e（2.718281828459045）。                     |
@@ -61,7 +61,7 @@
   | string toLower(string a)                        | 和`lower()`相同。                                            |
   | string upper(string a)                          | 返回大写形式的字符串。                                       |
   | string toUpper(string a)                        | 和`upper()`相同。                                            |
-  | int length(string a)                            | 以字节为单位，返回给定字符串的长度。                         |
+  | int length(a)                                   | 返回给定字符串的长度或路径的长度，单位分别是字节和跳数。                         |
   | string trim(string a)                           | 删除字符串头部和尾部的空格。                                 |
   | string ltrim(string a)                          | 删除字符串头部的空格。                                       |
   | string rtrim(string a)                          | 删除字符串尾部的空格。                                       |
@@ -84,13 +84,13 @@
 
   | 函数                  | 说明                                        |
   | :-------------------- | :------------------------------------------ |
-  | int now()             | 根据当前系统返回当前时区的时间戳。          |
-  | timestamp timestamp() | 根据当前系统返回当前时区的时间戳。          |
+  | int now()             | 根据当前系统返回当前时间戳。          |
+  | timestamp timestamp() | 根据当前系统返回当前时间戳。          |
   | date date()           | 根据当前系统返回当前日期（UTC 时间）。       |
   | time time()           | 根据当前系统返回当前时间（UTC 时间）。       |
   | datetime datetime()   | 根据当前系统返回当前日期和时间（UTC 时间）。 |
 
-* [Schema 函数](../3.ngql-guide/6.functions-and-expressions/4.schema.md)
+* [Schema 相关函数](../3.ngql-guide/6.functions-and-expressions/4.schema.md)
 
   * 原生 nGQL 语句适用
 
@@ -186,14 +186,14 @@
   | 匹配点                      | `(v)`                                                        | 用户可以在一对括号中使用自定义变量来表示模式中的点。例如`(v)`。 |
   | 匹配 Tag                     | `MATCH (v:player) RETURN v`                                  | 用户可以在点的右侧用`:<tag_name>`表示模式中的 Tag。           |
     | 匹配多 Tag                     | `MATCH (v:player:team) RETURN v LIMIT 10`                                  | 用户可以用英文冒号（:）匹配多 Tag 的点。           |
-  | 匹配点的属性                | `MATCH (v:player{name:"Tim Duncan"}) RETURN v`               | 用户可以在 Tag 的右侧用`{<prop_name>: <prop_value>}`表示模式中点的属性。 |
+  | 匹配点的属性                | `MATCH (v:player{name:"Tim Duncan"}) RETURN v` <br><br>`MATCH (v) WITH v, properties(v) as props, keys(properties(v)) as kk LIMIT 10000 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`<br>`MATCH ()<-[e]-()   RETURN e   LIMIT 3`      | 除了用`--`、`-->`、`<--`表示未命名的边之外，用户还可以在方括号中使用自定义变量命名边。例如`-[e]-`。 |
   | 匹配 Edge type              | `MATCH ()-[e:follow]->() RETURN e LIMIT 5`                            | 和点一样，用户可以用`:<edge_type>`表示模式中的 Edge type，例如`-[e:follow]-`。 |
-  | 匹配边的属性                | ` MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) RETURN e` | 用户可以用`{<prop_name>: <prop_value>}`表示模式中 Edge type 的属性，例如`[e:follow{likeness:95}]`。 |
+  | 匹配边的属性                | ` MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) RETURN e` <br><br>`MATCH ()-[e]->() WITH e, properties(e) as props, keys(properties(e)) as kk LIMIT 10000 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`的数据类型是列表。 |

diff --git a/docs-2.0/20.appendix/0.FAQ.md b/docs-2.0/20.appendix/0.FAQ.md
@@ -389,9 +389,9 @@ NebulaGraph {{ nebula.release }} 未提供运维命令以实现自动扩缩容
 
 |服务类型|端口|
 |-|-|
-|Meta|9559, 9560, 19559, 19560|
-|Graph|9669, 19669, 19670|
-|Storage|9777 ~ 9780, 19779, 19780|
+|Meta|9559, 9560, 19559|
+|Graph|9669, 19669|
+|Storage|9777 ~ 9780, 19779|
 
 如果修改过配置文件中预设的端口，请找出实际使用的端口并在防火墙中开放它们。
 

diff --git a/docs-2.0/20.appendix/6.eco-tool-version.md b/docs-2.0/20.appendix/6.eco-tool-version.md
@@ -154,6 +154,17 @@ Docker Compose 可以快速部署 NebulaGraph 集群。如何使用请参见 [Do
 |:---|:---|
 | {{ nebula.tag }}  | {{br.tag}}|
 
+{{ent.ent_begin}}
+## Backup & Restore (企业版)
+
+[Backup&Restore](../backup-and-restore/nebula-br-ent/1.br-ent-overview.md) 企业版是一款命令行界面（CLI）工具。通过 NebulaGraph BR（企业版），用户可以备份 NebulaGraph 企业版数据，并基于备份目录进行数据恢复。
+
+|NebulaGraph 版本|BR 版本|
+|:---|:---|
+| {{ nebula.tag }}  | {{br_ent.tag}}|
+
+{{ent.ent_end}}
+
 ## NebulaGraph Bench
 
 [NebulaGraph Bench](https://github.com/vesoft-inc/nebula-bench/releases/tag/{{bench.tag}}) 用于测试 NebulaGraph 的基线性能数据，使用 LDBC v0.3.3 的标准数据集。