함수별 LookML 매개변수 참조

개요

LookML은 SQL 데이터베이스의 측정기준, 집계, 계산, 데이터 관계를 설명하고 해당 데이터베이스에 대한 SQL 쿼리를 구성하는 데 사용되는 언어입니다. LookML을 학습하기 위한 권장 단계는 LookML 학습 단계 문서 페이지를 참고하세요.

이 참조 페이지를 통해 LookML 매개변수가 원하는 데이터 모델링 효과를 달성하는 데 어떻게 도움이 되는지 알아볼 수 있습니다. 이 참조는 기존 모델을 보고 각 매개변수의 역할을 파악하려는 경우에도 유용합니다. 관련 LookML 구조(모델, 보기, 탐색, 조인, 매니페스트 또는 필드)의 개별 참조 페이지를 방문할 수도 있습니다.

이러한 LookML 구조에 대한 소개와 이러한 구조 간의 관계는 LookML 용어 및 개념 문서 페이지를 참조하세요. 이 페이지 하단에 추가 리소스 링크가 있어 LookML 요소를 식별하고 이해하고 구현하는 데 도움이 됩니다.

참조 확인 방법

이 페이지에서는 매개변수가 달성할 수 있는 다양한 기능과 이러한 효과로 달성할 수 있는 다양한 효과로 구성됩니다.

각 섹션의 표 항목은 다음과 같습니다.

매개변수 이름 수준 설명
매개변수의 기본 문서 페이지 이름 및 링크 매개변수가 적용되는 수준이며, 모델, 보기, 탐색, 조인, 매니페스트 또는 필드 등 해당 수준에서 사용할 수 있는 다른 모든 매개변수의 목록으로 연결되는 링크가 포함됩니다. 일부 매개변수는 LookML의 여러 수준에서 사용할 수 있습니다. 매개변수 함수 및 하위 매개변수를 포함할 수 있는지에 대한 간략한 설명

일부 필드 수준 매개변수는 여러 필드 유형과 함께 사용할 수 있으므로 이 페이지에서는 각 필드 수준 매개변수에 사용할 수 있는 필드 유형을 나타내는 아이콘으로 표시합니다. 아이콘 위로 마우스를 가져가면 이름을 볼 수 있으며, 아이콘을 클릭하여 해당 유형의 참조 페이지를 볼 수도 있습니다.

D = 측정기준 DG = 측정기준 그룹 F = 필터 M = 측정 P = 매개변수


구조적 매개변수

이러한 LookML 매개변수는 프로젝트 또는 기본 파일의 구조에 영향을 미칩니다.

모델 또는 탐색 파일의 주요 구조 매개변수

LookML 용어 및 개념 문서 페이지에서 볼 수 있듯이 프로젝트에는 매개변수를 사용하여 모델과 탐색 및 조인을 정의하는 하나 이상의 모델 파일이 포함되어 있습니다.

이 섹션에서는 일반적으로 모델 파일에 배치하는 주요 구조 매개변수를 설명합니다. 다른 모든 매개변수에 대한 프레임워크 역할을 합니다. explore 매개변수는 일반적으로 모델 파일의 최상위 수준에서 정의되지만 네이티브 파생 테이블을 사용하면 탐색 파일에서 정의할 수 있습니다.

매개변수 이름 수준 설명
explore 모델 탐색 메뉴에서 뷰를 노출합니다. 탐색 및 해당 매개변수에 대한 자세한 내용은 탐색 매개변수 참조 페이지를 참조하세요. 탐색 이름 및 메뉴에 영향을 미칩니다. 이 매개변수에는 하위 탐색 매개변수가 탐색 매개변수 참조 페이지 및 이 페이지의 다른 위치에 나열되어 있습니다.
fields 살펴보기 탐색에서 사용할 수 있는 필드를 기본 뷰 및 탐색의 조인을 통해 제한합니다. 필드 선택 도구에서 사용할 수 있는 필드에 영향을 미칩니다.
include 모델 모델에 파일을 추가합니다. 이 매개변수는 네이티브 파생 테이블의 뷰 파일에도 사용할 수 있습니다.
join 참여 추가 보기에 탐색에 참여합니다. 아래의 뷰 결합 섹션도 참고하세요.
test 모델 모델의 로직을 확인하는 데이터 테스트를 만듭니다. 프로젝트 설정에는 데이터 테스트 필요 옵션이 있습니다. 프로젝트에 이 기능을 사용 설정하면 프로젝트의 개발자가 변경사항을 프로덕션에 배포하기 전에 데이터 테스트를 실행해야 합니다. 이 매개변수에는 explore_source 및 assert 하위 매개변수가 있습니다.

뷰 파일의 주요 구조 매개변수

LookML 용어 및 개념 문서 페이지에서 볼 수 있듯이 프로젝트에는 매개변수를 사용하여 뷰, 필드 (크기 및 측정값), 필드 세트를 정의하는 뷰 파일이 하나 이상 포함되어 있습니다.

이 섹션에서는 일반적으로 뷰 파일에 배치하는 주요 구조 매개변수를 설명합니다.

매개변수 이름 수준 설명
dimension 보기 (단, 필드 참조 페이지에 나열되어 있음) 측정기준 필드를 만듭니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.
dimension_group 보기(단, 필드 참조 페이지에 나열되어 있음) 여러 시간 기반 측정기준을 동시에 만듭니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.
fields 참여 조인에서 어느 필드를 탐색으로 가져올지 결정합니다.
measure 보기 (단, 필드 참조 페이지에 나열되어 있음) 측정 필드를 만듭니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.
view Model (그러나 보기 파일에서 사용됨) 뷰를 만듭니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다. 이 매개변수에는 매개변수 보기 참조 페이지와 현재 페이지의 다른 하위 섹션에 많은 하위 매개변수가 나열되어 있습니다.

도우미 구조 매개변수

이러한 매개변수를 사용하여 필드 집합을 지정하고 특정 파일 및 콘텐츠를 포함하고 정의를 재사용하는 등 원하는 구조 동작을 정의할 수 있습니다.

매개변수 이름 수준 설명
+ (상세검색) 탐색 및 보기 LookML 상세검색을 사용하여 프로젝트의 뷰 및 탐색의 LookML을 기반으로 빌드합니다.
constant 매니페스트 프로젝트 전체에서 사용할 수 있는 LookML 상수를 정의합니다. 이 매개변수에는 value 및 export 하위 매개변수가 있습니다.
extends 탐색 및 보기 다른 LookML 객체의 정의를 재사용하여 하위 매개변수를 원하는 대로 추가하고 재정의합니다. 이 매개변수는 LookML 대시보드에도 사용할 수 있습니다.
extension 탐색 및 보기 탐색, 뷰 또는 대시보드를 직접 사용할 수 없음을 지정합니다. 대신 이 정의는 이 객체에 기반하여 확장을 사용하는 다른 객체의 템플릿으로 사용됩니다. 이 매개변수는 대시보드에서 사용할 수 있습니다.
include 모델 모델에 파일을 추가합니다. 이 매개변수는 네이티브 파생 테이블의 뷰 파일에도 사용할 수 있습니다.
intervals 필드: DG type: duration로 구성된 측정기준 그룹에 대해 dimension_group에서 원하는 재생 시간 측정기준의 집합을 정의합니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.
local_dependency 매니페스트 포함할 파일이 포함된 프로젝트를 하나 이상 지정합니다.
parameter 보기(단, 필드 참조 페이지에 나열되어 있음) 사용자가 Liquid {% parameter %} 태그에 입력을 제공하는 데 사용할 수 있는 필터 전용 필드를 만듭니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.
project_name 매니페스트 현재 프로젝트의 이름을 지정합니다.
remote_dependency 매니페스트 포함할 파일이 포함된 하나 이상의 원격 저장소를 지정합니다.
set 보기 다른 매개변수에서 사용할 측정기준과 측정항목의 집합을 정의합니다. 이 매개변수는 조인에 사용 가능한 필드를 제한하여 필드 선택 도구로 제한하는 데 사용할 수 있습니다. 이 매개변수는 사용자가 데이터를 드릴다운할 때 표시해야 하는 필드를 정의하는 데도 사용할 수 있습니다. 이 매개변수에는 fields 하위 매개변수가 있습니다.
timeframes 필드: DG type: time로 구성된 측정기준 그룹에 대해 dimension_group에서 원하는 기간 측정기준 집합을 정의합니다. 필드 선택 도구의 기본 동작에 영향을 미칩니다.

확장 프로그램 프레임워크 애플리케이션

Looker 개발자는 프로젝트의 매니페스트 파일에서 application 매개변수를 사용하여 Looker의 확장 프로그램 프레임워크에 애플리케이션을 추가할 수 있습니다. 프로젝트에 확장 프로그램을 추가하면 적절한 권한을 가진 Looker 사용자가 Looker 찾아보기 메뉴에 표시된 확장 프로그램을 볼 수 있습니다.

관리자가 향상된 탐색 실험실 기능을 사용 설정한 경우 새로운 향상된 왼쪽 탐색 패널의 애플리케이션 섹션에 확장 프로그램이 표시됩니다.

매개변수 이름 수준 설명
application 매니페스트 Looker의 확장 프레임워크를 사용하여 프로젝트에 애플리케이션을 추가합니다. 이 매개변수에는 application 매개변수 문서 페이지에 설명된 하위 매개변수가 있습니다.

탐색 이름과 메뉴

탐색의 이름과 탐색 메뉴에 표시되는 모양을 통해 사용자는 필요에 따라 적절한 탐색을 선택할 수 있습니다. 이러한 LookML 매개변수는 탐색 이름 및 탐색 메뉴에 표시되는 기본 설정에 영향을 미칩니다.

자세한 내용은 탐색 메뉴 및 필드 선택 도구 변경하기 문서 페이지의 탐색 이름 및 메뉴 섹션을 참고하세요.

기본 동작

탐색 이름의 기본 동작과 탐색 메뉴에 표시되는 모양은 아래 나열된 매개변수로 지정됩니다.

매개변수 이름 수준 설명
explore 모델 탐색 메뉴에서 뷰를 노출합니다. 탐색 및 해당 매개변수에 대한 자세한 내용은 탐색 매개변수 참조 페이지를 참조하세요. 탐색 이름 및 메뉴에 영향을 미칩니다.

탐색 이름 및 메뉴 수정하기

탐색 이름 및 탐색 메뉴에 표시되는 방식은 아래 표의 매개변수를 통해 수정할 수 있습니다.

매개변수 이름 수준 설명
description 살펴보기 탐색 페이지와 탐색 메뉴에 표시되는 탐색에 대한 설명을 추가합니다.
group_label 살펴보기 탐색 메뉴에서 제목으로 사용할 라벨을 만듭니다.
hidden 살펴보기 탐색 메뉴에서 탐색 메뉴를 숨깁니다.
label 살펴보기 탐색 메뉴에 탐색이 표시되는 방식을 변경합니다.
label 모델 모델이 탐색 메뉴에 표시되는 방식을 변경합니다.

필드 선택 도구

필드 선택 도구에 있는 뷰와 필드의 구성과 표시 이름은 사용자가 시각화를 이해하고 탐색에서 필요한 필드를 찾는 데 도움이 됩니다. 이러한 LookML 매개변수는 필드 선택 도구의 콘텐츠, 모양, 구성의 기본 동작에 영향을 미칩니다.

자세한 내용은 탐색 메뉴 및 필드 선택 도구 변경 문서 페이지의 필드 선택 도구 섹션을 참고하세요.

기본 동작

기본 필드 선택 도구의 모양과 동작은 아래 나열된 매개변수에 의해 지정됩니다. 이 기본 동작에 대한 자세한 설명은 탐색 메뉴 및 필드 선택 도구 변경 문서 페이지의 필드 선택 도구 표시 섹션을 참고하세요.

매개변수 이름 수준 설명
dimension 보기(단, 필드 참조 페이지에 나열되어 있음) 측정기준 필드를 만듭니다.
dimension_group 보기 (단, 필드 참조 페이지에 나열되어 있음) 여러 시간 기반 측정기준을 동시에 만듭니다.
filter 보기 (단, 필드 참조 페이지에 나열되어 있음) 템플릿 필터 또는 조건부 조인에서 사용할 필터 전용 필드를 만듭니다.
measure 보기 (단, 필드 참조 페이지에 나열되어 있음) 측정 필드 만들기
parameter 보기 (단, 필드 참조 페이지에 나열되어 있음) 사용자가 Liquid {% parameter %} 태그에 입력을 제공하는 데 사용할 수 있는 필터 전용 필드를 만듭니다.
timeframes 필드: DG type: time로 구성된 측정기준 그룹에 대해 dimension_group에서 원하는 기간 측정기준 집합을 정의합니다.
intervals 필드: DG type: duration로 구성된 측정기준 그룹에 대해 dimension_group에서 원하는 재생 시간 측정기준의 집합을 정의합니다.
view 모델(단, 참조 페이지에서 확인) 뷰 만들기

필드 선택 도구에서 뷰 이름 수정

보기의 표시 이름은 사용자가 탐색에서 필요한 필드를 이해하고 찾는 데 도움이 될 수 있습니다. 시각화에 뷰 이름이 표시되는 경우 이름이 표시되는 방식을 수정하면 사용자가 시각화를 이해하는 데 도움이 됩니다. 이 섹션에서는 필드 선택 도구의 뷰 이름에 영향을 미치는 LookML 매개변수를 설명합니다. 이 주제에 대한 자세한 설명은 탐색 메뉴 및 필드 선택 도구 변경 문서 페이지의 필드 선택 도구 섹션을 참고하세요.

매개변수 이름 수준 설명
label 보기 필드 선택 도구에 뷰 이름이 표시되는 방식을 지정합니다.
view_label 살펴보기 탐색의 기본 보기에서 필드 그룹에 필드 선택 도구에서 라벨을 지정하는 방법을 지정합니다.
view_label 참여 필드 선택 도구에서 조인의 뷰 이름이 표시되는 방식을 변경합니다.

필드 선택 도구에서 필드 등록정보 수정

필드가 나열되는 방식을 수정하면 사용자가 시각화를 이해하고 탐색에서 필요한 필드를 찾는 데 도움이 됩니다. 필드 선택 도구에 필드가 표시되는 방식은 아래 표의 매개변수로 수정할 수 있습니다. 이 주제에 대한 자세한 설명은 탐색 메뉴 및 필드 선택 도구 변경 문서 페이지의 필드 선택 도구 섹션을 참고하세요.

매개변수 이름 수준 설명
description 필드: D DG M F P 마우스를 가져가면 볼 수 있는 필드에 설명을 추가합니다.
fields 살펴보기 탐색에서 사용할 수 있는 필드를 기본 뷰 및 탐색의 조인을 통해 제한합니다. 필드 선택 도구에서 사용할 수 있는 필드에 영향을 미칩니다.
fields 참여 조인에서 어느 필드를 탐색으로 가져올지 결정합니다.
hidden 필드: D DG M F P 탐색 UI에서 필드 숨기기
label 필드: D DG M F P 필드 선택 도구에 필드 이름이 표시되는 방식을 변경합니다.
label_from_parameter 필드: D M parameter의 입력에 따라 시각화에 필드 이름이 표시되는 방식을 변경합니다.

필드 선택 도구에서 필드 구성 수정

필드 구성을 사용하면 사용자가 탐색에서 필요한 필드를 찾는 데 도움이 됩니다. 필드 선택 도구의 필드 구성은 아래 표의 매개변수를 통해 수정할 수 있습니다. 이 주제에 대한 자세한 설명은 탐색 메뉴 및 필드 선택 도구 변경 문서 페이지의 필드 선택 도구 섹션을 참고하세요.

매개변수 이름 수준 설명
group_label 필드: D DG M F 필드 선택 도구의 뷰 내에서 필드를 그룹화
view_label 필드: D DG M F P 필드 선택 도구의 뷰 내에 표시되는 필드를 변경합니다.

현지화

모델을 현지화하는 경우 위치 설정 매개변수를 사용하면 사용자의 언어 설정에 따라 Looker UI의 라벨 및 설명 표시를 맞춤설정할 수 있습니다. 현지화를 위한 모델 설정에 대한 자세한 내용은 모델 현지화 문서 페이지를 참고하세요.

매개변수 이름 수준 설명
localization_settings 매니페스트 모델의 현지화 정보를 지정합니다. 이 매개변수에는 default_locale 및 localization_level 하위 매개변수가 있습니다.
localization_level 매니페스트 모델에 번역이 없는 문자열이 허용되는지 여부를 지정합니다.
default_locale 매니페스트 문자열을 번역하기 위한 모델의 기본값으로 사용할 언어를 지정합니다.

데이터 값 및 데이터 표시

탐색의 데이터 섹션에서 데이터의 값과 표현을 수정하면 사용자가 결과를 이해하는 데 도움이 될 수 있습니다. 측정기준 또는 측정값의 데이터 유형을 수정 또는 제한하거나, 사용자에게 표시되는 데이터 형식을 변경하거나, 누락된 값을 채우거나, 기타 시각화 옵션을 변경할 수 있습니다.

또한 사용자는 데이터 섹션에 표시되는 자체 표 계산을 정의할 수도 있습니다. 하지만 가능한 경우 올바른 계산을 한 후 다양한 쿼리에서 일관되게 사용하도록 LookML에서 측정기준과 측정값을 정의해야 합니다.

여러 필드 유형의 데이터 값

이 매개변수를 사용하면 여러 필드 유형의 데이터 값을 변경할 수 있습니다.

매개변수 이름 수준 설명
case 필드: D M 측정기준이 SQL 조건에 따라 결정할 수 있는 개별 값 집합을 만듭니다. 이 매개변수에는 when 및 else 하위 매개변수가 있습니다.
sql 필드: D DG M F 필드 계산 방법을 결정합니다.
type(측정기준, 필터 또는 매개변수) 필드: D F P 측정기준, 필터 또는 매개변수의 유형 지정
type (측정기준 그룹용) 필드: DG 측정기준 그룹의 유형을 지정합니다.
type(측정 목적) 분야: M 측정 유형 지정

특정 측정기준 유형의 데이터 값

유형별 매개변수를 사용하여 일부 측정기준 유형의 데이터 값을 수정할 수 있습니다.

type: date 또는 type: datetime의 크기

매개변수 이름 수준 설명
convert_tz 필드: D DG F M P 필드의 자동 시간대 변환을 사용 중지합니다.
datatype 필드: D DG F M 필드에 제공할 시간 데이터 유형을 지정합니다.
fiscal_month_offset 모델 회계 연도가 시작되는 월을 지정합니다 (역년과 다른 경우).
week_start_day 모델 주 관련 측정기준을 시작할 요일을 지정합니다.

type: distance의 크기

매개변수 이름 수준 설명
end_location_field 필드: D type: distance 필드의 종료 위치가 포함된 필드를 정의합니다. 이 매개변수는 구조적 매개변수로도 간주됩니다.
start_location_field 필드: D type: distance 필드의 시작 위치가 포함된 필드를 정의합니다.
units 필드: D type: distance 필드에 사용할 단위를 지정합니다.

type: location의 크기

매개변수 이름 수준 설명
sql_latitude 필드: D type: location 차원의 위도를 정의합니다.
sql_longitude 필드: D type: location 측정기준의 경도를 정의합니다.

type: string의 크기

매개변수 이름 수준 설명
string_datatype 필드: D SQL Server 또는 MySQL의 경우 type: string 측정기준에 대한 유니코드 데이터 유형을 지정합니다.

type: tier의 크기

매개변수 이름 수준 설명
tiers 필드: D type: tier 측정기준의 계층을 정의합니다.

type: duration 측정기준 그룹 또는 type: duration_x 측정기준

매개변수 이름 수준 설명
sql_start 필드: D DG 측정기준 그룹 type: duration 또는 측정기준 type: duration_x의 시작 시간을 정의합니다.
sql_end 필드: D DG 측정기준 그룹 type: duration 또는 측정기준 type: duration_x의 종료 시간을 정의합니다.

측정값의 데이터 값

이러한 매개변수는 대부분 표에 명시된 대로 특정 측정 유형으로 제한됩니다. 측정기준 값을 기준으로 필터링된 개수를 만들려면 측정기준별로 개수 필터링하기를 참조하세요. 두 필드 간의 비율을 계산하는 측정치를 만들려면 백분율을 참고하세요.

매개변수 이름 수준 설명
approximate 분야: M type: count_distinct의 측정값을 대략적으로 계산합니다. 이 매개변수를 지원하는 언어 목록은 approximate 문서 페이지를 참고하세요.
approximate_threshold 분야: M BigQuery가 정확한 개수에서 고유한 개수로 고유한 개수로 전환하는 횟수를 설정합니다.
direction 분야: M 피벗이 사용될 때 type: percent_of_total 또는 type: running_total의 측정값을 계산하는 방향을 결정합니다.
list_field 분야: M type: list의 측정값을 계산할 측정기준을 선언합니다. 이 매개변수는 구조적 매개변수로도 간주됩니다.
percentile 분야: M type: percentile 또는 type: percentile_distinct 측정값의 분수 값 (N번째 백분위수)을 지정합니다.
primary_key 필드: D 측정기준을 뷰의 기본 키로 선언합니다.
sql_distinct_key 분야: M type: sum_distinct 또는 type: average_distinct와 같은 고유한 측정값을 계산할 고유 항목을 정의합니다.
symmetric_aggregates 살펴보기 탐색에서 대칭 집계를 사용 설정할지 여부를 지정합니다. 이 매개변수는 조인의 작동 방식에 영향을 주는 매개변수에 대해서도 표시됩니다. 아래의 뷰 결합 섹션도 참고하세요.

데이터 형식

다음 표의 매개변수를 사용하여 데이터 형식을 지정하면 사용자가 데이터 값을 더 쉽게 읽을 수 있습니다.

매개변수 이름 수준 설명
html 필드: D DG M Liquid 템플릿을 사용하여 필드의 HTML 출력을 수정합니다.
named_value_format 모델 value_format_name와 함께 사용할 맞춤 값 형식을 만듭니다. 이 매개변수에는 value_format 및 strict_value_format 하위 매개변수가 있습니다.
style 필드: D type: tier 측정기준의 등급이 Looker UI에 표시되는 방식을 변경합니다.
value_format 필드: D M Excel 스타일 옵션을 사용하여 필드의 출력 형식 지정
value_format_name 필드: D M 기본 제공 또는 맞춤 형식을 사용하여 필드의 출력 형식 지정

데이터 순서 및 채우기

대부분의 필드에서 정렬 순서는 간단하며 값의 영숫자 정렬만 가능합니다. New LookML case 또는 Old LookML sql_case 문의 결과를 특정 순서로 정렬해야 하는 경우도 있습니다. 또는 값이 다른 필드의 값에 따라 정렬되도록 할 수 있습니다. allow_fill 매개변수를 사용하여 사용자가 Looker에 필드의 누락된 날짜 및 값을 입력하도록 요청하는 기능을 사용 설정하거나 중지할 수도 있습니다.

매개변수 이름 수준 설명
allow_fill 필드: D DG 측정기준에 측정기준 채우기가 허용되는지 결정합니다.
alpha_sort 필드: D case 매개변수가 조건을 알파벳순으로 정렬하도록 합니다.
order_by_field 필드: D DG

다른 필드의 값을 기준으로 필드를 정렬합니다.

측정기준 그룹에 지원됨

위치 데이터 시각화

Looker는 시각화 섹션에서 위치 데이터 값을 시각화하는 데 사용할 수 있는 다양한 지도를 제공합니다. 시각화를 위한 맞춤 지도를 만들어 사용할 수도 있습니다.

매개변수 이름 수준 설명
map_layer 모델 map_layer_name와 함께 사용할 맞춤 지도를 만듭니다. 이 매개변수에는 map_layer 페이지에 여러 하위 매개변수가 나열되어 있습니다.
map_layer_name 필드: D 데이터 지도에서 기본 제공 또는 맞춤 지도에 정의한 지역에 대한 매핑을 지정합니다.

데이터 값에 대한 클릭 가능한 작업

드릴

Looker에서 모든 쿼리 결과는 다른 쿼리의 시작점이 될 수 있습니다. 사용자는 데이터 값을 클릭하여 데이터를 자세히 살펴볼 수 있습니다. LookML을 사용하여 사용자가 데이터를 드릴다운할 때 표시할 필드를 지정할 수도 있습니다. 측정기준과 측정항목의 드릴다운 기본 동작이 다릅니다.

맞춤 드릴 경로를 만들기 위한 고급 옵션은 고객센터의 강력한 데이터 드릴링 도움말을 참조하세요.

매개변수 이름 수준 설명
drill_fields 필드: D DG M 측정값 또는 측정기준을 드릴다운할 때 표시할 필드 목록을 선언합니다.
set 보기 다른 매개변수에서 사용할 측정기준과 측정항목의 집합을 정의합니다. 이 매개변수는 조인에 사용할 수 있는 필드, 즉 필드 선택 도구를 제한하는 데 사용됩니다. 이 매개변수는 사용자가 데이터를 드릴다운할 때 표시할 필드를 정의하는 데 사용할 수도 있습니다. 추가 LookML 기본사항 문서 페이지의 상세보기에 세트 사용도 참고하세요.

데이터 작업

사용자가 데이터를 본 후 다른 이벤트를 트리거하고 싶어 하는 경우가 있습니다. Looker 작업 허브를 사용하는 경우 특정 tags의 필드가 특정 통합 서비스를 사용하도록 지정할 수 있습니다. 데이터 작업을 사용하여 필드에 대해 사용자가 사용할 수 있는 옵션을 지정할 수도 있습니다.

매개변수 이름 수준 설명
action 필드: D M 사용자가 Looker에서 바로 다른 도구에서 작업을 수행할 수 있는 필드에 데이터 작업을 만듭니다. 이 매개변수에는 action 페이지에 여러 하위 매개변수가 나열되어 있습니다.
tags 필드: D DG M F P 다른 애플리케이션에 전달할 수 있는 텍스트를 추가하여 필드에 관한 데이터를 제공합니다.

연결 중

사용자가 데이터 값을 클릭하여 관련 URL로 이동하도록 할 수 있습니다. 이러한 매개변수를 사용하면 사용자가 데이터를 살펴볼 때 표시되는 입력란을 비롯하여 표시할 텍스트, 도착 URL 및 도착 웹사이트의 파비콘을 지정할 수 있습니다.

매개변수 이름 수준 설명
link 필드: D M 다른 Looker 및 외부 콘텐츠로 연결되는 링크를 만듭니다. 이 매개변수에는 label, url, icon_url 하위 매개변수가 있습니다. link를 사용하는 고급 옵션은 고객센터의 더 강력한 데이터 드릴링 도움말도 참고하세요.

필터링

사용자는 탐색, 보기, 대시보드의 쿼리에 필터를 적용할 수 있습니다.

유용한 필터를 추가하거나 데이터베이스 리소스에 과도한 부담을 주는 쿼리를 실수로 만들지 않도록 하여 LookML에서 직접 필터 동작을 지정하여 사용자 환경을 선별하는 데 도움을 줄 수 있습니다. 사용자가 입력하는 동안 Looker가 생성할 수 있는 대소문자 구분, 기본값, 필터 추천과 같은 필터 동작을 지정할 수 있습니다.

LookML의 필터링에 대한 일반적인 내용은 추가 LookML 기본사항 문서 페이지의 결과 세트 필터링을 참고하세요. 템플릿 필터를 사용한 고급 옵션은 고객센터의 템플릿 필터 및 유동 매개변수 및 고급 템플릿 필터를 참고하세요.

필터 표현식과 구문의 전체 목록은 Looker 필터 표현식 문서 페이지에서 확인할 수 있습니다.

고정 값이 있는 필터 필요

이 매개변수를 사용하면 항상 적용할 필터를 지정할 수 있습니다.

추가 LookML 기본사항 문서 페이지에서 측정기준별 개수 필터링도 참고하세요.

매개변수 이름 수준 설명
access_filter 살펴보기 탐색에 사용자별 필터를 추가합니다. 이 매개변수에는 field 및 user_attribute 하위 매개변수가 있습니다.
sql_always_having 살펴보기 사용자가 이 탐색 분석에서 변경하거나 삭제할 수 없는 조건을 쿼리의 HAVING 절에 삽입합니다.
sql_always_where 살펴보기 사용자가 이 탐색 분석에서 변경하거나 삭제할 수 없는 조건을 쿼리의 WHERE 절에 삽입합니다.
sql_where 참여 이 조인이 쿼리에 포함된 경우 사용자가 이 탐색에서 변경하거나 삭제할 수 없는 조건을 쿼리의 WHERE 절에 삽입합니다. BigQuery 전용입니다. 이 매개변수는 필터 매개변수로도 간주될 수 있습니다.

값을 변경할 수 있는 필터 필요

이러한 매개변수를 사용하면 사용해야 하는 필터를 지정할 수 있지만 사용자가 필터 값을 변경할 수 있습니다.

매개변수 이름 수준 설명
always_filter 살펴보기 사용자가 변경할 수 있지만 삭제할 수는 없는 필터를 탐색에 추가합니다. 이 매개변수에는 filters 하위 매개변수가 있습니다.
filter 필드: F 템플릿 필터에서 사용할 필터 전용 필드를 만듭니다.
filters 분야: M 측정기준 제한을 기준으로 측정값 계산 제한

필터 방지

이 매개변수를 사용하면 어떤 상황에서든 또는 드릴다운할 때만 사용자가 필드를 필터로 사용하지 못하도록 할 수 있습니다.

매개변수 이름 수준 설명
can_filter 필드: D DG M 측정기준 또는 측정값을 필터로 사용할 수 있는지 여부를 결정합니다.
skip_drill_filter 필드: D 측정값을 드릴다운하면 측정기준이 필터에 추가되지 않습니다.

조건부 필터

경우에 따라 사용자가 여러 필터 중 하나를 사용하여 쿼리 범위를 좁히도록 지정해야 할 수 있습니다. 예를 들어 사용자는 날짜 또는 지역으로 쿼리를 제한해야 합니다.

아래의 매개변수 외에 추가 LookML 기본사항 문서 페이지의 결과 세트 필터링도 참고하세요.

매개변수 이름 수준 설명
conditionally_filter 살펴보기 사용자가 특정 목록에서 자신의 필터를 추가하지 않으면 탐색에 필터를 추가합니다. 이 매개변수에는 filters 및 unless 하위 매개변수가 있습니다.

값 필터링 동작

사용자가 더 쉽게 필터링할 수 있도록 필터의 기본값을 제공하거나 필터 값을 대소문자를 구분하지 않는 것으로 처리할 수 있습니다.

매개변수 이름 수준 설명
case_sensitive 살펴보기 탐색에서 필터가 대소문자를 구분하는지 여부를 지정합니다.
case_sensitive 필드: D F 측정기준과 관련하여 측정기준의 대소문자를 구분하는지 여부를 지정합니다.
case_sensitive 모델 모델에서 필터의 대소문자 구분 여부를 지정합니다.
default_value 필드: F P 필터 필드의 기본값을 지정합니다.

추천 필터

필터 추천을 사용하면 사용자가 데이터를 효과적으로 필터링할 수 있습니다. 경우에 따라 제안을 사용 중지하거나 추천 동작을 변경하는 것이 유용할 수 있습니다.

이러한 LookML 매개변수는 필터 추천의 기본 동작에 영향을 미칩니다.

기본 동작

기본적으로 특정 필터 필드에 대한 Looker의 제안은 해당 필드의 데이터에 있는 모든 고유한 값을 기반으로 합니다.

추천 사용 또는 사용 중지

필드에 고유한 값이 매우 많다고 판단되면 해당 필드에 대해 필터 추천을 사용 중지하는 것이 좋습니다. 이렇게 하면 사용자가 너무 많은 추천을 넘기지 않아도 되고 데이터베이스가 이러한 추천을 제공하지 않아도 됩니다. 여러 수준에서 필터 추천을 사용 또는 사용 중지할 수 있습니다.

매개변수 이름 수준 설명
suggestable 필드: D DG M F P 필드 추천을 사용 설정 또는 사용 중지합니다.
suggestions 보기 이 보기에서 모든 측정기준에 대한 추천을 사용 또는 사용 중지합니다.

추천 값

기본적으로 Looker는 필드의 고유한 값을 기반으로 필터 추천을 생성합니다. 경우에 따라 추천 가능성이 가장 높은 값과 같이 Looker에서 제안해야 하는 값을 지정한 경우 추천이 더 유용할 수 있습니다. 또한 데이터의 일부 값에 대한 액세스를 제한하고 있다면 해당 한도를 제안사항에 적용하거나 적용하지 않을 수 있습니다.

매개변수 이름 수준 설명
allowed_value 필드: P parameter의 선택을 지정합니다. 이 매개변수에는 label 및 value 하위 매개변수가 있습니다.
bypass_suggest_restrictions 필드: D DG F P sql_always_where를 사용 중일 때 사용자에게 추천을 표시하지만 제안사항에 이러한 제한을 적용하지 않습니다.
full_suggestions 필드: D DG F P sql_always_where를 사용 중일 때 사용자에게 제안사항을 표시하고 이러한 한도를 추천에 적용합니다.
suggest_dimension 필드: D DG M F P 추천 필드가 다른 측정기준의 값을 기반으로 합니다.
suggest_explore 필드: D DG M F P 필드에 대한 추천은 다른 탐색의 값을 기반으로 합니다.
suggestions 필드: D F P 필드 제안에 사용될 값 목록을 선언합니다.

캐싱 제안

기본적으로 Looker는 필드의 고유한 값을 기반으로 필터 추천을 생성합니다. 이러한 값은 성능 향상을 위해 캐시되지만, 캐시된 값이 사용되는 기간은 변경할 수 있습니다. 데이터가 상당히 안정적이면 시간을 늘려서 추천 값을 가져오는 성능을 개선해 보세요.

매개변수 이름 수준 설명
suggest_persist_for 필드: D F P Looker 필터 추천의 캐시 설정 변경

뷰 조인

LookML에서 조인 사용하기에 설명된 것처럼, 조인을 사용하면 둘 이상의 뷰에서 동시에 데이터를 탐색할 수 있습니다. 다양한 보기를 결합하여 사용자가 데이터의 각 부분이 서로 어떻게 관련되는지 볼 수 있습니다.

조인은 탐색과 뷰 간의 관계를 설정하는 모델 파일에 정의됩니다. 참여는 단일 탐색에서 하나 이상의 보기를 직접 또는 결합된 다른 보기를 통해 연결합니다.

이러한 LookML 매개변수를 사용하면 조인을 만들고 작동 방식을 지정할 수 있습니다.

가입 조건

일반적인 상황과 구체적인 상황에서 조인할 보기를 지정하는 다양한 매개변수가 있습니다. 또한 조인에 가져올 필드를 지정할 수도 있습니다.

매개변수 이름 수준 설명
always_join 살펴보기 탐색에 항상 적용되어야 하는 조인을 지정합니다.
fields 참여 조인에서 어느 필드를 탐색으로 가져올지 결정합니다.
from 참여 조인의 기반이 되는 뷰를 지정합니다.
include 모델 모델에 파일을 추가합니다. 모델에서 제공되는 파일의 뷰만 조인에 사용할 수 있습니다.
join 살펴보기 추가 보기에 탐색에 참여합니다. 조인 및 조인의 매개변수에 대한 자세한 내용은 조인 매개변수 참조 페이지를 확인하세요. 이 매개변수에는 현재 페이지의 다른 여러 하위 매개변수가 나열되어 있습니다.
required_joins 참여 특정 조인의 필드가 선택될 때 탐색에 적용될 조인을 지정합니다.
sql_table_name 참여 조인의 기반이 되는 데이터베이스 테이블을 지정합니다.

참여 방법

뷰 간 조인의 작동 방식과 조인 조건을 지정할 수 있습니다. 또한 Looker가 대칭 집계를 사용하여 집계 함수에 대한 올바른 결과를 제공할 수 있도록 기본 키를 지정해야 합니다.

대칭 집계에 대한 자세한 내용은 대칭 집계에 대한 간단한 설명 또는 '어떤 이유에서 내 SQL이 이렇게 생겼나요?' 및 SQL 팬아웃의 문제 고객센터 도움말을 참고하세요.

매개변수 이름 수준 설명
foreign_key 참여 조인된 뷰의 기본 키를 사용하여 탐색과 조인 사이의 관계를 지정합니다.
outer_only 참여 모든 쿼리가 외부 조인을 사용해야 하는지 여부를 지정합니다.
primary_key 필드: D 측정기준을 뷰의 기본 키로 선언합니다.
relationship 참여 조인이 일대일, 다대일, 일대다 또는 다대다 관계임을 선언합니다.
sql_on 참여 SQL ON 절을 작성하여 Explore와 조인의 관계를 지정합니다.
symmetric_aggregates 살펴보기 탐색에서 대칭 집계를 사용 설정할지 여부를 지정합니다. 이 매개변수는 측정값에 영향을 주는 매개변수와 함께 표시됩니다.
type 참여 조인을 왼쪽, 전체, 내부 또는 교차 유형으로 선언합니다.

캐싱

Looker는 사용 가능한 경우 캐싱 정책에 따라 이전 쿼리의 캐시된 결과를 사용하여 데이터베이스 로드를 줄이고 성능을 개선합니다. 또한 복잡한 쿼리를 영구적인 파생 테이블 (PDT)로 만들어 결과를 저장하여 이후 쿼리를 간소화할 수 있습니다. 캐싱을 계획할 때는 성능과 사용자의 데이터 '최신성'을 모두 고려해야 합니다.

쿼리 쿼리

데이터 그룹을 사용하여 데이터 파이프라인의 ETL (추출, 변환, 로드) 단계와 Looker를 더 긴밀하게 통합할 수 있습니다. 예를 들어 야간 ETL 작업을 통해 데이터를 일괄 로드하는 경우 Looker에서 ETL이 완료되었음을 확인하고 관련 캐시된 쿼리를 삭제할 수 있습니다.

자세한 내용은 데이터 그룹을 사용하여 쿼리 캐싱 및 PDT 재빌드 문서 페이지를 참조하세요.

매개변수 이름 수준 설명
datagroup 모델 모델의 데이터 그룹 캐싱 정책을 만듭니다. 이 매개변수에는 max_cache_age, sql_trigger, label, description 하위 매개변수가 있습니다.
persist_for 살펴보기 탐색의 캐시 설정을 변경합니다. 대신 데이터 그룹 매개변수의 더 큰 기능을 사용해 보세요.
persist_for 모델 모델의 캐시 설정을 변경합니다. 대신 데이터 그룹 매개변수의 더 큰 기능을 사용해 보세요.
persist_with 살펴보기 탐색의 캐싱 정책에 사용할 데이터 그룹을 지정합니다.
persist_with 모델 모델의 캐싱 정책에 사용할 데이터 그룹을 지정합니다.

캐시 필터 추천

기본적으로 Looker는 필드의 고유한 값을 기반으로 필터 추천을 생성합니다. 이러한 값은 성능 향상을 위해 캐시되지만, 캐시된 값이 사용되는 기간은 변경할 수 있습니다. 데이터가 상당히 안정적이면 캐시 값을 더 길게 사용하여 제안 값을 가져오는 성능을 개선하는 것이 좋습니다.

매개변수 이름 수준 설명
suggest_persist_for 필드: D F P Looker 필터 추천의 캐시 설정 변경

영구 파생 테이블 캐싱

영구 파생 테이블의 캐싱에 영향을 미치는 매개변수는 아래의 영구 파생 테이블용 재생성 및 캐싱 매개변수를 참조하세요.

파생 테이블

Looker의 파생 테이블 튜토리얼에서 설명한 것처럼 파생 테이블은 Looker에서 중요한 도구입니다. 이 기능을 사용하면 데이터베이스에 존재하지 않는 새 테이블을 만들고, 정교한 분석 기능을 확장하고, 쿼리 성능을 높일 수 있습니다.

자세한 내용은 LookML 용어 및 개념 문서 페이지에서 파생된 테이블 및 사실 테이블과 영구 파생 테이블을 참고하세요.

파생된 모든 테이블의 구조적 매개변수

파생 테이블은 SQL 또는 LookML을 사용하여 정의할 수 있습니다. 파생된 모든 테이블은 다음 매개변수로 시작합니다.

매개변수 이름 수준 설명
derived_table 보기 파생된 테이블의 뷰를 기반으로 합니다. 이 매개변수에는 현재 페이지의 다른 위치에 표시된 많은 하위 매개변수가 있으며 매개변수 보기 문서 페이지의 예시 사용 표에 표시되어 있습니다.

네이티브 파생 테이블의 구조적 매개변수

네이티브 파생 테이블은 데이터를 모델링할 때 훨씬 쉽게 읽고 이해할 수 있습니다.

아래 표의 매개변수는 네이티브 파생 테이블의 소스 데이터를 정의하는 데 사용됩니다. 자세한 내용은 explore_source 매개변수 문서 페이지의 사용 예에 자세히 설명되어 있습니다.

매개변수 이름 수준 설명
bind_all_filters 보기 explore_source 밑에서 탐색 쿼리의 모든 필터를 네이티브 파생 테이블 서브 쿼리로 전달합니다. 예는 explore_source 매개변수 문서 페이지를 참고하세요.
참고: explore_source 매개변수에는 bind_all_filters 하위 매개변수 또는 bind_filters 하위 매개변수를 포함할 수 있지만 둘 다 포함할 수는 없습니다.
bind_filters 보기 explore_source에서 탐색 쿼리의 필터를 네이티브 파생 테이블 서브 쿼리로 전달합니다. 이렇게 설정하려면 from_field 하위 매개변수를 사용하여 네이티브 파생 테이블 뷰에 정의되었거나 네이티브 파생 테이블이 조인된 탐색에서 액세스할 수 있는 필드를 지정하세요. 런타임 시 from_field에 있는 모든 필터는 네이티브 파생 테이블 서브 쿼리의 to_field에 전달됩니다. 예는 explore_source 매개변수 문서 페이지를 참고하세요.
참고: explore_source 매개변수에는 bind_all_filters 하위 매개변수 또는 bind_filters 하위 매개변수를 포함할 수 있지만 둘 다 포함할 수는 없습니다.
column 보기 explore_source 아래에 사용하여 테이블에 포함할 열을 지정합니다. 이 매개변수에는 field 하위 매개변수가 있습니다.
derived_column 보기 내부 열의 네임스페이스에 표현식이 있는 explore_source의 열을 지정합니다. 이 단계에서는 SQL 그룹화가 없으므로 여기에서 집계 SQL 표현식이 작동하지 않습니다. 이는 특히 윈도우 함수를 정의할 때 유용합니다. 이 매개변수에는 sql 하위 매개변수가 있습니다.
explore_source 보기 연결된 탐색을 기반으로 파생 테이블의 SQL을 생성합니다. explore_source에는 이 표의 다른 행과 기본 문서 페이지에 설명된 다양한 하위 매개변수가 있습니다.
expression_custom_filter 보기 explore_source 쿼리에 맞춤 필터 표현식을 지정합니다. 선택사항.
filters 보기 explore_source 쿼리에 맞춤 필터 표현식을 지정합니다. 선택사항.
include 모델 explore_source 문서 페이지에 설명된 대로 표에서 참조할 필드가 포함된 파일이 포함됩니다. 모델 및 뷰에 파일 추가와 같은 다른 용도는 include 매개변수의 기본 문서 페이지를 참조하고, include를 사용하여 조인을 만드는 방법은 위의 뷰 조인을 참고하세요.
limit 보기 쿼리의 행 한도를 지정합니다. 선택사항.
sorts 보기 선택사항. 이 explore_source의 정렬을 지정합니다. 대괄호로 묶고, 정렬할 필드 이름, :를 차례로 포함하고, 키워드를 asc 또는 desc 키워드를 사용하여 오름차순 또는 내림차순으로 정렬해야 하는지 표시합니다.
timezone 보기 explore_source 쿼리의 시간대를 설정합니다. 임시 (비영구) 파생 테이블의 경우 이 매개변수를 query_timezone로 설정하여 현재 실행 중인 쿼리의 시간대를 자동으로 사용합니다. 시간대를 지정하지 않으면 기본적으로 explore_source 쿼리가 시간대 변환을 수행하지 않고 데이터베이스 시간대로 작동합니다.

SQL 파생 테이블의 구조적 매개변수

SQL 파생 테이블의 경우 아래 나열된 매개변수를 사용합니다.

매개변수 이름 수준 설명
sql(derived_table의 경우) 보기 파생 테이블의 SQL 쿼리 선언

커스텀 데이터 정의를 위한 구조적 매개변수

커스텀 데이터 정의 언어 (DDL)가 필요한 데이터베이스 언어의 경우 아래 나열된 매개변수를 사용하세요. 예를 들어 데이터베이스 언어에서 단일 SQL 문으로 발급된 CREATE TABLE as SELECT를 지원하지 않는 경우 create_process 매개변수를 사용하여 PDT를 여러 단계로 빌드합니다.

매개변수 이름 수준 설명
create_process 보기 한 번에 하나씩 실행될 일련의 SQL 문을 나열된 순서대로 지정합니다. 각 개별 SQL 문은 sql_step 하위 매개변수를 사용하여 지정됩니다.
sql_create 보기 SQL CREATE 문을 정의하여 커스텀 DDL 명령어가 필요한 데이터베이스 언어에 PDT를 만듭니다.

영구 파생 테이블의 재생성 및 캐싱 매개변수

위의 캐싱 섹션에서 설명한 것처럼 데이터 그룹을 사용하여 캐싱을 관리하고 효율성과 데이터 최신 상태 간의 균형을 맞출 수 있습니다.

새 데이터를 사용할 수 있게 되면 데이터 그룹을 사용하여 영구 파생 테이블 (PDT)을 재생성할 수 있습니다. 또는 기본 테이블이 자주 업데이트되더라도 PDT를 자주 재생성하지 않도록 지정할 수 있으므로 PDT에 대한 쿼리를 더 오랫동안 캐시할 수 있습니다.

자세한 내용은 Looker의 파생 테이블 문서 페이지 및 데이터 그룹을 사용하여 쿼리 캐싱 및 PDT 재빌드 문서 페이지에서 지속성 전략을 참고하세요.

매개변수 이름 수준 설명
datagroup_trigger 보기 PDT 재빌드 정책에 사용할 데이터 그룹 지정
persist_for(derived_table의 경우) 보기 PDT가 다시 생성되기 전에 PDT의 최대 기간을 설정합니다. 더 강력한 datagroup_trigger 매개변수를 사용해 보세요.
sql_trigger_value 보기 PDT를 다시 생성하도록 하는 조건을 지정합니다. 더 강력한 datagroup_trigger 매개변수를 사용해 보세요.

파생 테이블의 쿼리 효율성 매개변수

데이터베이스 언어에 따라 파생된 테이블의 효율성을 개선하는 데 사용할 수 있는 매개변수가 있습니다.

매개변수 이름 수준 설명
cluster_keys 보기 PDT 또는 집계 테이블이 BigQuery의 하나 이상의 필드로 클러스터링되도록 지정합니다.
Snowflake의 cluster_keys에 대한 지원이 추가되었습니다.
집계 테이블이 있는 cluster_keys에 대한 지원이 추가되었습니다.
distribution 보기 PDT 또는 Redshift 또는 Aster에 빌드된 집계 테이블의 배포 키를 설정합니다.
집계 테이블이 있는 distribution에 대한 지원이 추가되었습니다.
distribution_style 보기 Redshift에서 빌드된 PDT 또는 집계 테이블의 배포 스타일을 설정합니다.
집계 테이블이 있는 distribution_style에 대한 지원이 추가되었습니다.
increment_key 보기 ADDED 21.4 파생된 테이블을 증분 PDT로 만듭니다. increment_key는 새 데이터를 쿼리하고 PDT에 추가해야 하는 시간 증가분을 지정합니다.
increment_offset 보기 ADDED 21.4 증분 PDT에 increment_key 매개변수와 함께 사용됩니다. increment_offset는 늦게 도착하는 데이터를 고려하여 다시 빌드된 이전 기간 (증분 키의 세부사항) 수를 지정합니다.
indexes 보기 PDT 또는 기존 데이터베이스 (예: MySQL, Postgres) 또는 Redshift의 인터리브 정렬 키
집계 테이블이 있는 indexes에 대한 지원이 추가되었습니다.
partition_keys 보기 PDT 또는 집계 테이블이 Presto의 하나 이상의 필드 또는 BigQuery의 단일 날짜/시간 필드로 파티셔닝되도록 지정합니다.
집계 테이블이 있는 partition_keys에 대한 지원이 추가되었습니다.
sortkeys 보기 Redshift에서 빌드된 PDT 또는 집계 테이블의 정렬 키를 설정합니다.
집계 테이블이 있는 sortkeys에 대한 지원이 추가되었습니다.
table_compression 보기 Amazon Athena의 PDT에 사용할 테이블 압축을 지정합니다.
table_format 보기 Amazon Athena의 PDT에 사용할 테이블 형식을 지정합니다.

집계 테이블

집계 인지도 문서 페이지에 설명된 대로 집계 표는 탐색에서 쿼리를 최적화하는 데 도움이 됩니다. 집계 테이블은 영구 파생 테이블 (PDT)과 마찬가지로 데이터베이스에 유지됩니다.

집계 테이블은 탐색 아래에 정의됩니다.

매개변수 이름 수준 설명
aggregate_table 살펴보기 탐색의 집계 테이블을 만듭니다. 이 매개변수에는 aggregate_table 매개변수 문서 페이지에 설명된 하위 매개변수가 있습니다.

추가 쿼리 동작 매개변수

쿼리 대상 및 방법에 영향을 주는 다양한 매개변수가 있으며, 그중 일부는 그 용도에 따라 이 페이지의 다른 섹션에서 설명합니다. 이 섹션에서는 쿼리 동작을 설정할 수 있는 나머지 LookML 매개변수를 설명합니다.

쿼리할 항목

이 매개변수는 쿼리에 사용될 연결, 파일, 필드에 대한 특정 정보를 정의합니다.

매개변수 이름 수준 설명
access_grant 모델 LookML 구조에 대한 액세스를 승인된 사용자 속성 값이 있는 사용자로만 제한하는 액세스 권한 부여를 생성합니다. 이 매개변수에는 user_attribute 및 allowed_values 하위 매개변수가 있습니다.
connection 모델 모델의 데이터베이스 연결 변경
fanout_on 필드: D DG M Google BigQuery 반복 필드에 대한 액세스 사용 설정
from 살펴보기 탐색의 기반이 되는 뷰를 지정하고 탐색의 이름으로 이 뷰의 필드를 참조합니다.
required_access_grants 살펴보기 탐색에 대한 액세스를 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자로만 제한합니다.
required_access_grants 참여 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자만 조인에 액세스하는 것을 제한합니다.
required_access_grants 보기 보기 액세스 권한을 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자로만 제한합니다.
required_access_grants 필드: D DG M F P 사용자 속성 값이 액세스 권한 부여와 일치하는 사용자만 필드에 액세스할 수 있도록 제한
required_fields 필드: D M 필드가 선택되면 쿼리에 필드를 추가해야 함
sql_table_name 살펴보기 탐색의 기반이 되는 데이터베이스 테이블을 지정합니다.
sql_table_name 보기 뷰의 기반이 되는 SQL 테이블 변경
view_name 살펴보기 탐색의 기반이 되는 뷰를 지정하고 해당 뷰의 필드를 뷰 이름으로 참조합니다.

쿼리 방법

이러한 매개변수는 Looker에서 쿼리를 구성하거나 처리하는 방식에 영향을 줍니다.

이러한 매개변수 중 일부는 대칭 집계가 작동하도록 하는 데 사용됩니다. 대칭 집계에 대한 자세한 내용은 고객센터의 대칭 집계에 대한 간단한 설명 또는 '어스에서 내 SQL이 표시되는 이유' 도움말을 참고하세요.

매개변수 이름 수준 설명
alias 필드: D DG M F P 필드 이름을 변경해도 이전 필드 이름이 있는 저장된 URL이 계속 작동하도록 허용
cancel_grouping_fields 살펴보기 탐색에서 특정 필드가 선택되면 GROUP BY 절을 취소합니다.
primary_key 필드: D 측정기준을 뷰의 기본 키로 선언합니다.
sql_where 참여 이 조인이 쿼리에 포함된 경우 사용자가 이 탐색에서 변경하거나 삭제할 수 없는 조건을 쿼리의 WHERE 절에 삽입합니다. BigQuery 전용입니다. 이 매개변수는 필터 매개변수로도 간주될 수 있습니다.
symmetric_aggregates 살펴보기 탐색에서 대칭 집계를 사용 설정할지 여부를 지정합니다. 이 값은 측정 값에 영향을 미치는 매개변수에 대해서도 표시됩니다.

피해야 할 매개변수

모델에 다음과 같은 매개변수가 표시될 수 있으므로 이러한 매개변수의 목록을 여기에 포함했습니다. 그러나 새 모델링을 추가하는 경우에는 이러한 매개변수를 사용하지 마세요.

매개변수 이름 수준 설명
access_filter_fields 살펴보기 삭제됨 6.0 access_filter로 대체됨
decimals 필드: D M 삭제된 5.4 value_format로 대체됨
distkey 보기 삭제됨 3.26 distribution로 대체됨
format 필드: D M 삭제됨 3.16 value_format로 대체됨
scoping 모델 삭제된 3.52 더 이상 필요하지 않음
sql 참여 AVOID 3.10 sql (조인용) 매개변수 문서 페이지에 설명된 대로 sql_on, foreign_key, type 또는 sql_table_name의 조합으로 대체됨
sql_foreign_key 참여 AVOID 3.16 foreign_key로 대체됨
template 모델 삭제된 3.30 더 이상 필요하지 않음
view_label 보기 AVOID 4.4 label로 대체됨

기타 튜토리얼 및 리소스

이 섹션에는 LookML에 대한 이해도를 높이고 Looker의 다른 개발자 작업을 지원하는 추가 리소스 링크가 포함되어 있습니다.

개발 프로세스 이해

Looker 문서 메뉴의 데이터 모델링 섹션은 Looker의 개발 섹션에서 시작할 수 있도록 설계되었습니다.

도움이 될 만한 특정 페이지:

LookML 이해하기

Looker 문서 메뉴의 LookML 학습 단계 섹션은 기본 LookML 개념을 소개하고 LookML을 능숙하게 다룰 수 있는 학습 과정을 추천하도록 설계되었습니다.

도움이 될 만한 특정 페이지:

LookML 대시보드 만들기

프로젝트의 모든 대시보드 파일에는 대시보드별 LookML 매개변수가 포함됩니다. 현재 페이지에는 데이터 모델링 매개변수만 포함되며 대시보드 매개변수는 포함되지 않습니다. 그러나 Looker 문서 메뉴의 LookML 대시보드 만들기 및 관리 섹션에서는 LookML 대시보드 사용을 소개합니다.

도움이 될 만한 특정 페이지:

퍼가기, API, 관리자 옵션

Embedding

다음 페이지는 스타일, 탐색, 대시보드를 삽입하는 방법에 대해 자세히 알아볼 수 있습니다.

API

Looker 문서 메뉴의 Looker API 섹션은 Looker의 안전한 'RESTful' 애플리케이션 프로그래밍 인터페이스 (API)를 시작할 수 있도록 설계되었습니다.

관리자 옵션

Looker 문서 메뉴의 관리자 옵션 시작하기 섹션은 Looker의 관리 섹션에서 시작할 수 있도록 설계되었습니다.

Looker Connect에서 교육

Looker Connect에서 LookML 개발자 학습 과정에 등록합니다.