---
schema_version: "1"
id: 456a717facaa9a5768dceb0f942a96081ef2f1c8e39a6de1b66906dfdf45b6eb
title: 使用實體快照
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/online/activity_log_entity_snapshots.md
canonical_url: https://help.tableau.com/current/online/zh-tw/activity_log_entity_snapshots.htm
source_site: help.tableau.com
content_type: documentation
content_hash: e78bd54afefbaface02754525f30eeec719aa3f309126194568903814bba2b0e
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-tw/docs/platform_data.html)。

擷取流程涉及以下步驟：

1. 使用 PAT 或 UAT 對工作階段進行驗證。
2. 識別您的站台 LUID（本機唯一識別碼）。
3. 為快照檔案產生下載 URL。

## 瞭解快照結構描述

每個快照下載都包含一組資料表，其中每個資料表代表站台上的特定實體類型，例如工作簿、使用者或專案。要瞭解每個資料表中的可用屬性，請在建置整合或儀表板之前檢閱結構描述定義。有關實體快照表的完整清單，請參閱[實體快照參考](https://help.tableau.com/current/online/zh-tw/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/current/online/zh-tw/activity_log_overview.htm#update-frequency-and-data-retention)。