incremento_offset

Utilizzo

view: my_view {
derived_table: {
increment_key: ["created_date"]
increment_offset: 1
...
}
}
Gerarchia
view
derived_table
increment_offset

- oppure -

explore
aggregate_table
materialization
increment_offset
Valore predefinito
0

Accetta
Un numero intero

Regole speciali

Definizione

Puoi creare PDT incrementali nel tuo progetto se il linguaggio le supporta. Una PDT incrementale è una tabella derivata permanente (PDT) che Looker crea aggiungendo alla tabella dati aggiornati, anziché ricreare la tabella nella sua interezza. Per ulteriori informazioni, consulta la pagina Documentazione sulle PDT incrementali.

Il parametro increment_key specifica il periodo di tempo durante il quale eseguire query su dati aggiornati e aggiungerli alla tabella aggregata. Il parametro increment_offset è un parametro facoltativo che puoi utilizzare se vuoi ricreare la tabella per i periodi di tempo precedenti contemporaneamente all'aggiunta di dati aggiornati alla tabella. Il parametro increment_offset definisce il numero di periodi di tempo precedenti che vengono ricreati quando si aggiungono i dati a una PDT incrementale.

Il parametro increment_offset è utile nel caso di dati in ritardo, in cui i periodi di tempo precedenti potrebbero avere nuovi dati che non sono stati inclusi quando l'incremento corrispondente è stato creato in origine e aggiunto alla PDT.

Il valore predefinito di increment_offset è 0, il che significa che alla tabella vengono aggiunti solo i nuovi dati dell'incremento corrente. Se imposti increment_offset su 1, i dati provenienti dall'incremento precedente verranno aggiunti alla tabella in aggiunta ai nuovi dati dall'incremento di tempo corrente.

Consulta la pagina Documentazione delle PDT incrementali per consultare alcuni scenari di esempio che illustrano come funzionano le PDT incrementali e mostrano l'interazione tra increment_key, increment_offset e la strategia di persistenza.

Consulta la sezione Dialetti di database supportati per le PDT incrementali in questa pagina per l'elenco dei dialetti che supportano le PDT incrementali.

Esempio

Ad esempio, questa PDT viene ricreata in incrementi di un giorno (increment_key: event_day), che risalgono a tre giorni prima (increment_offset: 3):

derived_table: {
  datagroup_trigger: usagetable_etl
  increment_key: "event_day"
  increment_offset: 3
  explore_source: events {
    column: name { field: account.name }
    column: account_id { field: account.id }
    column: database_dialect {}
    column: count_events {}
    column: event_day {}
   }
 }

Dialetti di database supportati per le PDT incrementali

Affinché Looker supporti le PDT incrementali nel tuo progetto Looker, il tuo dialetto del database deve supportare i comandi DDL (Data Definition Language) che consentono l'eliminazione e l'inserimento di righe.

La tabella seguente mostra quali dialetti supportano le PDT incrementali nell'ultima release di Looker: