From 21b9dfedfd8400685bb5fa7f750e724f020ea316 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Tue, 9 Apr 2024 22:16:49 +0200 Subject: [PATCH 1/4] ebnf show table regions --- .../sql-statement-show-table-regions.md | 34 +++++++------------ 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/sql-statements/sql-statement-show-table-regions.md b/sql-statements/sql-statement-show-table-regions.md index 7270900787702..edee55c36bfe4 100644 --- a/sql-statements/sql-statement-show-table-regions.md +++ b/sql-statements/sql-statement-show-table-regions.md @@ -21,25 +21,17 @@ SHOW TABLE [table_name] INDEX [index_name] REGIONS [WhereClauseOptional]; ## Synopsis -**ShowTableRegionStmt:** +```ebnf+diagram +ShowTableRegionStmt ::= + "SHOW" "TABLE" TableName PartitionNameList? ("INDEX" IndexName)? "REGIONS" ShowLikeOrWhere? -![ShowTableRegionStmt](/media/sqlgram/ShowTableRegionStmt.png) +TableName ::= + (SchemaName ".")? Identifier -**TableName:** - -![TableName](/media/sqlgram/TableName.png) - -**PartitionNameListOpt:** - -![PartitionNameListOpt](/media/sqlgram/PartitionNameListOpt.png) - -**WhereClauseOptional:** - -![WhereClauseOptional](/media/sqlgram/WhereClauseOptional.png) - -**WhereClause:** - -![WhereClause](/media/sqlgram/WhereClause.png) +ShowLikeOrWhere ::= + "LIKE" SimpleExpr +| "WHERE" Expression +``` Executing `SHOW TABLE REGIONS` returns the following columns: @@ -151,7 +143,7 @@ The above output shows that Region 96 was split, with a new Region 98 being crea For a more detailed example: ```sql -mysql> show table t regions; +mysql> SHOW TABLE t REGIONS; +-----------+--------------+--------------+-----------+-----------------+---------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ | REGION_ID | START_KEY | END_KEY | LEADER_ID | LEADER_STORE_ID | PEERS | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS | SCHEDULING_CONSTRAINTS | SCHEDULING_STATE | +-----------+--------------+--------------+-----------+-----------------+---------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ @@ -175,7 +167,7 @@ In the above example: To check the Region that corresponds to table t in store 1, use the `WHERE` clause: ```sql -test> show table t regions where leader_store_id =1; +test> SHOW TABLE t REGIONS WHERE leader_store_id =1; +-----------+-----------+---------+-----------+-----------------+--------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ | REGION_ID | START_KEY | END_KEY | LEADER_ID | LEADER_STORE_ID | PEERS | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS | SCHEDULING_CONSTRAINTS | SCHEDULING_STATE | +-----------+-----------+---------+-----------+-----------------+--------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ @@ -186,7 +178,7 @@ test> show table t regions where leader_store_id =1; Use `SPLIT TABLE REGION` to split the index data into Regions. In the following example, the index data `name` of table t is split into two Regions in the range of `[a,z]`. ```sql -test> split table t index name between ("a") and ("z") regions 2; +test> SPLIT TABLE t INDEX name BETWEEN ("a") AND ("z") REGIONS 2; +--------------------+----------------------+ | TOTAL_SPLIT_REGION | SCATTER_FINISH_RATIO | +--------------------+----------------------+ @@ -198,7 +190,7 @@ test> split table t index name between ("a") and ("z") regions 2; Now table t corresponds to seven Regions. Five of them (`102`, `106`, `110`, `114`, `3`) store the record data of table t and another two (`135`, `98`) store the index data `name`. ```sql -test> show table t regions; +test> SHOW TABLE t REGIONS; +-----------+-----------------------------+-----------------------------+-----------+-----------------+---------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ | REGION_ID | START_KEY | END_KEY | LEADER_ID | LEADER_STORE_ID | PEERS | SCATTERING | WRITTEN_BYTES | READ_BYTES | APPROXIMATE_SIZE(MB) | APPROXIMATE_KEYS | SCHEDULING_CONSTRAINTS | SCHEDULING_STATE | +-----------+-----------------------------+-----------------------------+-----------+-----------------+---------------+------------+---------------+------------+----------------------+------------------+------------------------+------------------+ From 09f04ca7248c157c1acd23bce4aa92a0477122ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Wed, 10 Apr 2024 06:43:57 +0200 Subject: [PATCH 2/4] Update sql-statements/sql-statement-show-table-regions.md Co-authored-by: kennytm --- sql-statements/sql-statement-show-table-regions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sql-statements/sql-statement-show-table-regions.md b/sql-statements/sql-statement-show-table-regions.md index edee55c36bfe4..87e31e0866587 100644 --- a/sql-statements/sql-statement-show-table-regions.md +++ b/sql-statements/sql-statement-show-table-regions.md @@ -23,7 +23,7 @@ SHOW TABLE [table_name] INDEX [index_name] REGIONS [WhereClauseOptional]; ```ebnf+diagram ShowTableRegionStmt ::= - "SHOW" "TABLE" TableName PartitionNameList? ("INDEX" IndexName)? "REGIONS" ShowLikeOrWhere? + "SHOW" "TABLE" TableName PartitionNameList? ("INDEX" IndexName)? "REGIONS" ("WHERE" Expression)? TableName ::= (SchemaName ".")? Identifier From 11b8bd8cac46bf6cd3ef813f0b9774710ceaefbc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dani=C3=ABl=20van=20Eeden?= Date: Wed, 10 Apr 2024 12:01:05 +0200 Subject: [PATCH 3/4] Update sql-statements/sql-statement-show-table-regions.md Co-authored-by: kennytm --- sql-statements/sql-statement-show-table-regions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/sql-statements/sql-statement-show-table-regions.md b/sql-statements/sql-statement-show-table-regions.md index 87e31e0866587..740ca391b5772 100644 --- a/sql-statements/sql-statement-show-table-regions.md +++ b/sql-statements/sql-statement-show-table-regions.md @@ -28,9 +28,6 @@ ShowTableRegionStmt ::= TableName ::= (SchemaName ".")? Identifier -ShowLikeOrWhere ::= - "LIKE" SimpleExpr -| "WHERE" Expression ``` Executing `SHOW TABLE REGIONS` returns the following columns: From dc1eb0b3b39ee9642bd3e8a69f66307139d02a1f Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Mon, 22 Apr 2024 14:49:35 +0800 Subject: [PATCH 4/4] Remove an extra line --- sql-statements/sql-statement-show-table-regions.md | 1 - 1 file changed, 1 deletion(-) diff --git a/sql-statements/sql-statement-show-table-regions.md b/sql-statements/sql-statement-show-table-regions.md index 740ca391b5772..b3ed1f3441750 100644 --- a/sql-statements/sql-statement-show-table-regions.md +++ b/sql-statements/sql-statement-show-table-regions.md @@ -27,7 +27,6 @@ ShowTableRegionStmt ::= TableName ::= (SchemaName ".")? Identifier - ``` Executing `SHOW TABLE REGIONS` returns the following columns: