ClickHouse/docs/ru/sql-reference/statements/show.md
Anna 0a9f6b1805
DOCSUP-2193: Describe SHOW queries for RBAC (#14515)
* Documentation for #10387, upd syntax by issues #12311, #12312

* Update docs/ru/sql-reference/statements/show.md

Co-authored-by: Anna Devyatova <annadevyatova@yandex-team.ru>
Co-authored-by: BayoNet <da-daos@yandex.ru>
2020-09-08 10:35:24 +03:00

8.8 KiB
Raw Blame History

SHOW Queries

SHOW CREATE TABLE

SHOW CREATE [TEMPORARY] [TABLE|DICTIONARY] [db.]table [INTO OUTFILE filename] [FORMAT format]

Возвращает один столбец типа String с именем statement, содержащий одно значение — запрос CREATE TABLE, с помощью которого был создан указанный объект.

SHOW DATABASES

SHOW DATABASES [INTO OUTFILE filename] [FORMAT format]

Выводит список всех баз данных. Запрос полностью аналогичен запросу SELECT name FROM system.databases [INTO OUTFILE filename] [FORMAT format].

SHOW PROCESSLIST

SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]

Выводит содержимое таблицы system.processes, которая содержит список запросов, выполняющихся в данный момент времени, кроме самих запросов SHOW PROCESSLIST.

Запрос SELECT * FROM system.processes возвращает данные обо всех текущих запросах.

Полезный совет (выполните в консоли):

$ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"

SHOW TABLES

Выводит список таблиц.

SHOW [TEMPORARY] TABLES [{FROM | IN} <db>] [LIKE '<pattern>' | WHERE expr] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Если секция FROM не используется, то запрос возвращает список таблиц из текущей базы данных.

Результат, идентичный тому, что выдаёт запрос SHOW TABLES можно получить также запросом следующего вида:

SELECT name FROM system.tables WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Пример

Следующий запрос выбирает первые две строки из списка таблиц в базе данных system, чьи имена содержат co.

SHOW TABLES FROM system LIKE '%co%' LIMIT 2
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ collations                     │
└────────────────────────────────┘

SHOW DICTIONARIES

Выводит список внешних словарей.

SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Если секция FROM не указана, запрос возвращает список словарей из текущей базы данных.

Аналогичный результат можно получить следующим запросом:

SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Example

Запрос выводит первые две стоки из списка таблиц в базе данных system, имена которых содержат reg.

SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
┌─name─────────┐
│ regions      │
│ region_names │
└──────────────┘

SHOW GRANTS

Выводит привилегии пользователя.

Синтаксис

SHOW GRANTS [FOR user]

Если пользователь не задан, запрос возвращает привилегии текущего пользователя.

SHOW CREATE USER

Выводит параметры, использованные при создании пользователя.

SHOW CREATE USER не возвращает пароль пользователя.

Синтаксис

SHOW CREATE USER [name | CURRENT_USER]

SHOW CREATE ROLE

Выводит параметры, использованные при создании роли.

Синтаксис

SHOW CREATE ROLE name

SHOW CREATE ROW POLICY

Выводит параметры, использованные при создании политики доступа к строкам.

Синтаксис

SHOW CREATE [ROW] POLICY name ON [database.]table

SHOW CREATE QUOTA

Выводит параметры, использованные при создании квоты.

Синтаксис

SHOW CREATE QUOTA [name | CURRENT]

SHOW CREATE SETTINGS PROFILE

Выводит параметры, использованные при создании профиля настроек.

Синтаксис

SHOW CREATE [SETTINGS] PROFILE name

SHOW USERS

Выводит список пользовательских аккаунтов. Для просмотра параметров пользовательских аккаунтов, см. системную таблицу system.users.

Синтаксис

SHOW USERS

SHOW ROLES

Выводит список ролей. Для просмотра параметров ролей, см. системные таблицы system.roles и system.role-grants.

Синтаксис

SHOW [CURRENT|ENABLED] ROLES

SHOW PROFILES

Выводит список профилей настроек. Для просмотра других параметров профилей настроек, см. системную таблицу settings_profiles.

Синтаксис

SHOW [SETTINGS] PROFILES

SHOW POLICIES

Выводит список политик доступа к строкам для указанной таблицы. Для просмотра других параметров, см. системную таблицу system.row_policies.

Синтаксис

SHOW [ROW] POLICIES [ON [db.]table]

SHOW QUOTAS

Выводит список квот. Для просмотра параметров квот, см. системную таблицу system.quotas.

Синтаксис

SHOW QUOTAS

SHOW QUOTA

Выводит потребление квоты для всех пользователей или только для текущего пользователя. Для просмотра других параметров, см. системные таблицы system.quotas_usage и system.quota_usage.

Синтаксис

SHOW [CURRENT] QUOTA

Оригинальная статья