include

용도

포함: "/views/airports.view"

계층 구조 모델 파일 include - 또는 - 파일 보기 include - 또는 - explore include

기본값 없음 결제 가능 파일 이름 또는 패턴이 포함된 문자열

정의

include 매개변수는 모델, 뷰 또는 탐색에서 사용할 수 있는 LookML 파일을 지정합니다. 다른 파일 내에서 LookML 파일을 사용하거나 참조하려면 include 매개변수를 사용하여 LookML 파일을 추가해야 합니다.

모델 파일, 파일 보기, 탐색 파일에서 include 매개변수를 사용할 수 있습니다. include 매개변수는 컨텍스트에 따라 다양한 유형의 LookML 파일을 참조할 수 있습니다.

모델 파일에서 include를 사용하여 다음을 참조할 수 있습니다.

• 파일 보기
• 대시보드 파일
• 파일 살펴보기
• 데이터 테스트 파일

뷰 파일에서 include를 사용하여 다음을 참조할 수 있습니다.

• 파일 보기
• 파일 살펴보기
• 데이터 테스트 파일

탐색 파일에서 include를 사용하여 다음을 참조할 수 있습니다.

• 파일 보기
• 파일 살펴보기

include를 사용하여 다른 프로젝트의 파일을 가져올 수도 있습니다. 다른 프로젝트의 파일 포함에 대한 자세한 내용은 다른 프로젝트에서 파일 가져오기 문서 페이지를 참조하세요. 로컬 LookML 프로젝트에서 파일을 가져오려면 로컬 프로젝트 가져오기 실험실 기능을 사용 설정해야 합니다.

include를 사용할 때는 다음 사항에 유의하세요.

• 문서 파일 또는 데이터 파일과 같은 LookML 이외의 파일 형식에는 include를 사용할 필요가 없습니다.
• 파일 포함은 항목을 모두 포함 또는 제외하므로 포함된 파일의 모든 정보가 포함 파일에 추가됩니다.
• 파일 하나에 여러 include 매개변수를 사용할 수 있습니다.
• * 와일드 카드 문자를 사용하여 전략적 명명 규칙 또는 동일한 확장자를 가진 파일을 나타낼 수 있습니다. 예를 들어 "*base.dashboard"를 사용하여 "database.dashboard"와 "crunchbase.dashboard"를 모두 일치시키고 포함할 수 있습니다. "*.dashboard"를 사용하여 확장자가 .dashboard인 모든 파일을 나타낼 수 있습니다.
• * 와일드 카드 문자를 사용하여 디렉터리의 모든 파일을 포함할 수 있습니다. 예를 들어 include: "/views/users/*.view"를 지정하여 views/users/ 디렉터리에 모든 뷰 파일을 포함할 수 있습니다. IDE 폴더에서 와일드 카드를 사용하는 방법에 대한 자세한 내용은 IDE 폴더에 대한 도움말 페이지를 참조하세요.

유용한 도움말: 와일드 카드를 사용할 때 파일의 줄 번호 옆에 있는 정보 아이콘 위로 마우스를 가져가거나 include 문을 클릭한 후 빠른 도움말을 확인하여 어떤 파일이 포함되어 있는지 확인할 수 있습니다.

유용한 도움말: Looker IDE의 점 3개로 된 메뉴에서 파일 경로 복사를 선택하여 파일 경로를 복사할 수 있습니다.

모델 파일에서 include 사용

모델 파일에서 include 매개변수를 사용하여 뷰 및 대시보드 또는 탐색 분석을 포함할 수 있습니다.

모델에 뷰 및 대시보드 포함

모델 파일에서 include 매개변수를 사용하여 대시보드를 지정하고 이 모델에서 사용할 수 있는 파일을 확인합니다. 모델 내에서 LookML 파일을 사용하거나 참조하려면 include 매개변수를 사용하여 LookML 파일을 추가해야 합니다.

include 매개변수에서 뷰 파일에 확장 프로그램 .view를 사용하고 대시보드에 확장 프로그램 .dashboard를 사용합니다. 이 확장 프로그램의 .lkml 및 .lookml 부분은 생략할 수 있습니다.

* 와일드 카드 문자를 사용하여 전략적 명명 규칙 또는 동일한 확장자를 가진 파일을 나타낼 수 있습니다. IDE 폴더 문서 페이지의 와일드 카드 예 섹션에 설명된 대로 * 와일드 카드를 디렉터리 경로와 함께 사용하여 여러 파일을 지정할 수도 있습니다.

예를 들어 모델 파일에서 다음과 같은 include 매개변수를 사용할 수 있습니다.

include: "/**/*.dashboard"
include: "/*/*base.view.lkml"
include: "//e_commerce/views/*.view.lkml"

이러한 매개변수에는 다음과 같은 파일이 포함됩니다.

• 프로젝트의 모든 디렉터리에 있는 모든 대시보드 파일
• 프로젝트의 모든 하위 디렉터리(예: /views/database.view.lkml 또는 /public/crunchbase.view.lkml)에서 base.view.lkml로 끝나는 뷰 파일
• 이름이 가져온 프로젝트의 /views/ 디렉터리에 있는 모든 뷰 파일(e_commerce)

프로젝트에 많은 수의 뷰 파일이 있는 경우 또는 프로젝트에서 영구 파생 테이블 (PDT)을 사용하는 경우 모델에 모든 뷰 파일을 포함하지 않아야 합니다. 대신 이와 같은 개별 뷰 파일을 포함하세요. 다음은 프로젝트에 개별 뷰 파일과 모든 대시보드를 포함하는 예입니다.

include: "/views/order.view"
include: "/views/user.view"
include: "/**/*.dashboard"

모델에 모델 포함

다른 프로젝트의 모델 파일을 포함할 수 없습니다. 대신 프로젝트 간에 탐색을 재사용, 구체화 또는 확장하려면 가져온 프로젝트에서 별도의 탐색 파일을 만든 다음 다른 프로젝트에 탐색 파일을 포함하면 됩니다. 자세한 내용은 모델에 탐색 포함을 참고하세요.

모델에 탐색 포함

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

탐색은 일반적으로 모델 파일 내에서 정의됩니다. 그러나 파생된 테이블을 위해 또는 모델 간에 탐색을 확장하거나 조정하려면 별도의 탐색 파일이 필요합니다.

별도의 탐색 파일이 있는 경우 모델 파일에 include 매개변수를 사용하여 파일을 포함해야 합니다. include 매개변수에서 .explore.lkml 파일을 탐색 파일에 사용합니다.

예를 들어 아래에 탐색이 두 개 있는 모델 파일이 있습니다.

• aircraft_new 탐색: explores 폴더의 aircraft_new.explore.lkml라는 자체 파일에 정의되어 있습니다. 탐색은 자체 파일에 정의되므로 탐색 파일의 경로를 include 매개변수에 지정해야 합니다.
• 모델 파일 내에 정의된 accidents 탐색 모델 파일 자체에 정의되어 있으므로 모델에서 include 매개변수를 사용할 필요가 없습니다. 그러나 accidents 탐색의 기반이 되는 뷰에 include가 필요합니다.

connection: "faa"

include: "/explores/aircraft_new.explore.lkml"
include: "/views/accidents.view"

explore: accidents {
  view_name: accidents
  from: accidents
}

모델에 데이터 테스트 포함

데이터 테스트는 모델 파일 또는 뷰 파일에서 직접 정의할 수 있습니다. 그러나 프로젝트의 여러 위치에서 데이터 테스트를 재사용하려면 별도의 데이터 테스트 파일을 만들면 됩니다.

별도의 데이터 테스트 파일이 있는 경우 데이터 테스트를 실행할 수 있도록 모델 파일 또는 뷰 파일에서 include 매개변수를 사용해야 합니다. include 매개변수에서 데이터 테스트 파일에 .lkml 확장자를 사용합니다.

예를 들어 다음은 데이터 테스트 파일이 포함된 모델 파일에서 발췌한 것입니다.

connection: "faa"

include: "/explores/aircraft_new.explore.lkml"
include: "/views/accidents.view"
include: "/tests/data_tests.lkml"

. . .

모델 파일에 데이터 테스트 파일을 포함하면 데이터 테스트를 실행하여 데이터 테스트가 제대로 작동하는지 확인하고 모델의 로직이 테스트를 통과하는지 확인할 수 있습니다.

이 페이지의 보기에 데이터 테스트 포함 섹션에 설명된 대로 보기 파일에 데이터 테스트 파일을 포함할 수도 있습니다.

뷰 파일에서 include 사용

대부분의 경우 뷰 파일에서 include를 사용할 필요가 없습니다. 그러나 다음과 같이 뷰 파일에 파일을 포함하고자 할 수도 있습니다.

• 뷰를 확장하거나 미세 조정하는 경우
• 파생된 테이블의 탐색 파일이 있는 경우

뷰에 뷰 포함 (확장 또는 미세 조정)

또한 다른 뷰 파일에 뷰 파일을 포함하여 포함된 뷰를 확장 또는 세분화할 수 있습니다.

예를 들어 다음은 basic_order_fields 뷰 파일을 포함한 후 이를 확장하는 marketing_order_fields 뷰 파일입니다.

include: "/views/basic_order_fields.view"
view: marketing_order_fields {
  extends: [basic_order_fields]  # The file that contains the basic_order_fields
}                                # view should be included

보기에 탐색 포함

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

대부분의 경우 보기에 탐색을 포함하지 않아도 됩니다. 그러나 네이티브 파생 테이블은 explore_source 매개변수가 있는 자체 뷰 파일에 정의되므로 특별한 경우입니다. explore_source 매개변수를 사용하여 Explore를 지정하고 네이티브 파생 테이블의 원하는 열과 기타 원하는 특성을 정의합니다. 탐색은 일반적으로 모델 파일 내에서 정의되지만 네이티브 파생 테이블의 경우 .explore.lkml 파일 확장자를 사용하여 탐색용 파일을 별도로 만드는 방법이 더 깔끔할 수 있습니다. 별도의 탐색 파일을 만드는 경우 네이티브 파생 테이블 보기 파일에 탐색 파일을 포함해야 합니다.

다음은 네이티브 파생 테이블 뷰 파일에서 include를 사용하여 탐색 파일을 가리키는 예입니다.

include: "/explores/order_items.explore.lkml"

view: user_order_facts {
  derived_table: {
    explore_source: order_items {
      column: user_id {field: order_items.user_id}
      column: lifetime_number_of_orders {field: order_items.order_count}
      column: lifetime_customer_value {field: order_items.total_revenue}
      derived_column: average_customer_order {
        sql:  lifetime_customer_value / lifetime_number_of_orders ;;
      }
    }
  }
  dimension: user_id {hidden: yes}
  dimension: lifetime_number_of_orders {type: number}
  dimension: lifetime_customer_value {type: number}
  dimension: average_customer_order {type: number}
}

네이티브 파생 테이블의 탐색 파일에 대한 자세한 내용은 include 문을 사용하여 참조 필드 사용 설정에 대한 문서를 참조하세요.

뷰에 데이터 테스트 포함

데이터 테스트는 모델 파일 또는 뷰 파일에서 직접 정의할 수 있습니다. 그러나 프로젝트의 여러 위치에서 데이터 테스트를 재사용하려면 별도의 데이터 테스트 파일을 만들면 됩니다.

별도의 데이터 테스트 파일이 있는 경우 데이터 테스트를 실행할 수 있도록 모델 파일 또는 뷰 파일에서 include 매개변수를 사용해야 합니다. include 매개변수에서 데이터 테스트 파일에 .lkml 확장자를 사용합니다.

예를 들어 다음은 데이터 테스트 파일이 포함된 뷰 파일에서 발췌한 것입니다.

include: "/tests/data_tests.lkml"

view: orders {
  sql_table_name: looker.orders ;;

  dimension: id {
    primary_key: yes
    type: number
    sql: ${TABLE}.id ;;
  }

. . .

데이터 테스트 파일을 뷰 파일에 포함한 후 데이터 테스트를 실행하여 데이터 테스트가 제대로 작동하는지 확인하고 뷰의 로직이 테스트를 통과하는지 확인할 수 있습니다.

이 페이지의 모델에 데이터 테스트 포함 섹션에 설명된 대로 모델 파일에 데이터 테스트 파일을 포함할 수도 있습니다.

탐색 파일에서 include 사용

탐색은 일반적으로 모델 파일 내에서 정의됩니다. 그러나 파생된 테이블을 위해 또는 모델 간에 탐색을 확장하거나 조정하려면 별도의 탐색 파일이 필요합니다.

별도의 탐색 파일이 있는 경우 include 매개변수를 사용하여 보기 또는 다른 탐색 분석을 포함할 수 있습니다.

탐색에 조회수 포함

별도의 탐색 파일이 있는 경우 탐색 분석에 사용되는 보기를 포함해야 합니다. 보기 파일의 경우 파일 확장자 .view를 사용하세요. 파일 확장자의 .lkml 부분은 생략할 수 있습니다. 다음은 사용 중인 두 보기가 포함된 Explore 파일의 예입니다.

include: "/views/aircraft.view"
include: "/views/aircraft_types.view"

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

탐색에 탐색 포함

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

한 탐색 파일을 다른 탐색 파일에 포함할 수 있습니다(예: 탐색을 확장하거나 수정하는 경우). include 매개변수를 사용하고 파일 확장자 .explore.lkml를 추가합니다.

다음은 다른 탐색 파일을 포함한 다음 탐색을 확장하는 Explore 파일의 예입니다.

include: "/explores/base.explore.lkml"

explore: aircraft_information {
  extends: [aircraft]

Examples

모델 파일, 파일 보기, 파일 탐색에서 include를 사용하는 예는 이전 섹션을 참고하세요.

고려사항

와일드 카드 사용

몇 개의 파일만 관리해야 하는 프로젝트의 경우 다음과 같이 각 파일을 자체 include 매개변수에 나열할 수 있습니다.

include: "/dashboards/user_info.dashboard"
include: "/views/users.view"

포함할 파일이 많은 프로젝트의 경우 와일드 카드를 사용하여 한 번에 여러 파일을 포함해야 하는 include 매개변수의 수를 줄일 수 있습니다.

• 프로젝트의 특정 디렉터리에 파일을 포함하려면 IDE 폴더에 와일드 카드를 사용합니다.
• 와일드 카드를 파일 확장자와 함께 사용하여 특정 파일 형식을 포함합니다.
• 전략적 파일 이름에 와일드 카드를 사용하여 파일 이름에 특정 접두사 또는 접미사가 있는 파일을 포함합니다.

와일드 카드를 사용하면 특히 기존 프로젝트를 IDE 폴더로 구성할 때 LookML 유효성 검사 경고의 임시 수정사항을 만들어야 하는 경우 유용할 수 있습니다. 하지만 include 문에 와일드 카드를 사용할 때는 다음 사항을 고려하세요.

• 모든 뷰 파일을 포함하면 LookML 유효성 검사 성능에 영향을 미치고 데이터베이스 스키마가 복잡해질 수 있으므로 Looker는 와일드 카드를 사용하여 프로젝트의 모든 뷰 파일을 포함하지 않는 것이 좋습니다.
• 모델 파일은 다른 모델 파일에 포함될 수 없으므로 Looker는 프로젝트의 모든 파일을 포함하는 와일드 카드 사용을 지원하지 않습니다.

IDE 폴더에 와일드 카드 사용

IDE 폴더와 함께 와일드 카드를 사용하여 LookML 프로젝트의 특정 디렉터리에 파일을 포함할 수 있습니다.

예를 들어 다음 include 문은 LookML 프로젝트의 /explores/ 디렉터리에 있는 모든 파일을 참조합니다.

include: "/explores/*"

특정 파일 형식에 와일드 카드 사용

와일드 카드를 사용하여 특정 유형의 모든 파일을 참조할 수 있습니다. 예를 들어 다음 include 문은 LookML 프로젝트의 모든 Explore 파일을 참조합니다.

include: "/**/*.explore.lkml"

LookML 파일 유형 및 파일 확장자의 목록은 LookML 프로젝트 파일 문서 페이지의 프로젝트 파일 유형 섹션을 참조하세요.

모든 뷰 파일을 포함하면 LookML 유효성 검사 성능에 영향을 미치고 데이터베이스 스키마가 복잡해질 수 있으므로 Looker는 와일드 카드를 사용하여 프로젝트의 모든 뷰 파일을 포함하지 않는 것이 좋습니다.

전략적 명명 패턴에 와일드 카드 사용

와일드 카드를 전략적 파일 이름과 함께 사용하여 include 문을 더욱 최적화할 수 있습니다. 예를 들어 다음과 같이 파일 이름을 지정하는 대신

/views/apple.view
/views/banana.view
/views/cherry.view
/views/orange.view
/views/celery.view

다음과 같이 전략적 프리픽스 또는 서픽스를 파일 이름에 추가할 수 있습니다.

/views/apple.fruit.view
/views/banana.fruit.view
/views/cherry.fruit.view
/views/orange.fruit.view
/views/celery.vegetable.view

그런 다음 와일드 카드를 사용하여 다음 include를 사용하여 .fruit 접미사만 참조합니다.

include: "/views/*.fruit.view"

모든 뷰 파일을 포함하면 LookML 검사의 성능에 영향을 미칠 수 있습니다.

프로젝트에 많은 수의 뷰 파일이 있고 이러한 모든 파일을 모델 파일에 포함하면 LookML 검사기의 성능에 영향을 미칠 수 있습니다. LookML 검사기는 모델에 포함된 모든 뷰 파일을 확인하므로 모델 파일의 include 매개변수에 필요한 뷰 파일만 포함해야 합니다.

뷰 파일에 전략적인 명명 규칙을 사용하면 뷰 그룹을 쉽게 포함할 수 있습니다 (이 페이지에 있는 전략적 이름 지정 패턴에 와일드 카드 사용의 예시 참고). 또는 IDE 폴더를 사용하여 보기를 폴더로 정리할 수 있습니다. 그런 다음 프로젝트의 모든 뷰를 포함하는 대신 * 와일드 카드를 사용하여 모든 뷰를 단일 폴더에 포함할 수 있습니다. 자세한 내용은 IDE 폴더에서 include 사용에 관한 문서를 참고하세요.

뷰 파일을 모두 포함하면 데이터베이스 스키마가 복잡해질 수 있습니다.

영구 파생 테이블 (PDT)을 사용하는 프로젝트의 경우 모델 파일에 PDT의 뷰 파일을 포함할 수 있습니다. 그러나 PDT의 뷰 파일이 포함된 각 모델 파일은 데이터베이스의 스크래치 스키마에 PDT의 사본을 만듭니다. 모델 파일이 여러 개 있는데 모델 파일에 모든 뷰 파일을 포함하면 데이터베이스 스크래치 스키마에 불필요한 요소를 추가할 수 있습니다. 따라서 PDT가 필요한 모델 파일에만 PDT의 보기 파일을 포함해야 합니다.