관리자 설정: 쿼리

Looker 22.16부터 Looker 관리자는 향상된 쿼리 관리자 실험용 실험실 기능을 사용 설정하여 쿼리 페이지를 개선할 수 있습니다. 실험실 기능은 쿼리 페이지에서 성능을 개선하며 50개가 아니라 페이지로 나눈 쿼리 500개를 나열합니다.

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

기본 쿼리 정보

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

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

세부정보 버튼

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

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

정보 섹션에는 다음 정보가 포함되어 있습니다.

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

쿼리 종료

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

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

쿼리 시간 제한 및 큐 추가

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

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

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

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

    Looker 인스턴스가 클러스터링된 경우 클러스터의 각 노드가 자체 스케줄러 큐를 사용합니다. 따라서 클러스터에 노드를 추가하면 Looker 스케줄러 프로세스에 추가 부담을 주지 않으면서 동시에 예약된 총 쿼리 수가 늘어납니다.

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

    Looker 인스턴스가 클러스터링된 경우 클러스터의 각 노드가 자체 렌더기 큐를 사용합니다. 따라서 클러스터에 노드를 추가하면 Looker 렌더기 프로세스에 추가 부담을 주지 않고 허용된 동시 렌더기 작업의 총 양이 증가합니다.

  • 웹훅 제한 시간: Looker에서 최대 30분 동안 웹훅에 데이터 전송을 시도합니다. Looker가 30분 내에 웹훅 대상과 통신할 수 없는 경우 쿼리가 타임아웃됩니다. 이 제한 시간은 구성할 수 없습니다.

  • 프록시 제한 시간: Looker에서 호스팅하는 인스턴스는 60분 동안 실행된 모든 쿼리를 종료하는 프록시를 사용합니다. 이 제한 시간은 구성할 수 없습니다.

    고객이 호스팅하는 인스턴스는 기본 시간 초과가 60초인 프록시를 사용합니다. 제한 시간을 60분으로 늘리는 것이 좋습니다. 자세한 내용은 프록시 서버 또는 부하 분산기 뒤에서 Looker 실행 Looker 커뮤니티 게시물을 참고하세요.

  • 데이터베이스 제한 시간: 대부분의 데이터베이스에는 Looker의 큐 및 시간 초과와 별개로 큐에 추가 및 제한 시간 규칙이 있습니다. 예를 들어 쿼리가 Looker 큐에서 떠났지만 데이터베이스에 계속 큐에 있을 수 있습니다. 데이터베이스 쿼리 제한 시간 맞춤설정에 대한 자세한 내용은 데이터베이스 문서를 참조하세요.