관리 메뉴의 데이터베이스 섹션에 있는 쿼리 페이지에는 Looker에서 데이터베이스에 제출한 최근 쿼리 50개에 대한 정보가 표시됩니다. 최근 50개 쿼리보다 오래된 쿼리에 대한 자세한 내용은 Looker의 사용량 섹션을 참고하세요.
향상된 쿼리 관리 실험실 기능을 사용 설정한 경우 쿼리 페이지에 다음 탭이 표시됩니다.
- 최근: 지난 1시간 동안 실행된 쿼리를 표시합니다. 이 탭에서 Looker 관리자가 실행 중인 쿼리를 취소할 수 있습니다.
- 완료: 최근 쿼리 500개를 표시합니다.
향상된 쿼리 관리 실험실 기능을 사용 설정하지 않은 경우 쿼리 페이지에 최근 쿼리 50개가 한 페이지에 표시됩니다.
기본 쿼리 정보
| 열 | 정의 |
|---|---|
| 시간 | 애플리케이션 시간대로 표시되는 쿼리 시작 시간입니다. |
| 상태 | 다음과 같은 쿼리 상태가 포함됩니다.
|
| 연결 | 이 쿼리가 실행된 Looker 연결입니다. |
| 사용자 | 이 쿼리를 실행한 사용자(확인할 수 있는 경우)입니다. Looker에서 영구 파생 테이블을 만들 때 또는 알 수 없는 사용자가 공개 Look에 액세스할 때 일부 쿼리는 특정 사용자에 의해 실행되지 않습니다. |
| 소스 | Looker의 쿼리 소스입니다(예: Explore 페이지 또는 SQL Runner). 가능한 경우 저장된 Look 또는 쿼리 ID의 링크가 모델 이름 및 Explore의 이름과 함께 표시됩니다. 일부 쿼리에는 SQL Runner에서 실행되는 것과 같은 추가 정보가 없습니다. 개방형 SQL 인터페이스에서 실행된 쿼리의 소스 값은 Sql_interface입니다. |
| 런타임 | 쿼리를 실행하는 데 걸린 시간입니다. 여기에는 쿼리 구성, 큐에서 쿼리를 소비한 모든 시점, 데이터베이스 간 송수신, 쿼리의 데이터베이스 실행이 포함됩니다.쿼리가 현재 실행 중이면 쿼리가 실행된 시간이 런타임에 표시됩니다. 이전에 실행한 쿼리의 경우 런타임에는 쿼리 실행이 완료되기까지 걸리는 시간 추정치도 표시됩니다. 예상치는 쿼리가 마지막으로 실행된 기간을 기준으로 하며 '약 2초'와 같이 표시됩니다. |
| 세부정보 버튼 | 자세한 내용은 이 페이지의 세부정보 버튼 하위 섹션을 참조하세요. |
세부정보 버튼
쿼리 오른쪽에 있는 세부정보 버튼을 클릭하면 쿼리에 대한 추가 정보가 표시됩니다. 쿼리 세부정보 팝업에는 다음이 포함됩니다.
- 쿼리에 대한 세부정보가 포함된 정보 섹션(다음 표 참조)
- 데이터베이스에 대해 실행된 원시 SQL을 보여주는 SQL 섹션. 컨텍스트 댓글은 쿼리 세부정보 정보에 표시되지 않습니다. 주석이 쿼리 캐싱에 영향을 미치지 않도록 Looker는 SQL이 데이터베이스에 전송되기 직전에 발신 SQL 명령어에 컨텍스트 주석을 추가합니다.
- 개방형 SQL 인터페이스를 통해 쿼리가 실행될 때 표시되는 SQL 인터페이스 쿼리 섹션. 이 섹션에서는 외부 BI 도구에서 Looker로 전송된 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시작 옵션을 구성하여 이 기본값을 변경할 수 있습니다.
프록시 제한 시간: 고객이 호스팅하는 인스턴스는 기본 제한 시간 60초의 프록시를 사용합니다. 이 제한 시간을 60분으로 늘리는 것이 좋습니다. 자세한 내용은 프록시 서버 또는 부하 분산기 뒤에서 Looker 실행 Looker 커뮤니티 게시물을 참조하세요.
데이터베이스 제한 시간: 대부분의 데이터베이스에는 Looker의 큐 및 제한 시간과 관계없이 큐 및 제한 시간 규칙이 있습니다. 예를 들어 쿼리가 Looker 큐에서 벗어났더라도 데이터베이스에서 큐에 추가될 수 있습니다. 데이터베이스 쿼리 제한 시간 맞춤설정 방법에 대한 자세한 내용은 데이터베이스 문서를 참조하세요.