sql_trigger_value

Utilizzo

view: my_view {
  derived_table: {
    sql_trigger_value: SELECT CURDATE() ;;
    ...
  }
}
Gerarchia
sql_trigger_value
Valore predefinito
Nessuno

Accetta
Un'istruzione SQL che genera una riga e una colonna

Definizione

sql_trigger_value consente di attivare la rigenerazione di una tabella derivata permanente in base a un'istruzione SQL fornita da te. Se il risultato dell'istruzione SQL è diverso dal valore precedente, la PDT viene rigenerata.

Il parametro sql_trigger_value prenderà in considerazione solo la prima riga e la prima colonna del codice SQL che scrivi. Pertanto, ti consigliamo vivamente di scrivere la query in modo che restituisca un solo valore (una riga e una colonna). In questo modo si evita qualsiasi confusione per i futuri sviluppatori e si impedisce ai dialetti SQL non in streaming di caricare set di risultati di grandi dimensioni in memoria.

Per impostazione predefinita, ogni cinque minuti Looker esegue la query SQL che hai scritto, a meno che non sia in corso la creazione di un'altra tabella derivata permanente. Se i risultati della query SQL cambiano, Looker rigenererà la tabella derivata. Puoi modificare questa pianificazione in base alle tue esigenze utilizzando l'impostazione PDT And Datagroup Maintenance Schedule (Pianificazione manutenzione PDT e gruppi di dati) nelle impostazioni di amministrazione di Looker.

Ad esempio, supponiamo che tu stia eseguendo MySQL e utilizzi:

    sql_trigger_value: SELECT CURDATE() ;;

I risultati sarebbero i seguenti:

Tempo di esecuzione di sql_trigger_value Risultato 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

Come puoi vedere, il valore di questa query SQL cambia una volta al giorno a mezzanotte, quindi la tabella derivata verrà rigenerata in questi orari.

Se l'amministratore ti ha concesso l'autorizzazione develop, puoi forzare la rigenerazione di una tabella derivata prima che la relativa query sql_trigger_value sia cambiata. Seleziona l'opzione Ricostruisci tabelle derivate ed esegui dal menu a forma di ingranaggio Azioni di esplorazione dopo aver eseguito una query.

Per ulteriori dettagli sull'opzione Rebuild Derived Tables & Run (Ricostruisci tabelle derivate ed esegui), consulta la pagina della documentazione Tabelle derivate in Looker.

Esempi

Crea una PDT su MySQL che viene ricreata una volta al giorno a mezzanotte:

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

Le sezioni seguenti mostrano l'SQL da utilizzare per varie strategie di ricostruzione delle PDT su dialetti diversi:

Google BigQuery

Desired Regeneration Schedule SQL da utilizzare
Una volta al giorno alla mezzanotte del fuso orario del Pacifico
SELECT FORMAT_TIMESTAMP('%F', CURRENT_TIMESTAMP(), 'America/Los_Angeles')
Una volta al giorno a un'ora specifica
SELECT FLOOR(((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) - 60*60*3)/(60*60*24))

Sostituisci "3" con l'ora del giorno in cui vuoi che avvenga la rigenerazione
Due volte al giorno a orari specifici
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

Sostituisci 4 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Tre volte al giorno in orari specifici
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

Sostituisci 4, 9 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Ogni ora
SELECT EXTRACT(HOUR FROM CURRENT_TIMESTAMP())
Ogni 2 ore
SELECT FLOOR((TIMESTAMP_DIFF(CURRENT_TIMESTAMP(),'1970-01-01 00:00:00',SECOND)) / (2*60*60))

Puoi sostituire "2" con il numero di ore che vuoi che trascorrano tra una rigenerazione e l'altra
Non aggiornare mai i dati
SELECT 1

MySQL

Desired Regeneration Schedule SQL da utilizzare
Una volta al giorno a mezzanotte
SELECT CURDATE()
Una volta al giorno a un'ora specifica nel fuso orario UTC (Coordinated Universal Time)
SELECT FLOOR((UNIX_TIMESTAMP(NOW()) - 60*60*3)/(60*60*24))

Sostituisci "3" con l'ora del giorno in cui vuoi che avvenga la rigenerazione
Due volte al giorno a orari specifici
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

Sostituisci 4 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Tre volte al giorno in orari specifici
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

Sostituisci 4, 9 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Quando viene aggiornata una tabella specifica
SELECT COUNT(*) FROM table
Ogni ora
SELECT HOUR(CURTIME())
Ogni 2 ore Coordinated Universal Time (UTC)
SELECT FLOOR(UNIX_TIMESTAMP() / (2*60*60))

Puoi sostituire "2" con il numero di ore che vuoi che trascorrano tra una rigenerazione e l'altra
Non aggiornare mai i dati
SELECT 1

Amazon Redshift

Desired Regeneration Schedule SQL da utilizzare
Una volta al giorno a mezzanotte
SELECT CURRENT_DATE
Una volta al giorno a un'ora specifica
SELECT FLOOR((EXTRACT(epoch from GETDATE()) - 60*60*3)/(60*60*24))

Sostituisci "3" con l'ora del giorno in cui vuoi che avvenga la rigenerazione
Due volte al giorno a orari specifici
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

Sostituisci 4 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Tre volte al giorno in orari specifici
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

Sostituisci 4, 9 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Quando viene aggiornata una tabella specifica
SELECT COUNT(*) FROM table
Ogni ora
SELECT DATE_PART('hour', GETDATE())
Ogni 2 ore
SELECT FLOOR(EXTRACT(epoch from GETDATE()) / (2*60*60))

Puoi sostituire "2" con il numero di ore che vuoi che trascorrano tra una rigenerazione e l'altra
Non aggiornare mai i dati
SELECT 1

PostgreSQL

Desired Regeneration Schedule SQL da utilizzare
Una volta al giorno a mezzanotte
SELECT CURRENT_DATE
Una volta al giorno a un'ora specifica
SELECT FLOOR((EXTRACT(epoch from NOW()) - 60*60*3)/(60*60*24))

Sostituisci "3" con l'ora del giorno in cui vuoi che avvenga la rigenerazione
Due volte al giorno a orari specifici
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

Sostituisci 4 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Tre volte al giorno in orari specifici
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

Sostituisci 4, 9 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Quando viene aggiornata una tabella specifica
SELECT COUNT(*) FROM table
Ogni ora
SELECT DATE_PART('hour', NOW())
Ogni 2 ore
SELECT FLOOR(EXTRACT(epoch from NOW()) / (2*60*60))

Puoi sostituire "2" con il numero di ore che vuoi che trascorrano tra una rigenerazione e l'altra
Non aggiornare mai i dati
SELECT 1

Snowflake

Desired Regeneration Schedule SQL da utilizzare
Una volta al giorno a mezzanotte
SELECT CURRENT_DATE()
Una volta al giorno a un'ora specifica nel fuso orario UTC (Coordinated Universal Time)
SELECT FLOOR((DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) - 60*60*3)/(60*60*24))

Sostituisci "3" con l'ora del giorno in cui vuoi che avvenga la rigenerazione
Due volte al giorno a orari specifici
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

Sostituisci 4 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Tre volte al giorno in orari specifici
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

Sostituisci 4, 9 e 18 con le ore del giorno in cui vuoi che avvenga la rigenerazione
Quando viene aggiornata una tabella specifica
SELECT COUNT(*) FROM table
Ogni ora
SELECT HOUR(CURRENT_TIME())
Ogni 2 ore Coordinated Universal Time (UTC)
SELECT FLOOR(DATE_PART('EPOCH_SECOND', CURRENT_TIMESTAMP) / (2*60*60))

Puoi sostituire "2" con il numero di ore che vuoi che trascorrano tra una rigenerazione e l'altra
Non aggiornare mai i dati
SELECT 1

Sfide comuni

sql_trigger_value richiede la configurazione di tabelle derivate permanenti

L'utilizzo di sql_trigger_value causerà errori di convalida di LookML, a meno che tu non abbia attivato la persistenza per le tabelle derivate nelle impostazioni di connessione al database. La maggior parte dei clienti configura le tabelle derivate permanenti durante la configurazione iniziale di una connessione al database. L'eccezione più comune a questa regola riguarda i clienti che connettono Looker a un database secondario hot-swap di sola lettura di PostgreSQL.

sql_trigger_value funziona in modo diverso tra la modalità di sviluppo e la modalità di produzione

sql_trigger_value dovrebbe funzionare come previsto in modalità di produzione. In modalità di sviluppo, tutte le tabelle derivate vengono trattate come se fosse stato utilizzato persist_for: 24 hours, indipendentemente dall'impostazione implementata. Per ulteriori informazioni, consulta la sezione Tabelle persistenti in modalità di sviluppo della pagina della documentazione Tabelle derivate in Looker.