Pular para o conteúdo principal

Como resolver o erro “Cannot Append Data in Parquet Format” no ClickHouse

Você está recebendo o erro “Cannot append data in format Parquet to file” no ClickHouse? Normalmente, o erro é exibido como: DB::Exception: Cannot append data in format Parquet to file, because this format doesn't support appends. (CANNOT_APPEND_TO_FILE) Suponha que você crie uma tabela que use o engine de tabela File com o formato Parquet.
Você pode gravar na tabela uma única vez:
Isso cria um arquivo chamado data.Parquet na pasta data/default/parquet_test. Se você tentar inserir outro batch:
…você recebe o seguinte erro:
Não é possível acrescentar dados a arquivos Parquet no ClickHouse. Mas você pode instruir o ClickHouse a criar um novo arquivo para cada INSERT ativando a configuração engine_file_allow_create_multiple_files. Se estiver ativada, a cada insert será criado um novo arquivo com um nome seguindo este padrão: data.Parquet -> data.1.Parquet -> data.2.Parquet, etc.: Vamos testar. Colocaremos nossos dois comandos em um único arquivo chamado parquet.sql:
Execute-o com clickhouse-client:
E agora você verá dois arquivos em data/default/parquet_test (e um novo arquivo para cada insert subsequente).
A configuração engine_file_allow_create_multiple_files também se aplica a outros formatos de dados que não aceitam anexação, como JSON e ORC.
Última modificação em 25 de junho de 2026