Looker

Partner Integration

Looker는 공식 ClickHouse 데이터 소스를 통해 ClickHouse Cloud 또는 온프레미스 배포 환경에 연결할 수 있습니다.

1. 연결 정보 확인

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

Parameter(s)	Description
HOST and PORT	일반적으로 TLS를 사용할 때는 포트가 8443이고, TLS를 사용하지 않을 때는 8123입니다.
DATABASE NAME	기본적으로 default라는 데이터베이스가 있으며, 연결하려는 데이터베이스의 이름을 사용합니다.
USERNAME and PASSWORD	기본값으로 사용자 이름은 default입니다. 사용하려는 용도에 적합한 사용자 이름을 사용합니다.

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

HTTPS를 선택하십시오. 연결 정보는 예제 curl 명령에 표시됩니다.

자가 관리형 ClickHouse를 사용하는 경우, 연결 정보는 ClickHouse 관리자가 설정합니다.

2. ClickHouse 데이터 소스 생성

Admin -> Database -> Connections로 이동한 후 오른쪽 상단의 「Add Connection」 버튼을 클릭합니다.

데이터 소스 이름을 지정한 다음 Dialect 드롭다운에서 ClickHouse를 선택합니다. 양식에 자격 증명을 입력합니다.

ClickHouse Cloud를 사용하거나 배포에 SSL이 필요한 경우, 추가 설정에서 SSL이 활성화되어 있는지 확인합니다.

연결을 먼저 테스트한 다음, 성공하면 새 ClickHouse 데이터 소스에 연결합니다.

이제 ClickHouse 데이터 소스를 Looker 프로젝트에 연결할 수 있습니다.

3. 알려진 제한 사항

1. 다음 데이터 타입은 기본적으로 문자열로 처리됩니다.
   • Array - JDBC 드라이버의 제한으로 인해 직렬화가 예상대로 동작하지 않습니다
   • Decimal* - 모델에서 number로 변경할 수 있습니다
   • LowCardinality(...) - 모델에서 적절한 타입으로 변경할 수 있습니다
   • Enum8, Enum16
   • UUID
   • Tuple
   • Map
   • JSON
   • Nested
   • FixedString
   • Geo 타입
     • MultiPolygon
     • Polygon
     • Point
     • Ring
2. Symmetric aggregate 기능은 지원되지 않습니다
3. Full outer join은 아직 드라이버에 구현되지 않았습니다