clickhouse-static-files-disk-uploader
指定された ClickHouse テーブルのメタデータを含むデータディレクトリを出力します。このメタデータは、web ディスクに支えられた読み取り専用データセットを含む別のサーバーに ClickHouse テーブルを作成するために使用できます。
このツールを使用してデータを移行しないでください。代わりに、BACKUP および RESTORE コマンドを使用してください。
使用法
コマンド
| コマンド | 説明 |
|---|---|
-h, --help | ヘルプ情報を表示します |
--metadata-path [path] | 指定されたテーブルのメタデータが含まれているパス |
--test-mode | テストモードを有効にし、指定されたURLにテーブルメタデータを持つPUTリクエストを送信します |
--link | ファイルを出力ディレクトリにコピーする代わりにシンボリックリンクを作成します |
--url [url] | テストモード用のWebサーバーのURL |
--output-dir [dir] | 非テストモードでファイルを出力するディレクトリ |
指定されたテーブルのメタデータパスを取得する
clickhouse-static-files-disk-uploaderを使用する際は、目的のテーブルのメタデータパスを取得する必要があります。
- 対象のテーブルとデータベースを指定して以下のクエリを実行します：
- これにより、指定されたテーブルのデータディレクトリへのパスが返されるはずです：
テーブルメタデータディレクトリをローカルファイルシステムに出力する
ターゲット出力ディレクトリ output と指定されたメタデータパスを使用して、以下のコマンドを実行します：
成功した場合、以下のメッセージが表示され、output ディレクトリには指定されたテーブルのメタデータが含まれているはずです：
テーブルメタデータディレクトリを外部URLに出力する
このステップは、データディレクトリをローカルファイルシステムに出力することに似ていますが、--test-mode フラグが追加されます。出力ディレクトリを指定する代わりに、--url フラグを介してターゲットURLを指定する必要があります。
test モードを有効にすると、テーブルメタデータディレクトリがPUTリクエストを介して指定されたURLにアップロードされます。
テーブルメタデータディレクトリを使用して ClickHouse テーブルを作成する
テーブルメタデータディレクトリを取得したら、それを使用して別のサーバーに ClickHouse テーブルを作成できます。
デモを示すために、この GitHub リポジトリをご覧ください。例では、web ディスクを使用してテーブルを作成し、別のサーバー上のデータセットにテーブルをアタッチできるようにしています。