Looker에서 맞춤 캘린더 사용

지원되는 언어의 경우 Looker의 맞춤 캘린더 기능을 사용하면 데이터베이스에서 특정 회계 또는 소매 캘린더와 같은 맞춤 캘린더를 정의한 다음 LookML 모델의 날짜 기반 측정기준 그룹에 캘린더를 적용할 수 있습니다. 그러면 사용자가 custom_week, custom_period과 같은 맞춤 기간을 표준 기간인 것처럼 사용하여 Explore 쿼리를 만들 수 있습니다.

기본 요건

맞춤 캘린더를 사용하기 전에 다음 기본 요건을 충족하는지 확인하세요.

• 맞춤 캘린더를 지원하는 언어에 대한 Looker 연결이 있어야 합니다.
• 데이터베이스에 캘린더 테이블을 만들어야 하며, 이 테이블은 Looker에서 뷰로 모델링할 수 있습니다. Looker는 데이터베이스의 캘린더 표를 사용하여 맞춤 기간을 계산합니다. 자세한 내용은 데이터베이스에 캘린더 테이블 만들기 섹션을 참고하세요.
• LookML 프로젝트에서 새 LookML 런타임을 사용해야 합니다. 인스턴스에서 기존 LookML 런타임 사용 기존 기능을 사용 설정한 경우 프로젝트의 매니페스트 파일에 new_lookml_runtime: yes 문을 추가해야 합니다.

맞춤 캘린더 만들기

맞춤 캘린더를 구현하려면 다음 섹션에 설명된 일반적인 단계를 수행해야 합니다.

1. 데이터베이스에 캘린더 테이블 만들기
2. LookML에서 맞춤 캘린더 뷰 정의하기
3. 맞춤 캘린더 측정기준 그룹 만들기

데이터베이스에 캘린더 테이블 만들기

맞춤 캘린더의 날짜를 계산하려면 데이터베이스에 맞춤 기간을 정의하는 전용 캘린더 테이블이 필요합니다. 표에는 표준 캘린더 날짜를 사용하는 참조 날짜 열이 있어야 합니다. Looker는 참조 날짜 열을 기반으로 캘린더 테이블을 데이터 테이블 (예: orders 테이블)에 조인합니다.

캘린더 표의 열 이름은 유연합니다. LookML에서 맞춤 캘린더 뷰를 정의할 때 calendar_definition 블록을 사용하여 데이터베이스의 열을 표준 맞춤 기간 이름에 매핑합니다.

다음은 fiscal_calendar_table이라는 캘린더 테이블의 예시 테이블 스키마입니다.

예를 들어 fiscal_calendar_table 테이블의 샘플 행은 다음과 같습니다.

LookML에서 맞춤 캘린더 뷰 정의

데이터베이스에 캘린더 테이블을 만든 후 데이터베이스 캘린더 테이블을 모델링하는 LookML 뷰를 만들어야 합니다.

맞춤 캘린더 뷰 파일에는 다음이 포함되어야 합니다.

• 데이터베이스의 맞춤 캘린더 테이블을 가리키는 sql_table_name 매개변수
• 표의 열을 Looker 맞춤 기간 유형에 매핑하는 calendar_definition 블록
• dimension 매개변수를 사용하여 데이터베이스의 맞춤 캘린더 테이블의 열을 모델링합니다.

다음은 예시 fiscal_calendar_table을 모델링하는 fiscal_calendar.view.lkml이라는 뷰 파일의 예입니다.

view: fiscal_calendar {
  sql_table_name: fiscal_calendar_table ;;
  calendar_definition: {
    reference_date: reference_date
    timeframe_mapping: {
      custom_year: fiscal_year
      custom_quarter: fiscal_quarter_of_year
      custom_date: fiscal_date
      custom_week: fiscal_week_of_year
      custom_period: fiscal_period_of_year
      custom_season: season
    }
    timeframe_ordinal_mapping: {
      custom_year: fiscal_year_num
      custom_quarter: fiscal_quarter_of_year_num
      custom_date: fiscal_date_num
      custom_week: fiscal_week_of_year_num
      custom_period: fiscal_period_of_year_num
      custom_season: season_num
    }
  }

  dimension: reference_date {
    type: date
    primary_key: yes
    sql: ${TABLE}.reference_date ;; # Assuming column name is reference_date
  }

  dimension: fiscal_date {
  type: string
  sql: FORMAT_TIMESTAMP('%Y-%m-%d', ${TABLE}.reference_date) ;;
}

  dimension: fiscal_year {
    type: string
    sql: ${TABLE}.fiscal_year ;;
  }

  dimension: fiscal_year_num {
    type: number
    sql: ${TABLE}.fiscal_year_num ;;
  }

  # ... other dimensions for quarters, weeks, periods, seasons, etc. ...

  # Example placeholder dimensions for unused timeframes
  dimension: season {
    type: string
    sql: 'N/A' ;;
    hidden: yes
  }
  dimension: season_num {
    type: number
    sql: 0 ;;
    hidden: yes
  }
}

calendar_definition 매개변수에 관한 자세한 내용은 calendar_definition 매개변수 페이지를 참고하세요.

맞춤 캘린더 측정기준 그룹 만들기

데이터베이스에 캘린더 테이블을 만들고 LookML에서 데이터베이스 캘린더 테이블을 모델링한 후 커스텀 캘린더 뷰를 기반으로 하는 type: custom_calendar 측정기준 그룹을 만들 수 있습니다.

예를 들어 맞춤 캘린더 측정기준 그룹을 정의하는 orders.view.lkml라는 뷰 파일은 다음과 같습니다.

include: "/views/fiscal_calendar.view"

view: orders {
  sql_table_name: public.orders ;;

  dimension_group: created {
    type: custom_calendar

    # Optional list of allowed timeframes
    custom_timeframes: [
      custom_date,
      custom_week,
      custom_year
    ]
    sql: ${TABLE}.created_at ;;
    based_on_calendar: fiscal_calendar  # This links to your calendar view
  }
}

이 LookML을 사용하면 Looker가 created 측정기준 그룹에 대한 새로운 맞춤 기간 세트('생성된 맞춤 연도', '생성된 맞춤 주' 등)를 자동으로 만듭니다. 그러면 사용자가 탐색, 보고, 필터링에 이러한 필드를 사용할 수 있습니다.

맞춤 캘린더의 측정기준 그룹을 만드는 방법에 대한 자세한 내용은 dimension_group 문서 페이지를 참고하세요.

고려사항

맞춤 일정에는 다음과 같은 제한사항이 있습니다.

• 필터링된 측정값: 필터링된 측정값에는 맞춤 캘린더가 지원되지 않습니다. 측정값의 filters 매개변수에서 맞춤 캘린더 측정기준을 참조할 수 없습니다.
• 고급 필터: 고급 필터에서는 맞춤 캘린더가 지원되지 않습니다. Looker 필터 표현식에서 맞춤 캘린더 측정기준을 참조할 수 없습니다.
• 대칭 집계: 일부 복잡한 조인 시나리오에서는 맞춤 캘린더 측정기준이 포함된 쿼리에 대칭 집계가 완전히 지원되지 않을 수 있습니다.
• 측정기준 채우기: Looker는 맞춤 캘린더 측정기준의 누락된 날짜를 측정기준 채우기할 수 없습니다.
• 캘린더 범위를 벗어난 필터링: 캘린더에 없는 날짜가 포함된 맞춤 기간에 필터를 적용하면 예기치 않은 결과가 반환될 수 있습니다. 이는 기간의 시작을 계산하는 데 사용되는 서수 산술과 관련이 있습니다.
• 시간대 변환 동작: Looker는 기존 시간대 변환 시맨틱스를 따릅니다. 즉, 데이터베이스와 쿼리 시간대가 일치하면 시간대 변환이 적용되지 않습니다. 동의하지 않으면 Looker에서 시간대 변환을 적용합니다. 맞춤 캘린더 측정기준 그룹에 convert_tz: no을 지정하여 이 동작을 재정의할 수 있습니다.
• 기본 정렬: 맞춤 캘린더 필드를 선택하면 Looker에서 첫 번째 날짜 필드에 기본 정렬을 적용합니다. 그런 다음 사용자가 다른 데이터 정렬을 지정할 수 있습니다.

맞춤 캘린더에 지원되는 데이터베이스 언어

다음 표에서는 최신 버전의 Looker에서 맞춤 캘린더를 지원하는 언어를 보여줍니다.