使用实体快照
实体快照为云管理员提供组成站点的内容、用户和关系的表格记录。标准事件日志记录特定时刻发生的事件，而实体快照捕获当时存在的所有内容的完整状态。实体快照只能通过 Tableau Cloud Manager (TCM) REST API 获得，而不能通过活动日志 S3 集成获得。
使用实体快照，您可以监视和优化部署、自动进行内容管理，并确保您的站点满足安全性和合规性要求。
开始之前
您必须拥有 Tableau Enterprise 或 Tableau+ 许可证。
您必须在 TCM 中具有云管理员角色。
您必须配置个人访问令牌 (PAT) 或统一访问令牌 (UAT) 来验证您的 TCM REST API 会话。
实体快照与事件日志
实体快照和事件日志都是有价值的管理工具，但它们有不同的用途。若要确定哪种数据类型适合您的用例，请考虑以下事项：
| 实体快照 | 事件日志 | |
|---|---|---|
| 用途 | 捕获站点内容、用户和关系在特定时刻的完整状态。 | 捕获跨租户和站点发生的动作和活动。 |
| 更新频率 | 每 60 分钟 | Tableau（默认值）：1 天 Advanced Management、Tableau Enterprise 和 Tableau+：不到 15 分钟 |
| 数据保留 | 14 天 | Tableau（默认值）：14 天 Advanced Management、Tableau Enterprise 和 Tableau+：最多 365 天 |
| 格式 | 以 Parquet 文件形式提供的表格数据集 | 以 JSON 文本文件形式提供的半结构化事件记录 |
| Access | Tableau Cloud Manager REST API | Tableau Cloud Manager REST API 或 Amazon S3 |
检索实体快照
若要检索实体快照，请使用 Tableau Cloud Manager REST API 中的 List entity snapshots for site 和 Get entity snapshots for site 平台数据方法。有关详细信息，请参见平台数据(链接在新窗口中打开)。
检索过程涉及以下步骤：
使用 PAT 或 UAT 对会话进行身份验证。
标识您的站点 LUID（本地唯一标识符）。
为快照文件生成下载 URL。
了解快照架构
每个快照下载都包含一组表，其中每个表表示站点上的特定实体类型，例如工作簿、用户或项目。若要了解每个表中的可用属性，请在构建集成或仪表板之前查看架构定义。有关实体快照表的完整列表，请参见实体快照参考。
集成快照数据
下载快照文件后，完成这些步骤以存储数据并将其集成到您的工作流中。您也可以使用 Tableau Cloud Platform Data Loader(链接在新窗口中打开)（GitHub 上提供的开源工具）自动执行此过程。
复制到集中存储：将文件上载到云存储库，例如 Amazon S3、Azure 或 Google Cloud Storage。如果愿意，您也可以使用本地文件存储。
导入到数据仓库：将数据导入数据仓库，例如 Snowflake、Amazon Redshift 或 Google BigQuery。
创建监控仪表板：将您的历史快照数据与 Tableau 或其他分析工具中的活动日志事件相结合，以构建合规性和站点性能仪表板。这些仪表板还可以通过行级安全性与非管理员共享。
实体快照每 60 分钟刷新一次，并保留 14 天。有关活动日志事件的更新频率和数据保留，请参见事件更新频率和数据保留。