system.settings

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

​

Описание

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

​

Столбцы

• name (String) — Имя настройки.
• value (String) — Значение настройки.
• changed (UInt8) — Показывает, была ли настройка явно задана в конфигурации или явно изменена.
• description (String) — Краткое описание настройки.
• min (Nullable(String)) — Минимальное значение настройки, если оно задано через ограничения. Если минимальное значение для настройки не задано, содержит NULL.
• max (Nullable(String)) — Максимальное значение настройки, если оно задано через ограничения. Если максимальное значение для настройки не задано, содержит NULL.
• disallowed_values (Array(String)) — Список недопустимых значений
• readonly (UInt8) — Показывает, может ли текущий пользователь изменить настройку: 0 — текущий пользователь может изменить настройку, 1 — текущий пользователь не может изменить настройку.
• type (String) — Тип значения, которое можно присвоить этой настройке.
• default (String) — Значение настройки по умолчанию.
• alias_for (String) — Имя исходной настройки, если эта настройка является псевдонимом другой настройки.
• is_obsolete (UInt8) — Показывает, является ли настройка устаревшей.
• tier (Enum8(‘Production’ = 0, ‘Obsolete’ = 4, ‘Experimental’ = 8, ‘Beta’ = 12)) — Уровень поддержки этой возможности. Возможности 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: Sets the minimum number of rows in the block that can be inserted into a table by an `INSERT` query. Smaller-sized blocks are squashed into bigger ones.

Possible values:

- Positive integer.
- 0 — Squashing disabled.
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: Sets the minimum number of bytes in the block which can be inserted into a table by an `INSERT` query. Smaller-sized blocks are squashed into bigger ones.

Possible values:

- Positive integer.
- 0 — Squashing disabled.
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: Sets the minimum number of rows in the block which can be inserted into a table by an `INSERT` query. Smaller-sized blocks are squashed into bigger ones. This setting is applied only for blocks inserted into [materialized view](/reference/statements/create/view). By adjusting this setting, you control blocks squashing while pushing to materialized view and avoid excessive memory usage.

Possible values:

- Any positive integer.
- 0 — Squashing disabled.

## See Also            

- [min_insert_block_size_rows](/reference/settings/session-settings#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: Sets the minimum number of bytes in the block which can be inserted into a table by an `INSERT` query. Smaller-sized blocks are squashed into bigger ones. This setting is applied only for blocks inserted into [materialized view](/reference/statements/create/view). By adjusting this setting, you control blocks squashing while pushing to materialized view and avoid excessive memory usage.

Possible values:

- Any positive integer.
- 0 — Squashing disabled.

## See Also            

- [min_insert_block_size_bytes](/reference/settings/session-settings#min_insert_block_size_bytes)
min:         ᴺᵁᴸᴸ
max:         ᴺᵁᴸᴸ
readonly:    0
type:        UInt64
default:     0
alias_for:   
is_obsolete: 0
tier:        Production

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

• Правильно ли загружены и применяются ли настройки из файлов конфигурации.
• Какие настройки были изменены в текущем сеансе.

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

​

См. также

• Настройки
• Разрешения для запросов
• Ограничения для настроек
• SHOW SETTINGS оператор