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/21 11:52:46 UTC
[shardingsphere] branch master updated: Update DistSQL RQL documents (#21684)
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 4900548711b Update DistSQL RQL documents (#21684)
4900548711b is described below
commit 4900548711bfe7eb404ac9e07b10d65245f85549
Author: Zichao <57...@users.noreply.github.com>
AuthorDate: Sat Oct 22 00:52:37 2022 +1300
Update DistSQL RQL documents (#21684)
* Update DistSQL documents
* Update DistSQL documents
---
.../db-discovery/show-db-discovery-heartbeat.cn.md | 73 ++++++++++++++
.../db-discovery/show-db-discovery-heartbeat.en.md | 74 ++++++++++++++
.../db-discovery/show-db-discovery-rule.en.md | 2 +-
.../db-discovery/show-db-discovery-type.cn.md | 74 ++++++++++++++
.../db-discovery/show-db-discovery-type.en.md | 75 ++++++++++++++
.../syntax/rql/rule-query/encrypt/_index.cn.md | 7 ++
.../syntax/rql/rule-query/encrypt/_index.en.md | 7 ++
.../rql/rule-query/encrypt/show-encrypt-rule.cn.md | 88 +++++++++++++++++
.../rql/rule-query/encrypt/show-encrypt-rule.en.md | 90 +++++++++++++++++
.../encrypt/show-encrypt-table-rule.cn.md | 87 ++++++++++++++++
.../encrypt/show-encrypt-table-rule.en.md | 89 +++++++++++++++++
.../show-readwrite-splitting-rule.en.md | 2 +-
.../syntax/rql/rule-query/shadow/_index.cn.md | 7 ++
.../syntax/rql/rule-query/shadow/_index.en.md | 7 ++
.../rql/rule-query/shadow/show-shadow-rule.cn.md | 109 ++++++++++++++++++++
.../rql/rule-query/shadow/show-shadow-rule.en.md | 110 +++++++++++++++++++++
.../rule-query/shadow/show-shadow-table-rule.cn.md | 74 ++++++++++++++
.../rule-query/shadow/show-shadow-table-rule.en.md | 72 ++++++++++++++
.../sharding/show-default-sharding-strategy.en.md | 2 +-
.../sharding/show-sharding-auditors.en.md | 2 +-
.../sharding/show-sharding-key-generator.en.md | 2 +-
.../sharding/show-sharding-table-nodes.en.md | 2 +-
.../show-sharding-table-rules-used algorithm.en.md | 2 +-
.../show-sharding-table-rules-used-auditor.en.md | 2 +-
...w-sharding-table-rules-used-key-generator.en.md | 2 +-
.../sharding/show-unused-sharding-auditors.en.md | 2 +-
.../show-unused-sharding-key-generators.en.md | 2 +-
27 files changed, 1054 insertions(+), 11 deletions(-)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.cn.md
new file mode 100644
index 00000000000..4e6ca54b535
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.cn.md
@@ -0,0 +1,73 @@
++++
+title = "SHOW DB_DISCOVERY HEARTBEATS"
+weight = 4
++++
+
+### 描述
+
+`SHOW DB_DISCOVERY HEARTBEATS` 语法用于查询指定逻辑库中的数据库发现心跳。
+
+### 语法
+
+```
+ShowDatabaseDiscoveryHeartbeats::=
+ 'SHOW' 'DB_DISCOVERY' 'HEARTBEATS' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| ------------------------ | ---------------- |
+| name | 数据库发现心跳名称 |
+| props | 数据库发现心跳参数 |
+
+
+### 示例
+
+- 查询指定逻辑库中的数据库发现心跳
+
+```sql
+SHOW DB_DISCOVERY HEARTBEATS FROM test1;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY HEARTBEATS FROM test1;
++-------------------+---------------------------------+
+| name | props |
++-------------------+---------------------------------+
+| group_0_heartbeat | {keep-alive-cron=0/5 * * * * ?} |
++-------------------+---------------------------------+
+1 row in set (0.00 sec)
+```
+
+- 查询当前逻辑库中的数据库发现心跳
+
+```sql
+SHOW DB_DISCOVERY HEARTBEATS;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY HEARTBEATS;
++-------------------+---------------------------------+
+| name | props |
++-------------------+---------------------------------+
+| group_0_heartbeat | {keep-alive-cron=0/5 * * * * ?} |
++-------------------+---------------------------------+
+1 row in set (0.00 sec)
+```
+
+### 保留字
+
+`SHOW`、`DB_DISCOVERY`、`HEARTBEATS`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.en.md
new file mode 100644
index 00000000000..3b1f278f436
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-heartbeat.en.md
@@ -0,0 +1,74 @@
++++
+title = "SHOW DB_DISCOVERY HEARTBEATS"
+weight = 4
++++
+
+### Description
+
+The `SHOW DB_DISCOVERY HEARTBEATS` syntax is used to query database discovery heartbeats for specified database.
+
+### Syntax
+
+```
+ShowDatabaseDiscoveryType::=
+ 'SHOW' 'DB_DISCOVERY' 'HEARTBEATS' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| ------------------------ | ----------------------------------------|
+| name | Database discovery heartbeat name |
+| props | Database discovery heartbeat properties |
+
+
+
+
+### Example
+
+- Query database discovery heartbeats for specified database.
+
+```sql
+SHOW DB_DISCOVERY HEARTBEATS FROM test1;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY HEARTBEATS FROM test1;
++-------------------+---------------------------------+
+| name | props |
++-------------------+---------------------------------+
+| group_0_heartbeat | {keep-alive-cron=0/5 * * * * ?} |
++-------------------+---------------------------------+
+1 row in set (0.00 sec)
+```
+
+- Query database discovery heartbeats for current database.
+
+```sql
+SHOW DB_DISCOVERY HEARTBEATS;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY HEARTBEATS;
++-------------------+---------------------------------+
+| name | props |
++-------------------+---------------------------------+
+| group_0_heartbeat | {keep-alive-cron=0/5 * * * * ?} |
++-------------------+---------------------------------+
+1 row in set (0.00 sec)
+```
+
+### Reserved word
+
+`SHOW`, `DB_DISCOVERY`, `HEARTBEATS`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.en.md
index 694e581f52e..2c133463665 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.en.md
@@ -70,7 +70,7 @@ mysql> SHOW DB_DISCOVERY RULES;
### Reserved word
-`SHOW`、`DB_DISCOVERY`、`RULES`、`FROM`
+`SHOW`, `DB_DISCOVERY`, `RULES`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.cn.md
new file mode 100644
index 00000000000..0fadb65de86
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.cn.md
@@ -0,0 +1,74 @@
++++
+title = "SHOW DB_DISCOVERY TYPES"
+weight = 3
++++
+
+### 描述
+
+`SHOW DB_DISCOVERY TYPES` 语法用于查询指定逻辑库中的数据库发现类型。
+
+### 语法
+
+```
+ShowDatabaseDiscoveryType::=
+ 'SHOW' 'DB_DISCOVERY' 'TYPES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| ------------------------ | ---------------------- |
+| name | 数据库发现类型名称 |
+| type | 数据库发现类型种类 |
+| props | 数据库发现类型参数 |
+
+
+### 示例
+
+- 查询指定逻辑库中的数据库发现类型
+
+```sql
+SHOW DB_DISCOVERY TYPES FROM test1;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY TYPES FROM test1;
++-------------------+-----------+---------------------------------------------------+
+| name | type | props |
++-------------------+-----------+---------------------------------------------------+
+| group_0_MySQL.MGR | MySQL.MGR | {group-name=667edd3c-02ec-11ea-9bb3-080027e39bd2} |
++-------------------+-----------+---------------------------------------------------+
+1 row in set (0.01 sec)
+```
+
+- 查询当前逻辑库中的数据库发现类型
+
+```sql
+SHOW DB_DISCOVERY TYPES;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY TYPES;
++-------------------+-----------+---------------------------------------------------+
+| name | type | props |
++-------------------+-----------+---------------------------------------------------+
+| group_0_MySQL.MGR | MySQL.MGR | {group-name=667edd3c-02ec-11ea-9bb3-080027e39bd2} |
++-------------------+-----------+---------------------------------------------------+
+1 row in set (0.00 sec)
+```
+
+### 保留字
+
+`SHOW`、`DB_DISCOVERY`、`TYPES`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.en.md
new file mode 100644
index 00000000000..e53bdc468ce
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-type.en.md
@@ -0,0 +1,75 @@
++++
+title = "SHOW DB_DISCOVERY TYPES"
+weight = 3
++++
+
+### Description
+
+The `SHOW DB_DISCOVERY TYPES` syntax is used to query database discovery types for specified database.
+
+### Syntax
+
+```
+ShowDatabaseDiscoveryType::=
+ 'SHOW' 'DB_DISCOVERY' 'TYPES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| ------------------------ | -----------------------------------|
+| name | Database discovery type name |
+| type | Database discovery type category |
+| props | Database discovery type properties |
+
+
+
+
+### Example
+
+- Query database discovery types for specified database.
+
+```sql
+SHOW DB_DISCOVERY TYPES FROM test1;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY TYPES FROM test1;
++-------------------+-----------+---------------------------------------------------+
+| name | type | props |
++-------------------+-----------+---------------------------------------------------+
+| group_0_MySQL.MGR | MySQL.MGR | {group-name=667edd3c-02ec-11ea-9bb3-080027e39bd2} |
++-------------------+-----------+---------------------------------------------------+
+1 row in set (0.01 sec)
+```
+
+- Query database discovery types for current database.
+
+```sql
+SHOW DB_DISCOVERY TYPES;
+```
+
+```sql
+mysql> SHOW DB_DISCOVERY TYPES;
++-------------------+-----------+---------------------------------------------------+
+| name | type | props |
++-------------------+-----------+---------------------------------------------------+
+| group_0_MySQL.MGR | MySQL.MGR | {group-name=667edd3c-02ec-11ea-9bb3-080027e39bd2} |
++-------------------+-----------+---------------------------------------------------+
+1 row in set (0.00 sec)
+```
+
+### Reserved word
+
+`SHOW`, `DB_DISCOVERY`, `TYPES`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.cn.md
new file mode 100644
index 00000000000..5ea090b010c
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.cn.md
@@ -0,0 +1,7 @@
++++
+title = "数据加密"
+weight = 1
+chapter = true
++++
+
+本章节将对数据加密特性的语法进行详细说明。
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.en.md
new file mode 100644
index 00000000000..c4955cb55c9
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/_index.en.md
@@ -0,0 +1,7 @@
++++
+title = "Encrypt"
+weight = 1
+chapter = true
++++
+
+This chapter describes the syntax of encrypt.
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.cn.md
new file mode 100644
index 00000000000..dcccaefd31c
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.cn.md
@@ -0,0 +1,88 @@
++++
+title = "SHOW ENCRYPT RULES"
+weight = 2
++++
+
+### 描述
+
+`SHOW ENCRYPT RULES` 语法用于查询指定逻辑库中的数据加密规则。
+
+### 语法
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'ENCRYPT' 'RULES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| ------------------------- | ------------------ |
+| table | 逻辑表名 |
+| logic_column | 逻辑列名 |
+| logic_data_type | 逻辑列数据类型 |
+| cipher_column | 密文列名 |
+| cipher_data_type | 密文列数据类型 |
+| plain_column | 明文列名 |
+| plain_data_type | 明文列数据类型 |
+| assisted_query_column | 辅助查询列名 |
+| assisted_query_data_type | 辅助查询列数据类型 |
+| encryptor_type | 加密算法类型 |
+| encryptor_props | 加密算法参数 |
+| query_with_cipher_column | 是否使用加密列进行查询 |
+
+### 示例
+
+- 查询指定逻辑库中的数据加密规则
+
+```sql
+SHOW ENCRYPT RULES FROM test1;
+```
+
+```sql
+mysql> SHOW ENCRYPT RULES FROM test1;
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
+| t_encrypt_2 | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | false |
+| t_encrypt_2 | order_id | | order_cipher | | | | | | MD5 | | false |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+4 rows in set (0.00 sec)
+```
+
+- 查询当前逻辑库中的数据加密规则
+
+```sql
+SHOW ENCRYPT RULES;
+```
+
+```sql
+mysql> SHOW ENCRYPT RULES;
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
+| t_encrypt_2 | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | false |
+| t_encrypt_2 | order_id | | order_cipher | | | | | | MD5 | | false |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+4 rows in set (0.00 sec)
+```
+
+### 保留字
+
+`SHOW`、`ENCRYPT`、`RULES`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.en.md
new file mode 100644
index 00000000000..46e44d6aca1
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-rule.en.md
@@ -0,0 +1,90 @@
++++
+title = "SHOW ENCRYPT RULES"
+weight = 2
++++
+
+### Description
+
+The `SHOW ENCRYPT RULES` syntax is used to query encrypt rules for specified database.
+
+### Syntax
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'ENCRYPT' 'RULES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| ------------------------- | ---------------------------------------- |
+| table | Logical table name |
+| logic_column | Logical column name |
+| logic_data_type | Logical column data type |
+| cipher_column | Ciphertext column name |
+| cipher_data_type | Ciphertext column data type |
+| plain_column | Plaintext column name |
+| plain_data_type | Plaintext column data type |
+| assisted_query_column | Assisted query column name |
+| assisted_query_data_type | Assisted query column data type |
+| encryptor_type | Encryption algorithm type |
+| encryptor_props | Encryption algorithm parameter |
+| query_with_cipher_column | Whether to use encrypted column for query |
+
+
+
+
+### Example
+
+- Query encrypt rules for specified database.
+
+```sql
+SHOW ENCRYPT RULES FROM test1;
+```
+
+```sql
+mysql> SHOW ENCRYPT RULES FROM test1;
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
+| t_encrypt_2 | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | false |
+| t_encrypt_2 | order_id | | order_cipher | | | | | | MD5 | | false |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+4 rows in set (0.00 sec)
+```
+
+- Query encrypt rules for current database.
+
+```sql
+SHOW ENCRYPT RULES;
+```
+
+```sql
+mysql> SHOW ENCRYPT RULES;
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
+| t_encrypt_2 | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | false |
+| t_encrypt_2 | order_id | | order_cipher | | | | | | MD5 | | false |
++-------------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+4 rows in set (0.00 sec)
+```
+
+### Reserved word
+
+`SHOW`, `ENCRYPT`, `RULES`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.cn.md
new file mode 100644
index 00000000000..91bfc323062
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.cn.md
@@ -0,0 +1,87 @@
++++
+title = "SHOW ENCRYPT TABLE RULE"
+weight = 3
++++
+
+### 描述
+
+`SHOW ENCRYPT TABLE RULE` 语法用于查询指定逻辑库中指定表的数据加密规则。
+
+### 语法
+
+```
+ShowEncryptTableRule::=
+ 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName('FROM' databaseName)?
+
+tableName ::=
+ identifier
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| ------------------------- | ------------------ |
+| table | 逻辑表名 |
+| logic_column | 逻辑列名 |
+| logic_data_type | 逻辑列数据类型 |
+| cipher_column | 密文列名 |
+| cipher_data_type | 密文列数据类型 |
+| plain_column | 明文列名 |
+| plain_data_type | 明文列数据类型 |
+| assisted_query_column | 辅助查询列名 |
+| assisted_query_data_type | 辅助查询列数据类型 |
+| encryptor_type | 加密算法类型 |
+| encryptor_props | 加密算法参数 |
+| query_with_cipher_column | 是否使用加密列进行查询 |
+
+### 示例
+
+- 查询指定逻辑库中指定表的数据加密规则
+
+```sql
+SHOW ENCRYPT TABLE RULE t_encrypt FROM test1;
+```
+
+```sql
+mysql> SHOW ENCRYPT TABLE RULE t_encrypt FROM test1;
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+2 rows in set (0.00 sec)
+```
+
+- 查询当前逻辑库中指定表的数据加密规则
+
+```sql
+SHOW ENCRYPT TABLE RULE t_encrypt;
+```
+
+```sql
+mysql> SHOW ENCRYPT TABLE RULE t_encrypt;
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+2 rows in set (0.00 sec)
+```
+
+### 保留字
+
+`SHOW`、`ENCRYPT`、`TABLE`、`RULE`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.en.md
new file mode 100644
index 00000000000..4d89d309016
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/encrypt/show-encrypt-table-rule.en.md
@@ -0,0 +1,89 @@
++++
+title = "SHOW ENCRYPT TABLE RULE"
+weight = 3
++++
+
+### Description
+
+The `SHOW ENCRYPT RULE` syntax is used to query encrypt rules for specified table in specified database.
+
+### Syntax
+
+```
+ShowEncryptTableRule::=
+ 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName('FROM' databaseName)?
+
+tableName ::=
+ identifier
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| ------------------------- | ---------------------------------------- |
+| table | Logical table name |
+| logic_column | Logical column name |
+| logic_data_type | Logical column data type |
+| cipher_column | Ciphertext column name |
+| cipher_data_type | Ciphertext column data type |
+| plain_column | Plaintext column name |
+| plain_data_type | Plaintext column data type |
+| assisted_query_column | Assisted query column name |
+| assisted_query_data_type | Assisted query column data type |
+| encryptor_type | Encryption algorithm type |
+| encryptor_props | Encryption algorithm parameter |
+| query_with_cipher_column | Whether to use encrypted column for query |
+
+
+
+
+### Example
+
+- Query encrypt rules for specified table in specified database.
+
+```sql
+SHOW ENCRYPT TABLE RULE t_encrypt FROM test1;
+```
+
+```sql
+mysql> SHOW ENCRYPT TABLE RULE t_encrypt FROM test1;
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+2 rows in set (0.00 sec)
+```
+
+- Query encrypt rules for specified table in current database.
+
+```sql
+SHOW ENCRYPT TABLE RULE t_encrypt;
+```
+
+```sql
+mysql> SHOW ENCRYPT TABLE RULE t_encrypt;
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| table | logic_column | logic_data_type | cipher_column | cipher_data_type | plain_column | plain_data_type | assisted_query_column | assisted_query_data_type | encryptor_type | encryptor_props | query_with_cipher_column |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+| t_encrypt | user_id | | user_cipher | | user_plain | | | | AES | aes-key-value=123456abc | true |
+| t_encrypt | order_id | | order_cipher | | | | | | MD5 | | true |
++-----------+--------------+-----------------+---------------+------------------+--------------+-----------------+-----------------------+--------------------------+----------------+-------------------------+--------------------------+
+2 rows in set (0.00 sec)
+```
+
+### Reserved word
+
+`SHOW`, `ENCRYPT`, `TABLE`, `RULE`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.en.md
index d2c539c5586..aca7424a84c 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.en.md
@@ -70,7 +70,7 @@ mysql> SHOW READWRITE_SPLITTING RULES;
### Reserved word
-`SHOW`、`READWRITE_SPLITTING`、`RULES`、`FROM`
+`SHOW`, `READWRITE_SPLITTING`, `RULES`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.cn.md
new file mode 100644
index 00000000000..7b0b4658b5a
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.cn.md
@@ -0,0 +1,7 @@
++++
+title = "影子库压测"
+weight = 1
+chapter = true
++++
+
+本章节将对影子库压测特性的语法进行详细说明。
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.en.md
new file mode 100644
index 00000000000..3de84d85695
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/_index.en.md
@@ -0,0 +1,7 @@
++++
+title = "Shadow"
+weight = 1
+chapter = true
++++
+
+This chapter describes the syntax of shadow.
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.cn.md
new file mode 100644
index 00000000000..14bd94cae0e
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.cn.md
@@ -0,0 +1,109 @@
++++
+title = "SHOW SHADOW RULE"
+weight = 2
++++
+
+### 描述
+
+`SHOW SHADOW RULE` 语法用于查询指定逻辑库中的影子规则。
+
+### 语法
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'SHADOW' ('RULES'|'RULE' shadowRuleName) ('FROM' databaseName)?
+
+shadowRuleName ::=
+ identifier
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| ------------ | ------------- |
+| rule_name | 规则名称 |
+| source_name | 数据源名称 |
+| shadow_name | 影子数据源名称 |
+| shadow_table | 影子表 |
+
+### 示例
+
+- 查询指定逻辑库中的指定影子规则
+
+```sql
+SHOW SHADOW RULE shadow_rule FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW RULE shadow_rule FROM test1;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+
+- 查询当前逻辑库中的指定影子规则
+
+```sql
+SHOW SHADOW RULE shadow_rule；
+```
+
+```sql
+mysql> SHOW SHADOW RULE shadow_rule;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.01 sec)
+```
+
+- 查询指定逻辑库中的影子规则
+
+```sql
+SHOW SHADOW RULES FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW RULES FROM test1;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+
+- 查询当前逻辑库中的影子规则
+
+```sql
+SHOW SHADOW RULES;
+```
+
+```sql
+mysql> SHOW SHADOW RULES;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+
+### 保留字
+
+`SHOW`、`SHADOW`、`RULE`、`RULES`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.en.md
new file mode 100644
index 00000000000..479e73d0412
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-rule.en.md
@@ -0,0 +1,110 @@
++++
+title = "SHOW SHADOW RULE"
+weight = 2
++++
+
+### Description
+
+The `SHOW SHADOW RULE` syntax is used to query shadow rules for specified database.
+
+### Syntax
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'SHADOW' ('RULES'|'RULE' shadowRuleName) ('FROM' databaseName)?
+
+shadowRuleName ::=
+ identifier
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| ------------ | ---------------------- |
+| rule_name | Shadow rule name |
+| source_name | Data source name |
+| shadow_name | Shadow data source name|
+| shadow_table | Shadow table |
+
+
+
+
+### Example
+
+- Query specified shadow rule in specified database.
+
+```sql
+SHOW SHADOW RULE shadow_rule FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW RULE shadow_rule FROM test1;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+
+- Query specified shadow rule in current database.
+
+```sql
+SHOW SHADOW RULE shadow_rule；
+```
+
+```sql
+mysql> SHOW SHADOW RULE shadow_rule;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.01 sec)
+```
+
+- Query shadow rules for specified database.
+
+```sql
+SHOW SHADOW RULES FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW RULES FROM test1;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+
+- Query shadow rules for current database.
+
+```sql
+SHOW SHADOW RULES;
+```
+
+```sql
+mysql> SHOW SHADOW RULES;
++-------------+-------------+-------------+----------------------+
+| rule_name | source_name | shadow_name | shadow_table |
++-------------+-------------+-------------+----------------------+
+| shadow_rule | ds_0 | ds_1 | t_order_item,t_order |
++-------------+-------------+-------------+----------------------+
+1 row in set (0.00 sec)
+```
+### Reserved word
+
+`SHOW`, `SHADOW`, `RULE`, `RULES`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.cn.md
new file mode 100644
index 00000000000..2267a4925e9
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.cn.md
@@ -0,0 +1,74 @@
++++
+title = "SHOW SHADOW TABLE RULE"
+weight = 3
++++
+
+### 描述
+
+`SHOW SHADOW TABLE RULE` 语法用于查询指定逻辑库中的影子表规则。
+
+### 语法
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'SHADOW' 'TABLE' 'RULES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+| --------------------- | ---------- |
+| shadow_table | 影子表 |
+| shadow_algorithm_name | 影子算法名称 |
+
+### 示例
+
+- 查询指定逻辑库中的影子表规则
+
+```sql
+SHOW SHADOW TABLE RULES FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW TABLE RULES FROM test1;
++--------------+-------------------------------------------------------+
+| shadow_table | shadow_algorithm_name |
++--------------+-------------------------------------------------------+
+| t_order_item | shadow_rule_t_order_item_value_match |
+| t_order | simple_hint_algorithm,shadow_rule_t_order_regex_match |
++--------------+-------------------------------------------------------+
+2 rows in set (0.00 sec)
+```
+
+- 查询当前逻辑库中的影子表规则
+
+```sql
+SHOW SHADOW TABLE RULES;
+```
+
+```sql
+mysql> SHOW SHADOW TABLE RULES;
++--------------+-------------------------------------------------------+
+| shadow_table | shadow_algorithm_name |
++--------------+-------------------------------------------------------+
+| t_order_item | shadow_rule_t_order_item_value_match |
+| t_order | simple_hint_algorithm,shadow_rule_t_order_regex_match |
++--------------+-------------------------------------------------------+
+2 rows in set (0.01 sec)
+```
+
+### 保留字
+
+`SHOW`、`SHADOW`、`TABLE`、`RULES`、`FROM`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.en.md
new file mode 100644
index 00000000000..1125535280f
--- /dev/null
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-table-rule.en.md
@@ -0,0 +1,72 @@
++++
+title = "SHOW SHADOW TABLE RULE"
+weight = 3
++++
+
+### Description
+
+The `SHOW SHADOW TABLE RULE` syntax is used to query shadow table rules for specified database.
+
+### Syntax
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'SHADOW' 'TABLE' 'RULES' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used `DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return value description
+
+| Column | Description |
+| --------------------- | --------------------- |
+| shadow_table | Shadow table |
+| shadow_algorithm_name | Shadow algorithm name |
+
+### Example
+
+- Query shadow table rules for specified database.
+
+```sql
+SHOW SHADOW TABLE RULES FROM test1;
+```
+
+```sql
+mysql> SHOW SHADOW TABLE RULES FROM test1;
++--------------+-------------------------------------------------------+
+| shadow_table | shadow_algorithm_name |
++--------------+-------------------------------------------------------+
+| t_order_item | shadow_rule_t_order_item_value_match |
+| t_order | simple_hint_algorithm,shadow_rule_t_order_regex_match |
++--------------+-------------------------------------------------------+
+2 rows in set (0.00 sec)
+```
+
+- Query shadow table rules for current database.
+
+```sql
+SHOW SHADOW TABLE RULES;
+```
+
+```sql
+mysql> SHOW SHADOW TABLE RULES;
++--------------+-------------------------------------------------------+
+| shadow_table | shadow_algorithm_name |
++--------------+-------------------------------------------------------+
+| t_order_item | shadow_rule_t_order_item_value_match |
+| t_order | simple_hint_algorithm,shadow_rule_t_order_regex_match |
++--------------+-------------------------------------------------------+
+2 rows in set (0.01 sec)
+```
+### Reserved word
+
+`SHOW`, `SHADOW`, `TABLE`, `RULES`, `FROM`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.en.md
index bc5617f38db..cb23adcc8cd 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.en.md
@@ -70,7 +70,7 @@ mysql> SHOW DEFAULT SHARDING STRATEGY;
### Reserved word
-`SHOW`、`DEFAULT`、`SHARDING`、`STRATEGY`、`FROM`
+`SHOW`, `DEFAULT`, `SHARDING`, `STRATEGY`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.en.md
index be0a3e4c854..201c27a89ae 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.en.md
@@ -66,7 +66,7 @@ mysql> SHOW SHARDING AUDITORS;
### Reserved word
-`SHOW`、`SHARDING`、`AUDITORS`、`FROM`
+`SHOW`, `SHARDING`, `AUDITORS`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.en.md
index 12213687658..929563894cf 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.en.md
@@ -65,7 +65,7 @@ mysql> SHOW SHARDING KEY GENERATORS;
### Reserved word
-`SHOW`、`SHARDING`、`KEY`、`GENERATORS`、`FROM`
+`SHOW`, `SHARDING`, `KEY`, `GENERATORS`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.en.md
index 3446c674591..bd77404708a 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.en.md
@@ -65,7 +65,7 @@ mysql> SHOW SHARDING TABLE NODES;
### Reserved word
-`SHOW`、`SHARDING`、`TABLE`、`NODE`、`FROM`
+`SHOW`, `SHARDING`, `TABLE`, `NODE`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.en.md
index 84ceb5364e4..79d4ac65b59 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.en.md
@@ -68,7 +68,7 @@ mysql> SHOW SHARDING TABLE RULES USED ALGORITHM table_inline;
### Reserved word
-`SHOW`、`SHARDING`、`TABLE`、`RULES`、`USED`、`ALGORITHM`、`FROM`
+`SHOW`, `SHARDING`, `TABLE`, `RULES`, `USED`, `ALGORITHM`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.en.md
index 6c2fae149c8..dfcbf230cad 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.en.md
@@ -68,7 +68,7 @@ mysql> SHOW SHARDING TABLE RULES USED AUDITOR sharding_key_required_auditor;
### Reserved word
-`SHOW`、`SHARDING`、`TABLE`、`RULES`、`USED`、`AUDITOR`、`FROM`
+`SHOW`, `SHARDING`, `TABLE`, `RULES`, `USED`, `AUDITOR`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.en.md
index a09a339b8d9..299f9f29adb 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.en.md
@@ -68,7 +68,7 @@ mysql> SHOW SHARDING TABLE RULES USED KEY GENERATOR snowflake_key_generator;
### Reserved word
-`SHOW`、`SHARDING`、`TABLE`、`USED`、`KEY`、`GENERATOR`、`FROM`
+`SHOW`, `SHARDING`, `TABLE`, `USED`, `KEY`, `GENERATOR`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.en.md
index dbfe07b5a77..ce04566d791 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.en.md
@@ -66,7 +66,7 @@ mysql> SHOW UNUSED SHARDING AUDITORS FROM test1;
### Reserved word
-`SHOW`、`UNUSED`、`SHARDING`、`AUDITORS`、`FROM`
+`SHOW`, `UNUSED`, `SHARDING`, `AUDITORS`, `FROM`
### Related links
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.en.md
index c1fec77027a..8349e3e30ea 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.en.md
@@ -66,7 +66,7 @@ mysql> SHOW UNUSED SHARDING KEY GENERATORS;
### Reserved word
-`SHOW`、`UNUSED`、`SHARDING`、`KEY`、`GENERATORS`、`FROM`
+`SHOW`, `UNUSED`, `SHARDING`, `KEY`, `GENERATORS`, `FROM`
### Related links