Skip to main content

SHOW Queries

SHOW CREATE TABLE​

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

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

SHOW DATABASES​

Выводит список всех баз данных.

SHOW DATABASES [LIKE | ILIKE | NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]

Этот запрос идентичен запросу:

SELECT name FROM system.databases [WHERE name LIKE | ILIKE | NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]

Примеры​

Получение списка баз данных, имена которых содержат последовательность символов 'de':

SHOW DATABASES LIKE '%de%'

Результат:

┌─name────┐
│ default │
└─────────┘

Получение списка баз данных, имена которых содержат последовательность символов 'de' независимо от регистра:

SHOW DATABASES ILIKE '%DE%'

Результат:

┌─name────┐
│ default │
└─────────┘

Получение списка баз данных, имена которых не содержат последовательность символов 'de':

SHOW DATABASES NOT LIKE '%de%'

Результат:

┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system                         │
│ test                           │
│ tutorial                       │
└────────────────────────────────┘

Получение первых двух строк из списка имен баз данных:

SHOW DATABASES LIMIT 2

Результат:

┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default                        │
└────────────────────────────────┘

Смотрите также​

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 | ILIKE | NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

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

Этот запрос идентичен запросу:

SELECT name FROM system.tables [WHERE name LIKE | ILIKE | NOT LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]

Примеры​

Получение списка таблиц, имена которых содержат последовательность символов 'user':

SHOW TABLES FROM system LIKE '%user%'

Результат:

┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘

Получение списка таблиц, имена которых содержат последовательность символов 'user' без учета регистра:

SHOW TABLES FROM system ILIKE '%USER%'

Результат:

┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘

Получение списка таблиц, имена которых не содержат символ 's':

SHOW TABLES FROM system NOT LIKE '%s%'

Результат:

┌─name─────────┐
│ metric_log   │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘

Получение первых двух строк из списка таблиц:

SHOW TABLES FROM system LIMIT 2

Результат:

┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log        │
└────────────────────────────────┘

Смотрите также​

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 user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]

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

WITH IMPLICIT добавляет неявные привилегии (например GRANT SELECT ON system.one).

FINAL объединяет все текущие привилегии с привилегиями всех ролей пользователя (с наследованием).

SHOW CREATE USER​

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

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

Синтаксис​

SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]

SHOW CREATE ROLE​

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

Синтаксис​

SHOW CREATE ROLE name1 [, name2 ...]

SHOW CREATE ROW POLICY​

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

Синтаксис​

SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]

SHOW CREATE QUOTA​

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

Синтаксис​

SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]

SHOW CREATE SETTINGS PROFILE​

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

Синтаксис​

SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]

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

SHOW ACCESS​

Выводит список всех пользователей, ролей, профилей и пр., а также все привилегии.

Синтаксис​

SHOW ACCESS

SHOW CLUSTER(s)​

Возвращает список кластеров. Все доступные кластеры перечислены в таблице system.clusters.

Примечание

По запросу SHOW CLUSTER name вы получите содержимое таблицы system.clusters для этого кластера.

Синтаксис​

SHOW CLUSTER '<name>'
SHOW CLUSTERS [LIKE|NOT LIKE '<pattern>'] [LIMIT <N>]

Примеры​

Запрос:

SHOW CLUSTERS;

Результат:

┌─cluster──────────────────────────────────────┐
│ test_cluster_two_shards                      │
│ test_cluster_two_shards_internal_replication │
│ test_cluster_two_shards_localhost            │
│ test_shard_localhost                         │
│ test_shard_localhost_secure                  │
│ test_unavailable_shard                       │
└──────────────────────────────────────────────┘

Запрос:

SHOW CLUSTERS LIKE 'test%' LIMIT 1;

Результат:

┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘

Запрос:

SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;

Результат:

Row 1:
──────
cluster:                 test_shard_localhost
shard_num:               1
shard_weight:            1
replica_num:             1
host_name:               localhost
host_address:            127.0.0.1
port:                    9000
is_local:                1
user:                    default
default_database:
errors_count:            0
estimated_recovery_time: 0

SHOW SETTINGS​

Возвращает список системных настроек и их значений. Использует данные из таблицы system.settings.

Синтаксис

SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>

Секции

При использовании LIKE|ILIKE можно задавать шаблон для имени настройки. Этот шаблон может содержать символы подстановки, такие как % или _. При использовании LIKE шаблон чувствителен к регистру, а при использовании ILIKE — не чувствителен.

Если используется CHANGED, запрос вернет только те настройки, значения которых были изменены, т.е. отличны от значений по умолчанию.

Примеры

Запрос с использованием LIKE:

SHOW SETTINGS LIKE 'send_timeout';

Результат:

┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300   │
└──────────────┴─────────┴───────┘

Запрос с использованием ILIKE:

SHOW SETTINGS ILIKE '%CONNECT_timeout%'

Результат:

┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout                         │ Seconds      │ 10    │
│ connect_timeout_with_failover_ms        │ Milliseconds │ 50    │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100   │
└─────────────────────────────────────────┴──────────────┴───────┘

Запрос с использованием CHANGED:

SHOW CHANGED SETTINGS ILIKE '%MEMORY%'

Результат:

┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘

См. также