> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> O Astrato leva o verdadeiro BI self-service para empresas e negócios de dados, colocando a análise nas mãos de cada usuário e permitindo que criem seus próprios dashboards, relatórios e aplicativos de dados, respondendo a perguntas sobre os dados sem ajuda da TI. O Astrato acelera a adoção, agiliza a tomada de decisões e unifica análise, analytics embarcada, entrada de dados e aplicativos de dados em uma única plataforma. O Astrato reúne ação e análise em um só lugar, introduz write-back em tempo real, interage com modelos de ML e acelera sua análise com IA — vá além dos dashboards graças ao suporte a pushdown de SQL no Astrato.

# Conectando o Astrato ao ClickHouse

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Mantido pela comunidade
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<CommunityMaintainedBadge />

O Astrato usa Pushdown SQL para consultar diretamente o ClickHouse Cloud ou implantações on-premise. Isso significa que você pode acessar todos os dados de que precisa com o desempenho líder do setor do ClickHouse.

<div id="connection-data-required">
  ## Dados necessários para a conexão
</div>

Ao configurar sua conexão de dados, você precisará ter em mãos:

* Conexão de dados: Hostname, Porta

* Credenciais do banco de dados: Nome de usuário, Senha

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**:

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="botão Connect do serviço do ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
  </Frame>
</div>

Escolha **HTTPS**. Os detalhes de conexão são exibidos em um comando `curl` de exemplo.

<div className="ch-image-md">
  <Frame>
    <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="detalhes de conexão HTTPS do ClickHouse Cloud" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
  </Frame>
</div>

Se você estiver usando ClickHouse autogerenciado, os detalhes de conexão são definidos pelo administrador do seu ClickHouse.

<div id="creating-the-data-connection-to-clickhouse">
  ## Criando a conexão de dados com o ClickHouse
</div>

* Selecione **Data** na barra lateral e, em seguida, a guia **Conexão de dados**
  (ou acesse este link: [https://app.astrato.io/data/sources](https://app.astrato.io/data/sources))
  ​
* Clique no botão **Nova conexão de dados** no canto superior direito da tela.

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_1_dataconnection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=806b01cd8d8ae2b482f28368b3e28317" alt="Conexão de dados do Astrato" border width="396" height="165" data-path="images/integrations/data-visualization/astrato_1_dataconnection.webp" />

* Selecione **ClickHouse**.

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=91feeabc20a7665402c8382934173ae9" alt="Conexão de dados do Astrato com ClickHouse" border width="235" height="164" data-path="images/integrations/data-visualization/astrato_2a_clickhouse_connection.webp" />

* Preencha os campos obrigatórios na caixa de diálogo da conexão

<Image size="sm" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=9926d9a8ec14e804e428a7d33ea53502" alt="Campos obrigatórios do Astrato para conexão com o ClickHouse" border width="486" height="601" data-path="images/integrations/data-visualization/astrato_2b_clickhouse_connection.webp" />

* Clique em **Test Connection**. Se a conexão for bem-sucedida, dê um **name** à conexão de dados e clique em **Next.**

* Defina o **user access** da conexão de dados e clique em **connect.**

<Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_3_user_access.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=59617eb5f2eaa17d07552ae3b142b78a" alt="Acesso do usuário no Astrato para conexão com o ClickHouse" border width="1973" height="1651" data-path="images/integrations/data-visualization/astrato_3_user_access.webp" />

* Uma conexão e uma visualização de dados são criadas.

<Note>
  se uma duplicata for criada, um timestamp será adicionado ao nome da fonte de dados.
</Note>

<div id="creating-a-semantic-model--data-view">
  ## Criando um modelo semântico / visão de dados
</div>

No nosso editor de visão de dados, você verá todas as suas tabelas e esquemas no ClickHouse. Selecione alguns para começar.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=398fe1932fc832d619799aa0d379b5b2" alt="Astrato se conecta ao Acesso do usuário do ClickHouse" border width="1210" height="671" data-path="images/integrations/data-visualization/astrato_4a_clickhouse_data_view.webp" />

Agora que você selecionou seus dados, vá para a definição da **visão de dados**. Clique em Define no canto superior direito da página.

Aqui, você pode fazer junções entre os dados, bem como **criar dimensões e medidas governadas** — o que é ideal para garantir consistência na lógica de negócios entre diferentes equipes.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=879a1a1ebc0e1c1f230e35f5ae844043" alt="Astrato se conecta ao Acesso do usuário do ClickHouse" border width="1208" height="669" data-path="images/integrations/data-visualization/astrato_4b_clickhouse_data_view_joins.webp" />

**O Astrato sugere junções de forma inteligente** usando seus metadados, inclusive aproveitando as chaves no ClickHouse. Nossas junções sugeridas facilitam o início do trabalho com seus dados bem governados no ClickHouse, sem precisar reinventar a roda. Também mostramos a **qualidade da junção**, para que você possa revisar todas as sugestões em detalhes no Astrato.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=33668dda643494290403bf9ec908081f" alt="Astrato se conecta ao Acesso do usuário do ClickHouse" border width="1210" height="672" data-path="images/integrations/data-visualization/astrato_4c_clickhouse_completed_data_view.webp" />

<div id="creating-a-dashboard">
  ## Criando um dashboard
</div>

Em apenas alguns passos, você pode criar seu primeiro gráfico no Astrato.

1. Abra o painel de visualizações
2. Selecione uma visualização (vamos começar com Column Bar Chart)
3. Adicione dimensões
4. Adicione medidas

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=08a51bb303040f0f31692ec7fc11be71" alt="Astrato conectado ao Acesso do usuário do ClickHouse" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5a_clickhouse_build_chart.webp" />

<div id="view-generated-sql-supporting-each-visualization">
  ### Veja o SQL gerado que dá suporte a cada visualização
</div>

Transparência e precisão estão no centro do Astrato. Garantimos que toda consulta gerada seja visível, permitindo que você mantenha total controle. Todo o processamento acontece diretamente no ClickHouse, aproveitando sua velocidade e mantendo segurança e governança robustas.

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=a1f85efb08f5bbf55285658e7cedd93c" alt="Astrato conectado ao ClickHouse Acesso do usuário" border width="1215" height="675" data-path="images/integrations/data-visualization/astrato_5b_clickhouse_view_sql.webp" />

<div id="example-completed-dashboard">
  ### Exemplo de dashboard concluído
</div>

Um dashboard completo e bonito, ou um app de dados, está mais perto do que nunca. Para ver mais do que criamos, acesse nossa galeria de demonstrações em nosso site: [https://astrato.io/gallery](https://astrato.io/gallery)

<Image size="lg" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=49402b740a457b5c97f0aa3e0236678f" alt="Astrato conecta ao ClickHouse Acesso do usuário" border width="1306" height="800" data-path="images/integrations/data-visualization/astrato_5c_clickhouse_complete_dashboard.webp" />
