관리자 설정 - 쿼리

관리 메뉴의 데이터베이스 섹션에 있는 쿼리 페이지에는 Looker에서 데이터베이스에 제출한 최근 쿼리 50개에 대한 정보가 표시됩니다. 그보다 오래된 쿼리에 대한 자세한 내용은 Looker의 사용량 섹션을 참조하세요.

기본 쿼리 정보

정의
시간 애플리케이션 시간대로 표시되는 쿼리 시작 시간입니다.
상태 다음과 같은 쿼리 상태가 포함됩니다.
  • 캐시: Looker가 데이터베이스에 대해 중복 쿼리를 실행하는 대신 캐시에서 결과를 반환했습니다.
  • 완료: 쿼리가 성공적으로 완료되었습니다.
  • 오류: 오류가 발생하여 쿼리를 완료할 수 없습니다. 자세한 내용은 세부정보 버튼을 클릭하면 확인할 수 있습니다.
  • 취소됨: Looker 또는 사용자가 쿼리를 취소했습니다.
  • PDT 대기: 쿼리를 실행하려면 영구 파생 테이블이 빌드될 때까지 기다려야 합니다.
  • PDT 빌드 중: 영구 파생 테이블이 빌드 중입니다.
  • 대기 중: 이미 진행 중인 쿼리가 너무 많아 쿼리를 실행하기 위해 대기 중입니다(연결 설정 또는 데이터베이스의 Looker가 쿼리를 제한할 수 있음).
  • 실행 중: 쿼리가 실행 중입니다.
  • 알 수 없음: Looker에서 이 쿼리의 상황을 확인할 수 없습니다.
연결 이 쿼리가 실행된 Looker 연결입니다.
사용자 이 쿼리를 실행한 사용자(확인할 수 있는 경우)입니다. Looker에서 영구 파생 테이블을 만들 때 또는 알 수 없는 사용자가 공개 Look에 액세스할 때 일부 쿼리는 특정 사용자에 의해 실행되지 않습니다.
원본 Looker의 쿼리 소스입니다(예: Explore 페이지 또는 SQL Runner). 가능한 경우 저장된 Look 또는 쿼리 ID의 링크가 모델 이름 및 Explore의 이름과 함께 표시됩니다. 일부 쿼리에는 SQL Runner에서 실행되는 것과 같은 추가 정보가 없습니다.
런타임 쿼리를 실행하는 데 걸린 시간입니다. 여기에는 쿼리 구성, 큐에서 쿼리를 소비한 모든 시점, 데이터베이스 간 송수신, 쿼리의 데이터베이스 실행이 포함됩니다.

쿼리가 현재 실행 중이면 쿼리가 실행된 시간이 런타임에 표시됩니다. 이전에 실행한 쿼리의 경우 런타임에는 쿼리 실행이 완료되기까지 걸리는 시간 추정치도 표시됩니다. 예상치는 쿼리가 마지막으로 실행된 기간을 기준으로 하며 '약 2초'와 같이 표시됩니다.
세부정보 버튼 자세한 내용은 이 페이지의 세부정보 버튼 하위 섹션을 참조하세요.

세부정보 버튼

쿼리 오른쪽에 있는 세부정보 버튼을 클릭하면 쿼리에 대한 추가 정보가 표시됩니다. 쿼리 세부정보 팝업에는 다음이 포함됩니다.

  • 쿼리에 대한 세부정보가 포함된 정보 섹션(다음 표 참조)
  • 데이터베이스에 대해 실행된 원시 SQL을 보여주는 SQL 섹션. 컨텍스트 댓글쿼리 세부정보 정보에 표시되지 않습니다. 주석이 쿼리 캐싱에 영향을 미치지 않도록 Looker는 SQL이 데이터베이스에 전송되기 직전에 발신 SQL 명령어에 컨텍스트 주석을 추가합니다.
  • SQL Runner에서 쿼리를 여는 SQL Runner에서 열기 링크

정보 섹션에는 다음 정보가 포함됩니다.

섹션 정의
기록 ID 쿼리의 기록 ID입니다(가능한 경우).
상태 기본 쿼리 정보 표에 설명된 쿼리의 상태입니다.
메시지 쿼리에 PDT가 포함된 경우 PDT 생성 주석이 이 필드에 표시됩니다. 쿼리에 PDT가 포함되지 않으면 필드가 표시되지 않습니다.
연결 이 쿼리가 실행된 Looker 연결입니다.
사용자 이 쿼리를 실행한 사용자(확인할 수 있는 경우)입니다. Looker에서 영구 파생 테이블을 만들 때 또는 알 수 없는 사용자가 공개 Look에 액세스할 때 일부 쿼리는 특정 사용자에 의해 실행되지 않습니다.
원본 Looker의 쿼리 소스입니다(예: Explore 페이지 또는 SQL Runner). 가능한 경우 저장된 Look에 대한 링크, 쿼리 ID, 모델 이름, Explore 이름, 선택한 필드 등의 추가 정보가 표시됩니다.
시작 시간 애플리케이션 시간대로 표시되는 쿼리 시작 시간입니다.
종료 시간 애플리케이션 시간대로 표시되는 쿼리 종료 시간입니다.
런타임 쿼리를 실행하는 데 걸린 시간입니다.

쿼리 종료

쿼리가 실행 중인 브라우저 탭을 닫으면 Looker에서 여전히 실행 중인 쿼리를 자동으로 중지합니다. Looker 관리자는 쿼리 페이지에서 실행 중인 쿼리를 중지할 수도 있습니다. see_queries 권한이 있는 사용자는 쿼리 페이지를 볼 수 있지만 Looker 관리자만 실행 중인 쿼리를 중지할 수 있습니다. 아직 실행 중인 모든 쿼리에는 쿼리 오른쪽에 중지 버튼이 표시됩니다. 쿼리를 중지하려면 중지를 클릭합니다.

Looker에서 쿼리를 강제 종료하려면 데이터베이스 언어에서 쿼리 종료를 지원해야 합니다. 다음 목록은 최신 버전의 Looker에서 쿼리 종료를 지원하는 언어를 보여줍니다.

언어 지원 여부
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Apache Druid
아니요
Apache Druid 0.13 이상
아니요
Apache Druid 0.18 이상
아니요
Apache Hive 2.3 이상
Apache Hive 3.1.2 이상
Apache Spark 3 이상
ClickHouse
Cloudera Impala 3.1 이상
네이티브 드라이버를 사용하는 Cloudera Impala 3.1 이상
네이티브 드라이버를 사용하는 Cloudera Impala
DataVirtuality
Databricks
Denodo 7
Denodo 8
Dremio
Dremio 11 이상
Exasol
Firebolt
Google BigQuery Legacy SQL
Google BigQuery 표준 SQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
아니요
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL 데이터베이스
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008 이상
Microsoft SQL Server 2012 이상
Microsoft SQL Server 2016
Microsoft SQL Server 2017 이상
MongoBI
MySQL
MySQL 8.0.12 이상
Oracle
Oracle ADWC
PostgreSQL 9.5 이상
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA 2 이상
SingleStore
SingleStore 7 이상
Snowflake
Teradata
Trino
벡터
Vertica

쿼리 제한 시간 및 큐 추가

Looker는 큐에서 너무 오래 대기한 쿼리를 종료합니다. 이 작업을 시간 제한이라고 합니다. 쿼리에 다음과 같은 몇 가지 제한 시간이 적용될 수 있습니다.

  • 연결 풀 제한 시간: 동시 쿼리로 데이터베이스에 과부하가 걸리지 않도록 Looker는 Looker 쿼리 큐에 초과된 동시 쿼리를 보유하고 너무 오래 큐에 있는 쿼리를 종료합니다. 기본적으로 동시 쿼리는 연결당 최대 75개까지 허용됩니다. 연결 한도를 초과하는 추가 쿼리는 0초 후에 타임아웃됩니다. 이러한 기본값을 변경하려면 연결의 연결 설정 페이지에서 최대 연결 수연결 풀 제한 시간 설정을 구성합니다.

  • 사용자별 쿼리 한도 및 제한 시간: 단일 사용자가 Looker 쿼리 큐를 채우지 못하도록 각 사용자에게 허용되는 최대 동시 쿼리 수와 해당 큐 시간 제한이 있습니다. 기본적으로 각 사용자는 최대 15개의 동시 쿼리를 실행할 수 있으며, 이 제한으로 인해 큐에 추가된 쿼리의 제한 시간은 600초입니다. 이 설정은 일반 인증 프로세스를 사용하여 Looker에 로그인하는 사용자와 API 사용자 인증 정보를 사용하여 로그인하는 사용자 모두에게 적용됩니다. 고객이 호스팅하는 Looker 인스턴스의 경우 --per-user-query-limit--per-user-query-timeout 시작 옵션을 구성하여 이 기본값을 변경할 수 있습니다.

  • 스케줄러 쿼리 한도 및 제한 시간: Looker 스케줄러 프로세스의 과부하를 방지하기 위해 Looker 인스턴스는 최대 10개의 동시 예약 쿼리를 실행할 수 있으며, 스케줄러 큐의 쿼리 제한 시간은 1,200초입니다. 고객이 호스팅하는 Looker 인스턴스의 경우 --scheduler-query-limit--scheduler-query-timeout 시작 옵션을 구성하여 이 기본값을 변경할 수 있습니다.

  • 렌더기 쿼리 제한 및 제한 시간: Looker 인스턴스는 Looker 렌더기 프로세스 과부하가 방지되도록 PDF 및 PNG 형식과 같은 동시 이미지 기반 다운로드를 최대 2회까지 렌더링할 수 있습니다. 고객이 호스팅하는 Looker 인스턴스의 경우 --concurrent-render-jobs 시작 옵션을 구성하여 이 기본값을 변경할 수 있습니다.

  • 웹훅 제한 시간: Looker는 최대 30분 동안 웹훅에 데이터 전송을 시도합니다. Looker에서 30분 내에 웹훅 대상과 통신할 수 없으면 쿼리가 타임아웃됩니다. 이 제한 시간은 구성할 수 없습니다.
    • 프록시 제한 시간: 고객이 호스팅하는 인스턴스는 기본 제한 시간 60초의 프록시를 사용합니다. 이 제한 시간을 60분으로 늘리는 것이 좋습니다. 자세한 내용은 프록시 서버 또는 부하 분산기 뒤에서 Looker 실행 Looker 커뮤니티 게시물을 참조하세요.

    • 데이터베이스 제한 시간: 대부분의 데이터베이스에는 Looker의 큐 및 제한 시간과 관계없이 큐 및 제한 시간 규칙이 있습니다. 예를 들어 쿼리가 Looker 큐에서 벗어났더라도 데이터베이스에서 큐에 추가될 수 있습니다. 데이터베이스 쿼리 제한 시간 맞춤설정 방법에 대한 자세한 내용은 데이터베이스 문서를 참조하세요.