> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Looker — это корпоративная платформа для BI, приложений для работы с данными и встроенной аналитики, которая помогает анализировать данные и делиться выводами в реальном времени.

# 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>
            Партнерская интеграция
        </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>;
};

Looker может подключаться к ClickHouse Cloud или к развертыванию в собственной инфраструктуре через официальный источник данных ClickHouse.

<div id="1-gather-your-connection-details">
  ## 1. Подготовьте сведения о подключении
</div>

Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

| Параметр(ы)               | Описание                                                                                                               |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Обычно используется порт 8443 при использовании TLS и 8123 без TLS.                                                    |
| `DATABASE NAME`           | По умолчанию есть база данных `default`; используйте имя базы данных, к которой хотите подключиться.                   |
| `USERNAME` and `PASSWORD` | По умолчанию имя пользователя — `default`. Используйте имя пользователя, подходящее для вашего сценария использования. |

Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud.
Выберите сервис и нажмите **Connect**:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=dd441fc2272e292760011d48e81d43d4" size="md" alt="Кнопка подключения сервиса ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

Выберите **HTTPS**. Сведения о подключении будут показаны в примере команды `curl`.

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/cTIaEq6k6KYDgBI1/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=cTIaEq6k6KYDgBI1&q=85&s=878b1fe94ea520377426f69503e38994" size="md" alt="Сведения о подключении к ClickHouse Cloud по HTTPS" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

Если вы используете самоуправляемый ClickHouse, сведения о подключении задаёт ваш администратор ClickHouse.

<div id="2-create-a-clickhouse-data-source">
  ## 2. Создайте источник данных ClickHouse
</div>

Перейдите в Admin -> Database -> Connections и нажмите кнопку "Add Connection" в правом верхнем углу.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/looker_01.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=f919a49443ea7c4bd9d173ccf8152685" alt="Добавление нового соединения в интерфейсе управления базой данных Looker" border width="1401" height="963" data-path="images/integrations/data-visualization/looker_01.webp" />

<br />

Укажите имя источника данных, выберите `ClickHouse` в раскрывающемся списке dialect и введите свои учетные данные в соответствующие поля формы.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/looker_02.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=14c2145261f7b2c67b40104dc008822b" alt="Указание учетных данных ClickHouse в форме подключения Looker" border width="1454" height="1115" data-path="images/integrations/data-visualization/looker_02.webp" />

<br />

Если вы используете ClickHouse Cloud или для вашего развертывания требуется SSL, убедитесь, что SSL включен в дополнительных настройках.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/looker_03.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=a0069d39f46394d81da49a947cbbcca5" alt="Включение SSL для подключения ClickHouse в настройках Looker" border width="1443" height="1116" data-path="images/integrations/data-visualization/looker_03.webp" />

<br />

Сначала проверьте подключение, а затем, когда проверка завершится, подключитесь к новому источнику данных ClickHouse.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/jCcMIFRXeNsMw8EN/images/integrations/data-visualization/looker_04.webp?fit=max&auto=format&n=jCcMIFRXeNsMw8EN&q=85&s=9641c4288146d9b9b46997b0bf4e88a6" alt="Проверка подключения и подключение к источнику данных ClickHouse" border width="1728" height="1210" data-path="images/integrations/data-visualization/looker_04.webp" />

<br />

Теперь вы сможете подключить источник данных ClickHouse к своему проекту Looker.

<div id="3-known-limitations">
  ## 3. Известные ограничения
</div>

1. Следующие типы данных по умолчанию обрабатываются как строки:
   * Array — из-за ограничений JDBC driver сериализация работает не так, как ожидается
   * Decimal\* — в модели можно изменить на number
   * LowCardinality(...) — в модели можно изменить на подходящий тип
   * Enum8, Enum16
   * UUID
   * Tuple
   * Map
   * JSON
   * Nested
   * FixedString
   * Гео-типы
     * MultiPolygon
     * Polygon
     * Point
     * Ring
2. [Функция symmetric aggregate](https://cloud.google.com/looker/docs/reference/param-explore-symmetric-aggregates) не поддерживается
3. [Full outer join](https://cloud.google.com/looker/docs/reference/param-explore-join-type#full_outer) пока не реализован в драйвере