Skip to main content

system.settings

Содержит информацию о сессионных настройках для текущего пользователя.

Столбцы:

  • name (String) — имя настройки.
  • value (String) — значение настройки.
  • changed (UInt8) — показывает, изменена ли настройка по отношению к значению по умолчанию.
  • description (String) — краткое описание настройки.
  • min (Nullable(String)) — минимальное значение настройки, если задано ограничение. Если нет, то поле содержит NULL.
  • max (Nullable(String)) — максимальное значение настройки, если задано ограничение. Если нет, то поле содержит NULL.
  • readonly (UInt8) — Показывает, может ли пользователь изменять настройку:
    • 0 — Текущий пользователь может изменять настройку.
    • 1 — Текущий пользователь не может изменять настройку.
  • default (String) — значению настройки по умолчанию.

Пример

Пример показывает как получить информацию о настройках, имена которых содержат min_i.

SELECT *
FROM system.settings
WHERE name LIKE '%min_i%'
┌─name────────────────────────────────────────┬─value─────┬─changed─┬─description───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┬─min──┬─max──┬─readonly─┐
│ min_insert_block_size_rows                  │ 1048576   │       0 │ Squash blocks passed to INSERT query to specified size in rows, if blocks are not big enough.                                                                         │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │        0 │
│ min_insert_block_size_bytes                 │ 268435456 │       0 │ Squash blocks passed to INSERT query to specified size in bytes, if blocks are not big enough.                                                                        │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │        0 │
│ read_backoff_min_interval_between_events_ms │ 1000      │       0 │ Settings to reduce the number of threads in case of slow reads. Do not pay attention to the event, if the previous one has passed less than a certain amount of time. │ ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ │        0 │
└─────────────────────────────────────────────┴───────────┴─────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┴──────┴──────┴──────────┘

Использование WHERE changed может быть полезно, например, если необходимо проверить:

  • Что настройки корректно загрузились из конфигурационного файла и используются.
  • Настройки, изменённые в текущей сессии.
SELECT * FROM system.settings WHERE changed AND name='load_balancing'

Cм. также