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 31c975fa506 Add `SHOW DEFAULT SINGLE TABLE STORAGE UNIT` docs. (#21716)
31c975fa506 is described below
commit 31c975fa5061a907d4e9b86bd55a3138ad08cdd8
Author: Jieker <[email protected]>
AuthorDate: Mon Oct 24 18:52:47 2022 +0800
Add `SHOW DEFAULT SINGLE TABLE STORAGE UNIT` docs. (#21716)
---
.../reference/distsql/syntax/reserved-word.cn.md | 6 ++-
.../reference/distsql/syntax/reserved-word.en.md | 6 ++-
.../rql/rule-query/single-table/_index.cn.md | 7 +++
.../rql/rule-query/single-table/_index.en.md | 7 +++
.../show-deafult-single-table-storage-unit.cn.md | 55 ++++++++++++++++++++++
.../show-deafult-single-table-storage-unit.en.md | 54 +++++++++++++++++++++
6 files changed, 133 insertions(+), 2 deletions(-)
diff --git a/docs/document/content/reference/distsql/syntax/reserved-word.cn.md
b/docs/document/content/reference/distsql/syntax/reserved-word.cn.md
index b3b8cffeb8c..d87fc5c9233 100644
--- a/docs/document/content/reference/distsql/syntax/reserved-word.cn.md
+++ b/docs/document/content/reference/distsql/syntax/reserved-word.cn.md
@@ -46,7 +46,7 @@ weight = 3
### 基础保留字
-`SHOW`、`RULE`、`RULES`、`TABLE`、`DATABASE`、`FROM`
+`SHOW`、`DEFAULT`、`RULE`、`RULES`、`TABLE`、`DATABASE`、`FROM`
### 资源定义
@@ -58,6 +58,10 @@ weight = 3
`UNUSED`、`SHARDING`、`ALGORITHMS`
+#### 单表
+
+`SINGLE`、`STORAGE`、`UNIT`
+
## 补充说明
- 上述保留字大小写不敏感
\ No newline at end of file
diff --git a/docs/document/content/reference/distsql/syntax/reserved-word.en.md
b/docs/document/content/reference/distsql/syntax/reserved-word.en.md
index fcec9bc3816..9604818f738 100644
--- a/docs/document/content/reference/distsql/syntax/reserved-word.en.md
+++ b/docs/document/content/reference/distsql/syntax/reserved-word.en.md
@@ -48,7 +48,7 @@ weight = 3
### Basic Reserved Words
-`SHOW`, `RULE`, `RULES`, `TABLE`, `DATABASE`, `FROM`
+`SHOW`, `DEFAULT`, `RULE`, `RULES`, `TABLE`, `DATABASE`, `FROM`
### Resource Definition
@@ -60,6 +60,10 @@ weight = 3
`UNUSED`, `SHARDING`, `ALGORITHMS`
+#### Single Table
+
+`SINGLE`, `STORAGE`, `UNIT`
+
## Supplement
- The above reserved words are not case-sensitive
\ No newline at end of file
diff --git
a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.cn.md
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.cn.md
new file mode 100644
index 00000000000..3a0d0f8ccf0
--- /dev/null
+++
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.cn.md
@@ -0,0 +1,7 @@
++++
+title = "单表"
+weight = 1
+chapter = true
++++
+
+本章节将对单表特性的语法进行详细说明。
diff --git
a/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.en.md
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.en.md
new file mode 100644
index 00000000000..8f47cf48efc
--- /dev/null
+++
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/_index.en.md
@@ -0,0 +1,7 @@
++++
+title = "Single Table"
+weight = 1
+chapter = true
++++
+
+This chapter describes the syntax of single table.
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
new file mode 100644
index 00000000000..a9a1db5556f
--- /dev/null
+++
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.cn.md
@@ -0,0 +1,55 @@
++++
+title = "SHOW DEFAULT SINGLE TABLE STORAGE UNIT"
+weight = 2
++++
+
+### 描述
+
+`SHOW DEFAULT SINGLE TABLE STORAGE UNIT` 语法用于查询指定逻辑库中的存储单元信息。
+
+### 语法
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### 补充说明
+
+- 未指定 `databaseName` 时，默认是当前使用的 `DATABASE`。 如果也未使用 `DATABASE` 则会提示 `No
database selected`。
+
+### 返回值说明
+
+| 列 | 说明 |
+|--------------------|---------|
+| storage_unit_name | 存储单元名称 |
+
+### 示例
+
+- 查询当前逻辑库中的存储单元信息
+
+```sql
+SHOW DEFAULT SINGLE TABLE STORAGE UNIT
+```
+
+```sql
+sql> SHOW DEFAULT SINGLE TABLE STORAGE UNIT;
++-------------------+
+| storage_unit_name |
++-------------------+
+| ds_0 |
++-------------------+
+1 row in set (0.01 sec)
+```
+
+### 保留字
+
+`SHOW`、`DEFAULT`、`SINGLE`、`TABLE`、`STORAGE`、`UNIT`
+
+### 相关链接
+
+- [保留字](/cn/reference/distsql/syntax/reserved-word/)
+
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
new file mode 100644
index 00000000000..f2db19ca8e6
--- /dev/null
+++
b/docs/document/content/reference/distsql/syntax/rql/rule-query/single-table/show-deafult-single-table-storage-unit.en.md
@@ -0,0 +1,54 @@
++++
+title = "SHOW DEFAULT SINGLE TABLE STORAGE UNIT"
+weight = 2
++++
+
+### Description
+
+The `SHOW DEFAULT SINGLE TABLE STORAGE UNIT` syntax is used to query storage
units for specified database.
+
+### Syntax
+
+```
+ShowEncryptRule::=
+ 'SHOW' 'DEFAULT' 'SINGLE' 'TABLE' 'STORAGE' 'UNIT' ('FROM' databaseName)?
+
+databaseName ::=
+ identifier
+```
+
+### Supplement
+
+- When `databaseName` is not specified, the default is the currently used
`DATABASE`. If `DATABASE` is not used, `No database selected` will be prompted.
+
+### Return Value Description
+
+| Column | Description |
+|--------------------|-------------------|
+| storage_unit_name | Storage unit name |
+
+### Example
+
+- Query storage units for specified database.
+
+```sql
+SHOW DEFAULT SINGLE TABLE STORAGE UNIT
+```
+
+```sql
+sql> SHOW DEFAULT SINGLE TABLE STORAGE UNIT;
++-------------------+
+| storage_unit_name |
++-------------------+
+| ds_0 |
++-------------------+
+1 row in set (0.01 sec)
+```
+
+### Reserved word
+
+`SHOW`, `DEFAULT`, `SINGLE`, `TABLE`, `STORAGE`, `UNIT`
+
+### Related links
+
+- [Reserved word](/en/reference/distsql/syntax/reserved-word/)
