system.remote_data_paths

S3 や Azure Blob Storage などのリモートディスクに保存されたデータファイルに関する情報を含むシステムテーブル。

​

説明

リモートディスク (例: S3、Azure Blob Storage) に保存されているデータファイルに関する情報が含まれます。これには、ローカルのメタデータパスとリモートのブロブパスの対応関係も含まれます。

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

​

カラム

• disk_name (String) — ディスク名。
• path (String) — ディスクのパス。
• cache_base_path (String) — cache ファイルのベースディレクトリ。
• local_path (String) — ClickHouse ファイルのパス。メタデータのパスとしても使用されます。
• remote_path (String) — オブジェクトストレージ内のブロブのパス。ClickHouse ファイルに対応付けられています。
• size (UInt64) — ファイルのサイズ (圧縮後) 。
• common_prefix_for_blobs (String) — オブジェクトストレージ内のブロブに共通するプレフィックス。
• cache_paths (Array(String)) — 対応するブロブの cache ファイル。

​

例

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']

​

関連項目

• データ保存に外部ストレージを使用する
• 外部ストレージを構成する
• system.disks