modify tagless (#2192)

* modify tagless * Update docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md Co-authored-by: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> * Update 1.insert-vertex.md * Update docs-2.0/3.ngql-guide/10.tag-statements/2.drop-tag.md Co-authored-by: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> * Update docs-2.0/3.ngql-guide/12.vertex-statements/1.insert-vertex.md Co-authored-by: randomJoe211 <69501902+randomJoe211@users.noreply.github.com> * Update upgrade-nebula-graph-to-latest.md * Update README.md * update * modify macro Co-authored-by: cooper-lzy <78672629+cooper-lzy@users.noreply.github.com> Co-authored-by: randomJoe211 <69501902+randomJoe211@users.noreply.github.com>
vesoft-inc · Oct 27, 2022 · 5741b12 · 5741b12
1 parent ea79d3e
commit 5741b12
Show file tree

Hide file tree

Showing 5 changed files with 17 additions and 41 deletions.
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
@@ -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
@@ -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/...nt-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md b/...nt-and-installation/3.upgrade-nebula-graph/upgrade-nebula-from-300-to-latest.md
@@ -1,13 +1,17 @@
-# 升级 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 包升级步骤
 
 1. 下载 [RPM/DEB 包](https://github.com/vesoft-inc/nebula-graph/releases/tag/v{{nebula.release}})。
 
 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/...yment-and-installation/3.upgrade-nebula-graph/upgrade-nebula-graph-to-latest.md b/...yment-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 服务中保存的数据。升级数据格式前，务必按照本文**升级准备**部分的说明备份数据。
-
-  命令语法：
-
-  ```
-  <nebula_install_path>/bin/db_upgrader \
-  --src_db_path=<old_storage_data_path> \
-  --dst_db_path=<data_backup_path> \
-  --upgrade_meta_server=<meta_server_ip>:<port>[, <meta_server_ip>:<port> ...] \
-  --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 版本。
-
-  本文示例：
-
-  ```
-  <nebula_install_path>/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
@@ -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 是一款开源的、分布式的、易扩展的原生图数据库，能够承载数千亿个点和数万亿条边的超大规模数据集，并且提供毫秒级查询。