Операторы 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 отображает список таблиц.

Синтаксис

Если clause 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	Тип данных столбца. Если запрос был выполнен через протокол проводного соединения 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 отображает список Словарей.

Синтаксис

Если clause 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	Использование памяти процесса слияния.

Синтаксис

Примеры