שימוש בפרמטרים באילתא מותאמת אישית

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

פרמטרים רגילים

אפשר להשתמש בפרמטרים הבאים בכל שאילתה מותאמת אישית:

פרמטר

מטרה

@DS_START_DATE

הפונקציה מחזירה את תחילת טווח התאריכים של הדוח.

@DS_END_DATE

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

@DS_USER_EMAIL

מקבל את כתובת האימייל של המשתמש שמחובר לחשבון.

כדי להשתמש בפרמטרים האלה, פועלים לפי השלבים הבאים:

  1. בקטע Parameters (פרמטרים) בחלונית החיבור, מפעילים את הפרמטרים שרוצים להשתמש בהם. כשמפעילים את הפרמטר @DS_USER_EMAIL, מערכת Data Studio מבקשת להעניק גישה לכתובת האימייל.
  2. בשם הפרמטר בשאילתה, צריך להשתמש באותיות רישיות.

מערכת Data Studio מעבירה את כל ערכי הפרמטרים כמחרוזות טקסט. כדי לטפל במחרוזות של פרמטרים כתאריכים קלנדריים, מספרים או סוגי נתונים אחרים, צריך להשתמש בפונקציית המרה מתאימה של SQL, כמו PARSE_DATE,‏ PARSE_TIMESTAMP או CAST.

שימוש בפרמטרים של תאריכים כדי להעביר טווחי תאריכים לשאילתה הבסיסית

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

שימוש בפרמטר האימייל כדי לספק גישה לנתונים ברמת השורה

הפרמטר email מאפשר להציג רק את הנתונים שמשויכים למשתמש המחובר בדוח, במקור נתונים או בניתוח. המשתמש צריך להיות מחובר לחשבון Google ולהסכים למסור את כתובת האימייל שלו ל-Data Studio. אם הצופה לא יאשר את ההסכמה, בכל התרשימים בדוח שמבוססים על מקור הנתונים הזה תוצג שגיאת הרשאה.

פרמטרים מותאמים אישית

אתם יכולים להשתמש בכל הפרמטרים שאתם יוצרים בממשק המשתמש של Data Studio בתוך השאילתה המותאמת אישית.

יצירת פרמטר בדף החיבור

  1. בקטע Parameters (פרמטרים) של עורך השאילתות המותאמות אישית, לוחצים על +ADD PARAMETER (הוספת פרמטר).
  2. מגדירים את אפשרויות הפרמטר.
  3. לוחצים על OK.

הסתרת פרמטרים מותאמים אישית במקור הנתונים

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

  1. לוחצים על אפשרויות נוספות.
  2. לוחצים על הסתרה.

מידע נוסף על הרשאת פרמטרים של מקורות נתונים בדוחות

שימוש בפרמטר בשאילתה מותאמת אישית

בגוף של שאילתת ה-SQL המותאמת אישית, מחליפים ערך שמוגדר בהארדקוד במזהה שמתחיל בתו @ (לדוגמה, @param_name).

דוגמאות לפרמטרים

ריכזנו כאן כמה דוגמאות לשימוש בפרמטרים:

דוגמה לפרמטר מותאם אישית

SELECT word FROM `TABLE` WHERE corpus = @corpus;

מחרוזת עם CONTAINS וערך סף מספרי

SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;

פרמטר מחרוזת עם אפשרות לבחירה מרובה

שימו לב איך UNNEST משטח את רשימת המערכים של ערכי הפרמטרים של בחירה מרובה:

SELECT * from user.users as user WHERE display_name in UNNEST(@name);

פרמטר תאריך בפורמט סטנדרטי

SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);

פרמטר תאריך באמצעות חותמת זמן של מערכת Unix במיקרו-שניות

SELECT creation_date, age, display_name from user.users as use
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE))
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE))

דוגמה לפרמטר של אימייל

SELECT * FROM Sales WHERE sales-rep-email = @DS_USER_EMAIL;