Merge 3.3 to master

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)
 

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 编码加拼接的方式来生成。
 

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`。
   - **密码**：任意密码。
 

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`的数据类型是列表。 |

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|
 
 如果修改过配置文件中预设的端口，请找出实际使用的端口并在防火墙中开放它们。
 

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 的标准数据集。