> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Consulte grandes volumes de dados com eficiência, analisando e modelando tudo no conforto de um ambiente de notebook familiar.
# Conecte o ClickHouse ao Deepnote
export const CommunityMaintainedBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
Deepnote é um notebook de dados colaborativo criado para equipes explorarem e compartilharem insights. Além de ser compatível com o Jupyter, ele funciona na nuvem e oferece um ambiente centralizado para colaborar e trabalhar com eficiência em projetos de ciência de dados.
Este guia pressupõe que você já tenha uma conta no Deepnote e uma instância do ClickHouse em funcionamento.
## Exemplo interativo
Se você quiser explorar um exemplo interativo de como consultar o ClickHouse a partir dos notebooks de dados do Deepnote, clique no botão abaixo para iniciar um projeto de template conectado ao [ClickHouse playground](/pt-BR/get-started/sample-datasets/playground).
[
](https://deepnote.com/launch?template=ClickHouse%20and%20Deepnote)
## Conecte-se ao ClickHouse
1. No Deepnote, selecione a visão geral de "Integrations" e clique no bloco do ClickHouse.
2. Informe os detalhes de conexão da sua instância do ClickHouse:
Para se conectar ao ClickHouse via HTTP(S), você precisa das seguintes informações:
| Parâmetro(s) | Descrição |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | Normalmente, a porta é 8443 ao usar TLS ou 8123 quando não se usa TLS. |
| `DATABASE NAME` | Por padrão, há um banco de dados chamado `default`; use o nome do banco de dados ao qual você deseja se conectar. |
| `USERNAME` and `PASSWORD` | Por padrão, o nome de usuário é `default`. Use o nome de usuário apropriado para o seu caso de uso. |
Os detalhes do seu serviço do ClickHouse Cloud estão disponíveis no console do ClickHouse Cloud.
Selecione um serviço e clique em **Connect**:
Escolha **HTTPS**. Os detalhes de conexão são exibidos em um comando `curl` de exemplo.
Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.
***OBSERVAÇÃO:*** Se a sua conexão com o ClickHouse estiver protegida por uma lista de acesso por IP, talvez seja necessário permitir os endereços IP do Deepnote. Leia mais sobre isso na [documentação do Deepnote](https://docs.deepnote.com/integrations/authorize-connections-from-deepnote-ip-addresses).
3. Parabéns! Agora o ClickHouse está integrado ao Deepnote.
## Usando a integração do ClickHouse.
1. Comece se conectando à integração do ClickHouse à direita do seu notebook.
2. Agora, crie um novo bloco de consulta do ClickHouse e consulte seu banco de dados. Os resultados da consulta serão salvos como um DataFrame e armazenados na variável especificada no bloco SQL.
3. Você também pode converter qualquer [bloco SQL](https://docs.deepnote.com/features/sql-cells) existente em um bloco do ClickHouse.