---
schema_version: "1"
id: af8a722e543e54d99f2989611104cccb26ce578da4fa07a044819fa52d563c74
title: 使用实体快照
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/online/activity_log_entity_snapshots.md
canonical_url: https://help.tableau.com/v0.0/online/zh-cn/activity_log_entity_snapshots.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 807810b5957131c891e9f0e711e3e8b95f6846e12c06ecad9843a381508d256c
description: 实体快照为云管理员提供组成站点的内容、用户和关系的表格记录。标准事件日志记录特定时刻发生的事件，而实体快照捕获当时存在的所有内容的完整状态。实体快照只能通过 Tableau Cloud Manager (TCM) REST API 获得，而不能通过活动日志 S3 集成获得。
---
[跳转到主要内容](#main-content)

# 使用实体快照

实体快照为云管理员提供组成站点的内容、用户和关系的表格记录。标准事件日志记录特定时刻发生的事件，而实体快照捕获当时存在的所有内容的完整状态。实体快照只能通过 Tableau Cloud Manager (TCM) REST API 获得，而不能通过活动日志 S3 集成获得。

使用实体快照，您可以监视和优化部署、自动进行内容管理，并确保您的站点满足安全性和合规性要求。

## 开始之前

- 您必须拥有 Tableau Enterprise 或 Tableau+ 许可证。
- 您必须在 TCM 中具有云管理员角色。
- 您必须配置个人访问令牌 (PAT) 或统一访问令牌 (UAT) 来验证您的 TCM REST API 会话。

## 实体快照与事件日志

实体快照和事件日志都是有价值的管理工具，但它们有不同的用途。若要确定哪种数据类型适合您的用例，请考虑以下事项：

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">&nbsp;</th><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">实体快照</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">事件日志</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>用途</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">捕获站点内容、用户和关系在特定时刻的完整状态。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">捕获跨租户和站点发生的动作和活动。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>更新频率</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每 60 分钟</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Tableau（默认值）：1 天</p><p>Advanced Management、Tableau Enterprise 和 Tableau+：不到 15 分钟</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>数据保留</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">14 天</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Tableau（默认值）：14 天</p><p>Advanced Management、Tableau Enterprise 和 Tableau+：最多 365 天</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>格式</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">以 Parquet 文件形式提供的表格数据集</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">以 JSON 文本文件形式提供的半结构化事件记录</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><b>Access</b></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Tableau Cloud Manager REST API</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Tableau Cloud Manager REST API 或 Amazon S3</td></tr></tbody></table>

## 检索实体快照

若要检索实体快照，请使用 Tableau Cloud Manager REST API 中的 `List entity snapshots for site` 和 `Get entity snapshots for site` 平台数据方法。有关详细信息，请参见[平台数据](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/platform_data.html)。

检索过程涉及以下步骤：

1. 使用 PAT 或 UAT 对会话进行身份验证。
2. 标识您的站点 LUID（本地唯一标识符）。
3. 为快照文件生成下载 URL。

## 了解快照架构

每个快照下载都包含一组表，其中每个表表示站点上的特定实体类型，例如工作簿、用户或项目。若要了解每个表中的可用属性，请在构建集成或仪表板之前查看架构定义。有关实体快照表的完整列表，请参见[实体快照参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_entity_snapshots_reference.htm)。

## 集成快照数据

下载快照文件后，完成这些步骤以存储数据并将其集成到您的工作流中。您也可以使用 [Tableau Cloud Platform Data Loader](https://github.com/tableau/tabcloud_platform_data_loader)（GitHub 上提供的开源工具）自动执行此过程。

1. **复制到集中存储**：将文件上载到云存储库，例如 Amazon S3、Azure 或 Google Cloud Storage。如果愿意，您也可以使用本地文件存储。
2. **导入到数据仓库**：将数据导入数据仓库，例如 Snowflake、Amazon Redshift 或 Google BigQuery。
3. **创建监控仪表板**：将您的历史快照数据与 Tableau 或其他分析工具中的活动日志事件相结合，以构建合规性和站点性能仪表板。这些仪表板还可以通过行级安全性与非管理员共享。

实体快照每 60 分钟刷新一次，并保留 14 天。有关活动日志事件的更新频率和数据保留，请参见[事件更新频率和数据保留](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm#update-frequency-and-data-retention)。