Команды SHOW

примечание

SHOW CREATE (TABLE|DATABASE|USER) скрывает секреты, если не включены следующие настройки:

• display_secrets_in_show_and_select (настройка сервера)
• format_display_secrets_in_show_and_select (формат настройки)

Кроме того, пользователь должен иметь привилегию displaySecretsInShowAndSelect.

SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE

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

Синтаксис

примечание

Если вы используете эту команду для получения запроса CREATE системных таблиц, вы получите фальшивый запрос, который лишь объявляет структуру таблицы, но не может быть использован для создания таблицы.

SHOW DATABASES

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

Синтаксис

Она эквивалентна запросу:

Примеры

В этом примере мы используем SHOW для получения имен баз данных, содержащих последовательность символов 'de' в своих названиях:

Мы также можем сделать это без учета регистра:

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

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

См. также

• CREATE DATABASE

SHOW TABLES

Команда SHOW TABLES отображает список таблиц.

Синтаксис

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

Эта команда эквивалентна запросу:

Примеры

В этом примере мы используем команду SHOW TABLES, чтобы найти все таблицы, содержащие 'user' в своих названиях:

Мы можем также сделать это без учета регистра:

Либо найти таблицы, которые не содержат букву 's' в своих названиях:

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

См. также

• Create Tables
• SHOW CREATE TABLE

SHOW COLUMNS

Команда SHOW COLUMNS отображает список колонок.

Синтаксис

Имя базы данных и таблицы можно указать в сокращенной форме как <db>.<table>, что означает, что FROM tab FROM db и FROM db.tab эквивалентны. Если база данных не указана, запрос возвращает список колонок из текущей базы данных.

Существует также два дополнительных ключевых слова: EXTENDED и FULL. Ключевое слово EXTENDED в настоящее время не имеет эффекта и существует для совместимости с MySQL. Ключевое слово FULL заставляет выводить дополнительные колонки, такие как сортировка, комментарии и привилегии.

Команда SHOW COLUMNS выдает результат в виде таблицы со следующей структурой:

Колонка	Описание	Тип
field	Название колонки	String
type	Тип данных колонки. Если запрос был выполнен через wire-протокол MySQL, то будет показано эквивалентное название типа в MySQL.	String
null	YES, если тип данных колонки может содержать NULL, NO в противном случае	String
key	PRI, если колонка является частью первичного ключа, SOR, если колонка является частью сортировочного ключа, пусто в противном случае	String
default	Значение по умолчанию колонки, если она имеет тип ALIAS, DEFAULT или MATERIALIZED, иначе NULL.	Nullable(String)
extra	Дополнительная информация, в настоящее время не используется	String
collation	(только если было указано ключевое слово FULL) Сортировка колонки, всегда NULL, так как ClickHouse не поддерживает сортировку по колонкам	Nullable(String)
comment	(только если было указано ключевое слово FULL) Комментарий к колонке	String
privilege	(только если было указано ключевое слово FULL) Привилегия, которой вы обладаете для этой колонки, в настоящее время не доступно	String

Примеры

В этом примере мы будем использовать команду SHOW COLUMNS, чтобы получить информацию обо всех колонках в таблице 'orders', начиная с 'delivery_':

См. также

• system.columns

SHOW DICTIONARIES

Команда SHOW DICTIONARIES отображает список Словарей.

Синтаксис

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

Вы можете получить те же результаты, что и команда SHOW DICTIONARIES, следующим образом:

Примеры

Следующий запрос выбирает первые две строки из списка словарей в базе данных system, названия которых содержат reg.

SHOW INDEX

Отображает список первичных и индексов для пропуска данных таблицы.

Эта команда в основном существует для совместимости с MySQL. Системные таблицы system.tables (для первичных ключей) и system.data_skipping_indices (для индексов пропуска данных) предоставляют эквивалентную информацию, но в формате, более характерном для ClickHouse.

Синтаксис

Имя базы данных и таблицы можно указать в сокращенной форме как <db>.<table>, т.е. FROM tab FROM db и FROM db.tab эквивалентны. Если база данных не указана, запрос предполагает текущую базу данных.

Дополнительное ключевое слово EXTENDED в настоящее время не имеет эффекта и существует для совместимости с MySQL.

Команда выдает результат в виде таблицы со следующей структурой:

Колонка	Описание	Тип
table	Название таблицы.	String
non_unique	Всегда 1, так как ClickHouse не поддерживает ограничения уникальности.	UInt8
key_name	Название индекса, PRIMARY, если индекс является первичным ключом.	String
seq_in_index	Для первичного ключа, позиция колонки начиная с 1. Для индекса пропуска данных: всегда 1.	UInt8
column_name	Для первичного ключа, название колонки. Для индекса пропуска данных: '' (пустая строка), см. поле "expression".	String
collation	Сортировка колонки в индексе: A, если по возрастанию, D, если по убыванию, NULL, если не отсортировано.	Nullable(String)
cardinality	Оценка кардинальности индекса (число уникальных значений в индексе). В настоящее время всегда 0.	UInt64
sub_part	Всегда NULL, потому что ClickHouse не поддерживает префиксы индексов, как MySQL.	Nullable(String)
packed	Всегда NULL, потому что ClickHouse не поддерживает упакованные индексы (как MySQL).	Nullable(String)
null	В настоящее время не используется
index_type	Тип индекса, например, PRIMARY, MINMAX, BLOOM_FILTER и т.д.	String
comment	Дополнительная информация об индексе, в настоящее время всегда '' (пустая строка).	String
index_comment	'' (пустая строка), потому что индексы в ClickHouse не могут иметь поле COMMENT (как в MySQL).	String
visible	Если индекс виден оптимизатору, всегда YES.	String
expression	Для индекса пропуска данных, выражение индекса. Для первичного ключа: '' (пустая строка).	String

Примеры

В этом примере мы используем команду SHOW INDEX, чтобы получить информацию обо всех индексах в таблице 'tbl'

См. также

• system.tables
• system.data_skipping_indices

SHOW PROCESSLIST

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

Синтаксис

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

подсказка

Выполните в консоли:

SHOW GRANTS

Команда SHOW GRANTS показывает привилегии для пользователя.

Синтаксис

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

Модификатор WITH IMPLICIT позволяет показать неявные права (например, GRANT SELECT ON system.one).

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

SHOW CREATE USER

Команда SHOW CREATE USER показывает параметры, которые использовались при создании пользователя.

Синтаксис

SHOW CREATE ROLE

Команда SHOW CREATE ROLE показывает параметры, которые использовались при создании роли.

Синтаксис

SHOW CREATE ROW POLICY

Команда SHOW CREATE ROW POLICY показывает параметры, которые использовались при создании политики строк.

Синтаксис

SHOW CREATE QUOTA

Команда SHOW CREATE QUOTA показывает параметры, которые использовались при создании квоты.

Синтаксис

SHOW CREATE SETTINGS PROFILE

Команда SHOW CREATE SETTINGS PROFILE показывает параметры, которые использовались при создании профиля настроек.

Синтаксис

SHOW USERS

Команда SHOW USERS возвращает список имен учетных записей пользователей. Чтобы увидеть параметры учетных записей пользователей, смотрите системную таблицу system.users.

Синтаксис

SHOW ROLES

Команда SHOW ROLES возвращает список ролей. Чтобы просмотреть другие параметры, смотрите системные таблицы system.roles и system.role_grants.

Синтаксис

SHOW PROFILES

Команда SHOW PROFILES возвращает список профилей настроек. Чтобы просмотреть параметры учетных записей пользователей, смотрите системную таблицу settings_profiles.

Синтаксис

SHOW POLICIES

Команда SHOW POLICIES возвращает список политик строк для указанной таблицы. Чтобы просмотреть параметры учетных записей пользователей, смотрите системную таблицу system.row_policies.

Синтаксис

SHOW QUOTAS

Команда SHOW QUOTAS возвращает список квот. Чтобы просмотреть параметры квот, смотрите системную таблицу system.quotas.

Синтаксис

SHOW QUOTA

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

Синтаксис

SHOW ACCESS

Команда SHOW ACCESS отображает всех пользователей, роли, профили и т.д., а также все их привилегии.

Синтаксис

SHOW CLUSTER(S)

Команда SHOW CLUSTER(S) возвращает список кластеров. Все доступные кластеры перечислены в таблице system.clusters.

примечание

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

Синтаксис

Примеры

SHOW SETTINGS

Команда SHOW SETTINGS возвращает список системных настроек и их значений. Она выбирает данные из таблицы system.settings.

Синтаксис

Клаузы

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

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

Примеры

Запрос с клаузой LIKE:

Запрос с клаузой ILIKE:

Запрос с клаузой CHANGED:

SHOW SETTING

Команда SHOW SETTING выводит значение настройки для указанного имени настройки.

Синтаксис

См. также

• system.settings таблица

SHOW FILESYSTEM CACHES

Примеры

См. также

• system.settings таблица

SHOW ENGINES

Команда SHOW ENGINES выводит содержимое таблицы system.table_engines, которая содержит описание движков таблиц, поддерживаемых сервером, и информацию об их возможностях.

Синтаксис

См. также

• system.table_engines таблица

SHOW FUNCTIONS

Команда SHOW FUNCTIONS выводит содержимое таблицы system.functions.

Синтаксис

Если указана либо клаузула LIKE, либо ILIKE, запрос возвращает список системных функций, имена которых соответствуют указанному <pattern>.

См. также

• system.functions таблица

SHOW MERGES

Команда SHOW MERGES возвращает список слияний. Все слияния перечислены в таблице system.merges:

Колонка	Описание
table	Название таблицы.
database	Название базы данных, в которой находится таблица.
estimate_complete	Оценочное время завершения (в секундах).
elapsed	Время, прошедшее (в секундах) с начала слияния.
progress	Процент завершенной работы (от 0 до 100 процентов).
is_mutation	1, если этот процесс является частью мутации.
size_compressed	Общий размер сжатых данных объединенных частей.
memory_usage	Потребление памяти процесса слияния.

Синтаксис

Примеры