Detecting schema change (#1339)

vesoft-inc · Dec 29, 2021 · df6de28 · df6de28
1 parent 7cbb1ae
commit df6de28
Show file tree

Hide file tree

Showing 6 changed files with 6 additions and 42 deletions.
diff --git a/docs-2.0/2.quick-start/4.nebula-graph-crud.md b/docs-2.0/2.quick-start/4.nebula-graph-crud.md
@@ -49,7 +49,7 @@ nebula> SHOW HOSTS;
 
 !!! caution
 
-    Nebula Graph 中执行如下创建和修改操作，是异步实现的。要在**下一个**心跳周期之后才能生效；否则访问会报错。
+    Nebula Graph 中执行如下创建和修改操作，是异步实现的。要在**下一个**心跳周期之后才能生效，否则访问会报错。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。
 
 - `CREATE SPACE`
 - `CREATE TAG`
@@ -63,12 +63,6 @@ nebula> SHOW HOSTS;
 
     默认心跳周期是 10 秒。修改心跳周期参数`heartbeat_interval_secs`，请参见[配置简介](../5.configurations-and-logs/1.configurations/1.configurations.md)。
 
-为确保数据同步，后续操作能顺利进行，可采取以下方法之一：
-
-- 执行`SHOW`或`DESCRIBE`命令检查相应对象的状态，确保创建或修改已完成。如果没有完成，请等待几秒重试。
-
-- 等待 2 个心跳周期（20 秒）。
-
 ## 创建和选择图空间
 
 ### nGQL 语法

diff --git a/docs-2.0/3.ngql-guide/10.tag-statements/1.create-tag.md b/docs-2.0/3.ngql-guide/10.tag-statements/1.create-tag.md
@@ -59,12 +59,6 @@ nebula> CREATE TAG IF NOT EXISTS woman(name string, age int, \
 
 ## 创建 Tag 说明
 
-尝试使用新创建的 Tag 可能会失败，因为创建是异步实现的。
-
-Nebula Graph 将在下一个心跳周期内完成 Tag 的创建，为了确保创建成功，可以使用如下方法之一：
-
-- 在 [`SHOW TAGS`](4.show-tags.md) 语句的结果中查找新的 Tag，如果找不到，请等待几秒重试。
-
-- 等待两个心跳周期，例如 20 秒。
+尝试使用新创建的 Tag 可能会失败，因为创建是异步实现的。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。
 
 如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。
diff --git a/docs-2.0/3.ngql-guide/10.tag-statements/3.alter-tag.md b/docs-2.0/3.ngql-guide/10.tag-statements/3.alter-tag.md
@@ -40,12 +40,6 @@ nebula> ALTER TAG t1 COMMENT = 'test1';
 
 ## 修改 Tag 说明
 
-尝试使用刚修改的 Tag 可能会失败，因为修改是异步实现的。
-
-Nebula Graph 将在下一个心跳周期内完成 Tag 的修改，为了确保修改成功，可以使用如下方法之一：
-
-- 在 [`DESCRIBE TAG`](5.describe-tag.md) 语句的结果中查看 Tag 信息，确认修改成功。如果没有修改成功，请等待几秒重试。
-
-- 等待两个心跳周期，例如 20 秒。
+尝试使用刚修改的 Tag 可能会失败，因为修改是异步实现的。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。
 
 如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。
diff --git a/docs-2.0/3.ngql-guide/11.edge-type-statements/3.alter-edge.md b/docs-2.0/3.ngql-guide/11.edge-type-statements/3.alter-edge.md
@@ -40,12 +40,6 @@ nebula> ALTER EDGE e1 COMMENT = 'edge1';
 
 ## 修改 Edge type 说明
 
-尝试使用刚修改的 Edge type 可能会失败，因为修改是异步实现的。
-
-Nebula Graph 将在下一个心跳周期内完成 Edge type 的修改，为了确保修改成功，可以使用如下方法之一：
-
-- 在 [`DESCRIBE EDGE`](5.describe-edge.md) 语句的结果中查看 Edge type 信息，确认修改成功。如果没有修改成功，请等待几秒重试。
-
-- 等待两个心跳周期，例如 20 秒。
+尝试使用刚修改的 Edge type 可能会失败，因为修改是异步实现的。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。
 
 如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。
diff --git a/docs-2.0/3.ngql-guide/14.native-index-statements/1.create-native-index.md b/docs-2.0/3.ngql-guide/14.native-index-statements/1.create-native-index.md
@@ -54,11 +54,7 @@
 
     日常增量写入时保持 `--disable_auto_compaction = false`。
 
-    新创建的索引并不会立刻生效。创建新的索引并尝试立刻使用（例如`LOOKUP`或者`REBUILD INDEX`) 通常会失败（报错`can't find xxx in the space`）。因为创建步骤是异步实现的，Nebula Graph 要在下一个心跳周期才能完成索引的创建。可以使用如下方法之一：
-
-    - 在 [`SHOW TAG/EDGE INDEXES`](2.show-native-indexes.md) 语句的结果中查找到新的索引。或者，
-
-    - 等待两个心跳周期，例如 20 秒。如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。
+    新创建的索引并不会立刻生效。创建新的索引并尝试立刻使用（例如`LOOKUP`或者`REBUILD INDEX`) 通常会失败（报错`can't find xxx in the space`）。因为创建步骤是异步实现的，Nebula Graph 要在下一个心跳周期才能完成索引的创建。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。
 
 !!! danger
 

diff --git a/docs-2.0/3.ngql-guide/9.space-statements/1.create-space.md b/docs-2.0/3.ngql-guide/9.space-statements/1.create-space.md
@@ -87,15 +87,7 @@ nebula> SHOW CREATE SPACE my_space_4;
 
 !!! caution
 
-    立刻尝试使用刚创建的图空间可能会失败，因为创建是异步实现的。
-
-Nebula Graph 将在下一个心跳周期内完成图空间的创建，为了确保创建成功，可以使用如下方法之一：
-
-- 在 [`SHOW SPACES`](3.show-spaces.md) 或 [`DESCRIBE SPACE`](4.describe-space.md) 语句的结果中查找新的图空间，如果找不到，请等待几秒重试。
-
-- 等待两个心跳周期，例如 20 秒。
-
-如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。但过短的心跳周期（<5 秒）可能会导致分布式系统中的机器误判对端失联。
+    立刻尝试使用刚创建的图空间可能会失败，因为创建是异步实现的。为确保数据同步，后续操作能顺利进行，请等待 2 个心跳周期（20 秒）。如果需要修改心跳间隔，请为[所有配置文件](../../5.configurations-and-logs/1.configurations/1.configurations.md)修改参数`heartbeat_interval_secs`。但过短的心跳周期（<5 秒）可能会导致分布式系统中的机器误判对端失联。
 
 ## 检查分片分布情况