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

> Looker é uma plataforma corporativa para BI, aplicações de dados e análises embutidas que ajuda a explorar e compartilhar insights em tempo real.

# Looker

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Partner Integration
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

O Looker pode se conectar ao ClickHouse Cloud ou a uma implantação on-premise por meio da fonte de dados oficial do ClickHouse.

<div id="1-gather-your-connection-details">
  ## 1. Reúna os detalhes de conexão
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/1oh4rjwfuHRS2yL2/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=1oh4rjwfuHRS2yL2&q=85&s=81c1524ac8ac2dac27e1558f13fcfd29" size="md" alt="botão Connect do serviço do ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/1oh4rjwfuHRS2yL2/images/_snippets/connection-details-https.png?fit=max&auto=format&n=1oh4rjwfuHRS2yL2&q=85&s=335e19954512afe36d735a736cd32be7" size="md" alt="detalhes de conexão HTTPS do ClickHouse Cloud" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

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

<div id="2-create-a-clickhouse-data-source">
  ## 2. Crie uma fonte de dados do ClickHouse
</div>

Navegue até Admin -> Database -> Connections e clique no botão "Add Connection" no canto superior direito.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ujc-kN615--sFi3M/images/integrations/data-visualization/looker_01.png?fit=max&auto=format&n=ujc-kN615--sFi3M&q=85&s=9fe3148e2734c6d46d26e75efd0bab23" alt="Adicionando uma nova conexão na interface de gerenciamento de banco de dados do Looker" border width="1401" height="963" data-path="images/integrations/data-visualization/looker_01.png" />

<br />

Escolha um nome para sua fonte de dados e selecione `ClickHouse` no menu suspenso de dialeto. Insira suas credenciais no formulário.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ujc-kN615--sFi3M/images/integrations/data-visualization/looker_02.png?fit=max&auto=format&n=ujc-kN615--sFi3M&q=85&s=ce3ea358221f4548d063492d242335e4" alt="Informando suas credenciais do ClickHouse no formulário de conexão do Looker" border width="1454" height="1115" data-path="images/integrations/data-visualization/looker_02.png" />

<br />

Se você estiver usando ClickHouse Cloud ou se a sua implantação exigir SSL, certifique-se de que o SSL esteja ativado nas configurações adicionais.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ujc-kN615--sFi3M/images/integrations/data-visualization/looker_03.png?fit=max&auto=format&n=ujc-kN615--sFi3M&q=85&s=ed8dfd6f3ac9dc4759a3a923448549b4" alt="Ativando SSL para a conexão com o ClickHouse nas configurações do Looker" border width="1443" height="1116" data-path="images/integrations/data-visualization/looker_03.png" />

<br />

Primeiro, teste a conexão e, quando isso for concluído, conecte-se à sua nova fonte de dados do ClickHouse.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ujc-kN615--sFi3M/images/integrations/data-visualization/looker_04.png?fit=max&auto=format&n=ujc-kN615--sFi3M&q=85&s=c45cb027b31c7784942b62cb617e28c1" alt="Testando e conectando-se à fonte de dados do ClickHouse" border width="1728" height="1210" data-path="images/integrations/data-visualization/looker_04.png" />

<br />

Agora você já deve conseguir vincular a fonte de dados do ClickHouse ao seu projeto do Looker.

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

1. Os seguintes tipos de dados são tratados como strings por padrão:
   * Array - a serialização não funciona como esperado devido às limitações do driver JDBC
   * Decimal\* - pode ser alterado para número no model
   * LowCardinality(...) - pode ser alterado para um tipo apropriado no model
   * Enum8, Enum16
   * UUID
   * Tuple
   * Map
   * JSON
   * Nested
   * FixedString
   * tipos Geo
     * MultiPolygon
     * Polygon
     * Point
     * Ring
2. O [recurso de agregação simétrica](https://cloud.google.com/looker/docs/reference/param-explore-symmetric-aggregates) não tem suporte
3. O [full outer join](https://cloud.google.com/looker/docs/reference/param-explore-join-type#full_outer) ainda não foi implementado no driver
