Declare 문은 필드 또는 함수 간의 관계를 정의할 수 있는 필드 정의를 만드는 데 사용됩니다. 일련의 필드 정의는 차원으로 사용할 수 있는 파생된 필드를 자동으로 생성하는 데 사용할 수 있습니다. 예를 들어, 캘린더 정의를 만들 수 있으며 이를 사용하여 날짜 필드에서 연도, 월, 주, 일 등의 관련 차원을 생성할 수 있습니다.
Declare는 새 필드 정의를 설정하거나 기존 정의에 기반하여 필드 정의를 만들 때 사용할 수 있습니다.
새 필드 정의 설정
구문:
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
인수:
| 인수 | 설명 |
|---|---|
| definition_name | 필드 정의의 이름이며 콜론으로 끝납니다. 경고 메모필드 정의에 대한 이름으로 autoCalendar를 사용하지 마십시오. 이 이름은 자동 생성 캘린더 템플릿용으로 예약되어 있습니다.
Calendar: |
| tag_list | 필드 정의에서 파생된 필드에 적용할 태그의 쉼표로 구분된 목록입니다. 태그 적용은 선택 사항이지만, $date, $numeric 또는 $text 등과 같이 정렬 순서를 지정하는 데 사용되는 태그를 적용하지 않으면 파생 필드가 기본적으로 로드 순서에 따라 정렬됩니다.
'$date'Thank you for bringing this to our attention, and apologies for the inconvenience. |
| parameter_list | 쉼표로 구분된 매개 변수 목록입니다. 매개 변수는 name=value 형식으로 정의되며 필드 정의를 재사용할 때 재정의할 수 있는 시작 값이 할당됩니다. 선택 사항입니다.
first_month_of_year = 1 |
| field_list | 필드 정의를 사용할 때 생성되는 쉼표로 구분된 필드 목록입니다. 필드는 <expression> As field_name tagged tag 형식으로 정의됩니다. $1을 사용하여, 파생 필드를 생성해야 하는 원본 데이터 필드를 참조합니다.
Year($1) As Year tagged ('$numeric') |
이제 캘린더가 정의되고, 이를 Derive 절을 사용하여 로드된 데이터 필드(이 경우에는 OrderDate 및 ShippingDate)에 적용할 수 있습니다.
파생 필드 (전체 예)
기존 필드 정의 재사용
구문:
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
인수:
| 인수 | 설명 |
|---|---|
| definition_name | 필드 정의의 이름이며 콜론으로 끝납니다.
MyCalendar: |
| existing_definition | 새 필드 정의를 만들 때 재사용할 필드 정의입니다. 새로운 필드 정의는, parameter_assignment를 사용하여 필드 표현식에 사용된 값을 변경하는 경우를 제외하고, 해당 정의의 기반으로 사용된 원본 정의와 동일한 방식으로 작동합니다.
Using Calendar |
| parameter_assignment | 쉼표로 구분된 매개 변수 할당 목록입니다. 매개 변수 할당은 name=value 형식으로 정의되며, 기본 필드 정의에 설정된 매개 변수 값을 재정의합니다. 선택 사항입니다.
first_month_of_year = 4 |
이 예에서는 이전 예에서 만든 캘린더 정의를 재사용합니다. 이 사례의 경우 4월에 시작하는 회계년도를 사용하려고 합니다. 이 작업은 값 4를 first_month_of_year 매개 변수에 할당하여 수행되며, 정의된 DayNumberOfYear 필드에 영향을 미칠 수 있습니다.
이 예에서는 이전 예의 샘플 데이터와 필드 정의를 사용한다고 가정합니다.
데이터 스크립트를 다시 로드하면 OrderDate.MyCalendar.* 및 ShippingDate.MyCalendar.*라는 이름으로 생성된 필드를 시트 편집기에서 사용할 수 있습니다.