From 0a747b01b6dbf418bd3501920d2dde9eea2ea352 Mon Sep 17 00:00:00 2001 From: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Date: Thu, 20 Jan 2022 13:35:45 +0800 Subject: [PATCH] disable balance data --- .../2.quick-start/6.cheatsheet-for-ngql-command.md | 11 ++++++++--- docs-2.0/20.appendix/0.FAQ.md | 2 ++ .../2.balance-syntax.md | 6 ++++-- .../4.job-statements.md | 2 ++ docs-2.0/4.deployment-and-installation/5.zone.md | 6 ++++++ .../7.data-security/1.authentication/3.role-list.md | 5 ++++- docs-2.0/8.service-tuning/load-balance.md | 6 ++++++ .../4.cluster-operator/3.cluster-information.md | 7 ++++++- .../4.cluster-operator/4.manage.md | 2 ++ docs-2.0/nebula-dashboard-ent/8.faq.md | 2 ++ mkdocs.yml | 3 ++- 11 files changed, 44 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 c35fe86972a..e01715da575 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 @@ -477,16 +477,17 @@ | 语法 | 说明 | | :-------------------------------- | :----------------------------------------------------------- | + |`BALANCE LEADER`|在当前图空间内所有 Zone 之间启动任务均衡分布 leader。该命令会返回任务 ID。| + + * [作业管理](../3.ngql-guide/18.operation-and-maintenance-statements/4.job-statements.md) | 语法 | 说明 | | -------------------- | ------------------------------------------------------------ | - |`SUBMIT JOB BALANCE IN ZONE`|在当前图空间内每个 Zone 内部启动任务均衡分布分片。| - |`SUBMIT JOB BALANCE ACROSS ZONE`|在当前图空间内所有 Zone 之间启动任务均衡分布分片。| | `SUBMIT JOB COMPACT` | 触发 RocksDB 的长耗时`compact`操作。 | | `SUBMIT JOB FLUSH` | 将内存中的 RocksDB memfile 写入硬盘。 | | `SUBMIT JOB STATS` | 启动一个作业，该作业对当前图空间进行统计。作业完成后，用户可以使用`SHOW STATS`语句列出统计结果。 | @@ -494,6 +495,10 @@ | `SHOW JOBS` | 列出当前图空间内所有未过期的作业。 | | `STOP JOB` | 停止当前图空间内未完成的作业。 | | `RECOVER JOB` | 重新执行当前图空间内失败的作业，并返回已恢复的作业数量。 | + * [终止查询](../3.ngql-guide/18.operation-and-maintenance-statements/6.kill-query.md) diff --git a/docs-2.0/20.appendix/0.FAQ.md b/docs-2.0/20.appendix/0.FAQ.md index 291788f2f6c..63c9924b608 100644 --- a/docs-2.0/20.appendix/0.FAQ.md +++ b/docs-2.0/20.appendix/0.FAQ.md @@ -347,7 +347,9 @@ Nebula Graph {{ nebula.release }} 未提供运维命令以实现自动扩缩容 - storaged 的扩容：（副本数都必须大于 1） 在新机器上准备 storaged 二进制文件和配置文件，在配置文件中修改或增加已在运行的 metad 地址，启动 storaged 进程。 + ### 修改 Host 名称后，旧的 Host 一直显示 `OFFLINE` 怎么办？ diff --git a/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/2.balance-syntax.md b/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/2.balance-syntax.md index e6e03e21c84..8b19c1a9822 100644 --- a/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/2.balance-syntax.md +++ b/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/2.balance-syntax.md @@ -4,18 +4,20 @@ !!! compatibility "历史版本兼容性" - Neubla Graph 3.0.0 新增 Zone 功能导致 Balance 命令发生变化，3.0.0 之前版本的命令不再兼容。 + 不支持`BALANCE DATA`命令。 `BALANCE`语法说明如下。 |语法|说明| |:---|:---| +|`BALANCE LEADER`|在当前图空间内所有 Zone 之间启动任务均衡分布 leader。该命令会返回任务 ID。| + 查看、停止、重启任务，请参见[作业管理](4.job-statements.md)。 diff --git a/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/4.job-statements.md b/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/4.job-statements.md index 0df6299b503..484cccfa26e 100644 --- a/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/4.job-statements.md +++ b/docs-2.0/3.ngql-guide/18.operation-and-maintenance-statements/4.job-statements.md @@ -6,6 +6,7 @@ 所有作业管理命令都需要先选择图空间后才能执行。 + ## SUBMIT JOB COMPACT diff --git a/docs-2.0/4.deployment-and-installation/5.zone.md b/docs-2.0/4.deployment-and-installation/5.zone.md index 38fdb474491..00ea10785ba 100644 --- a/docs-2.0/4.deployment-and-installation/5.zone.md +++ b/docs-2.0/4.deployment-and-installation/5.zone.md @@ -53,9 +53,11 @@ nebula> SHOW ZONES; 将 Storage 节点加入已创建的 Zone。 + ```ngql ADD HOSTS : [,: ...] INTO ZONE ""; @@ -118,9 +120,11 @@ DROP ZONE ""; 合并时将检查所有图空间分片的分布情况，防止同一个分片的不同副本因为合并导致分布在同一个 Zone 中。 + ```ngql MERGE ZONE "" [,"" ...] INTO ""; @@ -136,9 +140,11 @@ MERGE ZONE "default_zone_192.168.10.100_9779","default_zone_192.168.10.101_9779" 将一个 Zone 中的所有 Storage 节点分离至多个新建 Zone。 + ```ngql DIVIDE ZONE "" INTO ""(:) [""(:) ...]; diff --git a/docs-2.0/7.data-security/1.authentication/3.role-list.md b/docs-2.0/7.data-security/1.authentication/3.role-list.md index 7a40151744c..8dcbd3ea43a 100644 --- a/docs-2.0/7.data-security/1.authentication/3.role-list.md +++ b/docs-2.0/7.data-security/1.authentication/3.role-list.md @@ -57,7 +57,6 @@ Nebula Graph 内置了多种角色，说明如下： |权限|God |Admin|DBA|User|Guest|相关语句| |:---|:---|:---|:---|:---|:---|:---| |Read space|Y|Y|Y|Y|Y|`USE`、`DESCRIBE SPACE`| - |Write space|Y|||||`CREATE SPACE`、`DROP SPACE`、`CREATE SNAPSHOT`、`DROP SNAPSHOT`、`BALANCE DATA`、`BALANCE DATA STOP`、`BALANCE DATA REMOVE`、`BALANCE LEADER`、`ADMIN`、`CONFIG`、`INGEST`、`DOWNLOAD`、`BUILD TAG INDEX`、`BUILD EDGE INDEX`| |Read schema|Y|Y|Y|Y|Y|`DESCRIBE TAG`、`DESCRIBE EDGE`、`DESCRIBE TAG INDEX`、`DESCRIBE EDGE INDEX`| |Write schema|Y|Y|Y|||`CREATE TAG`、`ALTER TAG`、`CREATE EDGE`、`ALTER EDGE`、`DROP TAG`、`DELETE TAG`、`DROP EDGE`、`CREATE TAG INDEX`、`CREATE EDGE INDEX`、`DROP TAG INDEX`、`DROP EDGE INDEX`| |Write user|Y|||||`CREATE USER`、`DROP USER`、`ALTER USER`| @@ -66,6 +65,10 @@ Nebula Graph 内置了多种角色，说明如下： |Write data|Y|Y|Y|Y||`INSERT VERTEX`、`UPDATE VERTEX`、`INSERT EDGE`、`UPDATE EDGE`、`DELETE VERTEX`、`DELETE EDGES`、`DELETE TAG`| |Show operations|Y|Y|Y|Y|Y|`SHOW`、`CHANGE PASSWORD`| |Job|Y|Y|Y|Y||`SUBMIT JOB COMPACT`、`SUBMIT JOB FLUSH`、`SUBMIT JOB STATS`、`STOP JOB`、`RECOVER JOB`| + |Write space|Y|||||`CREATE SPACE`、`DROP SPACE`、`CREATE SNAPSHOT`、`DROP SNAPSHOT`、`BALANCE`、`ADMIN`、`CONFIG`、`INGEST`、`DOWNLOAD`、`BUILD TAG INDEX`、`BUILD EDGE INDEX`| + !!! caution diff --git a/docs-2.0/8.service-tuning/load-balance.md b/docs-2.0/8.service-tuning/load-balance.md index 3952c399d41..c9addcb4acc 100644 --- a/docs-2.0/8.service-tuning/load-balance.md +++ b/docs-2.0/8.service-tuning/load-balance.md @@ -2,6 +2,11 @@ 用户可以使用`BALANCE`语句平衡分片和 Raft leader 的分布，或者清空某些 Storage 服务器方便进行维护。详情请参见 [BALANCE](../3.ngql-guide/18.operation-and-maintenance-statements/2.balance-syntax.md)。 +!!! compatibility "历史版本兼容性" + + 不支持`BALANCE DATA`命令。 + + ## 均衡 leader 分布 diff --git a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/3.cluster-information.md b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/3.cluster-information.md index 9a764551c77..f89e284cf95 100644 --- a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/3.cluster-information.md +++ b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/3.cluster-information.md @@ -32,7 +32,12 @@ 选择指定图空间，查看指定图空间的 Partition 分布情况。 ## 服务信息 -展示 Storage 服务的基本信息。用户可以通过右上角的 **Balance Date** 按钮启动任务，均衡分布集群中的所有分片。参数说明如下： + +展示 Storage 服务的基本信息。参数说明如下： + + | 参数 | 说明 | | :--- | :--- | diff --git a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/4.manage.md b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/4.manage.md index 809df778e0f..bf16358f4cb 100644 --- a/docs-2.0/nebula-dashboard-ent/4.cluster-operator/4.manage.md +++ b/docs-2.0/nebula-dashboard-ent/4.cluster-operator/4.manage.md @@ -26,6 +26,7 @@ 单击**停止**/**重启**，会立即中断进行中的任务，可能会导致数据不一致，请在业务低峰期执行该操作。 + ## 更新配置 diff --git a/docs-2.0/nebula-dashboard-ent/8.faq.md b/docs-2.0/nebula-dashboard-ent/8.faq.md index d49a25541a3..ac41bda800f 100644 --- a/docs-2.0/nebula-dashboard-ent/8.faq.md +++ b/docs-2.0/nebula-dashboard-ent/8.faq.md @@ -28,11 +28,13 @@ Nebula Graph 是分布式图数据库，可以支持运行时动态扩展和缩 Meta 服务主要存储 Nebula Graph 数据库中的元数据。一旦 Meta 服务出现问题，整个集群会面临瘫痪风险。且 Meta 处理的数据量较少，一般不会出现扩缩容场景，因此我们直接在 Dashboard 中禁用了操作 Meta，防止出现用户误操作导致集群不可用的情况。 + ## 为什么无法启动 Dashboard（企业版）？ diff --git a/mkdocs.yml b/mkdocs.yml index a85a473d977..173aacdf508 100755 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -485,7 +485,7 @@ nav: - 配置 Nebula Graph 集群: - 自定义 Nebula Graph 集群的配置参数: nebula-operator/8.custom-cluster-configurations/8.1.custom-conf-parameter.md - 回收 PV: nebula-operator/8.custom-cluster-configurations/8.2.pv-reclaim.md - - 均衡扩容后的 Storage 数据: nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md +#banlance-3.1 notice Exclude - 均衡扩容后的 Storage 数据: nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md - 升级 Nebula Graph 集群: nebula-operator/9.upgrade-nebula-cluster.md - 连接 Nebula Graph 数据库: nebula-operator/4.connect-to-nebula-graph-service.md - 故障自愈: nebula-operator/5.operator-failover.md @@ -545,6 +545,7 @@ plugins: - nebula-flink/* - CHANGELOG.md - spark-connector/* + - nebula-operator/8.custom-cluster-configurations/8.3.balance-data-when-scaling-storage.md # Exclude the file with the following file name. # - abc.md # Exclude files with regular expressions (regexes)