פונקציות ואופרטורים של Looker

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

אם האדמין העניק לכם הרשאות ליצירת שדות בהתאמה אישית, תוכלו להשתמש בתכונות הבאות כדי לבצע במהירות פונקציות נפוצות בלי ליצור ביטויי Looker:

ביטויי Looker (לפעמים נקראים Lexp) משמשים לביצוע חישובים של:

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

חלק מהפונקציות זמינות רק לחישובים בטבלה

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

הדף הזה מאורגן כך שקל להבין אילו פונקציות ואילו אופרטורים זמינים, בהתאם למקום שבו משתמשים בביטוי Looker.

פונקציות ואופרטורים מתמטיים

פונקציות ואופרטורים מתמטיים פועלים באחת משתי דרכים:

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

פונקציות לכל ביטוי של Looker

תפקיד תחביר מטרה
abs abs(value) מחזירה את הערך המוחלט של value.

דוגמה אפשר לראות בפוסט לקהילה בנושא Standard Deviation and Simple Time Series Outlier Detection Using Table Calculations (סטיית תקן וזיהוי פשוט של חריגים בסדרות זמן באמצעות חישובים בטבלה).
ceiling ceiling(value) הפונקציה מחזירה את המספר השלם הקטן ביותר שגדול מ-value או שווה לו.
exp exp(value) הפונקציה מחזירה את הערך של e בחזקת value.
floor floor(value) הפונקציה מחזירה את המספר השלם הגדול ביותר שקטן מ-value או שווה לו.
ln ln(value) הפונקציה מחזירה את הלוגריתם הטבעי של value.
log log(value) מחזירה את הלוגריתם של value לפי בסיס 10.
mod mod(value, divisor) מחזירה את השארית של חילוק value ב-divisor.
power power(base, exponent) הפונקציה מחזירה את הערך של base בחזקת exponent.

דוגמה אפשר לראות בפוסט לקהילה בנושא Standard Deviation and Simple Time Series Outlier Detection Using Table Calculations (סטיית תקן וזיהוי פשוט של חריגים בסדרות זמן באמצעות חישובים בטבלה).
rand rand() הפונקציה מחזירה מספר אקראי בין 0 ל-1.
round round(value, num_decimals) הפונקציה מחזירה את הערך value מעוגל ל-num_decimals מקומות עשרוניים.

דוגמאות לשימוש ב-round אפשר למצוא בפוסטים בקהילה בנושא שימוש ב-pivot_index בחישובים בטבלה וזיהוי חריגות בסדרות זמן פשוטות באמצעות חישובים בטבלה.
sqrt sqrt(value) הפונקציה מחזירה את השורש הריבועי של value.

דוגמה אפשר לראות בפוסט לקהילה בנושא Standard Deviation and Simple Time Series Outlier Detection Using Table Calculations (סטיית תקן וזיהוי פשוט של חריגים בסדרות זמן באמצעות חישובים בטבלה).

פונקציות לחישובים בטבלה בלבד

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

תפקיד תחביר מטרה
acos acos(value) הפונקציה מחזירה את היפוך הקוסינוס של value.
asin asin(value) מחזירה את היפוך הסינוס של value.
atan atan(value) הפונקציה מחזירה את היפוך הטנגנס של value.
beta_dist beta_dist(value, alpha, beta, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות בטא עם הפרמטרים alpha ו-beta. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
beta_inv beta_inv(probability, alpha, beta) הפונקציה מחזירה את המיקום של probability בהתפלגות בטא מצטברת הפוכה עם הפרמטרים alpha ו-beta.
binom_dist binom_dist(num_successes, num_tests, probability, cumulative) הפונקציה מחזירה את ההסתברות לקבלת num_successes הצלחות ב-num_tests ניסיונות עם probability הצלחה נתונה. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
binom_inv binom_inv(num_tests, test_probability, target_probability) הפונקציה מחזירה את המספר הקטן ביותר k כך ש-binom(k, num_tests, test_probability, yes) >= target_probability.
chisq_dist chisq_dist(value, dof, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות הגאמה עם dof דרגות חופש. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
chisq_inv chisq_inv(probability, dof) הפונקציה מחזירה את המיקום של probability בהתפלגות הגאמה המצטברת ההפוכה עם dof דרגות חופש.
chisq_test chisq_test(actual, expected) הפונקציה מחזירה את ההסתברות לפי מבחן חי בריבוע לבדיקת אי-תלות בין נתוני actual ו-expected. ‫actual יכול להיות עמודה או עמודה של רשימות, ו-expected חייב להיות מאותו סוג.
combin combin(set_size, selection_size) הפונקציה מחזירה את מספר הדרכים לבחירת selection_size רכיבים מתוך קבוצה בגודל set_size.
confidence_norm confidence_norm(alpha, stdev, n) הפונקציה מחזירה את מחצית הרוחב של רווח בר-סמך נורמלי ברמת מובהקות alpha, סטיית תקן stdev וגודל מדגם n.
confidence_t confidence_t(alpha, stdev, n) הפונקציה מחזירה את מחצית הרוחב של הרווח בר-סמך של התפלגות t של סטודנט ברמת מובהקות alpha, סטיית תקן stdev וגודל מדגם n.
correl correl(column_1, column_2) הפונקציה מחזירה את מקדם המתאם של column_1 ו-column_2.
cos cos(value) הפונקציה מחזירה את הקוסינוס של value.
count count(expression) הפונקציה מחזירה את מספר הערכים שאינם null בעמודה שמוגדרת על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את המספר בכל רשימה.
count_distinct count_distinct(expression) הפונקציה מחזירה את מספר הערכים הייחודיים שאינם null בעמודה שמוגדרת על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את המספר בכל רשימה.
covar_pop covar_pop(column_1, column_2) הפונקציה מחזירה את השונות המשותפת של האוכלוסייה של column_1 ו-column_2.
covar_samp covar_samp(column_1, column_2) הפונקציה מחזירה את השונות המשותפת המדגמית של column_1 ו-column_2.
degrees degrees(value) הפונקציה ממירה את value מרדיאנים למעלות.
expon_dist expon_dist(value, lambda, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות המעריכית עם הפרמטר lambda. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
f_dist f_dist(value, dof_1, dof_2, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות F עם הפרמטרים dof_1 ו-dof_2. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
f_inv f_inv(probability, dof_1, dof_2) הפונקציה מחזירה את המיקום של probability בהתפלגות ההופכי של F המצטברת עם הפרמטרים dof_1 ו-dof_2.
fact fact(value) הפונקציה מחזירה את העצרת של value.
gamma_dist gamma_dist(value, alpha, beta, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות הגאמה עם הפרמטרים alpha ו-beta. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
gamma_inv gamma_inv(probability, alpha, beta) הפונקציה מחזירה את המיקום של probability בהתפלגות הגאמה המצטברת ההפוכה עם הפרמטרים alpha ו-beta.
geomean geomean(expression) הפונקציה מחזירה את הממוצע הגיאומטרי של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את הממוצע הגיאומטרי של כל רשימה.
hypgeom_dist hypgeom_dist(sample_successes, sample_size, population_successes, population_size, cumulative) הפונקציה מחזירה את ההסתברות לקבלת sample_successes מתוך sample_size, מספר population_successes ו-population_size. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
intercept intercept(y_column, x_column) הפונקציה מחזירה את נקודת החיתוך של קו הרגרסיה הלינארית עם הצירים, דרך הנקודות שנקבעו על ידי y_column ו-x_column.

דוגמה אפשר לראות בפוסט לקהילה How to Forecast in Looker with Table Calculations.
kurtosis kurtosis(expression) הפונקציה מחזירה את האקסס קורטוזיס של המדגם של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את האקסס קורטוזיס של המדגם של כל רשימה.
large large(expression, k) הפונקציה מחזירה את הערך הגדול ביותר ה-k בעמודה שנוצרה על ידי expression, אלא אם expression מגדיר עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הערך הגדול ביותר ה-k בכל רשימה.
match match(value, expression) הפונקציה מחזירה את מספר השורה של המופע הראשון של value בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את המיקום של value בכל רשימה.
max max(expression) הפונקציה מחזירה את הערך המקסימלי בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הערך המקסימלי בכל רשימה.

דוגמאות לשימוש בפונקציה max מופיעות בפוסטים בקהילה בנושא שימוש ברשימות בחישובים בטבלה וקיבוץ לפי מאפיין בחישובים בטבלה.
mean mean(expression) הפונקציה מחזירה את הממוצע של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את הממוצע של כל רשימה.

דוגמאות לשימוש ב-mean אפשר למצוא בפוסטים לקהילה בנושא חישוב ממוצעים נעים וזיהוי חריגות בסדרות זמן פשוטות באמצעות חישובים בטבלה.
median median(expression) הפונקציה מחזירה את החציון של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה היא מחזירה את החציון של כל רשימה.
min min(expression) הפונקציה מחזירה את הערך המינימלי בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הערך המינימלי בכל רשימה.
mode mode(expression) הפונקציה מחזירה את הערך השכיח של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את הערך השכיח של כל רשימה.
multinomial multinomial(value_1, value_2, ...) מחזירה את העצרת של סכום הארגומנטים חלקי המכפלה של העצרות של כל אחד מהם.
negbinom_dist negbinom_dist(num_failures, num_successes, probability, cumulative) הפונקציה מחזירה את ההסתברות לקבלת num_failures כישלונות לפני קבלת num_successes הצלחות, בהינתן probability ההסתברות להצלחה. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
norm_dist norm_dist(value, mean, stdev, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות הנורמלית עם הערכים הנתונים mean ו-stdev. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
norm_inv norm_inv(probability, mean, stdev) הפונקציה מחזירה את המיקום של probability בהופכי של ההתפלגות הנורמלית המצטברת.
norm_s_dist norm_s_dist(value, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות הנורמלית הסטנדרטית. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
norm_s_inv norm_s_inv(probability) הפונקציה מחזירה את המיקום של probability בהופכי של ההתפלגות הנורמלית הסטנדרטית המצטברת.
percent_rank percent_rank(column, value) הפונקציה מחזירה את הדירוג של value ב-column כאחוז מ-0 עד 1 כולל, כאשר column היא העמודה, השדה, הרשימה או הטווח שמכילים את מערך הנתונים לבדיקה, ו-value היא העמודה עם הערך שלפיו ייקבע דירוג האחוז.

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

percent_rank(${view_name.field_1}, ${view_name.field_1})

percent_rank(list(1, 2, 3), ${view_name.field_1})

percent_rank(list(1, 2, 3), 2)
percentile percentile(expression, percentile_value) הפונקציה מחזירה את הערך מהעמודה שנוצרה על ידי expression שמתאים ל-percentile_value הנתון, אלא אם expression מגדיר עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את ערך האחוזון של כל רשימה. הערך percentile_value חייב להיות בין 0 ל-1, אחרת הפונקציה מחזירה null.
pi pi() הפונקציה מחזירה את הערך של פאי.
poisson_dist poisson_dist(value, lambda, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות פואסון עם הפרמטר lambda. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
product product(expression) הפונקציה מחזירה את המכפלה של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את המכפלה של כל רשימה.
radians radians(value) ממירה את value ממעלות לרדיאנים.
rank rank(value, expression) הפונקציה מחזירה את הדירוג של value בעמודה שנוצרה על ידי expression. לדוגמה, אם רוצים לדרג הזמנות לפי מחיר המכירה הכולל שלהן, אפשר להשתמש בפונקציה rank(${order_items.total_sale_price},${order_items.total_sale_price}), שמחזירה דירוג לכל ערך של order_items.total_sale_price בשאילתה, בהשוואה לעמודה כולה של order_items.total_sale_price בשאילתה. אם expression מגדיר כמה רשימות, הפונקציה הזו מחזירה את הגודל היחסי של value בכל רשימה.

דוגמה אפשר לראות בפוסט לקהילה בנושא דירוגים עם חישובים בטבלה.
rank_avg rank_avg(value, expression) הפונקציה מחזירה את הדירוג הממוצע של value בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הדירוג הממוצע של value בכל רשימה.
running_product running_product(value_column) הפונקציה מחזירה את המכפלה המצטברת של הערכים בטווח value_column.
running_total running_total(value_column) מחזירה סכום מצטבר של הערכים ב-value_column.

דוגמה מופיעה בדף השיטות המומלצות בנושא יצירת סכום מצטבר בעמודות באמצעות חישובים בטבלה.
sin sin(value) הפונקציה מחזירה את הסינוס של value.
skew skew(expression) הפונקציה מחזירה את מדד ההטיה של המדגם של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את מדד ההטיה של המדגם של כל רשימה.
slope slope(y_column, x_column) הפונקציה מחזירה את שיפוע קו הרגרסיה הלינארית שעובר דרך הנקודות שנקבעו על ידי y_column ו-x_column.

דוגמה אפשר לראות בפוסט לקהילה How to Forecast in Looker with Table Calculations.
small small(expression, k) הפונקציה מחזירה את הערך הקטן ביותר ה-k בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הערך הקטן ביותר ה-k בכל רשימה.
stddev_pop stddev_pop(expression) הפונקציה מחזירה את סטיית התקן (אוכלוסייה) של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את סטיית התקן (אוכלוסייה) של כל רשימה.
stddev_samp stddev_samp(expression) הפונקציה מחזירה את סטיית התקן (מדגם) של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה היא מחזירה את סטיית התקן (מדגם) של כל רשימה.
sum sum(expression) מחזירה את הסכום של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה מחזירה את הסכום של כל רשימה.

דוגמאות לשימוש ב-sum מופיעות במאמרים סיכום נתונים בשורות (סך הכל של שורה) בחישובים בטבלה ושיטות מומלצות לחישוב אחוז מסך הכולל.
t_dist t_dist(value, dof, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות t של סטודנט עם dof דרגות חופש. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
t_inv t_inv(probability, dof) הפונקציה מחזירה את המיקום של probability בהתפלגות הנורמלית המצטברת ההפוכה עם dof דרגות חופש.
t_test t_test(column_1, column_2, tails, type) הפונקציה מחזירה את התוצאה של מבחן t של סטודנט על הנתונים מ-column_1 ו-column_2, באמצעות 1 או 2 tails. ‫type: 1 = מזווג, 2 = הומוסקדסטי, 3 = הטרוסקדסטי.
tan tan(value) הפונקציה מחזירה את הטנגנס של value.
var_pop var_pop(expression) הפונקציה מחזירה את השונות (אוכלוסייה) של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את השונות (אוכלוסייה) של כל רשימה.
var_samp var_samp(expression) הפונקציה מחזירה את השונות (מדגם) של העמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות, ובמקרה כזה הפונקציה מחזירה את השונות (מדגם) של כל רשימה.
weibull_dist weibull_dist(value, shape, scale, cumulative) הפונקציה מחזירה את המיקום של value בהתפלגות Weibull עם הפרמטרים shape ו-scale. אם cumulative = yes, מחזירה את ההסתברות המצטברת.
z_test z_test(data, value, stdev) מחזירה ערך p חד-זנבי של מבחן Z באמצעות data ו-stdev הקיימים על הממוצע המשוער value.

אופרטורים לכל ביטוי של Looker

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

אופרטור תחביר מטרה
+ value_1 + value_2 כולל value_1 וvalue_2.
- value_1 - value_2 מפחיתה את value_2 מ-value_1.
* value_1 * value_2 מכפיל את value_1 ב-value_2.
/ value_1 / value_2 מחלק את value_1 ב-value_2.

פונקציות מחרוזת

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

פונקציות לכל ביטוי של Looker

תפקיד תחביר מטרה
concat concat(value_1, value_2, ...) הפונקציה מחזירה את הערכים value_1, ‏ value_2, ‏ ..., ‏ value_n כמחרוזת אחת.
contains contains(string, search_string) הפונקציה מחזירה Yes אם string מכיל את search_string, ואחרת היא מחזירה No. הפונקציה contains היא תלוית אותיות רישיות (case-sensitive).
length length(string) הפונקציה מחזירה את מספר התווים ב-string.
lower lower(string) הפונקציה מחזירה את המחרוזת string אחרי שכל התווים הומרו לאותיות קטנות.
position position(string, search_string) הפונקציה מחזירה את אינדקס ההתחלה של search_string ב-string אם הוא קיים, ואת הערך 0 אם הוא לא קיים.
replace replace(string, old_string, new_string) הפונקציה מחזירה את string עם כל המופעים של old_string שהוחלפו ב-new_string.
substring substring(string, start_position, length) הפונקציה מחזירה את מחרוזת המשנה של string, שמתחילה בתו start_position ומורכבת מ-length תווים. הפרמטר start_position מתחיל ב-1, כאשר 1 מציין את התו הראשון במחרוזת, 2 מציין את התו השני במחרוזת וכן הלאה.
upper upper(string) הפונקציה מחזירה את המחרוזת string עם כל התווים שהומרו לאותיות גדולות.

פונקציות לחישובים בטבלה בלבד

תפקיד תחביר מטרה
split split(string, delimeter) הפונקציה מחזירה רשימה של מחרוזות ב-string, שמופרדות באמצעות delimiter.
to_number to_number(string) הפונקציה מחזירה את המספר שמיוצג על ידי string, או null אם אי אפשר להמיר את המחרוזת.
to_string to_string(value) הפונקציה מחזירה את הייצוג של value כמחרוזת, או מחרוזת ריקה אם value הוא null.

פונקציות של תאריך

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

פונקציות לכל ביטוי של Looker

תפקיד תחביר מטרה
add_days add_days(number, date) הוספה של number ימים ל-date.
add_hours add_hours(number, date) הוספת number שעות ל-date.
add_minutes add_minutes(number, date) הוספה של number דקות לטיימר date.
add_months add_months(number, date) כולל number חודשים של date.
add_seconds add_seconds(number, date) הוספה של number שניות ל-date.
add_years add_years(number, date) הפונקציה מוסיפה number שנים ל-date.
date date(year, month, day) הפונקציה מחזירה את התאריך year-month-day או את הערך null אם התאריך לא תקין.
date_time date_time(year, month, day, hours, minutes, seconds) הפונקציה מחזירה את year-month-day hours:minutes:seconds התאריך או את null אם התאריך לא תקין.
diff_days diff_days(start_date, end_date) הפונקציה מחזירה את מספר הימים בין start_date ל-end_date.

דוגמה מופיעה בפוסט בקהילה בנושא שימוש בתאריכים בחישובים בטבלה.
diff_hours diff_hours(start_date, end_date) הפונקציה מחזירה את מספר השעות בין start_date ל-end_date.
diff_minutes diff_minutes(start_date, end_date) הפונקציה מחזירה את מספר הדקות בין start_date ל-end_date.

דוגמה מופיעה בפוסט בקהילה בנושא שימוש בתאריכים בחישובים בטבלה.
diff_months diff_months(start_date, end_date) הפונקציה מחזירה את מספר החודשים בין start_date ל-end_date.

דוגמה אפשר לראות בפוסט בקהילה בנושא קיבוץ לפי מאפיין בחישובים בטבלה.
diff_seconds diff_seconds(start_date, end_date) הפונקציה מחזירה את מספר השניות בין start_date ל-end_date.
diff_years diff_years(start_date, end_date) הפונקציה מחזירה את מספר השנים בין start_date ל-end_date.
extract_days extract_days(date) הפונקציה מחלצת את הימים מה-date.

דוגמה מופיעה בפוסט בקהילה בנושא שימוש בתאריכים בחישובים בטבלה.
extract_hours extract_hours(date) הפונקציה מחלצת את השעות מה-date.
extract_minutes extract_minutes(date) הפונקציה מחלצת את הדקות מה-date.
extract_months extract_months(date) הפונקציה מחלצת את החודשים מ-date.
extract_seconds extract_seconds(date) הפונקציה מחלצת את השניות מ-date.
extract_years extract_years(date) הפונקציה מחלצת את השנים מה-date.
now now() מחזירה את התאריך והשעה הנוכחיים.

דוגמאות לשימוש ב-now אפשר למצוא בפוסט בקהילה בנושא פונקציית החישוב בטבלה Now() כוללת טיפול משופר באזורי זמן ובפוסט בקהילה בנושא שימוש בתאריכים בחישובים בטבלה.
trunc_days trunc_days(date) הפונקציה מעגלת את date למספר הימים.
trunc_hours trunc_hours(date) הפונקציה מעגלת את date לשעות.
trunc_minutes trunc_minutes(date) הערך date מעוגל לדקות.
trunc_months trunc_months(date) הפונקציה מעגלת את date לחודשים.
trunc_years trunc_years(date) הפונקציה מקצרת את date לשנים.

פונקציות לחישובים בטבלה בלבד

תפקיד תחביר מטרה
to_date to_date(string) הפונקציה מחזירה את התאריך והשעה שמתאימים ל-string (YYYY,‏ YYYY-MM,‏ YYYY-MM-DD,‏ YYYY-MM-DD hh,‏ YYYY-MM-DD hh:mm או YYYY-MM-DD hh:mm:ss).

פונקציות, אופרטורים וקבועים לוגיים

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

פונקציות לכל ביטוי של Looker

תפקיד תחביר מטרה
case case(when(yesno_arg, value_if_yes), when(yesno_arg, value_if_yes), ..., else_value) נוסף ב-21.10 מאפשר לוגיקה מותנית עם כמה תנאים ותוצאות. הפונקציה מחזירה value_if_yes עבור המקרה הראשון when שהערך yesno_arg שלו הוא yes. הפונקציה מחזירה את הערך else_value אם כל המקרים when הם no.
coalesce coalesce(value_1, value_2, ...) הפונקציה מחזירה את הערך הראשון שאינו null ב-value_1,‏ value_2,‏ ...,‏ value_n אם נמצא כזה, אחרת היא מחזירה null.

דוגמאות לשימוש בפונקציה coalesce אפשר למצוא בפוסטים הבאים בקהילה: יצירת סכום מצטבר בשורות באמצעות חישובים בטבלה, יצירת אחוז מהסכום הכולל בשורות באמצעות חישובים בטבלה ושימוש בפונקציה pivot_index בחישובים בטבלה.
if if(yesno_expression, value_if_yes, value_if_no) אם הערך של yesno_expression הוא Yes, הפונקציה מחזירה את הערך value_if_yes. אחרת, הפונקציה מחזירה את הערך של value_if_no.

דוגמה אפשר לראות בפוסט בקהילה בנושא קיבוץ לפי מאפיין בחישובים בטבלה.
is_null is_null(value) הפונקציה מחזירה Yes אם value הוא null, ומחזירה No אחרת.

דוגמה מופיעה בדף התיעוד בנושא יצירת ביטויים ב-Looker. דוגמה נוספת לשימוש ב-is_null עם האופרטור NOT מופיעה בדף התיעוד בנושא שימוש בחישובים בטבלה.

אופרטורים לכל ביטוי של Looker

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

אופרטור תחביר מטרה
= value_1 = value_2 הפונקציה מחזירה Yes אם value_1 שווה ל-value_2, ו-No אחרת.
!= value_1 != value_2 הפונקציה מחזירה Yes אם value_1 לא שווה ל-value_2, ו-No אחרת.

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

אופרטור תחביר מטרה
> value_1 > value_2 הפונקציה מחזירה Yes אם value_1 גדול מ-value_2, ו-No אחרת.
< value_1 < value_2 מחזירה Yes אם value_1 קטן מ-value_2, ומחזירה No אחרת.
>= value_1 >= value_2 הפונקציה מחזירה Yes אם value_1 גדול מ-value_2 או שווה לו, ומחזירה No אחרת.
<= value_1 <= value_2 הפונקציה מחזירה Yes אם value_1 קטן מ-value_2 או שווה לו, ומחזירה No בכל מקרה אחר.

אפשר גם לשלב ביטויים של Looker עם האופרטורים הלוגיים הבאים:

אופרטור תחביר מטרה
AND value_1 AND value_2 הפונקציה מחזירה Yes אם גם value_1 וגם value_2 הם Yes, ומחזירה No אחרת.
OR value_1 OR value_2 הפונקציה מחזירה Yes אם value_1 או value_2 הם Yes, ומחזירה No אחרת.
NOT NOT value הפונקציה מחזירה Yes אם value הוא No, ומחזירה No אחרת.

האופרטורים הלוגיים האלה חייבים להיות באותיות רישיות. אופרטורים לוגיים שכתובים באותיות קטנות לא יפעלו.

קבועים לוגיים

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

יציבות משמעות
yes נכון
no לא נכון
null ללא ערך

שימו לב שהקבועים yes ו-no הם הסמלים המיוחדים שמשמעותם True או False בביטויי Looker. לעומת זאת, שימוש במירכאות כמו ב-"yes" וב-"no" יוצר מחרוזות ליטרליות עם הערכים האלה.

הערך של ביטויים לוגיים הוא True או False, בלי שנדרשת הפונקציה if. לדוגמה:

if(${field} > 100, yes, no)

שווה לביטוי הבא:

${field} > 100

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

if(${field} < 1, null, ${field})

שילוב של האופרטורים AND ו-OR

האופרטורים AND מוערכים לפני האופרטורים OR, אלא אם מציינים את הסדר באמצעות סוגריים. לכן, הביטוי הבא ללא סוגריים נוספים:

if (
  ${order_items.days_to_process}>=4 OR
  ${order_items.shipping_time}>5 AND
  ${order_facts.is_first_purchase},
"review", "okay")

הערך שיתקבל יהיה:

if (
  ${order_items.days_to_process}>=4 OR
  (${order_items.shipping_time}>5 AND ${order_facts.is_first_purchase}),
"review", "okay")

פונקציות מיקום

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

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

אם הניתוח כולל סיכומים, תוכלו להפנות לערכים הכוללים של העמודות והשורות:

תפקיד תחביר מטרה
:total ${field:total} הפונקציה מחזירה את סכום העמודה של השדה.
:row_total ${field:row_total} הפונקציה מחזירה את סכום השורה של השדה.

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

תפקיד תחביר מטרה
index index(expression, n) הפונקציה מחזירה את הערך של הרכיב ה-n בעמודה שנוצרה על ידי expression, אלא אם expression מגדירה עמודה של רשימות. במקרה כזה, הפונקציה מחזירה את הרכיב ה-n בכל רשימה.
list list(value_1, value_2, ...) יוצרת רשימה מהערכים שצוינו.

לדוגמה, אפשר לעיין בפוסט בקהילה בנושא שימוש ברשימות בחישובים בטבלה.
lookup lookup(value, lookup_column, result_column) הפונקציה מחזירה את הערך ב-result_column שנמצא באותה שורה שבה נמצא value ב-lookup_column.
offset offset(column, row_offset) הפונקציה מחזירה את הערך של שורה (n + row_offset) ב-column, כאשר n הוא מספר השורה הנוכחי.

דוגמאות לשימוש ב-offset מופיעות בדף השיטות המומלצות בנושא חישוב אחוז מהערך הקודם ואחוז השינוי באמצעות חישובים בטבלה.
offset_list offset_list(column, row_offset, num_values) מחזירה רשימה של הערכים num_values החל משורה (n + row_offset) ב-column, כאשר n הוא מספר השורה הנוכחי.

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

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

תפקיד תחביר מטרה
pivot_column pivot_column() הפונקציה מחזירה את האינדקס של עמודת הציר הנוכחית.
pivot_index pivot_index(expression, pivot_index) הפונקציה מחשבת את expression בהקשר של עמודת הציר במיקום pivot_index (1 לציר הראשון, 2 לציר השני וכן הלאה). הפונקציה מחזירה ערך null לתוצאות לא מוצגות.

דוגמאות לשימוש ב-pivot_index מופיעות בפוסטים בקהילה בנושא שימוש ב-pivot_index בחישובים בטבלה ויצירת אחוז מהסך הכולל בשורות באמצעות חישובים בטבלה.
pivot_offset pivot_offset(pivot_expression, col_offset) הפונקציה מחזירה את הערך של pivot_expression במיקום (n + col_offset), כאשר n הוא המיקום הנוכחי של עמודת הציר. הפונקציה מחזירה ערך null לתוצאות לא מוצגות.

דוגמאות לשימוש ב-pivot_offset אפשר למצוא בפוסט בקהילה בנושא יצירת סכום מצטבר בשורות באמצעות חישובים בטבלה ובדף השיטות המומלצות בנושא חישוב אחוז מהערך הקודם ושינוי באחוזים באמצעות חישובים בטבלה.
pivot_offset_list pivot_offset_list(pivot_expression, col_offset, num_values) הפונקציה מחזירה רשימה של num_values ערכים ב-pivot_expression החל ממיקום (n + col_offset), כאשר n הוא אינדקס הציר הנוכחי. הפונקציה מחזירה null לתוצאות לא מוצגות.
pivot_row pivot_row(expression) הפונקציה מחזירה את הערכים של expression אחרי הפעולה Pivot כרשימה. הפונקציה מחזירה null לתוצאות לא מוצגות.

דוגמאות לשימוש ב-pivot_row מופיעות במאמרים סיכום נתונים בשורות (סך הכל של שורה) בחישובים בטבלה ושיטות מומלצות לחישוב אחוז מסך הכולל.
pivot_where pivot_where(select_expression, expression) הפונקציה מחזירה את הערך של expression עבור עמודת הציר שמקיימת באופן ייחודי את התנאי select_expression או null אם עמודה ייחודית כזו לא קיימת.

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

פונקציות סינון למסננים מותאמים אישית ולשדות מותאמים אישית

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

תפקיד תחביר מטרה
matches_filter matches_filter(field, filter_expression) הפונקציה מחזירה את הערך Yes אם הערך של השדה תואם לביטוי המסנן, ואת הערך No אם לא.