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