이 페이지에서는
sql_analytic_model_name매개변수가 Explore의 일부임을 참조합니다.
sql_analytic_model_name은 뷰의 일부로도 사용할 수 있으며,sql_analytic_model_name(뷰용) 매개변수 문서 페이지에 설명되어 있습니다.
사용
explore: explore_name {
sql_analytic_model_name: analytic_model_name ;;
}
sql_analytic_model_name |
기본값
없음
허용
데이터베이스 내 분석 모델 이름
특수 규칙
|
정의
BigQuery 및 Snowflake 연결의 경우 sql_analytic_model_name 매개변수는 LookML Explore의 기반으로 사용할 기존 데이터베이스 내 분석 모델 (BigQuery 그래프 또는 Snowflake의 시맨틱 뷰)의 이름을 지정합니다.
대부분의 경우 sql_analytic_model_name (뷰용) 매개변수를 사용하여 뷰 파일에서 분석 모델을 지정합니다. 그런 다음 해당 뷰 파일에서 데이터베이스의 분석 모델을 기반으로 하는 LookML 측정기준과 측정값을 정의합니다. 하지만 데이터베이스에 동일한 LookML 필드로 정의할 수 있는 분석 모델이 여러 개 있는 경우 explore 매개변수 아래에서 sql_analytic_model_name 매개변수를 사용할 수 있습니다.
explore 매개변수 아래에서 sql_analytic_model_name을 지정하면 Explore가 뷰 파일에 지정된 분석 모델을 재정의하고 대신 explore 매개변수 아래의 sql_analytic_model_name에 지정한 분석 모델을 쿼리합니다. 이 경우 Explore는 뷰 파일에 정의된 LookML 측정값과 측정기준을 사용하지만 explore 매개변수의 sql_analytic_model_name 매개변수에 지정된 분석 모델에 적용합니다.
분석 모델 이름 범위 지정
분석 모델 이름만 사용하여 분석 모델을 참조하면 Looker는 Looker 관리자가 데이터베이스 연결의 설정에서 구성한 기본 검색 경로 (데이터베이스 및 스키마)를 사용합니다.
데이터베이스 사용자의 기본 검색 경로에 없는 다른 데이터베이스 및 스키마에서 분석 모델을 참조해야 하는 경우 <database_name>.<schema_name>.<analytic_model_name> 형식을 사용하여 다른 데이터베이스 또는 스키마를 가리키도록 분석 모델 이름을 범위 지정할 수 있습니다.
- 다른 스키마의 분석 모델을 참조하려면
<schema_name>.<analytic_model_name>을 사용합니다. - 다른 데이터베이스의 분석 모델을 참조하려면 전체
<database_name>.<schema_name>.<analytic_model_name>을 사용합니다.
Google BigQuery 연결의 경우 <project_name>.<dataset_name>.<analytic_model_name> 형식을 사용하여 분석 모델 이름을 범위 지정하여 다른 프로젝트 및 데이터 세트의 분석 모델을 참조할 수 있습니다. 자세한 내용은 Google BigQuery 연결 문서 페이지를 참조하세요.
예
다음은 BigQuery 데이터베이스의 StoreGraph BigQuery 그래프를 기반으로 하는 MyStoreGraphView라는 LookML 뷰의 예입니다. 그래프에 매핑된 측정기준과 측정값을 포함합니다.
view: MyStoreGraphView {
sql_analytic_model_name: StoreGraph ;;
dimension: location_id {
type: number
sql: Stores_location_id ;;
}
dimension: population {
type: number
sql: Locations_population ;;
}
dimension: location_name {
type: string
sql: Locations_name ;;
}
measure: locations_total_population {
type: number
sql: Locations_total_population ;;
}
}
데이터베이스에 StoreGraph와 동일한 요소가 있는 ShopDetailsGraph라는 다른 그래프가 있다고 가정해 보겠습니다. 다음은 MyStoreGraphView 뷰 파일에서 sql_analytic_model_name 값을 재정의하는 Explore입니다. Explore에는 MyStoreGraphView에 정의된 것과 동일한 LookML 측정기준과 측정값이 있지만 Explore는 ShopDetailsGraph 분석 모델을 쿼리합니다.
explore: MyStoreGraphView {
sql_analytic_model_name: ShopDetailsGraph ;;
}
고려사항
Looker의 분석 모델 고려사항
데이터베이스 내 분석 모델을 사용할 때는 다음 고려사항과 제한사항에 유의하세요.
데이터 유형: 분석 모델에서는 측정기준 및 측정값에 다음 데이터 유형만 지원됩니다.
- 측정기준 및 측정값에 지원됨:
stringnumberdateyesno
- 측정기준에만 지원됨:
timedate_time
- 측정기준 및 측정값에 지원됨:
측정값:
- 기본 측정값은 미리 정의해야 함: 기본 측정값은 기본 데이터베이스 분석 모델에 미리 정의해야 합니다. Looker는 분석 모델의 측정기준에 집계 (예:
type: sum또는type: count)를 실행하여 새 기본 측정값을 정의할 수 없습니다. 다른 측정값을 기반으로 하는 측정값이 지원됨: LookML 측정값의
sql매개변수를 사용하여 분석 모델의 미리 정의된 기본 측정값을 사용하는 비집계 계산을 실행할 수 있습니다. 다른 측정값을 기반으로 하는 측정값을 만들 때는 새 측정값을sum또는count와 같은 집계 측정값 유형으로 정의할 수 없습니다. 새 측정값을string,number,date또는yesno와 같은 비집계 측정값 유형으로 정의해야 합니다. 아래 예시를 참조하세요.measure: average_order_amount { type: number sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;; }
- 기본 측정값은 미리 정의해야 함: 기본 측정값은 기본 데이터베이스 분석 모델에 미리 정의해야 합니다. Looker는 분석 모델의 측정기준에 집계 (예:
조인: 기본 뷰가 분석 모델을 기반으로 하는 Explore에는 조인이 포함될 수 없습니다. 마찬가지로 분석 모델을 기반으로 하는 뷰는 표준 LookML 기본 뷰가 있는 Explore에 조인할 수 없습니다.
암시적 조인: 암시적 조인에 의존하는 기능은 분석 모델에서 지원되지 않습니다. 암시적 조인에 의존하는 기능의 몇 가지 예는 맞춤 캘린더 및
type: location,type: distance또는type: zipcode로 정의된 필드입니다.분석 모델에서는 다음 기능이 지원되지 않습니다.
분석 모델은 현재 연결에서 액세스할 수 있어야 함
sql_analytic_model_name 매개변수가 explore 객체 내에서 사용되면 해당 explore 객체는 모델 객체에 포함됩니다. 이 페이지의 계층 구조는 이 관계 체인을 보여줍니다. 모델 객체에는 데이터베이스 connection이 정의되어 있습니다. sql_analytic_model_name 매개변수에서 분석 모델을 참조할 때는 분석 모델이 모델 파일에 지정된 연결 내에서 액세스할 수 있어야 합니다.
기본 데이터베이스 및 스키마 (또는 Google BigQuery의 경우 결제 프로젝트 및 데이터 세트)는 Looker 관리자가 데이터베이스에 대한 Looker 연결을 만들 때 정의합니다.