Declare

Declare 문은 필드 또는 함수 간의 관계를 정의할 수 있는 필드 및 그룹 정의를 만드는 데 사용됩니다. 일련의 필드 정의는 차원으로 사용할 수 있는 파생된 필드를 자동으로 생성하는 데 사용할 수 있습니다. 예를 들어, 캘린더 정의를 만들 수 있으며 이를 사용하여 날짜 필드에서 연도, 월, 주, 일 등의 관련 차원을 생성할 수 있습니다.

Declare는 새 필드 정의를 설정하거나 기존 정의에 기반하여 필드 정의를 만들 때 사용할 수 있습니다.

새 필드 정의 설정

Syntax:

definition_name:

Declare [Field[s]] Definition [Tagged tag_list ]

[Parameters parameter_list ]

Fields field_list 

Arguments:

인수 설명
definition_name

필드 정의의 이름이며 콜론으로 끝납니다.

경고: 필드 정의에 대한 이름으로 autoCalendar를 사용하지 마십시오. 이 이름은 자동 생성 캘린더 템플릿용으로 예약되어 있습니다.

Example:  

Calendar:

tag_list

필드 정의에서 파생된 필드에 적용할 태그의 쉼표로 구분된 목록입니다. 태그 적용은 선택 사항이지만, $date, $numeric 또는 $text 등과 같이 정렬 순서를 지정하는 데 사용되는 태그를 적용하지 않으면 파생 필드가 기본적으로 로드 순서에 따라 정렬됩니다.

Example:  

'$date'

필드 태그

parameter_list

쉼표로 구분된 파라메타 목록입니다. 파라메타는 name=value 형식으로 정의되며 필드 정의를 재사용할 때 재정의할 수 있는 시작 값이 할당됩니다. 선택 사항입니다.

Example:  

first_month_of_year = 1

field_list

필드 정의를 사용할 때 생성되는 쉼표로 구분된 필드 목록입니다. 필드는 <expression> As field_name tagged tag 형식으로 정의됩니다. $1을 사용하여, 파생 필드를 생성해야 하는 원본 데이터 필드를 참조합니다.

Example:  

Year($1) As Year tagged '$year'

Example:

Calendar: DECLARE FIELD DEFINITION TAGGED '$date' Parameters first_month_of_year = 1 Fields
Year($1) As Year Tagged ('$numeric'), Month($1) as Month Tagged ('$numeric'), Date($1) as Date Tagged ('$date'), Week($1) as Week Tagged ('$numeric'), Weekday($1) as Weekday Tagged ('$numeric'), DayNumberOfYear($1, first_month_of_year) as DayNumberOfYear Tagged ('$numeric') ;
 

이제 캘린더가 정의되고, 이를 Derive 절을 사용하여 로드된 데이터 필드(이 경우에는 OrderDateShippingDate)에 적용할 수 있습니다.

파생된 필드 (전체 예)

기존 필드 정의 재사용

Syntax:

<definition name>:

Declare [Field][s] Definition

Using <existing_definition> 

[With <parameter_assignment> ]

Arguments:

인수 설명
definition_name

필드 정의의 이름이며 콜론으로 끝납니다.

Example:  

MyCalendar:

existing_definition

새 필드 정의를 만들 때 재사용할 필드 정의입니다. 새로운 필드 정의는, parameter_assignment를 사용하여 필드 표현식에 사용된 값을 변경하는 경우를 제외하고, 해당 정의의 기반으로 사용된 원본 정의와 동일한 방식으로 작동합니다.

Example:  

Using Calendar

parameter_assignment

쉼표로 구분된 파라메타 할당 목록입니다. 파라메타 할당은 name=value 형식으로 정의되며, 기본 필드 정의에 설정된 파라메타 값을 재정의합니다. 선택 사항입니다.

Example:  

first_month_of_year = 4

Example:

이 예에서는 이전 예에서 만든 캘린더 정의를 재사용합니다. 이 사례의 경우 4월에 시작하는 회계년도를 사용하려고 합니다. 이 작업은 값 4를 first_month_of_year 파라메타에 할당하여 수행되며, 정의된 DayNumberOfYear 필드에 영향을 미칠 수 있습니다.

이 예에서는 이전 예의 샘플 데이터와 필드 정의를 사용한다고 가정합니다.

MyCalendar: DECLARE FIELD DEFINITION USING Calendar WITH first_month_of_year=4;
 
DERIVE FIELDS FROM FIELDS OrderDate,ShippingDate USING MyCalendar;
 

데이터 스크립트를 다시 로드하면 OrderDate.MyCalendar.*ShippingDate.MyCalendar.*라는 이름으로 생성된 필드를 시트 편집기에서 사용할 수 있습니다.

See also: