> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.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 데이터 소스를 통해 ClickHouse Cloud 또는 온프레미스 배포 환경에 연결할 수 있습니다.

<div id="1-gather-your-connection-details">
  ## 1. 연결 정보를 확인합니다
</div>

HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.

| 매개변수                      | 설명                                                         |
| ------------------------- | ---------------------------------------------------------- |
| `HOST` and `PORT`         | 일반적으로 TLS를 사용하는 경우 포트는 8443, TLS를 사용하지 않는 경우 8123입니다.      |
| `DATABASE NAME`           | 기본적으로 `default`라는 이름의 데이터베이스가 제공되며, 연결할 데이터베이스 이름을 사용하십시오. |
| `USERNAME` and `PASSWORD` | 기본 사용자 이름은 `default`입니다. 사용 사례에 맞는 사용자 이름을 사용하십시오.         |

ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
서비스를 선택한 다음 **Connect**를 클릭하십시오.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" 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-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/looker_01.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=cb5846b6a77fb20c68023fab8a0e79b8" alt="Looker의 데이터베이스 관리 인터페이스에서 새 연결을 추가하는 모습" border width="1401" height="963" data-path="images/integrations/data-visualization/looker_01.webp" />

<br />

데이터 소스 이름을 지정하고, 방언 드롭다운에서 `ClickHouse`를 선택합니다. 그런 다음 양식에 자격 증명을 입력합니다.

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/looker_02.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=f708c905c47561747b4eb7ecaba82696" alt="Looker 연결 양식에 ClickHouse 자격 증명을 입력하는 모습" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/looker_03.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=79bb19b7f3e09c738dbd5fee0384bae0" alt="Looker 설정에서 ClickHouse 연결에 SSL을 활성화하는 모습" 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-detect-table-modification/L7_COrR7NltKl_Va/images/integrations/data-visualization/looker_04.webp?fit=max&auto=format&n=L7_COrR7NltKl_Va&q=85&s=14abf082cdd131287b20e914e4ebc77c" 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 드라이버의 제한으로 인해 serialization이 예상대로 동작하지 않습니다
   * Decimal\* - 모델에서 숫자 유형으로 변경할 수 있습니다
   * LowCardinality(...) - 모델에서 적절한 타입으로 변경할 수 있습니다
   * Enum8, Enum16
   * UUID
   * Tuple
   * Map
   * JSON
   * Nested
   * FixedString
   * Geo 타입
     * 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)은 아직 드라이버에 구현되어 있지 않습니다