Skip to main content
Neste guia, vamos aprender como consultar um servidor remoto do ClickHouse a partir do chDB.

Configuração

Primeiro, vamos criar um ambiente virtual:
E agora vamos instalar o chDB. Verifique se você tem a versão 2.0.2 ou superior:
Agora vamos instalar pandas e ipython:
Vamos usar o ipython para executar os comandos no restante do guia, que você pode iniciar com:
Você também pode usar o código em um script Python ou no ambiente de notebook da sua preferência.

Uma introdução ao ClickPy

O servidor remoto do ClickHouse que vamos consultar é o ClickPy. O ClickPy rastreia todos os downloads de pacotes do PyPI e permite explorar as estatísticas dos pacotes por meio de uma UI. O banco de dados por trás dele pode ser consultado usando o usuário play. Você pode saber mais sobre o ClickPy em seu repositório no GitHub.

Consultando o serviço ClickHouse do ClickPy

Vamos importar chDB:
Vamos consultar o ClickPy usando a função remoteSecure. Essa função recebe, no mínimo, um nome de host, um nome de tabela e um nome de usuário. Podemos escrever a seguinte consulta para retornar o número de downloads por dia do pacote openai na forma de um DataFrame do Pandas:
Agora, vamos fazer o mesmo para obter os downloads de scikit-learn:

Combinando DataFrames do Pandas

Agora temos dois DataFrames, que podemos combinar com base na data (que está na coluna x) assim:
Podemos então calcular a proporção de downloads do Open AI em relação aos downloads de scikit-learn assim:

Consultando DataFrames do Pandas

Em seguida, vamos supor que queremos encontrar as datas com as melhores e piores proporções. Podemos voltar ao chDB e calcular esses valores:
Se quiser saber mais sobre como consultar DataFrames do Pandas, consulte o guia para desenvolvedores sobre consultas em DataFrames do Pandas.
Última modificação em 3 de julho de 2026