Skip to main content
clickhouse-local é uma CLI com uma versão embutida do ClickHouse. Ela permite usar o poder do ClickHouse sem precisar instalar um servidor. Neste guia, aprenderemos a usar um banco de dados clickhouse-local com o chDB.

Configuração

Primeiro, vamos criar um ambiente virtual:
Agora vamos instalar o chDB. Certifique-se de que você tenha a versão 2.0.2 ou superior:
Agora, vamos instalar ipython:
Vamos usar o ipython para executar os comandos do restante do guia, que você pode iniciar com:

Instalando o clickhouse-local

Fazer o download e instalar o clickhouse-local é igual a fazer o download e instalar o ClickHouse. Podemos fazer isso executando o seguinte comando:
Para iniciar o clickhouse-local com os dados persistidos em um diretório, precisamos informar um --path:

Ingestão de dados no clickhouse-local

O banco de dados padrão armazena dados apenas na memória, então precisamos criar um banco de dados com nome para garantir que os dados ingeridos sejam persistidos em disco.
Vamos criar uma tabela e inserir alguns números aleatórios:
Vamos escrever uma consulta para ver quais dados temos:
Depois de fazer isso, certifique-se de executar exit; na CLI, pois apenas um processo pode manter um bloqueio neste diretório. Se não fizermos isso, receberemos o seguinte erro ao tentar nos conectar ao banco de dados pelo chDB:

Conectando-se ao banco de dados clickhouse-local

Volte ao shell ipython e importe o módulo session do chDB:
Inicialize uma sessão apontando para demo.chdb:
Podemos então executar a mesma consulta que retorna os quantis dos números:
Também podemos inserir dados nesse banco de dados usando o chDB:
Podemos então executar novamente a consulta de quantis no chDB ou no clickhouse-local.
Última modificação em 23 de julho de 2026