검색어

이 페이지에서는 Explore에 포함된 query 파라미터를 참조합니다.

query는 aggregate_table 매개변수 문서 페이지에 설명된 대로 집계 테이블의 일부로 사용할 수도 있습니다.

사용

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
계층 구조
explore
query
기본값
없음

수락
쿼리를 정의하는 쿼리 및 하위 매개변수의 이름

정의

query 매개변수를 사용하여 Explore의 모델링된 분석을 만들 수 있습니다. 모델링된 분석은 비어 있는 Explore의 퀵스타트 섹션 또는 Explore가 이미 실행된 후의 퀵스타트 팝업에 나열됩니다. 작동 방식은 이 페이지의 예 섹션을 참고하세요.

모델링된 분석은 초보 Looker 사용자에게 유용합니다. 가장 관련성이 높고 유용한 측정기준, 측정, 필터, 피벗과 같은 요소를 지정할 수 있기 때문입니다.

LookML에서 쿼리 정의

쿼리의 LookML을 처음부터 만드는 대신 Explore를 사용하여 쿼리의 기본 LookML을 만들 수 있습니다. 자세한 내용은 다음 섹션인 Explore에서 쿼리 LookML 가져오기를 참고하세요.

query 파라미터에는 다음과 같은 하위 파라미터가 있습니다.

파라미터 이름 설명 예
label 선택적으로 query의 라벨을 추가합니다. 라벨은 Explore의 필드 선택 도구에 쿼리에 대해 표시되는 항목입니다. label: "Weekly Sales Totals"
description 선택적으로 이 쿼리에 대한 설명을 추가하여 사용자에게 알립니다. Explore에서 설명이 있는 쿼리에는 정보 아이콘이 표시됩니다. 사용자가 정보 아이콘 위로 마우스를 가져가면 설명 텍스트가 표시됩니다. description: "Total value of all sales per day"
dimensions Explore에서 쿼리에 포함할 측정기준의 쉼표로 구분된 목록입니다. dimensions 필드는 다음 문법을 사용합니다.

dimensions: [dimension1, dimension2, ...] 		dimensions:

  [orders.created_month, orders.country]
measures Explore에서 쿼리에 포함할 측정치의 쉼표로 구분된 목록입니다. measures 필드는 다음 문법을 사용합니다.

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters 선택적으로 query에 필터를 추가합니다. 필터는 쿼리를 생성하는 SQL의 WHERE 절에 추가됩니다.

filters 필드는 다음 문법을 사용합니다.

filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit 선택적으로 쿼리의 행 제한을 지정합니다. limit: 10
sorts 선택적으로 query의 정렬 필드와 정렬 방향 (오름차순 또는 내림차순)을 지정합니다.

sorts 필드는 다음 문법을 사용합니다.

sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots 선택적으로 쿼리의 지정된 측정기준을 기준으로 결과를 피벗합니다. pivots 필드는 다음 문법을 사용합니다.

pivots: [dimension1, dimension2, ...]

NOTE: pivots 매개변수에 지정된 필드는 쿼리의 dimensions 매개변수에도 지정해야 합니다. 		pivots: [created_quarter]
timezone 지원되지 않음 timezone 매개변수는 explore의 하위 매개변수인 query 매개변수에 지원되지 않습니다. explore 아래의 query는 explore에서 사용하는 것과 동일한 시간대를 사용합니다.

Explore에서 쿼리 LookML 가져오기

단축키로 Looker 개발자는 Explore에서 aggregate_table LookML을 생성하는 데 사용되는 기능을 차용한 다음 집계 테이블 쿼리 LookML을 복사하여 모델링된 분석 LookML의 시작점으로 사용할 수 있습니다.

집계 테이블의 LookML을 복사하면 모델링된 쿼리 LookML에 필요하지 않은 일부 매개변수도 복사됩니다. 특히 집계 테이블 LookML을 복사한 후에는 aggregate_table 및 materialization 매개변수를 삭제해야 합니다. 이러한 매개변수는 집계 테이블에만 적용되기 때문입니다. (이러한 매개변수에 대한 자세한 내용은 aggregate_table 매개변수 문서 페이지를 참고하세요.)

또한 집계 테이블 query 매개변수는 모델링된 Explore 쿼리에서 지원되는 매개변수의 일부만 지원합니다. 즉, 집계 테이블 query LookML을 복사한 후 모델링된 쿼리에 추가 매개변수를 사용할 수 있습니다. 모델링된 쿼리에 지원되는 매개변수의 전체 목록은 이 페이지의 LookML에서 쿼리 정의 섹션을 참고하세요.

Explore를 사용하여 모델링된 쿼리 LookML의 기반을 가져오려면 다음 단계를 따르세요.

  1. Explore에서 모델링된 쿼리에 포함할 모든 필드와 필터를 선택합니다.
  2. 실행을 선택하여 결과를 확인합니다.

  3. Explore 작업 톱니바퀴 메뉴에서 LookML 가져오기를 선택합니다. 이 옵션은 Looker 개발자만 사용할 수 있습니다.

  4. 집계 표 탭을 선택합니다.

  5. Looker는 집계 테이블의 Explore 상세검색을 위한 LookML을 제공합니다. 집계 테이블의 query LookML을 사용하여 모델링된 Explore 쿼리에 맞게 수정할 수 있습니다. LookML을 복사하여 Explore 개선사항 앞에 있는 주석에 표시된 연결된 모델 파일에 붙여넣습니다. Explore가 모델 파일이 아닌 별도의 Explore 파일에 정의된 경우 모델 파일 대신 Explore 파일에 상세검색을 추가할 수 있습니다.

    여기에서 모델링된 쿼리에 사용할 집계 테이블 LookML을 수정할 수 있습니다.

  6. query 매개변수와 하위 매개변수만 유지합니다. 집계 테이블에만 적용되므로 aggregate_table 및 materialization 매개변수를 삭제합니다.

  7. 쿼리 이름을 추가합니다. 이 페이지의 예 섹션에 표시된 것처럼 구문은 다음과 같습니다.

    query: query_name

  8. 원하는 경우 모델링된 쿼리에 추가 매개변수를 입력합니다. 모델링된 쿼리에 지원되는 매개변수의 전체 목록은 이 페이지의 LookML에서 쿼리 정의 섹션을 참고하세요.

예

이 예시에서는 order_items 탐색 분석을 위한 order_count_by_month 모델링된 쿼리를 만듭니다.


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

사용자는 주문 상품 Explore의 빠른 시작 섹션에서 빠른 시작 분석을 실행할 수 있습니다.