system.settings

Table système contenant des informations sur les paramètres de session de l’utilisateur actuel.

​

Description

Contient des informations sur les paramètres de session de l’utilisateur actuel.

​

Colonnes

• name (String) — Nom du paramètre.
• value (String) — Valeur du paramètre.
• changed (UInt8) — Indique si le paramètre a été explicitement défini dans la config ou explicitement modifié.
• description (String) — Brève description du paramètre.
• min (Nullable(String)) — Valeur minimale du paramètre, si elle est définie via des contraintes. Si le paramètre n’a pas de valeur minimale, contient NULL.
• max (Nullable(String)) — Valeur maximale du paramètre, si elle est définie via des contraintes. Si le paramètre n’a pas de valeur maximale, contient NULL.
• disallowed_values (Array(String)) — Liste des valeurs non autorisées
• readonly (UInt8) — Indique si l’utilisateur actuel peut modifier le paramètre : 0 — L’utilisateur actuel peut modifier le paramètre, 1 — L’utilisateur actuel ne peut pas modifier le paramètre.
• type (String) — Type de la valeur pouvant être attribuée à ce paramètre.
• default (String) — Valeur par défaut du paramètre.
• alias_for (String) — Nom du paramètre d’origine si ce paramètre est un alias d’un autre paramètre.
• is_obsolete (UInt8) — Indique si un paramètre est obsolète.
• tier (Enum8(‘Production’ = 0, ‘Obsolete’ = 4, ‘Experimental’ = 8, ‘Beta’ = 12)) — Niveau de prise en charge de cette fonctionnalité. Les fonctionnalités de ClickHouse sont organisées en niveaux, qui varient selon l’état actuel de leur développement et les attentes que l’on peut avoir quant à leur utilisation :

• PRODUCTION: La fonctionnalité est stable, son utilisation est sûre et elle ne pose pas de problèmes d’interaction avec d’autres fonctionnalités PRODUCTION.
• BETA: La fonctionnalité est stable et sûre. Les résultats de son utilisation avec d’autres fonctionnalités sont inconnus et son bon fonctionnement n’est pas garanti. Les tests et signalements sont les bienvenus.
• EXPERIMENTAL: La fonctionnalité est en cours de développement. Elle est destinée uniquement aux développeurs et aux passionnés de ClickHouse. Elle peut fonctionner ou non et pourrait être supprimée à tout moment.
• OBSOLETE: N’est plus prise en charge. Soit elle a déjà été supprimée, soit elle sera supprimée dans de futures versions.

​

Exemple

L’exemple suivant montre comment obtenir des informations sur les paramètres dont le nom contient 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.

<div id="see-also">
  ## Voir aussi
</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: 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.

<div id="see-also">
  ## Voir aussi
</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

L’utilisation de WHERE changed peut être utile, par exemple, lorsque vous souhaitez vérifier :

• si les paramètres définis dans les fichiers de configuration sont correctement chargés et bien pris en compte ;
• les paramètres qui ont été modifiés dans la session en cours.

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

​

Voir aussi

• Paramètres
• Permissions pour les requêtes
• Contraintes sur les paramètres
• instruction SHOW SETTINGS