Pular para o conteúdo principal
DataStore é a API compatível com o Pandas do chDB que combina a conhecida interface de DataFrame do pandas com o poder da otimização de consultas SQL e permite escrever código no estilo do pandas com o desempenho do ClickHouse.

Principais recursos

  • Compatibilidade com pandas: 209 métodos de DataFrame do pandas, 56 métodos .str, 42+ métodos .dt
  • Otimização de SQL: as operações são convertidas automaticamente em consultas SQL otimizadas
  • Avaliação preguiçosa: as operações são adiadas até que os resultados sejam necessários
  • 630+ métodos de API: API abrangente para manipulação de dados
  • Extensões do ClickHouse: acessores adicionais (.arr, .json, .url, .ip, .geo) não disponíveis no pandas

Arquitetura

O DataStore usa avaliação preguiçosa com execução em dois engines:
  1. Encadeamento preguiçoso de operações: as operações são registradas, não executadas imediatamente
  2. Seleção inteligente de engine: o QueryPlanner direciona cada segmento para o engine ideal (chDB para SQL, Pandas para operações complexas)
  3. Cache intermediário: os resultados são armazenados em cache a cada etapa para uma exploração iterativa mais rápida
Consulte o Modelo de Execução para mais detalhes.

Migração com uma única linha a partir do Pandas

Seu código pandas existente funciona sem alterações, mas agora roda no mecanismo do ClickHouse.

Comparação de desempenho

O DataStore oferece ganhos significativos de desempenho em comparação com o pandas, especialmente em agregação e pipelines complexos: Benchmark com 10M linhas. Veja o script de benchmark e o Guia de desempenho para mais detalhes.

Quando usar DataStore

Use o DataStore quando:
  • Estiver trabalhando com grandes conjuntos de dados (milhões de linhas)
  • Estiver realizando agregações e operações de groupby
  • Estiver consultando dados de arquivos, bancos de dados ou armazenamento em nuvem
  • Estiver criando pipelines de dados complexos
  • Quiser a API do pandas com melhor desempenho
Use a API de SQL puro quando:
  • Preferir escrever SQL diretamente
  • Precisar de controle mais refinado sobre a execução de consultas
  • Estiver trabalhando com recursos específicos do ClickHouse não expostos na API do pandas

Comparação de funcionalidades

Estatísticas da API

Primeiros passos

Referência da API

Tópicos avançados

Configuração e depuração

Guias para usuários do Pandas

Exemplo rápido

Próximos passos

Última modificação em 19 de junho de 2026