매개변수 보기

뷰는 데이터베이스의 기본 테이블인지 아니면 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 PDT가 BigQuery의 하나 이상의 필드로 클러스터링되도록 지정합니다.

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에 추가됨 increment_key 파라미터와 함께 사용됩니다. 증분 PDT의 경우. increment_offset은 늦게 도착하는 데이터를 고려하여 다시 빌드되는 이전 기간 수 (증분 키의 세분성 적용)를 지정합니다.
interval_trigger 21.20에 추가됨 interval_trigger는 영구 파생 테이블의 다시 빌드 일정을 "N (seconds | minutes | hours)" 형식으로 지정합니다.
materialized_view 21.10에 추가됨 The statement materialized_view: yes creates a materialized view on your database for a derived table.
indexes 기존 데이터베이스 (예: MySQL, Postgres)에서 빌드된 PDT의 색인 또는 Redshift의 인터리브 정렬 키를 설정합니다.
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로 대체됨