Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merge from 3.4.1 #2644

Merged
merged 1 commit into from
Mar 13, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs-2.0/1.introduction/3.vid.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 点 VID

在 NebulaGraph 中,一个点由点的 ID 唯一标识,即 VID 或 Vertex ID。
在一个图空间中,一个点由点的 ID 唯一标识,即 VID 或 Vertex ID。

## VID 的特点

Expand Down
2 changes: 1 addition & 1 deletion docs-2.0/2.quick-start/1.quick-start-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,11 @@

![docker-update](https://docs-cdn.nebula-graph.com.cn/figures/docker-update.png)


视频介绍

<iframe src="//player.bilibili.com/player.html?bvid=BV1NA411y7Uy&cid=1028726635&page=1&high_quality=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" width="720px" height="480px"> </iframe>


## 云上部署

### 使用流程图
Expand Down
8 changes: 7 additions & 1 deletion docs-2.0/20.appendix/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,10 @@

9. 2022.2 发布 v3.0.0

10. 2022.4 发布 v3.1.0
10. 2022.4 发布 v3.1.0

11. 2022.7 发布 v3.2.0

12. 2022.10 发布 v3.3.0

13. 2023.2 发布 v3.4.0
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# NebulaGraph Dashboard 企业版更新说明

## 企业版 v3.4.1

- 缺陷修复

- 修复 RPM 包因为权限问题无法执行 `nebula-agent` 的问题。
- 修复 goconfig 文件夹权限问题导致无法查看集群导入信息的问题。
- 修复当许可证过期时间小于`30`天且`gracePeriod`大于`0`时页面提示错误的问题。

## 企业版 v3.4.0

- 功能
Expand Down
62 changes: 3 additions & 59 deletions docs-2.0/20.appendix/release-notes/nebula-comm-release-note.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,11 @@
# NebulaGraph 社区版 {{ nebula.release }} release notes

## 功能

- 支持[终止会话](../../3.ngql-guide/17.query-tuning-statements/2.kill-session.md)。[#5146](https://github.com/vesoft-inc/nebula/pull/5146)
- 支持 [Memory Tracker](../../5.configurations-and-logs/1.configurations/4.storage-config.md),优化内存管理。[#5082](https://github.com/vesoft-inc/nebula/pull/5082)

## 优化

- 优化作业管理。 [#5212](https://github.com/vesoft-inc/nebula/pull/5212) [#5093](https://github.com/vesoft-inc/nebula/pull/5093) [#5099](https://github.com/vesoft-inc/nebula/pull/5099) [#4872](https://github.com/vesoft-inc/nebula/pull/4872)

- 修改 Graph 服务配置参数`session_reclaim_interval_secs`的默认值更改为 60 秒。 [#5246](https://github.com/vesoft-inc/nebula/pull/5246)

- 调整配置文件中`stderrthreshold`的默认级别。 [#5188](https://github.com/vesoft-inc/nebula/pull/5188)

- 优化全文索引。 [#5077](https://github.com/vesoft-inc/nebula/pull/5077) [#4900](https://github.com/vesoft-inc/nebula/pull/4900) [#4925](https://github.com/vesoft-inc/nebula/pull/4925)

- 限制优化器中计划树的最大深度以避免堆栈溢出。 [#5050](https://github.com/vesoft-inc/nebula/pull/5050)

- 优化模式表达式作为谓词时的处理方案。 [#4916](https://github.com/vesoft-inc/nebula/pull/4916)

## 缺陷修复

- 修复查询计划生成与优化时的问题。 [#4863](https://github.com/vesoft-inc/nebula/pull/4863) [#4813](https://github.com/vesoft-inc/nebula/pull/4813)

- 修复索引相关的缺陷:

- 全文索引 [#5214](https://github.com/vesoft-inc/nebula/pull/5214) [#5260](https://github.com/vesoft-inc/nebula/pull/5260)
- 字符串索引 [5126](https://github.com/vesoft-inc/nebula/pull/5126)

- 修复查询语句的缺陷:

- 变量 [#5192](https://github.com/vesoft-inc/nebula/pull/5192)
- 过滤条件和表达式 [#4952](https://github.com/vesoft-inc/nebula/pull/4952) [#4893](https://github.com/vesoft-inc/nebula/pull/4893) [#4863](https://github.com/vesoft-inc/nebula/pull/4863)
- 点或边的属性 [#5230](https://github.com/vesoft-inc/nebula/pull/5230) [#4846](https://github.com/vesoft-inc/nebula/pull/4846) [#4841](https://github.com/vesoft-inc/nebula/pull/4841) [#5238](https://github.com/vesoft-inc/nebula/pull/5238)
- 函数与聚合 [#5135](https://github.com/vesoft-inc/nebula/pull/5135) [#5121](https://github.com/vesoft-inc/nebula/pull/5121) [#4884](https://github.com/vesoft-inc/nebula/pull/4884)
- 使用非法的数据类型 [#5242](https://github.com/vesoft-inc/nebula/pull/5242)
- 子句与算子 [#5241](https://github.com/vesoft-inc/nebula/pull/5241) [#4965](https://github.com/vesoft-inc/nebula/pull/4965)

- 修复 DDL 和 DML 语句相关的缺陷:

- ALTER TAG [#5105](https://github.com/vesoft-inc/nebula/pull/5105) [#5136](https://github.com/vesoft-inc/nebula/pull/5136)
- UPDATE [#4933](https://github.com/vesoft-inc/nebula/pull/4933)

- 修复其它功能的缺陷:

- TTL [#4961](https://github.com/vesoft-inc/nebula/pull/4961)
- 身份验证 [#4885](https://github.com/vesoft-inc/nebula/pull/4885)
- 服务 [#4896](https://github.com/vesoft-inc/nebula/pull/4896)

## 变更
- 修复参数表达式编码到存储层执行时导致崩溃的问题。 [#5336](https://github.com/vesoft-inc/nebula/pull/5336)

- 新增的属性名不能与已存在或被删除的属性名同名,否则新增属性会失败。 [#5130](https://github.com/vesoft-inc/nebula/pull/5130)
- 限制修改 Schema 时的类型转换。 [#5098](https://github.com/vesoft-inc/nebula/pull/5098)
- 创建`NOT NULL`类型的属性时,必须指定默认值。 [#5105](https://github.com/vesoft-inc/nebula/pull/5105)
- 在配置文件中添加多线程查询参数`query_concurrently`,默认值为`true`。 [#5119](https://github.com/vesoft-inc/nebula/pull/5119)
- 从配置文件中改移除 KV 分离存储功能参数`kv_separation`,默认关闭该功能。 [#5119](https://github.com/vesoft-inc/nebula/pull/5119)
- 修改配置文件中`local_config`的默认值为`true`。 [#5119](https://github.com/vesoft-inc/nebula/pull/5119)
- 统一使用`v.tag.property`的方式获取属性值,需要指明 Tag。使用`v.property`的方式访问`v`点上某个 Tag 的属性在之前的版本中被错误地允许。 [#5230](https://github.com/vesoft-inc/nebula/pull/5230)
- 删除命令`SHOW HOSTS`中的`HTTP port`列。 [#5056](https://github.com/vesoft-inc/nebula/pull/5056)
- 禁用`OPTIONAL MATCH <pattern> WHERE <condition>`形式的查询。 [#5273](https://github.com/vesoft-inc/nebula/pull/5273)
- 禁用 TOSS。 [#5119](https://github.com/vesoft-inc/nebula/pull/5119)
- 重命名 Listener 的 pid 文件名和 log 目录名。 [#5119](https://github.com/vesoft-inc/nebula/pull/5119)
- 修复一些列表函数的崩溃问题。 [#5383](https://github.com/vesoft-inc/nebula/pull/5383)

## 历史版本

[历史版本](https://nebula-graph.com.cn/tags/release-note/)
[历史版本](https://www.nebula-graph.com.cn/tags/%E5%8F%91%E7%89%88%E8%AF%B4%E6%98%8E)
85 changes: 3 additions & 82 deletions docs-2.0/20.appendix/release-notes/nebula-ent-release-note.md
Original file line number Diff line number Diff line change
@@ -1,90 +1,11 @@
# NebulaGraph 企业版 {{ nebula.release }} release notes

## 功能

- 支持[增量备份](../../backup-and-restore/nebula-br-ent/1.br-ent-overview.md)。
- 支持 Tag/Edge type 级别的[细粒度权限管理](../../7.data-security/1.authentication/3.role-list.md)。
- 支持[终止会话](../../3.ngql-guide/17.query-tuning-statements/2.kill-session.md)。
- 支持 [Memory Tracker](../../5.configurations-and-logs/1.configurations/4.storage-config.md),优化内存管理。
- 支持[黑匣子监控工具](../../6.monitor-and-metrics/3.bbox/3.1.bbox.md)。
- 支持 [json_extract](../../3.ngql-guide/6.functions-and-expressions/2.string.md) 函数。
- 支持 [extract](../../3.ngql-guide/6.functions-and-expressions/2.string.md) 函数。

## 优化

- 支持`GET SUBGRAPH`时过滤点。
- 支持`GetNeighbors`过滤点。
- 支持时间戳和日期时间相互转换。
- 支持模式表达式引用局部定义变量。
- 优化作业管理。
- 优化全文索引。
- 优化模式表达式作为谓词时的处理方案。
- 优化 GO 语句的 JOIN 性能。
- 优化 k-hop 查询性能。
- 优化查询最短路径的性能。
- 优化点属性过滤的下推。
- 优化边过滤的下推。
- 优化查询子图的循环条件。
- 优化属性裁剪的规则。
- 移除无效的 Project 操作符。
- 移除无效的 AppendVertices 操作符。
- 减少连接操作的数据复制量。
- 减少 Traverse 和 AppendVertices 操作符的数据复制量。
- 修改 Graph 服务配置参数`session_reclaim_interval_secs`的默认值更改为 60 秒。
- 调整配置文件中`stderrthreshold`的默认级别。
- 通过下标获取属性值,减少属性查询的时间。
- 限制优化器中计划树的最大深度以避免堆栈溢出。

## 缺陷修复

- 修复查询计划生成与优化时的问题。

- 修复索引相关的缺陷:

- 全文索引
- 字符串索引

- 修复查询语句的缺陷:

- 变量
- 过滤条件和表达式
- 点或边的属性
- 参数
- 函数与聚合
- 使用非法的数据类型
- 时区、日期、时间等
- 子句与算子

- 修复 DDL 和 DML 语句相关的缺陷:

- ALTER TAG
- UPDATE

- 修复其它功能的缺陷:

- TTL
- 数据同步
- 身份验证
- 服务
- 日志
- 监控和统计

## 变更
- 修复参数表达式 encode 到存储层执行导致崩溃的问题。

- 如果您打算从 3.1 升级到 3.4 版本,请按照[升级文档](../../4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-ent-from-3.x-3.4.md)的指导进行操作。
- 新增的属性名不能与已存在或被删除的属性名同名,否则新增属性会失败。
- 限制修改 Schema 时的类型转换。
- 创建`NOT NULL`类型的属性时,必须指定默认值。
- 在配置文件中添加多线程查询参数`query_concurrently`,默认值为`true`。
- 从配置文件中改移除 KV 分离存储功能参数`kv_separation`,默认关闭该功能。
- 修改配置文件中`local_config`的默认值为`true`。
- 统一使用`v.tag.property`的方式获取属性值,需要指明 Tag。使用`v.property`的方式访问`v`点上某个 Tag 的属性在之前的版本中被错误地允许。
- 删除命令`SHOW HOSTS`中的`HTTP port`列。
- 禁用`OPTIONAL MATCH <pattern> WHERE <condition>`形式的查询。
- 禁用`COUNT(DISTINCT *)`形式的函数。
- 禁用 TOSS。
- 重命名 Listener 的 pid 文件名和 log 目录名。
- 修复一些列表函数的崩溃问题。

## 历史版本

[历史版本](https://nebula-graph.com.cn/tags/release-note/)
[历史版本](https://www.nebula-graph.com.cn/tags/%E5%8F%91%E7%89%88%E8%AF%B4%E6%98%8E)
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

如果必须使用关键字:

- 非保留关键字作为标识符时可以不使用引号
- 当非保留关键字均为小写字母时,如果将其作为标识符时可以不使用引号;当非保留关键字包含大写字母时并将其作为标识符时,需要用反引号(\`)包围,例如 \`Comment\`

- 保留关键字或特殊字符作为标识符时,需要用反引号(\`)包围,例如 \`AND\`。

Expand Down
2 changes: 1 addition & 1 deletion docs-2.0/3.ngql-guide/10.tag-statements/1.create-tag.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ CREATE TAG [IF NOT EXISTS] <tag_name>
|参数|说明|
|:---|:---|
|`IF NOT EXISTS`|检测待创建的 Tag 是否存在,只有不存在时,才会创建 Tag。仅检测 Tag 的名称,不会检测具体属性。|
|`<tag_name>`|1、每个图空间内的 Tag 必须是唯一的。<br>2、Tag 名称设置后无法修改。<br>3、Tag 名称以英文字母开头,支持 1~4 字节的 UTF-8 编码字符,包括英文字母(区分大小写)、数字、中文等,但是不包括除下划线外的特殊字符。使用特殊字符或保留关键字时,需要用反引号(\`)包围且不能使用英文句号(`.`),详情参见[关键字和保留字](../../3.ngql-guide/1.nGQL-overview/keywords-and-reserved-words.md)。|
|`<tag_name>`|1、每个图空间内的 Tag 必须是唯一的。<br>2、Tag 名称设置后无法修改。<br>3、支持 1~4 字节的 UTF-8 编码字符,包括英文字母(区分大小写)、数字、中文、日文、韩文等,但是不包括除下划线外的特殊字符。使用特殊字符或保留关键字时,需要用反引号(\`)包围且不能使用英文句号(`.`),详情参见[关键字和保留字](../../3.ngql-guide/1.nGQL-overview/keywords-and-reserved-words.md)。|
|`<prop_name>`|属性名称。每个 Tag 中的属性名称必须唯一。属性的命名规则与 Tag 相同。|
|`<data_type>`|属性的数据类型,目前支持[数值](../3.data-types/1.numeric.md)、[布尔](../3.data-types/2.boolean.md)、[字符串](../3.data-types/3.string.md)以及[日期与时间](../3.data-types/4.date-and-time.md)。|
|`NULL \| NOT NULL`|指定属性值是否支持为`NULL`。默认值为`NULL`。当指定属性值为`NOT NULL`时,必需指定属性的默认值,也就是`DEFAULT`的值。|
Expand Down
4 changes: 2 additions & 2 deletions docs-2.0/3.ngql-guide/13.edge-statements/1.insert-edge.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,9 @@ INSERT EDGE [IF NOT EXISTS] <edge_type> ( <prop_name_list> ) VALUES
- `IF NOT EXISTS`:用户可以使用`IF NOT EXISTS`关键字检测待插入的边是否存在,只有不存在时,才会插入。

!!! Note
- `IF NOT EXISTS` 仅检测<边的类型、起始点、目的点和 rank>是否存在,不会检测属性值是否重合。
- `IF NOT EXISTS` 仅检测<边的类型、起始点、目的点和 rank>是否存在,不会检测属性值是否重合。

- `IF NOT EXISTS` 会先读取一次数据是否存在,因此对性能会有明显影响。
- `IF NOT EXISTS` 会先读取一次数据是否存在,因此对性能会有明显影响。

- `<edge_type>`:边关联的 Edge type,只能指定一个 Edge type。Edge type 必须提前创建,详情请参见 [CREATE EDGE](../11.edge-type-statements/1.create-edge.md)。

Expand Down
4 changes: 2 additions & 2 deletions docs-2.0/3.ngql-guide/13.edge-statements/3.upsert-edge.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@

!!! caution

并发`UPSERT`同一个 TAG 或 EDGE TYPE 会报错。

并发`UPSERT`同一个 TAG 或 EDGE TYPE 会报错。
## 语法

```ngql
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

- “属性索引”应用于基于属性的查询,例如基于属性`age`找到`age == 19`的所有的点。

如果已经为 Tag `T`的属性`A`建立过属性索引`i_TA`,索引之间的可替代关系如下(Edge type 索引同理):
如果已经为 Tag `T`的属性`A`建立过属性索引`i_TA`(`T`的索引为`i_T`),索引之间的可替代关系如下(Edge type 索引同理):

- 查询引擎可以使用`i_TA`来替代`i_T`。

Expand Down
12 changes: 6 additions & 6 deletions docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,12 +114,12 @@ nebula> INSERT EDGE serve(start_year, end_year) VALUES "player101" -> "team204":
nebula> GET SUBGRAPH WITH PROP 2 STEPS FROM "player101" \
WHERE follow.degree > 90 AND $$.player.age > 30 \
YIELD VERTICES AS nodes, EDGES AS relationships;
+-------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
| nodes | relationships |
+-------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
| [("player101" :player{age: 36, name: "Tony Parker"})] | [[:follow "player101"->"player100" @0 {degree: 95}], [:follow "player101"->"player125" @0 {degree: 95}], [:follow "player100"->"player101" @0 {degree: 95}]] |
| [("player125" :player{age: 41, name: "Manu Ginobili"}), ("player100" :player{age: 42, name: "Tim Duncan"})] | [[:follow "player100"->"player125" @0 {degree: 95}]] |
+-------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+
+-------------------------------------------------------+------------------------------------------------------+
| nodes | relationships |
+-------------------------------------------------------+------------------------------------------------------+
| [("player101" :player{age: 36, name: "Tony Parker"})] | [[:follow "player101"->"player100" @0 {degree: 95}]] |
| [("player100" :player{age: 42, name: "Tim Duncan"})] | [] |
+-------------------------------------------------------+------------------------------------------------------+
```

## FAQ
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,8 @@ nGQL 扩展的自定义变量可以表示为`$var_name`,`var_name`由字母、

!!! Note

自定义变量区分大小写。
- 自定义变量区分大小写。
- 在包含扩展的自定义变量的复合语句中,用英文分号`;`结束定义变量的语句。详情参见 [nGQL 风格指南](../../3.ngql-guide/1.nGQL-overview/ngql-style-guide.md)。

## 示例

Expand Down
2 changes: 0 additions & 2 deletions docs-2.0/3.ngql-guide/5.operators/4.pipe.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,6 @@ nebula> GO FROM "player100" OVER follow \
+-------------+
```

用户可以使用`YIELD`显式声明需要返回的结果,如果不使用`YIELD`,默认返回目标点 ID。

必须在`YIELD`子句中为需要的返回结果设置别名,才能在管道符右侧使用引用符`$-`,例如示例中的`$-.dstid`。

## 性能提示
Expand Down
16 changes: 16 additions & 0 deletions docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,18 @@ nebula> LOOKUP ON player WHERE player.age > 45 \
+-------------------------------------+
```

用户也可以使用属性引用符(`$^`和`$$`)替代函数`properties()`中的`vertex`参数来获取点的所有属性。

- `$^`表示探索开始时的点数据。例如`GO FROM "player100" OVER follow reversely YIELD properties($^)`中,`$^`指`player100`这个点。

- `$$`表示探索结束的终点数据。

`properties($^)`和`properties($$)`一般用于`GO`语句中。更多信息,请参见[属性引用符](../5.operators/5.property-reference.md)。

!!! caution

用户可以通过`properties().<property_name>`来获取点的指定属性。但是不建议使用这种方式获取指定属性,因为`properties()`函数返回所有属性,这样会降低查询性能。

### properties(edge)

properties(edge) 返回边的所有属性。
Expand All @@ -77,6 +89,10 @@ nebula> GO FROM "player100" OVER follow \
+------------------+
```

!!! warning

用户可以通过`properties(edge).<property_name>`来获取边的指定属性。但是不建议使用这种方式获取指定属性,因为`properties(edge)`函数返回边的所有属性,这样会降低查询性能。

### type(edge)

type(edge) 返回边的 Edge type。
Expand Down
Loading