sql_trigger_value

שימוש

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))

מחליפים את הספרה 3 בשעה ביום שבה רוצים שההפעלה מחדש תתרחש
פעמיים ביום בשעות ספציפיות
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

מחליפים את 4 ו-18 בשעות ביום שבהן רוצים שהיצירה מחדש תתרחש
שלוש פעמים ביום בשעות ספציפיות
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

מחליפים את הערכים 4, 9 ו-18 בשעות ביום שבהן רוצים שההתחדשות תתרחש
כל שעה
SELECT EXTRACT(HOUR FROM CURRENT_TIMESTAMP())
כל שעתיים
SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60))

אפשר להחליף את הספרה "2" במספר השעות הרצוי בין כל יצירה מחדש
אף פעם לא לעדכן נתונים
SELECT 1

MySQL

לוח הזמנים הרצוי ליצירה מחדש ‫SQL לשימוש
פעם ביום בחצות
SELECT CURDATE()
פעם ביום בשעה ספציפית לפי זמן אוניברסלי מתואם (UTC)
SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24))

מחליפים את הספרה 3 בשעה ביום שבה רוצים שההפעלה מחדש תתרחש
פעמיים ביום בשעות ספציפיות
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

מחליפים את 4 ו-18 בשעות ביום שבהן רוצים שהיצירה מחדש תתרחש
שלוש פעמים ביום בשעות ספציפיות
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

מחליפים את הערכים 4, 9 ו-18 בשעות ביום שבהן רוצים שההתחדשות תתרחש
כשמתבצע עדכון בטבלה מסוימת
SELECT COUNT(*) FROM table
כל שעה
SELECT HOUR(CURTIME())
כל שעתיים לפי זמן אוניברסלי מתואם (UTC)
SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60))

אפשר להחליף את הספרה "2" במספר השעות הרצוי בין כל יצירה מחדש
אף פעם לא לעדכן נתונים
SELECT 1

Amazon Redshift

לוח הזמנים הרצוי ליצירה מחדש ‫SQL לשימוש
פעם ביום בחצות
SELECT CURRENT_DATE
פעם ביום בשעה ספציפית
SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24))

מחליפים את הספרה 3 בשעה ביום שבה רוצים שההפעלה מחדש תתרחש
פעמיים ביום בשעות ספציפיות
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

מחליפים את 4 ו-18 בשעות ביום שבהן רוצים שהיצירה מחדש תתרחש
שלוש פעמים ביום בשעות ספציפיות
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

מחליפים את הערכים 4, 9 ו-18 בשעות ביום שבהן רוצים שההתחדשות תתרחש
כשמתבצע עדכון בטבלה מסוימת
SELECT COUNT(*) FROM table
כל שעה
SELECT DATE_PART('hour', GETDATE())
כל שעתיים
SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60))

אפשר להחליף את הספרה "2" במספר השעות הרצוי בין כל יצירה מחדש
אף פעם לא לעדכן נתונים
SELECT 1

PostgreSQL

לוח הזמנים הרצוי ליצירה מחדש ‫SQL לשימוש
פעם ביום בחצות
SELECT CURRENT_DATE
פעם ביום בשעה ספציפית
SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24))

מחליפים את הספרה 3 בשעה ביום שבה רוצים שההפעלה מחדש תתרחש
פעמיים ביום בשעות ספציפיות
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

מחליפים את 4 ו-18 בשעות ביום שבהן רוצים שהיצירה מחדש תתרחש
שלוש פעמים ביום בשעות ספציפיות
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

מחליפים את הערכים 4, 9 ו-18 בשעות ביום שבהן רוצים שההתחדשות תתרחש
כשמתבצע עדכון בטבלה מסוימת
SELECT COUNT(*) FROM table
כל שעה
SELECT DATE_PART('hour', NOW())
כל שעתיים
SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60))

אפשר להחליף את הספרה "2" במספר השעות הרצוי בין כל יצירה מחדש
אף פעם לא לעדכן נתונים
SELECT 1

פתית שלג

לוח הזמנים הרצוי ליצירה מחדש ‫SQL לשימוש
פעם ביום בחצות
SELECT CURRENT_DATE()
פעם ביום בשעה ספציפית לפי זמן אוניברסלי מתואם (UTC)
SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24))

מחליפים את הספרה 3 בשעה ביום שבה רוצים שההפעלה מחדש תתרחש
פעמיים ביום בשעות ספציפיות
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

מחליפים את 4 ו-18 בשעות ביום שבהן רוצים שהיצירה מחדש תתרחש
שלוש פעמים ביום בשעות ספציפיות
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

מחליפים את הערכים 4, 9 ו-18 בשעות ביום שבהן רוצים שההתחדשות תתרחש
כשמתבצע עדכון בטבלה מסוימת
SELECT COUNT(*) FROM table
כל שעה
SELECT HOUR(CURRENT_TIME())
כל שעתיים לפי זמן אוניברסלי מתואם (UTC)
SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60))

אפשר להחליף את הספרה "2" במספר השעות הרצוי בין כל יצירה מחדש
אף פעם לא לעדכן נתונים
SELECT 1

אתגרים נפוצים

כדי להשתמש ב-sql_trigger_value, צריך להגדיר טבלאות נגזרות מתמידות (PDT)

השימוש ב-sql_trigger_value יגרום לשגיאות אימות של LookML, אלא אם הפעלתם שמירה של טבלאות נגזרות בהגדרות החיבור למסד הנתונים. רוב הלקוחות כן מגדירים טבלאות נגזרות מתמידות כשהם מגדירים חיבור למסד נתונים בפעם הראשונה. החריג הנפוץ ביותר לכלל הזה הוא לקוחות שמחברים את Looker לשרת משני לקריאה בלבד ב-PostgreSQL, שניתן להחלפה חמה.

‫sql_trigger_value פועל באופן שונה במצב פיתוח ובמצב ייצור

‫sql_trigger_value אמור לפעול כמו שצריך במצב ייצור. במצב פיתוח, כל הטבלאות הנגזרות מטופלות כאילו נעשה שימוש ב-persist_for: 24 hours, לא משנה איזו הגדרה הטמעתם. מידע נוסף זמין בקטע טבלאות לשימוש חוזר במצב פיתוח בדף התיעוד טבלאות נגזרות ב-Looker.