increment_offset é compatível apenas com increment_key
increment_offset e increment_key são compatíveis apenas com tabelas permanentes.
increment_offset e increment_key são compatíveis apenas com dialetos específicos.

Definição

É possível criar PDTs incrementais no seu projeto, se o dialeto for compatível. Uma PDT incremental é uma tabela derivada persistente (PDT, na sigla em inglês) criada pelo Looker anexando novos dados à tabela, em vez de recriar a tabela inteira. Consulte a página de documentação de PDTs incrementais para mais informações.

O parâmetro increment_key especifica o período em que os dados novos devem ser consultados e anexados à tabela de agregação. O parâmetro increment_offset é opcional e pode ser recriado na tabela de períodos anteriores enquanto os dados novos são anexados à tabela. O parâmetro increment_offset define o número de períodos anteriores que serão recriados ao anexar dados a uma PDT incremental.

O parâmetro increment_offset é útil no caso de dados atrasados, em que os períodos anteriores podem ter novos dados que não foram incluídos quando o incremento correspondente foi originalmente criado e anexado ao PDT.

O valor increment_offset padrão é 0, o que significa que apenas os novos dados do incremento atual são anexados à tabela. Se você definir increment_offset como 1, os dados de chegada tardio do incremento anterior serão adicionados à tabela, além dos novos dados do incremento de tempo atual.

Consulte a página de documentação de PDTs incrementais para ver alguns exemplos de como eles funcionam e que mostram a interação de increment_key, increment_offset e a estratégia de persistência.

Consulte a seção Dialetos de banco de dados compatíveis com PDTs incrementais nesta página para ver a lista de dialetos compatíveis.

Exemplo

Por exemplo, essa PDT é recriada em incrementos de um dia (increment_key: event_day), voltando três dias (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 {}
   }
 }

Dialetos de banco de dados compatíveis com PDTs incrementais

Para que o Looker ofereça suporte a PDTs incrementais no seu projeto do Looker, o dialeto do banco de dados precisa ser compatível com os comandos da Linguagem de definição de dados (DDL) que permitem a exclusão e a inserção de linhas.

A tabela a seguir mostra quais dialetos são compatíveis com PDTs incrementais na versão mais recente do Looker: