sql_trigger_value

用量

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

將「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())
每 2 小時
SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60))

您可以將「2」替換成每次重新生成之間的時間間隔 (以小時為單位)
一律不更新資料
SELECT 1

MySQL

Desired Regeneration Schedule 要使用的 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())
每 2 小時 (世界標準時間)
SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60))

您可以將「2」替換成每次重新生成之間的時間間隔 (以小時為單位)
一律不更新資料
SELECT 1

Amazon Redshift

Desired Regeneration Schedule 要使用的 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())
每 2 小時
SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60))

您可以將「2」替換成每次重新生成之間的時間間隔 (以小時為單位)
一律不更新資料
SELECT 1

PostgreSQL

Desired Regeneration Schedule 要使用的 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())
每 2 小時
SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60))

您可以將「2」替換成每次重新生成之間的時間間隔 (以小時為單位)
一律不更新資料
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))

將「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())
每 2 小時 (世界標準時間)
SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60))

您可以將「2」替換成每次重新生成之間的時間間隔 (以小時為單位)
一律不更新資料
SELECT 1

常見挑戰

sql_trigger_value 必須設定永久衍生資料表

除非您在資料庫連線設定中啟用衍生資料表的持續性,否則使用 sql_trigger_value 會導致 LookML 驗證錯誤。大多數客戶在初次設定資料庫連線時,會設定永久衍生資料表。這項規則最常見的例外狀況,是客戶將 Looker 連結至 PostgreSQL 唯讀、熱插拔次要資料庫。

sql_trigger_value 在開發模式和正式環境模式中的運作方式不同

sql_trigger_value 應可在正式環境模式中正常運作。在開發模式中,無論您採用何種設定,所有衍生資料表都會視為已使用 persist_for: 24 hours。詳情請參閱「Looker 中的衍生資料表」說明文件頁面的「開發模式中的永久資料表」一節。