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

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

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

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

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

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

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

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

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

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

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

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

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

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

דוגמה אפשר לראות בפוסט בקהילה בנושא סטיית תקן וזיהוי פשוט של חריגות בסדרות זמן באמצעות חישובים בטבלה.
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 של קו הרגרסיה הלינארית שעובר דרך הנקודות שנקבעו על ידי 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 True
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 אם לא.