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

SHOW VARIABLES

Описание​

Этот оператор используется для отображения системных переменных Doris с возможностью отбора по условиям

Синтаксис​

SHOW [<effective_scope>] VARIABLES [<like_pattern> | <where clause>]

Необязательные параметры​

1. <effective_scope>

Область действия может принимать одно из значений: GLOBAL, SESSION или LOCAL. Если область действия не указана, по умолчанию используется SESSION. LOCAL является псевдонимом SESSION.

2. <like_pattern>

Используется оператор like для сопоставления и фильтрации результатов

3. <where>

Используется условие where для сопоставления и фильтрации результатов

Требования к управлению доступом​

Пользователи, выполняющие эту команду SQL, должны иметь как минимум следующие привилегии:

ПривилегияОбъектПримечания
N/ASessionДля просмотра переменных специальные привилегии не требуются

Возвращаемое значение​

Variable_nameValueDefault_ValueChanged
имя переменной1значение1значение по умолчанию10/1
имя переменной2значение2значение по умолчанию20/1

Примечания по использованию​

  • Команда Show variables в основном используется для просмотра значений системных переменных.
  • Для выполнения команды SHOW VARIABLES не требуются никакие привилегии: достаточно иметь возможность подключиться к серверу.
  • В столбце Changed из раздела Return Value значение 0 означает отсутствие изменений, а 1 означает наличие изменений.
  • При использовании оператора SHOW действуют следующие ограничения:
    • В условии where нельзя использовать or
    • Имена столбцов должны находиться слева
    • В условии where поддерживаются только сравнения на равенство
    • Для сопоставления с variable_name используется оператор like.
    • Подстановочный символ процента % можно использовать в любом месте шаблона сопоставления

Пример​

  • По умолчанию сопоставление выполняется по Variable_name; в этом примере используется точное совпадение

    show variables like 'max_connections';
  • С помощью подстановочного символа процента (%) можно найти несколько совпадений

    show variables like '%connec%';
  • Использование условия Where для запросов с сопоставлением

    show variables where variable_name = 'version';