increment_offset n'est compatible qu'avec increment_key
increment_offset et increment_key ne sont compatibles qu'avec les tables persistantes
increment_offset et increment_key ne sont disponibles que pour des dialectes spécifiques

Définition

Vous pouvez créer des PDT incrémentiels dans votre projet si votre dialecte les accepte. Un PDT incrémentiel est une table dérivée persistante (PDT) que Looker crée en ajoutant des données récentes à la table, au lieu de la reconstruire entièrement. Pour en savoir plus, consultez la page sur la PDT incrémentiel.

Le paramètre increment_key spécifie la période pour laquelle de nouvelles données doivent être interrogées et ajoutées à la table agrégée. Le paramètre increment_offset est un paramètre facultatif que vous pouvez utiliser si vous souhaitez recréer la table pour des périodes précédentes en même temps que de nouvelles données. Le paramètre increment_offset définit le nombre de périodes précédentes qui seront recréées lors de l'ajout de données à un PDT incrémentiel.

Le paramètre increment_offset est utile dans le cas de données tardives, où des périodes précédentes peuvent inclure de nouvelles données qui n'étaient pas incluses lors de la création initiale de l'incrément correspondant et de leur ajout au PDT.

La valeur increment_offset par défaut est 0, ce qui signifie que seules les nouvelles données de l'incrément actuel sont ajoutées à la table. Si vous définissez increment_offset sur 1, les données arrivant en retard à partir de l'incrément précédent seront ajoutées à la table en plus des nouvelles données à partir de l'incrément actuel.

La page de documentation sur les PDT incrémentiels illustre des exemples de fonctionnement des PDT incrémentiels illustrant l'interaction de increment_key, increment_offset et la stratégie de persistance.

Consultez la section Dialectes de base de données compatibles pour les PDT incrémentiels de cette page pour obtenir la liste des dialectes compatibles avec les PDT incrémentiels.

Exemple

Par exemple, ce PDT est reconstruit par incréments d'une journée (increment_key: event_day), en remontant à trois jours (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 {}
   }
 }

Dialectes de base de données pris en charge pour les augmentations de tables PDT

Pour que Looker accepte les PDT incrémentiels dans votre projet Looker, le dialecte de votre base de données doit accepter les commandes DDL (Data Definition Language) qui permettent de supprimer et d'insérer des lignes.

Le tableau suivant présente les dialectes compatibles avec les PDT incrémentiels dans la dernière version de Looker: