system.remote_data_paths - ClickHouse Documentation

描述

包含有关存储在远程磁盘 (例如 S3、Azure Blob 存储) 上的数据文件的信息，包括本地元数据路径与远程 blob 路径之间的映射关系。每一行表示一个与数据文件关联的远程 blob 对象。

列

disk_name (String) — 磁盘名称。
path (String) — 磁盘路径。
metadata_type (String) — 磁盘的元数据存储类型 (例如 Local、PlainRewritable) 。
cache_base_path (String) — 缓存文件的根目录。
local_path (String) — ClickHouse 文件路径，同时用作元数据路径。
remote_path (String) — 与 ClickHouse 文件关联的对象存储 blob 路径。
size (UInt64) — 文件大小 (压缩后) 。
common_prefix_for_blobs (String) — 对象存储中 blob 的公共前缀。
cache_paths (Array(String)) — 对应 blob 的缓存文件。
last_modified (DateTime) — 文件元数据的最后修改时间。对于不记录该信息的元数据存储，此值为零。

示例

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

另请参见

最后修改于 2026年9月26日