Pular para o conteúdo principal
Gera um diretório de dados contendo metadados de uma tabela específica do ClickHouse. Esses metadados podem ser usados para criar uma tabela do ClickHouse em outro servidor contendo um conjunto de dados em modo somente leitura com suporte de um disco web. Não use esta ferramenta para migrar dados. Em vez disso, use os comandos BACKUP e RESTORE.

Uso

Comandos

Recupere o caminho de metadados da tabela especificada

Ao usar clickhouse-static-files-disk-uploader, você deve obter o caminho de metadados da tabela desejada.
  1. Execute a seguinte consulta, especificando sua tabela de destino e o banco de dados:

  1. Isso deve retornar o caminho do diretório de dados da tabela especificada:

Exportar o diretório de metadados da tabela para o sistema de arquivos local

Usando o diretório de saída de destino output e um caminho de metadados especificado, execute o seguinte comando:
Se tudo der certo, você deverá ver a seguinte mensagem, e o diretório output deverá conter os metadados da tabela especificada:

Enviar o diretório de metadados da tabela para uma URL externa

Este passo é semelhante a enviar o diretório de dados para o sistema de arquivos local, mas com a adição da flag --test-mode. Em vez de especificar um diretório de saída, você deve informar uma URL de destino por meio da flag --url. Com o modo test habilitado, o diretório de metadados da tabela é enviado para a URL especificada por meio de uma requisição PUT.

Usando o diretório de metadados da tabela para criar uma tabela do ClickHouse

Depois de obter o diretório de metadados da tabela, você pode usá-lo para criar uma tabela do ClickHouse em outro servidor. Consulte este repositório no GitHub, que mostra uma demo. No exemplo, criamos uma tabela usando um disco web, o que nos permite associá-la a um conjunto de dados em outro servidor.
Última modificação em 19 de junho de 2026