> ## 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.

> Hashboard é uma plataforma robusta de análise que pode ser facilmente integrada ao ClickHouse para análise de dados em tempo real.

# Como conectar o ClickHouse ao Hashboard

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 />

[Hashboard](https://hashboard.com) é uma ferramenta interativa de exploração de dados que permite que qualquer pessoa da sua organização acompanhe métricas e descubra insights acionáveis. O Hashboard executa consultas SQL em tempo real no seu banco de dados ClickHouse e é particularmente útil para casos de uso de exploração de dados ad hoc e self-service.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/hashboard_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=8d6a35e51b0ddbe06be6f0694a31da4e" alt="Interface do explorador de dados do Hashboard mostrando construtor de consultas interativo e visualização" border width="1653" height="801" data-path="images/integrations/data-visualization/hashboard_01.webp" />

<br />

Este guia orienta você pelas etapas para conectar o Hashboard à sua instância do ClickHouse. Essas informações também estão disponíveis na [documentação da integração com ClickHouse](https://hashboard.com/docs/database-connections/clickhouse) do Hashboard.

<div id="pre-requisites">
  ## Pré-requisitos
</div>

* Um banco de dados ClickHouse hospedado na sua própria infraestrutura ou no [ClickHouse Cloud](https://clickhouse.com/).
* Uma [conta no Hashboard](https://hashboard.com/getAccess) e um projeto.

<div id="steps-to-connect-hashboard-to-clickhouse">
  ## Etapas para conectar o Hashboard ao ClickHouse
</div>

<Steps>
  <Step title="Reúna os detalhes da conexão" id="1-gather-your-connection-details">
    Para se conectar ao ClickHouse com TCP nativo, você precisa destas informações:

    | Parâmetros              | Descrição                                                                                                       |
    | ----------------------- | --------------------------------------------------------------------------------------------------------------- |
    | `HOST` e `PORT`         | Normalmente, a porta é 9440 ao usar TLS, ou 9000 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ê quer se conectar. |
    | `USERNAME` e `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 o serviço ao qual você vai se conectar 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 **Native**; os detalhes estarão disponíveis em um comando `clickhouse-client` de exemplo.

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-native.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=91bf501b52dd0ed0fddf84f56d290fc8" alt="Detalhes da conexão TCP nativa do ClickHouse Cloud" width="1290" height="1176" data-path="images/_snippets/connection-details-native.webp" />
      </Frame>
    </div>

    Se você estiver usando ClickHouse autogerenciado, os detalhes da conexão serão definidos pelo administrador do ClickHouse.
  </Step>

  <Step title="Adicione uma nova conexão de banco de dados no Hashboard" id="2-add-a-new-database-connection-in-hashboard">
    1. Acesse seu [projeto no Hashboard](https://hashboard.com/app).
    2. Abra a página Settings clicando no ícone de engrenagem na barra lateral de navegação.
    3. Clique em `+ New Database Connection`.
    4. Na janela modal, selecione "ClickHouse."
    5. Preencha os campos **Connection Name**, **Host**, **Port**, **Username**, **Password** e **Database** com as informações coletadas anteriormente.
    6. Clique em "Test" para verificar se a conexão foi configurada com sucesso.
    7. Clique em "Add"

    Seu banco de dados ClickHouse agora está conectado ao Hashboard, e você pode prosseguir criando [Modelos de Dados](https://hashboard.com/docs/data-modeling/add-data-model), [Explorações](https://hashboard.com/docs/visualizing-data/explorations), [Métricas](https://hashboard.com/docs/metrics) e [Painéis](https://hashboard.com/docs/dashboards). Consulte a documentação correspondente do Hashboard para obter mais detalhes sobre esses recursos.
  </Step>
</Steps>

<div id="learn-more">
  ## Saiba mais
</div>

Para conhecer recursos mais avançados e obter ajuda para solucionar problemas, consulte a [documentação do Hashboard](https://hashboard.com/docs).