メインコンテンツへスキップ
指定した ClickHouse テーブルのメタデータを含むデータディレクトリを出力します。このメタデータを使用すると、ディスクを基盤とする読み取り専用データセットを含む ClickHouse テーブルを別のサーバー上に作成できます。 このツールをデータ移行に使用しないでください。代わりに、BACKUPRESTORE コマンドを使用してください。

使い方

コマンド

指定したテーブルのメタデータパスを取得する

clickhouse-static-files-disk-uploader を使用するには、対象のテーブルのメタデータパスを取得する必要があります。
  1. ターゲットテーブルとデータベースを指定して、次のクエリを実行します。

  1. これにより、指定したテーブルのデータディレクトリのパスが返されます:

テーブルのメタデータディレクトリをローカルファイルシステムに出力する

出力先ディレクトリ output と指定したメタデータパスを使用して、次のコマンドを実行します。
成功すると、次のメッセージが表示され、output ディレクトリには指定したテーブルのメタデータが格納されます。

テーブルのメタデータディレクトリを外部URLに出力する

この手順は、データディレクトリをローカルファイルシステムに出力する手順とほぼ同じですが、--test-mode フラグを追加で指定します。出力先ディレクトリの代わりに、--url フラグで対象URLを指定する必要があります。 test モードを有効にすると、テーブルのメタデータディレクトリは PUT リクエストで指定したURLにアップロードされます。

テーブルのメタデータディレクトリを使用して ClickHouse テーブルを作成する

テーブルのメタデータディレクトリを取得したら、それを使って別のサーバー上に ClickHouse テーブルを作成できます。 デモについては、こちらの GitHub リポジトリを参照してください。この例では、web ディスクを使ってテーブルを作成しています。これにより、そのテーブルを別のサーバー上のデータセットにアタッチできます。
最終更新日 2026年6月19日