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

> Holistics é uma plataforma com tecnologia de IA para BI de autoatendimento e analytics embutido que ajuda todos a tomar decisões melhores com métricas governadas e facilmente acessíveis.

# Conectando o ClickHouse ao Holistics

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

[Holistics](https://www.holistics.io/) é uma plataforma de BI de autoatendimento nativa de IA com uma camada semântica programável para métricas consistentes e confiáveis.

Ao conectar o ClickHouse ao Holistics, suas equipes passam a contar com uma experiência de autoatendimento rápida, confiável e baseada em IA, fundamentada em uma camada semântica orientada por código. Os usuários de negócios podem explorar os dados com confiança usando recursos de arrastar e soltar e IA, enquanto você mantém as definições de métricas reutilizáveis, combináveis e versionadas no Git.

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

Antes de se conectar, certifique-se de ter o seguinte:

* **Permissões:** Você precisa ser um Admin no Holistics para adicionar novas fontes de dados.
* **Acesso à rede:** Seu servidor ClickHouse deve estar acessível a partir dos [endereços IP do Holistics](https://docs.holistics.io/docs/connect/ip-whitelisting).
* **Usuário do banco de dados:** Crie um usuário dedicado, somente leitura, para o Holistics em vez de usar uma conta de administrador.

<div id="recommended-privileges">
  ### Privilégios recomendados
</div>

O usuário dedicado precisa de privilégios de `SELECT` nas tabelas que você deseja consultar, bem como nas tabelas `system` (para detecção de esquema).

```sql theme={null}
-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;
```

<Steps>
  <Step title="Reúna os detalhes da conexão" id="step-1-gather-connection-details">
    Para se conectar ao ClickHouse com HTTP(S), você precisará destas informações:

    | **Parâmetro**              | **Descrição**                                                                                   |
    | -------------------------- | ----------------------------------------------------------------------------------------------- |
    | **Host**                   | O hostname do seu servidor ClickHouse (por exemplo, `mz322.eu-central-1.aws.clickhouse.cloud`). |
    | **Porta**                  | **8443** para ClickHouse Cloud (SSL/TLS). **8123** para instâncias autogerenciadas sem SSL.     |
    | **Nome do banco de dados** | O nome do banco de dados ao qual você deseja se conectar. O padrão geralmente é `default`.      |
    | **Nome de usuário**        | O usuário do banco de dados. O padrão é `default`.                                              |
    | **Senha**                  | A senha do usuário do banco de dados.                                                           |

    Você pode encontrar esses detalhes clicando no botão **Connect** no console do ClickHouse Cloud e selecionando **HTTPS**.

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=512a3ef076212baa4887e0f241b400c4" alt="Localização do botão Connect no console do ClickHouse Cloud" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.webp" />
  </Step>

  <Step title="Configure o acesso à rede" id="step-2-configure-network-access">
    Como o Holistics é uma aplicação em nuvem, os servidores dele precisam conseguir acessar seu banco de dados. Você tem duas opções:

    1. **Conexão direta (recomendada):** Adicione os endereços IP do Holistics à lista de permissões no seu firewall ou na IP Access List do ClickHouse Cloud. Você pode encontrar a lista de IPs no guia de [IP Whitelisting](https://docs.holistics.io/docs/connect/ip-whitelisting).

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ec2b20fe5329b6bd9ed39a5547b5c1cc" alt="Exemplo de inclusão de IPs na lista de permissões no ClickHouse Cloud" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.webp" />

    2. **Túnel SSH reverso:** Se o seu banco de dados estiver em uma rede privada (VPC) e não puder ser exposto publicamente, use um [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel).
  </Step>

  <Step title="Adicione uma fonte de dados no Holistics" id="step-3-add-data-source-in-holistics">
    1. No Holistics, vá para **Settings → fontes de dados**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=140bed8bce68e86bcb0f42e6486ea30a" alt="Navegando até fontes de dados nas configurações do Holistics" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.webp" />

    2. Clique em **Nova fonte de dados** e selecione **ClickHouse**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d92626890c46a53d7ff9dc980c02cf6a" alt="Selecionando ClickHouse na lista de novas fontes de dados" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.webp" />

    3. Preencha o formulário com os detalhes coletados na Etapa 1.

       | **Campo**                  | **Configuração**                                                                 |
       | -------------------------- | -------------------------------------------------------------------------------- |
       | **Host**                   | Hostname do seu ClickHouse                                                       |
       | **Porta**                  | `8443` (ou `8123`)                                                               |
       | **Exigir SSL**             | Ative **ON** se estiver usando a porta 8443 (obrigatório para ClickHouse Cloud). |
       | **Nome do banco de dados** | `default` (ou seu banco de dados específico)                                     |

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=cf2745f7ec9288d499a9d1a8ba349a73" alt="Preenchendo os detalhes de conexão do ClickHouse no Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.webp" />

    4. Clique em **Test Connection**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c48de7963b5e10198c670e3f62ec4496" alt="Teste de conexão com ClickHouse bem-sucedido no Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.webp" />

       * **Sucesso:** Clique em **Save**.
       * **Falha:** Verifique seu nome de usuário/senha e confirme que os [IPs do Holistics estão na lista de permissões](https://docs.holistics.io/docs/connect/ip-whitelisting).
  </Step>
</Steps>

<div id="known-limitations">
  ## Limitações conhecidas
</div>

O Holistics oferece suporte à maioria dos recursos padrão de SQL no ClickHouse, com as seguintes exceções:

* **Total acumulado:** No momento, essa função analítica tem suporte limitado no ClickHouse.
* **Tipos de dados aninhados:** Estruturas JSON ou Array muito aninhadas podem exigir achatamento por meio de modelos SQL antes da visualização.

Para ver a lista completa de recursos compatíveis, consulte a [página de limitações específicas do database](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations).