跳到主要内容
跳到主要内容

clickhouse-static-files-disk-uploader

生成一个数据目录，其中包含指定 ClickHouse 表的元数据。可以使用这些元数据在另一台服务器上创建一个 ClickHouse 表，该表包含由 web 磁盘作为后端的只读数据集。

不要使用此工具迁移数据。请改用 BACKUP 和 RESTORE 命令。

使用方法​

$ clickhouse static-files-disk-uploader [args]

命令​

命令说明
-h, --help打印帮助信息
--metadata-path [path]包含指定表的元数据的路径
--test-mode启用 test 模式，该模式会将表元数据通过 PUT 请求提交到给定的 URL
--link在输出目录中创建符号链接，而不是复制文件
--url [url]test 模式下使用的 Web 服务器 URL
--output-dir [dir]在 non-test 模式下输出文件的目录

获取指定表的元数据路径​

使用 clickhouse-static-files-disk-uploader 时，必须先获取所需表的元数据路径。

  1. 运行以下查询，并指定目标表和数据库：

SELECT data_paths
  FROM system.tables
  WHERE name = 'mytable' AND database = 'default';
  1. 这应返回指定表的数据目录路径：

┌─data_paths────────────────────────────────────────────┐
│ ['./store/bcc/bccc1cfd-d43d-43cf-a5b6-1cda8178f1ee/'] │
└───────────────────────────────────────────────────────┘

将表的元数据目录导出到本地文件系统​

使用目标输出目录 output 和指定的元数据路径，执行以下命令：

$ clickhouse static-files-disk-uploader --output-dir output --metadata-path ./store/bcc/bccc1cfd-d43d-43cf-a5b6-1cda8178f1ee/

如果执行成功，您应会看到以下消息，且 output 目录中会包含指定表的元数据：

数据路径:"/Users/john/store/bcc/bccc1cfd-d43d-43cf-a5b6-1cda8178f1ee",目标路径:"output"

将表元数据目录输出到外部 URL​

此步骤与将数据目录输出到本地文件系统类似，但需要额外添加 --test-mode 标志。不同之处在于，你不再指定输出目录，而必须通过 --url 标志指定目标 URL。

在启用 test 模式后，表元数据目录会通过 PUT 请求上传到指定的 URL。

$ clickhouse static-files-disk-uploader --test-mode --url http://nginx:80/test1 --metadata-path ./store/bcc/bccc1cfd-d43d-43cf-a5b6-1cda8178f1ee/

使用表元数据目录创建 ClickHouse 表​

获得表元数据目录后，你可以使用它在另一台服务器上创建一个 ClickHouse 表。

请参阅这个 GitHub 仓库，其中展示了一个演示示例。在该示例中，我们使用 web 磁盘创建一个表，从而能够将该表挂载到另一台服务器上的数据集。