From 8a3604802cde2a72837f30aa5aeaa588f27548d9 Mon Sep 17 00:00:00 2001 From: Shuaipeng Yu Date: Mon, 25 May 2020 13:05:06 +0800 Subject: [PATCH 1/3] add show config statement Signed-off-by: Shuaipeng Yu --- sql-statements/sql-statement-show-config.md | 94 +++++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 sql-statements/sql-statement-show-config.md diff --git a/sql-statements/sql-statement-show-config.md b/sql-statements/sql-statement-show-config.md new file mode 100644 index 000000000000..d62f5bc4dd50 --- /dev/null +++ b/sql-statements/sql-statement-show-config.md @@ -0,0 +1,94 @@ +--- +title: SHOW CONFIG +summary: TiDB 数据库中 SHOW CONFIG 的使用概况。 +category: reference +aliases: ['/docs-cn/dev/reference/sql/statements/show-config/'] +--- + +# SHOW CONFIG + +> **警告：** +> +> 当前该功能为实验特性，不建议在生产环境中使用。 + +`SHOW CONFIG` 语句用于展示 TiDB 各个组件当前正在应用的配置，请注意，配置与系统变量作用于不同维度，请不要混淆，如果希望获取系统变量信息，请使用 [SHOW VARIABLES](/sql-statements/sql-statement-show-variables.md) 语法。 + +## 语法图 + +**ShowStmt:** + +![ShowStmt](/media/sqlgram/ShowStmt.png) + +**ShowTargetFilterable:** + +![ShowTargetFilterable](/media/sqlgram/ShowTargetFilterable.png) + +## 示例 + +显示所有配置： + +{{< copyable "sql" >}} + +```sql +SHOW CONFIG; +``` + +``` ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| Type | Instance | Name | Value | ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| tidb | 127.0.0.1:4000 | advertise-address | 127.0.0.1 | +| tidb | 127.0.0.1:4000 | alter-primary-key | false | +| tidb | 127.0.0.1:4000 | binlog.binlog-socket | | +| tidb | 127.0.0.1:4000 | binlog.enable | false | +... +120 rows in set (0.01 sec) +``` + +显示 `type` 是 `tidb` 的配置： + +{{< copyable "sql" >}} + +```sql +SHOW CONFIG WHERE type = 'tidb'; +``` + +``` ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| Type | Instance | Name | Value | ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| tidb | 127.0.0.1:4000 | advertise-address | 127.0.0.1 | +| tidb | 127.0.0.1:4000 | alter-primary-key | false | +| tidb | 127.0.0.1:4000 | binlog.binlog-socket | | +| tidb | 127.0.0.1:4000 | binlog.enable | false | +... +40 rows in set (0.01 sec) +``` + +也可以用 `LIKE` 子句来显示 `type` 是 `tidb` 的配置： + +{{< copyable "sql" >}} + +```sql +SHOW CONFIG LIKE 'tidb'; +``` + +``` ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| Type | Instance | Name | Value | ++------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ +| tidb | 127.0.0.1:4000 | advertise-address | 127.0.0.1 | +| tidb | 127.0.0.1:4000 | alter-primary-key | false | +| tidb | 127.0.0.1:4000 | binlog.binlog-socket | | +| tidb | 127.0.0.1:4000 | binlog.enable | false | +... +40 rows in set (0.01 sec) +``` + +## MySQL 兼容性 + +`SHOW CONFIG` 是 TiDB 的扩展语法，MySQL 没有对应的语法。 + +## 另请参阅 + +* [SHOW VARIABLES](/sql-statements/sql-statement-show-variables.md) From b94c380c8adf32bad24cd9929aa8a83849515c81 Mon Sep 17 00:00:00 2001 From: Shuaipeng Yu Date: Mon, 25 May 2020 16:02:41 +0800 Subject: [PATCH 2/3] address comments Signed-off-by: Shuaipeng Yu --- sql-statements/sql-statement-show-config.md | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/sql-statements/sql-statement-show-config.md b/sql-statements/sql-statement-show-config.md index d62f5bc4dd50..370a7e6c92f4 100644 --- a/sql-statements/sql-statement-show-config.md +++ b/sql-statements/sql-statement-show-config.md @@ -50,19 +50,16 @@ SHOW CONFIG; {{< copyable "sql" >}} ```sql -SHOW CONFIG WHERE type = 'tidb'; +SHOW CONFIG WHERE type = 'tidb' AND name = 'advertise-address'; ``` ``` -+------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ -| Type | Instance | Name | Value | -+------+----------------+-------------------------------------------------+---------------------------------------------------------------------+ -| tidb | 127.0.0.1:4000 | advertise-address | 127.0.0.1 | -| tidb | 127.0.0.1:4000 | alter-primary-key | false | -| tidb | 127.0.0.1:4000 | binlog.binlog-socket | | -| tidb | 127.0.0.1:4000 | binlog.enable | false | -... -40 rows in set (0.01 sec) ++------+----------------+-------------------+-----------+ +| Type | Instance | Name | Value | ++------+----------------+-------------------+-----------+ +| tidb | 127.0.0.1:4000 | advertise-address | 127.0.0.1 | ++------+----------------+-------------------+-----------+ +1 row in set (0.05 sec) ``` 也可以用 `LIKE` 子句来显示 `type` 是 `tidb` 的配置： From 4c80aea258b4ecae5d5afe32e81efe41535e9b23 Mon Sep 17 00:00:00 2001 From: Shuaipeng Yu Date: Mon, 25 May 2020 16:50:46 +0800 Subject: [PATCH 3/3] remove aliases Signed-off-by: Shuaipeng Yu --- sql-statements/sql-statement-show-config.md | 1 - 1 file changed, 1 deletion(-) diff --git a/sql-statements/sql-statement-show-config.md b/sql-statements/sql-statement-show-config.md index 370a7e6c92f4..ea4d6f47fb8c 100644 --- a/sql-statements/sql-statement-show-config.md +++ b/sql-statements/sql-statement-show-config.md @@ -2,7 +2,6 @@ title: SHOW CONFIG summary: TiDB 数据库中 SHOW CONFIG 的使用概况。 category: reference -aliases: ['/docs-cn/dev/reference/sql/statements/show-config/'] --- # SHOW CONFIG