sql_trigger_value

用途

view: my_view {
  derived_table: {
    sql_trigger_value: SELECT CURDATE() ;;
    ...
  }
}
階層
sql_trigger_value
デフォルト値
なし

許可
1 行と 1 列の結果を返す SQL ステートメント

定義

sql_trigger_value を使用すると、指定した SQL ステートメントに基づいて、永続的な派生テーブルの再生成をトリガーできます。SQL ステートメントの結果が前の値と異なる場合、PDT が再生成されます。

sql_trigger_value パラメータは、記述した SQL の最初の行と列のみを考慮します。そのため、1 つの値(1 行 1 列)のみを返すようにクエリを作成することを強くおすすめします。これにより、将来のデベロッパーの混乱を回避し、非ストリーミング SQL 言語で大きな結果セットがメモリに読み込まれるのを防ぐことができます。

デフォルトでは、別の永続的な派生テーブルが構築中でない限り、Looker は 5 分ごとに作成した SQL クエリを実行します。SQL クエリの結果が変更されると、Looker は派生テーブルを再生成します。このスケジュールは、Looker の管理設定の [PDT とデータグループ メンテナンス スケジュール] の設定を使用して、必要に応じて変更できます。

たとえば、MySQL を実行していて、次のコマンドを使用したとします。

    sql_trigger_value: SELECT CURDATE() ;;

結果は次のようになります。

sql_trigger_value の実行時間 sql_trigger_value の結果
2015-01-01 00:00 2015年1月1日
2015-01-01 00:05 2015年1月1日
2015-01-01 00:10 2015年1月1日
... ...
2015-01-01 23:55 2015年1月1日
2015-01-02 00:00 2015-01-02
2015-01-02 00:05 2015-01-02

この SQL クエリの値は 1 日に 1 回、深夜に変化するため、派生テーブルはこれらの時刻に再生成されます。

管理者が develop 権限を付与している場合は、sql_trigger_value クエリが変更される前に、派生テーブルを強制的に再生成できます。クエリを実行した後、[Explore アクション] の歯車メニューから [派生テーブルを再構築して実行] オプションを選択します。

[派生テーブルを再構築して実行する] オプションの詳細については、Looker の派生テーブルのドキュメント ページをご覧ください。

例

1 日に 1 回、深夜に再ビルドされる PDT を MySQL に作成します。

view: clean_events {
  derived_table: {
    sql:
      SELECT *
      FROM events
      WHERE type NOT IN ('test', 'staff') ;;
    sql_trigger_value: SELECT CURDATE() ;;
  }
}

以下のセクションでは、さまざまな言語でさまざまな PDT 再構築戦略に使用する SQL を示します。

Google BigQuery

希望する再生成スケジュール 使用する SQL
1 日 1 回、太平洋時間の午前 0 時
SELECT FORMAT_TIMESTAMP('%F', CURRENT_TIMESTAMP(), 'America/Los_Angeles')
1 日に 1 回(指定した時刻)
SELECT FLOOR(((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) - 60*60*3)/(60*60*24))

「3」を、再生成を行う時刻に置き換えます。
1 日 2 回(指定した時刻)
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 を、再生成を行う時間帯に置き換えます。
1 日 3 回、特定の時間に
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 を、再生成を行う時刻に置き換えます。
1 時間ごと
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

希望する再生成スケジュール 使用する SQL
1 日 1 回、午前 0 時
SELECT CURDATE()
1 日 1 回、協定世界時(UTC)の指定した時刻
SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24))

「3」を、再生成を行う時刻に置き換えます。
1 日 2 回(指定した時刻)
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 を、再生成を行う時間帯に置き換えます。
1 日 3 回、特定の時間に
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
1 時間ごと
SELECT HOUR(CURTIME())
2 時間ごと(協定世界時(UTC))
SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60))

「2」の部分は、再生成の間隔として設定する時間数に置き換えることができます。
データを更新しない
SELECT 1

Amazon Redshift

希望する再生成スケジュール 使用する SQL
1 日 1 回、午前 0 時
SELECT CURRENT_DATE
1 日に 1 回(指定した時刻)
SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24))

「3」を、再生成を行う時刻に置き換えます。
1 日 2 回(指定した時刻)
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 を、再生成を行う時間帯に置き換えます。
1 日 3 回、特定の時間に
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
1 時間ごと
SELECT DATE_PART('hour', GETDATE())
2 時間ごと
SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60))

「2」の部分は、再生成の間隔として設定する時間数に置き換えることができます。
データを更新しない
SELECT 1

PostgreSQL

希望する再生成スケジュール 使用する SQL
1 日 1 回、午前 0 時
SELECT CURRENT_DATE
1 日に 1 回(指定した時刻)
SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24))

「3」を、再生成を行う時刻に置き換えます。
1 日 2 回(指定した時刻)
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 を、再生成を行う時間帯に置き換えます。
1 日 3 回、特定の時間に
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
1 時間ごと
SELECT DATE_PART('hour', NOW())
2 時間ごと
SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60))

「2」の部分は、再生成の間隔として設定する時間数に置き換えることができます。
データを更新しない
SELECT 1

Snowflake

希望する再生成スケジュール 使用する SQL
1 日 1 回、午前 0 時
SELECT CURRENT_DATE()
1 日 1 回、協定世界時(UTC)の指定した時刻
SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24))

「3」を、再生成を行う時刻に置き換えます。
1 日 2 回(指定した時刻)
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 を、再生成を行う時間帯に置き換えます。
1 日 3 回、特定の時間に
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
1 時間ごと
SELECT HOUR(CURRENT_TIME())
2 時間ごと(協定世界時(UTC))
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 の動作は Development Mode と本番環境モードで異なります

sql_trigger_value は本番環境モードで想定どおりに動作するはずです。Development Mode では、実装した設定に関係なく、すべての派生テーブルは persist_for: 24 hours が使用されているかのように扱われます。詳しくは、Looker の派生テーブル ドキュメントの Development Mode の永続テーブルをご覧ください。