メインコンテンツへスキップ
メインコンテンツへスキップ

system.remote_data_paths

ローカルのメタデータパスとリモートのブロブパスの対応関係を含め、リモートディスク (例: S3、Azure Blob Storage) に保存されたデータファイルに関する情報を格納します。

各行は、データファイルに関連付けられた 1 つのリモートブロブオブジェクトを表します。

カラム:

  • disk_name (String) — ストレージ設定で定義されたリモートディスクの名前。
  • path (String) — ストレージ設定で設定されたリモートディスクのルートパス。
  • cache_base_path (String) — リモートディスクに関連付けられたキャッシュファイルのベースディレクトリ。
  • local_path (String) — ClickHouse データディレクトリからの相対パスで表したローカルメタデータファイルのパス。リモートブロブに対応するファイルを指します。
  • remote_path (String) — ローカルメタデータファイルが対応する、リモートオブジェクトストレージ内のブロブパス。
  • size (UInt64) — ファイルの圧縮サイズ (バイト) 。
  • common_prefix_for_blobs (String) — リモートオブジェクトストレージ内のブロブに共通するプレフィックス。複数のブロブが同じパスプレフィックスを共有する場合に適用されます。
  • cache_paths (Array(String)) — リモートブロブに対応するローカルキャッシュファイルのパス。

設定

  • traverse_shadow_remote_data_paths — 有効にすると、このテーブルにはフリーズされたパーティション (ALTER TABLE ... FREEZE で使用される shadow/ ディレクトリ) のデータも含まれます。デフォルトでは無効です。

例

SELECT * FROM system.remote_data_paths LIMIT 1 FORMAT Vertical;

Row 1:
──────
disk_name:              s3
path:                   /var/lib/clickhouse/disks/s3/
cache_base_path:        /var/lib/clickhouse/disks/s3_cache/
local_path:             store/123/1234abcd-1234-1234-1234-1234abcd1234/all_0_0_0/data.bin
remote_path:            abc123/all_0_0_0/data.bin
size:                   1048576
common_prefix_for_blobs:
cache_paths:            ['/var/lib/clickhouse/disks/s3_cache/a1/b2/c3d4e5f6']

関連項目