Utiliser des instantanés d’entité
Les instantanés d’entité fournissent aux administrateurs de nuage un enregistrement tabulaire du contenu, des utilisateurs et des relations qui composent votre site. Les journaux d’événements standard enregistrent ce qui s’est produit à un moment précis, tandis que les instantanés d’entité capturent l’état complet de tout ce qui existait alors. Les instantanés d’entité sont accessibles uniquement via l’API REST de Tableau Cloud Manager (TCM), et non par l’intégration S3 du journal d’activité.
Les instantanés d’entité vous permettent de surveiller et d’optimiser votre déploiement, d’automatiser la gestion du contenu et de vous assurer que votre site respecte les exigences de sécurité et de conformité.
Avant de commencer
Vous devez disposer d’une licence Tableau Enterprise ou Tableau+.
Vous devez posséder un rôle d’administrateur de nuage dans TCM.
Vous devez configurer un jeton d’accès personnel (PAT) ou un jeton d’accès unifié (UAT) pour authentifier vos sessions de l’API REST de TCM.
Instantanés d’entité c. journaux d’événements
Les instantanés d’entité et les journaux d’événements sont tous deux des outils administratifs utiles, mais ils répondent à des besoins différents. Pour déterminer quel type de données convient à votre cas d’utilisation, considérez ce qui suit :
| Instantanés d’entité | Journaux d’événements | |
|---|---|---|
| Objectif | Capture l’état complet du contenu du site, des utilisateurs et des relations à un moment précis. | Capture les actions et les activités des locataires et des sites à mesure qu’elles ont lieu. |
| 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 |
| Conservation 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 livrés sous forme de fichiers texte JSON |
| Access | API REST de Tableau Cloud Manager | API REST de Tableau Cloud Manager ou Amazon S3 |
Récupérer des instantanés d’entité
Pour récupérer les instantanés d’entité, utilisez les méthodes de données des plateformes 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 la plateforme(Le lien s’ouvre dans une nouvelle fenêtre).
Le processus de récupération comprend les étapes suivantes :
Authentifiez votre session à l’aide d’un PAT ou d’un UAT.
Identifiez le LUID (identifiant unique local) de votre site.
Générez des URL de téléchargement pour vos fichiers d’instantanés.
Comprendre le schéma d’instantané
Chaque téléchargement d’instantané contient un ensemble de tables, chacune représentant un type d’entité spécifique de votre site, comme les classeurs, les utilisateurs ou les projets. Pour connaître les attributs disponibles dans chaque table, consultez les définitions de schéma avant de créer des intégrations ou des tableaux de bord. Pour une 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és
Après avoir téléchargé vos fichiers d’instantanés, suivez les étapes ci-dessous pour stocker les données et les intégrer à vos flux de travail. 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 en sources ouvertes disponible sur GitHub.
Copier vers un stockage centralisé : téléversez vos fichiers dans un référentiel dans le nuage, comme Amazon S3, Azure ou Google Cloud Storage. Vous pouvez également utiliser le 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 comme Snowflake, Amazon Redshift ou Google BigQuery.
Créer des tableaux de bord de surveillance : combinez les données historiques de vos instantanés aux événements du journal d’activité dans Tableau ou dans d’autres outils analytiques pour créer des tableaux de bord de conformité et de performance des sites. Ces tableaux de bord peuvent également être partagés avec des utilisateurs qui ne sont pas administrateurs grâce à 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 connaître la fréquence de mise à jour et la conservation des données pour les événements du journal d’activité, consultez Fréquence de mise à jour des événements et conservation des données.