diff --git a/docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md b/docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md index 638d27bc63d..a49df6306f6 100644 --- a/docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md +++ b/docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md @@ -4,12 +4,16 @@ 点可以有一个或多个 Tag。 -- 如果某个点只有一个 Tag,删除这个 Tag 后,该点变为无 Tag 的点。 +- 如果某个点只有一个 Tag,删除这个 Tag 后,用户就**无法访问**这个点,下次 Compaction 操作时会删除该点,但与该点相邻的**边仍然存在**——这会造成悬挂边。 - 如果某个点有多个 Tag,删除其中一个 Tag,仍然可以访问这个点,但是**无法访问**已删除 Tag 所定义的所有属性。 删除 Tag 操作仅删除 Schema 数据,硬盘上的文件或目录不会立刻删除,而是在下一次 Compaction 操作时删除。 +!!! Compatibility + + NebulaGraph {{nebula.release}} 中默认不支持插入无 Tag 的点。如需使用无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。 + ## 前提条件 - 登录的用户必须拥有对应权限才能执行`DROP TAG`语句。详情请参见[内置角色权限](../../7.data-security/1.authentication/3.role-list.md)。 diff --git a/docs-2.0/3.ngql-guide/12.vertex-statements/1.insert-vertex.md b/docs-2.0/3.ngql-guide/12.vertex-statements/1.insert-vertex.md index efd81f21017..21b2fefafea 100644 --- a/docs-2.0/3.ngql-guide/12.vertex-statements/1.insert-vertex.md +++ b/docs-2.0/3.ngql-guide/12.vertex-statements/1.insert-vertex.md @@ -57,7 +57,7 @@ prop_value_list: !!! caution - NebulaGraph {{ nebula.release }} 中支持插入无 Tag 的点。 + NebulaGraph {{nebula.release}} 中默认不支持插入无 Tag 的点。如需使用无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。插入无 Tag 点的命令示例如`INSERT VERTEX VALUES "1":();`。 - `property_name`:需要设置的属性名称。 @@ -78,9 +78,6 @@ prop_value_list: ## 示例 ```ngql -# 插入不包含 Tag 的点。 -nebula> INSERT VERTEX VALUES "1":(); - # 插入不包含属性的点。 nebula> CREATE TAG IF NOT EXISTS t1(); nebula> INSERT VERTEX t1() VALUES "10":(); 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 e6eb24b2882..14c83d76549 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 @@ -1,6 +1,6 @@ -# 升级 NebulaGraph v3.0.x 至 v{{nebula.release}} +# 升级 NebulaGraph v3.x 至 v{{nebula.release}} -NebulaGraph v3.0.x 升级至 v{{nebula.release}},只需要使用 v{{nebula.release}}的 RPM/DEB 包进行升级操作即可,或者[编译 v{{nebula.release}}](../2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md) 之后重新安装。 +NebulaGraph v3.x 升级至 v{{nebula.release}},只需要使用 v{{nebula.release}}的 RPM/DEB 包进行升级操作即可,或者[编译 v{{nebula.release}}](../2.compile-and-install-nebula-graph/1.install-nebula-graph-by-compiling-the-source-code.md) 之后重新安装。 ## RPM/DEB 包升级步骤 @@ -8,6 +8,10 @@ NebulaGraph v3.0.x 升级至 v{{nebula.release}},只需要使用 v{{nebula.rel 2. 停止所有 NebulaGraph 服务。详情请参见[管理 NebulaGraph 服务](../../2.quick-start/3.quick-start-on-premise/5.start-stop-service.md)。建议更新前备份配置文件。 +!!! caution + + 如果用户需要保留无 Tag 的点,在集群内所有 Graph 服务的配置文件(`nebula-graphd.conf`)中新增`--graph_use_vertex_key=true`;在所有 Storage 服务的配置文件(`nebula-storaged.conf`)中新增`--use_vertex_key=true`。 + 3. 执行如下命令升级: - RPM 包 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 3764ec12bcc..24dfc1e2b93 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 @@ -118,45 +118,13 @@ !!! note 如果启动异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。 -5. 使用`bin`目录下的新版 db_upgrader 文件升级数据格式。 - !!! danger - 本步骤不会备份 Storage 服务中保存的数据。升级数据格式前,务必按照本文**升级准备**部分的说明备份数据。 - - 命令语法: - - ``` - /bin/db_upgrader \ - --src_db_path= \ - --dst_db_path= \ - --upgrade_meta_server=:[, : ...] \ - --upgrade_version=2:3 - ``` - - - `old_storage_data_path`代表数据的存储路径,由 Storage 服务配置文件中的`data_path`参数定义。 - - `data_backup_path`代表自定义的数据备份路径。**当前版本该设置不生效,升级数据格式时不会将原有数据备份到任何路径。** - - `meta_server_ip`和`port`分别代表 Meta 服务各节点的 IP 地址和端口号。 - - `2:3`代表从 NebulaGraph 2.x 版本升级到 3.x 版本。 - - 本文示例: - - ``` - /bin/db_upgrader \ - --src_db_path=/usr/local/nebula/data/storage \ - --dst_db_path=/home/vesoft/nebula/data-backup \ - --upgrade_meta_server=192.168.8.132:9559 \ - --upgrade_version=2:3 - ``` - - !!! note - 如果出现异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。 - -6. 启动所有 Graph 和 Storage 服务。 +5. 启动所有 Graph 和 Storage 服务。 !!! note 如果启动异常,放弃本次升级,并在[论坛](https://discuss.nebula-graph.com.cn/)或 [GitHub](https://github.com/vesoft-inc/nebula/issues) 提问。 -7. 连接新版 NebulaGraph,验证服务是否可用、数据是否正常。连接方法参见[连接服务](../connect-to-nebula-graph.md)。 +6. 连接新版 NebulaGraph,验证服务是否可用、数据是否正常。连接方法参见[连接服务](../connect-to-nebula-graph.md)。 目前尚无有效方式判断升级是否完全成功,可用于测试的参考命令如下: diff --git a/docs-2.0/README.md b/docs-2.0/README.md index 74a9a6fe421..fc1f0a8ccb4 100644 --- a/docs-2.0/README.md +++ b/docs-2.0/README.md @@ -9,6 +9,9 @@ 本文档更新时间{{ now().year }}-{{ now().month }}-{{ now().day }},GitHub commit [{{ git.short_commit }}](https://github.com/vesoft-inc/nebula-docs/commits/v{{nebula.release}})。该版本主色系为"深粉色",色号为 #F7A7A0。 +!!! Compatibility + + 在 NebulaGraph 3.2 的版本中,允许存在无 Tag 的点,但从 NebulaGraph 3.3.0 开始默认不支持无 Tag 的点。 NebulaGraph 是一款开源的、分布式的、易扩展的原生图数据库,能够承载数千亿个点和数万亿条边的超大规模数据集,并且提供毫秒级查询。