שימוש
view: my_view {
derived_table: {
sql_trigger_value: SELECT CURDATE() ;;
...
}
}
|
היררכיה
sql_trigger_value |
ערך ברירת המחדל
ללא
מקבלים
הצהרת SQL שיוצרת שורה אחת ועמודה אחת
|
הגדרה
בעזרת sql_trigger_value אפשר להפעיל יצירה מחדש של טבלה נגזרת מתמידה (PDT) על סמך הצהרת SQL שאתם מספקים. אם התוצאה של הצהרת ה-SQL שונה מהערך הקודם, ה-PDT נוצר מחדש.
הפרמטר sql_trigger_value יביא בחשבון רק את השורה והעמודה הראשונות ב-SQL שכתבתם. לכן, מומלץ מאוד לכתוב את השאילתה כך שתחזיר רק ערך אחד (שורה אחת ועמודה אחת). כך אפשר למנוע בלבול בקרב מפתחים בעתיד, ולהגן על ניבי SQL שאינם בסטרימינג מפני טעינה של קבוצות גדולות של תוצאות לזיכרון.
כברירת מחדל, כל חמש דקות Looker מריץ את שאילתת ה-SQL שכתבתם, כל עוד לא מתבצעת בנייה של טבלה נגזרת מתמידה אחרת. אם התוצאות של שאילתת ה-SQL משתנות, Looker יוצר מחדש את הטבלה הנגזרת. אפשר לשנות את לוח הזמנים הזה לפי הצורך באמצעות ההגדרה PDT And Datagroup Maintenance Schedule בהגדרות האדמין של Looker.
לדוגמה, נניח שאתם מריצים את MySQL ומשתמשים בפקודה:
sql_trigger_value: SELECT CURDATE() ;;
התוצאות יהיו:
| זמן הריצה של sql_trigger_value | תוצאה של sql_trigger_value |
|---|---|
| 2015-01-01 00:00 | 2015-01-01 |
| 2015-01-01 00:05 | 2015-01-01 |
| 2015-01-01 00:10 | 2015-01-01 |
| ... | ... |
| 2015-01-01 23:55 | 2015-01-01 |
| 2015-01-02 00:00 | 2015-01-02 |
| 2015-01-02 00:05 | 2015-01-02 |
אפשר לראות שהערך של שאילתת ה-SQL הזו ישתנה פעם ביום בחצות, ולכן הטבלה הנגזרת תיווצר מחדש בזמנים האלה.
אם האדמין נתן לכם את ההרשאה develop, אתם יכולים לאלץ טבלה נגזרת להיווצר מחדש לפני ששאילתת ה-sql_trigger_value שלה השתנתה. אחרי שמריצים שאילתה, בוחרים באפשרות Rebuild Derived Tables & Run בתפריט גלגל השיניים Explore actions.
מידע נוסף על האפשרות Rebuild Derived Tables & Run זמין בדף התיעוד טבלאות נגזרות ב-Looker.
דוגמאות
יוצרים PDT ב-MySQL שנבנה מחדש פעם ביום בחצות:
view: clean_events {
derived_table: {
sql:
SELECT *
FROM events
WHERE type NOT IN ('test', 'staff') ;;
sql_trigger_value: SELECT CURDATE() ;;
}
}
בקטעים הבאים מוצג קוד ה-SQL שבו צריך להשתמש לאסטרטגיות שונות של בנייה מחדש של PDT בניבים שונים:
Google BigQuery
| לוח הזמנים הרצוי ליצירה מחדש | SQL לשימוש |
|---|---|
| פעם ביום בחצות לפי שעון החוף המערבי (PT) | SELECT FORMAT_TIMESTAMP('%F', CURRENT_TIMESTAMP(), 'America/Los_Angeles') |
| פעם ביום בשעה ספציפית | SELECT FLOOR(((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) - 60*60*3)/(60*60*24)) |
| פעמיים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| שלוש פעמים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| כל שעה | SELECT EXTRACT(HOUR FROM CURRENT_TIMESTAMP()) |
| כל שעתיים | SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60)) |
| אף פעם לא לעדכן נתונים | SELECT 1 |
MySQL
| לוח הזמנים הרצוי ליצירה מחדש | SQL לשימוש |
|---|---|
| פעם ביום בחצות | SELECT CURDATE() |
| פעם ביום בשעה ספציפית לפי זמן אוניברסלי מתואם (UTC) | SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24)) |
| פעמיים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| שלוש פעמים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| כשמתבצע עדכון בטבלה מסוימת | SELECT COUNT(*) FROM table |
| כל שעה | SELECT HOUR(CURTIME()) |
| כל שעתיים לפי זמן אוניברסלי מתואם (UTC) | SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60)) |
| אף פעם לא לעדכן נתונים | SELECT 1 |
Amazon Redshift
| לוח הזמנים הרצוי ליצירה מחדש | SQL לשימוש |
|---|---|
| פעם ביום בחצות | SELECT CURRENT_DATE |
| פעם ביום בשעה ספציפית | SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24)) |
| פעמיים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| שלוש פעמים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| כשמתבצע עדכון בטבלה מסוימת | SELECT COUNT(*) FROM table |
| כל שעה | SELECT DATE_PART('hour', GETDATE()) |
| כל שעתיים | SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60)) |
| אף פעם לא לעדכן נתונים | SELECT 1 |
PostgreSQL
| לוח הזמנים הרצוי ליצירה מחדש | SQL לשימוש |
|---|---|
| פעם ביום בחצות | SELECT CURRENT_DATE |
| פעם ביום בשעה ספציפית | SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24)) |
| פעמיים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| שלוש פעמים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| כשמתבצע עדכון בטבלה מסוימת | SELECT COUNT(*) FROM table |
| כל שעה | SELECT DATE_PART('hour', NOW()) |
| כל שעתיים | SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60)) |
| אף פעם לא לעדכן נתונים | SELECT 1 |
פתית שלג
| לוח הזמנים הרצוי ליצירה מחדש | SQL לשימוש |
|---|---|
| פעם ביום בחצות | SELECT CURRENT_DATE() |
| פעם ביום בשעה ספציפית לפי זמן אוניברסלי מתואם (UTC) | SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24)) |
| פעמיים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 4am and 6pm'
ELSE 'between 6pm and 4am'
END |
| שלוש פעמים ביום בשעות ספציפיות | SELECT CASE
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 4 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 9
THEN 'between 4am and 9am'
WHEN EXTRACT(HOUR FROM CURRENT_TIMESTAMP) > 9 AND EXTRACT(HOUR FROM CURRENT_TIMESTAMP) < 18
THEN 'between 9am and 6pm'
ELSE 'between 6pm and 4am'
END |
| כשמתבצע עדכון בטבלה מסוימת | SELECT COUNT(*) FROM table |
| כל שעה | SELECT HOUR(CURRENT_TIME()) |
| כל שעתיים לפי זמן אוניברסלי מתואם (UTC) | SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60)) |
| אף פעם לא לעדכן נתונים | SELECT 1 |
אתגרים נפוצים
כדי להשתמש ב-sql_trigger_value, צריך להגדיר טבלאות נגזרות מתמידות (PDT)
השימוש ב-sql_trigger_value יגרום לשגיאות אימות של LookML, אלא אם הפעלתם שמירה של טבלאות נגזרות בהגדרות החיבור למסד הנתונים. רוב הלקוחות כן מגדירים טבלאות נגזרות מתמידות כשהם מגדירים חיבור למסד נתונים בפעם הראשונה. החריג הנפוץ ביותר לכלל הזה הוא לקוחות שמחברים את Looker לשרת משני לקריאה בלבד ב-PostgreSQL, שניתן להחלפה חמה.
sql_trigger_value פועל באופן שונה במצב פיתוח ובמצב ייצור
sql_trigger_value אמור לפעול כמו שצריך במצב ייצור. במצב פיתוח, כל הטבלאות הנגזרות מטופלות כאילו נעשה שימוש ב-persist_for: 24 hours, לא משנה איזו הגדרה הטמעתם. מידע נוסף זמין בקטע טבלאות לשימוש חוזר במצב פיתוח בדף התיעוד טבלאות נגזרות ב-Looker.