NATIVE_DIMENSION

네이티브 함수는 기본적으로 사용 중지되어 있습니다. 네이티브 함수를 사용 설정하는 방법에 대한 안내는 이 도움말의 네이티브 함수 사용 설정하기 섹션을 참고하세요.

NATIVE_DIMENSION 함수를 사용하면 Looker Studio 필드에 SQL을 직접 쓸 수 있습니다. 이는 함수 목록에 없지만 데이터베이스에서 지원되는 함수에 유용합니다. 

이 도움말의 내용은 다음과 같습니다.

• 네이티브 함수 사용 설정하기
• 사용 예
• 문법
• NATIVE_DIMENSION 예
• NATIVE_DIMENSION 제한사항
• 관련 리소스

네이티브 함수 사용 설정하기

네이티브 함수는 기본적으로 사용 중지되어 있으며 데이터 소스 수준에서 관리됩니다.

NATIVE_DIMENSION 함수는 Looker Studio의 BigQuery 기본 통합이 사용 설정된 Google BigQuery 데이터 소스에서만 사용할 수 있습니다.

Google BigQuery 데이터 소스의 소유자는 다음 단계에 따라 데이터 소스에 네이티브 함수를 사용 설정할 수 있습니다.

1. Looker Studio에서 BigQuery 네이티브 통합을 사용 설정합니다.
2. Looker Studio에서 데이터 소스를 수정합니다.
3. 데이터 소스 편집기의 오른쪽 상단에서 네이티브 함수를 클릭합니다.
4. 네이티브 함수 대화상자에서 켜기를 선택합니다.
5. 저장을 클릭합니다.

네이티브 함수를 사용 중지하면 모든 사용자가 네이티브 함수로 필드를 만들 수 없습니다. 또한 네이티브 함수가 있는 필드를 참조하는 기존 차트에는 오류가 표시됩니다. 

사용 예

NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}', '$.name')","STRING")

문법

NATIVE_DIMENSION(표현식, 유형)

매개변수

표현식: 기본 데이터 세트로 평가할 표현식입니다. SELECT 문의 열 하나에 들어갈 수 있는 유효한 Google BigQuery SQL을 사용할 수 있습니다. 표현식에는 집계가 포함될 수 없습니다.

유형: 데이터 유형 리터럴입니다. 이 함수가 지원하는 유형은 다음 섹션을 참고하세요.

NATIVE_DIMENSION 유형

선택할 수 있는 유형은 다음과 같습니다.

유형	예상 데이터	보고서 예
STRING	0개 이상의 글자, 숫자, 문자 또는 기호	A1B2C3
BOOL	논리 값입니다.	true false
DOUBLE	부동 소수점 숫자입니다.	1,234.56
INT64	정수입니다.	1,234
DATE	날짜입니다.	2020-09-21
DATETIME	시간이 포함된 날짜입니다.	2020-09-21 12:35 PM
GEOGRAPHY	BigQuery 지역 데이터 유형에 해당하는 점과 다각형의 모음입니다. BigQuery 함수 POINT 및 POLYGON만 지원됩니다.	POINT(32 210)   POLYGON((0 0, 2 2, 2 0, 0 0), (2 2, 3 4, 2 4, 2 2))

 

표현식이 BigQuery의 TIMESTAMP 유형과 같은 타임스탬프 데이터 유형을 반환하는 경우 CAST 함수를 사용하여 DATETIME 유형으로 변환하세요. 예를 들면 다음과 같습니다.

NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")

표현식이 ARRAY, STRUCT, JSON과 같이 지원되지 않는 데이터 유형을 반환하는 경우 Looker Studio에서 오류가 반환됩니다.

NATIVE_DIMENSION 예

SQL의 JSON 함수

데이터에 JSON 페이로드 형식으로 값이 지정된 users_ages_json 필드가 포함되어 있다고 가정해 보겠습니다. 이 필드에서 나타날 수 있는 행 값의 예시는 다음과 같습니다.

{"이름": "제이컵", "연령": "26"}

 

BigQuery의 JSON_VALUE 함수를 사용하여 NATIVE_DIMENSION 함수로 users_ages_json에서 연령을 가져옵니다.

NATIVE_DIMENSION("JSON_VALUE(user_ages_json, '$.age')","INT64")

이 행 값의 예에서 NATIVE_DIMENSION 함수는 연령 26을 정수로 반환합니다.

NATIVE_DIMENSION 제한사항

지원되는 데이터 소스

NATIVE_DIMENSION 함수는 Looker Studio의 BigQuery 기본 통합이 사용 설정된 Google BigQuery 데이터 소스에서만 사용할 수 있습니다.

네이티브 함수를 사용할 수 있는 사용자

네이티브 함수가 사용 설정된 경우 데이터 소스의 소유자와 편집자는 데이터 소스에서 네이티브 함수가 있는 필드를 만들 수 있습니다.

데이터 소스의 보기 권한 사용자는 차트의 네이티브 함수가 있는 필드를 사용할 수 있습니다. 그러나 보기 권한 사용자는 네이티브 함수를 사용하여 새 필드를 만들거나 네이티브 함수를 사용하여 필드를 수정할 수 없습니다.

집계 필드

표현식 매개변수에는 집계된 필드를 include any할 수 없습니다.

윈도우 함수

표현식 매개변수에는 윈도우 함수를 include any할 수 없습니다.

혼합

혼합 데이터 소스에서는 NATIVE_DIMENSION 함수로 필드를 만들 수 없습니다.

그러나 혼합하기 전에 이 함수를 사용하여 필드를 만든 다음 혼합에서 사용할 수 있습니다.

TIMESTAMP 데이터 유형

표현식이 BigQuery의 TIMESTAMP 유형과 같은 타임스탬프 데이터 유형을 반환하는 경우 CAST 함수를 사용하여 DATETIME 유형으로 변환하세요. 예를 들면 다음과 같습니다.

NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")

관련 리소스

• 날짜 및 시간
• 계산된 필드
• Looker Studio 함수 목록

• CAST 함수