system.settings

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

Столбцы:

name (String) — Имя настройки.
value (String) — Значение настройки.
changed (UInt8) — Показывает, была ли настройка явно задана в конфигурации или явно изменена.
description (String) — Краткое описание настройки.
min (Nullable(String)) — Минимальное значение настройки, если оно задано через constraints. Если для настройки не задано минимальное значение, содержит NULL.
max (Nullable(String)) — Максимальное значение настройки, если оно задано через constraints. Если для настройки не задано максимальное значение, содержит NULL.
disallowed_values (Array(String)) — Список недопустимых значений.
readonly (UInt8) — Показывает, может ли текущий пользователь изменять настройку:
- 0 — Текущий пользователь может изменить настройку.
- 1 — Текущий пользователь не может изменить настройку.
default (String) — Значение настройки по умолчанию.
alias_for (String) — Имя исходной настройки, если данная настройка является псевдонимом другой настройки.
is_obsolete (UInt8) — Показывает, является ли настройка устаревшей.
tier (Enum8) — Уровень поддержки этой возможности. Возможности ClickHouse организованы по уровням, которые различаются в зависимости от текущего статуса их разработки и ожидаемого поведения при их использовании. Значения:
- 'Production' — Функция стабильна, безопасна в использовании и не имеет проблем во взаимодействии с другими production‑функциями.
- 'Beta' — Функция стабильна и безопасна. Результат её совместного использования с другими функциями неизвестен и корректность не гарантируется. Тестирование и отчёты приветствуются.
- 'Experimental' — Функция находится в разработке. Предназначена только для разработчиков и энтузиастов ClickHouse. Функция может как работать, так и не работать и может быть удалена в любой момент.
- 'Obsolete' — Больше не поддерживается. Либо уже удалена, либо будет удалена в будущих релизах.

Пример

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

SELECT *
FROM system.settings
WHERE name LIKE '%min_insert_block_size_%'
FORMAT Vertical

Row 1:
──────
name:        min_insert_block_size_rows
value:       1048449
changed:     0
description: Задаёт минимальное количество строк в блоке, который может быть вставлен в таблицу запросом `INSERT`. Блоки меньшего размера объединяются в более крупные.

Возможные значения:

- Положительное целое число.
- 0 — объединение отключено.
min:         ᴺᵁᴸᴸ
max:         ᴺᵁᴸᴸ
readonly:    0
type:        UInt64
default:     1048449
alias_for:   
is_obsolete: 0
tier:        Production

Row 2:
──────
name:        min_insert_block_size_bytes
value:       268402944
changed:     0
description: Задаёт минимальное количество байтов в блоке, который может быть вставлен в таблицу запросом `INSERT`. Блоки меньшего размера объединяются в более крупные.

Возможные значения:

- Положительное целое число.
- 0 — объединение отключено.
min:         ᴺᵁᴸᴸ
max:         ᴺᵁᴸᴸ
readonly:    0
type:        UInt64
default:     268402944
alias_for:   
is_obsolete: 0
tier:        Production

Row 3: ────── name: min_insert_block_size_rows_for_materialized_views value: 0 changed: 0 description: Задает минимальное количество строк в блоке, которое может быть вставлено в таблицу запросом INSERT. Блоки меньшего размера объединяются в более крупные. Этот параметр применяется только к блокам, вставляемым в материализованное представление. Настраивая этот параметр, вы управляете объединением блоков при записи в материализованное представление и избегаете чрезмерного потребления памяти.

Possible values:

Любое положительное целое число.
0 — объединение отключено.

See Also

min_insert_block_size_rows min: ᴺᵁᴸᴸ max: ᴺᵁᴸᴸ readonly: 0 type: UInt64 default: 0 alias_for:
is_obsolete: 0 tier: Production

Row 4: ────── name: min_insert_block_size_bytes_for_materialized_views value: 0 changed: 0 description: Задает минимальное количество байт в блоке, которое может быть вставлено в таблицу запросом INSERT. Блоки меньшего размера объединяются в более крупные. Этот параметр применяется только к блокам, вставляемым в материализованное представление. Настраивая этот параметр, вы управляете объединением блоков при записи в материализованное представление и избегаете чрезмерного потребления памяти.

Possible values:

Любое положительное целое число.
0 — объединение отключено.

See also

min_insert_block_size_bytes min: ᴺᵁᴸᴸ max: ᴺᵁᴸᴸ readonly: 0 type: UInt64 default: 0 alias_for:
is_obsolete: 0 tier: Production


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

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

<!-- -->

```sql
SELECT * FROM system.settings WHERE changed AND name='load_balancing'

См. также