Utiliser des instantanés d’entité
Les instantanés d’entité fournissent aux administrateurs cloud un enregistrement tabulaire du contenu, des utilisateurs et des relations qui constituent votre site. Alors que les journaux d’événements standard enregistrent ce qui s’est passé à un moment précis, les instantanés d’entité capturent l’état complet de tout ce qui a existé à ce moment-là. Les instantanés d’entité sont disponibles uniquement via l’API REST de Tableau Cloud Manager (TCM), et non via l’intégration S3 du journal d’activité.
Avec les instantanés d’entité, vous pouvez surveiller et optimiser votre déploiement, automatiser la gestion du contenu et vérifier que votre site répond aux exigences de sécurité et de conformité.
Avant de commencer
Vous devez posséder une licence Tableau Enterprise ou Tableau+.
Vous devez avoir le rôle d’administrateur Cloud dans TCM.
Vous devez configurer un jeton d’accès personnel (PAT) ou un jeton d’accès unifié (UAT) pour authentifier vos sessions d’API REST TCM.
Instantanés d’entité et journaux d’événements
Les instantanés d’entité et les journaux d’événements sont tous deux des outils administratifs précieux, mais ils servent des objectifs différents. Pour déterminer le type de données adapté à votre cas d’utilisation, considérez les points suivants :
| Instantanés d’entité | Journaux d’événements | |
|---|---|---|
| Objectif | Capture l’état complet du contenu du site, des utilisateurs et des relations à un moment donné. | Capture les actions et activités des locataires et des sites au fur et à mesure qu’elles se produisent. |
| Fréquence de mise à jour | Toutes les 60 minutes | Tableau (par défaut) : 1 jour Advanced Management, Tableau Enterprise et Tableau+ : moins de 15 minutes |
| Rétention des données | 14 jours | Tableau (par défaut) : 14 jours Advanced Management, Tableau Enterprise et Tableau+ : jusqu’à 365 jours |
| Format | Ensembles de données tabulaires livrés sous forme de fichiers Parquet | Enregistrements d’événements semi-structurés fournis sous forme de fichiers texte JSON |
| Accès | API REST de Tableau Cloud Manager | API REST de Tableau Cloud Manager ou Amazon S3 |
Récupérer les instantanés d’entité
Pour récupérer des instantanés d’entité, utilisez les méthodes de données de plate-forme List entity snapshots for site et Get entity snapshots for site dans l’API REST de Tableau Cloud Manager. Pour plus d’informations, consultez Données de plate-forme(Le lien s’ouvre dans une nouvelle fenêtre).
Le processus de récupération implique les étapes suivantes :
Authentifiez votre session à l’aide d’un jeton PAT ou UAT.
Identifiez le LUID (identifiant local unique) de votre site.
Générez des URL de téléchargement pour vos fichiers d’instantané.
Comprendre le schéma de l’instantané
Chaque téléchargement d’instantané contient un ensemble de tables, où chaque table représente un type d’entité spécifique sur votre site, tel que des classeurs, des utilisateurs ou des projets. Pour comprendre les attributs disponibles dans chaque table, passez en revue les définitions de schéma avant de créer des intégrations ou des tableaux de bord. Pour obtenir la liste complète des tables d’instantanés d’entité, consultez Référence des instantanés d’entité.
Intégrer les données d’instantané
Après avoir téléchargé vos fichiers d’instantané, effectuez ces étapes pour stocker les données et les intégrer dans vos workflows. Vous pouvez également automatiser ce processus à l’aide de Tableau Cloud Platform Data Loader(Le lien s’ouvre dans une nouvelle fenêtre), un outil open source disponible sur GitHub.
Copier sur un stockage centralisé : téléchargez vos fichiers dans un référentiel cloud, tel qu’Amazon S3, Azure ou Google Cloud Storage. Vous pouvez également utiliser un stockage de fichiers local si vous préférez.
Importer dans des entrepôts de données : importez les données dans des entrepôts de données tels que Snowflake, Amazon Redshift ou Google BigQuery.
Créer des tableaux de bord de surveillance : combinez vos données d’instantanés historiques avec les événements du journal d’activité dans Tableau ou d’autres outils d’analyse pour créer des tableaux de bord de conformité et de performances des sites. Ces tableaux de bord peuvent également être partagés avec des non-administrateurs via la sécurité au niveau des lignes.
Les instantanés d’entité sont actualisés toutes les 60 minutes et sont conservés pendant 14 jours. Pour la fréquence de mise à jour et la rétention des données pour les événements du journal d’activité, consultez Fréquence de mise à jour des événements et rétention des données.