Apache Druid

Apache Druid 클러스터 구성

<DRUID_BASE_DIR>은 Apache Druid 클러스터가 서버에 설치된 기본 디렉터리를 나타냅니다.

SQL 사용 설정

Druid 데이터베이스에서 SQL을 사용 설정하려면 broker/runtime.properties 구성 파일에 다음 줄을 추가합니다.

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

COUNT DISTINCT 근사치 사용 중지(선택사항)

기본적으로 Druid는 COUNT DISTINCT의 근사치를 계산합니다. 정확한 결과를 얻으려면 broker/runtime.properties 구성 파일에 다음 줄을 추가합니다.

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

데이터베이스에 Looker 연결 만들기

Looker의 관리 섹션에서 연결을 선택한 후 연결 추가를 클릭합니다.

연결 세부정보를 작성합니다. 대부분의 설정은 대부분의 데이터베이스 언어에 공통적으로 적용됩니다. 자세한 내용은 Looker를 데이터베이스에 연결 문서 페이지를 참조하세요. 다음은 일부 설정에 대한 설명입니다.

  • 이름: 연결의 이름입니다.
  • 언어: Apache Druid, Apache Druid 0.13 이상 또는 Apache Druid 0.18 이상입니다.
  • 호스트: 클러스터 브로커의 DNS 또는 IP 주소입니다. broker/runtime.properties 파일에서 이 값을 찾을 수 있습니다.
  • 포트: Broker의 포트입니다. 기본 포트는 8082입니다. 클러스터가 SSL로 보호되는 경우 기본 포트는 8182입니다.
  • 데이터베이스: 데이터베이스의 이름입니다. 기본값은 druid입니다.
  • 사용자 이름: Apache Druid 클러스터가 Druid 기본 보안을 사용하도록 구성된 경우 데이터베이스 사용자 이름입니다. 그렇지 않은 경우 문자열을 지정할 수 있습니다.
  • 비밀번호: 사용자 비밀번호입니다. 클러스터가 Druid 기본 보안을 사용하도록 구성되지 않은 경우 문자열을 지정할 수 있습니다.
  • 스키마: 지정된 스키마가 없을 때 사용할 기본 스키마입니다. 스키마 입력은 선택사항입니다.

  • 추가 JDBC 매개변수: 세미콜론으로 구분된 Avatica JDBC 매개변수

    • 다음 속성을 연결 속성으로 설정할 수 있습니다.
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    예를 들면 다음과 같습니다. useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • 데이터 그룹 및 PDT 유지보수 일정: Looker가 데이터 그룹과 영구 파생 테이블을 확인해야 하는 경우를 나타내는 cron 표현식입니다. 데이터 그룹 및 PDT 유지보수 일정 문서에서 이 설정에 대해 자세히 알아보세요.

  • SSL: Apache Druid 클러스터가 Druid TLS를 사용하도록 구성되어 있는지 확인합니다.

  • Verify SSL: 엄격한 호스트 이름 인증을 시행하려면 선택합니다.

  • 노드당 최대 연결 수: 기본값은 25입니다. 이 설정은 처음에 기본값으로 두어도 됩니다. 자세한 내용은 데이터베이스에 Looker 연결 문서 페이지를 참조하세요.

  • 연결 풀 제한 시간: 기본값은 120초입니다.

  • SQL Runner 사전 캐시: 테이블을 선택할 때 SQL Runner가 테이블 정보를 미리 로드하지 않고 테이블 정보만 로드하도록 하려면 이 옵션을 선택 해제합니다. SQL Runner 사전 캐시 문서에서 이 설정에 대해 자세히 알아보세요.

  • 데이터베이스 시간대: 데이터베이스 시간대입니다. Apache Druid 0.13 이상 및 Apache Druid 0.18 이상에서 지원됩니다.

제대로 연결되었는지 확인하려면 테스트를 클릭합니다. 문제 해결 정보는 데이터베이스 연결 테스트 문서 페이지를 참조하세요.

Looker는 SELECT 1 쿼리를 실행하여 기본 연결을 확인하고 쿼리 테스트를 수행합니다. 카탈로그와 스키마 조합이 존재하는지 또는 사용자에게 해당 스키마에 대한 필수 액세스 권한이 있는지는 확인하지 않습니다.

문제가 있으면 연결 테스트 문서를 참조하세요.

이 설정을 저장하려면 연결을 클릭합니다.

SQL Runner에서 연결을 테스트합니다. SQL Runner로 이동하여 연결 및 스키마를 선택한 후 데이터베이스 테이블이 표시되는지 확인합니다.

기능 지원

Looker가 특정 기능을 지원하려면 데이터베이스 언어도 해당 기능을 지원해야 합니다.

Apache Druid

Apache Druid는 Looker 23.6부터 다음 기능을 지원합니다.

기능 지원 여부
지원 수준
지원됨
대칭 집계
아니요
파생 테이블
예
영구 SQL 파생 테이블
아니요
영구 기본 파생 테이블
아니요
공개 버전 뷰
아니요
쿼리 종료
아니요
피봇
아니요
시간대
아니요
SSL
예
소계
아니요
JDBC 추가 매개변수
예
대소문자 구분
예
위치 유형
예
목록 유형
아니요
백분위수
아니요
고유 백분위수
아니요
SQL Runner 표시 프로세스
아니요
SQL Runner 설명 테이블
아니요
SQL 실행기 표시 색인
아니요
SQL 실행기 선택 10
예
SQL 실행자 수
예
SQL 설명
예
OAuth 사용자 인증 정보
아니요
맥락 설명
예
연결 풀링
아니요
HLL 스케치
아니요
종합 인지도
아니요
점진적 PDT
아니요
밀리초
예
마이크로초
아니요
구체화된 뷰
아니요
대략적인 개수 차이
아니요

Apache Druid 0.13 이상

Apache Druid 0.13 이상에서는 Looker 23.6부터 다음 기능이 지원됩니다.

기능 지원 여부
지원 수준
지원됨
대칭 집계
아니요
파생 테이블
예
영구 SQL 파생 테이블
아니요
영구 기본 파생 테이블
아니요
공개 버전 뷰
아니요
쿼리 종료
아니요
피봇
아니요
시간대
예
SSL
예
소계
아니요
JDBC 추가 매개변수
예
대소문자 구분
예
위치 유형
아니요
목록 유형
아니요
백분위수
아니요
고유 백분위수
아니요
SQL Runner 표시 프로세스
아니요
SQL Runner 설명 테이블
아니요
SQL 실행기 표시 색인
아니요
SQL 실행기 선택 10
예
SQL 실행자 수
예
SQL 설명
예
OAuth 사용자 인증 정보
아니요
맥락 설명
예
연결 풀링
아니요
HLL 스케치
아니요
종합 인지도
아니요
점진적 PDT
아니요
밀리초
예
마이크로초
아니요
구체화된 뷰
아니요
대략적인 개수 차이
아니요

Apache Druid 0.18 이상

Apache Druid 0.18 이상에서는 Looker 23.6부터 다음 기능이 지원됩니다.

기능 지원 여부
지원 수준
지원됨
대칭 집계
아니요
파생 테이블
예
영구 SQL 파생 테이블
아니요
영구 기본 파생 테이블
아니요
공개 버전 뷰
아니요
쿼리 종료
아니요
피봇
아니요
시간대
예
SSL
예
소계
아니요
JDBC 추가 매개변수
예
대소문자 구분
예
위치 유형
예
목록 유형
아니요
백분위수
아니요
고유 백분위수
아니요
SQL Runner 표시 프로세스
아니요
SQL Runner 설명 테이블
아니요
SQL 실행기 표시 색인
아니요
SQL 실행기 선택 10
예
SQL 실행자 수
예
SQL 설명
예
OAuth 사용자 인증 정보
아니요
맥락 설명
예
연결 풀링
아니요
HLL 스케치
아니요
종합 인지도
아니요
점진적 PDT
아니요
밀리초
예
마이크로초
아니요
구체화된 뷰
아니요
대략적인 개수 차이
아니요

다음 단계

데이터베이스 연결을 완료한 후 인증 옵션을 구성합니다.