Looker 26.14 문서를 보고 있습니다. 최신 문서를 보려면 이 링크를 클릭하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

sql_analytic_model_name (뷰)

이 페이지에서는 sql_analytic_model_name 매개변수를 참조합니다. 이 매개변수는 뷰의 일부입니다.

sql_analytic_model_name은 Explore의 일부로도 사용할 수 있으며, sql_analytic_model_name (Explore용) 매개변수 문서 페이지에 설명되어 있습니다.

사용

view: view_name {
  sql_analytic_model_name: analytic_model_name ;;
}

계층 구조

뷰 파일

view

sql_analytic_model_name

기본값

없음

허용

데이터베이스 내 분석 모델 이름

특수 규칙

분석 모델은 BigQuery 및 Snowflake 연결에서만 지원됩니다.
sql_analytic_model_name에서 참조하는 분석 모델은 모델의 데이터베이스 연결 내에서 액세스할 수 있어야 합니다.
분석 모델이 데이터베이스 연결에서 정의한 기본 경로와 다른 데이터베이스, 스키마, 프로젝트 또는 데이터 세트에 있는 경우 분석 모델 이름을 범위 지정해야 합니다.

정의

BigQuery 및 Snowflake 연결의 경우 sql_analytic_model_name 매개변수는 LookML 뷰의 기준으로 사용할 기존 데이터베이스 내 분석 모델 (BigQuery 그래프 또는 Snowflake의 시맨틱 뷰)의 이름을 지정합니다. 이렇게 하면 BigQuery 그래프 또는 Snowflake의 시맨틱 뷰와 같이 데이터베이스에 직접 정의된 분석 모델을 활용할 수 있습니다.

이 시나리오에서는 분석 모델 객체가 이미 데이터베이스에 있으며 데이터베이스에서 관리합니다. 분석 모델은 Looker에서 생성, 유지관리 또는 관리되지 않습니다. 이는 sql_table_name을 사용하여 LookML 뷰로 노출되는 일반 데이터베이스 테이블이 Looker에서 관리되지 않는 방식과 유사합니다.

LookML 뷰 파일에서 sql_analytic_model_name 매개변수를 사용하여 Looker가 데이터베이스의 분석 모델을 가리키도록 합니다. 그런 다음 Looker 측정기준 및 측정항목을 만들어 분석 모델에 매핑하여 Looker를 사용하여 분석 모델을 쿼리할 수 있도록 합니다.

분석 모델 이름 범위 지정

분석 모델 이름만 사용하여 분석 모델을 참조하면 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 연결 문서 페이지를 참조하세요.

분석 뷰를 기반으로 LookML 측정기준 및 측정항목 만들기

뷰 파일을 만들고 분석 모델을 sql_analytic_model_name으로 식별한 후 동일한 뷰 파일에서 분석 모델을 기반으로 하는 LookML 측정기준 및 측정항목을 정의할 수 있습니다.

분석 모델의 요소를 참조하는 데 사용할 적절한 SQL 구문에 관한 자세한 내용은 언어의 문서를 참조하세요. 예를 들어 BigQuery 그래프 항목에서 LookML 측정기준을 만들려면 범위를 지정할 때 요소 사이에 밑줄을 사용해야 합니다. 예를 들어 BigQuery 그래프의 경우 이 LookML 측정기준은 Stores 노드 테이블의 location_id 속성을 기반으로 합니다.

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

하지만 Snowflake 시맨틱 뷰를 기반으로 하는 LookML 측정기준을 만들려면 측정항목 또는 측정기준의 정규화되지 않은 이름을 사용해야 합니다.

예

다음은 BigQuery 데이터베이스에 정의된 StoreGraph라는 BigQuery 그래프의 예입니다.

CREATE OR REPLACE PROPERTY GRAPH mydataset.StoreGraph
  NODE TABLES (
    mydataset.Stores AS S,
    mydataset.Locations AS L
    PROPERTIES(id, name, population, MEASURE(SUM(population)) AS total_population)
  )
  EDGE TABLES (
    mydataset.Stores AS SL
    SOURCE KEY (location_id) REFERENCES L (id)
    DESTINATION KEY (name) REFERENCES S (name)
  );

다음은 그래프에 매핑된 측정기준 및 측정항목을 포함하여 StoreGraph BigQuery 그래프를 기반으로 하는 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 ;;
  }
}

고려사항

Looker의 분석 모델 고려사항

데이터베이스 내 분석 모델을 사용할 때는 다음 고려사항과 제한사항에 유의하세요.

데이터 유형: 분석 모델에서는 측정기준 및 측정항목의 다음 데이터 유형만 지원됩니다.
- 측정기준 및 측정항목에서 지원됨:
  - string
  - number
  - date
  - yesno
- 측정기준에서만 지원됨:
  - time
  - date_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) ;;
}
```
조인: 기본 뷰가 분석 모델을 기반으로 하는 Explore에는 조인이 포함될 수 없습니다. 마찬가지로 분석 모델을 기반으로 하는 뷰는 표준 LookML 기본 뷰가 있는 Explore에 조인할 수 없습니다.
암시적 조인: 암시적 조인을 사용하는 기능은 분석 모델에서 지원되지 않습니다. 암시적 조인을 사용하는 기능의 예로는 맞춤 캘린더 및 type: location, type: distance 또는 type: zipcode로 정의된 필드가 있습니다.
분석 모델에서는 다음 기능이 지원되지 않습니다.

분석 모델은 현재 연결에서 액세스할 수 있어야 함

sql_analytic_model_name 매개변수가 view 객체 내에서 사용되면 해당 view 객체는 explore 객체에서 참조될 수 있으며, 이 객체는 모델 객체에서 참조됩니다. 모델 객체에는 데이터베이스 connection이 정의되어 있습니다. sql_analytic_model_name 매개변수에서 분석 모델을 참조할 때는 분석 모델이 모델 파일에 지정된 연결 내에서 액세스할 수 있어야 합니다.

기본 데이터베이스 및 스키마 (또는 Google BigQuery의 경우 결제 프로젝트 및 데이터 세트)는 Looker 관리자가 데이터베이스에 Looker 연결을 만들 때 정의합니다.