system.settings

Tabela de sistema com informações sobre as configurações de sessão do usuário atual.

​

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)) — 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.
• 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: Define o número mínimo de linhas no bloco que podem ser inseridas em uma tabela por uma consulta `INSERT`. Blocos menores são compactados em blocos maiores.

Possible values:

- Inteiro positivo.
- 0 — Compactação desativada.
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: Define o número mínimo de bytes no bloco que podem ser inseridos em uma tabela por uma consulta `INSERT`. Blocos menores são compactados em blocos maiores.

Possible values:

- Inteiro positivo.
- 0 — Compactação desativada.
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: Define o número mínimo de linhas no bloco que podem ser inseridas em uma tabela por uma consulta `INSERT`. Blocos menores são compactados em blocos maiores. Esta configuração é aplicada apenas para blocos inseridos em [visão materializada](/reference/statements/create/view). Ao ajustar esta configuração, você controla a compactação de blocos ao enviar para a visão materializada e evita o uso excessivo de memória.

Possible values:

- Qualquer inteiro positivo.
- 0 — Compactação desativada.

<div id="see-also">
  ## Veja também
</div>

- [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: Define o número mínimo de bytes no bloco que podem ser inseridos em uma tabela por uma consulta `INSERT`. Blocos menores são compactados em blocos maiores. Esta configuração é aplicada apenas para blocos inseridos em [visão materializada](/reference/statements/create/view). Ao ajustar esta configuração, você controla a compactação de blocos ao enviar para a visão materializada e evita o uso excessivo de memória.

Possible values:

- Qualquer inteiro positivo.
- 0 — Compactação desativada.

<div id="see-also">
  ## Veja também
</div>

- [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

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

• Configurações
• Permissões para consultas
• Restrições nas configurações
• instrução SHOW SETTINGS