You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shardingsphere.apache.org by ji...@apache.org on 2022/10/27 08:17:03 UTC

[shardingsphere] branch master updated: Update doc of DistSQL (#21790)

This is an automated email from the ASF dual-hosted git repository.

jianglongtao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git


The following commit(s) were added to refs/heads/master by this push:
     new 45f1be44982 Update doc of DistSQL (#21790)
45f1be44982 is described below

commit 45f1be449821adba57713531589b953ffa1c4563
Author: jiangML <10...@qq.com>
AuthorDate: Thu Oct 27 16:16:56 2022 +0800

    Update doc of DistSQL (#21790)
    
    * update doc of distsql
    
    * update doc
    
    * update usage doc
---
 docs/document/content/faq/_index.cn.md                       | 10 +++++-----
 docs/document/content/faq/_index.en.md                       | 12 ++++++------
 .../shardingsphere-proxy/distsql/syntax/ral/_index.en.md     | 12 ++++++------
 .../syntax/rdl/rule-definition/readwrite-splitting.en.md     |  2 +-
 .../distsql/syntax/rdl/rule-definition/shadow.cn.md          | 12 ++++++------
 .../distsql/syntax/rdl/rule-definition/shadow.en.md          |  8 ++++----
 .../distsql/syntax/rdl/rule-definition/single-table.cn.md    |  7 ++-----
 .../distsql/syntax/rdl/rule-definition/single-table.en.md    |  7 ++-----
 .../distsql/syntax/rdl/storage-unit-definition.en.md         |  6 +++---
 .../shardingsphere-proxy/distsql/usage/db-discovery.cn.md    |  2 +-
 .../shardingsphere-proxy/distsql/usage/db-discovery.en.md    |  2 +-
 .../shardingsphere-proxy/distsql/usage/encrypt-rule.cn.md    |  2 +-
 .../shardingsphere-proxy/distsql/usage/encrypt-rule.en.md    |  2 +-
 .../distsql/usage/readwirte-splitting-rule.cn.md             |  2 +-
 .../distsql/usage/readwirte-splitting-rule.en.md             |  2 +-
 .../shardingsphere-proxy/distsql/usage/shadow-rule.cn.md     |  2 +-
 .../shardingsphere-proxy/distsql/usage/shadow-rule.en.md     |  2 +-
 .../shardingsphere-proxy/distsql/usage/sharding-rule.cn.md   |  2 +-
 .../shardingsphere-proxy/distsql/usage/sharding-rule.en.md   |  2 +-
 19 files changed, 45 insertions(+), 51 deletions(-)

diff --git a/docs/document/content/faq/_index.cn.md b/docs/document/content/faq/_index.cn.md
index a41f754700a..3dfd9e80b0f 100644
--- a/docs/document/content/faq/_index.cn.md
+++ b/docs/document/content/faq/_index.cn.md
@@ -89,13 +89,13 @@ DROP DATABASE sharding_db;
    - DataGrip:2020.1、2021.1(使用 IDEA/DataGrip 时打开 `introspect using JDBC metadata` 选项)。
    - WorkBench:8.0.25。
 
-### [Proxy] 使用 Navicat 等第三方数据库工具连接 ShardingSphere-Proxy 时,如果 ShardingSphere-Proxy 没有创建 Database 或者没有添加 Resource,连接失败?
+### [Proxy] 使用 Navicat 等第三方数据库工具连接 ShardingSphere-Proxy 时,如果 ShardingSphere-Proxy 没有创建 Database 或者没有添加 Storage Unit,连接失败?
 
 回答:
 
-1. 第三方数据库工具在连接 ShardingSphere-Proxy 时会发送一些 SQL 查询元数据,当 ShardingSphere-Proxy 没有创建 `database` 或者没有添加 `resource` 时,ShardingSphere-Proxy 无法执行 SQL。
-2. 推荐先创建 `database` 和 `resource` 之后再使用第三方数据库工具连接。
-3. 有关 `resource` 的详情请参考。[相关介绍](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/)
+1. 第三方数据库工具在连接 ShardingSphere-Proxy 时会发送一些 SQL 查询元数据,当 ShardingSphere-Proxy 没有创建 `database` 或者没有添加 `storage unit` 时,ShardingSphere-Proxy 无法执行 SQL。
+2. 推荐先创建 `database` 和 `storage unit` 之后再使用第三方数据库工具连接。
+3. 有关 `storage unit` 的详情请参考。[相关介绍](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/)
 
 ## 分片
 
@@ -183,7 +183,7 @@ ShardingSphere 采用 snowflake 算法作为默认的分布式自增主键策略
 
 1. 如需自定义 JDBC 参数,请使用 `urlSource` 的方式定义 `dataSource`。
 2. ShardingSphere 预置了必要的连接池参数,如 `maxPoolSize`、`idleTimeout` 等。如需增加或覆盖参数配置,请在 `dataSource` 中通过 `PROPERTIES` 指定。
-3. 以上规则请参考 [相关介绍](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/)。
+3. 以上规则请参考 [相关介绍](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/)。
 
 ### [DistSQL] 使用 `DistSQL` 删除资源时,出现 `Resource [xxx] is still used by [SingleTableRule]`。
 
diff --git a/docs/document/content/faq/_index.en.md b/docs/document/content/faq/_index.en.md
index 4a1e9e8f4b1..342cd52f2d6 100644
--- a/docs/document/content/faq/_index.en.md
+++ b/docs/document/content/faq/_index.en.md
@@ -95,9 +95,9 @@ Answer:
 
 Answer:
 
-1. Third-party database tools will send some SQL query metadata when connecting to ShardingSphere-Proxy. When ShardingSphere-Proxy does not create a `database` or does not add a `resource`, ShardingSphere-Proxy cannot execute SQL.
-2. It is recommended to create `database` and `resource` first, and then use third-party database tools to connect.
-3. Please refer to [Related introduction](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/) the details about `resource`.
+1. Third-party database tools will send some SQL query metadata when connecting to ShardingSphere-Proxy. When ShardingSphere-Proxy does not create a `Database` or does not add a `Storage Unit`, ShardingSphere-Proxy cannot execute SQL.
+2. It is recommended to create `database` and `storage unit` first, and then use third-party database tools to connect.
+3. Please refer to [Related introduction](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/) the details about `storage unit`.
 
 ## Sharding
 
@@ -186,7 +186,7 @@ Answer:
 
 1. If you need to customize JDBC connection properties, please take the `urlSource` way to define `dataSource`.
 2. ShardingSphere presets necessary connection pool properties, such as `maxPoolSize`, `idleTimeout`, etc. If you need to add or overwrite the properties, please specify it with `PROPERTIES` in the `dataSource`.
-3. Please refer to [Related introduction](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/) for above rules.
+3. Please refer to [Related introduction](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/) for above rules.
 
 ### [DistSQL] How to solve ` Resource [xxx] is still used by [SingleTableRule].` exception when dropping a data source using DistSQL?
 
@@ -195,7 +195,7 @@ Answer:
 1. Resources referenced by rules cannot be deleted
 2. If the resource is only referenced by single table rule, and the user confirms that the restriction can be ignored, the optional parameter ignore single tables can be added to perform forced deletion
 ```
-DROP RESOURCE dataSourceName [, dataSourceName] ... [ignore single tables]
+UNREGISTER STORAGE UNIT storageUnitName [, storageUnitName] ... [ignore single tables]
 ```
 
 ### [DistSQL] How to solve ` Failed to get driver instance for jdbcURL=xxx.` exception when adding a data source using DistSQL?
@@ -204,7 +204,7 @@ Answer:
 
 ShardingSphere Proxy do not have jdbc driver during deployment. Some example of this include `mysql-connector`. To use it otherwise following syntax can be used:
 ```
-ADD RESOURCE dataSourceName [..., dataSourceName]
+REGISTER STORAGE UNIT storageUnit [..., storageUnit]
 ```
 
 ## Other
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/ral/_index.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/ral/_index.en.md
index ecd8f33e56a..9c7b4fa1da9 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/ral/_index.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/ral/_index.en.md
@@ -35,12 +35,12 @@ RAL (Resource & Rule Administration Language) responsible for hint, circuit brea
 
 ## Circuit Breaker
 
-| Statement                                                                                        | Function                           | Example                                                  |
-|:-------------------------------------------------------------------------------------------------|:-----------------------------------|:---------------------------------------------------------|
-| ALTER READWRITE_SPLITTING RULE [ groupName ] (ENABLE / DISABLE) resourceName [FROM databaseName] | Enable or disable read data source | ALTER READWRITE_SPLITTING RULE group_1 ENABLE resource_0 |
-| [ENABLE / DISABLE] COMPUTE NODE instanceId                                                       | Enable or disable proxy instance   | DISABLE COMPUTE NODE instance_1                          |
-| SHOW COMPUTE NODES                                                                               | Query proxy instance information   | SHOW COMPUTE NODES                                       |
-| SHOW STATUS FROM READWRITE_SPLITTING (RULES / RULE groupName) [FROM databaseName]                | Query all read resources status    | SHOW STATUS FROM READWRITE_SPLITTING RULES               |
+| Statement                                                                                           | Function                           | Example                                                  |
+|:----------------------------------------------------------------------------------------------------|:-----------------------------------|:---------------------------------------------------------|
+| ALTER READWRITE_SPLITTING RULE [ groupName ] (ENABLE / DISABLE) storageUnitName [FROM databaseName] | Enable or disable read data source | ALTER READWRITE_SPLITTING RULE group_1 ENABLE read_ds_1  |
+| [ENABLE / DISABLE] COMPUTE NODE instanceId                                                          | Enable or disable proxy instance   | DISABLE COMPUTE NODE instance_1                          |
+| SHOW COMPUTE NODES                                                                                  | Query proxy instance information   | SHOW COMPUTE NODES                                       |
+| SHOW STATUS FROM READWRITE_SPLITTING (RULES / RULE groupName) [FROM databaseName]                   | Query all read resources status    | SHOW STATUS FROM READWRITE_SPLITTING RULES               |
 
 ## Global Rule
 
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/readwrite-splitting.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/readwrite-splitting.en.md
index f68999a2643..fcd7b5cc799 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/readwrite-splitting.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/readwrite-splitting.en.md
@@ -20,7 +20,7 @@ staticReadwriteSplittingRuleDefinition:
     WRITE_STORAGE_UNIT=storageUnitName, READ_STORAGE_UNITS(storageUnitName [, storageUnitName] ... )
 
 dynamicReadwriteSplittingRuleDefinition:
-    AUTO_AWARE_RESOURCE=resourceName [, WRITE_DATA_SOURCE_QUERY_ENABLED=writeDataSourceQueryEnabled]
+    AUTO_AWARE_RESOURCE=autoAwareResourceName [, WRITE_DATA_SOURCE_QUERY_ENABLED=writeDataSourceQueryEnabled]
 
 loadBalancerDefinition:
     TYPE(NAME=loadBalancerType [, PROPERTIES([algorithmProperties] )] )
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.cn.md
index 01260eff9af..3f82fe2b261 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.cn.md
@@ -24,9 +24,9 @@ SHOW DEFAULT SHADOW ALGORITHM
 
 SHOW SHADOW ALGORITHMS
 
-shadowRuleDefinition: ruleName(resourceMapping, shadowTableRule [, shadowTableRule] ...)
+shadowRuleDefinition: ruleName(storageUnitMapping, shadowTableRule [, shadowTableRule] ...)
 
-resourceMapping: SOURCE=resourceName, SHADOW=resourceName
+storageUnitMapping: SOURCE=storageUnitName, SHADOW=storageUnitName
 
 shadowTableRule: tableName(shadowAlgorithm [, shadowAlgorithm] ...)
 
@@ -39,18 +39,18 @@ algorithmProperty: key=value
 
 ### 参数解释
 
-| 名称                  | 数据类型     | 说明         |
+| 名称                 | 数据类型     | 说明          |
 |:--------------------|:-------------|:------------|
 | ruleName            | IDENTIFIER   | 规则名称      |
-| resourceName        | IDENTIFIER   | 数据库名称    |
-| tableName           | IDENTIFIER   | 影子表名称    |
+| storageUnitName     | IDENTIFIER   | 存储单元名称   |
+| tableName           | IDENTIFIER   | 影子表名称     |
 | algorithmName       | IDENTIFIER   | 影子算法名称   |
 | shadowAlgorithmType | STRING       | 影子算法类型   |
 
 ### 注意事项
 
 - 重复的`ruleName`无法被创建;
-- `resourceMapping` 指定源数据库和影子库的映射关系,需使用 RDL 管理的 `resource` ,请参考 [数据源资源](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/);
+- `storageUnitMapping` 指定源数据库和影子库的映射关系,需使用 RDL 管理的 `storage unit` ,请参考 [存储单元](/cn/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/);
 - `shadowAlgorithm` 可同时作用于多个 `shadowTableRule`;
 - `shadowAlgorithmType` 目前支持 `VALUE_MATCH`、`REGEX_MATCH` 和 `SIMPLE_HINT`;
 - `shadowTableRule` 能够被不同的 `shadowRuleDefinition` 复用,因此在执行 `DROP SHADOW RULE` 时,对应的 `shadowTableRule` 不会被移除;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.en.md
index 7d69e2fc485..67a8744f19f 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/shadow.en.md
@@ -24,9 +24,9 @@ SHOW DEFAULT SHADOW ALGORITHM
 
 SHOW SHADOW ALGORITHMS
 
-shadowRuleDefinition: ruleName(resourceMapping, shadowTableRule [, shadowTableRule] ...)
+shadowRuleDefinition: ruleName(storageUnitMapping, shadowTableRule [, shadowTableRule] ...)
 
-resourceMapping: SOURCE=resourceName, SHADOW=resourceName
+storageUnitMapping: SOURCE=storageUnitName, SHADOW=storageUnitName
 
 shadowTableRule: tableName(shadowAlgorithm [, shadowAlgorithm] ...)
 
@@ -41,7 +41,7 @@ algorithmProperty: key=value
 | name                | DateType   | Description           |
 |:--------------------|:-----------|:----------------------|
 | ruleName            | IDENTIFIER | Rule name             |
-| resourceName        | IDENTIFIER | Resource name         |
+| storageUnitName     | IDENTIFIER | Storage unit name     |
 | tableName           | IDENTIFIER | Shadow table name     |
 | algorithmName       | IDENTIFIER | Shadow algorithm name |
 | shadowAlgorithmType | STRING     | Shadow algorithm type | 
@@ -49,7 +49,7 @@ algorithmProperty: key=value
 ### Notes
 
 - Duplicate `ruleName` cannot be created
-- `resourceMapping` specifies the mapping relationship between the source database and the shadow library. You need to use the `resource` managed by RDL, please refer to [resource](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/resource-definition/)
+- `storageUnitMapping` specifies the mapping relationship between the source database and the shadow library. You need to use the `storage unit` managed by RDL, please refer to [storage unit](/en/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition/)
 - `shadowAlgorithm` can act on multiple `shadowTableRule` at the same time
 - `shadowAlgorithmType` currently supports `VALUE_MATCH`, `REGEX_MATCH` and `SIMPLE_HINT`
 - `shadowTableRule` can be reused by different `shadowRuleDefinition`, so when executing `DROP SHADOW RULE`, the corresponding `shadowTableRule` will not be removed
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.cn.md
index f238b01d4f4..f424c011bdb 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.cn.md
@@ -6,12 +6,9 @@ weight = 2
 ## 定义
 
 ```sql
-SET DEFAULT SINGLE TABLE storageUnitDefinition
-
-storageUnitDefinition:
-    STORAGE UNIT = storageUnitName | RANDOM
+SET DEFAULT SINGLE TABLE STORAGE UNIT = (storageUnitName | RANDOM)
 ```
-- `STORAGE UNIT` 需使用 RDL 管理的存储单元。RANDOM 关键字代表随机存储。
+- `storageUnitName` 需使用 RDL 管理的存储单元。`RANDOM` 代表随机存储。
 
 
 ## 示例
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.en.md
index 04ed501cfe4..cfa72fedd3a 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/rule-definition/single-table.en.md
@@ -6,12 +6,9 @@ weight = 2
 ## Definition
 
 ```sql
-SET DEFAULT SINGLE TABLE storageUnitDefinition
-
-storageUnitDefinition:
-    STORAGE UNIT = storageUnitName | RANDOM
+SET DEFAULT SINGLE TABLE STORAGE UNIT = (storageUnitName | RANDOM)
 ```
-- `STORAGE UNIT` needs to use storage unit managed by RDL. The RANDOM keyword stands for random storage.
+- `storageUnitName` needs to use storage unit managed by RDL. The `RANDOM` stands for random storage.
 
 ## Example
 ```sql
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition.en.md
index 80daa63cf48..c7fa4aff598 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/syntax/rdl/storage-unit-definition.en.md
@@ -43,9 +43,9 @@ property:
 - Confirm that the storage unit to be added or altered can be connected, otherwise the operation will not be successful;
 - Duplicate `storageUnitName` is not allowed;
 - `PROPERTIES` is used to customize connection pool parameters, `key` and `value` are both STRING types;
-- `ALTER RESOURCE` is not allowed to change the real data source associated with this storage unit;
-- `ALTER RESOURCE` will switch the connection pool. This operation may affect the ongoing business, please use it with caution;
-- `DROP RESOURCE` will only delete logical storage unit, not real data sources;
+- `ALTER STORAGE UNIT` is not allowed to change the real data source associated with this storage unit;
+- `ALTER STORAGE UNIT` will switch the connection pool. This operation may affect the ongoing business, please use it with caution;
+- `UNREGISTER STORAGE UNIT` will only delete logical storage unit, not real data sources;
 - Storage unit referenced by rules cannot be deleted;
 - If the storage unit is only referenced by `single table rule`, and the user confirms that the restriction can be ignored, the optional parameter `ignore single tables` can be added to perform forced deletion.
 
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.cn.md
index c776e7a37c6..881b7cd9269 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.cn.md
@@ -67,7 +67,7 @@ DROP DB_DISCOVERY TYPE db_discovery_group_0_mgr;
 DROP DB_DISCOVERY HEARTBEAT db_discovery_group_0_heartbeat;
 ```
 
-- 删除数据源
+- 移除数据源
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0,ds_1,ds_2;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.en.md
index fb8ea798e45..af4bb2efacc 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/db-discovery.en.md
@@ -67,7 +67,7 @@ DROP DB_DISCOVERY TYPE db_discovery_group_0_mgr;
 DROP DB_DISCOVERY HEARTBEAT db_discovery_group_0_heartbeat;
 ```
 
-- Drop resource
+- Unregister storage unit
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0,ds_1,ds_2;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.cn.md
index 5e900a06406..fb7a1947a08 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.cn.md
@@ -53,7 +53,7 @@ ALTER ENCRYPT RULE t_encrypt (
 DROP ENCRYPT RULE t_encrypt;
 ```
 
-- 删除数据源
+- 移除数据源
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.en.md
index 014c3d17f86..2e47590e1d0 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/encrypt-rule.en.md
@@ -53,7 +53,7 @@ ALTER ENCRYPT RULE t_encrypt (
 DROP ENCRYPT RULE t_encrypt;
 ```
 
-- Drop resource
+- Unregister storage unit
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.cn.md
index 024511c99bd..595a11876c5 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.cn.md
@@ -49,7 +49,7 @@ TYPE(NAME="random",PROPERTIES("read_weight"="2:0"))
 DROP READWRITE_SPLITTING RULE group_0;
 ```
 
-- 删除数据源
+- 移除数据源
 
 ```sql
 UNREGISTER STORAGE UNIT write_ds,read_ds;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.en.md
index 282d6c29892..1784ebc78aa 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/readwirte-splitting-rule.en.md
@@ -49,7 +49,7 @@ TYPE(NAME="random",PROPERTIES("read_weight"="2:0"))
 DROP READWRITE_SPLITTING RULE group_0;
 ```
 
-- Drop resource
+- Unregister storage unit
 
 ```sql
 UNREGISTER STORAGE UNIT write_ds,read_ds;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.cn.md
index a012e872aa0..36bac24bbac 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.cn.md
@@ -54,7 +54,7 @@ t_order_item(TYPE(NAME="SIMPLE_HINT", PROPERTIES("foo"="bar"))));
 DROP SHADOW RULE group_0;
 ```
 
-- 删除数据源
+- 移除数据源
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0,ds_1,ds_2;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.en.md
index 60989cdbd85..a1724168f82 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/shadow-rule.en.md
@@ -54,7 +54,7 @@ t_order_item(TYPE(NAME="SIMPLE_HINT", PROPERTIES("foo"="bar"))));
 DROP SHADOW RULE group_0;
 ```
 
-- Drop resource
+- Unregister storage unit
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0,ds_1,ds_2;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.cn.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.cn.md
index d36fb0bd6aa..e9fb27f8935 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.cn.md
@@ -57,7 +57,7 @@ DROP TABLE t_order;
 DROP SHARDING TABLE RULE t_order;
 ```
 
-- 删除数据源
+- 移除数据源
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0, ds_1;
diff --git a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.en.md b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.en.md
index 59c84e20091..407e23951b1 100644
--- a/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.en.md
+++ b/docs/document/content/user-manual/shardingsphere-proxy/distsql/usage/sharding-rule.en.md
@@ -59,7 +59,7 @@ DROP TABLE t_order;
 DROP SHARDING TABLE RULE t_order;
 ```
 
-- Drop resource
+- Unregister storage unit
 
 ```sql
 UNREGISTER STORAGE UNIT ds_0, ds_1;