Apache Druid

네트워크 트래픽 암호화

Looker 애플리케이션과 데이터베이스 사이에 네트워크 트래픽을 암호화하는 것이 가장 좋습니다. 보안 데이터베이스 액세스 사용 설정 문서 페이지에 설명된 옵션 중 하나를 고려해 보세요.

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 Druide 0.13.x~0.17.x) 또는 Apache Druid 0.18+ 입니다.

  • 호스트: 클러스터 브로커의 DNS 또는 IP 주소입니다. broker/runtime.properties 파일에서 이 값을 찾을 수 있습니다.

  • 포트: Broker의 포트입니다. 기본 포트는 8082입니다. 클러스터가 SSL로 보호되는 경우 기본 포트는 8182입니다.

  • 데이터베이스: 데이터베이스의 이름입니다. 기본값은 druid입니다.

  • 사용자 이름: Apache Druid 클러스터가 Druid 기본 보안을 사용하도록 구성된 경우 데이터베이스 사용자 이름입니다. 그렇지 않은 경우 문자열을 지정할 수 있습니다.

  • 비밀번호: 사용자 비밀번호입니다. 클러스터가 Druid 기본 보안을 사용하도록 구성되지 않은 경우 문자열을 지정할 수 있습니다.

  • 스키마: 지정된 스키마가 없을 때 사용할 기본 스키마입니다. 스키마 입력은 선택사항입니다.

  • 추가 JDBC 매개변수: 세미콜론으로 구분된 Avatica JDBC 매개변수입니다. Looker에서 지원하는 매개변수 목록은 이 페이지의 지원되는 JDBC 매개변수 섹션을 참조하세요.

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

    예: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

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

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

Looker에 연결 가능 이 표시되면 연결 을 눌러 연결을 만듭니다.

그러면 데이터베이스 연결이 Looker 연결 관리 페이지의 목록에 추가됩니다.

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

지원되는 JDBC 매개변수

Apache Druid의 경우 Looker는 연결의 추가 JDBC 매개변수 필드에서 다음 JDBC 매개변수를 지원합니다. 이러한 매개변수에 대한 자세한 내용은 데이터베이스 문서를 참조하세요.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

기능 지원

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

Apache Druid

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

기능 지원 여부
Looker (Google Cloud 핵심 서비스)
대칭 집계
파생 테이블
영구 SQL 파생 테이블
영구 기본 파생 테이블
안정적인 뷰
쿼리 종료
SQL 기반 피벗
시간대
SSL
소계
JDBC 추가 파라미터
대소문자 구분
위치 유형
목록 유형
백분위수
고유 백분위수
SQL Runner 표시 프로세스
SQL Runner 설명 테이블
SQL Runner 표시 색인
SQL Runner 선택 10
SQL Runner 카운트
SQL 설명
OAuth 2.0 사용자 인증 정보
컨텍스트 주석
연결 풀링
HLL 스케치
집계 인식
증분 PDT
밀리초
마이크로초
구체화된 뷰
이전 기간 대비 측정항목
대략적인 고유값
데이터베이스 내 분석 모델
맞춤 캘린더

Apache Druid 0.13.x~0.17.x

Apache Druid 0.13.x~0.17.x는 Looker 26.14부터 다음 기능을 지원합니다.

기능 지원 여부
Looker (Google Cloud 핵심 서비스)
대칭 집계
파생 테이블
영구 SQL 파생 테이블
영구 기본 파생 테이블
안정적인 뷰
쿼리 종료
SQL 기반 피벗
시간대
SSL
소계
JDBC 추가 파라미터
대소문자 구분
위치 유형
목록 유형
백분위수
고유 백분위수
SQL Runner 표시 프로세스
SQL Runner 설명 테이블
SQL Runner 표시 색인
SQL Runner 선택 10
SQL Runner 카운트
SQL 설명
OAuth 2.0 사용자 인증 정보
컨텍스트 주석
연결 풀링
HLL 스케치
집계 인식
증분 PDT
밀리초
마이크로초
구체화된 뷰
이전 기간 대비 측정항목
대략적인 고유값
데이터베이스 내 분석 모델
맞춤 캘린더

Apache Druid 0.18 이상

Apache Druid 0.18 이상은 Looker 26.14부터 다음 기능을 지원합니다.

기능 지원 여부
Looker (Google Cloud 핵심 서비스)
대칭 집계
파생 테이블
영구 SQL 파생 테이블
영구 기본 파생 테이블
안정적인 뷰
쿼리 종료
SQL 기반 피벗
시간대
SSL
소계
JDBC 추가 파라미터
대소문자 구분
위치 유형
목록 유형
백분위수
고유 백분위수
SQL Runner 표시 프로세스
SQL Runner 설명 테이블
SQL Runner 표시 색인
SQL Runner 선택 10
SQL Runner 카운트
SQL 설명
OAuth 2.0 사용자 인증 정보
컨텍스트 주석
연결 풀링
HLL 스케치
집계 인식
증분 PDT
밀리초
마이크로초
구체화된 뷰
이전 기간 대비 측정항목
대략적인 고유값
데이터베이스 내 분석 모델
맞춤 캘린더

다음 단계

데이터베이스 연결을 완료한 후 인증 옵션 구성하기