Skip to content

Commit

Permalink
Merge branch 'foesa-yang-change-nebulagraph-name'
Browse files Browse the repository at this point in the history
  • Loading branch information
foesa-yang committed Aug 9, 2022
2 parents 430aabf + 50ec96a commit 8d526d0
Show file tree
Hide file tree
Showing 273 changed files with 2,176 additions and 2,177 deletions.
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Nebula Graph 中文文档贡献指南
# NebulaGraph 中文文档贡献指南

**Nebula Graph** 欢迎帮助我们改善文档。
**NebulaGraph** 欢迎帮助我们改善文档。

## 可贡献的内容

Expand All @@ -14,7 +14,7 @@

## 必须遵循的 Markdown 规范

在贡献之前,请知悉有关 **Nebula Graph** 文档维护的 Markdown 规范。
在贡献之前,请知悉有关 **NebulaGraph** 文档维护的 Markdown 规范。

- [Markdown 规范](https://github.com/DavidAnson/markdownlint/blob/master/doc/Rules.md)

Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
[![Publish docs via GitHub Pages](https://github.com/vesoft-inc/nebula-docs-cn/actions/workflows/deploy.yaml/badge.svg?branch=v3.0.1)](https://github.com/vesoft-inc/nebula-docs-cn/actions/workflows/deploy.yaml)

# Nebula Graph 文档
# NebulaGraph 文档

- [中文](https://docs.nebula-graph.com.cn/)
- [English](https://docs.nebula-graph.io)

## 贡献文档

如果发现文档问题,请随时创建一个 [Issue](https://github.com/vesoft-inc/nebula-docs-cn/issues) 告知我们或直接创建一个 [PR](https://github.com/vesoft-inc/nebula-docs-cn/pulls) 修复或更新。请参阅 Nebula Graph [中文文档贡献指南](CONTRIBUTING.md)开始贡献。
如果发现文档问题,请随时创建一个 [Issue](https://github.com/vesoft-inc/nebula-docs-cn/issues) 告知我们或直接创建一个 [PR](https://github.com/vesoft-inc/nebula-docs-cn/pulls) 修复或更新。请参阅 NebulaGraph [中文文档贡献指南](CONTRIBUTING.md)开始贡献。
2 changes: 1 addition & 1 deletion docs-2.0/1.introduction/0-0-graph.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

## 图、图片与图论

图无处不在。当听到图这个词时,很多人都会想到条形图或折线图,因为有时候我们确实会把它们称作图。从传统意义上来说,图是用来展示两个或多个数据系统之间的联系的。最简单的例子如下图,下图展示了 Nebula Graph GitHub 仓库星星数量随时间推移的变化。
图无处不在。当听到图这个词时,很多人都会想到条形图或折线图,因为有时候我们确实会把它们称作图。从传统意义上来说,图是用来展示两个或多个数据系统之间的联系的。最简单的例子如下图,下图展示了 NebulaGraph GitHub 仓库星星数量随时间推移的变化。

![image](https://user-images.githubusercontent.com/42762957/91426247-d3861000-e88e-11ea-8e17-e3d7d7069bd1.png "这不是本书所说的图")

Expand Down
6 changes: 3 additions & 3 deletions docs-2.0/1.introduction/0-1-graph-database.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ Cypher 启发了一系列后续的图查询语言,包括

[^GSQL]: https://docs.tigergraph.com/dev/gsql-ref

2019 年,Nebula Graph 以 openCypher 为基础发布其扩展的图语言 Nebula Graph Query Language, nGQL。
2019 年,NebulaGraph 以 openCypher 为基础发布其扩展的图语言 NebulaGraph Query Language, nGQL。

![Image](https://docs-cdn.nebula-graph.com.cn/books/images/langhis.jpg "图语言的历史")

Expand Down Expand Up @@ -240,6 +240,6 @@ Oracle graph[^Oracle] 是关系型数据库巨头 Oracle 在图技术与图数

[^Oracle]: https://www.oracle.com/database/graph/

#### 新一代开源分布式图数据库 Nebula Graph
#### 新一代开源分布式图数据库 NebulaGraph

在下一章,我们将正式介绍新一代开源分布式图数据库 Nebula Graph
在下一章,我们将正式介绍新一代开源分布式图数据库 NebulaGraph
2 changes: 1 addition & 1 deletion docs-2.0/1.introduction/0-2.relates.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ NoSQL 数据库的列式存储与 NoSQL 数据库的键值存储有许多相似

#### 图存储

最后一类 NoSQL 数据库是图数据库。本书重点讨论的 Nebula Graph 也是一种图数据库。虽然同为 NoSQL 型数据库,但是图数据库与上述 NoSQL 数据库有本质上的差异。图数据库以点、边、属性的形式存储数据。其优点在于灵活性高,支持复杂的图形算法,可用于构建复杂的关系图谱。我们将在随后的章节中详细讨论图数据库。不过在本章中,你只要知道图数据库是一种 NoSQL 类型的数据库就可以了。常见的图数据库有:Nebula Graph、Neo4j、OrientDB 等。
最后一类 NoSQL 数据库是图数据库。本书重点讨论的 NebulaGraph 也是一种图数据库。虽然同为 NoSQL 型数据库,但是图数据库与上述 NoSQL 数据库有本质上的差异。图数据库以点、边、属性的形式存储数据。其优点在于灵活性高,支持复杂的图形算法,可用于构建复杂的关系图谱。我们将在随后的章节中详细讨论图数据库。不过在本章中,你只要知道图数据库是一种 NoSQL 类型的数据库就可以了。常见的图数据库有:NebulaGraph、Neo4j、OrientDB 等。

## 图技术方面

Expand Down
44 changes: 22 additions & 22 deletions docs-2.0/1.introduction/1.what-is-nebula-graph.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# 什么是 Nebula Graph
# 什么是 NebulaGraph

Nebula Graph 是一款开源的、分布式的、易扩展的原生图数据库,能够承载包含数千亿个点和数万亿条边的超大规模数据集,并且提供毫秒级查询。
NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库,能够承载包含数千亿个点和数万亿条边的超大规模数据集,并且提供毫秒级查询。

![Nebula Graph 鸟瞰图](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-birdview-3.0.0.png)
![NebulaGraph 鸟瞰图](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-birdview-3.0.0.png)

## 什么是图数据库

Expand All @@ -12,78 +12,78 @@ Nebula Graph 是一款开源的、分布式的、易扩展的原生图数据库

图数据库适合存储大多数从现实抽象出的数据类型。世界上几乎所有领域的事物都有内在联系,像关系型数据库这样的建模系统会提取实体之间的关系,并将关系单独存储到表和列中,而实体的类型和属性存储在其他列甚至其他表中,这使得数据管理费时费力。

Nebula Graph 作为一个典型的图数据库,可以将丰富的关系通过边及其类型和属性自然地呈现。
NebulaGraph 作为一个典型的图数据库,可以将丰富的关系通过边及其类型和属性自然地呈现。

## Nebula Graph 的优势
## NebulaGraph 的优势

### 开源

Nebula Graph 是在 Apache 2.0 条款下开发的。越来越多的人,如数据库开发人员、数据科学家、安全专家、算法工程师,都参与到 Nebula Graph 的设计和开发中来,欢迎访问 [Nebula Graph GitHub 主页](https://github.com/vesoft-inc/nebula)参与开源项目。
NebulaGraph 是在 Apache 2.0 条款下开发的。越来越多的人,如数据库开发人员、数据科学家、安全专家、算法工程师,都参与到 NebulaGraph 的设计和开发中来,欢迎访问 [NebulaGraph GitHub 主页](https://github.com/vesoft-inc/nebula)参与开源项目。

### 高性能

基于图数据库的特性使用 C++ 编写的 Nebula Graph,可以提供毫秒级查询。众多数据库中,Nebula Graph 在图数据服务领域展现了卓越的性能,数据规模越大,Nebula Graph 优势就越大。详情请参见 [Nebula Graph benchmarking 页面](https://discuss.nebula-graph.com.cn/t/topic/782)
基于图数据库的特性使用 C++ 编写的 NebulaGraph,可以提供毫秒级查询。众多数据库中,NebulaGraph 在图数据服务领域展现了卓越的性能,数据规模越大,NebulaGraph 优势就越大。详情请参见 [NebulaGraph benchmarking 页面](https://discuss.nebula-graph.com.cn/t/topic/782)

### 易扩展

Nebula Graph 采用 shared-nothing 架构,支持在不停止数据库服务的情况下扩缩容。
NebulaGraph 采用 shared-nothing 架构,支持在不停止数据库服务的情况下扩缩容。

### 易开发

Nebula Graph 提供 Java、Python、C++ 和 Go 等流行编程语言的客户端,更多客户端仍在开发中。详情请参见 [Nebula Graph clients](../14.client/1.nebula-client.md)
NebulaGraph 提供 Java、Python、C++ 和 Go 等流行编程语言的客户端,更多客户端仍在开发中。详情请参见 [NebulaGraph clients](../14.client/1.nebula-client.md)

### 高可靠访问控制

Nebula Graph 支持严格的角色访问控制和 LDAP(Lightweight Directory Access Protocol)等外部认证服务,能够有效提高数据安全性。详情请参见[验证和授权](../7.data-security/1.authentication/1.authentication.md)
NebulaGraph 支持严格的角色访问控制和 LDAP(Lightweight Directory Access Protocol)等外部认证服务,能够有效提高数据安全性。详情请参见[验证和授权](../7.data-security/1.authentication/1.authentication.md)

### 生态多样化

Nebula Graph 开放了越来越多的原生工具,例如 [Nebula Studio](https://github.com/vesoft-inc/nebula-studio)[Nebula Console](https://github.com/vesoft-inc/nebula-console)[Nebula Exchange](https://github.com/vesoft-inc/nebula-exchange) 等,更多工具可以查看[生态工具概览](../20.appendix/6.eco-tool-version.md)
NebulaGraph 开放了越来越多的原生工具,例如 [NebulaGraph Studio](https://github.com/vesoft-inc/nebula-studio)[NebulaGraph Console](https://github.com/vesoft-inc/nebula-console)[NebulaGraph Exchange](https://github.com/vesoft-inc/nebula-exchange) 等,更多工具可以查看[生态工具概览](../20.appendix/6.eco-tool-version.md)

此外,Nebula Graph 还具备与 Spark、Flink、HBase 等产品整合的能力,在这个充满挑战与机遇的时代,大大增强了自身的竞争力。
此外,NebulaGraph 还具备与 Spark、Flink、HBase 等产品整合的能力,在这个充满挑战与机遇的时代,大大增强了自身的竞争力。

### 兼容 openCypher 查询语言

Nebula Graph 查询语言,简称为 nGQL,是一种声明性的、部分兼容 openCypher 的文本查询语言,易于理解和使用。详细语法请参见 [nGQL 指南](../3.ngql-guide/1.nGQL-overview/1.overview.md)
NebulaGraph 查询语言,简称为 nGQL,是一种声明性的、部分兼容 openCypher 的文本查询语言,易于理解和使用。详细语法请参见 [nGQL 指南](../3.ngql-guide/1.nGQL-overview/1.overview.md)

### 面向未来硬件,读写平衡

闪存型设备有着极高的性能,并且[价格快速下降](https://blocksandfiles.com/wp-content/uploads/2021/01/Wikibon-SSD-less-than-HDD-in-2026.jpg)
Nebula Graph 是一个面向 SSD 设计的产品,相比于基于 HDD + 大内存的产品,更适合面向未来的硬件趋势,也更容易做到读写平衡。
NebulaGraph 是一个面向 SSD 设计的产品,相比于基于 HDD + 大内存的产品,更适合面向未来的硬件趋势,也更容易做到读写平衡。

### 灵活数据建模

用户可以轻松地在 Nebula Graph 中建立数据模型,不必将数据强制转换为关系表。而且可以自由增加、更新和删除属性。详情请参见[数据模型](2.data-model.md)
用户可以轻松地在 NebulaGraph 中建立数据模型,不必将数据强制转换为关系表。而且可以自由增加、更新和删除属性。详情请参见[数据模型](2.data-model.md)

### 广受欢迎

腾讯、美团、京东、快手、360 等科技巨头都在使用 Nebula Graph。详情请参见 [Nebula Graph 官网](https://nebula-graph.com.cn/)
腾讯、美团、京东、快手、360 等科技巨头都在使用 NebulaGraph。详情请参见 [NebulaGraph 官网](https://nebula-graph.com.cn/)

## 适用场景

Nebula Graph 可用于各种基于图的业务场景。为节约转换各类数据到关系型数据库的时间,以及避免复杂查询,建议使用 Nebula Graph
NebulaGraph 可用于各种基于图的业务场景。为节约转换各类数据到关系型数据库的时间,以及避免复杂查询,建议使用 NebulaGraph

### 欺诈检测

金融机构必须仔细研究大量的交易信息,才能检测出潜在的金融欺诈行为,并了解某个欺诈行为和设备的内在关联。这种场景可以通过图来建模,然后借助 Nebula Graph,可以很容易地检测出诈骗团伙或其他复杂诈骗行为。
金融机构必须仔细研究大量的交易信息,才能检测出潜在的金融欺诈行为,并了解某个欺诈行为和设备的内在关联。这种场景可以通过图来建模,然后借助 NebulaGraph,可以很容易地检测出诈骗团伙或其他复杂诈骗行为。

### 实时推荐

Nebula Graph 能够及时处理访问者产生的实时信息,并且精准推送文章、视频、产品和服务。
NebulaGraph 能够及时处理访问者产生的实时信息,并且精准推送文章、视频、产品和服务。

### 知识图谱

自然语言可以转化为知识图谱,存储在 Nebula Graph 中。用自然语言组织的问题可以通过智能问答系统中的语义解析器进行解析并重新组织,然后从知识图谱中检索出问题的可能答案,提供给提问人。
自然语言可以转化为知识图谱,存储在 NebulaGraph 中。用自然语言组织的问题可以通过智能问答系统中的语义解析器进行解析并重新组织,然后从知识图谱中检索出问题的可能答案,提供给提问人。

### 社交网络

人际关系信息是典型的图数据,Nebula Graph 可以轻松处理数十亿人和数万亿人际关系的社交网络信息,并在海量并发的情况下,提供快速的好友推荐和工作岗位查询。
人际关系信息是典型的图数据,NebulaGraph 可以轻松处理数十亿人和数万亿人际关系的社交网络信息,并在海量并发的情况下,提供快速的好友推荐和工作岗位查询。

## 视频

用户也可以通过视频了解什么是图数据。

- [图数据库 Nebula Graph 介绍视频](https://www.bilibili.com/video/BV1kf4y1v7LM)(01 分 39 秒)
- [图数据库 NebulaGraph 介绍视频](https://www.bilibili.com/video/BV1kf4y1v7LM)(01 分 39 秒)

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

Expand Down
12 changes: 6 additions & 6 deletions docs-2.0/1.introduction/2.data-model.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# 数据模型

本文介绍 Nebula Graph 的数据模型。数据模型是一种组织数据并说明它们如何相互关联的模型。
本文介绍 NebulaGraph 的数据模型。数据模型是一种组织数据并说明它们如何相互关联的模型。

## 数据模型

Nebula Graph 数据模型使用 6 种基本的数据模型:
NebulaGraph 数据模型使用 6 种基本的数据模型:

- 图空间(Space)

Expand All @@ -19,7 +19,7 @@ Nebula Graph 数据模型使用 6 种基本的数据模型:

!!! Compatibility

Nebula Graph 2.x 及以下版本中的点必须包含至少一个 Tag。
NebulaGraph 2.x 及以下版本中的点必须包含至少一个 Tag。

- 边(Edge)

Expand Down Expand Up @@ -55,7 +55,7 @@ Nebula Graph 数据模型使用 6 种基本的数据模型:

## 有向属性图

Nebula Graph 使用有向属性图模型,指点和边构成的图,这些边是有方向的,点和边都可以有属性。
NebulaGraph 使用有向属性图模型,指点和边构成的图,这些边是有方向的,点和边都可以有属性。

下表为篮球运动员数据集的结构示例,包括两种类型的点(**player****team**)和两种类型的边(**serve****follow**)。

Expand All @@ -68,10 +68,10 @@ Nebula Graph 使用有向属性图模型,指点和边构成的图,这些边

!!! Note

Nebula Graph 中没有无向边,只支持有向边。
NebulaGraph 中没有无向边,只支持有向边。

!!! compatibility

由于 Nebula Graph {{ nebula.release }} 的数据模型中,允许存在"悬挂边",因此在增删时,用户需自行保证“一条边所对应的起点和终点”的存在性。详见 [INSERT VERTEX](../3.ngql-guide/12.vertex-statements/1.insert-vertex.md)[DELETE VERTEX](../3.ngql-guide/12.vertex-statements/4.delete-vertex.md)[INSERT EDGE](../3.ngql-guide/13.edge-statements/1.insert-edge.md)[DELETE EDGE](../3.ngql-guide/13.edge-statements/4.delete-edge.md)
由于 NebulaGraph {{ nebula.release }} 的数据模型中,允许存在"悬挂边",因此在增删时,用户需自行保证“一条边所对应的起点和终点”的存在性。详见 [INSERT VERTEX](../3.ngql-guide/12.vertex-statements/1.insert-vertex.md)[DELETE VERTEX](../3.ngql-guide/12.vertex-statements/4.delete-vertex.md)[INSERT EDGE](../3.ngql-guide/13.edge-statements/1.insert-edge.md)[DELETE EDGE](../3.ngql-guide/13.edge-statements/4.delete-edge.md)

不支持 openCypher 中的 MERGE 语句。
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
# Nebula Graph 架构总览
# NebulaGraph 架构总览

Nebula Graph 由三种服务构成:Graph 服务、Meta 服务和 Storage 服务,是一种存储与计算分离的架构。
NebulaGraph 由三种服务构成:Graph 服务、Meta 服务和 Storage 服务,是一种存储与计算分离的架构。

每个服务都有可执行的二进制文件和对应进程,用户可以使用这些二进制文件在一个或多个计算机上部署 Nebula Graph 集群。
每个服务都有可执行的二进制文件和对应进程,用户可以使用这些二进制文件在一个或多个计算机上部署 NebulaGraph 集群。

下图展示了 Nebula Graph 集群的经典架构。
下图展示了 NebulaGraph 集群的经典架构。

![Nebula Graph architecture](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-architecture_3.png "Nebula Graph architecture")
![NebulaGraph architecture](https://docs-cdn.nebula-graph.com.cn/figures/nebula-graph-architecture_3.png "NebulaGraph architecture")

## Meta 服务

Nebula Graph 架构中,Meta 服务是由 nebula-metad 进程提供的,负责数据管理,例如 Schema 操作、集群管理和用户权限管理等。
NebulaGraph 架构中,Meta 服务是由 nebula-metad 进程提供的,负责数据管理,例如 Schema 操作、集群管理和用户权限管理等。

Meta 服务的详细说明,请参见 [Meta 服务](2.meta-service.md)

## Graph 服务和 Storage 服务

Nebula Graph 采用计算存储分离架构。Graph 服务负责处理计算请求,Storage 服务负责存储数据。它们由不同的进程提供,Graph 服务是由 nebula-graphd 进程提供,Storage 服务是由 nebula-storaged 进程提供。计算存储分离架构的优势如下:
NebulaGraph 采用计算存储分离架构。Graph 服务负责处理计算请求,Storage 服务负责存储数据。它们由不同的进程提供,Graph 服务是由 nebula-graphd 进程提供,Storage 服务是由 nebula-storaged 进程提供。计算存储分离架构的优势如下:

- 易扩展

Expand All @@ -30,7 +30,7 @@ Nebula Graph 采用计算存储分离架构。Graph 服务负责处理计算请

计算存储分离架构能够提高资源利用率,而且可根据业务需求灵活控制成本。

<!--如果使用 [Nebula Graph Cloud](https://cloud.nebula-graph.com.cn/ "Nebula Graph Cloud official website"),可以进一步节约前期成本。-->
<!--如果使用 [NebulaGraph Cloud](https://cloud.nebula-graph.com.cn/ "NebulaGraph Cloud official website"),可以进一步节约前期成本。-->

- 更多可能性

Expand Down
Loading

0 comments on commit 8d526d0

Please sign in to comment.