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

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

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

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

פרמטר

מטרה

@DS_START_DATE

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

@DS_END_DATE

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

@DS_USER_EMAIL

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

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

  1. בקטע Parameters (פרמטרים), מפעילים את הפרמטרים שרוצים להשתמש בהם.

  2. בשאילתה, הקפידו להשתמש באותיות רישיות בשמות הפרמטרים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בגוף השאילתה המותאמת אישית, מחליפים ערך שמוגדר בהארדקוד במזהה שמתחיל בתו @. לדוגמה: ‎@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;