sql_trigger_value

Nutzung

view: my_view {
  derived_table: {
    sql_trigger_value: SELECT CURDATE() ;;
    ...
  }
}
Hierarchie
sql_trigger_value
Standardwert
Keine

Akzeptiert
Eine SQL-Anweisung, die eine Zeile und eine Spalte ergibt

Definition

Mit sql_trigger_value können Sie die Neugenerierung einer persistenten abgeleiteten Tabelle basierend auf einer von Ihnen angegebenen SQL-Anweisung auslösen. Wenn das Ergebnis der SQL-Anweisung sich vom vorherigen Wert unterscheidet, wird die PDT neu generiert.

Der Parameter sql_trigger_value berücksichtigt nur die erste Zeile und Spalte in der von Ihnen geschriebenen SQL-Abfrage. Daher empfehlen wir dringend, die Abfrage so zu schreiben, dass nur ein Wert (eine Zeile und eine Spalte) zurückgegeben wird. Dadurch werden Verwirrungen für zukünftige Entwickler vermieden und SQL-Dialekte ohne Streaming werden davor geschützt, große Ergebnismengen in den Arbeitsspeicher zu laden.

Standardmäßig führt Looker alle fünf Minuten die von Ihnen geschriebene SQL-Abfrage aus, sofern nicht gerade eine andere persistente abgeleitete Tabelle erstellt wird. Wenn sich die Ergebnisse der SQL-Abfrage ändern, generiert Looker die abgeleitete Tabelle neu. Sie können diesen Zeitplan in den Administratoreinstellungen von Looker mit der Einstellung Wartungszeitplan für PDTs und Datengruppen ändern.

Angenommen, Sie verwenden MySQL und haben Folgendes verwendet:

    sql_trigger_value: SELECT CURDATE() ;;

Die Ergebnisse würden so aussehen:

sql_trigger_value-Ausführungszeit sql_trigger_value-Ergebnis
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

Der Wert dieser SQL-Abfrage ändert sich einmal pro Tag um Mitternacht. Die abgeleitete Tabelle wird also zu diesen Zeiten neu generiert.

Wenn Ihr Administrator Ihnen die Berechtigung develop erteilt hat, können Sie die Neuerstellung einer abgeleiteten Tabelle erzwingen, bevor sich die zugehörige sql_trigger_value-Abfrage geändert hat. Wählen Sie nach dem Ausführen einer Abfrage im Zahnradmenü Explore-Aktionen die Option Abgeleitete Tabellen neu erstellen und ausführen aus.

Weitere Informationen zur Option Abgeleitete Tabellen neu erstellen und ausführen finden Sie auf der Dokumentationsseite Abgeleitete Tabellen in Looker.

Beispiele

Erstellen Sie eine PDT in MySQL, die einmal täglich um Mitternacht neu erstellt wird:

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

In den folgenden Abschnitten wird die SQL-Anweisung für verschiedene PDT-Neuerstellungsstrategien in verschiedenen Dialekten gezeigt:

Google BigQuery

Gewünschter Zeitplan für die Regeneration Zu verwendendes SQL
Einmal täglich um Mitternacht (UTC-7/-8)
SELECT FORMAT_TIMESTAMP('%F', CURRENT_TIMESTAMP(), 'America/Los_Angeles')
Einmal pro Tag zu einer bestimmten Uhrzeit
SELECT FLOOR(((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) - 60*60*3)/(60*60*24))

Ersetzen Sie „3“ durch die Uhrzeit, zu der die Regenerierung erfolgen soll.
Zweimal pro Tag zu bestimmten Uhrzeiten
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

Ersetzen Sie 4 und 18 durch die Tageszeiten, zu denen die Regeneration erfolgen soll.
Dreimal täglich zu bestimmten Uhrzeiten
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

Ersetzen Sie 4, 9 und 18 durch die Tageszeiten, zu denen die Regenerierung erfolgen soll.
Stündlich
SELECT EXTRACT(HOUR FROM CURRENT_TIMESTAMP())
Alle zwei Stunden
SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60))

Sie können die „2“ durch die Anzahl der Stunden ersetzen, die zwischen den einzelnen Regenerationen liegen sollen.
Daten nie aktualisieren
SELECT 1

MySQL

Gewünschter Zeitplan für die Regeneration Zu verwendendes SQL
Einmal täglich um Mitternacht
SELECT CURDATE()
Einmal pro Tag zu einer bestimmten Uhrzeit (UTC)
SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24))

Ersetzen Sie „3“ durch die Uhrzeit, zu der die Regenerierung erfolgen soll.
Zweimal pro Tag zu bestimmten Uhrzeiten
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

Ersetzen Sie 4 und 18 durch die Tageszeiten, zu denen die Regeneration erfolgen soll.
Dreimal täglich zu bestimmten Uhrzeiten
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

Ersetzen Sie 4, 9 und 18 durch die Tageszeiten, zu denen die Regenerierung erfolgen soll.
Wenn eine bestimmte Tabelle aktualisiert wird
SELECT COUNT(*) FROM table
Stündlich
SELECT HOUR(CURTIME())
Alle 2 Stunden koordinierte Weltzeit (UTC)
SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60))

Sie können die „2“ durch die Anzahl der Stunden ersetzen, die zwischen den einzelnen Regenerationen liegen sollen.
Daten nie aktualisieren
SELECT 1

Amazon Redshift

Gewünschter Zeitplan für die Regeneration Zu verwendendes SQL
Einmal täglich um Mitternacht
SELECT CURRENT_DATE
Einmal pro Tag zu einer bestimmten Uhrzeit
SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24))

Ersetzen Sie „3“ durch die Uhrzeit, zu der die Regenerierung erfolgen soll.
Zweimal pro Tag zu bestimmten Uhrzeiten
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

Ersetzen Sie 4 und 18 durch die Tageszeiten, zu denen die Regeneration erfolgen soll.
Dreimal täglich zu bestimmten Uhrzeiten
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

Ersetzen Sie 4, 9 und 18 durch die Tageszeiten, zu denen die Regenerierung erfolgen soll.
Wenn eine bestimmte Tabelle aktualisiert wird
SELECT COUNT(*) FROM table
Stündlich
SELECT DATE_PART('hour', GETDATE())
Alle zwei Stunden
SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60))

Sie können die „2“ durch die Anzahl der Stunden ersetzen, die zwischen den einzelnen Regenerationen liegen sollen.
Daten nie aktualisieren
SELECT 1

PostgreSQL

Gewünschter Zeitplan für die Regeneration Zu verwendendes SQL
Einmal täglich um Mitternacht
SELECT CURRENT_DATE
Einmal pro Tag zu einer bestimmten Uhrzeit
SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24))

Ersetzen Sie „3“ durch die Uhrzeit, zu der die Regenerierung erfolgen soll.
Zweimal pro Tag zu bestimmten Uhrzeiten
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

Ersetzen Sie 4 und 18 durch die Tageszeiten, zu denen die Regeneration erfolgen soll.
Dreimal täglich zu bestimmten Uhrzeiten
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

Ersetzen Sie 4, 9 und 18 durch die Tageszeiten, zu denen die Regenerierung erfolgen soll.
Wenn eine bestimmte Tabelle aktualisiert wird
SELECT COUNT(*) FROM table
Stündlich
SELECT DATE_PART('hour', NOW())
Alle zwei Stunden
SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60))

Sie können die „2“ durch die Anzahl der Stunden ersetzen, die zwischen den einzelnen Regenerationen liegen sollen.
Daten nie aktualisieren
SELECT 1

Snowflake

Gewünschter Zeitplan für die Regeneration Zu verwendendes SQL
Einmal täglich um Mitternacht
SELECT CURRENT_DATE()
Einmal pro Tag zu einer bestimmten Uhrzeit (UTC)
SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24))

Ersetzen Sie „3“ durch die Uhrzeit, zu der die Regenerierung erfolgen soll.
Zweimal pro Tag zu bestimmten Uhrzeiten
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

Ersetzen Sie 4 und 18 durch die Tageszeiten, zu denen die Regeneration erfolgen soll.
Dreimal täglich zu bestimmten Uhrzeiten
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

Ersetzen Sie 4, 9 und 18 durch die Tageszeiten, zu denen die Regenerierung erfolgen soll.
Wenn eine bestimmte Tabelle aktualisiert wird
SELECT COUNT(*) FROM table
Stündlich
SELECT HOUR(CURRENT_TIME())
Alle 2 Stunden koordinierte Weltzeit (UTC)
SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60))

Sie können die „2“ durch die Anzahl der Stunden ersetzen, die zwischen den einzelnen Regenerationen liegen sollen.
Daten nie aktualisieren
SELECT 1

Häufige Herausforderungen

Für sql_trigger_value müssen persistente abgeleitete Tabellen eingerichtet sein.

Die Verwendung von sql_trigger_value führt zu LookML-Validierungsfehlern, es sei denn, Sie haben in den Einstellungen für die Datenbankverbindung die Persistenz für abgeleitete Tabellen aktiviert. Die meisten Kunden richten bei der Erstkonfiguration einer Datenbankverbindung persistente abgeleitete Tabellen ein. Die häufigste Ausnahme von dieser Regel gilt für Kunden, die Looker mit einem schreibgeschützten, Hot-Swap-fähigen PostgreSQL-Sekundärsystem verbinden.

sql_trigger_value funktioniert im Entwicklungsmodus anders als im Produktionsmodus

sql_trigger_value sollte im Produktionsmodus wie erwartet funktionieren. Im Entwicklungsmodus werden alle abgeleiteten Tabellen so behandelt, als wäre persist_for: 24 hours verwendet worden, unabhängig davon, welche Einstellung Sie implementiert haben. Weitere Informationen finden Sie im Abschnitt Persistente Tabellen im Entwicklungsmodus auf der Dokumentationsseite Abgeleitete Tabellen in Looker.