Инструкции 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' в своих именах:
Наконец, мы можем получить имена только первых двух баз данных:
См. также
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 |
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_':
См. также
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
выводит значение настройки для указанного имени настройки.
Синтаксис
См. также
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 | Потребление памяти процесса слияния. |