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/12/18 14:37:37 UTC
[shardingsphere] branch master updated: Update DistSQL documents (#22945)
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 a61343ef4df Update DistSQL documents (#22945)
a61343ef4df is described below
commit a61343ef4df2ff1888044e1a56d4547b191200e5
Author: Zichao <57...@users.noreply.github.com>
AuthorDate: Mon Dec 19 03:37:31 2022 +1300
Update DistSQL documents (#22945)
* Update DistSQL documents
* Update DistSQL documents
* Update DistSQL documents
* Update DistSQL documents
* Update DistSQL documents
* Update DistSQL documents
* Update DistSQL documents
---
...r-readwrite-splitting-rule-enable-disable.cn.md | 2 +-
...r-readwrite-splitting-rule-enable-disable.en.md | 2 +-
.../enable-disable-compute-node.cn.md | 2 +-
.../enable-disable-compute-node.en.md | 2 +-
.../label-relabel-compute-node.cn.md | 2 +-
.../label-relabel-compute-node.en.md | 2 +-
.../ral/global-rule/alter-sql-parser-rule.cn.md | 6 ++---
.../ral/global-rule/alter-sql-parser-rule.en.md | 6 ++---
.../ral/global-rule/alter-traffic-rule.cn.md | 15 ++++++-----
.../ral/global-rule/alter-traffic-rule.en.md | 15 ++++++-----
.../ral/global-rule/alter-transaction-rule.cn.md | 7 ++++--
.../ral/global-rule/alter-transaction-rule.en.md | 7 ++++--
.../ral/global-rule/create-traffic-rule.cn.md | 15 ++++++-----
.../ral/global-rule/create-traffic-rule.en.md | 15 ++++++-----
.../hint/add-sharding-hint-database-value.cn.md | 4 +--
.../hint/add-sharding-hint-database-value.en.md | 4 +--
.../ral/hint/add-sharding-hint-table-value.cn.md | 4 +--
.../ral/hint/add-sharding-hint-table-value.en.md | 4 +--
.../distsql/syntax/ral/hint/clear-hint.cn.md | 2 +-
.../distsql/syntax/ral/hint/clear-hint.en.md | 2 +-
.../hint/set-readwrite-spitting-hint-source.cn.md | 2 +-
.../hint/set-readwrite-spitting-hint-source.en.md | 2 +-
.../distsql/syntax/ral/hint/show-hint-status.cn.md | 2 +-
.../distsql/syntax/ral/hint/show-hint-status.en.md | 2 +-
.../ral/migration/alter-migration-rule.cn.md | 14 +++++------
.../ral/migration/alter-migration-rule.en.md | 12 ++++-----
.../syntax/ral/migration/migrate-table-into.cn.md | 2 +-
.../register-migration-source-storage-unit.cn.md | 11 +++-----
.../register-migration-source-storage-unit.en.md | 11 +++-----
.../ral/migration/unregister-storage-unit.cn.md | 2 +-
.../ral/migration/unregister-storage-unit.en.md | 4 +--
.../syntax/ral/refresh-table-metadata.cn.md | 2 +-
.../syntax/ral/refresh-table-metadata.en.md | 2 +-
.../distsql/syntax/ral/set-dist-vairable.cn.md | 2 +-
.../distsql/syntax/ral/set-dist-vairable.en.md | 2 +-
.../distsql/syntax/ral/show-dist-variable.cn.md | 2 +-
.../distsql/syntax/ral/show-dist-variable.en.md | 2 +-
.../db-discovery/alter-db-discovery-rule.cn.md | 15 ++++++++---
.../db-discovery/alter-db-discovery-rule.en.md | 15 ++++++++---
.../db-discovery/create-db-discovery-rule.cn.md | 15 ++++++++---
.../db-discovery/create-db-discovery-rule.en.md | 15 ++++++++---
.../db-discovery/drop-db-discovery-rule.cn.md | 2 +-
.../db-discovery/drop-db-discovery-rule.en.md | 2 +-
.../db-discovery/drop-db-discovery-type.cn.md | 2 +-
.../db-discovery/drop-db-discovery-type.en.md | 2 +-
.../encrypt/alter-encrypt-rule.cn.md | 17 ++++++-------
.../encrypt/alter-encrypt-rule.en.md | 17 ++++++-------
.../encrypt/create-encrypt-rule.cn.md | 17 ++++++-------
.../encrypt/create-encrypt-rule.en.md | 17 ++++++-------
.../encrypt/drop-encrypt-rule.cn.md | 2 +-
.../encrypt/drop-encrypt-rule.en.md | 2 +-
.../alter-readwrite-splitting-rule.cn.md | 17 ++++++++++---
.../alter-readwrite-splitting-rule.en.md | 17 ++++++++++---
.../create-readwrite-splitting-rule.cn.md | 17 ++++++++++---
.../create-readwrite-splitting-rule.en.md | 17 ++++++++++---
.../drop-readwrite-splitting-rule.cn.md | 2 +-
.../drop-readwrite-splitting-rule.en.md | 2 +-
.../shadow/alter-default-shadow-algorithm.cn.md | 11 +++++++-
.../shadow/alter-default-shadow-algorithm.en.md | 11 +++++++-
.../rule-definition/shadow/alter-shadow-rule.cn.md | 21 +++++++++++-----
.../rule-definition/shadow/alter-shadow-rule.en.md | 24 ++++++++++++------
.../shadow/create-default-shadow-algorithm.cn.md | 11 +++++++-
.../shadow/create-default-shadow-algorithm.en.md | 11 +++++++-
.../shadow/create-shadow-rule.cn.md | 21 +++++++++++-----
.../shadow/create-shadow-rule.en.md | 21 +++++++++++-----
.../shadow/drop-shadow-algorithm.cn.md | 2 +-
.../shadow/drop-shadow-algorithm.en.md | 2 +-
.../sharding/alter-default-sharding-strategy.cn.md | 19 ++++++++++----
.../sharding/alter-default-sharding-strategy.en.md | 19 ++++++++++----
.../alter-sharding-table-reference-rule.cn.md | 2 +-
.../alter-sharding-table-reference-rule.en.md | 2 +-
.../sharding/alter-sharding-table-rule.cn.md | 25 +++++++++++++------
.../sharding/alter-sharding-table-rule.en.md | 27 +++++++++++++-------
.../create-default-sharding-strategy.cn.md | 19 ++++++++++----
.../create-default-sharding-strategy.en.md | 19 ++++++++++----
.../create-sharding-table-reference-rule.cn.md | 2 +-
.../create-sharding-table-reference-rule.en.md | 2 +-
.../sharding/create-sharding-table-rule.cn.md | 29 ++++++++++++++--------
.../sharding/create-sharding-table-rule.en.md | 29 ++++++++++++++--------
.../set-default-single-table-storage-unit.cn.md | 2 +-
.../set-default-single-table-storage-unit.en.md | 2 +-
.../alter-storage-unit.cn.md | 11 +++-----
.../alter-storage-unit.en.md | 11 +++-----
.../register-storage-unit.cn.md | 9 +++----
.../register-storage-unit.en.md | 9 +++----
.../unregister-storage-unit.cn.md | 2 +-
.../unregister-storage-unit.en.md | 2 +-
.../db-discovery/show-db-discovery-heartbeat.cn.md | 2 +-
.../db-discovery/show-db-discovery-heartbeat.en.md | 2 +-
.../db-discovery/show-db-discovery-rule.cn.md | 2 +-
.../db-discovery/show-db-discovery-rule.en.md | 2 +-
.../db-discovery/show-db-discovery-type.cn.md | 2 +-
.../db-discovery/show-db-discovery-type.en.md | 2 +-
.../rql/rule-query/encrypt/show-encrypt-rule.cn.md | 2 +-
.../rql/rule-query/encrypt/show-encrypt-rule.en.md | 2 +-
.../encrypt/show-encrypt-table-rule.cn.md | 4 +--
.../encrypt/show-encrypt-table-rule.en.md | 4 +--
.../show-readwrite-splitting-rule.cn.md | 2 +-
.../show-readwrite-splitting-rule.en.md | 2 +-
.../rule-query/shadow/show-shadow-algorithm.cn.md | 2 +-
.../rule-query/shadow/show-shadow-algorithm.en.md | 2 +-
.../rql/rule-query/shadow/show-shadow-rule.cn.md | 4 +--
.../rql/rule-query/shadow/show-shadow-rule.en.md | 4 +--
.../rule-query/shadow/show-shadow-table-rule.cn.md | 2 +-
.../rule-query/shadow/show-shadow-table-rule.en.md | 2 +-
.../sharding/show-default-sharding-strategy.cn.md | 2 +-
.../sharding/show-default-sharding-strategy.en.md | 2 +-
.../sharding/show-sharding-algorithms.cn.md | 2 +-
.../sharding/show-sharding-algorithms.en.md | 2 +-
.../sharding/show-sharding-auditors.cn.md | 4 +--
.../sharding/show-sharding-auditors.en.md | 4 +--
.../sharding/show-sharding-key-generator.cn.md | 4 +--
.../sharding/show-sharding-key-generator.en.md | 4 +--
.../sharding/show-sharding-table-nodes.cn.md | 4 +--
.../sharding/show-sharding-table-nodes.en.md | 4 +--
.../show-sharding-table-reference-rules.cn.md | 2 +-
.../show-sharding-table-reference-rules.en.md | 2 +-
.../sharding/show-sharding-table-rule.cn.md | 2 +-
.../sharding/show-sharding-table-rule.en.md | 2 +-
.../show-sharding-table-rules-used algorithm.cn.md | 2 +-
.../show-sharding-table-rules-used algorithm.en.md | 2 +-
.../show-sharding-table-rules-used-auditor.cn.md | 2 +-
.../show-sharding-table-rules-used-auditor.en.md | 2 +-
...w-sharding-table-rules-used-key-generator.cn.md | 2 +-
...w-sharding-table-rules-used-key-generator.en.md | 2 +-
.../sharding/show-unused-sharding-algorithms.cn.md | 2 +-
.../sharding/show-unused-sharding-algorithms.en.md | 2 +-
.../sharding/show-unused-sharding-auditors.cn.md | 4 +--
.../sharding/show-unused-sharding-auditors.en.md | 4 +--
.../show-unused-sharding-key-generators.cn.md | 4 +--
.../show-unused-sharding-key-generators.en.md | 4 +--
.../single-table/count-single-table-rule.cn.md | 2 +-
.../single-table/count-single-table-rule.en.md | 2 +-
.../show-deafult-single-table-storage-unit.cn.md | 2 +-
.../show-deafult-single-table-storage-unit.en.md | 2 +-
.../single-table/show-single-table.cn.md | 2 +-
.../single-table/show-single-table.en.md | 2 +-
.../storage-unit-query/show-storage-units.en.md | 5 +++-
138 files changed, 562 insertions(+), 354 deletions(-)
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.cn.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.cn.md
index 60356e4eedf..360ac7be2aa 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.cn.md
@@ -11,7 +11,7 @@ weight = 2
```sql
AlterReadwriteSplittingRule ::=
- 'ALTER' 'READWRITE_SPLITTING' 'RULE' groupName ( 'ENABLE' | 'DISABLE' ) storageUnitName 'FROM' databaseName
+ 'ALTER' 'READWRITE_SPLITTING' 'RULE' groupName ('ENABLE' | 'DISABLE') storageUnitName 'FROM' databaseName
groupName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.en.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.en.md
index 1dc7885adfd..e5a2f9a2bd1 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/alter-readwrite-splitting-rule-enable-disable.en.md
@@ -11,7 +11,7 @@ The `ALTER READWRITE_SPLITTING RULE ENABLE/DISABLE` syntax is used enable/disabl
```sql
AlterReadwriteSplittingRule ::=
- 'ALTER' 'READWRITE_SPLITTING' 'RULE' groupName ( 'ENABLE' | 'DISABLE' ) storageUnitName 'FROM' databaseName
+ 'ALTER' 'READWRITE_SPLITTING' 'RULE' groupName ('ENABLE' | 'DISABLE') storageUnitName 'FROM' databaseName
groupName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.cn.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.cn.md
index 5ad5f68f5ac..53cda3dc038 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
EnableDisableComputeNode ::=
- ( 'ENABLE' | 'DISABLE' ) 'COMPUTE' 'NODE' instanceId
+ ('ENABLE' | 'DISABLE') 'COMPUTE' 'NODE' instanceId
instanceId ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.en.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.en.md
index 3d140df1ae5..de3d494c44c 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/enable-disable-compute-node.en.md
@@ -11,7 +11,7 @@ The `ENABLE/DISABLE COMPUTE NODE` syntax is used enable/disable a specified prox
```sql
EnableDisableComputeNode ::=
- ( 'ENABLE' | 'DISABLE' ) 'COMPUTE' 'NODE' instanceId
+ ('ENABLE' | 'DISABLE') 'COMPUTE' 'NODE' instanceId
instanceId ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.cn.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.cn.md
index 0c46fb4e834..e84adfd19fc 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.cn.md
@@ -11,7 +11,7 @@ weight = 6
```sql
LableRelabelComputeNodes ::=
- ('LABEL'|'RELABEL') 'COMPUTE' 'NODE' instance_id 'WITH' labelName
+ ('LABEL' | 'RELABEL') 'COMPUTE' 'NODE' instance_id 'WITH' labelName
instance_id ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.en.md b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.en.md
index 09e6af500b8..366aa9a208b 100644
--- a/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/circuit-breaker/label-relabel-compute-node.en.md
@@ -11,7 +11,7 @@ The `LABEL|RELABEL COMPUTE NODES` syntax is used to label `PROXY` instance.
```sql
LableRelabelComputeNodes ::=
- ('LABEL'|'RELABEL') 'COMPUTE' 'NODE' instance_id 'WITH' labelName
+ ('LABEL' | 'RELABEL') 'COMPUTE' 'NODE' instance_id 'WITH' labelName
instance_id ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.cn.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.cn.md
index 3a244f502c1..dd673b665b9 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.cn.md
@@ -11,15 +11,15 @@ weight = 6
```sql
AlterSqlParserRule ::=
- 'ALTER' 'SQL_PARSER' 'RULE' 'SQL_COMMENT_PARSE_ENABLE' '=' sqlCommentParseEnable ',' 'PARSE_TREE_CACHE' parseTreeCacheDefination ',' 'SQL_STATEMENT_CACHE' sqlStatementCacheDefination
+ 'ALTER' 'SQL_PARSER' 'RULE' 'SQL_COMMENT_PARSE_ENABLE' '=' sqlCommentParseEnable ',' 'PARSE_TREE_CACHE' parseTreeCacheDefinition ',' 'SQL_STATEMENT_CACHE' sqlStatementCacheDefinition
sqlCommentParseEnable ::=
boolean
-parseTreeCacheDefination ::=
+parseTreeCacheDefinition ::=
'(' 'INITIAL_CAPACITY' '=' initialCapacity ',' 'MAXIMUM_SIZE' '=' maximumSize ',' 'CONCURRENCY_LEVEL' '=' concurrencyLevel ')'
-sqlStatementCacheDefination ::=
+sqlStatementCacheDefinition ::=
'(' 'INITIAL_CAPACITY' '=' initialCapacity ',' 'MAXIMUM_SIZE' '=' maximumSize ',' 'CONCURRENCY_LEVEL' '=' concurrencyLevel ')'
initialCapacity ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.en.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.en.md
index c6d88071ef8..fc391fe6c2a 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-sql-parser-rule.en.md
@@ -11,15 +11,15 @@ The `ALTER SQL_PARSER RULE` syntax is used to alter sql parser rule configuratio
```sql
AlterSqlParserRule ::=
- 'ALTER' 'SQL_PARSER' 'RULE' 'SQL_COMMENT_PARSE_ENABLE' '=' sqlCommentParseEnable ',' 'PARSE_TREE_CACHE' parseTreeCacheDefination ',' 'SQL_STATEMENT_CACHE' sqlStatementCacheDefination
+ 'ALTER' 'SQL_PARSER' 'RULE' 'SQL_COMMENT_PARSE_ENABLE' '=' sqlCommentParseEnable ',' 'PARSE_TREE_CACHE' parseTreeCacheDefinition ',' 'SQL_STATEMENT_CACHE' sqlStatementCacheDefinition
sqlCommentParseEnable ::=
boolean
-parseTreeCacheDefination ::=
+parseTreeCacheDefinition ::=
'(' 'INITIAL_CAPACITY' '=' initialCapacity ',' 'MAXIMUM_SIZE' '=' maximumSize ',' 'CONCURRENCY_LEVEL' '=' concurrencyLevel ')'
-sqlStatementCacheDefination ::=
+sqlStatementCacheDefinition ::=
'(' 'INITIAL_CAPACITY' '=' initialCapacity ',' 'MAXIMUM_SIZE' '=' maximumSize ',' 'CONCURRENCY_LEVEL' '=' concurrencyLevel ')'
initialCapacity ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.cn.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.cn.md
index 33e8ad0df98..a1a48ead013 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.cn.md
@@ -11,16 +11,19 @@ weight = 8
```sql
AlterTrafficRule ::=
- 'ALTER' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefination ',' loadBalancerDefination ')'
+ 'ALTER' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefinition ',' loadBalancerDefinition ')'
lableName ::=
identifier
-trafficAlgorithmDefination ::=
- 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' = trafficAlgorithmTypeName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+trafficAlgorithmDefinition ::=
+ 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' trafficAlgorithmTypeName (',' propertiesDefinition)? ')' ')'
-loadBalancerDefination ::=
- 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' = loadBalancerName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+loadBalancerDefinition ::=
+ 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' '=' loadBalancerName (',' propertiesDefinition)? ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
trafficAlgorithmTypeName ::=
string
@@ -32,7 +35,7 @@ key ::=
string
value ::=
- string
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.en.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.en.md
index 552bc267e64..a1a7ac9c38f 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-traffic-rule.en.md
@@ -11,16 +11,19 @@ The `ALTER TRAFFIC RULE` syntax is used to alter dual routing rule.
```sql
AlterTrafficRule ::=
- 'ALTER' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefination ',' loadBalancerDefination ')'
+ 'ALTER' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefinition ',' loadBalancerDefinition ')'
lableName ::=
identifier
-trafficAlgorithmDefination ::=
- 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' = trafficAlgorithmTypeName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+trafficAlgorithmDefinition ::=
+ 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' trafficAlgorithmTypeName (',' propertiesDefinition)? ')' ')'
-loadBalancerDefination ::=
- 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' = loadBalancerName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+loadBalancerDefinition ::=
+ 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' '=' loadBalancerName (',' propertiesDefinition)? ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
trafficAlgorithmTypeName ::=
string
@@ -32,7 +35,7 @@ key ::=
string
value ::=
- string
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.cn.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.cn.md
index 240fc4e42a7..ce18f005245 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.cn.md
@@ -11,7 +11,10 @@ weight = 5
```sql
AlterTransactionRule ::=
- 'ALTER' 'TRANSACTION' 'RULE' '(' 'DEFAULT' '=' defaultTransactionType ',' 'TYPE' '(' 'NAME' '=' transactionManager ',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')' ')' ')'
+ 'ALTER' 'TRANSACTION' 'RULE' '(' 'DEFAULT' '=' defaultTransactionType ',' 'TYPE' '(' 'NAME' '=' transactionManager ',' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
defaultTransactionType ::=
string
@@ -23,7 +26,7 @@ key ::=
string
value ::=
- string
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.en.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.en.md
index 42d20c56ccc..37970256fd4 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/alter-transaction-rule.en.md
@@ -11,7 +11,10 @@ The `ALTER TRANSACTION RULE` syntax is used to alter transaction rule configurat
```sql
AlterTransactionRule ::=
- 'ALTER' 'TRANSACTION' 'RULE' '(' 'DEFAULT' '=' defaultTransactionType ',' 'TYPE' '(' 'NAME' '=' transactionManager ',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')' ')' ')'
+ 'ALTER' 'TRANSACTION' 'RULE' '(' 'DEFAULT' '=' defaultTransactionType ',' 'TYPE' '(' 'NAME' '=' transactionManager ',' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
defaultTransactionType ::=
string
@@ -23,7 +26,7 @@ key ::=
string
value ::=
- string
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.cn.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.cn.md
index c3796255853..09b251318cb 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.cn.md
@@ -11,16 +11,19 @@ weight = 7
```sql
CreateTrafficRule ::=
- 'CREATE' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefination ',' loadBalancerDefination ')'
+ 'CREATE' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefinition ',' loadBalancerDefinition ')'
lableName ::=
identifier
-trafficAlgorithmDefination ::=
- 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' = trafficAlgorithmTypeName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+trafficAlgorithmDefinition ::=
+ 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' trafficAlgorithmTypeName (',' propertiesDefinition)? ')' ')'
-loadBalancerDefination ::=
- 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' = loadBalancerName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+loadBalancerDefinition ::=
+ 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' '=' loadBalancerName (',' propertiesDefinition)? ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
trafficAlgorithmTypeName ::=
string
@@ -32,7 +35,7 @@ key ::=
string
value ::=
- string
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.en.md b/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.en.md
index 5edfdc18b73..52731f0cf11 100644
--- a/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/global-rule/create-traffic-rule.en.md
@@ -11,16 +11,19 @@ The `CREATE TRAFFIC RULE` syntax is used to create dual routing rule.
```sql
CreateTrafficRule ::=
- 'CREATE' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefination ',' loadBalancerDefination ')'
+ 'CREATE' 'TRAFFIC' 'RULE' '(' 'LABELS' '(' lableName ')' ',' trafficAlgorithmDefinition ',' loadBalancerDefinition ')'
lableName ::=
identifier
-trafficAlgorithmDefination ::=
- 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' = trafficAlgorithmTypeName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+trafficAlgorithmDefinition ::=
+ 'TRAFFIC_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' trafficAlgorithmTypeName (',' propertiesDefinition)? ')' ')'
-loadBalancerDefination ::=
- 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' = loadBalancerName (',' 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')')? ')' ')'
+loadBalancerDefinition ::=
+ 'LOAD_BALANCER' '(' 'TYPE' '(' 'NAME' '=' loadBalancerName (',' propertiesDefinition)? ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
trafficAlgorithmTypeName ::=
string
@@ -32,7 +35,7 @@ key ::=
string
value ::=
- string
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.cn.md b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.cn.md
index ce1a8c24b26..8bdccfb9c49 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.cn.md
@@ -10,9 +10,9 @@ weight = 4
```sql
AddShardingHintDatabaseValue ::=
- 'ADD' 'SHARDING' 'HINT' 'DATABASE_VALUE' shardingHintDatabaseValueDefination
+ 'ADD' 'SHARDING' 'HINT' 'DATABASE_VALUE' shardingHintDatabaseValueDefinition
- shardingHintDatabaseValueDefination ::=
+ shardingHintDatabaseValueDefinition ::=
tableName '=' databaseShardingValue
tableName ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.en.md b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.en.md
index 6b20e99201f..04dc1b58894 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-database-value.en.md
@@ -11,9 +11,9 @@ The `ADD SHARDING HINT DATABASE_VALUE` syntax is used to add sharding database v
```sql
AddShardingHintDatabaseValue ::=
- 'ADD' 'SHARDING' 'HINT' 'DATABASE_VALUE' shardingHintDatabaseValueDefination
+ 'ADD' 'SHARDING' 'HINT' 'DATABASE_VALUE' shardingHintDatabaseValueDefinition
- shardingHintDatabaseValueDefination ::=
+ shardingHintDatabaseValueDefinition ::=
tableName '=' databaseShardingValue
tableName ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.cn.md b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.cn.md
index afb2037cbdb..c30dca63dd7 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.cn.md
@@ -10,9 +10,9 @@ weight = 5
```sql
AddShardingHintDatabaseValue ::=
- 'ADD' 'SHARDING' 'HINT' 'TABLE_VALUE' shardingHintTableValueDefination
+ 'ADD' 'SHARDING' 'HINT' 'TABLE_VALUE' shardingHintTableValueDefinition
- shardingHintTableValueDefination ::=
+ shardingHintTableValueDefinition ::=
tableName '=' tableShardingValue
tableName ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.en.md b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.en.md
index d692738be6e..bdb3eb491f2 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/add-sharding-hint-table-value.en.md
@@ -11,9 +11,9 @@ The `ADD SHARDING HINT TABLE_VALUE` syntax is used to add table sharding value t
```sql
AddShardingHintDatabaseValue ::=
- 'ADD' 'SHARDING' 'HINT' 'TABLE_VALUE' shardingHintTableValueDefination
+ 'ADD' 'SHARDING' 'HINT' 'TABLE_VALUE' shardingHintTableValueDefinition
- shardingHintTableValueDefination ::=
+ shardingHintTableValueDefinition ::=
tableName '=' tableShardingValue
tableName ::=
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.cn.md b/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.cn.md
index 4446d3134b3..23492afe9c3 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.cn.md
@@ -11,7 +11,7 @@ weight = 6
```sql
ClearHint ::=
- 'CLEAR' ('SHARDING'|'READWRITE_SPLITTING')? 'HINT'
+ 'CLEAR' ('SHARDING' | 'READWRITE_SPLITTING')? 'HINT'
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.en.md b/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.en.md
index 60c1eecabc8..2aa8937781d 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/clear-hint.en.md
@@ -11,7 +11,7 @@ The `CLEAR HINT` syntax is used to clear hint settings for current connection.
```sql
ClearHint ::=
- 'CLEAR' ('SHARDING'|'READWRITE_SPLITTING')? 'HINT'
+ 'CLEAR' ('SHARDING' | 'READWRITE_SPLITTING')? 'HINT'
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.cn.md b/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.cn.md
index 47b045501a0..5eb771d24e6 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.cn.md
@@ -10,7 +10,7 @@ weight = 2
```sql
SetReadwriteSplittingHintSource ::=
- 'SET' 'READWRITE_SPLITTING' 'HINT' 'SOURCE' '='('auto'|'write')
+ 'SET' 'READWRITE_SPLITTING' 'HINT' 'SOURCE' '='('auto' | 'write')
```
### 示例
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.en.md b/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.en.md
index 31e69a668b1..467ebc212e1 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/set-readwrite-spitting-hint-source.en.md
@@ -11,7 +11,7 @@ The `SET READWRITE_SPLITTING HINT SOURCE` syntax is used to set readwrite splitt
```sql
SetReadwriteSplittingHintSource ::=
- 'SET' 'READWRITE_SPLITTING' 'HINT' 'SOURCE' '='('auto'|'write')
+ 'SET' 'READWRITE_SPLITTING' 'HINT' 'SOURCE' '='('auto' | 'write')
```
### Example
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.cn.md b/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.cn.md
index c611b758542..f932f4458d1 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.cn.md
@@ -12,7 +12,7 @@ weight = 7
```sql
ShowHintStatus ::=
- 'SHOW' ('SHARDING'|'READWRITE_SPLITTING') 'HINT' 'STATUS'
+ 'SHOW' ('SHARDING' | 'READWRITE_SPLITTING') 'HINT' 'STATUS'
```
### 示例
diff --git a/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.en.md b/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.en.md
index 203b29b9bcf..6a0187a6c4c 100644
--- a/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/hint/show-hint-status.en.md
@@ -11,7 +11,7 @@ The `SHOW HINT STATUS` syntax is used to query hint settings for current connect
```sql
ShowHintStatus ::=
- 'SHOW' ('SHARDING'|'READWRITE_SPLITTING') 'HINT' 'STATUS'
+ 'SHOW' ('SHARDING' | 'READWRITE_SPLITTING') 'HINT' 'STATUS'
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.cn.md b/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.cn.md
index 7834b8b481c..ec20cc2c2cf 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.cn.md
@@ -11,7 +11,7 @@ weight = 3
```sql
AlterMigrationRule ::=
- 'ALTER' 'MIGRATION' 'RULE' ( '(' (readConfiguration ',')? (writeConfiguration ',')? (dataChannel)? ')' )?
+ 'ALTER' 'MIGRATION' 'RULE' ('(' (readConfiguration ',')? (writeConfiguration ',')? (dataChannel)? ')')?
readConfiguration ::=
'READ' '(' ('WORKER_THREAD' '=' workerThreadPoolSize ',')? ('BATCH_SIZE' '=' batchSize ',')? ('SHARDING_SIZE' '=' shardingSize ',')? (rateLimiter)? ')'
@@ -20,7 +20,7 @@ writeConfiguration ::=
'WRITE' '(' ('WORKER_THREAD' '=' workerThreadPoolSize ',')? ('BATCH_SIZE' '=' batchSize ',')? ('SHARDING_SIZE' '=' shardingSize ',')? (rateLimiter)? ')'
dataChannel ::=
- 'STREAM_CHANNEL' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' 'PROPERTIES' '(' propertyDefinition ')'
+ 'STREAM_CHANNEL' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' propertiesDefinition ')' ')'
workerThreadPoolSize ::=
int
@@ -32,19 +32,19 @@ shardingSize ::=
int
rateLimiter ::=
- 'RATE_LIMITER' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' 'PROPERTIES' '(' propertyDefinition ')'
+ 'RATE_LIMITER' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' propertiesDefinition ')' ')'
algorithmName ::=
string
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
-
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
key ::=
string
value ::=
- string
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.en.md b/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.en.md
index 2ac4f19ffde..efd88bebdd2 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/alter-migration-rule.en.md
@@ -11,7 +11,7 @@ The `ALTER MIGRATION RULE` syntax is used to alter migration rule.
```sql
AlterMigrationRule ::=
- 'ALTER' 'MIGRATION' 'RULE' ( '(' (readConfiguration ',')? (writeConfiguration ',')? (dataChannel)? ')' )?
+ 'ALTER' 'MIGRATION' 'RULE' ('(' (readConfiguration ',')? (writeConfiguration ',')? (dataChannel)? ')')?
readConfiguration ::=
'READ' '(' ('WORKER_THREAD' '=' workerThreadPoolSize ',')? ('BATCH_SIZE' '=' batchSize ',')? ('SHARDING_SIZE' '=' shardingSize ',')? (rateLimiter)? ')'
@@ -20,7 +20,7 @@ writeConfiguration ::=
'WRITE' '(' ('WORKER_THREAD' '=' workerThreadPoolSize ',')? ('BATCH_SIZE' '=' batchSize ',')? ('SHARDING_SIZE' '=' shardingSize ',')? (rateLimiter)? ')'
dataChannel ::=
- 'STREAM_CHANNEL' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' 'PROPERTIES' '(' propertyDefinition ')'
+ 'STREAM_CHANNEL' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' propertiesDefinition ')' ')'
workerThreadPoolSize ::=
int
@@ -32,19 +32,19 @@ shardingSize ::=
int
rateLimiter ::=
- 'RATE_LIMITER' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' 'PROPERTIES' '(' propertyDefinition ')'
+ 'RATE_LIMITER' '(' 'TYPE' '(' 'NAME' '=' algorithmName ',' propertiesDefinition ')' ')'
algorithmName ::=
string
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
key ::=
string
value ::=
- string
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/migrate-table-into.cn.md b/docs/document/content/reference/distsql/syntax/ral/migration/migrate-table-into.cn.md
index 7a8c7a34885..91d1fb17ed7 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/migrate-table-into.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/migrate-table-into.cn.md
@@ -11,7 +11,7 @@ weight = 7
```sql
MigrateTableInto ::=
- 'MIGRATE' 'TABLE' migrationSource '.' tableName 'INTO' (databaseName '.')?tableName
+ 'MIGRATE' 'TABLE' migrationSource '.' tableName 'INTO' (databaseName '.')? tableName
migrationSource ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.cn.md
index 088d64385ed..cf630a7b2a5 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.cn.md
@@ -14,7 +14,7 @@ RegisterStorageUnit ::=
'REGISTER' 'MIGRATION' 'SOURCE' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- StorageUnitName '(' 'URL' '=' url ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ StorageUnitName '(' 'URL' '=' url ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -28,17 +28,14 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' ( key '=' value ) ( ',' key '=' value )* ')'
key ::=
string
value ::=
- string
+ literal
```
### 特别说明
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.en.md
index b10f30409dc..ed7f182e977 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/register-migration-source-storage-unit.en.md
@@ -14,7 +14,7 @@ RegisterStorageUnit ::=
'REGISTER' 'MIGRATION' 'SOURCE' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- StorageUnitName '(' 'URL' '=' url ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ StorageUnitName '(' 'URL' '=' url ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -28,17 +28,14 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' ( key '=' value ) ( ',' key '=' value )* ')'
key ::=
string
value ::=
- string
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.cn.md
index 9da004500d6..dc6c3b3c889 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.cn.md
@@ -11,7 +11,7 @@ weight = 5
```sql
UnregisterMigrationSourceStorageUnit ::=
- 'UNREGISTER' 'MIGRATION' 'SOURCE' 'STORAGE' 'UNIT' storageUnitName ( ',' storageUnitName )*
+ 'UNREGISTER' 'MIGRATION' 'SOURCE' 'STORAGE' 'UNIT' storageUnitName (',' storageUnitName)*
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.en.md
index 955a4ccbe0d..adef8f0fb84 100644
--- a/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/migration/unregister-storage-unit.en.md
@@ -10,8 +10,8 @@ The `UNREGISTER MIGRATION SOURCE STORAGE UNIT` syntax is used to unregister migr
### Syntax
```sql
-UnregisterStorageUnit ::=
- 'DROP' 'STORAGE' 'UNIT' ( 'IF' 'EXISTS' )? storageUnitName ( ',' storageUnitName )*
+UnregisterMigrationSourceStorageUnit ::=
+ 'UNREGISTER' 'MIGRATION' 'SOURCE' 'STORAGE' 'UNIT' storageUnitName (',' storageUnitName)*
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.cn.md b/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.cn.md
index a8ddcf5d531..273daddbddb 100644
--- a/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.cn.md
@@ -11,7 +11,7 @@ weight = 6
```sql
RefreshTableMetadata ::=
- 'REFRESH' 'TABLE' 'METADATA' ( (tableName)? | tableName 'FROM' 'STORAGE' 'UNIT' storageUnitName)?
+ 'REFRESH' 'TABLE' 'METADATA' ((tableName)? | tableName 'FROM' 'STORAGE' 'UNIT' storageUnitName)?
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.en.md b/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.en.md
index 3966ec92cff..6f3448ce4c7 100644
--- a/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/refresh-table-metadata.en.md
@@ -11,7 +11,7 @@ The `REFRESH TABLE METADATA` syntax is used to refresh table metadata.
```sql
RefreshTableMetadata ::=
- 'REFRESH' 'TABLE' 'METADATA' ( (tableName)? | tableName 'FROM' 'STORAGE' 'UNIT' storageUnitName)?
+ 'REFRESH' 'TABLE' 'METADATA' ((tableName)? | tableName 'FROM' 'STORAGE' 'UNIT' storageUnitName)?
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.cn.md b/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.cn.md
index 480b794ddab..13a52b97565 100644
--- a/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
SetDistVariable ::=
- 'SET' 'DIST' 'VARIABLE' ( proxyPropertyName '=' proxyPropertyValue | 'transaction_type' '=' transactionType | 'agent_plugins_enable' '=' agentPluginsEnable )
+ 'SET' 'DIST' 'VARIABLE' (proxyPropertyName '=' proxyPropertyValue | 'transaction_type' '=' transactionType | 'agent_plugins_enable' '=' agentPluginsEnable)
proxyPropertyName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.en.md b/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.en.md
index 9184368f1b0..95a0fcbaffb 100644
--- a/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/set-dist-vairable.en.md
@@ -10,7 +10,7 @@ The `SET DIST VARIABLE` syntax is used to set system variables.
```sql
SetDistVariable ::=
- 'SET' 'DIST' 'VARIABLE' ( proxyPropertyName '=' proxyPropertyValue | 'transaction_type' '=' transactionType | 'agent_plugins_enable' '=' agentPluginsEnable )
+ 'SET' 'DIST' 'VARIABLE' (proxyPropertyName '=' proxyPropertyValue | 'transaction_type' '=' transactionType | 'agent_plugins_enable' '=' agentPluginsEnable)
proxyPropertyName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.cn.md b/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.cn.md
index f7fdc04671b..4b2b18b8444 100644
--- a/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.cn.md
+++ b/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.cn.md
@@ -11,7 +11,7 @@ weight = 5
```sql
ShowDistVariable ::=
- 'SHOW' ('VARIABLES'|'VARIABLE' 'NAME' '=' variableName)
+ 'SHOW' ('VARIABLES' | 'VARIABLE' 'NAME' '=' variableName)
variableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.en.md b/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.en.md
index 5b60ee3542d..86334804a99 100644
--- a/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.en.md
+++ b/docs/document/content/reference/distsql/syntax/ral/show-dist-variable.en.md
@@ -11,7 +11,7 @@ The `SHOW DIST VARIABLE` syntax is used to query `PROXY` system variables config
```sql
ShowDistVariable ::=
- 'SHOW' ('VARIABLES'|'VARIABLE' 'WHERE' 'NAME' '=' variableName)
+ 'SHOW' ('VARIABLES' | 'VARIABLE' 'WHERE' 'NAME' '=' variableName)
variableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.cn.md
index df7f3e06ff6..74fa82712b5 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.cn.md
@@ -11,11 +11,14 @@ weight = 3
```sql
AlterDatabaseDiscoveryRule ::=
- 'ALTER' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition ( ',' databaseDiscoveryDefinition)*
+ 'ALTER' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition (',' databaseDiscoveryDefinition)*
databaseDiscoveryDefinition ::=
- ruleName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'TYPE' '(' 'NAME' '=' typeName ( ',' 'PROPERTIES' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* )? ',' 'HEARTBEAT' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' ')'
-
+ ruleName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'TYPE' '(' 'NAME' '=' typeName (',' propertiesDefinition)? ')' ',' 'HEARTBEAT' '(' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
ruleName ::=
identifier
@@ -27,6 +30,12 @@ typeName ::=
discoveryHeartbeatName ::=
identifier
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.en.md
index 67dd0ab5048..43dbcf8cd01 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/alter-db-discovery-rule.en.md
@@ -11,11 +11,14 @@ The `ALTER DB_DISCOVERY RULE` syntax is used to alter a database discovery rule.
```sql
AlterDatabaseDiscoveryRule ::=
- 'ALTER' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition ( ',' databaseDiscoveryDefinition)*
+ 'ALTER' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition (',' databaseDiscoveryDefinition)*
databaseDiscoveryDefinition ::=
- ruleName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'TYPE' '(' 'NAME' '=' typeName ( ',' 'PROPERTIES' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* )? ',' 'HEARTBEAT' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' ')'
-
+ ruleName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'TYPE' '(' 'NAME' '=' typeName (',' propertiesDefinition)? ')' ',' 'HEARTBEAT' '(' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
ruleName ::=
identifier
@@ -27,6 +30,12 @@ typeName ::=
discoveryHeartbeatName ::=
identifier
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.cn.md
index 88f9324d375..477c3f400a1 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.cn.md
@@ -11,11 +11,14 @@ weight = 2
```sql
CreateDatabaseDiscoveryRule ::=
- 'CREATE' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition ( ',' databaseDiscoveryDefinition)*
+ 'CREATE' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition (',' databaseDiscoveryDefinition)*
databaseDiscoveryDefinition ::=
- ruleName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'TYPE' '(' 'NAME' '=' typeName ( ',' 'PROPERTIES' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* )? ',' 'HEARTBEAT' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' ')'
-
+ ruleName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'TYPE' '(' 'NAME' '=' typeName (',' propertiesDefinition)? ')' ',' 'HEARTBEAT' '(' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
ruleName ::=
identifier
@@ -27,6 +30,12 @@ typeName ::=
discoveryHeartbeatName ::=
identifier
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.en.md
index 29f3f9ddcdb..6aa0a48c7ae 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/create-db-discovery-rule.en.md
@@ -11,11 +11,14 @@ The `CREATE DB_DISCOVERY RULE` syntax is used to create a database discovery rul
```sql
CreateDatabaseDiscoveryRule ::=
- 'CREATE' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition ( ',' databaseDiscoveryDefinition)*
+ 'CREATE' 'DB_DISCOVERY' 'RULE' databaseDiscoveryDefinition (',' databaseDiscoveryDefinition)*
databaseDiscoveryDefinition ::=
- ruleName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'TYPE' '(' 'NAME' '=' typeName ( ',' 'PROPERTIES' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* )? ',' 'HEARTBEAT' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' ')'
-
+ ruleName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'TYPE' '(' 'NAME' '=' typeName (',' propertiesDefinition)? ')' ',' 'HEARTBEAT' '(' propertiesDefinition ')' ')'
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
ruleName ::=
identifier
@@ -27,6 +30,12 @@ typeName ::=
discoveryHeartbeatName ::=
identifier
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.cn.md
index be73c0c8eba..77bc9adacbb 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
DropDatabaseDiscoveryRule ::=
- 'DROP' 'DB_DISCOVERY' 'RULE' dbDiscoveryRuleName (',' dbDiscoveryRuleName)* ('FROM' databaseName)?
+ 'DROP' 'DB_DISCOVERY' 'RULE' dbDiscoveryRuleName (',' dbDiscoveryRuleName)* ('FROM' databaseName)?
dbDiscoveryRuleName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.en.md
index c1ee6a46585..fe838542104 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-rule.en.md
@@ -11,7 +11,7 @@ The `DROP DB_DISCOVERY RULE` syntax is used to drop database discovery rule for
```sql
DropDatabaseDiscoveryRule ::=
- 'DROP' 'DB_DISCOVERY' 'RULE' dbDiscoveryRuleName (',' dbDiscoveryRuleName)* ('FROM' databaseName)?
+ 'DROP' 'DB_DISCOVERY' 'RULE' dbDiscoveryRuleName (',' dbDiscoveryRuleName)* ('FROM' databaseName)?
dbDiscoveryRuleName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.cn.md
index 7f41a4795f9..de03560c455 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.cn.md
@@ -11,7 +11,7 @@ weight = 6
```sql
DropDatabaseDiscoveryType ::=
- 'DROP' 'DB_DISCOVERY' 'TYPE' dbDiscoveryTypeName (',' dbDiscoveryTypeName)* ('FROM' databaseName)?
+ 'DROP' 'DB_DISCOVERY' 'TYPE' dbDiscoveryTypeName (',' dbDiscoveryTypeName)* ('FROM' databaseName)?
dbDiscoveryTypeName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.en.md
index 3055d14cfde..27de5600538 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/db-discovery/drop-db-discovery-type.en.md
@@ -11,7 +11,7 @@ The `DROP DB_DISCOVERY TYPE` syntax is used to drop database discovery type for
```sql
DropDatabaseDiscoveryType ::=
- 'DROP' 'DB_DISCOVERY' 'TYPE' dbDiscoveryTypeName (',' dbDiscoveryTypeName)* ('FROM' databaseName)?
+ 'DROP' 'DB_DISCOVERY' 'TYPE' dbDiscoveryTypeName (',' dbDiscoveryTypeName)* ('FROM' databaseName)?
dbDiscoveryTypeName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.cn.md
index 5dc1e0a3b91..aa9f947674f 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.cn.md
@@ -11,28 +11,25 @@ weight = 3
```sql
AlterEncryptRule ::=
- 'ALTER' 'ENCRYPT' 'RULE' encryptDefinition ( ',' encryptDefinition )*
+ 'ALTER' 'ENCRYPT' 'RULE' encryptDefinition (',' encryptDefinition)*
encryptDefinition ::=
- ruleName '(' 'COLUMNS' '(' columnDefinition ( ',' columnDefinition )* ')' ( ',' 'QUERY_WITH_CIPHER_COLUMN' '=' ( 'TRUE' | 'FALSE' ) )? ')'
+ ruleName '(' 'COLUMNS' '(' columnDefinition (',' columnDefinition)* ')' (',' 'QUERY_WITH_CIPHER_COLUMN' '=' ('TRUE' | 'FALSE'))? ')'
columnDefinition ::=
- '(' 'NAME' '=' columnName ( ',' 'PLAIN' '=' plainColumnName )? ',' 'CIPHER' '=' cipherColumnName ( ',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName )? ( ',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName )? ',' encryptAlgorithmDefinition ( ',' assistedQueryAlgorithmDefinition )? ( ',' likeQueryAlgorithmDefinition )? ')'
+ '(' 'NAME' '=' columnName (',' 'PLAIN' '=' plainColumnName)? ',' 'CIPHER' '=' cipherColumnName (',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName)? (',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName)? ',' encryptAlgorithmDefinition (',' assistedQueryAlgorithmDefinition)? (',' likeQueryAlgorithmDefinition)? ')'
encryptAlgorithmDefinition ::=
- 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
assistedQueryAlgorithmDefinition ::=
- 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
likeQueryAlgorithmDefinition ::=
- 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
propertiesDefinition ::=
- 'PROPERTIES' '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.en.md
index 4168e5c1c33..e0bb5dc6f82 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/alter-encrypt-rule.en.md
@@ -11,28 +11,25 @@ The `ALTER ENCRYPT RULE` syntax is used to alter an encryption rule.
```sql
AlterEncryptRule ::=
- 'ALTER' 'ENCRYPT' 'RULE' encryptDefinition ( ',' encryptDefinition )*
+ 'ALTER' 'ENCRYPT' 'RULE' encryptDefinition (',' encryptDefinition)*
encryptDefinition ::=
- ruleName '(' 'COLUMNS' '(' columnDefinition ( ',' columnDefinition )* ')' ( ',' 'QUERY_WITH_CIPHER_COLUMN' '=' ( 'TRUE' | 'FALSE' ) )? ')'
+ ruleName '(' 'COLUMNS' '(' columnDefinition (',' columnDefinition)* ')' (',' 'QUERY_WITH_CIPHER_COLUMN' '=' ('TRUE' | 'FALSE'))? ')'
columnDefinition ::=
- '(' 'NAME' '=' columnName ( ',' 'PLAIN' '=' plainColumnName )? ',' 'CIPHER' '=' cipherColumnName ( ',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName )? ( ',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName )? ',' encryptAlgorithmDefinition ( ',' assistedQueryAlgorithmDefinition )? ( ',' likeQueryAlgorithmDefinition )? ')'
+ '(' 'NAME' '=' columnName (',' 'PLAIN' '=' plainColumnName)? ',' 'CIPHER' '=' cipherColumnName (',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName)? (',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName)? ',' encryptAlgorithmDefinition (',' assistedQueryAlgorithmDefinition)? (',' likeQueryAlgorithmDefinition)? ')'
encryptAlgorithmDefinition ::=
- 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
assistedQueryAlgorithmDefinition ::=
- 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
likeQueryAlgorithmDefinition ::=
- 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
propertiesDefinition ::=
- 'PROPERTIES' '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.cn.md
index a8f2df9180e..0187bfa4d6a 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.cn.md
@@ -11,28 +11,25 @@ weight = 2
```sql
CreateEncryptRule ::=
- 'CREATE' 'ENCRYPT' 'RULE' encryptDefinition ( ',' encryptDefinition )*
+ 'CREATE' 'ENCRYPT' 'RULE' encryptDefinition (',' encryptDefinition)*
encryptDefinition ::=
- ruleName '(' 'COLUMNS' '(' columnDefinition ( ',' columnDefinition )* ')' ( ',' 'QUERY_WITH_CIPHER_COLUMN' '=' ( 'TRUE' | 'FALSE' ) )? ')'
+ ruleName '(' 'COLUMNS' '(' columnDefinition (',' columnDefinition)* ')' (',' 'QUERY_WITH_CIPHER_COLUMN' '=' ('TRUE' | 'FALSE'))? ')'
columnDefinition ::=
- '(' 'NAME' '=' columnName ( ',' 'PLAIN' '=' plainColumnName )? ',' 'CIPHER' '=' cipherColumnName ( ',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName )? ( ',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName )? ',' encryptAlgorithmDefinition ( ',' assistedQueryAlgorithmDefinition )? ( ',' likeQueryAlgorithmDefinition )? ')'
+ '(' 'NAME' '=' columnName (',' 'PLAIN' '=' plainColumnName)? ',' 'CIPHER' '=' cipherColumnName (',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName)? (',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName)? ',' encryptAlgorithmDefinition (',' assistedQueryAlgorithmDefinition)? (',' likeQueryAlgorithmDefinition)? ')'
encryptAlgorithmDefinition ::=
- 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
assistedQueryAlgorithmDefinition ::=
- 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
likeQueryAlgorithmDefinition ::=
- 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
propertiesDefinition ::=
- 'PROPERTIES' '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.en.md
index f2b346c1ad2..8f91604b940 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/create-encrypt-rule.en.md
@@ -11,28 +11,25 @@ The `CREATE READWRITE_SPLITTING RULE` syntax is used to create a readwrite split
```sql
CreateEncryptRule ::=
- 'CREATE' 'ENCRYPT' 'RULE' encryptDefinition ( ',' encryptDefinition )*
+ 'CREATE' 'ENCRYPT' 'RULE' encryptDefinition (',' encryptDefinition)*
encryptDefinition ::=
- ruleName '(' 'COLUMNS' '(' columnDefinition ( ',' columnDefinition )* ')' ( ',' 'QUERY_WITH_CIPHER_COLUMN' '=' ( 'TRUE' | 'FALSE' ) )? ')'
+ ruleName '(' 'COLUMNS' '(' columnDefinition (',' columnDefinition)* ')' (',' 'QUERY_WITH_CIPHER_COLUMN' '=' ('TRUE' | 'FALSE'))? ')'
columnDefinition ::=
- '(' 'NAME' '=' columnName ( ',' 'PLAIN' '=' plainColumnName )? ',' 'CIPHER' '=' cipherColumnName ( ',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName )? ( ',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName )? ',' encryptAlgorithmDefinition ( ',' assistedQueryAlgorithmDefinition )? ( ',' likeQueryAlgorithmDefinition )? ')'
+ '(' 'NAME' '=' columnName (',' 'PLAIN' '=' plainColumnName)? ',' 'CIPHER' '=' cipherColumnName (',' 'ASSISTED_QUERY_COLUMN' '=' assistedQueryColumnName)? (',' 'LIKE_QUERY_COLUMN' '=' likeQueryColumnName)? ',' encryptAlgorithmDefinition (',' assistedQueryAlgorithmDefinition)? (',' likeQueryAlgorithmDefinition)? ')'
encryptAlgorithmDefinition ::=
- 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ENCRYPT_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
assistedQueryAlgorithmDefinition ::=
- 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'ASSISTED_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
likeQueryAlgorithmDefinition ::=
- 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType ( ',' propertiesDefinition )? ')'
+ 'LIKE_QUERY_ALGORITHM' '(' 'TYPE' '(' 'NAME' '=' encryptAlgorithmType (',' propertiesDefinition)? ')'
propertiesDefinition ::=
- 'PROPERTIES' '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.cn.md
index 50e75d4025c..7d772f0f60d 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
DropEncryptRule ::=
- 'DROP' 'ENCRYPT' 'RULE' tableName ( ',' tableName )*
+ 'DROP' 'ENCRYPT' 'RULE' tableName (',' tableName)*
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.en.md
index 34f788f2ad8..4027b2b3a13 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/encrypt/drop-encrypt-rule.en.md
@@ -11,7 +11,7 @@ The `DROP ENCRYPT RULE` syntax is used to drop an existing encryption rule.
```sql
DropEncryptRule ::=
- 'DROP' 'ENCRYPT' 'RULE' tableName ( ',' tableName )*
+ 'DROP' 'ENCRYPT' 'RULE' tableName (',' tableName)*
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.cn.md
index 0eb8f664ba8..79af125852c 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.cn.md
@@ -11,19 +11,19 @@ weight = 3
```sql
AlterReadwriteSplittingRule ::=
- 'ALTER' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition ( ',' readwriteSplittingDefinition )*
+ 'ALTER' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition (',' readwriteSplittingDefinition)*
readwriteSplittingDefinition ::=
- ruleName '(' ( staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition ) ( ',' loadBalancerDefinition )? ')'
+ ruleName '(' (staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition) (',' loadBalancerDefinition)? ')'
staticReadwriteSplittingDefinition ::=
'WRITE_RESOURCE' '=' writeResourceName ',' 'READ_RESOURCES' '(' ruleName (',' ruleName)* ')'
dynamicReadwriteSplittingDefinition ::=
- 'AUTO_AWARE_RESOURCE' '=' resourceName ( ',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE') )?
+ 'AUTO_AWARE_RESOURCE' '=' resourceName (',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE'))?
loadBalancerDefinition ::=
- 'TYPE' '(' 'NAME' '=' loadBalancerType ( ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' )? ')'
+ 'TYPE' '(' 'NAME' '=' loadBalancerType (',' propertiesDefinition)? ')'
ruleName ::=
identifier
@@ -36,6 +36,15 @@ resourceName ::=
loadBalancerType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.en.md
index db379b9bfd9..90a43043438 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/alter-readwrite-splitting-rule.en.md
@@ -11,19 +11,19 @@ The `ALTER READWRITE_SPLITTING RULE` syntax is used to alter a readwrite splitti
```sql
AlterReadwriteSplittingRule ::=
- 'ALTER' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition ( ',' readwriteSplittingDefinition )*
+ 'ALTER' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition (',' readwriteSplittingDefinition)*
readwriteSplittingDefinition ::=
- ruleName '(' ( staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition ) ( ',' loadBalancerDefinition )? ')'
+ ruleName '(' (staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition) (',' loadBalancerDefinition)? ')'
staticReadwriteSplittingDefinition ::=
'WRITE_RESOURCE' '=' writeResourceName ',' 'READ_RESOURCES' '(' ruleName (',' ruleName)* ')'
dynamicReadwriteSplittingDefinition ::=
- 'AUTO_AWARE_RESOURCE' '=' resourceName ( ',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE') )?
+ 'AUTO_AWARE_RESOURCE' '=' resourceName (',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE'))?
loadBalancerDefinition ::=
- 'TYPE' '(' 'NAME' '=' loadBalancerType ( ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' )? ')'
+ 'TYPE' '(' 'NAME' '=' loadBalancerType (',' propertiesDefinition)? ')'
ruleName ::=
identifier
@@ -36,6 +36,15 @@ resourceName ::=
loadBalancerType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.cn.md
index 593973e2591..9e43e9c1df9 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.cn.md
@@ -11,19 +11,19 @@ weight = 2
```sql
CreateReadwriteSplittingRule ::=
- 'CREATE' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition ( ',' readwriteSplittingDefinition )*
+ 'CREATE' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition (',' readwriteSplittingDefinition)*
readwriteSplittingDefinition ::=
- ruleName '(' ( staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition ) ( ',' loadBalancerDefinition )? ')'
+ ruleName '(' (staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition) (',' loadBalancerDefinition)? ')'
staticReadwriteSplittingDefinition ::=
'WRITE_RESOURCE' '=' writeResourceName ',' 'READ_RESOURCES' '(' ruleName (',' ruleName)* ')'
dynamicReadwriteSplittingDefinition ::=
- 'AUTO_AWARE_RESOURCE' '=' resourceName ( ',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE') )?
+ 'AUTO_AWARE_RESOURCE' '=' resourceName (',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE'))?
loadBalancerDefinition ::=
- 'TYPE' '(' 'NAME' '=' loadBalancerType ( ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' )? ')'
+ 'TYPE' '(' 'NAME' '=' loadBalancerType (',' propertiesDefinition)? ')'
ruleName ::=
identifier
@@ -36,6 +36,15 @@ resourceName ::=
loadBalancerType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.en.md
index 05b4438b880..ad64f23e1a6 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/create-readwrite-splitting-rule.en.md
@@ -11,19 +11,19 @@ The `CREATE READWRITE_SPLITTING RULE` syntax is used to create a readwrite split
```sql
CreateReadwriteSplittingRule ::=
- 'CREATE' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition ( ',' readwriteSplittingDefinition )*
+ 'CREATE' 'READWRITE_SPLITTING' 'RULE' readwriteSplittingDefinition (',' readwriteSplittingDefinition)*
readwriteSplittingDefinition ::=
- ruleName '(' ( staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition ) ( ',' loadBalancerDefinition )? ')'
+ ruleName '(' (staticReadwriteSplittingDefinition | dynamicReadwriteSplittingDefinition) (',' loadBalancerDefinition)? ')'
staticReadwriteSplittingDefinition ::=
'WRITE_RESOURCE' '=' writeResourceName ',' 'READ_RESOURCES' '(' ruleName (',' ruleName)* ')'
dynamicReadwriteSplittingDefinition ::=
- 'AUTO_AWARE_RESOURCE' '=' resourceName ( ',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE') )?
+ 'AUTO_AWARE_RESOURCE' '=' resourceName (',' 'WRITE_DATA_SOURCE_QUERY_ENABLED' '=' ('TRUE' | 'FALSE'))?
loadBalancerDefinition ::=
- 'TYPE' '(' 'NAME' '=' loadBalancerType ( ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ')' )? ')'
+ 'TYPE' '(' 'NAME' '=' loadBalancerType (',' propertiesDefinition)? ')'
ruleName ::=
identifier
@@ -36,6 +36,15 @@ resourceName ::=
loadBalancerType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.cn.md
index c9adf0373ec..361ee465d88 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
DropReadwriteSplittingRule ::=
- 'DROP' 'READWRITE_SPLITTING' 'RULE' ('FROM' databaseName)
+ 'DROP' 'READWRITE_SPLITTING' 'RULE' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.en.md
index a698140671e..228ceb8c40d 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/readwrite-splitting/drop-readwrite-splitting-rule.en.md
@@ -11,7 +11,7 @@ The `DROP READWRITE_SPLITTING RULE` syntax is used to drop readwrite splitting r
```sql
DropReadwriteSplittingRule ::=
- 'DROP' 'READWRITE_SPLITTING' 'RULE' ('FROM' databaseName)
+ 'DROP' 'READWRITE_SPLITTING' 'RULE' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.cn.md
index 4148515b140..122c819bdd0 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.cn.md
@@ -14,10 +14,19 @@ AlterDefaultShadowAlgorithm ::=
'ALTER' 'DEFAULT' 'SHADOW' 'ALGORITHM' shadowAlgorithm
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' ( 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ) ')' ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefiinition ')'
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.en.md
index b76d5d803d3..a0b3058e7fe 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-default-shadow-algorithm.en.md
@@ -14,10 +14,19 @@ AlterDefaultShadowAlgorithm ::=
'ALTER' 'DEFAULT' 'SHADOW' 'ALGORITHM' shadowAlgorithm
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' ( 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ) ')' ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefiinition ')'
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.cn.md
index d16744362ca..a3a646384e6 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.cn.md
@@ -11,19 +11,19 @@ weight = 3
```sql
AlterShadowRule ::=
- 'ALTER' 'SHADOW' 'RULE' shadowDefinition ( ',' shadowDefinition )*
+ 'ALTER' 'SHADOW' 'RULE' shadowRuleDefinition (',' shadowRuleDefinition)*
-shadowDefinition ::=
- ruleName '(' storageUnitMapping shadowTableRule ( ',' shadowTableRule )* ')'
+shadowRuleDefinition ::=
+ ruleName '(' storageUnitMapping shadowTableRule (',' shadowTableRule)* ')'
storageUnitMapping ::=
- 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
+ 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
shadowTableRule ::=
- tableName '(' shadowAlgorithm ')'
+ tableName '(' shadowAlgorithm ')'
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' ) ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefinition ')'
ruleName ::=
identifier
@@ -39,6 +39,15 @@ algorithmName ::=
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.en.md
index 95eafb78214..083e4edfbc0 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/alter-shadow-rule.en.md
@@ -11,19 +11,19 @@ The `ALTER SHADOW RULE` syntax is used to alter shadow rule.
```sql
AlterShadowRule ::=
- 'ALTER' 'SHADOW' 'RULE' shadowDefinition ( ',' shadowDefinition )*
+ 'ALTER' 'SHADOW' 'RULE' shadowRuleDefinition (',' shadowRuleDefinition)*
-shadowDefinition ::=
- ruleName '(' storageUnitMapping shadowTableRule ( ',' shadowTableRule )* ')'
+shadowRuleDefinition ::=
+ ruleName '(' storageUnitMapping shadowTableRule (',' shadowTableRule)* ')'
storageUnitMapping ::=
- 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
+ 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
shadowTableRule ::=
- tableName '(' shadowAlgorithm ')'
+ tableName '(' shadowAlgorithm ')'
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' ) ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefinition ')'
ruleName ::=
identifier
@@ -37,7 +37,17 @@ tableName ::=
algorithmName ::=
identifier
-shadowAlgorithmType ::
+shadowAlgorithmType ::=
+ string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.cn.md
index 5bf8979e5fd..b0e3bd94d09 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.cn.md
@@ -14,10 +14,19 @@ CreateDefaultShadowAlgorithm ::=
'CREATE' 'DEFAULT' 'SHADOW' 'ALGORITHM' shadowAlgorithm
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' ( 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ) ')' ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefiinition ')'
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.en.md
index c806806dbe2..8be029ed9cf 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-default-shadow-algorithm.en.md
@@ -14,10 +14,19 @@ CreateDefaultShadowAlgorithm ::=
'CREATE' 'DEFAULT' 'SHADOW' 'ALGORITHM' shadowAlgorithm
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' ( 'key' '=' 'value' ( ',' 'key' '=' 'value' )* ) ')' ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefiinition ')'
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.cn.md
index 7cd30cf28df..55f9ee7636e 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.cn.md
@@ -11,19 +11,19 @@ weight = 2
```sql
CreateShadowRule ::=
- 'CREATE' 'SHADOW' 'RULE' shadowDefinition ( ',' shadowDefinition )*
+ 'CREATE' 'SHADOW' 'RULE' shadowRuleDefinition (',' shadowRuleDefinition)*
-shadowDefinition ::=
- ruleName '(' storageUnitMapping shadowTableRule ( ',' shadowTableRule )* ')'
+shadowRuleDefinition ::=
+ ruleName '(' storageUnitMapping shadowTableRule (',' shadowTableRule)* ')'
storageUnitMapping ::=
- 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
+ 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
shadowTableRule ::=
- tableName '(' shadowAlgorithm ')'
+ tableName '(' shadowAlgorithm ')'
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' ) ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefinition ')'
ruleName ::=
identifier
@@ -39,6 +39,15 @@ algorithmName ::=
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.en.md
index 22082d5df6e..a31b0cb4d2d 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/create-shadow-rule.en.md
@@ -11,19 +11,19 @@ The `CREATE SHADOW RULE` syntax is used to create a shadow rule.
```sql
CreateShadowRule ::=
- 'CREATE' 'SHADOW' 'RULE' shadowDefinition ( ',' shadowDefinition )*
+ 'CREATE' 'SHADOW' 'RULE' shadowRuleDefinition (',' shadowRuleDefinition)*
-shadowDefinition ::=
- ruleName '(' storageUnitMapping shadowTableRule ( ',' shadowTableRule )* ')'
+shadowRuleDefinition ::=
+ ruleName '(' storageUnitMapping shadowTableRule (',' shadowTableRule)* ')'
storageUnitMapping ::=
- 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
+ 'SOURCE' '=' storageUnitName ',' 'SHADOW' '=' storageUnitName
shadowTableRule ::=
- tableName '(' shadowAlgorithm ')'
+ tableName '(' shadowAlgorithm ')'
shadowAlgorithm ::=
- 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' 'PROPERTIES' '(' 'key' '=' 'value' ( ',' 'key' '=' 'value' ) ')'
+ 'TYPE' '(' 'NAME' '=' shadowAlgorithmType ',' propertiesDefinition ')'
ruleName ::=
identifier
@@ -39,6 +39,15 @@ algorithmName ::=
shadowAlgorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.cn.md
index 329a5bd2994..f7fd3fd22a0 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.cn.md
@@ -11,7 +11,7 @@ weight = 8
```sql
DropShadowAlgorithm ::=
- 'DROP' 'SHADOW' 'ALGORITHM' shadowAlgorithmName(',' shadowAlgorithmName)* ('FROM' databaseName)?
+ 'DROP' 'SHADOW' 'ALGORITHM' shadowAlgorithmName (',' shadowAlgorithmName)* ('FROM' databaseName)?
shadowAlgorithmName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.en.md
index 1bb30ad1742..b9d070f3716 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/shadow/drop-shadow-algorithm.en.md
@@ -11,7 +11,7 @@ The `DROP SHADOW ALGORITHM` syntax is used to drop shadow algorithm for specifie
```sql
DropShadowAlgorithm ::=
- 'DROP' 'SHADOW' 'ALGORITHM' shadowAlgorithmName(',' shadowAlgorithmName)* ('FROM' databaseName)?
+ 'DROP' 'SHADOW' 'ALGORITHM' shadowAlgorithmName (',' shadowAlgorithmName)* ('FROM' databaseName)?
shadowAlgorithmName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.cn.md
index 2c56db3eb4f..fbb8bf7a13d 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.cn.md
@@ -14,10 +14,13 @@ AlterDefaultShardingStrategy ::=
'ALTER' 'DEFAULT' 'SHARDING' ('DATABASE' | 'TABLE') 'STRATEGY' '(' shardingStrategy ')'
shardingStrategy ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames ) ',' ( 'SHARDING_ALGORITHM' '=' algorithmName | algorithmDefinition )
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames) ',' 'SHARDING_ALGORITHM' '=' algorithmDefinition
+
+strategyType ::=
+ string
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ',' 'PROPERTIES' '(' propertyDefinition ')' ')'
+ 'TYPE' '(' 'NAME' '=' algorithmType ',' propertiesDefinition ')'
columnNames ::=
columnName (',' columnName)+
@@ -25,11 +28,17 @@ columnNames ::=
columnName ::=
identifier
-algorithmName ::=
- identifier
-
algorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.en.md
index a6c4ee98750..4ad84fb1236 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-default-sharding-strategy.en.md
@@ -14,10 +14,13 @@ AlterDefaultShardingStrategy ::=
'ALTER' 'DEFAULT' 'SHARDING' ('DATABASE' | 'TABLE') 'STRATEGY' '(' shardingStrategy ')'
shardingStrategy ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames ) ',' ( 'SHARDING_ALGORITHM' '=' algorithmName | algorithmDefinition )
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames) ',' 'SHARDING_ALGORITHM' '=' algorithmDefinition
+
+strategyType ::=
+ string
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ',' 'PROPERTIES' '(' propertyDefinition ')' ')'
+ 'TYPE' '(' 'NAME' '=' algorithmType ',' propertiesDefinition ')'
columnNames ::=
columnName (',' columnName)+
@@ -25,11 +28,17 @@ columnNames ::=
columnName ::=
identifier
-algorithmName ::=
- identifier
-
algorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.cn.md
index eef253e3926..381c7db948c 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.cn.md
@@ -11,7 +11,7 @@ weight = 14
```sql
AlterShardingTableReferenceRule ::=
- 'ALTER' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition )*
+ 'ALTER' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition)*
referenceRelationshipDefinition ::=
ruleName '(' tableName (',' tableName)* ')'
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.en.md
index cb9cc0cff65..efa227b8e79 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-reference-rule.en.md
@@ -11,7 +11,7 @@ The `ALTER SHARDING TABLE REFERENCE RULE` syntax is used to alter sharding table
```sql
AlterShardingTableReferenceRule ::=
- 'ALTER' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition )*
+ 'ALTER' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition)*
referenceRelationshipDefinition ::=
ruleName '(' tableName (',' tableName)* ')'
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.cn.md
index 8eccd960aef..2504b1b87ce 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.cn.md
@@ -11,32 +11,41 @@ weight = 3
```sql
AlterShardingTableRule ::=
- 'ALTER' 'SHARDING' 'TABLE' 'RULE' ( tableDefinition | autoTableDefinition ) ( ',' ( tableDefinition | autoTableDefinition ) )*
+ 'ALTER' 'SHARDING' 'TABLE' 'RULE' (tableDefinition | autoTableDefinition) (',' (tableDefinition | autoTableDefinition))*
tableDefinition ::=
- tableName '(' 'DATANODES' '(' dataNode ( ',' dataNode )* ')' ( ',' 'DATABASE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'TABLE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'DATANODES' '(' dataNode (',' dataNode)* ')' (',' 'DATABASE_STRATEGY' '(' strategyDefinition ')')? (',' 'TABLE_STRATEGY' '(' strategyDefinition ')')? (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
autoTableDefinition ::=
- tableName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
strategyDefinition ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' | 'SHARDING_COLUMNS' ) '=' columnName ',' algorithmDefinition
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' | 'SHARDING_COLUMNS') '=' columnName ',' algorithmDefinition
keyGenerateStrategyDefinition ::=
'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
auditStrategyDefinition ::=
- 'AUDIT_STRATEGY' '(' algorithmDefinition ( ',' algorithmDefinition )* ')'
+ 'AUDIT_STRATEGY' '(' algorithmDefinition (',' algorithmDefinition)* ')'
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ( ',' 'PROPERTIES' '(' ( propertyDefinition )? ')' )?')'
+ 'TYPE' '(' 'NAME' '=' algorithmType (',' propertiesDefinition)?')'
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
tableName ::=
identifier
+dataNode ::=
+ string
+
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.en.md
index 7d4f3848987..59797e0a17b 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/alter-sharding-table-rule.en.md
@@ -11,32 +11,41 @@ The `ALTER SHARDING TABLE RULE` syntax is used to alter sharding table rule for
```sql
AlterShardingTableRule ::=
- 'ALTER' 'SHARDING' 'TABLE' 'RULE' ( tableDefinition | autoTableDefinition ) ( ',' ( tableDefinition | autoTableDefinition ) )*
+ 'ALTER' 'SHARDING' 'TABLE' 'RULE' (tableDefinition | autoTableDefinition) (',' (tableDefinition | autoTableDefinition))*
tableDefinition ::=
- tableName '(' 'DATANODES' '(' dataNode ( ',' dataNode )* ')' ( ',' 'DATABASE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'TABLE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'DATANODES' '(' dataNode (',' dataNode)* ')' (',' 'DATABASE_STRATEGY' '(' strategyDefinition ')')? (',' 'TABLE_STRATEGY' '(' strategyDefinition ')')? (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
autoTableDefinition ::=
- tableName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
strategyDefinition ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' | 'SHARDING_COLUMNS' ) '=' columnName ',' algorithmDefinition
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' | 'SHARDING_COLUMNS') '=' columnName ',' algorithmDefinition
keyGenerateStrategyDefinition ::=
'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
auditStrategyDefinition ::=
- 'AUDIT_STRATEGY' '(' algorithmDefinition ( ',' algorithmDefinition )* ')'
+ 'AUDIT_STRATEGY' '(' algorithmDefinition (',' algorithmDefinition)* ')'
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ( ',' 'PROPERTIES' '(' ( propertyDefinition )? ')' )?')'
+ 'TYPE' '(' 'NAME' '=' algorithmType (',' propertiesDefinition)?')'
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
tableName ::=
identifier
+dataNode ::=
+ string
+
storageUnitName ::=
identifier
@@ -45,7 +54,7 @@ columnName ::=
algorithmType ::=
identifier
-
+
strategyType ::=
string
```
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.cn.md
index 2da6efb30aa..0dfc9a47e0e 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.cn.md
@@ -14,10 +14,13 @@ CreateDefaultShardingStrategy ::=
'CREATE' 'DEFAULT' 'SHARDING' ('DATABASE' | 'TABLE') 'STRATEGY' '(' shardingStrategy ')'
shardingStrategy ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames ) ',' ( 'SHARDING_ALGORITHM' '=' algorithmName | algorithmDefinition )
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames) ',' 'SHARDING_ALGORITHM' '=' algorithmDefinition
+
+strategyType ::=
+ string
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ',' 'PROPERTIES' '(' propertyDefinition ')' ')'
+ 'TYPE' '(' 'NAME' '=' algorithmType ',' propertiesDefinition ')'
columnNames ::=
columnName (',' columnName)+
@@ -25,11 +28,17 @@ columnNames ::=
columnName ::=
identifier
-algorithmName ::=
- identifier
-
algorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### 补充说明
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.en.md
index c551121c095..19b57b1bbbf 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-default-sharding-strategy.en.md
@@ -14,10 +14,13 @@ CreateDefaultShardingStrategy ::=
'CREATE' 'DEFAULT' 'SHARDING' ('DATABASE' | 'TABLE') 'STRATEGY' '(' shardingStrategy ')'
shardingStrategy ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames ) ',' ( 'SHARDING_ALGORITHM' '=' algorithmName | algorithmDefinition )
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' '=' columnName | 'SHARDING_COLUMNS' '=' columnNames) ',' 'SHARDING_ALGORITHM' '=' algorithmDefinition
+
+strategyType ::=
+ string
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ',' 'PROPERTIES' '(' propertyDefinition ')' ')'
+ 'TYPE' '(' 'NAME' '=' algorithmType ',' propertiesDefinition ')'
columnNames ::=
columnName (',' columnName)+
@@ -25,11 +28,17 @@ columnNames ::=
columnName ::=
identifier
-algorithmName ::=
- identifier
-
algorithmType ::=
string
+
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
```
### Supplement
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.cn.md
index b7daaa2d995..c579e8e6abb 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.cn.md
@@ -11,7 +11,7 @@ weight = 13
```sql
CreateShardingTableReferenceRule ::=
- 'CREATE' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition )*
+ 'CREATE' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition)*
referenceRelationshipDefinition ::=
ruleName '(' tableName (',' tableName)* ')'
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.en.md
index 22dda92bf5f..0e7c1e27ae4 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-reference-rule.en.md
@@ -11,7 +11,7 @@ The `CREATE SHARDING TABLE REFERENCE RULE` syntax is used to create reference ru
```sql
CreateShardingTableReferenceRule ::=
- 'CREATE' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition )*
+ 'CREATE' 'SHARDING' 'TABLE' 'REFERENCE' 'RULE' referenceRelationshipDefinition (',' referenceRelationshipDefinition)*
referenceRelationshipDefinition ::=
ruleName '(' tableName (',' tableName)* ')'
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.cn.md
index 16daba1f893..81b6cddb76f 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.cn.md
@@ -11,32 +11,41 @@ weight = 2
```sql
CreateShardingTableRule ::=
- 'CREATE' 'SHARDING' 'TABLE' 'RULE' ( tableDefinition | autoTableDefinition ) ( ',' ( tableDefinition | autoTableDefinition ) )*
+ 'CREATE' 'SHARDING' 'TABLE' 'RULE' (tableDefinition | autoTableDefinition) (',' (tableDefinition | autoTableDefinition))*
tableDefinition ::=
- tableName '(' 'DATANODES' '(' dataNode ( ',' dataNode )* ')' ( ',' 'DATABASE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'TABLE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'DATANODES' '(' dataNode (',' dataNode)* ')' (',' 'DATABASE_STRATEGY' '(' strategyDefinition ')')? (',' 'TABLE_STRATEGY' '(' strategyDefinition ')')? (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
autoTableDefinition ::=
- tableName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
strategyDefinition ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' | 'SHARDING_COLUMNS' ) '=' columnName ',' algorithmDefinition
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' | 'SHARDING_COLUMNS') '=' columnName ',' algorithmDefinition
keyGenerateStrategyDefinition ::=
- 'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
+ 'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
auditStrategyDefinition ::=
- 'AUDIT_STRATEGY' '(' algorithmDefinition ( ',' algorithmDefinition )* ')'
+ 'AUDIT_STRATEGY' '(' algorithmDefinition (',' algorithmDefinition)* ')'
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ( ',' 'PROPERTIES' '(' ( propertyDefinition )? ')' )?')'
+ 'TYPE' '(' 'NAME' '=' algorithmType (',' propertiesDefinition)?')'
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
tableName ::=
identifier
+dataNode ::=
+ string
+
storageUnitName ::=
identifier
@@ -46,7 +55,7 @@ columnName ::=
algorithmType ::=
identifier
-algorithmType ::=
+strategyType ::=
string
```
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.en.md
index f2e253beb72..57c40102c80 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/sharding/create-sharding-table-rule.en.md
@@ -11,32 +11,41 @@ The `CREATE SHARDING TABLE RULE` syntax is used to add sharding table rule for t
```sql
CreateShardingTableRule ::=
- 'CREATE' 'SHARDING' 'TABLE' 'RULE' ( tableDefinition | autoTableDefinition ) ( ',' ( tableDefinition | autoTableDefinition ) )*
+ 'CREATE' 'SHARDING' 'TABLE' 'RULE' (tableDefinition | autoTableDefinition) (',' (tableDefinition | autoTableDefinition))*
tableDefinition ::=
- tableName '(' 'DATANODES' '(' dataNode ( ',' dataNode )* ')' ( ',' 'DATABASE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'TABLE_STRATEGY' '(' strategyDefinition ')' )? ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'DATANODES' '(' dataNode (',' dataNode)* ')' (',' 'DATABASE_STRATEGY' '(' strategyDefinition ')')? (',' 'TABLE_STRATEGY' '(' strategyDefinition ')')? (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
autoTableDefinition ::=
- tableName '(' 'STORAGE_UNITS' '(' storageUnitName ( ',' storageUnitName )* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition ( ',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')' )? ( ',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')' )? ')'
+ tableName '(' 'STORAGE_UNITS' '(' storageUnitName (',' storageUnitName)* ')' ',' 'SHARDING_COLUMN' '=' columnName ',' algorithmDefinition (',' 'KEY_GENERATE_STRATEGY' '(' keyGenerateStrategyDefinition ')')? (',' 'AUDIT_STRATEGY' '(' auditStrategyDefinition ')')? ')'
strategyDefinition ::=
- 'TYPE' '=' strategyType ',' ( 'SHARDING_COLUMN' | 'SHARDING_COLUMNS' ) '=' columnName ',' algorithmDefinition
+ 'TYPE' '=' strategyType ',' ('SHARDING_COLUMN' | 'SHARDING_COLUMNS') '=' columnName ',' algorithmDefinition
keyGenerateStrategyDefinition ::=
- 'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
+ 'KEY_GENERATE_STRATEGY' '(' 'COLUMN' '=' columnName ',' algorithmDefinition ')'
auditStrategyDefinition ::=
- 'AUDIT_STRATEGY' '(' algorithmDefinition ( ',' algorithmDefinition )* ')'
+ 'AUDIT_STRATEGY' '(' algorithmDefinition (',' algorithmDefinition)* ')'
algorithmDefinition ::=
- 'TYPE' '(' 'NAME' '=' algorithmType ( ',' 'PROPERTIES' '(' ( propertyDefinition )? ')' )?')'
+ 'TYPE' '(' 'NAME' '=' algorithmType (',' propertiesDefinition)?')'
-propertyDefinition ::=
- ( key '=' value ) ( ',' key '=' value )*
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
+
+key ::=
+ string
+
+value ::=
+ literal
tableName ::=
identifier
+dataNode ::=
+ string
+
storageUnitName ::=
identifier
@@ -46,7 +55,7 @@ columnName ::=
algorithmType ::=
identifier
-algorithmType ::=
+strategyType ::=
string
```
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.cn.md
index 860c5f8ed4f..06460abe369 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.cn.md
@@ -14,7 +14,7 @@ SetDefaultSingleTableStorageUnit ::=
'SET' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' singleTableDefinition
singleTableDefinition ::=
- '=' (storageUnitName ｜ 'RANDOM')
+ '=' (storageUnitName | 'RANDOM')
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.en.md
index d0a2bb39a81..0b0063d4346 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/rule-definition/single-table/set-default-single-table-storage-unit.en.md
@@ -14,7 +14,7 @@ SetDefaultSingleTableStorageUnit ::=
'SET' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' singleTableDefinition
singleTableDefinition ::=
- '=' (storageUnitName ｜ 'RANDOM')
+ '=' (storageUnitName | 'RANDOM')
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.cn.md
index 4477564b400..854d58e5051 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.cn.md
@@ -10,11 +10,11 @@ weight = 3
### 语法
```sql
-AlterResource ::=
+AlterStorageUnit ::=
'ALTER' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- storageUnitName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ storageUnitName '(' ('HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url) ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -37,11 +37,8 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
key ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.en.md
index 962b3122566..ef1c1791a6a 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/alter-storage-unit.en.md
@@ -10,11 +10,11 @@ The `ALTER STORAGE UNIT` syntax is used to alter storage units for the currently
### Syntax
```sql
-AlterResource ::=
+AlterStorageUnit ::=
'ALTER' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- storageUnitName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ storageUnitName '(' ('HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url) ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -37,11 +37,8 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
key ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.cn.md
index dbd1e7db68c..e3d313a41b7 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.cn.md
@@ -14,7 +14,7 @@ RegisterStorageUnit ::=
'REGISTER' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- StorageUnitName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ storageUnitName '(' ('HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url) ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -37,11 +37,8 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
key ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.en.md
index c02b93049a8..c612a8280a3 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/register-storage-unit.en.md
@@ -14,7 +14,7 @@ RegisterStorageUnit ::=
'REGISTER' 'STORAGE' 'UNIT' storageUnitDefinition (',' storageUnitDefinition)*
storageUnitDefinition ::=
- StorageUnitName '(' ( 'HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url ) ',' 'USER' '=' user (',' 'PASSWORD' '=' password )? (',' proerties)?')'
+ storageUnitName '(' ('HOST' '=' hostName ',' 'PORT' '=' port ',' 'DB' '=' dbName | 'URL' '=' url) ',' 'USER' '=' user (',' 'PASSWORD' '=' password)? (',' propertiesDefinition)?')'
storageUnitName ::=
identifier
@@ -37,11 +37,8 @@ user ::=
password ::=
string
-proerties ::=
- PROPERTIES '(' property ( ',' property )* ')'
-
-property ::=
- key '=' value
+propertiesDefinition ::=
+ 'PROPERTIES' '(' key '=' value (',' key '=' value)* ')'
key ::=
string
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.cn.md
index efddffc2164..356e97d39c9 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.cn.md
@@ -11,7 +11,7 @@ weight = 4
```sql
UnregisterStorageUnit ::=
- 'UNREGISTER' 'STORAGE' 'UNIT' ( 'IF' 'EXISTS' )? storageUnitName ( ',' storageUnitName )* ( 'IGNORE' 'SINGLE' 'TABLES' )?
+ 'UNREGISTER' 'STORAGE' 'UNIT' ('IF' 'EXISTS')? storageUnitName (',' storageUnitName)* ('IGNORE' 'SINGLE' 'TABLES')?
storageUnitName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.en.md
index b6505b68bcd..2eb8cc88464 100644
--- a/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/rdl/storage-unit-definition/unregister-storage-unit.en.md
@@ -11,7 +11,7 @@ The `UNREGISTER STORAGE UNIT` syntax is used to unregister storage unit from the
```sql
UnregisterStorageUnit ::=
- 'UNREGISTER' 'STORAGE' 'UNIT' ( 'IF' 'EXISTS' )? storageUnitName ( ',' storageUnitName )* ( 'IGNORE' 'SINGLE' 'TABLES' )?
+ 'UNREGISTER' 'STORAGE' 'UNIT' ('IF' 'EXISTS')? storageUnitName (',' storageUnitName)* ('IGNORE' 'SINGLE' 'TABLES')?
storageUnitName ::=
identifier
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
index 4e6ca54b535..ee3cbf8927f 100644
--- 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
@@ -9,7 +9,7 @@ weight = 4
### 语法
-```
+```sql
ShowDatabaseDiscoveryHeartbeats::=
'SHOW' 'DB_DISCOVERY' 'HEARTBEATS' ('FROM' databaseName)?
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
index 3b1f278f436..22e382a5e63 100644
--- 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
@@ -9,7 +9,7 @@ The `SHOW DB_DISCOVERY HEARTBEATS` syntax is used to query database discovery he
### Syntax
-```
+```sql
ShowDatabaseDiscoveryType::=
'SHOW' 'DB_DISCOVERY' 'HEARTBEATS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.cn.md
index adae8fb9ecf..d7212a3af31 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/db-discovery/show-db-discovery-rule.cn.md
@@ -9,7 +9,7 @@ weight = 2
### 语法
-```
+```sql
ShowDatabaseDiscoveryRule::=
'SHOW' 'DB_DISCOVERY' 'RULES' ('FROM' databaseName)?
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 2c133463665..d3e8f296d1d 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
@@ -9,7 +9,7 @@ The `SHOW DB_DISCOVERY RULES` syntax is used to query database discovery rules f
### Syntax
-```
+```sql
ShowDatabaseDiscoveryRule::=
'SHOW' 'DB_DISCOVERY' 'RULES' ('FROM' databaseName)?
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
index 0fadb65de86..1c2f5f2307a 100644
--- 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
@@ -9,7 +9,7 @@ weight = 3
### 语法
-```
+```sql
ShowDatabaseDiscoveryType::=
'SHOW' 'DB_DISCOVERY' 'TYPES' ('FROM' databaseName)?
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
index e53bdc468ce..fa491150cad 100644
--- 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
@@ -9,7 +9,7 @@ The `SHOW DB_DISCOVERY TYPES` syntax is used to query database discovery types f
### Syntax
-```
+```sql
ShowDatabaseDiscoveryType::=
'SHOW' 'DB_DISCOVERY' 'TYPES' ('FROM' databaseName)?
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
index dcccaefd31c..657b7fdee84 100644
--- 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
@@ -9,7 +9,7 @@ weight = 2
### 语法
-```
+```sql
ShowEncryptRule::=
'SHOW' 'ENCRYPT' 'RULES' ('FROM' databaseName)?
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
index 46e44d6aca1..1342e445ff9 100644
--- 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
@@ -9,7 +9,7 @@ The `SHOW ENCRYPT RULES` syntax is used to query encrypt rules for specified dat
### Syntax
-```
+```sql
ShowEncryptRule::=
'SHOW' 'ENCRYPT' 'RULES' ('FROM' databaseName)?
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
index 91bfc323062..07d9c4f47f5 100644
--- 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
@@ -9,9 +9,9 @@ weight = 3
### 语法
-```
+```sql
ShowEncryptTableRule::=
- 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName('FROM' databaseName)?
+ 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName ('FROM' databaseName)?
tableName ::=
identifier
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
index 4d89d309016..c9aaf2e3a8c 100644
--- 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
@@ -9,9 +9,9 @@ The `SHOW ENCRYPT RULE` syntax is used to query encrypt rules for specified tabl
### Syntax
-```
+```sql
ShowEncryptTableRule::=
- 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName('FROM' databaseName)?
+ 'SHOW' 'ENCRYPT' 'TABLE' 'RULE' tabeName ('FROM' databaseName)?
tableName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.cn.md
index 1f6d1ccecc3..d77c01e60ae 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/readwrite-splitting/show-readwrite-splitting-rule.cn.md
@@ -9,7 +9,7 @@ weight = 2
### 语法
-```
+```sql
ShowReadWriteSplittingRule::=
'SHOW' 'READWRITE_SPLITTING' 'RULES' ('FROM' databaseName)?
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 aca7424a84c..ddd94158bce 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
@@ -9,7 +9,7 @@ The `SHOW READWRITE_SPLITTING RULES` syntax is used to query readwrite splitting
### Syntax
-```
+```sql
ShowReadWriteSplittingRule::=
'SHOW' 'READWRITE_SPLITTING' 'RULES' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.cn.md
index 813351707e0..4e790b5e1d1 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.cn.md
@@ -9,7 +9,7 @@ weight = 4
### 语法
-```
+```sql
ShowEncryptAlgorithm::=
'SHOW' 'SHADOW' 'ALGORITHMS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.en.md
index 94524dc584a..74cc15e2966 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/shadow/show-shadow-algorithm.en.md
@@ -9,7 +9,7 @@ The `SHOW SHADOW ALGORITHM` syntax is used to query shadow algorithms for specif
### Syntax
-```
+```sql
ShowEncryptAlgorithm::=
'SHOW' 'SHADOW' 'ALGORITHMS' ('FROM' databaseName)?
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
index 14bd94cae0e..91945a8aab4 100644
--- 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
@@ -9,9 +9,9 @@ weight = 2
### 语法
-```
+```sql
ShowEncryptRule::=
- 'SHOW' 'SHADOW' ('RULES'|'RULE' shadowRuleName) ('FROM' databaseName)?
+ 'SHOW' 'SHADOW' ('RULES' | 'RULE' shadowRuleName) ('FROM' databaseName)?
shadowRuleName ::=
identifier
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
index 479e73d0412..f3d470e7d49 100644
--- 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
@@ -9,9 +9,9 @@ The `SHOW SHADOW RULE` syntax is used to query shadow rules for specified databa
### Syntax
-```
+```sql
ShowEncryptRule::=
- 'SHOW' 'SHADOW' ('RULES'|'RULE' shadowRuleName) ('FROM' databaseName)?
+ 'SHOW' 'SHADOW' ('RULES' | 'RULE' shadowRuleName) ('FROM' databaseName)?
shadowRuleName ::=
identifier
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
index 2267a4925e9..cb5fd829dde 100644
--- 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
@@ -9,7 +9,7 @@ weight = 3
### 语法
-```
+```sql
ShowEncryptRule::=
'SHOW' 'SHADOW' 'TABLE' 'RULES' ('FROM' databaseName)?
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
index 1125535280f..eab1601a2f2 100644
--- 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
@@ -9,7 +9,7 @@ The `SHOW SHADOW TABLE RULE` syntax is used to query shadow table rules for spec
### Syntax
-```
+```sql
ShowEncryptRule::=
'SHOW' 'SHADOW' 'TABLE' 'RULES' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.cn.md
index 82c2d975e32..20c6f4fa219 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-default-sharding-strategy.cn.md
@@ -9,7 +9,7 @@ weight = 5
### 语法
-```
+```sql
ShowDefaultShardingStrategy::=
'SHOW' 'DEFAULT' 'SHARDING' 'STRATEGY' ('FROM' databaseName)?
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 cb23adcc8cd..c7273291262 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
@@ -9,7 +9,7 @@ The `SHOW DEFAULT SHARDING STRATEGY` syntax is used to query default sharding st
### Syntax
-```
+```sql
ShowDefaultShardingStrategy::=
'SHOW' 'DEFAULT' 'SHARDING' 'STRATEGY' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.cn.md
index 39a75120e51..665bfb0f4d1 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.cn.md
@@ -9,7 +9,7 @@ weight = 3
### 语法
-```
+```sql
ShowShardingAlgorithms::=
'SHOW' 'SHARDING' 'ALGORITHMS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.en.md
index b93e5faade8..9392c0218f3 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-algorithms.en.md
@@ -9,7 +9,7 @@ The `SHOW SHARDING ALGORITHMS` syntax is used to query the sharding algorithms i
### Syntax
-```
+```sql
ShowShardingAlgorithms::=
'SHOW' 'SHARDING' 'ALGORITHMS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.cn.md
index 744248f8f66..4ddf461450b 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-auditors.cn.md
@@ -9,9 +9,9 @@ weight = 8
### 语法
-```
+```sql
ShowShardingAuditors::=
- 'SHOW' 'SHARDING' 'AUDITOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'AUDITOR' ('FROM' databaseName)?
databaseName ::=
identifier
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 201c27a89ae..b31cd1d66b5 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
@@ -10,9 +10,9 @@ weight = 8
### Syntax
-```
+```sql
ShowShardingAuditors::=
- 'SHOW' 'SHARDING' 'AUDITOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'AUDITOR' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.cn.md
index e7bde3a2d37..a9abea59dfd 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-key-generator.cn.md
@@ -9,9 +9,9 @@ weight = 6
### 语法
-```
+```sql
ShowShardingKeyGenerators::=
- 'SHOW' 'SHARDING' 'KEY' 'GENERATOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'KEY' 'GENERATOR' ('FROM' databaseName)?
databaseName ::=
identifier
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 929563894cf..e9933bf0520 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
@@ -9,9 +9,9 @@ weight = 6
### Syntax
-```
+```sql
ShowShardingKeyGenerators::=
- 'SHOW' 'SHARDING' 'KEY' 'GENERATOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'KEY' 'GENERATOR' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.cn.md
index d886f8f3251..8702099f091 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-nodes.cn.md
@@ -9,9 +9,9 @@ weight = 10
### 语法
-```
+```sql
ShowShardingTableNode::=
- 'SHOW' 'SHARDING' 'TABLE' 'NODE'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'TABLE' 'NODE' ('FROM' databaseName)?
databaseName ::=
identifier
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 bd77404708a..9ad8e868b24 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
@@ -10,9 +10,9 @@ weight = 10
### Syntax
-```
+```sql
ShowShardingTableNode::=
- 'SHOW' 'SHARDING' 'TABLE' 'NODE'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'TABLE' 'NODE' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.cn.md
index 43672e1c8cc..2393f2f1c79 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.cn.md
@@ -12,7 +12,7 @@ weight = 14
```sql
ShowShardingBindingTableRules::=
- 'SHOW' 'SHARDING' 'TABLE' 'REFERENCE' 'RULES'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'TABLE' 'REFERENCE' 'RULES' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.en.md
index c765cd3fb25..a2dbda0ea2a 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-reference-rules.en.md
@@ -11,7 +11,7 @@ weight = 14
```sql
ShowShardingBindingTableRules::=
- 'SHOW' 'SHARDING' 'TABLE' 'REFERENCE' 'RULES'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'TABLE' 'REFERENCE' 'RULES' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.cn.md
index 6f523fdd9a6..7ee0b071370 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.cn.md
@@ -9,7 +9,7 @@ weight = 2
### 语法
-```
+```sql
ShowShardingTableRule ::=
'SHOW' 'SHARDING' 'TABLE' ('RULE' tableName | 'RULES') ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.en.md
index b82ece4a864..6eddf80eb08 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rule.en.md
@@ -9,7 +9,7 @@ The `SHOW SHARDING TABLE RULE` syntax is used to query the sharding table rule i
### Syntax
-```
+```sql
ShowShardingTableRule ::=
'SHOW' 'SHARDING' 'TABLE' ('RULE' tableName | 'RULES') ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.cn.md
index 4d00284876e..8ad4e4d2b49 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used algorithm.cn.md
@@ -9,7 +9,7 @@ weight = 11
### 语法
-```
+```sql
ShowShardingTableRulesUsedAlgorithm::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'ALGORITHM' algorithmName ('FROM' databaseName)?
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 79d4ac65b59..832fc61ded4 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
@@ -10,7 +10,7 @@ weight = 11
### Syntax
-```
+```sql
ShowShardingTableRulesUsedAlgorithm::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'ALGORITHM' algorithmName ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.cn.md
index ca93851ff6d..21f864788fa 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-auditor.cn.md
@@ -9,7 +9,7 @@ weight = 13
### 语法
-```
+```sql
ShowShardingTableRulesUsedAuditor::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'AUDITOR' AuditortorName ('FROM' databaseName)?
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 dfcbf230cad..422b85fb46e 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
@@ -10,7 +10,7 @@ weight = 13
### Syntax
-```
+```sql
ShowShardingTableRulesUsedAuditor::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'AUDITOR' AuditortorName ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.cn.md
index 8c4679b2f51..d30abd4af2b 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-sharding-table-rules-used-key-generator.cn.md
@@ -9,7 +9,7 @@ weight = 12
### 语法
-```
+```sql
ShowShardingTableRulesUsedKeyGenerator::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'KEY' 'GENERATOR' keyGeneratorName ('FROM' databaseName)?
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 299f9f29adb..6108b4c8eed 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
@@ -10,7 +10,7 @@ weight = 12
### Syntax
-```
+```sql
ShowShardingTableRulesUsedKeyGenerator::=
'SHOW' 'SHARDING' 'TABLE' 'RULES' 'USED' 'KEY' 'GENERATOR' keyGeneratorName ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.cn.md
index 789277ae282..62cde37b12d 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.cn.md
@@ -9,7 +9,7 @@ weight = 4
### 语法
-```
+```sql
ShowShardingAlgorithms::=
'SHOW' 'UNUSED' 'SHARDING' 'ALGORITHMS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.en.md
index 58e5df892b0..5dc76822923 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-algorithms.en.md
@@ -9,7 +9,7 @@ The `SHOW UNUSED SHARDING ALGORITHMS` syntax is used to query the unused shardin
### Syntax
-```
+```sql
ShowShardingAlgorithms::=
'SHOW' 'UNUSED' 'SHARDING' 'ALGORITHMS' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.cn.md
index 522dc091ef9..e9974a66479 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-auditors.cn.md
@@ -9,9 +9,9 @@ weight = 9
### 语法
-```
+```sql
ShowUnusedShardingAuditors::=
- 'SHOW' 'SHARDING' 'AUDITOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'AUDITOR' ('FROM' databaseName)?
databaseName ::=
identifier
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 ce04566d791..41a8028d1df 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
@@ -10,9 +10,9 @@ weight = 9
### Syntax
-```
+```sql
ShowUnusedShardingAuditors::=
- 'SHOW' 'SHARDING' 'AUDITOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'AUDITOR' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.cn.md
index 0f8be14f26e..abd7def8529 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/sharding/show-unused-sharding-key-generators.cn.md
@@ -9,9 +9,9 @@ weight = 7
### 语法
-```
+```sql
ShowUnusedShardingKeyGenerators::=
- 'SHOW' 'UNUSED' 'SHARDING' 'KEY' 'GENERATOR'('FROM' databaseName)?
+ 'SHOW' 'UNUSED' 'SHARDING' 'KEY' 'GENERATOR' ('FROM' databaseName)?
databaseName ::=
identifier
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 8349e3e30ea..6afa9d06545 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
@@ -10,9 +10,9 @@ weight = 7
### Syntax
-```
+```sql
ShowShardingKeyGenerators::=
- 'SHOW' 'SHARDING' 'KEY' 'GENERATOR'('FROM' databaseName)?
+ 'SHOW' 'SHARDING' 'KEY' 'GENERATOR' ('FROM' databaseName)?
databaseName ::=
identifier
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.cn.md
index 3a214b9ac2d..37e8abb1d8f 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.cn.md
@@ -9,7 +9,7 @@ weight = 4
### 语法
-```
+```sql
CountSingleTableRule::=
'COUNT' 'SINGLE_TABLE' 'RULE' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.en.md
index 86c9bf495f3..fa58ec37b97 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/count-single-table-rule.en.md
@@ -9,7 +9,7 @@ The `COUNT SINGLE_TABLE RULE` syntax is used to query number of single table rul
### Syntax
-```
+```sql
CountSingleTableRule::=
'COUNT' 'SINGLE_TABLE' 'RULE' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.cn.md
index d6ccf21f8dc..ac015a1fdaa 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.cn.md
@@ -9,7 +9,7 @@ weight = 2
### 语法
-```
+```sql
ShowDefaultSingleTableStorageUnit::=
'SHOW' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.en.md
index 402ab5b59b4..84d965bea5f 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.en.md
@@ -9,7 +9,7 @@ The `SHOW DEFAULT SINGLE TABLE STORAGE UNIT` syntax is used to query storage uni
### Syntax
-```
+```sql
ShowDefaultSingleTableStorageUnit::=
'SHOW' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.cn.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.cn.md
index 2ecfe29079b..35154359eca 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.cn.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.cn.md
@@ -9,7 +9,7 @@ weight = 3
### 语法
-```
+```sql
ShowSingleTable::=
'SHOW' 'SINGLE' ('TABLES' ('LIKE' likeLiteral)?|'TABLE' tableName) ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.en.md b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.en.md
index ce5e7bab928..d1c4b406ba9 100644
--- a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-single-table.en.md
@@ -9,7 +9,7 @@ The `SHOW SINGLE TABLE` syntax is used to query single tables for specified data
### Syntax
-```
+```sql
ShowSingleTable::=
'SHOW' 'SINGLE' ('TABLES' ('LIKES' likeLiteral)?|'TABLE' tableName) ('FROM' databaseName)?
diff --git a/docs/document/content/reference/distsql/syntax/rql/storage-unit-query/show-storage-units.en.md b/docs/document/content/reference/distsql/syntax/rql/storage-unit-query/show-storage-units.en.md
index ad0ae19c5f6..04fe00f4da9 100644
--- a/docs/document/content/reference/distsql/syntax/rql/storage-unit-query/show-storage-units.en.md
+++ b/docs/document/content/reference/distsql/syntax/rql/storage-unit-query/show-storage-units.en.md
@@ -11,7 +11,10 @@ The `SHOW STORAGE UNITS` syntax is used to query the storage units that have bee
```sql
ShowStorageUnit ::=
- 'SHOW' 'STORAGE' 'UNITS' ('FROM' databaseName)?
+ 'SHOW' 'STORAGE' 'UNITS' ('WHERE' 'USAGE_COUNT' '=' usageCount)? ('FROM' databaseName)?
+
+usageCount ::=
+ int
databaseName ::=
identifier