Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.settings

View as MarkdownEdit this pageReport an issueSet up docs MCP

Descripción

Contiene información sobre los ajustes de sesión del usuario actual.

Columnas

  • name (String) — Nombre del ajuste.
  • value (String) — Valor del ajuste.
  • changed (UInt8) — Muestra si el ajuste se definió explícitamente en la configuración o se cambió explícitamente.
  • description (String) — Breve descripción del ajuste.
  • min (Nullable(String)) — Valor mínimo del ajuste, si se ha establecido alguno mediante restricciones. Si el ajuste no tiene valor mínimo, contiene NULL.
  • max (Nullable(String)) — Valor máximo del ajuste, si se ha establecido alguno mediante restricciones. Si el ajuste no tiene valor máximo, contiene NULL.
  • disallowed_values (Array(String)) — Lista de valores no permitidos
  • readonly (UInt8) — Muestra si el usuario actual puede cambiar el ajuste: 0 — El usuario actual puede cambiar el ajuste, 1 — El usuario actual no puede cambiar el ajuste.
  • type (String) — El tipo de valor que se puede asignar a este ajuste.
  • default (String) — Valor predeterminado del ajuste.
  • alias_for (String) — Nombre del ajuste original si este ajuste es un alias de otro ajuste.
  • is_obsolete (UInt8) — Muestra si un ajuste está obsoleto.
  • tier (Enum8('Production' = 0, 'Obsolete' = 4, 'Experimental' = 8, 'Beta' = 12, 'PrivatePreview' = 16)) — Nivel de soporte de esta característica. Las características de ClickHouse se organizan en niveles, que varían según el estado actual de su desarrollo y las expectativas que se pueden tener al utilizarlas:
    • PRODUCTION: La característica es estable, segura de usar y no presenta problemas al interactuar con otras características PRODUCTION.
    • BETA: La característica es estable y segura. Se desconoce el resultado de usarla junto con otras características y no se garantiza su correcto funcionamiento. Se agradecen las pruebas y los informes.
    • EXPERIMENTAL: La característica está en desarrollo. Está destinada solo a desarrolladores y entusiastas de ClickHouse. Puede funcionar o no, y podría eliminarse en cualquier momento.
    • PRIVATE PREVIEW: La característica tiene un camino claro hacia la disponibilidad general. Su aplicabilidad sigue siendo limitada y no se recomienda su uso en producción.
    • OBSOLETE: Ya no es compatible. O bien ya se ha eliminado o se eliminará en futuras versiones.

Ejemplo

El siguiente ejemplo muestra cómo obtener información sobre los ajustes cuyo nombre contiene 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

El uso de WHERE changed puede ser útil, por ejemplo, cuando quieras comprobar:

  • Si los ajustes definidos en los archivos de configuración se han cargado correctamente y se están utilizando.
  • Qué ajustes han cambiado en la sesión actual.
SELECT * FROM system.settings WHERE changed AND name='load_balancing'

Véase también

Navigation