Инструкции 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.

Инструкция produces результирующую таблицу со следующей структурой:

Колонка	Описание	Тип
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 отображает cluster, shard_num, replica_num, host_name, host_address и port таблицы 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	Потребление памяти процесса слияния.

Синтаксис

Примеры