Looker 22.16 문서를 보고 있습니다. 최신 문서는 여기에서 확인할 수 있습니다.

확장 (탐색용)

이 페이지에서는 탐색의 일부인 extends 매개변수를 설명합니다.

extends는 extends(뷰용) 매개변수 문서 페이지에 설명된 대로 뷰의 일부로 사용할 수도 있습니다.

extends는 대시보드 매개변수 문서 페이지에 설명된 대로 LookML 대시보드의 일부로 사용할 수도 있습니다.

용도

Explore: Explore_name {
extends: [explore_name, explore_name, ...]
}

계층 구조

모델 파일

explore

extends

기본값

없음

결제 가능

쉼표로 구분된 탐색 이름 목록이 포함된 대괄호

정의

extends 매개변수를 사용하면 다른 탐색을 시작점으로 사용하여 다른 탐색의 콘텐츠 및 설정을 기반으로 구축할 수 있습니다. 충돌이 있는 경우 확장 탐색이 자체 설정을 사용하여 확장되는 탐색의 설정을 재정의합니다. Looker에서 코드를 실행하는 방법에 관한 자세한 내용은 extends로 코드 재사용 문서 페이지를 참고하세요.

LookML 상세검색을 확인하세요.
뷰 또는 탐색 확장을 확장하는 것은 여러 버전의 뷰 또는 탐색을 사용하려는 시나리오에 적합합니다. 하지만 목표가 포함된 LookML 파일을 수정하지 않고 뷰 또는 탐색을 수정하는 것이라면 상세검색을 대신 사용하는 것이 좋습니다. 상세검색 내에서 extends 매개변수를 사용할 수도 있습니다. 자세한 내용과 사용 사례는 LookML 개선 문서 페이지를 참조하세요.

탐색을 확장할 경우 확장될 탐색에 view_name 매개변수가 있어야 합니다. view_name 매개변수는 탐색의 기반이 되는 뷰를 정의합니다. 기본값은 탐색의 이름입니다. 기본 탐색에 view_name가 지정되지 않은 경우 기본적으로 탐색 이름이 지정됩니다. 하지만 기본 탐색 분석을 확장하는 다른 탐색 분석에는 사용할 수 없으므로 '알 수 없는 보기' 오류가 발생합니다. Looker에서 올바른 뷰 파일을 사용하려면 view_name 매개변수를 사용하여 파일을 지정해야 합니다. 탐색의 모든 확장 버전에서 이 작업이 필요하므로 기본 탐색에 추가하여 탐색이 확장될 때마다 참조되도록 하는 것이 좋습니다.

기본 탐색에 아직 view_name 매개변수가 없는 경우 view_name 매개변수를 추가하고 탐색의 이름과 동일한 값을 지정하기만 하면 됩니다.

기본에 view_label 매개변수를 사용하고 탐색을 확장할 수도 있습니다. view_label 매개변수는 필드 선택 도구에서 뷰의 필드가 그룹화되는 라벨을 결정합니다 (예시는 view_label (탐색용) 매개변수 문서 페이지 참고). 기본에 view_label을 지정하지 않고 탐색을 확장하면 둘 다 기본 탐색의 탐색 이름을 사용합니다.

예

다음은 모델 파일에 정의된 탐색의 예입니다.

explore: orders {
  view_name: orders
  view_label: "Orders"
  # The normal contents of the Explore follow
}

그리고 위에서 정의한 orders 탐색을 확장하는 새 탐색을 추가합니다.

explore: name_of_the_new_explore {
  extends: [orders]
  view_label: "Order Information"
  # The additional things you want to add or change
  # in the new Explore
}

확장 뷰를 기반으로 하는 탐색을 확장하는 경우 from 매개변수도 사용해야 합니다. 확장에 from를 추가하고 확장ed 뷰의 이름을 할당합니다.

explore: new_explore {
  extends: [orders]
  from: extended_orders_view
  #The normal contents of the Explore follow
}

`extends`를 사용하여 여러 사용자의 필드 제한

탐색을 확장할 때 매우 유용한 사용 사례로는 탐색 필드의 하위 집합만 특정 사용자에게 표시할 수 있습니다. 예를 들어 조인된 표에서 사용 가능한 모든 필드가 포함된 products 탐색이 있다고 가정해 보겠습니다.

explore: products {
  view_name: products
  from: products
  join: inventory_items {
    type: left_outer
    sql_on: ${products.id}=${inventory_items.product_id} ;;
    relationship: many_to_one
  }

  join: order_items {
    type: left_outer
    sql_on: ${order_items.inventory_item_id}=${inventory_items.id} ;;
    relationship: one_to_one
  }
}

제품 카테고리와 반품만 확인해야 하는 팀이 있다면 products 탐색을 확장하고 fields 매개변수를 사용하여 제품 카테고리와 반품 필드만 포함하도록 지정할 수 있습니다.


explore: products_extended {
  extends: [products]
  fields: [products.category,order_items.returned_date]
}

products_extended 탐색에는 products.category 및 order_items.returned_date의 두 입력란만 표시됩니다.

모델 간 탐색 확장

탐색은 일반적으로 모델 파일 내에서 정의됩니다. 탐색을 확장하려면 위의 예와 같이 동일한 모델 파일에서 확장 탐색을 정의하면 됩니다.

그러나 여러 모델로 탐색을 확장하려는 경우 기본 파일로 사용할 별도의 탐색 파일을 만들어야 합니다. 자체 파일에서 기본 탐색을 정의하면 모델 파일에 탐색 파일을 포함하고 모델 파일에서 탐색을 확장할 수 있습니다.

다른 탐색 파일에 탐색 파일을 포함할 수 있으므로 필요한 경우 여러 다른 탐색 파일에 기본 탐색 파일을 공유할 수도 있습니다.

탐색 파일은 파일이 포함된 모델의 연결을 리슨합니다. 탐색 파일의 상위 모델과 다른 연결로 구성된 모델에 탐색 파일을 포함할 때는 이 점에 유의하세요. 포함된 모델의 연결을 위한 스키마가 상위 모델 연결의 스키마와 다른 경우 쿼리 오류가 발생할 수 있습니다.

메타데이터를 사용하여 객체의 확장 프로그램 보기

Looker IDE에서 explore 또는 view 매개변수를 클릭하고 메타데이터 패널을 사용하여 객체의 확장 프로그램을 확인하거나 확장되는 객체를 확인할 수 있습니다. 자세한 내용은 LookML 객체의 메타데이터 문서 페이지를 참조하세요.

고려사항

일부 매개변수는 중복해서 사용할 수 없습니다.

대부분의 경우 확장 객체에 확장 중인 객체와 동일한 매개변수가 포함된 경우 확장 객체의 값이 확장 객체의 매개변수 값보다 우선합니다. 하지만 일부 매개변수의 경우 확장 프로그램이 추가될 수 있습니다. 즉, 확장 객체의 값이 확장 객체의 값과 함께 사용됩니다.

다음 탐색 매개변수는 추가됩니다.

다음 예에서 aircraft_base 탐색은 join 매개변수를 사용하여 aircraft 뷰를 aircraft_types 뷰와 조인합니다.


explore: aircraft {
  view_name: aircraft
  label: "Aircraft"

  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }
}

aircraft_extended 탐색은 aircraft_base 탐색을 확장합니다. 또한 aircraft_extended 탐색에는 aircraft_engine_types 뷰에 조인되는 join 매개변수가 있습니다.


explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

join 매개변수는 추가된 것입니다. 따라서 결과로 표시된 탐색에는 기본 탐색에서 결합된 뷰와 확장 탐색에 결합된 뷰가 표시됩니다. 이 경우 aircraft_extended 탐색에는 aircraft 뷰, aircraft_types 뷰, aircraft_engine_types 뷰가 포함됩니다.

현지화가 필요한 프로젝트

객체를 확장할 때는 현지화 규칙도 광고 확장에도 적용된다는 점에 유의하세요. 객체를 확장한 다음 새 라벨이나 설명을 정의하는 경우 프로젝트의 언어 문자열 파일에 현지화 정의를 제공해야 합니다. 자세한 내용은 LookML 모델 현지화 문서 페이지를 참고하세요.