Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.settings

View as MarkdownEdit this pageReport an issueSet up docs MCP

Descrição

Contém informações sobre as configurações de sessão do usuário atual.

Colunas

  • name (String) — Nome da configuração.
  • value (String) — Valor da configuração.
  • changed (UInt8) — Mostra se a configuração foi definida explicitamente no arquivo de configuração ou alterada explicitamente.
  • description (String) — Breve descrição da configuração.
  • min (Nullable(String)) — Valor mínimo da configuração, se houver algum definido por meio de restrições. Se a configuração não tiver valor mínimo, contém NULL.
  • max (Nullable(String)) — Valor máximo da configuração, se houver algum definido por meio de restrições. Se a configuração não tiver valor máximo, contém NULL.
  • disallowed_values (Array(String)) — Lista de valores não permitidos
  • readonly (UInt8) — Mostra se o usuário atual pode alterar a configuração: 0 — O usuário atual pode alterar a configuração, 1 — O usuário atual não pode alterar a configuração.
  • type (String) — O tipo de valor que pode ser atribuído a esta configuração.
  • default (String) — Valor padrão da configuração.
  • alias_for (String) — O nome da configuração original se a configuração for um alias de outra configuração.
  • is_obsolete (UInt8) — Mostra se uma configuração está obsoleta.
  • tier (Enum8('Production' = 0, 'Obsolete' = 4, 'Experimental' = 8, 'Beta' = 12, 'PrivatePreview' = 16)) — Nível de suporte deste recurso. Os recursos do ClickHouse são organizados em níveis, que variam conforme o estágio atual de seu desenvolvimento e as expectativas que se pode ter ao usá-los:
    • PRODUCTION: O recurso é stable, seguro para uso e não apresenta problemas de interação com outros recursos PRODUCTION.
    • BETA: O recurso é stable e seguro. O resultado de usá-lo em conjunto com outros recursos é desconhecido, e a correção não é garantida. Testes e relatos são bem-vindos.
    • EXPERIMENTAL: O recurso está em desenvolvimento. Destina-se apenas a desenvolvedores e entusiastas do ClickHouse. O recurso pode ou não funcionar e pode ser removido a qualquer momento.
    • PRIVATE PREVIEW: O recurso está em um caminho claro para a disponibilidade geral. Sua aplicabilidade ainda é limitada, e seu uso em produção não é recomendado.
    • OBSOLETE: Não é mais compatível. Ou já foi removido ou será removido em lançamentos futuros.

Exemplo

O exemplo a seguir mostra como obter informações sobre configurações cujos nomes contêm 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#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#min_insert_block_size_bytes)
min:         ᴺᵁᴸᴸ
max:         ᴺᵁᴸᴸ
readonly:    0
type:        UInt64
default:     0
alias_for:   
is_obsolete: 0
tier:        Production

Usar WHERE changed pode ser útil, por exemplo, quando você quiser verificar:

  • Se as configurações nos arquivos de configuração foram carregadas corretamente e estão sendo usadas.
  • Quais configurações foram alteradas na sessão atual.
SELECT * FROM system.settings WHERE changed AND name='load_balancing'

Veja também

Navigation