Skip to main content
Este guia ajuda você a migrar seu código existente em pandas para o DataStore, com melhor desempenho sem perder a compatibilidade.

A migração em uma linha

A migração mais simples é alterar a importação:
É isso! A maior parte do código do pandas funciona sem alterações.

Migração passo a passo

1

Instale o chDB

2

Altere a instrução de importação

3

Teste seu código

Execute o código existente. A maioria das operações funciona sem alterações:
4

Lide com as diferenças

Algumas operações se comportam de forma diferente. Veja Principais diferenças abaixo.

O que funciona sem alterações

Carregamento de dados

Filtragem

Seleção

GroupBy e agregação

Ordenação

Operações de String

Operações com DateTime

Operações de E/S


Principais diferenças

1. Avaliação preguiçosa

As operações do DataStore são preguiçosas — elas só são executadas quando os resultados são necessários. pandas:
DataStore:

2. Tipos de retorno

3. Sem o parâmetro inplace

DataStore não oferece suporte a inplace=True. Sempre use o valor retornado: pandas:
DataStore:

4. Comparando DataStores

O pandas não reconhece objetos DataStore, então use to_pandas() para compará-los:

5. Ordem das Linhas

DataStore pode não preservar a ordem das linhas em fontes como arquivos e bancos de dados SQL. Use ordenação explícita:

Padrões de migração

Padrão 1: Leitura-Análise-Gravação

Padrão 2: DataFrame com operações do pandas

Se você precisar de funcionalidades específicas do pandas, faça a conversão ao final:

Padrão 3: Fluxo de trabalho híbrido


Comparação de desempenho

DataStore é significativamente mais rápido para grandes volumes de dados: Benchmark com 10M linhas

Solução de problemas da migração

Problema: Operação não funciona

Algumas operações do pandas podem não ser suportadas. Verifique:
  1. A operação consta na lista de compatibilidade?
  2. Tente converter para pandas primeiro: ds.to_df().operation()

Problema: Resultados diferentes

Ative o log de depuração para entender o que está acontecendo:

Problema: Desempenho lento

Verifique o padrão de execução:

Problema: Incompatibilidades de tipos

DataStore pode inferir os tipos de forma diferente:

Estratégia de migração gradual

Semana 1: Testar a compatibilidade

Semana 2: Migre scripts simples

Comece com scripts que:
  • Leem arquivos grandes
  • Fazem filtragem e agregação
  • Não usam funções apply personalizadas

Semana 3: Lide com casos complexos

Para scripts com funções personalizadas:

Semana 4: Migração completa

Atualize todos os scripts para importar o DataStore.

FAQ

Posso usar tanto pandas quanto DataStore?

Sim! É possível converter livremente entre eles:

Meus testes continuarão passando?

A maioria dos testes deve passar. Para testes de comparação, converta para pandas:

Posso usar o DataStore no Jupyter?

Sim! O DataStore funciona em notebooks Jupyter:

Como faço para reportar issues?

Se você encontrar problemas de compatibilidade, reporte-os em: https://github.com/chdb-io/chdb/issues
Última modificação em 23 de julho de 2026