From 86ca2185568619caa31fd07f7b29d74a567011ad Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 14:12:11 +0800 Subject: [PATCH 001/132] Merge to v3.3.0 --- .github/workflows/deploy.yaml | 8 ++-- docs-2.0/stylesheets/extra.css | 8 ++-- mkdocs.yml | 4 +- overrides/partials/header.html | 74 ---------------------------------- 4 files changed, 10 insertions(+), 84 deletions(-) delete mode 100644 overrides/partials/header.html diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml index b964cce273..bd47bc5d5d 100644 --- a/.github/workflows/deploy.yaml +++ b/.github/workflows/deploy.yaml @@ -2,7 +2,7 @@ name: Publish docs via GitHub Pages on: push: branches: - - master + - v3.3.0 jobs: deploy: @@ -27,7 +27,7 @@ jobs: - name: mike run: | git fetch origin gh-pages --depth=1 # fix mike's CI update - mike deploy master -p --rebase + mike deploy v3.3.0 -p --rebase mike list - name: show git branch @@ -37,7 +37,7 @@ jobs: git checkout gh-pages - name: Compress run: | - tar -vczf nebula-docs.tar.gz master versions.json *.html + tar -vczf nebula-docs.tar.gz 3.3.0 versions.json *.html - name: Transfer # uses: garygrossgarten/github-action-scp@release @@ -60,7 +60,7 @@ jobs: mkdir -p /usr/web/nebula-docs/ tar -xzf /usr/web/nebula-docs.tar.gz -C /usr/web/nebula-docs/ mkdir -p /usr/web/nebula-docs/site/pdf/ - cp -f /usr/web/nebula-docs/master/pdf/NebulaGraph-CN.pdf /usr/web/nebula-docs/site/pdf/NebulaGraph-book.pdf + cp -f /usr/web/nebula-docs/3.3.0/pdf/NebulaGraph-CN.pdf /usr/web/nebula-docs/site/pdf/NebulaGraph-book.pdf # pip3 install --upgrade pip # pip3 install -r /usr/web/nebula-docs/requirement.txt diff --git a/docs-2.0/stylesheets/extra.css b/docs-2.0/stylesheets/extra.css index 66e78d3326..79403aff7b 100644 --- a/docs-2.0/stylesheets/extra.css +++ b/docs-2.0/stylesheets/extra.css @@ -4,14 +4,14 @@ /* NebulaGraph 黑夜主题色 */ :root{ - --md-primary-fg-color: #FF0000; /* 导航栏页面颜色 */ - --md-accent-fg-color: #49BDF0; /* 选中/悬浮颜色 */ + --md-primary-fg-color: #6b2e38; /* 导航栏页面颜色 */ + --md-accent-fg-color: #f04949; /* 选中/悬浮颜色 */ } /* NebulaGraph 白天主题色 */ [data-md-color-scheme="nebula"]{ - --md-primary-fg-color: #F7A7A0; /* 导航栏页面颜色 */ - --md-accent-fg-color: #7DBB7C; /* 选中/悬浮颜色 */ + --md-primary-fg-color: #C65467; /* 导航栏页面颜色 */ + --md-accent-fg-color: #bb7d7c; /* 选中/悬浮颜色 */ --md-code-fg-color: rgb(12, 21, 26); /* 代码段字体色 */ --md-code-bg-color: #eaebec;/* 代码段背景色 */ diff --git a/mkdocs.yml b/mkdocs.yml index 6f8c993cb9..a419181a41 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -8,7 +8,7 @@ docs_dir: docs-2.0 copyright: Copyright © 2022 NebulaGraph - 浙ICP备20010487号 # modify when release: -edit_uri: 'edit/master/docs-2.0/' +edit_uri: 'edit/v3.3.0/docs-2.0/' # Configuration theme: @@ -104,7 +104,7 @@ plugins: # modify when release: - with-pdf: copyright: 2022 vesoft Inc. - cover_subtitle: master + cover_subtitle: 3.3.0 author: 吴敏，周瑶，梁振亚，杨怡璇，黄凤仙 cover: true back_cover: true diff --git a/overrides/partials/header.html b/overrides/partials/header.html deleted file mode 100644 index adb60a1dc5..0000000000 --- a/overrides/partials/header.html +++ /dev/null @@ -1,74 +0,0 @@ -
- -
From e3c2c1e8c45d2e04c1427ae27905a602edf24085 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 14:15:21 +0800 Subject: [PATCH 002/132] Update mkdocs.yml --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index a419181a41..63d552fe76 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -61,7 +61,7 @@ markdown_extensions: # Plugins plugins: - - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 + # - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 - macros: include_dir: docs-2.0/reuse/ - git-revision-date-localized From 5da655f5daa9b6ae2f887ac6fc3c61e589d89adf Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 15:31:53 +0800 Subject: [PATCH 003/132] Update deploy.yaml --- .github/workflows/deploy.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml index bd47bc5d5d..05251d594a 100644 --- a/.github/workflows/deploy.yaml +++ b/.github/workflows/deploy.yaml @@ -27,7 +27,7 @@ jobs: - name: mike run: | git fetch origin gh-pages --depth=1 # fix mike's CI update - mike deploy v3.3.0 -p --rebase + mike deploy 3.3.0 -p --rebase mike list - name: show git branch From 0f321a298218f339db1c482ed6a7655d311eb37f Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 16:20:02 +0800 Subject: [PATCH 004/132] update --- docs-2.0/README.md | 2 +- docs-2.0/stylesheets/extra.css | 4 ++-- mkdocs.yml | 33 +++++++++++++++++---------------- 3 files changed, 20 insertions(+), 19 deletions(-) diff --git a/docs-2.0/README.md b/docs-2.0/README.md index fc1f0a8ccb..910843a73e 100644 --- a/docs-2.0/README.md +++ b/docs-2.0/README.md @@ -7,7 +7,7 @@ --> !!! Note - 本文档更新时间{{ now().year }}-{{ now().month }}-{{ now().day }}，GitHub commit [{{ git.short_commit }}](https://github.com/vesoft-inc/nebula-docs/commits/v{{nebula.release}})。该版本主色系为"深粉色"，色号为 #F7A7A0。 + 本文档更新时间{{ now().year }}-{{ now().month }}-{{ now().day }}，GitHub commit [{{ git.short_commit }}](https://github.com/vesoft-inc/nebula-docs/commits/v{{nebula.release}})。该版本主色系为"海后红"，色号为 #C65467。 !!! Compatibility diff --git a/docs-2.0/stylesheets/extra.css b/docs-2.0/stylesheets/extra.css index 79403aff7b..33e4e792c5 100644 --- a/docs-2.0/stylesheets/extra.css +++ b/docs-2.0/stylesheets/extra.css @@ -4,8 +4,8 @@ /* NebulaGraph 黑夜主题色 */ :root{ - --md-primary-fg-color: #6b2e38; /* 导航栏页面颜色 */ - --md-accent-fg-color: #f04949; /* 选中/悬浮颜色 */ + --md-primary-fg-color: #C65467; /* 导航栏页面颜色 */ + --md-accent-fg-color: #bb7d7c; /* 选中/悬浮颜色 */ } /* NebulaGraph 白天主题色 */ diff --git a/mkdocs.yml b/mkdocs.yml index 63d552fe76..09182dda37 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -281,12 +281,6 @@ nav: - 步骤 1：创建云服务实例: 2.quick-start/2.quick-start-on-cloud/1.create-instance-on-cloud.md - 步骤 2：连接 NebulaGraph: 2.quick-start/2.quick-start-on-cloud/2.connect-to-nebulagraph-on-cloud.md - 步骤 3：管理数据: 2.quick-start/2.quick-start-on-cloud/3.how-to-query-on-cloud.md - - 本地部署: - - 步骤 1：安装 NebulaGraph: 2.quick-start/3.quick-start-on-premise/2.install-nebula-graph.md - - 步骤 2：启动 NebulaGraph: 2.quick-start/3.quick-start-on-premise/5.start-stop-service.md - - 步骤 3：连接 NebulaGraph: 2.quick-start/3.quick-start-on-premise/3.connect-to-nebula-graph.md - - 步骤 4：注册 Storage 服务: 2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts.md - - 步骤 5：使用基本 nGQL 命令: 2.quick-start/3.quick-start-on-premise/4.nebula-graph-crud.md - nGQL 命令汇总: 2.quick-start/6.cheatsheet-for-ngql-command.md - nGQL 指南: @@ -439,15 +433,21 @@ nav: - 作业管理: 3.ngql-guide/4.job-statements.md - 安装部署: - - 准备资源: 4.deployment-and-installation/1.resource-preparations.md - - 编译与安装: - - 使用源码安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md - - 使用 RPM/DEB 包安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/2.install-nebula-graph-by-rpm-or-deb.md - - 使用 tar.gz 文件安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md - - 使用 Docker Compose 部署: 4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md - - 使用 RPM/DEB 包部署多机集群: 4.deployment-and-installation/2.compile-and-install-nebula-graph/deploy-nebula-graph-cluster.md - - 使用生态工具安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/6.deploy-nebula-graph-with-peripherals.md - - 安装存算合并版 NebulaGraph: 4.deployment-and-installation/standalone-deployment.md + - 本地部署: + - 步骤 1：安装 NebulaGraph: 2.quick-start/3.quick-start-on-premise/2.install-nebula-graph.md + - 步骤 2：启动 NebulaGraph: 2.quick-start/3.quick-start-on-premise/5.start-stop-service.md + - 步骤 3：连接 NebulaGraph: 2.quick-start/3.quick-start-on-premise/3.connect-to-nebula-graph.md + - 步骤 4：注册 Storage 服务: 2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts.md + - 步骤 5：使用基本 nGQL 命令: 2.quick-start/3.quick-start-on-premise/4.nebula-graph-crud.md + - 准备资源: 4.deployment-and-installation/1.resource-preparations.md + - 编译与安装: + - 使用源码安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md + - 使用 RPM/DEB 包安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/2.install-nebula-graph-by-rpm-or-deb.md + - 使用 tar.gz 文件安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md + - 使用 Docker Compose 部署: 4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md + - 使用 RPM/DEB 包部署多机集群: 4.deployment-and-installation/2.compile-and-install-nebula-graph/deploy-nebula-graph-cluster.md + - 使用生态工具安装: 4.deployment-and-installation/2.compile-and-install-nebula-graph/6.deploy-nebula-graph-with-peripherals.md + - 安装存算合并版 NebulaGraph: 4.deployment-and-installation/standalone-deployment.md #ent #ent - 设置 NebulaGraph 企业版 License: 4.deployment-and-installation/deploy-license.md - 管理服务: 4.deployment-and-installation/manage-service.md @@ -723,7 +723,8 @@ nav: - 附录: - Release Note: - NebulaGraph 社区版: 20.appendix/release-notes/nebula-comm-release-note.md - - NebulaGraph 企业版: 20.appendix/release-notes/nebula-ent-release-note.md +#ent +#ent - NebulaGraph 企业版: 20.appendix/release-notes/nebula-ent-release-note.md - NebulaGraph Studio: 20.appendix/release-notes/studio-release-note.md - NebulaGraph Dashboard 社区版: 20.appendix/release-notes/dashboard-comm-release-note.md - NebulaGraph Dashboard 企业版: 20.appendix/release-notes/dashboard-ent-release-note.md From 828b70ccef17f9094bbbf37b0edfb6f9d120e4ea Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 16:26:42 +0800 Subject: [PATCH 005/132] Update deploy.yaml --- .github/workflows/deploy.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml index 05251d594a..f13117a503 100644 --- a/.github/workflows/deploy.yaml +++ b/.github/workflows/deploy.yaml @@ -28,6 +28,7 @@ jobs: run: | git fetch origin gh-pages --depth=1 # fix mike's CI update mike deploy 3.3.0 -p --rebase + mike set-default 3.3.0 -p --rebase mike list - name: show git branch From da59ae13d0b818ee3f5830215d9cb2de2870bb59 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 2 Nov 2022 16:28:58 +0800 Subject: [PATCH 006/132] Update 0.FAQ.md (#2290) --- docs-2.0/20.appendix/0.FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/20.appendix/0.FAQ.md b/docs-2.0/20.appendix/0.FAQ.md index 70508b8510..2fe57534cc 100644 --- a/docs-2.0/20.appendix/0.FAQ.md +++ b/docs-2.0/20.appendix/0.FAQ.md @@ -166,7 +166,7 @@ Storage 服务在毫秒级时间内多次收到插入或者更新同一点或边 - 导入数据时，手动 [compaction](../8.service-tuning/compaction.md)，加速读的速度。 -- 增加 Graph 服务与 Storage 服务的 RPC 连接超时时间，在`nebula-storaged.conf`文件里面修改`--storage_client_timeout_ms`参数的值。该值的单位为毫秒（ms），默认值为 60000 毫秒。 +- 增加 Graph 服务与 Storage 服务的 RPC 连接超时时间，在`nebula-graphd.conf`文件里面修改`--storage_client_timeout_ms`参数的值。该值的单位为毫秒（ms），默认值为 60000 毫秒。 From ec6242d651bded3ceab162a4203aa5f6fdb756a4 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 2 Nov 2022 17:05:16 +0800 Subject: [PATCH 007/132] Update mkdocs.yml --- mkdocs.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 09182dda37..df8465c516 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -450,15 +450,15 @@ nav: - 安装存算合并版 NebulaGraph: 4.deployment-and-installation/standalone-deployment.md #ent #ent - 设置 NebulaGraph 企业版 License: 4.deployment-and-installation/deploy-license.md - - 管理服务: 4.deployment-and-installation/manage-service.md - - 连接服务: 4.deployment-and-installation/connect-to-nebula-graph.md - - 管理 Storage 主机: 4.deployment-and-installation/manage-storage-host.md -# - 管理逻辑机架（Zone）: 4.deployment-and-installation/5.zone.md - - - 升级版本: - - 升级 NebulaGraph 版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md - - 升级 v3.0.x 至当前版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md - - 卸载 NebulaGraph: 4.deployment-and-installation/4.uninstall-nebula-graph.md + - 管理服务: 4.deployment-and-installation/manage-service.md + - 连接服务: 4.deployment-and-installation/connect-to-nebula-graph.md + - 管理 Storage 主机: 4.deployment-and-installation/manage-storage-host.md +# - 管理逻辑机架（Zone）: 4.deployment-and-installation/5.zone.md + + - 升级版本: + - 升级 NebulaGraph 版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md + - 升级 v3.0.x 至当前版本: 4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md + - 卸载 NebulaGraph: 4.deployment-and-installation/4.uninstall-nebula-graph.md - 配置与日志: - 配置: From cef70db95d7cc468a3e07f17bcfb1ee0501f4f3a Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 09:12:51 +0800 Subject: [PATCH 008/132] Update mkdocs.yml --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index df8465c516..348bcabe3a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -104,7 +104,7 @@ plugins: # modify when release: - with-pdf: copyright: 2022 vesoft Inc. - cover_subtitle: 3.3.0 + cover_subtitle: v3.3.0 author: 吴敏，周瑶，梁振亚，杨怡璇，黄凤仙 cover: true back_cover: true From 1c825abec4c0560f4ff2fe4d7e843fb445c61642 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 09:14:36 +0800 Subject: [PATCH 009/132] Update deploy.yaml --- .github/workflows/deploy.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml index f13117a503..a6089f5ca7 100644 --- a/.github/workflows/deploy.yaml +++ b/.github/workflows/deploy.yaml @@ -10,7 +10,7 @@ jobs: steps: - uses: actions/checkout@v2 with: - fetch-depth: 0 # fetch all commits/branches + fetch-depth: 1 # fetch all commits/branches - name: Setup Python uses: actions/setup-python@v1 From 3aa1f7c8333dbdd6689c09dc3ef94b57056c6288 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Thu, 3 Nov 2022 09:43:14 +0800 Subject: [PATCH 010/132] Update mkdocs.yml --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 348bcabe3a..6b07b43c8b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -61,7 +61,7 @@ markdown_extensions: # Plugins plugins: - # - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 + - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 - macros: include_dir: docs-2.0/reuse/ - git-revision-date-localized From 2318a02feaabc4e5738e0ecaec6a40e90f1e1879 Mon Sep 17 00:00:00 2001 From: Wey Gu Date: Thu, 3 Nov 2022 10:15:16 +0800 Subject: [PATCH 011/132] chore: enable algolia search (#2293) --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 6b07b43c8b..348bcabe3a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -61,7 +61,7 @@ markdown_extensions: # Plugins plugins: - - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 + # - search # 这个是原有的 mkdocs 搜索插件， 如果想使用algolia搜索，请注释掉这个插件 - macros: include_dir: docs-2.0/reuse/ - git-revision-date-localized From a19295b3cfaf90d7e3b92c000f4bed9b63020674 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Thu, 3 Nov 2022 10:17:05 +0800 Subject: [PATCH 012/132] Update mkdocs.yml --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 348bcabe3a..c1a15965a8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -131,7 +131,7 @@ extra: # Google Analytics. analytics: provider: google - property: UA-60523578-7 + property: UA-60523578-15 # branch represents code names (git clone). release represents version number used in texts. version: method: mike From 9a0ce5eb89959b44e7971e61ddf56cb795802155 Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Thu, 3 Nov 2022 10:48:18 +0800 Subject: [PATCH 013/132] Fix favicon --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index c1a15965a8..4c480bd61e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -15,7 +15,7 @@ theme: name: material custom_dir: overrides logo: 'https://cloud-cdn.nebula-graph.com.cn/vesoft-nebula-logo-white.png' - favicon: 'assets/images/favicon.ico' + favicon: 'https://docs-cdn.nebula-graph.com.cn/figures/favicon.ico' # Change color in `stylesheets > extra.css` palette: - scheme: nebula From bc1288c4e632b614a390bea3ccf96bbeaa339f9b Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Thu, 3 Nov 2022 10:49:41 +0800 Subject: [PATCH 014/132] Fix favicon (#2295) --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index c1a15965a8..4c480bd61e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -15,7 +15,7 @@ theme: name: material custom_dir: overrides logo: 'https://cloud-cdn.nebula-graph.com.cn/vesoft-nebula-logo-white.png' - favicon: 'assets/images/favicon.ico' + favicon: 'https://docs-cdn.nebula-graph.com.cn/figures/favicon.ico' # Change color in `stylesheets > extra.css` palette: - scheme: nebula From 5f95547e0603e46e1c7c7f53e0ca6e3cece112ee Mon Sep 17 00:00:00 2001 From: Jerry Liang <8124783+nianiaJR@users.noreply.github.com> Date: Thu, 3 Nov 2022 11:01:08 +0800 Subject: [PATCH 015/132] fix: missing file causing doc search issue (#2296) --- overrides/partials/header.html | 74 ++++++++++++++++++++++++++++++++++ 1 file changed, 74 insertions(+) create mode 100644 overrides/partials/header.html diff --git a/overrides/partials/header.html b/overrides/partials/header.html new file mode 100644 index 0000000000..adb60a1dc5 --- /dev/null +++ b/overrides/partials/header.html @@ -0,0 +1,74 @@ +
+ +
From 8b3fb34466b4569a2cfd78e4d146f65590368bf7 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 13:42:09 +0800 Subject: [PATCH 016/132] Update 1.what-is-dashboard.md --- docs-2.0/nebula-dashboard/1.what-is-dashboard.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-dashboard/1.what-is-dashboard.md b/docs-2.0/nebula-dashboard/1.what-is-dashboard.md index 2120857b9f..d2a6da1071 100644 --- a/docs-2.0/nebula-dashboard/1.what-is-dashboard.md +++ b/docs-2.0/nebula-dashboard/1.what-is-dashboard.md @@ -52,5 +52,6 @@ NebulaGraph 的版本和 Dashboard 社区版的版本对应关系如下。 ## 视频 - * [NebulaGraph Dashboard Demo 介绍（v3.0 版本）](https://www.bilibili.com/video/BV12A4y1f7KL/)（2 分 57 秒） - \ No newline at end of file +[NebulaGraph Dashboard Demo 介绍（v3.0 版本）](https://www.bilibili.com/video/BV12A4y1f7KL/)（2 分 57 秒） + + From b57f29565dd7974f54115a60bcc777e700d69092 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 13:45:17 +0800 Subject: [PATCH 017/132] Update 2.deploy-dashboard.md --- docs-2.0/nebula-dashboard/2.deploy-dashboard.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-dashboard/2.deploy-dashboard.md b/docs-2.0/nebula-dashboard/2.deploy-dashboard.md index 576efeeac7..8be6e2dc8b 100644 --- a/docs-2.0/nebula-dashboard/2.deploy-dashboard.md +++ b/docs-2.0/nebula-dashboard/2.deploy-dashboard.md @@ -28,7 +28,7 @@ | Dashboard 安装包 | NebulaGraph 版本 | | :----- | :----- | -| [nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz](https://oss-cdn.nebula-graph.com.cn/nebula-graph-dashboard/{{ dashboard.release }}/nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz) | 2.5.x ~ 3.1.x | +| [nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz](https://oss-cdn.nebula-graph.com.cn/nebula-graph-dashboard/{{ dashboard.release }}/nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz) | 3.3.0 | ## 目录结构说明 From b6385f1e8cf1f68a2dc631f531a98a60797a5cf0 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 13:53:53 +0800 Subject: [PATCH 018/132] Update 4.use-dashboard.md --- docs-2.0/nebula-dashboard/4.use-dashboard.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-dashboard/4.use-dashboard.md b/docs-2.0/nebula-dashboard/4.use-dashboard.md index 393dc37c56..f432520a16 100644 --- a/docs-2.0/nebula-dashboard/4.use-dashboard.md +++ b/docs-2.0/nebula-dashboard/4.use-dashboard.md @@ -4,7 +4,7 @@ Dashboard 页面主要分为机器、服务、管理三个部分，本文将详 ## 页面概览 -![页面概览](https://docs-cdn.nebula-graph.com.cn/figures/overview1-220922-cn.png) +![页面概览](https://docs-cdn.nebula-graph.com.cn/figures/overview1-221103-cn.png) ## 机器页面介绍 @@ -17,6 +17,7 @@ Dashboard 页面主要分为机器、服务、管理三个部分，本文将详 - 页面的监控数据默认不自动更新，可以调整**更新频率**让页面自动更新，也可以单击![setup](https://docs-cdn.nebula-graph.com.cn/figures/refresh-220616.png)按钮手动更新。 - 如果需要设置基线，作为参考标准线，可以单击模块右上角的![setup](https://docs-cdn.nebula-graph.com.cn/figures/Setup_cn.png) 按钮。 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择`Load`查看详情信息，如下图。 + ![load](https://docs-cdn.nebula-graph.com.cn/figures/ds-load-220913-cn.png) - 可以设置监控时间段、实例、更新频率和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](6.monitor-parameter.md)。 @@ -38,6 +39,7 @@ Dashboard 页面主要分为机器、服务、管理三个部分，本文将详 - 页面的监控数据默认不自动更新，可以调整**更新频率**让页面自动更新，也可以单击![setup](https://docs-cdn.nebula-graph.com.cn/figures/refresh-220616.png)按钮手动更新。 - 可以查看集群内所有服务的状态。 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择 `Graph` 查看详情信息，如下图。 + ![service](https://docs-cdn.nebula-graph.com.cn/figures/ds-graph-220913-cn.png) - 可以设置监控时间段、实例、更新频率、周期、聚合方式和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](6.monitor-parameter.md)。 @@ -132,4 +134,4 @@ Dashboard 支持的图空间指标，参见[图空间级别监控指标](6.monit - 查看帮助信息 -- 折叠侧边栏 \ No newline at end of file +- 折叠侧边栏 From ba83666dcdd132f4e8d20480baee7b0f4399c439 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 13:56:21 +0800 Subject: [PATCH 019/132] Update 2.deploy-dashboard.md --- docs-2.0/nebula-dashboard/2.deploy-dashboard.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs-2.0/nebula-dashboard/2.deploy-dashboard.md b/docs-2.0/nebula-dashboard/2.deploy-dashboard.md index 8be6e2dc8b..d533bf7b6e 100644 --- a/docs-2.0/nebula-dashboard/2.deploy-dashboard.md +++ b/docs-2.0/nebula-dashboard/2.deploy-dashboard.md @@ -24,11 +24,7 @@ ## 下载 Dashboard -在每台机器上下载 TAR 包，建议选择最新版本。 - -| Dashboard 安装包 | NebulaGraph 版本 | -| :----- | :----- | -| [nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz](https://oss-cdn.nebula-graph.com.cn/nebula-graph-dashboard/{{ dashboard.release }}/nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz) | 3.3.0 | +在每台机器上下载 TAR 包 [nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz](https://oss-cdn.nebula-graph.com.cn/nebula-graph-dashboard/{{ dashboard.release }}/nebula-dashboard-{{ dashboard.release }}.x86_64.tar.gz)。 ## 目录结构说明 From c0e120e1b179b5493c4a37b186563b2a24e2a301 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 14:00:33 +0800 Subject: [PATCH 020/132] Update 2.deploy-connect-dashboard-ent.md --- docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md index aced538732..fb835236d9 100644 --- a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md @@ -271,6 +271,7 @@ $ sudo /dashboard/scripts/dashboard.service restart all #重启 Dashboard 所有 userFilter: "&(objectClass=*)" # 查询条件。 emailKey: mail # LDAP 数据库存放邮箱信息的字段名。 ``` + ### 查看日志 用户可以在`/var/log/messages`路径下查看 Dashboard 企业版的操作日志。 @@ -388,6 +389,7 @@ sudo rpm -e webAddress: http://127.0.0.1:7005 # 邮件被邀请人连接 Dashboard 的访问地址。 messageStore: 90 # 告警消息保存的天数，默认 90 天。 ``` + ### 查看日志 用户可以在`/var/log/syslog`路径下查看 Dashboard 企业版的操作日志。 From 3c10f77e4869d66b7e81b91722f67a5dc7934e8f Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 14:15:18 +0800 Subject: [PATCH 021/132] Update 4.use-dashboard.md --- docs-2.0/nebula-dashboard/4.use-dashboard.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs-2.0/nebula-dashboard/4.use-dashboard.md b/docs-2.0/nebula-dashboard/4.use-dashboard.md index f432520a16..c673c01d54 100644 --- a/docs-2.0/nebula-dashboard/4.use-dashboard.md +++ b/docs-2.0/nebula-dashboard/4.use-dashboard.md @@ -19,6 +19,7 @@ Dashboard 页面主要分为机器、服务、管理三个部分，本文将详 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择`Load`查看详情信息，如下图。 ![load](https://docs-cdn.nebula-graph.com.cn/figures/ds-load-220913-cn.png) + - 可以设置监控时间段、实例、更新频率和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](6.monitor-parameter.md)。 - 可以暂时隐藏不需要查看的节点。 @@ -41,6 +42,7 @@ Dashboard 页面主要分为机器、服务、管理三个部分，本文将详 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择 `Graph` 查看详情信息，如下图。 ![service](https://docs-cdn.nebula-graph.com.cn/figures/ds-graph-220913-cn.png) + - 可以设置监控时间段、实例、更新频率、周期、聚合方式和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](6.monitor-parameter.md)。 - 可以暂时隐藏不需要查看的节点。 From 8de0471a348f41a13210a75d801dfee9a2c2a5fa Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 14:30:53 +0800 Subject: [PATCH 022/132] Update 2.monitor.md --- docs-2.0/nebula-dashboard-ent/4.cluster-operator/2.monitor.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/2.monitor.md b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/2.monitor.md index bc8a575377..73ec53121e 100644 --- a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/2.monitor.md +++ b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/2.monitor.md @@ -15,7 +15,9 @@ - 页面的监控数据默认不自动更新，可以调整**更新频率**让页面自动更新，也可以单击![setup](https://docs-cdn.nebula-graph.com.cn/figures/refresh-220616.png)按钮手动更新。 - 如果需要设置基线，作为参考标准线，可以单击模块右上角的![setup](https://docs-cdn.nebula-graph.com.cn/figures/Setup_cn.png) 按钮。 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择`Load`查看详情信息，如下图。 + ![load](https://docs-cdn.nebula-graph.com.cn/figures/ds-load-220913-cn.png) + - 可以设置监控时间段、实例、更新频率和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](../7.monitor-parameter.md)。 - 可以暂时隐藏不需要查看的节点。 @@ -36,7 +38,9 @@ - 页面的监控数据默认不自动更新，可以调整**更新频率**让页面自动更新，也可以单击![setup](https://docs-cdn.nebula-graph.com.cn/figures/refresh-220616.png)按钮手动更新。 - 可以查看集群内所有服务的状态。 - 如果需要查看某一项更详细的监控指标，可以单击模块右上角的![watch](https://docs-cdn.nebula-graph.com.cn/figures/watch_cn.png) 按钮，在示例中选择 `Graph` 查看详情信息，如下图。 + ![service](https://docs-cdn.nebula-graph.com.cn/figures/ds-graph-220913-cn.png) + - 可以设置监控时间段、实例、更新频率、周期、聚合方式和基线。 - 可以搜索和勾选指标。监控指标详情请参见[监控指标说明](../7.monitor-parameter.md)。 - 可以暂时隐藏不需要查看的节点。 From 89b4af3708b46dd0b455731aa657e27dc3329f79 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 16:00:42 +0800 Subject: [PATCH 023/132] Update ex-ug-deploy.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index 327dd7c9e2..520f8d36e8 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -227,12 +227,6 @@ Dag Controller 是一款任务编排调度工具，可以编排调度有向无 Dag Controller 可以结合 NebulaGraph Analytics 进行复杂的图计算。例如 Dag Controller 将算法调用请求发送给 NebulaGraph Analytics ，NebulaGraph Analytics 保存结果至 NebulaGraph 或 HDFS，Dag Controller 再将上次的计算结果作为下一个算法任务的输入创建新的任务。 -### 前提条件 - -- 已部署 2.2.x 或以上版本的 [HDFS](https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-common/ClusterSetup.html)。 - -- 已安装 1.8 版本的 JDK。 - ### 配置步骤 1. 配置 Dag Controller 机器 SSH 免密登录 NebulaGraph Analytics 机器，以及 NebulaGraph Analytics 集群内所有节点间的 SSH 相互免密登录。 From 7a82973b3b19cb01dbc89b4a9ba0bfac5c0f9a12 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 16:01:20 +0800 Subject: [PATCH 024/132] Update nebula-analytics.md --- docs-2.0/graph-computing/nebula-analytics.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs-2.0/graph-computing/nebula-analytics.md b/docs-2.0/graph-computing/nebula-analytics.md index d73234296d..716128948b 100644 --- a/docs-2.0/graph-computing/nebula-analytics.md +++ b/docs-2.0/graph-computing/nebula-analytics.md @@ -5,8 +5,14 @@ NebulaGraph Analytics 是一款高性能图计算框架工具，支持对 Nebula ## 前提条件 - [联系我们](https://www.nebula-graph.com.cn/contact)获取 Nebula Analytics 安装包。 + - [准备 Nebula Analytics License](analytics-ent-license.md)。 +- 已部署 2.2.x 或以上版本的 [HDFS](https://hadoop.apache.org/docs/stable/hadoop-project-dist/hadoop-common/ClusterSetup.html)。 + +- 已安装 1.8 版本的 JDK。 + + ## 适用场景 支持将数据源为 NebulaGraph 集群、HDFS 上的 CSV 文件或本地 CSV 文件中的数据导入 NebulaGraph Analytics，并将图计算结果输出至 NebulaGraph 集群、HDFS 上的 CSV 文件或本地 CSV 文件。 From 2d729c2f64ab013be4395dca5668739c3287c3d5 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 17:31:00 +0800 Subject: [PATCH 025/132] Update ex-ug-connect.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md index 2555247fea..fb78f065e5 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md @@ -49,7 +49,8 @@ OAuth 部分的配置说明如下。 !!! Note - 即使 NebulaGraph 数据库与 Explorer 部署在同一台机器上，用户也必须在 **Host** 字段填写这台机器的本机 IP 地址，而不是 `127.0.0.1` 或者 `localhost`。 + - 即使 NebulaGraph 数据库与 Explorer 部署在同一台机器上，用户也必须在 **Host** 字段填写这台机器的本机 IP 地址，而不是 `127.0.0.1` 或者 `localhost`。 + - 在新的标签页连接另一个 NebulaGraph 数据库时，会覆盖旧标签页的会话。如果需要同时登录多个 NebulaGraph 数据库，可以用不同的浏览器或者无痕模式。 - **用户名**和**密码**：根据 NebulaGraph 的[身份验证](../../7.data-security/1.authentication/1.authentication.md)设置填写登录账号和密码。 - 如果未启用身份验证，可以填写默认用户名 `root` 和任意密码。 From a91d16789d98e6d71d8245f954b8ea391c032b36 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 3 Nov 2022 17:41:23 +0800 Subject: [PATCH 026/132] Update nebula-analytics.md --- docs-2.0/graph-computing/nebula-analytics.md | 23 ++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/docs-2.0/graph-computing/nebula-analytics.md b/docs-2.0/graph-computing/nebula-analytics.md index 716128948b..f5aa6de15e 100644 --- a/docs-2.0/graph-computing/nebula-analytics.md +++ b/docs-2.0/graph-computing/nebula-analytics.md @@ -62,13 +62,28 @@ NebulaGraph Analytics 支持的图计算算法如下。 ## 安装 NebulaGraph Analytics -1. 在多个机器安装由多个 NebulaGraph Analytics 服务构成的集群时，需要安装路径相同，并设置节点间 SSH 免密登录。 +1. 安装 NebulaGraph Analytics。 - ```bash - sudo rpm -i nebula-analytics-{{plato.release}}-centos.x86_64.rpm --prefix /home/xxx/nebula-analytics + ``` + $ sudo rpm -ivh --prefix + $ sudo chown : -R + ``` + + 例如： + + ``` + $ sudo rpm -ivh nebula-analytics-{{plato.release}}-centos.x86_64.rpm --prefix=/home/vesoft/nebula-analytics + $ sudo chown vesoft:vesoft -R /home/vesoft/nebula-analytics + ``` + +2. 配置`set_env.sh`文件，路径为`nebula-analytics/scripts/set_env.sh`。配置正确的 Hadoop 路径和 JDK 路径。如果有多台机器，请确保路径一致。 + + ``` + export HADOOP_HOME= + export JAVA_HOME= ``` -2. 拷贝 License 至所有机器的 NebulaGraph Analytics 安装路径的`scripts`目录内。 +3. 拷贝 License 至所有机器的 NebulaGraph Analytics 安装路径的`scripts`目录内。 - 关于语句的详细信息，参考[用户管理](../../7.data-security/1.authentication/2.management-user.md "点击前往用户管理")。 +--> + ## 浏览器支持 建议使用最新版本的 Chrome 访问 Studio。 From 3a2b3ac7d2147e4b258eae8e09ea19f66641d789 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Tue, 8 Nov 2022 11:13:41 +0800 Subject: [PATCH 038/132] add note for multiple data storage directories (#2298) * add note for multiple data storage directories * comment fix --- .../3.1create-cluster-with-kubectl.md | 9 +++++++-- .../8.custom-cluster-configurations/8.2.pv-reclaim.md | 2 ++ .../8.3.balance-data-when-scaling-storage.md | 2 ++ docs-2.0/nebula-operator/9.upgrade-nebula-cluster.md | 2 ++ 4 files changed, 13 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-operator/3.deploy-nebula-graph-cluster/3.1create-cluster-with-kubectl.md b/docs-2.0/nebula-operator/3.deploy-nebula-graph-cluster/3.1create-cluster-with-kubectl.md index b3d9b2f434..e343f22f22 100644 --- a/docs-2.0/nebula-operator/3.deploy-nebula-graph-cluster/3.1create-cluster-with-kubectl.md +++ b/docs-2.0/nebula-operator/3.deploy-nebula-graph-cluster/3.1create-cluster-with-kubectl.md @@ -83,13 +83,15 @@ requests: storage: 2Gi storageClassName: fast-disks - dataVolumeClaims: + dataVolumeClaims: # 从 Operator 1.3.0 开始，支持挂载多个数据盘。 - resources: requests: storage: 2Gi + storageClassName: fast-disks - resources: requests: storage: 2Gi + storageClassName: fast-disks enableAutoBalance: true reference: name: statefulsets.apps @@ -119,7 +121,8 @@ | `spec.storaged.replicas` | `3` | Storaged 服务的副本数。 | | `spec.storaged.images` | `vesoft/nebula-storaged` | Storaged 服务的容器镜像。 | | `spec.storaged.version` | `{{nebula.tag}}` | Storaged 服务的版本号。 | - | `spec.storaged.dataVolumeClaims.resources.requests.storage` | - | Storaged 服务的数据盘存储大小，可指定多块数据盘存储数据。 | + | `spec.storaged.dataVolumeClaims.resources.requests.storage` | - | Storaged 服务的数据盘存储大小，可指定多块数据盘存储数据。当指定多块数据盘时，路径为：`/usr/local/nebula/data1`、`/usr/local/nebula/data2`等。 | + | `spec.storaged.dataVolumeClaims.resources.storageClassName` | - | Storaged 服务的数据盘存储配置。若不指定，则使用全局的存储配置。 | | `spec.storaged.logVolumeClaim.storageClassName`|-|Storaged 服务的日志盘存储配置。| | `spec.storaged.enableAutoBalance` | `true` | 是否自动均衡数据。 | | `spec.reference.name` | - | 依赖的控制器名称。 | @@ -266,9 +269,11 @@ - resources: requests: storage: 2Gi + storageClassName: fast-disks - resources: requests: storage: 2Gi + storageClassName: fast-disks logVolumeClaim: resources: requests: diff --git a/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.2.pv-reclaim.md b/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.2.pv-reclaim.md index 9156948684..ea03ebe9ec 100644 --- a/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.2.pv-reclaim.md +++ b/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.2.pv-reclaim.md @@ -78,9 +78,11 @@ NebulaGraph Operator 使用持久化卷 PV（Persistent Volume）和持久化卷 - resources: requests: storage: 2Gi + storageClassName: fast-disks - resources: requests: storage: 2Gi + storageClassName: fast-disks image: vesoft/nebula-storaged logVolumeClaim: resources: diff --git a/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md b/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md index 1784f69067..c418c5c54c 100644 --- a/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md +++ b/docs-2.0/nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md @@ -82,9 +82,11 @@ NebulaGraph 的 Storage 服务的扩容分为两个阶段，第一个阶段等 - resources: requests: storage: 2Gi + storageClassName: fast-disks - resources: requests: storage: 2Gi + storageClassName: fast-disks image: vesoft/nebula-storaged logVolumeClaim: resources: diff --git a/docs-2.0/nebula-operator/9.upgrade-nebula-cluster.md b/docs-2.0/nebula-operator/9.upgrade-nebula-cluster.md index 3cf209e796..95adc9ce69 100644 --- a/docs-2.0/nebula-operator/9.upgrade-nebula-cluster.md +++ b/docs-2.0/nebula-operator/9.upgrade-nebula-cluster.md @@ -107,9 +107,11 @@ - resources: requests: storage: 2Gi + storageClassName: fast-disks - resources: requests: storage: 2Gi + storageClassName: fast-disks logVolumeClaim: resources: requests: From c8edbc7c5421018097cc1cd91565335b25edaa5c Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 9 Nov 2022 11:09:51 +0800 Subject: [PATCH 039/132] Update 0.FAQ.md --- docs-2.0/20.appendix/0.FAQ.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-2.0/20.appendix/0.FAQ.md b/docs-2.0/20.appendix/0.FAQ.md index 2fe57534cc..79349032d7 100644 --- 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| 如果修改过配置文件中预设的端口，请找出实际使用的端口并在防火墙中开放它们。 From 56468dc2428bb706f46f26ba6eaa62b213e8c2f3 Mon Sep 17 00:00:00 2001 From: Abby <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 9 Nov 2022 15:16:39 +0800 Subject: [PATCH 040/132] Update mkdocs.yml --- mkdocs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 4c480bd61e..2713f33208 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -198,9 +198,9 @@ extra: tag: v3.2.0 branch: release-3.2 console: - release: 3.3.0 + release: 3.3.1 branch: release-3.3 - tag: v3.3.0 + tag: v3.3.1 br: release: 0.6.1 branch: master From bf3272da0465c76e10cad5103f1d2af4ec5f839c Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 9 Nov 2022 15:18:38 +0800 Subject: [PATCH 041/132] Update mkdocs.yml (#2299) From 239771ded0fe07a63cfc61a28d9164b3914b4f37 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 9 Nov 2022 15:37:51 +0800 Subject: [PATCH 042/132] Update 6.eco-tool-version.md (#2300) --- docs-2.0/20.appendix/6.eco-tool-version.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs-2.0/20.appendix/6.eco-tool-version.md b/docs-2.0/20.appendix/6.eco-tool-version.md index 796f8371e4..68668d7dd1 100644 --- 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 的标准数据集。 From 1b4eca0a47430a3113580808b179e7dc09bcf7cb Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 10 Nov 2022 09:45:20 +0800 Subject: [PATCH 043/132] update dashboard and explorer (#2302) --- .../{cluster-information => operator}/backup-and-restore.md | 4 ++-- .../4.cluster-operator/operator/version-upgrade.md | 2 +- docs-2.0/nebula-explorer/ex-ug-page-overview.md | 1 + mkdocs.yml | 2 +- 4 files changed, 5 insertions(+), 4 deletions(-) rename docs-2.0/nebula-dashboard-ent/4.cluster-operator/{cluster-information => operator}/backup-and-restore.md (98%) diff --git a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/cluster-information/backup-and-restore.md b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md similarity index 98% rename from docs-2.0/nebula-dashboard-ent/4.cluster-operator/cluster-information/backup-and-restore.md rename to docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md index 38198eb391..26e53c5059 100644 --- a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/cluster-information/backup-and-restore.md +++ b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md @@ -27,8 +27,8 @@ 1. 在 NebulaGraph Dashboard 企业版顶部导航栏，单击**集群管理**。 2. 在目标集群右侧**详情**。 -3. 在左侧导航栏，单击**集群信息**->**备份恢复**。 - +3. 在左侧导航栏，单击**集群操作**->**备份恢复**。 + ### 备份数据 用户通过创建备份文件的方式将备份的数据存至云存储服务中，操作如下： diff --git a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md index 7297575242..1881c57335 100644 --- a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md +++ b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md @@ -10,7 +10,7 @@ Dashboard 企业版支持升级现有 NebulaGraph 集群的版本。 !!! note - - 仅支持升级版本不低于 **3.0.0** 的 NebulaGraph 集群。 + - 仅支持升级版本不低于 **3.0.0** 的 NebulaGraph 集群，且最高升级至 **3.2.1** 版本。如需升级至 **3.3.0**，请参见[手动升级文档](../../..//4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md)。 - 不支持跨大版本升级集群。 - 支持社区版升级为企业版（需要上传校验 License）或企业版升级为社区版。 - 支持升级为当前大版本内的任意小版本（包括比当前版本低的小版本）。 diff --git a/docs-2.0/nebula-explorer/ex-ug-page-overview.md b/docs-2.0/nebula-explorer/ex-ug-page-overview.md index 59d36d8818..236779705f 100644 --- a/docs-2.0/nebula-explorer/ex-ug-page-overview.md +++ b/docs-2.0/nebula-explorer/ex-ug-page-overview.md @@ -13,6 +13,7 @@ NebulaGraph Explorer 由顶部导航栏、左侧导航栏、和画布三大模 | **Explorer** | 可视化探索及分析数据。详情参见[开始探索](graph-explorer/ex-ug-query-exploration.md)、[节点筛选](graph-explorer/node-filtering.md)、[探索拓展](graph-explorer/ex-ug-graph-exploration.md)、[图计算](graph-explorer/graph-algorithm.md)。 | | **Visual Query** | 可视化构造场景进行数据查询。详情参见[可视化查询](12.query-visually.md)。 | | **Workflow** | 可视化构造自定义工作流进行复杂图计算。详情参见[工作流简介](workflow/workflows.md)。| +| ![Schema_drafting](https://docs-cdn.nebula-graph.com.cn/figures/schema_drafting_221110.png) | 在画板上自行设计 Schema，可以直观展示点边关系。详情参见[Schema 草图](db-management/draft.md)。| | ![create_schema](https://docs-cdn.nebula-graph.com.cn/figures/studio-nav-schema.png) | 对 NebulaGraph 图空间进行管理。详情参见[创建 Schema](db-management/10.create-schema.md)。 | | ![import_data](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-download.png) | 将数据批量导入 NebulaGraph。详情参见[导入数据](db-management/11.import-data.md)。 | | ![Console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png) | 对 NebulaGraph 内的数据使用 nGQL 进行查询操作。详情参见[控制台](db-management/explorer-console.md)。 | diff --git a/mkdocs.yml b/mkdocs.yml index 2713f33208..097ed5e231 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -593,7 +593,6 @@ nav: - 信息总览: nebula-dashboard-ent/4.cluster-operator/cluster-information/overview-info.md - 集群诊断: nebula-dashboard-ent/4.cluster-operator/cluster-information/cluster-diagnosis.md # - 集群作业管理: nebula-dashboard-ent/4.cluster-operator/cluster-information/job-management.md - - 备份恢复: nebula-dashboard-ent/4.cluster-operator/cluster-information/backup-and-restore.md - 集群操作: - 节点管理: nebula-dashboard-ent/4.cluster-operator/operator/node.md - 扩缩容: nebula-dashboard-ent/4.cluster-operator/operator/scale.md @@ -601,6 +600,7 @@ nav: - 更新配置: nebula-dashboard-ent/4.cluster-operator/operator/update-config.md - 成员管理: nebula-dashboard-ent/4.cluster-operator/operator/member-management.md - 版本升级: nebula-dashboard-ent/4.cluster-operator/operator/version-upgrade.md + - 备份恢复: nebula-dashboard-ent/4.cluster-operator/operator/backup-and-restore.md - 操作记录: nebula-dashboard-ent/4.cluster-operator/5.operation-record.md - 其他设置: nebula-dashboard-ent/4.cluster-operator/6.settings.md - 权限管理: nebula-dashboard-ent/5.account-management.md From 90025ee60b4a701029a2fc097b0b1813563a392e Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 10 Nov 2022 10:18:22 +0800 Subject: [PATCH 044/132] Update ex-ug-connect.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md index fb78f065e5..c77f2cff18 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md @@ -14,6 +14,10 @@ ## OAuth2.0 认证设置 +!!! caution + + 当前 OAuth2.0 认证设置为 Beta 功能，后续可能会有一定优化调整。 + !!! note 如果想直接连接数据库，请参见后文**连接数据库**部分。 From 156913928e8d3e3c9c520c4b3837787276df887f Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 10 Nov 2022 11:01:56 +0800 Subject: [PATCH 045/132] Update ex-ug-what-is-exchange.md (#2303) --- .../about-exchange/ex-ug-what-is-exchange.md | 33 +++++++++++++------ 1 file changed, 23 insertions(+), 10 deletions(-) diff --git a/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md b/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md index b97871d3a6..5859239ea4 100644 --- a/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md +++ b/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md @@ -51,16 +51,29 @@ Exchange 具有以下优点： ## 版本兼容性 -NebulaGraph Exchange 版本（即 JAR 包版本）和 NebulaGraph 内核的版本对应关系如下。 - -|NebulaGraph 版本|Exchange client 版本| -|:---|:---| -|nightly |3.0-SNAPSHOT| -|3.0.0 ~ 3.3.0 |3.3.0 | -|3.0.0 ~ 3.2.x |3.0.0 | -|2.6.x |2.6.x | -|2.5.x |2.5.x | -|2.0.0、2.0.1|2.1.0、2.0.1、2.0.0| +NebulaGraph Exchange 版本（即 JAR 包版本）、NebulaGraph 内核版本和 Spark 版本对应关系如下。 + +| Exchange 版本 | NebulaGraph 版本 | Spark 版本 | +|:----------|:-----------|:-------| +|nebula-exchange_spark_3.0-3.0-SNAPSHOT.jar| nightly |3.3.x、3.2.x、3.1.x、3.0.x | +|nebula-exchange_spark_2.4-3.0-SNAPSHOT.jar| nightly |2.4.x | +|nebula-exchange_spark_2.2-3.0-SNAPSHOT.jar| nightly |2.2.x | +|nebula-exchange_spark_3.0-3.3.0.jar | 3.x.x |3.3.x、3.2.x、3.1.x、3.0.x| +|nebula-exchange_spark_2.4-3.3.0.jar | 3.x.x |2.4.x | +|nebula-exchange_spark_2.2-3.3.0.jar | 3.x.x |2.2.x | +|nebula-exchange_spark_3.0-3.0.0.jar | 3.x.x |3.3.x、3.2.x、3.1.x、3.0.x| +|nebula-exchange_spark_2.4-3.0.0.jar | 3.x.x |2.4.x | +|nebula-exchange_spark_2.2-3.0.0.jar | 3.x.x |2.2.x | +|nebula-exchange-2.6.3.jar | 2.6.1、2.6.0 |2.4.x | +|nebula-exchange-2.6.2.jar | 2.6.1、2.6.0 |2.4.x | +|nebula-exchange-2.6.1.jar | 2.6.1、2.6.0 |2.4.x | +|nebula-exchange-2.6.0.jar | 2.6.1、2.6.0 |2.4.x | +|nebula-exchange-2.5.2.jar | 2.5.1、2.5.0 |2.4.x | +|nebula-exchange-2.5.1.jar | 2.5.1、2.5.0 |2.4.x | +|nebula-exchange-2.5.0.jar | 2.5.1、2.5.0 |2.4.x | +|nebula-exchange-2.1.0.jar | 2.0.1、2.0.0 |2.4.x | +|nebula-exchange-2.0.1.jar | 2.0.1、2.0.0 |2.4.x | +|nebula-exchange-2.0.0.jar | 2.0.1、2.0.0 |2.4.x | JAR 包有两种获取方式：[自行编译](../ex-ug-compile.md)或者从 maven 仓库下载。 From 57e74d33d5e6b17f22aaf7b04f98b613838e1984 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Thu, 10 Nov 2022 11:40:08 +0800 Subject: [PATCH 046/132] Update 3.vid.md (#2304) --- docs-2.0/1.introduction/3.vid.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-2.0/1.introduction/3.vid.md b/docs-2.0/1.introduction/3.vid.md index ab4a0e02a3..38691028f2 100644 --- 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()`。在`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`设置成超大，这会浪费大量内存和硬盘，也会降低性能。此时可通过 BASE64，MD5，hash 编码加拼接的方式来生成。 From d580a6755b10f13f9531f6edee5d6738cee6ab30 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 10 Nov 2022 15:42:38 +0800 Subject: [PATCH 047/132] Update 1.prepare-resources.md (#2305) * Update 1.prepare-resources.md * Update 1.prepare-resources.md --- docs-2.0/nebula-explorer/workflow/1.prepare-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md index 90797a8241..8761ac796f 100644 --- a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md +++ b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md @@ -18,7 +18,7 @@ |类型|说明| |:--|:--| |NebulaGraph 配置| 执行图查询或写入图计算结果的 Graph 服务地址。默认为登录 Explorer 使用的 Graph 服务，无法修改。可以设置三种服务的超时时间。| - |HDFS 配置| 存储结果的 HDFS 地址。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径、HDFS 用户名（可选）。| + |HDFS 配置| 存储结果的 HDFS 地址（`fs.defaultFS`配置）。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径、HDFS 用户名（可选）。需要先在 Analytics 所在机器上安装 HDFS 客户端，该配置才能生效。| |NebulaGraph Analytics 配置| 执行图计算的 NebulaGraph Analytics 地址。单击**添加**新增地址。| 4. 配置完成后，单击**确认**。 From a52ea2626ad8e8e47312674b9af9fd45e8cea819 Mon Sep 17 00:00:00 2001 From: Abby <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 10 Nov 2022 16:34:51 +0800 Subject: [PATCH 048/132] highlight on bulk edge where filtering expression --- .../7.general-query-statements/2.match.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index 1a6f849be4..c28761ee5f 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -448,6 +448,28 @@ nebula> MATCH (v:player{name:"Tim Duncan"}) -[*0]-> (v2) \ +----------------------------------------------------+ ``` +!!! Note + + 如果想要通过描述多跳的边的过滤条件，比如`-[e:follow*2]->`，这时候 `e` 不再是单条边时候的数据类型了，而是一列边组成的列表，例如： + 以下语句可以运行但是没有返回数据，因为`e`是一个列表，没有`.degree`的属性。 + ```ngql + nebula> MATCH p=(v:player{name:"Tim Duncan"})-[e:follow*2]->(v2) \ + WHERE e.degree > 1 \ + RETURN DISTINCT v2 AS Friends; + ``` + 这是正确的表达： + ```ngql + nebula> MATCH p=(v:player{name:"Tim Duncan"})-[e:follow*2]->(v2) \ + WHERE ALL(e_ in e WHERE e_.degree > 0) \ + RETURN DISTINCT v2 AS Friends; + ``` + 进一步，这是表达对多跳边的第一跳的边属性过滤的表达： + ```ngql + nebula> MATCH p=(v:player{name:"Tim Duncan"})-[e:follow*2]->(v2) \ + WHERE e[0].degree > 98 \ + RETURN DISTINCT v2 AS Friends; + ``` + ### 匹配变长路径 用户可以在模式中使用`:*[minHop..maxHop]`匹配变长路径。 From d940ffe78d67b44f568b29d1d283b7b2620f1027 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 10 Nov 2022 16:37:10 +0800 Subject: [PATCH 049/132] highlight on bulk edge where filtering expression (#2306) From 8d3fc93b9531244be224e2af41817c7b56adc7c1 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 11 Nov 2022 14:48:24 +0800 Subject: [PATCH 050/132] explorer removes dependence on studio (#2311) --- .../db-management/10.create-schema.md | 78 ++++++++++++++++++- .../db-management/11.import-data.md | 50 +++++++++++- .../nebula-explorer/db-management/draft.md | 2 +- .../db-management/explorer-console.md | 29 ++++++- 4 files changed, 149 insertions(+), 10 deletions(-) diff --git a/docs-2.0/nebula-explorer/db-management/10.create-schema.md b/docs-2.0/nebula-explorer/db-management/10.create-schema.md index 04efa5fc13..924bc1d53e 100644 --- a/docs-2.0/nebula-explorer/db-management/10.create-schema.md +++ b/docs-2.0/nebula-explorer/db-management/10.create-schema.md @@ -1,7 +1,79 @@ # Schema 管理 -Explorer 支持界面化或者通过控制台命令方式管理 Schema。 +Explorer 支持界面化方式管理 Schema。 -在 Explorer 页面的右上方，单击![Schema_page](https://docs-cdn.nebula-graph.com.cn/figures/studio-nav-schema.png)进入 Schema 创建页面。 +!!! Note -Explorer 的 Schema 功能同 Studio。详情参见[创建 Schema](../../nebula-studio/quick-start/st-ug-create-schema.md)。 + - 用户可以使用 Schema 草图功能图形化设计 Schema。详情参见 [Schema 草图](draft.md)。 + - 用户可以在控制直接执行 nGQL 命令管理 Schema。 + +## 前提条件 + +- 账号拥有 GOD、ADMIN 或 DBA 权限。详情参见 [NebulaGraph 内置角色](../../7.data-security/1.authentication/3.role-list.md)。 + +- 已经规划 Schema 的要素。 + +!!! Note + + 本示例已经创建图空间。如果账号拥有 GOD 权限，也可以在 **控制台** 或 **Schema** 上创建一个图空间。 + +## 入口 + +在顶部导航栏里，单击![Schema_page](https://docs-cdn.nebula-graph.com.cn/figures/studio-nav-schema.png) 图标。 + +## 创建图空间 + +1. 单击**创建图空间**。 + +2. 设置参数。参数介绍参见 [CREATE SPACE](../../3.ngql-guide/9.space-statements/1.create-space.md)。 + +3. 单击**创建**。 + +## 创建标签/边类型 + +1. 在**图空间列表**中，找到图空间，单击图空间名称或者在**操作**列中单击**Schema**。 + +2. 单击**标签**或**边类型**页签，单击**创建**。 + +3. 设置参数。参数介绍参见[CREATE TAG](../../3.ngql-guide/10.tag-statements/1.create-tag.md)和[CREATE EDGE](../../3.ngql-guide/11.edge-type-statements/1.create-edge.md)。 + + !!! Note + + 未设置索引时，用户才可以设置 TTL。详情参见 [TTL 配置](../../3.ngql-guide/8.clauses-and-options/ttl-options.md)。 + +4. 单击**创建**。 + +在**标签**和**边类型**列表里，可以执行修改和删除操作。 + +## 创建索引 + +!!! Note + + - 创建索引前需要确保相关的 Tag 或 Edge type 已创建。 + - 由于索引会影响写性能，建议首次导入大批量数据时，先导入数据，再创建索引并重建索引。详情参见[索引介绍](../../3.ngql-guide/14.native-index-statements/README.md)。 + +1. 在**图空间列表**中，找到图空间，单击图空间名称或者在**操作**列中单击**Schema**。 + +2. 单击**索引**页签，单击**创建**。 + +3. 设置参数。参数介绍参见[CREATE INDEX](../../3.ngql-guide/14.native-index-statements/1.create-native-index.md)。 + + !!! Note + + 索引属性的顺序会影响 `LOOKUP` 语句的查询结果。详情参见 [LOOKUP](../../3.ngql-guide/7.general-query-statements/5.lookup.md)。 + +4. 单击**创建**。 + +在**索引**列表里，可以重建索引或删除索引。 + +## 查看统计信息 + +1. 在**图空间列表**中，找到图空间，单击图空间名称或者在**操作**列中单击**Schema**。 + +2. 单击**统计**页签，单击**更新**。 + +## 查看 Schema + +1. 在**图空间列表**中，找到图空间，单击图空间名称或者在**操作**列中单击**Schema**。 + +2. 单击**查看 Schema**页签，单击**获取 Schema**。 \ No newline at end of file diff --git a/docs-2.0/nebula-explorer/db-management/11.import-data.md b/docs-2.0/nebula-explorer/db-management/11.import-data.md index d5163b4c85..a61cd04f3d 100644 --- a/docs-2.0/nebula-explorer/db-management/11.import-data.md +++ b/docs-2.0/nebula-explorer/db-management/11.import-data.md @@ -1,7 +1,51 @@ # 数据导入 -Explorer 支持界面化地将数据导入至 NebulaGraph 中。 +Explorer 支持界面化地将 CSV 格式数据导入至 NebulaGraph 中。 -在 Explorer 页面右上方，单击![download](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-download.png)进入导入数据页面。 +## 前提条件 -Explorer 的导入数据功能同 Studio。详情参见[导入数据](../../nebula-studio/quick-start/st-ug-import-data.md)。 +- NebulaGraph 数据库里已经创建 Schema。 + +- CSV 文件符合 Schema 要求。 + +- 账号拥有 GOD、ADMIN 或 DBA 权限。详情参见 [NebulaGraph 内置角色](../../7.data-security/1.authentication/3.role-list.md)。 + +## 入口 + +在顶部导航栏里，单击 ![download](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-download.png) 图标。 + +## 操作步骤 + +### 上传文件 + +1. 选择的**上传文件**页签，单击**上传文件**按钮，选择需要的 CSV 文件。 + + !!! Note + + 一次可以选择多个 CSV 文件。 + +2. 上传结束后，可以在文件列表的 **操作** 列，单击 ![detail](https://docs-cdn.nebula-graph.com.cn/figures/detail.png) 图标预览文件内容。 + +### 导入数据 + +1. 选择**导入数据**页签，单击**创建导入任务**按钮，完成如下设置： + + !!! caution + + 用户也可以单击**导入模版**，下载示例配置文件`example.yaml`，配置后再上传配置文件。配置方式与 [NebulaGraph Importer](../../nebula-importer/use-importer.md) 大致相同，但是所有文件路径仅保留文件名。并且请确保在导入配置文件之前已上传所有 CSV 数据文件。 + + - **图空间**：需要导入数据的图空间名称。 + - **任务名称**：默认自动生成，可以修改。 + - **批处理量**（可选）：每批导入多少行数据。 + - **关联点**：单击**绑定数据源** 按钮，在对话框中选择绑定文件并单击**确认**按钮。 + + - 在 **vertices 1** 页签内的 `vertexID` 项中，单击 **Select CSV Index**，在弹出的对话框内为 VID 选择数据源。 + - 单击**添加Tag**按钮，然后在新创建的**Tag**页签内单击**选择 Tag**，选择需要关联的 Tag。在显示的属性列表中，为属性选择数据源。 + + - **关联边**：与关联点的操作相同。 + + ![导入任务](https://docs-cdn.nebula-graph.com.cn/figures/import_task_221111_cn.png) + +2. 完成设置后，单击**导入**,输入 NebulaGraph 账号的密码并确认。 + +后可以在**导入数据**页签内查看日志、下载日志、下载配置文件、删除任务等操作。 diff --git a/docs-2.0/nebula-explorer/db-management/draft.md b/docs-2.0/nebula-explorer/db-management/draft.md index 218b55b79e..d6b1b25b30 100644 --- a/docs-2.0/nebula-explorer/db-management/draft.md +++ b/docs-2.0/nebula-explorer/db-management/draft.md @@ -10,7 +10,7 @@ Explorer 支持 Schema 草图功能。用户可以在画板上自行设计 Schem ## 入口 -在顶部导航栏里，点击 ![Template](https://docs-cdn.nebula-graph.com.cn/figures/sketch_cion_221018.png) 图标。 +在顶部导航栏里，单击 ![Template](https://docs-cdn.nebula-graph.com.cn/figures/sketch_cion_221018.png) 图标。 ## 设计 Schema diff --git a/docs-2.0/nebula-explorer/db-management/explorer-console.md b/docs-2.0/nebula-explorer/db-management/explorer-console.md index 58cfdf15dc..e66984d063 100644 --- a/docs-2.0/nebula-explorer/db-management/explorer-console.md +++ b/docs-2.0/nebula-explorer/db-management/explorer-console.md @@ -1,8 +1,31 @@ # 控制台 -Explorer 的控制台功能允许用户手动输入 nGQL 语句，并可视化地呈现查询结果。 +Explorer 的控制台功能允许用户手动输入 nGQL 语句，并可视化地呈现查询结果。本文介绍控制台的界面。 -在 Explorer 页面的右上方，单击![console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png)进入控制台页面。 +## 入口 -Explorer 控制台功能同 Studio。详情，参见[控制台](../../nebula-studio/quick-start/st-ug-console.md)。 +在顶部导航栏里，单击 ![console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png) 图标。 +## 页面介绍 + +![控制台界面截图](https://docs-cdn.nebula-graph.com.cn/figures/console_ovewview_221111_cn.png) + +下表列出了控制台界面上的各种功能。 + +| 编号 | 功能 | 说明 | +| :-- | :--| :-- | +| 1 | 选择图空间 | 选择执行 nGQL 的图空间。不支持在控制台执行`USE `语句切换图空间。 | +| 2 | 收藏夹 | 点击![save](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-save.png) 按钮，展开收藏夹，点击其中一个语句，输入框中即自动输入该语句。 | +| 3 | 历史清单 | 点击 ![history](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-history.png) 按钮，在语句运行记录列表里，点击其中一个语句，输入框中即自动输入该语句。列表里提供最近 15 次语句运行记录。 | +| 4 | 清空输入框 | 点击 ![clear](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-clear.png) 按钮，清空输入框中已经输入的内容。 | +| 5 | 运行 | 在输入框中输入 nGQL 语句后，点击 ![play](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-play.png) 按钮即开始运行语句。 | +| 6 | 保存为模板 | 将输入框中输入的 nGQL 语句保存为模板。详情参见[查询语句模板](ngql-template.md)。 | +| 7 | 输入框 | 输入 nGQL 语句的区域。可以同时输入多个语句按顺序执行，语句之间以 `;` 分隔。支持用`//`添加注释。 | +| 8 | 自定义参数展示 | 点击 ![查询](https://docs-cdn.nebula-graph.com.cn/figures/down.png)按钮可展开查看自定义参数，用于参数化查询。详情信息可见[管理参数](../../nebula-console.md)。| +| 9 | 语句运行状态 | 运行 nGQL 语句后，这里显示语句运行状态。如果语句运行成功，语句以绿色显示。如果语句运行失败，语句以红色显示。 | +| 10 | 添加到收藏夹 | 点击![save](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-save.png) 按钮，将语句存入收藏夹中，已收藏的语句该按钮以黄色展示。| +| 11 | 导出 CSV 文件或 PNG 格式图片 | 运行 nGQL 语句返回结果后，返回结果为表格形式时，点击 ![download](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-download.png) 按钮即能将结果以 CSV 文件的形式导出。
切换到可视化窗口，点击 ![download](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-download.png) 按钮即能将结果以 CSV 文件或 PNG 图片的形式导出。 | +| 12 | 展开/隐藏执行结果 | 点击 ![up](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-up.png) 按钮，隐藏此条 nGQL 语句返回的结果。 | +| 13 | 关闭执行结果 | 点击 ![close](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-close.png)按钮，关闭此条 nGQL 语句返回的结果。 | +| 14 | 表格窗口 | 显示语句运行结果。如果语句会返回结果，窗口会以表格形式呈现返回的结果。 | +| 15 | 可视化窗口 | 显示语句运行结果。如果语句会返回完整的点边结果，窗口会以可视化形式呈现返回的结果。点击右方 ![expand](https://docs-cdn.nebula-graph.com.cn/figures/studio-btn-back.png)按钮，展开数据概览面板。 | \ No newline at end of file From 1ca94bf4e290311357ae5deacb4655d6bb084c15 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Fri, 11 Nov 2022 15:05:30 +0800 Subject: [PATCH 051/132] add-usage-for-length()-and-size() (#2312) --- .../6.functions-and-expressions/1.math.md | 14 +++++++++++--- .../6.functions-and-expressions/2.string.md | 19 ++++++++++++++++--- 2 files changed, 27 insertions(+), 6 deletions(-) diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/1.math.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/1.math.md index e04cd88677..9cbbaaf1d4 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/1.math.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/1.math.md @@ -554,12 +554,12 @@ nebula> RETURN bit_xor(5,6); ## size() -size() 返回列表或映射中元素的数量。 +size() 返回列表或映射中元素的数量，或者返回字符串的长度。 -语法：`size()` +语法：`size({|})` - `expression`：列表或映射的表达式。 - +- `string`：指定的字符串。 - 返回类型：int。 示例： @@ -573,6 +573,14 @@ nebula> RETURN size([1,2,3,4]); +-----------------+ ``` +```ngql +nebula> RETURN size("basketballplayer") as size; ++------+ +| size | ++------+ +| 16 | ++------+ +``` ## range() range() 返回指定范围（`[start,end]`）中指定步长的值组成的列表。 diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/2.string.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/2.string.md index 8d3e5bd6c8..9f9ebaef85 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/2.string.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/2.string.md @@ -75,12 +75,14 @@ nebula> RETURN upper("Basketball_Player"); ## length() -length() 返回指定字符串的长度，单位：字节。 +length() 返回： + - 指定字符串的长度，单位：字节。 + - 路径的长度，单位：跳。 -语法：`length()` +语法：`length({|})` - `string`：指定的字符串。 - +- `path`：指定的路径，使用变量表示。 - 返回类型：int。 示例： @@ -94,6 +96,17 @@ nebula> RETURN length("basketball"); +----------------------+ ``` +```ngql +nebula> MATCH p=(v:player{name:"Tim Duncan"})-->(v2) return length(p); ++-----------+ +| length(p) | ++-----------+ +| 1 | +| 1 | +| 1 | ++-----------+ +``` + ## trim() trim() 删除指定字符串头部和尾部的空格。 From bcec7e570450bcedf013c2c305bbba8f28d9397e Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Fri, 11 Nov 2022 15:15:48 +0800 Subject: [PATCH 052/132] Update 6.cheatsheet-for-ngql-command.md (#2313) --- docs-2.0/2.quick-start/6.cheatsheet-for-ngql-command.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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 index 34c9acf902..edc7790113 100644 --- 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) | 删除字符串尾部的空格。 | From 2cc3381779ea64977076751fbbf09ce77de84c90 Mon Sep 17 00:00:00 2001 From: Wey Gu Date: Sat, 12 Nov 2022 12:04:17 +0800 Subject: [PATCH 053/132] subgraph: add filter condition example (#2310) * subgraph: add filter condition example * chore: spacing fix * format: line break added --- .../16.subgraph-and-path/1.get-subgraph.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md b/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md index 53a95dd409..a1fc458f5b 100644 --- a/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md +++ b/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md @@ -107,6 +107,20 @@ nebula> INSERT EDGE serve(start_year, end_year) VALUES "player101" -> "team204": ![GET SUBGRAPH FROM "101" OUT serve](https://docs-cdn.nebula-graph.com.cn/figures/subgraph-2-22-5-7.png) +- 查询从点`player101`开始、0~2 跳、`follow`类型边`degree`大于 90，年龄大于 30 的子图，同时展示边的属性。 + + ```ngql + 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}]] | + +-------------------------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ + ``` + ## FAQ ### 为什么返回结果中会出现超出`step_count`跳数之外的关系？ From 678e564ec56ff47f616513ed4adf7e849d7eed4e Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 09:51:38 +0800 Subject: [PATCH 054/132] Update 10.create-schema.md --- docs-2.0/nebula-explorer/db-management/10.create-schema.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-explorer/db-management/10.create-schema.md b/docs-2.0/nebula-explorer/db-management/10.create-schema.md index 924bc1d53e..99f96b8357 100644 --- a/docs-2.0/nebula-explorer/db-management/10.create-schema.md +++ b/docs-2.0/nebula-explorer/db-management/10.create-schema.md @@ -5,7 +5,7 @@ Explorer 支持界面化方式管理 Schema。 !!! Note - 用户可以使用 Schema 草图功能图形化设计 Schema。详情参见 [Schema 草图](draft.md)。 - - 用户可以在控制直接执行 nGQL 命令管理 Schema。 + - 用户可以在控制台直接执行 nGQL 命令管理 Schema。 ## 前提条件 @@ -76,4 +76,4 @@ Explorer 支持界面化方式管理 Schema。 1. 在**图空间列表**中，找到图空间，单击图空间名称或者在**操作**列中单击**Schema**。 -2. 单击**查看 Schema**页签，单击**获取 Schema**。 \ No newline at end of file +2. 单击**查看 Schema**页签，单击**获取 Schema**。 From e3243c2bbc3b52f01dc5446feb92f4f09d4baaa7 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 10:49:39 +0800 Subject: [PATCH 055/132] Update 11.import-data.md --- docs-2.0/nebula-explorer/db-management/11.import-data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/db-management/11.import-data.md b/docs-2.0/nebula-explorer/db-management/11.import-data.md index a61cd04f3d..a6b51a6dd6 100644 --- a/docs-2.0/nebula-explorer/db-management/11.import-data.md +++ b/docs-2.0/nebula-explorer/db-management/11.import-data.md @@ -48,4 +48,4 @@ Explorer 支持界面化地将 CSV 格式数据导入至 NebulaGraph 中。 2. 完成设置后，单击**导入**,输入 NebulaGraph 账号的密码并确认。 -后可以在**导入数据**页签内查看日志、下载日志、下载配置文件、删除任务等操作。 +可以在**导入数据**页签内查看日志、下载日志、下载配置文件、删除任务等操作。 From d05dc4f4fc8669a444da2e850ebb7f88f4369294 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 11:49:18 +0800 Subject: [PATCH 056/132] update workflow (#2314) --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index c8a3ef64c9..688bc3bf06 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -243,12 +243,11 @@ Dag Controller 可以结合 NebulaGraph Analytics 进行复杂的图计算。例 按同样方法设置 A 免密登录机器 B-2、B-3 等，以及集群 B 内所有机器的互相免密登录。 -2. 添加以下内容至`~/.bash_profile`文件内，执行`source ~/.bash_profile`使其生效。 +2. 在 Dag Controller 机器上执行`eval $(ssh-agent)`启动 ssh agent，然后执行`ssh-add ~/.ssh/id_rsa`将私钥交给 ssh-agent 管理。 - ``` - eval $(ssh-agent) - ssh-add ~/.ssh/id_rsa - ``` + !!! note + + ssh-agent是密钥管理器，用来管理多个密钥，并为其他需要使用 SSH 密钥对的程序提供代理。 3. 配置`dag-ctrl-api.yaml`文件，路径为`dag-ctrl/etc/dag-ctrl-api.yaml`。配置 NebulaGraph Analytics 机器的用户名及端口，如果有多台机器，请确保使用相同用户名和端口。 From e288b617912a6a319d84f767a26d2e8127d61063 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 11:54:16 +0800 Subject: [PATCH 057/132] Update ex-ug-deploy.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index 688bc3bf06..7ff3c4f4ca 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -243,7 +243,7 @@ Dag Controller 可以结合 NebulaGraph Analytics 进行复杂的图计算。例 按同样方法设置 A 免密登录机器 B-2、B-3 等，以及集群 B 内所有机器的互相免密登录。 -2. 在 Dag Controller 机器上执行`eval $(ssh-agent)`启动 ssh agent，然后执行`ssh-add ~/.ssh/id_rsa`将私钥交给 ssh-agent 管理。 +2. 在 Dag Controller 机器上执行`eval $(ssh-agent)`启动 ssh-agent，然后执行`ssh-add ~/.ssh/id_rsa`将私钥交给 ssh-agent 管理。 !!! note From 383e9b7ebfbe8cbd5de7735c6aa2fe5168202248 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 16:41:21 +0800 Subject: [PATCH 058/132] Update ex-ug-deploy.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index 7ff3c4f4ca..fe1fe27e5e 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -146,10 +146,10 @@ sudo rpm -e nebula-explorer-.x86_64 cd nebula-explorer # 启动 Explorer。 - sudo ./lib/start.sh + sudo ./scripts/start.sh # （可选）启动 Dag Controller。 - sudo ./dag-ctrl/lib/start.sh + sudo ./dag-ctrl/scripts/start.sh ``` ### 查看服务状态 From 6a3d19053982b21a1e7a6f7e133a90adbeabf015 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 14 Nov 2022 16:45:54 +0800 Subject: [PATCH 059/132] Update ex-ug-deploy.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index fe1fe27e5e..16c6e1062d 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -146,7 +146,7 @@ sudo rpm -e nebula-explorer-.x86_64 cd nebula-explorer # 启动 Explorer。 - sudo ./scripts/start.sh + sudo ./lib/start.sh # （可选）启动 Dag Controller。 sudo ./dag-ctrl/scripts/start.sh From 082b42a64f34415e46543d07776ba23770bd8c3c Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 15 Nov 2022 09:08:10 +0800 Subject: [PATCH 060/132] dashboard update create cluster (#2316) --- .../1.create-cluster.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs-2.0/nebula-dashboard-ent/3.create-import-dashboard/1.create-cluster.md b/docs-2.0/nebula-dashboard-ent/3.create-import-dashboard/1.create-cluster.md index 92249c9e70..5fd33259c9 100644 --- a/docs-2.0/nebula-dashboard-ent/3.create-import-dashboard/1.create-cluster.md +++ b/docs-2.0/nebula-dashboard-ent/3.create-import-dashboard/1.create-cluster.md @@ -9,32 +9,32 @@ 1. 在 Dashboard 页面顶部，单击**集群管理**。 2. 在集群管理页面，单击**创建集群**标签。 3. 在创建集群页面，完成以下配置： - - 输入**集群名称**，最大可输入 15 个字符，本示例设置为`test`。 - - 选择 NebulaGraph 安装版本。本示例设置为`企业版 v3.1.0`。 + - 输入**集群名称**，最大可输入 15 个字符。 + - 选择 NebulaGraph 安装版本。 !!! note Dashboard 默认内置企业版的 NebulaGraph 安装包。如果用户需要安装其他版本的 NebulaGraph，可以在**安装包管理**页面下载或上传，详情参见[安装包管理](../system-settings/manage-package.md)。 - - 单击**上传证书**。 + - 单击**上传证书**。 !!! note 如果创建社区版的 NebulaGraph，则不需要上传 License 证书，忽略此步骤。 - - 添加节点信息，提供两种方式： + - 添加节点信息，提供两种方式： - - **添加节点**，添加单个节点的相关信息，可多次添加。 + - **添加节点**，输入待添加节点的 Host 信息、SSH 端口号、SSH 用户、认证方式、安装包等。 - ![cluster](https://docs-cdn.nebula-graph.com.cn/figures/create-cluster-2022-04-08_cn.png) + 关于认证方式的说明如下： - 1. 配置每个 Host 的 IP 信息，本示例设置为`192.168.8.129`。 - 2. 配置 SSH 信息，本示例设置如下：SSH 端口号为`22`，SSH 用户名为 `vesoft`，SSH 密码为`nebula`。 - 3. 选择 NebulaGraph 安装包，本示例为`nebula-graph-ent-3.1.0-ent.el7.x86_64.rpm`。 - 4. 自定义集群的安装路径。本示例为默认安装路径`.nebula/cluster`。 - 5. （可选）输入节点名，可以对节点进行备注。本示例设置为`Node_1`。 + - SSH 密码：输入 SSH 用户对应的密码。 - - **批量导入节点**，批量添加多个节点的相关信息。批量导入需要先选择安装包后单击**下载 CSV 模版**。按照模版填写后上传，尽量确保节点信息正确，否则容易造成上传失败。 + - SSH 密钥：单击**上传**，选择节点的私钥文件。需要提前在待添加节点上生成密钥文件，并将私钥发送给当前电脑（非 Dashboard 机器）。如果设置了短密码（passphrase），也需要填写。 + + ![cluster](https://docs-cdn.nebula-graph.com.cn/figures/create-cluster-221115_cn.png) + + - **批量导入节点**，批量添加多个节点的相关信息。批量导入需要先选择安装包后单击**下载 CSV 模版**。按照模版填写后上传，尽量确保节点信息正确，否则容易造成上传失败。 4. 勾选节点并在节点右上方，单击需要添加的服务。创建集群需要给节点添加 3 种类型的服务。如果不熟悉 NebulaGraph 架构，建议单击**自动添加服务**按钮。 From 07f7a1910342dd3c497be9fd8f1301a8f1d09448 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Tue, 15 Nov 2022 16:03:58 +0800 Subject: [PATCH 061/132] Update 2.balance-syntax.md (#2318) --- docs-2.0/synchronization-and-migration/2.balance-syntax.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/synchronization-and-migration/2.balance-syntax.md b/docs-2.0/synchronization-and-migration/2.balance-syntax.md index 1bb9f5c3a5..f3e7b7b19c 100644 --- a/docs-2.0/synchronization-and-migration/2.balance-syntax.md +++ b/docs-2.0/synchronization-and-migration/2.balance-syntax.md @@ -6,10 +6,10 @@ |语法|说明| |:---|:---| -|`BALANCE DATA`|启动任务均衡分布当前图空间中的所有分片。该命令会返回任务 ID（`job_id`）。| -|`BALANCE DATA REMOVE [,: ...]`|启动任务迁空当前图空间指定的 Storage 服务中的分片。| |`BALANCE LEADER`|启动任务均衡分布当前图空间中的所有 leader。该命令会返回任务 ID（`job_id`）。| From 4eaef37efeba1339f5591f0a5411bb03a21423a4 Mon Sep 17 00:00:00 2001 From: Wey Gu Date: Wed, 16 Nov 2022 14:04:19 +0800 Subject: [PATCH 063/132] fixed full-text index prefix (#2320) --- .../1.search-with-text-based-index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/15.full-text-index-statements/1.search-with-text-based-index.md b/docs-2.0/3.ngql-guide/15.full-text-index-statements/1.search-with-text-based-index.md index 0fd1d5af84..e3e9bf4651 100644 --- a/docs-2.0/3.ngql-guide/15.full-text-index-statements/1.search-with-text-based-index.md +++ b/docs-2.0/3.ngql-guide/15.full-text-index-statements/1.search-with-text-based-index.md @@ -100,7 +100,7 @@ nebula> CREATE TAG INDEX IF NOT EXISTS name ON player(name(20)); //重建原生索引。 nebula> REBUILD TAG INDEX; -//创建全文索引，索引名称需要以 NebulaGraph 开头。 +//创建全文索引，索引名称需要以 `nebula` 开头。 nebula> CREATE FULLTEXT TAG INDEX nebula_index_1 ON player(name); //重建全文索引。 From 3321edd8706a996b8f258fe37729e06f8a386653 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 16 Nov 2022 15:39:07 +0800 Subject: [PATCH 064/132] Add-collect()-examples (#2321) --- .../15.aggregating.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md index 81b988684c..02ce125728 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md @@ -260,6 +260,31 @@ nebula> MATCH (n:player) \ | 25 | ["Joel Embiid", "Kyle Anderson"] | +-----+--------------------------------------------------------------------------+ ... + +nebula> GO FROM "player100" OVER serve \ + YIELD properties($$).name AS name \ + | GROUP BY $-.name \ + YIELD collect($-.name) AS name; ++-----------+ +| name | ++-----------+ +| ["Spurs"] | ++-----------+ + +nebula> LOOKUP ON player \ + YIELD player.age As playerage \ + | GROUP BY $-.playerage \ + YIELD collect($-.playerage) AS playerage; ++------------------+ +| playerage | ++------------------+ +| [22] | +| [47] | +| [43] | +| [25, 25] | ++------------------+ +... + ``` ## 聚合示例 From 95848c5e1358e36eaca005659a6bd7893fd7d62f Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 16 Nov 2022 15:55:54 +0800 Subject: [PATCH 065/132] move std() sum() to aggregating functions (#2322) --- .../15.aggregating.md | 38 +++++++++++++++++++ .../16.type-conversion.md | 38 ------------------- 2 files changed, 38 insertions(+), 38 deletions(-) diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md index 02ce125728..ff86d1cb4d 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/15.aggregating.md @@ -287,6 +287,44 @@ nebula> LOOKUP ON player \ ``` +## std() + +std() 返回参数的总体标准差。 + +语法：`std()` + +- 返回类型：double。 + +示例： + +```ngql +nebula> MATCH (v:player) RETURN std(v.player.age); ++-------------------+ +| std(v.player.age) | ++-------------------+ +| 6.423895701687502 | ++-------------------+ +``` + +## sum() + +sum() 返回参数的和。 + +语法：`sum()` + +- 返回类型：与原参数相同。 + +示例： + +```ngql +nebula> MATCH (v:player) RETURN sum(v.player.age); ++-------------------+ +| sum(v.player.age) | ++-------------------+ +| 1698 | ++-------------------+ +``` + ## 聚合示例 ```ngql diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/16.type-conversion.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/16.type-conversion.md index 23dfb2c546..1a4e2433fe 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/16.type-conversion.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/16.type-conversion.md @@ -150,41 +150,3 @@ nebula> YIELD hash(toLower("HELLO NEBULA")); +-------------------------------+ ``` - -## std() - -std() 返回参数的总体标准差。 - -语法：`std()` - -- 返回类型：double。 - -示例： - -```ngql -nebula> MATCH (v:player) RETURN std(v.player.age); -+-------------------+ -| std(v.player.age) | -+-------------------+ -| 6.423895701687502 | -+-------------------+ -``` - -## sum() - -sum() 返回参数的和。 - -语法：`sum()` - -- 返回类型：与原参数相同。 - -示例： - -```ngql -nebula> MATCH (v:player) RETURN sum(v.player.age); -+-------------------+ -| sum(v.player.age) | -+-------------------+ -| 1698 | -+-------------------+ -``` \ No newline at end of file From fed2453cfd9c4227a1e38001392972f27126826d Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Thu, 17 Nov 2022 10:24:17 +0800 Subject: [PATCH 066/132] Modify tagless (#2323) --- .../3.nebula-graph-architecture/4.storage-service.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 index 9c63216362..2f49f9fbe4 100644 --- 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) From e8b78d5fae35156b0341ae81075188dfad685bc1 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 17 Nov 2022 15:39:57 +0800 Subject: [PATCH 067/132] add hdfs error for dag (#2326) --- .../nebula-explorer/deploy-connect/ex-ug-deploy.md | 6 ++++++ docs-2.0/nebula-explorer/faq.md | 14 ++++++++++++++ 2 files changed, 20 insertions(+) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index 16c6e1062d..106d375b7a 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -25,6 +25,12 @@ License 仅在企业版提供，申请 License 需填写 [Nebula Explorer 试用申请](https://wj.qq.com/s2/10158890/69a8)。 +- 如果需要使用图计算，需要部署 HDFS。namenode 默认使用 8020 端口，datanode 默认使用 50010 端口。 + + !!! caution + + 如果 HDFS 端口不通，可能会提示连接超时。 + ## 注意事项 Explorer 从 3.2.0 版本开始内置了 Dag Controller 安装包，用于提供图计算服务。用户可以自行决定是否启动 Dag Controller 服务。如果没有启动 Dag Controller 服务， Explorer 中的 **Workflow** 菜单将显示为灰色无法点击。 diff --git a/docs-2.0/nebula-explorer/faq.md b/docs-2.0/nebula-explorer/faq.md index 408837b7ed..68281dce87 100644 --- a/docs-2.0/nebula-explorer/faq.md +++ b/docs-2.0/nebula-explorer/faq.md @@ -68,6 +68,20 @@ Dag Controller 包含图查询组件和图计算组件。图查询是发送请 3. 修改上述配置后需要重启 Dag Controller 使配置生效。 +## 任务运行失败，报错`no available namenodes: dial tcp xx.xx.xx.xx:8020: connect: connection timed out`怎么办？ + +请检查 HDFS 的 namenode 端口是否开放。 + +## 任务运行失败，报错`org.apache.hadoop.net.ConnectTimeoutException: 60000 millis timeout`怎么办？ + +请检查 HDFS 的 datanode 端口是否开放。 + +如果没有开放端口，还可能报类似如下错误： + +- `Check failed: false close hdfs-file failed` +- `org.apache.hadoop.ipc.RemoteException(java.io.IOException): File /analytics/xx/tasks/analytics_xxx/xxx.csv could only be replicated to 0 nodes instead of minReplication` + + ## 任务运行失败，报错`broadcast.hpp:193] Check failed: (size_t)recv_bytes >= sizeof(chunk_tail_t) recv message too small: 0`怎么办？ 任务要处理的数据量过小，但是配置的计算节点数与进程数太多。需要在提交作业时设置较小的`clusterSize`和`processes`。 From f8c29a586e9dee530ad3dd86433bed42495b8211 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Thu, 17 Nov 2022 15:48:24 +0800 Subject: [PATCH 068/132] Update error-code.md --- docs-2.0/20.appendix/error-code.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs-2.0/20.appendix/error-code.md b/docs-2.0/20.appendix/error-code.md index 410fd3eb86..df738bcef1 100644 --- a/docs-2.0/20.appendix/error-code.md +++ b/docs-2.0/20.appendix/error-code.md @@ -66,7 +66,6 @@ NebulaGraph 运行出现问题时，会返回错误码。本文介绍错误码 |`E_NO_RUNNING_BALANCE_PLAN`|`-2025`| 没有正在运行的数据均衡计划| |`E_NO_VALID_HOST`|`-2026`| 缺少有效的主机| |`E_CORRUPTED_BALANCE_PLAN`|`-2027`| 已经损坏的数据均衡计划| -|``|`-2029`| 缺少有效的 drainer| |`E_IMPROPER_ROLE`|`-2030`| 回收用户角色失败| |`E_INVALID_PARTITION_NUM`|`-2031`| 无效的分区数量| |`E_INVALID_REPLICA_FACTOR`|`-2032`| 无效的副本因子| @@ -163,7 +162,7 @@ NebulaGraph 运行出现问题时，会返回错误码。本文介绍错误码 |``|`-5004`| | |``|`-2043`| | |``|`-2006`| | - +|``|`-2029`| 缺少有效的 drainer| |``|`-3061`| 客户端和服务端版本不兼容| |``|`-3062`| 获取 ID 序号失败| From f04e7259d8092c7918c4360f6e25ae97950f9863 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 17 Nov 2022 17:12:35 +0800 Subject: [PATCH 069/132] Add hdfs error for dag (#2327) * add hdfs error for dag * update --- docs-2.0/nebula-explorer/faq.md | 4 ++-- docs-2.0/nebula-explorer/workflow/1.prepare-resources.md | 4 +++- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs-2.0/nebula-explorer/faq.md b/docs-2.0/nebula-explorer/faq.md index 68281dce87..b68302e2fc 100644 --- a/docs-2.0/nebula-explorer/faq.md +++ b/docs-2.0/nebula-explorer/faq.md @@ -70,11 +70,11 @@ Dag Controller 包含图查询组件和图计算组件。图查询是发送请 ## 任务运行失败，报错`no available namenodes: dial tcp xx.xx.xx.xx:8020: connect: connection timed out`怎么办？ -请检查 HDFS 的 namenode 端口是否开放。 +请检查 HDFS 的 namenode 端口 8020 是否开放。 ## 任务运行失败，报错`org.apache.hadoop.net.ConnectTimeoutException: 60000 millis timeout`怎么办？ -请检查 HDFS 的 datanode 端口是否开放。 +请检查 HDFS 的 datanode 端口 50010 是否开放。 如果没有开放端口，还可能报类似如下错误： diff --git a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md index 8761ac796f..e3cfb24e70 100644 --- a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md +++ b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md @@ -15,10 +15,12 @@ 3. 配置如下三种资源： + ![workflow_configuration](https://docs-cdn.nebula-graph.com.cn/figures/workflow_configuration_221117_cn.png) + |类型|说明| |:--|:--| |NebulaGraph 配置| 执行图查询或写入图计算结果的 Graph 服务地址。默认为登录 Explorer 使用的 Graph 服务，无法修改。可以设置三种服务的超时时间。| - |HDFS 配置| 存储结果的 HDFS 地址（`fs.defaultFS`配置）。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径、HDFS 用户名（可选）。需要先在 Analytics 所在机器上安装 HDFS 客户端，该配置才能生效。| + |HDFS 配置| 存储结果的 HDFS 地址（`fs.defaultFS`配置）。支持配置保存路径，例如`hdfs://192.168.8.100:9000/test`。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径、HDFS 用户名（可选）。需要先在 Analytics 所在机器上安装 HDFS 客户端，该配置才能生效。| |NebulaGraph Analytics 配置| 执行图计算的 NebulaGraph Analytics 地址。单击**添加**新增地址。| 4. 配置完成后，单击**确认**。 From 26747a1eead9eb698e004a7f1f9292705543de39 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 17 Nov 2022 17:26:46 +0800 Subject: [PATCH 070/132] Update 1.prepare-resources.md --- docs-2.0/nebula-explorer/workflow/1.prepare-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md index e3cfb24e70..88db8488c2 100644 --- a/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md +++ b/docs-2.0/nebula-explorer/workflow/1.prepare-resources.md @@ -20,7 +20,7 @@ |类型|说明| |:--|:--| |NebulaGraph 配置| 执行图查询或写入图计算结果的 Graph 服务地址。默认为登录 Explorer 使用的 Graph 服务，无法修改。可以设置三种服务的超时时间。| - |HDFS 配置| 存储结果的 HDFS 地址（`fs.defaultFS`配置）。支持配置保存路径，例如`hdfs://192.168.8.100:9000/test`。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径、HDFS 用户名（可选）。需要先在 Analytics 所在机器上安装 HDFS 客户端，该配置才能生效。| + |HDFS 配置| 存储结果的 HDFS 地址。单击**添加**新增地址，设置 HDFS 名称、HDFS 路径（`fs.defaultFS`配置）、HDFS 用户名。HDFS 路径支持配置保存路径，例如`hdfs://192.168.8.100:9000/test`。需要先在 Analytics 所在机器上安装 HDFS 客户端，该配置才能生效。| |NebulaGraph Analytics 配置| 执行图计算的 NebulaGraph Analytics 地址。单击**添加**新增地址。| 4. 配置完成后，单击**确认**。 From 3eb64604cdeba25fb5dced8251c9a938655a1b17 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 18 Nov 2022 11:27:42 +0800 Subject: [PATCH 071/132] update ngql template (#2329) --- docs-2.0/nebula-explorer/db-management/ngql-template.md | 4 +++- .../nebula-explorer/graph-explorer/ex-ug-query-exploration.md | 2 ++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/db-management/ngql-template.md b/docs-2.0/nebula-explorer/db-management/ngql-template.md index 4c5fbe67af..97fe1d5b39 100644 --- a/docs-2.0/nebula-explorer/db-management/ngql-template.md +++ b/docs-2.0/nebula-explorer/db-management/ngql-template.md @@ -40,4 +40,6 @@ NebulaGraph 数据库里已经创建 Schema。 ## 使用模板 -除了在模板列表页面单击 ![console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png) 自动跳转至控制台并输入模板，还支持在图探索页面使用模板。详情参见[开始探索](../graph-explorer/ex-ug-query-exploration.md)。 \ No newline at end of file +- (推荐)在图探索页面使用模板。详情参见[开始探索](../graph-explorer/ex-ug-query-exploration.md)。 + +- 在模板列表页面单击 ![console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png) 自动跳转至控制台并输入模板语句，需要自行修改参数化的文本。 diff --git a/docs-2.0/nebula-explorer/graph-explorer/ex-ug-query-exploration.md b/docs-2.0/nebula-explorer/graph-explorer/ex-ug-query-exploration.md index c6d7f3722a..e3a84183f4 100644 --- a/docs-2.0/nebula-explorer/graph-explorer/ex-ug-query-exploration.md +++ b/docs-2.0/nebula-explorer/graph-explorer/ex-ug-query-exploration.md @@ -61,6 +61,8 @@ 用户可以选择已创建的查询语句模板，并填写模板参数值。 +![query_template](https://docs-cdn.nebula-graph.com.cn/figures/query_template_221118_cn.png) + - 返回结果为点时，画布上会展示这些点。 - 返回结果不为点时，会用表格形式展示结果。例如返回球员姓名、年龄等。 From 444440066df5b4fec00357d0a678fef18a3664cd Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 18 Nov 2022 11:55:48 +0800 Subject: [PATCH 072/132] Update ngql-template.md --- docs-2.0/nebula-explorer/db-management/ngql-template.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/db-management/ngql-template.md b/docs-2.0/nebula-explorer/db-management/ngql-template.md index 97fe1d5b39..ce90b3621b 100644 --- a/docs-2.0/nebula-explorer/db-management/ngql-template.md +++ b/docs-2.0/nebula-explorer/db-management/ngql-template.md @@ -40,6 +40,6 @@ NebulaGraph 数据库里已经创建 Schema。 ## 使用模板 -- (推荐)在图探索页面使用模板。详情参见[开始探索](../graph-explorer/ex-ug-query-exploration.md)。 +- （推荐）在图探索页面使用模板。详情参见[开始探索](../graph-explorer/ex-ug-query-exploration.md)。 - 在模板列表页面单击 ![console](https://docs-cdn.nebula-graph.com.cn/figures/nav-console2.png) 自动跳转至控制台并输入模板语句，需要自行修改参数化的文本。 From 5a738535392dcd0f13fd025f60b0262b7ea78a59 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 18 Nov 2022 15:36:37 +0800 Subject: [PATCH 073/132] Update ex-ug-connect.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md index c77f2cff18..4a4a91f64c 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-connect.md @@ -53,8 +53,8 @@ OAuth 部分的配置说明如下。 !!! Note - - 即使 NebulaGraph 数据库与 Explorer 部署在同一台机器上，用户也必须在 **Host** 字段填写这台机器的本机 IP 地址，而不是 `127.0.0.1` 或者 `localhost`。 - - 在新的标签页连接另一个 NebulaGraph 数据库时，会覆盖旧标签页的会话。如果需要同时登录多个 NebulaGraph 数据库，可以用不同的浏览器或者无痕模式。 + - 即使 NebulaGraph 数据库与 Explorer 部署在同一台机器上，用户也必须在 **Host** 字段填写这台机器的本机 IP 地址，而不是 `127.0.0.1` 或者 `localhost`。 + - 在新的标签页连接另一个 NebulaGraph 数据库时，会覆盖旧标签页的会话。如果需要同时登录多个 NebulaGraph 数据库，可以用不同的浏览器或者无痕模式。 - **用户名**和**密码**：根据 NebulaGraph 的[身份验证](../../7.data-security/1.authentication/1.authentication.md)设置填写登录账号和密码。 - 如果未启用身份验证，可以填写默认用户名 `root` 和任意密码。 From 221137cd46a9d52644a6cdff733b82d1c99e557d Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Fri, 18 Nov 2022 17:08:42 +0800 Subject: [PATCH 074/132] Update optional-match.md (#2331) --- .../3.ngql-guide/7.general-query-statements/optional-match.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/optional-match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/optional-match.md index c8cdd8a1ed..e25925621e 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/optional-match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/optional-match.md @@ -1,5 +1,9 @@ # OPTIONAL MATCH +!!! caution + + 目前 `OPTIONAL MATCH` 为 Beta 功能，后续可能会有一定优化调整。 + `OPTIONAL MATCH`通常与`MATCH`语句一起使用，作为`MATCH`语句的可选项去匹配命中的模式，如果没有命中对应的模式，对应的列返回`NULL`。 ## openCypher 兼容性 From 99732ad7448c2814e06b4e2828d0a4bd405142d7 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 21 Nov 2022 15:24:05 +0800 Subject: [PATCH 075/132] merge helm in studio doc (#2333) --- .../st-ug-what-is-graph-studio.md | 5 +- .../deploy-connect/st-ug-deploy-by-helm.md | 61 ------------------- .../deploy-connect/st-ug-deploy.md | 59 ++++++++++++++++++ mkdocs.yml | 1 - 4 files changed, 60 insertions(+), 66 deletions(-) delete mode 100644 docs-2.0/nebula-studio/deploy-connect/st-ug-deploy-by-helm.md diff --git a/docs-2.0/nebula-studio/about-studio/st-ug-what-is-graph-studio.md b/docs-2.0/nebula-studio/about-studio/st-ug-what-is-graph-studio.md index d02dcf4269..2b203e0635 100644 --- a/docs-2.0/nebula-studio/about-studio/st-ug-what-is-graph-studio.md +++ b/docs-2.0/nebula-studio/about-studio/st-ug-what-is-graph-studio.md @@ -8,10 +8,7 @@ NebulaGraph Studio（简称 Studio）是一款可以通过 Web 访问的开源 ## 发行版本 -可以使用以下方式安装部署 Studio： - -- 用户可以使用 Docker 服务、RPM 服务、tar 包和 DEB 包安装部署 Studio，并连接到 NebulaGraph 数据库。详细信息参考 [部署 Studio](../deploy-connect/st-ug-deploy.md)。 -- 使用 Helm 安装部署：在 Kubernetes 集群里使用 Helm 安装并部署 Studio，并连接到 NebulaGraph 数据库。详细信息参考[使用 Helm 部署 NebulaGraph Studio](../deploy-connect/st-ug-deploy-by-helm.md)。 +用户可以使用 RPM 包、DEB 包、tar 包和 Docker 服务安装部署 Studio，在 Kubernetes 集群里还支持使用 Helm 安装部署 Studio。详细信息参考 [部署 Studio](../deploy-connect/st-ug-deploy.md)。 +[连接 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/connect-to-nebula-graph/) From f02abbbd938cc0a06674ba215e8d0f1fbd822494 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Mon, 21 Nov 2022 16:22:37 +0800 Subject: [PATCH 078/132] fix link --- docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md | 6 +++--- docs-2.0/reuse/source_manage-service.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md index 34120c7e7e..5f08d56960 100644 --- a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md +++ b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md @@ -2,7 +2,7 @@ RPM 和 DEB 是 Linux 系统下常见的两种安装包格式，本文介绍如 !!! note - 部署 NebulaGraph 集群的方式参见[使用 RPM/DEB 包部署集群](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/2.compile-and-install-nebula-graph/deploy-nebula-graph-cluster/)。 + {{ ent.ent_begin }} !!! enterpriseonly @@ -152,5 +152,5 @@ RPM 和 DEB 是 Linux 系统下常见的两种安装包格式，本文介绍如 {{ ent.ent_end }} -- [启动 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/5.start-stop-service/) -- [连接 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.connect-to-nebula-graph/) +- [启动 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/5.start-stop-service/) +- [连接 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.connect-to-nebula-graph/) diff --git a/docs-2.0/reuse/source_manage-service.md b/docs-2.0/reuse/source_manage-service.md index d9cdd6f79f..084898d089 100644 --- a/docs-2.0/reuse/source_manage-service.md +++ b/docs-2.0/reuse/source_manage-service.md @@ -291,4 +291,4 @@ a74054c6ae25 vesoft/nebula-graphd:nightly "/usr/local/nebula/b…" 36 mi ## 下一步 -[连接 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.connect-to-nebula-graph/) +- [连接 NebulaGraph](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.connect-to-nebula-graph/) \ No newline at end of file From 7b821848476cb9a54dea9bc54896ebc756e8f0e3 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Mon, 21 Nov 2022 16:23:20 +0800 Subject: [PATCH 079/132] update --- docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md index 5f08d56960..b5487d4e3f 100644 --- a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md +++ b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md @@ -2,6 +2,7 @@ RPM 和 DEB 是 Linux 系统下常见的两种安装包格式，本文介绍如 !!! note + 部署 NebulaGraph 集群的方式参见[使用 RPM/DEB 包部署集群](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts/)。 {{ ent.ent_begin }} From 38387c890d7ec0442b18e1941317b02a2ee658dc Mon Sep 17 00:00:00 2001 From: "jingchun.xia" <6269380+xiajingchun@users.noreply.github.com> Date: Mon, 21 Nov 2022 18:27:07 +0800 Subject: [PATCH 080/132] wrong link of snapshot --- docs-2.0/20.appendix/learning-path.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/20.appendix/learning-path.md b/docs-2.0/20.appendix/learning-path.md index 32a674f299..8a25cae290 100644 --- a/docs-2.0/20.appendix/learning-path.md +++ b/docs-2.0/20.appendix/learning-path.md @@ -139,7 +139,7 @@ | 文档 | | ------------------------------------------------------------ | - |[创建快照](https://docs.nebula-graph.com.cn/{{nebula.release}}/7.data-security/3.manage-snapshot/#_5)| + |[创建快照](https://docs.nebula-graph.com.cn/{{nebula.release}}/backup-and-restore/3.manage-snapshot/#_5)| diff --git a/docs-2.0/reuse/source_ngql_for_quick_start.md b/docs-2.0/reuse/source_ngql_for_quick_start.md index 81a27d539f..0f068e6426 100644 --- a/docs-2.0/reuse/source_ngql_for_quick_start.md +++ b/docs-2.0/reuse/source_ngql_for_quick_start.md @@ -82,6 +82,10 @@ nebula> CREATE SPACE basketballplayer(partition_num=15, replica_factor=1, vid_type=fixed_string(30)); ``` + !!! note + + 如果报错提示`[ERROR (-1005)]: Host not enough!`，请检查是否已[添加 Storage 主机](../2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts.md)。 + 2. 执行命令`SHOW HOSTS`检查分片的分布情况，确保平衡分布。 ```ngql From 94a4d3b040e582242920a3964358988b67c09bc3 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 22 Nov 2022 13:46:12 +0800 Subject: [PATCH 083/132] fix links (#2338) --- mkdocs.yml | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 35119e2377..c3bc4d1b47 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -83,9 +83,6 @@ plugins: - 4.deployment-and-installation/deploy-license.md - 5.configurations-and-logs/2.log-management/audit-log.md - 7.data-security/1.authentication/4.ldap.md - - graph-computing/0.deploy-controller-analytics.md - - graph-computing/nebula-analytics.md - - graph-computing/use-explorer.md - nebula-exchange/use-exchange/ex-ug-export-from-nebula.md - nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md - synchronization-and-migration/replication-between-clusters.md @@ -596,7 +593,8 @@ nav: # - 集群作业管理: nebula-dashboard-ent/4.cluster-operator/cluster-information/job-management.md - 集群操作: - 节点管理: nebula-dashboard-ent/4.cluster-operator/operator/node.md - - 扩缩容: nebula-dashboard-ent/4.cluster-operator/operator/scale.md +#ent +#ent - 扩缩容: nebula-dashboard-ent/4.cluster-operator/operator/scale.md - 服务管理: nebula-dashboard-ent/4.cluster-operator/operator/service.md - 更新配置: nebula-dashboard-ent/4.cluster-operator/operator/update-config.md - 成员管理: nebula-dashboard-ent/4.cluster-operator/operator/member-management.md @@ -687,7 +685,8 @@ nav: - 导入 Kafka 数据: nebula-exchange/use-exchange/ex-ug-import-from-kafka.md - 导入通用 JDBC 数据: nebula-exchange/use-exchange/ex-ug-import-from-jdbc.md - 导入 SST 文件数据: nebula-exchange/use-exchange/ex-ug-import-from-sst.md - - 导出 NebulaGraph 数据: nebula-exchange/use-exchange/ex-ug-export-from-nebula.md +#ent +#ent - 导出 NebulaGraph 数据: nebula-exchange/use-exchange/ex-ug-export-from-nebula.md - Exchange 常见问题: nebula-exchange/ex-ug-FAQ.md - NebulaGraph Operator: From 5d283a95b21408d67d4fd11b9d18bc08de3f5fb8 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 22 Nov 2022 14:51:14 +0800 Subject: [PATCH 084/132] Fix links 2 (#2339) * fix links * update --- .../nebula-exchange/about-exchange/ex-ug-what-is-exchange.md | 5 +++++ docs-2.0/reuse/source_ngql_for_quick_start.md | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md b/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md index 5859239ea4..1667e506ea 100644 --- a/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md +++ b/docs-2.0/nebula-exchange/about-exchange/ex-ug-what-is-exchange.md @@ -111,8 +111,13 @@ Exchange {{exchange.release}} 支持将以下格式或来源的数据转换为 N 除了用 nGQL 语句的形式导入数据，Exchange 还支持将数据源的数据生成 SST 文件，然后通过 Console [导入 SST 文件](../use-exchange/ex-ug-import-from-sst.md)。 +{{ ent.ent_begin }} + 此外，企业版 Exchange 支持以 NebulaGraph 为源，将数据[导出到 CSV 文件](../use-exchange/ex-ug-export-from-nebula.md)。 + {{ ent.ent_end }} + + ## 更新说明 [Release](https://github.com/vesoft-inc/nebula-exchange/releases/tag/{{exchange.tag}}) diff --git a/docs-2.0/reuse/source_ngql_for_quick_start.md b/docs-2.0/reuse/source_ngql_for_quick_start.md index 0f068e6426..fad3dad5b8 100644 --- a/docs-2.0/reuse/source_ngql_for_quick_start.md +++ b/docs-2.0/reuse/source_ngql_for_quick_start.md @@ -84,7 +84,7 @@ !!! note - 如果报错提示`[ERROR (-1005)]: Host not enough!`，请检查是否已[添加 Storage 主机](../2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts.md)。 + 如果报错提示`[ERROR (-1005)]: Host not enough!`，请检查是否已[添加 Storage 主机](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts/)。 2. 执行命令`SHOW HOSTS`检查分片的分布情况，确保平衡分布。 From 109eeaef416c4d292d25c9a6661017c722ee8ece Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Tue, 22 Nov 2022 16:20:07 +0800 Subject: [PATCH 085/132] 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 --- .../8.clauses-and-options/group-by.md | 25 +++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) diff --git a/docs-2.0/3.ngql-guide/8.clauses-and-options/group-by.md b/docs-2.0/3.ngql-guide/8.clauses-and-options/group-by.md index 0591c2c2dd..66f0d7f5f3 100644 --- a/docs-2.0/3.ngql-guide/8.clauses-and-options/group-by.md +++ b/docs-2.0/3.ngql-guide/8.clauses-and-options/group-by.md @@ -57,8 +57,6 @@ nebula> GO FROM "player100" OVER follow BIDIRECT \ +---------------------+------------+ ``` -## 用函数进行分组和计算 - ```ngql # 查找所有连接到 player100 的点，并根据起始点进行分组，返回 degree 的总和。 nebula> GO FROM "player100" OVER follow \ @@ -73,3 +71,26 @@ nebula> GO FROM "player100" OVER follow \ ``` `sum()`函数详情请参见[内置数学函数](../6.functions-and-expressions/1.math.md)。 + + +## 隐式分组 + +在上述 nGQL 语句中明确写出`GROUP BY`并起到分组字段作用的用法称为`GROUP BY`显示用法；而在 openCypher 语句中`GROUP BY`的用法是隐式的，即在语句中不用写出`GROUP BY`也可起到分组字段的作用。nGQL 语句中显示地`GROUP BY`用法与 openCypher 语句中的隐式地`GROUP BY`用法相同，并且 nGQL 语句兼容 openCypher 的用法，即也支持隐式地使用`GROUP BY`。有关`GROUP BY`的隐式用法，请参见[how-to-make-group-by-in-a-cypher-query](https://stackoverflow.com/questions/52722671/how-to-make-group-by-in-a-cypher-query)。 + +例如：查询 34 岁以上的球员中完全重叠服役的区间。 + +```ngql +nebula> LOOKUP ON player WHERE player.age > 34 YIELD id(vertex) AS v | \ + GO FROM $-.v OVER serve YIELD serve.start_year AS start_year, serve.end_year AS end_year | \ + YIELD $-.start_year, $-.end_year, count(*) AS count | \ + ORDER BY $-.count DESC | LIMIT 5; ++---------------+-------------+-------+ +| $-.start_year | $-.end_year | count | ++---------------+-------------+-------+ +| 2018 | 2019 | 3 | +| 1998 | 2004 | 2 | +| 2012 | 2013 | 2 | +| 2007 | 2012 | 2 | +| 2010 | 2011 | 2 | ++---------------+-------------+-------+ +``` \ No newline at end of file From ac3e9558f03c7a47831d3403ddc17c34aac3954a Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 23 Nov 2022 10:13:02 +0800 Subject: [PATCH 086/132] update TIMESTAMP (#2341) --- docs-2.0/2.quick-start/6.cheatsheet-for-ngql-command.md | 4 ++-- docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md | 2 +- .../6.functions-and-expressions/3.date-and-time.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) 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 index edc7790113..270bb883ca 100644 --- 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 @@ -84,8 +84,8 @@ | 函数 | 说明 | | :-------------------- | :------------------------------------------ | - | int now() | 根据当前系统返回当前时区的时间戳。 | - | timestamp timestamp() | 根据当前系统返回当前时区的时间戳。 | + | int now() | 根据当前系统返回当前时间戳。 | + | timestamp timestamp() | 根据当前系统返回当前时间戳。 | | date date() | 根据当前系统返回当前日期（UTC 时间）。 | | time time() | 根据当前系统返回当前时间（UTC 时间）。 | | datetime datetime() | 根据当前系统返回当前日期和时间（UTC 时间）。 | diff --git a/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md b/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md index 18aaacccf3..62c93c007b 100644 --- a/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md +++ b/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md @@ -114,7 +114,7 @@ nebula> RETURN datetime(1625469277); - 插入`TIMESTAMP`的方式包括时间戳、`timestamp()`函数和`now()`函数。 -- `timestamp()`函数支持传入空值获取当前时区的时间戳。 +- `timestamp()`函数支持传入空值获取当前时间戳。 - `timestamp()`函数可将`DATETIME`类型的日期值转换成`TIMESTAMP`类型的日期值，且传入的参数为`string`类型。 diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/3.date-and-time.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/3.date-and-time.md index 7dba1cfe7a..0fafe547e9 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/3.date-and-time.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/3.date-and-time.md @@ -4,8 +4,8 @@ NebulaGraph 支持以下内置日期时间函数。 |函数| 说明 | |:---- | :----| -|int now() | 根据当前系统返回当前时区的时间戳。 | -|timestamp timestamp() | 根据当前系统返回当前时区的时间戳。 | +|int now() | 根据当前系统返回当前时间戳。 | +|timestamp timestamp() | 根据当前系统返回当前时间戳。 | |date date() | 根据当前系统返回当前日期（UTC 时间）。 | |time time() | 根据当前系统返回当前时间（UTC 时间）。 | |datetime datetime() | 根据当前系统返回当前日期和时间（UTC 时间）。 | From b8dff83776e44bfe48752c05cd944785594908d0 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 23 Nov 2022 10:48:16 +0800 Subject: [PATCH 087/132] 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 --- .../6.cheatsheet-for-ngql-command.md | 4 ++-- .../7.general-query-statements/2.match.md | 23 ++++++++++++++----- 2 files changed, 19 insertions(+), 8 deletions(-) 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 index 270bb883ca..7ae9241208 100644 --- 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 @@ -186,14 +186,14 @@ | 匹配点 | `(v)` | 用户可以在一对括号中使用自定义变量来表示模式中的点。例如`(v)`。 | | 匹配 Tag | `MATCH (v:player) RETURN v` | 用户可以在点的右侧用`:`表示模式中的 Tag。 | | 匹配多 Tag | `MATCH (v:player:team) RETURN v LIMIT 10` | 用户可以用英文冒号（:）匹配多 Tag 的点。 | - | 匹配点的属性 | `MATCH (v:player{name:"Tim Duncan"}) RETURN v` | 用户可以在 Tag 的右侧用`{: }`表示模式中点的属性。 | + | 匹配点的属性 | `MATCH (v:player{name:"Tim Duncan"}) RETURN v`

`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 的右侧用`{: }`表示模式中点的属性；或者不指定 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`
`MATCH ()<-[e]-() RETURN e LIMIT 3` | 除了用`--`、`-->`、`<--`表示未命名的边之外，用户还可以在方括号中使用自定义变量命名边。例如`-[e]-`。 | | 匹配 Edge type | `MATCH ()-[e:follow]->() RETURN e LIMIT 5` | 和点一样，用户可以用`:`表示模式中的 Edge type，例如`-[e:follow]-`。 | - | 匹配边的属性 | ` MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) RETURN e` | 用户可以用`{: }`表示模式中 Edge type 的属性，例如`[e:follow{likeness:95}]`。 | + | 匹配边的属性 | ` MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) RETURN e`

`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`| 用户可以用`{: }`表示模式中 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` | 用户可以在模式中使用`:*`匹配定长路径。`hop`必须是一个非负整数。`e`的数据类型是列表。 | diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index c28761ee5f..4ef2e564b1 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -156,8 +156,6 @@ nebula> MATCH (v:player:actor) \ +----------------------------------------------------------------------------------------+ ``` - - ### 匹配点的属性 用户可以在 Tag 的右侧用`{: }`表示模式中点的属性。 @@ -190,6 +188,14 @@ nebula> MATCH (v:player) \ 在 openCypher 9 中，`=`是相等运算符，在 nGQL 中，`==`是相等运算符，`=`是赋值运算符。 +用户也可以不指定 Tag，直接匹配点的属性。 + +```ngql +nebula> 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; +``` ### 匹配点 ID 用户可以使用点 ID 去匹配点。`id()`函数可以检索点的 ID。 @@ -365,10 +371,6 @@ nebula> MATCH ()-[e:follow]->() \ ### 匹配边的属性 -!!! Note - - 匹配边的属性的前提是 Edge type 本身有对应属性的索引，否则，用户无法执行 `MATCH` 语句匹配该属性。 - 用户可以用`{: }`表示模式中 Edge type 的属性，例如`[e:follow{likeness:95}]`。 ```ngql @@ -382,6 +384,15 @@ nebula> MATCH (v:player{name:"Tim Duncan"})-[e:follow{degree:95}]->(v2) \ +--------------------------------------------------------+ ``` +用户也可以不指定 Edge type，直接匹配边的属性。 + +```ngql +nebula> 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; +``` + ### 匹配多个 Edge type 使用`|`可以匹配多个 Edge type，例如`[e:follow|:serve]`。第一个 Edge type 前的英文冒号（:）不可省略，后续 Edge type 前的英文冒号可以省略，例如`[e:follow|serve]`。 From 144cf432548434ad504b5931cf6552925e632858 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 23 Nov 2022 11:19:05 +0800 Subject: [PATCH 088/132] 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 --- .../7.general-query-statements/2.match.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md index 4ef2e564b1..757c7053b5 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/2.match.md @@ -195,6 +195,11 @@ nebula> 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; ++----------------------------------------------------+ +| v | ++----------------------------------------------------+ +| ("player100" :player{age: 42, name: "Tim Duncan"}) | ++----------------------------------------------------+ ``` ### 匹配点 ID @@ -391,6 +396,15 @@ nebula> 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; ++----------------------------------------------------+ +| e | ++----------------------------------------------------+ +| [:follow "player125"->"player100" @0 {degree: 90}] | +| [:follow "player140"->"player114" @0 {degree: 90}] | +| [:follow "player133"->"player144" @0 {degree: 90}] | +| [:follow "player133"->"player114" @0 {degree: 90}] | +... ++----------------------------------------------------+ ``` ### 匹配多个 Edge type From c2fbf54987e76130c0f7169c801974983d1d6b3b Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 23 Nov 2022 14:14:22 +0800 Subject: [PATCH 089/132] Update 2.deploy-connect-dashboard-ent.md (#2343) --- .../2.deploy-connect-dashboard-ent.md | 37 ------------------- 1 file changed, 37 deletions(-) diff --git a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md index 62d53ddd55..ef7f09c3ce 100644 --- a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md @@ -198,43 +198,6 @@ $ sudo /dashboard/scripts/dashboard.service restart all #重启 Dashboard 所有 sudo rpm -ivh nebula-dashboard-ent-xxx.rpm --prefix= ``` - 在可视化的安装过程中，用户需要输入 License 的路径，选择存放元数据的数据库，目前支持 SQLite 和 MySQL。 - - 例如： - - === "SQLite" - - ```bash - Nebula Dashboard Enterprise version need license, please enter the license file path(~/nebula.license): /home/vesoft/license/nebula.license - - Which database do you want to use? [sqlite | mysql]:sqlite # 不填默认为 SQLite。 - - Do you want to start the service now? [Y/N]: y - ``` - - === "MySQL" - - ```bash - Nebula Dashboard Enterprise version need license, please enter the license file path(~/nebula.license): /home/vesoft/license/nebula.license # license的存放路径。 - - Which database do you want to use? [sqlite | mysql]:mysql - - Step1: set mysql database config - - Enter mysql host(127.0.0.1): 192.168.8.157 # 连接的 MySQL 数据库的 IP 地址。 - - Enter mysql service port(3306): # 连接的 MySQL 数据库的端口号。默认3306。 - - Enter mysql username(root): # 登录 MySQL 的账户。 - - Enter mysql password(nebula): # 登录 MySQL 的密码。 - - Enter mysql database name(dashboard): # MySQL 数据库名称。 - - Do you want to start the service now? [Y/N]: y - - ``` - 3. （可选）使用以下命令查看所有服务状态、启动服务。 ``` From be0e789f912211da1b44c5609ba88e7c90d5a88c Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 23 Nov 2022 14:15:47 +0800 Subject: [PATCH 090/132] Update 2.deploy-connect-dashboard-ent.md --- .../2.deploy-connect-dashboard-ent.md | 37 ------------------- 1 file changed, 37 deletions(-) diff --git a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md index ef7f09c3ce..974389cdfb 100644 --- a/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/2.deploy-connect-dashboard-ent.md @@ -288,43 +288,6 @@ sudo rpm -e 使用 DEB 包安装 Dashboard 企业版时不支持自定义安装路径。 - 在可视化的安装过程中，用户需要输入 License 的路径，选择存放元数据的数据库，目前支持 SQLite 和 MySQL。 - - 例如： - - === "SQLite" - - ```bash - Nebula Dashboard Enterprise version need license, please enter the license file path(~/nebula.license): /home/vesoft/license/nebula.license - - Which database do you want to use? [sqlite | mysql]:sqlite # 不填默认为 SQLite。 - - Do you want to start the service now? [Y/N]: y - ``` - - === "MySQL" - - ```bash - Nebula Dashboard Enterprise version need license, please enter the license file path(~/nebula.license): /home/vesoft/license/nebula.license # license的存放路径。 - - Which database do you want to use? [sqlite | mysql]:mysql - - Step1: set mysql database config - - Enter mysql host(127.0.0.1): 192.168.8.157 # 连接的 MySQL 数据库的 IP 地址。 - - Enter mysql service port(3306): # 连接的 MySQL 数据库的端口号。默认3306。 - - Enter mysql username(root): # 登录 MySQL 的账户。 - - Enter mysql password(nebula): # 登录 MySQL 的密码。 - - Enter mysql database name(dashboard): # MySQL 数据库名称。 - - Do you want to start the service now? [Y/N]: y - - ``` - 3. （可选）使用以下命令查看所有服务状态、启动服务。 ``` From aecccc34527153e9e3c26f13db21689dbcdd1c6a Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 24 Nov 2022 09:12:35 +0800 Subject: [PATCH 091/132] Dashboard update 3.2.2 (#2345) * dashboard update 3.2.2 * update --- .../dashboard-ent-release-note.md | 21 ++++++++++++++++++- .../1.what-is-dashboard-ent.md | 2 +- mkdocs.yml | 4 ++-- 3 files changed, 23 insertions(+), 4 deletions(-) diff --git a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md index 476a92c99c..7f49f9a51b 100644 --- a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md +++ b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md @@ -1,5 +1,25 @@ # NebulaGraph Dashboard 企业版更新说明 +## 企业版 v3.2.2 + +- 优化 + + - 删除无用的公共文件夹。 + +- 缺陷修复 + + - 修复 RPM 和 DEB 包无法向 Dashboard 自动注册服务的问题。 + +## 企业版 v3.2.1 + +- 优化 + + - 下载列表添加 NebulaGraph 3.3.0 版本。 + +- 缺陷修复 + + - 修复在社区版 NebulaGraph 3.3.0 中使用 BR 工具失败的问题。 + ## 企业版 v3.2.0 - 功能 @@ -30,4 +50,3 @@ - 修复在服务管理页面查看监控页面时不跳转的问题。 - 修复服务监控页面无法设置基线的问题。 - 修复导入集群时授权失败的问题。 - diff --git a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md index 73811f51d9..4b90d11a73 100644 --- a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md @@ -45,7 +45,7 @@ NebulaGraph 的版本和 Dashboard 企业版的版本对应关系如下。 |NebulaGraph 版本|Dashboard 版本| |:---|:---| -|3.3.0 |3.2.0| +|3.3.0 |3.2.2、3.2.1、3.2.0| |2.5.0 ~ 3.2.0|3.1.2、3.1.1、3.1.0| |2.5.x ~ 3.1.0|3.0.4| |2.5.1 ~ 3.0.0|1.1.0| diff --git a/mkdocs.yml b/mkdocs.yml index c3bc4d1b47..85463d7df2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -192,8 +192,8 @@ extra: base100: 1.0.0 branch: release-3.2 dashboard_ent: - release: 3.2.0 - tag: v3.2.0 + release: 3.2.2 + tag: v3.2.2 branch: release-3.2 console: release: 3.3.1 From 2fce075980983ac2333b4243a85b5e357b958656 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 24 Nov 2022 14:06:09 +0800 Subject: [PATCH 092/132] add-note-for-arm (#2348) --- .../4.deployment-and-installation/1.resource-preparations.md | 2 +- .../3.deploy-nebula-graph-with-docker-compose.md | 2 -- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/1.resource-preparations.md b/docs-2.0/4.deployment-and-installation/1.resource-preparations.md index 92468ceea2..026812861b 100644 --- a/docs-2.0/4.deployment-and-installation/1.resource-preparations.md +++ b/docs-2.0/4.deployment-and-installation/1.resource-preparations.md @@ -25,7 +25,7 @@ NebulaGraph 是针对 NVMe SSD 进行设计和实现的，所有默认参数都 !!! note - 社区用户可以在 ARM MacOS 的 Docker Desktop 上或者 ARM Linux Server 上运行容器化的 NebulaGraph。 + 从 3.0.2 开始，NebulaGraph 在 Docker Hub 上的 Docker 支持 ARM64 架构。社区用户可以在 ARM macOS 的 Docker Desktop 上或者 ARM Linux Server 上运行容器化的 NebulaGraph。 ## 编译源码要求 diff --git a/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md b/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md index 9d78cfd3d0..2dd9c6de92 100644 --- a/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md +++ b/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/3.deploy-nebula-graph-with-docker-compose.md @@ -42,8 +42,6 @@ 3. 执行如下命令启动 NebulaGraph 服务。 - 从 3.0.2 开始，NebulaGraph 在 Docker Hub 上的 Docker 支持 ARM64 架构。用户可以在 ARM macOS 的 Docker Desktop 上或者 ARM Linux Server 上运行容器化的 NebulaGraph。 - !!! Note 如果长期未内核更新镜像，请先更新 [NebulaGraph 镜像](#nebula_graph_docker)和 [NebulaGraph Console 镜像](#nebula_console)。 From 35fb75013cdd11ed9748525b02617fc1b55b5da3 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 24 Nov 2022 14:15:56 +0800 Subject: [PATCH 093/132] update-cloud-for-quick-start (#2347) --- .../2.connect-to-nebulagraph-on-cloud.md | 4 +- .../reuse/source_create_instance_aliyun.md | 113 +++++++++++------- 2 files changed, 75 insertions(+), 42 deletions(-) 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 index 88bf35c094..5f1803f323 100644 --- 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/reuse/source_create_instance_aliyun.md b/docs-2.0/reuse/source_create_instance_aliyun.md index 8407fcfc50..bc1454452b 100644 --- a/docs-2.0/reuse/source_create_instance_aliyun.md +++ b/docs-2.0/reuse/source_create_instance_aliyun.md @@ -1,14 +1,12 @@ - 在使用 NebulaGraph Cloud 阿里云版服务前，要先在阿里云控制台创建服务实例。 !!! caution - 通过 NebulaGraph Cloud 阿里云版创建的 NebulaGraph、NebulaGraph Dashboard 和 NebulaGraph Explorer 服务都是企业版，试用期 3 天。如需长期使用，[联系我们](https://www.nebula-graph.com.cn/contact)申请正式许可证，之后[续期许可证](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/deploy-license/#nebulagraph_license_3)。 + 通过 NebulaGraph Cloud 阿里云版创建的 NebulaGraph、Nebula Dashboard 和 Nebula Explorer 等服务都是企业版，试用期 14 天。如需长期使用，发送邮件[申请正式许可证](mailto:inquiry@vesoft.com)，之后[续期许可证](../../4.deployment-and-installation/deploy-license.md#nebula_graph_license_3)。 -## 前提条件 +## 账号与权限 - 准备[阿里云账号](https://help.aliyun.com/document_detail/324606.html)。 - - 如果使用 RAM 用户创建实例，需为其添加以下权限： - AliyunECSFullAccess @@ -17,67 +15,102 @@ - AliyunCloudMonitorFullAccess - AliyunComputeNestUserFullAccess -## 操作步骤 +## 资源与费用 -1. 登录[创建服务实例](https://computenest.console.aliyun.com/user/cn-hangzhou/serviceInstanceCreate?ServiceId=service-39f4f251e9484369a778)页面。 +NebulaGraph Cloud 阿里云版支持免费试用和付费使用。两种使用方式有不同的资源归属和费用消耗。 -2. 选中**同意授权并创建关联角色**。 +付费版服务实例创建在用户的阿里云账号下，资源费用由用户承担。实例内 NebulaGraph 相关服务的许可证到期后，其中的数据仍然保留在用户的阿里云资源中，直到资源被用户删除。 - ![选中同意授权并创建关联角色](https://docs-cdn.nebula-graph.com.cn/figures/authorize-compute-nest_cn_2022.05.30.png) +免费试用版服务实例使用的资源属于阿里云，资源费用由阿里云承担。实例内 NebulaGraph 相关服务的许可证到期后，其中的数据仍然保留在试用的阿里云资源中，直到资源过期或被用户删除。资源的试用时间为 30 天，到期后资源内保存的数据不保留。 -3. 选择要创建实例的**地域**。 +!!! note -4. 进行**基本信息配置**。 - - 1. 选择 **NebulaGraph版本**。默认为 **3.1.0**。 - 当前仅能选择 **3.1.0**。 - - 2. 设置 **NebulaGraph集群名**。默认为`nebula`。 - - 3. 设置实例密码。 - - - 密码长度为 8-30 个字符。 - - 密码中必须包含大写字母、小写字母、数字、特殊符号中的三种。 - - 特殊符号包括：()`~!@#$%^&*_-+=|{}[]:;'<>,.?/ + 基础版套餐将所有 NebulaGraph 服务节点部署在同一台 ECS 服务器上。 + +## 创建付费版服务实例 + +1. 登录阿里云计算巢[推荐服务](https://computenest.console.aliyun.com/user/cn-hangzhou/recommendService)页面，搜索 **NebulaGraph**。 -5. 进行**付费模式设置**，指定 ECS 服务器的付费方式。默认为**按量付费**。 +2. 在 **NebulaGraph 集群版**卡片上，单击**云市场购买**。 + +3. 在云市场的 **NebulaGraph Enterprise** 产品页，选择**套餐版本**和**购买时长**（即 NebulaGraph 服务的许可证有效期），并单击**立即购买**。 + + !!! caution + + 当前云市场显示的部分价格并非实际售价，购买时需通过右侧的钉钉客服确认实际价格。 + +4. 在**确认订单**页面，选择要创建实例的**地域**。 + +5. 在**付费模式设置**区域，指定 ECS 服务器的付费方式。默认为**按量付费**。 - **按量付费**：按照计费周期计费，在每个结算周期生成账单并从账户中扣除相应费用。详情参见[按量付费](https://help.aliyun.com/document_detail/40653.html)。 - - **预付费，包年包月**：先付费后使用。详情参见[包年包月](https://help.aliyun.com/document_detail/56220.html)。 - - 选择包年包月模式需要指定**购买时长周期**和**购买时长**。**购买时长周期**当前仅支持 **Month**，即按月购买，**购买时间**选择范围为 1-60 月。 - -6. 进行**基础设施配置**。 + - **包年包月**：先付费后使用。详情参见[包年包月](https://help.aliyun.com/document_detail/56220.html)。选择包年包月模式需要指定**购买时长周期**和**购买时长**。**购买时长周期**当前仅支持 **Month**，即按月购买。 + +6. 在**套餐选择**区域，根据需要选择套餐版本。 - 1. 选择**专有网络VPC实例ID**。 + + +7. 在 **NebulaGraph 配置**区域，完成数据盘和 ECS 服务器密码设置。 +8. 在**基础设施配置**区域，完成以下设置。 + + 1. 选择**专有网络 VPC 实例 ID**。 + 如果下拉列表为空，先单击其右侧的**新建专有网络**，完成专有网络创建。 2. 选择**交换机可用区**。 - 3. 选择**业务网络交换机的实例ID**。 - + 3. 选择**业务网络交换机的实例 ID**。 + 如果下拉列表为空，先单击其右侧的**新建交换机**，完成交换机创建。 -7. 进行**集群节点配置**，根据业务需求配置 NebulaGraph 内核服务的节点。 +9. 在**温馨提示**区域，选中**我同意告知服务商我的联系方式**，以便购买后发放许可证。 - NebulaGraph 内核包含 Graph、Meta、Storage 服务，因此需要为这些服务分别选择**节点数量**、**节点实例类型**、**数据盘类型**和**数据盘空间**。 +10. 在页面底部，单击**我已接受协议，前往支付**。 - !!! caution - 建议按照页面推荐信息配置集群节点以提升服务的可用性，例如配置 3 个 Meta 节点和至少 3 个 Storage 节点。 +11. 在**支付**页面，选择支付方式，之后单击页面底部的**支付**。 + +12. 在**支付完成**页面，单击**管理控制台**。 + +13. 在**已购买的服务**页面，单击要创建的实例右侧的**立即进入计算巢部署或查看部署详情**。 + +14. 在计算巢的**服务实例详情**页面，单击**基本信息**区域**状态**右侧的**部署**，并在弹出的对话框中单击**确定部署**。 + +15. 监控实例状态，直到部署完成。平均部署耗时为 10 分钟。 + +## 创建免费版试用版服务实例 + +!!! danger + 免费试用实例不可在生产环境中使用。 + +1. 登录阿里云计算巢[推荐服务](https://computenest.console.aliyun.com/user/cn-hangzhou/recommendService)页面，搜索 **NebulaGraph**。 + +2. 在 **NebulaGraph 集群版**卡片上，单击**免费试用**。 + +3. 系统会为首次创建 NebulaGraph 服务实例的用户弹出申请对话框。在**申请权限**对话框中填写申请人信息。带有红色星号（*）的为必填项。 + + 申请通过后才能继续执行以下步骤。 + +4. 设置**服务实例名称**。 + +5. 选择要创建实例的**地域**。 + +6. 在**套餐选择**区域，根据需要选择套餐版本。 + + -8. 进行**可视化产品配置**，选择要部署的可视化产品。 +7. 在 **NebulaGraph 配置**区域，完成数据盘相关设置。 - 可选用的产品包括 [Dashboard](https://docs.nebula-graph.com.cn/{{nebula.release}}/nebula-dashboard-ent/1.what-is-dashboard-ent/) 和 [Explorer](https://docs.nebula-graph.com.cn/{{nebula.release}}/nebula-explorer/about-explorer/ex-ug-what-is-explorer/)，默认都处于**开启**状态，此时需要为其选择**实例类型**。选中**关闭**表示不部署相应产品。 +8. 在**基础设施配置**区域，选择**交换机可用区**。 -9. 根据需要配置**标签和资源组**。详情参见[什么是资源管理](https://help.aliyun.com/document_detail/94475.html)。 +9. 根据需要配置**标签和资源组**。详情参见[什么是资源管理](https://help.aliyun.com/document_detail/94475.html)。 10. 完成**权限确认**，并选中**我同意授权服务商（杭州悦数科技有限公司）获取上述权限以提供代运维服务**。 -11. 在页面底部，选中**我已阅读并同意《计算巢服务协议》**，并单击**创建**。 +11. 在页面底部，选中**我已阅读并同意《计算巢服务协议》**，并单击**开始免费试用**。 -12. 在**创建**对话框，完成**信息确认**并**支付费用**。 +12. 在**创建**对话框，完成信息确认并单击**确定**。 13. 在**提交成功**页面，单击去列表查看。 @@ -91,4 +124,4 @@ Q：服务实例的状态显示为**部署失败**怎么处理？ 1. 如果使用 RAM 账号创建的实例，确认为该账号授予了本文前提条件中指定的权限。 2. 如果权限符合要求，[删除](https://help.aliyun.com/document_detail/290837.html)创建失败的实例，尝试重新创建。 -3. 如果仍然创建失败，到 [NebulaGraph 论坛](https://discuss.nebula-graph.com.cn/)寻求帮助。 +3. 如果仍然创建失败，到 [NebulaGraph 论坛](https://discuss.nebula-graph.com.cn/)寻求帮助。 \ No newline at end of file From 220d7a313debc17aeb926edb3a1055c350f5236b Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 24 Nov 2022 17:55:29 +0800 Subject: [PATCH 094/132] Br community opts (#2351) * br-community-opts * Update 3.br-backup-data.md * Update 2.compile-br.md --- .../nebula-br/1.what-is-br.md | 3 +- .../nebula-br/2.compile-br.md | 84 ++++++++++++++++++- .../nebula-br/3.br-backup-data.md | 24 +++--- .../nebula-br/4.br-restore-data.md | 24 +++--- mkdocs.yml | 2 +- 5 files changed, 107 insertions(+), 30 deletions(-) diff --git a/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md b/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md index cc16d07204..3b1e4a59fc 100644 --- a/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md +++ b/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md @@ -17,9 +17,8 @@ Backup&Restore（简称 BR）是一款命令行界面（CLI）工具，可以帮 - 数据备份仅支持全量备份，不支持增量备份。 - NebulaGraph Listener 暂时不支持备份，且全文索引也不支持备份。 - 如果备份数据到本地磁盘，备份的文件将会放置在每个服务器的本地路径中。也可以在本地挂载 NFS 文件系统，以便将备份数据还原到不同的主机上。 -- 备份图空间只能恢复到原集群，不能跨集群恢复。 +- 备份图空间只能恢复到原集群，不能跨集群恢复，并且集群的 Storage 主机数量及 IP 需一致。 - 数据备份过程中，指定图空间中的 DDL 和 DML 语句将会阻塞，我们建议在业务低峰期进行操作，例如凌晨 2 点至 5 点。 -- 数据恢复需要原集群和目标集群的 Storage 主机数量及 IP 一致。 - 数据恢复期间有一段时间服务会被停止。 - （实验性功能）如果备份 A 集群中的某个指定图空间，并恢复这个图空间数据至集群 B 时，集群 B 中其他图空间数据将被清除。 - 不支持在容器部署的 NebulaGraph 集群中使用 BR。 diff --git a/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md b/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md index 8aac72d040..6c08917956 100644 --- a/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md +++ b/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md @@ -2,7 +2,19 @@ 本文介绍如何安装 BR。 -## 使用二进制文件安装 +## 安装说明 + +使用 BR 工具备份和恢复 NebulaGraph 时，需要安装 NebulaGraph Agent 服务。Agent 是集群中每台机器的一个守护进程，用于启停 NebulaGraph 服务和上传、下载备份文件。BR 工具和 Agent 插件的安装方式如下文。 + +## 版本兼容性 + +|NebulaGraph 社区版|BR 社区版 |Agent | +|:---|:---|:---| +|3.3.0|3.3.0|0.2.0| + +## 安装 BR + +### 使用二进制文件安装 1. 下载 BR。 @@ -29,13 +41,14 @@ Nebula Backup And Restore Utility Tool,V-{{br.release}} ``` -## 使用源码安装 +### 使用源码安装 使用源码安装 BR 前，准备工作如下： - 安装 [Go](https://github.com/golang/go "Click to go to GitHub") 1.14.x 或更新版本。 - 安装 make。 + 1. 克隆`nebula-br`库至机器。 ```bash @@ -60,3 +73,70 @@ [nebula-br]$ bin/br version NebulaGraph Backup And Restore Utility Tool,V-{{br.release}} ``` + +## 安装 Agent + +NebulaGraph Agent 以二进制形式存在各个机器的安装目录中，通过 RPC 协议对 BR 工具提供服务。 + +在**每台机器**中，进行以下操作： + +1. 下载 Agent。 + + ``` + wget https://github.com/vesoft-inc/nebula-agent/releases/download/v{{agent.release}}/agent-{{agent.release}}-linux-amd64 + ``` + +2. 修改 Agent 的名称为`agent`。 + + ``` + sudo mv agent-{{agent.release}}-linux-amd64 agent + ``` + +3. 授予 Agent 可执行权限。 + + ``` + sudo chmod +x agent + ``` + +4. 执行以下命令启动 Agent。 + + !!! note + + 启动 Agent 前，确保已经启动集群中的 Meta 服务，并且 Agent 有对应 NebulaGraph 服务目录和备份目录的读写权限。 + + ``` + sudo nohup ./nebula_agent --agent=":8888" --meta=":9559" > nebula_agent.log 2>&1 & + ``` + + - `--agent`：Agent 所在机器的 IP 地址和访问端口。 + - `--meta`：集群中任一 Meta 服务所在机器的 IP 地址和访问端口。 + - `--ratelimit`：可选项，限制文件上传和下载的速度，防止带宽被占满导致其他服务不可用。单位：Bytes。 + + 例如： + + ``` + sudo nohup ./nebula_agent --agent="192.168.8.129:8888" --meta="192.168.8.129:9559" --ratelimit=1048576 > nebula_agent.log 2>&1 & + ``` + + !!! caution + + `--agent`配置的 IP 地址需要和[配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)中 Meta 和 Storage 服务的地址格式保持一致，即都使用真实 IP 地址或者都使用`127.0.0.1`，否则 Agent 无法启动。 + + +1. 连接服务并查看 Agent 的运行状态。 + + ``` + nebula> SHOW HOSTS AGENT; + +-----------------+------+----------+---------+--------------+---------+ + | Host | Port | Status | Role | Git Info Sha | Version | + +-----------------+------+----------+---------+--------------+---------+ + | "192.168.8.129" | 8888 | "ONLINE" | "AGENT" | "96646b8" | | + +-----------------+------+----------+---------+--------------+---------+ + ``` + + +## 常见问题 + +### 报错`E_LIST_CLUSTER_NO_AGENT_FAILURE` + +如果操作过程中遇见`E_LIST_CLUSTER_NO_AGENT_FAILURE`错误，可能是由于 Agent 服务没有启动或者 Agent 服务没有被注册至 Meta 服务。首先执行`SHOW HOSTS AGENT`查看集群上所有节点的 Agent 服务的状态，当时状态显示为`OFFLINE`时表示注册 Agent 失败， 然后检查启动 Agent 服务的命令中的`--meta`参数是否正确。 \ No newline at end of file diff --git a/docs-2.0/backup-and-restore/nebula-br/3.br-backup-data.md b/docs-2.0/backup-and-restore/nebula-br/3.br-backup-data.md index 2dadd163a9..bb87f3c20f 100644 --- a/docs-2.0/backup-and-restore/nebula-br/3.br-backup-data.md +++ b/docs-2.0/backup-and-restore/nebula-br/3.br-backup-data.md @@ -1,36 +1,34 @@ # 使用 BR 备份数据 -BR 编译成功后，可以备份整个图空间的数据，本文介绍如何使用 BR 备份数据。 +成功安装 BR 工具后，可以备份整个图空间的数据，本文介绍如何使用 BR 备份数据。 ## 准备工作 -- BR 编译完成。如何编译 BR，请参见[编译 BR](2.compile-br.md)。 - -- 确认 NebulaGraph 服务正在运行中。 +- [安装 BR 和 Agent](2.compile-br.md) 并在集群中的每个主机上运行 Agent。 -- 已下载 [nebula-agent](https://github.com/vesoft-inc/nebula-agent) 并在集群中的每个主机上运行代理服务。 +- 确认 NebulaGraph 服务正在运行中。 - 如果在本地保存备份文件，需要在 Meta 服务器、Storage 服务器和 BR 机器上创建绝对路径相同的目录，并记录绝对路径，同时需要保证账号对该目录有写权限。 - + !!! Note 在生产环境中，我们建议用户将 NFS (Network File System）存储设备挂载到 Meta 服务器、Storage 服务器和 BR 机器上进行本地备份，或者使用 Alibaba Cloud OSS、Amazon S3 进行远程备份。否则当需要通过本地文件恢复数据时，必须手动将这些备份文件移动到指定目录，会导致数据冗余和某些问题。更多信息，请参见[使用 BR 恢复数据](4.br-restore-data.md)。 ## 操作步骤 -运行以下命令对整个集群进行全量备份操作。 +在 BR 工具的安装路径下（编译安装的默认路径为`./bin/br`）运行以下命令对整个集群进行全量备份操作。 !!! Note 确保备份文件的路径存在。 ```bash -$ ./bin/br backup full --meta --storage +$ ./br backup full --meta --storage ``` 例如： -- 运行以下命令对 meta 服务的地址为`127.0.0.1:9559`的整个集群进行全量备份操作，并将备份文件保存到本地的 `/home/nebula/backup/`路径下。 +- 运行以下命令对 meta 服务的地址为`192.168.8.129:9559`的整个集群进行全量备份操作，并将备份文件保存到本地的 `/home/nebula/backup/`路径下。 !!! caution @@ -41,13 +39,13 @@ $ ./bin/br backup full --meta --storage 备份至本地时，默认只备份 leader metad 的数据，因此当有多个 metad 节点时，需要手动将备份后的 leader metad 的目录（路径为`/meta`）拷贝并覆盖其他 follower meatd 节点的对应目录。 ```bash - $ ./bin/br backup full --meta "127.0.0.1:9559" --storage "local:///home/nebula/backup/" + $ ./br backup full --meta "192.168.8.129:9559" --storage "local:///home/nebula/backup/" ``` -- 运行以下命令对 meta 服务的地址为`127.0.0.1:9559`的整个集群进行全量备份操作，并将备份文件保存到兼容 s3 协议的对象存储服务 `br-test` 桶下的`backup`中。 +- 运行以下命令对 meta 服务的地址为`192.168.8.129:9559`的整个集群进行全量备份操作，并将备份文件保存到兼容 s3 协议的对象存储服务 `br-test` 桶下的`backup`中。 ```bash - $ ./bin/br backup full --meta "127.0.0.1:9559" --s3.endpoint "http://127.0.0.1:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region=default + $ ./br backup full --meta "192.168.8.129:9559" --s3.endpoint "http://192.168.8.129:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region=default ``` 以下列出命令的相关参数。 @@ -58,7 +56,7 @@ $ ./bin/br backup full --meta --storage | `--debug` | - | 否 | 无 | 查看更多日志信息。 | | `--log` | string | 否 | `"br.log"` | 日志路径。 | | `--meta` | string | 是| 无 | meta 服务的地址和端口号。 | -| `--spaces` | stringArray | 否 | 无 | (实验性功能)指定要备份的图空间名字，未指定将备份所有图空间。 | +| `--spaces` | stringArray | 否 | 无 |（实验性功能）指定要备份的图空间名字，未指定将备份所有图空间。可指定多个图空间，用法为`--spaces nba_01 --spaces nba_02`。 | | `--storage` | string | 是 | 无 | BR 备份数据存储位置，格式为：`://`
Schema：可选值为 `local` 和 `s3`。选择 s3 时，需要填写`s3.access_key`、`s3.endpoint`、`s3.region`和 `s3.secret_key`。
PATH：存储位置的路径。| | `--s3.access_key` | string | 否 | 无 | 用于标识用户。 | | `--s3.endpoint` | string | 否 | 无 | S3 对外服务的访问域名的 URL，指定 http 或 https。 | diff --git a/docs-2.0/backup-and-restore/nebula-br/4.br-restore-data.md b/docs-2.0/backup-and-restore/nebula-br/4.br-restore-data.md index 859765f847..f6b5fc92fa 100644 --- a/docs-2.0/backup-and-restore/nebula-br/4.br-restore-data.md +++ b/docs-2.0/backup-and-restore/nebula-br/4.br-restore-data.md @@ -12,9 +12,7 @@ ## 准备工作 -- BR 编译完成。如何编译 BR，请参见[编译 BR](2.compile-br.md)。 - -- 已下载 [nebula-agent](https://github.com/vesoft-inc/nebula-agent) 并在集群中的**每个**主机上运行代理服务。 +- [安装 BR 和 Agent](2.compile-br.md) 并在集群中的每个主机上运行 Agent。 - 确认没有应用程序连接到待恢复数据的 NebulaGraph 集群。 @@ -22,15 +20,17 @@ ## 操作步骤 +在 BR 工具的安装路径下（编译安装的默认路径为`./bin/br`），完成以下操作。 + 1. 用户可以使用以下命令列出现有备份信息： ```bash - $ ./bin/br show --storage + $ ./br show --storage ``` 例如，可以使用以下命令列出在本地 `/home/nebula/backup` 路径中的备份的信息。 ```bash - $ ./bin/br show --storage "local:///home/nebula/backup" + $ ./br show --storage "local:///home/nebula/backup" +----------------------------+---------------------+------------------------+-------------+------------+ | NAME | CREATE TIME | SPACES | FULL BACKUP | ALL SPACES | +----------------------------+---------------------+------------------------+-------------+------------+ @@ -41,7 +41,7 @@ 或使用以下命令列出在兼容 s3 协议的对象存储服务 `br-test` 桶下的`backup`中的备份的信息。 ```bash - $ ./bin/br show --s3.endpoint "http://127.0.0.1:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region=default + $ ./br show --s3.endpoint "http://192.168.8.129:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region=default ``` 以下列出命令的相关参数。 @@ -59,18 +59,18 @@ 2. 用户可以使用以下命令恢复数据： ``` - $ ./bin/br restore full --meta --storage --name + $ ./br restore full --meta --storage --name ``` - 例如，可以使用以下命令，将本地 `/home/nebula/backup/` 路径中的数据恢复到为 meta 地址为`127.0.0.1:9559`集群中： + 例如，可以使用以下命令，将本地 `/home/nebula/backup/` 路径中的数据恢复到为 meta 地址为`192.168.8.129:9559`集群中： ``` - $ ./bin/br restore full --meta "127.0.0.1:9559" --storage "local:///home/nebula/backup/" --name BACKUP_2021_12_08_18_38_08 + $ ./br restore full --meta "192.168.8.129:9559" --storage "local:///home/nebula/backup/" --name BACKUP_2021_12_08_18_38_08 ``` - 或者使用以下命令，将兼容 s3 协议的对象存储服务 `br-test` 桶下的`backup`的备份，恢复到 meta 服务的地址为`127.0.0.1:9559`的集群中。 + 或者使用以下命令，将兼容 s3 协议的对象存储服务 `br-test` 桶下的`backup`的备份，恢复到 meta 服务的地址为`192.168.8.129:9559`的集群中。 ```bash - $ ./bin/br restore full --meta "127.0.0.1:9559" --s3.endpoint "http://127.0.0.1:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region="default" --name BACKUP_2021_12_08_18_38_08 + $ ./br restore full --meta "192.168.8.129:9559" --s3.endpoint "http://192.168.8.129:9000" --storage="s3://br-test/backup/" --s3.access_key=minioadmin --s3.secret_key=minioadmin --s3.region="default" --name BACKUP_2021_12_08_18_38_08 ``` 如果返回如下信息，表示数据已经恢复成功。 @@ -100,7 +100,7 @@ 3. 如果在备份期间发现任何错误，用户可以使用以下命令清理临时文件。该命令将清理集群和外部存储中的文件，同时用户也可以使用该命令清理外部存储中的旧的备份文件。 ``` - $ ./bin/br cleanup --meta --storage --name + $ ./br cleanup --meta --storage --name ``` 以下列出命令的相关参数。 diff --git a/mkdocs.yml b/mkdocs.yml index 85463d7df2..04f08abe90 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -490,7 +490,7 @@ nav: - 备份与恢复: - NebulaGraph BR（社区版）: - BR（社区版）概述: backup-and-restore/nebula-br/1.what-is-br.md - - 编译 BR: backup-and-restore/nebula-br/2.compile-br.md + - 安装 BR: backup-and-restore/nebula-br/2.compile-br.md - 使用 BR 备份数据: backup-and-restore/nebula-br/3.br-backup-data.md - 使用 BR 恢复数据: backup-and-restore/nebula-br/4.br-restore-data.md #ent From cdb0bd76f3e356aa7e3a26c1e25f596f6a9afbb4 Mon Sep 17 00:00:00 2001 From: "jingchun.xia" <6269380+xiajingchun@users.noreply.github.com> Date: Thu, 24 Nov 2022 23:32:21 +0800 Subject: [PATCH 095/132] mistake in rebuild index config it should be rebuild_index_batch_size instead of snapshot_batch_size --- .../14.native-index-statements/4.rebuild-native-index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/14.native-index-statements/4.rebuild-native-index.md b/docs-2.0/3.ngql-guide/14.native-index-statements/4.rebuild-native-index.md index 5335657c69..5ce23a6cbe 100644 --- a/docs-2.0/3.ngql-guide/14.native-index-statements/4.rebuild-native-index.md +++ b/docs-2.0/3.ngql-guide/14.native-index-statements/4.rebuild-native-index.md @@ -9,7 +9,7 @@ !!! performance - 通过修改配置文件中的`rebuild_index_part_rate_limit` 和 `snapshot_batch_size` 两个参数，可优化重建索引的速度，另外，更大参数可能会导致更高的内存和网络占用，详情请参见 [Storage服务配置](../../5.configurations-and-logs/1.configurations/4.storage-config.md#misc)。 + 通过修改配置文件中的`rebuild_index_part_rate_limit` 和 `rebuild_index_batch_size` 两个参数，可优化重建索引的速度，另外，更大参数可能会导致更高的内存和网络占用，详情请参见 [Storage服务配置](../../5.configurations-and-logs/1.configurations/4.storage-config.md#misc)。 ## 语法 From deedd9a161b0c92537c61ac2b4bce8996d7448e4 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Fri, 25 Nov 2022 11:53:25 +0800 Subject: [PATCH 096/132] why-space-0-not-found (#2352) --- .../upgrade-nebula-graph-to-latest.md | 30 +++++++++++-------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md index 24dfc1e2b9..d1a6a2f472 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md @@ -149,17 +149,21 @@ ## FAQ -Q：升级过程中是否可以通过客户端写入数据？ +### 升级过程中是否可以通过客户端写入数据？ -A：不可以。升级过程中需要停止所有服务。 +不可以。升级过程中需要停止所有服务。 -Q：如果某台机器只有 Graph 服务，没有 Storage 服务，如何升级？ +### 升级过程中出现`Space 0 not found`。 -A：只需要升级 Graph 服务对应的二进制文件和配置文件。 +当升级过程中出现`Space 0 not found`告警信息时，用户可以忽略这个信息。因为升级过程会从磁盘读取所有 Space ID，而`0`（路径为`/data/storage/nebula/0`）并不会存在磁盘上，所以 localCache 里不会有 Space `0`相关数据。之所以可以忽略是因为 Space `0` 不含用户数据，它只用来存 JobManager 的 Task 状态。 -Q：操作报错 `Permission denied`。 +### 如果某台机器只有 Graph 服务，没有 Storage 服务，如何升级？ -A：部分命令需要有 sudo 权限。 +只需要升级 Graph 服务对应的二进制文件和配置文件。 + +### 操作报错 `Permission denied`。 + +部分命令需要有 sudo 权限。 -Q：是否有工具或者办法验证新旧版本数据是否一致？ +### 是否有工具或者办法验证新旧版本数据是否一致？ -A：没有。如果只是检查数据量，可以在升级完成后再次运行`SUBMIT JOB STATS`和`SHOW STATS`统计数据量，并与升级之前做对比。 +没有。如果只是检查数据量，可以在升级完成后再次运行`SUBMIT JOB STATS`和`SHOW STATS`统计数据量，并与升级之前做对比。 -Q: Storage `OFFLINE`并且`Leader count`是`0`怎么处理？ +### Storage `OFFLINE`并且`Leader count`是`0`怎么处理？ -A：运行以下命令手动添加 Storage 主机： +运行以下命令手动添加 Storage 主机： ```ngql ADD HOSTS :[, : ...]; @@ -189,10 +193,10 @@ ADD HOSTS 192.168.10.100:9779, 192.168.10.101:9779, 192.168.10.102:9779; 如果添加 Storage 主机后问题仍然存在，在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。 -Q：为什么升级后用`SHOW JOBS`查询到的 Job 的 ID 与升级前一样，但 Job 名称等信息不同了？ +### 为什么升级后用`SHOW JOBS`查询到的 Job 的 ID 与升级前一样，但 Job 名称等信息不同了？ -A： NebulaGraph 2.5.0 版本调整了 Job 的定义，详情参见 [Pull request](https://github.com/vesoft-inc/nebula-common/pull/562/files)。如果是从 2.5.0 之前的版本升级，会出现该问题。 +NebulaGraph 2.5.0 版本调整了 Job 的定义，详情参见 [Pull request](https://github.com/vesoft-inc/nebula-common/pull/562/files)。如果是从 2.5.0 之前的版本升级，会出现该问题。 -Q: 有哪些语法不兼容 ? +### 有哪些语法不兼容 ? A: 参见[Release Note](../../20.appendix/release-notes/nebula-comm-release-note.md) Incompatibility 部分。 From 73c2abf52f86036949d277572afc15079500d862 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Fri, 25 Nov 2022 13:56:31 +0800 Subject: [PATCH 097/132] Why space 0 not found (#2353) * why-space-0-not-found * Update upgrade-nebula-graph-to-latest.md --- .../3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md index d1a6a2f472..9114fecd8b 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md @@ -155,7 +155,7 @@ ### 升级过程中出现`Space 0 not found`。 -当升级过程中出现`Space 0 not found`告警信息时，用户可以忽略这个信息。因为升级过程会从磁盘读取所有 Space ID，而`0`（路径为`/data/storage/nebula/0`）并不会存在磁盘上，所以 localCache 里不会有 Space `0`相关数据。之所以可以忽略是因为 Space `0` 不含用户数据，它只用来存 JobManager 的 Task 状态。 +当升级过程中出现`Space 0 not found`告警信息时，用户可以忽略这个信息。升级过程会从磁盘读取所有 Space ID，而`0`（路径为`/data/storage/nebula/0`）并不会存在磁盘上。Space `0` 用来存储 Storage 服务的元信息，并不包含用户数据，因此不会影响升级。 ### 如果某台机器只有 Graph 服务，没有 Storage 服务，如何升级？ From 52e4e58489c70421b54e469f1214255b1ba2db15 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Fri, 25 Nov 2022 16:47:25 +0800 Subject: [PATCH 098/132] Br community opts (#2354) * br-community-opts * Update 3.br-backup-data.md * Update 2.compile-br.md * Update 1.what-is-br.md --- docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md b/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md index 3b1e4a59fc..aa23886dae 100644 --- a/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md +++ b/docs-2.0/backup-and-restore/nebula-br/1.what-is-br.md @@ -17,10 +17,9 @@ Backup&Restore（简称 BR）是一款命令行界面（CLI）工具，可以帮 - 数据备份仅支持全量备份，不支持增量备份。 - NebulaGraph Listener 暂时不支持备份，且全文索引也不支持备份。 - 如果备份数据到本地磁盘，备份的文件将会放置在每个服务器的本地路径中。也可以在本地挂载 NFS 文件系统，以便将备份数据还原到不同的主机上。 -- 备份图空间只能恢复到原集群，不能跨集群恢复，并且集群的 Storage 主机数量及 IP 需一致。 +- 备份图空间只能恢复到原集群，不能跨集群恢复，并且集群的 Storage 主机数量及 IP 需一致。还原指定图空间时将清除集群中其余所有图空间。 - 数据备份过程中，指定图空间中的 DDL 和 DML 语句将会阻塞，我们建议在业务低峰期进行操作，例如凌晨 2 点至 5 点。 - 数据恢复期间有一段时间服务会被停止。 -- （实验性功能）如果备份 A 集群中的某个指定图空间，并恢复这个图空间数据至集群 B 时，集群 B 中其他图空间数据将被清除。 - 不支持在容器部署的 NebulaGraph 集群中使用 BR。 From 14ca1dd64109f30a7b6922509bb343e396410202 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Mon, 28 Nov 2022 11:54:08 +0800 Subject: [PATCH 099/132] Update upgrade-nebula-from-300-to-latest.md --- .../upgrade-nebula-from-300-to-latest.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md index e35e943a0f..88734559bf 100644 --- a/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md +++ b/docs-2.0/4.deployment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md @@ -8,9 +8,9 @@ NebulaGraph v3.x 升级至 v{{nebula.release}}，只需要使用 v{{nebula.relea 2. 停止所有 NebulaGraph 服务。详情请参见[管理 NebulaGraph 服务](../../2.quick-start/3.quick-start-on-premise/5.start-stop-service.md)。建议更新前备份配置文件。 -!!! caution + !!! caution - 如果用户需要保留无 Tag 的点，在集群内所有 Graph 服务的配置文件（`nebula-graphd.conf`）中新增`--graph_use_vertex_key=true`；在所有 Storage 服务的配置文件（`nebula-storaged.conf`）中新增`--use_vertex_key=true`。 + 如果用户需要保留无 Tag 的点，在集群内所有 Graph 服务的配置文件（`nebula-graphd.conf`）中新增`--graph_use_vertex_key=true`；在所有 Storage 服务的配置文件（`nebula-storaged.conf`）中新增`--use_vertex_key=true`。 3. 执行如下命令升级： @@ -48,4 +48,4 @@ NebulaGraph v3.x 升级至 v{{nebula.release}}，只需要使用 v{{nebula.relea !!! caution - Docker Compose 部署的 NebulaGraph 建议重新部署新版本后导入数据。 \ No newline at end of file + Docker Compose 部署的 NebulaGraph 建议重新部署新版本后导入数据。 From dcae37017d16c33a98253bb26cb670e764857209 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Mon, 28 Nov 2022 14:01:35 +0800 Subject: [PATCH 100/132] Update README.md (#2355) --- docs-2.0/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs-2.0/README.md b/docs-2.0/README.md index 910843a73e..9ab96dce49 100644 --- a/docs-2.0/README.md +++ b/docs-2.0/README.md @@ -15,6 +15,15 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库，能够承载数千亿个点和数万亿条边的超大规模数据集，并且提供毫秒级查询。 +## 最新发布 + +- [NebulaGraph 社区版 {{ nebula.release }}](20.appendix/release-notes/nebula-comm-release-note.md) + +- [NebulaGraph Studio](20.appendix/release-notes/studio-release-note.md) +- [NebulaGraph Dashboard](20.appendix/release-notes/dashboard-comm-release-note.md) +- [NebulaGraph Dashboard 企业版](20.appendix/release-notes/dashboard-ent-release-note.md) +- [NebulaGraph Explorer](20.appendix/release-notes/explorer-release-note.md) + ## 快速开始 * [学习路径](20.appendix/learning-path.md)与[获取认证](https://academic.nebula-graph.io/?lang=ZH_CN) * [什么是 NebulaGraph](1.introduction/1.what-is-nebula-graph.md) @@ -24,6 +33,8 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库 * [FAQ](20.appendix/0.FAQ.md) * [生态工具](20.appendix/6.eco-tool-version.md) + + ## 其他资料 From c36f4857d032b9405abb13e1095f14c0ff72272b Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Mon, 28 Nov 2022 15:55:26 +0800 Subject: [PATCH 101/132] startNode()-&-endNode()-don't-return-prop-via-edges- (#2358) --- docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md index f82b6a748e..302a4606fb 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md @@ -339,7 +339,7 @@ nebula> MATCH (v:player{name:"Tim Duncan"})-[e]->() \ ### startNode() -startNode() 获取一条边或一条路径并返回它的起始点信息，包括点 ID、Tag、属性和值。 +startNode() 获取一条路径并返回它的起始点信息，包括点 ID、Tag、属性和值。 语法：`startNode()` @@ -357,7 +357,7 @@ nebula> MATCH p = (a :player {name : "Tim Duncan"})-[r:serve]-(t) \ ### endNode() -endNode() 获取一条边或一条路径并返回它的目的点信息，包括点 ID、Tag、属性和值。 +endNode() 获取一条路径并返回它的目的点信息，包括点 ID、Tag、属性和值。 语法：`endNode()` From 0c2954542924f50aea6a6cc60debb421830295a0 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Mon, 28 Nov 2022 18:37:21 +0800 Subject: [PATCH 102/132] Add release notes on the default page (#2361) * Update README.md * Update README.md --- docs-2.0/README.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs-2.0/README.md b/docs-2.0/README.md index 9ab96dce49..e174b26c7e 100644 --- a/docs-2.0/README.md +++ b/docs-2.0/README.md @@ -15,14 +15,6 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库，能够承载数千亿个点和数万亿条边的超大规模数据集，并且提供毫秒级查询。 -## 最新发布 - -- [NebulaGraph 社区版 {{ nebula.release }}](20.appendix/release-notes/nebula-comm-release-note.md) - -- [NebulaGraph Studio](20.appendix/release-notes/studio-release-note.md) -- [NebulaGraph Dashboard](20.appendix/release-notes/dashboard-comm-release-note.md) -- [NebulaGraph Dashboard 企业版](20.appendix/release-notes/dashboard-ent-release-note.md) -- [NebulaGraph Explorer](20.appendix/release-notes/explorer-release-note.md) ## 快速开始 * [学习路径](20.appendix/learning-path.md)与[获取认证](https://academic.nebula-graph.io/?lang=ZH_CN) @@ -34,6 +26,15 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库 * [生态工具](20.appendix/6.eco-tool-version.md) +## 最新发布 + +- [NebulaGraph 社区版 {{ nebula.release }}](20.appendix/release-notes/nebula-comm-release-note.md) + +- [NebulaGraph Studio](20.appendix/release-notes/studio-release-note.md) +- [NebulaGraph Dashboard](20.appendix/release-notes/dashboard-comm-release-note.md) +- [NebulaGraph Dashboard 企业版](20.appendix/release-notes/dashboard-ent-release-note.md) +- [NebulaGraph Explorer](20.appendix/release-notes/explorer-release-note.md) + ## 其他资料 From 9236c959b0aae135ebe911956ffeab60aa5bd41f Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Tue, 29 Nov 2022 10:03:53 +0800 Subject: [PATCH 103/132] Update README.md --- docs-2.0/README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs-2.0/README.md b/docs-2.0/README.md index e174b26c7e..0ac8e74009 100644 --- a/docs-2.0/README.md +++ b/docs-2.0/README.md @@ -41,7 +41,6 @@ NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库 - [Nebula Graph 完全指南](https://docs.nebula-graph.com.cn/site/pdf/NebulaGraph-book.pdf)与[摘要版本](https://arxiv.org/abs/2206.07278) -- [发布说明](20.appendix/release-notes/nebula-comm-release-note.md) - [论坛](https://discuss.nebula-graph.com.cn/) - [项目主页](https://nebula-graph.com.cn/) - [系列视频](https://space.bilibili.com/472621355) From ac643c62aaa90ea126ddf60988e1adb5cd442c4f Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Tue, 29 Nov 2022 11:56:51 +0800 Subject: [PATCH 104/132] Update 1.resource-preparations.md (#2356) * Update 1.resource-preparations.md * list supporting operating systems --- .../4.install-nebula-graph-from-tar.md | 7 ++++++- .../reuse/source_install-nebula-graph-by-rpm-or-deb.md | 6 ++++++ 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md b/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md index c38838cb6e..98bd15e6fe 100644 --- a/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md +++ b/docs-2.0/4.deployment-and-installation/2.compile-and-install-nebula-graph/4.install-nebula-graph-from-tar.md @@ -4,7 +4,12 @@ !!! note - NebulaGraph 从 2.6.0 版本起提供 tar.gz 文件。 + - NebulaGraph 从 2.6.0 版本起提供 tar.gz 文件。 + + - 当前仅支持在 Linux 系统下安装 NebulaGraph，且仅支持 CentOS 7.x、CentOS 8.x、Ubuntu 16.04、Ubuntu 18.04、Ubuntu 20.04 操作系统。 + + - 如果用户使用的是国产化的 Linux 操作系统，请[安装企业版 NebulaGraph](https://www.nebula-graph.com.cn/contact)。 + ## 操作步骤 diff --git a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md index b5487d4e3f..795a6e5c35 100644 --- a/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md +++ b/docs-2.0/reuse/source_install-nebula-graph-by-rpm-or-deb.md @@ -18,6 +18,12 @@ RPM 和 DEB 是 Linux 系统下常见的两种安装包格式，本文介绍如 ## 下载安装包 +!!! note + + - 当前仅支持在 Linux 系统下安装 NebulaGraph，且仅支持 CentOS 7.x、CentOS 8.x、Ubuntu 16.04、Ubuntu 18.04、Ubuntu 20.04 操作系统。 + + - 如果用户使用的是国产化的 Linux 操作系统，请[安装企业版 NebulaGraph](https://www.nebula-graph.com.cn/contact)。 + ### 阿里云 OSS 下载 - 下载 release 版本 From f5d2b4bcc42ee78062d1062d038a3719c67b3363 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 29 Nov 2022 13:49:26 +0800 Subject: [PATCH 105/132] Update 3.go.md (#2362) --- docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md b/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md index 85edb11a54..6137545965 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md @@ -43,7 +43,8 @@ YIELD [DISTINCT] !!! Note - 遍历多个 Edge type 时，`WHERE`子句有一些限制。例如不支持`WHERE edge1.prop1 > edge2.prop2`。 + - 遍历多个 Edge type 时，`WHERE`子句有一些限制。例如不支持`WHERE edge1.prop1 > edge2.prop2`。 + - GO 语句执行时先遍历所有的点，然后再根据过滤器条件进行过滤。 - `YIELD [DISTINCT] `：定义需要返回的输出。` `建议使用 [Schema 函数](../6.functions-and-expressions/4.schema.md)，当前支持`src(edge)`、`dst(edge)`、`type(edge)`等，暂不支持嵌套函数。详情参见 [YIELD](../8.clauses-and-options/yield.md)。 From 732010d57d1ef4ee5d591c3ebbbfdeaf3ee28697 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 30 Nov 2022 17:02:25 +0800 Subject: [PATCH 106/132] Update 4.schema.md (#2365) --- .../6.functions-and-expressions/4.schema.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md b/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md index 302a4606fb..a580264694 100644 --- a/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md +++ b/docs-2.0/3.ngql-guide/6.functions-and-expressions/4.schema.md @@ -1,8 +1,13 @@ -# Schema 函数 +# Schema 相关函数 -本文介绍 NebulaGraph 支持的 Schema 函数。Schema 函数分为两类，一类适用于原生 nGQL 语句，另一类适用于 openCypher 兼容语句。 +本文介绍 NebulaGraph 支持的 [Schema](../../1.introduction/2.data-model.md) 相关的函数。 -## 原生 nGQL 语句适用 +Schema 相关的函数分为两类： + +- [适用于原生 nGQL 语句](#ngql) +- [适用于 openCypher 兼容语句](#opencypher) + +## 原生 nGQL 语句适用 原生 nGQL 语句的`YIELD`和`WHERE`子句中可以使用如下介绍的函数。 @@ -204,7 +209,7 @@ edges 返回子图中的边的信息。详情参见 [GET SUBGRAPH](../16.subgrap path 返回路径信息。详情参见 [FIND PATH](../16.subgraph-and-path/2.find-path.md)。 -## openCypher 兼容语句适用 +## openCypher 兼容语句适用 openCypher 兼容语句的`RETURN`和`WHERE`子句中可以使用如下介绍的函数。 From 2a58e9c8a6d8061f6058fc751d606235ed0eecaa Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Wed, 30 Nov 2022 17:12:15 +0800 Subject: [PATCH 107/132] Wording revision of schema related functions (#2366) * Update 4.schema.md * comments fix --- docs-2.0/2.quick-start/6.cheatsheet-for-ngql-command.md | 2 +- docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md | 2 +- .../4.variable-and-composite-queries/3.property-reference.md | 2 +- docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md | 2 +- mkdocs.yml | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) 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 index 7ae9241208..a1ea5fc753 100644 --- 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 @@ -90,7 +90,7 @@ | 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 语句适用 diff --git a/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md b/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md index a1fc458f5b..b0d91ff4ed 100644 --- a/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md +++ b/docs-2.0/3.ngql-guide/16.subgraph-and-path/1.get-subgraph.md @@ -34,7 +34,7 @@ YIELD [VERTICES AS ] [, EDGES AS ]; - **仅支持**`AND`运算符。 - **仅支持**过滤目的点，点的格式为`$$.tagName.propName`。 - **支持**数学函数、聚合函数、字符串函数、日期时间函数、列表函数中的通用函数和类型转化函数。 -- **不支持**聚合函数、Schema 函数、条件表达式函数、谓词函数、geo 函数和自定义函数，列表函数中除通用函数以外的函数。 +- **不支持**聚合函数、Schema 相关函数、条件表达式函数、谓词函数、geo 函数和自定义函数，列表函数中除通用函数以外的函数。 ## 示例 diff --git a/docs-2.0/3.ngql-guide/4.variable-and-composite-queries/3.property-reference.md b/docs-2.0/3.ngql-guide/4.variable-and-composite-queries/3.property-reference.md index f5d12ceb8f..8ba2acbf03 100644 --- a/docs-2.0/3.ngql-guide/4.variable-and-composite-queries/3.property-reference.md +++ b/docs-2.0/3.ngql-guide/4.variable-and-composite-queries/3.property-reference.md @@ -88,7 +88,7 @@ nebula> GO FROM "player100" OVER follow YIELD follow._src, follow._dst, follow._ !!! compatibility "历史版本兼容性" - 从 NebulaGraph 2.6.0 起支持了新的 [Schema 函数](../6.functions-and-expressions/4.schema.md)。以上示例在 NebulaGraph {{ nebula.release}} 中的近似写法如下： + 从 NebulaGraph 2.6.0 起支持了新的 [Schema 相关函数](../6.functions-and-expressions/4.schema.md)。以上示例在 NebulaGraph {{ nebula.release}} 中的近似写法如下： ```ngql GO FROM "player100" OVER follow YIELD properties($^).name AS startName, properties($$).age AS endAge; diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md b/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md index 6137545965..1c1205a161 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/3.go.md @@ -46,7 +46,7 @@ YIELD [DISTINCT] - 遍历多个 Edge type 时，`WHERE`子句有一些限制。例如不支持`WHERE edge1.prop1 > edge2.prop2`。 - GO 语句执行时先遍历所有的点，然后再根据过滤器条件进行过滤。 -- `YIELD [DISTINCT] `：定义需要返回的输出。` `建议使用 [Schema 函数](../6.functions-and-expressions/4.schema.md)，当前支持`src(edge)`、`dst(edge)`、`type(edge)`等，暂不支持嵌套函数。详情参见 [YIELD](../8.clauses-and-options/yield.md)。 +- `YIELD [DISTINCT] `：定义需要返回的输出。` `建议使用 [Schema 相关函数](../6.functions-and-expressions/4.schema.md)，当前支持`src(edge)`、`dst(edge)`、`type(edge)`等，暂不支持嵌套函数。详情参见 [YIELD](../8.clauses-and-options/yield.md)。 - `SAMPLE `：用于在结果集中取样。详情参见 [SAMPLE](../8.clauses-and-options/sample.md)。 diff --git a/mkdocs.yml b/mkdocs.yml index 04f08abe90..e2aa3642c2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -322,7 +322,7 @@ nav: - 聚合函数: 3.ngql-guide/6.functions-and-expressions/15.aggregating.md - 字符串函数: 3.ngql-guide/6.functions-and-expressions/2.string.md - 日期时间函数: 3.ngql-guide/6.functions-and-expressions/3.date-and-time.md - - Schema 函数: 3.ngql-guide/6.functions-and-expressions/4.schema.md + - Schema 相关函数: 3.ngql-guide/6.functions-and-expressions/4.schema.md - 列表函数: 3.ngql-guide/6.functions-and-expressions/6.list.md - 类型转换函数: 3.ngql-guide/6.functions-and-expressions/16.type-conversion.md - 条件表达式函数: 3.ngql-guide/6.functions-and-expressions/5.conditional-expressions.md From 6ec4fadc642a7633dc2ea0e33abe3bb448f5d51a Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 1 Dec 2022 10:21:18 +0800 Subject: [PATCH 108/132] dashboard release 3.2.3 (#2367) --- .../20.appendix/release-notes/dashboard-ent-release-note.md | 6 ++++++ docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md | 2 +- mkdocs.yml | 4 ++-- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md index 7f49f9a51b..b1b8edd0f8 100644 --- a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md +++ b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md @@ -1,5 +1,11 @@ # NebulaGraph Dashboard 企业版更新说明 +## 企业版 v3.2.3 + +- 优化 + + - 如果 NebulaGraph 企业版版本高于 3.3.0，隐藏备份恢复页面。 + ## 企业版 v3.2.2 - 优化 diff --git a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md index 4b90d11a73..f47863e9dc 100644 --- a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md @@ -45,7 +45,7 @@ NebulaGraph 的版本和 Dashboard 企业版的版本对应关系如下。 |NebulaGraph 版本|Dashboard 版本| |:---|:---| -|3.3.0 |3.2.2、3.2.1、3.2.0| +|3.3.0 |3.2.3、3.2.2、3.2.1、3.2.0| |2.5.0 ~ 3.2.0|3.1.2、3.1.1、3.1.0| |2.5.x ~ 3.1.0|3.0.4| |2.5.1 ~ 3.0.0|1.1.0| diff --git a/mkdocs.yml b/mkdocs.yml index e2aa3642c2..527673b1d2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -192,8 +192,8 @@ extra: base100: 1.0.0 branch: release-3.2 dashboard_ent: - release: 3.2.2 - tag: v3.2.2 + release: 3.2.3 + tag: v3.2.3 branch: release-3.2 console: release: 3.3.1 From 8c23cd9a1447d93f8e96b79b948e200ac9c2eaaa Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 1 Dec 2022 15:10:39 +0800 Subject: [PATCH 109/132] Update ex-ug-deploy.md --- docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md index 106d375b7a..2e5be5de85 100644 --- a/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md +++ b/docs-2.0/nebula-explorer/deploy-connect/ex-ug-deploy.md @@ -264,7 +264,6 @@ Dag Controller 可以结合 NebulaGraph Analytics 进行复杂的图计算。例 Host: 0.0.0.0 # Dag Controller 服务的 IP。 Port: 9002 # Dag Controller 服务的端口。 Timeout: 60000 # HTTP 接口请求的超时时间。 - RPC_HDFS_PASSWORD: "123456" # 保留参数。 Log: # 日志打印相关参数。详情参见 https://go-zero.dev/cn/docs/blog/tool/logx/ Mode: file # 保存模式。 From eca948d8b88c6e2b787c581b2f080d22d9c49711 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Thu, 1 Dec 2022 15:33:22 +0800 Subject: [PATCH 110/132] timestamp()-supports-int (#2368) * timestamp()-supports-int * Update 4.date-and-time.md --- docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md b/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md index 62c93c007b..8f4c999943 100644 --- a/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md +++ b/docs-2.0/3.ngql-guide/3.data-types/4.date-and-time.md @@ -110,13 +110,13 @@ nebula> RETURN datetime(1625469277); - 以时间戳形式存储和显示。例如`1615974839`，表示`2021-03-17T17:53:59`。 -- 查询`TIMESTAMP`的方式包括时间戳和`timestamp()`函数。 +- 查询`TIMESTAMP`类型属性值的方式包括时间戳整数和`timestamp()`函数。 -- 插入`TIMESTAMP`的方式包括时间戳、`timestamp()`函数和`now()`函数。 +- 插入`TIMESTAMP`类型属性值的方式包括时间戳整数、`timestamp()`函数和`now()`函数。 -- `timestamp()`函数支持传入空值获取当前时间戳。 +- `timestamp()`函数支持传入空值获取当前时间戳；同时支持传入整数以标识该整数为时间戳，整数取值：`0~9223372036`。 -- `timestamp()`函数可将`DATETIME`类型的日期值转换成`TIMESTAMP`类型的日期值，且传入的参数为`string`类型。 +- `timestamp()`函数可将`DATETIME`类型的日期值转换成`TIMESTAMP`类型的日期值，且传入的`DATETIME`类型的日期值为`string`类型。 - 底层存储的数据格式为** 64 位 int**。 From a6dcad5c53a49bfd8bc6ff65b80a79095bf9f55c Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 2 Dec 2022 13:50:28 +0800 Subject: [PATCH 111/132] Update 1.resource-preparations.md (#2372) --- .../1.resource-preparations.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-2.0/4.deployment-and-installation/1.resource-preparations.md b/docs-2.0/4.deployment-and-installation/1.resource-preparations.md index 026812861b..8fc82e8f19 100644 --- a/docs-2.0/4.deployment-and-installation/1.resource-preparations.md +++ b/docs-2.0/4.deployment-and-installation/1.resource-preparations.md @@ -189,8 +189,8 @@ NebulaGraph 是针对 NVMe SSD 进行设计和实现的，所有默认参数都 | -------- | ----------- | | CPU 架构 | x86_64 | | CPU 核数 | 48 | -| 内存 | 96 GB | -| 硬盘 | 2 * 900 GB，NVMe SSD | +| 内存 | 256 GB | +| 硬盘 | 2 * 1.6 TB，NVMe SSD | ### 操作系统要求 @@ -202,7 +202,7 @@ NebulaGraph 是针对 NVMe SSD 进行设计和实现的，所有默认参数都 !!! danger - **不要**跨机房部署集群。 + **不要**跨机房部署单个集群（企业版支持跨机房集群间同步）。 | 进程 | 数量| | ------------------------| ------| From dfc657e4d9c7f672f45c11b406ced0be39e8cf32 Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Fri, 2 Dec 2022 16:28:18 +0800 Subject: [PATCH 112/132] Update 5.lookup.md (#2373) --- docs-2.0/3.ngql-guide/7.general-query-statements/5.lookup.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs-2.0/3.ngql-guide/7.general-query-statements/5.lookup.md b/docs-2.0/3.ngql-guide/7.general-query-statements/5.lookup.md index e8bf1a6cbe..4635a10512 100644 --- a/docs-2.0/3.ngql-guide/7.general-query-statements/5.lookup.md +++ b/docs-2.0/3.ngql-guide/7.general-query-statements/5.lookup.md @@ -59,7 +59,8 @@ YIELD [AS ] - 不支持运算表达式和函数表达式中嵌套 AliasProp 表达式。 - 不支持 XOR 运算符。 - 不支持除`STARTS WITH`之外的字符串操作。 -- 不支持图模式 +- 不支持过滤 `rank()`。 +- 不支持图模式. ## 检索点 From 63bee9331f0cb718f23937151aa57fdffc2f4534 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Fri, 2 Dec 2022 18:01:35 +0800 Subject: [PATCH 113/132] Update 10.create-schema.md --- docs-2.0/nebula-explorer/db-management/10.create-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/db-management/10.create-schema.md b/docs-2.0/nebula-explorer/db-management/10.create-schema.md index 99f96b8357..86c2ceda28 100644 --- a/docs-2.0/nebula-explorer/db-management/10.create-schema.md +++ b/docs-2.0/nebula-explorer/db-management/10.create-schema.md @@ -58,7 +58,7 @@ Explorer 支持界面化方式管理 Schema。 3. 设置参数。参数介绍参见[CREATE INDEX](../../3.ngql-guide/14.native-index-statements/1.create-native-index.md)。 - !!! Note + !!! Note 索引属性的顺序会影响 `LOOKUP` 语句的查询结果。详情参见 [LOOKUP](../../3.ngql-guide/7.general-query-statements/5.lookup.md)。 From d12834bd8d5c9a71eb7d3d902edcb2b9a28b5945 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Mon, 5 Dec 2022 11:01:56 +0800 Subject: [PATCH 114/132] Update source_connect-to-nebula-graph.md (#2374) --- docs-2.0/reuse/source_connect-to-nebula-graph.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/reuse/source_connect-to-nebula-graph.md b/docs-2.0/reuse/source_connect-to-nebula-graph.md index ba8ba78f95..3757de9c58 100644 --- a/docs-2.0/reuse/source_connect-to-nebula-graph.md +++ b/docs-2.0/reuse/source_connect-to-nebula-graph.md @@ -2,7 +2,7 @@ !!! caution - 首次连接到 NebulaGraph 后，必须先[注册 Storage 服务](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts.md)，才能正常查询数据。 + 首次连接到 NebulaGraph 后，必须先[注册 Storage 服务](../4.deployment-and-installation/connect-to-nebula-graph.md)，才能正常查询数据。 NebulaGraph 支持多种类型的客户端，包括命令行客户端、可视化界面客户端和流行编程语言客户端。详情参见[客户端列表](https://docs.nebula-graph.com.cn/{{nebula.release}}/14.client/1.nebula-client/)。 From e6bda5b18bbce198f16c835882ff0dbf0ead1cfd Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 6 Dec 2022 13:37:54 +0800 Subject: [PATCH 115/132] Update ex-ug-what-is-explorer.md --- .../nebula-explorer/about-explorer/ex-ug-what-is-explorer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md b/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md index 219474be6f..2b63de135a 100644 --- a/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md +++ b/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md @@ -1,6 +1,6 @@ # 什么是 NebulaGraph Explorer -NebulaGraph Explorer （简称 Explorer）是一款可以通过 Web 访问的可视化图探索工具，搭配 NebulaGraph 内核使用，用于与图数据进行可视化交互。即使没有图数据操作经验，用户也可以快速成为图专家。 +NebulaGraph Explorer （简称 Explorer）是一款可以通过 Web 访问的可视化图探索工具，搭配 NebulaGraph 内核使用，用于与图数据进行可视化交互。即使没有图数据操作经验，用户也可以快速成为图专家。 !!! enterpriseonly From 1b11cb0596190d622585c372a12ff03b0a6a6600 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Tue, 6 Dec 2022 15:24:25 +0800 Subject: [PATCH 116/132] exchange update faq (#2376) --- docs-2.0/nebula-exchange/ex-ug-FAQ.md | 4 ++-- .../parameter-reference/ex-ug-para-import-command.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-2.0/nebula-exchange/ex-ug-FAQ.md b/docs-2.0/nebula-exchange/ex-ug-FAQ.md index d09f114b23..84b43bfa04 100644 --- a/docs-2.0/nebula-exchange/ex-ug-FAQ.md +++ b/docs-2.0/nebula-exchange/ex-ug-FAQ.md @@ -46,9 +46,9 @@ ## 执行问题 -### Q：Yarn-Cluster 模式下如何提交？ +### Q：报错`java.lang.ClassNotFoundException: com.vesoft.nebula.exchange.Exchange` -在 Yarn-Cluster 模式下提交任务，请参考如下命令： +在 Yarn-Cluster 模式下提交任务，请参考如下命令，**尤其是示例中的两个**`--conf`： ```bash $SPARK_HOME/bin/spark-submit --class com.vesoft.nebula.exchange.Exchange \ diff --git a/docs-2.0/nebula-exchange/parameter-reference/ex-ug-para-import-command.md b/docs-2.0/nebula-exchange/parameter-reference/ex-ug-para-import-command.md index d2ed7b58ac..8c0d170d24 100644 --- a/docs-2.0/nebula-exchange/parameter-reference/ex-ug-para-import-command.md +++ b/docs-2.0/nebula-exchange/parameter-reference/ex-ug-para-import-command.md @@ -19,9 +19,9 @@ !!! note JAR 文件版本号以实际编译得到的 JAR 文件名称为准。 -!!! note +!!! faq - 如果使用 [yarn-cluster 模式](https://spark-reference-doc-cn.readthedocs.io/zh_CN/latest/deploy-guide/running-on-yarn.html)提交任务，请参考如下示例： + 如果使用 [yarn-cluster 模式](https://spark-reference-doc-cn.readthedocs.io/zh_CN/latest/deploy-guide/running-on-yarn.html)提交任务，请参考如下示例，，**尤其是示例中的两个**`--conf`。 ```bash $SPARK_HOME/bin/spark-submit --master yarn-cluster \ From 5e0e119b057db236e4a98f589f174c599f0ee5a0 Mon Sep 17 00:00:00 2001 From: "abby.huang" <78209557+abby-cyber@users.noreply.github.com> Date: Tue, 6 Dec 2022 17:21:01 +0800 Subject: [PATCH 117/132] Update 2.compile-br.md (#2377) --- docs-2.0/backup-and-restore/nebula-br/2.compile-br.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md b/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md index 6c08917956..66c1ba3f4a 100644 --- a/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md +++ b/docs-2.0/backup-and-restore/nebula-br/2.compile-br.md @@ -11,6 +11,7 @@ |NebulaGraph 社区版|BR 社区版 |Agent | |:---|:---|:---| |3.3.0|3.3.0|0.2.0| +|3.0.x ~ 3.2.x|0.6.1|0.1.0 ~ 0.2.0| ## 安装 BR @@ -139,4 +140,4 @@ NebulaGraph Agent 以二进制形式存在各个机器的安装目录中，通 ### 报错`E_LIST_CLUSTER_NO_AGENT_FAILURE` -如果操作过程中遇见`E_LIST_CLUSTER_NO_AGENT_FAILURE`错误，可能是由于 Agent 服务没有启动或者 Agent 服务没有被注册至 Meta 服务。首先执行`SHOW HOSTS AGENT`查看集群上所有节点的 Agent 服务的状态，当时状态显示为`OFFLINE`时表示注册 Agent 失败， 然后检查启动 Agent 服务的命令中的`--meta`参数是否正确。 \ No newline at end of file +如果操作过程中遇见`E_LIST_CLUSTER_NO_AGENT_FAILURE`错误，可能是由于 Agent 服务没有启动或者 Agent 服务没有被注册至 Meta 服务。首先执行`SHOW HOSTS AGENT`查看集群上所有节点的 Agent 服务的状态，当时状态显示为`OFFLINE`时表示注册 Agent 失败， 然后检查启动 Agent 服务的命令中的`--meta`参数是否正确。 From 8a48fd283af3ac0b22e26533bea71abf3d4c801b Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 7 Dec 2022 09:39:58 +0800 Subject: [PATCH 118/132] dashboard release 3.2.4 (#2378) --- .../20.appendix/release-notes/dashboard-ent-release-note.md | 6 ++++++ docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md | 2 +- mkdocs.yml | 4 ++-- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md index b1b8edd0f8..68ab64e9b8 100644 --- a/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md +++ b/docs-2.0/20.appendix/release-notes/dashboard-ent-release-note.md @@ -1,5 +1,11 @@ # NebulaGraph Dashboard 企业版更新说明 +## 企业版 v3.2.4 + +- 优化 + + - 安装 NebulaGraph 企业版 3.1.3 或 3.4 时，默认关闭实验性功能。 + ## 企业版 v3.2.3 - 优化 diff --git a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md index f47863e9dc..957bf85eb0 100644 --- a/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md +++ b/docs-2.0/nebula-dashboard-ent/1.what-is-dashboard-ent.md @@ -45,7 +45,7 @@ NebulaGraph 的版本和 Dashboard 企业版的版本对应关系如下。 |NebulaGraph 版本|Dashboard 版本| |:---|:---| -|3.3.0 |3.2.3、3.2.2、3.2.1、3.2.0| +|3.3.0 |3.2.4、3.2.3、3.2.2、3.2.1、3.2.0| |2.5.0 ~ 3.2.0|3.1.2、3.1.1、3.1.0| |2.5.x ~ 3.1.0|3.0.4| |2.5.1 ~ 3.0.0|1.1.0| diff --git a/mkdocs.yml b/mkdocs.yml index 527673b1d2..d2c2de0480 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -192,8 +192,8 @@ extra: base100: 1.0.0 branch: release-3.2 dashboard_ent: - release: 3.2.3 - tag: v3.2.3 + release: 3.2.4 + tag: v3.2.4 branch: release-3.2 console: release: 3.3.1 From 01ec90fc351da9c75f669c1e937dfab6b2758558 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Wed, 7 Dec 2022 10:26:33 +0800 Subject: [PATCH 119/132] explorer release 3.2.1 (#2379) --- docs-2.0/20.appendix/release-notes/explorer-release-note.md | 6 ++++++ .../about-explorer/ex-ug-what-is-explorer.md | 2 +- mkdocs.yml | 4 ++-- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs-2.0/20.appendix/release-notes/explorer-release-note.md b/docs-2.0/20.appendix/release-notes/explorer-release-note.md index a79d43abee..b6fbb2a1ca 100644 --- a/docs-2.0/20.appendix/release-notes/explorer-release-note.md +++ b/docs-2.0/20.appendix/release-notes/explorer-release-note.md @@ -1,5 +1,11 @@ # NebulaGraph Explorer 版本更新说明 +## v3.2.1 + +- 缺陷修复 + - 修复连接不存在的地址时超时并报 HTTP 错误`500`的问题。 + - 修复随机导入节点时画布上无法显示节点属性的问题。 + ## v3.2.0 - 功能 diff --git a/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md b/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md index 2b63de135a..cc786aed4b 100644 --- a/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md +++ b/docs-2.0/nebula-explorer/about-explorer/ex-ug-what-is-explorer.md @@ -47,7 +47,7 @@ NebulaGraph 的版本和 Explorer 版本对应关系如下。 | NebulaGraph 版本 | Explorer 版本 | | --- | --- | -| 3.3.0 | 3.2.0| +| 3.3.0 | 3.2.1、3.2.0| | 3.1.0 ~ 3.2.x| 3.1.0| | 3.0.0 ~ 3.1.0 | 3.0.0 | | 2.5.x ~ 3.0.0| 2.2.0| diff --git a/mkdocs.yml b/mkdocs.yml index d2c2de0480..e3fb18f67c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -151,9 +151,9 @@ extra: release: 3.5.0 tag: v3.5.0 explorer: - release: 3.2.0 + release: 3.2.1 branch: release-3.2 - tag: v3.2.0 + tag: v3.2.1 exchange_ent: release: 3.0.0 branch: v3.0.0 From 96cb5cefeb7fa860dff7c242328c74a25dc33e3b Mon Sep 17 00:00:00 2001 From: foesa <35463247+foesa-yang@users.noreply.github.com> Date: Wed, 7 Dec 2022 14:45:08 +0800 Subject: [PATCH 120/132] Update algorithm-description.md (#2380) --- docs-2.0/graph-computing/algorithm-description.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-2.0/graph-computing/algorithm-description.md b/docs-2.0/graph-computing/algorithm-description.md index f24c2f8d30..8a0e767bb4 100644 --- a/docs-2.0/graph-computing/algorithm-description.md +++ b/docs-2.0/graph-computing/algorithm-description.md @@ -194,7 +194,7 @@ DegreeWithTime 算法是基于边的时间范围统计邻居，查找出图中 ### BetweennessCentrality -BetweennessCentrality（中介中心性）算法是一种检测点对图中信息流的影响量的方法，用于查找从图的一部分到另一部分时作为桥梁的点。每个点都会根据通过该点的最短路径的数量获得一个分数，即中介中心性分数。 +BetweennessCentrality（介数中心性）算法是一种检测点对图中信息流的影响量的方法，用于查找从图的一部分到另一部分时作为桥梁的点。每个点都会根据通过该点的最短路径的数量获得一个分数，即介数中心性分数。 参数说明如下。 @@ -222,7 +222,7 @@ BetweennessCentrality（中介中心性）算法是一种检测点对图中信 |参数|类型|说明| |:--|:--|:--| |`VID`|创建图空间时`vid_type`决定| 点 ID。| - |`VALUE`|double| 点的中介中心性分数。| + |`VALUE`|double| 点的介数中心性分数。| ### ClosenessCentrality @@ -741,4 +741,4 @@ Jaccard（杰卡德相似度）算法用于计算两个点（或集合）的相 |:--|:--|:--| |`VID1`|创建图空间时`vid_type`决定| 第一个点的 ID。| |`VID2`|创建图空间时`vid_type`决定| 第二个点的 ID。| - |`VALUE`|double| `VID1`和`VID2`的相似度。| \ No newline at end of file + |`VALUE`|double| `VID1`和`VID2`的相似度。| From b9369d9822b2ffec738edfea867fdac119592fd5 Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Wed, 7 Dec 2022 15:12:00 +0800 Subject: [PATCH 121/132] Fix broken link --- docs-2.0/reuse/source_connect-to-nebula-graph.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs-2.0/reuse/source_connect-to-nebula-graph.md b/docs-2.0/reuse/source_connect-to-nebula-graph.md index 3757de9c58..6f3316670d 100644 --- a/docs-2.0/reuse/source_connect-to-nebula-graph.md +++ b/docs-2.0/reuse/source_connect-to-nebula-graph.md @@ -1,14 +1,16 @@ 本文介绍如何使用原生命令行客户端 Nebula Console 连接 NebulaGraph。 + + !!! caution - 首次连接到 NebulaGraph 后，必须先[注册 Storage 服务](../4.deployment-and-installation/connect-to-nebula-graph.md)，才能正常查询数据。 + 首次连接到 NebulaGraph 后，必须先[注册 Storage 服务](https://docs.nebula-graph.com.cn/{{nebula.release}}/2.quick-start/3.quick-start-on-premise/3.1add-storage-hosts/)，才能正常查询数据。 NebulaGraph 支持多种类型的客户端，包括命令行客户端、可视化界面客户端和流行编程语言客户端。详情参见[客户端列表](https://docs.nebula-graph.com.cn/{{nebula.release}}/14.client/1.nebula-client/)。 ## 前提条件 -- NebulaGraph 服务已[启动](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/manage-service/)。 +- NebulaGraph 服务已[启动](https://docs.nebula-graph.com.cn/{{nebula.release}}/4.deployment-and-installation/manage-service/)。 - 运行 Nebula Console 的机器和运行 NebulaGraph 的服务器网络互通。 From c38be4676376b4780cf607af720cd3e9822a1c54 Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Wed, 7 Dec 2022 17:28:12 +0800 Subject: [PATCH 122/132] Let it snow --- mkdocs.yml | 2 +- overrides/partials/header.html | 49 ++++++++++++++++++++++++++++++++++ 2 files changed, 50 insertions(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index e3fb18f67c..1288564203 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -28,7 +28,7 @@ theme: name: Switch to light mode features: - navigation.top - - header.autohide + # - header.autohide - content.tabs.link language: 'zh' diff --git a/overrides/partials/header.html b/overrides/partials/header.html index adb60a1dc5..ed0263681b 100644 --- a/overrides/partials/header.html +++ b/overrides/partials/header.html @@ -71,4 +71,53 @@ {% endif %} + + From b4006ce4468ceb7da7e0df5e8399f7af67e5d451 Mon Sep 17 00:00:00 2001 From: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> Date: Thu, 8 Dec 2022 09:44:26 +0800 Subject: [PATCH 123/132] Stop snowing --- overrides/partials/header.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/overrides/partials/header.html b/overrides/partials/header.html index ed0263681b..26a5c10302 100644 --- a/overrides/partials/header.html +++ b/overrides/partials/header.html @@ -71,7 +71,7 @@ {% endif %} - - -->