매개변수 보기

뷰는 테이블이 데이터베이스에 기본적으로 포함되어 있는지 아니면 Looker의 파생 테이블 기능을 사용하여 생성되었는지에 관계없이 Looker의 데이터 테이블을 나타냅니다. 뷰는 일반적으로 뷰 파일에 선언되며 파일당 하나의 뷰가 있습니다.

각 뷰에는 필드 정의가 있으며, 각 필드 정의는 일반적으로 기본 테이블의 열 또는 Looker의 계산에 해당합니다. 이러한 필드는 필드 참조, 측정기준 유형 참조, 측정값 유형 참조에 설명되어 있습니다.

이 페이지에 설명된 보기 수준 설정도 있습니다.

사용 예시

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

## STRUCTURAL PARAMETERS

include:"filename_or_pattern"
## Possibly more include declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

매개변수 정의

파라미터 이름 설명
구조적 매개변수
drill_fields (뷰용) 뷰에 정의된 측정값을 드릴할 때 표시되는 기본 필드 목록을 지정합니다.
extends (뷰용) 이 뷰에 의해 확장될 뷰를 지정합니다.
extension (뷰용) 뷰에 확장 프로그램이 필요하며 사용자에게 직접 노출될 수 없음을 지정합니다.
include 뷰에 파일을 추가합니다.
test 모델의 논리를 확인하기 위한 데이터 테스트를 만듭니다. 프로젝트 설정에는 데이터 테스트를 요구하는 옵션이 포함되어 있습니다. 프로젝트에 이 옵션을 사용 설정하면 프로젝트의 개발자가 변경사항을 프로덕션에 배포하기 전에 데이터 테스트를 실행해야 합니다. 이 매개변수에는 explore_source 및 assert 하위 매개변수가 있습니다.
set 다른 매개변수에서 사용할 측정기준 및 측정값 집합을 정의합니다.
view 뷰를 만듭니다.
디스플레이 매개변수
label (뷰용) 필드 선택 도구에 뷰 이름이 표시되는 방식을 지정합니다.
fields_hidden_by_default 21.12에 추가됨 yes로 설정하면 기본적으로 뷰의 모든 필드가 숨겨집니다. 필드에 hidden: no 매개변수를 사용하여 필드를 표시합니다.
필터 매개변수
suggestions (뷰용) 이 보기의 모든 측정기준에 대한 추천을 사용 설정하거나 사용 중지합니다.
쿼리 매개변수
autogenerate_primary_keys (뷰용) 자동 기본 키 생성을 사용 설정 또는 사용 중지합니다.
required_access_grants (뷰용) 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자로만 뷰에 대한 액세스를 제한합니다.
sql_table_name (뷰용) 뷰가 기반하는 SQL 테이블을 변경합니다.
파생 테이블 매개변수
cluster_keys BigQuery에서 하나 이상의 필드로 PDT를 클러스터링하도록 지정합니다.

Snowflake에서 cluster_keys 지원 추가
create_process 맞춤 DDL 명령어가 필요한 데이터베이스 언어에서 PDT를 만드는 단계의 순서를 지정합니다. 이 파라미터에는 하위 파라미터 sql_step이 있습니다.
datagroup_trigger PDT 다시 빌드 정책에 사용할 데이터 그룹을 지정합니다.
derived_table 파생 테이블을 기반으로 뷰를 만듭니다.
distribution Redshift 또는 Aster에서 빌드된 PDT의 배포 키를 설정합니다.
distribution_style Redshift에서 빌드된 PDT의 배포 스타일을 설정합니다.
explore_source Explore를 기반으로 기본 파생 테이블을 정의합니다.
increment_key 추가됨 21.4 파생 테이블을 증분 PDT로 만듭니다. increment_key는 새 데이터를 쿼리하여 PDT에 추가해야 하는 시간 증분값을 지정합니다.
increment_offset 21.4 추가 증분 PDT의 increment_key 매개변수와 함께 사용됩니다. increment_offset은 늦게 도착하는 데이터를 고려하여 다시 빌드되는 이전 기간 수 (증분 키의 세분성 적용)를 지정합니다.
interval_trigger 21.20 추가 interval_trigger은 영구 파생 테이블의 다시 빌드 일정을 "N (seconds | minutes | hours)" 형식으로 지정합니다.
materialized_view 추가됨 21.10 materialized_view: yes 문은 파생 테이블의 데이터베이스에 구체화된 뷰를 만듭니다.
indexes 기존 데이터베이스 (예: MySQL, Postgres) 또는 Redshift의 인터리브 정렬 키에 빌드된 PDT의 색인을 설정합니다.
partition_keys PDT가 Presto의 하나 이상의 필드 또는 BigQuery의 단일 날짜/시간 필드로 파티션을 나눌지 여부를 지정합니다.
persist_for (derived_table의 경우) PDT가 재생성되기 전의 최대 기간을 설정합니다.
publish_as_db_view publish_as_db_view: yes 문은 PDT의 안정적인 데이터베이스 뷰를 만들어 Looker 외부에서 테이블을 쿼리할 수 있도록 합니다.
sortkeys Redshift에서 빌드된 PDT의 정렬 키를 설정합니다.
sql (derived_table의 경우) 파생 테이블의 SQL 쿼리를 선언합니다.
sql_create 맞춤 DDL 명령어가 필요한 데이터베이스 언어에서 PDT를 만드는 SQL CREATE 문을 정의합니다.
sql_trigger_value PDT가 재생성되도록 하는 조건을 지정합니다.
table_compression Amazon Athena의 PDT에 사용할 테이블 압축을 지정합니다.
table_format Amazon Athena에서 PDT에 사용할 테이블 형식을 지정합니다.
세부 조정 매개변수
view: +view_name 기존 뷰에 상세검색을 추가하기 위해 기존 뷰 이름 앞에 더하기 기호 (+)를 추가합니다. 자세한 내용과 사용 사례는 LookML 상세검색 문서 페이지를 참고하세요.
final 현재 세부검색이 뷰에 허용된 최종 세부검색임을 나타냅니다. 자세한 내용과 사용 사례는 LookML 상세검색 문서 페이지를 참고하세요.
피해야 할 매개변수
distkey 3.26 삭제 distribution로 대체됨
view_label 4.4 피하기 label로 대체됨