Перейти к основному содержимому
Перейти к основному содержимому

Инструкции SHOW

примечание

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

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

SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE

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

Синтаксис

примечание

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

SHOW DATABASES

Эта инструкция выводит список всех баз данных.

Синтаксис

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

Примеры

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

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

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

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

См. также

SHOW TABLES

Инструкция SHOW TABLES отображает список таблиц.

Синтаксис

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

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

Примеры

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

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

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

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

См. также

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
nullYES, если тип данных колонки допускает значения NULL, NO в противном случаеString
keyPRI, если колонка является частью первичного ключа, 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_':

См. также

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':

См. также

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 выводит значение настройки для указанного имени настройки.

Синтаксис

См. также

SHOW FILESYSTEM CACHES

Примеры

См. также

SHOW ENGINES

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

Синтаксис

См. также

SHOW FUNCTIONS

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

Синтаксис

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

См. также

SHOW MERGES

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

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

Синтаксис

Примеры