Skip to content

Commit

Permalink
Merge 3.0.0 (#1516)
Browse files Browse the repository at this point in the history
* Update 1.text-based-index-restrictions.md

* Update 4.nebula-graph-crud.md

* Update 2.find-path.md

* Update 2.find-path.md

* Add ranking config in exchange examples (#1407)

* add license check (#1410)

* Update 2.match.md

* Update 2.match.md

* Update nebula-plato.md (#1411)

* Update 1.nebula-client.md

* update start sh

* update stop sh

* update stop sh

* change start service setting

* update start

* Update nebula-plato.md

* Add ranking config in exchange examples (#1412)

* timestamp_in_logfile_name and logrotate faq (#1400)

* Fix exchange conf link (#1414)

* Update note.css

* Update 3.cluster-information.md

* disable balance data (#1416)

* update config shell

* update nebula-dashboard server config

* fix schema rule (#1418)

* Update README.md

* Update 2.deploy-dashboard.md

* Add next step

* Update mkdocs.yml (#1422)

* Update 1.what-is-dashboard-ent.md

* [WIP]update Studio (#1419)

* [WIP]update Studio

* update-0124

* Update st-ug-deploy.md

* [wip] explore 216 --what is explorer & deployment updates (#1417)

* [wip] explore 216 --what is explorer updates

* explorer 216 -- deploy&connect

* Update mkdocs.yml

* Update mkdocs.yml

* [WIP] explorer220-overview (#1421)

* explorer220-overview

* Update ex-ug-page-overview.md

* Update st-ug-what-is-graph-studio.md

* Explorer220 query (#1423)

* explorer220-overview

* explorer 220-query

* Update st-ug-crud-tag.md

* node-filtering (#1424)

* dashboard ent config_file update (#1426)

* dashboard ent config_file update

* Update 2.deploy-connect-dashboard-ent.md

* Create 2.deploy-connect-dashboard-ent.md

* Update 1.insert-edge.md

* Update 2.data-model.md

* Update 2.graph-modeling.md

* dashboard-ent-custom-installation path (#1430)

* dashboard-ent-custom-installation path

* Update 1.create-cluster.md

* update-picture

* Update 1.what-is-dashboard.md

* [WIP] explorer 220 graph-exploration (#1429)

* explorer 220 - canvas (#1433)

* Update 2.deploy-dashboard.md

* Update 2.deploy-dashboard.md

* Update upgrade docs (#1427)

* Update upgrade docs

* Update upgrade docs

* Update upgrade-nebula-from-200-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Resolve Whitewum's and Harris's comments

* Fix some issues

* update resource calculation

* add caution for date_time_zonespec.csv

* delete zone (#1434)

* manage storage hosts (#1437)

* manage storage hosts

* update

* Update manage-storage-host.md

* Add faq for job id issue (#1438)

* Remove zone (#1439)

* Remove zone (#1440)

* Remove zone

* Update 4.nebula-graph-crud.md

* Exchange support PostgreSQL data source (#1441)

* [WIP] explorer220-updates (#1435)

* explorer220-updates

* updates

* Update mkdocs.yml

* console updates

* Update canvas-overview.md

* Update visualization-mode.md

* Update visualization-mode.md

* show hosts (#1442)

* show hosts

The `show hosts` command displays the version

* Update 6.show-hosts.md

* Update learning-path.md

* Update 2.data-model.md

* Update compaction.md

* Update compaction.md

* Update compaction.md

* Update 3.system-design.md

* Update 3.system-design.md

* Update st-ug-release-note.md

* Update nebula-bench.md

* Update how-to-contribute.md

* Update how-to-contribute.md

* Update 6.eco-tool-version.md

* Update 6.eco-tool-version.md

* Update 0.FAQ.md

* Create 0.FAQ.md (#1443)

* Update use-importer.md

* Update mkdocs.yml

* Update 6.eco-tool-version.md

* update clients (#1444)

* Update 3.system-design.md

* Update ex-ug-deploy.md (#1445)

* Update ex-ug-graph-exploration.md

* update docs (#1446)

* Update ex-ug-graph-exploration.md

* Update 6.kill-query.md (#1448)

* Update 2.deploy-dashboard.md

* Update ex-ug-shortcuts.md

* Update ex-ug-graph-exploration.md (#1449)

* Update st-ug-deploy-by-helm.md (#1450)

* Update explorer-console.md (#1451)

* Update source_connect-to-nebula-graph.md

* Update 5.nebula-python-client.md (#1452)

as we use format string in nebula-python, don't support python3.5

* update

* Update 6.show-hosts.md

* add gifs for dashboard 110 (#1453)

* Update 6.pricing.md

* Update 1.what-is-br.md

* Update 4.storage-service.md

* Update 2.deploy-dashboard.md (#1455)

* Update 1.what-is-nebula-graph.md

* Update mkdocs.yml (#1456)

* Update 2.deploy-dashboard.md (#1457)

* Update 2.deploy-dashboard.md

* Dashboard community deploy&connect updates (#1460)

* deploy&connect updates for dashboard community

* Update mkdocs.yml

* update release notes (#1459)

* update release notes

* update

* update

* update

* Update releasenote.md

* Update 2.deploy-dashboard.md

* Update releasenote.md

* Update releasenote.md

* Update learning-path.md

fix invalid video list url

* Update deploy.yaml

* Update visualization-mode.md (#1463)

* Update ex-ug-compile.md

* Update releasenote.md

* Update releasenote.md

* update br 0211 (#1461)

* update br 0211

* update

* add

* Update 4.br-restore-data.md

* Update 4.br-restore-data.md

* Update 2.compile-br.md

* Update 1.configurations.md

* Update mkdocs.yml

* Update mkdocs.yml

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* fixed some issues (#1467)

* Update releasenote.md

* Update 2.deploy-connect-dashboard-ent.md (#1468)

* Update 4.describe-space.md

* Update upgrade-nebula-graph-to-latest.md

* Update releasenote.md

* Create releasenote.md

* Update releasenote.md

* Update mkdocs.yml

* update-br

* Update 2.deploy-connect-dashboard-ent.md

* update branch of client (#1469)

* Update mkdocs.yml

* Update 4.nebula-java-client.md

* update compatibility (#1470)

* Update 3.br-backup-data.md

* Update 3.br-backup-data.md

* Update nebula-plato.md

* Update 3.br-backup-data.md

* Update nebula-plato.md

* Update st-ug-deploy.md

* Update 3.br-backup-data.md

* Update st-ug-deploy.md

* Update 4.br-restore-data.md

* Update 4.br-restore-data.md

* Update 3.br-backup-data.md

* Update st-ug-release-note.md

* Update ex-ug-limitations.md

* Update mkdocs.yml

* Update use-importer.md

* Update use-importer.md

* Update nebula-algorithm.md

* Update config-with-header.md

* Update config-without-header.md

* Update releasenote.md

* Update st-ug-what-is-graph-studio.md

* Update nebula-algorithm.md

* Update nebula-spark-connector.md (#1473)

* Update ex-ug-import-from-mysql.md

* update exchange 3.0.0 (#1474)

* [WIP]change plato name (#1472)

* change plato name

* update

* Update nebula-analytics.md

* Update nebula-analytics.md

* Update 6.eco-tool-version.md

* Update 3.system-design.md

* Update nebula-analytics.md

* Update releasenote.md

* Update releasenote.md

* add br

* Update releasenote.md

* Update releasenote.md

* Update releasenote.md

* Update releasenote.md

* Update learning-path.md

* Update learning-path.md

* Update learning-path.md

* Update learning-path.md (#1476)

* Update nebula-console.md

* Update nebula-console.md (#1477)

* Update studio 3.2.1 (#1478)

* Update 6.eco-tool-version.md (#1479)

* Update logo.css (#1480)

* Update 1.configurations.md (#1481)

* Fix link and add cloud (#1482)

* Update nebula-cloud.md

* Update 6.eco-tool-version.md

* Update 3.graph-service.md (#1483)

* Update 3.graph-service.md

* Update 3.alter-tag.md

* Update 3.alter-tag.md

* Update 3.alter-tag.md

* commit id update and rm old pics (#1488)

* Update 0.FAQ.md

* Update 0.FAQ.md (#1489)

* Update 1.overview.md (#1490)

* Update 5.lookup.md

* Update 1.create-native-index.md

* Update 4.br-restore-data.md

* Update 0.FAQ.md

* note for basketallplayer (#1491)

* note for basketallplayer

* Update 1.overview.md

* vm.min_free_kbytes is a setting of Linux Virtual Memory not Virtual Machine (#1493)

as titled

* Upgrade with no auto-backup (#1494)

* Upgrade with no auto-backup

The db-upgrader currently does not backup the old data.

* Update upgrade-nebula-graph-to-latest.md

* Update upgrade-nebula-graph-to-latest.md

* Update 0.FAQ.md (#1495)

* Update 0.FAQ.md

* Create 0.FAQ.md

* Update 0.FAQ.md (#1496)

* Update 1.what-is-br.md

* Update canvas-snapshot.md

* Update manage-storage-host.md (#1497)

* Update 8.faq.md (#1498)

* Update 3.graph-service.md (#1499)

* Update mkdocs.yml (#1500)

* Create 6.eco-tool-version.md

* Update st-ug-what-is-graph-studio.md

* Update st-ug-terms.md

* Update 6.eco-tool-version.md (#1501)

* Update mkdocs.yml (#1502)

* Update mkdocs.yml

* Update mkdocs.yml

* Explain storage format change (#1503)

* Explain storage format change in 3.x

* Update edge format

* Update 4.storage-service.md

* Update mkdocs.yml

* Update requirements.txt

* Update requirements.txt

* Update nebula-analytics.md

* Update mkdocs.yml

* Update requirements.txt

* Update mkdocs.yml

* Synchronize book with 3.0.0 (#1504)

* synchronize book with 3.0.0

* Update mkdocs.yml

* Update history.md (#1505)

* Update 1.what-is-br.md (#1506)

* fixed create index comment syntax (#1507)

ref: vesoft-inc/nebula#3945

* Update nebula-analytics.md

* fix analytics docs (#1508)

* Update 2.match.md (#1509)

* Update visualization-mode.md (#1510)

* Update ex-ug-import-from-sst.md

* Update ex-ug-import-from-clickhouse.md

* Update ex-ug-import-from-csv.md

* update full-text index (#1511)

* Fix exchange config files (#1512)

* Update write-tools.md

* Update write-tools.md

* Update 3.role-list.md

* Update keywords-and-reserved-words.md (#1513)

* Update keywords-and-reserved-words.md

* Update keywords-and-reserved-words.md

* fix some typos (#1515)

* ADD HOSTS in docker deployment (#1514)

This will prevent users from being confused.

* Update deploy.yaml

Co-authored-by: min.wu <50101159+whitewum@users.noreply.github.com>
Co-authored-by: foesa <35463247+foesa-yang@users.noreply.github.com>
Co-authored-by: randomJoe211 <69501902+randomJoe211@users.noreply.github.com>
Co-authored-by: abby.huang <78209557+abby-cyber@users.noreply.github.com>
Co-authored-by: li Nico <37568394+NicolaCage@users.noreply.github.com>
Co-authored-by: Harris.Chu <1726587+HarrisChu@users.noreply.github.com>
Co-authored-by: Steam <evaz1879@gmail.com>
Co-authored-by: Nut He <18328704+hetao92@users.noreply.github.com>
Co-authored-by: jingchun.xia <6269380+xiajingchun@users.noreply.github.com>
Co-authored-by: Wey Gu <weyl.gu@gmail.com>
  • Loading branch information
11 people authored Mar 7, 2022
1 parent 12b5645 commit 5ed96fa
Show file tree
Hide file tree
Showing 53 changed files with 1,069 additions and 136 deletions.
230 changes: 230 additions & 0 deletions docs-2.0/1.introduction/0-0-graph.md

Large diffs are not rendered by default.

245 changes: 245 additions & 0 deletions docs-2.0/1.introduction/0-1-graph-database.md

Large diffs are not rendered by default.

251 changes: 251 additions & 0 deletions docs-2.0/1.introduction/0-2.relates.md

Large diffs are not rendered by default.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -84,10 +84,6 @@ Validator 模块对生成的 AST 进行语义校验,主要包括:

如上图所示,探索到节点 `Filter` 时,发现依赖的节点是 `GetNeighbor`,匹配预先定义的规则,就会将 `Filter` 融入到 `GetNeighbor` 中,然后移除节点 `Filter`,继续匹配下一个规则。在执行阶段,当算子 `GetNeighbor` 调用 Storage 服务的接口获取一个点的邻边时,Storage 服务内部会直接将不符合条件的边过滤掉,这样可以极大地减少传输的数据量,该优化称为过滤下推。

!!! Note

Nebula Graph {{ nebula.release }} 默认没有打开优化。

## Executor

Executor 模块包含调度器(Scheduler)和执行器(Executor),通过调度器调度执行计划,让执行器根据执行计划生成对应的执行算子,从叶子节点开始执行,直到根节点结束。如下图所示。
Expand Down Expand Up @@ -120,6 +116,6 @@ Nebula Graph 的代码层次结构如下:

用户也可以通过视频全方位了解 Nebula Graph 的查询引擎。

- [nMeetup·上海 |全面解析 2.0 Query Engine](https://www.bilibili.com/video/BV1xV411n7DD)(33 分 30 秒)
- [nMeetup·上海 |全面解析 Query Engine](https://www.bilibili.com/video/BV1xV411n7DD)(33 分 30 秒)

<iframe src="//player.bilibili.com/player.html?aid=417369444&bvid=BV1xV411n7DD&cid=317029694&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" width="720px" height="480px"> </iframe>
Original file line number Diff line number Diff line change
Expand Up @@ -70,47 +70,38 @@ Nebula Graph 使用自行开发的 KVStore,而不是其他开源 KVStore,原

- 支持多个图空间,不同图空间相互隔离,每个图空间可以设置自己的分片数和副本数。

<!--
## 数据存储格式

图存储的主要数据是点和边,Nebula Graph 将点和边的信息存储为 key,同时将点和边的属性信息存储在 value 中,以便更高效地使用属性过滤。

由于 Nebula Graph 2.0 的数据存储格式在 1.x 的基础上做了修改,下文将在介绍数据存储格式时同时介绍不同版本的差异。
- 点数据存储格式

![The vertex format of storage service](https://www-cdn.nebula-graph.com.cn/nebula-blog/nebula-graph-vertex-data-format.png)
相比 Nebula Graph 2.x 版本,3.x 版本的每个点多了一个不含 TagID 字段并且无 value 的 key,用于支持无 Tag 的点。

![The vertex format of storage service](3.0-vertex-key.png)

|字段|说明|
|:---|:---|
|`Type`|key 类型。长度为 1 个字节。|
|`PartID`|数据分片编号。长度为 3 个字节。此字段主要用于 Storage 负载均衡(balance)时方便根据前缀扫描整个分片的数据。|
|`VertexID`|点 ID。当点 ID 类型为 int 时,长度为 8 个字节;当点 ID 类型为 string 时,长度为创建图空间时指定的`fixed_string`长度。|
|`TagID`|点关联的 Tag ID。长度为 4 个字节。|
|`Type`|key 类型。长度为 1 字节。|
|`PartID`|数据分片编号。长度为 3 字节。此字段主要用于 Storage 负载均衡(balance)时方便根据前缀扫描整个分片的数据。|
|`VertexID`|点 ID。当点 ID 类型为 int 时,长度为 8 字节;当点 ID 类型为 string 时,长度为创建图空间时指定的`fixed_string`长度。|
|`TagID`|点关联的 Tag ID。长度为 4 字节。|
|`SerializedValue`|序列化的 value,用于保存点的属性信息。|

- 边数据存储格式

![The edge format of storage service](https://www-cdn.nebula-graph.com.cn/nebula-blog/nebula-graph-edge-data-format.png)
![The edge format of storage service](3.0-edge-key.png)

|字段|说明|
|:---|:---|
|`Type`|key 类型。长度为 1 个字节。|
|`PartID`|数据分片编号。长度为 3 个字节。此字段主要用于 Storage 负载均衡(balance)时方便根据前缀扫描整个分片的数据。|
|`VertexID`|点 ID。前一个`VertexID`在出边里表示起始点 ID,在"入边"里表示目的点 ID;后一个`VertexID`"出边"里表示目的点 ID,在"入边"里表示起始点 ID。|
|`Edge type`|边的类型。大于 0 表示"出边",小于 0 表示"入边"。长度为 4 个字节。|
|`Rank`|用来处理两点之间有多个同类型边的情况。用户可以根据自己的需求进行设置,例如存放交易时间、交易流水号等。长度为 8 个字节,|
|`PlaceHolder`|预留。长度为 1 个字节。|
!!! compatibility "历史版本兼容性"
2.0 和 1.x 的差异如下:
- 1.x 中,点和边的`Type`值相同,而在 2.0 中进行了区分,即在物理上分离了点和边,方便快速查询某个点的所有 Tag。
- 1.x 中,`VertexID`仅支持 int 类型,而在 2.0 中新增了 string 类型。
- 2.0 中取消了 1.x 中的保留字段`Timestamp`。
- 2.0 中边数据新增字段`PlaceHolder`。
- 2.0 中修改了索引的格式,以便支持范围查询。
-->
|`Type`|key 类型。长度为 1 字节。|
|`PartID`|数据分片编号。长度为 3 字节。此字段主要用于 Storage 负载均衡(balance)时方便根据前缀扫描整个分片的数据。|
|`VertexID`|点 ID。前一个`VertexID`在出边里表示起始点 ID,在入边里表示目的点 ID;后一个`VertexID`出边里表示目的点 ID,在入边里表示起始点 ID。|
|`Edge type`|边的类型。大于 0 表示出边,小于 0 表示入边。长度为 4 字节。|
|`Rank`|用来处理两点之间有多个同类型边的情况。用户可以根据自己的需求进行设置,例如存放交易时间、交易流水号等。长度为 8 字节,|
|`PlaceHolder`|预留字段。长度为 1 字节。|
|`SerializedValue`|序列化的 value,用于保存边的属性信息。|

### 属性说明

Nebula Graph 使用强类型 Schema。
Expand All @@ -123,26 +114,25 @@ Nebula Graph 使用强类型 Schema。

![data partitioning](https://www-cdn.nebula-graph.com.cn/nebula-blog/DataModel02.png)

<!--
### 切边与存储放大

Nebula Graph 中逻辑上的一条边对应着硬盘上的两个键值对(key-value pair),在边的数量和属性较多时,存储放大现象较明显。边的存储方式如下图所示。

![edge storage](https://docs-cdn.nebula-graph.com.cn/docs-2.0/1.introduction/2.nebula-graph-architecture/two-edge-format.png)
![edge storage](edge-division.png)

上图以最简单的两个点和一条边为例,起点 SrcVertex 通过边 EdgeA 连接目的点 DstVertex,形成路径`(SrcVertex)-[EdgeA]->(DstVertex)`。这两个点和一条边会以 4 个键值对的形式保存在存储层的两个不同分片,即 Partition x 和 Partition y 中,详细说明如下:
上图以最简单的两个点和一条边为例,起点 SrcVertex 通过边 EdgeA 连接目的点 DstVertex,形成路径`(SrcVertex)-[EdgeA]->(DstVertex)`。这两个点和一条边会以 6 个键值对的形式保存在存储层的两个不同分片,即 Partition x 和 Partition y 中,详细说明如下:

* 点 SrcVertex 的键值保存在 Partition x 中。Key 的字段有 Type、PartID(x),VID(Src)和 TagID。SerializedValue 即 Value,是序列化的点属性。
* 点 SrcVertex 的键值保存在 Partition x 中。

* EdgeA 的第一份键值,这里用 EdgeA_Out 表示,与 SrcVertex 一同保存在 Partition x 中。Key 的字段有 Type、PartID(x)、VID(Src,即点 SrcVertex 的 ID)、EdgeType(符号为正,代表边方向为出)、Rank(0)、VID(Dst,即点 DstVertex 的 ID)和 PlaceHolder。SerializedValue 即 Value,是序列化的边属性。
* EdgeA 的第一份键值,这里用 EdgeA_Out 表示,与 SrcVertex 一同保存在 Partition x 中。key 的字段有 Type、PartID(x)、VID(Src,即点 SrcVertex 的 ID)、EdgeType(符号为正,代表边方向为出)、Rank(0)、VID(Dst,即点 DstVertex 的 ID)和 PlaceHolder。SerializedValue 即 Value,是序列化的边属性。

* 点 DstVertex 的键值保存在 Partition y 中。Key 的字段有 Type、PartID(y),VID(Dst)和 TagID。SerializedValue 即 Value,是序列化的点属性。
* 点 DstVertex 的键值保存在 Partition y 中。

* EdgeA 的第二份键值,这里用 EdgeA_In 表示,与 DstVertex 一同保存在 Partition y 中。Key 的字段有 Type、PartID(y)、VID(Dst,即点 DstVertex 的 ID)、EdgeType(符号为负,代表边方向为入)、Rank(0)、VID(Src,即点 SrcVertex 的 ID)和 PlaceHolder。SerializedValue 即 Value,是序列化的边属性,与 EdgeA_Out 中该部分的完全相同。
* EdgeA 的第二份键值,这里用 EdgeA_In 表示,与 DstVertex 一同保存在 Partition y 中。key 的字段有 Type、PartID(y)、VID(Dst,即点 DstVertex 的 ID)、EdgeType(符号为负,代表边方向为入)、Rank(0)、VID(Src,即点 SrcVertex 的 ID)和 PlaceHolder。SerializedValue 即 Value,是序列化的边属性,与 EdgeA_Out 中该部分的完全相同。

EdgeA_Out 和 EdgeA_In 以方向相反的两条边的形式存在于存储层,二者组合成了逻辑上的一条边 EdgeA。EdgeA_Out 用于从起点开始的遍历请求,例如`(a)-[]->()`;EdgeA_In 用于指向目的点的遍历请求,或者说从目的点开始,沿着边的方向逆序进行的遍历请求,例如例如`()-[]->(a)`

如 EdgeA_Out 和 EdgeA_In 一样,Nebula Graph 冗余了存储每条边的信息,导致存储边所需的实际空间翻倍。因为边对应的 Key 占用的硬盘空间较小,但 Value 占用的空间与属性值的长度和数量成正比,所以,当边的属性值较大或数量较多时候,硬盘空间占用量会比较大。
如 EdgeA_Out 和 EdgeA_In 一样,Nebula Graph 冗余了存储每条边的信息,导致存储边所需的实际空间翻倍。因为边对应的 key 占用的硬盘空间较小,但 value 占用的空间与属性值的长度和数量成正比,所以,当边的属性值较大或数量较多时候,硬盘空间占用量会比较大。

如果对边进行操作,为了保证两个键值对的最终一致性,可以开启 [TOSS 功能](../../5.configurations-and-logs/1.configurations/3.graph-config.md),开启后,会先在正向边所在的分片进行操作,然后在反向边所在分片进行操作,最后返回结果。
-->
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 9 additions & 7 deletions docs-2.0/20.appendix/0.FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,11 +38,9 @@ Nebula Graph 一直在持续开发,功能或操作的行为可能会有变化

从 Nebula Graph 3.0.0 开始,查询语句`LOOKUP``GO``FETCH`必须用`YIELD`子句指定输出结果。详情请参见[YIELD](../3.ngql-guide/8.clauses-and-options/yield.md)

<!--
### 如何处理错误信息 `Zone not enough!`

从 3.0.0 版本开始,在配置文件中添加的 Storage 节点无法直接读写,配置文件的作用仅仅是将 Storage 节点注册至 Meta 服务中。必须使用`ADD HOSTS`命令后,才能正常读写 Storage 节点。详情参见[管理逻辑机架(Zone)](../4.deployment-and-installation/5.zone.md)。
-->
从 3.0.0 版本开始,在配置文件中添加的 Storage 节点无法直接读写,配置文件的作用仅仅是将 Storage 节点注册至 Meta 服务中。必须使用`ADD HOSTS`命令后,才能正常读写 Storage 节点。详情参见[管理 Storage 主机](../4.deployment-and-installation/manage-storage-host.md)

### 如何处理错误信息 `To get the property of the vertex in 'v.age', should use the format 'var.tag.prop'`

Expand Down Expand Up @@ -192,6 +190,10 @@ Got 1 rows (time spent 1235/1934 us)

- 第二个数字`1934`表示从客户端角度看所花费的时间,即从客户端发送请求、接收结果,然后在屏幕上显示结果所花费的时间。

### 为什么在正常连接 Nebula Graph 后,`nebula-storaged`进程的端口号一直显示红色?

`nebula-storaged`进程的端口号的红色闪烁状态是因为`nebula-storaged`在启动流程中会等待`nebula-metad`添加当前 Storage 服务,当前 Storage 服务收到 Ready 信号后才会正式启动服务。从 3.0.0 版本开始,Meta 服务无法直接读写在配置文件中添加的 Storage 服务,配置文件的作用仅仅是将 Storage 服务注册至 Meta 服务中。用户必须使用`ADD HOSTS`命令后,才能使 Meta 服务正常读写 Storage 服务。更多信息,参见[管理 Storage 主机](../4.deployment-and-installation/manage-storage-host.md)

### 为什么 Nebula Graph 的返回结果每行之间没有横线分隔了?

这是 Nebula Console 2.6.0 版本的变动造成的,不是 Nebula Graph 内核的变更,不影响返回数据本身的内容。
Expand Down Expand Up @@ -306,14 +308,12 @@ nebula > MATCH (s)<-[e]-() WHERE id(s) == "given" RETURN count(e); #入度

### 日志文件过大时如何回收日志?

<!--
Nebula Graph 的日志默认在 `/usr/local/nebula/logs/` 下,正常 INFO 级别日志文件为 `nebula-graphd.INFO, nebula-storaged.INFO, nebula-metad.INFO`,报警和错误级别后缀为 `.WARNING``.ERROR`

Nebula Graph 使用 [glog](https://github.com/google/glog) 打印日志。glog 没有日志回收的功能,用户可以:

- 使用 crontab 设置定期任务回收日志文件,详情请参见 [Glog should delete old log files automatically](https://github.com/google/glog/issues/423)
- 使用 [logrotate](https://github.com/logrotate/logrotate) 实现日志轮询。使用 logrotate 管理日志前需修改相应 Nebula Graph 服务的配置,将`timestamp_in_logfile_name`参数的值改成`false`
-->

### 如何查看 Nebula Graph 版本

Expand All @@ -339,9 +339,11 @@ $ ./nebula-graphd --version

执行`rpm -qa |grep nebula`即可查看版本。

<!--3.0.0版本不支持扩缩容
### 如何扩缩容
用户可以使用 Dashboard(企业版),在可视化页面对 graphd <!--和 storaged --> 进行快速扩缩容,详情参见[集群操作-扩缩容](../nebula-dashboard-ent/4.cluster-operator/4.manage.md)
用户可以使用 Dashboard(企业版),在可视化页面对 graphd 和 storaged 进行快速扩缩容,详情参见[集群操作-扩缩容](../nebula-dashboard-ent/4.cluster-operator/4.manage.md)。
Nebula Graph {{ nebula.release }} 未提供运维命令以实现自动扩缩容,参考以下步骤:
Expand All @@ -355,7 +357,7 @@ Nebula Graph {{ nebula.release }} 未提供运维命令以实现自动扩缩容
- graphd 的扩容: 在新机器上准备 graphd 二进制文件和配置文件,在配置文件中修改或增加已在运行的 metad 地址,启动 graphd 进程。
- storaged 不支持扩缩容。
- storaged 不支持扩缩容。 -->

<!-- balance-3.1
Expand Down
3 changes: 2 additions & 1 deletion docs-2.0/20.appendix/6.eco-tool-version.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,10 +61,11 @@ Nebula Explorer(简称 Explorer)是一款可以通过 Web 访问的图探索

Nebula Exchange(简称 Exchange)是一款 Apache Spark&trade; 应用,用于在分布式环境中将集群中的数据批量迁移到 Nebula Graph 中,能支持多种不同格式的批式数据和流式数据的迁移。详情请参见[什么是 Nebula Exchange](../nebula-exchange/about-exchange/ex-ug-what-is-exchange.md)

<!-- hide in 3.0.0
## Nebula Operator
Nebula Operator(简称 Operator)是用于在 Kubernetes 系统上自动化部署和运维 Nebula Graph 集群的工具。依托于 Kubernetes 扩展机制,Nebula Graph 将其运维领域的知识全面注入至 Kubernetes 系统中,让 Nebula Graph 成为真正的云原生图数据库。详情请参考[什么是 Nebula Operator](../nebula-operator/1.introduction-to-nebula-operator.md)
Nebula Operator(简称 Operator)是用于在 Kubernetes 系统上自动化部署和运维 Nebula Graph 集群的工具。依托于 Kubernetes 扩展机制,Nebula Graph 将其运维领域的知识全面注入至 Kubernetes 系统中,让 Nebula Graph 成为真正的云原生图数据库。详情请参考[什么是 Nebula Operator](../nebula-operator/1.introduction-to-nebula-operator.md)。 -->


## Nebula Importer
Expand Down
42 changes: 42 additions & 0 deletions docs-2.0/20.appendix/history.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Nebula Graph 年表

1. 2018.9.5 由 @[dutor](https://github.com/dutor) 提交了第一行代码。

![image](https://docs-cdn.nebula-graph.com.cn/books/images/dutor.png)

2. 2019.5 发布了 v0.1.0 alpha 版本, 并开源。

![image](https://docs-cdn.nebula-graph.com.cn/books/images/alpha-bj.png)
![image](https://docs-cdn.nebula-graph.com.cn/books/images/alpha-hz.jpg)

此后一年内陆续发布 v1.0.0-beta, v1.0.0-rc1, v1.0.0-rc2, v1.0.0-rc3, v1.0.0-rc4

![image](https://docs-cdn.nebula-graph.com.cn/books/images/v010.png)

3. 2019.7 在 HBaseCon 第一次公开亮相[^Hbasecon]@[dangleptr](https://github.com/dangleptr)

![image](https://www-cdn.nebula-graph.com.cn/nebula-blog/HBase01.png)

[^Hbasecon]: Nebula Graph 1.x 版本支持 RocksDB 和 HBase 两种主要的后端,但在 Nebula Graph 2.x 版本取消了默认对 HBase 的支持。

4. 2020.3 在 v1.0 开发的收尾阶段,启动了 v2.0 项目的研发

5. 2020.6 发布了第一个正式大版本 v1.0.0 GA

![image](https://docs-cdn.nebula-graph.com.cn/books/images/v100GA.png)

6. 2021.3 发布了第二个大版本 v2.0 GA

![image](https://docs-cdn.nebula-graph.com.cn/books/images/v200.png)

7. 2021.8 发布 v2.5.0

![image](https://docs-cdn.nebula-graph.com.cn/books/images/2.5.0.png)

8. 2021.10 发布 v2.6.0

更多信息,参见[Releases](https://github.com/vesoft-inc/nebula/releases)

9. 2022.2 发布 v3.0.0

更多信息,参见[Releases](https://github.com/vesoft-inc/nebula/releases)
Loading

0 comments on commit 5ed96fa

Please sign in to comment.