system.settings

現在のユーザーのセッション設定に関する情報を含むシステムテーブルです。

​

説明

現在のユーザーのセッション設定に関する情報が含まれます。

​

カラム

• name (String) — 設定名。
• value (String) — 設定値。
• changed (UInt8) — 設定が config で明示的に定義されているか、または明示的に変更されたかを示します。
• description (String) — 設定の簡単な説明。
• min (Nullable(String)) — 制約によって設定されている場合の、この設定の最小値。最小値がない場合は NULL が入ります。
• max (Nullable(String)) — 制約によって設定されている場合の、この設定の最大値。最大値がない場合は NULL が入ります。
• disallowed_values (Array(String)) — 許可されていない値の一覧
• readonly (UInt8) — 現在のユーザーがこの設定を変更できるかどうかを示します: 0 — 現在のユーザーはこの設定を変更できます、1 — 現在のユーザーはこの設定を変更できません。
• type (String) — この設定に割り当て可能な値の型。
• default (String) — 設定のデフォルト値。
• alias_for (String) — この設定が別の設定の別名である場合の、元の設定名。
• is_obsolete (UInt8) — この設定が廃止されたものかどうかを示します。
• tier (Enum8(‘Production’ = 0, ‘Obsolete’ = 4, ‘Experimental’ = 8, ‘Beta’ = 12)) — この機能のサポートレベル。ClickHouse の機能は tier ごとに整理されており、現在の 開発状況や、使用時に期待できる内容に応じて区分されています:

• PRODUCTION: この機能は安定しており、安全に使用でき、他の PRODUCTION 機能と組み合わせても問題はありません。
• BETA: この機能は安定しており、安全に使用できます。他の機能と組み合わせて使用した場合の結果は不明で、正しさは保証されません。テストと報告を歓迎します。
• EXPERIMENTAL: この機能は開発中です。開発者および ClickHouse 愛好家向けです。この機能は動作する場合もしない場合もあり、いつでも削除される可能性があります。
• OBSOLETE: すでにサポートされていません。すでに削除されているか、今後の release で削除される予定です。

​

例

以下の例では、名前に 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: `INSERT` クエリによってテーブルに挿入できるブロック内の最小行数を設定します。サイズの小さいブロックはより大きなブロックにまとめられます。

設定可能な値:

- 正の整数。
- 0 — まとめる処理を無効にします。
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: `INSERT` クエリによってテーブルに挿入できるブロック内の最小バイト数を設定します。サイズの小さいブロックはより大きなブロックにまとめられます。

設定可能な値:

- 正の整数。
- 0 — まとめる処理を無効にします。
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: `INSERT` クエリによってテーブルに挿入できるブロック内の最小行数を設定します。サイズの小さいブロックはより大きなブロックにまとめられます。この設定は [materialized view](/reference/statements/create/view) に挿入されるブロックにのみ適用されます。この設定を調整することで、materialized view へのプッシュ時のブロックをまとめる処理を制御し、メモリの過剰消費を回避できます。

設定可能な値:

- 任意の正の整数。
- 0 — まとめる処理を無効にします。

<div id="see-also">
  ## 関連項目
</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: `INSERT` クエリによってテーブルに挿入できるブロック内の最小バイト数を設定します。サイズの小さいブロックはより大きなブロックにまとめられます。この設定は [materialized view](/reference/statements/create/view) に挿入されるブロックにのみ適用されます。この設定を調整することで、materialized view へのプッシュ時のブロックをまとめる処理を制御し、メモリの過剰消費を回避できます。

設定可能な値:

- 任意の正の整数。
- 0 — まとめる処理を無効にします。

<div id="see-also">
  ## 関連項目
</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

WHERE changed は、たとえば次のようなことを確認したい場合に役立ちます。

• 設定ファイル内の設定が正しく読み込まれ、実際に使用されているかどうか。
• 現在のセッションで変更された設定。

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

​

関連項目

• 設定
• クエリの権限
• 設定の制約
• SHOW SETTINGS ステートメント