Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.settings

View as MarkdownEdit this pageReport an issueSet up docs MCP

설명

현재 사용자의 세션 설정 정보를 포함합니다.

컬럼

  • name (String) — 설정 이름입니다.
  • value (String) — 설정 값입니다.
  • changed (UInt8) — 설정이 config에서 명시적으로 정의되었는지, 또는 명시적으로 변경되었는지를 보여줍니다.
  • description (String) — 설정에 대한 간단한 설명입니다.
  • min (Nullable(String)) — 제약 조건(constraints)을 통해 설정된 최소값이 있으면 해당 값을 나타냅니다. 설정에 최소값이 없으면 NULL을 포함합니다.
  • max (Nullable(String)) — 제약 조건을 통해 설정된 최대값이 있으면 해당 값을 나타냅니다. 설정에 최대값이 없으면 NULL을 포함합니다.
  • disallowed_values (Array(String)) — 허용되지 않는 값 목록
  • readonly (UInt8) — 현재 사용자가 이 설정을 변경할 수 있는지 보여줍니다: 0 — 현재 사용자가 이 설정을 변경할 수 있습니다. 1 — 현재 사용자가 이 설정을 변경할 수 없습니다.
  • type (String) — 이 설정에 할당할 수 있는 값의 타입입니다.
  • default (String) — 설정의 기본값입니다.
  • alias_for (String) — 이 설정이 다른 설정의 alias인 경우 원래 설정의 이름입니다.
  • is_obsolete (UInt8) — 이 설정이 더 이상 사용되지 않는 설정인지 보여줍니다.
  • tier (Enum8('Production' = 0, 'Obsolete' = 4, 'Experimental' = 8, 'Beta' = 12, 'PrivatePreview' = 16)) — 이 기능의 지원 수준입니다. ClickHouse 기능은 현재 개발 상태와 사용 시 기대할 수 있는 수준에 따라 여러 티어로 구분됩니다:
    • PRODUCTION: 이 기능은 안정적이며 안전하게 사용할 수 있고, 다른 PRODUCTION 기능과 함께 사용해도 문제가 없습니다.
    • BETA: 이 기능은 안정적이고 안전합니다. 다른 기능과 함께 사용할 때의 결과는 알려져 있지 않으며, 정확성도 보장되지 않습니다. 테스트와 보고를 환영합니다.
    • EXPERIMENTAL: 이 기능은 개발 중입니다. 개발자와 ClickHouse 애호가를 위한 기능입니다. 동작할 수도 있고 동작하지 않을 수도 있으며, 언제든 제거될 수 있습니다.
    • PRIVATE PREVIEW: 이 기능은 일반 제공을 향해 명확히 나아가고 있습니다. 적용 범위는 아직 제한적이며, 프로덕션 환경에서의 사용은 권장되지 않습니다.
    • OBSOLETE: 더 이상 지원되지 않습니다. 이미 제거되었거나 향후 릴리스에서 제거될 예정입니다.

예시

다음 예시는 이름에 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">
  ## 관련 항목
</div>

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

<div id="see-also">
  ## 관련 항목
</div>

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

WHERE changed를 사용하면 다음과 같은 항목을 확인할 때 유용합니다:

  • 설정 파일의 설정이 올바르게 로드되어 실제로 사용되고 있는지
  • 현재 세션에서 변경된 설정
SELECT * FROM system.settings WHERE changed AND name='load_balancing'

관련 항목

Navigation