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

  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에 추가 뷰를 조인합니다. 조인 및 조인 매개변수에 대한 자세한 내용은 조인 매개변수 참조 페이지를 참고하세요.
쿼리 매개변수
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로 대체됨