show

description: 'Документация для SHOW' sidebar_label: 'SHOW' sidebar_position: 37 slug: /sql-reference/statements/show title: 'Операторы SHOW'

примечание

Если вы используете этот оператор для получения запроса 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	Тип данных столбца. Если запрос был сделан через протокол передачи данных MySQL, то показывается эквивалентное имя типа в MySQL.	String
null	YES, если тип данных столбца является Nullable, 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	Потребление памяти процесса слияния.

Синтаксис

Примеры