ClickHouse/docs/ja/operations/system-tables/parts_columns.md
2024-11-18 11:58:58 +09:00

8.8 KiB
Raw Blame History

slug
/ja/operations/system-tables/parts_columns

parts_columns

MergeTree テーブルのパーツとカラムに関する情報を含みます。

各行は一つのデータパーツを示します。

カラム:

  • partition (String) — パーティション名。ALTER クエリの説明を参照して、パーティションが何かを学んでください。

    フォーマット:

    • YYYYMM 自動月ごとのパーティション分割の場合。
    • any_string 手動でのパーティション分割の場合。
  • name (String) — データパーツの名前。

  • part_type (String) — データパーツの保存フォーマット。

    可能な値:

    • Wide — 各カラムがファイルシステム内の別個のファイルに保存されています。
    • Compact — 全カラムがファイルシステム内の一つのファイルに保存されています。

    データ保存フォーマットは、MergeTree テーブルの min_bytes_for_wide_partmin_rows_for_wide_part 設定によって制御されます。

  • active (UInt8) — データパーツがアクティブかどうかを示すフラグ。データパーツがアクティブであればテーブルで使用され、そうでなければ削除されます。非アクティブなデータパーツはマージ後に残ります。

  • marks (UInt64) — マークの数。データパーツ内の行数を概算するためには、marks をインデックス粒度通常8192と掛けてくださいこのヒントは適応的な粒度では機能しません

  • rows (UInt64) — 行数。

  • bytes_on_disk (UInt64) — すべてのデータパーツファイルの合計サイズ(バイト単位)。

  • data_compressed_bytes (UInt64) — データパーツ内の圧縮データの総サイズ。補助ファイル(例えば、マークファイルなど)は含まれていません。

  • data_uncompressed_bytes (UInt64) — データパーツ内の非圧縮データの総サイズ。補助ファイル(例えば、マークファイルなど)は含まれていません。

  • marks_bytes (UInt64) — マークを含むファイルのサイズ。

  • modification_time (DateTime) — データパーツが含まれるディレクトリが変更された時間。これは通常、データパーツの作成時間に相当します。

  • remove_time (DateTime) — データパーツが非アクティブになった時間。

  • refcount (UInt32) — データパーツが使用されている場所の数。2より大きい値は、データパーツがクエリやマージで使用されていることを示します。

  • min_date (Date) — データパーツ内の日付キーの最小値。

  • max_date (Date) — データパーツ内の日付キーの最大値。

  • partition_id (String) — パーティションのID。

  • min_block_number (UInt64) — マージ後に現在のパーツを構成するデータパーツの最小数。

  • max_block_number (UInt64) — マージ後に現在のパーツを構成するデータパーツの最大数。

  • level (UInt32) — マージツリーの深さ。ゼロは、現在のパーツが他のパーツと合併されたのではなく、挿入によって作成されたことを意味します。

  • data_version (UInt64) — データパーツに適用されるべき変更を決定するために使用される番号(data_version よりもバージョンが高い変更)。

  • primary_key_bytes_in_memory (UInt64) — 主キー値に使用されるメモリの量(バイト単位)。

  • primary_key_bytes_in_memory_allocated (UInt64) — 主キー値のために予約されているメモリの量(バイト単位)。

  • database (String) — データベースの名前。

  • table (String) — テーブルの名前。

  • engine (String) — パラメータなしのテーブルエンジンの名前。

  • disk_name (String) — データパーツを保存するディスク名。

  • path (String) — データパーツファイルが含まれるフォルダへの絶対パス。

  • column (String) — カラムの名前。

  • type (String) — カラムタイプ。

  • column_position (UInt64) — テーブル内のカラムの序数位置1から始まる

  • default_kind (String) — デフォルト値の式タイプ(DEFAULTMATERIALIZEDALIAS)、または定義されていない場合は空文字列。

  • default_expression (String) — デフォルト値の式、または定義されていない場合は空文字列。

  • column_bytes_on_disk (UInt64) — カラムの合計サイズ(バイト単位)。

  • column_data_compressed_bytes (UInt64) — カラム内の圧縮データの総サイズ(バイト単位)。

  • column_data_uncompressed_bytes (UInt64) — カラム内の非圧縮データの総サイズ(バイト単位)。

  • column_marks_bytes (UInt64) — マークを含むカラムのサイズ(バイト単位)。

  • bytes (UInt64) — bytes_on_disk のエイリアス。

  • marks_size (UInt64) — marks_bytes のエイリアス。

SELECT * FROM system.parts_columns LIMIT 1 FORMAT Vertical;
Row 1:
──────
partition:                             tuple()
name:                                  all_1_2_1
part_type:                             Wide
active:                                1
marks:                                 2
rows:                                  2
bytes_on_disk:                         155
data_compressed_bytes:                 56
data_uncompressed_bytes:               4
marks_bytes:                           96
modification_time:                     2020-09-23 10:13:36
remove_time:                           2106-02-07 06:28:15
refcount:                              1
min_date:                              1970-01-01
max_date:                              1970-01-01
partition_id:                          all
min_block_number:                      1
max_block_number:                      2
level:                                 1
data_version:                          1
primary_key_bytes_in_memory:           2
primary_key_bytes_in_memory_allocated: 64
database:                              default
table:                                 53r93yleapyears
engine:                                MergeTree
disk_name:                             default
path:                                  /var/lib/clickhouse/data/default/53r93yleapyears/all_1_2_1/
column:                                id
type:                                  Int8
column_position:                       1
default_kind:
default_expression:
column_bytes_on_disk:                  76
column_data_compressed_bytes:          28
column_data_uncompressed_bytes:        2
column_marks_bytes:                    48

関連項目