For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/data-platform/dpe-actions-diff.md.

Convertir des valeurs cumulatives en deltas journaliers avec l'action Diff

Voir en Markdown

Lorsque vous avez des tables contenant des attributs datés décrivant des valeurs totales (total des commandes quotidiennes, revenu mensuel total, etc.) à un instant donné

Objectif

Lorsque vous avez des tables contenant des attributs datés décrivant des valeurs totales (total des commandes quotidiennes, revenu mensuel total, etc.) à un instant donné, l'action diff vous permet de calculer la différence de ces valeurs entre des incréments de temps consécutifs.

Par exemple, prenons l'attribut total_fans dans la table ci-dessous, calculé chaque jour pour une certaine page de profil de réseau social. En supposant que total_fans décrit le nombre total de fans depuis la création de ce profil, l'action diff vous permettra de calculer le nombre de nouveaux fans acquis ou perdus entre chaque jour.

diff

Veuillez noter que les premières dates de chaque id n'auront pas leur première valeur incrémentale calculée, car la date précédente n'est pas connue. Il existe un paramètre avancé optionnel si vous disposez de la date de création afin que la première date incrémentale soit calculée comme égale à l'attribut total.

Configuration de l'action

Interface de configuration de l'action

Lors de la configuration de l'action diff depuis l'interface, il vous sera demandé de spécifier :

  • le nom de table qui contient la valeur totale
  • l'attribut de timeline qui sera utilisé pour obtenir les incréments de temps entre 2 valeurs totales
  • la mesure à calculer, il peut y en avoir plusieurs pour une table donnée ; pour chacune, spécifiez l'attribut de valeur cumulative et l'attribut de valeur incrémentale

Les clés primaires de la table sont automatiquement assignées.

diff

Exemple de configuration JSON de l'action

Comme toute autre action du DPE, vous pouvez également configurer l'action en « Mode avancé » en éditant sa configuration JSON, dont un extrait est présenté ci-dessous.

{
    "table": "dwh/default_dataset/posts",
    "attribute_timeline": "date",
    "attribute_total": ["total_impressions"],
    "attribute_diff": ["incr_impressions"],
    
    "table_attribute_created_at": "ref_posts",
    "attribute_created_at": "post_createdat",
}

Paramètres de l'action

Voici une brève description de tous les attributs disponibles dans la configuration JSON.

ParamètreDescriptionExempleRequis
tableNom de la table sur laquelle exécuter l'action diffDwh/agr_site_dateOui
attribute_timelineNom de l'attribut de timelinedateOui
attribute_totalListe des noms d'attributs contenant des totaux.["total_impressions"]Oui
attribute_diffListe des noms d'attributs contenant des valeurs incrémentales.["incr_impressions"]Oui
table_attribute_created_atTable optionnelle contenant la date de création des idref_postsNon
attribute_created_atAttribut optionnel contenant la date de création des idpost_createdatNon

Aller plus loin

Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.

Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe la Data Platform sur le canal Discord dédié.

Si vous avez besoin d'une assistance concernant vos services OVHcloud, créez une demande depuis notre centre d'aide.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?