Explore 매개변수

이 페이지는 explore 매개변수의 하위 요소인 모든 LookML 매개변수로 연결됩니다.

Explore는 Looker 애플리케이션에서 쿼리의 시작점으로 사용됩니다. Explore는 를 참조하며 각 Explore에는 다른 뷰에 대한 조인이 포함될 수 있습니다. Explore는 일반적으로 모델 파일에 선언해야 합니다.

사용 예시

매개변수 이름 위로 마우스를 가져가면 간단한 설명이 표시되고, 클릭하면 해당 페이지로 이동합니다. 매개변수를 여러 특정 옵션 중 하나로 설정할 수 있는 경우 기본값이 먼저 표시됩니다.

## STRUCTURAL PARAMETERS

explore: explore_name {
  extension: required
  extends: [explore_name,  explore_name, ...]
  fields: [field_or_set, field_or_set, ...]
  tags: ["string1", "string2", ...]

  # DISPLAY PARAMETERS
  description: "Description I want"
  group_label: "Label to use as a heading in the Explore menu"
  hidden: yes | no
  label: "desired label"
  query:  {
      # Desired query parameters (described on the query page)      }
  view_label: "Field picker heading I want for the Explore's fields"

  # FILTER PARAMETERS

  access_filter: {
    field: fully_scoped_field
    user_attribute: user_attribute_name
  }

  # Possibly more access_filter declarations

  always_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
  }
  case_sensitive: yes | no
  conditionally_filter: {
    filters: [field_name: "filter expression", field_name: "filter expression", ...]
    unless: [field_name, field_name, ...]
  }
  sql_always_having: SQL HAVING condition ;;
  sql_always_where: SQL WHERE condition ;;

  # JOIN PARAMETERS

  always_join: [view_name, view_name, ...]
  join: view_name {
    # Desired join parameters (described on Join Parameters page)
  }
  # Possibly more join declarations

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  cancel_grouping_fields: [fully_scoped_field, fully_scoped_field, ...]
  from: view_name
  persist_for: "N (seconds | minutes | hours)"
  persist_with: datagroup_name
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;
  sql_preamble: SQL STATEMENT  ;;
  symmetric_aggregates: yes | no
  view_name: view_name

  # AGGREGATE TABLE PARAMETERS

  aggregate_table: table_name {
    query:  {
      # Desired query parameters (described on the aggregate_table page)
    }
    materialization:  {
      # Desired materialization parameters (described on the aggregate_table page)
    }
  }
  # Possibly more aggregate_table declarations
}

## REFINEMENT PARAMETERS

explore: +explore_name {
  final: yes
}

매개변수 정의

파라미터 이름 설명
구조적 매개변수
extends (Explore용) 이 Explore에 의해 확장될 Explore를 지정합니다.
extension (Explore용) Explore에 확장 프로그램이 필요하며 사용자에게 직접 노출될 수 없음을 지정합니다.
explore (모델용) Explore 메뉴에 뷰를 노출합니다.
fields (Explore용) Explore의 기본 뷰 및 Explore의 조인을 통해 사용할 수 있는 필드를 제한합니다.
tags (Explore용) 다른 애플리케이션에 전달할 수 있는 텍스트를 지정합니다.
디스플레이 매개변수
description (Explore용) 사용자에게 UI에 표시되는 Explore에 대한 설명을 추가합니다.
group_label (Explore용) 탐색 메뉴에서 제목으로 사용할 그룹 라벨을 만듭니다.
hidden (Explore용) Explore 메뉴에서 Explore를 숨깁니다.
label (Explore용) Explore 메뉴에 Explore가 표시되는 방식을 변경합니다.
query (Explore용) 사용자가 Explore의 퀵스타트 메뉴에서 선택할 수 있는 사전 정의된 쿼리를 만듭니다.
view_label (Explore용) Explore의 기본 뷰에 있는 필드 그룹에 필드 선택 도구에서 라벨이 지정되는 방식을 지정합니다.
필터 매개변수
access_filter Explore에 사용자별 필터를 추가합니다.
always_filter 사용자가 변경할 수 있지만 삭제할 수는 없는 필터를 Explore에 추가합니다.
case_sensitive (Explore용) Explore에서 필터가 대소문자를 구분하는지 여부를 지정합니다.
conditionally_filter 사용자가 특정 목록에서 자체 필터를 추가하지 않는 경우 Explore에 필터를 추가합니다.
sql_always_having 사용자가 이 Explore에 대해 변경하거나 삭제할 수 없는 조건을 쿼리의 HAVING 절에 삽입합니다.
sql_always_where 사용자가 이 Explore에 대해 변경하거나 삭제할 수 없는 조건을 쿼리의 WHERE 절에 삽입합니다.
조인 매개변수
always_join Explore에 항상 적용해야 하는 조인을 지정합니다.
join Explore에 추가 뷰를 조인합니다. 조인 및 조인 매개변수에 대한 자세한 내용은 조인 매개변수 참조 페이지를 참고하세요.
쿼리 매개변수
autogenerate_primary_keys (Explore용) 자동 기본 키 생성을 사용 설정 또는 사용 중지합니다.
cancel_grouping_fields Explore에서 특정 필드를 선택하면 GROUP BY 절이 취소됨
from (Explore용) Explore가 기반으로 할 뷰를 지정하고 Explore 이름으로 해당 뷰의 필드를 참조합니다.
persist_for (Explore용) Explore의 캐시 설정을 변경합니다.
persist_with (Explore용) Explore의 캐싱 정책에 사용할 데이터 그룹을 지정합니다.
required_access_grants (Explore용) 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자로만 Explore에 대한 액세스를 제한합니다.
sql_table_name (Explore용) Explore가 기반으로 할 데이터베이스 테이블을 지정합니다.
symmetric_aggregates Explore에 대칭 집계가 사용 설정되어 있는지 여부를 지정합니다.
view_name (Explore용) Explore의 기반이 되는 뷰를 지정하고 뷰의 이름으로 해당 뷰의 필드를 참조합니다.
집계 테이블 매개변수
aggregate_table Explore의 쿼리에 집계 인식을 사용하기 위해 집계 테이블을 만듭니다. aggregate_table 파라미터에 대한 자세한 내용은 aggregate_table 파라미터 페이지를 참고하세요. 집계 인식 개요는 집계 인식 문서 페이지를 참고하세요.
query 총괄 표의 쿼리를 정의합니다. query 및 하위 매개변수에 관한 자세한 내용은 aggregate_table 파라미터 페이지를 참고하세요.
materialization 총괄 표의 지속성 전략을 정의합니다. materialization 및 하위 매개변수에 관한 자세한 내용은 aggregate_table 파라미터 페이지를 참고하세요.
세부 조정 매개변수
explore: +explore_name 기존 Explore에 상세검색을 추가하기 위해 기존 Explore 이름 앞에 더하기 기호 (+)를 추가합니다. 자세한 내용과 사용 사례는 LookML 상세검색 문서 페이지를 참고하세요.
final 현재 상세검색이 Explore에 허용된 최종 상세검색임을 나타냅니다. 자세한 내용과 사용 사례는 LookML 상세검색 문서 페이지를 참고하세요.
피해야 할 매개변수
access_filter_fields 6.0에서 삭제됨 access_filter로 대체됨