> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> System table containing information about session settings for current user.

# system.settings

<h2 id="description">
  Description
</h2>

Contains information about session settings for current user.

<h2 id="columns">
  Columns
</h2>

* `name` ([String](/reference/data-types/index)) — Setting name.
* `value` ([String](/reference/data-types/index)) — Setting value.
* `changed` ([UInt8](/reference/data-types/index)) — Shows whether the setting was explicitly defined in the config or explicitly changed.
* `description` ([String](/reference/data-types/index)) — Short setting description.
* `min` ([Nullable(String)](/reference/data-types/index)) — Minimum value of the setting, if any is set via constraints. If the setting has no minimum value, contains NULL.
* `max` ([Nullable(String)](/reference/data-types/index)) — Maximum value of the setting, if any is set via constraints. If the setting has no maximum value, contains NULL.
* `disallowed_values` ([Array(String)](/reference/data-types/index)) — List of disallowed values
* `readonly` ([UInt8](/reference/data-types/index)) — Shows whether the current user can change the setting: 0 — Current user can change the setting, 1 — Current user can't change the setting.
* `type` ([String](/reference/data-types/index)) — The type of the value that can be assigned to this setting.
* `default` ([String](/reference/data-types/index)) — Setting default value.
* `alias_for` ([String](/reference/data-types/index)) — The name of the original setting if the setting is an alias for another setting.
* `is_obsolete` ([UInt8](/reference/data-types/index)) — Shows whether a setting is obsolete.
* `tier` ([Enum8('Production' = 0, 'Obsolete' = 4, 'Experimental' = 8, 'Beta' = 12)](/reference/data-types/index)) —
  Support level for this feature. ClickHouse features are organized in tiers, varying depending on the current status of their
  development and the expectations one might have when using them:

- PRODUCTION: The feature is stable, safe to use and does not have issues interacting with other PRODUCTION features.
- BETA: The feature is stable and safe. The outcome of using it together with other features is unknown and correctness is not guaranteed. Testing and reports are welcome.
- EXPERIMENTAL: The feature is under development. Only intended for developers and ClickHouse enthusiasts. The feature might or might not work and could be removed at any time.
- OBSOLETE: No longer supported. Either it is already removed or it will be removed in future releases.

<h2 id="example">
  Example
</h2>

The following example shows how to get information about settings which name contains `min_i`.

```sql theme={null}
SELECT *
FROM system.settings
WHERE name LIKE '%min_insert_block_size_%'
FORMAT Vertical
```

```text theme={null}
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 {#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 {#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
```

Using of `WHERE changed` can be useful, for example, when you want to check:

* Whether settings in configuration files are loaded correctly and are in use.
* Settings that changed in the current session.

```sql theme={null}
SELECT * FROM system.settings WHERE changed AND name='load_balancing'
```

<h2 id="see-also">
  See Also
</h2>

* [Settings](/reference/system-tables/overview#system-tables-introduction)
* [Permissions for Queries](/concepts/features/configuration/settings/permissions-for-queries)
* [Constraints on Settings](/concepts/features/configuration/settings/constraints-on-settings)
* [SHOW SETTINGS](/reference/statements/show#show-settings) statement
