用量
view: my_view {
derived_table: {
sql_trigger_value: SELECT CURDATE() ;;
...
}
}
|
階層
sql_trigger_value |
預設值
無
接受
會產生一列一欄的 SQL 陳述式
|
定義
sql_trigger_value 可根據您提供的 SQL 陳述式,觸發永久衍生資料表的重新生成作業。如果 SQL 陳述式的結果與先前的值不同,系統就會重新產生 PDT。
sql_trigger_value 參數只會考量您編寫的 SQL 中的第一列和第一欄。因此,強烈建議您編寫查詢,只傳回一個值 (一列和一欄)。這樣一來,未來的開發人員就不會感到困惑,非串流 SQL 方言也不會將大型結果集載入記憶體。
根據預設,只要沒有其他永久衍生資料表正在建構,Looker 每五分鐘就會執行您編寫的 SQL 查詢。如果 SQL 查詢結果有變,Looker 就會重新生成衍生資料表。您可以在 Looker 的管理員設定中,使用「PDT And Datagroup Maintenance Schedule」設定,視需要變更這項排程。
舉例來說,假設您執行 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 查詢變更前,強制重新產生衍生資料表。執行查詢後,從「探索動作」齒輪選單中選取「重建衍生資料表並執行」選項。
如要進一步瞭解「重建衍生資料表並執行」選項,請參閱「Looker 中的衍生資料表」說明文件頁面。
範例
在 MySQL 上建立 PDT,每天午夜重建一次:
view: clean_events {
derived_table: {
sql:
SELECT *
FROM events
WHERE type NOT IN ('test', 'staff') ;;
sql_trigger_value: SELECT CURDATE() ;;
}
}
下列各節說明在不同方言上,各種 PDT 重建策略所使用的 SQL:
Google BigQuery
| Desired Regeneration Schedule | 要使用的 SQL |
|---|---|
| 每天一次,時間為太平洋時間午夜 | 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()) |
| 每 2 小時 | SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60)) |
| 一律不更新資料 | SELECT 1 |
MySQL
| Desired Regeneration Schedule | 要使用的 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()) |
| 每 2 小時 (世界標準時間) | SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60)) |
| 一律不更新資料 | SELECT 1 |
Amazon Redshift
| Desired Regeneration Schedule | 要使用的 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()) |
| 每 2 小時 | SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60)) |
| 一律不更新資料 | SELECT 1 |
PostgreSQL
| Desired Regeneration Schedule | 要使用的 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()) |
| 每 2 小時 | SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60)) |
| 一律不更新資料 | SELECT 1 |
Snowflake
| Desired Regeneration Schedule | 要使用的 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()) |
| 每 2 小時 (世界標準時間) | SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60)) |
| 一律不更新資料 | SELECT 1 |
常見挑戰
sql_trigger_value 必須設定永久衍生資料表
除非您在資料庫連線設定中啟用衍生資料表的持續性,否則使用 sql_trigger_value 會導致 LookML 驗證錯誤。大多數客戶在初次設定資料庫連線時,會設定永久衍生資料表。這項規則最常見的例外狀況,是客戶將 Looker 連結至 PostgreSQL 唯讀、熱插拔次要資料庫。
sql_trigger_value 在開發模式和正式環境模式中的運作方式不同
sql_trigger_value 應可在正式環境模式中正常運作。在開發模式中,無論您採用何種設定,所有衍生資料表都會視為已使用 persist_for: 24 hours。詳情請參閱「Looker 中的衍生資料表」說明文件頁面的「開發模式中的永久資料表」一節。