NATIVE_DIMENSION

הפונקציה מחזירה את התוצאה של ביטוי SQL ב-BigQuery, כפי שהיא מוערכת על ידי מערך הנתונים הבסיסי.

הפונקציה NATIVE_DIMENSION מאפשרת לכתוב SQL ישירות בשדה Data Studio. האפשרות הזו שימושית לפונקציות שלא נכללות ברשימת הפונקציות, אבל מסד הנתונים שלכם תומך בהן.

הפעלת פונקציות מותאמות

הפונקציות המובנות מושבתות כברירת מחדל, והניהול שלהן מתבצע ברמת מקור הנתונים.

אם אתם הבעלים של מקור נתונים ב-BigQuery, אתם יכולים להפעיל פונקציות מקוריות למקור הנתונים באמצעות השלבים הבאים:

  1. ב-Data Studio, עורכים את מקור הנתונים.
  2. בפינה השמאלית העליונה של העורך של מקור הנתונים, לוחצים על פונקציות מקוריות.
  3. בתיבת הדו-שיח פונקציות מקוריות, בוחרים באפשרות מופעל.
  4. לוחצים על Save.

אם משביתים את הפונקציות המובנות, אף משתמש לא יכול ליצור שדות באמצעות פונקציות מובנות. בנוסף, בכל התרשימים הקיימים שמתייחסים לשדות עם פונקציות מקוריות תוצג שגיאה.

דוגמאות לשימוש

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

תחביר

NATIVE_DIMENSION( expression, type )

פרמטרים

‫expression – ביטוי להערכה על ידי מערך הנתונים הבסיסי. זה יכול להיות כל SQL תקין של BigQuery שיופיע בעמודה אחת של הצהרת SELECT. הביטוי לא יכול לכלול צבירות.

‫type – מחרוזת ליטרלית של סוג נתונים. בקטע הבא מפורטים הסוגים שהפונקציה הזו תומכת בהם.

NATIVE_DIMENSION סוגים

אפשר לבחור מבין הסוגים הבאים:

סוג הנתונים הצפויים דוגמאות לדוחות
STRING אפס או יותר אותיות, מספרים, תווים או סמלים.

A1B2C3

BOOL

ערך לוגי.

true

false

DOUBLE מספר בשיטת נקודה צפה. 1,234.56
INT64 מספר שלם. 1,234
DATE תאריך ביומן.

2020-09-21

DATETIME תאריך ביומן עם שעה. 2020-09-21 12:35 PM
GEOGRAPHY

אוסף של נקודות ומצולעים שתואמים ל סוג הנתונים הגיאוגרפיים ב-BigQuery .

יש תמיכה רק בפונקציות POINT ו- POLYGON של BigQuery.

POINT(32 210)

POLYGON((0 0, 2 2, 2 0, 0 0), (2 2, 3 4, 2 4, 2 2))

אם הביטוי מחזיר סוג נתונים של חותמת זמן, כמו הסוג TIMESTAMP של BigQuery, צריך להשתמש בפונקציה CAST כדי להמיר אותו לסוג DATETIME. לדוגמה:

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

דוגמאות ל-NATIVE_DIMENSION

פונקציות JSON ב-SQL

נניח שהנתונים שלכם כוללים את השדה users_ages_json שהערכים שלו מעוצבים כמטען ייעודי (payload) של JSON. דוגמה לערך בשורה בשדה הזה:

{"name": "Jakob", "age": "26"}

כדי לאחזר את הגיל מ-users_ages_json, משתמשים בפונקציה NATIVE_DIMENSION של BigQuery: JSON_VALUE:

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

בדוגמה הזו, הפונקציה NATIVE_DIMENSION תחזיר את הגיל 26 כמספר שלם.

המגבלות של NATIVE_DIMENSION

מי יכול להשתמש בפונקציות מותאמות

אם הפונקציות המובנות מופעלות, בעלי מקור הנתונים ועורכים יכולים ליצור שדות עם פונקציות מובנות במקור הנתונים.

משתמשים עם הרשאת צפייה במקור הנתונים יכולים להשתמש בשדות עם פונקציות מקוריות בתרשימים. עם זאת, הצופים לא יכולים ליצור שדות חדשים באמצעות פונקציות מקוריות, וגם לא לערוך שדות באמצעות פונקציות מקוריות.

שדות מצטברים

אי אפשר לכלול שדות מצטברים בפרמטר expression.

פונקציות חלון

אי אפשר לכלול פונקציות חלון בפרמטר expression.

תערובות

אי אפשר ליצור שדה באמצעות הפונקציה NATIVE_DIMENSION במקור נתונים משולב.

אבל אפשר ליצור שדה באמצעות הפונקציה הזו לפני המיזוג, ואז להשתמש בשדה הזה במיזוג.

סוגי נתונים של חותמת זמן

אם הביטוי מחזיר סוג נתונים של חותמת זמן, כמו הסוג TIMESTAMP של BigQuery, צריך להשתמש בפונקציה CAST כדי להמיר אותו לסוג DATETIME. לדוגמה:

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