ClickHouse/docs/en/sql-reference/statements/show.md

168 lines
4.7 KiB
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
toc_priority: 38
toc_title: SHOW
---
2020-07-11 11:05:49 +00:00
# SHOW Statements {#show-queries}
2020-03-20 10:10:48 +00:00
## SHOW CREATE TABLE {#show-create-table}
2020-03-20 10:10:48 +00:00
``` sql
SHOW CREATE [TEMPORARY] [TABLE|DICTIONARY] [db.]table [INTO OUTFILE filename] [FORMAT format]
```
2020-03-20 10:10:48 +00:00
Returns a single `String`-type statement column, which contains a single value the `CREATE` query used for creating the specified object.
2020-03-18 18:43:51 +00:00
## SHOW DATABASES {#show-databases}
2020-03-20 10:10:48 +00:00
``` sql
SHOW DATABASES [INTO OUTFILE filename] [FORMAT format]
```
Prints a list of all databases.
This query is identical to `SELECT name FROM system.databases [INTO OUTFILE filename] [FORMAT format]`.
2020-03-20 10:10:48 +00:00
## SHOW PROCESSLIST {#show-processlist}
2020-03-20 10:10:48 +00:00
``` sql
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
```
Outputs the content of the [system.processes](../../operations/system-tables/processes.md#system_tables-processes) table, that contains a list of queries that is being processed at the moment, excepting `SHOW PROCESSLIST` queries.
The `SELECT * FROM system.processes` query returns data about all the current queries.
Tip (execute in the console):
2020-03-20 10:10:48 +00:00
``` bash
$ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
```
2020-03-20 10:10:48 +00:00
## SHOW TABLES {#show-tables}
Displays a list of tables.
2020-03-20 10:10:48 +00:00
``` sql
2020-02-12 01:23:33 +00:00
SHOW [TEMPORARY] TABLES [{FROM | IN} <db>] [LIKE '<pattern>' | WHERE expr] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```
If the `FROM` clause is not specified, the query returns the list of tables from the current database.
You can get the same results as the `SHOW TABLES` query in the following way:
2020-03-20 10:10:48 +00:00
``` sql
SELECT name FROM system.tables WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```
**Example**
The following query selects the first two rows from the list of tables in the `system` database, whose names contain `co`.
2020-03-20 10:10:48 +00:00
``` sql
SHOW TABLES FROM system LIKE '%co%' LIMIT 2
```
2020-03-20 10:10:48 +00:00
``` text
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ collations │
└────────────────────────────────┘
```
2020-03-20 10:10:48 +00:00
## SHOW DICTIONARIES {#show-dictionaries}
Displays a list of [external dictionaries](../../sql-reference/dictionaries/external-dictionaries/external-dicts.md).
2020-03-20 10:10:48 +00:00
``` sql
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```
If the `FROM` clause is not specified, the query returns the list of dictionaries from the current database.
You can get the same results as the `SHOW DICTIONARIES` query in the following way:
2020-03-20 10:10:48 +00:00
``` sql
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```
**Example**
The following query selects the first two rows from the list of tables in the `system` database, whose names contain `reg`.
2020-03-20 10:10:48 +00:00
``` sql
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
```
2020-03-20 10:10:48 +00:00
``` text
┌─name─────────┐
│ regions │
│ region_names │
└──────────────┘
```
## SHOW GRANTS {#show-grants-statement}
Shows privileges for a user.
### Syntax {#show-grants-syntax}
``` sql
SHOW GRANTS [FOR user]
```
If user is not specified, the query returns privileges for the current user.
## SHOW CREATE USER {#show-create-user-statement}
Shows parameters that were used at a [user creation](../../sql-reference/statements/create/user.md).
`SHOW CREATE USER` doesnt output user passwords.
### Syntax {#show-create-user-syntax}
``` sql
SHOW CREATE USER [name | CURRENT_USER]
```
## SHOW CREATE ROLE {#show-create-role-statement}
Shows parameters that were used at a [role creation](../../sql-reference/statements/create/role.md).
### Syntax {#show-create-role-syntax}
``` sql
SHOW CREATE ROLE name
```
## SHOW CREATE ROW POLICY {#show-create-row-policy-statement}
Shows parameters that were used at a [row policy creation](../../sql-reference/statements/create/row-policy.md).
### Syntax {#show-create-row-policy-syntax}
``` sql
SHOW CREATE [ROW] POLICY name ON [database.]table
```
## SHOW CREATE QUOTA {#show-create-quota-statement}
Shows parameters that were used at a [quota creation](../../sql-reference/statements/create/quota.md).
### Syntax {#show-create-row-policy-syntax}
``` sql
SHOW CREATE QUOTA [name | CURRENT]
```
## SHOW CREATE SETTINGS PROFILE {#show-create-settings-profile-statement}
Shows parameters that were used at a [settings profile creation](../../sql-reference/statements/create/settings-profile.md).
### Syntax {#show-create-row-policy-syntax}
``` sql
SHOW CREATE [SETTINGS] PROFILE name
```
[Original article](https://clickhouse.tech/docs/en/query_language/show/) <!--hide-->