# tableau Tableau Cloud (online) - Full Documentation

<!-- document id=12cc0e6ad33401291d268483e1c89660b816a8e1a11d56e723782d15cc693cce url=/tableau/next/zh-cn/online/adminview_insights_events.md -->

[跳转到主要内容](#main-content)

# “TS 事件”数据源

TS 事件充当主审核数据源。它包含有关站点上发生的各种事件的数据，包括登录、发布和访问的视图。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：哪些视图最常用？

使用以下步骤创建一个视图，其中显示站点上最常用的视图。

1. 连接到“TS 事件”数据源。
2. 从“数据”窗格中，将“Item Name”（项名称）拖到“行”功能区，并将“Number of Events”（事件数）拖到“列”功能区。
3. 从“数据”窗格中，将“Item Type”（项类型）拖到“筛选器”功能区，然后选中“视图”复选框。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将 TS 事件与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“参与者用户 ID = 用户 ID”上将 TS 事件联接到 TS 用户
- 在“项 ID = 项 ID”和“项类型 = 项类型”上将 TS 事件联接到站点内容

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“TS 事件”数据源中包含的字段。每行数据与 Tableau Cloud 站点上发生的单个事件相关。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="5">Who Acted</td><td>Actor License Role</td><td>字符串</td><td>发起事件的用户的许可证角色； Creator、Explorer 或 Viewer（查看者）之一。</td></tr><tr><td>Actor Site Role</td><td>字符串</td><td>启动事件的用户的站点角色</td></tr><tr><td>Actor User Id</td><td>数字</td><td>启动事件的用户的用户 ID。</td></tr><tr><td>Actor User Name</td><td>字符串</td><td>启动事件的用户的电子邮件地址</td></tr><tr><td>Target User Id</td><td>数字</td><td>事件目标用户的用户 ID。</td></tr><tr><td rowspan="14">What Was Acted Upon</td><td>Historical Item Name</td><td>字符串</td><td>执行事件时针对其执行事件的数据源或工作簿的名称。</td></tr><tr><td>Historical Item Repository Url</td><td>字符串</td><td><p>针对其执行事件的数据源、工作簿或视图的唯一 URL 样式路径。</p><p>此值保留了事件执行期间某一项的历史路径。</p></td></tr><tr><td>Historical Project Name</td><td>字符串</td><td>发生事件的项目名称，与事件发生时的名称一致。</td></tr><tr><td>Item Id</td><td>数字</td><td>针对其执行事件的数据源、工作簿或视图的 ID。</td></tr><tr><td>Item LUID</td><td>字符串</td><td>针对其执行事件的数据源、工作簿或视图的 LUID。</td></tr><tr><td>Item Type</td><td>字符串</td><td>如果事件针对内容执行，则值为数据源、工作簿或视图。如果事件不是针对内容执行的，则项类型将为 NULL。</td></tr><tr><td>Item Name</td><td>字符串</td><td><p>订阅中包含的项的显示名称。</p><p>针对其执行事件的数据源或工作簿的当前名称。</p></td></tr><tr><td>Item Owner Email</td><td>字符串</td><td><p>项所有者的电子邮件地址。</p><p>当前拥有执行事件的视图、数据源或工作簿的用户的电子邮件。</p></td></tr><tr><td>Item Owner Id</td><td>数字</td><td>当前拥有执行事件的视图、数据源或工作簿的用户的 ID。</td></tr><tr><td>Item Repository Url</td><td>字符串</td><td><p>针对其执行事件的数据源、工作簿或视图的唯一 URL 样式路径。</p><p>此值描述了项可用的当前路径。如果事件不是针对上面列出的三个项目之一执行的，或者该项已被删除，则它将为 NULL。</p></td></tr><tr><td>Project Name</td><td>字符串</td><td>如果事件针对内容执行，则为发生事件的项目的当前名称。</td></tr><tr><td>Site Luid</td><td>字符串</td><td>发生事件的站点的 Luid</td></tr><tr><td>Site Name</td><td>字符串</td><td>发生事件的站点的名称</td></tr><tr><td>Workbook Name</td><td>字符串</td><td>执行事件时针对其执行事件的工作簿的名称。</td></tr><tr><td rowspan="5">What Action Was Taken</td><td>Event Date</td><td>日期时间</td><td>相关事件发生的日期和时间 (UTC)。</td></tr><tr><td>Event Date (local)</td><td>日期时间</td><td><p>相关事件发生的日期和时间，根据您设置的时区参数进行调整。</p><p><b>注意：</b>对于较旧的数据，如果您的时区使用夏令时，那么这样的简单调整将是不准确的。</p></td></tr><tr><td>Event Id</td><td>数字</td><td>事件的唯一标识符。</td></tr><tr><td>Event Name</td><td>字符串</td><td>发生的特定事件的名称。</td></tr><tr><td>Event Type</td><td>字符串</td><td>事件分组为动作类型，例如“创建”、“访问”、“更新”和“删除”。</td></tr><tr><td rowspan="3">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Count of Distinct Actors</td><td>计算字段</td><td>代表唯一参与者（发起事件的用户）计数的度量。</td></tr><tr><td>Number of Events</td><td>计算字段</td><td>表示事件总数的度量</td></tr></tbody></table>

<!-- document id=46ea52046cec12c2e8bb0e63b0e7058740062fb17483bb25025042a6e4a2d46f url=/tableau/next/zh-cn/online/adminview_insights_users.md -->

[跳转到主要内容](#main-content)

# “TS 用户”数据源

TS 用户包含用户相关数据，例如剩余许可证、站点角色以及用户拥有的工作簿。从 2023 年 5 月开始，TS 用户包含 Tableau Desktop、Tableau Prep、Web 制作和站点角色特定功能的产品激活和使用数据。

如果用户的站点角色更改为未许可，他们的信息仍保留在“TS 用户”数据源中。然而，当从站点中移除用户时，他们的信息也会在 36 小时内从“TS 用户”中移除。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：有多少许可证正在使用？

使用以下步骤创建显示已使用许可证数量的视图。

1. 连接到“TS 用户”数据源。
2. 从“数据”窗格中，将“Measure Names”（度量名称）拖到“行”功能区，并将“Measure Values”（度量值）拖到“列”功能区。
3. 在“行”功能区中右键单击“Measure Names”（度量名称）字段，并选择“显示筛选器”。
4. 单击“Measure Names”（度量名称）筛选器下拉菜单，并选择“自定义”\>“显示应用按钮”。
5. 在筛选器中，选中“Total Allowed Licenses”（允许的许可证总数）和“Total Occupied Licenses”（占用的许可证总数）复选框，然后单击“应用”。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“TS 用户”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“用户 LUID = 用户 LUID”上将 TS 用户联接到组
- 在“用户 ID = 演员用户 ID”上将 TS 用户联接到 TS 事件
- 在“用户电子邮件 = 所有者电子邮件”或“用户电子邮件 = 项父项目所有者电子邮件”上将 TS 用户联接到站点内容

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“TS 用户”数据源中包含的字段。每行数据对应 Tableau Cloud 站点上的唯一用户。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="9">License Utilization</td><td>Allowed Creators</td><td>数字</td><td>允许的 Creator 许可证总数</td></tr><tr><td>Allowed Explorers</td><td>数字</td><td>已购买的 Explorer 许可证总数</td></tr><tr><td>Allowed Viewers</td><td>数字</td><td>购买的 Viewer（查看者）许可证总数</td></tr><tr><td>Occupied Creator Licenses</td><td>计算字段</td><td>已占用 Creator 许可证的数量</td></tr><tr><td>Occupied Explorer Licenses</td><td>计算字段</td><td>已占用的 Explorer 许可证数量</td></tr><tr><td>Occupied Viewer Licenses</td><td>计算字段</td><td>已占用的 Viewer（查看者）许可证数量</td></tr><tr><td>Total Allowed Licenses</td><td>数字</td><td><p>允许的许可证总数</p></td></tr><tr><td>Total Occupied Licenses</td><td>计算字段</td><td>已占用的许可证总数</td></tr><tr><td>Total Remaining Licenses</td><td>计算字段</td><td>剩余许可证总数</td></tr><tr><td rowspan="3">Site</td><td>Site Luid</td><td>字符串</td><td>与用户关联的站点的 LUID。主要用于引用 Tableau Server API 中的站点。</td></tr><tr><td>Site Name</td><td>字符串</td><td>Tableau Cloud 站点的名称</td></tr><tr><td>Site Version</td><td>字符串</td><td>托管您的站点的 Tableau Cloud pod 上运行的 Tableau Server 版本</td></tr><tr><td rowspan="4">Traffic to Content - Historical</td><td>Total Traffic - Data Sources</td><td>数字</td><td><p>用户数据源被访问的总次数</p></td></tr><tr><td>Total Traffic - Views</td><td>数字</td><td>用户视图被访问的总次数</td></tr><tr><td>Unique Visitors - Data Sources</td><td>数字</td><td><p>访问用户数据源的唯一用户数</p></td></tr><tr><td>Unique Visitors - Views</td><td>数字</td><td>访问过该用户视图的唯一用户数</td></tr><tr><td rowspan="8">User</td><td>User Creation Date</td><td>日期时间</td><td>用户帐户的创建日期和时间 (UTC)</td></tr><tr><td>User Email</td><td>字符串</td><td>与用户帐户关联的电子邮件地址</td></tr><tr><td>User Friendly Name</td><td>字符串</td><td>与用户帐户关联的用户友好名称</td></tr><tr><td>User ID</td><td>数字</td><td>用户的内部 ID</td></tr><tr><td>User License Type</td><td>字符串</td><td><p>与用户关联的基于用户的许可证：Viewer（查看者）、Explorer 或 Creator。</p></td></tr><tr><td>User LUID</td><td>字符串</td><td>用户的 LUID。主要用于在 Tableau Server API 中引用用户</td></tr><tr><td>User Name</td><td>字符串</td><td>与用户帐户关联的用户名。</td></tr><tr><td>User Site Role</td><td>字符串</td><td>用户的站点角色。确定用户可在站点上具有的最高访问权限级别。</td></tr><tr><td rowspan="4">User Activity - Historical</td><td>Access Events - Data Sources</td><td>数字</td><td>用户访问已发布数据源的次数。</td></tr><tr><td>Access Events - Views</td><td>数字</td><td>用户访问视图的次数。</td></tr><tr><td>Publish Events - Data Sources</td><td>数字</td><td>用户发布数据源的次数。</td></tr><tr><td>Publish Events - Workbooks</td><td>数字</td><td>用户发布工作簿的次数。</td></tr><tr><td rowspan="13">User Activity - Most Recent Event</td><td>Data Source - Last Access Date</td><td>日期时间</td><td>用户上次访问已发布数据源的日期和时间 (UTC)</td></tr><tr><td>Data Source - Last Publish Date</td><td>日期时间</td><td>用户上次发布已发布数据源的日期和时间 (UTC)</td></tr><tr><td>Last Login Date</td><td>日期时间</td><td>用户上次登录的日期和时间 (UTC)。</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> - Last Access Date</td><td>日期时间</td><td>用户上次从 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 连接到 Tableau Cloud 的日期和时间 (UTC)。仅在使用基于登录名的许可证管理 (LBLM) 激活 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 时记录。</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> - Last Access Date (Local)</td><td>日期时间</td><td>用户上次从 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 连接到 Tableau Cloud 的日期和时间，由时区参数调整。仅在使用基于登录名的许可证管理 (LBLM) 激活 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 时记录。</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> - 最新产品版本</td><td>字符串</td><td>上次用于连接到 Tableau Cloud 的 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 版本。仅在使用基于登录名的许可证管理 (LBLM) 激活 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 时记录。</td></tr><tr><td>Tableau Prep - Last Access Date</td><td>日期时间</td><td>用户上次从 Tableau Prep 连接到 Tableau Cloud 的日期和时间 (UTC)。仅在使用基于登录名的许可证管理 (LBLM) 激活 Tableau Prep 时记录。</td></tr><tr><td>Tableau Prep - Last Access Date (Local)</td><td>日期时间</td><td>用户上次从 Tableau Prep 连接到 Tableau Cloud 的日期和时间，由时区参数调整。仅在使用基于登录名的许可证管理 (LBLM) 激活 Tableau Prep 时记录。</td></tr><tr><td>Tableau Prep - Last Product Version</td><td>字符串</td><td>上次用于连接到 Tableau Cloud 的 Tableau Prep 的版本。仅在使用基于登录名的许可证管理 (LBLM) 激活 Tableau Prep 时记录。</td></tr><tr><td>View - Last Access Date</td><td>日期时间</td><td>用户上次访问视图的日期和时间 (UTC)。</td></tr><tr><td>Web Authoring - Last Access Date</td><td>日期时间</td><td>用户上次访问 Web 制作环境的日期和时间 (UTC)。</td></tr><tr><td>Web Authoring - Last Access Date (Local)</td><td>日期时间</td><td>用户上次访问 Web 制作环境的日期和时间，由时区参数调整。</td></tr><tr><td>Web Authoring - Last Publish Date</td><td>日期时间</td><td>用户上次发布工作簿的日期和时间 (UTC)</td></tr><tr><td rowspan="7">User Content</td><td>Certified Data Sources</td><td>数字</td><td>用户拥有的经过认证的数据源的数量。</td></tr><tr><td>Data Sources</td><td>数字</td><td>用户拥有的已发布数据源数量</td></tr><tr><td>Projects</td><td>数字</td><td>用户拥有的项目数量。</td></tr><tr><td>Size of Data Sources (MB)</td><td>数字</td><td>用户拥有的所有已发布数据源的总大小 (MB)。</td></tr><tr><td>Size of Workbooks (MB)</td><td>数字</td><td>用户拥有的所有工作簿的总大小 (MB)。</td></tr><tr><td>Views</td><td>数字</td><td>用户拥有的视图数量。</td></tr><tr><td>Workbooks</td><td>数字</td><td>用户拥有的工作簿数量。</td></tr><tr><td rowspan="2">User Metrics</td><td>Days Since Last Login</td><td>数字</td><td>自用户上次登录以来的天数。</td></tr><tr><td>User Account Age</td><td>数字</td><td>用户帐户创建后的天数</td></tr><tr><td>-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr></tbody></table>

<!-- document id=4eb38bd8d48bf8c3d713988fb0087cf6145c46dd25939db53f56015acd79e72d url=/tableau/next/zh-cn/online/adminview_insights_tokens.md -->

[跳转到主要内容](#main-content)

# “令牌”数据源

令牌包含有关站点上活动的、未过期的用户令牌的信息，包括个人访问令牌 (PAT)、刷新令牌和 OAuth 令牌。站点管理员可以通过数据源监控令牌的使用情况和过期情况，根据需要轮换必要的令牌。

数据源中包含以下标记：

- **OAuth 数据库** - 管理用于 OAuth 连接的访问令牌。令牌在 Tableau Cloud 用户将其删除或数据提供程序撤销它之前一直有效。有关详细信息，请参见 [OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm)。
- **OAuth 客户端** - 管理连接的客户端（例如 Tableau Desktop 和 Tableau Prep）使用的刷新令牌。有关详细信息，请参见[从连接的客户端中访问站点](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm)。
- **个人访问令牌 (PAT)** - 管理用于登录 Tableau Cloud 的长期身份验证令牌，例如使用 Tableau REST API 创建的自动化脚本和任务。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。

站点管理员可以随时通过取消使用不需要的令牌的用户许可来快速撤销令牌。需要注意的是，当用户重新获得许可时必须创建新的令牌。有关移除或撤销特定类型令牌的步骤，请点击上一节中的链接。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例： OAuth 数据库令牌上次更新是什么时候？

使用以下步骤创建一个视图，用于测量 OAuth 数据库令牌的最后更新时间以及组织内的令牌轮换合规性。

1. 连接到“令牌”数据源。
2. 从“数据”窗格中，将“令牌类型”拖到“筛选器”功能区。选择“OAuth 数据库”，并单击“确定”。
3. 将“数据库类型” 、 “数据库用户名”和“上次更新时间”拖到“行”功能区。
4. 在“行”功能区上，右键单击“上次更新时间” ，然后从上下文菜单中选择“确切日期” 。将字段从连续更改为离散。
5. 从菜单中，选择“分析”\>“创建计算字段”。
    
    1. 名称：自上次更新以来的天数
    2. 计算：
        
        ```
        ROUND(TODAY()-[Last Updated])
        ```
6. 单击“确定”。
7. 从“数据”窗格中，将“自上次更新以来的天数”拖到“行”功能区。将字段从连续更改为离散。

### 示例：嵌入式 OAuth 数据库令牌何时过期？

为了防止视图加载错误和数据提取刷新失败等中断，监控嵌入式 OAuth 数据库令牌的过期情况非常重要。使用以下步骤创建一个视图来标识即将过期的令牌，使用户能够主动刷新其凭据。

**注意：**Tableau 不存储 OAuth 数据库令牌的过期时间。若要获取此信息，请联系您的数据库管理员以验证每种数据库类型的到期详细信息。

1. 连接到“令牌”数据源。
2. 从“数据”窗格中，将“令牌类型”拖到“筛选器”功能区。选择“OAuth 数据库”，并单击“确定”。
3. 将“数据库类型”和“所有者电子邮件”拖到“行”功能区。
4. 从菜单中，选择“分析”\>“创建计算字段”。在此示例中，我们使用有效期为 90 天的 Snowflake 数据库。
    
    1. 名称：`Expires At (all tokens)`
    2. 计算：
        
        IF \[Token Type\] = 'OAuth Database'  
        THEN  
        IF \[Database Type\] = 'snowflake'  
        THEN DATEADD('day', 90, \[Last Updated\])  
        // add conditions for other database types here //  
        ELSE NULL  
        END  
        ELSE \[Expires At\]  
        END
5. 从菜单中，选择“分析”\>“创建计算字段”。
    
    1. 名称：`Days Until Expiration`
    2. 计算：
        
        DATEDIFF('day', TODAY(), \[Expires At (all tokens)\])
6. 将“过期前的天数”拖到“行”功能区。将字段从连续更改为离散。
7. 将“到期前的天数”拖到“筛选器”功能区。选择“所有值”，将最大值设置为 14。这会筛选未来 14 天内到期或已过期的令牌。根据需要进行调整。
8. 使用结果值联系令牌设置为即将过期的用户。

### 示例：哪些用户在站点上拥有 PAT？

以下示例显示在站点上拥有 PAT 的用户的名称和站点角色。您可以调整其他令牌类型的筛选器。

1. 连接到“令牌”和“TS 用户”数据源。
2. 选择“数据”\>“编辑混合关系”。
3. 在“混合关系”对话框中，将主数据源设置为“Tokenss”（令牌），然后选择“自定义”单选按钮。
4. 单击“添加”。
5. 在“添加/编辑字段映射”对话框中，将“Owner Email”（所有者电子邮件）映射到“AUser Email”（用户电子邮件），然后单击“确定”\>“确定”。
6. 从“数据”窗格中，将“令牌类型”拖到“筛选器”功能区。选中“PAT”复选框，并单击“确定”。
7. 从“数据”窗格中，将“用户名” 、 “用户站点角色” 、 “过期时间”和“上次使用时间”拖到“行”功能区。
8. 验证“用户电子邮件”是“数据”窗格中的链接字段。如果有断开的链接，请单击字段名称旁边的图标来链接两个数据源。
9. 在“行”功能区上，右键单击“过期时间” ，然后从上下文菜单中选择“确切日期” 。将字段从连续更改为离散。
10. 对“上次使用时间”重复步骤 7。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“令牌”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 若要查看令牌所有者的站点角色，请基于“所有者电子邮件”=“用户电子邮件”将令牌联接到 TS 用户
- 若要查看令牌所有者的组成员身份，请基于“所有者电子邮件”=“用户电子邮件”将令牌联接到组

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“令牌”数据源中包含的字段。每行数据对应“令牌 ID”和“所有者电子邮件”的组合。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="5">Database</td><td>Asset Key ID</td><td>数字</td><td>数据库条目的 ID。适用于 OAuth 数据库令牌。</td></tr><tr><td>Database Type</td><td>字符串</td><td>数据库的类型，例如 Salesforce、Snowflake 等。适用于 OAuth 数据库令牌。</td></tr><tr><td>Database User Name</td><td>字符串</td><td>连接到数据库的用户的名称。适用于 OAuth 数据库令牌。</td></tr><tr><td>Instance URL</td><td>字符串</td><td>数据提供程序的实例 URL，例如 https://login.salesforce.com。适用于 OAuth 数据库令牌。</td></tr><tr><td>Last Updated</td><td>日期时间</td><td>数据源凭据上次更改的日期和时间 (UTC)。适用于 OAuth 数据库令牌。</td></tr><tr><td rowspan="2">Devices</td><td>Device ID</td><td>字符串</td><td>与令牌关联的已连接客户端的 ID。适用于 OAuth 客户端令牌。</td></tr><tr><td>Device Name</td><td>字符串</td><td>与令牌关联的已连接客户端的名称。适用于 OAuth 客户端令牌。</td></tr><tr><td rowspan="2">Site</td><td>Site LUID</td><td>字符串</td><td>Tableau Cloud 站点的 LUID。主要用于通过 REST API 引用内容。</td></tr><tr><td>Site Name</td><td>字符串</td><td>Tableau Cloud 站点的名称。</td></tr><tr><td rowspan="8">Token</td><td>Expires At</td><td>日期时间</td><td>令牌过期的日期和时间 (UTC)。适用于 PAT 和 OAuth 客户端令牌。</td></tr><tr><td>GUID</td><td>字符串</td><td>令牌的唯一 ID。适用于 PAT 和 OAuth 客户端令牌。</td></tr><tr><td>Issued At</td><td>日期时间</td><td>令牌发行的日期和时间 (UTC)。</td></tr><tr><td>Last Used At</td><td>日期时间</td><td>令牌上次使用的日期和时间 (UTC)。适用于 PAT 和 OAuth 客户端令牌。</td></tr><tr><td>Owner Email</td><td>字符串</td><td>令牌所有者的电子邮件地址。</td></tr><tr><td>PAT Name</td><td>字符串</td><td>个人访问令牌的名称。适用于 PAT。</td></tr><tr><td>Token Identifier</td><td>字符串</td><td>使用 PAT 和 OAuth 客户端令牌的 GUID 以及 OAuth 数据库令牌的资产密钥 ID 唯一地标识一行数据。</td></tr><tr><td>Token Type</td><td>字符串</td><td>令牌类型的枚举值。个人访问令牌 (PAT)、OAuth 客户端或 OAuth 数据库。</td></tr><tr><td>-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)。</td></tr></tbody></table>

<!-- document id=6e4c9fa8f0727e6d1ac7503ff36afd38103b3a3d9d67d69f677f90b2de48578d url=/tableau/next/zh-cn/online/adminview_insights_job_performance.md -->

[跳转到主要内容](#main-content)

# “作业性能”数据源

“作业性能”包含事件和站点上后台作业的运行时信息，例如数据提取刷新和流程运行。从 2023 年 5 月开始，作业性能包括 Tableau Bridge 刷新数据，其中包括 Bridge 客户端名称、池化数据以及刷新开始和完成时间。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：站点上发生了多少次数据提取刷新和流程运行？

使用以下步骤创建一个视图，显示站点上发生的数据提取刷新和流程运行的总次数。

1. 连接到“作业性能”数据源。
2. 从“数据”窗格中，将“Item Name”（项名称）、“Item Type”（项类型）、“Owner Email”（所有者电子邮件）和“Job Type”（作业类型）拖到“行”功能区。
3. 在“行”功能区上，右键单击“Item Name”（项名称），并选择“排序”。
4. 在“排序”对话框中，选择“排序依据”\>“字段”和“字段名称”\>“Job ID”（作业 ID）。关闭该对话框。
5. 从“数据”窗格中，将“Started At (local)”（开始时间(本地)）拖到“列”功能区。
6. 在“列”功能区中，右键单击“Started At (local)”（开始时间(本地)），并选择“确切日期”。这会将维度转换为度量。
7. 从“数据”窗格中，将“Job Result”（作业结果）拖到“颜色”，并将“Job Execution Duration (Days)”（作业执行持续时间(天)）拖到“标记”卡上的“大小”。

### 示例：平均作业排队持续时间是多少？

使用以下步骤创建显示平均作业排队持续时间的视图。

1. 连接到“作业性能”数据源。
2. 从“数据”窗格中，将“Started At”（开始时间）拖到“列”功能区，并将“Started At (local)”（开始时间(本地)）拖到“行”功能区。
3. 在“列”功能区中，右键单击“Started At”（开始时间），并从第二组值中选择“Date”（日期）（即 2022 年 5 月 11 日）。这会将字段转换为度量。
4. 在“行”功能区中，右键单击“Started At (local)”（开始时间(本地)），然后从第一组值中选择“更多”\>“Hour”（小时）（即 9）。
5. 在“标记”卡上，从“形状”下拉菜单中选择“方形”。
6. 从“数据”窗格中，将“Job Queued Duration”（作业排队持续时间）拖到“标记”卡上的“颜色”。右键单击字段，并选择“度量”\>“平均值”。
7. 从“数据”窗格中，将“Job ID””（作业 ID）拖到“标记”卡上的“大小”。右键单击字段，并选择“度量”\>“计数(不重复)”。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“作业性能”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“项 ID = 项 ID”上将作业性能联接到站点内容

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“作业性能”数据源中包含的字段。每行数据对应唯一的后台作业和相关的内容项，提供有关作业状态、持续时间和错误详细信息的信息。

**注意：**“作业性能”数据源不包括虚拟连接信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="9">Bridge</td><td>代理是否已池化？</td><td>字符串</td><td>指示 Bridge 客户端是否属于池的一部分</td></tr><tr><td>Agent Name</td><td>字符串</td><td>执行刷新的 Bridge 客户端的名称</td></tr><tr><td>Agent Timezone</td><td>字符串</td><td>Bridge 客户端的时区</td></tr><tr><td>Agent Version</td><td>字符串</td><td>计算机上部署的 Bridge 版本</td></tr><tr><td>Bridge Error Message</td><td>字符串</td><td>与失败请求相关的错误消息</td></tr><tr><td>Bridge Error Type</td><td>字符串</td><td>刷新错误的类型</td></tr><tr><td>Bridge Initiator User Name</td><td>字符串</td><td>（通过计划任务或手动运行）发起刷新请求的用户</td></tr><tr><td>Bridge Job Result</td><td>字符串</td><td>Bridge 刷新作业的结果。“成功”或“失败”。</td></tr><tr><td>Pool Name</td><td>字符串</td><td>与 Bridge 客户端关联的池的名称</td></tr><tr><td rowspan="14">Dates</td><td>Bridge Completed At</td><td>日期时间</td><td>Bridge 刷新完成的日期和时间 (UTC)</td></tr><tr><td>Bridge Completed At (Local)</td><td>日期时间</td><td>Bridge 刷新完成的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Bridge Started At</td><td>日期时间</td><td>Bridge 刷新开始的日期和时间 (UTC)</td></tr><tr><td>Bridge Started At (Local)</td><td>日期时间</td><td>Bridge 刷新开始的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Completed At</td><td>日期时间</td><td>作业完成的日期和时间 (UTC)</td></tr><tr><td>Completed At (Local)</td><td>日期时间</td><td>作业完成的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Created At</td><td>日期时间</td><td>创建作业的日期和时间 (UTC)</td></tr><tr><td>Created At (Local)</td><td>日期时间</td><td>创建作业的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Overflow Queued At</td><td>日期时间</td><td>作业进入溢出队列的日期和时间 (UTC)。这仅适用于计入并发作业容量的作业。对于其他作业，它为 NULL。</td></tr><tr><td>Overflow Queued At (Local)</td><td>日期时间</td><td>作业进入溢出队列的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Queued At</td><td>日期时间</td><td>作业进入队列的日期和时间 (UTC)。这仅适用于不计入并发作业容量的作业。对于其他作业，它为 NULL。</td></tr><tr><td>Queued At (Local)</td><td>日期时间</td><td>作业进入队列的日期和时间，通过 Timezone 参数调整。不考虑夏令时。</td></tr><tr><td>Started At</td><td>日期时间</td><td>作业开始的日期和时间 (UTC)</td></tr><tr><td>Started At (Local)</td><td>日期时间</td><td>作业开始的日期和时间，由时区参数调整。不考虑夏令时。</td></tr><tr><td>Hyperlinks</td><td>Item Hyperlink</td><td>字符串</td><td>站点上项的完整 URL</td></tr><tr><td rowspan="7">Item</td><td>Item ID</td><td>字符串</td><td>与作业相关的项的 ID。ID 在每个项类型和站点内都是唯一的。</td></tr><tr><td>Item LUID</td><td>字符串</td><td>项的 LUID。LUID 在每个项类型和站点内都是唯一的。主要用于通过 REST API 引用内容。</td></tr><tr><td>Item Name</td><td>字符串</td><td>对于数据源、流程和工作簿，指作业与其相关的项的显示名称。</td></tr><tr><td>Item Type</td><td>字符串</td><td>作业与其相关的项的类型。数据源、流程、工作簿或视图。</td></tr><tr><td>Owner Email</td><td>字符串</td><td>项所有者的电子邮件地址</td></tr><tr><td>Parent Project Name</td><td>字符串</td><td>此项的父项目的项名称。</td></tr><tr><td>Parent Project Owner Email</td><td>字符串</td><td>该项所在父项目（如果有）所有者的电子邮件地址。</td></tr><tr><td rowspan="11">Job</td><td>Error Message</td><td>字符串</td><td>与作业相关的运行时详细信息，例如 ID、状态和错误消息</td></tr><tr><td>Final Job Result</td><td>字符串</td><td>后台作业的最终结果，即“成功”或“失败”。</td></tr><tr><td>Job ID</td><td>字符串</td><td>生成的作业的 ID。每个作业类型和站点的 ID 都是唯一的。</td></tr><tr><td>Job LUID</td><td>字符串</td><td>作业的 LUID。每个作业类型和站点的 LUID 都是唯一的。主要用于通过 REST API 引用内容。</td></tr><tr><td>Job Result</td><td>字符串</td><td>后台作业的结果，即“成功”或“失败”。</td></tr><tr><td>Job Type</td><td>字符串</td><td>作业的类型。数据提取刷新、增量刷新、流程运行、订阅、数据通知或指标。</td></tr><tr><td>Subscriber Email</td><td>字符串</td><td>接收订阅的个人的电子邮件地址</td></tr><tr><td>Subscriber ID</td><td>字符串</td><td>订阅创建者的用户 ID</td></tr><tr><td>Subscription Subject</td><td>字符串</td><td>用户订阅工作簿或视图时输入的电子邮件主题。</td></tr><tr><td>Was Manual Run</td><td>布尔值</td><td>是否通过选择站点上的“立即运行”选项手动启动作业。</td></tr><tr><td>Was Overflow Queued</td><td>布尔值</td><td>作业是否计入并发作业容量。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm" class="xref">Tableau Cloud 容量</a>。</td></tr><tr><td rowspan="2">Schedule</td><td>Schedule LUID</td><td>字符串</td><td>后台任务与之关联的计划的 LUID</td></tr><tr><td>Schedule Name</td><td>字符串</td><td>后台任务与之关联的计划的名称</td></tr><tr><td rowspan="8">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Bridge Extract Upload Duration</td><td>数字</td><td>数据提取上载所需的时间（以秒为单位）</td></tr><tr><td>Bridge Refresh Duration</td><td>数字</td><td>自刷新开始以来经过的时间（以秒为单位）</td></tr><tr><td>Job Duration</td><td>数字</td><td>作业运行所花费的时间（以秒为单位），包括在队列中等待花费的任何时间。</td></tr><tr><td>Job Execution Duration</td><td>数字</td><td>作业启动后运行的时间（以秒为单位）。</td></tr><tr><td>Job Overflow Queued Duration</td><td>数字</td><td>在溢出队列中等待的时间（以秒为单位）。这仅适用于计入并发作业容量的作业。对于其他作业，它为 NULL。</td></tr><tr><td>Job Queued Duration</td><td>数字</td><td>在队列中等待的时间（以秒为单位）。这仅适用于不计入并发作业容量的作业。对于其他作业，它为 NULL。</td></tr><tr><td>Timezone</td><td>数字</td><td>指定显示日期的时区。该字段表示一个整数值，用于确定与 UTC 偏移的小时数。它没有考虑夏令时调整。</td></tr></tbody></table>

<!-- document id=9cce1a549044d8ff8ce278a387ef995a560219c0c104d1b10a5ae2e46d5bfe18 url=/tableau/next/zh-cn/online/adminview_insights_viz_load_times.md -->

[跳转到主要内容](#main-content)

# “可视化项加载时间”数据源。

可视化项加载时间包含您站点上视图的加载时间信息，以帮助内容作者更好地了解加载视图时的用户体验。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：哪些视图加载时间最长？

使用以下步骤创建显示加载时间的视图，帮助确定哪些视图的加载时间最长。

1. 连接到“可视化项加载时间”数据源。
2. 从“数据”窗格中，将“Item Name”（项名称）拖到“行”功能区，并将“Duration”（持续时间）拖到“列”功能区。
3. 从“数据”窗格中，将“Status Code Type”（状态代码类型）拖到“筛选器”功能区，然后选中“Success”（成功）复选框。
4. 在“列”功能区中，右键单击“维度”并选择“度量(计数)”\>“中值”。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“可视化项加载时间”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“项目存储库 URL = 项目存储库 URL”上将可视化项加载时间联接到 TS 事件和站点内容
- 在“项目类型 = 项目类型”上将可视化项加载时间联接到 TS 事件和站点内容

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“可视化项加载时间”数据源中包含的字段。每行数据对应一个内容项的请求和加载时长（以秒为单位）。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="6">Item</td><td>Item Hyperlink</td><td>字符串</td><td>站点上项的完整 URL</td></tr><tr><td>Item Luid</td><td>字符串</td><td>所请求项（数据源或视图）的 LUID。</td></tr><tr><td>Item Name</td><td>字符串</td><td>项的显示名称。</td></tr><tr><td>Item Owner Email</td><td>字符串</td><td>项所有者的电子邮件地址</td></tr><tr><td>Item Repository URL</td><td>字符串</td><td>与请求相关的项（数据源或视图）的唯一名称，派生自名称中的 ASCII 字符，可在 URL 中使用以引用该项。</td></tr><tr><td>Item Type</td><td>字符串</td><td>项的类型，可以是数据源或视图。</td></tr><tr><td rowspan="2">Project</td><td>Project Name</td><td>字符串</td><td><p>包含项的项目的名称。</p></td></tr><tr><td>Project Owner User Name</td><td>字符串</td><td>项目所有者的电子邮件地址</td></tr><tr><td rowspan="7">Request</td><td>HTTP Request URI</td><td>字符串</td><td>请求 URI</td></tr><tr><td>HTTP User Agent</td><td>字符串</td><td>客户端提供的代理字符串</td></tr><tr><td>Request ID</td><td>字符串</td><td>请求的主键</td></tr><tr><td>Request Time</td><td>日期时间</td><td>请求开始的日期和时间 (UTC)。</td></tr><tr><td>Request Time (local)</td><td>日期时间</td><td>请求开始的日期和时间，由时区参数调整。</td></tr><tr><td>Status Code</td><td>数字</td><td>返回到客户端的状态</td></tr><tr><td>Status Code Type</td><td>字符串</td><td>状态代码的类型。值 1 = 信息响应，2 = 成功，3 = 重定向，4 = 客户端错误，5 = 服务器错误。</td></tr><tr><td rowspan="2">Workbook</td><td>Workbook Name</td><td>字符串</td><td>对于视图，为包含所请求项的父工作簿的名称。</td></tr><tr><td>Workbook Owner User Name</td><td>字符串</td><td>对于视图，为包含所请求项的父工作簿所有者的电子邮件地址。</td></tr><tr><td rowspan="2">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Timezone</td><td>字符串</td><td>指定显示日期的时区。该字段表示一个整数值，用于确定与 UTC 偏移的小时数。它没有考虑夏令时调整。</td></tr></tbody></table>

<!-- document id=70dbf6d5acf7423778ae82e03e2638ec97796708c5bcdbab9a7c2dd89668d942 url=/tableau/next/zh-cn/online/explain_data_lm_status.md -->

[跳转到主要内容](#main-content)

# “数据解释”功能中分析的字段

“数据解释”功能在仪表板或工作表上运行统计分析，以查找属于异常值的标记，或者特别在您选择的标记上执行。分析还会考虑当前视图中未显示的数据源中可能相关的数据点。

“数据解释”功能可能不会在分析中包括数据源中的每一列。在许多情况下，将自动从分析中排除某些类型的字段。有关详细信息，请参见[默认情况下排除的字段](#DefaultExcFields)。

![“数据解释”功能视图已分析字段。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_viewfields.gif)

**注意**：具有超过 500 个唯一值的维度不会被考虑用于分析（除非作者在“数据解释”功能设置中允许）。

所有用户都可以查看有关在当前分析中包括或排除哪些字段的信息。拥有编辑权限的 Creator 和 Explorer 可以编辑“数据解释”功能用于统计分析的字段。

## 查看“数据解释”功能分析的字段

当您展开对标记值有贡献的度量的解释时，“数据指南”窗格底部将显示一个链接，该链接指示分析中考虑的字段数。

![“数据解释”功能详细信息，包含用于查看与较高总和值相关的 23 个字段中的 14 个字段的链接。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_fieldslink.png)

单击链接可查看当前统计分析中包括或排除的字段列表。

当数据源包含超过 1000 个未可视化维度或度量时，您可能会看到一条通知，询问您是否希望“数据解释”功能考虑更多字段。单击“全部解释”以运行包含更多字段的分析。分析可能需要更长时间才能完成。

#### 查看“数据解释”功能用于统计分析的字段

1. [在仪表板、工作表或标记上运行“数据解释”功能](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#RunExD)。
2. 在“数据指南”窗格中的**“对其值有贡献”**下，单击度量名称。  
      
    ![关于所分析标记的“数据解释”功能详细信息，其中突出显示的文本描述了高于预期的行程距离总值 8,800。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_viewfields1.png)
3. 单击窗格底部的_字段数_链接。  
      
    ![关于所分析标记的“数据解释”功能详细信息，其中突出显示的文本为“23 个字段中的 12 个”。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_viewfields2.png)

## 更改用于统计分析的字段

具有编辑权限的 Creator 和 Explorer 可以在“数据解释设置”对话框的“字段”选项卡中选择要在统计分析中包括或排除的字段。

![“数据解释设置”窗口，提供有关数据设置的信息，包括字段和数据类型。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_settings.png)

如果数据源包含的维度具有大量的唯一值（最多 500 个），则不会为分析考虑这些字段。

#### 编辑“数据解释”功能用于统计分析的字段

分析字段的设置应用于数据源级别。

1. 编辑视图时在标记上运行“数据解释”功能。
2. 在“数据指南”窗格中，单击该窗格底部的设置图标。或者，单击“已分析字段”视图中的“编辑”按钮（[如何打开已分析字段](#ViewAnalyzed)）。  
      
    ![“已分析字段”窗格上的“编辑”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_editfields.png)
3. 在“数据解释设置”对话框中，单击“字段”选项卡。
4. 单击字段名称旁边的下拉箭头，选择“自动”或“从不包括”，然后单击“确定”。  
      
    请注意，要包括在分析中的字段必须少于 500 个唯一值。  
      
    ![“数据解释设置”窗口，其中选择了一个度量，并且下拉菜单展开以显示包含或排除该字段的选项。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_excludefield.png)

## 默认情况下排除的字段

<table class="table--stripes" style="width: 100%; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 45%;"><col style="width: 55%;"></colgroup><thead><tr><th>默认情况下排除的字段</th><th>排除理由</th></tr></thead><tbody><tr><td><p>数据源中有超过 1000 个度量时，排除所有未可视化的度量。</p><p>数据源中有超过 1000 个维度时，排除所有未可视化的维度。</p></td><td><p>为超过 1000 个未可视化的度量或维度计算解释可能需要更长时间的计算时间，有时需要几分钟时间。默认情况下会为初始分析排除这些字段，但您可以选择包括这些字段以进行进一步分析。</p><p>在此情况下，您可能会看到一条通知，询问您是否希望“数据解释”功能考虑更多字段。单击通知链接以获取更多信息。单击<span class="uicontrol">“全部解释”</span>以运行包含更多字段的分析。</p></td></tr><tr><td>使用几何图形、纬度或经度的字段</td><td>几何图形、纬度或经度本身永远不能是解释。将纬度或经度作为解释的原因极有可能是存在虚假的关联，而不是可能的解释。</td></tr><tr><td>具有高基数的维度（成员超过 500 的维度）</td><td><p>高基数维度的计算时间较长。不会考虑将包含超过 500 个唯一值的维度用于分析。</p></td></tr><tr><td>组、数据桶或集</td><td>当前不支持。</td></tr><tr><td>表计算</td><td>当表计算的详细级别与视图不同时，无法对表计算进行分析。</td></tr><tr><td>无法求平均值的未可视化度量</td><td>无法求平均值的未可视化度量包括作为计算字段的度量，其中计算表达式包含聚合（添加到工作表时显示为 AGG() 字段）。</td></tr><tr><td>离散度量和连续维度</td><td>当前不支持。</td></tr><tr><td>隐藏字段</td><td>不可用。</td></tr><tr><td>包含错误的计算字段</td><td>不存在要分析的值。</td></tr></tbody></table>

<!-- document id=edddc6e09d4178d5324a1033a3d61e009ec3a4b3803b8559de66865dc357b32b url=/tableau/next/zh-cn/online/explain_data_explanation_types.md -->

[跳转到主要内容](#main-content)

# “数据解释”功能中的解释类型

每次您在可视化项或仪表板中选择新标记并运行“数据解释”功能时，Tableau 都会根据该标记和工作簿中的基础数据运行新的统计分析。可能的解释显示在“数据指南”窗格的可展开部分中。有关“数据解释”功能如何分析和评估解释的信息，请参见[“数据解释”功能的工作原理](https://help.tableau.com/v0.0/online/zh-cn/explain_data_explained.htm)。

## 浏览基础值

此部分列出了每个可以解释的度量（称为_目标度量_）的解释。此处列出的每个解释都描述了与在已分析标记上测试的目标度量值的关系。使用您对数据的真实实际理解来确定“数据解释”功能发现的关系是否有意义且值得探索。

![关于所分析标记的“数据解释”功能详细信息，其中突出显示的文本描述了高于预期的行程距离总值 8,800。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_targetmeasure.png)

在此示例中，“Trip Distance”（行程距离）是目标度量

### 基础特征

这些解释描述了视图中标记的基础记录如何对所解释的度量的聚合值产生影响。标记属性可以包括[极端值](#MA-Extreme)、[Null 值](#MA-Null)、[记录数](#MA-NR)或标记的[平均值](#MA-AVG)。

**注意**：有关解释中常用术语的定义，请参见[解释中的术语和概念](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#TermsToKnow "链接到解释中使用的 Tableau 术语和概念的定义。")。

#### 极端值

此解释类型指示一个或多个记录的值是否明显高于或低于大多数记录。如果模型支持该解释，则表明极端值正在影响已分析标记的目标度量。

当标记具有极端值时，并不自动意味着它具有离群值或者您应将这些记录从视图中排除。怎样选择由您根据分析自行决定。解释只是指出标记中一个极端值。例如，它可能会显示记录中一个输入错误的值，即一根香蕉的成本为 10 美元，而不是 10 美分。或者，它可能会显示一名特定销售人员在某个季度的表现特别出色。

**注意**：此解释必须由作者启用才能在已发布工作簿的查看模式下可见。有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。

<table style="border-left-style: none;border-left-width: 6px;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>此解释显示：</b></p><ul><li>已分析标记中的基础记录数。</li><li>对目标度量值产生影响的一个或多个极端值。</li><li>标记中值的分布。</li><li>与每个分布值对应的记录详细信息。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在图表中的圆上以查看其对应的值。</li><li>选择详细信息列表下方的向左或向右箭头可滚动查看记录详细信息。</li><li>如果可用，选择<b>“查看完整数据”</b>，然后选择<b>“完整数据”</b>选项卡以查看表中的所有记录。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p style="font-weight: bold;">分析的后续步骤：</p><ul><li style="font-weight: normal;">如果记录数较少，请检查这些值与极端值的比较。</li><li style="font-weight: normal;">如果极端值明显高于或低于其他记录值，则排除它并考虑它如何改变已分析标记的值。</li><li style="font-weight: normal;">在考虑有和没有极端值的数据时，以此为契机，应用您对数据的实践知识。<br><br></li></ul></td><td>&nbsp;</td><td><p style="text-align: left;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_ev_dist.gif" alt="在此示例中，租用 463 小时的单个极端值导致总租用时间的总和高于预期的 613 小时。"></p><p>在此示例中，租用 463 小时的单个极端值导致总租用时间的总和高于预期的 613 小时。</p><p>造成如此高值的一个可能原因是，有人在归还自行车时忘记将自行车停靠。在这种情况下，作者可能希望排除此值以供将来分析。</p><p>&nbsp;</p></td></tr><tr><td><h5>可视化差异</h5><p><b>本节显示：</b></p><ul><li>排除极端值后，已分析标记值如何变化。</li></ul><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p><p><b>探索选项：</b></p><ul><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li><li>探索有和没有极端值（或多个极端值）的差异。</li><li>作者可以将视图作为新工作表打开，并应用筛选器以排除极端值。</li></ul><p style="font-weight: bold;">分析的后续步骤：</p><ul><li>如果极端值明显高于或低于其他记录值，则排除它并查看它如何改变已分析标记的值。</li><li>在考虑有和没有极端值的数据时，以此为契机，应用您对数据的实践知识。</li></ul></td><td>&nbsp;</td><td style="text-align: left;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_ev_vizthediff.png" alt="使用地图快照和说明性文本显示差异标题，说明当排除极值时，值将从 619.3 变为 155.5。"><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_ev_vizthediff.gif" alt="在此示例中，当排除极端值 483 时，与视图中的其他标记相比，已分析标记不再高。"></p><p>在此示例中，当排除极端值 483 时，与视图中的其他标记相比，已分析标记不再高。其他标记现在会很突出。作者可能想要探索其他标记，以考虑为什么这些其他地点的自行车租赁时间更长。</p></td></tr></tbody></table>

#### Null 值

Null 值解释类型指出标记中缺失数据量高于预期的情况。它指示为 null 的目标度量值的比例，以及 null 值可能如何影响该度量的聚合值。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>此解释显示：</b></p><ul><li>已分析标记（蓝色圆圈）的目标度量中为 null 的值的百分比。</li></ul><p><b>探索选项：</b></p><ul><li>在散点图中将鼠标悬停每个圆圈上可查看其详细信息。</li><li>滚动查看更多图表。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p style="font-weight: bold;">分析的后续步骤：</p><ul><li>可选择排除标记中的 null 值以进行进一步分析。</li></ul></td><td>&nbsp;</td><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explain_data_nullvalues.png" alt="带有“数据解释”功能文本的散点图，解释 null 值的百分比可能对平均值有影响。"></p><p>在此示例中，目标度量中的 null 值百分比显示为蓝色圆圈。</p></td></tr></tbody></table>

#### 记录数

这种解释类型描述了基础记录的计数何时与总和相关。分析发现标记中聚合的记录数与标记的实际值之间存在关系。

虽然这看起来很明显，但这种解释类型可帮助您探索标记的值是否受到其记录中值的大小的影响，或者仅仅是因为已分析标记中的记录数而受到影响。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>此解释显示：</b></p><ul><li>已分析标记（深蓝色条形）的目标度量中的记录数。</li><li>源可视化项中其他标记（浅蓝色条形）的目标度量中的记录数。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在每个条形上可查看其详细信息。</li><li>滚动查看更多图表。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p style="font-weight: bold;">分析的后续步骤：</p><ul><li>比较记录的单个值是低还是高，或者已分析标记中的记录数是低还是高。</li><li>作者，如果您对大量记录感到惊讶，您可能需要对数据进行标准化。</li></ul></td><td>&nbsp;</td><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_nr.png" alt="散点图显示了次数和行程距离总和之间的关系，其中“数据解释”功能文本解释道，由于 8 月份的记录数量较多，因此行程距离总和可能较高。"></p><p>在此示例中，针对“Ride Month”（骑行月）的每个值列出了“Trip Distance”（行程距离）的记录数，这是原始可视化项中的一个维度。八月的总行程距离值最高。</p><p>您可能会探索八月的行程距离值最高是否是因为八月的骑行次数更多，还是因为某些骑行时间更长导致行程距离最高。</p></td></tr></tbody></table>

#### 标记的平均值

这种解释类型描述了度量的平均值何时与总和相关。比较平均值是低还是高，或者记录数是低还是高。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><p><b>此解释显示：</b></p><ul><li>源可视化项中使用的维度的每个值的目标度量的平均值。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在每个条形上可查看其详细信息。</li><li>滚动查看更多图表。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p><b>分析的后续步骤：</b></p><ul><li>比较平均值是低还是高，或者记录数是低还是高。例如，利润高是因为您卖了很多东西还是因为您卖了昂贵的东西？</li><li>尝试弄清楚为什么已分析标记具有明显更高或更低的平均值。</li></ul><p>&nbsp;</p></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_ar_ctr.png" alt="选择了平均出行距离维度，并解释平均出行距离正在增加所解释标记的出行距离预期总和。"><p>在此示例中，八月的平均行程距离与大多数月份相比并没有显著提高或降低。这表明八月的行程距离更高是因为八月的骑行次数更多，而不是人们的骑行时间更长。</p></td></tr></tbody></table>

### 产生影响的单一值

使用此解释来了解构成已分析标记的记录值的组成。

这种解释类型确定非可视化维度中的单个值何时可能对已分析标记的聚合值造成影响。非可视化维度是存在于数据源中，但当前未在视图中使用的维度。

此解释表明何时某个维度的每个基础记录具有相同的值，或者何时某个维度值因许多或少数记录对于已分析标记具有相同的单个值而很突出。

**注意**：有关解释中常用术语的定义，请参见[解释中的术语和概念](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#TermsToKnow "链接到解释中使用的 Tableau 术语和概念的定义。")。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>此解释显示：</b><ul><li>已分析标记（蓝色条形）与源可视化项中的所有标记（灰色条形）的维度的单个值的记录数百分比。</li><li>已分析标记（蓝色条形）与源可视化项中的所有标记（灰色条形）的维度的所有其他值的记录数百分比。</li><li>已分析标记（蓝色条形）与所有标记（灰色条形）中某个维度的单个值的目标度量的平均值。</li><li>已分析标记（蓝色条形）与源可视化项中的所有标记（灰色条形）的维度的所有其他值目标度量的平均值。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在每个条形上可查看其详细信息。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p><b>分析的后续步骤：</b></p><ul><li>使用此解释来了解构成已分析标记的记录值的组成。</li><li>作者可能想要创建一个新的可视化项来探索本解释中出现的任何未可视化的维度。</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_rsv_ctr.png" alt="所选标记的“数据解释”功能详细信息，其中的条形图显示影响该值的记录。"><p>在此示例中，统计分析表明，许多次骑行来自 Back Bay 车站附近。请注意，“Station Neighborhood”（车站附近）是一个未可视化的维度，它与源可视化项的基础数据中的“Trip Distance”（行程距离）有某种关系。</p></td></tr></tbody></table>

### 主要促成因素

使用此解释查看构成已分析标记的最大部分的值。

对于 COUNT 聚合，主要促成因素显示具有最多记录的维度值。对于 SUM，此解释显示具有最大部分和的维度值。

### 产生影响的维度

使用此解释来了解构成已分析标记的记录值的组成。

这种解释类型表明，未可视化维度的分布可能对已分析标记的聚合值产生影响。这种类型的解释用于目标度量总和、计算及平均值。非可视化维度是存在于数据源中，但当前未在视图中使用的维度。

**注意**：有关解释中常用术语的定义，请参见[解释中的术语和概念](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#TermsToKnow "链接到解释中使用的 Tableau 术语和概念的定义。")。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>此解释显示：</b><ul><li>源可视化项中已分析标记（蓝色条形）维度的所有值的记录数与所有标记（灰色条形）维度的所有值的百分比。</li><li>已分析标记（蓝色条形）某个维度的所有值与所有标记（灰色条形）某个维度的所有值的目标度量平均值。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在每个条形上可查看其详细信息。</li><li>滚动查看更多图表。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p><b>分析的后续步骤：</b></p><ul><li>使用此解释来了解构成已分析标记的记录值的组成。</li><li>作者可能想要创建一个新的可视化项来探索本解释中出现的任何未可视化的维度。</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_rd_ctr.png" alt="所选标记及其分布的“数据解释”功能详细信息。"><p>在这个例子中，统计分析表明，与整体评分相比，从南部车站和 MIT 骑行的次数更多，从 Charles Circle 和 Kendall 骑行的次数更少。</p><p>请注意，“Station Name”（车站名称）是一个未可视化的维度，它与源可视化项的基础数据中的“Trip Distance”（行程距离）有某种关系。</p></td></tr></tbody></table>

### 产生影响的度量

这种解释类型表明，未可视化度量的平均值可能对已分析标记的聚合值产生影响。非可视化度量是存在于数据源中，但当前未在视图中使用的度量。

这种解释可以揭示未可视化度量与目标度量之间的线性或二次关系。

**注意**：有关解释中常用术语的定义，请参见[解释中的术语和概念](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#TermsToKnow "链接到解释中使用的 Tableau 术语和概念的定义。")。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>此解释显示：</b><ul><li>目标度量的总和与视图中已分析标记（蓝色圆圈）和所有标记（灰色圆圈）的未可视化度量的平均值之间的关系。</li><li>如果目标度量的总和高或低，因为未可视化度量的平均值高或低。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停每个圆圈上可查看其详细信息。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p><b>分析的后续步骤：</b></p><ul><li>作者可能想要创建一个新的可视化项来探索本解释中出现的任何未可视化的度量。</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_rm_ctr.png" alt="所选度量的“数据解释”功能详细信息。"><p>在这个例子中，行程距离很长的一个可能原因是平均租用总时间也很长。</p></td></tr></tbody></table>

## 其他要探索的内容

此部分提供了已分析标记独特或不寻常的可能原因。这些解释：

- 不会解释为什么这个标记的值之所以是值的原因。
- 与源可视化项中的度量值没有任何关系。
- 不考虑任何目标度量。

### 其他感兴趣的维度

使用此解释来了解构成已分析标记的记录值的组成。

与视图中所有其他标记的值分布相比，已分析标记中未可视化维度的分布是不寻常的。非可视化维度是存在于数据源中，但当前未在视图中使用的维度。

**注意**：有关解释中常用术语的定义，请参见[解释中的术语和概念](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm#TermsToKnow "链接到解释中使用的 Tableau 术语和概念的定义。")。

<table style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 100px;"><col style="width: 10px;"><col style="width: 100px;"></colgroup><tbody><tr><td><b>此解释显示：</b><ul><li>源可视化项中已分析标记（蓝色条形）维度的所有值的记录数与所有标记（灰色条形）维度的所有值的百分比。</li></ul><p><b>探索选项：</b></p><ul><li>将鼠标悬停在每个条形上可查看其详细信息。</li><li>滚动查看更多图表。</li><li>选择<span class="uicontrol">“打开”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_openviewicon.png" alt="“打开视图”图标。"> 图标以查看可视化项的更大版本。</li></ul><p><b>分析的后续步骤：</b></p><ul><li>使用此解释来了解构成已分析标记的记录值的组成。</li><li>作者可能想要创建一个新的可视化项来探索本解释中出现的任何未可视化的维度。</li></ul></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/explaindata_exp_rd_tvd.png" alt="其他感兴趣维度的“数据解释”功能详细信息。"><p>在此示例中，很大比例的记录与阴天天气相关。因为数据是关于波士顿的自行车租赁，并且已分析标记是八月的行程距离，我们可以假设天气通常温暖潮湿。人们可能会在阴天更频繁地租用自行车，以避免炎热。八月也有可能有更多的阴天。</p></td></tr></tbody></table>

<!-- document id=44ad9110239d4c1894ef3789a7ed9049979798ca5f169e7b5d2edf94abf8fa3a url=/tableau/next/zh-cn/online/explain_data_basics.md -->

[跳转到主要内容](#main-content)

# “数据解释”功能入门

当您在可视化项中探索标记时，在分析流程中使用“数据解释”功能。“数据指南”窗格打开时，“数据解释”功能会自动运行，并根据当前选择（仪表板、工作表或标记）进行更新。

<table style="margin-left: 0; margin-right: auto; width: 100%"><colgroup><col style="width: 350px;"><col style="width: 350px;"></colgroup><tbody><tr><td class="table--plain"><p style="font-weight: bold;">使用“数据解释”功能</p><ul><li><a href="#RunExD" class="xref">在仪表板、工作表或标记上运行“数据解释”功能</a></li><li><a href="#Drill" class="xref">深入解释</a></li><li><a href="#ViewFields" class="xref">查看分析的字段</a></li><li><a href="#TermsToKnow" class="xref">解释中的术语和概念</a></li><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_explanation_types.htm">解释类型</a></li></ul></td><td class="table--plain"><p style="font-weight: bold;">作者工作簿和控制访问权限</p><ul><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm" target="_blank">使用“数据解释”功能的要求和注意事项</a></li><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm" target="_blank">更改“数据解释”功能设置（仅限作者）</a></li><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm" class="xref">控制对“数据解释”功能的访问</a></li><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_enable.htm" class="xref">为站点禁用或启用“数据解释”功能</a></li><li><a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_explained.htm" class="xref">“数据解释”功能的工作原理</a></li></ul></td></tr></tbody></table>

## 在仪表板、工作表或标记上运行“数据解释”功能

以下是在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中运行“数据解释”功能的基本步骤：

1. 打开仪表板或工作簿中的工作表。
2. 在视图工具栏中，选择“数据指南”![“数据网格”图标](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_icon.png)打开“数据指南”窗格。
3. 如果您打开仪表板，“数据解释”功能将对其进行异常值分析。  
      
    ![检测到的异常值显示在仪表板的“数据指南”中](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_dg_dashboard.png)  
      
    如果您在仪表板中选择了一个工作表，“数据解释”功能会针对异常值分析该工作表中的标记。  
      
    ![“数据解释”功能对于所选工作表的详细解释。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_dg_sheet.png)  
      
    如果您在仪表板中选择了一个标记，“数据解释”功能会专门分析该标记进行解释。  
      
    ![“数据解释”功能对于所选标记的详细解释。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_dg_mark.png)  
      
    当您选择相应的解释时，正在解释的标记会在可视化项中突出显示。

或者，您可以在可视化项中选择一个标记，将光标悬停在该标记上。在工具提示菜单中，选择**“数据指南”**![“数据网格”图标](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_icon.png)。  
  
![标记工具提示的图像，其中选择了“数据指南”图标](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_tooltip_dg2.png)

在 Tableau Public 中，选择工具提示菜单中的灯泡以运行“数据解释”功能。  
  
![单击标记工具提示菜单中的灯泡图标以运行“数据解释”功能。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_tooltip_button.png)  
  
“数据指南”窗格中显示了对已分析标记值的可能解释。选择不同的解释名称以展开详细信息并开始探索。

### 查看解释所需的“数据解释”功能权限

如果您看到检测到的异常值带有联系可视化项所有者的提示，这是因为您需要权限来查看这些类型的解释。选择所有者姓名，转到包含其电子邮件地址的 Tableau 内容页面。请与所有者联系，要求他们授予您对工作簿或视图的“数据解释”功能权限。

如果您是工作簿的所有者，有关设置权限的详细信息，请参见[控制谁可以使用“数据解释”功能以及他们可以看到什么](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm#Control)。

### 有关使用“数据解释”功能的提示

- 不能选择多个标记进行相互比较。
- 视图必须包含使用 SUM、AVG、COUNT、COUNTD 或 AGG（计算字段）聚合的标记。
- 当“数据解释”功能无法分析选定的标记类型时，会显示一条消息来说明原因。有关详细信息，请参见[“数据解释”功能不可用的情况](https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm#NotAvailable)。
- 所分析的数据必须从单个主数据源中提取。“数据解释”功能不适用于混合数据源或多维数据集数据源。
- 有关哪些特征使数据源与“数据解释”功能一起使用更有趣的信息，请参见[使用“数据解释”功能的要求和注意事项](https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm)。

## 深入解释

1. 在“数据指南”窗格中，选定标记解释名称以查看更多详细信息。
    
    选择解释以展开或收缩其详细信息。
2. 滚动以查看更多解释详细信息。
3. 将鼠标悬停在解释中的图表上可查看有关不同数据点的详细信息。选择“打开”![“打开视图”图标。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_openviewicon.png) 图标以查看可视化项的更大版本。
    
    打开视图进行编辑的 Creator 或 Explorer 可以选择“打开”![“打开视图”图标。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_openviewicon.png) 图标以将可视化项作为新工作表打开，并进一步探索数据。
    
    **注意**：具有编辑权限的 Creator 和 Explorer 也可以控制“数据解释”功能设置。有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。
4. 将鼠标悬停在帮助图标 ![“数据解释”功能帮助图标。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_helpicon.png) 上以查看解释的工具提示帮助。选择帮助图标 ![“数据解释”功能帮助图标。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_helpicon.png) 使工具提示保持打开。选择**“了解更多”**链接以打开相关帮助主题。

## 查看分析的字段

1. [在仪表板、工作表或标记上运行“数据解释”功能](#RunExD)。
2. 在“数据指南”窗格中的**“浏览其基础值”**下，选择目标度量名称。  
    ![关于所分析标记的“数据解释”功能详细信息，其中突出显示的文本描述了高于预期的行程距离总值 8,800。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_viewfields1.png)
3. 选择窗格底部的_字段数_链接。  
    ![关于所分析标记的“数据解释”功能详细信息，其中突出显示的文本为“23 个字段中的 14 个”。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_viewfields2.png)

作者可以选择打开“解释数据设置”来控制在分析中包括哪些字段。有关详细信息，请参见[“更改用于统计分析的字段”](https://help.tableau.com/v0.0/online/zh-cn/explain_data_lm_status.htm#IncludeExcludeFields)。

## 解释中的术语和概念

以下术语和概念经常出现在解释中。您可能会发现在使用“数据解释”功能的上下文中熟悉它们的含义会很有帮助。

什么是标记？

标记是一个可选择的数据点，它汇总了数据中的一些基础记录值。标记可以由单个记录或聚合在一起的多个记录组成。Tableau 中的标记可采用多种不同的方式显示，例如线条、形状、条形和单元格文本。

Tableau 根据视图中字段的交集获取构成标记的记录。

**已分析标记**是指“数据解释”功能分析的仪表板或工作表中的标记。

有关标记的详细信息，请参见[标记](https://help.tableau.com/current/pro/desktop/zh-cn/view_parts.htm#Marks)。

预期意味着什么？

标记的预期值是可视化项中基础数据的预期值范围中的中值。预期范围是统计模型为已分析标记预测的第 15 个和第 85 个百分位数之间的值范围。Tableau 每次对选定标记运行统计分析时都会确定预期范围。

如果预期值摘要显示标记_低于预期_或_高于预期_，则意味着聚合的标记值不在统计模型针对标记预测的值的范围内。如果预期值摘要显示标记_略低于_或_略高于_预期，或_在自然偏差范围内_，则意味着聚合的标记值在预测标记值的范围内，但为该值范围内的较低值或较高值。

有关详细信息，请参见[什么是预期范围？](https://help.tableau.com/current/pro/desktop/zh-cn/explain_data_explained.htm#ExpectedRangeLM)

什么是维度和度量？

数据库中的每个列名称都是一个字段。例如，“产品名称”和“销售额”各自都是字段。在 Tableau 中，对数据进行分类的“产品名称”等字段称为维度；具有可量化数据的字段（如“销售额”）称为度量。默认情况下，当您将度量拖到视图中时，Tableau 会聚合度量。

一些解释描述了基础记录值和这些值的聚合如何影响已分析标记的值。其他解释可能会提到已分析标记跨维度的值分布。

当您在标记上运行“数据解释”功能时，分析会考虑数据源中未在视图中呈现的维度和度量。这些字段称为未可视化维度和未可视化度量。

有关维度和度量的详细信息，请参见[维度和度量](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles.htm)。

什么是聚合？

聚合是一个汇总值或总计值。每当您将度量拖到“行”、“列”、“标记”卡选项或视图上时，Tableau 都会自动应用聚合，例如 SUM 或 AVG。例如，度量显示为 SUM(Sales) 或 AVG(Sales) 以指示度量的聚合方式。

若要使用“数据解释”功能，可视化项使用的度量必须是使用 SUM、AVG、COUNT、COUNTD 或 AGG 聚合的。

有关聚合的详细信息，请参见 [Tableau 中的数据聚合](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_aggregation.htm)。

什么是记录值？

记录是数据库表中的一行。一行包含与每个字段对应的值。在此示例中，“类别”、“产品名称”和“销售额”是字段（或列）。“家具”、“落地灯”和“96 美元”是值。

<table class="table--plain" style="width: 360px"><colgroup><col style="width: 120px;"><col style="width: 120px;"><col style="width: 120px;"></colgroup><tbody><tr><td style="font-weight: bold;">类别</td><td style="font-weight: bold;">产品名称</td><td style="font-weight: bold;">销售额</td></tr><tr><td>家具</td><td>落地灯</td><td>96.00 美元</td></tr></tbody></table>

什么是分布？

分布是数据的所有可能值（或区间）的列表。它还指示每个值出现的频率（出现频率）。

<!-- document id=7f3e55df3ed0d64ad0fdedb74b7646eaa7f00aaf24a3c9b9ab98329df5a5871e url=/tableau/next/zh-cn/online/explain_data_explained.md -->

[跳转到主要内容](#main-content)

# “数据解释”功能的工作原理

使用“数据解释”功能作为渐进式的出发点来进一步探索您的数据。它生成的可行解释可帮助您查看构成视图中已分析标记或与之相关的不同值。它可以让您了解数据源中数据点的特征，以及数据如何使用统计建模相关（关联）。这些解释为您提供了另一种工具，用于检查数据并查找有关接下来要探索的内容的有趣线索。

**注意**：“数据解释”功能是一种工具，用于发现和描述数据中的关系。它无法告诉您导致关系的原因或如何解释数据。**您是数据的专家。**在帮助您决定哪些特征对于使用不同视图进一步探索可能很有趣时，您的领域知识和直觉非常关键。

有关“数据解释”功能的工作原理以及如何使用“数据解释”功能来增强分析的相关信息，请参见以下 Tableau 会议演示文稿：

- [From Analyst to Statistician: Explain Data in Practice（从分析师到统计师：“数据解释”功能实际运用，1 小时）](https://www.tableau.com/zh-cn/events/tc/2019/analyst-statistician-explain-data-practice)
- [Leveraging Explain Data（利用“数据解释”功能，45 分钟）](https://www.tableau.com/zh-cn/events/tc/2019/leveraging-explain-data)

## “数据解释”功能是什么（不是什么）

“数据解释”功能是：

- 对您的领域专业知识加以利用的工具和工作流。
- 一种工具，可显示数据中的关系并建议下一步查看的位置。
- 有助于加快数据分析并使更广泛的用户更容易访问数据分析的工具和工作流。

“数据解释”功能不是：

- 统计测试工具。
- 证明或反驳假设的工具。
- 一个能给您答案或告诉你数据中因果关系的工具。

在标记上运行“数据解释”功能时，请记住以下几点：

- **使用可聚合的精细数据。**此功能专为分析聚合数据而设计。这意味着您的数据必须精细，但必须在更高的详细级别对您为“数据解释”功能选择的标记进行聚合或汇总。“数据解释”功能无法在最精细详细级别的解聚标记（行级别数据）上运行。
- **考虑数据的形状、大小和基数。**尽管“数据解释”功能可与较小的数据集结合使用，但它需要足够宽并包含足够标记（粒度）的数据才能创建模型。
- **不要假设因果关系。**关联不是因果关系。解释基于数据的模型，但不是因果性解释。
    
    关联意味着某些数据变量（例如 A 和 B）之间存在关系。您不能仅仅从数据中看到这种关系就知道是 A 导致了 B 还是 B 导致了 A，或者是否发生了更复杂的事情。这些数据模式在每种情况中完全相同，一个算法不能区分每种情况。仅仅因为两个变量看起来一起变化并不一定意味着一个变化会导致另一个变化发生变化。第三个因素可能导致两者都发生了变化，也可能只是巧合，根本没有任何因果关系。
    
    不过，您可能会从外部了解到一些不在数据内的信息，这些信息可帮助您确定所发生的情况。一种通常可从外部了解到的情况是，数据是在实验中收集的。如果您知道 B 是像抛硬币一样随机选择的，那么 A 中任何一致的差异模式（不仅仅是随机噪声）一定是由 B 导致的。有关这些概念更详细、更深入的说明，请参见 Hal Varian 撰写的文章 [Causal inference in economics and marketing（经济和市场营销中的因果推断）](https://www.pnas.org/content/pnas/113/27/7310.full.pdf)。

## 如何对解释进行分析和评估

“数据解释”功能在仪表板或工作表上运行统计分析，以查找属于异常值的标记，或者特别在您选择的标记上执行。分析还会考虑当前视图中未显示的数据源中可能相关的数据点。

“数据解释”功能第一次只会使用可视化项中存在的数据预测标记的值。接下来，将会考虑数据源（而不是当前视图）中的数据并将其添加到模型。模型确定预测标记值的范围，该范围在预测值的一个标准偏差内。

### 什么是预期范围？

标记的预期值是可视化项中基础数据的预期值范围中的中值。预期范围是统计模型为已分析标记预测的第 15 个和第 85 个百分位数之间的值范围。Tableau 每次对选定标记运行统计分析时都会确定预期范围。

将使用统计建模基于可能的解释的解释能力来对其进行评估。对于每个解释，Tableau 会将预期值与实际值进行比较。

| 值 | 描述 |
| --- | --- |
| 高于预期/低于预期 | 如果预期值摘要显示标记_低于预期_或_高于预期_，则意味着聚合的标记值不在统计模型针对标记预测的值的范围内。如果预期值摘要显示标记_略低于_或_略高于_预期，或_在自然偏差范围内_，则意味着聚合的标记值在预测标记值的范围内，但为该值范围内的较低值或较高值。 |
| 预期值 | 如果某个标记具有预期值，则意味着其值落在统计模型为该标记预测的预期值范围内。 |
| 随机变化 | 当已分析标记的记录数较少时，可能没有足够的数据可供“数据解释”功能来形成具有统计意义的解释。如果标记的值超出预期范围，“数据解释”功能无法确定此意外值是由随机变化引起的还是由基础记录中的有意义的差异引起的。 |
| 没有解释 | 当已分析标记值超出预期范围并且不符合用于“数据解释”功能的统计模型时，不会生成解释。 |

### 用于分析的模型

“数据解释”功能会在视图中构建数据模型来预测标记的值然后在给定模型的情况下确定标记是高于还是低于预期值。接下来，它会考虑其他信息，如将数据源中的其他列添加到视图，或将记录级别离群值标记为可能的解释。对于每个可能的解释，“数据解释”功能都会适配一个新模型，并在给定新信息的情况下评估标记的非预期程度。解释的分数是通过将复杂性（从数据源中添加了多少信息）与需要解释的变异量加以权衡得出的。如果解释比它们所解释的变化更简单，则解释就更好。

<table class="table--stripes" style="margin-left: 0; margin-right: auto;"><colgroup><col style="width: 25%;"><col style="width: 75%;"></colgroup><thead><tr><th>解释类型</th><th>评估</th></tr></thead><tbody><tr><td><p><b>极端值</b></p></td><td><p>基于可视化标记的模型，极端值是离群值形式的聚合标记。如果所选标记位于数据预期值分布的尾部，则被视为包含极端值。</p><p>通过比较有极端值和无极端值的聚合标记来确定极端值。如果删除值后标记变得不那么让人惊讶，则它会得到较高的分数。</p><p>当标记具有极端值时，并不自动意味着它具有离群值，或者您应将这些记录从视图中排除。怎样选择由您根据分析自行决定。解释只是指出标记中一个有趣的极端值。例如，它可能会显示记录中一个输入错误的值，即一根香蕉的成本为 10 美元，而不是 10 美分。或者，它可能会显示一名特定销售人员在某个季度的表现特别出色。</p></td></tr><tr><td><p><b>记录数</b></p></td><td><p>记录数解释根据聚合计数对聚合总和进行建模；记录的平均值根据聚合平均值对其进行建模。模型对总和的解释越好，得分就越高。</p><p>此解释描述总和由于计数较高或较低或者平均值较高或较低而是否令人关注。</p></td></tr><tr><td><p><b>标记的平均值</b></p></td><td><p>这种类型的解释用于总和形式的聚合标记。它解释了标记是否与其他标记一致，因为就其聚合计数或平均值而言，注意关系 SUM(X) = COUNT(X) * AVG(X)。</p><p>此解释描述总和由于计数较高或较低或者平均值较高或较低而是否令人关注。</p></td></tr><tr><td><p><b>产生影响的维度</b></p></td><td><p>该解释根据未可视化维度的类别之间的细分对已分析标记的目标度量进行建模。分析平衡了模型的复杂性和对标记的解释程度。</p><p><i>非可视化维度</i>是存在于数据源中，但当前未在视图中使用的维度。这种类型的解释用于总和、计算及平均值。</p><p>非可视化维度的模型是通过以下方式创建的：依据解释列的分类值将标记拆分，然后使用包括源可视化项中所有数据点的值构建模型。对于每一行，模型都会尝试恢复组成每个标记的各个组件。分析指明，与使用非可视化维度的值未知的模型相比，对与非可视化维度对应的组件进行建模然后加总时，模型是否能对标记进行更好的预测。</p><p>聚合维度解释探讨在没有任何条件的情况下可将标记值解释到怎样的程度。然后，模型会通过条件对作为可能解释的每一列的值进行限制。通过对解释列的分布进行条件限制，应该能进行更好的预测。</p></td></tr><tr><td><p><b>产生影响的度量</b></p></td><td><p>此解释根据这种未可视化的度量对标记建模，聚合为其跨可视化维度的平均值。<i>非可视化度量</i>是存在于数据源中，但当前未在视图中使用的度量。</p><p>产生影响的度量解释可以揭示未可视化度量与目标度量之间的线性或二次关系。</p></td></tr></tbody></table>

<!-- document id=b9c7342e8d85574ab569500a8f31705872856a9f770b0f79335bbb94909ab35a url=/tableau/next/zh-cn/online/adminview_insights_site_content.md -->

[跳转到主要内容](#main-content)

# “站点内容”数据源

“站点内容”数据源提供有关站点上的项目、数据源、流程、工作簿和视图的基本管控信息。提供的关于内容项的数据对于其项类型可能是唯一的。具有唯一字段的项类型位于标题与其项类型相对应的文件夹中。

从 2023 年 12 月开始，站点内容数据源包括您站点的 Tableau Pulse 信息。创建视图时，您可以在“指标”文件夹中找到专用于 Tableau Pulse 的字段。

**注意：**连接到站点内容数据源的用户将看到有关站点上所有内容项的数据，无论为每个项设置的权限如何。如果您计划分发给非管理用户，请记住这一点。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：站点已发布数据源中有多少百分比通过了认证？

使用以下步骤创建一个视图，其中显示站点上已认证的已发布数据源的百分比。

1. 连接到“站点内容”数据源。
2. 从“数据”窗格中，将“Migrated Data (Count)”（已迁移数据(计数)）拖到“列”功能区。
3. 从“数据”窗格中，将“Data Source Content Type”（数据源内容类型）拖到“筛选器”功能区，清除“全部”复选框，然后选中“已发布”复选框。
4. 从“数据”窗格中，将“Data Source Certified”（已认证数据源）拖到“标记”卡上的“颜色”。
5. 右键单击“列”功能区中的“CNT (Migrated Data)”（CNT (已迁移数据)）字段，然后选择“快速表计算”\>“总计百分比” 。

### 示例：如何按标记查看内容？

使用以下步骤创建一个视图，其中显示站点上的已标记内容。

1. 连接到“站点内容”数据源。
2. 创建一个包含您要搜索的标记值的参数。该参数将在计算字段中使用。有关如何创建参数的详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[创建参数](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_create.htm)。
3. 从工具栏中，单击“分析”\>“创建计算字段”。
    
    1. 使用此计算仅返回参数值与整个标记匹配的内容。
        
        1. 名称：
            
            Tag Filter (Exact)
        2. 计算：
            
            CONTAINS(\[Tags\], "||" + <Your\_Parameter> + "||")
            
            **注意：**所有标记都合并为一个字符串，并由双管道 (||) 字符分隔。
    2. 使用此计算返回参数值出现在 \[Tags\] 字符串中任何位置的内容。
        
        1. 名称：
            
            Tag Filter (Wildcard)
        2. 计算：
            
            CONTAINS(\[Tags\], <Your\_Parameter>)
4. 从“数据”窗格中，将计算拖到“筛选器”功能区。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以将站点内容与以下字段上的其他“在线管理见解”数据源联接，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“项 ID = 项 ID”和“项类型 = 项类型”上将站点内容联接到 TS 事件
- 在“所有者电子邮件 = 用户电子邮件”或“所有者电子邮件 = 项父项目所有者电子邮件”上将站点内容联接到 TS 用户

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“站点内容”数据源中包含的字段。每行数据对应一个唯一的内容项，其中项目 LUID 是 Tableau Cloud 站点中内容的唯一标识符。

**注意：**“站点内容”数据源不包括虚拟连接信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="3">Data Source</td><td>Data Source Content Type</td><td>字符串</td><td>指示数据源是已发布还是已嵌入。对于任何非数据源的项都将为 NULL。</td></tr><tr><td>Data Source Database Type</td><td>字符串</td><td>数据库连接的类型（即 mysql、postgres、sqlproxy 等）。对于任何非数据源的项都将为 NULL。</td></tr><tr><td>Data Source Is Certified</td><td>布尔值</td><td>数据源是否为认证数据源。对于任何非数据源的项都将为 NULL。</td></tr><tr><td rowspan="14">Dates</td><td>Created At</td><td>日期时间</td><td>创建项的日期和时间 (UTC)。</td></tr><tr><td>Created At (Local)</td><td>日期时间</td><td>创建项的日期和时间，由时区参数调整。</td></tr><tr><td>Extracts Incremented At</td><td>日期时间</td><td>数据源增量刷新的日期和时间 (UTC)。仅适用于增量刷新。</td></tr><tr><td>Extracts Incremented At (Local)</td><td>日期时间</td><td>数据源增量刷新的日期和时间，由时区参数调整。</td></tr><tr><td>Extracts Refreshed At</td><td>日期时间</td><td>数据源上次刷新的日期和时间 (UTC)。仅适用于完全数据提取刷新。</td></tr><tr><td>Extracts Refreshed At (Local)</td><td>日期时间</td><td>数据源上次刷新的日期和时间，由时区参数调整。</td></tr><tr><td>First Published At</td><td>日期时间</td><td>项首次发布的日期和时间 (UTC)。</td></tr><tr><td>First Published At (Local)</td><td>日期时间</td><td>项首次发布的日期和时间，由您设置的时区参数调整。</td></tr><tr><td>Last Accessed At</td><td>日期时间</td><td>通过访问视图或连接数据源，上次访问项的日期和时间 (UTC)。</td></tr><tr><td>Last Accessed At (Local)</td><td>日期时间</td><td>通过访问视图或连接数据源，上次访问项的日期和时间，由您设置的时区参数调整。</td></tr><tr><td>Last Published At</td><td>日期时间</td><td>项上次发布的日期和时间 (UTC)。</td></tr><tr><td>Last Published At (Local)</td><td>日期时间</td><td>项上次发布的日期和时间，由您设置的时区参数调整。</td></tr><tr><td>Updated At</td><td>日期时间</td><td>项上次更新的日期和时间 (UTC)。</td></tr><tr><td>Updated At (Local)</td><td>日期时间</td><td>项上次更新的日期和时间，由您设置的时区参数调整。</td></tr><tr><td rowspan="2">Hyperlinks</td><td>Item Hyperlink</td><td>字符串</td><td>站点上项的完整 URL。（对于创建项的超链接很有用）。</td></tr><tr><td>Site Hyperlink</td><td>字符串</td><td>Tableau Cloud 站点的根 URL</td></tr><tr><td rowspan="17">Item</td><td>Description</td><td>字符串</td><td>项的文字描述。对于视图项将为 NULL。</td></tr><tr><td>Has Incremental Extract</td><td>布尔值</td><td>是否可以对此工作簿或数据源执行增量提取。</td></tr><tr><td>Has Refresh Scheduled</td><td>布尔值</td><td>工作簿或数据源是否按计划刷新数据提取。</td></tr><tr><td>Has Refreshable Extract</td><td>布尔值</td><td><p>工作簿或数据源是否有可刷新的数据提取。</p><p>（例如：通过 REST API 发布的 .hyper 文件无法从 Tableau Cloud 刷新，因此这些数据提取将被标记为 False）</p></td></tr><tr><td>Is Data Extract</td><td>布尔值</td><td>工作簿或数据源是否包含数据提取。</td></tr><tr><td>Item ID</td><td>数字</td><td>项的 ID。ID 在每个项类型和站点内都是唯一的。</td></tr><tr><td>Item LUID</td><td>字符串</td><td>项的 LUID。LUID 在每个项类型和站点内都是唯一的。主要用于通过 REST API 引用内容。</td></tr><tr><td>Item Name</td><td>字符串</td><td>项的显示名称。</td></tr><tr><td>Item Parent Project ID</td><td>数字</td><td>包含该项（例如工作簿或数据源）的父项目的项 ID。此项的父项目的项 ID。（例如：工作簿所在项目的项 ID。）</td></tr><tr><td>Item Parent Project Level</td><td>字符串</td><td>此项的父项目的项目级别。（例如：工作簿所在项目的项目级别。）</td></tr><tr><td>Item Parent Project Name</td><td>字符串</td><td>项的父项目的名称。例如，工作簿所在项目的项名称。</td></tr><tr><td>Item Parent Project Owner Email</td><td>字符串</td><td>父项目所有者的电子邮件地址</td></tr><tr><td>Item Revision</td><td>数字</td><td>项的修订号</td></tr><tr><td>Item Type</td><td>字符串</td><td>此内容所属的项的类型。数据源、流程、项目、视图或工作簿。</td></tr><tr><td>Owner Email</td><td>字符串</td><td>项所有者的电子邮件地址</td></tr><tr><td>标记</td><td>字符串</td><td>应用于该项的标记列表。所有标记都合并为一个字符串，并由双管道 (||) 字符分隔。</td></tr><tr><td>Top Parent Project Name</td><td>字符串</td><td><p>项的顶级父项目的名称。例如，此项的项目分层结构中项目级别 0 处的项目的项名称。对于顶层项目将为 NULL。</p></td></tr><tr><td rowspan="4">-</td><td>Size (bytes)</td><td>数字</td><td>以字节为单位的项大小（对于 GB ÷1,000,000,000）</td></tr><tr><td>Size (MB)</td><td>数字</td><td>以 MB 为单位的项大小（对于 GB ÷1,000）</td></tr><tr><td>Total Size (bytes)</td><td>数字</td><td>以字节为单位的项总大小（对于 GB ÷1,000,000,000）</td></tr><tr><td>Total Size (MB)</td><td>数字</td><td>以 MB 为单位的项总大小（对于 GB ÷ 1,000）</td></tr><tr><td rowspan="7">Metric</td><td>Adjustable Filter Options</td><td>字符串</td><td>作为可调筛选器选项添加到指标定义中的字段，或在指标上选择的筛选器选项。</td></tr><tr><td>Has Definition Filters</td><td>字符串</td><td>是否应用了定义筛选器。</td></tr><tr><td>Metric Definition Aggregation</td><td>字符串</td><td>正在跟踪的度量的聚合。</td></tr><tr><td>Metric Definition Data Source ID</td><td>字符串</td><td>指标定义所连接的数据源</td></tr><tr><td>Metric Definition ID for Related Metric</td><td>字符串</td><td>指标所关联的定义</td></tr><tr><td>Metric Definition Number Format</td><td>字符串</td><td>指标值的格式</td></tr><tr><td>Metric Time Granularity</td><td>字符串</td><td>数据汇总的详细级别</td></tr><tr><td rowspan="5">Project</td><td>Controlled Permissions Enabled</td><td>布尔值</td><td>项目的资产权限设置。当为真时，项目权限被锁定，资产继承项目权限规则。</td></tr><tr><td>Controlling Permissions Project LUID</td><td>字符串</td><td>控制嵌套项目权限的项目的 LUID</td></tr><tr><td>Controlling Permissions Project Name</td><td>字符串</td><td>控制嵌套项目权限的项目的名称</td></tr><tr><td>Nested Projects Permissions Enabled</td><td>布尔值</td><td>嵌套项目的资产权限设置。当为真时，嵌套项目权限被锁定，并且资产从父项目继承权限规则。</td></tr><tr><td>Project Level</td><td>数字</td><td>项目在其分层结构中的级别。每级值增加 1：0 = 顶级项目，1 = 其父级是顶级项目的项目，2 = 其父级的父级是顶级项目的项目，依此类推。对于任何非项目项，该值都是 NULL。</td></tr><tr><td rowspan="2">Site</td><td>Site LUID</td><td>字符串</td><td>与用户关联的站点的 LUID。主要用于在 REST API 中引用站点。</td></tr><tr><td>Site Name</td><td>字符串</td><td>Tableau Cloud 站点的名称</td></tr><tr><td>-</td><td>Storage Quota (bytes)</td><td>数字</td><td>Tableau Cloud 站点的存储容量（以字节为单位）。</td></tr><tr><td rowspan="4">View</td><td>View Title</td><td>字符串</td><td>视图的标题。对于非视图的项，该值为 NULL。</td></tr><tr><td>View Type</td><td>字符串</td><td>视图的类型。故事、仪表板或工作表。对于非视图的项，该值为 NULL。</td></tr><tr><td>View Workbook ID</td><td>数字</td><td>视图的父工作簿的 ID。主要用于超链接和 REST API。对于非视图的项，该值为 NULL。</td></tr><tr><td>View Workbook Name</td><td>字符串</td><td>视图的父工作簿的显示名称。对于非视图的项，该值为 NULL。</td></tr><tr><td>Workbook</td><td>Workbook Shows Sheets As Tabs</td><td>布尔值</td><td>工作簿的工作表是否显示为标签。对于非工作簿的项，该值为 NULL。</td></tr><tr><td rowspan="2">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Timezone</td><td>字符串</td><td>指定显示日期的时区。该字段表示一个整数值，用于确定与 UTC 偏移的小时数。它没有考虑夏令时调整。</td></tr></tbody></table>

<!-- document id=f45ca2c3a3551527cd71c7687fc7e7d99429218f5049410f56e448d044fddc32 url=/tableau/next/zh-cn/online/adminview_insights_subscriptions.md -->

[跳转到主要内容](#main-content)

# “订阅”数据源

订阅数据源提供有关站点订阅的详细信息，包括创建者和收件人的姓名、内容项、作业状态和计划。站点管理员可以使用此数据来改善通过订阅访问内容的用户的观看体验。

从 2024 年 2 月开始，订阅数据源包括您站点的 Tableau Pulse 信息。“用户组名称”和“用户组 LUID”字段已包含在 User 文件夹中。当用户作为组的一部分跟踪指标时，这些字段显示组名称和 LUID。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：用户多久收到一次订阅？

使用下列步骤创建显示用户接收订阅的频率的视图。

1. 连接到“订阅”和“TS 事件”数据源。
2. 选择“数据”\>“编辑混合关系”。
3. 在“混合关系”对话框中，将主数据源设置为“Subscriptions”（订阅），然后选择“自定义”单选按钮。
4. 单击“添加”。
5. 在“添加/编辑字段映射”对话框中，将“Subscriber Email”（订阅者电子邮件）映射到“Actor User Name”（参与者用户名），然后单击“确定”。
6. 单击“确定”退出“混合关系”对话框。
7. 从“数据”窗格中，将“Subscriber Email”（订阅者电子邮件）、“Subject”（主题）和“Last Sent (local)”（上次发送（本地））拖到“行”功能区。
8. 从“数据”窗格中，将“Number of Events”（事件数量）拖到“列”功能区。
9. 验证“Item LUID”（项 LUID）、“Item Type”（项类型）和“Actor User Name”（参与者用户名）是否为“数据”窗格中的链接字段。如果有断开的链接，请单击字段名称旁边的图标来链接两个数据源。
10. 从“数据”窗格中，将“Subscription Status”（订阅状态）拖到“标记”卡上的“颜色”。

### 示例：哪些 Pulse 指标最常用？

使用以下步骤创建显示最常用的 Tableau Pulse 指标的视图。

1. 连接到“订阅”数据源。
2. 从“数据”窗格中，将“Item Type”（项类型）拖到“筛选器”功能区，然后选中对话框中的“指标”复选框。
3. 将“Item LUID”（项 LUID）和“Item Name”（项名称）拖到“行”功能区。
4. 将“CNT(Subscriber User LUID)”（CNT（订阅者用户 LUID））拖到“列”功能区。
5. 从工具栏中，选择“降序排序”按钮以对 X 轴进行排序。
    
    **注意：**可视化项单独显示订阅的用户。若要按组查看订阅的用户，请使用“Subscriber Group Name”（订阅者组名称）和“Subscriber Group LUID”（订阅者组 LUID）字段。
6. 从菜单中，选择“分析”\>“创建计算字段”。
    
    1. 名称：
        
        Is Group Follow
    2. 计算：
        
        NOT ISNULL(Subscriber Group LUID)
7. 从“数据”LUID窗格中，将“Is Group Follow”（组关注）拖到“标记”卡上的“颜色”。
8. 将“Subscriber Group Name”（订阅者组名称）拖到“标记”卡上的“详细信息”。
    
    > [!TIP]
    > 
    > **提示：**了解哪些用户选择自己关注某个指标，而不是由他人添加的指标，可以帮助确定哪些指标自然受欢迎。
9. 从菜单中，选择“分析”\>“创建计算字段”。
    
    1. 名称：
        
        User Self-Followed
    2. 计算：
        
        NOT \[Is Group Follow\] AND \[Created By User Email\] <> \[Subscriber Email\]
10. 从“数据”窗格中，将“User Self-Followed”（用户自行关注）拖到“标记”卡上的“颜色”。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“订阅”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 通过“Subscriber Email = Actor User Name”（订阅者电子邮件 = 参与者用户名）将“Subscriptions”（订阅）联接到“TS Events”（TS 事件

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“订阅”数据源中包含的字段。每行数据对应一个订阅和收件人的组合。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="5">Content</td><td>Item LUID</td><td>字符串</td><td>订阅中包含的项的 LUID</td></tr><tr><td>Item Type</td><td>字符串</td><td>订阅中包含的项类型，即工作簿或视图。</td></tr><tr><td>Item Name</td><td>字符串</td><td>订阅中包含的项的显示名称</td></tr><tr><td>Item Owner Email</td><td>字符串</td><td>项所有者的电子邮件地址</td></tr><tr><td>Item Hyperlink</td><td>字符串</td><td>站点上项的完整 URL</td></tr><tr><td rowspan="14">Subscription</td><td>Data Conditions</td><td>字符串</td><td>发送订阅的条件，即“始终”或“当数据可用时”</td></tr><tr><td>Has Image Attached</td><td>布尔值</td><td>指示是否在订阅邮件中附加图片</td></tr><tr><td>Has PDF Attached</td><td>布尔值</td><td>指示订阅电子邮件中是否附加了 PDF</td></tr><tr><td>Is Extract Refresh Triggered</td><td>布尔值</td><td>指示与订阅相关的数据提取是否已刷新</td></tr><tr><td>Schedule LUID</td><td>字符串</td><td>计划的 LUID</td></tr><tr><td>Schedule Name</td><td>字符串</td><td>计划的名称</td></tr><tr><td>Subject</td><td>字符串</td><td>订阅的使用者</td></tr><tr><td>Subscription LUID</td><td>字符串</td><td>订阅的 LUID</td></tr><tr><td>Subscription Status</td><td>字符串</td><td>订阅的状态，即“活动”或“挂起”。</td></tr><tr><td>Subscription ID</td><td>数字</td><td>订阅的 ID</td></tr><tr><td>Created At</td><td>日期时间</td><td>订阅s的创建时间 (UTC)</td></tr><tr><td>Created At (Local)</td><td>日期时间</td><td>订阅的创建日期和时间，由时区参数调整。</td></tr><tr><td>Last Sent</td><td>日期时间</td><td>上次发送订阅的日期和时间 (UTC)</td></tr><tr><td>Last Sent (Local)</td><td>日期时间</td><td>上次发送订阅的日期和时间，由时区参数调整。</td></tr><tr><td rowspan="6">User</td><td>Created By User Email</td><td>字符串</td><td>创建订阅的用户的电子邮件地址</td></tr><tr><td>Created By User LUID</td><td>字符串</td><td>创建订阅的用户的 LUID</td></tr><tr><td>Subscriber Email</td><td>字符串</td><td>接收订阅的用户的电子邮件地址</td></tr><tr><td>Subscriber User LUID</td><td>字符串</td><td>接收订阅的用户的 LUID</td></tr><tr><td>Subscriber Group Name</td><td>字符串</td><td>如果用户作为某个组的一部分关注某个指标，则为该组的名称。</td></tr><tr><td>Subscriber Group LUID</td><td>字符串</td><td>如果用户作为某个组的一部分关注某个指标，则为该组的 LUID。</td></tr><tr><td rowspan="6">Schedule</td><td>Day of Month</td><td>字符串</td><td>运行此计划的月份中的某一天</td></tr><tr><td>Day of Week</td><td>字符串</td><td>运行此计划的周中的某一天</td></tr><tr><td>Schedule Type</td><td>字符串</td><td>指示计划是每小时、每天、每周还是每月运行。</td></tr><tr><td>Minute Interval</td><td>字符串</td><td>计划运行的频率（以分钟为单位）。</td></tr><tr><td>Start At Minute</td><td>字符串</td><td>计划将开始的一天中的时间</td></tr><tr><td>End At Minute</td><td>字符串</td><td>计划将结束的一天中的时间</td></tr><tr><td rowspan="6">Task</td><td>Task LUID</td><td>字符串</td><td>任务的 LUID</td></tr><tr><td>Task ID</td><td>数字</td><td>任务的 ID</td></tr><tr><td>Task Type</td><td>字符串</td><td>与此任务关联的后台作业的类型，例如数据提取、订阅或 Bridge 刷新。</td></tr><tr><td>Consecutive Failure Count</td><td>数字</td><td>任务的失败次数</td></tr><tr><td>Historical Queue Time</td><td>数字</td><td>任务排队的时间（以秒为单位）。</td></tr><tr><td>Historical Run Time</td><td>数字</td><td>完成任务所用的时间（以秒为单位）。不包括排队时间。</td></tr><tr><td rowspan="4">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Number of Recipients</td><td>数字</td><td>收件人的不同计数</td></tr><tr><td>Number of Subscriptions</td><td>数字</td><td>订阅的非重复计数</td></tr><tr><td>Timezone</td><td>字符串</td><td>指定显示日期的时区。该字段表示一个整数值，用于确定与 UTC 偏移的小时数。它没有考虑夏令时调整。</td></tr></tbody></table>

<!-- document id=60c87df9a1427799485460851e145802c2146f28295fdc0a5eb105ec60fa9e19 url=/tableau/next/zh-cn/online/to_bridge_security.md -->

[跳转到主要内容](#main-content)

# Bridge 安全性

Tableau Bridge 应用以下安全性设计：

- 所有通信都是从私有网络防火墙后面发起的，因此不需要您管理额外的例外情况。
- Tableau Bridge 和 Tableau Cloud 之间传输的数据是加密的。
- 如果数据源或虚拟连接设置为使用 “Bridge（旧版）”计划，则数据库凭据使用 Windows 凭据管理器存储在计算机上。对于刷新计划，凭据将传递给选择用于执行刷新的客户端。

您可以在以下部分中找到有关 Bridge 安全性的更多详细信息。

## 传输安全性

**注意**：Tableau Bridge 使用端口 443 向 Tableau Cloud 发出出站 Internet 请求，并使用端口 80 发出证书验证出站请求。

Tableau Bridge 使用 WebSocket (wss://) 连接与您的 Tableau Cloud 环境建立安全的双向通信。WebSocket 连接是持久的，并协调 Bridge 和 Tableau Cloud 之间的数据上载。所有用户在建立连接之前都经过身份验证和授权，并且所有输入都被验证为来自 Tableau Cloud 的可信来源。

## 身份验证

Bridge 有两个主要身份验证点：Tableau Cloud 和私有网络数据。

如果客户端解除链接或者升级到新版本，则无需重新登录。在这种情况下，Bridge 使用在 Windows 凭据存储中本地保存的现有令牌。

如果客户端关闭，或者使用 Windows 任务栏上的“退出”选项，则需要重新登录并提供凭据。这会创建一个新的刷新令牌，并将其保存到 Windows 凭据存储中。  

您可以检查凭据管理器中的令牌并检查 _TABLEAU\_CONNECTIONS\_online.tableau.com_ 的通用凭据。

### Tableau Cloud

若要连接到 Tableau Cloud，请通过 Bridge 客户端输入一个用户 Tableau Cloud 凭据。

1) 输入凭据之后，2) Tableau Cloud 将返回一个身份验证令牌。3) 该令牌使用 Windows 操作系统的凭据管理器存储在运行客户端的计算机上。Bridge 使用令牌来执行各种任务，例如下载数据提取的刷新计划令牌。

![图表说明了用户凭据从计算机到 Tableau Cloud 的旅程。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_security_auth_cloud_overview_sz.png)

### 私有网络数据

若要访问私有网络数据，某些数据源或虚拟连接需要使用数据库凭据进行身份验证。根据内容的连接类型，客户端将采用以下方式之一处理数据库凭据：

- 对于**使用刷新计划的实时连接和数据提取连接**，数据库凭据会在请求时发送，并使用 TLS 1.2 连接。
- 对于**使用 Bridge 旧版计划的数据提取连接**，如果数据源需要数据库凭据，则必须直接在客户端中输入这些凭据。数据库凭据使用 Windows 操作系统的凭据管理器存储在计算机上。客户端按计划的刷新时间将数据库凭据发送到同样位于私有网络防火墙后面的数据库。

客户端支持通过基于域的安全性 (Active Directory) 和用户名/密码凭据来访问私有网络数据。

## 对私有网络防火墙的更改

Bridge 客户端要求 无 对私有防火墙的更改。之所以无需更改，是因为客户端只会建立到 Tableau Cloud 的出站连接。为了允许出站连接，客户端使用以下协议，具体情况视内容使用的连接类型而定：

- 对于**使用刷新计划的实时连接和数据提取连接**，使用安全 WebSockets (wss://) 协议。
- 对于**使用 Bridge 旧版计划的数据提取连接**，使用 HTTP 安全 (https://) 协议。

## 访问私有网络数据

与私有网络数据的连接由 Bridge 客户端代表 Tableau Cloud 发起。发起连接的进程取决于内容类型和连接类型。

- 对于**包含实时连接或虚拟连接的数据源**，客户端将使用安全 WebSockets (wss://) 1) 建立与 Tableau Bridge 服务的持久连接，该服务是位于 Tableau Cloud 上的客户端的一部分。客户端随后将等待来自 Tableau Cloud 的响应，之后 2) 发起针对私有网络数据的实时查询。客户端 3) 将查询传递到私有网络数据，然后 4) 使用同一持久连接返回 5) 私有网络数据。
    
    ![Tableau Bridge 客户端与 Tableau Bridge 服务之间进行私有网络数据访问的连接过程图。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_security_live_cloud_sz.png)
- 对于**包含使用刷新计划的数据提取连接的数据源**，客户端将使用安全 WebSockets (wss://) 1) 建立与 Tableau Bridge 服务的持久连接，该服务是位于 Tableau Cloud 上的客户端的一部分。然后，客户端等待 Tableau Cloud 的请求，以获得新的刷新计划。当客户端收到请求时，2) 客户端使用数据源 (.tds) 文件的安全连接 (https://) 与 Tableau Cloud 联系。3/4) 然后客户端使用请求的作业中包含的嵌入式凭据连接到私有网络数据。客户端 5) 创建数据的数据提取，然后 6) 使用 Tableau Bridge 服务将数据提取重新发布到 Tableau Cloud。步骤 2-6 可以并行进行，以允许发生多个刷新请求。
    
    ![显示 Tableau Bridge 客户端、Tableau Cloud 和私有网络数据库之间的连接图。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_security_online_cloud-sz.png)
- 对于**包含使用 Bridge 旧版计划的数据提取连接的数据源**，客户端 1) 使用安全连接 (https://) 与 Tableau Cloud 联系来查询新刷新计划和数据源 (.tds) 文件。如果 2) 此信息可用，3/4) 则客户端将在计划的时间使用存储的凭据连接到私有网络数据。客户端 5) 创建数据的数据提取，然后 6) 使用 Tableau Bridge 服务将数据提取重新发布到 Tableau Cloud。Tableau Bridge 服务是位于 Tableau Cloud 上的客户端的一部分。
    
    ![Tableau Bridge 客户端与数据网络交互的图表。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_security_extract_cloud_sz.png)

## 转发代理筛选

为了确保只将数据传输到 Tableau Cloud，我们建议从 Bridge 客户端中对出站连接实现基于域的筛选（转发代理筛选）。初始出站连接后，通信是双向的。

Tableau Bridge 不支持直通式或手动代理身份验证。

以下列表包含部分限定的域名，Bridge 为出站连接使用这些域名：

- **\*.online.tableau.com**
- **\*.compute-1.amazonaws.com**，Amazon VPC 的公共 DNS 主机名，其形式为 ec2-<公共 ipv4 地址>.compute-1.amazonaws.com（适用于 us-east-1 区域）
- **\*.compute.amazonaws.com**，Amazon VPC 的公共 DNS 主机名，其形式 ec2-<公共 ipv4 地址>.compute.amazonaws.com（适用于 us-east-1 外的所有其他区域）。
- （可选）**\*.salesforce.com**、**id.tableau.com** 和 **identity.idp.tableau.com**，如果您的站点启用了带有 Tableau 身份验证（带有 MFA 的 Tableau）的多重身份验证 (MFA)，并且您的环境正在使用阻止客户端访问其他必要服务的代理
- （可选）**crash-artifacts-747369.s3.amazonaws.com**，用于接收崩溃转储报告
- （可选）**s3-us-west-2-w.amazonaws.com**，用于接收崩溃转储报告
- （可选）**s3-w-a.us-west-2.amazonaws.com**，用于接收崩溃转储报告
- （可选）**bam.nr-data.net**，用于 New Relic 的 Web 分析
- （可选）**Js-agent.newrelic.com，向**，向 New Relic 发送性能数据

<!-- document id=be8af67accf75fa9059bb889b3fd16b26531aac97531bd605f5a446c69febeff url=/tableau/next/zh-cn/online/adminview_bridge_extract.md -->

[跳转到主要内容](#main-content)

# Bridge 数据提取

“Bridge 数据提取”管理视图捕获 Tableau Bridge 最近 30 天进行的刷新活动。

![折线图显示数据提取随时间推移的刷新情况，第二个图表则按原因显示数据提取失败的次数。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_bridge_extracts.png)

这个预构建的管理视图可帮助回答站点管理员对一个或全部注册到站点的 Bridge 客户端执行的刷新可能具有的疑问：

- **错误率：**刷新成功和失败的频率如何？如果刷新失败，原因是什么？
- **进行的请求数：**安排了多少次刷新？
- **经过的时间：**刷新花费了多长时间？
- **饱和性：**每个客户端的忙碌程度如何？

您可以按客户端名称、数据提取数据源的创建时间、数据提取数据源名称和刷新持续时间筛选视图。

### 有关此视图的注意事项

- 如果在管理视图中看不到任何数据，请验证是否有与您的站点关联的 Bridge 客户端。或者，更改视图右上角的“已创建数据提取”筛选器的值。
- 如果您没有在视图中看到您期望的基于持续时间的数据，请通过单击“显示所有值”(![带有红色 X 标记的筛选器图标。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_show_all_values.png)) 图标清除“刷新的平均持续时间(秒)”筛选器。
- 在“常见数据提取刷新失败”表中，将鼠标指针悬停在每个条形上以查看错误和错误详细信息。如果存在多个与错误关联的数据源，则改为显示星号(\*)。
- 在某些情况下，_“数据提取的 Bridge 任务”_视图上的数据缺失或不完整。这是因为该视图不包含某些作业，例如已取消或失败的作业。使用_“数据提取后台任务”_查看特定于数据提取的任务。

<!-- document id=f58383f192d392ac6964ac27f086064f23f3f4cb00e7059bce57b88caea442d9 url=/tableau/next/zh-cn/online/to_bridge_site_capacity.md -->

[跳转到主要内容](#main-content)

# Bridge 站点容量

站点对于工作簿和数据提取有 1 TB 的存储限制。非标准版本或附加组件可提供额外容量。发布到站点的单个工作簿或数据源（实时或数据提取）的最佳最大大小为 25 GB。

Tableau Bridge 可能会对站点容量产生影响。

- Tableau Bridge 生成的数据提取确实会对站点存储容量产生影响。
- 通过 Bridge 提取的虚拟连接和嵌入式数据源也会影响站点容量。这是因为数据是通过 Tableau Cloud 后台程序处理的。

<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">Bridge 对站点容量的影响？</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="2" 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"><p>是（数据提取），请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#storage" class="xref">存储</a>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个工作簿、已发布数据源或流程大小</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>是，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#storage" class="xref">存储</a>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><b>使用 Bridge 提取已发布数据源</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">并发刷新</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>否</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><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" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3"><b>使用 Bridge 的虚拟连接和嵌入式数据源</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每日刷新</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">是，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#extracts" class="xref">数据提取 - 每日、运行时和内存使用量</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">并发刷新</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">是，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#extracts" class="xref">数据提取并发</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个刷新运行时间</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">是，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#extracts" class="xref">数据提取 - 每日、运行时和内存使用量</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"></tr><tr class="TableStyle-Basic-Border-Body-Body1"></tr></tbody></table>

<!-- document id=301398b19b031af6a413914b5d0051122c86ba249935224247bdab9410a7867b url=/tableau/next/zh-cn/online/creator_connect.md -->

[跳转到主要内容](#main-content)

# Creator：连接到 Web 上的数据

您需要先连接到数据，然后才能在 Web 上创建工作簿和构建视图来分析数据。Tableau 支持连接到 Web 上通过 Tableau Desktop 发布的数据源，或通过 Tableau Cloud、Tableau Server 或 Tableau Public 直接连接到数据。

从 2019.3 开始，Tableau Catalog 作为适用于 Tableau Server 和 Tableau Cloud 的 Data Management 产品的一部分提供。在环境中启用了 Tableau Catalog 后，除了通过“浏览”导航和连接到数据外，您还可以通过 Tableau Catalog 导航和连接到更多种类的数据，如数据库和表。有关 Tableau Catalog 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。从 2021.4 开始，Data Management 包括虚拟连接，即数据的中央访问点。有关详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_vconn_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_vconn_overview.htm) 帮助中的“关于虚拟连接和数据策略”。

## 打开“连接到数据”页面

在 Web 上，使用“连接到数据”页面访问要连接的数据。登录到 Tableau Server 或 Tableau Cloud，可以通过两种方式打开此页面：

- “主页”\>“新建”\>“工作簿”
- “浏览”\>“新建”\>“工作簿”

如果使用 Tableau Public，您可以从作者个人资料中打开此页面：

- “我的个人资料”\>“创建可视化项”

“连接到数据”对话框显示常见混合内容的可滚动列表。如果有 Data Management 许可证，您可以使用虚拟连接来连接到数据，如果有启用了 Tableau Catalog 的 Data Management，您还可以连接到外部资产，比如数据库、文件和表。

响应式搜索字段显示建议列表，该列表会在您输入文本时更新。按数据类型、认证状态或其他取决于所选数据类型的筛选器来筛选结果。例如，某些类型的数据可能允许您根据标记、连接类型、数据质量警告或其他条件进行筛选。旧版本的对话框和功能略有不同，但整体功能相似。

![连接到 Tableau Cloud 上的数据，可选择连接到数据源、虚拟连接、数据库和文件或表。](/tableau/next/zh-cn/online/zh-cn/Img/connect_to_data.png)

在“连接到数据”页面上，您看到的选项卡取决于您所拥有的产品。

在 Tableau Server 上，从以下选项卡中选择以连接到数据：“此站点上”、“文件”和“连接器”。

### 连接到“此站点上”的数据

1. 选择“此站点上”浏览到或搜索已发布的数据源。
2. 在“名称”下选择数据源，并单击“连接”按钮。

**注意：**除了连接到数据源之外，当您拥有 Data Management 时，您可以使用“此站点上”通过虚拟连接来连接到数据。启用 Tableau Catalog 后，您还可以连接到数据库、文件和表。

### 连接到文件

Tableau 支持直接在浏览器中上载 Excel 基于文本的数据源（.xlsx、.csv、.tsv），以及只需要一个文件的空间文件格式（.kml、.geojson、.topojson、.json 以及打包在 .zip 中的 Esri shapefile 和 Esri 文件地理数据库）。在“连接到数据”窗格的“文件”选项卡中，通过将文件拖放到字段中或单击“从计算机上载”来连接到该文件。您可以上载的最大文件大小为 1 GB。

### 使用连接器

从“连接器”选项卡中，您可以连接到存放于企业中的云数据库中或服务器上的数据。您必须为想要进行的每个数据连接提供连接信息。例如，对于大多数数据连接，您必须提供服务器名称和您的登录信息。

[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)包含有关如何将 Tableau 连接到其中每种连接器类型以设置数据源的信息。如果所需的连接器未出现在“连接器”选项卡中，您可以通过 Tableau Desktop 连接到数据，并将数据源发布到 Tableau Cloud 或 Tableau Server 用于 Web 制作。详细了解如何在 Tableau Desktop 中[发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources.htm)。

Tableau 成功连接到您的数据后，“数据源”页面将打开，以便您能够准备要分析的数据并开始构建视图。若要了解详细信息，请参见 [Creator：在 Web 上准备数据](https://help.tableau.com/current/pro/desktop/zh-cn/creator_data_prep.htm)。

#### Tableau Server 连接器

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix*</p><p>Alibaba AnalyticDB for MySQL‡</p><p>Alibaba Data Lake Analytics‡</p><p>Alibaba MaxCompute‡</p><p>Amazon Athena‡</p><p>Amazon Aurora for MySQL‡</p><p>Amazon EMR&nbsp;Hadoop Hive‡</p><p>Amazon Redshift‡</p><p>Apache Drill‡</p><p>Aster Database*</p><p>Azure Data Lake Storage Gen2‡</p><p>Box‡</p><p>Cloudera Hadoop‡</p><p>Databricks‡</p><p>Datorama by Salesforce‡</p><p>Denodo‡</p><p>Dremio by Dremio‡</p><p>Dropbox‡</p><p>Esri 连接器‡</p><p>Exasol‡</p></td><td><p>Google BigQuery**‡</p><p>Google BigQuery JDBC**‡</p><p>Google Cloud SQL‡</p><p>Google 云端硬盘‡</p><p>Impala‡</p><p>Kognito*</p><p>Kyvos‡</p><p>Hortonworks Hadoop Hive</p><p>IBM BigInsights</p><p>IBM DB2‡</p><p>IBM PDA (Netezza)*</p><p>Kyvos‡</p><p>MariaDB‡</p><p>MarkLogic*</p><p>Microsoft Azure SQL Database‡</p><p>Microsoft Azure Synapse Analytics‡</p><p>Microsoft SQL Server‡</p><p>MonetDB*</p><p>MongoDB&nbsp;BI&nbsp;Connector‡</p><p>MySQL‡</p></td><td><p>OData‡</p><p>OneDrive‡</p><p>Oracle‡</p><p>Pivotal Greenplum Database‡</p><p>PostgreSQL‡</p><p>Progress OpenEdge*</p><p>Presto‡</p><p>Qubole Presto‡</p><p>SAP HANA（仅适用于虚拟连接）‡</p><p>SAP Sybase ASE*</p><p>SAP Sybase IQ*</p><p>Salesforce‡</p><p>Sharepoint 列表‡</p><p>SingleStore（前身为 MemSQL）‡</p><p>Snowflake‡</p><p>Spark&nbsp;SQL‡</p><p>Teradata***‡</p><p>Vertica‡</p></td></tr></tbody></table>

\*在 Linux 服务器上不可用。

\*\*在通过 Web 创建数据源时，Google BigQuery 需要 OAuth。详细了解服务器管理员如何能[为 Google 设置 OAuth](https://help.tableau.com/current/server/zh-cn/config_oauth_google.htm)。

\*\*\*Teradata Web 制作当前不支持查询分段功能。有关详细信息，请参见 [Teradata](https://help.tableau.com/current/pro/desktop/zh-cn/examples_teradata.htm)。

‡支持虚拟连接（如果您有 Data Management）。有关详细信息，请参见 Tableau Server 帮助中的[关于虚拟连接和数据策略](https://help.tableau.com/current/server/zh-cn/dm_vconn_overview.htm)。

#### Tableau Catalog 支持的连接器

Tableau Catalog 支持使用 Tableau Server 支持的一部分数据连接器进行连接。如果数据源、数据库、文件或表呈灰色显示，则无法通过 Tableau Server 进行连接。不过，如果有正确的权限，您可以通过 Tableau Desktop 的“连接”窗格进行连接。

在 Tableau Cloud 上，从以下选项卡中选择以连接到数据：“此站点上”、“文件”、“连接器”和“仪表板起始模板”。

### 连接到“此站点上”的数据

1. 选择“此站点上”浏览到或搜索已发布的数据源。
2. 在“名称”下选择数据源，并单击“连接”按钮。

**注意：**除了连接到数据源之外，当您拥有 Data Management 时，您可以使用“此站点上”通过虚拟连接来连接到数据。启用 Tableau Catalog 后，您还可以连接到数据库、文件和表。

### 连接到文件

Tableau 支持直接在浏览器中上载 Excel 或基于文本的数据源（.xlsx、.csv、.tsv）。在“连接到数据”窗格的“文件”选项卡中，通过将 Excel 或文本文件拖放到字段中并单击“从计算机上载”来连接到该文件。您可以上载的最大文件大小为 1 GB。

### 使用连接器

从“连接器”选项卡中，您可以连接到存放于企业中的云数据库中或服务器上的数据。您必须为想要进行的每个数据连接提供连接信息。例如，对于大多数数据连接，您必须提供服务器名称和您的登录信息。

[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)包含有关如何使用连接器将 Tableau 连接到数据的信息。如果所需的连接器未出现在“连接器”选项卡中，您可以通过 Tableau Desktop 连接到数据，并将数据源发布到 Tableau Cloud 或 Tableau Server 用于 Web 制作。详细了解如何在 Tableau Desktop 中[发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources.htm)。

**注意**：如果无法从 Tableau Cloud 连接到数据，请检查以确定数据库是否可公开访问。Tableau Cloud 只能连接到可从公共 Internet 中访问的数据。如果您的数据位于专用网络后面，您可以使用 Tableau Bridge 进行连接。若要了解详细信息，请参见[发布者：使用 Tableau Bridge 使 Tableau Cloud 数据保持最新](https://help.tableau.com/current/online/zh-cn/qs_refresh_local_data.htm)。

#### Tableau Cloud 连接器

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Alibaba AnalyticsDB for MySQL‡</p><p>Alibaba Data Lake Analytics‡</p><p>Amazon Athena‡</p><p>Amazon Aurora for MySQL‡</p><p>Amazon EMR&nbsp;Hadoop Hive‡</p><p>Amazon Redshift‡</p><p>Apache Drill‡</p><p>Azure Data Lake Storage Gen2‡</p><p>Azure Synapse Analytics（兼容 SQL Server）</p><p>Box‡</p><p>Cloudera Hadoop‡</p><p>Databricks‡</p><p>Datorama by Salesforce‡</p><p>Denodo‡</p><p>Dremio by Dremio‡</p></td><td><p>Dropbox*‡</p><p>Esri 连接器‡</p><p>Exasol‡</p><p>Google BigQuery*‡</p><p>Google Cloud SQL（兼容 MySQL）‡§</p><p>Google 云端硬盘‡</p><p>Hortonworks Hadoop Hive</p><p>Impala‡</p><p>Kyvos‡</p><p>MariaDB‡</p><p>Microsoft Azure SQL&nbsp;Database‡</p><p>Microsoft Azure Synapse Analytics‡</p><p>Microsoft SQL Server‡</p><p>MongoDB BI&nbsp;Connector‡</p><p>MySQL‡</p></td><td><p>OData‡</p><p>OneDrive*‡</p><p>Oracle‡</p><p>Pivotal Greenplum Database‡</p><p>PostgreSQL‡</p><p>Presto‡</p><p>Qubole Presto‡</p><p>Salesforce‡</p><p>SAP HANA（仅适用于虚拟连接）‡</p><p>Sharepoint 列表‡</p><p>SingleStore（前身为 MemSQL）‡</p><p>Snowflake‡</p><p>Spark SQL‡</p><p>Teradata**‡</p><p>Vertica‡</p></td></tr></tbody></table>

\* 有关在 Tableau Cloud 中对 Google BigQuery、OneDrive 和 Dropbox 连接使用 OAuth 2.0 标准的详细信息，请参见 [OAuth 连接](https://help.tableau.com/current/online/zh-cn/protected_auth.htm)。

\*\*Teradata Web 制作当前不支持查询分段功能。有关详细信息，请参见 [Teradata](https://help.tableau.com/current/pro/desktop/zh-cn/examples_teradata.htm)。

‡支持虚拟连接（如果您有 Data Management）。有关详细信息，请参见 Tableau Cloud 帮助中的[关于虚拟连接和数据策略](https://help.tableau.com/current/online/zh-cn/dm_vconn_overview.htm)。

§Tableau Cloud 不支持使用 Google Cloud SQL 的 SSL。

#### Tableau Catalog 支持的连接器

Tableau Catalog 支持使用 Tableau Cloud 支持的一部分数据连接器进行连接。如果数据源、数据库、文件或表呈灰色显示，则无法通过 Tableau Cloud 进行连接。不过，如果有正确的权限，您可以通过 Tableau Desktop 的“连接”窗格进行连接。

### 使用仪表板起始模板

在 Tableau Cloud 上，您可以使用“仪表板起始模板”制作和分析来自 LinkedIn Sales Navigator、Oracle Eloqua、Salesforce、ServiceNow ITSM 和 QuickBooks Online 的数据。在“仪表板起始模板”选项卡上，从预先构建的设计列表中选择一个选项，并单击“使用仪表板”。有关详细信息，请参见[基于云的数据源的仪表板起始模板](https://help.tableau.com/current/pro/desktop/zh-cn/starters.htm)。

### 使用 Tableau Bridge 进行 Web 制作

在 Tableau Cloud 内制作数据视图或直接在 Web 上工作时，Tableau Bridge 为各种数据库和云数据环境提供完整的查询支持：

- **指定连接器**：您可以在 Web 制作会话期间直接为 Tableau Cloud 连接窗格中显示的任何受支持的命名连接器建立全新的数据连接。
- **非指定/通用连接器**：在修改已指向功能齐全、预先存在的 Bridge 支持的架构的内容时，Web 制作与某些非指定数据库连接器完全兼容。这包括：
    
    - “编辑数据源”选项可能不适用于所有未命名连接器。
    - 编辑现有且正常运行的云工作簿中的嵌入式数据源。

Tableau 不支持在所有情况下通过 Web 制作编辑已发布数据源。限制如下：

- **“编辑数据源”**选项可能不适用于使用未命名（通用）连接器的已发布数据源。按钮显示为灰色。
- 当前不支持编辑包含 Bridge 数据源的多个连接的实时已发布数据源，否则会导致错误。

有关详细信息，请参见[“与 Bridge 的连接”](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)。

在 Tableau Public 上，您可以通过上传支持的文件连接到数据。

### 连接到文件

Tableau 支持直接在浏览器中上载 Excel 或基于文本的数据源（.xlsx、.csv、.tsv）。在“连接到数据”窗格的“文件”选项卡中，通过将 Excel 或文本文件拖放到字段中并单击“从计算机上载”来连接到该文件。您可以上载的最大文件大小为 1 GB。

如果您没有数据集，请查看 Tableau Public 网站上免费的[示例数据集](https://public.tableau.com/zh-cn/s/resources?qt-overview_resources=1#qt-overview_resources)。

### 使用连接器

从“连接器”选项卡中，您可以连接到存放于云数据库中的数据。您必须为想要进行的每个数据连接提供连接信息。例如，对于大多数数据连接，您必须提供您的登录信息。

[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)包含有关如何使用连接器将 Tableau 连接到数据的信息。如果所需的连接器未出现在“连接器”选项卡中，您可以通过 Tableau Desktop 连接到数据，并创建数据提取。

**注意**：如果无法从 Tableau Public 连接到数据，请检查以确定数据库是否可公开访问。Tableau Public 只能连接到可从公共 Internet 中访问的数据。

#### Tableau Public 连接器

<table style="width: 100%;"><colgroup><col></colgroup><tbody><tr><td><p>Google 云端硬盘</p><p>OData</p></td></tr></tbody></table>

## 连接之后

Tableau 连接到您的数据后，“数据源”页面将打开，以便您能够准备要分析的数据并开始构建视图。若要了解详细信息，请参见 [Creator：在 Web 上准备数据](https://help.tableau.com/current/pro/desktop/zh-cn/creator_data_prep.htm)。

## 在 Web 制作过程中使数据保持最新

**在 Tableau Cloud 或 Tableau Server 中更新上载的文件**：如果手动上载文件（Excel 或文本）进行 Web 制作，Tableau 无法自动刷新文件。若要更新数据，请选择“编辑连接”来上载文件的新版本。

在 Tableau Public 中，转到您的可视化项并单击“请求更新”。您还可以通过在 Tableau Desktop Public Edition 中选择“使此数据保持同步”来自动使数据保持最新。

**在 Tableau Cloud 中更新基于文件的已发布数据源：**如果 Tableau Cloud 中有使用基于文件的数据的已发布数据源（通过 Tableau Desktop 发布），您可以使用 Tableau Bridge 使其保持最新。有关详细信息，请参见[使用 Tableau Bridge 扩展数据新鲜度选项](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)。

并非所有情形都支持通过 Web 制作编辑已发布数据源。限制如下：

- 对于使用未命名（通用）连接器的已发布数据源，“编辑数据源”选项不可用。该按钮可能显示为灰色。
- 编辑实时 PDS（无论是通过 Web 制作创建还是从 Tableau Desktop 发布）可能会导致连接错误。Tableau Cloud 可能会尝试直接连接到数据库，而不是通过 Bridge 路由，从而导致请求失败。
- 当前不支持编辑包含 Bridge 数据源的多个连接的实时 PDS，并且将导致错误。

了解使用 Bridge 进行 Web 制作期间的错误

Web 制作失败期间显示的错误消息可能未明确指明与 Bridge 相关的问题。常见情形及其含义：

- 网络或登录超时错误（例如，“发生了网络相关或实例特定的错误”或“登录超时已过期”）可能表示 Tableau Cloud 回退为直接尝试连接，而不是通过 Bridge 进行路由。验证您的 Bridge 客户端是否已连接并分配给正确的池。
- NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL 错误表示没有将 Bridge 代理分配给为您的站点配置的命名池。分配一个活动 Bridge 客户端来解决此问题。
- 如果“编辑数据源”按钮呈灰色显示，则数据源使用当前不支持通过 Web 制作进行编辑的未命名连接器。

<!-- document id=44ee4800c8f74914b3c571d0ed9342e4ae6268dc2617ead6b602ca50d0ec159a url=/tableau/next/zh-cn/online/csvguidelines.md -->

[跳转到主要内容](#main-content)

# CSV 导入文件准则

通过创建含有用户信息的逗号分隔值 (CSV) 文件，然后导入该文件，即可批量添加用户。您可以在 CSV 文件中包括属性（例如许可级别和发布访问权限），以便在导入这些属性的同时将它们应用于用户。

本主题介绍 CSV 文件本身的详细信息。若要使用 CSV 导入用户，您可以：

- 使用站点管理页面。有关信息，请参见[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)
- 使用 `tabcmd` 实用工具。有关信息，请参见 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。
- 使用 Tableau Cloud Manager。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

## CSV 文件格式要求

用于导入用户的 CSV 文件具有以下格式要求：

- 没有列标题。Tableau Cloud假定文件中的每一行代表一个用户。
- 只有在导入到站点时才支持带字节顺序标记 (BOM) 的 UTF-8 格式。如果要导入到 Tableau Cloud Manager，请使用 UTF-8 格式并从文件中移除任何 BOM。
    - 诸如 BIG-5 等字符编码必须转换为 UTF-8。可通过在文本编辑器中打开文件并使用“另存为”命令来达到此目的。
    - 如果 `@` 字符出现在除域分隔符以外的任何**用户名**字段中，则它必须为十六进制格式：`\0x40`。例如，`user@fremont@mycompany.com` 应该为 `user\0x40fremont@mycompany.com`。

## CSV 文件中所需的列结构

文件不应包含标题行。并非所有列都需要填写，但必须通过包括所有预期的逗号分隔符来保留所需的列结构。

列结构因产品和导入工具而异。确保使用适合您的环境的结构：

- **Tableau Cloud：**username、password、display name、license level、administrator level、publishing capability、email address
- **带有 Tableau Cloud Manager (TCM) 的 Tableau Cloud：**tenant or site URI、username, password、display name、license level、administrator level、publishing capability、email address、authentication type
- **Tableau Server：**username、password、display name、license level、admin level、publishing capability、email address
- **使用身份池的 Tableau Server：**username、password、display name、license level、admin level、publishing capability、email address、identity pool name、identifier

有关每列的可能值的详细信息，请参见下面的列详细信息部分。

> [!WARNING]
> 
> **重要信息：**列的顺序非常重要。将第一列视为用户名，将第二列视为密码，将第三列视为显示名称等等，而不考虑列中的内容。如果忽略字段的值，您必须仍然包括字段的逗号分隔符。

## Tableau Cloud CSV 的列详细信息

如果 CSV 文件仅包含 username 值（电子邮件地址），则用户将会收到邀请其访问站点的电子邮件。用户可以联接站点以创建帐户，但在管理员配置他们的帐户（显示名称、许可级别等）之前，他们的帐户会保持未许可状态。用户在站点上的电子邮件地址可能会在站点上显示前导句点（例如 `.user@domain.com`），直到用户首次登录为止。

CSV 文件的列结构：_username、password、display name、license level、administrator level、publishing capability、email address_

### 列详细信息

任何留空的列仍必须用逗号分隔，以保留列结构。

**Username：**_必填_。用户的电子邮件地址。

**Password：**_忽略_。作为最佳做法，请将此列留空。

- 新用户在首次登录到 Tableau Cloud 时必须选择密码和显示名称。如果用户已有 Tableau 帐户，则他们可能已经有密码。

**Display name：**_忽略_。作为最佳做法，请将此列留空。

**License level：**可以是**“Creator”**、**“Explorer”**、**“Viewer（查看者）”**或**“Unlicensed”**。如果留空，则许可级别将为 Unlicensed。

**Administrator level：**可以是**“Site”**或**“None”**。如果留空，则 administrator level 将为 None。

- Site = 站点管理员，None = 非管理员。
- **注意**：使用 Tableau Cloud Manager 时，云只是一个相关值。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

**Publishing capability：**可以是**“Yes/True/1”**或**“No/False/0”**。如果留空，则 publishing capability 将为 false。

- 如果 license level 为 Creator，则 publishing capability 必须为 Yes/True/1
- 如果 license level 为 Explorer，则 publishing capability 值就是区分“Explorer（可发布）”和“Explorer”的站点角色的值
- 如果 license level 为 Viewer 或 Unlicensed，则无论此列的值如何，用户都将无法进行发布

**Email address：**从 2025 年 7 月（Tableau 2025.2）开始，如果与用户名不同，您可以指定电子邮件地址。电子邮件地址仅用于通知目的。如果未提供电子邮件地址值，Tableau Cloud 将使用必填用户名字段中的值来发送通知。出于安全考虑，您只能指定仅是一个站点的成员用户的电子邮件地址。  

### 不使用 TCM 的身份验证类型

如果您不使用 Tableau Cloud Manager，则在上载过程中只能设置单一默认身份验证类型。之后，您可以为个别用户更改身份验证类型。

- 直接在 Tableau Cloud 中上载 CSV 文件时，请在导入文件时指定身份验证类型，该类型将应用于所有导入的用户。
- 使用 `tabcmd` 来导入用户时，请在上载期间设置身份验证类型和适用于 CSV 文件中所有用户的站点角色。有关信息，请参见 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。

若要在上载时为每个用户设置特定的身份验证类型，您必须使用 Tableau Cloud Manager。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

### Tableau Cloud CSV 示例结构

> [!TIP]
> 
> **提示：**请记住，结构为：`username, password, display name, license level, administrator level, publishing capability, email address`，当列留空时，逗号之间没有任何内容。

以下示例显示一个用户，该用户被授予“Explorer（可发布）”站点角色、将不会是站点管理员，并且将能够发布其有适当内容权限的项目。

user1@domain.com,,,Explorer,None,true,user1@domain2.com

通过更改 administrator-level 列，您将能以具有“站点管理员 Explorer”站点角色的站点管理员形式导入以下用户。

adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com

## TCM CSV 的列详细信息

如果 CSV 文件仅包含用户名（电子邮件地址）值，则用户将会收到邀请其访问站点的电子邮件。用户可以联接站点以创建帐户，但在管理员配置他们的帐户（显示名称、许可级别等）之前，他们的帐户会保持未许可状态。

请记住，留空的列仍必须用逗号分隔，以保留列结构。

CSV 文件的列结构：`tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type`

### 列详细信息

**Tenant or site URI：**租户或站点的统一资源标识符。

**Username：**_必填_。用户的电子邮件地址。

**Password：**_忽略_。作为最佳做法，请将此列留空。

- 新用户在首次登录到 Tableau Cloud 时必须选择密码和显示名称。如果用户已有 Tableau 帐户，则他们可能已经有密码。

**Display name：**_忽略_。作为最佳做法，请将此列留空。

**License level：**对于站点，可以是**“Creator”**、**“Explorer”**、**“Viewer（查看者）”**或**“Unlicensed”**。如果留空，则许可级别将为 Unlicensed。

**Administrator level：**可以是**“Site”**、**“Cloud”**或**“None”**。如果留空，则 administrator level 将为 None。

- Site = 站点管理员，None = 非管理员，Cloud = 云管理员。

**Publishing capability：**对于站点，可以是**“True”**或**“False”**。如果留空，则 publishing capability 将为 false。

- 如果 license level 为 Creator，则 publishing capability 必须为 True
- 如果 license level 为 Explorer，则 publishing capability 值就是区分“Explorer（可发布）”和“Explorer”的站点角色的值
- 如果 license level 为 Viewer 或 Unlicensed，则无论此列的值如何，用户都将无法进行发布

**Authentication type：**用于访问租户或站点的用户身份验证类型。可以是**“Google”**、**“OpenID”**、**“Salesforce”**、**“SAML”**、**“TableauIDWithMFA”**或**“DEFAULT”**。

### TCM CSV 示例结构

> [!TIP]
> 
> **提示：**请记住，结构为：`tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type`，当列留空时，逗号之间没有任何内容。

以下示例显示了在 Tableau Cloud Manager 中被授予云管理员角色的用户，并使用带有 MFA 的 Tableau 进行身份验证。

TCM,cloudadminuser@domain.com,,,,Cloud,,TableauIDWithMFA

通过更改 authentication 列，您可以使用备用身份验证类型导入以下用户（如果在 Tableau Cloud Manager 设置中配置了该类型）。

TCM,cloudadminuser@domain.com,,,,Cloud,,Salesforce

在以下示例中，您可以使用带有 MFA 的 Tableau 身份验证导入站点角色为“Explorer - 可发布”的用户。

MySite,user1@domain.com,,,Explorer,None,True,TableauIDWithMFA

## CSV 设置和站点角色

用户的许可证级别、管理员和发布设置确定如何在导入过程中设置用户的站点角色。下面介绍了应如何在 CSV 中捕获站点角色。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 30%;"><col style="width: 30%;"><col style="width: 20%;"><col></colgroup><tbody><tr><td style="font-weight: bold;">站点角色</td><td style="font-weight: bold;">License level</td><td style="font-weight: bold;">Administrator level</td><td style="font-weight: bold;">Publishing capability</td></tr><tr><td><p><b>云管理员</b></p><p><i>仅当您在登录 Tableau Cloud Manager（即未登录特定站点）的情况下导入用户时，此角色才有效。</i></p></td><td>Unlicensed</td><td>Cloud</td><td>False</td></tr><tr><td><p><b>站点管理员 Creator</b> 或<b>站点管理员 Explorer</b></p><p><i>仅当您在登录到特定站点的情况下导入用户时，这些角色才有效。</i></p></td><td>Creator 或 Explorer</td><td>Site</td><td>True</td></tr><tr><td><b>Creator</b></td><td>Creator</td><td>None</td><td>True</td></tr><tr><td><b>Explorer（可发布）</b></td><td>Explorer</td><td>None</td><td>True</td></tr><tr><td><b>Explorer</b></td><td>Explorer</td><td>None</td><td>False</td></tr><tr><td><b>Viewer（查看者）</b></td><td>Viewer（查看者）</td><td>None</td><td>False</td></tr><tr><td><b>Unlicensed</b></td><td>Unlicensed</td><td>None</td><td>False</td></tr></tbody></table>

<!-- document id=ce21565a4cce991e021591b867a3e3b6a49b01635c2875c2318b410a731c0439 url=/tableau/next/zh-cn/online/data_connect_security.md -->

[跳转到主要内容](#main-content)

# Data Connect 安全性

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 采用责任共担模式运行。使用此模型，您可以提供物理或虚拟计算资源，Tableau 在这些资源上托管和管理 Data Connect Kubernetes 群集。Tableau 通过远程管理、监控和维护 Kubernetes 群集来减少管理开销。由于能够执行补救措施以实现持续可用性，Tableau 无需监控流量和连接状态。此外，为了减少延迟和降低网络拥塞，Data Connect 允许您确定最符合您的性能要求的数据中心、边缘位置和环境。在这种模型中，Tableau 负责安全地操作数据连接服务，而您负责管理基础设施和网络层。

![Data Connect 环境的各种组件以及管理这些组件的责任。](/tableau/next/zh-cn/online/zh-cn/Img/data_connect-security_894x611.png)

## 安全性设计

Data Connect 应用以下安全性设计：

- Data Connect 服务是控制平面服务，无法访问您的数据。Data Connect 服务的底层组件是 Tableau Bridge。
- 为了促进安全的数据传输，Data Connect 使用 Tableau Bridge，它利用安全的 Web 套接字与 Tableau Cloud 建立持久连接。
- Data Connect 服务不与数据库凭据或数据库访问交互。数据库凭据安全地存储在 Tableau Cloud 上，并传递给选择执行刷新的 Tableau Bridge 客户端。
- 所有通信都是从防火墙后面发起的，因此不需要任何额外的明确入站防火墙规则来管理异常。

除其他操作外，Bridge 客户端还负责访问您的数据并与 Tableau Cloud 建立安全的 Web 套接字连接。请参见[Bridge 安全性](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_security.htm)。

## 架构

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_setup_579x566.png)

1. Tableau Cloud 与 Kubernetes 业务流程服务通信，以部署、监视和管理 Kubernetes 业务流程。
2. 初始化 Data Connect 时，通过端口 443 与业务流程提供程序服务建立安全连接。
3. 配置服务后，Kubernetes 群集将部署带有 Bridge 客户端的容器。这些 Bridge 客户端将负责执行 Tableau 工作负载。
4. Tableau Cloud 用户登录 Tableau Cloud 以与 Data Connect 服务进行交互。
5. 在设置时，Bridge 客户端使用 HTTPS 初始化与 Tableau Cloud 的连接。成功连接后，Bridge 客户端使用 WebSocket (wss://) 连接与您的 Tableau Cloud 环境建立安全的双向通信。
6. 从 Tableau Cloud 发起的查询针对您的数据库运行，以支持最终用户分析。

## 安全 层

Data Connect 解决方案有三个层。安装在您的基础设施中的_应用程序_、用于部署和管理应用程序的_业务流程_层，以及支持网络和硬件_基础设施_。

- 应用程序层：数据库身份验证、将数据发送到 Tableau Cloud 以及网络注意事项，请参见[Bridge 安全性](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_security.htm)。
- 业务流程层：请参见下面的[容器编排](#orchestration)部分。
- 基础设施层：在 Data Connect 责任共担模型中，基础设施本身的安全将由您负责。以下部分介绍 Data Connect 业务流程层如何与您的基础设施交互的安全详细信息。

## 服务配置

在 Data Connect 配置期间，您将负责从您的网络内部配置和启动服务。此过程提供正确的访问级别并指定哪些数据访问节点要与您的 Tableau Cloud 站点集成。有关 Data Connect 服务配置的详细信息，请参见[步骤 1：设置群集](https://help.tableau.com/v0.0/online/zh-cn/data_connect_setup.htm#setup-cluster)。

在初始化 Data Connect 解决方案时，会发生以下情况：

- Data Connect 节点运行状况已验证。
- 通过端口 443 与业务流程提供程序服务建立安全连接。
- Kubernetes 操作软件已下载并安装到计算机上。此软件允许 Tableau 远程部署和管理 Data Connect。
- 通过安全连接查询 Data Connect 节点信息以维护服务的运行状况。

您的数据永远不会通过业务流程连接传输。

## Tableau Cloud 通信

从您的基础设施到 Tableau Cloud 的所有通信都是从防火墙后面发起的。您不必管理额外的例外情况。

有关 Data Connect 通信和基础设施配置的详细信息，请参见[网络规格](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm#Networki)。

## Tableau Cloud 身份验证

Data Connect 创建身份验证令牌，用于保护 Tableau Bridge 与 Tableau Cloud 的连接。这些令牌特定于站点，并由它们与之关联的 Bridge 客户端池使用。令牌存储在群集上的 [Kubernetes 密文](http://kubernetes.io/docs/concepts/configuration/secret/)中，由 Data Connect 管理。部署在该群集上的 Bridge 客户端可访问这些令牌来登录 Tableau Cloud，但这些令牌不会存储在客户端上。

为了保持 Data Connect 服务平稳运行，使用 Data Connect 的所有站点的站点管理员需要在 Tableau Cloud 中每 90 天刷新一次池的令牌。如果令牌未刷新，该池中的 Bridge 客户端将无法向 Tableau Cloud 站点进行身份验证，并且使用该池的作业将失败。

## 数据库身份验证

您可以在[Bridge 安全性](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_security.htm)中找到有关身份验证的更多详细信息。

在数据库身份验证的背景下，重要的是要了解 Data Connect 仅支持 Bridge 刷新计划，而不支持 Bridge 旧版计划。

## 容器编排

业务流程层仅是一个控制层，无法访问数据层，因此不会与客户数据交互。Data Connect 与数据层交互的唯一方面是安装在您基础设施上的应用程序。此应用程序是 Bridge 客户端。

## 安全常见问题解答

### 容器上预置了什么代码？

除了 Kubernetes 操作（kops）所需的软件外，还部署了适用于容器的 Linux 版 Tableau Bridge。创建基础映像时，必须预置数据库驱动程序。

### 如何管理 Data Connect 部署的软件上检测到的漏洞？

您通过基础映像提供 Data Connect 部署的所有软件。若要更改已部署的软件，您需要提供一个新基础映像。然后，该映像将被部署到该池中的所有 Data Connect 节点。

### Data Connect 需要什么级别的计算机访问权限？

Data Connect 需要对您的基础设施进行管理级别的访问。此访问权限允许 Tableau 更新和维护服务。

<!-- document id=55ef4ea2322285766675e8e439cf70163204ef2dbeb82597f924cb6d7d5a513e url=/tableau/next/zh-cn/online/security_auth_google.md -->

[跳转到主要内容](#main-content)

# Google 身份验证

如果您的组织使用 Google，则您可以启用 Tableau Cloud 或 TCM 以使用 Google 帐户通过 OpenID Connect 借助多重身份验证(MFA) 进行单点登录。Tableau 支持 Google 身份验证作为身份验证类型。当您启用 Google 身份验证时，系统会将用户定向到 Google 登录页面，以便输入和管理由 Google 存储和管理的凭据。

## 配置身份验证类型

如果您的组织已经在使用 Google，那么在 Tableau Cloud 中将身份验证类型设置为 Google 或 TCM。

**对于 Tableau Cloud**

1. 以站点管理员身份登录到 Tableau Cloud。
2. 选择“设置”\>“身份验证”，单击“新配置”按钮，然后从“身份验证”下拉菜单中选择“Google”。
    
    **注意：**如果 Google 不在可用选项列表中，则表示您的站点已启用 Google 身份验证。
3. 为配置输入一个名称，并单击“保存变更”：
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/to_site_auth_google.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。
4. 添加新用户（或更新任何以前的用户）以使用 Google 作为其配置的身份验证类型。
    
    - 若要添加用户，请参见[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)。
    - 若要更新用户的身份验证方法，请参见[设置用户身份验证类型](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)。

**对于 TCM**

1. 以云管理员身份登录到 TCM。
2. 选择“设置”\>“身份验证”，并选中“启用其他身份验证方法”复选框。
3. 从“身份验证”下拉菜单中，选择“Google”。
4. 添加新用户（或更新任何以前的用户）以使用 Google 作为其配置的身份验证类型。
    
    - 若要添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。
    - 若要更新用户的身份验证方法，请参见[设置用户身份验证类型](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)。

<!-- document id=ef632630abac8a4ba26844f933e04dd66ff978c33c31a9130cd32bc9882999cd url=/tableau/next/zh-cn/online/protected_auth.md -->

[跳转到主要内容](#main-content)

# OAuth 连接

使用 Tableau Cloud 或 Tableau Server 存储敏感数据库凭据的替代方法或是使用 **OAuth 2.0** 标准创建连接。以下连接器支持 OAuth 身份验证： 

- Amazon Athena
- Anaplan
- Azure Data Lake Storage Gen2、Azure SQL、Azure Synapse
- Box
- Esri ArcGIS Server
- Databricks
- Denodo
- Dremio
- Dropbox
- Google Ads、Google Analytics、Google BigQuery、Google Drive
- Impala
- LinkedIn Sales Navigator
- Marketo
- OneDrive 和 SharePoint Online
- Oracle Eloqua
- QuickBooks Online
- Salesforce，Salesforce CDP
- SAP HANA
- ServiceNow ITSM
- Snowflake

从 Tableau 中，当用户通过使用 OAuth 的连接器登录到数据时，用户将被重定向到身份验证提供程序的登录页面。用户提供凭据并授权 Tableau 访问其数据后，身份验证提供程序会向 Tableau 发送**访问令牌**，该令牌唯一标识 Tableau 和用户。此访问令牌用于代表用户访问数据。有关详细信息，请参见下面的 [OAuth 进程概述](#Overview)。

使用基于 Oauth 的连接可提供以下好处：

- **安全：**您的数据库凭据从不会被 Tableau Cloud 知道或存储在其中，并且访问令牌只能由 Tableau 代表用户使用。
- **方便：**不必在多个位置嵌入您的数据源 ID 和密码，您可以对访问特定数据提供程序的所有已发布工作簿和数据源使用为该数据提供程序提供的令牌。
    
    **注意：**对于 Google BigQuery 数据的实时连接，每个工作簿 Viewer（查看者）都可以拥有标识用户的唯一访问令牌，而不是共享单个用户名和密码凭据。

## OAuth 进程概述

下列步骤介绍 Tableau 环境中调用 OAuth 过程的一个工作流。

1. 用户执行的操作需要访问基于云的数据源。
    
    例如，您打开发布到 Tableau Cloud 的工作簿。
2. Tableau 将用户定向到云数据提供程序的登录页面。发送给数据提供程序的信息将 Tableau 标识为请求站点。
3. 当用户登录到数据时，提供程序会提示用户确认其授权 Tableau Cloud 访问数据。
4. 用户确认后，数据提供程序会向 Tableau Cloud 发送访问令牌。
5. Tableau Cloud 向用户显示工作簿和数据。
    
    ![您的笔记本电脑、Tableau Cloud 和数据库之间的数据流程图。](/tableau/next/zh-cn/online/zh-cn/Img/protected_auth_online.png)

**注意**：Tableau Cloud 2025.2（2025 年夏季）版本中新增了对 OAuth 连接的一次性刷新令牌（有时称为一次性刷新令牌、滚动刷新令牌或刷新令牌轮换）的支持，并在 Tableau Server 2025.3 版本中添加了支持（如果数据源提供商的 IDP 支持）。这些令牌在 Tableau Bridge 与 Tableau Cloud 的连接上尚不受支持。如果为连接使用外部 OAuth 配置，请参见 GitHub 中的 [OAuth 配置和使用文档](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 配置文档")了解详细信息。

下列用户工作流可以使用 OAuth 进程：

- 从 Tableau Desktop 或从 Tableau Cloud 创建工作簿并连接到数据源。
- 从 Tableau Desktop 发布数据源。
- 从诸如 Tableau Mobile 或 Tableau Desktop 等批准的_客户端_登录 Tableau Cloud 站点。
- 使用 Tableau Bridge 访问本地数据。请参见[与 Bridge 的连接](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm#authentication)。

## 默认已保存凭据连接器

_已保存凭据_是指 Tableau Cloud 存储 OAuth 连接的用户令牌的功能。这允许用户将其 OAuth 凭据保存到其在 Tableau Cloud 上的用户配置文件。保存凭据后，当他们随后访问连接器进行发布、编辑或刷新时，将不会收到提示。

**注意**：在 Web 上编辑 Tableau Prep 流程时，系统可能仍会提示您重新进行身份验证。

所有支持的连接器列在 Tableau Cloud 上用户的“我的帐户设置”页面上的“数据源的已保存凭据”下。用户针对每种连接器管理其已保存凭据。

### 数据连接访问令牌

可以根据包含数据连接的访问令牌嵌入凭据，以允许在初始身份验证过程结束之后直接访问。除非 Tableau Cloud 用户删除访问令牌或数据提供程序撤消它，否则它会一直有效。

可能超出了数据源提供程序允许的访问令牌数。在这种情况下，当用户创建新令牌时，数据提供程序将使用自上次访问以来已经过去的时间长度来决定使哪个令牌失效以便为新令牌腾出空间。

### 批准的客户端身份验证的访问令牌

默认情况下，在用户第一次登录时提供其凭据后，Tableau Cloud站点允许用户直接从批准的 Tableau 客户端访问其站点。此类型的身份验证还使用 OAuth 访问令牌安全地存储用户的凭据。

有关详细信息，请参见[从连接的客户端中访问站点](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm)。

## 默认托管密钥链连接器

_托管密钥链_是指提供商为 Tableau Cloud 生成 OAuth 令牌并由同一站点中的所有用户共享的功能。当用户首次发布数据源时，Tableau Server 会提示用户输入数据源凭据。Tableau Cloud 将凭据提交到数据源提供程序，该提供程序将返回 OAuth 令牌供 Tableau Cloud 代表用户使用。在后续发布操作中，使用 Tableau Cloud 为同一类和用户名存储的 OAuth 令牌，以便不会提示用户输入 OAuth 凭据。如果数据源密码发生更改，则重复上述过程，并将旧令牌替换为 Tableau Cloud 上的新令牌。

默认托管密钥链连接器不需要在 Tableau Cloud 上进行额外的 OAuth 配置：

- Google Analytics、Google BigQuery 和 Google Sheets（在 2022 年 3 月已弃用）
- Salesforce

## 配置自定义 OAuth

从 2021.2 开始，作为站点管理员，您可以为每个 OAuth 支持的数据提供程序（连接器）配置自定义 OAuth 客户端，以覆盖您站点的预配置 OAuth 客户端设置。您可以考虑配置自定义 OAuth 客户端以支持安全连接到需要唯一 OAuth 客户端的数据。

配置了自定义 OAuth 客户端后，默认配置将被忽略，并且站点上创建的所有新 OAuth 凭据默认使用自定义 OAuth 客户端。

**重要信息：**在配置自定义 OAuth 客户端之前建立的现有 OAuth 凭据暂时可用，但站点管理员和用户都必须更新已保存凭据以帮助确保数据访问不间断。

### 步骤 1：准备 OAuth 客户端 ID、客户端密文和重定向 URL

在配置自定义 OAuth 客户端之前，您必须收集在此之后列出的信息。获得此信息后，您可以为每个 OAuth 支持的连接器配置自定义 OAuth 客户端。

- **OAuth 客户端 ID 和客户端密文：**首先向数据提供程序（连接器）注册 OAuth 客户端以检索客户端 ID 和客户端密文。支持的连接器包括：
    
    - Azure Data Lake Storage Gen2、Azure SQL Database、Azure Synapse
    - Databricks
    - Dremio
    - Dropbox
    - Google Analytics、Google BigQuery、Google Sheets（2022 年 3 月已弃用）
    - Impala
    - Intuit Quick books Online
    - Salesforce，Salesforce CDP
    - Snowflake（有关详细信息，请参见 Tableau 连接器 SDK 文档中的[OAuth 配置和使用](https://tableau.github.io/connector-plugin-sdk/docs/oauth)。）
- **重定向 URL：**请注意 Tableau Cloud 站点所在的 pod，以确保您在下面**步骤 2** 的注册过程中输入正确的重定向 URL。重定向 URL 使用以下格式：
    
    Https://<您的 pod> .online.tableau.com/auth/add\_oauth\_token
    
    例如， https://us-west-2b.online.tableau.com/auth/add\_oauth\_token
    
    **注意：**有关 pod 的详细信息，请参见 [Salesforce 信任](https://status.salesforce.com/products/tableau)页面。
    
    如果已为站点设置了自定义域，则 OAuth 客户端必须使用自定义域作为重定向 URL。举例来说，如果自定义域为“analytics.example.com”，则重定向 URL 将为“https://analytics.example.com/auth/add\_oauth\_token”。有关详细信息，请参见[将自定义域与 Tableau Cloud 配合使用](https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm)。

### 步骤 2：注册 OAuth 客户端 ID 和客户端密文

按照下面描述的过程将自定义 OAuth 客户端注册到您的站点。

1. 使用站点管理员凭据登录到 Tableau Cloud，并导航到“设置”页面。
2. 在“OAuth 客户端注册”下，单击“添加 OAuth 客户端”按钮。
3. 输入所需信息，包括上述**步骤 1** 中的信息：
    
    **注意：**除非使用多个 OAuth 客户端，否则请将“OAuth 实例 URL”字段留空。
    
    1. 对于“连接类型”，选择与要配置其自定义 OAuth 客户端的连接器对应的数据库类值。
    2. 对于“客户端 ID”、“客户端密文”和“重定向 URL”，输入您在上面的**步骤 1** 中准备的信息。
    3. 单击“添加 OAuth 客户端”按钮以完成注册过程。
    
    ![用于创建 OAuth 客户端的表单，包括连接类型、OAuth 实例 URL、客户端 ID、客户端密文和重定向 URL 字段。](/tableau/next/zh-cn/online/zh-cn/Img/oauth_custom.png)
4. （可选）为其他连接器重复步骤 3。
5. 单击“设置”页面底部或顶部的“保存”按钮以保存更改。

### 步骤 3：验证和更新保存的凭据

为了帮助确保数据访问不间断，您（和您的站点用户）必须删除以前保存的凭据，并再次添加它以使用自定义 OAuth 客户端，而不是默认的 OAuth 客户端。

1. 导航到“我的帐户设置”页面。
2. 在“保存的数据源凭据”下，执行以下操作：
    
    1. 单击您在上述**步骤 2** 中配置的自定义 OAuth 客户端的连接器的现有已保存凭据旁边的“删除”。
    2. 在同一个连接器旁边，单击“添加”并按照提示进行操作，以 1) 连接到在上面**步骤 2** 中配置的自定义 OAuth 客户端，以及 2) 保存最新的凭据。

### 步骤 4：通知用户更新他们保存的凭据

确保通知您的站点用户更新他们为数据提供程序保存的凭据，您在上面的**步骤 2** 中为其配置了自定义 OAuth 客户端。站点用户可以使用[更新保存的凭据](https://help.tableau.com/v0.0/online/zh-cn/manage_stored_credentials.htm#oauth_update_credentials)中描述的过程来更新他们保存的凭据。

## 此部分中的其他文章

<!-- document id=15f8cae318d7fcd23259a4e91227ef13e36069418148735ed89fb0ee94c21ee6 url=/tableau/next/zh-cn/online/openid_auth.md -->

[跳转到主要内容](#main-content)

# OpenID Connect

您可以将 Tableau Cloud 或 Tableau Cloud Manager (TCM) 配置为支持为单点登录 (SSO) 使用 OpenID Connect。OIDC 是一种标准身份验证协议，它使用户能够登录到诸如 Google 或 Salesforce 等身份提供程序 (IdP)。用户成功登录到其 IdP 后，将会自动登录到 Tableau Cloud 或 TCM。

配置 OIDC 的过程包含若干步骤。本节中的主题提供有关将 Tableau Cloud 或 TCM 与 OIDC 一起使用的一般信息，并提供用于配置 IdP 和 Tableau Cloud 或 TCM 的顺序。

**注意：**需要单独的设置和应用程序集成才能为 Tableau Cloud 和 TCM 启用 OIDC 身份验证。

若要使用 Tableau REST API 配置 OIDC，请参见 Tableau REST API 帮助中的 [OpenID Connect 身份验证方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_openid_connect.htm)。**注意：**仅适用于 Tableau Cloud。

## 身份验证概述

本部分介绍 Tableau Cloud 或 TCM 的 OpenID Connect (OIDC) 身份验证过程。

![](/tableau/next/zh-cn/online/zh-cn/Img/openid_auth_overview_cloud.png)

1.用户尝试从客户端计算机登录到 Tableau Cloud 或 TCM。

2.Tableau Cloud 将身份验证请求重定向到 IdP 网关。

3.用户收到凭据提示，并成功向 IdP 进行验证。IdP 做出响应，并将重定向 URL 返回到 Tableau Cloud 或 TCM。重定向 URL 中包括用户的授权代码。

4.客户端被重定向到 Tableau Cloud 或 TCM，并提供授权代码。

5\. Tableau Cloud或 TCM 将客户端的授权代码连同其自己的客户端凭据一起提供给 IdP。Tableau Cloud或 TCM 也是 IdP 的客户端。此步骤旨在防止假冒或中间人攻击。

6.IdP 将访问令牌和 ID 令牌返回给 Tableau Cloud 或 TCM。

- JSON Web 令牌 (JWT) 验证：默认情况下，Tableau 会对 IdP JWT 执行验证。在发现过程中，Tableau 将在 IdP 配置发现文档中检索 `jwks_uri` 指定的公钥。Tableau 将验证 ID 令牌是否过期，并验证 JSON Web 签名 (JWS)、颁发者 (IdP) 和客户端 ID。您可以在 OIDC 文档中详细了解 JWT 进程。[10.签名和加密](http://openid.net/specs/openid-connect-core-1_0.html#SigEnc)以及 IETF 建议标准 [JSON Web 令牌](https://tools.ietf.org/html/rfc7519)。我们建议一直启用 JWT 验证，除非 Idp 不支持。
- ID 令牌是用户的一组属性密钥对。该密钥对称为_声明_。下面是用户的一个示例 IdP 声明：
    
    "sub"                     : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5"
    "email"                   : "alice@example.com",
    "email\_verified"          : true,
    "name"                    : "Alice Adams",
    "given\_name"              : "Alice",
    "family\_name"             : "Adams"

7\. Tableau Cloud 或 TCM 从 IdP 声明中识别用户，并完成步骤 1 中的身份验证请求。 Tableau Cloud 可以配置为此过程使用不同的声明。请参见[要求](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm#requirements)。

8\. Tableau Cloud 或 TCM 为用户授权。

## Tableau 如何使用 OpenID Connect

OpenID Connect 是一种灵活的协议，对于服务提供商（本文中为 Tableau Cloud 或 TCM）和 IdP 之间交换的信息，此协议支持许多选项。以下列表提供了有关 Tableau Cloud 和 TCM OIDC 的实现的详细信息。这些详细信息可以帮助您了解 Tableau Cloud 或 TCM 所发送和需要的信息类型，以及如何配置 IdP。

- Tableau Cloud 和 TCM 仅支持 OpenID 授权代码流程，如 OpenID Connect 文档中的 [OpenID Connect 最终规范](http://openid.net/specs/openid-connect-core-1_0.html)中所述。
- Tableau Cloud 和 TCM 依赖于使用发现或提供程序 URL 来检索 IdP元数据。
- Tableau Cloud 和 TCM 支持 OpenID Connect 规范中指定的 `client_secret_basic` （默认） 和 `client_secret_post` 客户端身份验证 以及其他参数。只能使用 Tableau REST API 配置这些方法。

## OIDC 声明中的动态组成员身份

**注意：**仅适用于 Tableau Cloud。

从 2024 年 6 月开始，如果配置了 OIDC 身份验证并启用了该功能的设置，您可以通过身份提供程序 (IdP) 发送的 JSON Web 令牌 (JWT) 中包含的自定义声明动态控制群组成员身份。

配置后，在用户身份验证期间，IdP 会发送包含两个自定义组成员身份声明的 OIDC 断言：组 (`https://tableau.com/groups` ) 和组名（例如，“Group1”和“Group2”）来将用户声明到其中。Tableau 验证该断言，然后启用对组以及权限依赖于这些组的内容的访问权限。

有关详细信息，请参见[使用断言的动态组成员身份](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#assertions)。

**示例 JWT**

"sub"                     : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5",
"email"                   : "alice@example.com",
"email\_verified"          : true,
"name"                    : "Alice Adams",
"given\_name"              : "Alice",
"family\_name"             : "Adams",
"https://tableau.com/groups": \["Group1", "Group2"\]

## OIDC 声明中的用户属性

**注意：**仅适用于 Tableau Cloud。

从 2025 年 10 月 (Tableau 2025.3) 开始，在配置并启用功能设置后，您可以在登录期间将身份提供程序 (IdP) 发送的 JSON Web 令牌 (JWT) 中的用户属性声明传递到 Tableau Cloud。这些用户属性可与 Tableau 的用户属性函数 `(USERATTRIBUTE()`, `USERATTRIBUTEINCLUDES()`) 结合使用，动态控制和自定义内容。Tableau 验证声明，然后启用对内容的访问。

有关详细信息，请参见[使用用户属性自定义和控制数据访问](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm#user_attributes)。

**示例 JWT**

"sub"                     : "7gYhRR3HiRRCaRcgvY50ubrtjGQBMJW4rXbpPFpg2cptHP62m2sqowM7G1LwjN5",
"email"                   : "alice@example.com",
"email\_verified"          : true,
"name"                    : "Alice Adams",
"given\_name"              : "Alice",
"family\_name"             : "Adams",
"region"                 : \["South", "South West"\]

## 此部分中的其他文章

<!-- document id=e7845aeae8388bf8246e6e641e6a5b6b6c4eaf2d63fc964b5a08b0130bf437b6 url=/tableau/next/zh-cn/online/security_auth_sfdc.md -->

[跳转到主要内容](#main-content)

# Salesforce 身份验证

如果您的组织使用 Salesforce，则您可以启用 Tableau Cloud 或 Tableau Cloud Manager (TCM) 以使用 Salesforce 帐户通过 OpenID Connect 借助多重身份验证 (MFA) 进行单点登录。自 2021 年春季起，Tableau 支持将 Salesforce 身份验证作为身份验证类型。自 2024 年 10 月起，TCM 支持 Salesforce 身份验证。

当您启用 Salesforce 身份验证时，系统会将用户定向到 Salesforce 登录页面，以便输入通过 Salesforce 中存储和管理的凭据。此方案还支持 Salesforce 将身份验证与另一个 IdP 联合的方案。

## 用户名要求

在 Salesforce Org 中使用的用户名必须与 Tableau Cloud 或 TCM中的用户名字段匹配。这两个用户名都是电子邮件格式，但它们可能不能用作电子邮件地址。验证这些属性是否匹配。如果没有，请配置 Salesforce 身份验证类型，然后查看下面的[用户名不匹配](#mismatch)部分。

## 更改和配置身份验证类型

如果您的组织已经在使用 Salesforce，那么在 Tableau Cloud 或 TCM 中将身份验证类型设置为 Salesforce 是一个三步过程。

**对于 Tableau Cloud**

1. 在 Salesforce 中，安装 [Tableau Cloud 已连接应用包](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000GlvlrUAB)。若要允许用户从您的组织登录 Tableau Cloud，请通过分配适当的配置文件或权限集来管理对已连接应用的访问。此外，将已连接应用设置为管理员预先批准。有关详细信息，请参见[管理已连接应用的其他访问设置](https://help.salesforce.com/articleView?id=connected_app_manage_additional_settings.htm&type=5&language=en_US)。
2. 在 Tableau Cloud 中，通过执行以下操作更改为 Salesforce 身份验证：
    
    1. 在 Tableau Cloud 中，以站点管理员身份登录。
    2. 选择“设置”\>“身份验证”，单击“新配置”按钮，然后从“身份验证”下拉菜单中选择“Salesforce”。
    3. 为配置输入一个名称。  
        
        **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。
    4. （可选）如果您已将 Salesforce 组织配置为使用自定义域进行用户登录，则您需要配置 Tableau Cloud 以将用户重定向到登录页面。单击“编辑我的域”以输入您的 Salesforce“我的域”。Tableau Cloud 将验证域，然后将其添加为登录 URL。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/to_site_auth_salesforce.png)
3. 添加新用户（或更新任何以前的用户）以使用 Salesforce 作为其配置的身份验证类型。
    
    - 若要添加用户，请参见[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)。
    - 若要更新用户的身份验证方法，请参见[设置用户身份验证类型](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)。

**对于 TCM**

1. 在 Salesforce 中安装 [Tableau Cloud 已连接应用包](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000GlvlrUAB)。若要允许用户从您的组织登录 TCM，请通过分配适当的配置文件或权限集来管理对已连接应用的访问。此外，将已连接应用设置为管理员预先批准。有关详细信息，请参见[管理已连接应用的其他访问设置](https://help.salesforce.com/articleView?id=connected_app_manage_additional_settings.htm&type=5&language=en_US)。
2. 在 TCM 中，通过执行以下操作更改为 Salesforce 身份验证：
    
    1. 在 TCM 中，以云管理员身份登录。
    2. 选择“设置”\>“身份验证”，并选中“启用其他身份验证方法”复选框。
    3. 从“身份验证”下拉菜单中，选择“Salesforce”。
    4. （可选）如果您已将 Salesforce 组织配置为使用自定义域进行用户登录，则您需要配置 TCM 将用户重定向到登录页面。单击“编辑我的域”以输入您的 Salesforce“我的域”。TCM 将验证域，然后将其添加为登录 URL。
3. 添加新用户（或更新任何以前的用户）以使用 Salesforce 作为其配置的身份验证类型。
    
    - 若要添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。
    - 若要更新用户的身份验证方法，请参见[设置用户身份验证类型](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)。

## 疑难解答

### 用户名不匹配

如果 Tableau Cloud 中的现有用户使用的用户名与其在 Salesforce 中的相应用户名不匹配，请执行以下过程：

1. 将现有 Tableau Cloud 用户更改为未许可的站点角色以防止使用许可证。
2. 添加用于 Salesforce 身份验证的新 Tableau Cloud 用户，确保用户名与 Salesforce 组织中的用户名匹配。
3. 如有必要，请将 Tableau Cloud 中旧用户名拥有的先前内容迁移到新用户。

### 返回 URL 中包含 OAUTH\_APP\_BLOCKED 的登录失败

当配置了 Salesforce 身份验证的用户尝试登录但未重定向时，就会出现此问题。Tableau Cloud 将显示一条消息：

登录失败。请重试。

如果您继续收到此消息，请捕获下面的状态信息，并将其发送给客户支持。

此外，用户浏览器中的返回 URL 包括以下字符串：

/public/oidc/login?error=OAUTH\_APP\_BLOCKED&error\_description=this+app+is+blocked+by+admin&state=...

这表明您的组织正在阻止 Salesforce 中的已连接应用。一些具有安全意识的 Salesforce 客户会阻止所有已连接应用并实施 API 允许列表功能，以阻止已连接应用工作。

为了解决此问题，请确保安装了 [Tableau Cloud - Salesforce 用户通过 OIDC 登录](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000GlvlrUAB)已连接应用，并应用了适当的用户配置文件和权限集。  
有关详细信息，请参见：

- [管理对已连接应用的访问](https://help.salesforce.com/articleView?id=sf.connected_app_manage.htm&type=5)
- [管理已连接应用的其他访问设置](https://help.salesforce.com/articleView?id=sf.connected_app_manage_additional_settings.htm&type=5)

### 无法编辑配置名称

2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。。

<!-- document id=b45d4c3009f74030a7d763dcb740d91cbfe7a649cfdcc10e7f0554c42b03f708 url=/tableau/next/zh-cn/online/saml.md -->

[跳转到主要内容](#main-content)

# SAML

SAML（安全断言标记语言）是一种 XML 标准，此标准允许安全的 Web 域交换用户身份验证和授权数据。您可以将 Tableau Cloud 或 Tableau Cloud Manager (TCM) 配置为使用外部身份提供程序 (IdP) 通过 SAML 2.0 对用户进行身份验证。不会与 Tableau 一起存储任何用户凭据，而使用 SAML 使您能够将 Tableau 添加到组织的单点登录环境。

通过 SAML 进行的用户身份验证不适用于 Tableau Cloud 内容（例如数据源和工作簿）的许可和授权。也不会控制对工作簿和数据源连接的基础数据的访问。

**注意：**Tableau Cloud 在浏览器和 Tableau Mobile 应用软件中仅支持由服务提供程序和 IdP 启动的 SAML。来自Tableau Desktop 的 SAML 连接必须是服务提供程序启动的。

## 身份验证概述

下图显示了在典型的服务提供程序启动的流程中使用单点登录对用户进行身份验证的步骤：

![](/tableau/next/zh-cn/online/zh-cn/Img/saml_about_cloud.png)

1. 用户导航到 Tableau Cloud 或 TCM 登录页面，或单击已发布的工作簿 URL。
2. Tableau 通过将客户端重定向到已配置的 IdP 启动身份验证过程。
3. IdP 向用户请求用户的用户名和密码。用户提交有效凭据后，IdP 对用户进行身份验证。
4. IdP 以 SAML 响应的形式将成功的身份验证返回到客户端。客户端将 SAML 响应传递到 Tableau Cloud 或 TCM。
5. Tableau Cloud 或 TCM 验证 SAML 响应中的用户名是否与 Tableau Cloud 存储库.中存储的已许可用户匹配。如果经验证匹配，则 Tableau Cloud 或 TCM 以请求的内容或信息n响应客户端。

## 此部分中的其他文章

<!-- document id=642bf553f5f8d650a9e0895398a27ea7f6f97195b28640952b6d6370922058d6 url=/tableau/next/zh-cn/online/saml_trouble.md -->

[跳转到主要内容](#main-content)

# SAML 疑难解答

本主题提供相关信息，帮助解决在配置 SAML 身份验证时可能发生的问题。

## 必需的断言和元数据未正确映射

大多数问题发生的原因是您从 IdP 导入的元数据或输入的断言名称与对应的 IdP 属性不匹配。若要排除 SAML 问题，首先要确保 Tableau Cloud 中的步骤 1-5 或“身份验证”页面 TCM 中的步骤 1-4 中显示的信息与 IdP 的 SAML 配置设置相匹配。

Tableau Cloud 或 TCM 需要包含用户名的 IdP 断言。除了检查 Tableau Cloud 中的步骤 2--5 或 TCM 中的步骤 2-4 外，还要确保用户的用户名在 Tableau Cloud 和 IdP 之间匹配。

## 身份提供程序不显示登录页面

用户在 Tableau Cloud 或 TCM 登录页面上提供其用户名，Tableau 将请求重定向到身份提供程序 (IdP)，但 IdP 未返回其 SAML 登录页面。IdP 可能会出于以下原因而无法返回登录页面：

- SSO 服务 URL 无效。
    
    当您导入 IdP 元数据时，请确保 SSO 服务 URL 字段显示正确的 URL。
- IdP 未识别收到的身份验证请求。
    
    例如，Tableau Cloud 或 TCM 实体 ID 可能不正确。如果“身份验证”页面上的 SAML 配置设置已损坏或被无意更改，则可能会发生这种情况。

为了解决该问题，请重复 SAML 配置的步骤 1–2：

1. 登录到您的 IdP 帐户并导出 IdP 元数据。
2. 执行以下操作之一：
    
    - 登录 Tableau Cloud，转到“设置”\>“身份验证”页面，在身份验证配置旁边，单击“操作”菜单并选择“编辑”。在“编辑配置”页面上的步骤 2 中，重新导入并上载元数据。
    - 登录TCM，转到“设置”\>“身份验证”页面，在“SAML 身份验证类型”下，单击 “配置（必需）”下拉箭头。在步骤 2 中，重新导入并上载元数据。

## IdP 登录后未发生任何情况

如果用户在 IdP 的登录页面上提供不正确的凭据，或者用户未获授权使用 SAML，某些 IdP 在身份验证失败时将不会将控件返回到 Tableau。

在 Tableau Cloud 中的“用户”页面上，您可以看到用户是否已获权进行 SAML 身份验证。

![](/tableau/next/zh-cn/online/zh-cn/Img/saml_site_troubleshoot1.png)

## “全名”字段显示用户的电子邮件地址

对于 SAML 站点，如果在步骤 3 中未提供姓名或全名的断言，则会用电子邮件地址填充“全名”字段。匹配“身份验证”页面中 SAML 设置的属性。

## 使用单点登录时无法验证用户的身份

SAML 身份验证在 Tableau 外部进行，因此，排查身份验证问题可能很困难。但是，Tableau Cloud 会记录登录尝试。可以创建日志文件的快照，并使用它们来排查问题。

如果用户在 Tableau Cloud 上进行身份验证时遇到问题，您应检查日志文件以确保 IdP 返回的用户名属性值与用户的用户名匹配。

下载日志文件：

1. 登录到 Tableau Cloud 或 TCM。
2. 转到“设置”\>“身份验证”页面，然后执行以下操作之一：
    
    - 在 Tableau Cloud 中身份验证配置的旁边，单击“操作”菜单并选择“编辑”。在“步骤 7.测试配置”的“SAML 故障排除”下，单击“下载日志”按钮。
    - 在 TCM 中的 SAML 身份验证类型下，单击“配置（必需）”下拉箭头。在步骤 “6.测试配置”的“SAML 故障排除”下，单击“下载日志”按钮。

## 通过命令行实用工具登录

当您使用 [tabcmd](https://help.tableau.com/v0.0/online/zh-cn/tabcmd.htm) 登录 Tableau Cloud 时，SAML 不用于身份验证，即使 Tableau Cloud 配置为使用 SAML。此工具需要个人访问令牌。。

<!-- document id=584e6ce403cd2466f7ffb374b83af084cf93bd2d15064c482321bee8979c6889 url=/tableau/next/zh-cn/online/scim_config_online.md -->

[跳转到主要内容](#main-content)

# SCIM

跨域身份管理系统 (SCIM) 是一种协议，它对 Tableau Cloud 等基于云的应用程序的用户和组预置自动化进行了标准化。Tableau Cloud 支持 SCIM，使身份提供程序 (IdP) 能够集中管理用户身份，同时简化在 Tableau Cloud 中管理用户和组成员身份的流程。IdP 使用 SCIM 来确保及时授予和撤销访问权限，并且 Tableau Cloud 与 IdP 中的预置分配保持同步。这种类型的集成提高了安全性，并减少了 Tableau Cloud 中站点管理员的手动工作。

![身份提供程序链接到 SCIM 和 Tableau Cloud 的简单说明。](/tableau/next/zh-cn/online/zh-cn/Img/scim_provisioning.jpg)

在上图中，IdP 将更新_推送_到 Tableau Cloud 并控制 Tableau Cloud 的 SCIM 端点被调用的频率，以确保用户和组得到适当的镜像。

## 特定于 IdP 的配置

本主题后面的步骤提供了您可与 IdP 文档配合使用来为 Tableau Cloud 站点配置 SCIM 的一般信息。可以为我们支持的以下 IdP 获取特定于 IdP 的配置步骤：

- [使用 Microsoft Entra ID 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_azure_ad.htm)
- [使用 Okta 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_okta.htm)
- [使用 OneLogin 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_onelogin.htm)
- [使用 PingFederate 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_pingfederate.htm)

## 启用 SCIM 支持概述

查看以下步骤，在 Tableau Cloud 和您的 IdP 中启用 SCIM 集成。若要完成此过程，您还将需要 IdP 提供的文档。请查找那些介绍如何为 SCIM 预置配置或启用服务提供程序的主题。

**注意：**

- 启用 SCIM 后，应通过 IdP 管理用户及其属性。在 Tableau Cloud 内直接进行的更改可能导致意外行为和覆盖值。
- 从 2025 年 1 月 (Tableau 2024.3) 开始：
    
    - 您可以选择 SAML 身份验证配置与 SCIM 关联。但是，一个站点上只能有一个 SAML 身份验证配置可以支持 SCIM。
    - SCIM 功能不再属于站点管理员范围。换句话说，所有站点管理员都有配置和编辑 SCIM 的能力。
- 从 2025 年 6 月 (Tableau 2025.2) 开始：
    
    - 您可以在站点上配置一个或多个 SCIM 配置。
    - 您可以绕过 Tableau 生成的 SCIM 令牌，而是使用外部生成的 JWT（使用 Tableau 已连接应用）来支持 Tableau Cloud 中的 SCIM 请求。
- 从 2025 年 12 月开始，您可以使用 [Tableau SCIM API](https://help.tableau.com/current/api/scim-api/zh-cn/index.html) 自动预置用户和组。
- 从 2026 年 2 月 （Tableau 2026.1）开始，您可以选择 OIDC 和 Google 身份验证与 SCIM 关联。
- 从 2026 年 6 月 (Tableau 2026.2) 开始，SCIM 集成支持[自定义域](https://help.tableau.com/current/online/zh-cn/custom_domain.htm)。

### 步骤 1：执行先决条件

启用 SCIM 与 Tableau Cloud 站点的集成之前，您将需要满足以下要求：

- 具有 Tableau Cloud 站点的站点管理员访问权限。
- 能够针对 Tableau Cloud 修改 IdP 的设置。
- 您的站点已配置为支持 SAML 或 OIDC（或 Google）单点登录 (SSO)。如果您还没有这样做，请参见[在站点或 TCM 上启用 SAML 身份验证](https://help.tableau.com/v0.0/online/zh-cn/saml_config_site.htm)或[针对 OpenID Connect 配置 Tableau Cloud 或 TCM](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm)，然后按照您的 IdP 的文档添加 Tableau Cloud 作为应用程序。
- （可选）如果使用外部令牌生成和管理，您可以满足以下要求：
    
    1. 创建并启用 Tableau 已连接应用。如果您还没有这样做，请参见[使用 Tableau 已连接应用进行应用程序集成](https://help.tableau.com/v0.0/online/zh-cn/connected_apps.htm)。
    2. 包含以下范围的有效 JWT：`tableau:users:*` 和 `tableau:groups:*`

### 步骤 2：启用 SCIM 支持

#### 在 Tableau Cloud 中 - 使用 Tableau 生成的令牌

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 执行以下操作：
    
    1. 在“身份验证”页面的“跨域身份管理系统 (SCIM)”下，单击**“新配置”**按钮。
    2. 在“新的 SCIM 配置”对话框中，执行以下操作：
        
        1. 为 SCIM 配置输入一个名称。
        2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
        3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 身份验证配置。
        4. 单击**“保存”**。
            
            **注意：**这将填充“SCIM 令牌”部分。
            
            ![新的 SCIM 配置](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_new.png)
    3. 在“SCIM 令牌”下，执行以下操作：
        
        1. 单击“新建密文”按钮。
        2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_newsecret_newsecret.png)
        3. 复制密文，并将其存储在安全位置。
            
            **重要信息：**
            
            - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
            - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_secret.png)
        4. 单击**“关闭”**。
3. 导航到您的 IdP 的 SCIM 设置，并在相应的字段中粘贴 Tableau Cloud 基本 URL 和 SCIM 令牌。

#### 在 Tableau Cloud 中，使用外部令牌

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 执行以下操作：
    
    1. 在“跨域身份管理系统 (SCIM)”下，单击“新配置”按钮。
    2. 在“新的 SCIM 配置”对话框中，执行以下操作：
        
        1. 为 SCIM 配置输入一个名称。
        2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
        3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 身份验证配置。
        4. 单击“保存”。
            
            **注意：**这将填充“SCIM 令牌”部分，您可以放心忽略该部分。
        5. 完成后，单击“关闭”。
3. 导航到您的 IdP 的 SCIM 设置，并在相应的字段中粘贴 Tableau Cloud 基本 URL。

#### 在 IdP 中

满足先决条件并在 Tableau Cloud 中启用 SCIM 后，使用 IdP 文档中的步骤通过身份提供程序 (IdP) 启用 SCIM 支持。有关特定 IdP 的某些一般准则，请参见[特定于 IdP 的配置](#idp_specific)。

### 步骤 3：预置用户和组

在启用 SCIM 支持后，按照您的 IdP 文档预置用户和组。有关特定 IdP 的某些一般准则，请参见[特定于 IdP 的配置](#idp_specific)。

您还可以使用 [Tableau SCIM API](https://help.tableau.com/current/api/scim-api/zh-cn/index.html) 自动预置用户和组。

## 替换 Tableau 生成的 SCIM 令牌

当您需要替换 Tableau 生成的 SCIM 令牌时，请按照以下步骤为现有 SCIM 配置生成新密文。

**注意：**若要为现有 SCIM 配置生成新令牌，您必须是创建 SCIM 配置的站点管理员。

1. 在 Tableau Cloud 中，导航到“设置”\>“身份验证”。
2. 在“跨域身份管理系统 (SCIM)”下，在 SCIM 配置旁边，选择**“操作”**\>**“编辑配置”**。
3. 在“SCIM 令牌”下，执行以下操作：
    
    1. 单击“新建密文”按钮。
    2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
    3. 复制密文，并将其存储在安全位置。
        
        **重要信息：**
        
        - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
        - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。

## 此部分中的其他文章

<!-- document id=dc35afbacda76f234632ccf5039d5c6f5e2d5ed0d90dbf556e3e34ed12e237b6 url=/tableau/next/zh-cn/online/snowflake_oauth_idp.md -->

[跳转到主要内容](#main-content)

# Snowflake 的外部 OAuth

从 Tableau 2024.3 开始，您可以使用 OAuth 2.0/OIDC 将外部身份提供程序的身份联合到 Snowflake。

根据身份提供程序的不同，配置集成需要执行不同的步骤。这是一个简略概述，旨在指导您的配置，但不提供您在身份提供程序文档中找到的必要详细信息。假设您熟悉配置 OAuth 并了解使用外部身份提供程序设置身份验证所需的技术细节。

## 在 Snowflake 上配置 IDP

有关配置 IDP 的信息，请参见 Snowflake 帮助系统中的[外部 OAuth 概述](https://docs.snowflake.com/en/user-guide/oauth-ext-overview)。

## 在 Tableau 上配置 IDP

1. 在 IDP 上为 Tableau Desktop 以及为 Tableau Cloud 或 Tableau Server 创建 OAuth 客户端。Desktop 客户端启用 [PKCE](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) 并使用 `http://localhost` 重定向。
2. 创建 Tableau OAuth 配置文件。有关如何执行此操作的详细信息，请参见 [github](https://tableau.github.io/connector-plugin-sdk/docs/oauth) 上的 [OAuth 配置和使用](https://tableau.github.io/connector-plugin-sdk/docs/oauth)，以及[此处](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth)的示例。我们欢迎提供其他 IDP 的其他示例。
    
    - 请务必在 Tableau OAuth 配置 ID 前添加“custom\_”前缀。
        
        **注意：**OAuth 配置 ID 的最大限制为 36 个字符。长于此长度的 ID 可能不会生成错误，但将不起作用。
    - 如果您的 IDP 支持动态本地主机端口，请禁用 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`。如果您的 IDP 不支持此功能，请确保将多个本地主机回调 URL 添加到配置文件中和 IDP 上的允许列表。
3. 在与桌面主机（Tableau Desktop、Tableau Prep Builder、Tableau Bridge）上的每个应用程序关联的 OAuthConfigs 文件夹中，以及在将通过站点设置页面使用 OAuth 的每个 Tableau Server 和 Tableau Cloud 站点上，安装新的 Tableau OAuth 配置文件。有关更多详细信息，请参见 [Desktop 上的自定义 OAuth 配置](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients)和[站点级别 OAuth 客户端](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop)。

## 连接到 Snowflake

连接时，必须选择 OAuth，并选择之前安装的 OAuth 配置。

![](/tableau/next/zh-cn/online/zh-cn/Img/snowflake_connect_oauth.png)

## Okta

如果使用 Okta，最好使用“自定义授权服务器”而不是“组织授权服务器”。自定义授权服务器更加灵活。默认创建一个自定义授权服务器，称为“默认”。授权 URL 应如下所示：

`https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize`

![okta 仪表板](/tableau/next/zh-cn/online/zh-cn/Img/athena_okta.png)

<!-- document id=4030db34d400d54da0d00d0d6ae2384b949fb80a0911e65184ae40d94f13c48d url=/tableau/next/zh-cn/online/tabcmd.md -->

[跳转到主要内容](#main-content)

# tabcmd

**重要信息：**在 2024 年 8 月到 2025 年 3 月之间，Tableau Cloud 站点已迁移到 Salesforce 的 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)。迁移的结果是，不再支持 tabcmd 1.0。尽快计划迁移到 tabcmd 2.0，以确保您不会受到影响。此次停用不会影响 Tableau Server。

**注意：**在大多数情况下，您必须将 tabcmd 命令行实用程序 2.0 (tabcmd 2.0) 与 Tableau Cloud 结合使用。Tabcmd 2.0 可从 [Tableau tabcmd](https://tableau.github.io/tabcmd) 获取。这个新版本允许您在 MacOS :和 Linux 上运行 tabcmd 命令、使用个人访问令牌 (PAT) 进行身份验证，并允许您符合多重身份验证标准。版本 2.0 构建在基于 Python 的 Tableau Server 客户端 (TSC) 中可用的公共端点之上。

Tableau 提供了 tabcmd 命令行实用工具，您可以使用它在 Tableau Cloud 站点上自动完成站点管理任务。例如，创建或删除用户、项目和组。

**重要信息：**tabcmd 1.0 不支持多重身份验证 (MFA)。若要将 tabcmd 与 Tableau Cloud 一起使用，请使用 [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd)（新窗口）。有关 Tableau Cloud 和 MFA 的详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/to_security_mfa.htm)。

## 安装 tabcmd

**注意：**这些说明用于安装 tabcmd 1.0 命令行实用程序。若要安装 tabcmd 2.0 命令行实用程序，请转到 [Tableau tabcmd](https://tableau.github.io/tabcmd)（新窗口）。

将 Tableau Server 或 Tableau Cloud 升级到新版本时，如果需要 tabcmd 的更新版本，您可以从 Tableau 网站上“Tableau _Server_ 版本”页面下载该版本。

对于 Tableau Server：我们建议下载择与您的服务器版本匹配的版本。对于 Tableau Cloud，我们建议您始终下载最新版本，以避免版本不兼容导致的问题。在任一情况下，使用 tabcmd 的过时版本可能会导致错误和不可预知的结果。

1. 打开 Web 浏览器并转到 [Tableau Server 版本](https://www.tableau.com/zh-cn/support/releases/server)页面。即使您使用 Tableau Online，也转到此页面。
2. 如果您使用的是：
    
    - **Tableau Cloud**，请使用 [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd)（新窗口）。
    - **Tableau Server（Windows 或 Linux）：**请选择与您的服务器版本匹配的版本。
    
    在任一情况下，如果展开的信息显示维护版本，请选择最新维护版本，或选择与您的服务器版本匹配的维护版本。
    
    ![选择您使用的服务器版本（Tableau Cloud 的最新版本）](/tableau/next/zh-cn/online/zh-cn/Img/tabcmd_download1.png)
    
    这将带您进入发行说明页面（名为“已解决问题”），您可以在其中阅读有关安全改进和已解决问题的信息。
3. 滚动到已解决问题下的“**下载文件**”部分，选择与您将从中运行 tabcmd 命令的计算机兼容的 tabcmd 下载链接。 
    
    ![选择适用于要在其上使用 tabcmd 安装程序的计算机的 tabcmd 安装程序（32 位或 64 位）](/tableau/next/zh-cn/online/zh-cn/Img/tabcmd_download.png)
    
    其余步骤将此计算机称为“tabcmd 计算机”。
4. 将安装程序保存到 tabcmd 计算机，或保存到可从该计算机访问的位置。
5. 完成适合于 tabcmd 计算机操作系统的安装步骤：
    
    - Windows
        
        默认情况下，tabcmd 安装到 `C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility`。您可以在安装过程中更改此项，并建议将 tabcmd 安装到 C:\\ 驱动器 (`C:\tabcmd`) 根目录处名为 `tabcmd` 的文件夹中。这可以使查找和运行更加容易，并且如果将 tabcmd 目录添加到 Windows PATH，则它适应 Windows 操作系统的一些限制。
        
        **注意** tabcmd 安装程序不会向 Windows PATH 变量添加 tabcmd 目录。您可以手动添加它，也可以在每次调用 tabcmd 时包含其完整路径。
        
        您可以通过两种方式在 Windows 上安装 tabcmd：
        
        - 双击安装程序，按照 UI 中的步骤进行操作：
            
            1. 接受许可协议。
            2. 如果要安装到非默认位置，请单击“自定义”，并键入或浏览到要将 tabcmd 安装到的位置。
            3. 单击“安装”。
                
                如果 Windows Defender 防火墙或用户帐户控制提示，请单击**“允许访问”**。
        - 从命令提示符中运行安装程序：
            
            1. 在 tabcmd 计算机上以管理员身份打开命令提示符。
            2. 导航到在其中复制了 tabcmd 安装程序的目录。
            3. 安装 tabcmd：
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1
                
                安装到非默认位置：
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\\to\\install\\directory>"
                
                例如：
                
                tableau-setup-tabcmd-tableau-<version\_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\\tabcmd"
                
                有关可用于 tabcmd 安装程序的命令行选项的完整列表，请使用 a /? 运行安装程序。有关 tabcmd 安装程序命令行选项的详细信息，请参见[tabcmd 的安装开关和属性 (Windows)](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_install_flags.htm)。
        
        Tabcmd 安装程序会在 `C:\Users\<user>\AppData\Local\Temp` 中创建日志，如果安装 tabcmd 时出现问题，您可以使用这些日志。日志使用命名约定 `Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log`。
    - Linux
        
        **注意：**若要在 Linux 计算机上运行 tabcmd，您必须安装 Java 11。在类似 RHEL 的系统上，Java 11 将在您安装 tabcmd 时作为依赖项安装。在 Ubuntu 系统上，如果 Java 11 尚未安装，则需要单独安装。  
          
        自 2022 年 7 月起，不再支持 Debian 发行版。有关详细信息，请参见[此 Tableau 社区](https://community.tableau.com/s/news/a0A4T0000011xDOUAY/debian-end-of-life)。
        
        1. 以具有 sudo 访问权限的用户身份登录到 tabcmd 计算机。
        2. 导航到您将所下载的 `.rpm` 或 `.deb` 软件包复制到的目录。
            
            - 在类似于 RHEL 的分发（包括 CentOS）上，运行以下命令：
                
                `sudo yum install tableau-tabcmd-<version>.noarch.rpm`
            - 在 Ubuntu 上，运行以下命令：
                
                `sudo apt-get install ./tableau-tabcmd-<version>_all.deb`
    
    若要从 Linux 计算机中卸载 tabcmd，请参见适用于正在运行的 Linux 版本的文档。
6. （可选）将安装 tabcmd 的完全限定位置添加到系统路径中，以允许您运行 tabcmd 命令，而无需更改到该位置，或为每个命令指定位置。执行此操作的步骤取决于操作系统的类型和版本。有关详细信息，请参见 [PATH（变量）](https://en.wikipedia.org/wiki/PATH_\(变量\))。

## 如何使用 tabcmd

使用 tabcmd 的基本步骤如下：

1. 以管理员身份打开命令提示符。
    
    **注意：**在 Windows 上，请勿使用 PowerShell 运行 tabcmd 命令。使用 PowerShell 可能会导致意外行为。
2. 在 Windows 计算机上，如果在不是初始节点的计算机上安装了 tabcmd，请切换到安装了 tabcmd 的目录。
    
    在 Linux 计算机上，您无需切换到安装目录。
3. 运行 tabcmd 命令。

在使用 tabcmd 时，您必须建立经过身份验证的服务器会话。会话会识别服务器或 Tableau Cloud 站点以及运行该会话的用户。您可以先启动会话，然后指定命令，或者在启动会话的同时执行命令。

**重要信息：**如果您要使用 tabcmd 执行多项任务，则必须依次（连续）运行任务，而非同时（并行）运行。

命令（例如 `login`）和选项（例如 `-s`、`-u` 等）不区分大小写，但您提供的值（例如 `User@Example.com`）区分大小写。

## 示例

下面的命令演示了如何启动会话：

`tabcmd login -s https://prod-useast-b.online.tableau.com -t mysite -u authority@email.com -p password`

下面介绍了如何用一条命令启动会话和删除工作簿，请注意此处不需要 `login`：

`tabcmd delete "Sales_Workbook" -s https://prod-useast-b.online.tableau.com -t campaign -u admin@email.com -p password`

选项 `-s`、`-t`、`-u` 和 `-p` 是 tabcmd 的全局变量，可与任何命令一起使用。

有关详细信息，请参见 [tabcmd 命令](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm)。

<!-- document id=170b507716fd1d84a42d557921d4f1bc9e5274e5a54f596985ff28aefbdca835 url=/tableau/next/zh-cn/online/tabcmd_cmd.md -->

[跳转到主要内容](#main-content)

# tabcmd 命令

**重要信息：**在 2024 年 8 月到 2025 年 3 月之间，Tableau Cloud 站点已迁移到 Salesforce 的 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)。迁移的结果是，不再支持 tabcmd 1.0。尽快计划迁移到 tabcmd 2.0，以确保您不会受到影响。此次停用不会影响 Tableau Server。

**注意：**在大多数情况下，您必须将 tabcmd 命令行实用程序 2.0 (tabcmd 2.0) 与 Tableau Cloud 结合使用。Tabcmd 2.0 可从 [Tableau tabcmd](https://tableau.github.io/tabcmd) 获取。这个新版本允许您在 MacOS :和 Linux 上运行 tabcmd 命令、使用个人访问令牌 (PAT) 进行身份验证，并允许您符合多重身份验证标准。版本 2.0 构建在基于 Python 的 Tableau Server 客户端 (TSC) 中可用的公共端点之上。

您可以在 Tableau Cloud 中通过 tabcmd 命令行工具使用以下命令：

[login](#id5fba51c9-5608-4520-8ceb-2caf4846a2be)

[logout](#id8f512aec-57a4-4ed4-94c4-86e91ea9cc9c)

[get _url_](#id7e0a0627-ad89-4135-a1c2-85b1d8472568)

[addusers](#id1999d76f-638e-47d4-86ac-fe8e206ed364)（至组）

[creategroup](#idbfa546df-2be7-444f-8bb8-07978b127783)

[deletegroup](#id0d009916-bee3-4ef0-a6ac-22188c0e7f30)

[export](#id7cb8d032-a4ff-43da-9990-15bdfe64bcd0)

[createproject](#id5a3316ed-45bb-4da4-b557-58492b2d4ac8)

[deleteproject](#idfdf59712-84ed-4590-9471-541d316917a6)

[publish](#iddf805b62-18ff-4497-9245-adc6905b2084)

[createextracts](#id5a3316ed-45bb-4da4-b557-1111112d4ac8)

[refreshextracts](#id4cdb3410-1c41-4dad-b1d2-306542ac9b32)

[deleteextracts](#id5a3316ed-45bb-4da4-b557-2222222d4ac8)

[delete _workbook-name_ 或 _datasource-name_](#idfdf59712-84ed-4590-9471-541d316917a6)

[createsiteusers](#idd1b7729f-dd20-475a-96f6-17fcd2577894)

[deletesiteusers](#deletesiteusers)

[removeusers](#id5cc30cba-44b8-48b0-93d6-5707938d157a)

[version](#id825f5d18-529c-408a-b876-57693195bbdd)

## addusers _group-name_

将用户添加到指定的组。

**示例**

`tabcmd addusers "Development" --users "users.csv"`

### 选项

`--users`

将给定 `.csv` 文件中的用户添加到指定组中。该文件应是每行一个用户名的简单列表。用户名不区分大小写。用户应已在 Tableau Cloud 上创建。

有关详细信息，请参见 [CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)。

`--[no-]complete`

当设置为 `complete` 时，此选项要求所有行都必须有效，更改才能成功。如果未指定，则使用 `--complete`。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createextracts

为已发布工作簿或数据源创建数据提取

### 选项

`-d`, `--datasource`

数据提取创建的目标数据源的名称。

`--embedded-datasources`

目标工作簿内嵌入的数据源名称的空格分隔列表。如果数据源名称包含空格，请用双引号括起来。仅在为工作簿创建数据提取时可用。

`--encrypt`

创建加密数据提取

`--include-all`

在目标工作簿内包括所有嵌入数据源仅在为工作簿创建数据提取时可用。

`--parent-project-path`

作为包含目标资源的项目的父级的项目的路径。必须使用 -project 指定项目名称。

`--project`

包含目标资源的项目的名称。仅当指定了 --workbook 或 --datasource 时才需要。如果未指定，则使用默认项目“默认”。

`-u`, `-url`

显示在 URL 中的资源的规范名称。

`-w`, `-workbook`

用于创建数据提取的目标工作簿的名称。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## creategroup _group-name_

创建一个组。使用 `addusers` 在创建组后添加用户。

**示例**

`tabcmd creategroup "Development"`

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createproject _project-name_

创建一个项目。

**示例**

`tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing quarterly sales reports."`

### 选项

`-n`, `--name`

指定要创建的项目的名称。

`--parent-project-path`

指定使用 `-n` 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： `--parent-project-path "Main" -n "Nested"`。

`-d`, `--description`

为项目指定说明。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## createsiteusers _filename.csv_

根据逗号分隔值 (CSV) 文件中提供的信息将用户添加到站点。如果尚未在服务器上创建用户，该命令会在将用户添加到站点之前创建该用户。

CSV 文件必须包含一个或多个用户名，还可（为每个用户）包括一个密码、全名、许可证类型、管理员级别、发布者（是/否），以及电子邮件地址。有关 CSV 文件的格式的信息，请参见[CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)。

作为在 CSV 文件中包括管理员级别和发布者权限的替代方法，您可以通过包括 `--role` 选项并指定要为 CSV 文件中列出的用户分配的站点角色来传递访问级别信息。

默认情况下，用户将添加到您登录到的站点。若要将用户添加到其他站点，请包括全局 `--site` 选项并指定该站点。（您必须具有在指定的站点上创建用户的权限。）

**示例**

`tabcmd createsiteusers "users.csv" --role "Explorer"`

### 选项

`--admin-type`

已弃用。请改用 `--role` 选项。

`--auth-type`

为 `.csv` 文件中的所有用户设置身份验证类型（`TableauID` 或 `SAML`）。如果未指定，则默认值为 `TableauID`。

**注意：**若要使用 SAML 身份验证，站点本身也必须启用 SAML。有关信息，请参见[在站点或 TCM 上启用 SAML 身份验证](https://help.tableau.com/v0.0/online/zh-cn/saml_config_site.htm)。

`--[no-]complete`

已弃用。默认错误行为：如果在十行范围内有 3 个以上的错误，则命令将失败。

`--no-publisher`

已弃用。请改用 `--role` 选项。

`--nowait`

不等待异步作业完成。

`--publisher`

已弃用。请改用 `--role` 选项。

`--role`

为 `.csv` 中的所有用户指定站点角色。如果要使用 --role 选项分配站点角色，请为每个站点角色创建单独的 CSV 文件。

有效的值包括：`ServerAdministrator`、`SiteAdministratorCreator`、`SiteAdministratorExplorer`、`SiteAdministrator`、`Creator`、`ExplorerCanPublish`、`Publisher`、`Explorer`、`Interactor`、`Viewer` 和 `Unlicensed`。

对于新用户，默认值为 `Unlicensed`，对于现有用户，默认值不变。如果有基于用户的服务器安装，并且在 `createsiteusers` 命令创建新用户的情况下您已达到用户许可证数的限制，则会以未许可用户的形式添加该用户。

**注意：**在多站点 Tableau Server 上，如果要使用 `--role` 选项分配 `ServerAdministrator` 站点角色，请使用 [`createusers`](#createusers) 命令，而不是 `createsiteusers`。

`--silent-progress`

不显示命令的进度消息。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## delete _workbook-name_ 或 _datasource-name_

从服务器中删除指定工作簿或数据源。

此命令按原样使用服务器上的工作簿或数据源的名称，而不是发布时的文件名。

**示例**

`tabcmd delete "Sales_Analysis"`

### 选项

`-r`, `--project`

包含您要删除的工作簿或数据源的项目的名称。如果未指定，则使用“Default”项目。

`--parent-project-path`

指定使用 `-r` 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： `--parent-project-path "Main" -r "Nested"`。

`--workbook`

要删除的工作簿的名称。

`--datasource`

要删除的数据源的名称。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteextracts

为已发布工作簿或数据源删除数据提取。

### 选项

`-d`, `--datasource`

用于数据提取删除的目标数据源的名称。

`--embedded-datasources`

目标工作簿内嵌入的数据源名称的空格分隔列表。如果数据源名称包含空格，请用双引号括起来。仅在删除工作簿的数据提取时可用。

`--encrypt`

创建加密数据提取

`--include-all`

在目标工作簿内包括所有嵌入数据源

`--parent-project-path`

作为包含目标资源的项目的父级的项目的路径。必须使用 -project 指定项目名称。

`--project`

包含目标资源的项目的名称。仅当指定了 --workbook 或 --datasource 时才需要。如果未指定，则使用默认项目“默认”。

`-u`, `-url`

显示在 URL 中的资源的规范名称。

`-w`, `-workbook`

用于数据提取删除的目标工作簿的名称。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletegroup _group-name_

从服务器中删除指定的组。

**示例**

`tabcmd deletegroup "Development"`

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deleteproject _project-name_

从服务器中删除指定的项目。

使用 `tabcmd`，您可以仅指定项目分层结构中的顶层项目。若要自动执行想要对父项目内的项目执行的任务，请使用等效的 Tableau [REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm%23API_Reference "在新浏览器选项卡中打开 REST API 参考") 调用。

**示例**

`tabcmd deleteproject "Designs"`

### 选项

`--parent-project-path`

指定使用命令指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Designs”的项目，请使用以下语法： `--parent-project-path "Main" "Designs"`。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## deletesiteusers _filename.csv_

从您登录到的站点中移除用户。要移除的用户在一个文件中指定，该文件包含每行一个用户名的简单列表。（除用户名之外不需要其他信息。）

默认情况下，如果服务器只有一个站点，或者用户只属于一个站点，则还会从服务器中移除用户。在 Tableau Server Enterprise 安装上，如果服务器包含多个站点，则会从站点中移除分配了**“服务器管理员”**站点角色的用户，但不会从服务器中移除这些用户。

如果用户拥有内容，则用户的角色将变为**“未许可”**，但不会从服务器或站点中移除用户。内容仍然由该用户拥有。若要完全移除用户，您必须更改内容的所有者，然后再次尝试移除用户。

**示例**

`tabcmd deletesiteusers "users.csv"`

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## export

从 Tableau Cloud 导出视图或工作簿，并将其保存到文件。此命令还可导出恰好适用于视图的数据。视图数据在摘要级别导出。若要导出详细级别数据，您必须使用 Tableau Server UI。有关详细信息，请参见[下载视图和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/export.htm)。

使用此命令时，请注意以下问题：

- **权限**：若要导出，您必须拥有“导出图像”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。
- **导出数据**：若要导出恰好适用于视图的数据，请使用 `--csv` 选项。这会将视图中使用的摘要数据导出为 .csv 文件。
- **指定要导出的视图、工作簿或数据：**
    
    - 使用 URL 的一部分标识要导出的内容，特别是工作簿或视图的 URL 中显示的 `"workbook/view"` 字符串。不要使用“友好名称”，并且不要包括 URL 末尾的 `:iid=_<n>_` 会话 ID。
        
        例如，“_Superstore_”（超市）工作簿中的 Tableau 示例视图“_Order Details_”（订单详细信息）具有类似于如下的 URL：`<server_name>/#/views/Superstore/OrderDetails?:iid=2`
        
        若要导出“_Order Details_”（订单详细信息）视图，请使用字符串 `Superstore/OrderDetails`。
        
        _不要_使用 `Superstore/Order Details` 或 `Superstore/OrderDetails?:iid=2`。
    - 如果服务器运行多个站点，并且视图或工作簿不在“默认”站点上，请使用 `-t <site_id>`。
    - 若要导出工作簿，请通过在工作簿中打开视图来获取 URL 字符串，并在使用的字符串中包括视图。
        
        在上面的示例中，若要导出“_Superstore_”（超市）工作簿，请使用字符串 `Superstore/OrderDetails`。
    - 若要导出工作簿，必须在 Tableau Desktop 的“发布”对话框中选中“将工作表显示为标签”的情况下发布该工作簿。
        
        **注意：**无法导出包含[管理视图](https://help.tableau.com/current/online/zh-cn/adminview.htm)的 Tableau 工作簿。
    - 若要筛选下载的数据，请使用此格式添加参数筛选器：
        
        ?<filter\_name>=value
        
        或者，如果对参数进行筛选且该参数具有与度量或维度的名称匹配的显示名称：
        
        `?Parameters.<filter_name>=value`
- 已保存文件的格式：格式选项取决于所导出的内容。只能使用 `--fullpdf` 参数将工作簿导出为 PDF。可将视图导出为 PDF (`--pdf`) 或 PNG (`--png`)。
- **已保存文件的名称和位置**（可选）：如果您不提供名称，则将从视图或工作簿名称得到名称。如果您不提供位置，则会将该文件保存到当前工作目录。否则，您可以指定完整路径或当前工作目录的相对路径。
    
    **注意**：您必须包括文件扩展名，例如 `.csv` 或 `.pdf`。命令不会自动向您提供的文件名中添加扩展名。
- **PDF 导出中不包含仪表板网页对象**：仪表板可以包含网页对象。如果要将包含网页对象的仪表板导出到 PDF，则 PDF 中将不包括该网页对象。
- **非 ASCII 和非标准 ASCII 字符及 PDF 导出**：如果您导出的视图或工作簿名称所包含的字符不在 ASCII 字符集内，或包括非标准 ASCII 字符集，则您需要对字符进行 URL 编码（或百分号编码）。
    
    举例来说，如果您的命令包括城市 `Zürich`，则需要将其 URL 编码为 `Z%C3%BCrich`：
    
    `tabcmd export "/Cities/Sheet1?locationCity=Z%C3%BCrich" -fullpdf`

**清除缓存以使用实时数据**

您可以选择添加 URL 参数 `?:refresh=yes` 强制刷新数据查询而不是从缓存中获取结果。如果将 tabcmd 与您自己的脚本结合使用，并且大量使用 `refresh` URL 参数，则可能会对性能造成负面影响。建议您仅当需要实时数据时才使用 `refresh`，例如，在单个仪表板上而不是整个工作簿上。

**示例**

_视图_

`tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report.csv"`

`tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

`tabcmd export "Finance/InvestmentGrowth" --png`

`tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png`

_工作簿_

`tabcmd export "Q1Sales/Sales_Report" --fullpdf`

`tabcmd export "Sales/Sales_Analysis" --fullpdf --pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports.pdf"`

### 选项

`-f`, `--filename`

使用给定文件名和扩展名保存文件。

`--csv`

仅视图。以 `.csv` 格式导出视图的数据（摘要数据）。

`--pdf`

仅视图。导出为 PDF。

`--png`

仅视图。导出为 `.png` 格式的图像。

`--fullpdf`

仅工作簿。导出为 PDF。必须已在“将工作表显示为标签”已启用的情况下发布该工作簿。

`--pagelayout`

设置所导出的 PDF 的页面方向（`landscape` 或 `portrait`）。如果不指定，则将使用其 Tableau Desktop 设置。

`--pagesize`

将导出的 PDF 的页面大小设置为以下各项之一：`unspecified`、`letter`、`legal`、`note folio`、`tabloid`、`ledger`、`statement`、`executive`、 `a3`、`a4`、`a5`、`b4`、`b5` 或 `quarto`。默认值为 `letter`。

`--width`

以像素为单位设置宽度。默认值为 800 像素。

`--height`

以像素为单位设置高度。默认值为 600 像素。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## get _url_

从指定（部分）URL 表示的 Tableau Cloud 中获取资源。结果以文件形式返回。

使用此命令时，请注意以下问题：

- **权限**：若要获取文件，您必须拥有“下载/另存到 Web”权限。虽然可针对每个工作簿或视图设置权限，但默认情况下，所有角色均会获得或继承此权限。
- **指定要获取的视图或工作簿**：使用 `"/views/<workbookname>/<viewname>.<extension>"` 字符串指定要获取的视图，并使用 `"/workbooks/<workbookname>.<extension>"` 字符串指定要获取的工作簿。将 `<workbookname>`  和 `<viewname>` 替换为当您在浏览器打开视图时工作簿和视图在 URL 中的显示名称，并将 <extension> 替换为想要保存的文件类型。不要在 URL 的末尾使用会话 ID (`?:iid=<n>`)，也不要使用工作簿或视图的“友好”名称。
    
    例如，当您在名为 _Metrics Summary_ 的工作簿中打开视图 _Regional Totals_ 时，URL 将类似于如下：
    
    `/views/MetricsSummary_1/RegionalTotals?:iid=1`
    
    使用字符串 `/views/MetricsSummary_1/RegionalTotals.<extension>` 来获取视图。
    
    使用字符串 `/workbooks/MetricsSummary_1.<extension>` 来获取工作簿。
    
    从 Tableau Cloud 下载工作簿和视图时，.twb 或 .twbx 文件的内容以纯文本形式存储。打开文件的任何人都可以读取所有数据，包括可能为数据提供语义线索的筛选器值。
- **文件扩展名**：URL 必须包括文件扩展名。扩展名确定返回的内容。可采用 PDF、PNG 或 CSV（仅限汇总数据）格式返回视图。Tableau 工作簿作为 TWB 返回（如果它连接到已发布的数据源或使用实时连接）或者作为 TWBX 返回（如果它连接到数据提取）。
    
    **注意**：如果要将视图下载到 PDF 或 PNG 文件，并且包括的 `--filename` 参数中包含 .pdf 或 .png 扩展名，则不必在 URL 中包括 .pdf 或 .png 扩展名。
- **已保存文件的名称和位置**（可选）：用于 `--filename` 的名称应包含该文件扩展名。如果您不提供名称和文件扩展名，则这两个名称都将从 URL 字符串得到。如果您不提供位置，则会将该文件保存到当前工作目录。否则，您可以指定完整路径或当前工作目录的相对路径。
- **PNG 大小**（可选）：如果保存的文件是 PNG，您可以在 URL 中指定该大小（以像素为单位）。

**清除缓存以使用实时数据**

您可以选择添加 URL 参数 `?:refresh=yes` 强制刷新数据查询而不是从缓存中获取结果。如果将 tabcmd 与您自己的脚本结合使用，则大量使用 `refresh` 参数可能会对性能造成负面影响。建议您仅当需要实时数据时才使用 `refresh`，例如，在单个仪表板上而不是整个工作簿上。

**示例**

_视图_

`tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename "Weekly-Report.png"`

`tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth" -f "Q1Growth.pdf"`

`tabcmd get "/views/Finance/InvestmentGrowth.csv"`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f growth.png`

`tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f growth.png`

_工作簿_

`tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_Workbooks\Weekly-Reports.twb"`

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## login

**重要信息：**tabcmd 1.0 不支持多重身份验证 (MFA)。若要将 tabcmd 与 Tableau Cloud 一起使用，请使用 [Tableau tabcmd 2.0](https://tableau.github.io/tabcmd)（新窗口）。有关 Tableau Cloud 和 MFA 的详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/to_security_mfa.htm)。

使 Tableau Cloud 用户登录。

可使用 `--server`、`--site`、`--username`、`--password` 全局选项来创建会话。

**注意**：使用 **tabcmd login** 命令时，将无法使用 SAML 站点登录 (SSO)，即使您的站点配置为使用 SAML。若要登录，您必须传递在站点中创建的用户的用户名和密码。您将具有您在登录时使用的 Tableau Cloud 用户的权限。

如果要使用创建会话时使用的相同信息进行登录，只需指定 `--password` 选项。将使用存储在 Cookie 中的服务器和用户名。

如果服务器使用 80（默认值）之外的端口，您需要指定该端口。

仅当服务器运行多个站点，并且您登录的站点不是默认站点时，才需要使用 `--site` (`-t`) 选项。如果未提供密码，则会提示您输入密码。如果指定 `--no-prompt` 选项但未提供密码，则该命令将失败。

登录后，该会话将继续进行，直到其在服务器上过期或 `logout` 命令运行。

**示例**

登录到具有指定的站点 ID 的 Tableau Cloud 站点：

`tabcmd login -s https://prod-useast-b.online.tableau.com -t siteID -u user@email.com -p password`

### 选项

`-s`, `--server`

如果从网络上的 Tableau Server 计算机中运行命令，您可以使用 `http://localhost`。否则，指定计算机的 URL，例如 `http://bigbox.myco.com` 或 `http://bigbox`。

如果服务器使用 SSL，则需要在计算机的 URL 中指定 `https://`。

对于 Tableau Cloud，指定完整 URL，包括您的站点部署到的 Pod。例如：`https://prod-useast-b.online.tableau.com`。

`-t`, `--site`

当服务器具有多个站点，并且您登录的站点不是默认站点时，请使用此选项。

在 URL 中使用站点 ID 以唯一地标识站点。例如，名为 West Coast Sales 的站点的 ID 可能为 west-coast-sales。

`-u`, `--username`

登录用户的用户名。对于 Tableau Cloud，用户名是用户的电子邮件地址。

`-p`, `--password`

`--username` 所指定的用户的密码。如果未提供密码，则会提示您输入密码。

`--password-file`

允许将密码存储在给定 `filename.txt` 文件中而不是命令行中以增加安全性。

`-x`, `--proxy`

用于指定 tabcmd 请求的 HTTP 代理服务器和端口（主机:端口）。

`--no-prompt`

不提示输入密码。如果未指定密码，则 `login` 命令将失败。

`--cookie`

登录时保存会话 ID。后续命令将不需要登录名。此值是命令的默认值。

`--no-cookie`

成功登录后不保存会话 ID 信息。后续命令将需要登录名。

`--timeout SECONDS`

处理 `login` 命令前服务器应等待的秒数。默认值：30 秒。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## logout

退出服务器。

**示例**

`tabcmd logout`

## publish _filename.twb(x)_、_filename.tds(x)_ 或 _filename.hyper_

将指定的工作簿 (.twb(x))、数据源 (.tds(x)) 或数据提取 (.hyper) 发布到 Tableau Cloud。

如果发布工作簿，则默认情况下无需数据库用户名或密码即可发布工作簿中的所有工作表。

将从在其中发布文件的项目中复制最初分配给工作簿或数据源的权限。可在发布了文件后更改已发布资源的权限。 

如果工作簿中包含用户筛选器，则必须指定一个缩略图选项。

**注意：**目前不支持使用 tabcmd 发布扩展数据源或组合数据源。如果使用 tabcmd 发布组合工作簿或数据源文件，它将无法正确链接到其在服务器上的父项。

**示例**

`tabcmd publish "analysis_sfdc.hyper" -n "Sales Analysis"   --oauth-username "user-name" --save-oauth`

如果文件与 tabcmd 并不位于同一目录，请包含文件的完整路径。

**示例**

`tabcmd publish "\\computer\volume\Tableau Workbooks\analysis_sfdc.hyper" -n "Sales Analysis" --oauth-username "username" --save-oauth`

### 选项

`-n`, `--name`

服务器上工作簿或数据源的名称如果省略，则工作簿、数据源或数据提取将以文件名来命名。

`-o`, `--overwrite`

如果服务器上已存在该工作簿、数据源或数据提取，则将其覆盖。

`-r`, `--project`

将工作簿、数据源或数据提取发布到指定项目。如果未指定，则发布到“Default”项目。

`--parent-project-path`

指定使用 `-r` 选项指定的嵌套项目的父项目的名称。例如，若要指定“Main”项目中名为“Nested”的项目，请使用以下语法： `--parent-project-path "Main" -r "Nested"`。

`--db-username`

使用此选项可将数据库用户名与工作簿、数据源或数据提取一起发布。

如果通过受保护 OAuth 连接和访问令牌连接到数据源，则应改用 `--oauth-username` 选项。

`--db-password`

使用此选项可将数据库密码与工作簿、数据源或数据提取一起发布。

`--save-db-password`

将提供的数据库密码存储在服务器上。

`--oauth-username`

用户帐户的电子邮件地址。如果用户对 `--name` 中指定的云端数据源已经有保存的访问令牌，则通过预先配置的 OAuth 连接来连接该用户。访问令牌在用户首选项中管理。

对于数据源的现有 OAuth 连接，应使用该选项而不是 `--db-username` 和 `--db-password`。

`--save-oauth`

将 `--oauth-username` 指定的凭据保存为已发布工作簿或数据源的嵌入式凭据。

随后，当发布者或服务器管理员登录服务器并编辑该工作簿或数据源的连接时，连接设置将显示此 OAuth 凭据已嵌入到内容中。

如果要安排在发布后刷新数据提取，则必须对 `--oauth-username` 使用该选项。这与对传统的数据库连接使用 `--save-db-password` 类似。

`--thumbnail-username`

如果工作簿中包含用户筛选器，则将基于指定用户可看到的内容生成缩略图。设置 `--thumbnail-group` 选项后，无法指定此选项。

`--thumbnail-group`

如果工作簿中包含用户筛选器，则将基于指定组可看到的内容生成缩略图。设置 `--thumbnail-username` 选项后，无法指定此选项。

`--tabbed`

发布带有选项卡式视图的工作簿时，每个工作表都成为一个选项卡，Viewer（查看者）可以使用这些选项卡在工作簿中导航。请注意，此设置将替代任何工作表级安全设置。

`--append`

将数据提取文件附加到现有的数据源中。

`--replace`

使用数据提取文件替换现有的数据源。

`--disable-uploader`

禁用增量文件上传器。

`--restart`

重新启动文件上载过程。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## refreshextracts _workbook-name_ 或 _datasource-name_

对属于指定工作簿或数据源的数据提取执行完全或增量刷新。

此命令使用服务器上显示的工作簿或数据源的名称，而不使用发布时的文件名。仅允许管理员或者工作簿或数据源的所有者执行此操作。

**注意：** 

- 如果服务器管理员为站点禁用了“**立即运行**”设置，此方法将失败并导致错误。有关详细信息，请参见 [Tableau Server 设置](https://help.tableau.com/current/server/zh-cn/maintenance_set.htm)。
- 您可以使用 tabcmd 来刷新云中承载的支持的数据源。例如，云平台上的 SQL Server、MySQL、PostgreSQL；Google Analytics（分析）
- 若要使用 tabcmd 刷新本地数据，数据源必须是可为 Tableau Bridge [建议计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm)配置的类型。对于连接到本地数据的所有其他数据源，您可以使用 Bridge 或命令行数据提取实用程序。有关详细信息，请参见[使用 Bridge 使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm)和[从命令行中自动执行数据提取刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm)。

**示例**

tabcmd refreshextracts --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --project "Sales External" --parent-project-path "Main" --project "Sales External" --datasource sales\_ds

tabcmd refreshextracts --workbook "My Workbook"

tabcmd refreshextracts --url SalesAnalysis

tabcmd refreshextracts --workbook "My Workbook" --addcalculations

tabcmd refreshextracts --datasource sales\_ds --removecalculations

### 选项

`--incremental`

运行增量刷新操作。

`--synchronous`

将完全刷新操作添加至后台程序进程所使用的队列，以在后台程序进程可用时立即运行。如果后台程序进程可用，则立即运行此操作。刷新操作会出现在“后台任务”报告中。

在同步刷新期间，`tabcmd` 在刷新操作进行时保持实时连接到服务器，并且每秒钟进行一次轮询，直到后台作业完成为止。

**注意：**`--synchronous` 选项不适用于使用 Tableau Bridge 刷新的数据源。

`--workbook`

包含要刷新的数据提取的工作簿的名称。如果工作簿名称中含有空格，请将名称放入引号内。

`--datasource`

包含要刷新的数据提取的数据源的名称。

`--project`

与 `--workbook` 或 `--datasource` 结合使用可确定 _Default_ 以外的项目中的工作簿或数据源。如果未指定，则使用“Default”项目。

`--parent-project-path`

指定使用 `--project` 选项指定的嵌套项目的父项目的名称。

例如：

- 若要指定“Main”项目中名为“Nested”的项目，请使用以下语法：
- \--parent-project-path "Main" --project "Nested"
- 指定在“Nested”项目中嵌套的名为“Nested2”的项目：
- \--parent-project-path "Main/Nested" --project "Nested2"

`--url`

显示在 URL 中的工作簿的名称。发布为“Sales Analysis”工作簿的 URL 名称为“SalesAnalysis”。

`--addcalculations`

与 `--workbook` 结合使用以在工作簿的嵌入式数据提取中实现计算，或与 `--datasource` 结合使用以在数据提取数据源中实现计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在[数据提取后台任务](https://help.tableau.com/current/online/zh-cn/adminview_backgrnd.htm) 管理视图中。

`--removecalculations`

与 `--workbook` 或 `--datasource` 结合使用可移除以前实现的计算。将操作添加到后台程序进程使用的查询中。如果后台程序进程可用，操作将立即运行。此操作出现在[数据提取后台任务](https://help.tableau.com/current/online/zh-cn/adminview_backgrnd.htm) 管理视图中。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

## removeusers _group-name_

从指定的组中移除用户。

**示例**

`tabcmd removeusers "Development" --users "users.csv"`

### 选项

`--users`

从指定的组删除给定 `.csv` 文件中的用户。该文件应是每行一个用户名的简单列表。

`--[no-]complete`

要求所有行都必须有效，更改才能成功。如果未指定，则使用 `--complete`。

全局选项

所有 `tabcmd` 命令都使用以下选项。若要开始一个会话，至少需要使用一次 `--server`、`--user` 和 `--password` 选项。将存储一个身份验证令牌，以便可以不用包括这些选项就能运行后续命令。此令牌在使用它的最后一个命令之后五分钟内保持有效。

`-h`, `--help`

显示命令帮助。

**注意：**将 tabcmd 与 Tableau Cloud 结合使用时，列出的某些命令可能不适用。

`-s`, `--server`

Tableau Cloud URL，至少需要使用一次才能开始会话。

`-u`, `--user`

Tableau Cloud 用户名，至少需要使用一次才能开始会话。

`-p`, `--password`

Tableau Cloud 密码，至少需要使用一次才能开始会话。

`--password-file`

允许将密码存储在给定 `.txt` 文件中而不是命令行中以增加安全性。

`-t`, `--site`

指示命令将应用于由 Tableau Cloud 站点 ID 指定的站点，用单引号或双引号引起来。如果指定的用户与多个站点关联，请使用此选项。使用缓存的身份验证令牌时，站点 ID 区分大小写。如果大小写不匹配，则即使令牌仍然有效，系统也可能提示您输入密码。

`--no-prompt`

指定后，该命令将不提示输入密码。如果未提供有效密码，则该命令将失败。

`--[no-]cookie`

指定后，登录时将保存会话 ID，这样后续命令就无需登录。若要不保存会话 ID，请使用 `no-` 前缀。默认情况下，将保存会话。

`--timeout`

等待指定秒数以使服务器完成命令处理。默认情况下，进程将等待服务器响应。

`--`

指定命令行上的选项结尾。您可以使用 `--` 向 `tabcmd` 指明不应将 `--` 后面的内容解释为选项设置，而是解释为命令的值。如果需要在包括连字符的命令中指定值，这将非常有用。下面的示例演示如何能在 `tabcmd` 命令中使用 `--`，在该命令中，`-430105/Sheet1` 是 `export` 命令的必需值。

`tabcmd export --csv -f "D:\export10.csv" -- -430105/Sheet1`

**提示**：有关可用于 Tableau Server 的 Tabcmd 1.0 命令，请参见 [Tabcmd 命令](https://help.tableau.com/current/server/zh-cn/tabcmd_cmd.htm)。

<!-- document id=c3d203e1d6b6221b8290c282c7866933c7c269710709128a84945ff9b4259b96 url=/tableau/next/zh-cn/online/tabcmd_install_flags.md -->

[跳转到主要内容](#main-content)

# tabcmd 的安装开关和属性 (Windows)

**重要信息：**在 2024 年 8 月到 2025 年 3 月之间，Tableau Cloud 站点已迁移到 Salesforce 的 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)。迁移的结果是，不再支持 tabcmd 1.0。尽快计划迁移到 tabcmd 2.0，以确保您不会受到影响。此次停用不会影响 Tableau Server。

**注意：**在大多数情况下，您必须将 tabcmd 命令行实用程序 2.0 (tabcmd 2.0) 与 Tableau Cloud 结合使用。Tabcmd 2.0 可从 [Tableau tabcmd](https://tableau.github.io/tabcmd) 获取。这个新版本允许您在 MacOS :和 Linux 上运行 tabcmd 命令、使用个人访问令牌 (PAT) 进行身份验证，并允许您符合多重身份验证标准。版本 2.0 构建在基于 Python 的 Tableau Server 客户端 (TSC) 中可用的公共端点之上。

通过 Windows 上的命令行安装 Tableau Server 命令行实用程序 (tabcmd) 版本 2019.4.0 或更高版本时，可以使用以下开关。

**注意：**对于 Tabcmd 安装程序的 Linux 版本，没有等效的开关。

<table class="simple-table"><colgroup><col style="width: 25%;"><col><col></colgroup><tbody><tr><td>开关</td><td>描述</td><td>注释</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>运行安装程序来安装、修复或卸载 tabcmd，使用 <code>/layout</code> 则会指定目录中创建安装包的完整本地副本。</p></td><td>默认值为进行安装，并显示 UI 和所有提示。如果在全新安装时未指定目录，则使用 <code>C:\Program Files\Tableau\Tableau Server\&lt;version&gt;\extras\Command Line Utility</code>。</td></tr><tr><td><code>/passive</code></td><td><p>运行安装程序并显示最少的 UI，并且不显示提示。</p></td><td>&nbsp;</td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>以无人参与的完全无提示模式运行安装程序。不会显示任何 UI 或提示。</p></td><td><p class="note"><b>注意：</b>使用 <code>/silent</code> 或 <code>/quiet</code>，不要两者都使用。</p></td></tr><tr><td><code>/norestart</code></td><td><p>运行安装程序而不重新启动 Windows，即使必须重新启动也是如此。</p></td><td><p class="note"><strong>注意：</strong>在某些极少数情况下，即使使用此选项，也无法抑制重新启动。当跳过较低版本系统的重新启动时（例如，在安装其他软件期间），很可能出现这种情况。</p></td></tr><tr><td><code>/log "&lt;log-file&gt;"</code></td><td><p>将信息记录到指定的文件和路径。</p><p>默认情况下，系统使用命名约定 <code>Tableau_Server_Command_Line_utility_&lt;version_code&gt;.log</code> 在用户的 <code>%TEMP%</code> 文件夹中创建日志文件。</p></td><td><p>如果未指定文件位置，则将日志文件写入用户的 TEMP 文件夹 (<code>C:\Users\&lt;username&gt;\AppData\Local\Temp</code>)。安装之后，检查此日志文件来查找错误。</p><p>示例：<code>&lt;Setup file&gt; /silent /log "C:\Tableau\Logs\tabcmd-Install" ACCEPTEULA=1 </code></p></td></tr></tbody></table>

<table class="simple-table"><colgroup><col style="width: 25%;"><col><col></colgroup><tbody><tr><td>属性</td><td>描述</td><td>注释</td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>接受最终用户许可协议 (EULA)。对于无提示和被动安装为必需。1 = 接受 EULA，0 = 不接受 EULA。</td><td><p>如果使用 <code>/passive</code>、<code>/silent</code> 或 <code>/quiet</code> 时未包括此属性，则安装程序将无法以无提示形式运行。</p><p>如果包含此属性但设置为 0，安装程序将失败</p></td></tr><tr><td><code>INSTALLDIR="&lt;path\to\installation\directory&gt;"</code></td><td>将 tabcmd 安装到指定的非默认安装位置。</td><td><p>指定用于安装 tabcmd 的位置。如果未使用，则 tabcmd 将安装到 <code>C:\Program Files\Tableau\Tableau Server\&lt;version_code&gt;\extras\Command Line Utility</code></p><p>示例：<code>&lt;Setup file&gt; /silent INSTALLDIR="C:\tabcmd"
					</code></p></td></tr></tbody></table>

<!-- document id=d9c71aeeeb658d62ce07bd69be1f4c83a62789a684edefffe054d0c040c00758 url=/tableau/next/zh-cn/online/web_author_einstein_best_practice.md -->

[跳转到主要内容](#main-content)

# Tableau Agent 最佳做法

Tableau Agent 会尽力理解您的问题的意图以及您的数据和业务的上下文。但如果没有针对 AI 优化的数据，Tableau Agent 可能会出错。

本文介绍您可以采取的一些步骤，以确保从 Tableau Agent 获得最佳结果。

## 一般信息

### 使用干净、建模良好的数据

杂乱的数据很难分析，的数据难以分析，而Tableau Agent 专注于分析，而非数据的清理和预处理。

- **执行**：在分析之前清理并准备杂乱的数据。尝试使用 [Tableau Prep 中的 Tableau Agent](https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm) 清理您的数据。
    - **不要**：期望分析智能体进行数据准备。
- **执行**：在数据建模中使用关系。
    - **不要**：对联接进行硬编码
    - **不要**：使用数据混合
- **执行**：使用经过认证的数据源并更新它们以供 AI 使用。
- **执行**：隐藏不必要的字段。如果用户不应使用该字段构建可视化项，则智能体不应看到它。

### 使用清晰的字段名称和描述

Tableau Agent 理解数据的方式与人类不同。如果没有良好的名称和描述，Tableau Agent 可能会误解字段或对要查询哪个字段感到困惑。消除有关数据如何适合分析的任何猜测。

- **执行**：使用唯一、描述性且完整的字段名称。
    - **不要**：将字段名称保留为“Age”（年龄），而该字段可能是“Case Age at Close”（结案时的存续时长）
    - **不要**：保留缩写或不明确的字段，如“P\_ID”或“Name”
    - **不要**：使用重复的字段名称或过于相似的名称。例如“Region1”、“Region1\_copy”。为每个字段使用不同的名称，或者如果您的分析中不需要重复项，则将其隐藏。
- **执行**：提供定义字段的描述。
- **执行**：包括业务上下文和预期同义词。
    - **不要**：假设您的所有用户将始终通过其正式名称来引用该字段
- **执行**：描述在分析中通常如何使用该字段，以及它与类似字段的不同之处。
    - **不要**：跨类似字段复制和粘贴描述
- **执行**：保留标准 Salesforce 字段的描述。
- **执行**：记录任何独特的业务逻辑或数据异常（例如如何解释 null，或何时使用“发票日期”而不是“购买日期”）。

### 创建业务首选项

_仅适用于仪表板中的 Tableau Agent 的“仪表板问答”功能_

为了让 Tableau Agent 基于您组织的业务知识，您可以创建并上载业务首选项文件。业务首选项可以包括您整个组织的规则、术语和业务逻辑（例如定义会计年度或库存阈值）等内容。有关详细信息，请参见[提高仪表板问答的响应质量](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard-narratives.htm#improve-response-quality-for-dashboard-Q&A)。

创建您的业务首选项文件时，请遵循以下准则：

- **建议**：创建清晰、简明且独立的首选项，并在每个首选项条目的开头使用“#”进行标识。Tableau Agent 将此行条目作为首选项之间的分隔符读取。您可以在此分隔符之间添加一个或多个附加行，以进一步解释业务首选项。
    
    示例：
    
    \# 收入以美元为单位
    
    使用 $ 设置格式，使用逗号作为千位分隔符。请勿包含美分。
    
    - **不要**：包含超过 50 个首选项或超过 8000 个字符。
    - **不要**：包含复杂的说明。而是将它们分解为简单、明确的首选项。
- **建议**：直接引用数据源中的确切字段名称或计算字段，以明确您的业务首选项适用于哪些字段。
    
    - **不要**：使用模糊或不明确的字段引用，导致 Tableau Agent 猜测您指的是哪个字段或指标。
- **建议**：在编写首选项之前直接在数据源中创建计算字段，然后在说明中引用这些计算字段。
    
    - **不要**：在您的业务首选项中编写要求 Tableau Agent 执行原始数学运算或动态定义多步骤公式的规则。例如，“将百分比乘以 100”。
- **建议**：包含特定领域的指南以及您组织的特有术语。例如，“当提到业务机会时，TPS 是产品总销售额的缩写”，或未包含在您的语义模型架构中的信息。
    
    - **不要**：包含一般业务信息。Tableau Agent 需要有关如何解读或显示数据的具体信息。

当前不支持以下类型的业务首选项：

- **不供 AI 使用**：屏蔽主题或问题。例如，“不要回答任何有关薪资的问题”。
- **可视化设置格式**：例如“显示一段时间内的销售额时使用折线图”。
- **LLM 回复结构**：例如，“回复时不要显示可视化项”或“每次回复时，先对用户说‘谢谢’，然后显示答案，最后以‘再见’结束。”

### 预定义计算字段

虽然 Tableau Agent 可以帮助通过自然语言创建计算，但如果用户错误地或含糊地要求计算，则可能会导致不正确的计算。

- **执行**：提前创建任何常用计算，以便可以确保一致性和准确性。

### 指定字段属性

智能体依靠字段属性作为分析边界。默认或错误配置的属性可能会导致不良的分析结果。

- **执行**：验证字段角色（维度和度量）和数据类型（例如日期、数字、布尔值）。
    - **不要**：如果应将邮政编码等字段视为属性（维度），请将其保留为数值字段（度量）。
    - **不要**：将日期存储为文本。
- **执行**：设置默认聚合。
    - **不要**：假设用户或智能体知道对“单价”使用平均值，而不是总和

## AI 就绪情况检查清单

在准备已发布数据源和工作簿以供 AI 使用时，请使用此检查清单来实施最佳做法。

**模型结构**

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")清理数据

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")上载的业务首选项（.md 或 .txt）包含描述独特域逻辑的明确规则

**注意**：此功能目前仅由仪表板中的 Tableau Agent 在仪表板问答中使用。

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")使用关系而不是联接

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")无数据混合

**字段**

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")字段名称具体且与上下文相关

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")所有字段都有有用的差异化描述

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")隐藏不必要的字段

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")常见或预期计算已存在

![复选框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_best_practice_checkbox.png "tab_gai")字段具有正确的属性：角色、数据类型、默认聚合

<!-- document id=645606ef01f6a46d9c1d3bf915b0ee9443815756fa5cc0bf989a04bfde40ca61 url=/tableau/next/zh-cn/online/web_author_einstein_faq.md -->

[跳转到主要内容](#main-content)

# Tableau Agent 常见问题解答

查找有关在 Tableau Desktop 和 Tableau Cloud 以及 Tableau Server Web 制作中使用 Tableau Agent 的常见问题的答案。若要了解有关用于 Tableau Prep 或 Tableau Catalog 的 Tableau Agent 的详细信息，请参见[使用 Tableau Agent 创建计算字段](https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm) 或[描述项目、工作簿或数据源](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#gen-ai-description)。

## 一般信息

### 什么是 Tableau Agent？

Tableau Agent 是 Tableau 中的一项生成式 AI 功能，可帮助您使用对话助手探索数据、创建可视化项并发现见解。它允许您在 Web 制作环境中通过自然语言与数据进行交互。

### 有免费试用吗？

是的。您可以注册 Tableau Cloud 免费试用版，其中现已包含 Tableau Agent 功能。只需填写此[表单](https://www.tableau.com/zh-cn/products/trial)或联系您的客户经理。作为有限试用的一部分，您目前可以在 Tableau Desktop（从 2025.1 开始）、Tableau Cloud Web 制作、Tableau Prep Builder（从 2025.2 开始）以及 Web 上的 Tableau Prep 中试用 Tableau Agent。

从 2026 年 7 月开始，您还可以试用仪表板中的 Tableau Agent。此测试版功能使您能够概览仪表板、逐个可视化项获取见解摘要，以及使用自然语言提出有关数据的问题。有关详细信息，请参见[仪表板中的 Tableau Agent](https://help.tableau.com/current/online/zh-cn/dashboard_narratives_overview.htm)。

试用版可让您完全访问 Tableau Agent 功能，但整体体验会受到一些限制。

- 您只能在新站点中试用，而不能将 Tableau Agent 的试用版添加到现有的生产站点。
- Tableau Catalog 中的 Tableau Agent 不包含在试用版中。
- Tableau Agent 在试用期间可以免费使用，但每小时可发出的请求数量可能会受到限制。

### 如何访问 Tableau Agent？

您可以在 Tableau Cloud 站点、Tableau Server 站点（从版本 2025.3 开始）或 Tableau Desktop（从版本 2025.1 开始）的 Web 制作环境中找到 Tableau Agent。在“智能显示”旁边的工具栏中查找 Tableau Agent 图标。

该图标仅在满足以下条件时才处于活动状态：

- **在 Tableau Desktop 中**：当您登录到具有 Tableau+ Cloud+ 或 Tableau+ 且已启用适用于 Tableau 的 AI 进行 Web 制作的 Tableau Cloud 站点，或启用了 Web 制作的 Tableau Server 站点时。
- **在 Tableau Web 制作中**：当启用了 Tableau 中的 AI 进行 Web 制作，且为您分配了 Creator 或 Explorer 角色时。作为 Viewer（查看者），您可以访问仪表板中的 Tableau Agent（版本 2026.2.4 及更高版本），前提是为仪表板启用了这些能力，并且您已被授予“AI 访问”和“完整数据查询”权限。

您还必须位于工作表标签上并已连接到数据源。在 Tableau Cloud 中，如果您选择启用仪表板中的 Tableau Agent（测试版），您还可以在仪表板选项卡上看到 Tableau Agent。

- 有关仪表板中的 Tableau Agent 的详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/online/zh-cn/dashboard_narratives_overview.htm)。
- 有关如何在 Tableau Cloud 站点中配置 Tableau Agent 的详细信息，请参见[为您的站点启用 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm)。
- 有关如何在 Tableau Server 上配置 Tableau Agent 的信息，请参见[在您的 Tableau Server 站点中启用 AI](https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm)。

![突出显示Einstein 图标的空白工作表](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_icon_webauth.png)

### 是否可以限制用户对 Tableau Agent 的访问？

是的。您可以为单个用户组或站点上的所有用户启用 Tableau 中的 AI 功能。目前，仅在 Tableau Cloud 中为可视化项制作和 Tableau Prep 配置 Tableau 中的 AI 时，此选项才可用。在 Tableau Server 中启用 Tableau 中的 AI 时，此选项当前不可用。有关详细信息，请参见[配置 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm#configure-ai-in-tableau)。

对于仪表板中的 Tableau Agent（测试版），您可以使用“权限”设置来控制访问。有关详细信息，请参见[“权限”](https://help.tableau.com/current/online/zh-cn/permissions.htm#DashboardAgent)。

### 为什么 Tableau Agent 按钮不可用了？

**注意**：如果您使用的是 Salesforce Government Cloud 组织，则不支持 Tableau Agent。

若要使用 Tableau Agent，必须满足以下条件：

- 您必须连接到启用了 Tableau+ 和 Tableau 中的 AI 的 Tableau Cloud 站点或启用了 Tableau 中的 AI 的 Tableau Server 站点（版本 2025.3 或更高版本）。
- 如果您使用 Tableau Desktop，则必须登录 Tableau Cloud 或 Tableau Server 站点。
- 您必须在工作表上或仪表板上。
    
    - 对于仪表板中的 Tableau Agent，您必须连接到 Tableau Cloud 站点并已选择启用仪表板中的 Tableau Agent（测试版）。作为 Viewer（查看者），您还必须被授予“AI 访问”和“完整数据查询”权限。
- 您必须连接到数据源。
    
    - 对于仪表板中的 Tableau Agent 的“概述”和“见解”功能，您必须连接到已发布数据源。“仪表板问答”功能支持已发布数据源和嵌入式数据源。
- 必须为您的站点启用 Tableau 中的 AI，并且为了在浏览器中使用，还必须启用 Tableau Web 制作的选项。

## 用途和功能

### 我可以将 Tableau Agent 用于任何类型的数据吗？

建议将 Tableau Agent 用于数据提取或基于文件的数据以提高性能，但用于可视化项制作的 Tableau Agent 也适用于实时连接或上载的 .hyper、.csv、.txt 和 .xlsx 文件类型的文件。

仪表板中的 Tableau Agent 的“概述”和“见解”功能可处理已发布数据源。“仪表板问答”功能适用于已发布数据源和嵌入式数据源。

不支持多维数据集。此外，如果您使用数据混合，Tableau Agent 只能与主数据源一起使用。

### 我可以用我的语言使用 Tableau Agent 吗？

从版本 2025.1 开始，Tableau Agent 支持英语 (en\_US) 和其他一些语言。如果您的 Cloud 站点、Server 站点，或 Tableau Desktop 应用程序设置为不受支持的语言，则 Tableau Agent 响应将采用英语 (en\_US)。有关受支持语言的详细信息，请参见 [Tableau 中的 AI 支持的语言和区域设置](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm#supported_language)。

**注意**：如果您的数据源字段名称和值与您的用户语言设置不同或与您与 Agent 交互的语言不同，请在您的请求中使用准确的字段名称和值。

### 我可以选择想要使用的大型语言模型 (LLM) 吗？

不可以。Tableau Agent 当前不支持选择 Salesforce 管理的大型语言模型 (LLM)。相反，Tableau 的开发团队会根据性能、准确性和成本测试并选择最佳模型。有关详细信息，请参见[地理感知 LLM 请求路由](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm#geoaware-llm-request-routing)。

### 我可以选择想要在 Tableau Server 中使用的大型语言模型 (LLM) 吗？

是的，从 Tableau Server 版本 2026.2 开始，您可以选择 OpenAI 或 Azure OpenAI。有关详细信息，请参见[在 Tableau Server 站点中启用 AI](https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm)。

### 我可以让 Tableau Agent 做什么？

Tableau Agent 具有多种功能。它可以创建可视化项并帮助您创建和理解计算。如果您选择启用仪表板中的 Tableau Agent（测试版），它可以分析您的仪表板并为仪表板用户创建概述和见解摘要。仪表板用户还可以更深入地研究他们的数据并使用自然语言提出问题。

Tableau Agent 可以帮助您构建可视化项，为您的数据选择最佳图表类型，执行基于日期的分析，以及管理数据筛选和排序。例如，您可以要求它“显示特定地区的销售数据”或“将销售额与利润进行比较”。有关详细信息，请参见[构建和更改可视化项](https://help.tableau.com/v0.0/online/zh-cn/web_author_einstein.htm#build_viz)。

Tableau Agent 还可以通过自然语言生成计算。使用与用于生成可视化项相同的对话窗格，您可以要求 Tableau Agent 创建、更新或解释计算。有关详细信息，请参见[创建计算](https://help.tableau.com/v0.0/online/zh-cn/web_author_einstein.htm#create_calcs)。

仪表板中的 Tableau Agent 从 2026年 7 月开始推出测试版，可以分析您的仪表板并创建有关仪表板的快速概览，或者为仪表板上的图表创建见解摘要，帮助用户快速找到数据见解，以便他们可以对最重要的事情采取行动。用户还可以（使用适当的权限）查询基础数据源并提出有关数据的问题，从而使用自然语言更深入地进行分析。有关详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/pro/zh-cn/dashboard_narratives_overview.htm)。

### 如何为我的字段添加上下文以从 Tableau Agent 获得最佳答案？

为字段添加描述。Tableau Agent 对 Tableau Desktop 或 Tableau Catalog 中注释中的字段描述进行索引。目前有一个限制，Tableau Agent 只能对每个描述的前 150 个字符进行索引，总体限制为 4000 个字符。如果您有许多字段，作为最佳做法，请使用简短明了的描述以获得最佳结果。有关更多提示，请参见[Tableau Agent 最佳做法](https://help.tableau.com/current/online/zh-cn/web_author_einstein_best_practice.htm)。

### 我能否教 Tableau Agent 学习适用于我组织的特定业务规则或自定义公式？

可以。仪表板作者可以在 Tableau Agent 窗格中的“配置设置”\>“配置业务首选项”下上载业务首选项文件（.txt 或 .md）。这让您可以提供最多 50 条特定规则，例如组织范围的规则、术语和业务逻辑（例如定义会计年度或库存阈值），以帮助 Tableau Agent 基于您的业务知识提供更好的答案。此功能目前仅供具有仪表板问答功能的仪表板中的 Tableau Agent 使用。有关详细信息，请参见[提高仪表板问答的响应质量](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard-narratives.htm#improve-response-quality-for-dashboard-Q&A)。

### Tableau Agent 的功能有哪些局限性？

是的，Tableau Agent 有一些局限性。例如，它无法为您选择数据源、进行数据建模、构建仪表板、建议相关内容或回答数据世系问题、回答咨询问题（例如“我应该如何分析我的数据？”），或与筛选器控件和参数等元素创建交互性。它主要是为了帮助新手用户和那些探索临时数据问题的用户。有关详细信息，请参见[Tableau Agent 限制](https://help.tableau.com/v0.0/online/zh-cn/web_author_einstein.htm#einstein_limitations)。

### 有效使用 Tableau Agent 的最佳方法是什么？

从处理干净的数据开始

- 使用 [Tableau Agent 最佳做法](https://help.tableau.com/current/online/zh-cn/web_author_einstein_best_practice.htm)优化您的工作簿和数据源
- 确保字段名称具有描述性且唯一
- 对于仪表板问答，请上载[业务首选项](https://help.tableau.com/current/online/zh-cn/web_author_einstein_best_practice.htm#create-business-preferences)以帮助 Tableau Agent 更好地了解您的业务
- 当您启动 Tableau Agent 会话时，如果您在数据源中看到名称相似的字段，请隐藏不相关的字段。Tableau Agent 不会根据隐藏字段给出答案
- 如果您知道自己想要什么，请指定度量的聚合函数
- 确保字段具有正确的字段角色（度量或维度）和数据类型（位置、字符串、布尔值等）
- 与传统 Tableau 一样，Tableau Agent 在数据提取方面表现更佳。使用实时数据源时，启动 Tableau Agent 会话所需的时间可能会更长，并且可视化项加载时间会更慢

仅询问有关分析数据的问题。Tableau Agent 不是通用聊天机器人。当需要提问时，启动每个请求时，就好像 Tableau Agent 只知道可视化项的当前状态一样。询问您想看到的内容。例如，“我在加利福尼亚州的一段时间内的销售额是多少？”。

您的请求请具体且详细描述，以帮助 Tableau Agent 更好地理解和响应您的数据分析需求。将您的请求分解为离散任务。例如，首先请求计算，然后请求使用该新字段的可视化项，而不是同时请求可视化项和新的计算字段。有关详细信息，请参见[从 Tableau Agent 获得最佳结果的技巧](https://help.tableau.com/v0.0/online/zh-cn/web_author_einstein.htm#tips)。

### 我可以将 Tableau Agent 用于仪表板或故事吗？

Tableau Agent 仍不适用于故事，但从 2026 年 7 月开始，Tableau Agent 现在以测试版提供，可用于 Tableau Cloud 和 Tableau Cloud 试用站点上的仪表板。有关详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/pro/zh-cn/dashboard_narratives_overview.htm)

## 技术细节

### Tableau Agent 如何处理数据隐私和安全？

#### Tableau Cloud

Tableau Cloud 中的 Tableau Agent 通过遵守第三方 LLM 提供商的零数据保留政策来确保数据隐私和安全。它尊重 Tableau Cloud 中所有现有的权限和数据策略，确保只有授权用户才能访问。此外，它还可采用基于模式的数据屏蔽技术来保护个人身份信息 (PII)，然后再由 LLM 处理。

有关详细信息，请参见 Salesforce 帮助中的 [Tableau 中的 AI 和 Einstein 信任层](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust_layer.htm)和[选择要屏蔽的数据](https://help.salesforce.com/s/articleView?id=ai.generative_ai_mask_select.htm&type=5)。

#### Tableau Server（版本 2025.3 及更高版本）

在 Tableau Server 中使用 Tableau Agent 时，您将连接到自己的 LLM 提供商。您的请求没有使用 Einstein 信任层及其相关的数据治理功能，包括内置的 PII 屏蔽。相反，您将依靠 LLM 提供商的安全措施来保护敏感数据。

### 当我连接到自己的 OpenAI 帐户时，Tableau Server 中的 Tableau Agent 是否使用 Einstein 信任层？

不使用。当您在 Tableau Server 中连接到 OpenAI 或 Azure OpenAI 时，来自 Tableau Agent 的所有请求都会直接发送到 LLM 提供商。此过程不使用 Einstein 信任层的安全和 PII 屏蔽功能。您将依靠 LLM 提供商的安全措施来保护敏感数据。有关详细信息，请参见 [Tableau 中的 AI 和信任](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm)。

### Tableau Agent 如何知道我的数据里有什么？

Tableau Agent 在每个会话开始时都会对您的数据源进行索引，以了解当前存在哪些数据。索引包含数据类型、字段名称以及字段的 1000 个样本唯一值。这可确保响应基于您的数据。请记住，Tableau Agent 尊重数据屏蔽（如果已启用），并且可能无法响应涉及屏蔽数据的请求。

如果您拥有高基数的字段（单个字段有许多不同的值），Tableau Agent 可能没有索引所有值。如果您尝试筛选高基数字段，Tableau Agent 会为该字段创建一个筛选器，但可能会提示您选择要包含或排除的值。

### 如果 Tableau Agent 创建的可视化项不正确怎么办？

与所有 AI 一样，回顾使用 Tableau Agent 时获得的结果非常重要。尽管 Tableau Agent 可以扫描您的数据源以查找字段名称和这些字段中的数据，但它无法像人类一样真正理解数据。始终检查 Tableau Agent 的结果。如果可视化项不符合您的期望，请尝试澄清您的请求或要求 Tableau Agent 重新创建它。您还可以直接与可视化项交互来调整分析以满足您的需求。将 Tableau Agent 创建的可视化项视为启动分析的起点。

您还可以始终使用对话窗格中的“拇指朝上”和“拇指朝下”图标提供反馈。

### Tableau Agent 能记得之前的交互吗？

Tableau Agent 是一种基于每张工作表的体验，这意味着它不会保留不同工作表之间的对话历史记录。它根据当前工作表的对话窗格中的信息来限制内存。如果您在同一会话中关闭并重新打开对话窗格，您的对话历史记录将会保留。如果您关闭工作簿，这将清除与 Tableau Agent 的对话。对话历史记录未保存，并且不会在您下次打开已发布或已保存的工作簿时出现。

<!-- document id=f540685a7cc266b44ac88caf35335fea49521ba9caf36240500dd593729e0e19 url=/tableau/next/zh-cn/online/to_bridge_faq.md -->

[跳转到主要内容](#main-content)

# Tableau Bridge 常见问题解答

查找 Tableau Bridge 常见问题的答案。

## Bridge 基础知识

### 什么是 Tableau Bridge？

Tableau Bridge 是一个代理客户端，它运行在您网络中的一台计算机上，用于将您的专用网络数据连接到 Tableau Cloud。Bridge 安装在组织的防火墙后面。它可以通过从您的数据到 Tableau Cloud 的已建立的安全出站连接来访问内部和虚拟云（托管在公共云中的独立私有云）数据。

请参见[使用 Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。

### Tableau Bridge 是用来做什么的？

如果您的部分或全部数据位于本地或防火墙后的虚拟云中，您可以使用 Bridge 安全地访问数据并将数据连接到 Tableau Cloud。这些数据可以是专用网络上的 .csv 文件，也可以存储在数据仓库中。

Bridge 还能让您的数据保持最新。如果您有一个可视化项必须在数据修改时进行刷新，Bridge 可以通过自动刷新数据提取或向您的本地数据源传递实时查询来使数据在 Tableau Cloud 中保持最新。

### Tableau Bridge 的费用是多少？

Tableau Bridge 是一个免费的、受支持的客户端，可与 Tableau Cloud 结合使用。

### Tableau Bridge 支持的操作系统和最低硬件要求是什么？

Bridge 在 Windows 64 位计算机上和 Linux 上受支持。对于 Linux 版 Bridge，您必须创建自定义 Docker 映像。有关最低硬件要求的信息，请参见[推荐的软件和硬件](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm#system)。

### 是否需要为每个 Tableau Cloud 站点安装单独的 Tableau Bridge？

是的。Tableau Bridge 在任何给定时间只能连接到一个 Tableau Cloud 站点。Tableau 建议将 Bridge 客户端安装在防火墙后面的专用虚拟计算机上，这样它就不会与其他应用程序的资源竞争。一台计算机上只能安装一个客户端。有关详细信息，请参见[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)。

### 即使我可以直接从 Tableau Cloud 连接到数据，我也可以使用 Bridge 吗？

如果 Tableau Cloud 可以直接访问数据，就不需要使用 Bridge。Bridge 充当代理，根据吞吐量的不同，Bridge 可能比直接连接到数据源的速度慢。

### 如何安装 Bridge？

(Windows) 从[下载](https://www.tableau.com/zh-cn/support/releases/bridge?_ga=2.221107416.1990179398.1663001829-720568525.1657234993)页面下载安装程序，并按照[安装 Bridge](https://help.tableau.com/current/online/zh-cn/to_bridge_install.htm) 的说明进行操作。请参见[推荐的软件和硬件](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm#system)。[](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm#system)

(Linux) 若要在 Linux 上使用 Bridge，您必须创建自定义 Docker 映像，安装 RPM 包，然后从容器映像内部运行 Bridge。

## 安全性

### Bridge 如何保证数据安全？

Bridge 和 Tableau Cloud 之间的所有流量都使用 TLS 进行保护。Bridge 建立初始出站连接；所有通信都是使用端口 80 和 443 从防火墙后面发起的。初始出站连接后，通信是双向的。来自 Tableau Bridge 的在途数据已经过加密。Bridge 使用以下协议，具体情况视内容使用的连接类型而定：

- 对于使用 Bridge 刷新计划的实时连接和数据提取刷新，使用安全 WebSockets (wss://) 协议。
- 对于使用 Bridge（旧版）计划的数据提取刷新，使用 HTTP 安全 (https://) 协议。

为了确保只将数据传输到 Tableau Cloud，您可以从 Bridge 客户端中对出站连接实现基于域的筛选（转发代理筛选）。

请参见 [Bridge 安全性](https://help.tableau.com/current/online/zh-cn/to_bridge_security.htm)。

### 还有其他保护数据的方法吗？

您可以使用白名单来识别允许访问您的数据的站点，并排除列表中未包含的站点。某些数据源始终是云原生的，例如 Amazon Athena、RedShift、Azure SQL Database、Google Cloud SQL。在这些情况下，当使用原生连接器时，默认情况下 Tableau Cloud 期望通过 IP 白名单直接连接。

如果数据在私有子网中与 Internet 隔离（因此 IP 白名单不是一个选项），可以将 Tableau Bridge 配置使用“云原生”数据源。

### 我需要什么权限？

- 您需要访问用于登录 Tableau Bridge 客户端的 Tableau Cloud 帐户以及与数据关联的站点。
- 若要将 Bridge 客户端分配给池（默认池或指定池），您需要站点管理员 Creator 或站点管理员 Explorer 角色。
- 菲要运行数据提取刷新，请执行以下操作：
    - 对于 Bridge 刷新计划，用户需要 Creator 或 Explorer（可发布）。Bridge 客户端必须由站点管理员正确设置。
    - 对于 Bridge 旧版计划，由于计划必须分配给特定的 Bridge 客户端，因此用户必须是该 Bridge 客户端的所有者（如果客户只有 Creator 或 Explorer（可发布）权限），或者是站点管理员。
- 需要 Creator 或 Explorer（可发布）角色以及数据管理许可证才能使用 Bridge 发布虚拟连接并刷新数据。
- (Windows) 运行 Bridge 的 Windows 帐户必须能够访问正在连接的所有数据源。
- (Windows) Windows 用户帐户必须是本地管理员组的成员，才能在服务模式下运行客户端。如果用户不是本地管理员，他们可以在应用程序模式下运行 Bridge 客户端，但他们必须保持登录到 Windows 计算机。

### 访问数据时使用哪些凭据？

对于使用 Bridge 旧版计划的数据提取，访问信息必须嵌入 Bridge 客户端中。Bridge 客户端所有者必须登录到 Windows 计算机并手动输入凭据。此过程会导致使用 Windows 凭据管理器将数据库凭据存储在计算机上。

对于 Bridge 刷新计划，可以在 Tableau Cloud 中为已发布的数据源嵌入凭据。

对于通过 Windows 身份验证访问的数据源，没有要嵌入的凭据，但是运行 Bridge 的 Windows 帐户必须能够访问源数据库。

Tableau Bridge 在连接到使用 OAuth 的私有数据和使用 OAuth 的公共数据（如果其联接到私有数据）时支持 OAuth。Oauth 支持保存的凭据或托管的密钥链连接器：功能的类型取决于您使用的连接器。Bridge 支持使用 Oauth 身份验证对数据源进行实时刷新和数据提取刷新。

**注意**：Tableau Cloud 2025.2（2025 年夏季）版本中新增了对 OAuth 连接的一次性刷新令牌（有时称为一次性刷新令牌、滚动刷新令牌或刷新令牌轮换）的支持，并在 Tableau Server 2025.3 版本中添加了支持（如果数据源提供商的 IDP 支持）。这些令牌在 Tableau Bridge 与 Tableau Cloud 的连接上尚不受支持。如果为连接使用外部 OAuth 配置，请参见 GitHub 中的 [OAuth 配置和使用文档](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 配置文档")了解详细信息。

Tableau Bridge 支持使用 Kerberos 的集成 Windows 身份验证。请参见[集成 Windows 身份验证](https://learn.microsoft.com/en-us/aspnet/web-api/overview/security/integrated-windows-authentication)。但是，Bridge 不支持使用 Kerberos 作为独立身份验证机制的连接。

### 多重身份验证要求是什么？

如果随 Tableau 身份验证一起启用了多重身份验证，站点的已连接客户端选项必须为启用状态，以允许 Bridge 客户端在无人值守的情况下运行，并且如果启用，则支持多重 Tableau 身份验证。如果为站点禁用了已连接客户端，则 Bridge 只能支持 Tableau 用户名和密码身份验证。

请参见[从连接的客户端中访问站点](https://help.tableau.com/current/online/zh-cn/to_connected_clients.htm#bridge)。

## 连接

### Bridge 支持哪些连接类型？

**数据提取连接**：当数据源或虚拟连接使用数据提取时，若要连接到私有网络数据时，可以使用 Bridge 来执行这些数据提取的计划刷新。请参见[针对数据提取连接的额外要求](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#conn_extract)。

**实时连接**：Bridge 支持数据源或虚拟连接与专用网络的实时连接。如果内容所有者发布的数据源或虚拟连接使用实时连接来连接到 Tableau Cloud 检测到它无法直接访问的数据，则会使用实时查询来使内容保持最新。请参见[针对实时连接的额外要求](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#conn_live)。

Bridge 可以支持的数据类型属于以下类别之一：

- 关系数据
- 文件数据，包括 Excel、文本和统计 (.sas7bdat) 文件。
- 私有云数据，包括 Amazon Redshift、Teradata 和 Snowflake。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。
- （有限）JDBC 数据
- （有限）ODBC 数据
- Web 数据连接器 2.0 SDK。请参见[使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm)。
- 当 Bridge 支持所有连接器时，多连接数据源中使用的数据（即包含跨数据库联接的数据源）。有关详细信息，请参见 Tableau 知识库中的[在 Tableau Bridge 上刷新跨数据库联接的数据源](https://kb.tableau.com/articles/HowTo/refreshing-federated-multi-connection-data-sources-on-tableau-bridge?lang=zh-cn)。

### Bridge 不支持哪些连接类型？

不支持的连接器：

- Microsoft Analysis Services
- Microsoft PowerPivot
- Oracle Essbase
- SAP NetWeaver Business Warehouse
- 选择使用 [Tableau 连接器 SDK](https://tableau.github.io/connector-plugin-sdk/docs/)构建的连接器 (.taco) 和通过 [Tableau Exchange](https://exchange.tableau.com/connectors) 获得的连接器。请参见[连接器和数据类型](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#Connecto)。

不支持的连接类型:

- 与基于文件的数据（excel、.csv 等）的实时连接
- 与 Google Cloud SQL、OData、Progress OpenEdge 和 Tableau 数据提取的实时连接
- 与基于多维数据集的数据的所有连接
- 与虚拟连接一起使用时的 Snowflake

### 是否可以将 Bridge 设置为连续运行？

(Windows) Bridge 可以在两种不同的模式下运行：应用程序模式和服务模式。Tableau 建议您在服务模式下运行 Bridge。如果客户端设置为在“服务”模式下运行，则无需登录到运行客户端的计算机，但您的计算机必须处于打开状态。默认情况下，客户端作为应用程序运行。这意味着 Windows 用户必须登录到运行客户端的计算机，以便完成计划的刷新。登录后，Bridge 客户端将从系统托盘中打开。

(Linux) Linux 版 Bridge 在 Linux 的后台运行，相当于 Windows 版 Tableau Bridge 中的服务模式。

请参见[应用程序模式与服务模式](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#application--versus-service-mode)。

### 我是否可以连接到工作簿中嵌入的数据源？

是的。Tableau Bridge 支持使用嵌入式数据源将工作簿直接发布到 Tableau Cloud。

## 负载平衡和池化

### 如何使用 Bridge 对数据刷新进行负载平衡？

您可以配置一个池，以便在可用的 Bridge 客户端之间分配数据刷新任务。池映射到域，从而允许您通过限制对私有网络中受保护域的访问，将池专用于使特定数据保持最新和维护安全。

请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。

## 扩展和部署

### 我如何使用 Bridge 进行扩展？

作为起点，我们建议最初配置至少两个 Tableau Bridge 客户端以实现冗余，并且在许多 Bridge 部署中，需要多个 Bridg e客户端来支持数据更新需求。

Bridge 默认支持最多 10 个并发已发布数据源数据提取刷新。此值可以根据您的工作负载和硬件要求进行更改。请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm)。确定在可用时间期限内需要多少数据已发布数据源数据提取。在许多情况下，有几个集中的时间段必须进行提取。您需要足够的 Bridge 客户端来完成此时间期限所需的所有数据提取刷新。举例来说，如果您要运行 7 小时的数据提取刷新，并在 4 小时的期限中运行它们，那么使用 2 个 Bridge 客户端将是一个合理的数量。

Bridge 支持每个客户端 16 个实时查询。确定并发用户的数量。站点管理员可以使用 Tableau Cloud 中的内置管理视图监控实时连接的数据源流量。这提供了一个高级视图，显示了具有实时连接的特定数据源被访问的频率。

作为试点和推广的一部分，您应该监控一段时间内的使用情况。

请参见[计划 Bridge 部署](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm)。

## 监视

### 如何监控 Bridge？

您可以使用[到 Bridge 连接数据源的流量](https://help.tableau.com/current/online/zh-cn/adminview_bridge_datasources.htm)管理视图，以查看具有实时连接的数据源的使用情况。此视图可帮助您确定使用量最大的数据源以及较少使用的数据源。

[“Bridge 数据提取”](https://help.tableau.com/current/online/zh-cn/adminview_bridge_extract.htm)管理视图捕获 Tableau Bridge 最近 30 天进行的刷新活动。只有已由 Bridge 客户端成功启动的作业才会在“Bridge 数据提取”管理视图中有记录。

在“作业”页面上，您可以将鼠标悬停在正在进行或已完成的计划作业上，以查看有关用于该作业的 Bridge 客户端和池的信息。

有关 Tableau Bridge 作业的事件信息也将显示在活动日志中。请参见“活动日志站点事件类型参考”主题中的[bridge\_job](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#bridge-job)。

<!-- document id=e9f3ff503d8d39efef0f830dda9f09c8538e89d5b451d886de23c72a02e8e59d url=/tableau/next/zh-cn/online/cloud_manager_capacity_metrics.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud Manager 中的容量指标

Tableau Cloud Manager (TCM) 中的容量指标使云管理员能够了解站点容量资源随着时间的推移是如何消耗的。它们可以帮助您识别站点何时接近其极限，了解高使用率是常规模式还是孤立事件，并决定是否需要重新分配容量。

您可以在 TCM 中的两个位置查看和监控容量指标：

- **“容量”页面：**显示租户上所有站点过去 24 小时的消耗情况数据。
- **“容量指标”页面：**显示特定站点过去 24 小时和 48 小时的更详细趋势数据，包括其他并发指标。

## “容量”页面上的容量指标

“容量”页面显示租户上所有站点的资源分配和消耗情况的概略视图。显示的数据反映过去 24 小时的情况。

“容量”页面上的容量管理仪表板显示分配给每个站点的可用容量以及当前消耗的容量。每个站点行显示使用量值及其针对每个容量类型的配置限制。当消耗量达到 Tableau 定义的阈值时，消耗量会用黄色或橙色指示符突出显示。

有关这些指示符的详细信息，请参见下面的[警告、严重和错误指示符](#indicators)部分。

## “容量指标”页面上的容量指标

“容量指标”页面显示特定站点过去 24 小时和 48 小时的更详细消耗数据。这个额外的时间段有助于区分孤立的峰值和潜在的趋势。

若要访问“容量指标”页面，请执行以下操作：

1. 以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
2. 在左侧导航窗格中，转至“容量”页面。
3. 在容量管理仪表板中，单击要查看其指标的站点。
    
    ![TCM 中的“容量指标”页面的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_homepage_metrics.png)

**注意：**您可以使用各种管理工具和活动日志以及容量指标数据，将站点上的特定活动与站点容量的总体消耗相关联。此类信息可用于数据提取并发、订阅并发和流程并发。

根据容量类型，可以使用以下指标。

### 并发容量指标

并发容量指标适用于后台作业：数据提取刷新并发、订阅并发和流程并发。它们衡量站点的并发作业容量得到充分利用的持续时间。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量指标</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">描述</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">表示的含义</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">最大持续并发</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">一小时内并发容量得到充分利用的最高时间百分比。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">突出显示峰值消耗或容量不足。<p><b>重要信息：</b>最大持续并发值大于 0% 表示在某个时间点已达到最大并发容量。较高的百分比意味着最大消耗持续发生，这可能会影响任务完成时间和向用户提供最新数据。</p><p><b>示例</b><br>假设您的站点有 500 个订阅作业设置为在星期一上午 9 点运行。由于所有 500 个订阅会同时发送运行，因此达到了最大并发。每个订阅发送后，都会有一个新订阅替换它，使并发限制连续 30 分钟保持完全占用状态。30 分钟后，最大并发不再被占用，订阅的其余部分将完成。当您检查订阅的容量指标时，您会看到容量指标为 50%，因为在给定的每小时时段内，60 分钟内有 30 分钟订阅并发被完全利用。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">持续并发中值</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-BodyB-Column1-Body1" style="font-weight: bold;">平均持续并发</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">一小时内并发容量被完全利用的时间百分比的平均值。</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">对异常值敏感；反映系统的总体负载趋势。与中位数进行比较，以确定峰值是否使平均值偏斜。</td></tr></tbody></table>

### 使用情况指标

使用情况容量指标适用于速率受限的容量类型：数据提取 API、发布 API 和 VizQL Data Service (VDS) API。它们衡量您每小时 API 调用限额的已使用量。

在基于容量的许可证模型下，使用情况容量指标包括可视化项（包括 VDS API 调用）和 Pulse 摘要。可视化项容量指标衡量您每小时调用限额的已使用量。Pulse 摘要容量指标衡量您每天调用限额的已使用量。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量指标</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">描述</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">表示的含义</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><b>最大容量使用量</b></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">一小时内使用的最高容量百分比。</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">突出显示高调用率或容量不足。较高的值可能表示调用有失败的风险。</td></tr></tbody></table>

## 警告、严重和错误指示符

“容量”和“容量指标”页面使用突出显示来帮助您快速确定哪些站点和容量需要关注。触发指示符的阈值范围因并发和使用容量类型而异。

**注意：**“容量”页面上的警告、严重和错误指示符涵盖过去 24 小时。“容量指标”页面上的指示符仅显示在“过去 24 小时”容量指标卡上，而不显示在“过去 48 小时”容量指标卡上。

### 黄色指示符 - 警告

![黄色（警告）指示符的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_indicator_yellow.png)

- **并发容量类型：**当站点某种容量类型的使用量达到持续饱和状态的 50%-75% 时，会显示黄色（警告）指示符。这是站点承受显著负载的早期迹象。
- **使用容量类型：**当站点某种容量类型的消耗达到其分配限制的 85%-99% 时，将显示黄色（警告）指示符。这是站点正在进行大量调用并接近速率限制的早期迹象。

当您看到这些指示符时，请考虑查看下面的[当您看到警告、严重或错误指示符时](#indicators_next_steps)部分。

### 橙色指示符 - 严重

![橙色（严重）指示符的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_indicator_orange.png)

- **并发容量类型：**当站点某种容量类型的使用量达到持续饱和状态的 76%-100% 时，会显示橙色（严重）指示符。在此级别，后台作业中可能会出现相应的延迟，并且用户接收过时数据的风险很高。
- **使用容量类型：**当站点的消耗达到其分配限制的 100% 时，会显示橙色（严重）指示符。这意味着该站点已完全耗尽其该类型的可用容量。发生这种情况时，调用可能会延迟或失败，从而对用户造成中断。

当您看到这些指示符时，我们强烈建议您查看下面的[当您看到警告、严重或错误指示符时](#indicators_next_steps)部分。

### 红色指示符 - 错误

![红色（错误）指示符的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_indicator_red.png)

- **所有容量类型：**当站点限制总数超过租户的限制时，将显示红色（错误）指示符。当 Creator 许可证数量发生更改并导致合规性问题时，可能会发生这种情况。应立即通过重新分配容量来解决此问题。有关详细信息，请参见[“减少站点限制”消息](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#troubleshoot_reduce_limits)。

### 当您看到警告、严重或错误指示符时

当您在容量管理仪表板中看到黄色、橙色或红色突出显示时，请检查“建议”列。

具有“查看站点限制”的站点是容量重新分配的候选项。重新分配容量时，请考虑以下事项：

- 单击站点名称打开“容量指标”页面以获得更详细的视图。
- 对于特定站点，单击“操作”菜单并选择“自定义站点限制”。有关详细信息，请参见[Tableau Cloud Manager 中管理的容量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#allocate)。

对于具有“减少站点限制”的站点，其突出显示的容量限制应相应减少。有关详细信息，请参见[Tableau Cloud Manager 中管理的容量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#reduce_limits)。若要减少容量限制，请参见[Tableau Cloud Manager 中管理的容量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#allocate)。

<!-- document id=e491ad48b6b0a442db75d0c59dcd953b11957d13c35afa04c24b528442b988d3 url=/tableau/next/zh-cn/online/cloud_manager_capacity.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud Manager 中管理的容量

容量管理是 Tableau Cloud Manager (TCM) 的“容量”页面上显示的功能集合。TCM 中的容量管理使云管理员能够更好地查看和控制租户上站点之间的资源分配方式。

![TCM 的“容量”页面的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_homepage.png)

从 2026 年 5 月 (Tableau 2026.1) 开始，容量是固定站点限制和可在租户级别配置的站点限制的组合。某些容量被整合到租户级别限制（称为云限制）中，形成一个共享容量池。作为云管理员，您可以从此池中提取容量以将容量分配给最需要它的站点。

以下容量类型可通过 TCM 进行管理：

- [数据提取并发](#extracts)
- [数据提取 API](#extract_apis)
- [订阅并发](#subscriptions)
- [发布 API](#publish_apis)
- [流程并发](#flows)
- [VizQL Data Service API](#vds_apis)
- [可视化项](#visualizations)（如果使用基于容量的模型获得许可）
- [Pulse 摘要](#pulse_digests)（如果使用基于容量的模型获得许可）

**注意：**

- 随着我们基础设施的发展，您可以在 TCM 中管理的容量类型可能会发生变化。
- 容量可以通过 Tableau Cloud 版本、Creator 许可证数量来增加；或通过为 Viewer（查看者）启用基于容量的许可证模型来增加。

本主题介绍可配置的租户级别容量，这些容量可以使用 TCM 在租户上跨站点分配。有关具有固定限制的容量、针对这些限制的优化以及故障排除建议，请参见[在站点设置的容量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm)。

### 在 TCM 中管理容量的好处

TCM 中的容量管理具有以下好处：

- **主动可见性。**查看租户级别和站点容量限制。当站点接近或达到限制时，使用消耗数据和亮点及时采取行动，以减少对用户的影响。
- **重新分配资源的灵活性。**根据使用情况和业务需求在站点之间移动租户级容量。
- **集中管理。**在 TCM 中管理租户级别的分配。您无需是特定站点上的站点管理员即可查看或调整容量。
- **支持增长。**为新站点、季节性高峰或其他需求高峰期预留容量。

## TCM 中的容量

“容量”页面显示三类信息：

- **云限制：**云限制是租户上站点的容量池。容量值表示可用最大容量。
- **默认站点限制：**默认站点限制是分配给所有新站点和限制尚未自定义的站点的容量。
- **资源分配和使用：**用于监控租户上各站点的资源分配和消耗的仪表板。消耗量由并发使用量或速率限制使用量表示，具体取决于容量类型，当限制达到特定阈值时，由可视指示器突出显示。有关详细信息，请参见[Tableau Cloud Manager 中的容量指标](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_metrics.htm)。

**注意：**TCM 中的速率限制使用容量是按小时测量的，但 Pulse 摘要（如果可用）除外，它是按天测量的。

### 数据提取并发

租户具有用于数据提取刷新作业的指定容量。数据提取容量是租户上的站点一次可以运行的并发数据提取刷新作业数。

根据可用的系统资源，等待时间（即作业开始之前的时间）会调整为在计划的开始时间后 15 分钟或更短的时间内启动作业。

计入数据提取容量的作业包括：

- 计划刷新
- 手动刷新
- 数据提取创建
- 触发刷新的某些命令行或 API 调用，包括增量追加数据

有关数据提取刷新作业运行时和内存大小限制，请参见[数据提取 - 每日、运行时和内存使用量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#extracts)。

**注意：**Tableau Bridge 对嵌入式数据提取和虚拟连接的刷新操作会影响站点的数据提取并发容量。有关 Tableau Bridge 会影响哪些容量类型的详细信息，请参见[Bridge 站点容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_site_capacity.htm)

### 数据提取 API

租户具有用于数据提取刷新 API 调用的指定容量。数据提取 API 容量是指一小时内可以在站点上进行的调用次数。

计入数据提取 API 容量的调用包括：

- **Tableau REST API：**[运行数据提取刷新任务](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#run_extract_refresh_task)、[立即更新数据源](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_data_source_now)和[立即更新工作簿](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#update_workbook_now)
- **tabcmd：**[refreshextracts](https://help.tableau.com/current/online/zh-cn/tabcmd_cmd.htm#refreshextracts-workbookname-or-datasourcename)
- [Tableau 客户端 (Python) 库](https://tableau.github.io/server-client-python/docs/)**：**用于启动数据提取刷新作业的调用

**注意：**如果调用数超过上述的 API 或命令行调用容量，您会看到以下错误之一：_Unknown 429（未知 429）_或 _ApiCallError: 429000: Too Many Requests – Too many requests for <job type> ‘api.rest.refresh\_extracts’.Please retry after 146 second(s)_.（ApiCallError：429000：请求太多 - 对 <作业类型>“api.rest.refresh\_extracts”的请求太多。请在 146 秒后重试）。

### 订阅并发

租户具有用于订阅作业的指定容量。订阅容量是站点一次可以运行的并发订阅作业数。

根据可用的系统资源，等待时间（即作业开始之前的时间）会调整为在计划的开始时间后 15 分钟或更短的时间内启动作业。

计入订阅容量的作业包括直接依据通过 Tableau Cloud 创建的订阅生成电子邮件，或生成电子邮件订阅的 API 调用。

有关订阅作业运行时间和电子邮件大小限制，请参见[订阅 - 运行时间和电子邮件大小](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#subscriptions)。

### 发布 API

租户具有用于发布 API 调用以启动发布和更新作业的指定容量。

计入发布 API 容量的调用包括：

- **Tableau REST API：**[发布工作簿](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#publish_workbook)、[发布数据源](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#publish_data_source)、[更新工作簿](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_workbook)、[更新数据源](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_data_source)、[Tableau Prep 流程运行](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_flow.htm)
- **tabcmd：**[publish](https://help.tableau.com/current/online/zh-cn/tabcmd_cmd.htm#publish-filenametwbx-filenametdsx-or-filenamehyper)
- [Tableau 客户端 (Python) 库](https://tableau.github.io/server-client-python/docs/)：启动工作簿和数据源的发布或更新作业的调用

### 流程并发

流程容量以资源块为单位进行度量。每个资源块表示一次可以运行的并发流程作业数。

站点的默认容量为 1 个并发流程作业，相当于拥有一个资源块。

如果流程作业启动时没有可用的资源块，则作业进入队列以等待资源块可用。即使有可用的资源块，流程作业也可能在繁忙时段进入队列，以确保您系统资源保持可用以支持整个 Tableau Cloud 中的流程作业。

**注意：**

- TCM 中的容量管理显示并发使用情况和可配置限制。流程并发使用情况容量包括站点上的_所有_流程作业（既包括站点的默认资源块，也包括为租户购买的资源块）。但是，附加流程并发限制仅包括购买的资源块以及可在站点之间移动的容量。
- 在 TCM 中，站点的默认资源块无法在站点之间查看或移动。

有关用户请求率、流程作业运行时间和内存使用限制，请参见[流程 - 用户请求、每日、运行时和内存使用量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#flows)。

### VizQL Data Service API

租户具有对 [VizQL Data Service (VDS) API](https://help.tableau.com/current/api/vizql-data-service/zh-cn/index.html) 进行调用的指定容量。VDS API 容量是指每小时可以在站点上进行的 VDS API 调用次数。

**注意：**

- 如果您的组织使用基于使用情况的许可 (UBL)，此容量将不会出现在 TCM 中。这是因为您的帐户是按使用情况进行管理的，而不是按可配置的容量限制进行管理的。
- 如果您的组织使用基于容量的许可，则 VDS API 容量由可视化项容量确定。

### 可视化项

TCM 中的可视化容量可通过基于容量的许可证模型获得，是指每小时可在站点上运行的租户范围请求数，这些请求用于加载仪表板和视图、刷新视图数据、调用 [VizQL Data Service (VDS) API](https://help.tableau.com/current/api/vizql-data-service/zh-cn/index.html)，浏览 Pulse 指标，并调用 [Pulse API](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_pulse.htm)。

**注意：**

- 虽然基于容量的许可模型在您的站点中提供了灵活的租户范围请求池，但每个用户仍然面临每小时 600 个请求。用户请求率在站点级别是固定的，无法在 TCM 中配置。
- 如果尚未启用基于容量的许可证模型，则可视化项容量在站点级别是固定的，无法在 TCM 中配置。有关详细信息，请参见[可视化项 - 加载时间、超时、请求率、内存使用情况](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#visualizations)。
- 如果尚未启用基于容量的许可证模型，则会将 VDS API 容量作为独立容量类型进行跟踪。有关详细信息，请参见[VizQL Data Service API](#vds_apis)。

### Pulse 摘要

TCM 中的 Pulse 摘要容量可通过基于容量的许可证模型获得，是指 24 小时内可以在站点上生成和发送的计划摘要的数量。

**注意：**Pulse 摘要在基于角色的使用模型中没有容量限制。

## 管理容量

单击下面的下拉箭头按钮展开每个部分。

### 容量管理带来的变化

单击下拉箭头按钮展开该部分，查看 TCM 中容量管理带来的变化。

#### 站点分配更改

在容量管理之前，站点有一组固定的容量限制。

从 2026 年 5 月 (Tableau 2026.1) 开始，某些容量限制将整合到租户级别限制（也称为云限制）中，使云管理员可以灵活地在租户上的站点之间分配容量，或将容量保留至现有或新站点需要时使用。

#### 数据提取并发更改

在容量管理之前，对于使用 Advanced Management 加载项或通过 Tableau+ 或 Enterprise 版获得许可的站点，创建时拥有的并发数据提取刷新次数为 25 次。

从 2026 年 5 月 (Tableau 2026.1) 开始，所有新站点的预置默认限制为 10 次并发数据提取刷新。云管理员可以更改此默认值。

#### 流程并发更改

在容量管理之前，流程资源块会自动预配到站点。

从 2026 年 5 月 (Tableau 2026.1) 开始，流程资源块将在租户级别分配。云管理员可以将购买的资源块分配到需要它们的站点。

**注意：**

- “容量”页面仅允许可配置已购买的资源块限制。
- 每个站点都会收到一个资源块，该资源块无法移动到租户上的其他站点。

#### 许可模式添加

若要增加 Tableau Cloud 的容量，您可以启用 2026 年 7 月 (Tableau 2026.2) 中引入的基于容量的许可证模型。基于容量的许可证模型“基于容量的 Viewer 块”替换了以下容量类型的版本默认容量：数据提取、数据提取 API、发布 API 和订阅。在新模型下，您还可以获得用于计划的 Pulse 摘要的容量和额外的可视化项容量。

<table style="width: 100%;margin-left: 0;margin-right: auto;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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">容量类型</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">基于使用情况</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">基于容量</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>Standard：</b>每个租户最多 15 个并发作业</p><p><b>Enterprise：</b>每个租户最多 25 个并发作业，每 10 个 Creator 许可证额外增加 1 个作业</p><p><b>Cloud+、Tableau+：</b>每个租户最多 50 个作业，每 5 个 Creator 许可证额外增加 1 个作业</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">每个租户 15 个并发作业</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取 API</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>Standard：</b>每小时 120 次调用</p><p><b>Enterprise：</b>每个租户每小时 240 次调用，每个 Creator 许可证额外增加 1 次调用</p><p><b>Cloud+、Tableau+：</b>每个租户每小时 480 次调用，每 1 个 Creator 许可证额外增加 2 次调用</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">每个租户每小时 1,000 次调用</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">流程</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>Standard：</b>每个站点 1 个资源块</p><p><b>Enterprise、 Cloud+、Tableau+：</b>取决于每个租户购买的资源块</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">不适用</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">发布 API</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>Standard：</b>每个租户每小时 800 次调用</p><p><b>Enterprise：</b>每个租户每小时 1200 次调用，每 2 个 Creator 许可证额外增加 1 次调用</p><p><b>Cloud+、Tableau+：</b>每个租户每小时 2,400 次调用，每 1 个 Creator 许可证额外增加 1 次调用</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">每个租户每小时 1,000 次调用</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">Pulse 摘要</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不适用</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">每个租户每天 1,000 次调用</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">订阅</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>Standard：</b>每个租户最多 20 个并发作业</p><p><b>Enterprise</b>每个租户最多 25 个并发作业，每 10 个 Creator 许可证额外增加 1 个作业</p><p><b>Cloud+、Tableau+：</b>每个租户最多 50 个并发作业，每 5 个 Creator 许可证额外增加 1 个并发作业</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">每个租户 25 个并发作业</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">可视化项</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>每个站点每个用户每小时最多 600 次调用</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>每个站点每个用户最多 600 次调用</p><p>每个租户每小时 300 次调用</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">VizQL Data Service API</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">每个租户每 1 个 Creator 许可证每小时 100 次调用</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">不适用</td></tr></tbody></table>

### 常见问题解答 (FAQ)

单击下拉箭头展开该部分并查看容量管理常见问题。

#### 站点限制是否仍然存在？

是的，“容量”页面上显示的容量在租户级别进行管理。这意味着，站点限制永远无法超过租户的可用容量。“容量”页面上未显示的容量仍然是特定于站点的容量，不能重新分配到租户上的其他站点。

#### 我可以管理哪些容量？

您可以在 TCM 中管理以下容量：

- 数据提取并发
- 订阅并发
- 数据提取 API 调用
- 流程并发
- 发布 API 调用
- VizQL Data Service 调用
- 可视化项（如果使用基于容量的模型获得许可）
- Pulse 摘要（如果使用基于容量的模型获得许可）

#### 我可以在“容量”页面上执行什么操作？

- 查看租户的容量限额
- 查看分配给租户上的站点的容量
- 管理和重新分配租户上站点之间的限制
- 访问有关租户上各个站点的容量使用情况的见解和建议

#### 是否可以将容量分配给我不是站点管理员的站点？

是的，容量分配是在 Tableau Cloud Manager (TCM) 中的租户级别处理的。您必须是云管理员才能查看和分配租户上任何站点的容量，无论您是否是特定站点的站点管理员。

#### 如何确定限值？

容量限额根据您的 Tableau 版本和 Creator 许可证数量计算。从 2026 年 7 月开始，容量限额也可以根据基于容量的许可证模型计算。

#### 如果我没有足够的容量来创建新站点，会发生什么情况？

如果没有足够的容量使用您定义的默认站点限制创建新站点，则将使用 Tableau 定义的最小容量限制创建该站点。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>容量类型</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>最小容量限制</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取 API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">订阅并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">发布 API&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">流程并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">VizQL Data Service API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">可视化项（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">10</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Pulse 摘要（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">0</td></tr></tbody></table>

如果租户没有足够的最小容量，您将看到站点创建错误。有关详细信息，请参见下面的[容量管理疑难解答](#troubleshoot)部分。

#### 超出可视化项容量时会发生什么情况？

当站点超过其可视化项容量时，TCM 中将显示指标，在使用量超过警告和严重阈值时通知您。

此外，所有云管理员都将在达到特定阈值时收到电子邮件通知，告知他们自己的限制。对于每个站点，每达到一项阈值上限，您每小时最多只会收到一封相关通知邮件。

指标与电子邮件通知二者的设计初衷，都是为了让用户能够主动、清晰地掌握容量超额的具体程度。这些通知旨在帮助云管理员监控大量使用趋势，同时允许站点保持连续性和用户访问。

### 自定义站点限制

租户上的每个站点都分配有容量限制。您可以根据每个站点的容量需求重新分配或修改容量限制。

1. 以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
2. 在左侧中导航窗格中，转至“容量”页面。
3. 在“容量”页面上，单击“自定义站点限制”按钮。
4. 在特定站点的容量类型下，输入新的容量限制，或者单击向上或向下箭头来调整容量限制。
    
    **注意：**您输入的值不能超过该特定容量类型的可用限制。

![TCM 的“容量”页面中的“自定义站点限制”配置页面的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_customize_limits.png)

### 更改默认容量限制

将为租户上创建的每个新站点分配默认容量限制。您可以修改这些限制。

**注意：**如果站点没有足够的默认容量，则使用最小容量创建新站点。如果没有最小容量，站点创建将失败并显示错误，直到云管理员通过从现有站点转移容量来提供容量。有关详细信息，请参见[添加、重命名、删除或激活站点](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_sites.htm)。

1. 以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
2. 在左侧中导航窗格中，转至“容量”页面。
3. 在“容量”页面上，单击“编辑默认站点限制”按钮。
4. 在容量类型下，输入新的容量限制。

![TCM 的“容量”页面中的“编辑默认站点限制”配置页面的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_default_limits.png)

## 监控容量管理

您可以使用[活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm)事件日志监视容量分配变化。例如，您可以查询以下事件类型：

- `[site_capacity_change](https://help.tableau.com/v0.0/online/zh-cn/activity_log_tenant_schema.htm#site-capacity-change)`
- `[site_capacity_default_change](https://help.tableau.com/v0.0/online/zh-cn/activity_log_tenant_schema.htm#site-capacity-default-change)`

## 容量管理疑难解答

使用本部分来帮助解决 TCM 中容量管理可能遇到的问题。

### 无法添加新站点

将站点添加到租户时，您会看到以下错误：

_“无法创建站点，因为没有可用容量。请编辑默认站点限制或自定义云限制，然后重试。”_

当没有足够的最小容量来创建新站点时，可能会出现此问题。租户上的每个站点都需要分配最小容量才能运行。若要解决此问题，请查看表格中的最低容量限制（由 Tableau 定义），并为新站点提供更多可用容量。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>容量类型</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>最小容量限制</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取 API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">订阅并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">发布 API&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">流程并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">VizQL Data Service API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">可视化项（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">10</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Pulse 摘要（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">0</td></tr></tbody></table>

若要腾出更多可用容量，请考虑从其他站点转移容量以腾出更多未分配容量。

1. 以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
2. 在左侧中导航窗格中，转至“容量”页面。
3. 在“容量”页面上，单击“自定义站点限制”按钮。
4. 确定具有您可腾出的容量的站点和容量类型。
5. 输入一个值或选择容量类型旁边的向下箭头按钮以减少容量限制。
6. 完成后，单击“保存”。

通过自定义容量限制腾出一些容量后，再次添加新站点。有关添加站点的详细信息，请参见[添加、重命名、删除或激活站点](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_sites.htm)。

### “减少站点限制”消息

当“容量”页面上的容量管理仪表板显示红色（错误）指示符，并且“建议”列显示“减少站点限制”消息时，站点限制总数超过了租户的限制，也称为云限制。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_troubleshoot_reduce_site_limits_message.png)

此问题的最常见原因是 Creator 许可证数量发生变化，应立即解决以避免合规性问题。若要解决此问题，您可以按照[Tableau Cloud Manager 中管理的容量](#customize)中所述的步骤重新分配容量，从而转移超出限制的站点的容量。

![“自定义站点限制”页面的图像，显示了容量不合规的多个站点。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_troubleshoot_reduce_limits.png)

**注意：**如果在自定义限制后，站点分配总额仍然超过租户的限制，系统会提示您将容量减少到其最小限制。接受最小限制后，您可以返回“自定义站点限制”页面，在可用的租户级别限制内调整站点的容量。

![“重置为最低站点限制”对话框的图像。](/tableau/next/zh-cn/online/zh-cn/Img/tcm_ccm_troubleshoot_reset_limits.png)

### 更新容量 API 错误

当您使用[更新容量](https://help.tableau.com/current/api/cloud-manager/zh-cn/reference/index.html#tag/Capacity-Methods/operation/updateCapacities) REST API 方法以编程方式重新分配限制时，如果请求尝试分配的容量超过可用容量或少于 Tableau 定义的最小限制，则可能会遇到更新失败情况。

该 API 可能会返回以下错误代码和消息：

- **207**
    - `errorCode: "POLICY_STORE_INVALID_SITE_LIMIT"`, `message: "Site limit for <siteId> <x> is below minimum <y>"`
    - `errorCode: "POLICY_STORE_SITES_LIMIT_OVERFLOW"`, `message: "Total site limits (<x>) exceeds cloud limit (<y>) for capacity: <capacity_name>"`
- **400**
    - `errorCode: "VALIDATION_ERROR"`, `message: "The following site IDs are suspended and cannot be updated: <siteId1>, <siteId2>, ...`

**若要解决 207 更新错误，请执行以下操作：**

1. 查看错误响应以确定哪些容量类型超出了限制。
2. 在进行 API 调用之前，在 TCM 的“容量”页面中验证可用租户级别限制。
3. 确保站点分配不超过租户的限制。

**若要解决 400 更新错误，请执行以下操作：**

- 确保更新活动站点的容量。不支持对处于暂停状态的站点进行容量更新。

### 电子邮件通知太多

您会收到许多“需要执行操作：可视化容量达到 150% 时超出了‘<站点名称>’的限制”电子邮件通知。

如果站点超过其可视化容量，则在使用量超过特定阈值限制时发送电子邮件通知。这些通知按站点、每个达到的阈值、每小时仅限发送一封电子邮件。如果您经常收到这些通知，请考虑在站点之间重新分配容量或购买额外的基于容量的 Viewer（查看者）块，以更好地支持您的可视化项使用。

若要重新分配容量，请参见[自定义站点限制](#custom)。若要购买基于容量的 Viewer（查看者）块，请联系您的 Tableau 客户经理（如果有）。

<!-- document id=bc5b90f70496b4d5028445d335b0c4fbde0ad881209dea35c182b65f7c1239d9 url=/tableau/next/zh-cn/online/cloud_manager_personal_access_tokens.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud Manager 的个人访问令牌

个人访问令牌 (PAT) 使您能够创建可长期使用的身份验证令牌。PAT 使您能够登录到 Tableau Cloud Manager (TCM) REST API，而无需硬编码凭据（用户名和密码）或交互式登录。有关详细信息，请参见 [Tableau Cloud Manager REST API](https://help.tableau.com/current/api/cloud-manager/zh-cn/index.html)。

> [!WARNING]
> 
> **重要信息：**TCM PAT 不能用于登录 Tableau REST API。若要对 Tableau REST API 进行身份验证，您必须使用 Tableau Cloud 中生成的 PAT。有关如何将 PAT 与 Tableau Cloud 结合使用的详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。

建议为使用 Tableau Cloud Manager REST API 创建的自动化脚本和任务创建 PAT：

- **提高安全性：**PAT 可在凭据泄露时降低风险。对于自动化任务，您可以使用个人访问令牌，而不是使用用户名和密码来减少凭据泄露的影响。如果 PAT 遭到破坏，或在出现故障或导致风险的自动化任务中使用，您只需撤销 PAT，而无需轮换或撤销用户的凭据。
- **管理自动化：**可以为运行的每个脚本或任务生成一个 PAT。这使您能够存储和查看整个组织中的自动化任务。此外，如果在使用 PAT 之后对用户帐户进行密码重置或元数据更改（用户名、电子邮件等），将不会像凭据硬编码在脚本中时一样中断自动化操作。

注意：

- 需要 PAT 才能向 Tableau Cloud Manager (TCM) 发出 Tableau Cloud Manager REST API 登录请求，并使用 Tableau 身份验证启用多重身份验证 (MFA)。
- 对于对 TCM 的通用客户端访问，不使用 PAT。
- 当 TCM 身份验证方法更改时，PAT 会自动撤销。
- 首次登录 Tableau Cloud Manager REST API 时，必须通过如下所述或 TCM REST API 帮助的[验证](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/authentication.html)中所述的过程，使用 TCM UI 创建 PAT。

## 了解个人访问令牌

创建个人访问令牌 (PAT) 之后，会对其进行哈希处理并存储在存储库中。对 PAT 进行哈希处理并存储后，PAT 密文会向用户显示一次，然后在用户关闭对话框后就无法再访问。因此，系统会指示用户将 PAT 复制到安全的位置，并像处理密码一样对其进行处理。

在运行时使用 PAT 时，Tableau Cloud Manager (TCM) 会将用户提供的 PAT与存储在存储库中的哈希值进行比较。如果匹配，则会启动经过身份验证的会话。在授权范围内，使用 PAT 进行身份验证的 TCM 会话具有与 PAT 所有者相同的访问权限和特权。

### 关于 PAT 过期

个人访问令牌 (PAT) 如果连续 15 天未使用，或根据创建 PAT 时选择的令牌过期值（以先到者为准），将会过期。

PAT 过期后，它们将无法用于身份验证，并会从云管理员的“我的帐户设置”页面中移除。

## 管理云管理员个人访问令牌的任务

### 创建 PAT

此过程要求您将密文复制到文件。该密文是您将包括在自动化脚本中的一个字符串，将用于向 Tableau Cloud Manager (TCM) 进行身份验证。像对待密码一样对待密文：保护密文并且不要与他人共享密文。

若要创建 PAT，请执行以下步骤：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在页面顶部，单击个人资料图片或姓名首字母缩写，然后选择“我的帐户设置”。
3. 在“个人访问令牌”下， 单击“创建令牌”。
4. 在“令牌名称”字段中输入令牌的描述性名称。
5. 选择令牌到期日期并单击“创建令牌”。
6. 在“个人访问令牌”对话框中，单击“复制密文”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pats_secret.png)
7. 将密文粘贴到一个文件，并将该文件存储在安全位置。
8. 完成后，单击“Done”（完成）。

**注意：**一个用户最多可以有 104 个 PAT。

### 撤销 PAT

云管理员可以按照以下步骤在“我的帐户设置”页面上撤销其 PAT：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在页面顶部，单击个人资料图片或姓名首字母缩写，然后选择“我的帐户设置”。
3. 在“个人访问令牌”部分下，标识要撤消的 PAT，然后单击“撤消令牌”。
4. 在“删除”对话框中，单击“删除”。

<!-- document id=c222fee1c85e715e07a28421d42b21e5ff6ee84f5ca565e1543c7267da8b4743 url=/tableau/next/zh-cn/online/cloud_manager_auth.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud Manager 身份验证

身份验证是指 TCM 云管理员如何登录 Tableau Cloud Manager (TCM) 以及首次登录后如何访问 TCM 的选项。身份验证将验证用户的身份。

TCM 支持您可以在**“设置”**页面上配置的多种身份验证类型。本主题中讨论的配置步骤仅限于 TCM，站点管理员单独配置站点身份验证。

## 支持的身份验证类型

Tableau Cloud Manager (TCM) 支持以下身份验证类型：

- **SSO：**如果在 TCM 上启用外部身份验证，则可以选择想要使用外部凭据登录的用户以及想要使用 Tableau 凭据的用户。可以在 TCM 上允许使用 带有 MFA 的 Tableau 和一个外部提供程序，但每个用户必须设置为使用其中一种类型。您可以在“用户”页面上配置用户身份验证选项。有关详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。
    
    - **Google：**如果您的组织使用 Google 应用程序，则您可以启用 TCM 以使用 Google 帐户通过 OpenID Connect (OIDC) 进行使用 MFA 的单点登录 (SSO)。当您启用 Google 身份验证时，系统会将用户定向到 Google 登录页面，以便输入使用 Google 存储的凭据。
    - **OpenID 连接 (OIDC)：**您可以通过通用 OIDC 启用 SSO。为此，您可以使用带有 MFA 的第三方身份提供程序 (IdP)，并将站点配置为与 IdP 建立信任关系。当您启用 OIDC 时，用户被定向到 IdP 登录页面，他们将在此页面中输入已通过 IdP 存储的 SSO 凭据。**注意：**为 TCM 启用 OIDC 身份验证需要从 Tableau Cloud 进行单独设置和应用程序集成。
    - **Salesforce：**如果您的组织使用 Salesforce，则您可以启用 TCM 以使用 Salesforce 帐户通过 OpenID Connect (OIDC) 进行使用 MFA 的单点登录 (SSO)。当您启用 Salesforce 身份验证时，系统会将用户定向到 Salesforce 登录页面，以便输入在 Salesforce 中存储和管理的凭据。
    - **安全断言标记语言 (SAML)：**最后，使用 SSO 的另一种方法是通过 SAML。为此，您可以使用带有 MFA 的第三方身份提供程序 (IdP)，并将站点配置为与 IdP 建立信任关系。当您启用 SAML 时，用户被定向到 IdP 登录页面，他们将在此页面中输入已通过 IdP 存储的 SSO 凭据。**注意：**为 TCM 启用 SAML 身份验证需要从 Tableau Cloud 进行单独设置和应用程序集成。
- **带有 MFA 的 Tableau：**内置的默认身份验证类型。它要求用户提供他们的 Tableau ID（与 TCM 一起存储的用户名和密码）和 MFA 验证方法，如验证器应用程序或安全密钥，以确认用户的身份。有关支持的 MFA 方法的详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。

> [!IMPORTANT]
> 
> **重要信息：**除了上述身份验证要求之外，我们建议您专门指定一个始终为**“带有 MFA 的 Tableau”**身份验证配置的云管理员帐户。如果遇到问题，专门的**带有 MFA 的 Tableau** 帐户可确保您能够访问 TCM。

## 身份验证要求

无论您配置哪种身份验证类型，多重身份验证 (MFA) 都是访问 TCM 时的默认和强制身份验证方法。MFA 确保用户提供除其主要凭证之外的额外验证方法，从而显著增强登录安全性并保护组织的数据。

### 实施 MFA

多重身份验证 (MFA) 是一个多步骤登录过程，要求用户提供除密码以外的其他信息才能访问他们的帐户。可以通过以下两种方式之一来实施 MFA：

- **单点登录 (SSO) 和 MFA（推荐方法）：**为了满足 MFA 要求，请通过 Google、OIDC、Salesforce 或 SAML 身份提供程序 (IdP) 启用 MFA。
- **带有 MFA 的 Tableau（替代方法）：**如果您不直接使用 SSO IdP，则可以启用 1) 带有 MFA 的 Tableau 凭据（与 Tableau 一起存储）和 2) 其他验证方法的组合，然后云管理员才能访问 TCM。我们还建议用户设置恢复代码作为仅在紧急情况下的备份验证方法。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。

### 步骤 1：为 Tableau Cloud Manager 配置身份验证

若要在 Tableau Cloud Manager (TCM) 中配置身份验证，请按照以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航到“设置”页面。
3. 在“身份验证类型”下， 选择“启用其他身份验证方法”。
4. 从下拉菜单中，选择您喜欢的身份验证类型。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_auth_type.png)
5. 单击“保存更改”。

### 步骤 2：为云管理员分配身份验证

配置TCM认证后，您可以在“用户”页面为云管理员分配身份验证方法。有关更改其他用户详细信息的详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

若要分配身份验证，请执行以下步骤：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航至“用户” 页面并选择要修改的用户。
    
    **注意：**您一次最多可以选择 50 个用户。若要修改超过 50 个用户，请导入包含所需更改的 CSV 文件。有关批量修改用户的详细信息，请参见[批量导入用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm#bulk-import-users)。
3. 选择“操作”\>“站点成员身份”。
4. 从“Tableau Cloud Manager 的身份验证”下拉菜单中选择一种身份验证方法。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_auth_admin.png)
    
    **注意：**如果已为 TCM 身份验证配置了除带 MFA 的 Tableau 之外的身份验证类型，则 TCM 在添加新 Tableau Cloud 管理员时将默认使用非默认身份验证类型。可以随时通过上图所示的“站点成员身份”对话框中的“Tableau Cloud Manager 的身份验证”下拉菜单更改此设置。
5. 单击“保存”。

## 管理带有 MFA 的 Tableau

作为 TCM 云管理员，您可以在 TCM 中管理带有 MFA 的 Tableau 验证方法，并为租户内各站点的其他云管理员和用户重置带有 MFA 的 Tableau 验证方法。

### 管理您的验证方法

您可以从“我的帐户设置”页面管理带有 MFA 的 Tableau 验证方法。单击“管理 MFA 验证方法”链接后，您可以添加或移除其他验证方法，包括添加恢复码。

**重要信息：**我们强烈建议您注册“恢复码”选项以帮助避免被锁定在您的租户之外。恢复码应仅在紧急情况下使用。

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在页面的右上角，单击个人资料，并选择“我的帐户设置”。
3. 在“帐户”下，单击“管理 MFA 验证方法”。

![弯曲的箭头指向验证方法列表。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_manage_methods_tcm.png)

### 重置验证方法

作为云管理员，您对租户上各个站点的用户负责。作为管理功能的一部分，您可以为租户上的其他云管理员、站点管理员和站点用户重置 MFA 验证方法。

如果用户被锁定在租户或站点之外，请重置其带有 MFA 的 Tableau 验证方法，以恢复其对站点或租户的访问权限。查看下表以确定后续步骤。

<table style="width: 100%;margin-left: 0;margin-right: auto;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"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">您的角色</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">目标用户</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">目标成员身份</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">是否可重置 MFA？</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">原因或后续步骤</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="4">TCM 云管理员</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">TCM 云管理员</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">同一租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">从 TCM 的<span class="uicontrol">“用户”</span>页面重置验证方法。有关详细信息，请参见下面的<a href="#reset-mfa-users" class="xref">重置租户上用户的验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不同租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">出于安全考虑，云管理员无法重置多租户用户的验证方法。有关详细信息，请参见<a href="#reset-mfa-multi-tenant-users" class="xref">关于为多个租户上的用户重置验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">站点管理员或站点用户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个或多个站点，同一租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>从 TCM 的<span class="uicontrol">“用户”</span>页面重置验证方法。有关详细信息，请参见下面的<a href="#reset-mfa-users" class="xref">重置租户上用户的验证方法</a>。</p><p><b>注意：</b>如果重置同时也是云管理员的站点级别用户的验证方法，此过程将为其所属站点和 TCM 重置带有 MFA 的 Tableau 验证方法。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">多个站点，不同租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">出于安全考虑，云管理员无法重置多租户用户的验证方法。有关详细信息，请参见<a href="#reset-mfa-multi-tenant-users" class="xref">关于为多个租户上的用户重置验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">租户上唯一的 TCM 云管理员</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">您自己</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">单个租户</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">与 Tableau 支持部门联系。若要联系 Tableau 支持，请按照<a href="https://help.salesforce.com/s/articleView?id=000393090&amp;type=1" target="_blank">如何在 Salesforce 帮助中创建个案</a>知识文章中描述的步骤进行操作。</td></tr></tbody></table>

#### 重置租户上用户的验证方法

您可以从 TCM 中的“用户”页面重置带有 MFA 的 Tableau 与 Tableau 验证方法，以使云管理员、站点管理员或站点用户能够重新获得对租户上 TCM 或站点的访问权限。

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 转到“用户”页面并导航到需要重新访问 TCM 或站点的用户。
3. 从“操作”菜单中，选择“重置 MFA 验证程序”。
4. 在“重置 MFA 验证程序”对话框中，单击“重置 MFA 验证程序”按钮。
    
    **注意：**
    
    - 提醒一下，仅当满足以下_任一_条件时，重置验证方法的选项才可用：
        
        - 用户属于同一 TCM 租户下的一个或多个站点。
        - 云管理员只属于一个 TCM 租户。
    - 如果重置同时也是云管理员的站点级别用户的验证方法，此过程将为其所属站点和 TCM 重置带有 MFA 的 Tableau 验证方法。

#### 关于为多个租户上的用户重置验证方法

作为安全最佳实践，您必须联系 Tableau 支持部门，为属于多个租户的云管理员或属于跨多个租户站点的用户重置 MFA 与 Tableau 验证方法。

若要联系 Tableau 支持，请按照[如何在 Salesforce 帮助中创建个案](https://help.salesforce.com/s/articleView?id=000393090&type=1)知识文章中描述的步骤进行操作。

## 为 Tableau Cloud 站点配置身份验证

站点身份验证只能由站点管理员直接在站点级别配置。如果您是云管理员，您还必须拥有站点管理员权限才能更改身份验证设置。

若要修改站点身份验证，请按照以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航到“站点”页面。
3. 单击要修改的站点旁边的省略号图标 (**...**)。
4. 从“操作”菜单中，选择 “身份验证类型”以重定向到站点的身份验证设置。有关以站点管理员身份配置站点身份验证的详细信息，请参见[身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)。

如果您不是站点管理员，则会显示一个对话框，其中包含有关如何分配必要角色的说明。您必须是具有站点管理员 Explorer 或站点管理员 Creator 角色的站点管理员才能继续配置站点身份验证。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_auth_site_permission.png)

### 为站点用户分配用户身份验证

作为云管理员，您不能直接配置站点身份验证设置。但是，如果站点上设置了多种身份验证方法，您可以在 Tableau Cloud Manager 的“用户”页面上修改用户对站点的身份验证。有关详细信息，请参见[管理用户的站点成员身份](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm#manage-site-membership)。

<!-- document id=2f76b8f5ccba96e0ffe7d32d877d8dee764df2d1a24d6bacb2db751c3b53061b url=/tableau/next/zh-cn/online/whatsnew_online.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud 发行说明

> [!TIP]
> 
> Tableau Online 现在更名为 Tableau Cloud。

本主题介绍最新版本中的新增功能。

使用下面的可视化项探索 Tableau Cloud 中的新功能。单击某个功能以显示工具提示，其中包含指向该功能详细文档的链接。探索筛选器以优化您的搜索。下载数据以创建自定义列表。

您也可以使用“按功能搜索”仪表板查看产品或版本的新功能列表，或探索功能何时发布。对于最新版本的 Tableau Cloud，仪表板当前默认为 Tableau Cloud。

## Web 制作和与视图交互

有关与 Web 制作和与视图交互相关的新功能及增强功能，请参见 [Tableau Desktop 和 Web 制作发行说明](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_desktop.htm)。有关与这些任务相关的详细主题，请参见[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_home.htm)。

## 此部分中的其他文章

<!-- document id=8e2672d3865df6576241dfaf85a5994fc025935883fe74e1621c611a0360d140 url=/tableau/next/zh-cn/online/to_site_capacity.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud 容量

Tableau Cloud 预置了支持用户分析需求的容量。随着 2026 年 5 月 (Tableau 2026.1) 中容量管理功能的引入，云管理员可以更好地了解和控制这些容量如何在租户中的站点之间分配。

**注意：**

- 本主题中讨论的容量信息适用于 Tableau Cloud Manager (TCM) 租户中的站点。租户是云管理员管理其组织的 Tableau Cloud 部署的顶级管理层。根据您的Tableau 版本，TCM 默认最多包含 3 个站点。站点数量随着不同的版本类型而增加：使用 [Enterprise](https://help.tableau.com/current/online/zh-cn/to_tab_enterprise_features.htm) 版最多可容纳 10 个站点，使用 [Cloud+](https://help.tableau.com/current/online/zh-cn/to_tab_cloud_plus_features.htm) 或 [Tableau+](https://help.tableau.com/current/online/zh-cn/to_tab_plus_features.htm) 版最多可容纳 50 个站点。但是，如果没有可用容量，您可能无法创建允许的最大数量的站点。
- 许可容量在租户级别进行管理，并可由云管理员使用站点角色限制分配给站点。有关详细信息，请参见[管理站点角色限制](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_site_role_limit.htm)。

## 容量摘要

下表按功能汇总了您的站点的容量限额。您可以通过下表中列出的功能区域找到更多容量信息。

**重要信息：**随着我们基础设施的发展，TCM 中特定站点的容量限制可能会发生变化。

#### 其他注意事项

- **版本和许可证：**多个容量是根据您的 Tableau Cloud 版本和 Creator 许可证数量计算得出的，并在适用的情况下加以注明。
- **Advanced Management 加载项：**自 2024 年 9 月 16 日起，Advanced Management 不再作为独立的加载项选项提供。如果您的站点以前通过 Advanced Management 加载项获得许可，则除非另有说明，否则您的站点或租户容量相当于 Tableau+ 或 Enterprise 版本的容量。

<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"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">功能区域</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量类型</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量限额</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">可在 TCM 中配置</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">详细信息</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="4" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="storage"></a><b>存储</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">站点存储</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard：</b>每个站点 1 TB<p><b>Enterprise、Cloud+、Tableau+：</b>每个站点 5 TB</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#storage" class="xref">存储</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Data Management：</b>每个站点最多 5 TB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm#feature-table" class="xref">关于 Tableau Cloud 上的 Tableau Advanced Management</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">单个工作簿、已发布数据源或流程大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard、Enterprise、Cloud+、Tableau+：</b>每个站点 25 GB（为实现最佳性能而建议的限制）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#storage" class="xref">存储</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Data Management：</b>每个站点 25 GB（为实现最佳性能而建议的限制）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm#feature-table" class="xref">关于 Tableau Cloud 上的 Tableau Advanced Management</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="4"><a name="extracts"></a><b>数据提取</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每日刷新</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每个站点每个 Creator 许可证最多 8 个后台程序小时</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#extracts" class="xref">数据提取 - 每日、运行时和内存使用量</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">并发刷新</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard：</b>每个租户最多 15 个作业*<p><b>Enterprise：</b>每个租户最多 25 个作业*，每 10 个 Creator 许可证额外增加 1 个作业</p><p><b>Cloud+、Tableau+：</b>每个租户最多 50 个作业*，每 5 个 Creator 许可证额外增加 1 个作业</p><p><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#extracts" class="xref">数据提取并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个刷新运行时间</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">120 分钟（2 小时）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#extracts" class="xref">数据提取 - 每日、运行时和内存使用量</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">刷新内存使用大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">20 GB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="extract_apis"></a><b>数据提取 API</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">调用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard：</b>每个租户每小时 120 次调用<p><b>Enterprise：</b>每个租户每小时 240 次调用，每 1 个 Creator 许可证额外增加 1 次调用</p><p><b>Cloud+、Tableau+：</b>每个租户每小时 480 次调用，每 1 个 Creator 许可证额外增加 2 次调用</p><p><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#extract_apis" class="xref">数据提取 API</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="3" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="subscriptions"></a><b>订阅</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">并发订阅</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard：</b>每个租户最多 20 个作业*<p><b>Enterprise：</b>每个租户最多 25 个作业*，每 10 个 Creator 许可证额外增加 1 个作业</p><p><b>Cloud+、Tableau+：</b>每个租户最多 50 个作业*，每 5 个 Creator 许可证额外增加 1 个作业</p><p><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#subscriptions" class="xref">订阅并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个订阅运行时间</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">30 分钟</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#subscriptions" class="xref">订阅 - 运行时间和电子邮件大小</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个电子邮件大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">2 MB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="publish_apis"></a><b>发布 API</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">调用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard：</b>每个租户每小时 800 次调用<p><b>Enterprise：</b>每个租户每小时 1200 次调用，每 2 个 Creator 许可证额外增加 1 次调用</p><p><b>Cloud+、Tableau+：</b>每个租户每小时 2,400 次调用，每 1 个 Creator 许可证额外增加 1 次调用</p><p><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#publish_apis" class="xref">发布 API</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="3" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="flows"></a><b>流程</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">并发流程</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard、Enterprise、Cloud+、Tableau+：</b>每个站点 1 个资源块</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#flows" class="xref">流程并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">其他并发流程</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Enterprise、Cloud+、Tableau+：</b>取决于每个租户购买的资源块</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#flows" class="xref">流程并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">流程内存使用大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">19.5 GB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#flows" class="xref">流程 - 用户请求、每日、运行时和内存使用量</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2"><a name="vds_apis"></a><b>VizQL Data Service (VDS) API</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">调用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>Standard、Enterprise、Cloud+、Tableau+：</b>每个租户每小时每 1 个Creator 许可证 100 次调用（不包括使用 UBL 许可的租户）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#vds_apis" class="xref">VizQL Data Service API</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#visualizations" class="xref">可视化项</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="5" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="vizualizations"></a><b>可视化项</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">加载时间</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">最长 5 分钟</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#visualizations" class="xref">可视化项 - 加载时间、超时、请求率、内存使用情况</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">空闲超时</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">120 分钟（2 小时）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2">请求率<p>&nbsp;</p><p>&nbsp;</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每个用户每小时最多 600 个请求</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#visualizations" class="xref">可视化项 - 加载时间、超时、请求率、内存使用情况</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p><b>基于容量的 Viewer（查看者）块：</b>请参见 <a href="#cvc" class="xref">使用基于容量的许可证模型的部署</a></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#visualizations" class="xref">可视化项</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">查询内存使用大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">40 GB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#visualizations" class="xref">可视化项 - 加载时间、超时、请求率、内存使用情况</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="4" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="view_acceleration"></a><b>视图加速</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">加速视图</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每个站点最少 30 个加速视图，每个 Creator 许可证额外增加 20 个视图。每个站点最多 750 个加速视图。</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="4"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity_site.htm#view_acceleration" class="xref">在站点设置的容量</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每日刷新</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">每个视图每天最多 12 个作业（每个站点）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单个加速视图运行时间</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">最长 30 分钟</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">加速视图内存使用大小</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">20 GB</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">-</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr></tbody></table>

\*为了确保整个 Tableau Cloud 的最佳性能和公平的资源分配，我们会根据实时需求动态管理容量。在高峰期或根据 Tableau 的判断，超出允许限制的请求可能会被拒绝，以优先考虑系统稳定性。

### 使用基于容量的许可证模型的部署

基于容量的许可证模型“基于容量的 Viewer（查看者）块”会替换版本的以下容量类型的默认容量：数据提取、数据提取 API、发布 API 和订阅。

在此模型下，您还可以获得用于计划的 Pulse 摘要的容量和额外的可视化项容量。

**注意：**用于可视化项和 VizQL Data Service (VDS) 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"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">功能区域</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量类型</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">容量限额</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">可在 TCM 中配置</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">详细信息</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</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">并发刷新</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单位，每个租户总共有 15 个作业（替换版本容量）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#extracts" class="xref">数据提取并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>数据提取 API</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">调用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单位，每个租户每小时总共调用 1000 次（替换版本容量）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#extract_apis" class="xref">数据提取 API</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>发布 API</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">调用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单位，每个租户每小时总共调用 1000 次（替换版本容量）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#publish_apis" class="xref">发布 API</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="cvc_pulse_digests"></a><b>Pulse 摘要</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">计划摘要</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单元，每个租户每天最多 1000 个请求**</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#pulse_digests" class="xref">Pulse 摘要</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</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">并发订阅</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单位，每个租户总共有 25 个作业（替换版本容量）</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#subscriptions" class="xref">订阅并发</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #dcdcdc;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #dcdcdc;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #dcdcdc;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #dcdcdc;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">&nbsp;</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a name="cvc_visualizations"></a><b>可视化项</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">请求率</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">对于购买的每个单位，每个租户每小时总共最多 300 个请求**</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#visualizations" class="xref">可视化项</a></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td></tr></tbody></table>

\*\*为了确保整个 Tableau Cloud 的最佳性能和公平的资源分配，我们会根据实时需求动态管理容量。在高峰期或根据 Tableau 的判断，超出允许限制的请求可能会被拒绝，以优先考虑系统稳定性。

## 此部分中的其他文章

<!-- document id=4ec0484bb82c2714423dedd3e99e7a3b266aba81bb6c8ff3a84e30b6c23f5661 url=/tableau/next/zh-cn/online/tableau-online-home.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud 帮助

## 入门指南

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_GetStarted_big.png)

- [Tableau Cloud 发行说明](https://help.tableau.com/v0.0/online/zh-cn/whatsnew_online.htm)
- [登录 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm)
- [浏览 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)
- [Web 制作入门指南](https://help.tableau.com/current/pro/desktop/zh-cn/getstarted_web_authoring.htm)
- [Tableau Cloud 手动迁移指南](https://help.tableau.com/current/guides/migration/zh-cn/emg_intro.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/to_get_started.htm)

## 使用 Tableau Cloud Manager

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ManageServer_big.png)

- [使用 Tableau Cloud Manager](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm)
- [云管理员角色和任务](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_admin.htm)
- [登录 Tableau Cloud Manager](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_signin.htm)
- [添加、重命名、删除或激活站点](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_sites.htm)
- [使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm)

## 管理站点

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ManageSites_big.png)

- [权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)
- [站点管理员角色和任务](https://help.tableau.com/v0.0/online/zh-cn/to_site_startup.htm)
- [设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)
- [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)
- [管理内容所有权](https://help.tableau.com/v0.0/online/zh-cn/owner.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/to_site_startup.htm)

## 配置站点身份验证

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_InstallConfigure_big.png)

- [在站点或 TCM 上启用 SAML 身份验证](https://help.tableau.com/v0.0/online/zh-cn/saml_config_site.htm)
- [身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)
- [使用 Microsoft Entra ID 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_azure_ad.htm)
- [使用 Okta 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_okta.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)

## 创建视图并在 Web 上与其进行交互

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_UseOnWeb_big.png)

- [创建视图或工作簿订阅](https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm)
- [在 Web 上连接到数据](https://help.tableau.com/v0.0/online/zh-cn/creator_connect.htm)
- [我可以使用 Tableau Web 视图做些什么](https://help.tableau.com/current/pro/desktop/zh-cn/viewer_tut.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/web_author.htm)

## 管理数据

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ManageData_big.png)

- [管理数据](https://help.tableau.com/v0.0/online/zh-cn/to_publish.htm)
- [允许实时连接到云平台上托管的数据](https://help.tableau.com/v0.0/online/zh-cn/to_connect_live_sql.htm)
- [在 Tableau Cloud 中管理后台作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm)
- [用于数据提供程序授权的 Tableau Cloud IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#safelist)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/to_publish.htm)

## 刷新数据

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_RefreshData_big.png)

- [在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)
- [使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm)
- [手动启动刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_manual.htm)
- [从命令行中自动执行数据提取刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/data_fresh_section.htm)

## 使用 Tableau Bridge

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Bridge_big.png)

- [与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)
- [使用 Bridge 使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm)
- [安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)
- [更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#to)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/data_fresh_sync_section.htm)

## 自动化和扩展

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Embed_big.png)

- [Tableau REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm)
- [Tableau Web 数据连接器 SDK](https://tableau.github.io/webdataconnector/docs/)
- [管理仪表板扩展程序](https://help.tableau.com/v0.0/online/zh-cn/dashboard_extensions_server.htm)
- [Tableau 元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/dev_resources.htm)

## 浏览 Data Management

![](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Addon_big.png)

- [关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)
- [关于 Tableau Prep Conductor](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_online_intro.htm)
- [关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)
- [许可 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_license.htm)
- [更多](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)

<!-- document id=26eb760fe75283b2007c27816690195c9202fba19857ab098e1cac2b336b784a url=/tableau/next/zh-cn/online/saml_online_requ.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud 的 SAML 要求

在为 Tableau Cloud 或 Tableau Cloud Manager (TCM) 配置 SAML 之前，请获取满足相关要求所需的内容。

- [Tableau 配置的身份提供程序 (IdP) 要求](#idp-reqs)
- [SAML 兼容性注意事项和要求](#compatibility-notes)
- [在 Tableau 客户端应用程序中使用 SAML SSO](#saml-sso-tableau-client)
- [更改身份验证类型对 Tableau Bridge 的影响](#bridge-consequences)
- [XML 数据要求](#xml-data-reqs)

**注意：**需要单独的设置和应用程序集成才能为 Tableau Cloud 和 TCM 启用 SAML 身份验证。

## Tableau 配置的身份提供程序 (IdP) 要求

若要将 Tableau Cloud 或 TCM 配置为使用 SAML，您需要以下内容：

- **已启用使用 MFA 的 SSO。**自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
    
    > [!WARNING]
    > 
    > **重要信息：**除了这些要求之外，我们建议您专门指定一个始终为 [带 MFA 的 TableauID](https://help.tableau.com/current/online/zh-cn/to_security_mfa.htm) 配置的站点管理员帐户。如果 SAML 或 IdP 出现问题，专用的带 MFA 的 Tableau 帐户可确保您始终能够访问站点。
- Tableau Cloud 站点或租户的管理员访问权限。在想要启用 SAML 的站点或租户上，您必须具有 Tableau Cloud 站点的管理员访问权限。
- 将使用 SSO 来访问 Tableau Cloud 或 TCM 的用户的列表。您应收集想要为其授予 Tableau 单点登录 (SSO) 访问权限的用户的用户名（电子邮件格式）。
- 支持 SAML 2.0 的 IdP 帐户。 您需要一个外部身份提供程序帐户。一些示例包括 PingFederate、SiteMinder 和 Open AM。IdP 必须支持 SAML 2.0。您必须具有该帐户的管理员访问权限。
- SHA256 用作签名算法。自 2020 年 5 月起，Tableau 会阻止使用 SHA-1 算法签名的 IdP 断言和证书。
- 支持导入和导出 XML 元数据的 IdP 提供程序。 尽管手动创建的元数据文件可以工作，但 Tableau 技术支持无法协助进行生成该文件或排除其问题。
- 强制将最大令牌期限设置为 24 天或更少（2073600 秒）的 IdP 提供程序。如果 IdP 允许令牌的最大期限大于 Tableau Cloud 上的最大期限设置（2073600 秒），则 Tableau 不会将令牌识别为有效令牌。在这种情况下，用户将在尝试登录到 Tableau Cloud 或 TCM 时收到错误消息（_The sign-in was unsuccessful.Try again_.（登录未成功，请重试。）。

## SAML 兼容性注意事项和要求

- SP 或 IdP 已启动： Tableau 支持在身份提供程序 (IdP) 或服务提供程序 (SP) 处开始的 SAML 身份验证。
- **单点注销 (SLO)**：Tableau 支持服务提供商 (SP) 发起的 SLO 和身份提供程序 (IdP) 发起的 SLO。
    
    **注意：**若要获取站点或租户的 SLO URL，请下载并参考您的 Tableau Cloud 站点或租户生成的元数据 XML 文件。可通过转到以下位置_之一_来查找此文件。
    
    - 在 Tableau Cloud 中，请转到“设置”\>“身份验证”\>“新配置”或者“编辑配置”。
    - 在 TCM 中，请转到“设置”\>“身份验证”。
- tabcmd 和 REST API：若要使用 [tabcmd](https://help.tableau.com/v0.0/online/zh-cn/tabcmd.htm) 或 [TableauREST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm "在新选项卡中打开 REST API 帮助。")，用户必须使用个人访问令牌 (PAT) 登录到 Tableau Cloud。若要使用 [Tableau Cloud Manager REST API](https://help.tableau.com/current/api/cloud-manager/zh-cn/reference/index.html "在新选项卡中打开 TCM REST API 帮助。")，用户必须使用个人访问令牌 (PAT) 登录到 TCM。
- 加密断言：Tableau 支持明文或加密断言。
- **需要重新配置 Tableau Bridge ：**Tableau Bridge 支持 SAML 身份验证，但身份验证更改需要重新配置 Bridge 客户端。有关信息，请参见[更改身份验证类型对 Tableau Bridge 的影响](#bridge-consequences)。
- **必需的签名算法**：对于所有新的 SAML 证书，Tableau Cloud 或 TCM 需要 SHA256（或更高）的签名算法。
- **RSA 密钥和 ECDSA 曲线大小：**IdP 证书的 RSA 密钥强度必须为 2048，ECDSA 曲线大小为 256。
- **NameID 属性**：Tableau 需要 SAML 响应中的 NameID 属性。
- **自定义域：**如果您为 Tableau Cloud 站点配置[将自定义域与 Tableau Cloud 配合使用](https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm)，则必须更新 IDP 应用程序设置中的 Tableau Cloud 实体 ID 和 ACS URL 以反映自定义域。举例来说，如果您的自定义域是 `analytics.example.com`，请更新这些 URL 以使用该域，而不是默认的 Tableau Cloud URL。

## 在 Tableau 客户端应用程序中使用 SAML SSO

**注意：**仅适用于 Tableau Cloud。

Tableau Cloud 用户（具有 SAML 凭据）也可以从 Tableau Desktop 或 Tableau Mobile 应用中登录到其站点。为了实现最佳兼容性，我们建议 Tableau 客户端应用程序的版本与 Tableau Cloud 的版本匹配。

从 Tableau Desktop 或 Tableau Mobile 连接到 Tableau Cloud 时，将使用服务提供程序发起的连接。

### 将经过身份验证的用户重定向回 Tableau 客户端

用户登录到 Tableau Cloud 时（使用 SP 发起的工作流），Tableau Cloud 会向 IdP 发送一个 SAML 请求 (`AuthnRequest`)，其中包括 Tableau 应用程序的 **RelayState** 值。如果用户已通过诸如 Tableau Desktop 或 Tableau Mobile 等 Tableau 客户端登录到 Tableau Cloud，则务必在 IdP 对 Tableau 的 SAML 响应内返回 RelayState 值，以将用户定向到特定的 Tableau 资源。

当用户直接从 IdP（使用 IdP 发起的工作流） 启动 Tableau Cloud 登录过程时，IdP 可以在 SAML 响应中包括 **RelayState** 值，以将用户定向到特定的 Tableau 资源。例如，RelayState 值可以设置为 `/#/site/[site-url]/views/[view-name]/[workbook-tab-name]`。

如果在这些情形下未正确返回 RelayState 值，则会在 Web 浏览器中将用户转向其 Tableau Cloud 主页，而不是重定向回他们从中登录的应用程序。

与身份提供商和内部 IT 团队合作，确认此值将包括在 IdP 的 SAML 响应内 之间的任何网络设备（例如代理或负载平衡器）保留。

### 更改身份验证类型对 Tableau Bridge 的影响

当您更改站点的身份验证类型或修改 IdP 时，为计划的数据提取刷新使用 Tableau Bridge 的发布者将需要取消链接和重新链接客户端，并使用新方法或 IdP 配置重新进行身份验证。

对于旧版计划，取消链接 Bridge 客户端会移除所有数据源，因此您必须重新设置刷新计划。对于 Online 计划，在重新链接客户端后，您必须重新配置 Bridge 客户端池。

身份验证类型的更改不会影响直接从 Tableau Cloud 站点中运行的 Bridge 实时查询或刷新（比如对于云中的基础数据就是如此）。

我们建议在对用户的站点身份验证进行更改之前将相关更改通知用户。否则，只有当用户从 Bridge 客户端中收到身份验证错误或者客户端打开时包含空白数据源区域时，他们才会意识到更改。

## XML 数据要求

可以使用 Tableau Cloud 或 TCM 和 IdP 生成的元数据 XML 文档来配置 SAML。在身份验证过程中，IdP 和 Tableau 使用这些 XML 文档来交换身份验证信息。如果 XML 未满足这些要求，则在您配置 SAML 或在用户尝试登录时会发生错误。

### HTTP POST 和 HTTP REDIRECT

Tableau Cloud 或 TCM 支持 SAML 通信的 HTTP POST 和 REDIRECT 请求。在由 IdP 导出的 SAML 元数据 XML 文档中，`Binding` 属性可以设置为：

- HTTP-POST
- HTTP-REDIRECT
- HTTP-POST-SimpleSign

### 使用 SAML 断言的动态群组成员身份

**注意：**仅适用于 Tableau Cloud。

从 2024 年 6 月 (Tableau 2024.2) 开始，如果配置了 SAML 并启用功能的设置，您可以通过身份提供商 (IdP) 发送的 SAML XML 响应中包含的自定义声明来动态控制群组成员身份。

配置后，在用户身份验证期间，IdP 会发送包含两个自定义组成员身份声明的 SAML 断言：组 (`https://tableau.com/groups` ) 和组名（例如，“Group1”和“Group2”）来将用户声明到其中。Tableau 验证该断言，然后启用对组以及权限依赖于这些组的内容的访问权限。

有关详细信息，请参见[使用断言的动态组成员身份](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#assertions) 。

**SAML XML 响应示例**

<saml2p:Response
  xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
    .....
    .....
  <saml2:Assertion
    .....
    .....
    xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
    <saml2:AttributeStatement
  		xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml2:Attribute
    		Name="https://tableau.com/groups"
			NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">Group1
			</saml2:AttributeValue>
			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">Group2
			</saml2:AttributeValue>
    	<saml2:Attribute>
    </saml2:AttributeStatement>
  </saml2:Assertion>
</saml2p:Response>

### SAML 断言中的用户属性

**注意：**仅适用于 Tableau Cloud。

从 2025 年 10 月 (Tableau 2025.3) 开始，在配置并启用功能的设置后，您可以在登录期间将身份提供程序 (IdP) 发送的 SAML XML 响应中的用户属性断言传递到 Tableau Cloud。这些用户属性可与 Tableau 的用户属性函数 (`USERATTRIBUTE()`, `USERATTRIBUTEINCLUDES()`) 结合使用，动态控制和自定义内容。Tableau 验证该断言，然后启用对内容的访问。

有关详细信息，请参见[使用用户属性自定义和控制数据访问](https://help.tableau.com/v0.0/online/zh-cn/saml_config_site.htm#user_attributes)。

**SAML XML 响应示例**

<saml2p:Response
  xmlns:saml2p="urn:oasis:names:tc:SAML:2.0:protocol"
    .....
    .....
  <saml2:Assertion
    .....
    .....
    xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion"
    <saml2:AttributeStatement
  		xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml2:Attribute
    		Name="Region"
			NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">South
			</saml2:AttributeValue>
			<saml2:AttributeValue
				xmlns:xs="http://www.w3.org/2001/XMLSchema"
				xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
				xsi:type="xs:string">South West
			</saml2:AttributeValue>
    	<saml2:Attribute>
    </saml2:AttributeStatement>
  </saml2:Assertion>
</saml2p:Response>

<!-- document id=0e996ab2742a1ab9ebccd10a783bc98695f18c9cdd5251e15ffbae2f294a9659 url=/tableau/next/zh-cn/online/to_maintenance_schedule.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud 系统维护

Tableau Cloud 需要定期维护，以维持支持 Tableau Cloud 服务的基础设施，并提供增强的功能和功能。作为 Tableau Cloud 站点管理员，您不必担心站点更新管理。但我们建议查看预留的维护计划，以计划预定的停机并避免服务中断。有关发布的详细信息，请参见 [Tableau Cloud 发布节奏](#release-cadence)。

从 2025 年 4 月开始，Tableau+ 客户可以创建发布预览站点，以在 Tableau Cloud 主要版本在生产环境中上线之前对其进行评估。这些站点托管在专用的有限发布预览环境中，并与标准 Tableau Cloud 站点分开更新。有关详细信息，请参见[关于 Tableau 发布预览](https://help.tableau.com/v0.0/online/zh-cn/release_preview.htm)。

## 维护通信

Tableau 通过 Salesforce Trust 状态页面和通知电子邮件向站点管理员传达系统维护信息。

### Salesforce Trust 通知

所有 Tableau Cloud 状态更新均在 Salesforce Trust 上发布。状态更新包括系统维护，以及报告的可能影响 Tableau Cloud 使用的事件。您可以通过访问 Trust 页面或订阅 Trust 来快速检查 Tableau Cloud 实例的状态。

若要订阅 Trust，请转到 [https://status.salesforce.com/products/tableau](https://status.salesforce.com/products/tableau)，然后单击“Subscribe to Notifications”（订阅通知）按钮。每当 Tableau Cloud 创建、更新或解决事件时，您都可以通过电子邮件或通知接收更新。有关详细说明，请参见 [Salesforce Trust 状态通知指南](https://trust1-public.s3.amazonaws.com/notifiction_guide/en/TrustNotificationGuide.pdf)。

### 站点管理员电子邮件

具有站点管理员角色的 Tableau Cloud 用户将自动接收有关其站点的通知电子邮件。电子邮件包括系统维护，以及报告的可能影响 Tableau Cloud 使用的事件。

通知电子邮件将包括日期和时间、Tableau Cloud 实例的名称、计划维护的类型、对用户的影响以及预计完成时间。

## 预留系统维护计划

Tableau 保留了系统维护窗口，用于维护支撑 Tableau Cloud 服务的基础设施的安全性、可用性和性能。预留的维护计划将帮助您规划预定的停机，并避免 Tableau Cloud 站点服务中断。虽然有一个预定义的维护时限，但可能有几个月的时间不需要维护。

在计划维护时，我们会在 [Salesforce Trust](https://status.salesforce.com/products/tableau) 站点上公布维护时限的日期和时间。对于影响整个 Tableau Cloud 实例的维护，Trust Status 通知将通过电子邮件发送给订阅者和站点管理员。当维护计划发布到 Trust Status 时，将在维护开始前 14 天发送通知。Trust Status 通知也将在每次维护的开始和结束时发送，并在 48 小时之前作为提醒发送。

如果我们需要重新计划维护，维护记录将在 Trust Status 页面上更新，并将向 Trust Status 订阅者发送电子邮件。

**注意：**如果需要优先维护，Trust Status 订阅者和 Tableau Cloud 站点管理员可能会提前不到一周时间收到通知。

只要有可能，并且仅在需要维护时，Tableau 将在下表中列出的时限内，将系统维护安排在**日历月的第一个和第三个周末**进行。在您的实例的 Tableau 系统维护时限之外为您的组织计划维护活动（软件升级、集成更改等）。在极端情况下，有时系统维护安排在这些时限之外，以维护 Tableau Cloud 基础设施的系统可用性、性能和安全性。

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 10%;"><col style="width: 10%;"><col style="width: 20%;"><col style="width: 25%;"><col style="width: 20%;"></colgroup><tbody><tr><th colspan="5" style="text-align: center;">预留系统维护时限</th></tr><tr><th colspan="2">地点</th><th>Pod</th><th>太平洋时间 (PST)</th><th>当地时间（标准时间）</th></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="6">亚太地区</td><td>澳大利亚</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 07:00 – 11:00</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 01:00 - 05:00 AEST</td></tr><tr><td>印度</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-in-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 14:00 – 18:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 03:30 - 07:30 IST</td></tr><tr><td>印度尼西亚</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 07:00 – 11:00</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 22:00 – 星期日 02:00 WIB</td></tr><tr><td>日本</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apnortheast-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 07:00 – 11:00</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 00:00 - 04:00 JST</td></tr><tr><td>新加坡</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-b</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 07:00 – 11:00</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 23:00 – 星期日 03:00 SGT</td></tr><tr><td>韩国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-kr-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 08:00 – 12:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 01:00 - 05:00 KST</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大</td><td>魁北克</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-ca-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 00:00 – 04:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 03:00 - 07:00 EST</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="3">欧洲</td><td>德国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">DUB01、EW1A</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 14:00 – 18:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 23:00 – 星期日 03:00 CET</td></tr><tr><td>瑞士</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-ch-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 14:00 – 18:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 23:00 – 星期日 03:00 CET</td></tr><tr><td>英国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-uk-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 14:00 – 18:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 22:00 – 星期日 02:00 GMT</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">美国 - 西部</td><td>俄勒冈州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">10AY、10AZ、UW2B、prod-uswest-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 00:00 – 04:00</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 00:00 - 04:00 PST</td></tr><tr><td>美国 - 东部</td><td>弗吉尼亚州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-useast-a、prod-useast-b、useast-1、prod-useast-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 00:00 – 04:00</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 03:00 - 07:00 EST</td></tr></tbody></table>

**注意：**

- 本地维护时限使用标准时间。在夏令时期间，当地时间可能会季节性变化 +/- 1 小时。
- 维护时限已于 2026 年 4 月 15 日更新，以便更好地为客户提供支持并帮助最大程度地减少中断。

之前的预留系统维护时限

为了更好地支持客户并帮助最大限度地减少中断，预留的系统维护时限已于 2026 年 4 月 15 日更新。有关当前预留的系统维护时限，请参见[上表](#maintenance-windows)。

下面列出了之前的预留系统维护时限，**仅供参考**。

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 25%;"><col style="width: 20%;"></colgroup><tbody><tr><th colspan="5" style="text-align: center;">预留系统维护时限</th></tr><tr><th>区域</th><th>Pod</th><th>区间</th><th>当地时间</th><th>UTC</th></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">美国 - 西部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">10AY、10AZ、UW2B、prod-uswest-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 08:00 - 14:00 PST</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">美国 - 东部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-useast-a、prod-useast-b、useast-1、prod-useast-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 11:00 - 17:00 EST</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">欧洲</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">DUB01、EW1A、prod-uk-a、prod-ch-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期六 02:00 - 08:00 CET</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 1:00 – 7:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大 - 魁北克</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-ca-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 11:00 - 17:00 EST</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 日本</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apnortheast-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 01:00 - 07:00 JST</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 澳大利亚</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 03:00 - 09:00 AEST</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 新加坡</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-b</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 00:00 - 06:00 SGT</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 印度尼西亚</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-apsoutheast-c</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>星期日 23:00 - 星期一 05:00 WIB</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 印度</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-in-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 22:00 - 星期日 04:00 IST</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">亚太地区 - 韩国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">prod-kr-a</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;"><p>每月第一个周末</p><p>每月第三个周末</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期日 01:00 - 07:00 KST</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">星期六 16:00 – 22:00</td></tr></tbody></table>

## Tableau Cloud 发布节奏

为确保我们的产品继续帮助人们每天使用数据解决问题，Tableau 不断创新。我们一年发布三次新的特性和功能（冬季、春季、夏季）。

### 发布沟通

发布通过产品内通知进行传达，让您知道您的站点何时计划升级，然后在升级完成后再次通知。可以在升级期间访问站点，这意味着用户可以使用所有特性和功能。没有与发布升级相关的停机。

### 发布时间表

在升级我们的本地软件之前的几周内，主要版本会在 Tableau Cloud 的全球基础架构中推出。由于我们的发布按顺序在全球范围内推出，因此不会宣布确切的日期和时间。相反，产品内通知用于在即将发布时通知用户和管理员。

在您的站点计划升级前大约两周，您会看到一个产品内通知，在升级完成后会看到另一个通知。下面是登录到站点时即将收到的升级通知的示例：

![Tableau Cloud 升级通知。](/tableau/next/zh-cn/online/zh-cn/Img/to_coming_soon.png)

### 了解新功能

有关您站点上的新功能的详细信息，请参见[即将推出](https://www.tableau.com/zh-cn/products/coming-soon)。“即将推出”页面提供有关即将进行和正在进行的 Tableau 发布的信息。作为 Tableau Cloud 客户，您可能已经有权访问此页面上列出的功能。一旦我们所有产品的客户都可以升级并利用新功能，就会进行更广泛的网站更新。

<!-- document id=de53c5f2eb27a0581eebd9209d1fce5d4c75a0a6792f11e34c6db183bdd9e26e url=/tableau/next/zh-cn/online/to_keep_data_fresh.md -->

[跳转到主要内容](#main-content)

# 使数据保持最新

将工作簿和数据源发布到 Tableau Cloud 后，您可以决定要如何使数据保持最新。用于使已发布的数据保持最新的选项取决于您的数据源的特征。

## 按数据源列出的数据新鲜度选项

下表列出了因数据源而异的可用数据新鲜度选项（及例外）。

#### 例外

- Tableau Cloud 不支持连接到任何基于多维数据集的数据源。
- Tableau Cloud 不支持使用 Kerberos 身份验证的已发布连接。
- 虽然您可以将 SAP BW 数据的数据提取发布到 Tableau Cloud，但不支持刷新。更新 SAP BW 数据源的最佳方法是重新发布它们。

#### 选项

<table class="table--plain"><thead><tr><th>源</th><th>发布选项</th><th>新鲜度选项</th><th>身份验证</th></tr></thead><tbody><tr><td style="background-color: #dcdcdc;" colspan="4">本地数据（只能通过专用网络访问）</td></tr><tr><td><p>基于文件的数据</p><p>（Excel、.csv、.txt）</p></td><td><p>仅限数据提取</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm">使用 Tableau Bridge</a>（推荐）</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm">从 Tableau Desktop 中手动刷新</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm">自动化命令行脚本</a></p></td><td>不适用</td></tr><tr><td><p>统计文件</p><p>(SAS (*.sas7bdat))</p></td><td>仅限数据提取</td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm">使用 Tableau Bridge</a>（推荐）</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm">从 Tableau Desktop 中手动刷新</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm">自动化命令行脚本</a></p></td><td>不适用</td></tr><tr><td><p>云平台上托管的数据</p><p>（例如，Amazon RDS 上的 Oracle）</p></td><td><p>实际连接或数据提取（取决于数据库）</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm">使用 Tableau Bridge</a>（推荐）</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm">从 Tableau Desktop 中手动刷新</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm">自动化命令行脚本</a></p></td><td><p>Tableau Bridge 设置中的嵌入凭据</p></td></tr><tr><td><p>关系数据库&nbsp;</p><p>（<span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 连接到的关系数据库。例如，SQL Server、Oracle、IBM DB2）</p></td><td><p>实际连接或数据提取（取决于数据库）</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm">使用 Tableau Bridge</a>（推荐）</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm">从 Tableau Desktop 中手动刷新</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm">自动化命令行脚本</a></p></td><td><p>Tableau Bridge 设置中的嵌入凭据</p></td></tr><tr><td style="background-color: #dcdcdc;" colspan="4">云数据（可通过公共 Internet 访问）</td></tr><tr><td><p>云平台上托管的数据</p><p>（请参见支持的平台列表，位置为<br><a href="https://help.tableau.com/v0.0/online/zh-cn/to_connect_live_sql.htm" class="xref">允许实时连接到云平台上托管的数据</a></p></td><td><p>实时连接或数据提取</p></td><td><p></p><p>数据提取：</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p><p></p></td><td><p>嵌入式凭据 + <a href="#safelist">IP 安全列表</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_connections_modify.htm" class="xref">编辑 Tableau Cloud 上的连接</a></p></td></tr><tr><td><p>Salesforce、Google Analytic </p></td><td><p>仅限数据提取</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm" class="xref">使用保存的凭据刷新数据</a></p></td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm" class="xref">OAuth 连接</a></td></tr><tr><td><p>Google BigQuery,</p><p>Google Sheets</p></td><td><p>实时连接或数据提取</p></td><td><p>数据提取：</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm" class="xref">使用保存的凭据刷新数据</a></p></td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm" class="xref">OAuth 连接</a></td></tr><tr><td><p>基于云（Box、Dropbox、OneDrive、Google Drive）文件的数据</p><p>（Excel、.csv、.txt、.tab、.tsv、.json）</p></td><td><p>实时连接或数据提取</p></td><td><p>数据提取：</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm" class="xref">使用保存的凭据刷新数据</a></p></td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm" class="xref">OAuth 连接</a></td></tr><tr><td><p>Anaplan</p><p>Oracle Eloqua</p><p>ServiceNow ITSM</p></td><td><p>仅限数据提取</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm" class="xref">使用保存的凭据刷新数据</a></p></td><td><p>嵌入式凭据</p><p><a href="https://help.tableau.com/v0.0/online/zh-cn/to_connections_modify.htm" class="xref">编辑 Tableau Cloud 上的连接</a></p></td></tr><tr><td><p>Marketo</p><p>&nbsp;</p></td><td><p>仅限数据提取</p></td><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#online">在 Tableau Cloud 上直接计划</a></p></td><td><p>嵌入式凭据</p></td></tr><tr><td><p>Web 数据连接器</p></td><td><p>仅限数据提取</p></td><td><p>对于基本用户名和密码凭据，请<a href="https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm">使用 Tableau Bridge</a>。</p><p>对于自定义（非基本）用户名和密码凭据，请使用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 的<span class="uicontrol">“从源刷新”</span>命令，或者<a href="https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm">从 Tableau Desktop 中运行手动刷新</a>。有关详细信息， 请参见 Tableau Web 数据连接器 API 帮助中的 <a href="https://tableau.github.io/webdataconnector/docs/wdc_authentication" target="_blank">WDC 身份验证</a>主题。  </p></td><td><p>Tableau Bridge：嵌入式凭据</p><p>其他：不可用</p></td></tr></tbody></table>

## 用于数据提供程序授权的 IP 地址

作为一项安全措施，基于云的数据提供程序可能会要求您提供外部应用程序从中请求访问数据的授权 IP 地址。来自未经明确允许的 IP 地址的请求可能会被拒绝。为了确保发布到 Tableau Cloud 的实时连接保持不间断，请将 Tableau Cloud 添加到数据提供程序的允许列表。

下表列出了 Tableau Cloud 根据您的站点所在的 pod 使用的 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1) IP 地址。您可以在登录 Tableau Cloud 后显示的 URL 中看到该 pod。

下表列出了每个 pod 的 IP 地址。它还列出了当您的 Tableau Cloud 数据与 Tableau Cloud 实例位于同一区域时要使用的 Hyperforce VPCE ID。您可以在登录 Tableau Cloud 后显示的 URL 中看到该 pod。

**注意：**

- 除了启用 Tableau Cloud IP 范围内的通信外，您可能还需要根据通信类型（HTTP 或 HTTPS）启用通过相应数据库端口（例如，80 或 443）的访问。
- 这些地址专用于 Salesforce，并由 Salesforce 控制。
- IP 地址范围以无类别域间路由 (CIDR) 表示法列出。

### Tableau Cloud 的 IP 地址

Hyperforce IP 地址会定期添加，并且需要您的数据提供商的允许列表进行更新。站点管理员将在有新的 IP 地址可用时收到提醒他们的电子邮件通知。

您还可以使用以下_一个_或_两个_选项随时了解新的 IP 地址：

- **选项 1 — 定期检查下面的 IP 地址表：**在启用 IP 地址前至少 30 天，下面的 IP 地址表会更新。

- **选项 2 — 使用 JSON 文本文件自动更新 IP 地址：**Salesforce 建议您的数据提供商的允许列表镜像 [https://ip-ranges.salesforce.com/ip-ranges.json](https://ip-ranges.salesforce.com/ip-ranges.json) 通过自动 IP 地址更新随时更新文本文件。新的 IP 地址会在启用前至少 30 天添加到文本文件中。
    
    在文本文件中，pod 的 IP 地址按 pod 所在的 Hyperforce 区域列出。若要确定 Hyperforce 区域，请参阅下表中的“Pod”和关联的“Hyperforce 区域”列。举例来说，如果您的 pod 名称是“prod-ca-a”，那么您的 Hyperforce 区域就是“ca-central-1”。在 [https://ip-ranges.salesforce.com/ip-ranges.json](https://ip-ranges.salesforce.com/ip-ranges.json) 文本文件中，搜索“ca-central-1”以获取要包含在数据提供程序允许列表中的适当 IP 地址。
    
    **注意：**
    
    - 当有新的 IP 地址可用时，包含新 IP 地址和现有 IP 地址的新版本文本文件将替换以前的文本文件。
    - 文本文件版本由“createDate”（UTC 时间）表示。
    - Salesforce 建议您复制该文本文件的先前版本以供记录。
    - 并非所有区域都会同时收到新的 IP 地址。

#### IP 地址

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"></colgroup><tbody><tr><th colspan="2">地点</th><td><b>Hyperforce 区域</b></td><td style="font-weight: bold;">Pod（<b>Pod 名称</b>）</td><td><b>Hyperforce 迁移后的 IP 地址和范围</b><p>（或者，在 <a href="https://ip-ranges.salesforce.com/ip-ranges.json" target="_blank">https://ip-ranges.salesforce.com/ip-ranges.json</a> 中搜索 Hyperforce 区域）</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="6">亚太地区</td><td><p>澳大利亚</p></td><td><p>ap-southeast-2</p></td><td><p>prod-apsoutheast-a</p></td><td><p>141.163.192.0/23</p></td></tr><tr><td>印度</td><td>ap-south-2</td><td>prod-in-a</td><td>141.163.216.0/24</td></tr><tr><td><p>印度尼西亚</p></td><td><p>ap-southeast-3</p></td><td><p>prod-apsoutheast-c</p></td><td><p>141.163.212.0/24</p></td></tr><tr><td><p>日本</p></td><td><p>ap-northeast-1</p></td><td><p>prod-apnortheast-a</p></td><td><p>141.163.208.0/23</p></td></tr><tr><td><p>新加坡</p></td><td><p>ap-southeast-1</p></td><td><p>prod-apsoutheast-b</p></td><td><p>141.163.196.0/23</p></td></tr><tr><td>韩国</td><td>ap-northeast-2</td><td>prod-kr-a</td><td>141.163.200.0/23</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大</td><td><p>魁北克</p></td><td><p>ca-central-1</p></td><td><p>prod-ca-a</p></td><td><p>155.226.152.0/23</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">欧洲</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">德国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">eu-central-1</td><td><p>dub01 (DUB01)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">145.224.208.0/23</td></tr><tr><td><p>eu-west-1a (EW1A)</p></td></tr><tr><td>瑞士</td><td>eu-central-2</td><td>prod-ch-a</td><td>145.224.198.0/24</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="1">英国</td><td><p>eu-west-2</p></td><td><p>prod-uk-a</p></td><td><p>145.224.200.0/23</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">美国 - 西部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">俄勒冈州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">us-west-2</td><td><p>10ax (10AX)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">155.226.128.0/21</td></tr><tr><td><p>10ay (10AY)</p></td></tr><tr><td><p>10az (10AZ)</p></td></tr><tr><td><p>uw2b (UW2B)</p></td></tr><tr><td><p>prod-uswest-c</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">美国 - 东部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">弗吉尼亚州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">us-east-1</td><td><p>prod-useast-a</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">155.226.144.0/22</td></tr><tr><td><p>prod-useast-b</p></td></tr><tr><td><p>us-east-1 (useast-1)</p></td></tr><tr><td><p>prod-useast-c</p></td></tr></tbody></table>

#### 关于 Hyperforce 迁移

在 2024 年 8 月到 2025 年 3 月之间，Tableau Cloud 站点已迁移到 Salesforce 的[Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)。此举增强了更广泛的合规性，改善了安全性和隐私性，提高了区域可用性，并确保了未来的可扩展性，从而在全球范围内更快、更可靠地提供这些优势。

**以前的 IP 地址**

迁移到 Hyperforce 后，Tableau Cloud IP 地址发生了变化。下面提供了旧的 IP 地址以供参考，并帮助您从数据提供商的允许列表中识别和移除任何非活动 IP 地址。

有关有效的 IP 地址，请参见[上表](#new_ip_addresses)。

Hyperforce 迁移前的 IP 地址

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"></colgroup><tbody><tr><th colspan="2">地点</th><td><b>Hyperforce 区域</b></td><td><b>Pod</b>（<b>Pod 名称</b>）</td><td><b>Hyperforce 迁移前的 IP 地址</b></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">亚太地区</td><td><p>澳大利亚</p></td><td><p>ap-southeast-2</p></td><td><p>prod-apsoutheast-a</p></td><td><p>3.25.37.32/28</p></td></tr><tr><td><p>日本</p></td><td><p>ap-northeast-1</p></td><td><p>prod-apnortheast-a</p></td><td><p>18.176.203.96/28</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大</td><td><p>魁北克</p></td><td><p>ca-central-1</p></td><td><p>prod-ca-a</p></td><td><p>3.98.24.208/28</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="3">欧洲</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2"><p rowspan="2">德国</p><p><b>注意：</b>在 Hyperforce 迁移之前，原为爱尔兰区域。</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">eu-central-1</td><td><p>dub01 (DUB01)</p></td><td><p>34.246.74.86</p><p>52.215.158.213</p></td></tr><tr><td><p>eu-west-1a (EW1A)</p></td><td><p>34.246.62.141</p><p>34.246.62.203</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="1">英国</td><td><p>eu-west-2</p></td><td><p>prod-uk-a</p></td><td><p>18.134.84.240/28</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">美国 - 西部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">俄勒冈州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">us-west-2</td><td><p>10ax (10AX)</p></td><td><p>34.208.207.197</p><p>52.39.159.250</p></td></tr><tr><td><p>10ay (10AY)</p></td><td><p>34.218.129.202</p><p>52.40.235.24</p></td></tr><tr><td><p>10az (10AZ)</p></td><td><p>34.218.83.207</p><p>52.37.252.60</p></td></tr><tr><td><p>us-west-2b (UW2B)</p></td><td><p>34.214.85.34</p><p>34.214.85.244</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="3">美国 - 东部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="3">弗吉尼亚州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="3">us-east-1</td><td><p>prod-useast-a</p></td><td><p>3.219.176.16/28</p></td></tr><tr><td><p>prod-useast-b</p></td><td><p>3.219.176.16/28</p></td></tr><tr><td><p>us-east-1 (useast-1)</p></td><td><p>50.17.26.34</p><p>52.206.162.101</p></td></tr></tbody></table>

### Tableau Cloud 的 VPCE ID

迁移到 Hyperforce 后，访问存储在 Amazon S3 存储桶中的 Tableau Cloud 数据时，需要满足一些新要求。

当数据与您的 Tableau Cloud 实例_位于同一区域_时：

- 您_必须_使用 VPC 端点 (VPCE) 而不是 IP 源地址来控制对 S3 数据的访问。
    
    VPC 端点是虚拟私有云 (VPC) 和资源（您在 S3 中的数据）之间的专用连接。使用端点是更好的解决方案，因为 IP 地址可能会随时间而变化。

当 S3 存储桶与 Tableau Cloud 站点_位于不同的区域_时：

- 您需要使用 IP 地址来控制对 S3 存储桶的访问。

当 Snowflake 实例位于与 Pod 位于 AWS 上的同一区域并且在 Snowflake 实例中[启用了内部阶段保护](https://docs.snowflake.com/en/user-guide/network-policies#protecting-internal-stages-on-aws "链接到有关在 AWS 上保护内部阶段的 Snowflake 文档")时，这适用于 S3 连接器和 Snowflake 连接器。

#### IP 地址和 VPCE ID

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 16%;"><col style="width: 14%;"><col style="width: 14%;"><col style="width: 16%;"><col style="width: 20%;"></colgroup><tbody><tr><th colspan="2">地点</th><td><b>Hyperforce 区域</b></td><td style="font-weight: bold;">Pod（<b>Pod 名称</b>）</td><td><b>IP 地址和范围/VPCE ID </b></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="6">亚太地区</td><td><p>澳大利亚</p></td><td><p>ap-southeast-2</p></td><td><p>prod-apsoutheast-a</p></td><td><p>141.163.192.0/23<br><br>vpce-071ca855ea8cc1154</p></td></tr><tr><td>印度</td><td>ap-south-2</td><td>prod-in-a</td><td><p>141.163.216.0/24</p><p>vpce-02e14aeeeccOa2eef</p></td></tr><tr><td><p>印度尼西亚</p></td><td><p>ap-southeast-3</p></td><td><p>prod-apsoutheast-c</p></td><td><p>141.163.212.0/24<br><br>vpce-05825e2ebed977018</p></td></tr><tr><td><p>日本</p></td><td><p>ap-northeast-1</p></td><td><p>prod-apnortheast-a</p></td><td><p>141.163.208.0/23<br><br>vpce-045516807606e4738</p></td></tr><tr><td><p>新加坡</p></td><td><p>ap-southeast-1</p></td><td><p>prod-apsoutheast-b</p></td><td><p>141.163.196.0/23<br><br>vpce-0c47ba2622417575b</p></td></tr><tr><td>韩国</td><td>ap-northeast-2</td><td>prod-kr-a</td><td><p>141.163.200.0/23</p><p>vpce-053ebbbe86f5411ca</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大</td><td><p>魁北克</p></td><td><p>ca-central-1</p></td><td><p>prod-ca-a</p></td><td><p>155.226.152.0/23<br><br>vpce-0fd4bd6f2f928fcf7</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">欧洲</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">德国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">eu-central-1</td><td><p>dub01 (DUB01)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">145.224.208.0/23<br><br>vpce-091ff41bc3686e6e8</td></tr><tr><td><p>eu-west-1a (EW1A)</p></td></tr><tr><td>瑞士</td><td>eu-central-2</td><td>prod-ch-a</td><td><p>145.224.198.0/24</p><p>vpce-0fbf9d552ffbb6be2</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="1">英国</td><td><p>eu-west-2</p></td><td><p>prod-uk-a</p></td><td><p>145.224.200.0/23<br><br>vpce-0101caa470966f49d</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">美国 - 西部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">俄勒冈州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">us-west-2</td><td><p>10ax (10AX)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">155.226.128.0/21<br><br>vpce-090a7c76e361d5013</td></tr><tr><td><p>10ay (10AY)</p></td></tr><tr><td><p>10az (10AZ)</p></td></tr><tr><td><p>uw2b (UW2B)</p></td></tr><tr><td><p>prod-uswest-c</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">美国 - 东部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">弗吉尼亚州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">us-east-1</td><td><p>prod-useast-a</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">155.226.144.0/22<br><br>vpce-0ea40e596e16259d1</td></tr><tr><td><p>prod-useast-b</p></td></tr><tr><td><p>us-east-1 (useast-1)</p></td></tr><tr><td><p>prod-useast-c</p></td></tr></tbody></table>

## Tableau Bridge 与 Tableau Cloud 的连接

为了方便本地数据与 Tableau Cloud 之间的连接，Tableau Bridge 使用公共端口 443 向 Tableau Cloud 发出出站请求。有关详细信息，请参见“安装 Tableau Bridge”主题中的[网络访问](https://help.tableau.com/current/online/zh-cn/to_bridge_install.htm#network-access)部分。

## 另请参见

- [管理数据](https://help.tableau.com/v0.0/online/zh-cn/to_publish.htm)
- [发布的数据源的最佳做法](https://help.tableau.com/current/pro/online/mac/zh-cn/help.htm#publish_datasources_about.htm)（Tableau 帮助）
- [数据提取刷新失败时通知所有者](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_enable_emails.htm)
- [编辑 Tableau Cloud 上的连接](https://help.tableau.com/v0.0/online/zh-cn/to_connections_modify.htm)

<!-- document id=b2a4f44cd4169c7a53a6c99a5ffd785510a61d6262efabd60d8fdb8ce27064d9 url=/tableau/next/zh-cn/online/to_connect_live_sql.md -->

[跳转到主要内容](#main-content)

# 允许实时连接到云平台上托管的数据

您可以通过多种方式管理 Tableau Cloud 工作簿的基础数据。您可以根据业务需求选择如何保持数据最新。根据数据源，您可以利用实时连接，也可以创建数据提取并定义数据提取计划以保持数据最新。您还可以嵌入凭据，或要求用户在打开连接到内容的视图时提供用于访问数据的凭据。

如果在云平台上维护关系数据，您可以在将工作簿和数据源发布到 Tableau Cloud 时使用与该数据的实时连接。使用实时连接时，您无需发布数据的静态数据提取。

## 启用加密连接

使用 SSL 对连接进行加密是适用于基础数据源的一种选项。在 Tableau Desktop 中创建连接时，您可以为与托管 SQL 数据的连接启用 SSL 加密。完成以下步骤以启用加密连接。

> [!TIP]
> 
> **提示：**确保 Tableau Cloud 位于数据提供程序的授权列表（安全列表）上。

1. 在 Tableau Desktop 中，连接到数据。
2. 在“服务器连接”对话框中，选中“需要 SSL”复选框。
3. 对于 PostgreSQL、SQL Server 兼容的连接以及其他没有在数据源中嵌入证书选项的连接，请单击“确定”完成。
    
    对于某些兼容连接，链接的文本将出现在“需要 SSL”复选框下方。这表明您可以指定要使用的备用证书文件，例如自签名证书。
4. （可选）使用自签名证书或其他自定义证书通过 SSL 连接到此数据。
    
    1. 选择显示的链接文本。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/to_connect_live_sql1.png)
    2. 在“配置和使用 SSL 证书”对话框中，指定证书的 **.pem** 文件。
        
        例如，对于 Amazon RDS 上托管的数据的 MySQL 连接，您可以指向 Amazon 上位于[此地址](https://rds.amazonaws.com/doc/mysql-ssl-ca-cert.pem)的自签名证书文件。

### 不受信任的证书

如果您使用的是 Tableau Cloud 不信任的证书，例如自签名证书或公司内部 CA 签名的证书，则从 Tableau Cloud 连接时可能会出现问题。尝试以下解决方案之一：

- 果您的连接器允许嵌入自定义证书，请使用它。（这是上一部分用到的方法）
- 为您的数据库获取由可信公共 CA 签署的新证书。
- 使用 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)，它是 Tableau 的连接代理。您可以通过使用 TDC 文件、属性文件或在 Windows 系统信任存储中安装您的证书，将您的证书配置为在运行 Bridge 的计算机上受信任。

### 支持的连接器

有关支持的连接器列表，请参见 [Creators：连接到 Web 上的数据](https://help.tableau.com/v0.0/online/zh-cn/creator_connect.htm#connector_list)主题中的“Tableau Cloud”选项卡。

有关连接器支持的功能的详细信息，请参见 Tableau 用户帮助的[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)部分中的特定连接器主题。

**注意：**并非此列表中的所有连接器都受 Tableau Prep Conductor 支持。若要查看支持的连接器的列表，请打开 Tableau Prep Builder 并展开“连接”窗格。

## 另请参见

- Tableau 帮助中的[连接器示例](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#exampleconnections_overview.htm)

<!-- document id=5a56135ca33dd1d706d8831fcfc3a0a32592cedfb1c5dce2bf4bd913d37cccb8 url=/tableau/next/zh-cn/online/to_custom_logo.md -->

[跳转到主要内容](#main-content)

# 为站点上载自定义徽标

若要将品牌标识并入您的站点标题中，您可以将 Tableau 徽标更改为您自己的徽标。

1. 以站点管理员身份登录到 Tableau Cloud。
2. 在要显示您的徽标的站点上，单击“设置”。
3. 在“站点徽标”部分，执行以下任一操作：
    
    - 将图像文件从您的计算机拖到“设置”页面上指示的区域。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/to_custom_logo1.png)
    - 单击“选择文件”打开一个对话框，您可以在其中浏览并选择图像文件。
    
    预览区域将更新以显示图像在标题中所提供的空间中的样子。
4. （可选）如果您的徽标不太适合放在可用空间中，并且您想要在 Tableau 外部进行调整之后再上载，您可以执行以下任一操作：
    
    - 单击“重置为默认值”以显示原始 Tableau 徽标。
    - 单击“恢复”以恢复到最后一次保存的设置。如果您已经放好了自定义徽标，但想要尝试其他徽标，则这一点十分有用。
5. 单击“保存”。

### 图像文件提示

- 建议的图像大小为 48 x 48 像素，最多可达 160 x 160 像素（最大值）。
- 具有透明背景的浅色图像最适合放在 Tableau Cloud 站点近乎黑色的背景上。

<!-- document id=0baca1554dcf1dccf2e95ab6d176e61abd8685295dc86d247340dd75d2a55e27 url=/tableau/next/zh-cn/online/to_customize_site_and_content.md -->

[跳转到主要内容](#main-content)

# 自定义站点和内容设置

作为 Tableau 管理员，您可以为组织自定义站点。可用的设置取决于您的站点配置，以及您是使用 Tableau Cloud 还是 Tableau Server。为了查看和编辑站点设置，您必须是 Tableau Cloud 上的站点管理员或 Tableau Server 上的服务器管理员。

使用以下主题来自定义您的站点。

## 此部分中的其他文章

<!-- document id=67f8707b29076b4f727d1d36ffbcc0324f7d15bf8d59a304191f700d6a0faeba url=/tableau/next/zh-cn/online/to_tab_cloud_plus_get-started.md -->

[跳转到主要内容](#main-content)

# Tableau Cloud+ 版本入门指南

TTableau Cloud+ 版本可用于 Tableau Cloud。它专门为全面采用 AI 驱动的自助分析而量身定制。它包含针对更大或更复杂的部署定制的高级功能，例如带有 Tableau Agent 的高级 AI 功能、50 个站点限制、发布预览和 Tableau Cloud 的 Premier Success。

Tableau Cloud+ 版本包含一些需要配置的功能，本主题介绍了您需要针对每个功能执行的操作。有些功能是 Tableau Cloud+ 独有的，而其他则是 Tableau Cloud 的其他版本所共有的。一些功能需要在 Salesforce 中进行配置。

初始步骤取决于您的客户类型：

- 新 Tableau 客户
    
    作为 Tableau Cloud 的新客户，您应该在探索 Tableau Cloud+ 版本的独特功能之前熟悉 Tableau Cloud。首先，请参见[入门指南](https://help.tableau.com/v0.0/online/zh-cn/to_get_started.htm)和[关于 Tableau Cloud+ 版本](https://help.tableau.com/v0.0/online/zh-cn/to_tab_cloud_plus_features.htm)，然后请按照以下配置步骤进行操作。
- 现有 Tableau Cloud 客户
    
    对于升级到 Tableau Cloud+ 的现有 Tableau Cloud 客户来说，几乎不需要做任何“迁移”工作。您的现有站点仍保留（无需“迁移”它们），但独特的 Tableau Cloud+ 功能需要一些配置。

## 配置 Tableau Cloud 和 Salesforce 的 Tableau+ 功能

这些 Tableau Cloud+ 功能需要配置才能使用：

- **Tableau Pulse**： [为 Tableau Pulse 设置站点](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm)（**注意：**请务必启用 Tableau Pulse 关键指标摘要，该功能在同一主题中有介绍，如下所示：[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)。
- Prep、Catalog 和 Web 制作中的 **Tableau Agent**： [在您的 Tableau Cloud 站点中启用 AI](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm) 以启用 Tableau Agent。
    
    这需要在每个 Tableau Cloud 站点上_和_配置了 Einstein 生成式 AI 的 Salesforce 组织中进行配置。它还需要一个 Data 360 实例。
    
    - 对于没有 Data 360 实例的 Tableau Cloud+ 客户，我们会提供一个。
    - 对于那些没有 Enterprise 版级别或更高版本 Salesforce 组织的用户，我们将在 Tableau Cloud+ 许可证中提供一个。
- **Data 360** 通过设置管理员用户并打开 Data 360 来配置 Data 360：[步骤 2：设置 Data Cloud 架构师用户](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm#setup_dc_permissions)。

以下功能并非 Tableau Cloud+ 独有，但在 Tableau Cloud 实例中提供了其他重要功能：

- **Data Management**：[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)（附带一个资源块。有关详细信息，请参见[资源块](https://help.tableau.com/v0.0/online/zh-cn/to_resource_blocks.htm)。
- **Advanced Management**：[关于 Tableau Cloud 上的 Tableau Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm)
- **Tableau Cloud Manager**：使用 TCM 管理多个 Tableau Cloud 站点。Tableau Cloud+ 客户最多可获得 50 个站点。有关使用 TCM 的详细信息，请参见[使用 Tableau Cloud Manager](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm)。
- [Premier Success](https://www.salesforce.com/services/success-plans/overview/premier-success-plans/)：通过专家指导和快速支持从 Tableau 获取最大价值。
- [eLearning](https://www.tableau.com/zh-cn/learn/training/elearning)：使用自定进度的在线课程按照自己的时间表学习 Tableau。

<!-- document id=e42f766304fda7c4784da09aef41635f4bbd9b02fae259f1b872004796e2785f url=/tableau/next/zh-cn/online/cmt-getting-started.md -->

[跳转到主要内容](#main-content)

# Tableau Content Migration Tool 入门指南

本文将帮助您开始使用 Tableau Content Migration Tool。它包含指向安装 Content Migration Tool 之前需要准备的信息的其他文章的链接，以及设计迁移计划和升级现有安装的步骤。

## 安装之前

### 安装要求

Content Migration Tool 只能安装在 Windows 操作系统上。在安装之前，您必须能够从安装了 Content Migration Tool 的计算机连接到 Tableau 源站点（您从中进行迁移的站点）和目标站点（您迁移到的站点）。源站点和目标站点都必须具有有效的 [Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm) 许可证。有关安装和升级 Content Migration Tool 的详细信息，请参见[安装 Tableau Content Migration Tool](https://help.tableau.com/v0.0/online/zh-cn/cmt-install.htm)。

### 与 Tableau Cloud 的兼容性

Content Migration Tool 版本 2022.2.1 及更高版本支持所有 Tableau Cloud 部署的内容迁移。我们建议从 [Tableau Advanced Management](https://www.tableau.com/zh-cn/support/releases/advanced-management) 下载页面安装最新版本以利用最新的功能和修复。

### 与 Tableau Server 的兼容性

Content Migration Tool 支持 Tableau Server 版本 2019.3 及更高版本的内容迁移。

该表根据已安装的 Content Migration Tool 版本列出了 Tableau Server 的兼容版本。

| CMT 版本 | Tableau Server 版本 |
| --- | --- |
| 2025.2x | 2023.3x - 2025.1.x |
| 2025.1x | 2023.3x - 2025.1.x |
| 2024.3x | 2022.3x - 2024.2.x |
| 2024.2x | 2022.3x - 2024.2.x |
| 2024.1x | 2022.1x - 2024.1.x |
| 2023.3.x | 2021.4.x - 2023.3.x |
| 2023.2.x | 2021.3.x - 2023.2.x |
| 2023.1.x | 2021.2.x - 2023.1.x |
| 2022.4.x | 2021.1.x - 2022.4.x |
| 2022.3.x | 2020.4.x - 2022.3.x |
| 2022.2.x | 2020.3.x - 2022.2.x |
| 2022.1.x | 2020.2.x - 2022.1.x |
| 2021.4.x | 2020.1.x - 2021.4.x |
| 2021.3.x | 2019.4.x - 2021.3.x |
| 2021.2.x | 2019.3.x - 2021.2.x |
| 2021.1.x | 2019.3.x - 2021.1.x |
| 2020.4.x | 2019.3.x - 2020.4.x |
| 2020.3.x | 2019.3.x - 2020.3.x |

**注意：**如果您有 Tableau Server 部署，您可以在 Tableau Server 安装和 Tableau Cloud 站点上的项目之间迁移内容。两个站点都必须具有有效的 Advanced Management 许可证。

### 与 Tableau 内容的兼容性

Content Migration Tool 支持迁移工作簿和保存在 Tableau 的八个最新版本中的已发布数据源。尽管您可以迁移现有数据源，但在迁移过程中只能更改和修改使用下表中的连接类型的数据源。有关详细信息，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)和[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)中的“数据源转换”。

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix</p><p>Actian Vectorwise</p><p>Amazon Athena</p><p>Amazon Aurora</p><p>Amazon EMR</p><p>Amazon Redshift</p><p>Apache Drill</p><p>Aster Database</p><p>Box</p><p>Cloudera Hadoop</p><p>Delimited Text File</p><p>EXASOL</p><p>Firebird</p><p>Google Analytics（分析）</p><p>Google BigQuery</p><p>Google Cloud SQL</p></td><td><p>Google 云端硬盘</p><p>HortonWorks Hadoop Hive</p><p>HP Vertica</p><p>IBM DB2</p><p>IBM Netezza</p><p>Map R Hadoop Hive</p><p>Microsoft Access</p><p>Microsoft Analysis Services</p><p>Microsoft Excel</p><p>Microsoft Excel Direct</p><p>Microsoft OneDrive</p><p>Microsoft SQL Server</p><p>MySQL</p><p>OData</p><p>Oracle</p><p>Oracle Essbase</p></td><td><p>Pivotal Greenplum Database</p><p>PostgreSQL</p><p>Progress OpenEdge</p><p>Salesforce</p><p>SAP HANA</p><p>SAP Sybase ASE</p><p>SAP Sybase IQ</p><p>Snowflake</p><p>Spark SQL</p><p>统计文件</p><p>Tableau 数据提取</p><p>Tableau 已发布数据源</p><p>Teradata</p><p>文本文件</p><p>Web 数据连接器</p><p>其他数据库 (ODBC)</p></td></tr></tbody></table>

## 安装之后

### 迁移内容时的限制

在开始之前，请确保了解使用 Content Migration Tool 迁移内容时的限制。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

### 创建迁移计划

Content Migration Tool 将引导您跨单个站点上的项目迁移内容、将内容迁移到同一 Tableau Server 实例上的新站点，以及迁移到存在于不同 Tableau Server 实例上的站点。可以保存您创建的计划，并再次用于将来的迁移。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm)。

<!-- document id=3438d50fb0256c4b1a5075afd2ad900bbe70e68abaa5dfce6e1287f73bc74117 url=/tableau/next/zh-cn/online/cmt-logfiles.md -->

[跳转到主要内容](#main-content)

# Tableau Content Migration Tool 日志文件

当您运行迁移时，Tableau Content Migration Tool 会生成日志文件。这些日志文件有助于排查问题。

**注意：**有关所有 Content Migration Tool 设置的信息，请参见[Tableau Content Migration Tool 设置](https://help.tableau.com/v0.0/online/zh-cn/cmt-settings.htm)。

## Content Migration Tool 日志文件位置

若要从 Content Migration Tool 内查找 Content Migration Tool 日志文件，请执行以下操作：

1. 启动 Content Migration Tool。
2. 单击“Help ”和“Settings”：
    
    ![帮助下拉菜单中的“设置”选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-help-settings.png)
3. 在“Settings ”对话框中，单击“Open Log Folder”：
    
    ![光标悬停在标有“打开日志文件夹”的蓝色按钮上。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-logfile-folder.png)
    
    将打开一个包含日志文件的窗口。

如果您正在与 Tableau 支持部门合作，并且他们要求您发送日志文件，请在发送文件之前将其压缩。有关向 Tableau 发送日志文件的详细信息，请参见 [Tableau 知识库](https://kb.tableau.com/articles/howto/alternative-method-for-sending-large-files?lang=zh-cn)。

## 谁可以执行此操作

通常，上面列出的任务只能由在计算机上具有管理员访问权限的用户完成。

<!-- document id=134394a5b30321890e20b4374ad072c4cb9603ea8016144a537714965c010150 url=/tableau/next/zh-cn/online/cmt-use-cases.md -->

[跳转到主要内容](#main-content)

# Tableau Content Migration Tool 用例

顾名思义，Tableau Content Migration Tool 主要用于将 Tableau Cloud 内容从一个项目移动到另一个项目。但是，该工具中有许多功能使其成为完成与内容迁移和维护相关的多个任务的理想之选。

**注意**：在许多用例中，我们使用术语“迁移”来描述将内容从一个环境、站点或项目移动到另一个环境、站点或项目。但是，从技术上讲， Content Migration Tool 会复制内容而不会自动删除或存档原始内容或源内容。

下面的信息描述了一些常见的用例，您可以在其中利用 Content Migration Tool。

## 内容推广

您可以使用 Content Migration Tool 为开发项目中创建内容，然后执行例行迁移以将内容推广到站点上的暂存或生产项目。

使用以下步骤将内容迁移到生产项目：

1. **创建计划**并选择要用作源的站点。在此示例中，我们描述了同一站点上的项目之间的迁移，因此请选择同一 Tableau 站点作为您的目标。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
    
    如果要在同一站点上的两个项目之间迁移工作簿，则源和目标的登录凭据可能非常相似或相同。在这种情况下，我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。
2. **选择包含您要迁移的内容的开发项目**。您可以选择整个项目、特定工作簿和数据源，以及用户权限。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-2-planning)主题中的“规划”。
    
    如果需要在此迁移期间对内容进行任何**更改或转换**，也可以在计划中配置该更改或转换。这一过程称为“**映射**”。
3. 从“添加映射”菜单中选择“更改项目”以添加项目映射。选择您的开发项目作为源和生产项目作为目标，或者单击“添加新项目”创建一个新项目。
    
    其他类型的映射包括：
    
    - **对工作簿的更改：**包括重命名工作簿和更改目标项目。有关工作簿转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
        
        ![“迁移”窗口中的下拉菜单列出了重命名工作簿、项目、前缀和后缀的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-workbook-mapping-options.png)
    - **数据源的更改：**包括替换表或架构名称、设置计算公式以及设置连接信息。有关数据源转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm#step-3-workbook-transformations)（嵌入式数据源）和[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm#step-3-data-source-transformations)（已发布数据源）。
        
        ![用于数据源转换的“添加转换”下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-mapping-options.png)
    - **对用户的更改**：包括目标中的域、用户和组名称更改。
4. 准备就绪时，单击**“运行迁移”**结束“规划”阶段，并准备运行计划。
5. **若要计划**此操作以定期运行，可以使用 Content Migration Tool 运行程序[为此操作编写作业脚本](https://help.tableau.com/v0.0/online/zh-cn/cmt-scripting_migration_example.htm)并对其进行计划。有关使用 Content Migration Tool 运行程序的详细信息请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。

## 针对客户定制内容

在咨询方案中工作时，可以使用 Content Migration Tool 针对每个客户自定义内容。每个工作簿都充当迁移计划的模板，允许您应用样式（文本、图像等）并针对特定客户替换数据源。

在这个例子中，我们描述了项目之间的迁移；存储模板的内部项目，以及与客户共享的外部项目。

**使用以下步骤针对客户自定义内容：**

1. **创建计划**并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
    
    如果要在同一站点上的两个项目之间迁移工作簿，则源和目标的登录凭据可能非常相似或相同。在这种情况下，我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。
2. **选择包含要迁移的模板内容的内部项目**。您可以选择整个项目、特定工作簿和数据源，以及用户权限。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)中的“规划”。
    
    如果需要在此迁移期间对内容进行任何**更改或转换**，也可以在计划中配置该更改或转换。这一过程称为“**映射**”。
3. 从“添加映射”菜单中选择“更改项目”以添加项目映射。选择您的内部项目作为源和生产项目作为目标，或者单击“添加新项目”创建一个新项目。
4. **在迁移计划的**“工作簿”步骤中，使用工作簿映射和转换来自定义内容。下面是两个常用转换的示例。有关工作簿转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
    
    - 若要个性化内容，可以使用“替换图像”和“替换文本”转换，用客户的公司名称和徽标更新工作簿。
    - 当涉及到数据源时，您可以使用“替换表/架构名称”或“设置自定义 SQL”转换来针对客户修改内容。
5. **验证并运行**计划。准备就绪时，单击“运行迁移”结束“规划”阶段，并准备运行计划。

## 环境迁移

您可以使用 Content Migration Tool 在 Tableau Cloud 和具有有效 Advanced Management 许可证的 Tableau Server 环境之间迁移内容。

使用以下步骤在 Tableau 部署之间迁移内容：

1. **创建计划**并**选择要从中迁移的站点**作为源。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
2. **选择要**从源站点迁移的内容。您可以选择整个项目、特定工作簿和数据源，以及用户权限。
3. **创建用户权限映射以**自定义并保护内容。有关详细信息，请参见[迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)。
    
    ![带有用于规划、映射和运行迁移的选项的菜单，其中突出显示了用户映射。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-user-mapping-options.png)
4. **验证并运行**计划。准备就绪时，单击“运行迁移”结束“规划”阶段，并准备运行计划。

> [!TIP]
> 
> **提示**  
> \- 在执行部分备份之前，请确保在使用 Content Migration Tool 时了解[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。  
> \- 您可以在最终迁移完成之前分阶段迁移内容，以迭代方式测试和验证内容。  
> \- Content Migration Tool 迁移不处理嵌入式凭据、订阅和自定义视图。必须手动迁移这些内容。

## 外部内容共享

您可以使用 Content Migration Tool 与外部协作者共享内部内容，而不允许访问您的项目。这样可以保证数据的安全，并允许您仅发布选择的工作簿和数据源。共享内容后，协作者登录到其 Tableau Cloud 站点以查看和进行更改，而不会影响存储在您的内部项目上的内容。

在继续之前，请确保您共享的内容在内部和外部项目之间兼容。

**使用以下步骤在外部共享内容：**

1. **准备内部内容**。最佳做法是，我们建议分离内部项目上的内容，并使用锁定的权限和严格的控制规则。应明确标记工作簿和数据源，以指示内容供外部使用。有关详细信息，请参见[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)。
    
    **注意**：与外部项目共享的内容必须使用数据提取，除非数据源是可公开访问的。有关创建数据提取和替换数据源的信息，请参见 Tableau Desktop 帮助中的[提取数据](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm)和[替换数据源](https://help.tableau.com/current/pro/desktop/zh-cn/connect_basic_replace.htm)。
    
    如果已实现行级别安全性，则必须更新这些数据源以反映用户筛选器和外部项目的其他详细信息。有关行级别安全性的详细信息，请参见 Tableau Desktop 帮助中的[在数据行级别限制访问权限](https://help.tableau.com/current/pro/desktop/zh-cn/publish_userfilters.htm)。
2. **创建计划**并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
    
    如果要在同一站点上的两个项目之间迁移工作簿，则源和目标的登录凭据可能非常相似或相同。在这种情况下，我们建议使用个人访问令牌以提高连接的可重用性。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。
3. **选择包含要迁移的模板内容的内部项目**。您可以选择整个项目、特定工作簿和数据源，以及用户权限。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)中的“规划”。
    
    如果需要在此迁移期间对内容进行任何**更改或转换**，也可以在计划中配置该更改或转换。这一过程称为“**映射**”。
4. 从“添加映射”菜单中选择“更改项目”以添加项目映射。选择您的内部项目作为源和外部项目作为目标，或者单击“添加新项目”创建一个新项目。
5. **验证并运行**计划。准备就绪时，单击“运行迁移”结束“规划”阶段，并准备运行计划。

## 验证数据库迁移

此用例是您打算在迁移基础数据库后验证内容的情况。数据库迁移的一个示例是从 SQL Server 转移到 Snowflake。CMT 可以帮助您在最终完成迁移之前验证依据两个数据源构建的内容是相同的，但它无法执行实际数据库迁移。

使用以下步骤来验证数据库迁移：

1. **创建计划**并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
2. **选择**要更改数据源或数据库连接的内容。
3. **配置迁移**以将您的内容复制到新项目。让我们将**源**项目称为**项目 A**，并将新项目或**目标**项目称为**项目 B**。
    - 对工作簿的更改：创建工作簿映射以将项目 A 更改为项目 B。有关工作簿转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
    - 对数据源的更改：创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表，请参见[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)。
4. **验证并运行**计划。准备就绪时，单击**“运行迁移”**结束“规划”阶段，并准备运行计划。
5. 使用新的数据库连接**更新****项目 B** 中的内容，或替换数据源。这需要通过制作手动完成。
6. **使用项目 B** 中的**副本****测试项目 A 中的每个工作簿**，并检查由于数据源更改而导致的数据中的任何不一致。
7. 确认一切正常后，使用项目 B 中的更新内容**覆盖**项目 A 中的内容。
    
    **注意：**如果目标项目中已存在内容，并且未选择“覆盖较新的工作簿”和“覆盖较新的工作簿”发布选项，则内容不会复制到目标项目。

## 维护任务

您可以使用 Content Migration Tool 执行各种维护任务。

### 标记过时内容

使用 Content Migration Tool 可以管理过时内容的存档。例如，可以生成按定时计划运行的计划，该计划可以自动选取标记为“过时内容”的内容并将其移动到存档项目。一段时间后，可将此项目中的内容从系统中清除。有关详细信息，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。

### 还原内容

您可以使用 Content Migration Tool，通过备份服务器中的内容还原从项目（意外或故意）移除的内容。

使用以下步骤从备份项目还原内容：

1. **创建计划**并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
2. **选择要从**备份项目还原的内容。
3. **配置迁移**以从备份项目中还原内容。我们将备份项目称为**项目 A**，将您要还原的项目称为**项目 B**。
    
    - 对工作簿的更改：创建工作簿映射以将项目 A 更改为项目 B。有关转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
    - 对数据源的更改：创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表，请参见[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)。
4. **验证并运行**计划。准备就绪时，单击“运行迁移”结束“规划”阶段，并准备运行计划。
5. 查看生产站点上的**内容**。

### 部分备份

拥有备份项目后，您可以使用 Content Migration Tool 将新内容从生产传输到备份项目。

**注意：**  
\- 在执行部分备份之前，请确保在使用 Content Migration Tool 时了解[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。  
\- 不应使用 Content Migration Tool 备份您的整个站点。我们建议优先考虑最需要的内容。

使用以下步骤执行内容的部分备份：

1. **创建计划**并选择要用作源的站点。选择与您的目标相同的 Tableau 站点。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm#step-1-start)主题中的“创建计划”。
2. **选择要从**产品项目备份的内容。您可以选择整个项目、特定工作簿和数据源，以及用户权限。若要仅迁移新内容，请确保未选择发布选项“覆盖较新的工作簿”和“覆盖较新的数据源”。有关详细信息，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
3. **配置迁移**以将内容复制到您的备份项目。我们将源项目称为**项目 A**，将备份项目称为**项目 B**。
    - 对工作簿的更改：创建工作簿映射以将项目 A 更改为项目 B。有关转换的完整列表，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
    - 对数据源的更改：创建数据源映射以将项目 A 更改为项目 B。有关数据源转换的完整列表，请参见[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)。
4. **验证并运行**计划。准备就绪时，单击“运行迁移”结束“规划”阶段，并准备运行计划。
5. **若要计划**此操作以定期运行，可以使用 Content Migration Tool 运行程序为此操作编写作业脚本并对其进行计划。有关使用 Content Migration Tool 运行程序的详细信息请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。

<!-- document id=116c073bf4318bb0c751cc3ca05087d7bfac98fd9465c781767a1680463dd044 url=/tableau/next/zh-cn/online/cmt-settings.md -->

[跳转到主要内容](#main-content)

# Tableau Content Migration Tool 设置

Tableau Content Migration Tool 默认设置适用于大多数情况，但您可以在需要时更改这些设置，或者，如果您与 Tableau 支持人员合作，他们会要求您进行更改。

若要查看或更新 Content Migration Tool 设置，请执行以下操作：

1. 打开 Content Migration Tool。
2. 单击“Help”>“Settings”。“设置”对话框将打开：
    
    ![设置窗口的高级选项卡，显示内容管理工具的高级选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-settings.png)  
    
    Diagnostics—单击“Open Log Folder”打开日志位置。您可以在这里查看日志，并在需要将日志发送给 Tableau 的情况下压缩日志。有关详细信息，请参见[Tableau Content Migration Tool 日志文件](https://help.tableau.com/v0.0/online/zh-cn/cmt-logfiles.htm)。
    
    如果您在与支持人员合作，并且他们要求您在日志中包括网络跟踪信息，请选择“Enable Network Tracing”。这将一直适用，直至您清除选项或重新启动 Content Migration Tool 为止。
    
    Security— 加密文件密钥是在安装时自动生成的。如果更改加密密钥，则使用先前密钥创建的、包含嵌入密码的任何迁移计划将无法打开。如果有多个 Tableau Content Migration Tool 安装，并且想要共享迁移计划，您需要确保工具的每个实例使用的加密密钥相同。
    
    Migration Scripts— 默认情况下，运行包含迁移脚本或可执行文件的迁移计划时会显示警告。其他用户可以编辑这些文件，因此请在运行迁移之前验证它们是否安全。打开和关闭此设置还将更新您对控制台运行者的警告首选项。有关详细信息，请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。
    
    Tuning—在几乎所有情况下，您都可以将这些设置保留为默认值。如果正在与支持人员合作，他们可能会要求您更改这些设置。
    
    Temporary Files— 如果要更改默认位置，请选择临时文件的位置。这是在迁移过程中复制内容的位置。如果默认位置没有足够的空间来临时保存迁移的内容，则可能需要更改此选项。
    
    Networking—选择“Allow Legacy HTTPS Connections”使您能够连接到使用较旧 HTTPS 配置（例如，SSL v3）运行的 Tableau Server 安装。不建议这样做。

## 谁可以执行此操作

通常，上面列出的任务只能由在安装了 Content Migration Tool 的计算机上具有管理员访问权限的用户完成。

<!-- document id=3f8ad128c45a0da109aad879345da3e7993ddaf91a32e479acf28ccb61f54385 url=/tableau/next/zh-cn/online/help.md -->



<!-- document id=370ae360e10cd25b09de1daf9c4e7090efe0dd7cbdbe25b714ab3b6006be3ad7 url=/tableau/next/zh-cn/online/mobile_security_settings-admin.md -->

[跳转到主要内容](#main-content)

# Tableau Mobile 应用程序安全设置

调整 Tableau Cloud Tableau Mobile 应用程序的安全策略。这些策略通过检查移动设备是否受到威胁以及限制与 Tableau Mobile 应用程序的某些交互来帮助确保您的数据安全。

这些策略仅适用于 Tableau Mobile 的标准版本，不适用于应用程序的 MAM 版本。如果您已部署 MAM 应用程序，请使用特定于 Tableau Mobile 的 ，以及您的 MAM 系统设置，以保护应用程序。

## 安全设置

在 Tableau Cloud 的站点设置页面上或使用 REST API 配置 Tableau Mobile 的安全设置。有关 REST API 的详细信息，请参见 Tableau REST API 帮助中的 [移动设置首选项](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_mobile_settings.htm)。

访问站点设置页面：

1. 以管理员身份登录到 Tableau Cloud 站点。
2. 从导航窗格中，选择“设置”。
3. 选择“Mobile”选项卡。

从 2022 年 12 月 开始，与移动设备安全相关的 设置可用。

这些设置包括检测以下条件：

- 越狱检测
    
    默认情况下，此设置在“严重”级别启用，并检测应用程序是否在已越狱或获得 Root 权限的设备上运行。
- 恶意软件检测（仅限 Android 设备）
    
    默认情况下，此设置在“严重”级别启用，并检测设备上是否有恶意软件。
    
    > [!IMPORTANT]
    > 
    > 2025 年 9 月，Tableau Mobile 已停用对恶意软件检测设置的支持。恶意软件检测设置已于 2025 年 9 月从 Tableau Cloud 设置页面和 Tableau Server 版本 2025.2.3 的 Tableau Server 设置页面中移除。以前版本的 Tableau Server 上恶意软件检测设置的任何配置都不会对 Tableau Mobile 应用程序产生影响。
- 没有刷新策略的最大脱机天数
    
    默认情况下，此设置在“严重”级别启用，默认最长为 14 天。它确定应用程序是否可以在脱机时间超过配置的最大值（因此没有策略刷新）的设备上使用。
- 防止调试
    
    默认情况下此设置处于启用状态，无法禁用。它检测设备是否附加了调试器。
- 屏幕共享和屏幕截图（仅限 Android 设备）
    
    此设置默认情况下启用，并确定 Tableau Mobile 应用程序用户是否可以共享屏幕截图或使用应用程序的屏幕共享。

您可以更改越狱检测设置的严重性级别：

- **警告**：执行该策略，如果失败，则显示可忽略的阻止消息。
- **错误**：执行该策略，如果失败，则显示一条阻止消息，直到问题得到解决。
- **严重**：执行该策略，如果失败，则显示一条阻止消息，应用程序决定如何通过提供程序处理注销/清除会话。这是默认值。

<!-- document id=185b890a003551175e21fb48e869ae38572f4d4de96fabd1570a0fec5791ce7f url=/tableau/next/zh-cn/online/prep_conductor_online_intro.md -->

[跳转到主要内容](#main-content)

# Tableau Prep Conductor

Tableau Prep Conductor 使您能够利用 Tableau Cloud 中的计划和跟踪功能自动运行您的流程以更新流程输出。Tableau Prep Conductor 是 Data Management 的一部分，并且必须启用才能安排流程运行。

**注意**：仅当您打算按计划运行流程或设置电子邮件通知时才需要 Data Management。您不需要发布流程并在 Web 上手动运行它们的 Data Management 许可证。作为 Creator，您还可以直接在服务器上创建和编辑流程。有关在 Web 上制作流程的详细信息，请参见 [Web 上的 Tableau Prep](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm)。

在 Tableau Prep Builder 中创建的流程必须发布到 Tableau Cloud，然后才能安排这些流程运行。发布流程类似于发布数据源和工作簿。您可以将文件与流程打包在一起，或指定与数据源的直接连接以在数据更改时更新流程输入。如果您的流程连接到数据库，请指定身份验证类型并设置凭据以访问数据。

您也可以发布流程以与他人共享，或继续在 Web 上对其进行编辑。例如，将不完整的流程发布到 Tableau Cloud，然后在“编辑”模式下在 Web 上打开流程以继续处理它。您还可以创建仅包含输入步骤（已正确配置）的流程，并与同事共享，然后他们可以将流程下载到他们的计算机并创建和发布自己的流程。

为了使流程运行，它们必须包括输出步骤，并且没有错误或不兼容的功能。有关发布流程的详细信息，请参见[将流程发布到 Tableau Server 或 Tableau Cloud](https://help.tableau.com/current/prep/zh-cn/prep_conductor_publish_flow.htm)。有关不兼容性的详细信息，请参见[与 Tableau Prep 的版本兼容性](https://help.tableau.com/current/prep/zh-cn/prep_conductor_compatibility.htm)。

下表显示了在启用和未启用 Data Management 和 Tableau Prep Conductor 的情况下可用的流程管理功能。

<table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>启用了 Tableau Prep Conductor 的 <span class="mc-variable Variables.DM_sku variable">Data Management</span></th><th>无 <span class="mc-variable Variables.DM_sku variable">Data Management</span></th></tr><tr><td><ul><li><p>查看和监视有关您的流程的详细信息，包括<span class="uicontrol">“内容”</span>页面中的最近活动。</p></li><li>编辑您的流程（从版本 2020.4 开始）。</li><li><p>在<span class="uicontrol">“运行历史记录”</span>选项卡中查看流运行的结果和任何错误。</p></li><li><p>使用<span class="uicontrol">“管理视图”</span>监视服务器和站点活动，包括跟踪流程性能历史记录的新视图。</p></li><li><p>使用 REST API 运行流程</p></li><li><p>查看失败的流程运行的详细通知。</p></li><li><p>设置电子邮件通知警报，以向流程所有者发送电子邮件，通知他们何时无法运行流程以及相关原因。</p><p>有关设置通知的详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/prep_conductor_monitor_flow.htm">监视流程运行状况和性能</a>。</p></li></ul></td><td><ul><li><p>查看有关您的流程的详细信息，包括<span class="uicontrol">“内容”</span>页面中的最近活动。</p></li><li><p>编辑您的流程（从版本 2020.4 开始）。</p></li><li><p>在<span class="uicontrol">“连接”</span>选项卡上查看和编辑您的连接。</p></li></ul></td></tr></tbody></table>

## 在 Tableau Cloud 上 启用 Tableau Prep Conductor

购买并许可 Data Management 后，必须在 Tableau Cloud 上启用 Prep Conductor。有关详细信息，请参见[](https://help.tableau.com/current/online/zh-cn/prep_conductor_configure_online)[在 Tableau Cloud 站点上启用 Tableau Prep Conductor](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_configure_online.htm) 和 [许可 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_license.htm)。

## 此部分中的其他文章

<!-- document id=bc8150d48f2709836e2b5d4aecba3dfe8ee022fa2f92e861a21a706de645d886 url=/tableau/next/zh-cn/online/pulse_insights_platform_insight_types.md -->

[跳转到主要内容](#main-content)

# Tableau Pulse 中的见解平台和见解类型

当您在 Tableau Pulse 中创建指标时，您将自动获取 Tableau Pulse 检测到的每个指标的见解。Tableau Pulse 中的见解平台可检测指标的驱动因素、趋势、贡献者和异常值。它使用自然语言和视觉解释主动标记和描述重要的见解。每个指标的最重要见解与该指标一起显示。

Tableau Pulse 还会针对其检测到的指标见解提出问题。这种引导式问答体验逐步揭示了指标上下文中的见解。当您点击有关数据的建议问题时，答案会显示在的图表中，其中包含有关基础数据的见解。

有关详细信息，请参见 [Tableau Pulse：通过自动化见解主动解答您的常见业务问题](https://www.tableau.com/zh-cn/blog/tableau-pulse-automated-business-insights)和 [Tableau Pulse 如何通过问答方式实现 NLP，从而帮助每个人](https://www.tableau.com/zh-cn/blog/how-tableau-pulse-approaches-nlp-with-qa)。

## Tableau Pulse 检测到的见解类型

用户通常询问的有关指标的问题可以分为众所周知的分析模式：描述性、诊断性、预测性和规范性。

- 描述性问题：我的指标发生了什么变化？
- 诊断性问题：为什么会发生这种情况？
- 预测性问题：接下来可能会发生什么？
- 规范性问题：我应该采取什么行动？

Tableau Pulse 中的见解平台专注于帮助用户回答有关其指标的基本描述性问题，例如：

- 自上一期间或去年同期以来，指标值发生了多少变化？
- 指标随时间变化的趋势如何？
- 维度的哪些成员对指标值的贡献最大？
- 还有哪些其他维度正在将指标值推向有利的方向？

Tableau Pulse 中的见解可以提醒用户 Tableau Pulse 指标中隐藏的更改或异常，以便他们更好地诊断问题。例如：

- 指标值比正常值高还是低？
- 指标值是否异常集中在某个维度的少数实体中？
- 该指标的趋势最近有变化吗？
- 是否存在影响指标值的异常大记录或异常值？

## Tableau Pulse 中的见解类型

Tableau Pulse 中使用以下见解类型：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 40%;"><col style="width: 40%;"></colgroup><tbody class="table--plain"><tr><td><b>见解类型</b></td><td><b>描述</b></td><td><b>是否可配置？</b></td></tr><tr><td><p>期间变化</p></td><td><p>显示指标在两个时间段之间的变化情况。</p><p>这种见解显示为每个指标的一部分。</p></td><td><p>默认情况下始终开启</p><p>Tableau Pulse 将期间变化见解视为见解摘要。</p></td></tr><tr><td>相关指标（需要 Tableau+ 许可版本）</td><td>根据考虑相关的候选指标显示两个指标之间的关系。</td><td>可以在指标定义设置的“见解”选项卡中打开或关闭。需要选择最多五个可能的相关候选项与单个指标定义进行比较。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights" target="_blank" class="xref">配置见解</a>。</td></tr><tr><td><p>记录级别异常值</p></td><td><p>在一段时间内指标的行级值的上下文中，显示指标的极高值或极低值。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。需要选择记录标识符字段。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights" target="_blank" class="xref">配置见解</a>。</p></td></tr><tr><td><p>预测（需要 Tableau+ 许可版本）</p></td><td><p>显示某个指标在该期间剩余时间的预期值，以及预测置信度范围。预测是根据历史指标数据计算的，并且只有在 Tableau Pulse 对预测有信心时才会出现在指标的概览图表上。预测置信度受数据质量、方差和新近度以及要预测的日期周期数的影响。您可以使用指标的见解探索页面上的“询问”按钮查看低置信度预测。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>当前趋势</p></td><td><p>显示当前趋势以传达指标值的变化率、方向和波动。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>趋势变化警报</p></td><td><p>显示与当前趋势显著不同的新趋势。这种见解传达了指标值的变化率、方向和波动。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>意外值</p></td><td><p>显示给定时间范围内的指标值何时高于或低于基于该指标的历史观察结果的预期范围。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p><p>关闭此见解以隐藏意外值见解的文本描述和预期范围（图表中的蓝色阴影带）。</p><p>Tableau Pulse 将意外值见解视为见解摘要。</p></td></tr><tr><td><p>目标和阈值细分</p></td><td><p>在指标的细分图表上显示达到目标或阈值的进度。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>目标进度（需要 Tableau+ 许可版本）</p></td><td><p>显示具有总和或计数聚合的指标是否有望在期间结束时达到其目标。需要打开“预测”见解。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。如果您关闭“预测”见解，“目标进度”见解也会关闭。</p></td></tr><tr><td><p>主要驱动因素</p></td><td><p>显示与观察到的指标变化方向相同的变化最大的维度成员的值。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>主要贬损因素</p></td><td><p>显示与观察到的指标变化相反方向变化最大的维度成员的值。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>集中贡献警示（风险垄断）</p></td><td><p>显示少数维度成员何时占对指标贡献的大部分（50% 或更多）。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr><tr><td><p>主要促成因素</p></td><td><p>显示给定时间范围内指标的维度最高值。</p><p>主要促成因素是在指定时间范围内对范围指标值的贡献排名中排名前 N 的维度成员。</p></td><td><p>默认情况下始终开启</p><p>Tableau Pulse 使用指标中的主要促成因素见解进行细分。</p></td></tr><tr><td><p>排名靠后的促成因素</p></td><td><p>显示给定时间范围内指标的维度最低值。</p><p>排名靠后的促成因素是在指定时间范围内对范围指标值的贡献排名中排名后 N 的维度成员。</p></td><td><p>可以在指标定义设置的“见解”选项卡中打开或关闭。</p></td></tr></tbody></table>

## Tableau Pulse 如何生成和维护可信的见解

以下是 Insights 平台生成用户可以信赖的自动化业务见解的几种方法：

- Tableau Pulse Insights Service 首先使用标准化的确定性统计模型来检测有关保证准确的指标的事实。这些事实在生成见解时充当基本事实。
- 生成的每个见解都仅限于发出请求的用户的数据安全上下文（例如 RLS 设置）。这种方法确保用户只能看到他们有权查看的数据。
- 分析师可以启用或禁用针对指标检测到的不同见解，以便他们可以控制向用户提供的内容。

Tableau Pulse 将这一切整合在一起的方式如下：见解平台统计服务使用正在关注或查看的指标的分析上下文来运行自动统计分析，生成有关指标的事实。这些事实使用用户的数据安全上下文回答不同的问题。

见解摘要是使用基于统计事实的自然语言生成的。最相关的事实由 Tableau 中的 AI 处理。这些事实被用作将语言生成情境化的基本事实。当为站点启用 Tableau 中的 AI 时，生成的结果事实会捆绑在一起并作为见解摘要显示在整个 Tableau Pulse 的多个功能中。

## 见解平台如何确定相关性

为了减少嘈杂因素，Tableau Pulse 仅显示最相关、最有用的见解，并避免显示嘈杂因素或虚假的发现。见解平台考虑以下因素，以确保用户看到的见解相关且有用：

- **见解的分析上下文基于 Tableau Pulse 指标定义**。与在数据中的所有列中寻找见解的其他解决方案不同，见解平台将其分析限制到由分析师策划的指标定义引用的度量和维度。此外，在生成见解时，仅考虑正在查看或关注的指标用户的筛选上下文。
- **见解根据对指标的影响进行排名**。见解平台检测到的每个事实都会根据其对指标值的影响进行评分。仅首先返回被确定为对指标值最具统计影响力的事实。
- **反馈进一步使见解个性化**。用户可以对他们看到的见解提供赞成或反对的反馈，以表明这些见解是否有用。见解平台从中学习，进一步个性化向用户展示的见解类型。
    
    **注意**：当您的 Tableau 站点启用个性化见解排名站点设置时，用户可以对见解提供赞同或反对的反馈。默认情况下已启用此设置。有关详细信息，请参见[关闭个性化见解排名](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#PersonalizedInsightRankingSet)。

当结合使用时，这些因素可确保在针对某个指标检测到的所有见解中，只有最有用的见解才会在 Tableau Pulse 中显示给用户。

## Tableau 中的 AI 如何在 Tableau Pulse 中突出显示见解

启用所需的 Tableau 中的 AI 设置后，Tableau Pulse 会在自然语言摘要和对话式数据探索体验中提供见解。

### 见解摘要突出显示感兴趣的指标

当见解摘要打开并且您关注两个或更多指标时，Tableau Pulse 会提供概述，帮助您查看相关指标的最新见解。此见解摘要显示在摘要顶部和 Tableau Pulse 主页中。有关启用见解摘要的信息，请参见[启用指标见解摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#pulse-insight-summaries)。

Tableau Pulse 会查看您关注的指标，并利用 Tableau 中的 AI 来总结最重要的变化。期间变化和意外值是见解摘要中考虑的见解类型。

见解摘要使用大型语言模型以简单的语言提供个性化概述。Tableau 中的 AI 构建于 Einstein 信任层之上，从而能够在不损害数据安全和隐私的情况下实现可信、合乎道德且开放的 AI 驱动体验。有关详细信息，请参见[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)和[适用于 Tableau 的 Einstein 生成式 AI](https://help.tableau.com/current/tableau/zh-cn/about_tableau_gai.htm)。

### Pulse 中的 Tableau Agent 可为指标组提供相关见解

启用“Pulse 中的 Tableau Agent”后，它会显示在 Tableau Pulse 主页上，并按数据源、定义或时间范围分组显示指标。选择一个问题将带您进入一个页面，其中包含关键见解、相关可视化项、来源参考和建议的后续问题。由于它由 Tableau 中的 AI 提供支持，因此您可以用自己的语言提出问题，以获得与您的数据相关的自然语言答案。

Pulse 中的 Tableau Agent 是 一项必须在 Tableau Cloud 站点设置中启用的 Tableau+ 功能。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)和 [启用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-enhancedQA-discover)。

<!-- document id=1cc9cb44fe21b901152bb9bc5e68f0a21a1effd020d6ab1772982a95387c61d8 url=/tableau/next/zh-cn/online/pulse_intro.md -->

[跳转到主要内容](#main-content)

# Tableau Pulse 发行说明

了解 Tableau Pulse 最新版本中的新增功能。有关 Tableau Pulse 的常规信息，请参见[关于 Tableau Pulse](https://help.tableau.com/v0.0/online/zh-cn/pulse_about.htm)。此页面上的发行说明特定于 Tableau Pulse。有关 Tableau Cloud 上的其他功能，请参见[Tableau Cloud 发行说明](https://help.tableau.com/v0.0/online/zh-cn/whatsnew_online.htm)。

## 发行说明

### 2026 年 8 月 26 日新增

#### 在 Microsoft Teams 中接收指标摘要和通知

Tableau Pulse 可帮助您在工作流程中监视您的数据。现在，您可以在 Microsoft Teams 中接收有关发送给您的指标的重要更新。Tableau Pulse 摘要和通知会显示在您的消息中，因此您无需打开应用程序即可查看指标的表现。若要了解适用于 Microsoft Teams 的 Tableau 应用程序，请参见[在 Microsoft 365 中访问 Tableau 内容](https://help.tableau.com/v0.0/online/zh-cn/teams_explore.htm)。

![以 Microsoft Teams 消息形式发送的 Tableau Pulse 摘要，包含 3 个销售指标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_teams_digest.png)

若要在 Microsoft Teams 中接收摘要和通知，您必须至少使用一次 Tableau 应用程序，并至少关注一个指标。这些摘要会根据您在 Tableau Pulse 网站上设置的首选项进行发送。如果您想以不同的频率接收摘要、仅在摘要中接收您最喜爱的指标，或关闭特定指标的通知，请选择“管理摘要”前往 Tableau Pulse 网站，并更新您的首选项。有关详细信息，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)和[针对指标关闭通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm#turn-off)。

#### 使用标记组织指标

现在，在设置核心定义时，您最多可以向指标定义添加 10 个标记。若要了解操作方法，请参见[配置核心定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#create)。您添加的标记会显示在定义以及基于该定义的指标上。使用这些标记，您可以对指标进行排序并筛选指标定义。

若要对指标进行排序，请在 Tableau Pulse 主页上的“关注”选项卡中选择“排序依据”菜单，然后选择“标记”。

![Tableau Pulse 主页上按“Sales Leaders”标记排序的指标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_sort_tags.png)

标记还会作为筛选器显示在 Tableau Pulse 主页的“浏览指标”选项卡上。若要按标记筛选指标定义，请选择定义列表上方的标记之一。

![按“Sales Leaders”标记筛选的指标定义列表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_browse_tags.png)

#### 向 Pulse 中的 Tableau Agent 询问有关顶部或底部维度成员的信息（需要 Tableau+ 或 Try AI）

想了解哪些产品最畅销，或者哪些帐户遇到了问题？向 Pulse 中的 Tableau Agent 询问有关某个维度的排名靠前或排名靠后的贡献者、抑制因素或驱动因素的信息。如果有可以按该维度细分的目标或阈值，您可以询问维度成员相对于目标或阈值的表现。

默认情况下，如果您未指定数量，Pulse 中的 Tableau Agent 会报告前 7 个或后 7 个维度成员。您可以通过在问题中指定数字来了解最多 50 个维度成员。若要了解如何访问 Pulse 中的 Tableau Agent，请参见[使用 Pulse 中的 Tableau Agent 提问](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#quick-query)。

![按市场份额显示前 20 名销售代表的条形图](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_top_n.png)

#### 通过电子邮件摘要与 Pulse 中的 Tableau Agent 开始对话（需要 Tableau+ 或 Try AI）

选择指标组名称旁边显示的问题，探查您的电子邮件摘要中的指标。这些问题会打开 Pulse 中的 Tableau Agent，您可以在其中继续对话，以发现有关该指标组的更多见解。为了使这些问题出现在您的电子邮件摘要中，您必须按数据源或指标定义对指标进行排序。

![包含问题“是什么推动了这些变化？”的电子邮件摘要向 Pulse 中的 Tableau Agent 提问。](/tableau/next/zh-cn/online/zh-cn/Img/tableau_email_digest_hook.png)

### 2026 年 7 月 2 日新增

#### 在深色模式下查看您的指标

Tableau Pulse 现在使用您为 Tableau Cloud 设置的主题。您可以在 Tableau Cloud 帐户设置页面上设置主题。

1. 若要设置主题，请转到 Tableau Cloud 主页。如果您正在查看 Tableau Pulse，若要导航回 Tableau Cloud，请选择标题中 Tableau Pulse 标题旁边的箭头图标。
2. 选择右上角的个人资料图标。
3. 选择“我的帐户设置”。
4. 在“辅助功能”下，为“主题”选择“深色”。
5. 选择“保存更改”。

![以深色模式显示指标的 Tableau Pulse 主页](/tableau/next/zh-cn/online/zh-cn/Img/pulse_dark_mode.png)

#### 使用升级的 Pulse 中的 Tableau Agent 获得改进的答案（增强型问答）

Pulse 中的 Tableau Agent（以前称为增强型问答或 Discover）现在由 GPT-5.2 提供支持。这种升级的大型语言模型允许 Pulse 中的 Tableau Agent 在回答您的问题时更准确地处理更复杂的数据。有关 Pulse 中的 Tableau Agent 的详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)。

选择 GPT-5.2 模型是因为它最适合为 Pulse 中的 Tableau Agent 提供可靠和值得信赖的答案。请注意，此模型不会分析您的数据，而是借助 Tableau 通过统计分析预先计算得出的见解，来回答关于您的指标的问题。

#### 找出谁编辑了指标定义

新的“上次修改者”标签显示最近编辑指标定义的用户。此标签出现在主页的“浏览指标”选项卡上、基于定义列出指标的页面上以及指标的元数据信息中。

![指标定义列表上的“上次修改”列](/tableau/next/zh-cn/online/zh-cn/Img/pulse_last_modified_browse.png)

![指标详细信息元数据上的“上次修改”列表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_last_modified_details.png)

### 2026 年 6 月 18 日新增

#### 在现有 Tableau 站点上免费试用 Pulse 中的 Tableau Agent（增强型问答）

如果您是 Tableau 站点管理员，您现在可以使用 Try AI 站点设置激活 Pulse 中的 Tableau Agent（增强型问答）试用版。Try AI 是在现有 Tableau 站点上测试 AI 能力的唯一方法。开始试用就像在 Tableau Cloud 上激活设置一样简单，无需设置 Salesforce 组织。试用期为 60 天，您可以将 Pulse 中的 Tableau Agent（增强型问答）的访问权限限制为特定用户组，或者使站点上的所有用户都可以访问该功能。若要详细了解，请参见[试用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm)。

#### 限制对 Pulse 中的 Tableau Agent（增强型问答）的访问

作为 Tableau 站点管理员，当您启用 Pulse 中的 Tableau Agent（增强型问答）时，您可以将访问权限限制为特定用户组。此设置便于在向站点上所有用户开放 Pulse 中的 Tableau Agent 之前，让部分用户先行体验。若要了解如何调整站点设置，请参见[启用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-enhancedQA-discover)。

**注意：**增强型问答 (Discover) 已重命名为 Pulse 中的 Tableau Agent。功能保持不变。只是名称发生了变化。您将在即将发布的版本中看到名称更改。

### 2026 年 6 月 4 日新增

#### 创建时间点指标以跟踪数据快照

指标定义上的新时间性设置有两个选项：“跨时间段累积”和“最近时间点”。此时间性设置控制指标值是在整个期间内累积，还是最近日期的数据快照。若要了解如何配置核心指标定义，请参见[定义指标值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Define)。

![核心指标定义的时间性设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_point_in_time_setting.png)

将时间性设置为最近时间点时，指标值是该期间内最新日期的数据的聚合。如果指标图表上的点表示多于一天，则图表上每个点的值表示该点所表示的期间中的最新日期。此设置对于整个时间段的累积指标值没有意义的数据（例如库存数据）很有用。“最近时间点”徽章将显示在此类型的指标上。

![指标详细信息页面上的时间点徽章](/tableau/next/zh-cn/online/zh-cn/Img/pulse_point_in_time_badge.png)

“跨时间段累积”是默认时间性。具有“跨时间段累积”时间性的指标的值在整个时间段内是累积的，非累积指标图表上的每个点都是该点所涵盖期间的聚合值。在引入时间性设置之前，除非您使用高级编辑器计算时间点指标，否则所有指标都属于“跨时间段累积”时间性。

### 2026 年 4 月 14 日新增

#### 在主屏幕上监控 Pulse 指标

若要密切关注您最喜爱的 Pulse 指标，请将 Tableau 小组件添加到主屏幕。为了让小组件显示 Pulse 指标，您需要将指标添加为收藏夹并调整应用程序设置，以便小组件可以访问您的数据。若要了解如何为小组件配置设置和选择指标，请参见[“配置 Tableau 小组件以在主屏幕上显示指标”](https://help.tableau.com/current/mobile/mobile-user/zh-cn/tableau_mobile_interact.htm#widget)。

![显示通话时间和等待指标的小部件](/tableau/next/zh-cn/online/zh-cn/Img/pulse_mobile_widget.png)

### 2026 年 3 月 26 日新增

#### 筛选仪表板上的 Pulse 指标

Pulse 对象可让您将指标与可视化项一起添加到仪表板。您现在可以配置 Pulse 对象，使其在您在仪表板上选择输入筛选器时做出响应。为了使 Pulse 对象响应筛选器，筛选器必须是来自指标定义连接到的同一数据源的维度，并且该维度必须是指标定义上的可调整指标筛选器。有关配置 Pulse 对象以及筛选器如何与 Pulse 对象协同工作的信息，请参见[向仪表板中添加指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_dashboard.htm#dashboard-object)。

![Pulse 仪表板对象筛选器选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_dashboard_object_filters.png)

#### 在仪表板订阅中查看 Pulse 指标并导出图像

如果您收到包含图像的仪表板订阅，或者导出仪表板的图像，Pulse 指标现在包含在仪表板图像中。请注意，仪表板的 PDF 和 PowerPoint 导出尚不支持 Pulse 指标。若要了解如何订阅仪表板，请参见[创建视图或工作簿订阅](https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm)。

![电子邮件订阅图像中的 Pulse 销售指标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_dashboard_subscription.png)

### 2026 年 3 月 12 日新增

#### 通过简化的电子邮件摘要了解您的指标概览

Tableau Pulse 电子邮件摘要采用新布局，可帮助您快速掌握指标的最新情况。紧凑的设计将有关更多指标的关键信息显示在屏幕上。若要确保收到电子邮件摘要，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)。

![电子邮件摘要中的指标简明列表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_digest_redesign.png)

#### 通过内联可视化项了解增强型问答见解（需要 Tableau+ 许可版本）

当增强型问答回答您的问题时，它会提供一份见解摘要，其中包含每个见解来源的引用。现在，该见解摘要通过来自最关键见解来源的内联可视化项来说明。以前，您需要单击每个引文才能查看见解来源。如果有多个见解来源，您仍然可以单击引文编号查看其他见解来源及其可视化项。有关使用增强型问答的信息，请参见[使用 Pulse 中的 Tableau Agent 探索指标组](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#Explore)。

![一个内联条形图，支持关于总收入的见解](/tableau/next/zh-cn/online/zh-cn/Img/pulse_inline_viz.png)

### 2026 年 2 月 6 日新增

#### 从 Tableau Pulse 主页轻松挖掘数据（需要 Tableau+ 许可版本）

Tableau Pulse 主页上新的“使用 AI 进行发现”按钮让您可以快速访问增强型问答体验。增强型问答（也称为“发现”）是一种由 AI 提供支持的对话式数据调查方式。使用自然语言提出问题，增强型问答将查看组中的指标以发现见解。为了使“使用 AI 进行分析”按钮出现在您的主页上，您的指标必须按数据源或定义排序。有关增强型问答的详细信息，请参见[使用 Pulse 中的 Tableau Agent 探索指标组](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#Explore)。

![一组指标上方的“使用 AI 进行分析”按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_quick_query.png)

### 2026 年 1 月 29 日新增

#### 针对指标关闭通知

当您关注的指标越过不利的阈值范围或出现新的不利趋势时，您会收到通知。如果您不想收到特定指标的通知，请关闭该指标的通知。若要关闭通知，请选择该指标的操作（⋮ 或 ⋯）菜单，然后选择“关闭通知”。

![关闭指标的通知菜单选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_turn_off_alert.png)

若要查看您已关闭通知的指标的列表，请在任何 Tableau Pulse 页面的右上角选择您的用户图标。选择“首选项”，然后选择“通知”选项卡。如果您决定要再次接收通知，请单击此列表中的指标将其打开，选择操作菜单，然后选择“打开通知”。

![包含已关闭通知的指标的列表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_alert_preferences.png)

#### 为您的目标或阈值指定一个自定义名称

如果默认标签“目标”或“阈值”不代表您组织的数据，您可以输入自定义标签以向指标查看者显示。您可以为数据源目标和阈值以及手动目标和阈值设置自定义标签。有关设置目标和阈值的信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)以及[使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm)。

![自定义目标标签选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_custom_goal_label.png)

此自定义标签显示在目标或阈值进度指示器上、指标图表上以及见解中。例如，带有自定义标签“目标”的目标表示已达成的目标金额。

![自定义标签，显示已达成目标金额目标指示器](/tableau/next/zh-cn/online/zh-cn/Img/pulse_custom_goal_progress.png)

#### 通过增强型问答了解相关指标（需要 Tableau+ 许可版本）

现在，您可以询问有关指标之间相似性的增强型问答。增强型问答可让您深入了解相关性的强度和方向，以及它是正的还是负的。若要访问增强型问答，请选择指标上的“提问”按钮，然后选择增强型问答问题。或者，从 Pulse 主页中，选择一组指标的增强问答问题之一。

![相关指标见解简报显示 COGS 与单位材料价格之间的关系](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_correlation.png)

增强型问答仅根据已确定相关候选项的指标定义查找相关性。为了通过增强型问答来解释相关性，相关系数必须至少为 0.7，并且相关性必须在您询问的特定时间段内发生。有关配置相关候选项的信息，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。

### 2026 年 1 月 8 日新增

#### 监控指标是否有望实现其目标（需要 Tableau+ 许可版本）

对于已设置目标的指标，您现在可以看到该指标是否有望在当前期间结束时实现其目标。指标的“正在进行”或“偏离正轨”状态将出现在目标进度旁边，图表上的预测线将变为绿色或红色以反映此状态。如果您不希望此信息出现在指标上，请在指标定义上关闭目标进度见解类型。有关详细信息，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。

![目标实现进度见解，显示本季度的目标正按计划进行](/tableau/next/zh-cn/online/zh-cn/Img/pulse_pace_to_goal.png)

#### 跟踪您的收藏夹指标

如果有您要监控的关键指标，请选择星形图标将它们添加到收藏夹。若要将指标添加为收藏夹，您必须关注该指标。

![指标上的收藏夹星形图标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_favorite_metric.png)

您可以筛选 Tableau Pulse 主页上显示的指标，以便仅查看收藏夹。您还可以调整摘要首选项，以仅在电子邮件和 Slack 摘要中显示收藏夹指标。请注意，如果您将摘要设置为仅显示收藏夹，您仍然会收到您关注的任何指标的通知。有关设置摘要首选项的信息，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)。

![按全部或收藏夹指标筛选选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_favorite_filter.png)

### 2025 年 12 月 18 日新增

#### 验证您的自定义日历

当您将自定义日历配置为指标定义的一部分时，Tableau Pulse 会验证数据以确保其格式正确。如果您的自定义日历未通过此验证，您会看到一条错误消息，可帮助您排查日历问题。显示的错误是 Tableau Pulse 遇到的第一个错误。若要了解 Tableau Pulse 如何验证自定义日历中的字段，请参见[自定义日历的要求](https://help.tableau.com/v0.0/online/zh-cn/pulse_data_source_requirements.htm#ds-requirement-calendar)。

![已在使用的月份的自定义日历错误消息](/tableau/next/zh-cn/online/zh-cn/Img/pulse_custom_calendar_validation.png)

### 2025 年 11 月 20 日新增

#### 接收有关指标重要更改的移动通知

现在，当 Tableau Mobile 检测到您关注的指标发生不利变化时，它会以推送通知的形式向您发送通知。当指标越过不利阈值范围以及检测到新的不利趋势时，将发送这些通知。点击通知可了解有关这些数据更改的更多信息。

![不利趋势的移动通知](/tableau/next/zh-cn/online/zh-cn/Img/pulse_mobile_push_notification.png)

若要接收推送通知，您必须在设备上开启 Tableau 应用程序的通知。即使 Tableau Mobile 应用程序已关闭，只要您开启了通知，您就会收到这些通知。如果您使用的是 Android 设备，则在安装 Tableau 应用程序时，这些通知默认情况下是关闭的。

##### 在 Android 上开启通知

1. 在 Android 设备上，导航到“Settings”（设置）\>“Notifications”（通知）\>“App notifications”（应用程序通知）。
2. 从菜单中，选择“All apps”（所有应用程序）。
3. 选择“Tableau”。
4. 在“notification categories”（通知类别）下，选择“Show unused categories”（显示未使用的类别）。
5. 选择“Other”（其他）。
6. 确保“Tableau Pulse”开关已打开。

##### 在 iOS 上开启通知

1. 在 iOS 设备上，导航到“Settings”（设置）\>“Notifications”（通知）。
2. 选择“Tableau”。
3. 确保“Allow Notifications”（允许通知）开关已打开。

#### 从有关目标和阈值的增强型问答中获取见解（需要 Tableau+ 许可版本）

如果指标有目标或阈值，增强型问答现在具有该上下文，并为您提供有关数据相对于目标或阈值的表现的见解。若要访问增强型问答，请选择指标上的“提问”按钮，然后选择增强型问答问题。或者，从 Tableau Pulse 主页中，选择一组指标的增强问答问题之一。

![关于实现目标可能性的见解](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_goal.png)

#### 在 Tableau Pulse 主页上查看目标和阈值

主页的“关注”选项卡上显示的指标卡现在显示目标和阈值信息。一目了然，您可以看到与前期相比以及相对于目标或阈值的所有指标的表现。

![指标卡上显示的季度目标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_home_card_goal.png)

#### 转到指标的已连接数据源

指标和指标定义现在链接到它们所连接的数据源，让您可以轻松地在 Tableau Cloud 中打开该数据源。

- 在指标定义上，转到核心定义步骤，然后选择数据源名称。
    
    ![链接到指标定义上的数据源](/tableau/next/zh-cn/online/zh-cn/Img/pulse_definition_data_source_link.png)
- 在指标上，选择信息图标以查看指标元数据，然后选择数据源名称。
    
    ![链接到指标上的数据源](/tableau/next/zh-cn/online/zh-cn/Img/pulse_metric_data_source_link.png)

### 2025 年 11 月 6 日新增

#### 查看图表上的描述性图例

指标的概览图表现在显示一个图例，用于标记图表上的每个元素。图例可帮助您了解图表上的哪些数据是完整的、哪些仍在进行中、哪些是预测，以及任何目标或阈值。

![显示已完成和正在进行的值和预测的图表图例](/tableau/next/zh-cn/online/zh-cn/Img/pulse_legend.png)

#### 使用高级定义中的用户函数筛选数据

当您使用高级编辑器创建指标定义时，您现在可以添加用户函数来为特定用户或组筛选数据。如果您在指标定义所连接的数据源上没有行级安全性，这些函数是一个有用的替代方案。有关编写用户函数的详细信息，请参见[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm)。

### 2025 年 10 月 23 日新增

#### 控制用户可以接收摘要的渠道

作为 Tableau Cloud 管理员，您现在可以关闭用户通过电子邮件和 Slack 接收 Tableau Pulse 摘要和通知的功能。关闭某个渠道后，会在用户的 Tableau Pulse 首选项中显示一条消息，通知用户这一点。有关详细信息，请参见[配置摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#digest-time)。

![摘要渠道的站点设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_channel_setting.png)

#### 设置生成摘要的日期

作为 Tableau Cloud 管理员，您现在可以设置生成每周和每月摘要的周中某日和月中某天。Tableau Pulse 在这些日期的指定开始时间开始生成摘要。有关详细信息，请参见[配置摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#digest-time)。

![摘要计划的站点设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_schedule_setting.png)

### 2025 年 10 月 3 日新增

#### 检查指标的预测

指标的概览图表现在显示该指标在该期间剩余时间的预期表现的预测。预测可用于具有 Tableau+ 许可版本的站点，并且仅显示在具有期初至今时间范围的指标上。如果 Tableau Pulse 对预测没有信心，则预测不会显示在概览图表上，但您仍然可以使用“提问”按钮查看预测。如果您不希望指标显示预测，请在指标定义上关闭预测见解类型。有关预测见解类型的详细信息，请参见[Tableau Pulse 中的见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm#InsightTypesList)。

![月末指标预测](/tableau/next/zh-cn/online/zh-cn/Img/pulse_forecast.png)

#### 克隆现有指标定义

通过克隆现有定义，在创建指标定义方面取得先机。克隆定义时，除治理步骤外，原始定义中的所有配置都会保留下来。如果需要为同一数据源中的不同度量设置定义，克隆尤其有用。若要保存克隆的定义，您必须更改一个或多个度量、聚合、时间维度或可调整指标筛选器，以使克隆的定义与原始定义不相同。有关详细信息，请参见[克隆指标定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#clone)。

![“克隆定义”按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_clone_definition.png)

#### 通过增强型问答询问有关滚动时间段的问题

现在，您可以询问过去 7 天、14 天、30 天、60 天或 90 天内您的数据发生了什么。增强型问答将提供使用可应用于指标的相同滚动日期窗口筛选器分析该精确时间段的答案。若要访问增强型问答，请选择指标上的“提问”按钮，然后选择增强型问答问题。或者，从 Pulse 主页中，选择一组指标的增强问答问题之一。增强型问答需要 Tableau+ 许可版本。

![最近 14 天时间段的增强型问答结果](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_last_14_days.png)

### 2025 年 9 月 11 日新增

#### 设置可根据数据动态调整的日期偏移

对于涵盖期初至今时间范围的指标，为指标显示的值适用于今天的日期。如果指标的数据源没有今天的数据，则指标值为 null。在指标定义上设置动态日期偏移，以便指标显示过去某个日期的值而不是 null。通过动态偏移，Tableau Pulse 会调整指标的时间序列，使其以具有数据的最近日期结束。有关详细信息，请参见[设置日期偏移](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#date-offset)。

![动态偏移时间设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_dynamic_offset.png)

#### 更易于阅读 Discover 简报

增强型问答 (Discover) 现在使用智能 Markdown 格式来生成易于阅读的见解摘要。AI 生成的见解摘要自动构建，包含标题、要点和摘要，使您可以更轻松地快速浏览和理解您的见解。

**注意：**Discover 中的见解摘要当前不支持自定义格式设置控制。

![Discover 见解概要](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_formatted_briefs.png)

### 2025 年 8 月 28 日新增

#### 在细分图表上显示更多促成因素

想知道不同的维度成员对指标的贡献如何？选择“显示更多”以在细分图表上列出更多促成因素。细分图表一开始显示 7 个促成因素，每次选择“显示更多”时会再显示 7 个促成因素，总共最多可显示 50 个促成因素。

![“显示更多促成因素”按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_show_more.png)

#### 将指标的时间范围设置为滚动时间窗口

滚动窗口显示最近 7 天、14 天、30 天、60 天或 90 天的数据。您还可以选择一个窗口，该窗口以月为单位显示 1 年的数据，并且该窗口以最近一个完整的月结束。这些指标的比较期遵循相同的滚动窗口。

若要调整时间范围，请选择指标上的“筛选器”选项。设置此筛选器时，如果尚不存在具有这些筛选器的指标，则会创建一个新指标。请务必关注筛选后的指标来跟踪它。关注者不会从的上一个指标延续下来。

![滚动时间窗口选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_rolling_window.gif)

#### 使用生成式 AI 在探索指标时提出问题 (Tableau+)

对于任何指标，您都可以单击“提问”以使用语义搜索提出问题，或使用生成式 AI 进行深入研究。在同一界面中，使用 Ask Q&A 快速查找可信的见解，或使用增强型问答 (Discover) 在同一上下文中进行更具对话性的 LLM 引导式探索。

![关于指标的生成式 AI 问题](/tableau/next/zh-cn/online/zh-cn/Img/pulse_insight_ask_discover.png)

从 Tableau Pulse 中的任何指标详细信息页面中，在“发现热门见解”下单击“提问”按钮。在第一个搜索栏中输入问题，以对检测到的见解运行语义搜索。从搜索结果中，单击带有闪光图标的问题以将增强型问答与 LLM 引导式探索结合使用。在打开的 Discover 页面中，针对您关注的同一指标或相关指标提出后续问题，所有这些都在同一个对话流程中进行。

您可以询问有关共享相同数据源的指标的问题。LLM 回复的响应可能因可用数据和见解范围而异。仅在 Tableau+ 中可用。

#### 增强型问答 (Discover) 体验和见解摘要中现在支持地理感知 LLM 请求路由

Tableau Pulse 增强型问答 (Discover) 现在支持使用 Azure Open AI 通过 Einstein GPT 网关进行地理感知 LLM 路由。（需要 Tableau+ 或 Einstein 1。）LLM 请求将根据您的 Salesforce 组织路由到最近的受支持区域，这改善了延迟并支持数据驻留要求。发现请求是使用您的 Salesforce 组织 ID 发出的，该 ID 允许在使用必要的权利时屏蔽和路由控制。Tableau Pulse 中的见解摘要使用 Tableau 管理的组织 Id，也支持地理感知 LLM 查询。

除了必要的权利外，不需要手动设置或区域选择。当与付费权利绑定时，可以控制屏蔽。

如果最近的区域不可用或超载，流量会自动回退到美国的 Azure OpenAI 位置。来自任何 Azure OpenAI 区域的回退始终路由到美国 Azure OpenAI 区域，从不直接路由到 OpenAI。有关详细信息，请参见 [Einstein 生成式 AI 平台上的地理感知 LLM 请求路由](https://help.salesforce.com/s/articleView?id=ai.generative_ai_platform_geo_aware_routing.htm)。

无法禁用回退设置。只有 Tableau+ 客户具有审核日志访问权限，可以查看何时发生回退，并可以从审核日志中获取回退事件数据。

### 2025 年 8 月 14 日新增

#### 通过“相关指标”见解了解相关指标的相似或不同之处

相关指标是一种新的见解类型，可以回答诸如“客户满意度与等待时间有何关系？”等问题Tableau Pulse 现在可以显示某个指标与另一个已被标记为考虑候选指标的相似或不同之处。

![显示相关性的指标图表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_insight_correlated_metric.png)

编辑指标定义时，您最多可以为 Tableau Pulse 选择最多五个候选项，以考虑与指标的相关性。这些候选项是您认为与指标相关的指标定义，并且预计会以相似或非常不同的方式移动。

![用于选择相关候选项的选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_insight_correlated_metric_candidates.png)

有关设置相关指标的详细信息，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。

#### 在适用于 Microsoft Teams 的 Tableau 应用程序中了解 Tableau Pulse 见解和通知

Tableau 应用程序中现在提供了更多 Tableau Pulse 功能。

- 见解摘要：查看 Tableau Pulse 主页上的见解摘要，大致了解数据的重要变化。
- 通知：查看您关注的指标发生不利变化的通知。
- 以您的首选语言显示的指标见解：为各个指标显示的见解自动反映为 Microsoft Teams 设置的语言。请注意，见解摘要使用为 Tableau 应用程序设置的语言，该语言是与 Microsoft Teams 语言设置不同的设置。

![Microsoft Teams 应用程序中的 Tableau Pulse](/tableau/next/zh-cn/online/zh-cn/Img/pulse_teams_app.png)

有关适用于 Microsoft Teams 的 Tableau 应用程序的信息，请参见[设置指南：适用于 Microsoft Teams 的 Tableau 应用程序](https://github.com/tableau/tableau-app-msft-teams)。

### 2025 年 8 月 7 日新增

#### 在指标细分图表上显示目标或阈值

在指标的“细分”选项卡上，您可以更改图表详细信息以显示目标或阈值数据。仅当在指标定义中设置了数据源目标或阈值时，才会显示此选项。您可以通过调整指标定义的见解设置上的“目标和阈值细分”见解来关闭此选项。有关调整见解的信息，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。有关指标详情的信息，请参见[详细探索指标、调整时间范围或应用筛选器](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#explore-detail)。

![图表详细信息选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_chart_detail.png)

#### 获取非周期 Slack 警报

如果您没有计划在 Tableau Pulse 识别通知的那一天接收 Slack 摘要，您现在会收到包含该通知的 Slack 消息。Tableau Pulse 每 24 小时检查您关注的指标，看看它们是否已经越过了不利的阈值范围，或者数据是否有新的不利趋势。在您接收 Slack 摘要的日子里，通知会显示在摘要的顶部，而不是显示为单独的消息。有关通知的详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。

![Slack 中的 Tableau Pulse 通知](/tableau/next/zh-cn/online/zh-cn/Img/pulse_slack_alert.png)

### 2025 年 7 月 24 日新增

#### 获取阈值通知

当您关注的指标进入不利的阈值范围时，您会在电子邮件、Slack 和 Tableau Mobile 中收到通知，并且 Tableau Pulse 站点上会显示通知。有关详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。

![超过阈值通知](/tableau/next/zh-cn/online/zh-cn/Img/pulse_threshold_crossed_alert.png)

#### 设置不利阈值范围

定义指标应高于还是低于阈值。您可以为数据源阈值和手动阈值设置不利范围。当指标的聚合值进入不利范围时，Tableau Pulse 会生成阈值通知。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)以及[创建手动目标或阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm#create-goal)。

![不利阈值范围设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_threshold_unfavorable_range.png)

#### 搜索指标定义并对其进行排序

在“浏览指标”选项卡上，选择搜索图标以搜索指标定义的列表。选择“已认证”、“指标定义”或“指标”列标题以按这些列进行排序。

![搜索指标定义](/tableau/next/zh-cn/online/zh-cn/Img/pulse_search_definitions.png)

### 2025 年 7 月 10 日新增

#### 通过跨指标分析发现跨多个指标的见解

增强型问答 (Discover) 现在支持跨指标分析，允许您并排比较指标并呈现有意义的模式。它可以突出显示共同的贡献者，检测趋势何时一起或向相反方向移动，标记多个指标中的异常值实体，并识别共同高于或低于预期范围的指标，所有这些都在单个自然语言响应中完成。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)。

### 2025 年 6 月 5 日新增

#### 通过非周期通知电子邮件随时了解情况

现在，如果 Tableau Pulse 在您不打算接收摘要的那一天发现通知，它就会发送电子邮件。以前，通知仅作为摘要的一部分发送。如果您的摘要频率设置为每周或每月，则在没有摘要的日子里，您不会收到有关通知的电子邮件通知。有关通知的详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。

![Tableau Pulse 通知电子邮件](/tableau/next/zh-cn/online/zh-cn/Img/pulse_alert_email.png)

### 2025 年 5 月 22 日新增

#### 为指标设置阈值

通过设置数据源或手动阈值来衡量指标相对于阈值的表现。数据源阈值是您根据指标定义设置的动态值。手动阈值是您为单个指标设置的单个静态值。查看指标的任何人都会看到阈值。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)和[使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm)。

![在指标上设置的阈值](/tableau/next/zh-cn/online/zh-cn/Img/pulse_threshold.png)

### 2025 年 5 月 7 日新增

#### 设置自定义日历

如果标准公历不适合贵组织的数据，请设置自定义日历。您现在可以灵活地配置日历，例如 4-5-4 零售日历。Tableau Pulse 基于自定义日历聚合不同时间范围和比较期间的指标数据。有关详细信息，请参见[设置自定义日历](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#custom-calendar)。

![自定义日历设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_custom_calendar.png)

#### 在增强型问答 (Discover) 中根据维度成员提出问题

让您的用户自由追随他们的好奇心，探索不同的区域、细分市场或时间段，所有这些都是通过增强型问答 (Discover) 中的自然语言完成的。Discover 现在可以处理基于维度值（区域、产品、细分市场）筛选指标的问题，或者比较维度成员（西部与东部）以发现有意义的模式。

例如，您可以要求“显示加利福尼亚州的销售额”或“比较亚太地区与欧洲、中东和非洲地区”，以自动将您的探索扩展到整套兼容指标。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#top)。

![“发现”页面，其中包含有关用于确定上下文范围的维度成员的问题](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_dimension_question.png)

#### 通过增强型问答 (Discover) 以您的首选语言提出问题并获得答复

增强型问答 (Discover) 现在支持多语言问题和响应，与 Tableau Cloud 支持的语言保持一致。建议的问题、后续问题和见解简报会根据站点的语言设置进行调整。当您提出问题时，Discover 会检测您的输入语言，并返回该语言的 LLM 响应 - 即使它与站点或数据语言不同。指标名称和筛选器始终保留其原始制作语言，以保持清晰和一致性。有关详细信息，请参见[Pulse 中的 Tableau Agent 中对问题和回复的多语言支持](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#Multilin)。

![“增强型问答 (Discover)”页面，包含西班牙语的见解摘要和问题](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_multilingual.png)

### 2025 年 4 月 24 日新增

#### 认证指标定义

通过认证指标定义，告诉其他人某个指标定义是可信和推荐的。认证徽章将出现在基于认证定义的指标上。该徽章可帮助用户自信地依靠这些指标做出业务决策。

您需要在作为编辑或创建定义一部分的新治理步骤中认证指标定义。指标定义的现有权限设置也已移至治理步骤。有关详细信息，请参见[配置治理](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-governance)。

![认证定义切换](/tableau/next/zh-cn/online/zh-cn/Img/pulse_certified_definition.png)

### 2025 年 4 月 10 日新增

#### 自定义见解摘要中的指标

当您关注某个指标时，有关该指标的显着变化可能会出现在 Tableau Pulse 主页顶部的见解摘要以及 Slack 和电子邮件摘要中。现在，您可以通过屏蔽指标来进一步自定义这些摘要。将指标屏蔽时，有关该特定指标的见解将从摘要中移除，而不会取消关注该指标。有关详细信息，请参见[自定义主页和摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#Grouping)。

### 2025 年 3 月 27 日新增

#### 为指标设置自定义比较日期

对于筛选为“今天”或“昨天”的指标，自定义比较将覆盖与前一天或一年前同一天的比较。此比较选项允许您比较每年不在同一日期的事件的数据。有关详细信息，请参见[设置自定义每日比较](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#custom-daily)。

![自定义每日比较和参考日期设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_custom_comparison.png)

#### 选择指标值的小数位数

如果需要使用一致的小数位数设置数据格式，则可以选择从 0 到 5 的精确数字。默认情况下，Tableau Pulse 会自动确定要显示的小数位数，值越大显示的小数位数越少。有关详细信息，请参见[定义指标选项](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#options)。

![小数位选项 0 到 5](/tableau/next/zh-cn/online/zh-cn/Img/pulse_decimal_places.png)

2025 年 3 月 13 日新增

#### 通过增强型问答功能发现更多见解 (Tableau+)

增强型问答 (Discover) 可以更轻松地探索跨业务关键指标组的见解，然后在“发现”页面上进行更深入的挖掘。当 Tableau Pulse 中的指标按数据源、定义或时间范围分组时，Discover 会使用统计算法来检查分组指标并发现相关、有趣且值得研究的见解。

![Tableau Pulse 中的“发现”页面，其中包含见解简要、指标来源以及用户输入的新问题](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_intro.png)

增强型问答体验提供了直观的关键见解、相关可视化项、来源参考和建议的后续问题，以帮助您深入挖掘。由于它由 Tableau 中的 AI 提供支持，因此您可以用自己的语言提出问题，以获得与您的数据相关的自然语言答案。

增强型问答 (Discover) 是 Tableau Pulse 中的一项 Tableau+ 高级功能，可在 Web 和移动设备上使用。增强型问答 (Discover) 必须在 Tableau Cloud 站点设置中启用，并且需要连接到为所选 Salesforce 组织设置了 Einstein 生成式 AI 的 Salesforce 组织。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)和 [启用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-enhancedQA-discover)。

#### 任何语言的 Ask Q&A 都可以实现更好的语义匹配

当您使用 Ask Q&A 时，启用此设置可增强任何语言的语义匹配。当此设置打开时，问题和见解文本将作为语义匹配的一部分发送给 OpenAI。对 OpenAI 的所有调用都会经过 [Einstein 信任层](https://help.salesforce.com/s/articleView?id=sf.generative_ai_trust_layer.htm&type=5)。有关详细信息，请参见[在 Tableau 中为 Ask Q&A 启用更好的语义匹配](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-better-semantic-match-ask)

#### 获取新的不利趋势通知

如果 Tableau Pulse 检测到您关注的指标数据中出现了新的不利趋势，您会在电子邮件和 Slack 摘要中收到有关该趋势的通知。如果使用 Tableau Mobile，您还会在移动设备上收到通知。有关详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。

![Tableau Mobile Pulse 针对新的不利趋势发出警报](/tableau/next/zh-cn/online/zh-cn/Img/pulse_mobile_alert.png)

#### 控制谁可以从数据源创建指标定义

数据源具有新的“创建指标定义”权限功能。通过此功能，您现在可以分别控制谁可以从数据源创建指标定义以及谁可以查看使用该数据源的指标。有关详细信息，请参见[用于创建指标定义的权限](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#permissions-create-definition)。

![“创建指标定义”的数据源权限](/tableau/next/zh-cn/online/zh-cn/Img/pulse_data_source_permission.png)

#### 调整 Tableau Pulse 开始生成摘要的时间

Tableau 站点管理员可以设置 Tableau Pulse 开始生成电子邮件和 Slack 摘要的时间。这样，如果您的数据在特定时间刷新，摘要将反映最新的数据。有关详细信息，请参见[配置摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#digest-time)。

![摘要开始时间的站点设置](/tableau/next/zh-cn/online/zh-cn/Img/pulse_digest_site_setting.png)

#### 设置数据源目标的聚合类型

您现在可以选择 Tableau Pulse 如何聚合数据源目标的数据。度量可聚合为总和、平均值、中值、最大值或最小值，维度可聚合为计数或非重复计数以生成度量。以前，所有数据源目标都聚合为总和。此外，您现在可以为使用任何聚合的指标定义设置数据源目标。以前，您只能为将度量聚合为总和或计数的指标定义创建数据源目标。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)。

![数据源目标聚合选择器](/tableau/next/zh-cn/online/zh-cn/Img/pulse_ds_goal_aggregation.png)

#### 创建高级数据源目标

高级编辑器允许您使用熟悉的 Tableau 可视化项制作环境创建数据源目标。您可以使用高级编辑器根据计算字段创建目标。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)。

![数据源目标高级目标选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_ds_goal_advanced.png)

2025 年 1 月新增

#### Tableau Pulse 数据源目标

创建或编辑指标定义时，您可以设置使用数据源中的字段来指定目标值的目标。该目标根据定义出现在指标上，并根据指标的时间范围进行汇总。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)和[指标定义的数据源要求](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-requirement-goals)。

#### Tableau Pulse 提供 14 种语言版本

Tableau Pulse 现在反映用户在 Tableau Cloud 上设置的语言和区域设置，以及在 Tableau Mobile 上为设备设置的语言。Tableau 支持英语（美国）、英语（英国）、法语（法国）、法语（加拿大）、德语、意大利语、西班牙语、巴西葡萄牙语、瑞典语、日语、朝鲜语、繁体中文、简体中文和泰语。有关详细信息，请参见 [Tableau Cloud 技术规格](https://www.tableau.com/zh-cn/products/techspecs)。

#### Tableau Pulse 链接至相关内容

创建或编辑指标定义时，您可以添加相关内容的链接。这些链接出现在每个指标的“见解探索”页面上。考虑包含相关仪表板、Slack 频道或工作流程的链接，以帮助其他人跟进数据。有关详细信息，请参见[配置核心定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#create)。

#### Tableau Pulse 仪表板对象的新边框样式

在仪表板中嵌入指标时，您可以选择 Tableau Pulse 样式选项，以便仪表板对象类似于 Tableau Pulse 中的圆角指标卡。如果没有此样式选项，仪表板上的指标将类似于其他无边框仪表板对象。有关详细信息，请参见[向仪表板中添加指标和从仪表板创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#dashboard-object)。

2024 年 12 月新增

#### 关闭 Tableau Pulse 中的意外值见解

在指标定义设置（“见解”选项卡）中，您可以关闭意外值见解以隐藏文本描述和预期范围（图表中的蓝色阴影带）。有关详细信息，请参见[Tableau Pulse 中的见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm#InsightTypesList)。

2024 年 11 月新增

#### Tableau Pulse 个性化见解排名设置

管理员可以在站点设置中关闭或打开 Tableau Pulse 个性化见解排名，与部署 Tableau Pulse 的设置无关。有关详细信息，请参见[关闭个性化见解排名](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#PersonalizedInsightRankingSet)。

2024 年 9 月新增

#### Tableau Pulse 货币设置

当您将定义设置为使用货币数字格式时，您现在可以设置使用哪个国家的货币，Tableau Pulse 将显示该货币符号和数字格式。

### 2024 年 8 月新增

#### Tableau Pulse 仪表板对象

您现在可以将 Pulse 指标对象添加到仪表板。添加此对象时，可以从连接到工作簿使用的相同已发布数据源的指标中进行选择。有关详细信息，请参见[向仪表板中添加指标和从仪表板创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#dashboard-object)。

#### Tableau Pulse 分组和排序

通过对指标进行分组和排序来自定义 Tableau Pulse 主页和摘要。您现在可以根据您最近关注指标的时间对指标进行排序，或者对共享指标定义或数据源的指标进行分组。有关详细信息，请参见[自定义主页和摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#Grouping)。

#### Tableau Pulse 目标

在 Tableau Pulse 中创建目标以跟踪指标实现该目标的进度。创建目标后，您将在 Tableau Pulse 摘要和 Tableau Pulse 主页上看到实现该目标的进度。有关详细信息，请参见[使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm)。

#### Tableau Pulse 改进了探索见解的“询问”体验

询问有关指标的更多问题，以获取基于相同指标定义的见解建议。您现在可以输入调整时间粒度和为当前指标视图应用维度筛选器的问题。例如，“上周加州的销售额”、“放大技术”或“昨天怎么样？”有关详细信息，请参见 [Tableau Pulse 如何通过问答方式实现 NLP，从而帮助每个人](https://www.tableau.com/zh-cn/blog/how-tableau-pulse-approaches-nlp-with-qa)。

#### Tableau Pulse for Salesforce 应用程序

Pulse for Salesforce 应用程序将您的 Salesforce 组织与 Tableau 连接起来，根据您的 Salesforce 数据创建指标，并在 Salesforce 中显示这些指标。有关详细信息，请参见[设置 Pulse for Salesforce 应用程序](https://help.tableau.com/v0.0/online/zh-cn/pulse_salesforce.htm)。

2024 年 7 月新增

#### Tableau Pulse 最小时间粒度

您现在可以为指标定义设置最小时间粒度，从而限制用户在通过筛选创建指标时可以选择的时间范围。这可以防止用户选择导致图表为空的时间范围，因为该粒度的数据不存在。有关详细信息，请参见[定义指标值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Define)。

#### 基于数据源的 Tableau Pulse 周开始时间

如果指标所连接的数据源的周开始日期与默认值（星期日）不同，则指标将反映该开始日期。对于处理每周值的指标图表和见解来说，该天显示为一周的第一天。

#### Tableau Pulse 限制指标定义编辑

您可以限制谁可以编辑或删除指标定义，以便只有特定用户和组才有访问权限。有关详细信息，请参见[限制对定义以及手动目标和阈值的编辑](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#edit-permissions)。

#### Tableau Pulse 记录级异常值见解类型

现在有一种新的见解类型，即记录级异常值，可帮助您轻松发现数据中影响指标值的异常值。在一段时间内指标的行级值的上下文中，此见解类型显示指标的极高值或极低值。有关详细信息，请参见[Tableau Pulse 中的见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm#InsightTypesList)。

#### Tableau Pulse 异常值见解设置

打开或关闭记录级异常值见解类型以控制 Tableau Pulse 是否在数据中查找极高或极低的值。有关详细信息，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。

2024 年 6 月新增

#### Tableau Pulse 日期偏移

现在，您可以将日期偏移添加到指标定义中，将时间序列中的终点从“今天”更改为过去几天。有关详细信息，请参见[定义指标值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Define)。

#### Tableau Pulse 可调指标筛选器的改进

当定义筛选器已应用于指标定义时，您可以选择的度指标筛选器选项现在仅显示相关值。这意味着，例如，如果指标定义的定义筛选器设置为将数据限制在某个区域，则只有该区域的城市才会显示为可调指标筛选器的选项。

#### Tableau Pulse 个性化见解排名

通过让 Tableau Pulse 了解您认为最有价值的见解，增强您的见解体验。您对见解的赞成和反对的反馈会影响您首先看到的见解。

#### Slack 中的 Tableau Pulse 图表

当您在 Slack 中查看 Tableau Pulse 摘要时，您现在将看到一个显示该期间数据的迷你图。

2024 年 3 月新增

#### Tableau Pulse 改进了仪表板的指标建议

当您探索仪表板的推荐指标时，Tableau 现在会显示更多相关和信息丰富的建议。此外，数据源中的计算字段现在会出现在建议中。

#### 指标定义中的 Tableau Pulse 预聚合字段

创建定义时，现在可以选择数据源中预聚合的字段，并将其用作度量。

#### 为指标显示的 Tableau Pulse 已应用筛选器

当您访问指标的“见解探索”页面时，应用于该指标的特定筛选器现在会在图表上方列出。

#### Tableau Pulse 改进了导航选项

Tableau Pulse Sparkle（“见解探索”页面的左上角）现在包括用于导航到 Tableau Cloud 主页和已关注指标的下拉选项。

#### Tableau Pulse 针对见解的特别问题

在引导式见解体验中，单击“提问”按钮，输入您自己的与某个指标的见解相关的问题。接收语义匹配的建议以获得更多见解。有关详细信息，请参见 [Tableau Pulse 如何通过问答方式实现 NLP，从而帮助每个人](https://www.tableau.com/zh-cn/blog/how-tableau-pulse-approaches-nlp-with-qa)。

2024 年 2 月新增

#### Tableau Pulse 关注指标

调整筛选器值，并关注基于相同定义的不同指标。当您关注某个指标时，时间段和筛选器选择将保留在 Tableau Pulse 主页和摘要中。有关详细信息，请参见[关注指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#follow)。

#### Tableau Pulse 引导式见解

Tableau Pulse 通过针对它检测到的指标的每个见解提出问题，提供了探索数据的途径。当您点击有关数据的建议问题时，答案会显示在易于阅读的图表中，其中包含有关基础数据的见解。有关详细信息，请参见[详细探索指标、调整时间范围或应用筛选器](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#explore-detail)。

#### Tableau Pulse 见解平台

见解平台可自动检测指标的驱动因素、趋势、贡献者和异常值。它使用自然语言和视觉解释主动标记和描述重要的见解。有关详细信息，请参见[Tableau Pulse 中的见解平台和见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm)。

#### Tableau Pulse 见解摘要

Tableau Pulse 会查看您关注的指标，并利用 Tableau 中的 AI 来总结最重要的见解。见解摘要使用大型语言模型 (LLM) 以简单的语言提供个性化概述。Tableau 中的 AI 构建于 Einstein 信任层之上，这意味着它可以在不损害数据安全和隐私的情况下实现可信、合乎道德且开放的 AI 驱动体验。有关详细信息，请参见[见解摘要突出显示感兴趣的指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm#insight-summaries)。

#### Tableau Pulse 指标层

指标层为您的数据提供了单一的真实来源。创建指标定义以指定指标所基于的核心元数据，然后调整筛选器和时间选项来为不同的关注者组创建指标。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。

#### Tableau Pulse 推荐的仪表板指标

通过选择为 Tableau 仪表板显示的推荐指标，在创建指标方面取得先机。有关详细信息，请参见[向仪表板中添加指标和从仪表板创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#recommended-metrics)。

#### Tableau Pulse 部署设置

选择为单个用户组或 Tableau 站点上的所有用户部署 Tableau Pulse。有关详细信息，请参见[为您的站点部署 Tableau Pulse](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#site-setting)。

#### Tableau Pulse 见解摘要设置

可以独立于用于部署 Tableau Pulse 的站点设置来打开或关闭见解摘要。有关详细信息，请参见[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)。

#### Tableau Pulse 会计日历支持

Tableau Pulse 现在反映已在数据源或数据源中的特定字段上设置的会计日历。有关详细信息，请参见[会计日历如何与指标配合使用](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#fiscal)。

#### Tableau Pulse 在线管理见解

Tableau Puse元数据已添加到在线管理见解的“站点内容”、“用户”和“订阅”数据源中。管理员可以使用这些数据源来了解站点上的定义和指标。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

#### Tableau Pulse 主要时间对比

现在，您可以将主要时间对比设置为指标定义的一部分，并且基于该定义的所有指标都将在摘要和见解中使用该对比。有关详细信息，请参见[定义指标值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Define)。

<!-- document id=74b9d2e37e907f24a66bbbbdde2c5a00538b3efeac0fb187510d7f8d648d1c2c url=/tableau/next/zh-cn/online/rls_options_overview.md -->

[跳转到主要内容](#main-content)

# Tableau 中的行级安全性选项概述

有时您想根据请求数据的用户筛选数据。例如：

- 您希望区域销售人员只看到其所在区域的销售数据。
- 您希望销售经理只看到向他们报告的销售人员的统计数据。
- 您希望学生只看到基于他们自己的考试成绩的可视化项。

以这种方式筛选数据的方法称为行级安全性 (RLS)。有多种方法可以在 Tableau 内部和外部实现行级安全性，每种方法都有自己的优点和缺点。

## 创建用户筛选器并将用户手动映射到值

在 Tableau 中实现行级安全性的最简单方法是通过用户筛选器，您可以在其中手动将用户映射到值。例如，您可以手动将名为“Alice”的用户映射到值“East”（东部），以便她只能看到数据源中“Region”（区域）列为“East”（东部）的行。

这种方法较为方便，但维护费用高并且必须注意安全性。必须按工作簿完成此方法，并且您必须更新筛选器并在用户群发生变化时重新发布数据源。当您使用这种类型的用户筛选器发布资产时，您需要设置权限，以便用户无法保存或下载它并移除筛选器，从而获得对所有数据的访问权。

有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[创建用户筛选器并将用户手动映射到值](https://help.tableau.com/current/pro/desktop/zh-cn/publish_userfilters_create.htm#create-user-filter)。

## 使用数据中的安全字段创建动态用户筛选器

使用此方法，您可以创建计算字段，以自动执行将用户映射到数据值这一过程。此方法要求基础数据包括要用于筛选的安全信息。例如，使用计算字段、USERNAME() 函数和数据源中的“Manager”（经理）列，您可以确定请求视图的用户是否为经理并相应地调整视图中的数据。

由于筛选是在数据级别定义的，并由计算字段自动进行，因此此方法比将用户手动映射到数据值更不容易出错。当您使用这种类型的用户筛选器发布资产时，您需要设置权限，以便用户无法保存或下载它并移除筛选器，从而获得对所有数据的访问权。

有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[使用数据中的安全字段创建动态筛选器](https://help.tableau.com/current/pro/desktop/zh-cn/publish_userfilters_create.htm#dynamic)。

## 使用数据策略

从 Tableau 2021.4 开始，当在 Tableau Server 或 Tableau Cloud 中启用 Data Management 时，拥有 Creator 许可证的用户可以通过虚拟连接上的数据策略实现行级安全性。由于虚拟连接是集中式且可重用的，因此您可以在一个地方为使用该连接的所有内容安全可靠地管理每个连接的行级安全性。

与 Tableau 中的上述行级安全性解决方案不同，如果作者忽略正确保护工作簿或数据源的权限，此方法不会带来同样的信息泄露风险，因为该策略是针对每个查询在服务器上强制执行的。

制定通过虚拟连接数据策略实现的行级安全性是为了解决其他行级安全性解决方案的缺点。我们推荐在大多数情况下选择此解决方案。

有关在虚拟连接上使用数据策略的行级安全性的详细信息，请参见[关于虚拟连接和数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm)。

## 使用数据库中现有的 RLS

许多数据源都有内置 RLS 的机制。如果您的组织已努力在数据源中构建行级安全性，则可以利用现有的 RLS。

与在考虑 Tableau 的情况下构建内置 RLS 模型相比，实现一个内置的 RLS 模型并不一定更容易或更好：当组织已经对这些技术进行了投资，并且希望利用投资，或者当他们需要将相同的安全策略应用于除 Tableau 之外的其他数据库客户端时，通常会利用这些技术。

使用内置 RLS 的主要优点是，它允许管理员在一个位置，即在管理员数据库中实现和控制其数据安全策略。

## 传递用户属性

您可以传递包含在 JSON Web 令牌 (JWT) 中的用户属性，以自定义和控制对 Tableau Cloud 嵌入工作流中数据的访问。有关详细信息，请参见[嵌入 v3 API](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html)。

## 行级别安全性选项比较

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 16%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 28%;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">RLS 选项</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">在以下情况下有用</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">优点</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1">缺点</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">手动用户筛选器</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>您正在进行概念验证或测试用户筛选功能</li><li>您正在创建一个静态工作簿以供一组不变的用户使用</li><li>您了解权限设置错误的数据安全风险</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>简单且规模小</li><li>易于理解的映射</li><li>适合测试</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>维护成本高</li><li>需要更新筛选器并在用户群的变化时重新发布</li><li>必须保护权限以防止用户看到未筛选的数据</li><li>必须在每个工作簿中复制</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">动态用户筛选器</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>您没有 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 许可证</li><li>数据包含可用于筛选的信息</li><li>您了解权限设置错误的数据安全风险</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>设置相对容易</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>必须保护权限以防止用户看到未筛选的数据</li><li>必须在每个工作簿或数据源中复制</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据策略</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>您有 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 许可证</li><li>数据包含可用于筛选的信息</li><li>数据安全的易用性是一个重要的问题</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>集中</li><li>安全</li><li>维护成本低</li><li>安全和分析的责任可以分开</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 许可证</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据库中的 RLS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>您的数据库具有内置到数据库中的现有 RLS 安全性</li><li>您未使用数据提取</li></ul></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>可能已经内置到组织的数据库中</li><li>策略可应用于 Tableau 以外的数据库客户端</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><ul><li>必须使用实时查询</li><li>可能有限制或要求。您的 IT 团队可以识别它们</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">用户属性</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>您正在使用 <a href="https://help.tableau.com/v0.0/online/zh-cn/connected_apps.htm" target="_blank">Tableau 已连接应用</a>验证和授权对嵌入内容的访问</li></ul></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>在为用户管理其他策略和个性化的同一位置管理数据访问策略</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><ul><li>需要 JWT 中定义的用户属性<a href="https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#authentication-tab-tableau-cloud" target="_blank">站点设置已启用</a>，以及使用<a href="https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm#user_attributes" target="_blank">用户属性函数</a>制作的内容</li></ul></td></tr></tbody></table>

<!-- document id=478ab3b080429bfc90cbd302f1526e99ce7ed61a1ee4afb658c8af6d4612cca1 url=/tableau/next/zh-cn/online/datasource_datamodel.md -->

[跳转到主要内容](#main-content)

# Tableau 数据模型

您在 Tableau 中创建的每个数据源都有一个数据模型。可以将数据模型想像为一个关系图，告知 Tableau 应如何查询已连接的数据库表中的数据。

添加到“数据源”页面的画布中的表将创建数据模型的结构。数据模型可以很简单，例如单个表。或者，它可能更为复杂，因为多个表使用不同的关系、联接和并集组合。

数据模型有两个层：

- 您首先在“数据源”页面画布中看到的默认视图是数据源的_逻辑层_。使用关系（或“关系线”）来合并逻辑层中的数据。将此层想像为“数据源”页面中的“关系”画布。有关详细信息，请参见[“使用关系进行多表数据分析”](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_normalized.htm)。
- 下一层是物理层。使用[联接](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_relationships_learnmorepage.htm#where-did-joins-go)和并集在物理层的表之间合并数据。每个逻辑表在此层中至少包含一个物理表。将物理层想像为“数据源”页面中的“联接/并集”画布。双击逻辑表以查看或添加联接和并集。

<table style="width: 865px; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 413px;"><col style="width: 15px;"><col style="width: 437px;"></colgroup><thead><tr><th>逻辑层</th><th>&nbsp;</th><th>物理层</th></tr></thead><tbody><tr><td style="text-align: center;">关系线 = 关系</td><td>&nbsp;</td><td style="text-align: center;">维恩图 = 联接</td></tr><tr><td style="text-align: left;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/data_model_logicallayer_ex1_sm.png" alt="具有多个相关表的数据源的顶级视图。"></td><td style="text-align: center;">&nbsp;</td><td style="text-align: left;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/data_model_physlayer_ex1_sm.png" alt="数据模型中“Book”（书籍）、“Award”（奖项）和“Info”（信息）表之间的关系图。"></td></tr><tr><td class="caption">具有多个相关表的数据源的顶级视图。这是逻辑层。可以使用关系（“关系线”）来合并逻辑表。它们不使用联接类型。它们就像物理表的容器。</td><td>&nbsp;</td><td class="caption">双击逻辑表可将其打开并查看其物理表。可以使用联接或并集合并物理表。在此示例中，“Book”（书籍）逻辑表由三个联接的物理表（“Book”（书籍）,“Award”（奖项）、“Info”（信息））组成。</td></tr></tbody></table>

| 逻辑层 |   | 物理层 |
| --- | --- | --- |
| “数据源”页面中的“关系”画布 |   | “数据源”页面中的“联接/并集”画布 |
| 拖到此处的表称为逻辑表 |   | 拖到此处的表称为物理表 |
| 逻辑表可以与其他逻辑表相关。 |   | 物理表可以联接或合并到其他物理表 |
| 逻辑表就像物理表的容器 |   | 双击逻辑表可查看其物理表 |
| 详细级别位于逻辑表的行级别 |   | 详细级别位于合并的物理表的行级别 |
| 逻辑表保持独立（规范化），未合并到数据源中 |   | 物理表合并到定义逻辑表的单个平面表中 |

## 数据模型的层

您看到的数据源顶层视图是数据模型的[逻辑层](#dm_log_phys)。您也可以将其想像为“关系”画布，因为您在此处使用关系（而不是联接）合并表。

在合并来自多个表的数据时，拖到逻辑层中的画布的每个表都必须与另一个表有关系。您无需为关系指定联接类型；在分析期间，Tableau 将根据工作表中的字段和分析上下文自动选择适当的联接类型。

您可以在数据模型的[物理层](#dm_log_phys)中使用联接和并集来合并数据。您只能在此画布中使用转置。您可以将其想像为“关联/并集”画布。在以前的 Tableau 版本中，物理层是数据模型中的唯一层。每个逻辑表可以包含一个或多个_物理表_。

> [!TIP]
> 
> **重要信息**：您仍然可以在 Tableau 中创建使用联接和并集的单表数据源。Tableau 中单表分析的行为未改变。升级的工作簿的工作方式将与 2020.2 之前一样。

**了解更多信息**：有关使用关系合并数据的相关信息，也可参见以下主题和博客文章：

- [关系与联接有何不同](https://help.tableau.com/v0.0/online/zh-cn/datasource_relationships_learnmorepage.htm)
- [使用关系进行多表数据分析](https://help.tableau.com/v0.0/online/zh-cn/datasource_multitable_normalized.htm)
- [关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)
- [关系，第 1 部分：在 Tableau 中引入新的数据建模](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [关系，第 2 部分：提示和技巧](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [关系，第 3 部分：跨多个相关表提出问题](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

另请参见 [Action Analytics](https://action-analytics.com/library/) 中有关关系的视频播客，例如[为什么 Tableau 发明了关系？](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/)单击 [Library（库）](https://action-analytics.com/library/)中的“Video Podcast”（视频播客）以查看更多信息。

## 了解数据模型

数据模型具有逻辑（语义）层和物理层。这为您提供了更多选项，用于使用架构合并数据以适合您的分析。

![数据模型图显示一个由关系链接的两个表的逻辑层，以及一个说明如何从物理表构建逻辑表的物理层。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_layers_sm.png)

每个逻辑表都在物理层中包含物理表。

在以前版本的 Tableau（2020.2 之前）中，数据源中的数据模型由单个物理层组成，您可以在其中指定联接和并集。添加到（联接或合并）物理层的表创建单个拼合的表（非规范化）以进行分析。

<table style="width: 850px; margin-left: 0; margin-right: auto;"><colgroup><col style="width: 350px;"><col style="width: 20px;"><col style="width: 465px;"></colgroup><thead><tr><th>物理层数据源</th><th>&nbsp;</th><th>逻辑层数据源</th></tr></thead><tbody><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/data_model_physical_layer.png" alt="数据模型中四个物理表之间的连接图。"></td><td>&nbsp;</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/data_model_logical_physical.png" alt="具有逻辑层和物理层的数据模型图。"></td></tr></tbody></table>

逻辑层中的表不会合并到数据源中，它们保持独立（规范化），并保持其本机详细级别。

逻辑表充当已合并物理表的容器。逻辑表可以包含单个物理表。或者，它可以包含通过联接或并集合并在一起的多个物理表。

### 向逻辑表中添加描述

逻辑表可以具有出现在其工具提示中的描述。这些工具提示仅显示在“数据源”选项卡中。

若要添加描述，请执行以下操作：

1. 在画布上选择一个表
2. 在底部窗格中，单击**“描述”**旁边的编辑图标（铅笔）。
3. 在富文本编辑器中输入描述

**注意**：仅在 Web 制作中，描述中的任何链接都是实时链接，可以单击直接打开。

![表的工具提示，其中包含字段描述和底部窗格的描述部分周围的突出显示](/tableau/next/zh-cn/online/zh-cn/Img/environ_workspace_datasource_tabledescriptions.png)

## 构建新模型

将一个或多个表添加到逻辑层时，实质上是为数据源构建数据模型。数据源可以由单个逻辑表组成，或者您可以将多个表拖动到画布以创建更复杂的模型。

- 拖到画布的第一个表将成为数据源中数据模型的根表。
- 拖出根表后，可以按任意顺序拖出其他表。您需要考虑哪些表应彼此关联，以及为每个关系定义的匹配字段对。
- 如果要创建星形架构，则首先将事实数据表拖出，然后将维度表与该表相关联会很有帮助。
- 删除画布中的表也会自动删除其关联的下级。如果删除根表，模型中的所有其他表也将被移除。
- 每个关系必须至少由一对匹配的字段组成。添加多个字段对以创建复合关系。匹配的字段对必须具有相同的数据类型。更改“数据源”页面中的数据类型不会更改此要求。Tableau 仍将使用基础数据库中的数据类型进行查询。
- 关系可以基于计算字段。
- 在定义关系时，可以使用运算符指定应该如何比较关系中使用的字段。

有关关系的详细信息，请参见[关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)中的[创建和定义关系](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-and-define-relationships)。

### 多表模型

- 若要创建多表模型，请将表拖到“数据源”页面画布的逻辑层。  
      
    ![若要创建多表模型，请将表拖到“数据源”页面画布的逻辑层。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_multitableanalysis.gif)

拖到“数据源”页面画布的逻辑层的表必须彼此关联。将其他表拖动到逻辑层画布时，Tableau 会自动尝试基于现有键约束和匹配字段创建关系，从而定义关系。如果无法确定匹配字段，则需要选择它们。

果未检测到约束，则会创建“**多对多**”关系，并将引用完整性设置为“**某些记录匹配**”。这些默认设置是安全的选择，为您的数据源提供了最大的灵活性。默认设置支持完全外部联接，并通过在分析期间形成联接之前聚合表数据来优化查询。每个表中的所有列和行数据将可用于分析。  

您可以通过双击表在任何逻辑表内添加更多数据。这将打开“数据源”页面画布的物理层。如果需要使用联接或并集，可以将要联接或合并的表拖到物理层画布中。物理表将合并在其逻辑表中。

按照[创建和定义关系](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-and-define-relationships)中的步骤来合并多个表。

### 单表模型

- 若要创建单表模型，请将表拖到“数据源”页面的逻辑层画布。然后，您可以使用“数据”窗格该表中的字段进行分析。  
      
    ![采用单表分析的数据模型。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_singletableanalysis.gif)

#### 包含其他表的单表模型

您可以通过双击表在单个逻辑表内添加更多数据。这将打开“数据源”页面画布的物理层。如果需要使用联接或并集，可以将要联接或合并的表拖到物理层画布中。物理表将合并在其逻辑表中。

![具有两个联接的数据模型。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_singletable_joins.gif)

此示例在数据源的“关系”画布（逻辑层）中显示“Book”（书籍）表。双击“Book”（书籍）逻辑表将打开“联接/并集”画布（物理层）。

在此示例中，联接会将“Award”（奖项）和“Info”（信息）表与“Book”（书籍）表合并。在这种情况下，在奖项的细节级别上，“Book”（书籍）和“Award”（奖项）之间的联接将是一对多。这将复制“Book”（书籍）和“Info”（信息）的度量值。为了避免重复，您可以将“Award”（奖项）和“Info”（信息）奖与“Book”（书籍）相关联，而不是在“Book”（书籍）逻辑表内部联接它们。

## 支持的数据模型架构

Tableau（版本 2020.2 及更高版本）中的数据建模功能旨在简化对常见多表数据场景（包括星型和雪花型数据模型）的分析。Tableau 数据源中支持以下类型的模型。

### 单表

对包含维度和度量混合的单个逻辑表进行分析的工作方式与 Tableau 2020.2 之前的版本一样。您可以使用联接、并集、自定义 SQL 等的组合来构建逻辑表。

![标有“客户”的对象具有三个蓝色条形，堆叠在两个绿色条形之上。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_schema1.png)

### 星形和雪花

企业数据仓库中具有“星形架构”或“雪花架构”是很常见的，其中的度量包含在一个中央事实表中，维度单独存储在独立的维度表中。此数据组织支持许多常见的分析流程，包括汇总和下取分析。

![客户对象用线条来显示与维度 1、维度 2 和维度 3 对象的关系。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_schema2.png)

这些模型可以直接使用 Tableau 2020.2 及更高版本中提供的数据建模功能中的关系来表示。

首先将事实表拖到模型中，然后将维度表关联到事实表（在星形架构中）或关联到其他维度表（在雪花架构中）。

通常，在建模良好的星形或雪花架构中，事实表和维度表之间的关系将为多对一。如果此信息已编码在数据仓库中，Tableau 将自动使用它来设置关系的性能选项。如果没有，您可以自己设置此信息。有关详细信息，请参见[使用性能选项优化关系查询](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_relationships_perfoptions.htm)。

在建模良好的星形或雪花架构中，事实表中的每个行在每个维度表中都将有一个匹配的条目。如果情况如此，并已在数据仓库完整性约束中捕获，Tableau 将自动使用此信息在性能选项中设置引用完整性设置。如果某些事实表行在维度表中没有匹配行（有时称为“延迟到达维度”或“提早到达维度”），则 Tableau 将默认在计算度量时保留所有行，但可能会在显示维度标题时删除值。有关详细信息，请参见[使用性能选项优化关系查询](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_relationships_perfoptions.htm)。

### 度量位于多个表中的星形和雪花架构

在某些星形或雪花架构中，用于分析的所有度量都包含在事实表中。但是，通常情况下，其他感兴趣的度量可能与分析中的维度表相关。即使维度表不包含度量，在分析中，想要计数或以其他方式聚合维度值也很常见。在这些情况下，事实表和维度表之间的区别不太明显。为了在查看您的数据模型时更加清晰，我们建议首先将最精细的粒度表添加到数据源画布中，然后将所有其他表与第一个表相关联。

![数据模型说明了如何将客户细分为三个维度。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_schema3.png)

如果要将这些表一起联接到单个逻辑表中，维度表中的度量值将被复制，从而导致扭曲的聚合，除非您采取预防措施，使用 LOD 计算或 COUNT DEDE 对值进行去重处理。但是，如果改为在这些表之间创建关系，Tableau 将在执行联接之前聚合度量，以避免不必要重复的问题。这样，您就无需您仔细跟踪试题的详细级别。

### 多事实分析

在版本 2024.2 及更高版本中，Tableau 的数据建模功能通过使用多事实关系支持多事实分析。有关如何创建多事实关系数据模型的详细信息，请参见：

- [关于多事实关系数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm)
- [何时使用多事实关系模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_when_to_use.htm)
- [构建多事实关系数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_build.htm)

多事实关系模型是一种具有多个基表的数据模型，当模型中也存在共享表时，它允许模型中存在不相关的表。在分析过程中，共享表中的字段根据共同的维度（例如在同一地点或同一时间发生）将原本不相关的数据表“拼接”在一起。关系的所有优点都得以保留，包括保留每个表的粒度或本机详细级别。

与单基表数据模型类似，Tableau 根据可视化项的结构确定后台使用的最佳联接类型。但在多事实关系模型中，联接选项扩展为包括外部联接和交叉联接，以处理不同级别的关联性。有关详细信息，请参见[“关于多事实关系数据模型”](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm)。

**注意**：在版本 2020.2 至 2024.1 中，只有当事实表（包含度量）与单个维度表相关时，才可以将它们添加到星型和雪花模型中。

例如，您可以将两个或更多事实表合并在一起，以分析共享的维度，例如在类似 Customer 360 的分析中。这些事实表的详细级别可以与维度表不同，也可以彼此不同。它们还可以与维度表具有多对多关系。在这些情况下，Tableau 将确保值在聚合之前不会被复制。

![数据模型说明了如何将客户细分为三个维度，并展示了销售和活动之间的联系。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_schema5.png)

如果没有与事实表相关的共享维度表，您有时可以使用自定义 SQL 或使用其他维度表的联接或并集动态生成一个维度表。

两个事实表可以在共同维度上彼此直接相关。当其中一个事实表包含公共维度的超集时，这种类型的分析效果最佳。

![数据模型显示销售和活动之间的关系。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_schema6.png)

有多种情况可能表明您应该构建具有多个基表而不是单个基表数据源的多事实关系模型：

- **循环关系**。不支持循环关系。如果您尝试构建具有循环的数据源，请使用多事实关系并将下游表作为另一个基表。
- **一致的维度**和**上下文 OR 关系**。如果您有一系列在同一组关系子句（例如日期和地点）上相关的表，则应该将这些维度拉出来并制成共享表。
    - 这尤其有用，因为多个关系子句必须全部为真（逻辑上为 AND），表才能与这些记录相关。
    - 相反，如果您想要分析一次可能为真的记录（上下文 Or），则可以通过设置具有共享维度表的数据模型来提供这种灵活性。
- **等量混合**。如果您正在使用混合，但希望获得没有主要和次要数据源的等效混合，请构建一个数据模型，将混合中的数据源与共享表中的链接字段相结合。

## 数据模型中关系的要求

- 在关联表时，定义关系的字段必须具有相同的数据类型。更改“数据源”页面中的数据类型不会更改此要求。Tableau 仍将使用基础数据库中的数据类型进行查询。
- 不能基于地理字段定义关系。
- 数据模型中不支持循环关系。

### 限制使用关联表的好处的因素

- 表中的脏数据（即创建时未考虑结构良好的模型且包含多个表中度量值和维度混合的表）可能会使多表分析更加复杂。
- 使用数据源筛选器将限制 Tableau 在数据中执行联接剔除的能力。联接剔除是定义 Tableau 如何通过移除不必要的联接来简化查询的术语。
- 具有许多跨关系的不匹配值的表。

<!-- document id=480a96c02fa26614a389393c5eb264839dd095fad75810cd599698faefb614b9 url=/tableau/next/zh-cn/online/tableau_admin_salesforce_integration.md -->

[跳转到主要内容](#main-content)

# 站点管理员速查表：Salesforce 集成

  

## Business Science

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Business-Services_big.png)

- [将 Einstein Discovery 预测集成到 Tableau 中](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_predictions.htm)
- [使用 Einstein Discovery 仪表板扩展程序在 Tableau 中浏览预测](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_dashboard_extension.htm)
- [Einstein Discovery：使用分析扩展程序传递表达式](https://help.tableau.com/current/pro/desktop/zh-cn/r_connection_manage.htm#Einstein2)

## 连接并嵌入 Salesforce 数据

![在云中部署。](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ConnectToData_big.png)

- [将 Tableau 视图嵌入 Salesforce](https://help.tableau.com/current/pro/desktop/zh-cn/embed_ex_lwc.htm)
- [创建 Salesforce 数据源](https://help.tableau.com/current/pro/desktop/zh-cn/examples_salesforce.htm)
- [为 Salesforce CDP 设置 OAuth](https://help.tableau.com/current/online/zh-cn/config_oauth_sfdc_cdp_online.htm)
- [Github：用于将 Tableau 嵌入 Salesforce 的 Lightning Web 组件](https://github.com/tableau/tableau-viz-lwc)
- [Trailhead：在 Salesforce 中嵌入 Tableau 可视化项](https://trailhead.salesforce.com/en/content/learn/projects/embed-tableau-visualizations-in-salesforce)

## 身份验证

![部署 Tableau Server。](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Collaborate_big.png)

- [为 Tabbleau Viz Lightning Web 组件配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_TOL_LWC.htm)
- [使用 Salesforce 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_salesforce.htm)
- [Salesforce 身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth_sfdc.htm)

<!-- document id=c3047ceaeaf6d0ddfc7a7ab3d75338da954500bd05bbcf72f5d58e4e7275379a url=/tableau/next/zh-cn/online/to_tab_plus_get-started.md -->

[跳转到主要内容](#main-content)

# Tableau+ Bundle 入门指南

Tableau+ Bundle 是一个专为在 Tableau Cloud 和 Tableau Next 中全面采用自助式代理分析而定制的综合软件包。它包含为更大或更复杂的部署定制的高级功能（如“发布预览”和 50 个站点的限制）、高级 AI 功能（如 Tableau Agent）和 Premier Success for Tableau Cloud。借助 Tableau+ Bundle，客户还可以访问全球首个代理分析平台 Tableau Next

Tableau+ Bundle 包含一些需要配置的功能，本主题介绍了您需要针对每个功能执行的操作。有些功能是 Tableau+ Bundle 独有的，而其他则是 Tableau Cloud 的各个版本所共有的。一些功能需要在 Salesforce 中进行配置。

初始步骤取决于您的客户类型：

- 新 Tableau 客户
    
    作为 Tableau Cloud 的新客户，您应该在探索 Tableau+ Bundle 的独特功能之前熟悉 Tableau Cloud。首先，请参见[入门指南](https://help.tableau.com/v0.0/online/zh-cn/to_get_started.htm)和[关于 Tableau+ Bundle](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_features.htm)，然后请按照以下配置步骤进行操作。
- 现有 Tableau Cloud 客户
    
    对于升级到 Tableau+ Bundle 的现有 Tableau Cloud 客户来说，几乎不需要做任何“迁移”工作。您的现有站点仍保留（无需“迁移”它们），但独特的 Tableau+ Bundle 功能需要一些配置。

## 针对 Tableau+ Bundle 功能配置 Tableau Cloud 和 Salesforce

这些 Tableau+ Bundle 功能需要配置才能使用：

- **Tableau Pulse**： [为 Tableau Pulse 设置站点](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm)（**注意：**请务必启用 Tableau Pulse 关键指标摘要，该功能在同一主题中有介绍，如下所示：[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)。
- Prep、Catalog 和 Web 制作中的 **Tableau Agent**： [在您的 Tableau Cloud 站点中启用 AI](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm) 以启用 Tableau Agent。
    
    这需要在每个 Tableau Cloud 站点上_和_配置了 Einstein 生成式 AI 的 Salesforce 组织中进行配置。它还需要一个 Data 360 实例。
    
    - 对于没有 Data 360 实例的 Tableau+ Bundle 客户，我们会提供一个。
    - 对于那些没有企业版级别或更高版本 Salesforce 组织的用户，我们将在 Tableau+ Bundle 中提供一个。
- **Data 360** 通过设置管理员用户并打开 Data 360 来配置 Data 360：[步骤 2：设置 Data Cloud 架构师用户](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm#setup_dc_permissions)。

以下功能并非 Tableau+ Bundle 独有，但在 Tableau Cloud 实例中提供了其他重要功能：

- **Data Management**：[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)（附带一个资源块。有关详细信息，请参见[资源块](https://help.tableau.com/v0.0/online/zh-cn/to_resource_blocks.htm)。
- **Advanced Management**：[关于 Tableau Cloud 上的 Tableau Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm)
- **Tableau Cloud Manager (TCM)**：使用 TCM 管理多个 Tableau Cloud 站点。Tableau+ Bundle 客户最多可获得 50 个站点。有关使用 TCM 的详细信息，请参见[使用 Tableau Cloud Manager](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm)。
- [Premier Success](https://www.salesforce.com/services/success-plans/overview/premier-success-plans/)：通过专家指导和快速支持从 Tableau 获取最大价值。
- [eLearning](https://www.tableau.com/zh-cn/learn/training/elearning)：使用自定进度的在线课程按照自己的时间表学习 Tableau。

<!-- document id=d00d74a031a2efd527aef45ae3f76bb50a6be395bac617b721f4e858e11bc3cd url=/tableau/next/zh-cn/online/actions_url.md -->

[跳转到主要内容](#main-content)

# URL 动作

URL 动作是一种超链接，它指向网页、文件或 Tableau 外部其他基于 Web 的资源。您可以使用 URL 动作来创建电子邮件，或链接到有关数据的其他信息。若要基于数据自定义链接，可以在 URL 中自动输入字段值作为参数。

> [!TIP]
> 
> **提示：**URL 动作还可在仪表板的网页对象中打开。请参见[“动作和仪表板”](https://help.tableau.com/current/pro/desktop/zh-cn/actions_dashboards.htm)了解详细信息。

![URL 动作从工具提示菜单中运行。该链接反映动作名称，而不是目标 URL。](/tableau/next/zh-cn/online/zh-cn/Img/urlaction_tooltip.png)

URL 动作从工具提示菜单中运行。该链接反映动作名称，而不是目标 URL。

## 使用 URL 动作打开网页

1. 在工作表上，选择“工作表”>“动作”。从仪表板上选择“仪表板”\>“动作”。
2. 在“动作”对话框中，单击“添加动作”，然后选择“转到 URL”。
3. 在下一个对话框中，输入动作的名称。若要在名称中输入字段变量，请单击“名称”框右侧的“插入”菜单。
    
    **注意：**请为动作指定描述性名称，因为工具提示中的链接文本是动作的名称，而不是 URL。举例来说，在链接到更多产品详细信息时，好的名称可以是"显示更多详细信息"。
4. 使用下拉列表选择源工作表或数据源。如果选择数据源或仪表板，您可以选择其中的单独工作表。
    
    ![用于选择源工作表和选择操作的菜单。](/tableau/next/zh-cn/online/zh-cn/Img/urlaction3.png)
5. 选择用户运行动作将采用的方式。
    
    <table class="table--plain" style="width: 100%;"><colgroup><col><col></colgroup><tbody><tr><th style="text-align: left;">如果选择此选项...</th><th style="text-align: left;">当用户执行以下操作时运行此动作...</th></tr><tr><td><span class="uicontrol">悬停</span></td><td>将鼠标悬停在视图中的标记上。此选项非常适合在仪表板中突出显示动作。</td></tr><tr><td><span class="uicontrol">选择</span></td><td>单击视图中的标记。此选项适合所有类型的动作。</td></tr><tr><td><span class="uicontrol">菜单</span></td><td>右键单击（在 Mac 上按住 Control 单击）视图中选定的标记，然后在工具提示（菜单）中单击一个选项。此选项特别适合于 URL 动作。</td></tr></tbody></table>
6. 对于 URL 目标，指定将在何处打开链接：
    - **新标签页（如果网页对象不存在）** — 确保 URL 在缺少网页对象的工作表上的浏览器中打开。当“源工作表”设置为“全部”或某个数据源时，这是一个不错的选择。
    - **新浏览器标签页** — 在默认浏览器中打开。
    - **网页对象** —（仅适用于带有网页对象的仪表板）在所选网页对象中打开。
    
    ![URL 目标的三个单选按钮：新标签页（如果不存在网页对象）、新浏览器标签页和网页对象。网页对象选项下方是一个用于选择网页对象的下拉框](/tableau/next/zh-cn/online/zh-cn/Img/urlaction-webpageobject.jpg)
    
    **注意**：对于“新标签页”选项，第一次运行该操作时会打开一个新标签页。此后，操作将在同一标签页中打开，而不是打开其他标签页。
7. 输入 URL
    
    - URL 应该以下列前缀之一开头：`http`、`https`、`ftp`、`mailto`、`news`、`gopher`、`tsc`、`tsl`、`sms` 或 `tel`
    
    **注意**：如果没有输入前缀，`http://` 将自动附加到开头，并且 URL 动作将在 Tableau Desktop 中工作。但是，如果将没有前缀的 URL 动作发布到 Tableau Server 或 Tableau Cloud，它将在浏览器中失败。如果要发布仪表板，请始终为动作提供完全限定的 URL。
    
    **注意**：只有当仪表板不包含 Web 对象时，才能指定 ftp 地址。如果存在 Web 对象，则 ftp 地址不会加载。
    
    - Tableau Desktop 还支持本地路径，例如 `C:\Example folder\example.txt`，以及文件 URL 动作。
    - 若要输入字段和筛选器值作为 URL 中的动态值，请单击 URL 右侧的“插入”菜单。请注意，任何引用的字段都必须在视图中使用。有关详细信息，请参见[在 URL 中使用字段和筛选器值](#Using)。
    
    ![用于添加带有超链接示例的 URL 操作的表单。](/tableau/next/zh-cn/online/zh-cn/Img/urlaction5.png)
    
    您输入的 URL 下方是一个带有超链接的示例，您可以单击进行测试。
8. （可选）在“数据值”部分，选择以下任意选项：
    - 对 **URL 不支持的数据值进行编码** — 如果数据包含的值具有浏览器不允许在 URL 中使用的字符，则选择此选项。举例来说，如果某个数据值包含“&”符号，例如“Sales & Finance”，则必须将“&”转换为浏览器能够理解的字符。
    - 通过 URL 参数**允许多个值** — 如果要链接到的网页可通过 URL 中的参数接收值列表，则选择此选项。例如，如果在视图中选择几种产品，需要查看网页上承载的每一种产品的详细信息。如果服务器可以根据标识符列表（产品 ID 或产品名称）加载多个产品详细信息，则可以使用多选功能发送标识符列表作为参数。
        
        允许多个值时，还必须定义转义字符，即用来隔开列表中每一项的字符（例如逗号）。如果数据值中使用分隔符，则还必须定义“分隔符转义”。

## 使用 URL 动作创建电子邮件

1. 在工作表上，选择“工作表”>“动作”。从仪表板上选择“仪表板”\>“动作”。
2. 在“动作”对话框中，单击**“添加动作”**，然后选择**“转到 URL”**。
3. 在“源工作表”下拉列表中，选择工作表，该工作表包含的字段带有要向其发送电子邮件的电子邮件地址。
4. 在 URI 框中，执行以下操作：
    
    - 键入 **mailto:，**然后单击右侧的“插入”菜单以选择包含电子邮件地址的数据字段。
    - 键入**“?subject=”**并输入主题行文本。
    - 键入**“&body=”**，并单击右侧的“插入”菜单以选择要包括在电子邮件正文中的信息的字段。
    
    在下面的示例中，“电子邮件”字段包含电子邮件地址，主题为“City Information”（城市信息），电子邮件的正文文本包含与电子邮件地址关联的城市和州/省/市/自治区数据。
    
    ![ ](/tableau/next/zh-cn/online/zh-cn/Img/UsingActionEmail_BodyText.png)：
5. （可选）将电子邮件正文中的工作簿数据显示为垂直列表，而不是默认水平列表。例如，假设您有一个包含城市（例如 Chicago、Paris、Barcelona）的水平列表，您更愿意以垂直方式显示该列表，如下所示：
    
    Chicago  
    Paris  
    Barcelona
    
    若要使列表变为垂直，请在“数据值”部分执行以下操作：
    
    - 取消选择“**对 URL 不支持的数据值进行编码”**
    - 选择“**通过 URL 参数允许多个值”** 。
    - 在“**值分隔符”**文本框中键入 **％0a**，以在列表中的每一项之间添加换行符。（这是换行符的 URL 编码字符。）

## 在 URL 中使用字段和筛选器值

当用户从所选标记触发 URL 动作时，Tableau 可以在 URL 中以变量的形式发送字段、筛选器和参数值。举例来说，如果 URL 动作链接到映射网站，您可以插入地址字段以自动打开网站上当前选定的地址。

1. 在“编辑 URL 动作”对话框中，开始键入链接的 URL。
2. 将光标置于要插入字段、参数或筛选器值的位置。
3. 单击文本框右侧的“插入”菜单，并选择要插入的字段、参数或筛选器。变量显示在尖括号内。您可以根据需要继续添加任意多个变量。
    
    **注意：**任何引用的字段都必须在视图中使用。否则，链接不会显示在可视化项中，即使它在您单击“测试链接”时起作用。
    
    ![一个包含用于添加新 URL 操作的字段的窗口。](/tableau/next/zh-cn/online/zh-cn/Img/parameter1.png)

### 包括聚合字段

可用字段列表仅包括非聚合字段。若要将聚合字段值用作链接参数，请先创建相关的计算字段，然后将该字段添加到视图。（如果可视化项中不需要计算字段，请将其拖到“标记”卡片上的“详细信息”。

### 插入参数值

插入参数值时，URL 动作默认发送“显示为”值。若要发送实际值，请在参数名称后添加字符 `~na`。

例如，假设您有一个包含 IP 地址的参数，具有“实际值”字符串（例如 10.1.1.195）和具有更友好值的“显示为”字符串（例如 `Computer A (10.1.1.195)`）。若要发送实际值，请将 URL 中的参数修改为类似于如下：`http://<IPAddress~na>/page.htm`。

<!-- document id=a0cbe1726407b1fc180fa74994caf272b0d4fd331ba5c7fc131be9dbad749c99 url=/tableau/next/zh-cn/online/prep_web_auth.md -->

[跳转到主要内容](#main-content)

# Web 上的 Tableau Prep

_不支持 Windows 上的 Internet Explorer 11 和 Internet Explorer 的兼容模式。_

从版本 2020.4 开始，Tableau Prep 支持流程的 Web 制作。现在，您可以创建流程以使用 Tableau Prep Builder、Tableau Server 或 Tableau Cloud 清理和准备数据。您也可以手动在 Web 上运行流程，而不需要 Data Management。

虽然 Web 上也支持大多数相同的 Tableau Prep Builder 功能，但创建和处理流程存在一些差异。

> [!IMPORTANT]
> 
> **重要信息：**若要在 Web 上创建和编辑流程，您必须具有 Creator 许可证。只有当您希望使用 Tableau Prep Conductor 或通过 API 按计划运行流程时，才需要 Data Management。有关配置和使用 Tableau Prep Conductor 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/prep_publishserver_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/prep_conductor_online_intro.htm) 帮助中的“Tableau Prep Conductor”。

## 安装和部署

若要使用户能够在 Web 上创建和编辑流程，您将需要在服务器上配置若干设置。有关其中每个设置的详细信息，请参见[在 Web 上创建流程并与其进行交互](https://help.tableau.com/current/server/zh-cn/web_author_flows.htm)。

- **Web 制作**：此选项默认情况下已启用，控制用户是否可以在 Tableau Server 或 Tableau Cloud 上创建和编辑流程。
- **立即运行**：控制用户或只有管理员可以使用“立即运行”选项手动运行流程。不需要 Data Management 即可在 Web 上手动运行流程。
- **Tableau Prep Conductor**：如果 Data Management 已获得许可，则启用此选项，以便允许用户计划和跟踪流程。
- **Tableau Prep 扩展程序**（版本 2021.2.0 及更高本）：控制用户是否可以连接到 Einstein Discovery 以针对其流程中的数据应用和运行预测模型。
- **自动保存**：（默认情况下启用）此功能每隔几秒钟自动保存用户的流程工作。

### 示例数据和处理限制

若要在 Web 上处理流程时保持性能，请对可以在流程中包含的数据量应用限制。

以下限制适用：

- 连接到文件时，最大文件大小为 1GB。
- 包含所有数据的数据采样选项不可用。默认示例数据限制为 100 万行。Tableau Server 管理员可以使用 TSM 设置数据样本限制。有关详细信息，请参见 [tsm configuration set 选项](https://help.tableau.com/current/server/zh-cn/cli_configuration-set_tsm.htm#maestroappsettingssamplingmaxrowlimit)。在 Tableau Cloud 中，此限制是固定的，管理员无法设置。
- 在 Tableau Cloud 中，您可以一天执行的流程运行次数受站点管理员限制。有关详细信息，请参见[“Tableau Cloud 站点容量”](https://help.tableau.com/current/online/zh-cn/to_site_capacity.htm)。

有关设置数据样本的详细信息，请参见 Tableau Prep 帮助中的[设置数据样本大小](https://help.tableau.com/current/prep/zh-cn/prep_configure_dastaset.htm#set-your-data-sample-size)。

需要帮助调试缓慢的流程？请尝试从“帮助”\>“设置和性能”菜单中打开“启用查询日志记录”。有关详细信息，请参见[启用查询日志记录](https://help.tableau.com/current/prep/zh-cn/prep_troubleshoot.htm#enable-query-logging)。

## Web 上的可用功能

当您在 Web 上创建和编辑流程时，您可能会注意到导航和某些功能可用性的一些差异。虽然大多数功能在所有平台上都可用，但 Tableau Server 或 Tableau Cloud 中某些功能受限或尚未受支持。下表标识可能存在差异的功能。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 208px;"><col style="width: 59px;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">功能区域</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">例外</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span></th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span></th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_connect.htm" target="_blank">连接到数据</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">某些连接器在 Web 上可能不受支持。打开服务器上的<span class="uicontrol">“连接”</span>窗格以查看支持的连接器。</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm" target="_blank">使用 Tableau Agent 构建 Tableau Prep 流程</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>从版本 2025.2 开始，在启用了 Tableau Agent 的情况下连接到 Tableau Cloud 时，在 Tableau Cloud（需要 Tableau+）和 Tableau Prep Builder 中受支持。</p><p>从版本 2025.3 开始，在启用了 Tableau Agent 的情况下连接到 Tableau Server 时，在 Tableau Server 和 Tableau Prep Builder 中受支持。</p><p>有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm" target="_blank">在 Tableau Cloud 站点中启用 AI</a>和<a href="https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm" target="_blank">在 Tableau Server 站点中启用 AI</a>。</p></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_build_flow.htm" target="_blank">构建和组织流程</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_configure_dastaset.htm#set-your-data-sample-size" target="_blank">选择数据样本大小</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">在 Tableau Server 中，数据样本大小受管理员使用 TSM 命令设置的限制所限。在 Tableau Cloud 中，此限制固定为 1,048,576 行，管理员无法更改。</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_add_input_data.htm#union-files-and-database-tables-in-the-input-step" target="_blank">在输入步骤中合并文件和数据库表</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">无法在 Tableau Server 或 Tableau Cloud 中编辑或创建输入并集。仅在 Tableau Prep Builder 中提供。</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_clean.htm" target="_blank">清理和调整数据</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_explore.htm#copy-field-values-in-the-data-grid" target="_blank">复制数据网格值</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">在 Tableau Prep Builder、Tableau Server（从版本 2022.3 开始）和 Tableau Cloud（从 2022.2（八月）开始）中提供。</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_combine.htm" target="_blank">聚合、联接或合并数据</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_scripts.htm" target="_blank">在流程中使用 R 和 Python 脚本</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">在 Tableau Cloud 中创建或编辑流程时，无法添加脚本步骤。这当前仅在 Tableau Prep&nbsp;builder 和 Tableau Server 中受支持。</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_copy_reuse_steps.htm#create-reusable-flow-steps-version-201932-and-later" target="_blank">创建可重用的流程步骤</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#automatically-save-your-flows-on-the-web" target="_blank">在 Web 上自动保存流程</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">不可用</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#automatic-file-recovery" target="_blank">自动文件恢复</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">不可用</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">不可用</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_troubleshoot.htm#enable-query-logging" target="_blank">启用查询日志记录</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#view-flow-output-in-tableau-desktop" target="_blank">在 Tableau Desktop 中查看流程输出</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#create-an-extract-to-a-file" target="_blank">创建数据提取到文件</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#create-an-extract-to-a-microsoft-excel-worksheet" target="_blank">创建数据提取到 Microsoft Excel 工作表</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_unavailable.png" alt="带有一条对角线的红色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/pro/desktop/zh-cn/customsql.htm" target="_blank">连接到自定义 SQL 查询</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#create-a-published-data-source" target="_blank">创建发布的数据源</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#save-flow-output-data--to-external-databases" target="_blank">将流程输出保存到外部数据库</a></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyE-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyD-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a href="https://help.tableau.com/current/prep/zh-cn/prep_predictions.htm" target="_blank">将 Einstein Discovery 预测添加到您的流程</a></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">&nbsp;</td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyB-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyB-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td><td style="text-align: center;" class="TableStyle-Basic-Border-BodyA-Column1-Body1"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_pwa_available.png" alt="带有白色复选标记的绿色圆圈。"></td></tr></tbody></table>

### 自动保存并使用草稿

当您在服务器上创建或编辑流程时，您的工作每隔几秒钟会自动保存为草稿，这样在发生崩溃时，或在意外关闭选项卡时，您不会丢失工作。

草稿将保存到您登录的服务器和项目。您无法保存草稿或将草稿发布到其他服务器，但您可以使用“文件”\>“发布为”菜单选项将流程保存到该服务器上的另一个项目。

![包含示例数据、字段名称和字段值的数据准备流程。](/tableau/next/zh-cn/online/zh-cn/Img/prep_save_draft1.png)

草稿内容只能由您查看，直到您发布它。如果发布更改并需要还原更改，可以使用“修订历史记录”对话框查看并还原到以前发布的版本。有关在 Web 上保存流程的详细信息，请参见[自动在 Web 上保存流程](https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#automatically-save-your-flows-on-the-web)。

## 在 Web 上发布流程

无论您是在 Web 上从头开始创建流程还是编辑现有流程，在运行流程之前都需要发布流程。

- 您只能将草稿流程发布到已登录的同一服务器。
- 您可以使用“文件”菜单并选择“发布为”将草稿发布到其他项目。
- 您可以为流程的数据库连接嵌入凭据，以使流程能够运行，而无需在流程运行时手动输入凭据。如果您打开流程进行编辑，您将需要重新输入您的凭据。

### 嵌入凭据

嵌入凭据仅适用于在服务器上运行流程。从 Tableau Cloud 版本 2025.2 开始，流程所有者可以在 Web 制作中编辑其流程，如果这些连接嵌入在流程中或保存到用户配置文件中，则不必对其所有数据库连接重新进行身份验证。如果使用 Tableau Server，在编辑连接到数据库的流程时，需要手动输入凭据。嵌入凭据只能在流程级别设置，而不能在服务器或站点级别设置。

执行以下操作之一：

- 从顶部菜单中，选择“文件”\>“连接凭据”\>“嵌入在已发布流程中”。
    
    ![显示“连接凭据”子菜单的“文件”菜单，嵌入已发布流程，以便在发布流程时将数据连接凭据嵌入到流程中。](/tableau/next/zh-cn/online/zh-cn/Img/prep_embed_credentials.png)
- 发布流程时，选择“嵌入凭据”复选框。此选项显示何时选择“发布为”以首次将流程发布到新项目，或者何时编辑上次由其他人发布的流程。
    
    ![“将流程发布为”对话框包含用于命名和发布流程的字段，以及项目和嵌入凭据的选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_embed_credentials_prompt.png)

### 发布流程

发布流程时，它将成为流程的当前版本，并可以由有权访问您的项目的其他人运行和看到。在发布流程之前，您只能看到从未发布过的流程或对草稿所做的流程更改。有关流程状态的详细信息，请参见[自动在 Web 上保存流程](https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#automatically-save-your-flows-on-the-web)。

若要发布您的流程，请执行以下操作之一：

- 从顶部菜单中，选择“文件”\>“发布”或“文件”\>“发布为”
    
    ![Web 上的“文件”菜单，突出显示了用于发布流程的“发布”选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_publish_menu.png)
- 在顶部栏中，单击“发布”按钮或单击放置箭头以选择“发布为”。
    
    ![Web 上的 Tableau Prep 流程顶部栏，显示“发布”和“发布为”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_publish.png)

### 谁可以执行此操作

- 服务器管理员、站点管理员 Creator 和 Creator 允许完全连接和发布访问权限。
- Creator 可以执行 Web 制作任务。

<!-- document id=6beff45a1aaed617fe4ae608ece8c896f7a9a5914a109ad76237cb62610deaf7 url=/tableau/next/zh-cn/online/server_desktop_web_edit_differences.md -->

[跳转到主要内容](#main-content)

# Web 制作和 Tableau Desktop 功能比较

对于熟悉 Tableau Desktop 但不熟悉 Tableau Server 和 Tableau Cloud Web 制作环境的任何人，本主题将简要介绍以 Tableau Desktop 中的类似用法使用的 Web 功能。它还列出了两种环境之间的一些根本区别。

**注意：**本主题汇总了核心制作功能，不涉及桌面和 Web 环境之间的每个差异。  

## 按版本列出的功能

有关要在每个版本中添加的最新 Web 编辑功能的列表，请参见 [Tableau Desktop 和 Web 制作发行说明](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#whatsnew_desktop.htm)和 [Tableau Cloud 发行说明](https://help.tableau.com/current/online/zh-cn/whatsnew_online.htm)中的 Web 制作部分，或者查看 [Release Navigator](https://public.tableau.com/views/ReleaseNavigator-V21/FeaturesInVersionDash?:language=zh-CN&:display_count=n&:origin=viz_share_link) 可视化项按版本筛选和比较更改。

## Web 制作的一般差异

- 您的制作能力由您的许可级别确定。有关每个许可级别您可执行的操作的概述，请参见[我可以使用 Tableau 站点执行什么操作？](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_overview.htm)

- 您可以访问视图中字段的右键单击菜单操作，但无法访问工作区中的每一项。
- Web 制作和 Tableau Desktop 的键盘快捷方式不同。有关 Web 制作键盘快捷方式的列表，请参见 [Web 制作的键盘快捷方式](https://help.tableau.com/current/pro/desktop/zh-cn/shortcut.htm#Shortcuts_webauth)。

## Web 制作功能

在 Web 环境中，您可以连接到数据，并依据这些数据源或通过 Tableau Desktop 发布的数据创建工作簿。您可以编辑在 Web 上创建或通过 Tableau Desktop 发布的视图。

管理员可以在站点级别设置用户可以拥有的 Web 制作能力。Explorer 可以编辑工作簿，通过已发布数据源创建新工作簿，连接到已发布数据源，以及创建和编辑视图、仪表板和故事。Creator 具有相同的能力，但也可以创建新的工作簿，连接到 Web 上的数据，并使用“数据问答”(Ask Data) 功能和（Tableau Cloud 中的）仪表板起始模板快速进行深入分析。

### 数据管理

- **Creator**：连接到数据源、上载文件（文本、Excel 和 Tableau 工作簿），或者使用适用于特定数据源的预构建仪表板起始模板。有关详细信息，请参见 [Creator：在 Web 上连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_connect.htm)。
- **Creator**：在 Web 上的“数据源”页面中准备数据。有关详细信息，请参见 [Creator：在 Web 上准备数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_data_prep.htm)。
    
    **注意**：在 Web 上制作数据时，可在“数据源”页面中查看的行数存在限制（由浏览器确定）：
    
    - Internet Explorer：10,000 行
    - 其他浏览器：100,000 行
    
    （与浏览器无关）在 Web 上可在“数据源”页面中查看的记录总数（行数乘列数）为 **300 万**条。

- 连接到某些数据源时运行初始 SQL
- 关联数据以合并来自多个表的数据
- 联接同一数据源的不同表中的数据，或联接使用多连接数据源的不同数据库中的数据
- 添加联接计算
- 合并数据
- 对数据进行透视
- 复制网格中的值（Ctrl+C，或在 Mac 上按 Command-C）
- [编辑数据源](https://help.tableau.com/current/pro/desktop/zh-cn/howto_connect.htm)
- 使用数据解释器清理数据
- 创建自定义 SQL 查询

- **Explorer**：连接到发布的数据源。

- 混合发布的数据源。
- 将数据源（嵌入在已发布的工作簿中）另存为单独的已发布数据源。
- 更改视图中的度量聚合。更改“数据”空格中的默认度量聚合。
- 在架构中搜索字段。
- 复制、隐藏或重命名字段。
- 更改字段的数据类型。
- 将度量转换为维度或反之。
- 将离散字段转换为连续字段或反之。此选项可用于度量和日期维度。
- 为字段分配地理角色。
- 为维度成员创建别名。
- 创建和编辑组。
- 创建和编辑集（不提供条件集）
- 创建、编辑和移除参数。设置数字和日期的格式，以及为 Web 上不支持的参数添加注释。

### 分析

- 在工作簿中创建、编辑、重命名、复制和清除工作表（视图、仪表板和故事）。
- 使用[“数据问答”（Ask Data）功能](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm)来自动创建视图。
- 使用[“数据解释”功能](https://help.tableau.com/current/pro/desktop/zh-cn/explain_data.htm)来自动创建视图。
- 使用架构搜索在“数据”窗格中搜索字段
- 将字段拖到视图、行、列和**“标记”**卡中的不同标记类型。
- 使用**“智能显示”**来创建视图。另外，从“数据”窗格中，选择感兴趣的字段并将其拖到视图区域，以自动创建“智能显示”视图。
- 查看基础数据（通过工具提示）。
- 工具提示内部可视化项可在 Web 视图中工作，但必须在 Tableau Desktop 中配置。[工具提示内部可视化项工作表可以隐藏](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#viz_in_tooltip.htm#Hide)，用相同的方式也可以隐藏故事或仪表板中使用的工作表。
- [动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions.htm)可在 Web 视图中工作，但必须在 Tableau Desktop 中配置。
- 创建和编辑计算字段。
- 利用连续的度量创建数据桶，并编辑数据桶。
- 创建和编辑表计算，并使用快速表计算。
- 创建集和显示集控件。（请注意，您不能在 Web 制作中从多维数据集数据源创建集。）
- 使用**“分析”**窗格将参考线、趋势线和其他对象拖到视图中。编辑参考线、趋势线和区间。在连续轴上创建和配置参考分布。Web 不支持添加群集以及添加和修改预测。
- 通过以下方法来创建组：在视图中选择标记，然后在该选择的工具提示中单击“组成员”（回形针图标）。您也可以在“数据”窗格中编辑现有组。
- 通过将一个维度拖到“数据”窗格中的另一个维度上来创建分层结构。**注意：**当字段已在文件夹内分组时，您无法创建分层结构。
- 更改用于与地图交互的选项，包括启用或禁用平移和缩放，或显示地图搜索、视图工具栏或地图比例。用户还可以映射单位。
- 在视图中上钻查询和下钻查询连续的层次结构。在具有连续层次结构的视图中，将鼠标悬停在连续轴上的标题附近以显示 + 和 - 控件。单击以向下或向上钻取。
- 显示标签、总计和小计。
- 显示、隐藏标记标签以及设置标记标签的格式
- 显示和隐藏标题和说明。
- 显示和隐藏筛选器和突出显示工具卡。
- 在视图中显示、隐藏标题和调整标题大小。
- 交换 X 和 Y 轴。调整视图中轴的大小。
- 更改视图大小。
- 显示和隐藏任何视图或仪表板的视图工具栏。
- 将工作表复制为交叉表视图。

### 筛选和排序

- 使用数据突出显示。
- 添加、编辑和移除筛选器，并编辑筛选器控件布局。
    
    **注意**：在 Tableau Cloud 或 Tableau Server 上制作数据时可以筛选的结果数量有限制。只会返回前 100 个结果，以限制在服务器上加载大型域时对用户产生的性能影响。
- 跨发布的数据源进行筛选。
- 将筛选器应用于多个工作表
- 创建上下文筛选器（“筛选器”功能区中的“添加到上下文”选项）和相关筛选器（视图中显示的筛选器控件中的“仅相关值”选项）。
- 在视图中对总计应用表计算筛选器。
- 显示隐藏字段并从视图中排除或删除字段。
- 按照升序或降序顺序对视图中的字段排序。通过在“行”或“列”功能区中右键单击维度来访问“排序”对话框。在每个区的上下文内对维度值进行嵌入排序。
- 拖放标题可在视图内创建自定义排序顺序。

### 格式设置

- 调整行标题的宽度和列标题的高度。
- 编辑工作簿格式，包括设置行的格式。
- 编辑工作表和仪表板标题。
- 编辑轴（在视图中双击轴）。其他可用选项：**使双轴同步**、清除轴范围（**重置**）以及刻度线设置。在字段上下文菜单中启用或禁用“**双轴**”（在“行”或“列”功能区上双击度量字段）。对数刻度可以为正值或对称（包括 0 和负值）。
- 编辑数字格式（小数位数、百分比、千位分隔符、单位和货币）。
- 创建、编辑、移动点、标记和区域注释并调整其大小。
- 添加和编辑仪表板对象，其中包括：水平和垂直布局容器、文本、图像、导航按钮、网页链接以及仪表板扩展程序。
- 创建透明工作表背景（将背景颜色设置为“无”）。将透明工作表与透明筛选器、荧光笔和参数合并。
- 更改调色板。对于分类字段，可以为数据项分配特定颜色和自定义颜色（使用十六进制代码）。对于连续字段，可以（使用十六进制代码）为开始和结束颜色设置自定义颜色。
- 创建、重新排列和预览设备特定的仪表板布局
- 设置仪表板项的确切大小、位置和间距。
- 在仪表板中的项周围添加填充、边框和背景颜色。
- 在地图视图中选择背景地图。
- 按度量显示图例。如果您为视图中的度量创建单独的颜色图例，Tableau 将为每个新的颜色图例分配默认调色板。要更改每个度量的颜色图例，请单击颜色图例上的下拉箭头以打开“编辑颜色”对话框，然后选择要使用的调色板。有关更多详细信息，请参见[按度量显示图例](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#view_parts.htm#LegendsPerMeasure)。

## 相关主题

[我可以使用 Tableau 站点做些什么？](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_overview.htm)

[设置站点的 Web 制作访问权限](https://help.tableau.com/current/server/zh-cn/web_author_enable.htm)

[Web 制作入门指南](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#getstarted_web_authoring.htm)

[Creator：连接到 Web 上的数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_connect.htm)

[Creator：在 Web 上准备数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_data_prep.htm)

[在 Web 上构建视图](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_build_view.htm)

[授权 Web 编辑、保存和下载权限](https://help.tableau.com/current/server/zh-cn/web_author_who.htm)

<!-- document id=4b5b697fbff74f387eab3841fc1c1729c8cdb137fe4dab4aa6562f93a35d0bc6 url=/tableau/next/zh-cn/online/to_sync_local_data.md -->

[跳转到主要内容](#main-content)

# 与 Bridge 的连接

当数据源或虚拟连接连接到 Tableau Cloud 无法直接访问的私有网络数据时，可以使用 Tableau Bridge 来帮助进行连接。

## 连接类型

Tableau Bridge 支持本地数据或防火墙后面的虚拟云中的数据。这些数据可以是专用网络上的 CSV 文件，也可以是存储在数据仓库中的数据。

对于 Tableau Cloud 可以直接访问的云数据，直接使用 Tableau Cloud 设置刷新计划几乎总是更好的选择。例如，您或许能够连接到云平台上托管的 MySQL 数据库。在这种情况下，您可以为直接使用 Tableau Cloud 连接到此类数据的数据提取设置刷新计划。

**数据提取刷新**

当数据源或虚拟数据提取时，若要连接到私有网络数据时，可以使用 Bridge 来执行这些数据提取的计划刷新。大多数情况下，内容所有者可以在发布过程中计划刷新。有关数据提取刷新要求，请参见[针对数据提取连接的额外要求](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#conn_extract)。

**实时连接**

Bridge 使用一种称为实时查询的功能，支持与私有网络数据进行实时连接的数据源或虚拟连接。如果内容所有者发布的数据源或虚拟连接使用实时连接来连接到 Tableau Cloud 检测到它无法直接访问的数据，则会自动使用实时查询。有关实时查询要求，请参见[针对实时连接的额外要求](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#conn_live)。

- 对于某些云数据源，Bridge 不支持实时连接。其中包括 Google Cloud SQL、OData 和 Progress OpenEdge。使用数据提取连接来使数据保持最新。
- 对于某些基于私有云的数据源，Bridge 不支持实时连接。其中包括 Google Drive、Box、OneDrive、Dropbox 和 Azure Data Lake Storage Gen2。使用数据提取连接来使数据保持最新。
- 不支持与基于文件的数据（例如 CSV、文本、Excel、统计数据 (.sas7bdat)）的实时连接。

**虚拟连接**

Bridge 支持提供可共享的数据中央访问点的虚拟连接。

- 与虚拟连接一起使用时，不支持 Snowflake。
- 与 Tableau Bridge 一起使用时，不支持虚拟连接的 OAuth。

**文件数据**

最新版本的 Windows 客户端以及适用于容器的 Linux 版 Tableau Bridge 支持提取文件数据，包括 CSV、Excel、文本和统计 (.sas7bdat)、PDF 和空间文件。

- 支持已发布数据源文件的数据提取刷新。我们建议为文件数据连接使用 UNC 格式。如果您要连接到本地文件路径，则必须使用“默认”池。
- 支持嵌入式数据源文件的数据提取刷新。您必须对嵌入式数据源使用已配置的池，并且文件路径必须使用 UNC 格式。
- 不支持文件共享上的 Hyper 文件的数据提取刷新和实时查询。
- 直接从浏览器上载工作簿时，无法为连接到平面文件的数据源执行数据提取刷新。
- 不支持基于文件的数据的实时连接。
- 对于 Prep Conductor 流程，不支持使用 Bridge 刷新平面文件数据。若要成功刷新 Prep Conductor 流程，请将平面文件移动到 Tableau Cloud 可直接访问的位置（Google Drive、Box、Dropbox 等）。

**与基于多维数据集的数据的连接**

不支持基于多维数据集的数据。

**嵌入式数据源**

Tableau Bridge 支持嵌入工作簿中的数据源。

- 对于 CSV、文本、Excel、统计 (.sas7bdat) 等文件数据，不支持实时连接。
- 默认池不支持嵌入式数据源。您必须使用已配置的池。有关详细信息，请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。

**已发布数据源**

已发布数据源的计划数据提取不支持多个池。

**Tableau Prep Builder**

从版本 2025.1 开始，支持通过 Tableau Bridge 进行 Tableau Prep 的专用网络连接。必须将 Tableau Bridge 客户端配置为使用 Bridge 客户端池（而不是默认池）。有关详细信息，请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。

您可以使用 Tableau Bridge 客户端连接到 Tableau Cloud 中的数据并刷新数据。有关详细信息，请参见 [从 Tableau Prep Builder 发布流程](https://help.tableau.com/current/prep/zh-cn/prep_conductor_publish_flow.htm#publish-a-flow-from-tableau-prep-builder)的“Tableau Cloud”部分中的“数据库”。

从版本 2026.2 开始，在 Tableau Cloud 上制作 Tableau Prep 流程时，您可以通过 Tableau Bridge 连接到包含变量和参数的本地 SAP HANA 数据源。有关详细信息，请参见[连接到数据](https://help.tableau.com/current/prep/zh-cn/prep_connect.htm#connect-via-builtin-connectors-for-popular-data-types)中的“连接到 SAP HANA 数据”。

Bridge 不支持以下操作：

- 运行 Tableau Prep Conductor 来刷新连接到平面文件的 Tableau Prep 流程。
    
    若要成功刷新 Prep Conductor 流程，请将平面文件移动到 Tableau Cloud 可直接访问的位置（Google Drive、Box、Dropbox 等）。
- 使用 Bridge 为 Prep Conductor 流程[将输出数据写入外部数据库](https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#write_to_DB)。
- 连接到 Snowflake。

**用户属性函数**

Tableau Bridge 工作流中不支持[用户属性函数](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html)。

## 连接器和数据类型

Bridge 支持 [Tableau Desktop](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm) 和 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/to_connect_live_sql.htm#connectors) 支持的连接器组合。下面列出了不支持的连接器以及连接器和数据类型的限制。

**包括外部文件**

不支持“包括外部文件”。请参见下面的[连接到平面文件和基于文件的数据提取](#remote-share)。

**私有云数据**

大多数情况下，Tableau Cloud 会自动检测 Bridge 客户端。但是，在某些情况下，您可能需要手动配置连接，以确保使用 Bridge。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。

**不支持的连接器**

- 不支持由不在 Tableau Exchange 上的第三方构建的连接器。
- 某些 Exchange 连接器不受支持。请参见下文。
- AWS S3
- Microsoft Analysis Services。
- Microsoft PowerPivot。
- Oracle Essbase。
- SAP NetWeaver Business Warehouse。

**Exchange 连接器**

Tableau Bridge 可用于使用 [Tableau Exchange 连接器页面](https://exchange.tableau.com/connectors)上提供的所选连接器查询数据。支持的 Exchange 连接器如下所示：

- Actian JDBC
- Actian ODBC
- Altinity Connector for ClickHouse
- AtScale
- Clickhouse
- Couchbase Analytics
- Data Virtuality JDBC
- dbt Semantic Layer
- Denodo JDBC
- Dr.Sum JDBC
- Exasol JDBC
- Firebolt
- Guidanz BI 连接器
- Incorta
- Jethro ODBC
- Looker
- MongoDB SQL Interface
- MotherDuck/DuckDB
- Oracle NetSuite
- Palantir Foundry
- REST API 连接器
- Salesforce Commerce Cloud Intelligence
- Salesforce Marketing Cloud
- SAP SuccessFactors
- ServiceNow
- SharePoint 列表 (JDBC)
- SingleStoreDB JDBC
- StarRocks
- Starburst
- Stratio Crossdata

Actian JDBC、Altinity Connector for ClickHouse、Guidanz BI Connector、Couchbase Analytics、Stratio Crossdata、Data Virtuality JDBC、Jethro ODBC、Oracle NetSuite、SAP SuccessFactors、ServiceNow 和 SingleStoreDB JDBC。

若要将 Exchange 连接器与 Tableau Bridge 一起使用，请对池中将访问目标数据源的每个 Exchange 连接器和每个 Bridge 客户端执行以下步骤。

1. 从 [Tableau Exchange 连接器页面](https://exchange.tableau.com/connectors)下载 .taco 文件。
2. 将 .taco 文件添加 Tableau 存储库连接器目录：
    
    - 在 Windows 上：`C:\Users[Windows User]\Documents\My Tableau Bridge Repository\Connectors`
    - 在 Linux 上：`/root/Documents/My_Tableau_Bridge_Repository/Connectors`
    - 对于数据连接，运行以下命令在基础映像中创建 Connector 目录： `mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors`
3. 按照 Tableau Exchange 上针对您的连接器的说明下载所需的驱动程序。
4. 在 Bridge 客户端上安装驱动程序。
5. 重新启动 Bridge 客户端。

**不支持实时连接的连接器**

- Google Cloud SQL
- OData
- Progress OpenEdge
- 平面文件

**SAP HANA**

支持标准配置。

**Snowflake**

与虚拟连接一起使用时，不支持 Snowflake。

**多连接数据源中使用的数据**

Tableau Bridge 可用于刷新跨数据库联接的数据源。工作簿或数据源中定义的数据库连接确定在 Tableau Cloud 上发布数据并使数据保持最新的方法。只要所有单独的数据连接都是 Tableau Bridge 可以刷新的类型，就可以刷新跨数据库联接的数据源。

**其他数据库**

- Tableau 为使用 JDBC 的连接提供有限的客户支持。请参见 [Tableau 对“其他数据库 (JDBC)”连接的支持](https://help.tableau.com/current/pro/desktop/zh-cn/examples_otherdatabases_jdbc.htm#tableau-support-for-other-databases-jdbc-connections)。
- Tableau 为使用 ODBC 的连接提供有限的客户支持。请参见 [Tableau 对“其他数据库 (ODBC)”连接的支持](https://help.tableau.com/current/pro/desktop/zh-cn/examples_otherdatabases.htm#tableau-support-for-other-databases-odbc-connections)。

**Web 数据连接器**

- Bridge 无法连接到 Web数据连接器 3.0 中的数据。有关详细信息，请参见[使用 Web 数据连接器 3.0 SDK 构建的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/examples_wdc_connector_sdk.htm)。
- 自 2023.1 版本起，Web 数据 2.0 已弃用。请参见 [Web 数据连接器 2.0](https://help.tableau.com/current/pro/desktop/zh-cn/examples_web_data_connector.htm)。
- Tableau 不对连接器或写入到 WDC API 接口的其他程序提供支持。

## 使用 Tableau Bridge 进行 Web 制作

在 Tableau Cloud 内制作数据视图或直接在 Web 上工作时，Tableau Bridge 为各种数据库和云数据环境提供完整的查询支持：

- **指定连接器**：您可以在 Web 制作会话期间直接为 Tableau Cloud 连接窗格中显示的任何受支持的命名连接器建立全新的数据连接。
- **非指定/通用连接器**：在修改已指向功能齐全、预先存在的 Bridge 支持的架构的内容时，Web 制作与某些非指定数据库连接器完全兼容。这包括：
    
    - “编辑数据源”选项可能不适用于所有未命名连接器。
    - 编辑现有且正常运行的云工作簿中的嵌入式数据源。

Tableau 不支持在所有情况下通过 Web 制作编辑已发布数据源。限制如下：

- **“编辑数据源”**选项可能不适用于使用未命名（通用）连接器的已发布数据源。按钮显示为灰色。
- 当前不支持编辑包含 Bridge 数据源的多个连接的实时已发布数据源，否则会导致错误。

### Bridge 代理要求

必须连接活动 Bridge 客户端并将其分配给池，Web 制作会话才能正常工作。如果代理不可用，Tableau Cloud 可能会尝试直接连接到数据库。

此回退行为可以：

- 触发掩盖真正原因的一般连接错误（Bridge 代理缺失或脱机）。
- 对于需要所有流量都通过 Bridge 进行路由以确保私有网络安全的组织，会导致意外失败。

为了防止意外错误，请在开始 Web 制作会话之前验证至少一个 Bridge 客户端是否处于联机状态并已池化。

### 操作先决条件

为确保无缝的 Web 编辑功能，站点管理员必须验证以下基准先决条件：

- 路由规则一致性：在所有情况下，必须在明确定义的 Bridge 命名池中主动注册目标数据库域或主机地址。
- 驱动程序可用性：对于数据库编辑方案，必须直接在运行活动 Bridge 客户端的物理主机上手动安装目标基础结构所需的匹配数据库驱动程序。
- 代理和网络规则：在专用或受限私有云配置中，您可能需要发布数据源。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。
- 会话超时限制：Web 上的所有 Web 制作交互、数据查询会话和大量分析修改仍受标准 Tableau Cloud 操作防护机制的约束，包括 2 小时的处理超时。

### 使用 Bridge 进行 Web 制作期间的错误

Web 制作失败期间显示的错误消息可能未明确指明与 Bridge 相关的问题。常见场景如下：

- 网络或登录超时错误（例如，“发生了网络相关或实例特定的错误”或“登录超时已过期”）可能表示 Tableau Cloud 回退为直接尝试连接，而不是通过 Bridge 进行路由。验证您的 Bridge 客户端是否已连接并分配给正确的池。
- **NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL** 错误表示没有将 Bridge 代理分配给为您的站点配置的命名池。分配一个活动 Bridge 客户端来解决此问题。
- 如果**“编辑数据源”**按钮呈灰色显示，则数据源使用当前不支持通过 Web 制作进行编辑的未命名连接器。

## Linux 版 Bridge

Tableau Bridge 支持专为容器工作负载设计的基于 Linux 的操作系统。限制和差异包括：

- Linux 版 Bridge 不支持旧版计划。
- Linux 版 Bridge 在后台运行，相当于 Windows 版 Tableau Bridge 中的服务模式。
- 若要保存日志文件，请在 docker 容器和本地文件文件系统之间复制文件或文件夹。
- 目前，Linux 版 Bridge 是通过使用 Docker 可执行文件在正在运行的容器中运行命令来安装的。
- Linux 版 Bridg 不支持 Window 集成身份验证。
- Linux 版 Bridge 仅支持具有 Linux 驱动程序的 Exchange 连接器。

### 连接到平面文件和基于文件的数据提取

自 2025 年 2 月发布以来，您可以配置 Linux 版 Bridge 以连接到远程共享。

与有时以静态上载形式“包括外部文件”的工作簿不同，连接到平面文件的已发布数据源需要 Tableau Bridge 来进行所有刷新活动：

- Tableau Cloud 不支持在独立的已发布数据源中嵌入物理平面文件。
- 发布时，请确保数据源指向完整的 UNC 路径（例如，\\\\InternalServer\\Data\\file.xlsx）。如果在发布独立源期间选择了“包括外部文件”，可能会导致 Bridge 在不存在的临时云目录中查找该文件，从而导致刷新失败。

发布用于 Bridge 刷新的独立数据源时，请始终取消选中“包括外部文件”。

![](/tableau/next/zh-cn/online/zh-cn/Img/to_bridge_liinux_map_drive_557x470.png "更改为")

#### 配置远程共享

1. 创建并设置远程共享的访问权限。例如，`SharedWB_1`。此计算机 host1 的最终 UNC 路径为 `//host1/SharedWB_1`。
2. 在运行 Bridge 客户端的主机上，将远程共享挂载到本地文件系统上。例如，`/mnt/remotes/H1_WB`。
3. 在文本文件中，使用以下格式创建 UNC 映射： `//<remote UNC>:/<local mount>`。例如，`//host1/SharedWB_1:/mnt/remotes/H1_WB`。
4. 通过在 Docker 文件中包含以下内容来配置 Docker 包含的远程共享。下面的示例远程共享配置与上图相对应。
    
    dnf install -y cifs-utils
    export CRED=/mnt/remotes/creds/
    mkdir -p $CRED && chmod 700 $CRED
    
    # Prepare credential files for host\_1 ($CRED/.h1) and host\_2 ($CRED/.h2)
    #    credential file format should be:
    #          username=...
    #          password=...
    chmod 600 $CRED/.h1
    chmod 600 $CRED/.h2
    
    # Add these CIFS entries to /etc/fstab (this will be automatically mounted on
    # reboot)
    cat >> /etc/fstab << EOE
    //host\_1/SharedWB\_1    /mnt/remotes/H1\_WB    cifs    credentials=/mnt/remotes/creds/.h1    0    0
    //host\_1/SharedDS\_1    /mnt/remotes/H1\_DS    cifs    credentials=/mnt/remotes/creds/.h1    0    0
    //host\_2/SharedWB\_1    /mnt/remotes/H2\_WB    cifs    credentials=/mnt/remotes/creds/.h2    0    0
    //host\_2/SharedDS\_1    /mnt/remotes/H2\_DS    cifs    credentials=/mnt/remotes/creds/.h2    0    0
    EOE
    
    # and mount fstab entries
    mount /mnt/remotes/H1\_WB
    mount /mnt/remotes/H1\_DS
    mount /mnt/remotes/H2\_WB
    mount /mnt/remotes/H2\_DS
    
    # Create the UNC map file
    cat > /mnt/remotes/uncmap << EOM
    //host\_1/SharedWB\_1:/mnt/remotes/H1\_WB
    //host\_1/SharedDS\_1:/mnt/remotes/H1\_DS
    //host\_2/SharedWB\_1:/mnt/remotes/H2\_WB
    //host\_2/SharedDS\_1:/mnt/remotes/H2\_DS
    EOM
    						
    
    Bridge 客户端定期读取 UNC 映射文件来检查是否有更改。为了避免 Bridge 在更改后重新启动，请将挂载目录和 UNC 映射文件的位置保存在同一目录中。
5. 运行以下命令完成配置：
    
    docker container run \\
    ...
    -e TABLEAU\_BRIDGE\_UNC\_MAP\_OVERRIDE='/mnt/remotes/uncmap' \\
    --mount type=bind,source="/mnt/remotes",target=/mnt/remotes \\
    ...

## 身份验证

站点的已连接客户端选项必须为启用状态，以允许 Bridge 客户端在无人值守的情况下运行，并且如果启用，则支持多重 Tableau 身份验证。如果为站点禁用了已连接客户端，则 Bridge 只能支持 Tableau 用户名和密码身份验证。

**OAuth**

- Windows 版 Tableau Bridge 和 Linux 版 Bridge 不支持适用于 Azure SQL、Azure Synapse 和 Dremio 的 OAuth。
- 支持 Google Drive 和 OneDrive 的嵌入式数据源和已发布数据源的 OAuth。
- 将您自己的身份提供程序 (IdP) 与 Amazon Athena 连接器结合使用时，您必须设置 OAuth 客户端配置文件。请参见[将您自己的身份提供程序与 Amazon Athena 结合使用](https://help.tableau.com/current/pro/desktop/zh-cn/amazon_athena_idp.htm)。

**Windows 身份验证**

Windows 用户帐户必须是本地管理员组的成员，才能在服务模式下运行客户端。如果用户不是本地管理员，他们可以在应用程序模式下运行 Bridge 客户端，但他们必须保持登录到 Windows 计算机。

**Kerberos**

Windows 版 Bridge 通过“运行身份”帐户支持集成 Windows 身份验证，适用于文件和某些数据库。

## 此部分中的其他文章

<!-- document id=c72a1e47325ae641bc2b1c4d7f08689f92293f6e8c3802c69a4c5e6d3cde6d81 url=/tableau/next/zh-cn/online/Viewer.md -->

[跳转到主要内容](#main-content)

# 与 Tableau 上的数据交互

本教程将引导您了解一些在 Tableau Server 中查看数据可视化项或视图并与之交互的基础知识。

Tableau 是一种工具，可让您与已发布的可视化项进行交互，以探索见解、提出问题并掌握数据。下面是如何开始操作的方法。

## 开始吧。可以安全地四处点击

Tableau 是为交互而构建的。您对可视化项所做的更改将暂时更改其外观。

其他人仍将看到最初显示的可视化项。用于构建它的数据也保持不变。

## 1：什么是 Tableau 站点？

Tableau 站点是您的团队相互分享数据和数据可视化项的地方。您可以浏览他们发布并向您提供的内容。

登录到 Tableau 站点时，您将进入主页。

![Tableau Cloud 上的查看者登录页面。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_sign_in.gif)

## 2：搜索可视化项

Tableau 将站点上的可视化项称为“视图”。使用搜索来查找视图或工作簿（单个文件中的一系列视图）。

搜索结果将显示与查询相关的所有不同内容类型。

![查看者可以在 Tableau Cloud 上搜索视图和工作簿。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_search.gif)

如果快速搜索中的视图不是您想要的，则可以选择“全部查看”以查看所有搜索结果，或使用“浏览”页面进行浏览。在这里，您将看到 Tableau 站点可以托管的所有不同类型的内容。

## 3：与内容互动

已发布视图是供您与数据交互和理解数据的画布。请记住，您不会破坏或更改基础数据，也不会更改其他人看到的内容。

以下是工具箱中的一些工具，可用于查找数据见解。

### 查看详细信息和对数据进行排序

现在您知道可以单击数据了，让我们检查一下。

当您在视图上移动鼠标时，您可能会看到一些工具提示，其中显示有关每个数据点（或标记）的详细信息。您也可以选择多个标记。

![查看者将鼠标悬停在已发布可视化项上的标记上。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_details.gif)

通过将鼠标悬停在列标题上并单击排序图标，可以按字母顺序或数字顺序对表进行排序。

![查看者可以对 Tableau Cloud 上的数据进行排序。](/tableau/next/zh-cn/online/zh-cn/Img/viewer_sort.gif)

### 筛选数据

将可见数据修剪或限制为特定区域、日期或类别。

![查看者可以筛选 Tableau Cloud 上的数据。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_filter.gif)

### 撤消/还原

也许您不是要排除所有区域，而是要排除一个区域。单击“撤消”以移除上一次更改，或使用“还原”来撤消所有选择。

![Tableau Cloud 上的撤消按钮。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_undo.gif)

## 4：保持

此视图可以使用新数据自动更新，因此您无需去搜索新图表即可获取最新信息。单击星形图标将其添加到收藏夹，以使其方便使用。

![在 Tableau Cloud 上收藏视图。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_favorites.gif)

所有收藏夹都将添加到导航面板的“收藏夹”页面。您浏览的任何最近的仪表板或视图也将显示在主页中，等待您下次使用。

![在 Tableau Cloud 的“主页”选项卡上访问收藏的工作簿。](/tableau/next/zh-cn/online/zh-cn/Img/Viewer_favoriteshome.gif)

在 Tableau Server 中，您可以做很多事情，本文只是探索了一些基础知识。有关详细信息，请参见“我可以使用 Tableau Web 视图做些什么？”

祝您探索愉快！

<!-- document id=91e6ca5fa21b36b7697d1378899cafa2d3b44493d7adcd0ac993d89f7956fa4c url=/tableau/next/zh-cn/online/security_personal_access_tokens.md -->

[跳转到主要内容](#main-content)

# 个人访问令牌

个人访问令牌 (PAT) 使您和您的 Tableau Cloud 用户能够创建可长期使用的身份验证令牌。PAT 使您和您的用户能够登录到 Tableau REST API，而无需硬编码凭据（用户名和密码）或交互式登录。有关将 PAT 与 Tableau REST API 结合使用的详细信息，请参见 Tableau REST API 帮助中的[登录和注销（身份验证）](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_concepts_auth.htm)。

> [!WARNING]
> 
> **重要信息：**Tableau Cloud PAT 不能用于登录 Tableau Cloud Manager (TCM) REST API。若要对 TCM REST API 进行身份验证，您必须使用 TCM 中生成的 PAT。有关如何将 PAT 与 TCM 结合使用的详细信息，请参见[Tableau Cloud Manager 的个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_personal_access_tokens.htm)。

建议为使用 Tableau REST API 创建的自动化脚本和任务创建 PAT：

- **提高安全性：**PAT 可在凭据泄露时降低风险。对于自动化任务，您可以使用个人访问令牌，而不是使用用户名和密码来减少凭据泄露的影响。如果 PAT 遭到破坏，或在出现故障或导致风险的自动化任务中使用，您或您的用户只需撤销 PAT，而无需轮换或撤销用户的凭据。
- **管理自动化：**可以为运行的每个脚本或任务生成一个 PAT。这使您和您的用户能够存储和查看整个组织中的自动化任务。此外，如果在使用 PAT 之后对用户帐户进行密码重置或元数据更改（用户名、电子邮件等），将不会像凭据硬编码在脚本中时一样中断自动化操作。
- **监视使用情况：**如果您拥有具有 Advanced Management 功能的 Tableau Cloud，作为站点管理员，您可以查看活动日志以跟踪哪些用户正在创建和撤销 PAT、正在使用哪些 PAT、正在撤销哪些 PAT 以及附加到它们的会话。

**注意：** 

- 您必须使用 PAT 而不是用户名和密码来向 Tableau Cloud 发出 REST API 登录请求，并通过 Tableau 身份验证启用了多重身份验证 (MFA)。
- 对于对 Tableau Cloud 的通用客户端访问，不使用 PAT。
- 若要将 PAT 与 tabcmd 一起使用，请从 [https://tableau.github.io/tabcmd/](https://tableau.github.io/tabcmd/) 安装 tabcmd 的兼容版本。
- 当[用户的身份验证方法](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)更改时，PAT 会自动撤销。

## 了解个人访问令牌

创建个人访问令牌 (PAT) 之后，会对其进行哈希处理并存储在存储库中。对 PAT 进行哈希处理并存储后，PAT 密文会向用户显示一次，然后在用户关闭对话框后就无法再访问。因此，系统会指示用户将 PAT 复制到安全的位置，并像处理密码一样对其进行处理。在运行时使用 PAT 时，Tableau Cloud 会将用户提供的 PAT与存储在存储库中的哈希值进行比较。如果匹配，则会启动经过身份验证的会话。

在授权范围内，使用 PAT 进行身份验证的 Tableau Cloud 会话具有与 PAT 所有者相同的访问权限和特权。

**注意：**用户不能通过 PAT 请求并发 Tableau Cloud 会话。使用相同的 PAT 再次登录，无论是在同一个站点还是不同的站点，都将终止前一个会话并导致身份验证错误。

### 关于 PAT 过期

如果个人访问令牌 (PAT) 在连续 15 天后未使用，它们将过期。如果 PAT 的使用频率高于每 15 天一次，则其过期时间取决于 PAT 的站点设置，该设置可由站点管理员进行配置。

PAT 过期后，它们将无法用于身份验证，并会从用户的“我的帐户设置”页面中移除。

## 个人访问令牌的站点设置

### 配置 PAT 创建和过期

作为站点管理员，您可以配置谁可以创建和使用 PAT，以及 PAT 何时过期。您对 PAT 设置所做的更改仅适用于新 PAT。在设置更改之前创建的 PAT 保留创建时的配置，并保持有效直至过期。

在 2023 年 6 月 (Tableau 2023.2) 及更高版本激活的站点上，默认情况下禁用创建 PAT。在 2023 年 6 月 (Tableau 2023.2) 之前激活的站点上，默认为所有用户启用创建个人访问令牌 (PAT)，并且默认有效期为一年。

1. 以站点管理员身份登录到 Tableau Cloud，并导航到“设置”页面。
2. 在“个人访问令牌”部分下，选中“启用个人访问令牌”复选框（如果尚未选中），然后执行以下任务_之一_：
    
    - 保留“启用个人访问令牌”复选框选择以使所有用户能够创建 PAT。
    - 或者，选择“仅限指定组中的用户”单选按钮，然后从列表中选择一个组，以将创建新 PAT 的访问权限限制为仅属于该组成员的用户。  
        **注意：**如果选择此选项，则必须选择一个组才能保存设置。

1. 在“设置过期期限”下，执行以下操作_之一_：
    
    - 如果尚未选择，请选择“180 天”单选按钮。
    - 或者，在“自定义天数”文本框中输入 1 到 365 之间的有效值。
    
    ![用于创建个人访问令牌并设置有效期的表单。](/tableau/next/zh-cn/online/zh-cn/Img/pats_configure.png)
2. 完成后，单击页面顶部或底部的“保存”按钮。

## 管理用户个人访问令牌的任务

### 创建 PAT

站点管理员无法为用户创建 PAT。您的用户必须创建自己的 PAT。

在 Tableau Cloud 上具有帐户的用户可以在“我的帐户设置”页面上创建、管理和撤消个人访问令牌。有关详细信息，请参见 Tableau 帮助中的[管理您的帐户设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm)。

注意：一个用户最多可以有 104 个 PAT。

### 监控 PAT 使用情况

如果有包含 Advanced Management 的 Tableau Cloud，您可以使用活动日志来监控 PAT 使用情况。活动日志中捕获 PAT 使用情况的事件包括但不限于：颁发令牌（颁发刷新令牌）、使用令牌登录（使用 pat 登录）、兑换令牌（兑换刷新令牌）和撤销令牌（撤消刷新令牌）。有关这些事件的详细信息，请参见[活动日志站点事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm)。

### 撤销 PAT

作为站点管理员，您可以撤销用户的 PAT。用户还可以使用 Tableau 用户帮助中[管理您的帐户](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm#pat)主题中描述的过程在“我的帐户设置”页面上撤销自己的 PAT。

1. 以站点管理员身份登录到 Tableau Cloud，并导航到“用户”页面。
2. 找到要撤消其 PAT 的用户。有关服务器管理页面导航和查找用户的详细信息，请参见[查看、管理或移除用户](https://help.tableau.com/v0.0/online/zh-cn/users_view.htm)。
3. 单击用户的名称以打开其个人资料页面。
4. 在该用户的个人资料页面上，单击“设置”选项卡。
    
    注意：如果站点管理员是用户所属的所有站点的站点管理员，则他们只能访问“设置”选项卡并查看用户的 PAT。
5. 在“个人访问令牌”部分，标识要撤消的 PAT，然后单击“撤消令牌”按钮。
6. 在“删除”对话框中，单击“删除”按钮。

<!-- document id=df47064e439f932f35b2bb71c04f553c31d683293fee88d24d24f2e91cce276a url=/tableau/next/zh-cn/online/gworkspace_set_up.md -->

[跳转到主要内容](#main-content)

# 为 Google Workspace 设置 Tableau 加载项

Google Workspace 的 Tableau 加载项允许您直接在工作流中安全地查看 Tableau 内容并与之交互。您可以将 Tableau 可视化项和 Pulse 指标的图像快照嵌入到 Google 文档和幻灯片中。您还可以将 Tableau Cloud 数据源直接连接到 Google Sheets，并将数据从 Google Sheets 导出到 Tableau Cloud。

该加载项适用于 Tableau Cloud 和 Tableau Server，可通过 Google Workspace Marketplace 获得。Tableau 管理员负责安装和设置用于连接 Tableau 站点和 Google Workspace 环境的应用。

有关使用 Google Workspace 的 Tableau 加载项的信息，请参见[在 Google Workspace 中访问 Tableau 内容](https://help.tableau.com/current/online/zh-cn/gworkspace_explore.htm)。

## 先决条件

若要为 Google Workspace 设置 Tableau 加载项，您需要以下应用和帐户：

- Tableau Cloud 或 Tableau Server
- Tableau Cloud 的站点管理员帐户或 Tableau Server 的服务器管理员帐户
- Google Workspace 订阅
- Google Workspace 管理员帐户
- Tableau 和 Google Workspace 的用户许可证，其中每个用户的 Google Workspace 电子邮件地址与其 Tableau 用户名匹配

## 安装 Tableau 加载项

打开 Google Workspace Marketplace，然后搜索 [Tableau 加载项列表](https://workspace.google.com/marketplace/app/tableau_cloud/1044537977580?flow_type=2)。  
  
![](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_install.png)  

如果安装按钮不可用，则您的 Google Workspace 管理员可能已定义可用加载项的允许列表。确保您的 Google Workspace 管理员已将 Tableau 加载项添加到允许列表中。Google Workspace 管理员也可以根据 Google 用户组为用户[自动安装加载项](https://support.google.com/a/answer/172482?hl=en\&ref_topic=27380\&sjid=17199801914992583928-NA)。

如果安装按钮处于活动状态，请选择该按钮，然后在新浏览器标签页中打开 Google 文档或幻灯片。安装加载项后，您将在右侧面板中看到一个 Tableau 图标。

## 配置 Tableau 加载项

首次打开 Tableau 加载项时，系统会提示您授权访问。Tableau 加载项需要访问您的 Google Drive 文件（例如 Google 文档和 Google 幻灯片）才能从 Tableau 导入和导出内容。

单击“授权访问”按钮将触发 OAuth 通知，该通知将概述所需的特定权限。

授予对 Tableau 加载项的访问权限后，您可能会再次收到一个提示，询问该加载项是否可以访问此特定文档或幻灯片。我们不会请求访问用户的所有云端硬盘文件，而只会请求您想要使用加载项的文件的权限。选择“允许”。  
  
![](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_access.png)

## 配置 Tableau 站点

首次打开 Tableau 加载项时，系统会提示您添加站点配置。使用此设置可以指定要与 Google Workspace 集成的 Tableau Cloud 站点。

只有对 Tableau Cloud 站点具有管理员权限的用户才能管理站点配置。

### 步骤 1：获取 Tableau 站点详细信息

1. 若要与 Tableau 站点通信，请确保您有一个直接信任的已连接应用。
2. 如果没有，您的 Tableau 管理员应遵循[使用直接信任配置已连接应用](https://help.tableau.com/current/online/zh-cn/connected_apps_direct.htm#create-a-connected-app)的准则。
3. 将状态设置为“已启用”。您可以绕过访问级别和域允许列表设置，因为加载项使用 Tableau REST API。
4. 收集 Tableau 已连接应用的客户端 ID、密文 ID 和密文值。您将在配置 Tableau 加载项时输入此信息。

### 步骤 2：配置 Tableau 加载项

1. 在 Google 文档或 Google 幻灯片中打开 Tableau 加载项。
2. 选择“添加新站点配置”，并输入您的 Tableau 站点信息和已连接应用详细信息。
3. 按下表中所述填写配置字段。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">属性</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1">描述</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><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">Tableau 基本 URL</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">这是 Tableau 站点的主机名。举例来说，如果您的 Tableau 站点可在 <span class="example">https://us-east-1.online.tableau.com/#/site/devplatembed/home</span> 访问，则“基本 URL”将为 <span class="example">https://us-east-1.online.tableau.com</span>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau 站点</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您的 Tableau 站点名称与 URL 中显示的名称完全一致，请记住此字段区分大小写。例如，在前面提供的 URL 示例中，站点名称为 <span class="example">devplatembed</span>。请注意，URL 中限制的字符可能会导致站点名称与其在 Tableau Cloud 中的显示标签略有不同。如果要为 Tableau Server 实例配置默认站点，此字段应留空。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">用户映射</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">此设置确定加载项用于在 Tableau 中对 Google Workspace 用户进行身份验证的方法。<br><strong>电子邮件：</strong>选择此选项后，加载项将使用用户的 Google Workspace 电子邮件地址作为其 Tableau Cloud 用户名。<br><strong>其他属性</strong>：此处将列出您为用户建立的任何自定义属性。必须为想要向 Tableau 进行身份验证的每个 Google 用户设置自定义属性。有关更多详细信息，请参见<a href="#User" class="xref">用户映射</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“域”复选框</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">在 Google Workspace 中注册的每个域都会有一个对应的复选框。有关其他信息，请参阅有关<a href="#Domains" class="xref">域</a>的部分</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">已连接应用凭据</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">您在步骤 1 中收集的 Tableau 站点详细信息。输入 Tableau 已连接应用的客户端 ID、密文 ID 和密文值。</td></tr></tbody></table>

1. 选择“保存”并刷新网页。

下次打开 Tableau 加载项时，下拉菜单将显示已配置站点的列表。

若要开始使用 Tableau 加载项，请选择右上角的“主页”按钮。

若要管理站点配置，请从主屏幕中选择“设置”。

#### 用户映射

若要向 Tableau Cloud 或 Server 验证 Tableau 加载项的身份，必须将 Google 用户映射到其对应的 Tableau 用户名。对于 Tableau Cloud，用户名通常对应于电子邮件地址。通过从下拉列表中选择“电子邮件”，加载项将使用用户的主要 Google Workspace 电子邮件进行登录。

不过，如果您的 Tableau 用户名与 Google Workspace 主要电子邮件不一致，则可以使用自定义属性或外部 ID。该加载项通过自动将检测到的自定义属性或外部 ID 作为选项包含在选择下拉列表以及标准电子邮件选项来中，从而支持这些替代身份验证方法。

#### 自定义属性

您可以通过 Google 管理控制台建立自定义属性。转到“Directory”（目录）>“Users”（用户）部分，然后从“More option”（更多选项）菜单中选择“Manage custom attributes”（管理自定义属性）。  
  
![Google Workspace 管理控制台，其中依次选择了“More option”（更多选项）和“Manage Custom Attributes”（管理自定义属性）。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace1.png)

通过选择“Add Custom Attribute”（添加自定义属性）按钮来定义类别（架构）和属性名称。

确保从下拉菜单中选择以下设置：

“Type”（类型）：“Text”（文本）

“Value”（值）：“Single Value”（单一值）

管理员可以选择限制此自定义属性的可见性，以便只有他们自己和该用户本人才能访问它。

  
![Google Workspace 管理控制台，带有用于添加自定义字段的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspacecustomfield.png)

创建自定义属性后，您必须为 Google Workspace 的 Tableau 加载项的每个用户定义其值。

对于个别更新，请转到 Google 管理控制台的“Users”（用户）页面，选择一个用户，然后在出现新字段的“User Information”（用户信息）部分输入值。

若要大规模管理这些值或将它们与 Active Directory 同步，我们建议使用 [Directory Sync](https://knowledge.workspace.google.com/admin/users/get-started-with-directory-sync) 工具。或者，您可以通过 [Google Directory API](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#update_user) 自动执行这些更新。

#### 外部 ID

如果您已经设置了填充[外部 ID](https://help.tableau.com/v0.0/online/zh-cn/%3Chttps://developers.google.com/workspace/admin/directory/reference/rest/v1/users#:~:text=%2C work.-,externalIds,-value \(Value>)的目录同步，则可以在加载项中使用它们。但是，由于 Google 将内置的外部 ID 类型定义为数组，因此它们在加载项中不可见。由于这些数组可以包含不同用户以不同顺序排列的多个值，因此加载项无法确定要选择哪个值。因此，只有当外部 ID 被归类为自定义类型时，加载项才支持外部 ID。

#### 域

加载项通过传递 JWT，通过 [/auth/signin](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_authentication.htm#sign_in) 端点向 Tableau 进行身份验证。此令牌包括已连接应用详细信息和 Google 用户的 Tableau 用户名。为了识别特定用户的正确站点配置，加载项使用 Google API 提供的 hostedDomain 属性。

保存站点配置后，它们将与特定域关联。举例来说，如果用户以 someuser@salesforce.com 身份登录，Google API 会告知加载项用户的域为 salesforce.com。然后，加载项会搜索与该域关联的站点配置以填充站点选取器下拉列表，该过程对大约 95% 的客户有效。

在某些情况下，单个组织内的最终用户可能分布在多个域中，例如 user1@salesforce.com 和 user2@tableau.com。标准 Google API 不提供将这些用户识别为隶属同一公司的机制，除非他们被授予管理权限。

为了简化此过程，加载项会在站点配置、设置或更新期间检索链接到客户的所有域。这样，您只需一次性提供 Tableau 站点详细信息，即可同时将它们应用于多个域。仅当用户拥有执行该特定 API 调用的必要权限，并且这些域是在 Google Workspace 中定义的，域检查清单才会显示额外的域。

**注意：**只有超级管理员或具有 “域管理”、“用户读取”权限的用户才能在 Google 文档、幻灯片或 Google 表格中为多个域设置该加载项，因为该工具需要管理目录范围。

## 另请参见

[Github 上的 Tableau 加载项常见问题解答](https://tableau.github.io/tableau-google-workspace-integration/#faq)

[Google Marketplace 上的 Tableau 加载项](https://workspace.google.com/marketplace/app/tableau/1044537977580)

[将应用添加到允许列表或排除列表](https://knowledge.workspace.google.com/admin/apps/manage-the-marketplace-app-allowlist-for-your-organization?hl=en&visit_id=639099932994860105-1044754439&rd=1#add)

<!-- document id=f4812c0110fd00f5e86384efca877804235491259745e666e01cf5e501963c89 url=/tableau/next/zh-cn/online/config_oauth_impala.md -->

[跳转到主要内容](#main-content)

# 为 Impala 配置外部 OAuth

从 Tableau Desktop 和 Tableau Server 的 Tableau 2025.3 以及 Tableau Cloud 的 2026.1 开始，您可以使用 OAuth 2.0/OIDC 将外部身份提供程序的身份联合到 Impala。

根据身份提供程序的不同，配置集成需要执行不同的步骤。这是一个简略概述。

## 在 Impala 上配置 IDP

有关在 Impala 上配置 IdP 的信息，请参见 Cloudera 文档中的[配置 OAuth 身份验证](https://docs.cloudera.com/cdp-private-cloud-base/7.1.9/impala-secure/topics/impala-oauth.html "用于在 Impala 上配置 OAuth 的 Cloudera 文档链接")。

## 配置 IDP

1. 在 IDP 上为 Tableau Desktop 和 Tableau Server 或 Tableau Cloud 创建 OAuth 客户端。Desktop 客户端应启用 [`PKCE`](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) 并使用 `http://localhost` 重定向。
2. 创建 Tableau OAuth 配置文件。有关如何执行此操作的详细信息，请参见 [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub 上的 OAuth 文档") 上的 [OAuth 配置和使用](https://tableau.github.io/connector-plugin-sdk/docs/oauth)，以及[此处](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub 上的 OAuth 示例。")的示例。我们欢迎提供其他 IDP 的示例。
    
    1. 请务必在 Tableau OAuth 配置 ID 前添加“`custom_`”前缀。
        
        **注意：**OAuth 配置 ID 的最大限制为 36 个字符。长于此长度的 ID 可能不会生成错误，但将不起作用。
    2. 如果您的 IDP 支持动态本地主机端口，则禁用 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`。如果您的 IDP 不支持此功能，请确保将多个本地主机回调 URL 添加到配置文件和 IDP 上的允许列表中。
3. 在与桌面主机（Tableau Desktop、Tableau Prep Builder、Tableau Bridge）上的每个应用程序关联的 `OAuthConfigs` 文件夹中，以及在将通过站点设置页面使用 OAuth 的每个 Tableau Server 和 Tableau Cloud 站点上，安装新的 Tableau OAuth 配置文件。有关更多详细信息，请参见 [Desktop 上的自定义 OAuth 配置](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients)和[站点级别 OAuth 客户端](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop)。

## 连接到 Impala

用户必须选择“使用 OAuth 登录”，然后选择之前安装的“OAuth 提供程序”。

![](/tableau/next/zh-cn/online/zh-cn/Img/impala_oauth_connect.png)

<!-- document id=8fa263b3bcc07e2bcd289a86d911655f68a25ee2d2128c21383dce2cee1f78a5 url=/tableau/next/zh-cn/online/teams_set_up.md -->

[跳转到主要内容](#main-content)

# 为 Microsoft 365 设置 Tableau 应用

适用于 Microsoft 365 的 Tableau 应用使用户无需离开工作流程即可查看和理解其数据。借助 Teams 应用程序，您的用户可以与 Tableau 视图（可视化项）和指标进行交互，并接收其关注指标的 Tableau Pulse 摘要和通知。使用 Word 和 PowerPoint 加载项，用户可以将视图和指标的图像快照添加到其文档和幻灯片中，并刷新这些快照以使其保持最新。

作为 Tableau 管理员，您安装并配置应用以将现有 Tableau 站点与 Microsoft 365 部署连接起来。您可以直接从 Microsoft 应用市场安装适用于 Tableau Cloud 的应用。若要安装适用于 Tableau Server 的应用，请下载并侧载该应用。

有关使用适用于 Microsoft 365 的 Tableau 应用的信息，请参见[在 Microsoft 365 中访问 Tableau 内容](https://help.tableau.com/v0.0/online/zh-cn/teams_explore.htm)。本文介绍如何设置应用。

注意：如果已将 Tableau 或 Microsoft 365 中的语言设置为 Tableau 支持的语言，而不是英语（美国），则您可能会看到未本地化的英语文本。

## 另请参见

- [GitHub 上的 Tableau 应用常见问题解答](https://github.com/tableau/tableau-app-msft-teams)
- [GitHub 上的发行说明](https://github.com/tableau/tableau-app-msft-teams/blob/main/ReleaseNotes.md)
- [YouTube 上的入门教程](https://www.youtube.com/watch?v=nsa123RgCO0)

## 先决条件

若要为 Microsoft 365 设置 Tableau 应用，您需要这些应用、帐户和配置。

- Tableau Cloud 或 Tableau Server 版本 2023.1 或更高版本
- Tableau Cloud 的站点管理员帐户或 Tableau Server 的服务器管理员帐户
- 适用于 Enterprise 订阅的 Microsoft 365
- Microsoft Teams、Word 和 PowerPoint
- Microsoft 365 管理员帐户
- Tableau 和 Microsoft 365 的用户许可证，这些许可证基于用户映射属性之一相互映射
- 已将 IP 地址范围 `4.152.0.0/15` 并 `20.2.0.0/16` 添加到允许列表（仅当在 Tableau Cloud 站点上启用了 IP 筛选时）

### 用户映射属性

若要允许使用 Tableau 进行单点登录，请将 Microsoft 365 中的用户帐户映射到 Tableau 中的用户帐户。您可以使用 Microsoft Teams SDK 或用户的 Microsoft Entra 配置文件中的属性设置此映射。

#### Microsoft Teams SDK 属性

| 属性 | 描述 |
| --- | --- |
| [Preferred\_Username](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/authentication/tab-sso-code#:~:text=user%27s%20display%20name.-,preferred_username,-%3A%20The%20app%20user%27s) | Microsoft Teams 用户的电子邮件地址。在某些情况下，此值与 Microsoft Entra 中定义的电子邮件不同。 |
| [User Principal Name](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/plan-connect-userprincipalname#what-is-userprincipalname) | 用户登录 Microsoft Entra 的主要方式。 |

#### Microsoft Entra 配置文件属性

| 属性 | 描述 |
| --- | --- |
| [Primary Email](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mail,-String) | 与 `user.mail` 属性相对应，并表示用户的电子邮件地址。 |
| [Mail Nickname](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mailNickname,-String) | 与 `user.mailNickname` 属性相对应，并表示用户的别名。 |
| [Employee ID](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=a%20user.-,employeeId,-String) | 与 `user.employeeId` 属性相对应，并表示组织分配的员工标识符。 |
| [On-Premise Distinguished Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesDistinguishedName,-String) | 与 `user.onPremiseDistinguishedName` 属性相对应，并表示从本地 Active Directory 同步的可分辨名称 (DN)。 |
| [On-Premise User Principal Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesUserPrincipalName,-String) | 与 `user.onPremiseUserPrincipalName` 属性相对应，并表示从本地 Active Directory 同步的 userPrincipalName。 |
| [On-premise SAM Account Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%2C%20le\).-,onPremisesSamAccountName,-String) | 与 `user.onPremiseSamAccountName` 属性相对应，并表示从本地 Active Directory 同步的 samAccountName。 |
| [Extension Attribute X](https://learn.microsoft.com/en-us/graph/extensibility-overview?tabs=http) | Microsoft Entra 允许您向用户的 Entra 配置文件添加最多 15 个额外属性。如果 Microsoft Entra 中不存在 Tableau 用户名，请使用扩展程序属性存储每个 Entra 用户的 Tableau 用户名。 |

## 部署适用于 Tableau Cloud 的应用

直接从 Microsoft 应用市场安装 Tableau Cloud 应用。若要安装适用于 Tableau Server 的 Tableau 应用，请参见 [Tableau Server 设置指南](https://help.tableau.com/current/server/zh-cn/teams_set_up.htm)。

### 安装 Teams 应用

您组织的策略确定用户是否可以自行安装应用，或者管理员是否必须为他们安装应用。

1. 打开 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com)。
2. 从导航面板中，选择“Teams apps”（Teams 应用）\>“Manage apps”（管理应用）。
3. 搜索 Tableau 应用，然后选择该应用。
4. 选择是向所有用户还是特定用户提供应用。
5. 若要为用户预安装应用，请为应用添加设置策略。

### 安装 Word 和 PowerPoint 加载项

在 Teams 管理中心安装适用于 Microsoft 365 的 Tableau 应用时，也会为 Word 和 PowerPoint 安装该应用。但是，若要使 Word 和 PowerPoint 加载项可供用户使用，您必须接受其他权限。

1. 打开 [Microsoft 365 管理中心](https://admin.cloud.microsoft.com)。
2. 从导航面板中，选择“Settings”（设置）\>“Integrated apps”（已集成应用）。
3. 搜索 Tableau 应用，然后选择该应用。
4. 选择“Deploy app”（部署应用）。
5. 使应用可供所有用户或特定用户使用。
6. 接受权限。
7. 查看并完成部署。

## 配置 Tableau 应用

安装 Tableau 应用后，Microsoft Teams 会提示您设置应用。您可以配置站点信息以将应用连接到 Tableau 站点。

### 1.创建已连接应用

适用于 Microsoft 365 的 Tableau 应用使用已连接应用通过单点登录对用户进行身份验证。在 Tableau Cloud 和 Tableau Server 中创建此已连接应用。

1. 在 Tableau Cloud 或 Tableau Server 中，创建直接信任的已连接应用。有关详细信息，请参见[使用 Tableau Cloud 的直接信任配置已连接应用](https://help.tableau.com/current/online/zh-cn/connected_apps_direct.htm)或[使用 Tableau Server 的直接信任配置已连接应用](https://help.tableau.com/current/server/zh-cn/connected_apps_direct.htm#create-a-connected-app)。
    
    - 如果您将已连接应用的域允许列表限制为仅指定域，请将以下域添加到允许列表。
        - `tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net`
        - `teams.microsoft.com`
        - `*.teams.microsoft.com`
    - 如果用户将从其他 Microsoft 平台访问应用，请从 [Microsoft 365 URL](https://learn.microsoft.com/en-us/microsoft-365/enterprise/urls-and-ip-address-ranges?view=o365-worldwide) 列表中添加其他域。
2. 启用已连接应用。
3. 生成已连接应用密文。
4. 复制已连接应用客户端 ID、密文 ID 和密文值。保存这些值。您需要它们才能在 Microsoft 365 中配置 Tableau 站点。

### 2.将您的站点配置添加到 Tableau 应用

当您在 Microsoft Teams 中打开 Tableau 应用时，如果您尚未配置该应用，您将看到一个设置屏幕。若要访问 Word 和 PowerPoint 中的站点配置选项，请选择加载项面板底部的“Settings”（设置）按钮。

1. 对于“Label”（标签），为站点指定一个名称。此名称将向 Microsoft 365 应用的用户显示。如果您不输入标签，应用将显示站点名称。此字段为可选。
2. 对于“Tableau Site Name”（Tableau 站点名称），输入出现在您站点 URL 中的名称。例如，对于 URL `https://us-west-2b.online.tableau.com/#/site/mysitename/home`，您将输入 `mysitename`。如果要将应用连接到 Tableau Server 并希望使用默认站点，请将此字段留空。
3. 对于“Base URL”（基本 URL），输入站点 URL 中以 `tableau.com` 结尾的部分，例如 `https://us-west-2b.online.tableau.com`。
4. 对于“User Mapping Attribute”（用户映射属性），选择用于通过单点登录对用户进行身份验证的 Microsoft Entra 属性。
5. 对于“Connected App ID”（已连接应用 ID）、“Connected App Secret ID”（已连接应用密文 ID）和“Connected App Secret Value”（已连接应用密文值），粘贴您在创建已连接应用时复制的值。
6. 选择“Add Site Config”（添加站点配置）。

Tableau 应用会在保存配置详细信息之前测试连接。如果应用无法连接到 Tableau，则不会添加站点配置。失败原因可能包括：已连接应用无法进行身份验证、未启用已连接应用、站点信息错误，或者您使用的帐户不是 Tableau 管理员帐户。这也可能意味着应用无法访问 Tableau Server，因为它位于防火墙后面。

## 添加或删除站点配置：

添加站点配置后，您可以添加其他站点或删除现有站点配置。

1. 在适用于 Microsoft Teams 的 Tableau 应用中，选择“Configuration”（配置）选项卡。或者，在 Word 或 PowerPoint 加载项面板上，选择**“Settings”（设置）**按钮。
2. 在“Configuration”（配置）下，选择“Tableau Site Config”（Tableau 站点配置）选项卡。
3. 若要添加站点，请选择“Add Site Details”（添加站点详细信息）。或者，若要移除站点，请选择该站点的删除图标。若要显示这些选项，您必须是当前连接的 Tableau 站点的站点管理员。

## 在 Tableau Cloud 中开启 Tableau Pulse 摘要

您的用户可以在 Microsoft Teams 中接收有关他们关注的 Tableau Pulse 指标的摘要和通知消息。Tableau Cloud 站点设置控制启用摘要和通知的渠道。如果您安装了 Microsoft 365 应用程序但未开启 Teams 的摘要设置，您的用户将无法在 Teams 中接收摘要。有关摘要的 Tableau 站点设置的详细信息，请参见[配置摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#digest-time)。

<!-- document id=be49582e7c6a2b8fe8167665109680f002780294e2ccbe8790a35bde60cfec09 url=/tableau/next/zh-cn/online/config_oauth_snowflake_client_creds.md -->

[跳转到主要内容](#main-content)

# 为 Snowflake 配置外部 OAuth：客户端凭据流程

OAuth 客户端凭据身份验证支持与 Snowflake 的计算机对计算机连接

无需用户交互。此方法非常适合于：

- 用于自动数据刷新的服务帐户
- 计划的数据提取作业
- CI/CD 管道
- 需要嵌入式凭据的已发布数据源

与标准 OAuth（使用授权代码流程）不同，客户端凭据流程不会

提示用户登录。 相反，Tableau 使用客户端 ID 和密文直接向身份提供程序

进行身份验证。

**注意：**客户端凭据流程需要 Snowflake 的外部 OAuth 功能以及受支持的身份提供程序。这与 Snowflake 的本机 OAuth 不同。

## 开始之前

若要将 OAuth 客户端凭据与 Snowflake 结合使用，您需要：

| 要求 | 描述 |
| --- | --- |
| 身份提供程序 | 针对客户端凭据授予配置的 Okta、Azure AD 或 Ping Federate |
| Snowflake 帐户 | 具有 ACCOUNTADMIN 访问权限的 Enterprise Edition 或更高版本 |
| OAuth 应用程序 | API 服务 (Okta)、应用程序注册 (Azure AD) 或同等服务 |
| 自定义范围 | Snowflake 角色分配的范围（例如“session:role:SYSADMIN”） |

## 配置您的身份提供程序

以下步骤使用 Okta 作为示例。对于其他提供程序，请查阅其文档以了解客户端凭据配置。

### 步骤 1：创建 API 服务应用程序

1. 登录到 Okta 管理员控制台。
2. 转到 \*\***“Applications”**（应用程序）>**“Applications”**（应用程序）。
3. 选择 \*\***“Create App Integration”**（创建应用程序集成）。
4. 选择 \*\***“API Services”**（API 服务）\*\*， 并选择 \*\***“Next”**（下一步）。
5. 输入应用程序名称（例如，`snowflake-tableau-service`）。
6. 选择**“Save”**（保存）。
7. 复制**“Client ID”（客户端 ID）**和**“Client Secret”**（客户端密文）。稍后您将需要这些值。

### 步骤 2：禁用 DPoP（如果已启用）

必须为客户端凭据流程禁用所有权证明演示 (DPoP)。

1. 在您的应用程序设置中，转到**“General”**（常规）>**“Client Credentials”**（客户端凭据）。
2. 清除**“Require Demonstrating Proof of Possession (DPoP) header in token requests”**（在令牌请求中需要所有权证明演示 (DPoP) 标头）复选框。
3. 选择**“Save”**（保存）。

### 步骤 3：添加自定义范围

Snowflake 需要自定义范围以将角色分配给经过身份验证的会话。

1. 转到**“Security”**（安全性）>**“API”**\>**“Authorization Servers”**（授权服务器）。
2. 选择**默认**授权服务器（或您的自定义服务器）。
3. 选择**“Scopes”**（范围）选项卡，然后选择**“Add Scope”**（添加范围）。
4. 添加以下范围：
    
    | 范围名称 | 描述 |
    | --- | --- |
    | snowflake | Snowflake 的一般访问范围 |
    | session:role:SYSADMIN | 分配 SYSADMIN 角色（根据您的角色进行调整） |
    
    **注意：**为服务帐户需要的任何其他角色创建其他范围。

### 步骤 4：配置访问策略

1. 选择**“Access Policies”**（访问策略）选项卡。
2. 选择现有策略或创建新策略。
3. 添加具有以下设置的规则：
    
    - **“Grant type”（授予类型）：**客户端凭据
    - **“Scopes”（范围）：**任何范围（或选择特定范围）
4. 选择**“Create Rule”**（创建规则）或**“Save”**（保存）。

## 配置 Snowflake

在 Snowflake 中以 ACCOUNTADMIN 身份运行以下 SQL 语句。将占位符值替换为您的配置。

### 步骤 1：创建外部 OAuth 集成

USE ROLE ACCOUNTADMIN;

CREATE OR REPLACE SECURITY INTEGRATION okta\_oauth\_integration
  TYPE = EXTERNAL\_OAUTH
  ENABLED = TRUE
  EXTERNAL\_OAUTH\_TYPE = OKTA
  EXTERNAL\_OAUTH\_ISSUER = 'https://<your-okta-domain>.okta.com/oauth2/default'
  EXTERNAL\_OAUTH\_JWS\_KEYS\_URL = 'https://<your-okta-domain>.okta.com/oauth2/
default/v1/keys'
  EXTERNAL\_OAUTH\_TOKEN\_USER\_MAPPING\_CLAIM = 'sub'
  EXTERNAL\_OAUTH\_SNOWFLAKE\_USER\_MAPPING\_ATTRIBUTE = 'login\_name'
  EXTERNAL\_OAUTH\_AUDIENCE\_LIST = ('api://default', 'snowflake')
EXTERNAL\_OAUTH\_ANY\_ROLE\_MODE = 'ENABLE';

| 参数 | 描述 |
| --- | --- |
| `EXTERNAL_OAUTH_TYPE` | 您的身份提供程序：`OKTA`、`AZURE` 或 `PING_FEDERATE` |
| `EXTERNAL_OAUTH_ISSUER` | 授权服务器中的颁发者 URL |
| `EXTERNAL_OAUTH_JWS_KEYS_URL` | 用于令牌验证的 JWKS 端点 |
| `EXTERNAL_OAUTH_TOKEN_USER_MAPPING_CLA IM` | 标识用户的 JWT 声明。对于 Okta，使用 `sub`。 |
| `EXTERNAL_OAUTH_ANY_ROLE_MODE` | 设置为 `ENABLE` 以允许通过范围进行角色分配 |

### 步骤 2：创建服务用户

创建一个 Snowflake 用户，其 `LOGIN_NAME` 与 OAuth 客户端 ID 匹配。

CREATE USER IF NOT EXISTS service\_account\_user  
  LOGIN\_NAME = '<your-okta-client-id>'  
  DISPLAY\_NAME = 'OAuth Service Account'  
  MUST\_CHANGE\_PASSWORD = FALSE  
  DISABLED = FALSE;
  
\-- Grant role to the service user  
GRANT ROLE SYSADMIN TO USER service\_account\_user;
  
\-- Set the default role  
ALTER USER service\_account\_user SET DEFAULT\_ROLE = 'SYSADMIN';
  
\-- Grant warehouse access  
GRANT USAGE ON WAREHOUSE <your-warehouse> TO USER service\_account\_user;
  
\-- Grant database and schema access  
GRANT USAGE ON DATABASE <your-database> TO USER service\_account\_user;  
GRANT USAGE ON SCHEMA <your-database>.<your-schema> TO USER  
service\_account\_user;  
GRANT SELECT ON ALL TABLES IN SCHEMA <your-database>.<your-schema> TO USER  
service\_account\_user;

**重要信息：**`LOGIN_NAME` 必须完全匹配 OAuth 令牌中的 `sub` 声明。对于 Okta API 服务应用程序，这是客户端 ID。

## 通过 Tableau Desktop 进行连接

1. 在 Tableau Desktop 中，选择**“连接”**\>**“Snowflake”**。
2. 输入您的连接详细信息：
    
    | 字段 | 值 |
    | --- | --- |
    | 服务器 | 您的 Snowflake 帐户 URL（例如 `account.snowflakecomputing.com`） |
    | 角色 | 要使用的角色（例如，`SYSADMIN`） |
    | 仓库 | 您的 Snowflake 仓库 |
    | 身份验证 | OAuth 客户端凭据 |
3. 输入 OAuth 配置：
    
    | 字段 | 值 |
    | --- | --- |
    | OAuth 令牌请求 URL | `https://<your-okta-domain>.okta.com/oauth2/default/ v1/token` |
    | 用户名 | 您的 OAuth 客户端 ID |
    | 密码 | 您的 OAuth 客户端密文 |
    | OAuth 范围 | `snowflake session:role:SYSADMIN` |
    
    **注意：**OAuth 范围必须包括您为角色分配配置的任何自定义范围。
4. 选择**“登录”**。

## 发布到 Tableau Cloud 或 Tableau Server

发布使用 OAuth 客户端凭据的工作簿或数据源时：

1. 在**“发布”**对话框中，选择**“数据源”**旁边的**“编辑”**。
2. 对于**“身份验证”**，选择**“嵌入式密码”**。
3. 客户端凭据嵌入在已发布的内容中。

**重要信息：**与标准 OAuth 不同，客户端凭据被视为嵌入式密码。访问已发布内容的用户使用服务帐户凭据，而不是他们自己的身份。

### 凭据轮换

当您的 OAuth 客户端密文轮换时，请在 Tableau Cloud 上更新嵌入式凭据：

1. 登录 Tableau Cloud。
2. 导航到已发布数据源。
3. 选择**“连接”**。
4. 使用新的客户端密文更新连接。

对于自动轮换，请使用 Tableau REST API 以编程方式更新连接凭据。

## 常见问题

### 何时应使用 OAuth 客户端凭据，而不是标准 OAuth？

当您需要无人值守的计算机对计算机身份验证时，请使用客户端凭据。标准

OAuth 需要用户交互来进行初始登录和定期重新身份验证。客户端凭据

使用服务帐户身份，并且不需要用户交互。

### 我可以将客户端凭据与 Snowflake 的本机 OAuth 一起使用吗？

不可以。Snowflake 的本机 OAuth 仅支持授权代码流程。客户端凭据需要具有受支持的身份提供程序（Okta、Azure AD 或 Ping Federate）的外部 OAuth。

### 如何处理已发布内容的密文轮换？

当您的 OAuth 客户端密文轮换时，您必须更新 Tableau Cloud 中的嵌入式凭据。您可以通过 Tableau Cloud UI 手动执行此操作，也可以使用 Tableau REST API 以编程方式执行此操作。考虑在密文轮换工作流中自动执行此过程。

### 为什么即使启用了 EXTERNAL\_OAUTH\_ANY\_ROLE\_MODE，我的连接也会失败并出现角色错误？

Snowflake 需要 OAuth 令牌中的角色信息。将自定义范围（例如 `session:role:SYSADMIN`）添加到您的授权服务器，并在从 Tableau 连接时将其包括在“OAuth 范围”字段中。

## 疑难解答

| 错误消息 | 原因 | 解决方案 |
| --- | --- | --- |
| “用户不存在或未授权” | Snowflake 用户 `LOGIN_NAME` 与 OAuth 客户端 ID 不匹配 | 设置用户的 `LOGIN_NAME` 以匹配 `sub` 声明（Okta 的客户端 ID） |
| “访问令牌中未列出请求的角色” | 令牌中缺少角色范围 | 将 `session:role:<ROLE>` 范围添加到您的授权服务器，并将其包含在 OAuth 范围中 |
| “无效的 DPoP 证明” | 在 Okta 中启用了 DPoP | 在 Okta 应用中禁用“Require Demonstrating Proof of Possession (DPoP)”（需要所有权证明演示 (DPoP)） |
| “范围无效” | 未配置自定义范围 | 将所需的范围添加到您的授权服务器；不包括 `openid` |
| 令牌验证失败 | JWKS URL 或颁发者不正确 | 验证 `EXTERNAL_OAUTH_JWS_KEYS _URL` 和 `EXTERNAL_OAUTH_ISSUER` 是否与您的授权服务器匹配 |

## 另请参见

- [在 Tableau Server 上为 Snowflake 连接配置 OAuth](https://help.tableau.com/current/server/zh-cn/config_oauth_snowflake.htm) - 了解 Snowflake 的标准 OAuth 身份验证。
- [外部 OAuth 安全集成](https://docs.snowflake.com/en/user-guide/oauth-external-overview) - 用于配置外部 OAuth 提供程序的 Snowflake 文档。
- [Okta 客户端凭据流程](https://developer.okta.com/docs/guides/implement-grant-type/clientcreds/main/) - 用于实现客户端凭据的 Okta 文档。
- [更新数据源连接](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_data_sources.htm#update_data_source_connection) - 有关凭据更新的 Tableau REST API 参考。

<!-- document id=df027080f79a992fb9ec945089bb568c58dba32f6c909330ce9724b49d471a1d url=/tableau/next/zh-cn/online/saml_config_TOL_LWC.md -->

[跳转到主要内容](#main-content)

# 为 Tabbleau Viz Lightning Web 组件配置 SAML

Tableau 提供了一个 Lightning Web 组件 （LWC），用于在 Salesforce Lightning 页面中嵌入 Tableau 可视化项。

本主题介绍如何为 Salesforce Lightning 页面中的嵌入式 Tableau 可视化项 SSO 体验。Tableau 可视化项 LWC 方案的 SSO 需要 SAML 配置。用于 Tableau 身份验证的 AML IdP 必须是 alesforce IdP 或用于 Salesforce 实例的同一 IdP。

在这种情况下，Salesforce 管理员将 Tableau 可视化项 LWC 拖到要嵌入可视化项的 Lightning 页面中。Tableau Cloud 上可供他们使用的任何视图都可以通过输入视图的嵌入 URL 显示在仪表板中。

在 Tableau Cloud 上为 Tableau 可视化项 LWC 配置单点登录 (SSO) 时，用户体验是无缝的：用户登录 Salesforce 后，嵌入式 Tableau 视图将无需向 Tableau Cloud 进行进一步身份验证即可工作。

如果未配置 SSO，则用户将需要使用 Tableau Cloud 重新进行身份验证，以通过 Tableau Cloud 查看嵌入式可视化项。

**注意**：配置了 [Salesforce 身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth_sfdc.htm)的用户将需要向 Tableau Cloud 重新进行身份验证，才能查看 Tableau Cloud 中的嵌入式可视化项。

## 要求

- 用于 Tableau 身份验证的 AML IdP 必须是 alesforce IdP 或用于 Salesforce 实例的同一 IdP。
- 必须在 Tableau Cloud 上配置 SAML。请参见[在站点或 TCM 上启用 SAML 身份验证](https://help.tableau.com/v0.0/online/zh-cn/saml_config_site.htm)。
- 必须为 Salesforce 配置 SAML。
- 安装 Tableau Viz Lightning Web 组件。请参见[将 Tableau 视图嵌入 Salesforce](https://help.tableau.com/current/pro/desktop/zh-cn/embed_ex_lwc.htm)。

## 配置身份验证工作流

您可能需要进行其他配置，以优化使用嵌入式 Tableau 视图访问 Lightning 的用户的登录体验。

如果无缝身份验证用户体验很重要，则需要进行一些其他配置。在此上下文中，“无缝”意味着访问已启用 Tableau 可视化项 LWC SSO 的 Salesforce Lightning 页面的用户无需执行任何操作来查看嵌入的 Tableau 视图。在无缝方案中，如果用户登录到 Salesforce，则嵌入的 Tableau 视图将显示，无需执行其他用户操作。此方案通过_框架内身份验证_启用。

要获得无缝的用户体验，您需要在 Tableau Cloud 和您的 IdP 处启用框架内身份验证。以下部分介绍如何配置框架内身份验证。

另一方面，有些情况下，用户正在与 Lightning 页面交互，需要他们单击“登录”按钮以查看嵌入的 Tableau 视图。在此方案中，用户必须执行其他操作才能查看嵌入的 Tableau 视图，因此称为弹出式身份验证。

![Tableau Online 登录弹出窗口。](/tableau/next/zh-cn/online/zh-cn/Img/lwc-pop-up.png)

如果不启用框架内身份验证，则弹出式身份验证是默认用户体验。

## 在 Tableau Cloud 上启用框架内身份验证

在 Tableau Cloud 上启用框架内身份验证之前，您必须已配置和启用 SAML。

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在**“身份验证”**选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
3. 向下导航至**“4.选择嵌入视图的默认值（可选）”**，然后选择**“使用内嵌框架 (iFrame) 进行身份验证”**单选按钮。

![选择嵌入视图设置的默认设置，并选择使用嵌入式框架进行身份验证的选项。](/tableau/next/zh-cn/online/zh-cn/Img/lwc-embedd-tol.png)

**警告：**嵌入式框架可能容易受到单击劫持攻击。_单击劫持_是一种针对网页的攻击，在这种攻击中，攻击者会试图在一个不相关页面上的透明层中显示攻击页面，从而诱骗用户单击或输入内容。在 Tableau Cloud 的上下文中，攻击者可能会试图使用单击劫持攻击来捕获用户凭据，或让授权用户更改设置。有关单击劫持攻击的详细信息，请参见开放式 Web 应用程序安全项目网站上的[单击劫持](https://www.owasp.org/index.php/Clickjacking)。

## 使用 SAML IDP 启用框架内身份验证

如上所述，使用 Salesforce Mobile 实现无缝身份验证用户体验需要 IdP 支持框架内身份验证。此功能在 IdP 处也称为“iframe 嵌入”或“框架保护”

### Salesforce 安全列表域

在某些情况下，IdP 只允许按域启用框架内身份验证。在这种情况下，在启用框架内身份验证时设置以下 Salesforce 通配符域：

`*.force`

`*.visualforce`

### Salesforce IdP

默认情况下，Salesforce IdP 支持框架内身份验证。您无需在 Salesforce 配置中启用或配置框架内身份验证。但是，您必须针对框架内身份验证配置 Tableau Cloud，如上所述。

### Okta IdP

请参见 Okta 帮助中心主题[常规自定义选项](https://help.okta.com/en/prod/Content/Topics/Settings/settings-customization-general.htm)中的“_在 iframe 中嵌入 Okta_”。

### Ping IdP

请参阅 Ping 支持主题[如何禁用 PingFederate 中的“X-Frame-Options=SAMEORIGIN”标头](https://support.pingidentity.com/s/article/How-to-Disable-the-X-Frame-Options-SAMEORIGIN-Header-in-PingFederate)。

### OneLogin IdP

请参见 OneLogin 知识库文章[帐户所有者的帐户设置](https://onelogin.service-now.com/kb_view_customer.do?sysparm_article=KB0010304#:~:text=Framing%20protection%20allows%20granular%20customization,a%20user%20agent%20can%20access.)中的“_框架保护_”。

### ADFS 和 EntraID IdP

Microsoft 已阻止所有框架内身份验证，无法将其启用。相反，Microsoft 在第二个窗口中仅支持弹出式身份验证。因此，某些浏览器可能会阻止弹出窗口行为，这将要求用户接受 `force.com` 和 `visualforce.com` 站点的弹出窗口。

## Salesforce 移动应用软件

如果您的用户主要在 Salesforce 移动应用软件中与 Lightning 进行交互，则您应该了解以下情况：

- Salesforce 移动应用软件要求您配置 SSO/SAML 以查看嵌入式 Tableau。
- Salesforce 移动应用软件需要框架内身份验证。弹出式身份验证不起作用。相反，Salesforce 移动应用软件上的用户将看到 Tableau 登录按钮，但无法登录到 Tableau。
- 移动应用软件在 ADFS 和 Azure AD IdP 上不起作用。
- 拥有 Android 设备的用户首次需要登录才能查看嵌入的 Tableau 可视化项，然后 SSO 将按预期工作。

<!-- document id=7c8038c67509bf640290258ba2a1da32236d523a1ed27b0e285f426af41e5c5f url=/tableau/next/zh-cn/online/ip_filtering.md -->

[跳转到主要内容](#main-content)

# 为 Tableau Cloud 配置 IP 筛选器

IP 筛选通过限制对批准的 IP 地址和范围的访问来保护您的 Tableau Cloud 站点。只有从这些允许的位置连接的用户和服务才能访问您的站点。

## 使用 IP 筛选器时的预期效果

下面是当用户和服务尝试访问配置了 IP 筛选的站点时发生的情况。

### IP 筛选的影响

IP 筛选通过根据您为站点定义的已批准 IP 地址和范围列表检查传入流量来提供安全性。仅使用此列表中的可路由公共 IP 地址。私有 IP 地址和范围（例如 10.0.0.0/8、172.16.0.0/12 或 192.168.0.0/16）将不起作用，并可能导致锁定。此限制会影响到您站点的所有传入流量，包括：

- 通过 Web 浏览器访问
- Tableau Desktop 连接
- REST API 调用
- 嵌入式视图

### 后端行为和例外

IP 筛选不会影响在后台运行的进程，例如 Tableau Bridge。例如，未经批准的 Bridge 计算机将继续工作，但其状态不会出现在 Bridge 设置页面上。

### 登录行为

登录 Tableau Cloud 的工作方式与 IP 筛选是分开进行的。

- 即使用户的 IP 地址被特定封禁，用户也可以访问 `www.online.tableau.com`。
- 站点选取器将列出用户所属的所有站点，即使 IP 筛选限制对其中某些站点的访问也是如此。
- 仅当用户或服务尝试从未经批准的 IP 地址连接到筛选的站点时，才会拒绝访问。

## 添加 IP 筛选器

若要将 IP 筛选器添加到您的站点，请使用以下步骤：

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“安全性”选项卡上，滚动到“IP 筛选”。
3. 选中“启用 IP 筛选”复选框。一条内联消息显示设备 IP 地址。
    
    ![显示 IP 筛选选项的 Tableau Cloud 安全设置页面。](/tableau/next/zh-cn/online/zh-cn/Img/ip_filtering_add.png)
4. 在“新 IP 地址和 IP 范围”部分，使用以下选项之一来定义要允许的 IP 地址和范围：
    
    - **单个地址：**输入要允许的 IP 地址。若要添加更多地址，请选择“添加”。
    - **批量编辑器：**展开下拉菜单，然后选择“IP 地址批量编辑器”。在对话框中，在单独的一行中输入每个 IP 地址或范围。
        
        ![IP 地址批量编辑器对话框，显示允许的 IP 地址和范围。](/tableau/next/zh-cn/online/zh-cn/Img/ip_filtering_bulk_editor.png)
        
        > [!WARNING]
        > 
        > **重要信息：**在保存之前，请验证是否已包含当前的公共 IP 地址。不要添加私有地址和范围，例如 10.0.0.0/8、172.16.0.0/12 或 192.168.0.0/16。使用这些地址或排除您的当前位置可能会将您锁定在站点之外。
5. 选择“保存”。更改将在 15 分钟内生效。

## 更新或移除 IP 筛选器

若要更改站点上的 IP 筛选器，请使用以下步骤：

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“安全性”选项卡上，滚动到“IP 筛选”。
3. 若要更新 IP 地址，请使用以下选项之一：
    
    - **单个地址：**选择可直接编辑的行。
    - **批量编辑器：**展开下拉菜单，然后选择“IP 地址批量编辑器”。在对话框中，在单独的一行中输入每个 IP 地址或范围。
    - **删除地址：**选择的行旁边的删除图标。
4. 选择“保存”。更改将在 15 分钟内生效。

## 关闭 IP 筛选

关闭 IP 筛选将永久删除您定义的 IP 地址和范围的列表。然后，任何许可用户都可以登录到站点，而不管其 IP 地址如何。如果打算稍后使用这些设置，请在关闭 IP 筛选之前复制允许列表。

若要关闭 IP 筛选，请使用以下步骤：

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“安全性”选项卡上，滚动到“IP 筛选”。
3. （可选）复制您的 IP 地址和范围列表。
4. 清除“启用 IP 筛选”复选框。
    
    ![IP 筛选部分，显示未选中的启用复选框。](/tableau/next/zh-cn/online/zh-cn/Img/ip_filtering_setting.png)
5. 选择“保存”。

## 疑难解答

### 重新获得站点访问权限

如果在配置 IP 筛选器后失去了对站点的访问权限，可以使用这些选项重新获得访问权限。

- **询问其他站点管理员：**请与不受 IP 筛选器影响的其他站点管理员联系，让他们更新或移除筛选器列表。
- **尝试其他 IP 地址：**从您知道允许的其他设备或网络（例如您的 VPN）访问站点。如果可以登录，请更新或移除 IP 筛选器。

如果您是唯一的站点管理员，并且失去了所有访问权限，请与 Tableau 支持部门联系以获取帮助。Tableau 必须手动重置或更新 IP 筛选器，然后您才能再次登录。

<!-- document id=076bb6aa553d24dbf491c941ef47de67d5051714da7c92225f999540b0648213 url=/tableau/next/zh-cn/online/pulse_data_source_requirements.md -->

[跳转到主要内容](#main-content)

# 为 Tableau Pulse 设置数据

您可以在 Tableau Pulse 中通过连接到 Tableau Cloud 上的已发布数据源来创建指标定义。此数据源应包含完整、结构良好且标记清晰的时间序列数据。按照本文中的准则来构建数据源。有关基于某个数据源创建指标定义的信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。

## 一般数据源要求

确保您正在使用的数据源满足以下条件。

- 它是单个已发布的数据源。您无法连接到嵌入工作簿中的数据源，也无法连接到多个数据源或使用数据混合，除非您在发布数据源之前合并数据。数据源可以是数据提取或实时连接，并且可以使用虚拟连接或直接连接到数据。
- 您拥有数据源的“连接”，“查看”和“创建指标定义”权限能力。
- 数据源包含：
    - 要聚合为总和、平均值、中值、最大值或最小值的度量，或者要聚合为计数或计数（不重复）的维度。
    - 指标时间序列的时间维度。Tableau Pulse 随着时间的推移监控数据，因此单个时间点值不会生成有效的指标。时间序列支持的粒度为日、周、月、季度和年。需要较低粒度（小时或分钟）的数据不太适合 Tableau Pulse。
    - 至少一个可用于筛选数据和见解的维度。

Tableau Pulse 显示您作为指标和见解文本上的筛选器添加的维度名称和值。数据源中的这些名称和值应该易于其他人理解。为了给查看者创造最佳体验，请遵循这些建议，以便名称和值符合 Tableau Pulse 的对话语言。

- 使用标题样式大写，而不是全部大写。
- 使用空格而不是连字符或下划线来分隔单词。
- 不要使用特殊字符。
- 不要使用显示为 `true` 或 `false` 的布尔值字段。
- 不要使用由 ID 或其他难以辨认的字符串组成的字段。

自定义日历、目标和阈值需要将其他数据添加到数据源。有关为这些功能设置数据源的信息，请参见[自定义日历的要求](#ds-requirement-calendar)和[数据源目标和阈值的要求](#ds-requirement-goals)。

## 自定义日历的要求

如果您的组织不使用标准公历，请在 Tableau Pulse 中设置自定义日历。例如，您可以定义与[美国全国零售商联合会 4-5-4 日历](https://nrf.com/resources/4-5-4-calendar)一致的日历。

必须在数据源中定义自定义日历，并且所有日历字段必须属于同一个表。自定义日历不需要与您的指标数据属于同一个表。如果自定义日历在单独的表中，请在该表和指标数据表之间创建关系。

不要添加会从日历表中移除日期的行级别安全性或数据源筛选器。如果向数据源中的事务表添加筛选器，请确保筛选器范围仅设置为该表，而不是该表和相关表。有关设置数据源筛选器的作用域的信息，请参见[创建数据源筛选器](https://help.tableau.com/current/pro/desktop/zh-cn/filtering_datasource.htm#create-filter)。

自定义日历的每一行表示一个日期，并包含这些字段。

- 参考日期

- 要映射到自定义日历的标准公历日期
- 数据类型：日期
- 示例：01/01/2025

- 一年中的某天

- 数据类型：数字（连续维度）
- 示例：333

- 一年中的某周

- 数据类型：数字（连续维度）
- 示例：48

- 一年中的某月

- 数据类型：数字（连续维度）
- 示例：11

- 月份名称

- 数据类型：字符串
- 示例：十二月

- 季度

- 数据类型：数字（连续维度）
- 示例：4

- 年

- 数据类型：数字（连续维度）
- 示例：2024

Tableau 中日期的格式因用户设置的区域设置而异，并且并非所有区域设置中都使用某些字段。例如，设置为日语或中文的区域设置将显示“一年中的某月”而不是“月份名称”。

将自定义日历添加到数据源后，您可以将日历配置为指标定义的一部分。有关详细信息，请参见[设置自定义日历](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#custom-calendar)。

### 自定义日历验证

确保自定义日历是完整一致的，并且没有跳过任何日期或数字。请遵循以下准则以确保您的自定义日历有效。

- 每个参考日期的所有字段都存在。
- 字段的数据类型正确。
- 表中的第一个条目是第一个参考日期。
- 参考日期按时间顺序排列。
- 参考日期包括一年中的每一天，即使当天没有业务数据。
- 年中的天、年中的周、年中的月份和年中的季度从 1 开始，按 1 递增，没有跳过的数字。
- 一周有 7 天。如果一年以部分周结束，则下一年必须以部分周开始，这样 2 周加起来就是 7 天。举例来说，如果一年的第 53 周只有 2 天，则下一年的第 1 周必须包含 5 天才能形成 7 天的一周，第 2 周将包含第 6-12 天。
- 日历中所有年份的每个月数的月份名称都相同。
- 一年有 4 个季度。
- 每个季度都以一个完整的月开始和结束。月份不能跨季度拆分。
- 数据包含前 2 个日历年。与上一年进行比较的指标使用这些日期来确定正确的比较。
- 数据在自定义年份结束前完成。如果将来的数据进入新的自定义年份，请包括该年的完整日期集，但不要包括当前自定义年份结束后超过 4 年的日期。

Tableau Pulse 会验证自定义日历中的字段。如果自定义日历出现问题，您会看到一个错误，可帮助您排查日历问题。

| 问题 | 错误消息示例 |
| --- | --- |
| 跳过的参考日期 | 对于 2026 年 2 月 1 日之前的日期，有一个跳过的参考日期。自定义日历必须包括一年中的每个日期。 |
| 参考日期重复 | 2026 年 2 月 1 日有重复条目。每个参考日期必须只出现一次。 |
| 年中某日被跳过 | 2026 年 2 月 1 日所在的年中该日被跳过。一年中的日期必须逐日递增，且不能有跳过的数字。 |
| 年中某周被跳过 | 2026 年 2 月 1 日所在的年中该周被跳过。一年中的周必须逐周递增，且不能有跳过的数字。 |
| 年中某周不完整 | 2026 年 2 月 1 日之前的年中该周不完整。一周必须有 7 天。 |
| 一年中的天数不足，无法形成一年中的周 | 2026 年 2 月 1 日所在的年中该周无效。一周必须有 7 天。 |
| 跳过了年中某月 | 2026 年 2 月 1 日所在的年中该月被跳过。一年中的月必须逐月递增，且不能有跳过的数字。 |
| 月份名称不一致 | 2026 年 2 月 1 日所在月份名称不一致。对于一年中的每个对应月份，月份名称必须相同。 |
| 缺少月份名称 | 2026 年 2 月 1 日所在月份没有月份名称。每个参考日期的所有字段都是必需的。 |
| 重复月份名称 | 2026 年 2 月 1 日所在月份的月份名称已用于另一个月份编号。月份名称必须对应于单个月份编号。 |
| 季度被跳过 | 2026 年 2 月 1 日所在的年中该季被跳过。季度必须逐季递增，且不能有跳过的数字。 |
| 季度不足 | 截至 2026 年 1 月 31 日的年度少于 4 个季度。一年必须有 4 个季度。 |
| 额外季度 | 从 2026 年 1 月 31 日开始的一年有超过 4 个季度。一年必须有 4 个季度。 |
| 一年中没有足够的月份，无法形成季度 | 从 2026 年 2 月 1 日开始的季度无效。季度不能大于年中的月份。 |
| 年份被跳过 | 2026 年 2 月 1 日所在年份被跳过。年份必须逐年递增，且不能有跳过的数字。 |
| 字段不以 1 开头 | 2026 年 2 月 1 日开始的年份中，该年的第 1 天、第 1 周、第 1 个月或第 1 季度的值不为 1。这些字段在年初必须以 1 开头。 |
| 值小于 1 | 2026 年 2 月 1 日所在的年中该日、年中该周、年中该月或年中该季为 0 或负值。此字段必须以 1 开头。 |
| 日历在当前日期之前结束 | 自定义日历于 2025 年 11 月 30 日结束，未涵盖当前期间。包含截至当前自定义日历年度末的参考日期。 |

### 示例自定义日历

若要了解如何构建自定义日历，请[下载示例自定义日历](http://help.tableau.com/samples/zh-cn/pulse/pulse_custom_calendar.csv)。下表显示了示例自定义日历中的十行。

| 参考日期 | 一年中的某天 | 一年中的某周 | 一年中的某月 | 月份名称 | 季度 | 年 |
| --- | --- | --- | --- | --- | --- | --- |
| 01/01/2025 | 333 | 48 | 11 | December | 4 | 2024 |
| 01/02/2025 | 334 | 48 | 11 | December | 4 | 2024 |
| 01/03/2025 | 335 | 48 | 11 | December | 4 | 2024 |
| 01/04/2025 | 336 | 48 | 11 | December | 4 | 2024 |
| 01/05/2025 | 337 | 49 | 12 | 一月 | 4 | 2024 |
| 01/06/2025 | 338 | 49 | 12 | 一月 | 4 | 2024 |
| 01/07/2025 | 339 | 49 | 12 | 一月 | 4 | 2024 |
| 01/08/2025 | 340 | 49 | 12 | 一月 | 4 | 2024 |
| 01/09/2025 | 341 | 49 | 12 | 一月 | 4 | 2024 |
| 01/10/2025 | 342 | 49 | 12 | 一月 | 4 | 2024 |

## 数据源目标和阈值的要求

有两种方法可以设置目标和阈值：手动设置或在数据源中设置。手动目标或阈值只是为单个指标输入的一个静态数字，因此没有数据源要求。数据源目标或阈值是在定义级别设置的。目标或阈值使用来自数据源的字段，根据该定义在指标上显示动态值。有关详细信息，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)和[使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm)。

如果您想将数据源目标或阈值作为指标定义的一部分，则需要考虑其他数据源因素。

- 将指定目标或阈值的字段作为定义连接到的数据源的一部分。指标定义仅连接到单个数据源，因此您无法连接到此数据的单独数据源。
- 如果目标或阈值数据与核心定义数据位于不同的表中，请在这两个表之间创建关系。如果您联接表而不是关联它们，数据源最终可能会出现重复的目标值或阈值。有关将数据起来的信息，请参见[使用关系进行多表数据分析](https://help.tableau.com/v0.0/online/zh-cn/datasource_multitable_normalized.htm)。
- 如果您希望在用户对指标应用维度筛选器时将显示更细粒度的目标或阈值，请在数据中包含该粒度级别。否则，即使数据被筛选为值的子集，Tableau Pulse 也会显示维度的总目标值或阈值。

这两个表显示了具有不同粒度目标的示例数据源。如果每一行没有目标或阈值数据（例如，在只有每月目标的情况下），则仅包含该值一次。不要重复每一行中的值。

维度中每个值的每日目标
| 日期 | 客户经理 | 销售额 | 销售目标（每日） |
| --- | --- | --- | --- |
| 06/01/2025 | Fred Suzuki | 658 | 600 |
| 06/01/2025 | Jane Johnson | 505 | 700 |
| 06/01/2025 | Laura Rodriguez | 623 | 650 |
| 06/02/2025 | Fred Suzuki | 678 | 600 |
| 06/02/2025 | Jane Johnson | 527 | 700 |
| 06/02/2025 | Laura Rodriguez | 656 | 650 |
| 06/03/2025 | Fred Suzuki | 607 | 600 |
| 06/03/2025 | Jane Johnson | 753 | 700 |
| 06/03/2025 | Laura Rodriguez | 558 | 650 |

 维度中每个值的每月目标
| 日期 | 客户经理 | 销售额 | 销售目标（每月） |
| --- | --- | --- | --- |
| 06/01/2025 | Fred Suzuki | 658 | 15000 |
| 06/01/2025 | Jane Johnson | 505 | 17000 |
| 06/01/2025 | Laura Rodriguez | 623 | 16000 |
| 06/02/2025 | Fred Suzuki | 678 |  |
| 06/02/2025 | Jane Johnson | 527 |  |
| 06/02/2025 | Laura Rodriguez | 656 |  |
| 06/03/2025 | Fred Suzuki | 607 |  |
| 06/03/2025 | Jane Johnson | 753 |  |
| 06/03/2025 | Laura Rodriguez | 558 |  |

<!-- document id=0a6c2cdbc4d65c65f0379da6b7cdad105fd9bf9f6712ec6323921491c06819d6 url=/tableau/next/zh-cn/online/pulse_set_up.md -->

[跳转到主要内容](#main-content)

# 为 Tableau Pulse 设置站点

Tableau Pulse 直接在用户的工作流程中为用户提供有关对其重要指标的个性化见解。具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色的用户可以添加指标定义，所有用户都可以关注指标来发现见解并了解数据的更改。有关定义、指标以及如何创建它们的信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。有关查看者如何与指标交互的信息，请参见[使用 Tableau Pulse 探索指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm)。

![Pulse 主页](/tableau/next/zh-cn/online/zh-cn/Img/pulse_home.png)

关注指标的用户会通过电子邮件或 Slack 收到定期摘要，其中包含有关其数据的见解。Tableau Pulse 允许不经常访问 Tableau 的用户无需离开他们通常工作的地方即可了解他们的数据。如果这些用户想要了解更多信息，他们可以访问 Tableau Cloud 上的指标，进行引导式自助数据分析，并了解不同因素如何影响他们的数据。

## 为您的站点部署 Tableau Pulse

默认情况下，用于部署 Tableau Pulse 的站点设置处于关闭状态。部署 Tableau Pulse 时，您可以选择为单个用户组或站点上的所有用户启用它。您可能希望对 Tableau Pulse 进行受控部署，并为单个组启用它，以便一部分用户可以在将其提供给整个组织之前对其进行探索和评估。若要了解如何为 Tableau Pulse 创建用户组，请参见[创建组并向其中添加用户](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm)。

若要部署 Tableau Pulse，请访问您站点的设置页面。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”。
2. 在“Tableau Pulse”>“部署”下，选择“打开 Tableau Pulse” 。
3. 选择是为所有用户还是为指定组打开 Tableau Pulse。
4. 如果您选择将 Tableau Pulse 限制到某个组，请选择该组。
5. 选择“保存”。

没有访问权限的用户如果访问 Tableau Pulse URL，将会收到一条消息，通知他们。此外，如果您将 Tableau Pulse 限制到某个组，则当您搜索以添加关注者时，该组是唯一可用的组，即使这些相同的用户属于不同的组。

### Tableau Pulse 的 API 可用性

外部 API 级别不支持将 Tableau Pulse 限制到指定组。如果完全关闭站点设置，API 将不允许用户访问 Tableau Pulse。如果 Tableau Pulse 的站点设置处于打开状态，则所有用户都将能够在通过 API 调用它的情况下（例如在嵌入式场景中）访问它，无论设置是否将其限制到指定组。有关使用 Tableau Pulse API 的详细信息，请参见[嵌入 Tableau Pulse](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_pulse.html) 和 [Tableau Pulse REST API 方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_pulse.htm)。

### 停止为无访问权限的用户保留的摘要

最初部署 Tableau Pulse 后，无论站点设置是打开还是关闭，查询数据源和发送指标摘要的服务都会继续运行。站点设置控制 Tableau Pulse 是否显示在导航菜单中以及用户是否能够访问 Tableau Pulse 主页和各个指标页面。

由于 Tableau Pulse 的服务继续运行，任何以前有权访问并关注指标的用户都将收到这些指标的摘要，即使您限制对他们不属于的组的访问权限，或将这些用户从具有访问 Tableau Pulse 访问权限的组中移除，也是如此。如果这些用户尝试打开摘要中发送的指标链接，他们将收到通知，指出他们无权访问 Tableau Pulse，并且无法取消关注这些指标。

为了防止无法访问 Tableau Pulse 的用户接收摘要，请从他们关注的指标中移除这些用户。请在关闭 Tableau Pulse 或将其限制到较小的用户组之前执行此操作，以便这些用户不会收到包含他们无法访问的指标链接的摘要。

## 设置您的站点

作为 Tableau 管理员，您可以帮助您的用户充分利用 Tableau Pulse。在用户开始之前，请检查指标所需的数据是否可用并打开可选功能。

- 验证您的站点上是否有已发布的数据源可供用户创建指标。有关指标的具体数据要求的信息，请参见[为 Tableau Pulse 设置数据](https://help.tableau.com/v0.0/online/zh-cn/pulse_data_source_requirements.htm)。若要确保用户可以访问数据，请参见[了解 Tableau Pulse 的治理](#permissons)。
- 如果您希望用户在 Slack 中接收 Tableau Pulse 摘要，请将您的 Tableau 站点与 Slack 连接。有关详细信息，请参见[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm)。
- 如果您希望用户看到个性化见解摘要，请打开 Tableau 中的 AI。有关详细信息，请参见[适用于 Tableau Pulse 的 Tableau 中的 AI](#tableau-ai)。

旧版指标功能已于 2024 年 2 月在 Tableau Cloud 上停用。您网站上的任何旧版指标都不会转移到 Tableau Pulse。如果您有旧版指标，请记下数据源、度量和时间维度，然后在 Tableau Pulse 中重新创建它们。有关旧版指标的详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm)。

## 了解 Tableau Pulse 的治理

设置和权限的组合控制对 Tableau Pulse 及其功能的访问。

- 站点设置控制访问 Tableau Pulse 和查看使用生成式 AI 的功能的能力。请参见[为您的站点部署 Tableau Pulse](#site-setting)和[适用于 Tableau Pulse 的 Tableau 中的 AI](#tableau-ai)。
- 数据源的权限和数据本身的身份验证控制着查看指标和创建指标定义的能力。请参见[用于查看指标的权限](#permissions-viewing)。
- 指标定义的设置控制谁可以编辑或删除指标定义和目标。请参见[用于编辑指标和目标的权限](#permissions-editing)。

### 站点角色如何影响 Tableau Pulse 访问权限

用户必须具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色才能在 Tableau Pulse 中创建创建、编辑或删除指标定义。对于创建和查看指标、关注指标和添加指标关注者以及设置和编辑指标目标，没有站点角色限制。如果用户的站点角色不允许执行某项操作，那么无论他们被授予什么权限，他们都将无法执行该操作。

### 用于查看指标的权限

Tableau Pulse 中的指标不是 Tableau Cloud 中项目内容层次结构的一部分，也不受基于内容的权限管辖，这意味着您不能拒绝用户查看单个指标的能力。但是，通过调整已发布数据源的权限，您可以控制用户是否可以查看基于该数据源的指标。此外，用户在查看指标时看到的数据遵循应用于数据源的行级安全性。

若要查看指标，用户必须具有：

- 指标所连接到的已发布数据源的“连接”和“查看权限”能力。有关权限的详细信息，请参见[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)。
- 访问指标所连接到的数据源中的数据。

Tableau Pulse 不会提示用户登录数据库或数据源的数据连接。相反，用户必须满足以下条件之一才能访问指标数据：

- 数据源的凭据已嵌入。有关嵌入式凭据的信息，请参见[设置凭据以访问您发布的数据](https://help.tableau.com/v0.0/online/zh-cn/publishing_sharing_authentication.htm)。
- 用户的凭据通过单点登录传递到数据源。
- 为数据源保存用户的凭据。有关详细信息，请参见[为数据连接管理保存的凭据](https://help.tableau.com/v0.0/online/zh-cn/manage_stored_credentials.htm)。
- 数据源不要求用户通过身份验证来访问数据。

如果用户尝试查看他们没有正确权限的指标，他们会看到一条消息，提示该指标不存在或他们没有权限访问该指标。

### 用于创建指标定义的权限

任何具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色的用户都可以创建指标定义。您不能拒绝用户创建定义的能力；但是，您可以限制用户在创建指标定义时可以连接的数据源。

若要依据数据源创建指标定义，用户必须具有该数据源的“创建指标定义”权限能力。他们还必须具有查看连接到该数据源的指标所需的相同访问权限。有关详细信息，请参见[用于查看指标的权限](#permissions-viewing)。

如果您希望用户能够查看基于数据源的指标，但不希望用户能够基于该数据源创建指标，请允许“查看”和“连接”能力，但拒绝“创建指标定义”能力。

### 用于创建指标的权限

没有设置来限制谁可以在 Tableau Pulse 中创建指标，并且对创建指标也没有站点角色限制。每当用户筛选现有指标时，如果该筛选器组合中尚不存在指标，则会创建一个新指标。只要用户可以查看现有指标，他们就可以通过调整筛选器来创建新指标。

### 用于编辑指标和目标的权限

您可以调整指标定义的设置来控制谁可以编辑或删除指标定义，以及谁可以根据该定义设置、编辑或删除指标的目标。请注意，如果用户的站点角色不允许，这些设置将不授予用户编辑定义的能力。Tableau 管理员不需要添加为编辑者，因为他们的站点角色赋予他们编辑所有指标定义和目标的能力。有关详细信息，请参见[限制对定义以及手动目标和阈值的编辑](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#edit-permissions)。

## 配置摘要

您可以控制用户接收 Tableau Pulse 摘要和非周期通知的时间和位置。

### 限制用户接收摘要的渠道

选择是否允许用户接收电子邮件、Slack 或 Microsoft Teams 摘要和通知。这些设置影响站点上的所有用户。用户还可以在各自的 Tableau Pulse 首选项中关闭渠道。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”。
2. 在“Tableau Pulse”>“摘要”下，选择用户可以接收摘要的渠道。
3. 选择“保存”。

为了让用户在 Slack 或 Microsoft Teams 中接收摘要，您必须将 Tableau 连接到这些应用程序。有关详细信息，请参见[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm)和[为 Microsoft 365 设置 Tableau 应用](https://help.tableau.com/v0.0/online/zh-cn/teams_set_up.htm)。

### 设置摘要开始时间和计划

您可以更改 Tableau Pulse 开始生成摘要的时间。您还可以设置生成每周和每月摘要的周中某日和月中某天。如果您的数据在特定时间或日期刷新，则这些设置很有用，这样 Tableau Pulse 摘要就会包含最新数据。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”。
2. 在“Tableau Pulse”>“摘要计划”下，为“摘要开始时间”选择一个时间。开始时间是 Tableau Pulse 开始生成摘要的时间，而不是发送摘要的时间。生成和发送摘要可能需要一个多小时。
3. 对于“每周”和“每月”频率，选择 Tableau Pulse 生成这些摘要时的周中某日和月中某天。
4. 选择“保存”。

## 适用于 Tableau Pulse 的 Tableau 中的 AI

Tableau 中的 AI 是 Tableau 的生成式人工智能技术。Tableau Pulse 使用 Tableau 中的 AI 来提供以下功能：

- 针对您所关注的指标的个性化见解摘要
- 任何语言的 Ask Q&A 都可以实现更好的语义匹配
- Pulse 中的 Tableau Agent，可以对指标和见解组进行深入的对话式探索。

这些功能的设置默认是关闭的，因此您需要在 Tableau Cloud 中单独打开每个设置才能使用它们。

**注意**：适用于 Tableau Pulse 的 Tableau 中的 AI 设置独立于部署 Tableau Pulse 的设置，这意味着打开 Tableau Pulse 并不会打开 Tableau 中的 AI 的设置。

Tableau Pulse 不会使用您站点的数据来训练其生成式 AI。当 Tableau 中的 AI 处理生成见解摘要或见解简要的提示时，提示和响应就会被忘记。您的数据不会存储在 Tableau 外部，Tableau 中的 AI 收集的唯一数据是用户可以提交的有关其见解摘要的自愿反馈。有关详细信息，请参见[适用于 Tableau 的 Einstein 生成式 AI](https://help.tableau.com/current/tableau/zh-cn/about_tableau_gai.htm)。

### 启用指标见解摘要

当您关注两个或更多指标时，Tableau Pulse 会提供概述，帮助您快速查看感兴趣指标的最新见解。如果可用，此见解摘要将显示在摘要和 Tableau Pulse 主页中。有关详细信息，请参见[见解摘要突出显示感兴趣的指标](https://help.tableau.com/current/online/zh-cn/pulse_insights_platform_insight_types.htm#insight-summaries-highlight-metrics-of-interest)。

默认情况下，Tableau 中的 AI 设置对于您的站点是关闭的。打开此设置，以便您的用户可以查看他们的个性化见解摘要并快速概览其指标的重要变化。

**注意**：此功能不需要您登录 Salesforce 组织。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”，然后选择 “常规”选项卡。
2. 在“Tableau 中的 AI”下，选择“Tableau Pulse：总结关键指标见解”。
3. 选择“保存”。

**注意**：适用于 Tableau Pulse 的 Tableau 中的 AI 设置独立于部署 Tableau Pulse 的设置，这意味着打开 Tableau Pulse 并不会打开 Tableau 中的 AI 的设置。

当您打开适用于 Tableau Pulse 的 Tableau 中的 AI 设置时，用户将看到一条通知，告知他们生成式 AI 可能会产生不准确或有害的响应。用户可以通过选择“赞成”或“反对”评级来留下有关他们看到的见解摘要质量的反馈。

适用于 Tableau Pulse 的 Tableau 中的 AI 用于生成见解摘要的语言，但 Tableau 中的 AI 不参与数据见解的识别，并且会进行检查以确保见解摘要中的数字没有更改。Tableau Pulse 发现的见解基于用于分析传统 Tableau 可视化项创作体验中的数据的相同类型的统计模型。

### 在 Tableau 中为 Ask Q&A 启用更好的语义匹配

Ask Q&A 可根据单一指标检测见解并提出进一步的问题。您可以输入自己的问题，调整时间粒度并为当前指标视图应用维度筛选器。例如，“上周加州的销售额”、“放大技术”或“昨天怎么样？”有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)和 [Tableau 如何通过问答方式实现 NLP，从而帮助每个人](https://www.tableau.com/zh-cn/blog/how-tableau-pulse-approaches-nlp-with-qa)。

默认情况下，您的站点已关闭 Ask Q&A 的更好语义匹配。当您使用 Ask Q&A 以任何语言探索单一指标时，启用此设置可获得最佳语义结果。

当您使用 Ask Q&A 时，启用此设置可增强任何语言的语义匹配。当此设置打开时，问题和见解文本将作为语义匹配计算过程的一部分发送给 OpenAI。对 OpenAI 的所有调用都会经过 [Einstein 信任层](https://help.salesforce.com/s/articleView?id=sf.generative_ai_trust_layer.htm&type=5)。

**注意**：此功能不需要您登录 Salesforce 组织。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”，然后选择 “常规”选项卡。
2. 在 Tableau 中的“AI”下，选择“Tableau Pulse：使用任何语言提问时都能获得更好的语义匹配”。
3. 选择“保存”。

**注意**：适用于 Tableau Pulse 的 Tableau 中的 AI 设置独立于部署 Tableau Pulse 的设置，这意味着打开 Tableau Pulse 并不会打开 Tableau 中的 AI 的设置。

当您打开适用于 Tableau Pulse 的 Tableau 中的 AI 设置时，用户将看到一条通知，告知他们生成式 AI 可能会产生不准确或有害的响应。用户可以通过选择“赞成”或“反对”评级，留下关于作为答案出现的见解的质量反馈。

### 启用 Pulse 中的 Tableau Agent

Pulse 中的 Tableau Agent 使用 Tableau 中的 AI 使您的分析超越单个指标，揭示指标组之间的联系。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)。Pulse 中的 Tableau Agent 是 Tableau+ 的一项功能；不过，您可以限时免费试用 Pulse 中的 Tableau Agent。有关详细信息，请参见[试用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm)。

**注意：**增强型问答 (Discover) 已重命名为 Pulse 中的 Tableau Agent。功能保持不变。只是名称发生了变化。

默认情况下，Pulse 中的Tableau Agent 对于您的站点处于关闭状态。打开此设置可启用基于 Tableau Pulse 中指标组的对话式问答体验。

**重要信息：**Pulse 中的 Tableau Agent 需要将 Salesforce 组织连接到 Tableau Cloud。连接设置位于 Tableau Cloud 中“常规设置”的“Tableau 中的 AI”部分的开头。此外，必须为您选择的 Salesforce 组织设置 Salesforce 中的 Einstein 生成式 AI。

若要使 Pulse 中的 Tableau Agent 在 Tableau Cloud 中可用，您必须在 Salesforce 和您的 Tableau Cloud 站点中配置更改。按照[为 AI 配置 Tableau Cloud 站点](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm#configure-tableau-cloud-sites-for-ai)中的多步骤过程的说明进行操作。

Pulse 中的 Tableau Agent 的试用版不需要与 Salesforce 组织的专用连接。若要了解如何开始试用，请参见[开始试用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm#start-trial)。

1. 按照帮助主题[为 AI 配置 Tableau Cloud 站点](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm#configure-tableau-cloud-sites-for-ai)中的说明进行操作。
2. 从 Tableau Cloud 主导航菜单中，选择“设置”，然后选择 “常规”选项卡。
3. 在“按功能划分的 AI 设置”下，找到“Tableau Pulse：使用 Pulse Discover 对指标和见解组进行深入、综合的探索”行。
4. 从“操作”(...) 菜单中，选择“打开”。若要仅为某些用户组启用该功能，请选择“用户访问权限”，然后选择要允许访问的组。
5. 选择“保存”。

**注意**：适用于 Tableau Pulse 的 Tableau 中的 AI 设置独立于部署 Tableau Pulse 的设置，这意味着打开 Tableau Pulse 并不会打开 Tableau 中的 AI 的设置。

当您打开适用于 Tableau Pulse 的 Tableau 中的 AI 设置时，用户将看到一条通知，告知他们生成式 AI 可能会产生不准确或有害的响应。

## 关闭个性化见解排名

您的 Tableau 站点默认启用“个性化见解排名”设置。启用此设置后，用户可以对见解提供赞同或反对的反馈。然后，Tableau Pulse 见解平台会使用该反馈进一步个性化向用户显示的见解类型并对其进行排序。此设置与部署 Tableau Pulse 的设置无关。

1. 从 Tableau Cloud 主导航菜单中，选择“设置”，然后选择“常规”。
2. 在“个性化见解排名”下，选择 “开启（用户可以提交反馈以改进他们收到的见解）”。
3. 选择“保存”。

当个性化见解排名关闭时，用户将无法对个人见解提交赞成或反对的反馈。

## 指标故障排除

如果您站点上的用户在创建指标定义或查看指标时看不到数据，则您的数据源可能存在问题。请注意，如果今天的日期是时间序列当前期间的开始（例如该月的第一天），则图表将仅显示该点。这不是您的数据源的问题。随着时间的推移，将在时间序列中添加新的点。

**如果用户正在创建指标定义并且预览中没有数据：**Tableau Pulse 会显示当前期间迄今为止的预览数据。如果所选度量没有最新数据，用户将不会在图表上看到预览。检查数据源以验证数据是否正在更新。

**如果用户正在查看以前有数据的指标，但现在没有数据：**检查数据源中是否移除或更改了指标使用的字段。编辑指标定义以考虑此更改，该更改将反映在所有基于该定义的指标上。有关详细信息，请参见[编辑指标定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#edit)。

<!-- document id=a0386a8e81642e40aca8b702adcb7ad1ad891616d43d095dee4d6652448520a9 url=/tableau/next/zh-cn/online/to_external_kms_credentials.md -->

[跳转到主要内容](#main-content)

# 为凭据加密密钥使用外部 KMS

您可以将用于加密和解密存储的数据凭据的主密钥存储在外部密钥管理系统 (KMS) 中。通过提供对加密密钥的直接控制，使用外部 KMS 可以帮助组织增强安全状况、满足法规要求并维护数据主权。

有关使用外部 KMS 进行密钥管理的优势的一般信息，请参见[使用外部 KMS 进行密钥管理](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm)。

注意：如果您拥有 Tableau +、Tableau Enterprise 或 Advanced Management，则用于凭据加密密钥的外部 KMS 功能自 Tableau Cloud 2026 年 8 月版起可用。如果在某个时候您不再拥有 Tableau +、Tableau Enterprise 或 Advanced Management，您仍可正常使用加密对象，但将无法管理密钥。

## 设置概述

使用 AWS KMS 存储数据凭据加密密钥的摘要级步骤包括：

1. [使用外部 KMS 启用数据提取加密](#Enable-for-extracts)
2. [启用凭据加密](#Enable)
3. [在 Tableau 中生成数据密钥](#Generate)

### 密钥状态

使用外部 KMS 时，Tableau Cloud 中用于凭据加密的密钥具有以下状态和功能：

- **活动** — 密钥用于加密凭据，以及解密其加密的凭据。
- **已存档** — 该密钥过去处于活动状态，但已被后来的密钥取代。它并非用于加密凭据，而是用于解密其加密的凭据。
- **已停用** — 密钥过去处于活动状态，后来已归档，并且此后已停用。它未用于加密或解密任何凭据。

#### 状态快速参考

| 密钥状态 | 可以加密凭据 | 可以解密凭据 |
| --- | --- | --- |
| 活动 | ✓ | ✓ |
| 已存档 |   | ✓ |
| 已停用 |   |   |

## 设置详细信息

配置时先进行以下操作：

1. 登录到您的 Tableau Cloud 站点。
2. 在左侧导航窗格中选择“设置”。
3. 选择“安全”选项卡。

### 1.使用外部 KMS 启用数据提取加密

若要使用外部 KMS 进行数据凭据加密，请先为数据提取加密启用外部 KMS。请参见[将外部 KMS 用于数据提取加密密钥](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms_extracts.htm#kms-extracts-setup-details)中的“设置详细信息”部分。

### 2.启用凭据加密

启用凭据加密：

1. 在“凭据加密”部分下，选择“加密保存的凭据”。

### 3.生成数据密钥

若要加密和解密已保存的数据凭据，请生成数据密钥。

生成数据密钥：

1. 在“凭据加密”部分下，选择“生成数据密钥”。
2. 在对话框中，选择“生成数据密钥”。请注意，您无法在 7 天内生成多个数据密钥。如果对话框不包含生成数据密钥按钮，则表示您在过去 7 天内已生成数据密钥。

生成后，新密钥的状态为“活动”，这意味着它用于对存储的数据凭据进行加密和解密。

注意：在站点上启用加密并激活第一个密钥后，Tableau Cloud 会为站点上的所有数据凭据创建加密作业。这些作业在后台运行且优先级最低，这意味着它们仅在有额外资源时运行。

## 其他操作

### 将密钥存档

已存档的密钥可以解密其加密的凭据，但不用于对其进行加密。存档密钥的唯一方法是生成新的数据密钥。请参见[生成数据密钥](#Generate)。

### 停用密钥

停用已存档的密钥，使其无法用于加密或解密任何存储的凭据。如果密钥已泄露，您可能会执行此操作。“停用密钥”操作仅适用于“已存档”的密钥。

停用密钥时，它不能用于解密它加密的凭据（与已存档密钥相反，已存档密钥_可以_解密它加密的凭据）。

注意：如有必要，您可以恢复已停用的密钥。恢复密钥会将其从“已停用”更改为“已存档”。请参见[“恢复密钥”](#Restore)。

停用密钥：

1. 在“凭据加密”部分下，选择相应“已存档”密钥旁边的操作 (...)。
2. 选择“停用密钥...”。
3. 在文本字段中输入“停用此密钥”以确认您的操作。
4. 选择“停用数据密钥”。

### 恢复密钥

恢复停用的密钥，使其可用于解密其加密的凭据。“恢复密钥”操作仅适用于“已停用” 密钥，并将其更改为“已存档”。

当您将密钥恢复到已存档状态时，它将不会用于加密任何凭据。它仅用于解密它写入的凭据。

1. 在“凭据加密”部分下，选择相应的“已停用”密钥旁边的操作 (...)。
2. 选择“恢复密钥...”。
3. 选择“恢复数据密钥”。

### 删除密钥

您无法删除凭据加密密钥。密钥只能存档（保留解密它写入的凭据的能力）或停用（既不能加密也不能解密）。请参见[密钥状态](#Key)。

注意：如果您在 AWS KMS 中禁用客户主密钥 (CMK)，则从其派生的 Tableau 密钥将停止进行加密或解密。同样，如果您从 AWS KMS 中的 CMK 策略中移除 Tableau 生成的子句，则从其派生的 Tableau 密钥将停止工作。

<!-- document id=b648652aedf777bd4cd2c3fa6d8cce933dd9321d46eccd2374976fee23a84f9e url=/tableau/next/zh-cn/online/to_bridge_linux_install.md -->

[跳转到主要内容](#main-content)

# 为容器安装 Linux 版 Bridge

Linux 版 Bridge 提供容器化工作负载的可扩展性和简化的管理功能。以下说明描述了运行适用于 Linux 版 Bridge 的轻量级方法，并假设您具有 Docker 的基本知识并了解生态系统中使用的关键术语。

## 从 Docker 容器安装并运行 Bridge

若要在 Linux 上使用 Bridge，您必须创建自定义 Docker 映像，安装 RPM 包，然后从容器映像内部运行 Bridge。

安装说明：

- 您可以在一台计算机上部署多个 Linux 版 Bridge 容器。
- 不支持具有动态 IP 的无服务器解决方案。
- 不支持 Bridge 旧版计划。有关详细信息，请参见[从 Bridge（旧版）计划迁移到 Online 计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm)。

### 先决条件

- 安装了 Docker 引擎。对于 docker 容器的基础映像，Linux 版 Bridge 在以下操作系统上受支持：
    
    - Amazon Linux 2023
    - Red Hat Enterprise Linux 8
    - Red Hat Enterpirse Linux 9
    
    **注意**：不支持 CentOS。
- 从 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面下载最新的 Tableau Bridge RPM 软件包。
- 有 Linux 操作系统经验。
- 基本的 shell 脚本编写。
- Docker 经验。
- Tableau 站点管理员[个人访问令牌](https://help.tableau.com/current/online/zh-cn/security_personal_access_tokens.htm) (PAT) 或[统一访问令牌](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/unified_access_tokens.html) (UAT)。您必须为每个 Bridge 客户端使用专用的 PAT 或 UAT。Tableau 支持每个用户 104 个 PAT 令牌。
- 如果您的 Bridge 主机将连接到远程共享，则需要在 Docker 文件中为 UNC 映射创建一个部分。请参见[连接到平面文件和基于文件的数据提取](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#remote-share)。
- Linux 版 Bridge 不支持 Bridge（旧版计划）。请参见[从 Bridge（旧版）计划迁移到 Online 计划](https://help.tableau.com/v0.0/online/zh-cn/%3Chttps://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm#Migrate from Bridge \(legacy\) to Online schedules>)。

### 步骤 1：创建 Bridge 容器映像

以下步骤是构建 Linux 版 Bridge 基础映像上的基本说明。有关详细信息，请参见 [Docker 概述](https://docs.docker.com/get-started/overview/)。[](https://docs.docker.com/get-started/overview/)

安装 Docker 后，唯一有权运行命令的用户是 root。您可以使用 `sudo` 运行 Docker 命令，也可以由 Docker 组的成员运行。

**重要信息**：基础映像将根据不同的驱动程序和平台而有所不同。以下示例旨在说明构建基础映像的过程。您必须针对特定环境调整构建过程。

1. 从 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面下载 Bridge `.rpm` 包。
2. （可选）您可以编辑配置设置以更改客户端的运行方式。有关详细信息，请参见更改 [Bridge 客户端设置](https://help.tableau.com/current/online/zh-cn/to_sync_change_computer_site.htm)。
3. 创建工作目录并将 `.rpm` 包移入目录中。
    
    `cd ~`
    
    `$ mkdir Docker`
    
    `$ cd Docker`
    
    `$ mv <RPM_location>.rpm .`
4. 在工作目录中创建 Docker 文件。例如：
    
    `$ touch Dockerfile`
5. 编辑 Docker 文件并添加用于运行 `yum update.` 的命令
    
    **Red Hat 示例**
    
    对于 Red Hat 8：
    
    `FROM registry.access.redhat.com/ubi8/ubi:latest`
    
    `RUN yum -y update`
6. 编辑 Docker 文件，然后输入命令从映像中复制、安装和移除 Bridge RPM 软件包：
    
    - **选项 1**：使用 `--mount`，例如：
        
        FROM registry.access.redhat.com/ubi8/ubi:latest
        RUN --mount=type=bind,source=<your\_bridge\_rpm>.rpm,target=/tmp/bridge.rpm \\
         set -eux; \\
         yum -y update; \\
         ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\
         yum -y clean all; \\
         rm -rf /var/cache/yum
    - **选项 2**：直接下载 rpm>，例如：
        
        FROM registry.access.redhat.com/ubi8/ubi:latest
        RUN set -eux; \\
         yum -y update; \\
         curl -fsSL https://repo.example.com/bridge.rpm -o /tmp/bridge.rpm; \\
         ACCEPT\_EULA=y yum install -y /tmp/bridge.rpm; \\
         rm -f /tmp/bridge.rpm; \\
         yum -y clean all; \\
         rm -rf /var/cache/yum
7. 使用 `docker` build 命令构建新的容器映像。
    
    例如，以下命令在当前目录中构建一个映像，并用单词 `​"bridge_base"` 标记它。
    
    `docker buildx build --platform=linux/amd64 -t bridge_base .`
8. 检查您创建的基础映像是否显示在映像列表中：
    
    `docker images | grep bridge`

### 步骤 2：安装驱动程序

Bridge 客户端需要驱动程序来促进专用网络数据和 Tableau Cloud 之间的连接。对于驱动程序，请转至[驱动程序下载](https://www.tableau.com/zh-cn/support/drivers)，选择数据源，然后选择“Linux”作为操作系统。

1. 可以在启动基础映像后以交互方式完成安装，也可以将单独的 Dockerfile 编写为基础映像之上的一层。
    
    **示例**
    
    将 MySQL 驱动程序 RPM 复制到该目录后，您可以使用以下 Dockerfile 创建一个单独的工作目录，用于对 MySQL 驱动程序进行分层：
    
    `# Using previously built bridge_base image`
    
    `FROM bridge_base`
    
    `COPY mysql-connector-odbc-8.0.26-1.el8.x86_64.rpm`
    
    `RUN yum install -y mysql-connector-odbc-8.0.26-1.el8.x86_64.rpm`
    
    **注意：**MySQL 和 Amazon Aurora MySQL 驱动程序的要求是配置区域设置并在映像中安装语言包：  
    示例：  
    `RUN yum install -y glibc-langpack-en`  
    `ENV LANG=en_US.UTF-8 LANGUAGE=en_US:en LC_ALL=en_US.UTF-8`
    
    **示例**
    
    安装 postgres JDBC 驱动程序。此操作也可以在单独的 Dockerfile 中完成。
    
    `# Using previously built bridge_base image`
    
    `FROM bridge_base`
    
    `COPY postgresql-42.3.3.jar /opt/tableau/tableau_driver/jdbc/`
    
    **示例**
    
    安装 Amazon Redshift 驱动程序。
    
    `# Using previously built bridge_base image`
    
    `FROM bridge_base`
    
    `yum install -y unixODBC`
    
    `yum --nogpgcheck localinstall -y`
    
    `AmazonRedshiftODBC-64-bit-2.1.7.0.x86_64.rpm`
    
    `odbcinst -i -d -f /opt/amazon/redshiftodbcx64/odbcinst.ini`
2. 创建新映像：

`docker image build -t bridge_final .`

`bridge_final` 映像使用上一步中的缓存映像，并自动为所有 Bridge 实例安装驱动程序。如果您有映像存储库，则可以将映像发布到存储库并将映像分发到要运行 Bridge 的所有计算机。

### 步骤 3：安装语言包并在 Docker 中设置区域设置

1. 在 Docker 容器中安装语言包：
    
    `RUN yum install -y glibc-langpack-en`
2. 使用 `ENV LC_ALL en_US.UTF-8` 在 Docker 中设置区域设置。您还可以通过将以下内容添加到 `/etc/profile` 文件来设置区域设置:
    
    `export LANG="en_US.utf8"`
    
    `export LANGUAGE="en_US.utf8"`
    
    `export LC_ALL="en_US.utf8"`

### 步骤 4：运行 Bridge 容器

现在您已经构建了基础映像，可以使用多种方法部署它。基本步骤包括：

1. 创建令牌
2. 启动 Bridge 容器的实例。
3. 将代理分配到池。

#### 创建令牌

在开始部署容器之前，请创建[个人访问令牌](https://help.tableau.com/current/online/zh-cn/security_personal_access_tokens.htm) (PAT) 或[统一访问令牌](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/unified_access_tokens.html) (UAT)。登录到代理需要 PAT 或 UAT。

**注意事项和要求**：

- Tableau Cloud 支持每个用户 104 个 PAT。我们建议每个客户端使用一个 PAT 或 UAT。
- 以下令牌名称必须匹配：`patTokenId` 或 `jwTokenFile` （运行 `run-bridge.sh` 命令时使用）、JSON 文件中的令牌名称，以及生成令牌时指定的令牌名称。
- 如果使用 UAT，则必须包括所需的 Oauth 范围：`"tableau:remote_agents:*"`、`"tableau: jobs:read"`、`"tableau:file_uploads:*"`、 `"tableau:datasources:*"`

#### 启动实例

此过程中的交互式方法说明了启动工作线程所需的步骤。当您退出时，容器停止运行。

- 以 `root` 用户身份运行此命令，移动到容器的 shell 提示符：
    
    `docker container run -it bridge_final /bin/bash`

其余命令在容器的此交互式会话的上下文中执行。

1. 将 PAT 或 UAT 令牌添加到 JSON 格式的平面文件中。例如：`/home/jSmith/Documents/MyTokenFile.txt`
2. 令牌语法示例：
    
    `{"MyToken" : "uLICC7e8SUS8ZNGe8RIFn4u==:lRihmYHI0XBKle7e8S4uSORXGqAkAl4"}`
3. 更改文件权限以限制当前用户的访问。例如：`chmod 600 MyTokenFile.txt`
4. 通过运行 `run-bridge.sh` 命令，启动 Bridge 容器的实例。该过程因您使用的令牌类型而异：
    
    **PAT 命令示例**
    
    /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94"
    
    **UAT 命令示例**
    
    /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --jwTokenFile="jwTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94"
    
    run-bridge.sh 参数
    
    <table style="border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" class="simple-table"><colgroup><col style="width: 129px;"><col></colgroup><tbody><tr><th colspan="2"><strong>全局参数</strong></th></tr><tr><td><code>--client</code></td><td>（必需）您想要为工作线程指定的名称。</td></tr><tr><td><code>--site</code></td><td>（必需）显示在 URI 中的站点名称。不要包含 URI 路径。</td></tr><tr><td><code>--userEmail</code></td><td>（必需）与令牌关联的用户电子邮件。</td></tr><tr><td><code>-e</code></td><td>（可选）默认情况下，Bridge 客户端工作线程作为后台服务运行。若要在前台运行工作线程，请包含 -e 参数。</td></tr><tr><td><code>--poolId</code></td><td>（可选）分配给客户端的池 ID。请参见<a href="#UsingPoolID" class="xref">使用池 ID</a>。</td></tr></tbody></table>
    
    <table style="border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" class="simple-table"><colgroup><col style="width: 129px;"><col></colgroup><tbody><tr><th colspan="2"><strong>PAT：必需参数</strong></th></tr><tr><td><code>--patTokenId</code></td><td>PAT 的 ID。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/security_personal_access_tokens.htm">个人访问令牌</a>。</td></tr><tr><td><code>--patTokenFile</code></td><td>PAT 文本文件的文件名和路径。</td></tr></tbody></table>
    
    <table style="border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" class="simple-table"><colgroup><col style="width: 129px;"><col></colgroup><tbody><tr><th colspan="2"><strong>UAT：必需参数</strong></th></tr><tr><td><code>--jwTokenFile</code></td><td>UAT 文本文件的文件名和路径。</td></tr></tbody></table>

**注意**：如果您正在安装旧版本的 Linux 版 Bridge，则必须运行不同的命令来启动工作线程。对于 2024.2 及更低版本，使用 `TabBridgeClientWorker` 命令（而不是 `run-bridge.sh` 命令）启动工作线程。所有命令选项都是相同的。

**代理已启动**

以下消息表明代理已启动。`“Service started: ...”`

**停止工作线程**

使用 `Control-C` 停止工作线程。您可以为容器映像启动一个新的工作线程，而不是重新启动工作线程。

#### 默认池分配

如果您没有使用命令选项 `--poolId` 分配池，则将客户端分配到默认池。如果您想要将客户端与特定域或 VConns 一起使用，您可以使用 UI 将客户端分配到命名池。Tableau Cloud“主页”\>“设置”\>“Bridge”上的菜单。有关详细信息，请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。

#### 使用池 ID

使用 `run-bridge.sh` 命令启动 Bridge 工作线程时，`poolId` 是可选的。但是，客户端的行为取决于客户端是否注册到站点以及客户端是否分配到池。Tableau Bridge 在任何给定时间只能连接或注册到一个 Tableau Cloud 站点。当您注销并重新登录时，客户端将注册到站点。

**如果未提供池 ID**

- 如果 Bridge 客户端已经注册，则客户端状态保持不变：
    - 如果客户端已分配给某个池，则它仍然分配给该池，无论它是指定池还是默认池。
    - 如果客户端未分配到池，它将保持未分配状态。
- 如果 Bridge 客户端是新的（您从未登录到 Tableau Cloud），则该客户端将分配到默认池。

**如果提供了池 ID**

- 如果提供了池 ID 并且正确，则将 Bridge 客户端分配给指定池。
- 如果提供了池 ID 且不正确：
    - 如果 Bridge 客户端未注册，则会将客户端分配到默认池。
    - 如果 Bridge 客户端已注册，则客户端状态保持不变，无论是指定池、默认池还是未分配。

#### 查找池 ID

若要查找池 ID，请转至“设置”\>“Bridge”页面，然后单击池的名称。例如：

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_pool_id.png)

## 升级 Linux 版 Bridge 客户端

与 Bridge 的最新版本保持同步可确保您可以利用 Bridge 客户端的每个新版本附带的最新功能和修复。

您不能为容器运行就地升级。相反，您必须使用最新的 Bridge 二进制文件构建新的容器映像，然后将 Bridge 客户端与以前的版本并排添加到池中。验证功能后，您随后移除了之前的 Bridge 客户端。请按以下步骤操作：

1. 按照上文所述安装并配置新的 Tableau Bridge 客户端。
2. 将新的 Bridge 客户端添加到相关池。请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。
3. 在继续下一步之前，请监控 Bridge 作业的运行状况以验证稳定性。
4. 从池中移除之前的 Bridge 客户端。打开池，找到要移除的客户端计算机，然后单击**“删除”**。
5. 等待 Bridge 客户端上的数据提取刷新超时过程完成。默认超时为 24 小时。有关详细信息，请参见[dataSourceRefreshSettings](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#dataSourceRefreshSettings)。
6. 刷新超时期限过后，您可以移除 Bridge 客户端的先前实例。

## 疑难解答

### 安装旧版本

如果您正在安装旧版本的 Linux 版 Bridge，则必须运行不同的命令来启动工作线程。对于 2024.2 及更低版本，使用 `TabBridgeClientWorker` 命令（而不是 `run-bridge.sh` 命令）启动工作线程。

所有命令选项与上面[步骤 4：运行 Bridge 容器](#runBridgeContainer)中记录的相同。

例如： 

/opt/tableau/tableau\_bridge/bin/TabBridgeClientWorker -e --patTokenId="Mytoken" --userEmail="admin@tableau.com" --client="myBridgeAgent" --site="mySite" --patTokenFile="/home/jSmith/Documents/MyTokenFile.txt" --poolId="1091bfe4-604d-402a-b41c-29ae4b85ec94"

### 工作线程启动错误

在某些情况下，运行 `run-bridge.sh` 命令后会出现以下错误：

`Missing log in parameters. Aborting the attempt to start service worker.`

在大多数情况下，使用原始选项和 `-e` 选项重新运行命令可修复该问题。`-e` 选项在前台运行 Bridge 工作线程服务。

如果在后台模式下运行 Bridge 客户端，并且看到启动错误，请验证所有输入参数是否包括任何所需文件的路径。例如，在后台模式下，不会提供用户上下文来解析令牌文件的路径。

### 使用日志文件

日志文件存储在用户的 `My_Tableau_Bridge_Repository/Logs`文件夹中。若要在 `tmp` 文件夹中保存日志，请运行以下命令：

docker container run --volume /tmp/bridge\_logs:/root/Documents/My\_Tableau\_Bridge\_Repository/Logs -it bridge\_final /bin/bash

在此示例中，该位置由 /tmp/bridge\_logs 指定。使用 docker 命令可以简化日志文件的保存，并避免手动将 Bridge 日志文件从容器复制到本地文件系统。

### MySQL 驱动程序失败

如果 `LC_MESSAGES` 没有设置 `UTF-8` 区域设置，您可能会遇到读取和显示问题。您可以编辑 `/etc/profile` 文件，或使用以下命令重新启动工作线程：

LC\_ALL=en\_US.UTF-8 /opt/tableau/tableau\_bridge/bin/run-bridge.sh -e

### 由于个人访问令牌过期，Bridge 客户端意外停止

当个人访问令牌 (PAT) 过期时，它将导致 Bridge 客户端与 Tableau Cloud 断开连接，并可能导致容器关闭。您可以从 Bridge 客户端通过在前台执行 Start 命令来验证您的 PAT 是否已过期。如果 PAT 已过期，您将看到以下错误：

`The client credentials are invalid. To complete the request, reset the credentials, and sign in to the Tableau Bridge client.`

如果您是原始 PAT 所有者，您还可以通过访问 Tableau Cloud 中的“管理帐户设置”来验证 PAT 是否已过期。为了解决该问题，您需要生成一个新的 PAT 并按照上面的[步骤 4：运行 Bridge 容器](#runBridgeContainer)步骤操作。

### 嵌入式数据提取和嵌入式实时连接超时错误

Linux 版 Bridge 的 24.3 版本为嵌入式数据提取和嵌入式实时连接提供了显著的性能改进。如果您在使用以前的版本时遇到超时错误，我们建议您升级到 Linux 版 Bridge 24.3+ 版本。如果这不能解决问题，请从工作簿中单独发布数据源。

<!-- document id=4d77b4e7757c84375bd720e65e7bd2e606b0cb642b9d9a0245be4a8e282b8e00 url=/tableau/next/zh-cn/online/dm_lineage.md -->

[跳转到主要内容](#main-content)

# 为影响分析使用世系

了解数据来源是信任数据的关键，知道其他人使用它意味着您可以分析更改对环境中数据的影响。Tableau Catalog 中的世系功能可帮助您执行这些操作。

当您拥有 Data Management 许可证并启用 Tableau Catalog 时，就可以访问内容的世系信息。有关 Tableau Catalog 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。

## 世系导航

若要查看资产的世系，请首先导航到资产的页面。此步骤的选项包括：

- 搜索资产并将其选中。
- 从“浏览”导航到该资产。
- 如果它是不在项目中的外部资产（例如数据库或表），请通过“外部资产”导航到该资产。（此选项也适用于项目_中_的外部资产。）

然后选择“世系”选项卡。

如果您看到“世系”选项卡但没有包含 Data Management 的许可证，则单击“世系”选项卡会显示 Data Management 的升级。可以在您的帐户设置中禁用升级。

**注意**：如果流程包含参数值，则不会显示流程的世系数据。有关在流程中使用参数的详细信息，请参见 Tableau Prep 帮助中的[在流程中创建和使用参数](https://help.tableau.com/current/prep/zh-cn/prep_parameters.htm)。

![世系出现在内容页面的世系选项卡上](/tableau/next/zh-cn/online/zh-cn/Img/dm_lineage_content.png)

世系显示与世系锚点（即选择的资产）相关的依赖关系。世系锚可以是数据库、表、工作簿、已发布数据源、虚拟连接、虚拟连接表、Pulse 指标定义或流程。（在上图中，锚点是 "Orders (superstore)"（订单(超市)）数据源，在下图中，锚点是“Batters”表）。该锚点下方的所有资产都直接或间接依赖于锚点，并且称为输出或下游资产。锚点上方的资产是锚点直接或间接依赖的资产，并且称为输入或上游资产。

![“世系”窗格出现在表或数据库页面的右侧](/tableau/next/zh-cn/online/zh-cn/Img/dm_lineage_example.png)

从 Tableau Cloud 2024 年 6 月版开始，Pulse 指标定义将出现在世系中。（Tableau Pulse 在 Tableau Server 上不可用。）

从 Tableau Cloud 2023 年 6 月和 Tableau Server 2023.3 开始，数据源的世系页面包括搜索和筛选（位于字段列表的右上角），使您可以快速查找感兴趣或相关的字段。

当您选择数据源中的字段或表中的列时，将筛选世系，以仅显示依赖于该字段（或列）的下游资产或者字段（或列）的上游输入，如此“Batterse”表示例中所示，该示例显示针对“'列”（佣金(可变)）字段筛选的世系。

![筛选世系是为了显示包含所选字段或列的资产计数](/tableau/next/zh-cn/online/zh-cn/Img/dm_lineage_filter.png)

您可以在“世系”窗格中选择上游或下游资产以查看其详细信息。例如，当您选择“数据源”时，依赖于此表的数据源的列表将会出现在“世系”窗格的左侧。

从“世系”窗格中，您可以通过感兴趣的链接导航到与您的初始选择相关的任何资产（在本例中为表）。

### 嵌入式资产出现在外部资产中

如果在发布数据源或工作簿发布时选中了“包括外部文件”复选框，Tableau Catalog 会将外部资产视为“嵌入式”。当外部资产（数据库、表或文件）嵌入在已发布 Tableau 内容（工作簿、数据源和流程）中时，该外部资产由内容使用，但无法与其他用户共享。该嵌入式外部资产将显示在其 Tableau 内容上游的世系中，并列在外部资产中。

若要查看某个外部资产是否为嵌入式资产，请转到该外部资产的详细信息页面，看看“嵌入式资产”是否列在“类别”下。

![“嵌入式资产”出现在“类别”标签下](/tableau/next/zh-cn/online/zh-cn/Img/dm_embedded_asset.png)

有关嵌入数据的信息，请参见 Tableau Desktop 和 Web 制作帮助中的[单独或嵌入在工作簿中发布数据](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources_about.htm#publishing-data-separately-or-embedded-in-workbooks)。

### 世系和自定义 SQL 连接

当您查看使用自定义 SQL 的连接的世系时，请谨记以下各项：

- 世系可能不完整。
- Catalog 不支持显示它仅通过自定义 SQL 知道的表的列信息。
- 字段详细信息卡可能不包含指向已连接列的链接，或者可能根本不显示任何连接列。
- 列详细信息卡可能不包含指向使用该列的字段的链接，或者可能根本不显示任何字段。

有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的 [Tableau Catalog 支持自定义 SQL](https://help.tableau.com/current/pro/desktop/zh-cn/customsql.htm#tableau-catalog-support-for-custom-sql)。

### Catalog 不支持多维数据集

Tableau Catalog 不支持多维数据集数据源（也称为多维或 OLAP 数据源）。依赖于多维数据集数据的 Tableau 内容（例如数据源、视图或工作簿）不会在 Catalog 中显示任何多维数据集元数据或多维数据集世系。

## 世系计数和选项卡计数不匹配

您可能会注意到，Tableau Catalog 世系工具与 Tableau Server 或 Tableau Cloud 中的选项卡之间的资产计数之间存在不匹配情况。

各个计数（世系计数与选项卡计数）会采用不同方式对资产进行计数，这一事实解释了计数不匹配的情况。例如，在任何给定时间点，Catalog 只能对已编制索引的资产进行计数，而 Tableau Server 或 Tableau Cloud 则会对发布的任何资产进行计数。造成计数差异的其他原因还包括：

- 您是否有该资产的“查看”权限。
- 资产是否已隐藏。
- 任何字段是否在工作簿中使用。
- 是否直接或间接连接到某一资产。
- 资产位于个人空间中。

### 工作簿计数不匹配示例

举例而说，工作簿的选项卡计数与世系计数是通过以下方式确定的。

![连接的工作簿标签计数为 239，世系中的工作簿计数为 230](/tableau/next/zh-cn/online/zh-cn/Img/dm_count_mismatch.png)

“连接的工作簿”选项卡对符合以下条件的工作簿进行计数：

- 连接到数据源（无论是否实际在工作簿中使用了任何字段）。
- 用户具有查看权限（无论是工作表、仪表板还是故事）。

Tableau Catalog 世系对符合以下所有条件的工作簿进行计数：

- 已由 Tableau Catalog 编制索引。
- 连接到数据源并至少使用数据源中的一个字段。
- 包含至少使用数据源中的一个字段中的工作表，其中包括内含工作表的仪表板或故事。

当元数据由于权限受限而被阻止时，或者资产位于个人空间中时，Catalog 仍然会对工作簿进行计数。但是，您会看到“需要权限”，而不是看到某些敏感元数据。有关详细信息，请参见[访问世系信息](https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm#lineage)。

## 使用电子邮件联系所有者

世系的尽头是所有者。所有者列表包括被指定为从世系锚点下游的任何内容的所有者或联系人的任何人。

您可以向所有者发送电子邮件，告知他们有关数据的更改。（若要向所有者发送电子邮件，您必须对世系锚点内容具有“覆盖”（保存）能力。

1. 选择“所有者”以查看此世系中受数据影响的人员列表。
2. 选择要向其发送消息的所有者。
3. 单击“发送电子邮件”打开电子邮件消息框。
4. 在文本框中输入主题和您的消息，并单击“发送”。

<!-- document id=693cc367b02c90ca20b722215948288e4340761f879652f1af4fff1ea40b63ff url=/tableau/next/zh-cn/online/data_stories_more_data.md -->

[跳转到主要内容](#main-content)

# 为您的 Tableau 数据故事添加更多数据

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

数据故事目前支持具有两个维度和一个度量的故事，或者具有一个维度和最多 10 个度量的故事。如果您想编写不需要在仪表板上显示的数据，请使用隐藏工作表来简化仪表板。如果您想在故事中添加两个以上的维度，请串连维度或创建多个数据故事并堆叠它们。  
  

## 使用隐藏工作表

如果您有想要包含在 Tableau 数据故事中的数据并且不需要显示驱动洞察的所有Tableau数据，则可以使用隐藏工作表将其他度量和维度引入您的故事中，而不会弄乱仪表板。  
  

1. 将“数据故事”对象拖到您的仪表板，以查看您可以在“数据故事”对话框中编写哪些工作表。在此示例中，有两个工作表可供编写。  
      
    ![显示两个可用工作表的“数据故事”对话框：“Tourism by Country/Region”（按国家/地区划分的旅游）和“Tourism Over Time”（随时间变化的旅游）。](/tableau/next/zh-cn/online/zh-cn/Img/data_story_configure_view.png)

1. 通过导航到左侧菜单，选择“浮动”，并将该工作表拖到仪表板上，从而引入另一个数据源，例如“Population”（人口）。  
      
    ![显示三个可用工作表的“数据故事”对话框：“Population”（人口）、“Tourism by Country/Region”（按国家/地区划分的旅游）和“Tourism Over Time”（随时间变化的旅游）。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_hidden_3.png)

使用新的可用数据源更新“数据故事”对话框。  

1. 单击进入“布局”，并将大小调整为 1 x 1 以隐藏工作表，但保留故事中的基础数据。  
      
    ![选择了“浮动”的“仪表板”窗格。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_hidden_1.1.png)

您现在可以使用此隐藏工作表配置您的故事。  

**注意：**您可能需要取消选择其他图例元素以隐藏工作表。  

## 串连维度

如果您的数据包含三个维度和一个度量，并且是离散故事，您可以通过创建计算字段来串连（链接在一起）其中两个维度。  
  

1. 从您要在故事中使用的工作表中，单击“分析”并选择“创建计算字段”。
2. 命名计算字段并使用以下公式创建计算，使用 + 号联接维度。  
    \[维度 1\] + \[维度 2\]  
      
    ![显示“\[Population 0-14\]+\[Population 15-64\]”的计算框](Img/data_stories_concatenate.png)

> [!TIP]
> 
> **提示：**将您的维度拖到“计算字段”框中并将它们放入公式中。  

1. 单击“确定”。
2. 将您的新计算字段拖到“详细信息”窗格中，以便在您的数据故事中访问它。

## 堆叠多个数据故事

通过创建多个数据故事并将它们垂直或水平堆叠在仪表板上来编写更多度量和维度。  

举例来说，如果您想创建一个关于实际收入与基准收入的故事，您可以创建两个不同的故事 — 一个包含实际收入和第一个基准，另一个包含实际收入和第二个基准 — 并将它们进行比较。

<!-- document id=174c9ae6a60f9621717b4ec1b4dfa478f9b0b025e816607414dc23bd7887083b url=/tableau/next/zh-cn/online/setup_tabAI_site_setting.md -->

[跳转到主要内容](#main-content)

# 在您的 Tableau Cloud 站点中启用 AI

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

Tableau 中的 AI 将值得信赖的生成式 AI 引入整个 Tableau 平台。Tableau 中的 AI 可以通过以下方式增强您的数据分析：建议步骤以帮助您清理 Tableau Prep 流程中的数据，为 Tableau Prep 流程或在构建可视化项时创建计算，推荐有洞察力的问题以探索您的数据，总结关键指标，以及直接依据您的数据集创建引人注目的可视化项。

Tableau 中的 AI 由生成式 AI 提供支持，并继承了 [Einstein 信任层](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust_layer.htm)和安全控制措施。若要详细了解 Tableau 中的 AI，请参见 [Tableau 中的 AI](https://help.tableau.com/current/tableau/zh-cn/about_tableau_gai.htm)。有关 Einstein 生成式 AI 的一般信息，请参见 Salesforce 帮助中的[关于 Einstein 生成式 AI](https://help.salesforce.com/s/articleView?id=ai.generative_ai_about.htm&type=5)。

本主题包括三种不同场景的步骤，并引导您完成在每种场景中配置 AI 以在 Tableau Cloud 中使用所需的步骤。您遵循的步骤取决于您要执行的操作：

- **试用客户：**如果您正在通过试用版试用 Tableau 中的 AI，请转到本主题后面的说明： [使用 Tableau Cloud 新站点试用版启用 Tableau 中的 AI](#GenAI_trial)。
- **Tableau Pulse 客户：**Tableau Cloud 管理员可以在 Tableau Pulse 中为 Ask Q&A 启用见解摘要和更好的语义匹配。有关详细信息，请参见[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#tableau-ai-in-tableau-pulse)。
- **Tableau Cloud+ 和 Tableau+ 客户：**Tableau Cloud+ 和 Tableau+ 客户可以配置 Pulse 中的 Tableau Agent，以及其他生成式 AI 和 Tableau Agent 功能。这些功能需要在 Salesforce 中进行额外的配置步骤，详情请参见[为 AI 配置 Tableau Cloud 站点](#GenAI_config_SF_Tab)。

**在其他应用程序中访问 Tableau Agent**

- **Tableau Desktop**（版本 2025.1 及更高版本）：使用启用了 AI 的 Tableau Cloud+ 或 Tableau+ 登录 Tableau Cloud 站点的用户将能够访问 Tableau Agent 并配置仪表板中的 Tableau Agent （版本 2026.2.4 及更高版本）的设置。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[使用 Tableau Agent 构建视图并探索数据](https://help.tableau.com/current/pro/desktop/zh-cn/desktop_einstein.htm)。
- **Tableau Prep**（版本 2025.2 及更高版本）：使用启用了 AI 的 Tableau Cloud+ 或 Tableau+ 登录 Tableau Cloud 站点的用户将能够在 Tableau Prep Builder 和 Tableau Cloud 中访问 Tableau Agent 进行 Tableau Prep Web 制作，以帮助清理和转换数据。有关此功能的更多详细信息，请参见 Tableau Prep 帮助中的[使用 Tableau Agent 构建 Tableau Prep 流程](https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm)。
- **Tableau Server** （版本 2025.3 及更高版本）：当您连接到启用了 AI 的 Tableau Server 时，使用 Tableau Agent。有关将 Tableau Agent 与 Tableau Server 结合使用的详细信息，请参见[在您的 Tableau Server 站点中启用 AI](https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm)。

## 在 Tableau Cloud 中启用 AI 的先决条件

**注意**：Tableau 中的 AI 不适用于 Government Cloud 用户。

Tableau Cloud 客户有几种在其站点中配置生成式 AI 的选项。必要的步骤取决于您可以访问和想要使用的功能。

- Tableau Pulse 的功能（例如见解摘要和针对 Ask Q&A 的更好的语义匹配）需要在 Tableau Cloud 站点设置中启用，但不需要您登录 Salesforce 组织。
- 必须在 Tableau Cloud 站点设置中打开 Pulse 中的 Tableau Agent，并且还需要连接到 Salesforce 组织。有关详细信息，请参见[为 AI 配置 Tableau Cloud 站点](#GenAI_config_SF_Tab)和[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)。
- 若要将生成式 AI 与 Tableau Cloud Web 制作、Tableau Prep 和 Tableau Catalog 等其他功能一起使用，您必须拥有 Tableau Cloud+ 或 Tableau+，并且需要在 Tableau 和 Salesforce 中都进行配置。有关说明，请参见[为 AI 配置 Tableau Cloud 站点](#GenAI_config_SF_Tab)。若要为这些功能启用 Tableau 中的 AI，您需要满足以下条件：
    
    - 一个带有 Tableau Cloud+ 或 Tableau+ 的 Tableau Cloud 站点。有关详细信息，请参见 [关于 Tableau Cloud+ 版本](https://help.tableau.com/current/online/zh-cn/to_tab_cloud_plus_features.htm)或[关于 Tableau+](https://help.tableau.com/current/online/zh-cn/to_tab_plus_features.htm)
    - 一个设置了 Einstein 生成式 AI 的 Salesforce 组织。当您购买 Tableau Cloud+ 或 Tableau+ 时，系统会为您预置一个 Salesforce 组织（如果还没有该组织），但您需要针对 Einstein 生成式 AI 对其进行配置。以下说明将引导您完成此操作。
    - Data Cloud 实例。当您购买 Tableau Cloud+ 或 Tableau+ 时，如果您还没有 Data Cloud 实例，我们会为您提供一个。
    - Tableau 和 Salesforce 的适当权限和凭据。下面将对此进行解释。
    
    如需完整说明，请转到下面的[为 AI 配置 Tableau Cloud 站点](#GenAI_config_SF_Tab)。

### 连接 Tableau 和 Salesforce 的权限和凭据

若要将 Salesforce Org 连接到您的 Tableau 站点，您需要具有以下角色和权限的用户凭据：

- **Tableau**：_Tableau Cloud 站点管理员（Explorer 或 Creator）_角色s。有关设置此站点角色及其权限的详细信息，请参见[设置用户的站点角色](https://help.tableau.com/current/online/zh-cn/users_site_roles.htm)。
- **Salesforce**：_自定义应用程序配置文件_权限。有关此权限的详细信息，请参见 Salesforce 帮助中的[具有“自定义应用程序”配置文件权限的用户能力](https://help.salesforce.com/s/articleView?id=000386451&type=1)。
    
    如果在尝试连接到 Salesforce 组织时收到错误“API\_CURRENTLY\_DISABLED: API is disabled for this User”（API\_CURRENTLY\_DISABLED：API 已为此用户禁用），请在“系统”\>“系统权限”下检查用户配置文件，并确保选中“API Enabled”（已启用 API）复选框。

**注意**：为 Tableau Cloud+ 或 Tableau+ 客户预置 Salesforce 组织时，创建的管理员用户应该已经分配有“自定义应用程序”权限。有关此权限的详细信息，请参见 Salesforce 帮助中的[自定义权限](https://help.salesforce.com/s/articleView?id=sf.custom_perms_overview.htm&type=5)和[授予自定义设置的权限](https://help.salesforce.com/s/articleView?id=sf.cs_grant_permission.htm&type=5)。

## 为 AI 配置 Tableau Cloud 站点

为了充分利用 Tableau 中的生成式 AI，您必须在 Salesforce 和 Tableau Cloud 站点中都进行配置更改。这是一个多步骤的过程，以下步骤描述了如何执行此操作。Tableau+ 客户可以使用这些选项。

简而言之，配置包括两个主要部分，在 Salesforce 中设置 Einstein 生成 AI，然后在您的 Tableau Cloud 站点中进行设置。

**注意**：如果您已有带有 Tableau+ 的 Salesforce 现有实例，则需要与您的 Salesforce 管理员合作，以确保正确配置 Salesforce 组织。在 Salesforce 管理员完成 Salesforce 组织的配置后，他们可以为具有 Tableau 管理员所需权限的 Salesforce 用户提供一组凭据。然后，Tableau 管理员可以使用这些凭据为 Tableau 中的 AI 和该 Salesforce 组织启用连接。

以下是这些步骤的概述，后面是详细说明：

- 在 Salesforce 中设置 Einstein 生成式 AI
    
    [步骤 1：激活您的 Salesforce 组织](#GenAI_activate_SForg)。
    
    [步骤 2：设置 Data Cloud 架构师用户](#setup_dc_permissions)。
    
    [步骤 3：启用 Data Cloud](#GenAI_enable_DC)。
    
    [步骤 4：配置您的 Salesforce 组织](#configure_SF_org)。

- [配置 Tableau 中的 AI](#GenAI_config_Tab)

### 在 Salesforce 中设置 Einstein 生成式 AI

若要为您的 Salesforce 组织设置 Einstein 生成式 AI，请完成以下步骤。

#### 步骤 1：激活您的 Salesforce 组织

购买完成后，Salesforce 将通过电子邮件发送邀请，以激活您的新 Salesforce 组织（如果还没有该组织）。您的激活将预置您的 Salesforce 组织并完成您的 Salesforce 组织用户的创建。

**注意**：如果您提供了现有的 Salesforce 组织，请与您的 Salesforce 管理员合作启用 Data Cloud 和 Einstein 生成式 AI。如果您的组织被配置为 Data Cloud One Companion，则需要在其连接到的主组织中执行“设置生成式 AI”步骤。有关详细信息，请参见 Salesforce 帮助中的 [Data Cloud One](https://help.salesforce.com/s/articleView?id=data.c360_a_data_cloud_one.htm&type=5) 内容。

#### 步骤 2：设置 Data Cloud 架构师用户

若要启用 Data Cloud，您需要拥有“Data Cloud 架构师”权限集。如果您在设置菜单中未看到“Data Cloud 设置”，请完成此部分中的步骤。否则，请继续下一部分以启用 Data Cloud。

有关 Data Cloud 权限集的详细信息，请参见 Salesforce 帮助中的 [Data 360 标准权限集](https://help.salesforce.com/s/articleView?id=data.c360_a_userpermissions.htm&type=5)。

![Salesforce 设置菜单。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_data_cloud_setup2.png)

##### 为用户添加“Data Cloud 架构师”权限集

1. 选择右上角的“Setup”（设置）![Salesforce 设置齿轮图标](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_icon_19x20.png) 图标。
2. 从下拉菜单中选择“Setup”（设置）。
    
    ![Salesforce 设置菜单选项。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_data_cloud_setup3.png)
3. 在“Quick Find”（快速查找）框中，输入用户，然后从结果中选择**“Users”（用户）**。
    
    ![用户设置菜单](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_users.png)
4. 在“Users”（用户）页面上，选择应具有 Data Cloud 权限的用户。单击“User name”（用户名）、“Alias”（别名）或“Username”（用户名）打开并编辑用户个人资料。
    
    ![Salesforce 中的管理员用户列表页面。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_user_list.png)
5. 若要查看分配给用户的权限集，请在“User profile”（用户个人资料）页面上，将鼠标悬停在“Permission Set assignments”（权限集分配）上，然后选择“Edit Assignments”（编辑分配）。如果已为用户分配“Data Cloud 架构师”或“Data Cloud 营销管理员”权限集，则会显示在前 5 个权限集中。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_user_permissions.png)
6. 在 “Permission Sets”（权限集）页面上的“Available Permission Sets”（可用权限集）中选择“Data Cloud 架构师”权限，然后选择 “Add”（添加）箭头将其添加到 “Enabled Permissions Sets”（已启用权限集）。然后选择“Save”（保存）。
    
    ![Salesforce 中的权限集页面。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_add_permissions.png)

您现在应该会在“Setup”（设置）菜单中看到“Data Cloud Setup”（Data Cloud 设置）。

![Salesforce 设置菜单，其中突出显示了“Data Cloud Setup”（Data Cloud 设置）菜单选项](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_data_cloud_setup.png)

#### 步骤 3：启用 Data Cloud

在您预置的 Salesforce 组织中启用 Data Cloud。用户必须具有分配的“Data Cloud 架构师”权限集才能启用 Data Cloud。有关在 Salesforce 中设置 Data Cloud 的详细信息，请参见 Salesforce 帮助中的[设置和启用 Data 360](https://help.salesforce.com/s/articleView?id=data.c360_a_setup_provision.htm&type=5)。

1. 在 Salesforce 中登录您的 Salesforce 组织。
2. 选择右上角的“Setup”（设置）![Salesforce 设置齿轮图标](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_icon.png) 图标。
3. 从下拉菜单中选择“Data Cloud Setup”（Data Cloud 设置）。如果您没有看到此选项，则您的用户可能没有设置 Data Cloud 权限。如果是这种情况，请按照[步骤 2：设置 Data Cloud 架构师用户](#setup_dc_permissions)中的步骤进行操作。
    
    ![Salesforce 设置菜单，其中突出显示了“Data Cloud Setup”（Data Cloud 设置）菜单选项](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_data_cloud_setup.png)
4. 在“Data Cloud Setup”（Data Cloud 设置）页面的右下角，选择“Get Started”（开始）以开始预置您组织的 Data Cloud。这可能需要几分钟。
    
    ![Salesforce 组织中的 Data Cloud 设置页面。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_datacloud.png)

该过程自动运行。一旦完成，您的页面将类似于下面的页面。

![初始设置完成后，将显示“Welcome to Data Cloud”（欢迎使用 Data Cloud）屏幕。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_datacloud2.png)

#### 步骤 4：配置您的 Salesforce 组织

设置您的 Salesforce 组织以启用 Einstein 生成式 AI。必须先完成 Data Cloud 设置，然后才能启用 Einstein 信任层、设置数据屏蔽并启用 Einstein 生成式 AI 数据收集和存储。

您需要执行以下操作：

- 打开 Einstein 生成式 AI 以同步 Einstein 和 Data Cloud，并使用生成式 AI 功能。
- 设置 Einstein 信任并设置个人身份信息 (PII) 的数据屏蔽。
- （可选）启用 Einstein 数据收集和存储，将您的 Einstein 生成式 AI 审计和反馈数据存储在 Data Cloud 中。

有关详细信息，请参见 Salesforce 帮助中的[设置 Einstein 生成式 AI](https://help.salesforce.com/s/articleView?id=ai.generative_ai_enable.htm&type=5)。

##### 启用 Einstein

1. 在您的 Salesforce 组织中，如果您尚未进行“Setup”（设置）页面，选择页面右上角的“Setup”（设置）![Salesforce 设置齿轮图标](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_icon.png)图标。然后从下拉菜单中选择“Setup”（设置）。
2. 在“Setup Quick Find”（设置快速查找）框中，输入 Einstein 设置，然后从结果中选择“Einstein Setup”（Einstein 设置）。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_einstein.png)
3. 启用“Turn on Einstein”（启用 Einstein）。

![Einstein 设置对话框，其中包含用于启用 Einstein 生成式 AI、信任和审计的选项](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_einstein_setup.png)

##### 设置 Einstein 信任层

Einstein 信任层在将提示中的敏感信息发送到大型语言模型 (LLM) 之前对其进行识别和屏蔽。Einstein 信任层使用数据屏蔽来保护敏感数据（例如个人身份信息 (PII) ）不暴露给外部 LLM。完成此步骤以建立对生成式 AI 的信任，并个性化集成到最终用户体验中的数据隐私控制。

**注意**：必须先完成 Data Cloud 设置，然后才能启用 Einstein 信任层并配置数据屏蔽。

1. 在“Einstein Setup”（Einstein 设置）页面的“Configure Einstein Trust Layer Settings”（配置 Einstein 信任层设置）部分，选择“Go to Einstein Trust Layer”（转到 Einstein 信任层）。
2. 在“Einstein Trust Layer”（Einstein 信任层）页面，启用“Large Language Model Data Masking”（大型语言模型数据屏蔽）并为您的组织设置屏蔽选项。
    
    ![Einstin 信任层和 PII 屏蔽设置页面。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_trust_pii.png)
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_trust_pii_2.png "Einstein 信任层 PII 屏蔽设置。")

##### 启用 Einstein 生成式 AI 数据收集和存储

跟踪 Salesforce 组织中生成式 AI 的使用情况，并确保 AI 的使用符合您的安全、隐私、监管和 AI 治理政策。此功能可能会消耗 Data Cloud 积分。有关详细信息，请参见 [Tableau 中的 AI 应用](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_usage.htm)。

**注意**：必须先完成 Data Cloud 设置，然后才能启用 Einstein 生成式 AI 数据收集和存储。

1. 在“Setup Quick Find”（设置快速查找）框中，键入 Einstein 审计，然后从结果中选择“Einstein Audit, Analytics, and Monitoring Setup”（Einstein 审计、分析和监控设置）。
    
    ![搜索 Einstein 反馈页面的 Salesforce Org 设置快速查找框。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_feedback.png)
2. 在“Einstein Audit， Analytics， and Monitoring Setup”（Einstein 审计、分析和监控设置）页面中，启用“Audit and Feedback”（审计和反馈）。Einstein 生成式 AI 审计数据可能需要几个小时才能在 Data Cloud 中可用。
    
    ![Salesforce 组织中的 Einstein 反馈页面。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_sf_setup_feedback2.png)

### 配置 Tableau 中的 AI

按照以下步骤为 Tableau Cloud 中的特定功能启用生成式 AI 功能。对于某些功能，您可以选择为单个用户组或站点上的所有用户启用它。有关详细信息，请参见[为组中的用户启用 Tableau 中的 AI](#AI_user_groups)。

**注意：** 此功能使用生成式 AI，建立在 Einstein 信任层之上。您的数据通过无缝集成到用户体验中的数据和隐私控制保持安全。有关详细信息，请参见 [Einstein 信任层](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust_layer.htm)。

1. 以站点管理员身份登录到 Tableau Cloud。
2. 在要启用生成式 AI 功能的站点上，选择“设置”。
3. （可选）在“按功能划分的 AI 设置”部分，选择“操作”![“操作”菜单。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_menu_24x13.png)菜单，然后选择“Tableau Pulse：总结关键指标见解”和“Tableau Pulse：使用任何语言提问时都能获得更好的语义匹配”旁边的“打开”。这些功能不需要 Salesforce 组织。
4. 登录您的 Salesforce 组织。
    
    - 选择“连接到 Salesforce”。
    - 在 “登录|Salesforce”页面上，输入 Salesforce 组织的 Salesforce 用户凭据。
        
        - 必须为 Salesforce 用户 ID 分配“自定义应用程序配置文件”权限。有关详细信息，请参见 Salesforce 帮助中[具有“自定义应用程序”配置文件权限的用户能力](https://help.salesforce.com/s/articleView?id=000386451&type=1)。
        - 您的 Salesforce 组织必须启用 Einstein 生成式 AI。
        
        ![Salesforce 登录页面，其中包含用户名和密码字段以及蓝色的登录按钮。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_login_sf.png)
    - 在“Allow Access”（允许访问）页面上，选择“Allow”（允许）。
    - 成功连接到您的 Salesforce 组织后，您还可以根据需要编辑、测试或删除您的连接。
        
        ![Tableau 中的 AI 站点设置部分。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_agent_262.4png.png)
5. 对于要启用的每个 Tableau 中的 AI 功能，选择“操作”![“操作”菜单](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_menu.png) 菜单，然后选择“启用”。从以下功能中选择：
    
    - Tableau Pulse：使用 Pulse Discover 对指标和见解组进行深入、综合的探索：使用户能够使用 Pulse 中的 Tableau Agent 探索指标组。Pulse 中的 Tableau Agent 使用统计算法来检查分组指标并显示相关、有趣且值得研究的见解。有关此功能的详细信息，请参见[启用 Pulse 中的 Tableau Agent](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#turn-on-enhanced-qa-discover-in-tableau)。
        
        **注意：**增强型问答 (Discover) 已重命名为 Pulse 中的 Tableau Agent。功能保持不变。只是名称发生了变化。
    - 用于可视化项制作的 Tableau Agent：使用对话式 UI 为您构建可视化项或完成任务：使用户能够在 Tableau Cloud Web 制作和 Tableau Desktop（版本 2025.1 及更高版本）中的 Tableau Agent 的帮助下创建可视化项并创建和理解计算。有关 Tableau Agent 的详细信息，请参见[使用 Tableau Agent 探索您的数据](https://help.tableau.com/current/online/zh-cn/web_author_einstein.htm)。
    - 适用于仪表板使用者的 Tableau Agent（测试版）：提供仪表板摘要和见解，并允许用户使用自然语言提出有关其数据的问题：使仪表板使用者能够快速获得有关其仪表板的概述或见解，以及查询基础数据源以提出有关其数据的问题。仪表板作者可以控制对这些功能的访问，并配置要包括哪些工作表和见解。有关详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_narratives_overview.htm)。您必须首先选择加入测试版才能启用此功能。
        
        **注意**：适用于仪表板使用者的 Tableau Agent 要求用户对他们想要使用 Tableau Agent 的所有工作簿具有“AI 访问”和“完整数据查询”权限能力。“完整数据查询”权限可确保智能体能够访问运行所需的基础数据。有关详细信息，请参见[“权限”](https://help.tableau.com/current/online/zh-cn/permissions.htm#DashboardAgent)。
    - 适用于 Tableau Prep 的 Tableau Agen：建议清理和转换数据的步骤：使用户能够在 Tableau Agent 的帮助下清理数据、创建计算字段和构建流程。Tableau Cloud 的 Tableau Prep Web 制作和 Tableau Prep Builder（版本 2025.2 及更高版本）中提供了此功能。有关 Tableau Prep 中的 Tableau Agent 的详细信息，请参见[使用 Tableau Agent 构建 Tableau Prep 流程](https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm)。
    - Tableau Catalog：草拟资产描述：使用户:能够自动生成数据源、工作簿和表的描述。有关 Tableau Catalog 中的生成式 AI 的详细信息，请参见[管理 Web 内容](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm)。

#### 为组中的用户启用 Tableau 中的 AI

您可以为单个用户组或站点上的所有用户启用 Tableau 中的 AI 功能。目前，此选项可用于适用于可视化项制作的 Tableau Agent 和适用于 Tableau Prep 的 Tableau Agent。若要了解如何 这些 Tableau 中的 AI 功能创建用户组，请参见[创建组并向其中添加用户](https://help.tableau.com/current/online/zh-cn/to_add_users_groups.htm)。

1. 在“Tableau 中的 Ai”下，选择要设置组访问权限的功能的“操作”![“操作”菜单。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_menu_24x13.png) 菜单。
2. 如果该功能未开启，请选择“启用”。
3. 再次选择“操作”![“操作”菜单。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_menu_24x13.png) 菜单，然后选择“选择用户组”。
    
    ![选择“用户组操作”菜单。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_group_menu.png)
4. 在“选择用户组”对话框中，选择单个用户组，然后单击“应用”。只有此用户组中的用户才能访问所选功能区域的 Tableau Agent。所有其他用户也许可以单击 Tableau Agent 图标，但会收到权限错误。
    
    ![“选择用户组”对话框。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_select_user_groups.png)
5. 单击页面顶部的“保存”以保存您的站点设置。

## 使用 Tableau Cloud 新站点试用版启用 Tableau 中的 AI

您可以通过注册 Tableau Cloud 的免费试用版，在新的 Tableau 站点上测试 Tableau 中的 AI。若要开始试用，请[填写注册表单](https://www.tableau.com/zh-cn/products/trial)，或联系您的客户经理。注册后，您将获得新 Tableau Cloud 站点的访问权限。

作为试用用户，系统会为您完成大部分配置。虽然试用期间请求是免费的，但每小时可发出的请求数量可能会受到限制。

Tableau Cloud 新站点试用版包括以下 Tableau 中的 AI 功能。

- Pulse 中的 Tableau Agent。提问时，Tableau Pulse 见解摘要和 Tableau Pulse 语义匹配不需要 Tableau+，因此您不需要试用站点即可启用这些功能。
- Web 制作、Tableau Desktop（版本 2025.1 及更高版本）和 Tableau Prep Builder（版本 2025.2 及更高版本）中的 Tableau Agent 功能
- 适用于仪表板使用者的 Tableau Agent（如果您选择加入测试版）。

使用试用体验时，以下功能和选项不可用：

- Tableau Catalog 中的 Tableau Agent
- 自定义数据屏蔽
- Data Cloud 中的审计跟踪

> [!TIP]
> 
> **提示：**您无法将所有 Tableau 中的 AI 功能的试用版添加到现有 Tableau 站点。但是，您可以在现有站点上试用 Pulse 中的 Tableau Agent。有关详细信息，请参见[在现有站点上试用 Pulse 中的 Tableau Agent](#Try-AI-Discover)。

若要开始使用 Tableau 中的 AI，请完成以下步骤：

1. 以站点管理员身份登录到试用 Tableau Cloud 站点。
2. 选择“设置”。
3. 在“Tableau 中的 AI”部分的“按功能划分的 AI 设置”中，选择“操作”![“操作”菜单](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_site_setting_actions_menu.png) 菜单，然后选择“启用”。
    
    **注意**：对于某些功能，您可以选择为单个用户组或站点上的所有用户启用它。有关详细信息，请参见[为组中的用户启用 Tableau 中的 AI](#AI_user_groups)。
    
    ![Tableau 中的 AI 站点设置页面，您可以在其中为您的试用站点启用 AI 功能。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_admin_trials_262.4.png)
4. 从以下功能中选择：
    
    - Tableau Pulse：总结关键指标见解：便您的用户可以查看他们的个性化见解摘要，并快速概览其指标的重要变化。有关 Tableau Prep 中的生成式 AI 的详细信息，请参见[适用于 Tableau Prep 的 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#tableau-ai-in-tableau-pulse)。
    - Tableau Pulse：使用任何语言提问时都能获得更好的语义匹配：使用户能够在使用 Ask Q&A 以任何语言探索单个指标时获得最佳语义结果。有关此功能的详细信息，请参见[在 Tableau 中为 Ask Q&A 启用更好的语义匹配](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#turn-on-better-semantic-matches-for-ask-qa-in-tableau)。
    - Tableau Pulse：使用 Pulse Discover 对指标和见解组进行深入、综合的探索：使用户能够使用 Pulse 中的 Tableau Agent 探索指标组并发现相关、有趣且值得研究的见解。有关此功能的详细信息，请参见[启用 Pulse 中的 Tableau Agent](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#turn-on-enhanced-qa-discover-in-tableau)。
    - 适用于可视化项制作的 Tableau Agent：使用对话式 UI 为您构建可视化项或完成任务：使用户能够在 Tableau Agent 的帮助下创建可视化项并创建和理解计算。有关 Tableau Cloud Web 制作中 Tableau Agent 的详细信息，请参见[使用 Tableau Agent 探索您的数据](https://help.tableau.com/current/online/zh-cn/web_author_einstein.htm)。
    - 适用于仪表板使用者的 Tableau Agent（测试版）：提供仪表板摘要和见解，并允许用户使用自然语言提出有关其数据的问题：使仪表板使用者能够快速获得有关其仪表板的概述或见解，以及查询基础数据源以提出有关其数据的问题。仪表板作者可以控制对这些功能的访问，并配置要包括哪些工作表和见解。有关详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_narratives_overview.htm)。您必须首先选择加入才能启用此功能。
        
        **注意**：适用于仪表板使用者的 Tableau Agent 要求用户对他们想要使用 Tableau Agent 的所有工作簿具有“AI 访问”和“完整数据查询”权限能力。“完整数据查询”权限可确保智能体能够访问运行所需的基础数据。有关详细信息，请参见[“权限”](https://help.tableau.com/current/online/zh-cn/permissions.htm#DashboardAgent)。
    - 适用于 Tableau Prep 的 Tableau Agent：建议清理和转换数据的步骤：使用户能够使用 Tableau Agent 帮助他们清理数据、创建计算字段和构建流程。Tableau Cloud 的 Tableau Prep Web 制作和 Tableau Prep Builder（版本 2025.2 及更高版本）中提供了此功能。有关 Tableau Prep 中的 Tableau Agent 的详细信息，请参见[使用 Tableau Agent 构建 Tableau Prep 流程](https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm)。
5. 导航到 Tableau 工作簿、仪表板或 Tableau Prep 流程并选择 Tableau Agent ![Tableau Agent 图标。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_desktop_agent_icon.png) 图标，打开 Tableau Agent 窗格并键入请求。在 Tableau Prep Builder 中，用户必须登录到启用了 Tableau 中的 AI 的 Cloud 站点才能看到该图标。

**重要信息**：若要在试用期结束后在生产站点中使用 Tableau 中的 AI，您需要购买 Tableau+，连接到已设置 Einstein 生成式 AI 的 Salesforce 组织，并完成本文中描述的配置步骤。

## 在现有站点上试用 Pulse 中的 Tableau Agent

您可以使用 Try AI 站点设置在现有 Tableau 站点上试用 Pulse 中的 Tableau Agent。此免费试用期为 60 天，仅限于 Pulse 中的 Tableau Agent。若要详细了解，请参见[试用 Pulse 中的 Tableau Agent](https://help.tableau.com/current/online/zh-cn/tableau_gai_trial.htm)。Pulse 中的 Tableau Agent 以前称为增强型问答 (Discover)。

> [!TIP]
> 
> **提示：**针对现有 Tableau 站点的 Try AI 不提供对用于 Web 制作的 Tableau Agent 或仪表板的访问权限。若要试用其他 Tableau 中的 AI 功能，您必须注册 Tableau Cloud 新站点试用版。有关详细信息，请参见[使用 Tableau Cloud 新站点试用版启用 Tableau 中的 AI](#GenAI_trial)。

<!-- document id=e75ddd279f84d7475dd495330560ef6c54e75b07c13eb06d2524043078006259 url=/tableau/next/zh-cn/online/maintenance_startpg.md -->

[跳转到主要内容](#main-content)

# 为所有用户设置默认开始页面

在新站点中，当用户登录到 Tableau Cloud Web 制作环境时，将进入主页屏幕，该屏幕将显示一个基于角色的欢迎横幅。主页还显示最近的视图、收藏夹和网站最近查看的内容。作为管理员，您可以在站点级别更改用户的默认登陆页面。例如，您可以显示所有工作簿，而在用户登录时，他们将看到其有权访问的工作簿。

### 为所有用户设置默认开始页面

1. 显示您希望作为用户在登录到站点时看到的默认页面的页面或筛选视图。
2. 在页面右上方区域选择您的个人资料图标。
3. 若要为站点上的所有用户设置开始页面，请单击“设为开始页面”和“针对此站点上的用户”。

## 用户设置的开始页面和分层结构

用户可以通过其个人资料图标设置自己的开始页面，并可以在其帐户设置中重置自己的开始页面（请参见[访问您的个人资料和帐户设置](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#useracct.htm)）。

如果用户设置了自己的开始页面，则会覆盖该站点的任何开始页面。下次用户登录 Tableau Cloud 时，他们将进入已设置的开始页面。如果用户或管理员都没有设置开始页面，则用户将默认进入主页。

<!-- document id=9bd7d92f96c2b2641749891aae604879928217946b8911f2ebf2b428e0ce6bbc url=/tableau/next/zh-cn/online/projects_data_gov.md -->

[跳转到主要内容](#main-content)

# 为托管自助服务配置项目、组、组集和权限

发布到 Tableau Cloud 和 Tableau Server 非常简单。对于某些组织来说，这可能有点_太_容易了。在让创作者发布自己的内容之前创建一个受控框架是有价值的。

为了保持整洁并确保人们可以找到并访问正确的内容，针对托管自助服务配置您的站点可能会很有用。这意味着要有适当的指导原则和设置，以确保内容是有组织的、可发现的和安全的，并且在发布过程中没有瓶颈。

作为站点管理员，本文为您提供了一种为托管自助服务设置站点的可能途径:

1. 确定您需要的组和项目的类型
2. 创建组和组集
3. 删除会导致歧义的权限并建立默认权限模式
4. 创建项目
5. 锁定项目权限

**注意：**此处提供的信息改编和简化自 Tableau 传道大使及分享其经验的客户的实践。

## 规划您的策略

Tableau 中的权限由应用于组或用户的内容（项目、工作簿等）的规则组成。这些权限规则是通过允许或拒绝特定功能来构建的。

![显示允许和拒绝的各种功能的权限规则界面](/tableau/next/zh-cn/online/zh-cn/Img/perms_permissionrules.png)

无论您是开始新项目还是进行更改，为您的项目、组和权限规则制定一个全面的计划都非常有用。详细信息由您决定，但我们建议针对所有环境使用两种重要做法：

- 管理项目（而不是单段内容）的权限，。
- 为组分配权限，而不是为单个用户分配权限。

如果在单独的用户级别和对单独的内容资产设置权限，将会很快变得难于管理。

### 使用封闭权限模型

用于设置权限的一般模型包括_开放_模型或_封闭_模型。在开放模型中，用户将获得高级别的访问权限，并且您可显式拒绝能力。在封闭模型中，用户只能获得他们完成工作所需的访问权限。这是安全专业人士提倡的模式。本主题中的示例采用封闭模型。

有关如何评估 Tableau 权限的详细信息，请参见[有效权限](https://help.tableau.com/current/server/zh-cn/permission_effective.htm)。

## 确定您需要的项目和组的类型

设计一个结构来容纳内容（在项目中）和用户类别（作为组）或组类别（在组集中）可能是设置站点中最具挑战性的部分，但它使持续管理变得更加容易。

**项目**：项目既可以作为管理权限的单元，也可以作为组织和导航框架。尝试创建一个项目结构，在人们期望找到内容的方式和允许逻辑许可之间取得平衡。

**组或组集**：在创建组之前，找到人们如何与内容交互的共同主题会很有用。尝试确定可用于创建组或组集的模式，并避免单个用户的一次性权限。

示例 1：项目和组结构

例如，让我们想象一个环境，其中存在每个人都应该能够访问的公司范围的内容，以及需要限制的一些 HR 内容。

项目包括：

- **Acme Corp Conference**。此项目将包括用于门票销售的数据源和工作簿、用于内容策略的仪表板，以及用于公司会议的项目计划。
- **Employee Success**。此项目将包括用于内部员工调查的匿名数据源和工作簿
- **Human Resources**。此项目将包括 HR 数据源和工作簿，这些数据源和工作簿应该仅供 HR 团队成员使用。

然后，组应与人们需要做的事情匹配：

- **Core Content Creators**。此组适用于可以发布到顶级项目并具有对数据源的广泛访问权限，但不需要能够移动或以其他方式管理内容的用户。
- **HR Content Creators。**此组适用于有权访问 HR 数据源并可以发布到 HR 项目的用户。
- **业务用户。**此组适用于应该能够访问由 Core Content Creators 创建的内容，但甚至不应该知道 HR 内容存在的用户。
- **HR Users。**此组适用于应该能够访问 HR 项目中的内容但无权创建或发布内容的用户。
- **Core Project Leaders。**此组适用于在非 HR 项目中应获得项目负责人身份的用户。

示例 2：组和组集结构

从 2024 年 6 月 (Tableau 2024.2) 开始，您可以使用组集通过在组集级别启用权限来进一步控制授予（或拒绝授予）用户的能力。当在组集级别设置权限时，用户必须属于要评估的组集内的所有组。

**注意：**组集权限规则在用户和组规则之后进行评估。

例如，假设您已创建组来满足上述示例 1 中用户的需求。您可以创建以下组集来进一步锁定 HR 访问权限：

- **HR Leaders。**该组集由 HR Content Creators 和 Core Project Leaders 组成。只有当该组集中的用户属于这两个组时，他们才会被赋予项目负责人身份、访问敏感 HR 数据源的能力以及向 HR 项目发布信息的能力。

### 考虑站点角色

记住，权限与内容相关，而不是与组或用户相关。这意味着您不能在隔绝的环境中授予组**探索**权限。相反，可以为该组授予项目及其内容的**探索**权限。但是，站点角色会被授予特定用户，并且可以定义或限制他们可以拥有的权限。有关许可证、站点角色和权限如何结合在一起的详细信息，请参见[权限、站点角色和许可证](https://help.tableau.com/current/server/zh-cn/permission_license_siterole.htm)。

## 创建组和组集

虽然一旦确定需要什么就创建组和项目可能很诱人，但按特定顺序完成操作很重要。

**项目**：在正确配置默认项目之前不应创建项目（请参见下一部分）。这是因为顶级项目使用“默认”项目作为其权限规则的模板。

**组**：需要创建组才能用于构建权限规则。无需将用户添加到组中，但可以这样做。有关创建组的详细信息，请参见[创建组并向其中添加用户](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm)。

**组集**：需要创建组才能用于构建权限规则。无需将用户添加到组中，但可以这样做。有关详细信息，请参见[使用组集](https://help.tableau.com/v0.0/online/zh-cn/group_sets.htm)。

> [!TIP]
> 
> **提示**：动创建多个组和项目并设置权限的过程可能有点冗长乏味。为了自动执行这些过程，并且可以为将来的更新重复执行，您可以使用 [REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api.htm) 命令执行这些任务。您可以为诸如添加或删除单个项目或组以及添加用户等任务使用 [tabcmd](https://help.tableau.com/current/server-linux/zh-cn/tabcmd.htm) 命令，但不能为设置权限使用该命令。

### 多个组中的成员资格

可以在 Business Users 组中包括 HR Content Creators 和 HR Users 组中的用户。这样可以轻松地将大多数内容的权限分配给 Core Content Users，而不是 和 Business Users。但是，在这种情况下，如果不拒绝 HR 用户，就无法拒绝 Business Users 组在 Human Resources 文件夹中的任何能力。相反，Business Users 组必须保持未指定状态，并且特定的 HR Content Creators 和 HR Users 组将被赋予其适用的能力。

这是因为 Tableau 权限具有限制性。如果 Business Users 被拒绝某些能力，则“拒绝”将覆盖两个组中用户的“允许另一个权限”规则。

#### 组集的影响

如果在组集级别启用了分配的权限，则不得指定组集中的每个组的权限，也不能拒绝允许该能力。

![组级别权限流程图。](/tableau/next/zh-cn/online/zh-cn/Img/perms_evalflow_basic.png "显示有效权限评估流程的流程图")

在决定如何分配组成员身份时，了解如何评估权限规则非常重要。有关详细信息，请参见[有效权限](https://help.tableau.com/current/server/zh-cn/permission_effective.htm)。

## 删除会导致歧义的权限并建立默认权限模式

每个站点都有一个“所有用户”组和一个“默认”项目。

**“所有用户”组**：添加到站点的任何用户将自动成为“所有用户”组的成员。为避免与在多个组上设置的权限规则混淆，最好从“所有用户”组中移除权限。

**“默认”项目**：“默认”项目充当站点中新项目的模板。所有新的顶级项目都将采用“默认”项目的权限规则。在“默认”项目上建立基线权限模式意味着您将对新项目有一个可预测的起点。（请注意，嵌套项目从其父项目（而不是“默认”项目）继承权限规则。）

移除“默认”项目上“所有用户”组的权限规则

1. 选择“浏览”以查看站点上的顶级项目。
2. 在“默认”项目的“操作”(...) 菜单上，选择“权限”。
3. 在“所有用户”组名称的旁边，选择**“...”**，然后选择“删除规则…”。

这使您可以为您完全控制的组建立权限规则，而不会为“所有用户”分配任何冲突的权限。有关如何评估多个规则以确定有效权限的详细信息，请参见[有效权限](https://help.tableau.com/current/server/zh-cn/permission_effective.htm)。

### 创建权限规则

现在您可以为所有新的顶级项目将继承的“默认”项目设置基本权限模式。您可以选择将“默认”项目的权限规则保留为空，并为每个新的顶级项目单独构建权限。但是，如果有任何权限规则应该应用于大多数项目，则将它们设置在“默认”项目上会很有帮助。

请记住，项目的权限对话框包含每种内容类型的选项卡。**您必须在项目级别为每种类型的内容设置权限，**否则用户将被拒绝访问该内容类型。（只有在明确允许的情况下，才会将能力授予用户。将能力保留为“未指定”将导致该能力被拒绝。有关详细信息，请参见[有效权限](https://help.tableau.com/current/server/zh-cn/permission_effective.htm)。）

提示：每次在项目级别创建权限规则时，请确保查看所有内容类型选项卡。

根据需要创建权限规则：

1. 单击“+添加组/用户规则”并开始键入以搜索组名称。
2. 对于每个选项卡，从下拉列表中选择一个现有权限角色模板，或通过单击能力来创建自定义规则。
3. 完成后，单击“保存”。

有关设置权限的详细信息，请参见[设置权限](https://help.tableau.com/current/server/zh-cn/permissions.htm#set-permissions)。

示例：每种内容类型的项目级别权限

对于我们的示例，大多数项目应该可供大多数人使用。对于默认项目，我们将使用[权限规则模板](https://help.tableau.com/current/server/zh-cn/permissions_capabilities.htm#capabilities)为核心内容创建者授予发布权限，并为其他所有人授予与工作簿交互的能力，仅此而已。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Core Content Creators</td><td style="text-align: center;">发布</td><td style="text-align: center;">发布</td><td style="text-align: center;">发布</td><td style="text-align: center;">视图</td></tr><tr><td style="font-weight: bold;">HR Content Creators</td><td style="text-align: center;">视图</td><td style="text-align: center;">浏览</td><td style="text-align: center;">视图</td><td style="text-align: center;">无</td></tr><tr><td style="font-weight: bold;">Business Users</td><td style="text-align: center;">视图</td><td style="text-align: center;">浏览</td><td style="text-align: center;">视图</td><td style="text-align: center;">无</td></tr><tr><td style="font-weight: bold;">HR Users</td><td style="text-align: center;">视图</td><td style="text-align: center;">浏览</td><td style="text-align: center;">视图</td><td style="text-align: center;">无</td></tr><tr><td style="font-weight: bold;">Core Project Leaders</td><td style="text-align: center;"><a href="https://help.tableau.com/current/server/zh-cn/permissions_projects.htm#set-a-project-leader">设置为项目主管</a></td><td style="text-align: center;">不适用</td><td style="text-align: center;">不适用</td><td style="text-align: center;">不适用</td></tr></tbody></table>

此模式采用封闭模型，并限制大多数用户对大多数内容的基本使用权限。当创建新的顶级项目时，这些规则将默认继承，但可以根据需要修改每个项目的权限规则。请记住，**Human Resources** 项目应该移除这些权限并建立自己的模式。

## 创建项目并调整权限

使用自定义权限模板设置了“默认”项目后，您可以创建其余的项目。对于每个项目，您可以根据情况调整默认权限。

创建一个项目

1. 选择“浏览”以查看站点上的顶级项目。
2. 从“新建”下拉列表中，选择“项目”。
3. 为项目命名，如果需要，为其提供描述。

建立命名约定可能很有用。例如，基本结构可以是 <部门前缀><团队> - <内容用途>；例如“开发运营 - 监控”。

当您将光标悬停在项目缩略图上和“项目详细信息”页面上时，将显示描述。一个好的描述可以帮助用户知道他们在正确的地方。

1. 根据需要[调整权限](https://help.tableau.com/current/server/zh-cn/permissions.htm#set-permissions)。
    1. 打开新项目。
    2. 从“操作”菜单 (...) 中，选择“权限”
    3. 根据需要修改任何权限规则。_记得检查所有内容选项卡_。

## 锁定内容权限

除了权限规则，项目还有内容权限设置。可通过两种方式配置此设置：**“已锁定”**（推荐）或**“可自定义”**。

锁定项目是一种保持一致性并确保项目中的所有内容（按内容类型）具有统一权限的方法。可定制的项目允许授权用户为内容片段设置单独的权限规则。有关详细信息，请参见[锁定内容权限](https://help.tableau.com/current/server/zh-cn/permissions_projects.htm#lock-content-permissions)。

无论内容权限设置如何，都始终会对内容实施权限。

## 可能的项目结构

一些组织发现拥有服务于特定用途的项目很有用。以下是一些示例项目及其预期用途。请注意，这些是示例模板，您应该始终在您的环境中测试配置。

有关每种内容类型的权限规则模板包含哪些能力的信息，请参见[权限能力](https://help.tableau.com/current/server/zh-cn/permissions_capabilities.htm)。

示例：针对特定用途的权限设置

#### 服务器上针对开放式协作共享的工作簿

部门中的任何人都可在其内容仍在开发时将内容发布到开放式协作项目。同事可以在服务器上使用 Web 编辑进行协作。有些人将此方式称为沙盒，有些人称之为暂存，诸如此类。在此项目上，您可以允许 Web 编辑、保存、下载等操作。

在这里，您不仅想要启用协作，而且还想使没有 Tableau Desktop 的人员能够做出贡献并提供反馈。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Data Stewards</td><td>发布</td><td>发布</td><td>发布</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Analysts</td><td>发布</td><td>发布</td><td>浏览</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Business Users</td><td>发布</td><td>发布</td><td>浏览</td><td><i>待定</i></td></tr></tbody></table>

请记住，“发布”模板中的某些能力（例如“覆盖”）可能会被[用户的站点角色阻止](https://help.tableau.com/current/online/zh-cn/permission_license_siterole.htm)，即使他们被允许具有该能力。

**注意**：“_TBD_”表示这些权限规则不容易由场景确定，但是可以根据给定的环境进行设置。

#### 无法编辑的共享报表

当创建工作簿和数据源的人员（分析人员和数据专员）想要将内容提供给业务用户进行查看，并确保其内容不会被“借用”或修改时，他们可以将内容发布到此项目。

对于这种类型的项目，您将要拒绝所有允许编辑或将数据脱离服务器重用的能力。您将允许查看能力。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Data Stewards</td><td>发布</td><td><i>待定</i></td><td>发布</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Analysts</td><td>发布</td><td>发布</td><td>视图</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Business Users</td><td>视图</td><td>视图</td><td>无</td><td>无</td></tr></tbody></table>

#### 供分析人员连接的审核数据源

数据专员将在其中发布满足您的所有数据要求并成为组织“信任来源”的数据源。此项目的项目主管可对这些数据源进行认证，使它们在搜索结果中的排名较高，并包括在推荐的数据源中。

您将允许授权分析人员将其工作簿连接到此项目中的数据源，但不能下载或编辑这些数据源。您将对此项目的“业务用户”组拒绝查看能力，因此这些用户甚至看不到此项目。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Data Stewards</td><td>发布</td><td><i>待定</i></td><td>发布</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Analysts</td><td>视图</td><td>无</td><td>视图</td><td>无</td></tr><tr><td style="font-weight: bold;">Business Users</td><td>无</td><td>无</td><td>无</td><td>无</td></tr></tbody></table>

#### 非活动内容

另一种可行方法是隔离站点管理员的视图一段时间未使用的工作簿和数据源。您可以为内容所有者指定一个时限，超过该时限之后，其内容将被从服务器中移除。

您是执行此操作还是直接从工作项目中删除取决于您的组织。在活动环境中，不要害怕去有意移除未使用的内容。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Data Stewards</td><td>无</td><td>无</td><td>无</td><td>无</td></tr><tr><td style="font-weight: bold;">Analysts</td><td>视图</td><td>视图</td><td><i>待定</i></td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Business Users</td><td>无</td><td>无</td><td>无</td><td>无</td></tr></tbody></table>

#### 工作簿模板的来源

用户可从此项目中进行下载，但不能发布或保存到此项目。在这个项目中，授权发布者或项目主管会提供模板工作簿。内置组织已批准的字体、颜色、图像甚至数据连接的模板可以为作者节省大量时间，并使报表的外观保持一致。

<table class="table--plain" style="width: 100%;"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">组</td><td style="font-weight: bold;">项目</td><td style="font-weight: bold;">工作簿</td><td style="font-weight: bold;">数据源</td><td style="font-weight: bold;">（其他内容）</td></tr><tr><td style="font-weight: bold;">Authorized Author</td><td>发布</td><td>发布</td><td>发布</td><td><i>待定</i></td></tr><tr><td style="font-weight: bold;">Data Stewards</td><td>无</td><td>无</td><td>无</td><td>无</td></tr><tr><td style="font-weight: bold;">Analysts</td><td>视图</td><td><p><i>模板</i>：探索</p><p>+&nbsp;</p><p><i>能力</i>：下载工作簿/保存副本</p></td><td>视图</td><td>无</td></tr><tr><td style="font-weight: bold;">Business Users</td><td>无</td><td>无</td><td>无</td><td>无</td></tr></tbody></table>

## 后续步骤

除了项目、组和权限外，其他数据监管主题包括：

**用户培训** 

帮助_所有_ Tableau 用户成为出色的数据专员。最成功的 Tableau 组织都会创建 Tableau 用户组、定期组织培训课程，诸如此类。

请参见[基于仪表板的自定义门户](https://help.tableau.com/v0.0/online/zh-cn/portal_dashboard.htm)，了解一种使用户面向站点的常见方法。

有关发布和数据认证技巧，请参见以下主题：

- [使用认证来帮助用户查找受信任的数据](https://help.tableau.com/v0.0/online/zh-cn/datasource_certified.htm)
- [准备发布工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_prepare.htm "获取发布工作簿的技巧")（Tableau 帮助链接）
- [发布的数据源的最佳做法](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources_about.htm)（Tableau 帮助链接）

**优化数据提取刷新和订阅活动**

如果您使用 Tableau Server，请为数据提取刷新和订阅计划创建策略，避免它们独占站点的资源。Wells Fargo 和 Sprint 编写的 TC 客户演示文稿详细阐述了此主题。此外，请参见[性能调整](https://help.tableau.com/current/server/zh-cn/perf_tuning.htm)下的主题。

如果您使用 Tableau Cloud，请参见下面的主题，熟悉用户刷新数据提取的可能方式：

- [使数据保持最新](https://help.tableau.com/current/online/zh-cn/to_keep_data_fresh.htm)
- [使用 Tableau Bridge 扩展数据新鲜度选项](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)

**监视**

使用管理视图来监视站点的性能和内容使用。

[管理视图](https://help.tableau.com/current/online/zh-cn/adminview.htm)

<!-- document id=6b89a0258ddaba5aad4ea1b4c69440347feb14b65a21ac4f0d895d8398c2c5bc url=/tableau/next/zh-cn/online/to_external_kms_extracts.md -->

[跳转到主要内容](#main-content)

# 为数据提取加密密钥使用外部 KMS

您可以将用于加密和解密数据提取的主密钥存储在外部密钥管理系统 (KMS) 中。通过提供对加密密钥的直接控制，使用外部 KMS 可以帮助组织增强安全状况、满足法规要求并维护数据主权。

有关使用外部 KMS 进行密钥管理的优势的一般信息，请参见[使用外部 KMS 进行密钥管理](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm)。

注意：如果您拥有 Tableau +、Tableau Enterprise 或 Advanced Management，则从 Tableau Cloud 2026 年 2 月版开始提供用于数据提取加密的外部 KMS 功能。如果在某个时候您不再拥有 Tableau +、Tableau Enterprise 或 Advanced Management，您仍可正常使用加密对象，但将无法管理密钥。

## 设置概述

将 AWS KMS 与 Tableau 结合使用的摘要级步骤包括：

1. **AWS KMS**：[创建客户主密钥](#Create) (CMK)。
2. **Tableau Cloud**：[启用数据提取加密](#Enable)（或从使用 Salesforce KMS 的客户管理的加密密钥迁移）。
3. **Tableau Cloud**：[在 Tableau 中生成密钥](#Generate)，使用 AWS KMS 中的客户主密钥 ARN。
4. **AWS KMS**：[将 Tableau 密钥策略](#Policy) JSON 添加到 AWS 客户主密钥的策略中。
5. **Tableau Cloud**：[激活密钥](#Activate)。

### 密钥状态

使用外部 KMS 时，Tableau Cloud 中用于数据提取加密的密钥具有以下状态和功能：

- **待定** — 您生成了密钥，但尚未使用。在激活密钥之前，它不能用于写入或读取任何数据提取。
- **活动** — 密钥用于写入数据提取，以及读取它写入的数据提取。
- **已存档** — 该密钥过去处于活动状态，但已被后来的密钥取代。它不是用于写入数据提取，而是用于读取它写入的数据提取。
- **已停用** — 密钥过去处于活动状态，后来已归档，并且此后已停用。它未用于读取或写入任何数据提取。

#### 状态快速参考

| 密钥状态 | 可以写入/加密数据提取 | 可以读取/解密数据提取 |
| --- | --- | --- |
| 待定 |   |   |
| 活动 | ✓ | ✓ |
| 已存档 |   | ✓ |
| 已停用 |   |   |

## 设置详细信息

配置时先进行以下操作：

1. 登录到您的 Tableau Cloud 站点。
2. 在左侧导航窗格中选择“设置”。
3. 选择“安全”选项卡。

### 1.在 AWS KMS 中创建主密钥

Tableau 用于加密的密钥基于 [AWS KMS](https://console.aws.amazon.com/kms/) 中存在的客户主密钥 (CMK)。因此，在 Tableau 生成密钥之前，您需要在 AWS KMS 中拥有 CMK。

Tableau 密钥生成对话框包含指向 [AWS KMS](https://console.aws.amazon.com/kms/) 的链接，以便您可以创建 CMK 或获取有关现有 CMK 的信息。如果您在 AWS KMS 中需要有关密钥的帮助，请咨询您当地的密钥专家。

AWS 密钥由 Amazon 资源名称 (ARN) 唯一标识。系统要求您在 Tableau 密钥生成过程中提供 CMK ARN。密钥 ARN 的格式如下：

`arn:aws:kms:us-east-2:123456789012:key/12345678-90ab-cdef-1234-567890abcdef`

在 AWS 中创建客户主密钥后，您可以在 Tableau Cloud 中启用数据提取加密。

### 2.使用外部 KMS 启用数据提取加密

注意：启用加密后，您将无法将其禁用。同样，从客户管理的加密密钥（使用 Salesforce KMS）切换到外部 KMS 是永久性的，无法撤消。

启用外部 KMS：

1. 在“数据提取加密”部分下，选择“加密数据提取”。
2. 选择“使用外部 KMS”。
    - 如果已选择“使用 Salesforce KMS”，则您当前正在通过 Salesforce KMS 使用客户管理的加密密钥。(有关详细信息，请参见[客户管理的加密密钥](https://help.tableau.com/v0.0/online/zh-cn/to_customer_managed_encryption_keys.htm)。)将设置更改为“使用外部 KMS”将不可逆转地从 Salesforce KMS 更改为外部 KMS。在更改 KMS 之前，请参见[“从客户管理的加密密钥迁移到外部 KMS”](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms_migrate.htm)。
3. 选择“生成密钥”。
    - 如果您要从 Salesforce KMS 迁移到外部 KMS，请阅读警告，然后选择“切换到外部 KMS”。

### 3.生成密钥

生成密钥是读写加密数据提取的第一个步骤。如果您已经有一个活动密钥，则可以生成另一个密钥，作为替换当前活动密钥的第一步。

在 Tableau 中生成密钥：

1. 在“数据提取加密”部分下，选择“生成密钥”。
2. 如果您要为站点生成第一个密钥，您将看到“配置 AWS KMS”对话框。如果您已有活动密钥，请首先继续完成“生成密钥”确认对话框。
3. 选择“启动 AWS KMS”并在需要时登录。
4. 在 AWS KMS 中，创建新密钥或查找现有密钥，然后复制密钥 ARN。如果您在 AWS KMS 中需要有关密钥的帮助，请咨询您当地的密钥专家。
5. 返回到 Tableau 的“配置 AWS KMS”对话框，并将密钥 ARN 粘贴到“来自 AWS 的密钥”字段中。
6. （可选）输入“描述”。
7. 选择“下一步”（或者，如果这是站点的第一个密钥，则选择“启用加密”）。
8. 选择“完成”以稍后将密钥策略 JSON 添加到 AWS KMS，或按照[“将密钥策略 JSON 添加到 KMS 密钥策略”](#Policy)立即执行此操作。

在将密钥策略 JSON 添加到 AWS KMS 策略然后激活它之前，该密钥不能用于读取或写入数据提取。

### 4.将密钥策略 JSON 添加到 KMS 密钥策略

新生成的密钥的状态为“待定”。在将密钥策略 JSON 添加到 AWS KMS 策略然后激活它之前，它不能用于读取或写入数据提取。

若要查看密钥策略 JSON，请从[“生成密钥”](#Generate)过程继续。

或者，如果您_未_从该过程继续：

1. 在“数据提取加密”部分下，选择相应“待定”密钥旁边的操作菜单 (...)。
2. 选择“密钥策略”。

若要将密钥策略 JSON 添加到 AWS KMS 策略，请将相关 `Statement` 对象从 Tableau 复制到 AWS KMS 中的策略 JSON。您只需要完整 JSON 文本的一部分。请记住，选择“复制密钥策略”并在文本编辑器中粘贴和编辑可能会更容易。

从 JSON 文本中，复制 `Statement` 数组中的对象。然后，在 AWS KMS 密钥的策略中，按照标准 JSON 语法将复制的文本添加到 `Statement` 数组中。（在添加新的 JSON 之前，您可能需要在现有 AWS KMS 的 `Statement` 的末尾添加一个逗号。）

示例：

突出显示的部分是要添加到 AWS KMS 策略中的部分：

```
{
    "Version": "2012-10-17",
    "Id": "sfdc-key-access-policy",
    "Statement": [{
            "Sid": "AllowSalesforceShieldKeyBroker1234567890abc",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:sts::123456789abc:assumed-role/EkmAwsKmsAccessRole/1234567890abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ12"
            },
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "kms:EncryptionContext:sf-auth": "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQ"
                }
            }
        }]
}
```

### 5.激活密钥

激活密钥以使用它来读取和写入新数据提取。“激活密钥”操作仅适用于“待定”密钥。

1. 在“数据提取加密”部分下，选择相应“待定”密钥旁边的操作菜单 (...)。
2. 选择“激活密钥...”。

如果您已经拥有活动密钥，则激活新密钥会将现有密钥的状态更改为“已存档”。存档的密钥仅用于读取它写入的数据提取。新密钥将变为“活动”状态，并将用于写入新数据提取以及读取它写入的数据提取。

注意：在站点上启用加密并激活第一个密钥后，Tableau Cloud 会为站点上的每个数据提取创建一个数据提取加密后台作业。这些作业被设置为最低优先级，这意味着它们仅在有额外资源时运行。现有数据提取刷新作业在数据提取加密之前运行。

## 其他操作

### 将密钥存档

存档的密钥可以读取它们写入的数据提取，但不用于写入新的数据提取。将密钥存档的唯一方法是激活新密钥。请参见[“激活密钥”](#Activate)。

### 停用密钥

停用存档的密钥，使其无法用于读取或写入任何数据提取。如果密钥已泄露，您可能会执行此操作。“停用密钥”操作仅适用于“已存档”的密钥。

停用密钥时，它不能用于读取它写入的数据提取（与已存档密钥相反，已存档密钥可以读取它写入的数据提取）。这意味着，如果没有使用活动密钥进行加密，某些基于数据提取的内容可能会停止工作。如果需要保留对使用旧密钥的基于数据提取的内容的访问权限，请确保在停用旧密钥之前使用活动密钥刷新数据提取。

注意：如有必要，您可以恢复已停用的密钥。恢复密钥会将其从“已停用”更改为“已存档”。请参见[“恢复密钥”](#Restore)。

停用密钥：

1. 在“数据提取加密”部分下，选择相应“已存档”密钥旁边的操作 (...)。
2. 选择“停用密钥...”。
3. 在文本字段中输入“停用此密钥”以确认您的操作。
4. 选择“停用密钥”。

### 恢复密钥

恢复停用的密钥，使其可用于读取它写入的数据提取。“恢复密钥”操作仅适用于“已停用” 密钥，并将其更改为“已存档”。

将密钥恢复到已存档状态时，它不会用于写入任何数据提取。它仅用于读取它写入的数据提取。

1. 登录到您的 Tableau Cloud 站点。
2. 在左侧导航窗格中选择“设置”。
3. 选择“安全”选项卡。
4. 在“数据提取加密”部分下，选择相应的“已停用”密钥旁边的操作菜单 (...)。
5. 选择“恢复密钥...”。
6. 选择“恢复密钥”。

### 删除密钥

您无法删除数据提取加密密钥。密钥只能存档（保留读取它写入的内容的能力）或停用（既不能读取也不能写入）。请参见[密钥状态](#Key)。

注意：如果您在 AWS KMS 中禁用客户主密钥 (CMK)，则从其派生的 Tableau 密钥将停止进行加密或解密。同样，如果您从 AWS KMS 中的 CMK 策略中移除 Tableau 生成的子句，则从其派生的 Tableau 密钥将停止工作。

### 查看密钥策略

“密钥策略”对话框显示用于添加到 AWS KMS 密钥策略的密钥策略 JSON。密钥策略 JSON 可以在[“生成密钥”](#Generate)过程中或之后添加。

有关详细信息，请参见[“将密钥策略 JSON 添加到 KMS 密钥策略”](#Policy)。

查看密钥的策略 JSON：

1. 在“数据提取加密”部分下，选择相应密钥旁边的操作菜单 (...)。
2. 选择“密钥策略”。

### 查看密钥历史记录

密钥历史记录表的每一行显示一个事件、事件后的密钥状态以及事件的日期和时间。

查看密钥的历史记录：

1. 在“数据提取加密”部分下，选择相应密钥旁边的操作菜单 (...)。
2. 选择“密钥历史记录”。

### 测试配置

对待定密钥使用“测试配置”操作来确定是否可以激活该密钥。对处于其他状态的密钥使用“测试配置”操作来显示它们是正常工作、应该工作还是无法工作。

测试密钥的配置：

1. 在“数据提取加密”部分下，选择相应密钥旁边的操作菜单 (...)。
2. 选择“测试配置...”。

**成功：**

- 密钥可用于对数据提取进行加密。如果密钥处于待定状态，则可以安全激活。如果密钥已经激活，则说明它正在正常工作。

**错误：**

- POLICY\_DENIED — 外部 KMS 没有允许此密钥的策略。确认您已将策略从此密钥复制到外部 KMS。
- KEY\_NOT\_FOUND — 找不到密钥，或者密钥已在 Tableau 中停用。确认 AWS KMS 密钥 ARN 和策略。
- UNKNOWN — 发生未知错误。请确保该密钥未在 AWS KMS 中禁用，然后重试。

注意：如果您在 AWS KMS 中禁用客户主密钥 (CMK)，则从其派生的 Tableau 密钥将停止进行加密或解密。同样，如果您从 AWS KMS 中的 CMK 策略中移除 Tableau 生成的子句，则从其派生的 Tableau 密钥将停止工作。

<!-- document id=ff425e2ffbf7b361f74f5d401b2605278080edd0978320887934aae8f6939396 url=/tableau/next/zh-cn/online/tz_for_extracts.md -->

[跳转到主要内容](#main-content)

# 更改时间设置

使用 Tableau Cloud 时，您可能要进行一些与时间相关的配置。

## 为数据提取设置站点时区

站点中基于数据提取的数据源的默认时区是协调世界时 (UTC)。站点管理员可以设置其他时区。

若要为数据提取设置站点时区，请执行以下操作：

1. 以管理员身份登录到 Tableau。
2. 在要配置的站点上，单击“`Settings`”。
3. 在“`Site Time Zone for Extracts`”部分，选择一个时区，然后单击“`Save`”。

在计算字段中，诸如 NOW() 或 TODAY() 等函数将查看时区。有关数据提取的详细信息，请参见 Tableau Desktop 帮助中的[提取数据](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm)。

时区设置除了用于基于数据提取的数据源外，还会影响内部数据提取。例如，当 Tableau 连接到基于文件的数据源（如文本文件）时，则会自动在内部创建一个数据提取。同样，在 Tableau 使用内部数据提取集成来自不同来源的数据时也会发生这种情况。

时区设置还会影响相对日期筛选器标题的呈现方式。

**注意：**在浏览器中查看工作簿时，相对日期筛选器标题（例如“最近 7 天”）会使用您的本地时区显示。但是，导出的文件（“下载”>“图像”或“下载”> PDF）在 Tableau Cloud pod 上呈现，使用 pod 的时区。这可能会导致导出的筛选器标题与您的浏览器视图最多相差一天。这只会影响标题文本，并且您的基础数据将保持准确。若要在浏览器和导出的视图中保持一致的标题，请改用包含固定开始和结束日期的**“日期范围”**筛选器。

## 将您的计算机时钟与 UTC 同步

Tableau Cloud 站点中显示的时间戳采用站点部署到的 pod 的协调世界时 (UTC)。为确保您的计算机上的时间与您的站点使用的时间相匹配，您可以使用以下建议之一将计算机的系统时钟与 UTC 同步：

- 如果您的计算机部署在 Amazon Web Services (AWS) 上，您可以使用网络时间协议 (NTP) 源同步计算机的系统时钟，如 AWS 网站上的[使时间与 Amazon 时间同步服务保持一致](https://aws.amazon.com/blogs/aws/keeping-time-with-amazon-time-sync-service/)博客文章中所述。
- 如果您的计算机部署在 AWS 之外，您可以使用美国国家标准与技术研究院 (NIST) 时间服务器之一同步计算机的系统时钟，如 NIST 网站上的[使用操作系统内置的工具通过 Internet 设置计算机时钟](https://www.nist.gov/pml/time-and-frequency-division/time-distribution/internet-time-service-its)页面中所述。

<!-- document id=e0c2db245e7bf573664f03c752370851e4b04b6c4c61adfbde11a9b73fad5deb url=/tableau/next/zh-cn/online/data_freshness_policy.md -->

[跳转到主要内容](#main-content)

# 为查询缓存设置数据新鲜度策略

## 了解查询缓存的数据新鲜度

您已经建立了自己的工作簿，您的团队很喜欢它。但有时人们需要单击“刷新”按钮才能在可视化项中显示最新数据。您使用实时连接构建了工作簿，那么为什么需要刷新数据？答案是性能。

为了提高性能，Tableau 会缓存用于获取数据的查询结果，以便后续访问可以更快地重用和返回缓存的数据。您可以单击“刷新”按钮来检索更新的数据，但这会增加潜在的性能成本。

若要平衡数据性能和新鲜度，请为您的工作簿设置数据新鲜度策略。在设置数据新鲜度策略时，您的数据会在指定的时间刷新。Tableau 不会对不符合您设置的新鲜度策略的缓存数据进行可视化。

## 选择最适合您的工作簿的方式

有些人可能不希望缓存以便始终拥有最新的数据，而其他人可能希望有大缓存以减少开销并提高工作簿性能。设置数据新鲜度策略的第一步是决定什么适合您的业务。

默认情况下，Tableau Cloud 每 12 小时刷新一次缓存数据，工作簿所有者可以在工作簿级别设置数据新鲜度策略。

在 Tableau Server 中，服务器管理员可以[为服务器上的所有站点设置默认缓存策略](https://help.tableau.com/current/server/zh-cn/config_cache.htm)，工作簿所有者可以在工作簿级别设置数据新鲜度策略。

**注意：**数据新鲜度策略在 Tableau Desktop 或使用数据提取或基于文件的数据源的工作簿中不可用。

## 编辑工作簿数据新鲜度策略

若要编辑工作簿数据新鲜度策略，您必须是工作簿所有者，并且工作簿必须与数据源建立实时连接。

1. 登录到 Tableau Cloud 或 Tableau Server 上的站点。
2. 从“主页”或“浏览”页面，导航到要为其设置策略的工作簿。
3. 使用三点（更多选项）图标打开菜单。
4. 选择“编辑数据新鲜度策略…”。
5. 选择以下选项之一：  
    站点默认值（12 小时）  
    始终为实时（Tableau 将始终获取最新数据）  
    确保数据保持最新的间隔  
    确保数据保持最新的时间
6. 选择“确定”。

“站点默认值”每 12 小时刷新一次您的数据，如果您的受众定期使用您的仪表板，这是一个很好的选择，但不需要最新的数据新鲜度。

“始终为实时”始终提供最新鲜的数据，这会增加加载时间。

“确保数据保持最新的间隔”……允许您以分钟、小时、天或周的粒度指定刷新数据的频率。

“确保数据保持最新的时间”... 允许您计划数据刷新的时间和日期。如果您在每周一、周三和周五的太平洋时间上午 09:00 召开重要会议，那么您可以将数据刷新设置为每周一、周三和周五的上午 08:45 进行，这样您就可以在会议开始时获得最新鲜的数据。

<!-- document id=e395633aea1d36863220d9438ff1eae9c928c14c16588c71d7ed95f8b0c8df80 url=/tableau/next/zh-cn/online/explain_data_enable.md -->

[跳转到主要内容](#main-content)

# 为站点禁用或启用“数据解释”功能

默认情况下已为站点启用“数据解释”功能，但 Tableau 管理员可能会禁用它。

1. 转到“常规”站点设置。
2. （仅限 Tableau Server）在“Web 制作”部分，选择“允许用户在其浏览器中编辑工作簿”。
3. 在“‘数据解释’功能的可用性”部分，从以下选项中进行选择：
    
    - “启用”允许具有适当权限的 Creator 和 Explorer 在编辑模式下运行“数据解释”功能。针对查看模式启动时，让所有具有适当权限的用户运行“数据解释”功能。
    - “禁用”可防止所有用户运行“数据解释”功能或访问工作簿中的“数据解释”功能设置。
4. 在 Tableau Cloud 和 Tableau Server 2023.3 及更高版本中，若要使用‘数据解释’功能：
    
    - 在“数据指南的可用性”部分，选择“显示”。有关数据指南的详细信息，请参见[使用数据指南浏览仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_guide.htm)。

<!-- document id=cface0b70a227407305ac164b9442e3e1492d706736946bf19778650d6cbe4f3 url=/tableau/next/zh-cn/online/ask_data_enable.md -->

[跳转到主要内容](#main-content)

# 为站点禁用或启用“数据问答”(Ask Data) 功能

**“数据问答”(Ask Data) 功能和指标的重要变化**

Tableau 的“数据问答”(Ask Data) 和指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见 [Tableau AI 和 Tableau Pulse 如何重新构想数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-gpt)。

默认情况下已为站点启用“数据问答”(Ask Data) 功能，但 Tableau 管理员可能会禁用它。

1. 转到“常规”站点设置。
2. （仅限 Tableau Server）在“Web 制作”部分，选择“允许用户在其浏览器中编辑工作簿”。
3. 在“‘数据问答’（Ask Data）功能的可用性”部分，从以下选项中进行选择：
    
    - “已启用”将为所有已发布的数据源创建“数据问答”(Ask Data) 功能镜头。
    - “已禁用”会在整个站点中隐藏“数据问答”(Ask Data) 功能，同时保留有关以前创建的镜头的信息，以便在重新启用“数据问答”(Ask Data) 功能的情况下可以将其还原。

<!-- document id=33d5ea0e19bf034a3aa227b0f50be5e5b93dd3419c1ccaa88f78cc4b7763a5b4 url=/tableau/next/zh-cn/online/dm_vconn_extract.md -->

[跳转到主要内容](#main-content)

# 为虚拟连接计划数据提取刷新

虚拟连接的好处之一是您可以多次重用同一个数据提取，从而减少数据扩散并移除冗余数据提取刷新作业。为确保使用虚拟连接的任何内容的数据提取数据都是最新的，您可以在发布连接后为连接中的表创建数据提取刷新计划。

您还可以计划使用虚拟连接的数据源和工作簿的数据提取刷新。请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/current/online/zh-cn/schedule_add.htm)和[按计划刷新数据](https://help.tableau.com/current/server/zh-cn/schedule_add.htm) (Tableau Server)。

## 数据提取表

请参见[提取表数据](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_conn.htm#vconn_extract_table_data)。

## 在 Tableau Cloud 上计划数据提取刷新

1. 导航到虚拟连接页面。（从主页或“浏览”页面的下拉菜单中单击“虚拟连接”，然后选择您的虚拟连接。）
2. 在页面顶部，标题应该显示“数据为数据提取”。如果显示“数据为实时”，请刷新您的浏览器。
3. 选择“计划任务”选项卡，然后单击“+新建任务”。
4. “创建计划任务”对话框将打开。Tableau Server 和 Tableau Cloud 中的“创建计划任务”对话框看起来有所不同。如果您使用 Tableau Server，请参见 Tableau Server 产品帮助中的[为虚拟连接计划数据提取刷新](https://help.tableau.com/current/server/zh-cn/dm_vconn_extract.htm#schedule-extract-refreshes-on-tableau-server)。
5. 使用“重复”、“间隔”和“于”下拉列表选择刷新频率。使用“于”下的按钮选择一周中的某几天。
6. 对于多个表使用数据提取的情况，请选择“从属”或“独立”。
    - “从属”意味着如果一个或多个表的数据提取刷新作业失败，则不会更新任何数据提取。
    - “独立”意味着一个表的数据提取作业的成功或失败不会影响其他表的数据提取是否更新。
7. 选择“刷新类型”。您可以在虚拟连接编辑器中配置数据提取的类型。有关详细信息，请参见[“创建虚拟连接”页面](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm#incremental-extract)的“增量数据提取”部分。
    - “完整”意味着完整的提取刷新作业将在虚拟连接中的所有数据提取上运行，无论它们是配置为完整数据提取刷新还是增量数据提取刷新。
    - “增量”意味着增量数据提取刷新作业将在虚拟连接中的所有增量数据提取上运行。对于虚拟连接中的所有其他数据提取，将运行完整数据提取刷新作业。
8. 选择“添加或编辑表”以选择要刷新的表。
9. 选择“确定”。
10. 选择“应用”。
![](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_online_extract_sched.png)

连接到私有网络数据的虚拟连接使用 Bridge 来使数据保持最新。有关详细信息，请参见[“配置和管理 Bridge 客户端池”](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。

## 数据提取刷新的时间限制

为了确保长时间运行的刷新任务不会占用所有系统资源，并且不会阻止站点上其他数据提取的刷新，虚拟连接的数据提取刷新有两个小时的时间限制。有关刷新任务的超时限制以及解决这些错误的建议的详细信息，请参见[数据提取刷新的时间限制](https://help.tableau.com/current/online/zh-cn/schedule_add.htm#timeout)。注意：从 Tableau Cloud 2024 年 6 月版和 Tableau Server 2024.2 开始，虚拟连接支持表数据提取的增量刷新。在该版本之前，虚拟连接仅支持完全刷新。

## 谁可以执行此操作

若要发布虚拟连接或设置权限，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

## 后续步骤

为虚拟连接计划数据提取刷新后，您可以[使用虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_use.htm)

<!-- document id=1eb6096befe6ea8aa0c3b2db5ec96d1066765bc239a0bfc458d57954f02f9b8d url=/tableau/next/zh-cn/online/dm_vconn_create_rlspolicy.md -->

[跳转到主要内容](#main-content)

# 为行级安全性创建数据策略

使用数据策略将行级安全性应用于虚拟连接中的一个或多个表。数据策略筛选数据，确保用户只看到他们应该看到的数据。数据策略适用于实时连接和数据提取连接。

## 关于数据策略

数据策略有三个主要组成部分：

![虚拟连接编辑器中数据策略的三个组成部分的示例](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_policy_components.png)

1. 应用该策略的表称为策略表。这些表是经过筛选的表。
2. 定义表之间（例如，权利表和事实表之间）以及表列和策略列之间关系的映射字段。策略列是用于筛选数据的列。
3. 策略条件，它是在查询时针对每一行进行计算的表达式或计算。如果策略条件为 TRUE，则该行将显示在查询中。

创建数据策略时，您需要一个可用于筛选数据的列。此列称为策略列。数据由策略条件筛选，通常使用用户函数，例如 USERNAME() 或 FULLNAME()。

如果您的策略表包含您可以筛选的列，则将该列用作策略列。

如果策略表不包含此类列，请使用包含可用于筛选数据的列的权利表。权利表是一个表，其中包含可用于筛选滤策略表的策略列和可关联（映射）到策略表中的列的另一列（如上面的数据策略示例图像所示）。

## 使用策略表中的策略列进行筛选

筛选数据的最常见方法是使用表中包含要筛选的数据的列。将该列用作策略列，然后将适当的表列映射到策略列。

若要使用策略列筛选数据，首先，从左窗格向策略添加表。若要添加表，请执行以下操作之一：

- 双击表名称。
- 单击表名称附近的下拉箭头，并选择“使用策略管理表”。
- 或者，将该表拖到右侧并将其放在“添加为策略表”上。

将表添加到策略后，盾牌图标 ![数据策略图标](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_shield_18.png) 将出现在左侧窗格中表名的右侧，表明它是一个策略表。

接下来，映射列以在表中的列名和策略列名称之间创建关系。使用数据策略条件中的策略列名称来控制用户的行级数据访问权限：

1. 单击“+添加要映射的列”添加将用于筛选数据的一列或多列。
2. 为策略列命名。您将在策略条件中使用此名称。
3. 对于策略适用的每个表，使用下拉菜单选择映射到策略列的表列。
4. 为要在策略条件中使用的尽可能多的策略列重复此过程。

Your browser does not support the video tag.

> [!TIP]
> 
> **提示：**您可以不使用“+添加要映射的列”按钮，而是开始在策略条件区域中键入计算并使用自动完成功能来选择列名称，该名称随后将填充步骤 1 下的策略列信息。

Your browser does not support the video tag.

### 使用策略表中的策略列的示例

![使用策略表中的策略列筛选数据的数据策略示意图](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_policy_table_diagram.png)

1. “Sales”（销售额）表有一个“\[Salesperson\]”（销售人员）列，“Region”（区域）表有一个“\[SalesRep\]”（销售代表）列。“Salesperson”（销售人员）和“SalesRep”（销售代理）数据与您站点上的 Tableau 用户的全名相匹配。
2. 您希望按“Salesperson”（销售人员）筛选“Sales”（销售额）和“Region”（区域）数据，因此将策略列命名为“Salesperson”（销售人员），然后将“Sales”（销售额）中的“Salesperson”（销售人员）列和“Region”（区域）中“SalesRep”列映射到“Salesperson”（销售人员）策略列。
3. 然后编写策略条件来筛选两个表。使用“\[Salesperson\]”（销售人员）策略列和 FULLNAME() 用户函数，以便每个用户只能看到自己的数据。

## 使用权利表中的策略列进行筛选

当策略表不包含您可以筛选的列时，将使用权利表。您可以使用权利表将数据表中的列映射到权利表中的列。注意以下各项：

- 确保包括权利表作为虚拟连接中的一个表。您可以将来自任何连接或数据库的表用作中央权利表，以保护许多其他数据库中的表。在某些情况下，与您要保护的表位于同一数据库中的权利表可能存在潜在的安全风险，因为它可能会泄露员工数据。在不同的数据库中拥有一个权利表可以更容易地控制权限，例如，授予某人访问数据库的权限。
- 如果您不希望虚拟连接用户看到授权表，您可以切换“表”选项卡上“可见性”列中的设置以隐藏它。隐藏后，权利表仍可用于策略筛选，但不能在可视化项或工作簿数据源中使用。

**注意**：权利表不支持直接连接到流程输出（.hyper 文件）。流程输出必须直接写入数据库。

使用权利表筛选数据：

1. 首添加要应用数据策略的数据表。执行以下操作之一：
    - 双击表名称。
    - 单击表名称附近的下拉箭头，并选择“使用策略管理表”。
    - 或者，将该表拖到右侧并将其放在“添加为策略表”上。
2. 将表添加到策略后，盾牌图标 ![数据策略图标](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_shield_18.png) 将出现在左侧窗格中表名的右侧，表明它是一个策略表。
3. 选择权利表，然后：
    - 单击下拉箭头，并选择“用作权利表”表。
    - 或者，将该表拖到右侧并将其放在“添加为权利表”上。
4. 对于策略应用到的每个表，单击下拉菜单并选择列以将策略表映射到权利表。
    
    Your browser does not support the video tag.

### 使用权利表中的策略列的示例

![使用权利表中的策略列筛选数据的数据策略示意图](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_entitlement_diagram.png)

1. 您要筛选的数据具有“EMP\_ID”列，但没有员工姓名列。但是，您有另一个表，其中包含“EMP\_ID”和员工的“FULL NAME”（全名）列。并且，员工“FULL NAME”（全名）列中的值与您站点上 Tableau 用户的全名相匹配。
2. 您可以将“Employees”（员工）表作为权利表添加到策略中，然后将策略表列名称“EMP\_ID”映射到每个表的权利列名称“EMP\_ID”。
3. 然后在您的策略条件中使用 FULLNAME() 函数将 Tableau Server 用户的全名与权利表的“\[FULL NAME\]”（全名）列（即策略列）匹配，以便每个用户只能看到他们自己的数据。

## 编写策略条件

创建数据策略的最后一步是编写策略条件，它是用于定义行级访问权限的计算或表达式。策略条件通常用于通过用户函数限制对用户或组的访问。

一个策略条件：

- 在数据策略中是必需的。
- 评估结果必须为真或假。
- 当策略条件为真时显示行。

当您关闭策略选项卡时，它不会放弃您的工作。

### 策略条件示例

仅显示“Region”（区域）列值为“North”（北部）的行：

`[Region] = "North"`

使登录用户能够查看用户名与“EmployeeName”（员工姓名）中的值匹配的行：

`FULLNAME() = [EmployeeName]`

使“Managers”（经理）组的成员能够查看所有行，而用户只能看到其用户名与“employee\_name”（员工姓名）列中的值匹配的行：

`ISMEMBEROF('Managers') OR USERNAME() = [employee_name]`

### 策略条件中支持的 Tableau 函数

策略条件支持 Tableau 函数的子集：

- 逻辑（与 null 相关的除外）
- 字符串
- 用户
- 日期
- 数字：MIN、MID、MAX

若要查看支持哪些特定函数，请在虚拟连接编辑器中的“数据策略”选项卡上，查看右侧的“参考”面板。

**注意**：如果虚拟连接具有包含[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm)（例如，`USERNAME()`）的数据策略，并且您从工作簿或数据源连接到它并在那里创建数据提取，则数据提取将仅包含与创建数据提取时的虚拟连接数据策略匹配的行。若要利用数据策略中包含用户函数的虚拟连接，请使用从工作簿或数据源到虚拟连接的实时连接，而不是数据提取。

## 谁可以执行此操作

若要创建数据策略，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

## 后续步骤

创建数据策略后，下一步是验证它是否按预期方式工作。请参见[使用“以用户身份预览”测试行级安全性](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_test_preview.htm)。或者，如果您准备与他人共享虚拟连接及其数据策略，请参见[发布虚拟连接并设置权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_publish_save.htm)。

## 资源

有关计算的详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[了解 Tableau 中的计算](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields_understand.htm)。

有关用户函数的详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm)。

有关 Tableau 中其他行级别安全性选项的信息，请参见 Tableau Server 帮助中的 [Tableau 中的行级安全性选项概述](https://help.tableau.com/current/server/zh-cn/rls_options_overview.htm)。

<!-- document id=1794add1c3d1687c7525dbffb6c1440bc28abe364a7ace7e800742e692e97025 url=/tableau/next/zh-cn/online/datasource_mfr_relatedness_messages.md -->

[跳转到主要内容](#main-content)

# 了解多事实关系数据模型的工具提示

**注意**：对于单表数据源或者单基表数据源，所有表都是相关的。本页上的所有内容均指多基表数据源。

## 字段级相关性

具有多个基表的数据模型在表之间的相关（或不相关）方式上具有很大的灵活性。_表_的相关性是一个基于数据模型的常数。然而，_字段_在可视化项中的关联性取决于哪些字段处于活动状态（即，工作表功能区上哪些字段用作胶囊）。在单个可视化项级别，Tableau 会成对评估活动字段以确定[它们彼此之间如何相互关联](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#fieldlevel)。

字段上不相关的图标 ![不相关图标](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_unrelated.png) 表示该字段与可视化项中的至少一个其他字段不相关。此图标可以显示在功能区上或“数据”窗格中的胶囊中。（在某些情况下，可能会有相关图标 ![](/tableau/next/zh-cn/online/zh-cn/Img/MFR_icon_related.png "相关性图标")。）将鼠标悬停在图标上会打开包含更多信息的工具提示。不同类型的字段相关性有不同的消息源，包括：

- 不相关的维度 - 维度对
- 不相关的维度 - 度量对
- 拼接维度
- 不相关的筛选器对

> [!TIP]
> 
> **提示**：在 Tableau 中，聚合维度（例如 ATTR（维度）或 MIN（维度））充当度量。

根据字段是在功能区上使用还是在“数据”窗格中使用，消息也会略有不同。

- **在功能区上**：功能区上胶囊的工具提示提供了相关信息，显示可视化项中的字段如何相互关联，以及这对 Tableau 如何计算结果产生的影响。
- **在“数据”窗格中**：数据窗格中字段的工具提示提供了有关如果将该字段添加到可视化项中_会_发生什么情况的信息。如果“数据”窗格中的字段与可视化项中的任何字段都不相关，也可以使用浅灰色文本淡化这些字段。

有各种功能可能会添加到字段的注释中，例如表计算和用户提供的注释。所有这些信息都显示在一个统一的工具提示中。

![](/tableau/next/zh-cn/online/zh-cn/Img/unified_tooltip.png "字段的工具提示，包含有关相关性、表计算和用户注释的信息")

### 了解您的数据模型

无论何时使用包含多事实关系的数据模型，定期引用该模型都会很有用。使用[“查看数据模型”](https://help.tableau.com/current/pro/desktop/zh-cn/viewdatamodel.htm)选项（“工作表”菜单 >“查看数据模型”）打开一个对话框，其中包含您可以在工作表标签上引用的数据模型。

本主题中的示例基于具有两个基表（“Classes”（班级）和“Clubs”（俱乐部））和两个共享标签（“Students”（学生））的数据模型。

![具有两个基表（“Classes”（班级）和“Clubs”（俱乐部））和一个共享表（“Students”（学生））的数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_basic_4table_model.png)

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"></colgroup><tbody><tr><td><p><b>Classes（班级）</b></p></td><td><p><b>Clubs（俱乐部）</b></p></td><td><p><b>Students（学生）</b></p></td><td><b>Rooms（房间）</b></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_viewdata_classes_r.png" alt="查看“Classes”（班级）表的数据，显示三个字段及其值"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_viewdata_clubs_r.png" alt="查看“Clubs”（俱乐部）表的数据，显示三个字段及其值"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_viewdata_students_r.png" alt="查看“Students”（学生）表的数据，显示三个字段及其值"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_viewdata_rooms_r.png" alt="查看“Rooms”（房间）表的数据，显示三个字段及其值"></td></tr><tr><td><p>字段：</p><ul><li><b>Classes（班级）</b>：一个维度，其值为“Nesting Basics”（筑巢基础）、“Advanced Songs”（高级歌曲）、“Flying for Fledglings”（雏鸟飞行）和“Alarm Calls 101”（报警电话 101）</li><li><b>Room（房间）</b>，用于与“Rooms”（房间）表关联的维度</li><li><b>Student（学生）</b>，用于与“Students”（学生）表关联的维度</li><li><b>Length（长度）</b>， 一个度量</li></ul></td><td><p>字段：</p><ul><li><b>Clubs（俱乐部）</b>，一个维度，其值为“Photography”（摄影）、“Travel”（旅行）、“Juggling”（杂耍）、“Art”（艺术）和“First Aid”（急救）</li><li><b>Room（房间）</b>，用于与“Rooms”（房间）表关联的维度</li><li><b>Student（学生）</b>，用于与“Students”（学生）表关联的维度</li><li><b>Dues（会费）</b>， 一个度量</li></ul></td><td><p>字段：</p><ul><li><b>Bus Rider（巴士乘客）</b>，一个维度，其值为“yes”（是）或“no”（否）</li><li><b>Student（学生）</b>，一个维度，其值为“Finch”（雀类）、“Cardinal”（红衣凤头鸟）、“Sparrow”（麻雀）、“Robin”（Robin） 和“Jay”（松鸦）。用于与基表关联</li><li><b>Age（年龄）</b>， 一个度量</li></ul></td><td><p>字段：</p><ul><li><b>房间</b>，包含“Cedar”（雪松）、“Alder”（赤杨）、“Maple”（枫木）、“Fir”（冷杉）和“Madrone”（马德罗尼木）值的维度</li><li><b>分支</b>，一个度量</li></ul></td></tr></tbody></table>

## 不相关的维度-维度对

不相关的维度是交叉联接的，这可能导致跨标题的维度成员组合不能反映基础表中数据的实际组合。

不相关的维度-维度对的消息为：

- **在功能区上**：不相关的维度显示所有可能的值组合。不相关内容：_<维度列表>_
- **在“数据”窗格中**：如果使用，此维度将显示具有不相关维度的所有可能的值组合：_<维度列表>_
- **在“数据”窗格中显示为灰色**：此维度与可视化项中的任何维度均不相关。如果使用，它将显示与其他不相关维度的所有可能的值组合。

对于不相关筛选器，消息为：

- **在可视化项中**：此字段未被不相关筛选器筛选：_<筛选器>_
- **在“数据”窗格中**：如果使用，此字段将被不相关筛选器忽略：_<筛选器>_

交叉联接可能是开销很大的操作，会对性能产生负面影响。因此，如果您向可视化项添加不相关的维度，Tableau 也会显示[相关性警告对话框](https://help.tableau.com/v0.0/online/zh-cn/datasource_mfr_multiple_base_tables.htm#Relatedn)。

## 拼接维度

尽管从分析角度来看，单独可视化不相关的维度是有原因的，但是对于使用多个基表的分析来说，一个常见的“好方法”是另外使用拼接维度。在存在拼接维度的情况下，不相关的维度不再是交叉联接，而是外部联接。外部联接仍可能引入 null 值，但维度成员标题会从所有可能的组合精简为与外部联接至少一侧相关的组合。它们也不会像交叉联接那样对性能产生同样大的影响。如果没有需要不相关图标的其他相关性问题，则拼接维度会显示相关图标 ![](/tableau/next/zh-cn/online/zh-cn/Img/MFR_icon_related.png "相关图标")。

拼接维度的消息为：

- **在功能区上**：此维度将以下字段拼接在一起：_<字段列表>_
- **在“数据”窗格中**：如果使用，此维度将以下字段拼接在一起：_<字段列表>_
- **在“数据”窗格中显示为灰色**：_不适用，拼接仅发生在可视化项中_

比较不相关维度与拼接维度

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>不相关：交叉联接</p></td><td><p>拼接：中间内部联接的外部联接</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_tt_unrelateddims.png" alt="交叉联接，每个“Classes”（班级）和“Clubs”（俱乐部）的组合占一行"><p><span class="caption">一个可视化项，显示了“Classes”（班级）和“Clubs”（俱乐部）的交叉联接，其中行代表“Advanced Songs”（高级歌曲）/“Alarm Calls 101”（报警电话 101）/“Flying for Fledglings”（雏鸟飞行）/“Nesting Basics”（筑巢基础）与“Art”（艺术）/“First Aid”（急救）/“Juggling”（杂耍）/“Photography”（摄影）的每个组合。 </span></p></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_tt_unrelateddimsstitched_252.png" alt="学生班级和学生俱乐部结果的外部联接"><p><span class="caption">一个可视化项，显示了学生-班级内部联接和以及学生-俱乐部内部联接的外部联接结果。并非所有班级和俱乐部的组合都有代表，并且没有班级的学生和俱乐部也有行。</span></p></td></tr></tbody></table>

## 不相关的维度-度量对

有关如何计算度量值以及维度相关性为何如此重要的信息，请参见[关于如何计算度量值的补充](#computemeasures)。

度量的消息为：

- **在功能区上**：此度量不能按不相关维度细分：_<维度列表>_。
- **在“数据”窗格中**：如果使用，此度量将不会按不相关维度细分：_<维度列表>_
- **在“数据”窗格中显示为灰色**：此度量与可视化项中的任何维度均无关。如果使用，则不会对其进行细分。

维度的消息为：

- **在功能区上**：此维度不能细分不相关的度量：_<度量列表>_
- **在“数据”窗格中**：如果使用，此维度不会细分不相关的度量：_<度量列表>_
- **在“数据”窗格中显示为灰色**：此维度与可视化项中的任何度量均无关。如果使用，则不会细分度量值。

对于不相关筛选器，消息为：

- **在可视化项中**：此字段未被不相关筛选器筛选：_<筛选器>_
- **在“数据”窗格中**：如果使用，此字段将被不相关筛选器忽略：_<筛选器>_

可视化项中的结果是跨不相关维度值的度量的重复值。此行为类似于使用 LOD 表达式将度量的聚合级别设置为与可视化项的原始粒度不同的详细级别。不相关维度本质上被排除在度量的聚合值计算之外。

![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_measures_repeated.png "一个可视化项，其中会费值与俱乐部挂钩，并且俱乐部在各个班级重复出现")

## 尚未相关

具有潜在关系的字段称为[尚未相关](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#notyet)并在可视化项中被评估为不相关。[解析](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#resolve)尚未相关的字段与解析真正不相关的字段（只能拼接）的方法不同，因此工具提示会指出为什么它们被认为是不相关的。

维度的消息取决于它是否尚未与另一个维度、度量或筛选器相关。

- 对于维度-维度对，维度的消息为： 
    - **在功能区上**：不相关的维度显示所有可能的值组合。此维度尚未与以下内容相关，因此被视为与以下内容无关：_<维度列表>_
    - **在“数据”窗格中**：如果使用，此维度尚未与以下内容相关，因此被视为与以下内容无关：_<维度列表>_
- 对于维度-度量对，维度的消息为： 
    - **在功能区上**：此维度尚未相关，因此无法细分以下内容：_<度量列表>_
    - **在“数据”窗格中**：如果使用，此维度将与以下内容不相关，因此不会细分以下内容：_<度量列表>_
- 对于维度-筛选器对，维度的消息为： 
    - **在功能区上**：此字段尚未相关，因此将被以下筛选器忽略：_<筛选器列表>_
    - **在“数据”窗格中**：如果使用，此字段尚不相关，因此将被不相关的筛选器忽略：_<筛选器列表>_

度量的消息取决于它是否尚未与维度或筛选器相关。

- 对于度量-维度对，度量的消息为： 
    - **在功能区上**：此度量尚未与以下内容相关，因此无法按以下内容细分：_<维度列表>_
    - **在“数据”窗格中**：如果使用，此度量尚未与以下内容相关，因此不会按以下内容细分：_<维度列表>_
- 对于度量-筛选器对，度量的消息是： 
    - **在功能区上**：此字段尚未相关，因此将被以下筛选器忽略：_<筛选器列表>_
    - **在“数据”窗格中**：如果使用，此字段尚不相关，因此将被不相关的筛选器忽略：_<筛选器列表>_

有关如何计算度量值以及维度相关性为何如此重要的信息，请参见[关于如何计算度量值的补充](#computemeasures)。

## 模糊相关

具有多个活动可能关系的字段称为[模糊相关](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#ambiguously)并在可视化项中被评估为不相关。[解析](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#resolve)模糊相关字段的解析方式与真正不相关字段（只能拼接）不同，因此工具提示会指出为什么它们被认为是不相关的。

维度的消息为：

- **在功能区上**：此维度与以下内容模糊相关，因此无法细分以下内容：_<度量列表>_
- **在“数据”窗格中**：如果使用，此维度将与以下内容模糊相关，因此不会细分以下内容：_<度量列表>_

度量的消息取决于歧义是在于维度还是筛选器。

- 对于度量-维度对，度量的消息为： 
    - **在功能区上**：此度量与以下内容模糊相关，因此无法按以下内容细分：_<维度列表>_
    - **在“数据”窗格中**：如果使用，此度量将与以下内容模糊相关，因此不会按以下内容细分：_<维度列表>_
- 对于度量-筛选器对，度量的消息是： 
    - **在功能区上**：此度量段与以下筛选器模糊相关，因此将被其忽略：_<筛选器列表>_
    - **在“数据”窗格中**：如果使用，此度量将与以下筛选器模糊相关，因此将被其忽略：_<筛选器列表>_

有关如何计算度量值以及维度相关性为何如此重要的信息，请参见[关于如何计算度量值的补充](#computemeasures)。

## 共享表中的度量

当使用共享表（如“Students”（学生））中的维度时，它会将来自其他不相关的表（如“Classes”（班级）和“Clubs”（俱乐部））的维度拼接在一起。但是，如果您不使用维度，而是使用“Students”（学生）表中的度量，结果会怎样？度量不能拼接。

![具有两个基表（“Classes”（班级）和“Clubs”（俱乐部））和一个共享表（“Students”（学生））的数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_basic_3table_model.png)

当不相关的维度一起可视化时，度量值不能同时按这些维度细分。（有关如何计算度量值以及维度相关性为何如此重要的信息，请参见[关于如何计算度量值的补充](#computemeasures)。）在这种情况下，我们将该度量视为与维度组合不相关，即使它与任一维度单独相关。

为了解决这种类型的不确定性并防止度量被限制在表范围内，可以拼接不相关的维度，或者移除一个或多个维度，直到存在用于聚合度量的明确关系路径。

### 所有维度彼此不相关

跨不相关维度共享的度量的消息为：

- **在功能区上**：此度量每次只能按以下维度之一细分：_<维度的项目符号列表>_
- **在“数据”窗格中**：如果使用，此度量一次只能按以下维度之一细分：_<维度的项目符号列表>_

每个维度的消息为：

- **在功能区上**：此维度无法与以下维度结合细分度量 _<度量>_：_<维度的项目符号列表>_
- **在“数据”窗格中**：如果使用，此维度无法与以下维度组结合细分度量 _<度量>_：_<维度的项目符号列表>_

### 某些维度彼此相关

如果某些维度彼此相关，则相关维度可能会在不存在不相关维度的情况下分解度量。了解各个维度之间是否相关是很有用的。（例如：如果一个可视化项由相关维度 Dim1 和 Dim2 以及与它们都不相关的维度 DimA 组成，则共享表中的度量与所有三个维度不会同等相关。Dim1 和 Dim2 彼此不冲突，但它们都与 DimA 冲突。若要通过移除字段来解决，您可以单独移除 DimA，也可以同时移除 Dim1 和 Dim2。）

在这种情况下，维度在工具提示消息中按组列出。

跨不相关维度组共享的度量的消息为：

- **在功能区上**：此度量一次只能按以下维度组之一进行细分：_<维度的项目符号列表>_
- **在“数据”窗格中**：如果使用，此度量一次只能按以下维度组之一进行细分：_<维度的项目符号列表>_

每个维度的消息为：

- **在功能区上**：此维度无法与以下维度组结合细分度量 _<度量>_：_<维度的项目符号列表>_
- **在“数据”窗格中**：如果使用，此维度无法与以下维度组结合细分度量 _<度量>_：_<维度的项目符号列表>_

## 相关度量

当某个度量与可视化项中的某些维度相关但与其他维度不相关时，该度量的工具提示中可能会显示一条附加消息，解释其与哪些维度相关。这有助于解释该指标是如何聚合的。仅当度量也与可视化项中的维度不相关时，才会显示此消息。否则，标准行为是将度量聚合到其相关度量的详细级别。

度量的消息为：

- **在功能区上**：此度量聚合到相关维度的详细级别：_<与此度量相关的可视化项中的维度>_
- **在“数据”窗格中**：如果使用，此度量将聚合到相关维度的详细级别：_<与此度量相关的可视化项中的维度>_

此消息旨在帮助识别在计算度量值时要考虑哪个或哪些维度。有关如何计算度量值以及维度相关性为何如此重要的信息，请参见[关于如何计算度量值的补充](#computemeasures)。

## 筛选器

与可视化项中其他活动字段相比，还会评估筛选器功能区上的字段的相关性。

当筛选器与可视化项中的至少一个字段不相关时，将显示图标和工具提示。筛选器字段和可视化项中的字段均有工具提示。

筛选器的消息为： 

- **不相关筛选器**：此筛选器不适用于不相关字段：_<字段>_
- **模糊筛选器**：此筛选器忽略以下度量，因为它与这些度量模糊相关：_<度量列表>_
- **尚未相关的筛选器**：此筛选器忽略以下字段，因为它尚未与这些字段相关：_<字段列表>_

筛选器的行为还取决于它们与可视化项中其他字段的相关性。筛选器不会影响与其不相关的字段的值。除非将筛选器设置为无值（排除所有内容或不包含任何内容），否则对于与筛选器无关的任何字段，可视化项都将保持不变。但是，取消选择筛选器中的每个选项将返回一个空白的可视化项。

![具有不相关筛选器的可视化项，表明取消选择交互式筛选器控件中的选项不会对可视化项产生影响](/tableau/next/zh-cn/online/zh-cn/Img/mfr_tt_unrelatedfilter.png)

带有不相关筛选器的可视化项的两个屏幕截图，显示取消选择交互式筛选器控件中的选项不会影响可视化项

相关字段按预期进行筛选。在具有相关和不相关字段组合的更复杂的可视化项中（例如在拼接上下文中），筛选器只会影响与筛选器字段相关的值。

## 关于如何计算度量值的补充

当某个度量与某个维度不相关时，它就不能按该维度的成员进行细分（也就是说，当俱乐部没有班级长度时，您不能细分每个俱乐部的平均班级长度）。相反，度量将在与视图中的维度成员标题不同的级别上进行聚合。

维度和度量的术语

在 Tableau 中，_度量_是_聚合_ — 它们聚合到由视图中的_维度_设置的_粒度_。因此，度量的值取决于维度的上下文。例如，“谷物食品盒的数量”取决于我们指的是总库存还是每个品牌的盒数。

_维度_通常是分类字段，例如国家/地区或品牌。在 Tableau 中，维度设置视图的粒度，即_详细级别_。我们通常希望根据某种类别的组合将数据分组为标记。我们用来构建视图的维度确定我们有多少个标记。

_聚合_是指数据的组合方式。Tableau 的默认聚合为 SUM。您可以将聚合更改为其他选项，其中包括“平均值”、“中值”、“不重复计数”、“最小值”等。_粒度_指的是度量的详细程度或细分程度 — 由相关维度控制。除非度量的粒度是行级（又称解聚），否则其值必须是聚合的。

#### 示例

![五种品牌、三种包装盒尺寸的谷物食品包装盒数量数值表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_cereal_rawdata.png)

**“谷物食品包装盒数量”的值是？**

嗯，这取决于聚合类型和维度设置的粒度。

- 聚合
    - 总和（或总计）
    - 平均值
- 粒度：
    - 表范围/完全聚合（示例中的蓝色条形）
    - 按**“Brand”（品牌）**维度细分（示例中的彩色条形）

![包含四个可视化项的仪表板，一个用于显示表范围内的盒数总和 (54)，一个用于显示表范围内的平均盒数 (6)，然后这两个版本的可视化项按五个品牌细分](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_cereal.png)

### 度量值跟随维度成员

度量的值由其相关的维度确定。没有相关维度的度量是表范围的。具有相关维度的度量按相关维度的成员细分（即，为每个维度成员计算度量的值）。如果由于存在不相关的维度而导致相关维度的成员重复，则度量的值将根据其维度成员重复。

1. 没有维度的度量的表范围是其总体值。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_measures_tablescoped.png)
2. 仅在不相关维度存在的情况下，度量是表范围的，并且对不相关维度的成员重复。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_measures_tablescoped_unrelated.png)
3. 在存在相关维度的情况下，度量会被更精细地细分，并且其值将根据相关维度的每个成员进行计算。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_measures_broken_down.png)
4. 当存在不相关维度和相关维度时，度量将按其相关维度进行细分。只要这些相关维度成员在不相关的维度中重复出现，度量值就会随其相关维度成员一起出现。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_measures_broken_down_and_repeated.png)
    
    因为会费是按俱乐部计算的，所以每次俱乐部重复时，每个俱乐部的会费值也会重复。

<!-- document id=6d1b4d189ecd150f26aed628fde1a5ec4a4ee4d154c6be724f0a1838c49c6a7a url=/tableau/next/zh-cn/online/license_product_keys.md -->

[跳转到主要内容](#main-content)

# 了解许可证模式

本主题介绍不同的许可模式和可能与之关联的产品密钥和订阅。在 [Tableau 客户门户](http://customer.tableausoftware.com/)中可以找到产品密钥和订阅在 Tableau Cloud 中的表示形式的有用视图。

使用 Tableau 客户门户 ( Tableau Desktop 和 Tableau Prep Builder) 查看产品密钥时，请注意特定于产品的前缀。

<table style="max-width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td>产品密钥前缀</td><td>描述</td></tr><tr><td>TC</td><td>Tableau Creator 产品密钥，可用于激活或停用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 和 <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span>。</td></tr><tr><td>TD</td><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 产品密钥，仅可用于激活或停用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>。这是一个不再出售或提供的旧版产品密钥。</td></tr></tbody></table>

## 短期许可证模式

Tableau 的短期许可证模式由允许使用 Tableau Cloud 的指标来定义。短期许可证也称为订阅许可证。Tableau 目前通过订阅许可证销售 Tableau Cloud 的访问权限。在订阅许可证模式中，客户每年支付订阅费用。如果订阅过期，软件将停止工作。

Tableau Cloud订阅许可证基于角色、基于内核或基于容量。可以购买包含所有角色和功能的单个许可证密钥，此许可证称为可更新订阅许可证 (USL)。只需在 Tableau Cloud 上激活一个密钥即可代表整个购买。

- _基于角色的许可证_允许您根据每种角色类型的可用许可证添加用户。
- _基于使用情况的许可证_不会限制 Tableau Cloud 中的 Viewer（查看者）用户帐户数。相反，许可证是按使用情况计算的，更具体地说，是按分析展示量计算的。_嵌入式分析基于使用情况的许可证_是一种基于使用情况的许可证。
- _基于容量的许可证_为 Tableau Cloud 提供无限制的“Viewer（查看者）”用户，取代了按用户按月提供的“Viewer（查看者）”许可。您可以购买定义您的部署可以支持多少并发使用量的容量单位，而不是按 Viewer（查看者）付费。至少需要部署一个 Creator 许可证。Creator 和 Explorer 继续按每用户每月获得许可。

### 基于角色的许可证模式

Tableau 提供基于角色的短期许可证，这些许可证可以各种价位授予一系列能力。共有四种类型基于角色的短期许可证：显示、Viewer（查看者）、Explorer 和 Creator。

- _显示许可证_允许用户与大量内部用户共享和显示 Tableau 内容，这些用户通过共享显示来使用仪表板，无需交互。显示许可证没有单独的站点角色；使用显示许可证时，管理员为每个许可的显示位置创建一个专用的登录帐户，该帐户与单个用户的登录帐户不同，并分配 Viewer（查看者）最大站点角色。
- _Viewer_（查看者）许可证让用户能够查看 Tableau Cloud 中的工作簿并与之交互。Viewer（查看者）许可证还让用户能够访问 Tableau Mobile、为工作簿添加注释、以各种方式导出可视化项、下载工作簿汇总数据、下载工作簿汇总数据、为自己创建订阅，以及接收数据驱动型通知。
- _Explorer_ 许可证类似于以前的 Tableau Cloud 版本中的基于用户的许可证，并包括随 Viewer（查看者）许可证一起提供的能力，以及其他能力。Explorer 许可证允许使用 Web 浏览器访问工作簿制作能力以及一整套协作功能。
- 使用 Tableau Cloud 时，_Creator 许可证_可允许各种各样的能力，同时还授予使用 Tableau Desktop 和 Tableau Prep Builder 的能力。Creator 许可证允许 Explorer 许可证下可用的所有能力，以及使用 Tableau Cloud 时的以下能力：
    - 依据新数据源创建和发布新工作簿。
    - 在“数据”窗格中编辑嵌入的数据源。
    - 创建和发布新数据连接。
    - 在 Tableau Desktop 和 Tableau Prep Builder 上使用 基于登录名的许可证管理 激活。

### 基于使用情况的许可证模式

在基于使用使用的许可 (UBL) 模式中，使用情况查看者按分析展示中测量的使用情况授予许可，而 Creator 和 Explorer 则按用户定义。

分析展示是在使用情况查看者（必须是您组织外部的查看者）访问您的外部应用程序或 Pulse 指标中（或与之相关）的一个或多个嵌入式分析时生成的。例如，当 Viewer（查看者）执行以下操作时：

- 加载仪表板。
- 加载工作表。
- 通过 API 或 UI 下载或导出可视化项（仪表板或工作表），例如图像、PDF、PowerPoint 或 Tableau 工作簿。
- 接收订阅。
- 成功请求详细的 Pulse 见解。成功的详细信息请求可能发生在用户与 Tableau 内的 Pulse 界面交互时，也可能发生在外部应用程序向 Pulse Insights API 发出请求的嵌入式场景中。
- 获取 VizQL Data Service 请求的响应。

**注意：**Tableau Pulse 在发布时将可用于基于使用情况的站点，并将于 2024 年 6 月开始测量分析展示。

站点管理员将收到[每月概览电子邮件](https://help.salesforce.com/s/articleView?id=000390885&type=1)，更新他们的分析展示消费，以便他们可以跟踪其使用情况和管理其预算。您还可以随时向您的客户经理请求使用情况指标来监控使用情况。

### 基于容量的许可证模式

从 2026 年 7 月开始，基于容量的许可模式为需要更广泛地扩展和规模化其分析访问权限的客户提供了购买基于容量的单位的选项。

在基于容量的许可模式中，Viewer（查看者）用户不会按用户帐户获得许可。相反，您可以购买基于容量的 Viewer（查看者）块，用于定义您的部署需要支持多少并发使用量。使用此模式，您可以添加到 Tableau Cloud 的 Viewer（查看者）用户帐户数量没有限制。

Creator 和 Explorer 继续按用户按月获得许可。每次部署至少需要一个 Creator 许可证才能购买基于容量的 Viewer（查看者）块。部署可以使用基于容量或基于角色的 Viewer（查看者）许可，但不能同时使用两者。

每个基于容量的 Viewer（查看者）块都为以下类型的操作定义了限制。这些类型可能会随着我们的基础设施的发展而变化。

**可视化项操作：**

- 打开和刷新仪表板及视图
- VizQL Data Service (VDS) API 调用
- 探索 Pulse 指标
- Pulse 见解 API 调用

**后台操作：** 

- 并发数据提取刷新
- 数据提取 API 调用
- 发布 API 调用
- 并发订阅
- 计划 Pulse 摘要

基于容量的许可适用于 Standard、Enterprise、Cloud+ 和 Tableau+ Bundle 版本。容量在租户级别预置，并且可由 Tableau cloud 管理员在 Tableau Cloud Manager (TCM) 中分配给各个站点。有关特定容量类型和限制的详细信息，请参见[Tableau Cloud 容量](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm)。

## 基于嵌入式分析

Tableau 的嵌入式分析产品是 Tableau Cloud 的有限用途许可证，可供希望将 Tableau Cloud 分析嵌入到面向外部的解决方案中的客户使用，以便向组织外部的客户提供 Tableau 内容和见解。

**注意：**嵌入式分析许可证不能在与全功能许可证相同的环境中使用。若要更改为嵌入式分析许可证，请首先停用现有的完全使用许可证，然后激活嵌入式分析许可证。

例如，假设有一个运行服务的组织，客户在其中分析消费者数据并生成有关不同消费者人口统计的行为模式的报告。在此方案中，Tableau Cloud 支持名为“Demographics Analyzer”（人口统计分析器）的特定专有应用程序，并与导出的 TXT 文件和 SQL 数据库连接。组织在安全门户中向其客户端提供可视化内容，客户端可登录到该门户以管理其帐户并查看结果。最终用户通过他们用于访问门户的帐户进行唯一标识。

若要验证许可证，请联系[客户成功](https://www.tableau.com/zh-cn/support/customer-success)。

## 许可版本

许可版本包括用户有权使用的一套特性和功能。许可版本不能在部署中混合使用，这意味着部署中的所有用户都必须使用相同的许可版本。选择许可版本时，请考虑整个部署的需求。

### Tableau Cloud 许可版本

- #### Tableau 标准版许可证
    
    Tableau 标准版是基础 Tableau Cloud 版本。它为每个许可用户提供 Tableau Cloud 访问权限、治理、协作、数据准备和可视化分析功能。
- #### Tableau 企业版许可证
    
    企业版专为 Tableau Cloud 上复杂的业务环境而设计。它非常适合需要高级管理、安全和数据管理功能以便在更复杂的数据环境中扩展到更多用户并满足企业标准的组织。
    
    有关更多信息和 Tableau Enterprise 所含功能的列表，请参见[关于 Tableau Enterprise](https://help.tableau.com/v0.0/online/zh-cn/to_tab_enterprise_features.htm)。
- #### Tableau Cloud+ 版本许可证
    
    Tableau Cloud+ 版本仅适用于 Tableau Cloud。它专门为全面采用 AI 驱动的自助分析而量身定制。它包含针对更大或更复杂的部署定制的高级功能，例如带有 Tableau Agent 的高级 AI 功能、50 个站点限制、发布预览和 Tableau Cloud 的 Premier Success。
    
    有关详细信息和 Tableau Cloud+ 版本附带的功能列表，请参见[关于 Tableau Cloud+ 版本](https://help.tableau.com/v0.0/online/zh-cn/to_tab_cloud_plus_features.htm)。。
- #### Tableau+ Bundle 许可证
    
    Tableau+ Bundle 适用于 Tableau Cloud。它包括使用 Tableau Next 进行的代理分析，以及 Tableau Cloud+ 版本许可证。
    
    有关详细信息和 Tableau+ Bundle 附带的功能列表，请参见[关于 Tableau+ Bundle](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_features.htm)。

### Tableau Server 许可版本

- #### Tableau 标准版许可证
    
    Tableau 标准版是基础 Tableau Server 版本。它为每个许可用户提供 Tableau Server 访问权限、治理、协作、数据准备和可视化分析功能。
- #### Tableau 企业版许可证
    
    企业版专为 Tableau Server 上复杂的业务环境而设计。它非常适合需要高级管理、安全和数据管理功能以便在更复杂的数据环境中扩展到更多用户并满足企业标准的组织。
    
    有关更多信息和 Tableau Enterprise 所含功能的列表，请参见[关于 Tableau Enterprise](https://help.tableau.com/v0.0/online/zh-cn/to_tab_enterprise_features.htm)。
- #### Tableau Server+ 版本许可证
    
    Server+ 版本专为希望充分利用 Tableau Server 的强大功能以及灵活性和智能性来进一步扩展的组织而设计。它非常适合需要扩展部署环境（1 个生产环境和最多 6 个用于测试的额外非生产环境）、使用预构建容器的加速设置、 和高级成功支持以推动采用并在整个组织中实现价值最大化的企业。
    
    有关详细信息和 Tableau Server+ 版本附带的功能列表，请参见 Tableau Server 帮助中的[关于 Tableau Server+ 版本](https://help.tableau.com/current/online/zh-cn/tab_server_plus_features.htm "涵盖 Tableau Server+ 功能的主题的链接")。

## 私人连接许可

如果您有带有 Tableau Enterprise 或 Tableau Cloud+ 版本或者 Tableau+ Bundle 的 Tableau Cloud，私人连接可作为附加许可证购买。每个专用连接都需要一个附加许可证。

您还需要购买数据使用块以通过专用连接发送和接收数据。专用连接数据使用按 TB 计费。

每月使用情况摘要按照 [每月帐户摘要常见问题解答](https://help.salesforce.com/s/articleView?id=000390885&type=1)中所述发送。想要更频繁、更精细的统计数据的云管理员可以使用[活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm)来获取使用情况。出现在 Tableau Cloud Manager 中的专用连接列表中的专用连接端点 ID 映射到活动日志事件中的 `endpointID`。

## 功能许可证

**重要信息：**自 2024 年 9 月 16 日起，Advanced Management 和 Data Management 不再作为独立的附加选项提供。仅当您先前购买了这些产品，或者购买了某些许可证版本：Tableau Enterprise、Tableau Cloud+ 或 Tableau+ Bundle（适用于 Tableau Cloud），或者 Tableau Enterprise 或 Tableau Server+（适用于 Tableau Server）时，Advanced Management 和 Data Management 功能才可用。

功能许可证的销售方式与其他许可证不同。具有独立许可证的功能必须针对部署中的每个用户授予许可。

这些功能是按年许可的，并且在许可上下文中，这些功能对于用户群的可用性为“全部或无”：

- Data Management
- Advanced Management
- 基于登录名的许可证管理

**注意：**可更新的订阅许可证在一个许可证中同时包含功能和角色。您不再需要为不同的功能及其相关角色激活多个许可证和产品密钥。

### Data Management

Data Management 许可证包括 Tableau Catalog 和 Tableau Prep Conductor。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。

### Advanced Management

Tableau Cloud Advanced Management 按部署许可。有关 Advanced Management 及其包括的功能的详细信息，请参见[关于 Tableau Cloud 上的 Tableau Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm)。

### 基于登录名的许可证管理

基于登录名的许可证管理 (LBLM) 简化了Tableau Desktop 和 Tableau Prep Builder 的许可。最终用户无需激活产品密钥，云 Creator 可以通过登录云站点 (LBLM) 来激活和使用 Tableau Desktop 和 Tableau Prep Builder。

有关详细信息，请参见[使用基于登录名的许可证管理激活 Tableau](https://help.tableau.com/v0.0/online/zh-cn/license_lblm.htm)。

<!-- document id=45c98d8ed54d9edb8ee16692e88cec466e68c9126feffbd83d6fc66197937edb url=/tableau/next/zh-cn/online/to_security.md -->

[跳转到主要内容](#main-content)

# 云中的安全性

Tableau 深知数据是组织拥有的最具战略意义的资产之一。我们将保证客户数据的安全性和保密性视为我们的头等大事。Tableau 企业级安全功能可管理运营安全性、用户安全性、应用程序安全性、网络安全性和数据安全性。

若要了解详情，请参见 Tableau 网站 ([https://www.tableau.com](https://www.tableau.com/zh-cn/)) 上的以下资源：

- [Tableau Cloud 的云安全性](http://www.tableau.com/zh-cn/learn/whitepapers/tableau-online-security-cloud)白皮书。
- [Tableau Cloud 提示：向云发布数据时的安全检查表](https://www.tableau.com/zh-cn/about/blog/2016/3/tableau-online-tips-4-things-consider-when-publishing-data-cloud-51950)

如果使用 TableauID 凭据登录到 Tableau Cloud，则也可以使用这些凭据登录到 Tableau 网站。

## 运营安全性

Tableau Cloud 基础架构托管在符合 SAS-70 标准的数据中心中，可对客户数据进行诸多控制和保护。

您的数据属于您本人，即使存储在 Tableau Cloud 中也是如此。只有您的授权用户才有权访问存储在 Tableau Cloud 中的数据或工作簿 — Tableau 员工及其他客户无权访问。

Tableau 可以访问与系统利用率、帐户状态和性能相关的指标，并且可以监视这些指标。

## 用户安全性

唯一有权访问您站点和内容的人是站点管理员或云管理员明确添加的用户。如果某用户不再是您系统中的授权用户，只需移除此人的用户帐户以撤消访问 Tableau Cloud 及其中存储的内容的权限即可。

Tableau Cloud 强制实施 2 小时的空闲用户会话超时。这意味着，在未使用 Tableau Cloud 2 小时后，用户必须重新进行身份验证。空闲会话超时值是无法修改的系统设置。

### Tableau 帐户

您的 Tableau 帐户为 Tableau 的网站和服务提供安全、统一的身份验证。

Tableau 帐户的一些安全功能包括：

- 由 HTTPS 提供保护的用户登录。
- 在失败的登录尝试重复几次后帐户锁定一段时间。
- 通过用户电子邮件验证帐户以证明身份。
- 密码使用加密保护进行存储。Tableau 员工和承包商无法访问纯文本密码。
- 可以为使用 Tableau 身份验证的帐户启用多重身份验证 (MFA)。

Tableau Cloud 站点管理员和云管理员可以选择使用组织的身份提供程序来加强控制和方便用户。有关详细信息，请参见[身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)和[Tableau Cloud Manager 身份验证](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm)。

### 角色和权限

角色是一组应用于项目、工作簿、视图或数据源以管理用户交互的权限。适用于每个资产的特定权限有多种：查看、创建、编辑、修改、删除等。

## 网络安全

**重要信息：**从版本 2025.2 (Tableau Desktop)、2025.3 (Tableau Server) 和 2025 年 6 月版 (Tableau Cloud) 开始，Tableau 使用 OpenSSL 3.4.x 和 2 级安全性。2 级安全性需要 2048 位或更长的密钥。任何现有的 1 级安全密钥将不再有效，您将需要生成和部署新的密钥对。如果您已按照建议生成至少 2048 位长度的密钥，则无需进行操作。有关详细信息， 有关生成密钥的详细信息，请参见 Server 帮助中的[生成 SSL 密钥](https://help.tableau.com/current/server/zh-cn/ssl_cert_create.htm#generate-a-key) 。

用户与 Tableau Cloud 之间的所有通信都使用 SSL 加密以实现安全的数据传输。Tableau Cloud 支持 TLS 1.2 及更高版本。有关 TLS 支持的详细信息，请参见 [Tableau 社区](https://community.tableau.com/s/question/0D54T00000C5Q4mSAF/important-as-of-january-18th-2019-tableau-online-will-only-support-encrypted-connections-over-tls-12)。各种加密技术可确保浏览器、服务器层和存储库之间的往来通信安全无虞。此外，在迁移到 Salesforce [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)后，Tableau Cloud 不再支持 HTTP/1.0；客户必须使用 HTTP/1.1 或更高版本来增强性能和安全性。最后，Tableau 还具有许多内置安全机制可帮助防止假冒、劫持和 SQL 注入攻击，并且它可通过每月更新主动测试和响应新威胁。

## 应用程序安全性

Tableau Cloud 环境托管于多租户配置中，可跨客户分离用户、数据和元数据。

### 电子邮件通知

Tableau 采用基于域的消息身份验证、报告和一致性 (DMARC) 来增强电子邮件安全性。DMARC 是一个电子邮件验证系统，可以保护电子邮件发件人和收件人免受垃圾邮件、网络钓鱼和欺骗的侵害，它与 SPF（发件人策略框架）和 DKIM（域名密钥识别邮件）协议一起工作，指示电子邮件服务器如何处理未经身份验证的电子邮件。例如，DMARC 有助于防止未经授权的发件人发送谎称来自 Tableau 的电子邮件，从而保护用户，同时 Tableau 的电子邮件通知是可信的，并可靠地传递。

默认情况下，所有 Tableau 电子邮件通知都启用 DMARC，包括 Tableau Cloud Manager 和站点邀请、指标、数据驱动的通知、刷新失败等。

## 数据安全

Tableau Cloud 可消除在公司环境中实施 VPN 或隧道的需要。许多数据源都可作为数据提取进行捕获，然后定期刷新。为了使用自动刷新，您需要将凭据嵌入在数据源的连接信息中。对于 Google 和 Salesforce.com 数据源，您可以采用 OAuth 2.0 访问令牌的形式嵌入凭据。

您可以通过添加用户和数据源筛选器在工作簿和数据源中定义其他安全性。Tableau 还提供用户筛选器功能，可使用用户名、组或当前用户的全名启用行级别数据安全性。使用用户筛选器，您可以基于查看数据的人的身份对您的数据设置筛选器。例如，西部销售总监可看到西部销售的结果，但看不到其他区域的结果。可在从 Tableau Desktop 发布工作簿和数据源时设置用户筛选器。

有关可用于在 Tableau 中实现行级安全性的替代方法的信息，请参见[Tableau 中的行级安全性选项概述](https://help.tableau.com/v0.0/online/zh-cn/rls_options_overview.htm)。

### HIPAA 合规性

Tableau Cloud 符合健康信息和可移植性责任法案 (HIPAA)，并且可以以符合 HIPAA 的方式提供，以满足医疗保健和生命科学用户的需求。有关详细信息，请查看[Salesforce Trust | Compliance（Salesforce Trust | 合规性）](https://compliance.salesforce.com/en/services/tableau)网站上的“Tableau Cloud and the HIPAA Security Rul”（Tableau Cloud 和 HIPAA 安全规则）白皮书。

### PCI-DSS 合规性

Tableau Cloud 符合支付卡行业数据安全标准 (PCI-DSS) 4.0 标准。Tableau 的 PCI-DSS 合规性基于责任共担模式。此模式要求 Tableau Cloud、服务提供商和客户在此模式下履行自己的责任，以使环境完全符合 PCI-DSS 标准。有关 Tableau Cloud 的承诺和责任，以及您为完全合规而必须在责任共担模式下考虑的关键因素的详细信息，请参见[借助Tableau Cloud 的 PCI-DSS 合规性确保支付和持卡人数据的安全](https://www.tableau.com/zh-cn/blog/tableau-cloud-pci-dss-compliant)博客文章和 [Salesforce Trust | 合规性](https://compliance.salesforce.com/en/services/tableau)站点上的“Tableau Cloud PCI DSS White Paper (EN)”（Tableau Cloud PCI DSS 白皮书）。

## 数据位置

Tableau Cloud 托管在 Salesforce 的 [Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1) 上。

Tableau Cloud 的结构使您可以选择存储站点及其数据的区域。作为新客户，您可以在站点设置过程中选择以下区域之一： 

<table style="width: 90%;margin-left: 0;margin-right: auto;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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1" colspan="2">领地</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">区域</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="6">亚洲</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="6">亚太地区</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">澳大利亚</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">印度</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">印度尼西亚</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">日本</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">新加坡</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><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" rowspan="3">欧洲</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="3">欧洲</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">德国</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">瑞士</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><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" rowspan="3">北美</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">美国东部</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">弗吉尼亚州</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">美国西部</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">俄勒冈州</td></tr></tbody></table>

如果需要，您可以通过站点迁移过程将现有站点迁移到其他区域。请与您的 Tableau 销售客户经理联系以请求此更改。

站点会定期备份在选定区域中。您可以通过登录 Tableau Cloud 来验证您的站点位置，记下 URL 开头的主机名，然后将其与[用于数据提供程序授权的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#safelist)中的**“站点位置”**列进行比较。例如，以 **10ax**、**10ay**、**10az**、**us-west-2b**、**prod-uswest-c** 开头的 URL 对应于“美国西部 - 俄勒冈”区域。与“美国西部俄勒冈州”区域区的站点对应的数据在俄勒冈州存储和备份。

- 若要申请新站点，请参见 [Tableau Cloud](https://www.tableau.com/zh-cn/products/cloud-bi) 产品页面。
- 有关 Tableau Cloud 维护计划的详细信息，请参见[Tableau Cloud 系统维护](https://help.tableau.com/v0.0/online/zh-cn/to_maintenance_schedule.htm)。

## 另请参见

[使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#tableau-online-ip-addresses-for-data-provider-authorization)

[OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm)

[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)

[SAML 身份验证的工作原理](https://help.tableau.com/v0.0/online/zh-cn/saml.htm)

[用户筛选](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#publish_userfilters.htm)（Tableau 帮助）

<!-- document id=b0fe93cea6c9d47d345b840779b88aee1595ed2b6667fbd793285b8de5d62a16 url=/tableau/next/zh-cn/online/cloud_manager_admin.md -->

[跳转到主要内容](#main-content)

# 云管理员角色和任务

本主题概述了云管理员的角色，重点介绍了其与站点管理员角色的区别，并定义了 Tableau Cloud Manager (TCM) 中涉及的核心职责。

## 我们如何定义云管理员角色

云管理员负责监督您组织中的 Tableau Cloud 站点。与管理特定站点设置和内容权限的站点管理员不同，云管理员在租户级别进行操作，处理更广泛的职责，例如跨多个站点的用户管理、许可证监控和站点创建。有关 Tableau Cloud 中租户和站点管理的详细信息，请参见[了解 Tableau Cloud 中的租户和站点管理](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm#tenant-site-info)。

### 许可和访问

与传统站点角色相比，云管理员的角色是独一无二的。云管理员只能访问 Tableau Cloud Manager，并且由于他们没有站点访问权限，因此他们不会消耗 Tableau Cloud 许可证。如果需要站点访问权限，云管理员可以通过 TCM 为自己分配站点角色，从而获得租户内任何站点的访问权限。

## 云管理员的主要职责

以下是 Tableau Cloud Manager 中云管理员的主要职责：

- **跨站点管理用户：**云管理员监督 Tableau Cloud 内所有站点的用户，例如添加或移除用户以及在租户级别调整站点角色。
- **跨站点批量上载用户：**云管理员可以导入大量用户并使用 CSV 文件配置站点访问。批量上载有利于管理大规模部署中跨多个站点的用户访问。
- **跟踪整体许可证：**云管理员通过设置站点角色限制来主动监视和管理 Tableau Cloud 许可证，从而使站点管理员能够添加达到指定数量的用户。
- **创建站点：**云管理员负责在 Tableau Cloud 中创建和删除站点。他们通过指定名称、地区和初始站点管理员来设置站点的初始框架。配置站点后，管理责任将传递给管理站点级别操作的站点管理员。

### 云管理员范围之外的任务

云管理员专注于租户级别的管理，并不直接处理特定站点的日常管理。若要获得站点访问权限并执行设置特定站点权限、管理内容和详细自定义站点等任务，还必须为他们分配站点管理员角色。有关修改用户站点成员身份的详细信息，请参见[管理用户的站点成员身份](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm#manage-site-membership)。

在本主题中，我们回顾了云管理员和站点管理员角色之间的区别。但是，在您的组织中，同一个人可能会担任这两个角色。实际上，您可以采用最适合您的环境的方法来划分这些责任。

<!-- document id=3c56084b9183db69750eaf00158a8b9bc9571d93187a2e7f76d74fe8621c628e url=/tableau/next/zh-cn/online/restrict_site_access.md -->

[跳转到主要内容](#main-content)

# 仅允许访问已批准的站点

从 2026 年 5 月 (Tableau 2026.2) 开始，您可以将组织的网络配置为仅限制用户访问已批准的 Tableau Cloud 站点。此安全功能通过阻止访问未经授权的站点（例如个人试用站点或其他组织的 Tableau Cloud 站点）来帮助防止未经授权的数据共享。

**注意：**本主题介绍如何控制用户可以从您的网络访问哪些站点。若要控制用户可从哪些位置访问站点，请考虑 [IP 筛选](https://help.tableau.com/v0.0/online/zh-cn/ip_filtering.htm)。

### 限制站点访问的好处

特定于站点的访问是一种基于网络的安全控制，允许您的组织强制用户可以从您的网络访问哪些 Tableau Cloud 站点。配置后，用户只能登录您的组织明确批准的 Tableau Cloud 站点并与之交互。这种方法在具有严格数据安全要求的行业和地区（如金融服务、医疗保健和公共部门组织）中尤为重要。

此功能可帮助组织：

- **防止数据丢失：**阻止用户将公司数据上载到未经授权的 Tableau Cloud 试用站点或其他站点
- **保持合规性：**防止未经授权使用未经批准的 Tableau Cloud 站点，以展示对组织数据发布和共享位置的控制
- **满足法规要求：**满足受监管行业和地区严格的数据安全要求

### 工作方式

特定于站点的站点访问通过使用组织的网络基础结构来实现：

1. 您的组织配置 SSL 代理服务器以拦截到 Tableau Cloud (`*.online.tableau.com`) 的 HTTPS 流量。
2. 代理向请求中添加 `X-Tableau-Allowed-Sites` 标头，用于标识哪些 Tableau Cloud 站点已获批准访问。
3. Tableau Cloud 读取这些标头，并根据批准的站点列表允许或阻止访问。
4. 当用户尝试访问未经批准的站点时，访问将被拒绝。

**重要信息：**Tableau 支持团队无法协助配置 SSL 代理或对其进行故障排除。

### 限制站点访问的影响

为您的网络启用此功能后，以下访问将受到影响：

- 通过 Web 浏览器访问
- Tableau Desktop 与 Tableau Cloud 的连接
- Tableau REST API 调用
- 嵌入式视图

### 开始之前

特定于站点的访问需要 Tableau Cloud 云管理员和您组织的 IT 管理员之间的协调。在实施此功能之前，请确保您具有：

- **SSL 代理基础结构**：支持 SSL 拦截和 HTTP 标头注入的 SSL 代理服务器
- **IT 支持**：用于配置代理服务器和维护标头注入的技术资源
- **站点清单**：已批准的 Tableau Cloud 站点 ID 的完整列表

## 配置特定于组织的站点访问权限

实施特定于站点的访问涉及 IT 配置和持续的 Tableau Cloud 管理。

### 步骤 1：识别已批准的站点

为批准的站点生成完整的站点 ID 列表的最佳方式是通过 Tableau Cloud Manager (TCM) 和 Web 浏览器的开发人员工具。

1. 打开 Web 浏览器并转到浏览器的开发人员工具。
2. 转到并以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
3. 返回浏览器的开发人员工具，在“网络”选项卡上，执行以下操作：

1. 查找对 `https://<your-tenant-name>.cloudmanager.tableau.com/api/v1/tenants/<tenantId>/sites` 的请求。
2. 转到 `sites?maxResults=200`。
3. 检查响应。响应包含租户内所有站点的列表，包括站点 ID。站点 ID 列为 `siteUUID`。
4. 捕获响应中的所有 `siteUUID` 值，以编译要包含在标头中的 `X-Tableau-Allowed-Sites` 站点列表。

### 步骤 2：与 IT 合作配置 SSL 代理

向您的 IT 管理员提供已批准站点的列表，并与他们一起配置 SSL 代理。

配置 SSL 代理以将以下标头添加到对 `*.online.tableau.com` 的请求。HTTP 标头值是已批准站点 ID 的逗号分隔列表。标头中最多可以列出大约 400 个站点 ID。

- 对于单个站点：`X-Tableau-Allowed-Sites: siteUUID`
- 对于多个站点：`X-Tableau-Allowed-Sites: siteUUID1,siteUUID2,siteUUID3`

**注意：**如果您的 Tableau Cloud 站点配置为使用[自定义域](https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm)，IT 管理员需要配置 SSL 代理以将 `X-Tableau-Allowed-Sites` 标头添加到对自定义域的请求中。

### 步骤 3：通过代理验证流量路由

配置 SSL 代理后，IT 管理员应验证进入站点的所有用户流量是否都通过配置的 SSL 代理路由，以确保 HTTP 标头应用于每个请求。

### 步骤 4：测试配置

测试配置以验证批准的站点是否可访问，以及未批准的站点是否被阻止。

您可以通过以下方式测试配置：

1. **验证阻止：**通过转到添加到 HTTP 标头的站点 ID 列表中未包括的站点来验证阻止是否有效。
    
    当您看到 HTTP 403（禁止访问）响应时，阻止将起作用。
2. **验证允许的访问权限：**通过转到添加到 HTTP 标头的站点 ID 列表中包含的站点来验证访问是否有效。
    
    当页面正常加载时，访问将起作用。
3. **验证向后兼容性：**通过从代理配置中移除 `X-Tableau-Allowed-Sites` HTTP 标头来验证向后兼容性。导航到您的站点。
    
    当页面正常加载时，向后兼容性起作用。

## 疑难解答

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.css');margin-left: 0;margin-right: auto;" 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><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"><b>问题</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">解决方法</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">用户报告意外的 HTTP 403（禁止访问）错误</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: normal;">意外的 HTTP 403（禁止访问）错误</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">验证标头中的 <code>X-Tableau-Allowed-Sites</code> 站点 ID 与用户尝试访问的站点是否完全匹配。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">用户无法访问任何站点</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: normal;">无法访问所有站点</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">检查 <code>X-Tableau-Allowed-Sites</code> 标头是否包含正确的站点 ID，没有拼写错误或多余的空格。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-weight: bold;"><code>X-Tableau-Allowed-Sites</code> 似乎无法正常工作</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-weight: normal;">功能似乎无法正常工作</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">确认 SSL 代理正在正确将 <code>X-Tableau-Allowed-Sites</code> 标头添加到对 <code>*.online.tableau.com</code> 的请求。</td></tr></tbody></table>

<!-- document id=e4689eb7c841d7989fd309f3a84ba5fcb44fbbb227db00a103f9f7c81865eb6f url=/tableau/next/zh-cn/online/private_connect_migrate_from_bridge.md -->

[跳转到主要内容](#main-content)

# 从 Tableau Bridge 迁移到出站私人连接

Tableau Bridge、Data Connect 和私人连接都满足处理 Tableau Cloud 和专用数据时常见的安全和网络要求。在某些情况下，私人连接提供比 Tableau Bridge 或 Data Connect 更简单、维护成本更低的解决方案，并且您可能希望更新工作簿或数据源，使其使用私人连接，而不是 Tableau Bridge 或 Data Connect。您可以通过更改连接服务器名称（和端口，如果需要）来更新工作簿或数据源以使用私人连接。

## 更新数据源或工作簿以使用专用连接

### 先决条件

您需要知道以下各项：

- 专用连接的连接地址 。站点管理员和云管理员有权访问连接地址。
- 数据库的端口号（如果与当前端口号不同）。端口号取决于 AWS 中端点服务的配置，配置该服务（或与配置该服务的一方交互）的人员应该知道是否需要不同的端口号。站点管理员和云管理员也应该知道该信息。

### 更新连接信息

1. 在左侧导航栏中，选择“浏览”。
2. 转到已发布数据源或工作簿。
3. 如果是数据源，请转到“连接”选项卡。如果是工作簿，请转到“数据源”选项卡。
4. 选择连接或数据源的“操作”菜单 (...)，然后选择“编辑连接”。
5. 将“服务器名称”更改为专用连接的“连接地址”。
6. 将“服务器端口”更改为新端口（如果需要更改）。
7. 将“网络类型”更改为“Tableau Cloud”。
8. 选择“保存”。

### 具有计划数据提取刷新的资产的注意事项

- 将“网络类型”从“专用网络”更改为“Tableau Cloud”不会更改现有数据提取刷新计划使用的网络类型。如果更改具有与其关联的现有数据提取刷新计划的资产使用的网络类型，则必须创建新数据提取刷新计划。
- 通过专用连接进行的数据提取刷新计入[并发刷新](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm#site-extract-refresh-capacity)，而使用 Tableau Bridge 的某些数据提取刷新则不会计入。

<!-- document id=cddea8ac01c8b01e8ad70bab78ceebe36b78be21f88a369c759234aa27eb31ac url=/tableau/next/zh-cn/online/to_refresh_desktop.md -->

[跳转到主要内容](#main-content)

# 从 Tableau Desktop 中刷新已发布数据提取

您可以从 Tableau Desktop 中将更新发送到已发布数据提取。此选项最适合于刷新本地网络上维护的数据的数据提取。

1. 在 Tableau Desktop 中，连接到发布到 Tableau Cloud 的数据源，或打开连接到该数据源的工作簿。
    
    若要连接到服务器，请使用地址 **https://online.tableau.com**。
    
    在“数据”窗格中，发布到 Tableau 服务器的数据源在其名称旁边会显示一个 Tableau 图标。
    
    ![服务器上的示例超市数据源。](/tableau/next/zh-cn/online/zh-cn/Img/DataSourceOnServer.png)
2. 选择“数据”\>“Tableau 数据服务器”，然后选择以下选项之一：
    
    - 从源刷新
        
        使用原始数据源中的数据刷新数据提取（完全或增量）。
        
        此命令仅适用于包含与原始数据源的连接的数据提取。如果您直接连接到数据提取文件，然后将其发布，则不包含与原始数据源的连接。
    - 从数据源追加数据
        
        从工作簿中的其他数据源更新数据提取。
    - 从文件追加数据
        
        如果数据提取的原始数据源类型是基于同一文件的数据源或数据提取文件，则从文件内容更新数据提取。

**注意：** 如果看不到“Tableau 数据服务器”选项，则您的数据源可能发布到 Tableau Cloud（此时将不会显示上面的图标）。如果看到“Tableau 数据服务器”选项，但刷新命令不可用，则表示数据源虽然在服务器上但不是数据提取。例如，它是与 Internet 上托管的数据的实时连接。

## 另请参见

Tableau 帮助的[“提取数据”](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#extracting_data.htm)部分中的主题。

<!-- document id=fac4e6f1ef9da5826b1edb60fead182e02ec37a9ec8fb8a5496971eb676eccd2 url=/tableau/next/zh-cn/online/to_refresh_extract_commandline.md -->

[跳转到主要内容](#main-content)

# 从命令行中自动执行数据提取刷新任务

您可以使用 Tableau 数据提取命令行实用工具自动执行数据提取刷新任务。此实用工具是 Tableau Desktop 附带的一种命令行实用工具，您可以通过其刷新发布的数据提取数据源，或将数据从文件附加到这些数据源。

若要使用 Tableau 数据提取命令行实用工具，需满足以下要求：

- 它在 Windows 上随 Tableau Desktop 一起提供，并且只能在 Windows 系统上运行。
- 它不适用于试用版的 Tableau Desktop。
- 您可以为不使用 Oauth 的数据提取数据源使用该实用工具。
- 您只能使用它来刷新单连接数据源。它不适用于多连接数据源。

**2022 年 10 月已弃用：**由于 Tableau Cloud 中的[多重身份验证](https://help.tableau.com/current/online/zh-cn/to_security_mfa.htm)要求，此实用程序在后续版本中不可用。若要刷新 Tableau Cloud 无法直接访问的数据源或虚拟连接数据，请改用 Tableau Bridge。有关详细信息，请参见[设置 Bridge 刷新计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm)。  
  
若要使用脚本启动刷新作业，请使用 tabcmd [refreshextracts](https://help.tableau.com/current/server/zh-cn/tabcmd_cmd.htm#refreshextracts-workbookname-or-datasourcename) 或 REST API [运行数据提取刷新任务](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#run_extract_refresh_task)。

## 运行实用工具

1. 以管理员身份打开命令提示符，并转到 Tableau Desktop bin 目录。例如：
    
    `cd C:\Program Files\Tableau\Tableau 2022.4\bin`
2. 使用下列命令之一，并添加下表中描述的参数。
    
    - `tableau refreshextract`
    - `tableau addfiletoextract`

**注意：**使用此实用工具时，始终要在命令行上或脚本中指定 `tableau`，决不要指定 `tableau.exe`。

**注意：**若要进行故障排除，请在 \\我的 Tableau 存储库\\Logs 文件夹中检查 tableaucom.txt 文件中的日志。

**注意**：在多站点环境中，指定命令将应用于的站点。

## tableau refreshextract 命令的语法和参数

使用 `tableau refreshextract` 可刷新 Tableau Server 或 Tableau Cloud 上的数据提取。刷新数据提取将会使用自上次刷新后对数据源所做的任何修改更新现有数据提取。

要查看此命令的帮助，请在 Windows 命令提示符处键入以下命令：

`tableau help refreshextract`

### 使用参数

- 所有选项都有一个与双连字符结合使用的完整形式（例如，`--server`）。
- 有些选项还有一个与单连字符结合使用的短形式（例如，`-s`）。
- 如果选项的值包含空格，则用引号将选项值引起来。
- 所刷新的数据源必须是原始数据源，而不是数据提取 (`.hyper`)。

### tableau refreshextract 命令选项

<table><colgroup><col style="width: 25%;"><col style="width: 30%;"><col style="width: 45%;"></colgroup><tbody><tr><td><b>短形式</b></td><td><b>完整形式</b></td><td><b>描述</b></td></tr><tr><td>&nbsp;</td><td><code>--source-username &lt;user name&gt;</code></td><td><p>数据源连接的有效用户名。</p><p>将此选项与 <code>--source-password</code> 结合使用，或使用</p><p><code>--original-file</code>，而不是用户名和密码选项。</p><p class="note"><b>注意</b>：在刷新发布的数据提取时必须提供用户和密码，即使最初是利用嵌入式凭据发布数据源的。</p></td></tr><tr><td>&nbsp;</td><td><code>--source-password "&lt;password&gt;"</code></td><td><p>数据源用户的密码。</p></td></tr><tr><td>&nbsp;</td><td><p><code>--original-file &lt;path and file name&gt;</code></p><p>或</p><p><code>--original-file&nbsp;&lt;path and folder name&gt;</code></p></td><td><p>将在服务器上进行刷新的数据源的路径和文件名。例如：<code>--original-file c:\folder\file.csv</code></p><p>若要刷新多文件数据源，请将路径传递到包含数据文件的文件夹。例如：<code>--original-file c:\folder</code>。</p><p>如果文件位于网络共享上，请为路径使用 UNC 格式：<code>\\server\path\filename.csv</code></p></td></tr><tr><td>&nbsp;</td><td><code>--force-full-refresh</code></td><td><p>如果数据源设置为进行增量刷新，请使用此选项强制对数据提取进行完整刷新。如果不包括此选项，则执行增量刷新。并非所有数据源都支持增量刷新。</p></td></tr><tr><td><code>-s &lt;server http address&gt;</code></td><td><code>--server  &lt;URL&gt;</code></td><td><p>在其中发布数据的 Tableau Server 的 URL。</p><p>对于 Tableau Cloud，请指定 <code>https://online.tableau.com</code>。</p></td></tr><tr><td><code>-t &lt;site id&gt;</code></td><td><code>--site &lt;siteid&gt;</code></td><td><p>在多站点环境中，指定命令将应用于的站点。对于 Tableau Cloud，如果您的用户名与一个以上的站点关联，请使用此参数。对于 Tableau Server，如果未指定站点，则使用默认站点。</p><p>站点 ID 独立于站点名称，当您在浏览器中查看站点时，它会显示在 URL 中。例如，如果您登录到 Tableau Cloud 后看到的页面的 URL 是</p><pre xml:space="preserve">https://online.tableau.com/t/vernazza/views</pre><p>站点 ID 是 <i>vernazza</i>。</p></td></tr><tr><td>&nbsp;</td><td><code>--datasource &lt;datasource&gt;</code></td><td><p>发布到 Tableau Server 或 Tableau Cloud 的数据源的名称。</p></td></tr><tr><td>&nbsp;</td><td><code>--project &lt;projectname&gt;</code></td><td><p>数据源所属的项目。如果不包括此选项，则假定为默认项目。</p><p>如果要指定的项目是嵌入在项目分层结构内的子项目，则必须随 <code>--parent-project-path</code> 参数一起使用此参数。</p></td></tr><tr><td>&nbsp;</td><td><code>--parent-project-path path/to/project</code></td><td><p>如果将数据源发布到的项目没有位于项目分层结构的顶层，请随 <code>--project</code> 参数一起使用此参数以指定嵌套项目的路径。</p><p>使用正斜杠字符 (<code>/</code>) 来分隔分层结构中的项目级别。使用反斜杠 (<code>\</code>) 对项目名称中的正斜杠或反斜杠字符进行转义。</p><p>例如，对于顶层“Marketing”下的项目“Social”中名为 Sandbox 的项目：</p><p><code>--project Sandbox --parent-project-path Marketing/Social</code></p></td></tr><tr><td><code>-u &lt;user name&gt;</code></td><td><code>--username &lt;username&gt;</code></td><td><p>有效的 Tableau Server 或 Tableau Cloud 用户。</p></td></tr><tr><td><code>-p "&lt;password&gt;"</code></td><td><code>--password  "&lt;password&gt;"</code></td><td><p>指定的 Tableau Server 或 Tableau Cloud 用户的密码。</p></td></tr><tr><td>&nbsp;</td><td><code>--proxy-username &lt;username&gt;</code></td><td><p>代理服务器的用户名。</p></td></tr><tr><td>&nbsp;</td><td><code>--proxy-password "&lt;password&gt;"</code></td><td><p>代理服务器的密码。</p></td></tr><tr><td><code>-c "&lt;path and file name&gt;"</code></td><td><code>--config-file  "&lt;path and file name&gt;"</code></td><td><p>包含命令配置选项的文件的路径和文件名信息。始终将路径括在双引号内。有关详细信息，请参见下面的<a href="#Using" class="xref">使用配置文件</a>。</p></td></tr></tbody></table>

### tableau refreshextract 示例命令

以下命令可刷新已发布到 Tableau Cloud、名为 CurrentYrOverYrStats 的数据提取。此命令指定以下内容：

- Tableau Cloud 用户和密码。
- Tableau Cloud 站点和项目名称。
- 数据源以及用于登录托管数据源的用户名和密码，在本例中，数据库源由云端数据源提供商（例如 Salesforce.com）托管。

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username database_user@hosted_datasource_provider.com --source-password "db_password"`

若要刷新基于文件的数据源的数据提取，请提供您从中创建数据提取的原始文件路径。如果文件位于网络共享上，请使用 UNC 格式，而不是映射的驱动器。

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --original-file "\\server\path\filename.csv"`

## tableau addfiletoextract 的语法

使用 `tableau addfiletoextract` 将文件内容附加到已发布到 Tableau Server 或 Tableau Cloud 的数据提取。此命令组合两个文件。

如果只想使用最新更改更新现有数据提取，请使用 `refreshextract` 命令。使用 `addfiletoextract` 更新现有数据提取将会复制数据。

要查看此命令的帮助，请在 Windows 命令提示符处键入以下命令：

`tableau help addfiletoextract`

所有选项都有一个与双连字符结合使用的完整形式（例如，`--server`）。有些选项还有一个与单连字符结合使用的短形式（例如，`-s`）。如果选项的值包含空格，则用引号将选项值引起来。

### tableau addfiletoextract 命令选项

<table><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"><b>完整形式</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>描述</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--file &lt;path and file name&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>包含要追加的数据的数据文件的路径和文件名信息。该文件可来自 Excel、Access、Tableau 数据提取，或者带分隔符的文本文件。它不能受密码保护。如果文件位于网络共享上，请使用 UNC 格式。例如，<code>\\server\path\filename.csv</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-s &lt;server http address&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--server  &lt;URL&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>在其中发布数据的 Tableau Server 的 URL。</p><p>对于 Tableau Cloud，请指定 <code>https://online.tableau.com</code>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-t &lt;site id&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--site &lt;site id&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>在多站点环境中，指定命令将应用于的站点。对于 Tableau Cloud，如果您的用户名与一个以上的站点关联，则必须包括此参数。对于 Tableau Server，如果未指定站点，则使用默认站点。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--datasource &lt;datasource&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>发布到 Tableau Server 或 Tableau Cloud 的数据源的名称。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--project &lt;projectname&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>数据源所属的项目。如果不包括此选项，则假定为默认项目。</p><p>如果要指定的项目是嵌入在项目分层结构内的子项目，则必须随 <code>--parent-project-path</code> 参数一起使用此参数。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--parent-project-path path/to/project</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>如果将数据源发布到的项目没有位于项目分层结构的顶层，请随 <code>--project</code> 参数一起使用此参数以指定嵌套项目的路径。</p><p>使用正斜杠字符 (<code>/</code>) 来分隔分层结构中的项目级别。使用反斜杠 (<code>\</code>) 对项目名称中的正斜杠或反斜杠字符进行转义。</p><p>例如，对于顶层“Marketing”下的项目“Social”中名为 Sandbox 的项目：</p><p><code>--project Sandbox --parent-project-path Marketing/Social</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-u &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--username &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>有效的 Tableau Server 或 Tableau Cloud 用户。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>-p "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--password  "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>指定的 Tableau Server 或 Tableau Cloud 用户的密码。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--proxy-username &lt;username&gt;</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>代理服务器的用户名。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>--proxy-password "&lt;password&gt;"</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>代理服务器的密码。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>-c "&lt;path and filename&gt;"</code></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>--config-file "&lt;path and filename&gt;"</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>包含命令配置选项的文件的路径和文件名信息。始终将路径括在双引号内。有关详细信息，请参见下面的<a href="#Using" class="xref">使用配置文件</a>。</p></td></tr></tbody></table>

### tableau addfiletoextract 示例命令

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau addfiletoextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --file "C:\Users\user2\Documents\DataUploadFiles\AprMay.csv"`

## 使用配置文件

可以使用纯文本编辑器（例如记事本或 Text Edit），来创建可用于 `tableau refreshextract` 或 `tableau addfiletoextract` 的配置文件。如果希望在一段时间内定期更新同一数据源，配置文件可能非常有用。指定配置文件后，就无需在每次运行命令时都键入相同的选项。配置文件还有一个优势，那就是不会在命令行上泄漏用户名和密码。

### 创建配置文件

例如，假设您创建了一个名为 config.txt 的文件并将它保存到您的 Documents 文件夹。在该文件中，您包含了下面显示的参数信息。

对于从托管数据源发布到 Tableau Cloud 的数据源（其中**服务器**为 **https://online.tableau.com**）：

`server=https://online.tableau.com   site=vernazza   username=email@domain.com   password=OurPassword   project=New Animations   datasource=CurrentYrOverYrStats   source-username=database_user@hosted_datasource_provider.com   source-password=db_password`

### 在命令行中引用配置文件

创建配置文件后，可以运行 `tableau refreshextract` 或 `tableau addfiletoextract` 命令，指向配置文件，将其作为命令行中使用的唯一选项，并将配置文件的路径括在双引号内。语法如下：

`tableau refreshextract --config-file "<path>"`

例如，若要刷新在[创建配置文件](#Create)部分的示例中指定的数据提取，应运行以下命令（确保在所用 Tableau Desktop 版本的 bin 目录中工作）：

`C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --config-file "C:\Users\user1\Documents\config.txt"`

### 配置文件的语法差异

用于在配置文件内指定选项的语法与命令行中使用的语法在以下方面有所不同：

- 选项名称不以短横线或连字符开头。
- 可使用等号（不含空格）分隔选项名称和选项值。
- 值不需要（或不允许）用引号引起来，即使它们包含空格也是如此（就像前面示例中的 `project` 选项）。

## 使用 Windows 任务计划程序刷新数据提取

您可将 Windows 任务计划程序与 Tableau 数据提取命令行实用工具结合使用，以便从企业防火墙内自动执行对 Tableau Cloud 数据源的定期更新。可将任务配置为每天、每周或每月执行一次，或者在发生特定系统事件后执行。例如，在计算机启动时运行任务。

若要了解详细信息，请参见 Microsoft TechNet 库中的[任务计划程序使用指南](http://technet.microsoft.com/zh-cn/library/cc766428.aspx)页。

<!-- document id=14a686bdb05b31ec3b1a17952eab9a49f6a1748c21b75e16e1fdc9e7436a1f5d url=/tableau/next/zh-cn/online/to_external_kms_migrate.md -->

[跳转到主要内容](#main-content)

# 从客户管理的加密密钥迁移到外部 KMS

> [!WARNING]
> 
> **注意：**从客户管理的加密密钥切换到外部密钥管理服务 (KMS) 是永久性的，无法撤消。有关使用外部 KMS 的详细信息，请参见[使用外部 KMS 进行密钥管理](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm)。

从客户管理的加密密钥（使用 Salesforce 的 KMS）迁移到外部 KMS 很简单，但它是永久性的，无法撤消。更改后，您将在外部 KMS 而不是 Salesforce 的 KMS 中管理密钥。在从客户管理的加密密钥迁移到外部 KMS 之前，请确保您了解如何在外部 KMS 中执行基本密钥功能。

迁移后，从外部 KMS 派生的密钥将写入新的数据提取。Salesforce KMS 密钥将继续读取其写入的数据提取，直到使用基于 KMS 的外部密钥刷新数据提取。

有关客户管理的加密密钥和 Salesforce KMS 的详细信息，请参见[客户管理的加密密钥](https://help.tableau.com/v0.0/online/zh-cn/to_customer_managed_encryption_keys.htm)。

从客户管理的加密密钥迁移到外部 KMS：

1. 登录到您的 Tableau Cloud 站点。
2. 在左侧导航窗格中选择“设置”。
3. 选择“安全”选项卡。
4. 在“数据提取加密”部分下，将选择从“使用 Salesforce KMS”更改为“使用外部 KMS”。
5. 阅读警告，然后选择“切换到外部 KMS”。

<!-- document id=84eb14fb4075b236ba46a4753e35bff58d3c87386f54bca8ee0d925c273afa7f url=/tableau/next/zh-cn/online/whatsnew_previous_versions_online.md -->

[跳转到主要内容](#main-content)

# 以前版本的 Tableau Cloud 中引入的功能

> [!TIP]
> 
> 若要查看自 2022 年 6 月以来添加的最新 Tableau Cloud 内容，请使用[Tableau Cloud 发行说明](https://help.tableau.com/v0.0/online/zh-cn/whatsnew_online.htm)中的“Tableau Release Navigator”。

浏览以前发布的版本功能的摘要。

[所有 Tableau Cloud 发行说明](https://www.tableau.com/zh-cn/support/releases/online "所有 Tableau Cloud 发行说明") | [所有已知问题](https://issues.salesforce.com/ "所有已知问题")

## 早期版本中的新增功能

2022 年 6 月新增

### 使用 Azure Active Directory 预置用户和组

站点管理员现在可以自动完成用户管理、预置组，并通过 Azure Active Directory 分配 Tableau Cloud 角色。有关详细信息，请参见[使用 Microsoft Entra ID 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_azure_ad.htm)。

### 使用 Tableau 已连接应用授权访问 Tableau REST API

使用已连接应用，您可以使用 JSON Web 令牌 (JWT) 以编程方式代表用户授权访问 REST API。

有关详细信息，请参见[已连接应用的访问范围](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm)。

### 默认情况下为每个站点启用“数据解释”功能

默认情况下，站点管理员可以使用站点设置和“数据解释”功能权限启用“数据解释”功能。作者不再需要在“数据解释设置”对话框中设置工作簿选项“允许在线查看时在此工作簿中使用‘数据解释’功能”（该工作簿设置已移除）。在查看模式下访问“数据解释”功能取决于站点设置、站点角色和“数据解释”功能权限。

有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。

### 调整指标的比较和日期范围

您现在可以编辑指标的配置以更改比较、日期范围和状态指标。以前，您只能在创建指标时配置这些选项。有关详细信息，请参见[编辑指标的配置](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm#config)。

### 将 Tableau 数据故事添加到仪表板

现在，您可以在 Tableau Cloud 中创建数据故事，并且只能创建英文版本。数据故事会在您的仪表板中自动生成叙述性见解，从而节省时间并呈现相关见解。当您与仪表板交互时，数据故事编写的故事会调整，让您更深入地研究数据并更快地识别关键见解。有关详细信息，请参见[创建 Tableau 数据故事（仅限英文）](https://help.tableau.com/v0.0/online/zh-cn/data_stories.htm)。

### 编辑已发布数据源

自 6 月起，您现在可以编辑更多类型的连接，包括 Amazon Athena、OData、Databricks 和 SharePoint 列表。有关详细信息，请参见[编辑已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/edit_datasources.htm)。

### 自动暂停加速视图

您现在可以为消耗不必要资源的视图自动暂停加速。设置加速任务在每天、每周或每月自动挂起加速之前的失败次数阈值。有关详细信息，请参见[“视图加速”](https://help.tableau.com/current/server/zh-cn/data_acceleration.htm)。

### 了解 ICU 68.2 升级

为了提高安全性和提供更好的语言支持，我们正在升级到当前的 Unicode 国际化组件 (ICU) 库 68.2。此更新解决了排序问题，并能更好地处理新的 Unicode 字符。此更新可能会影响仪表板排序、筛选和计算。如果您在计算字段中使用字符串比较，请确认您的计算仍按预期工作。有关详细信息，请参见[字符串函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_string.htm)。

### Tableau Catalog - 数据管理的一部分

**“数据问答”(Ask Data) 功能镜头出现在世系中** - 世系窗格现在包含镜头信息。有关详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm)。

### 虚拟连接 - 数据管理的一部分

**虚拟连接支持修订历史** - 修订历史可让您查看对连接的更改、删除修订或将连接还原到以前的版本。

**数据策略测试的增强筛选器功能** - 在虚拟连接编辑器中，当您预览应用了数据策略的数据时，您现在可以看到策略允许的值和被筛选掉的值。

### Tableau Bridge 对 Oauth 的支持

Tableau Bridge 现在支持将 OAuth 作为一种身份验证方法来连接到：Snowflake、Google BigQuery、Google 云端硬盘、Salesforce 和 OneDrive。使用 OAuth 提供比基本用户名和密码身份验证更好的安全性，并且更易于管理。有关详细信息，请参见[发布基于已启用 OAuth 的私有云的数据源](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm#oauth_bridge)。

2022 年 5 月新增

### “在线管理见解”作业性能数据源

使用“在线管理见解”更深入地了解您的站点。您现在可以连接到“作业性能”数据源以查看站点上后台作业的事件和运行时信息。作业包括数据提取刷新、Bridge 刷新和流程运行。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

2022 年 3 月新增

### Bridge 池的 IPv4 地址支持

将域映射到 Bridge 池时，站点管理员可以在专用网络允许列表中指定 IPv4 地址，以刷新在其连接中使用 IPv4 地址的数据源和虚拟连接。有关详细信息，请参见[IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#ip)。

### 加快视图的加载时间

工作簿所有者、站点管理员和服务器管理员现在可以加快其视图的加载时间。“视图加速”预先计算长时间运行的查询，因此加速工作簿的加载速度更快。有关详细信息，请参见[“视图加速”](https://help.tableau.com/current/server/zh-cn/data_acceleration.htm)。

![“视图加速”窗口](/tableau/next/zh-cn/online/zh-cn/Img/view_acceleration.png)

### 自定义“查看数据”窗口

在工作表中，您可以在“查看数据”窗口中自定义数据的表格显示。从默认视图中移除列、更改列顺序、对列进行排序或添加列以提供更深入的上下文。然后，您可以将基础数据的自定义视图下载为 CSV 文件以与您的团队共享。

**注意**：当您自定义“查看数据”窗口时，更改仅在“查看数据”窗口打开时保留。

Tableau Cloud、Tableau Server 和 Tableau Desktop 中提供了新的“查看数据”窗口和自定义选项。有关详细信息，请参见[查看基础数据](https://help.tableau.com/current/pro/desktop/zh-cn/inspectdata_viewdata.htm)。

Tableau Cloud、Tableau Server 和 Tableau Desktop 中的键盘导航和屏幕阅读器可以访问“查看数据”窗口及其选项。有关详细信息，请参见“Tableau 的键盘辅助功能”中的[“查看数据”窗口](https://help.tableau.com/current/pro/desktop/zh-cn/access_keyboard_navigation.htm#view-data-window)。

### 在 Web 上打开工作簿的工作表描述

Tableau Cloud 和 Tableau Server 中现在提供工作表描述。在 Web 上编辑工作簿时，在“工作表”菜单中选择“工作表描述”。字段描述也在 Web 上提供。有关详细信息，请参见[获取有关工作簿中的字段和工作表的详细信息](https://help.tableau.com/current/pro/desktop/zh-cn/inspectdata_describe.htm)。

### Tableau 中搜索行为的变化

从 2022 年春季版本开始，Tableau 中“搜索结果”页面上的搜索功能发生了变化。在此版本之前，内容被编入索引以允许“部分令牌匹配”。这意味着您可以搜索部分字符串。举例来说，如果您搜索“super”，结果可能包括在标题、描述和列中包含“Superstore”一词的内容，即使“super”一词本身并不存在。

从 2022 年春季开始，索引以一种新的方式完成，同时支持“完全令牌匹配”和“模糊令牌匹配”。这意味着您看到的结果将基于完整的字符串，并且不会进行部分匹配。模糊匹配提供对完整字符串的部分匹配。若要查找“Superstore”，您需要搜索“superstore”或整个字符串的某些变体，例如“supertor”、“sperstore”，或者”superstores”。仅搜索“super”不会返回该匹配项。这种方法的目标和好处是减少噪音，将结果限制为与您的搜索字符串更匹配的内容。

关于利用此更改的建议：

- 在查询中使用完整的单词
- 搜索出现在内容标题或描述中的单词

#### 快速搜索

快速搜索的行为没有改变，因此仍然支持部分令牌匹配，但这意味着快速搜索中的结果可能与“搜索结果”页面中的结果不同。

### Tableau Catalog - 数据管理的一部分

**虚拟连接的认证和数据质量警告**\- 您现在可以认证和设置虚拟连接的数据质量警告。

**虚拟连接出现在世系中**\- 世系窗格现在包含虚拟连接和虚拟连接表信息。有关详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm)。

#### 开发人员资源

**元数据 API 中的虚拟连接** - 虚拟连接和虚拟连接表现在可以使用元数据 API 进行寻址，并且可以在使用时出现在输出中。有关详细信息，请参见 Tableau 元数据 API 参考中的[了解元数据模型](https://help.tableau.com/current/api/metadata_api/zh-cn/docs/meta_api_model.html)。

### 虚拟连接 - 数据管理的一部分

**Salesforce 连接器支持虚拟连接**\- 您可以将 Tableau 连接到您的 Salesforce 数据，并创建实现行级安全性的虚拟连接和数据策略。有关虚拟连接的详细信息，请参见[关于虚拟连接和数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm)。

**添加到空间使用视图的虚拟连接** - 虚拟连接作为对象类型添加到“空间使用情况统计数据”视图中，因此管理员可以查看虚拟连接使用了多少磁盘空间。

2022 年 1 月新增

### 为 Salesforce CDP 设置 OAuth

作为 Tableau Cloud 站点管理员，您可以为 Salesforce CDP 设置 OAuth。有关详细信息，请参见[将 Tableau Cloud Web 制作连接到 Salesforce Data Cloud](https://help.tableau.com/v0.0/online/zh-cn/config_oauth_sfdc_cdp_online.htm)。

### 更新“在线管理见解”数据源

作为 Tableau Cloud 站点管理员，您现在可以指定在您的站点上更新“在线管理见解”数据源的频率。有关详细信息，请参见[管理“在线管理见解”](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights_manage.htm)。

### Tableau Cloud 登录更新

对于添加到多个 Tableau Cloud 站点的用户，登录过程现在将提示用户输入他们尝试访问的站点的站点 URI。有关详细信息，请参见[登录 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm)。

### 使用“在线管理见解”获取视图加载时间

使用新的“在线管理见解”数据源更深入地了解您的 Tableau Cloud 站点。您现在可以连接到“可视化项加载时间”以查看您的站点上发布的视图的加载时间信息。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

2021 年 12 月新增

### 重置 MFA 验证方法

站点管理员现在可以为丢失所有常用 MFA 验证方法并被锁定在站点之外的用户重置 MFA。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm#mfa_locked_out)。

### 支持 IdP 发起的 SLO

除了支持服务提供商 (SP) 发起的单点注销 (SLO) 之外，Tableau Cloud 还支持身份提供程序 (IdP) 发起的 SLO。有关 SAML 和要求的详细信息，请参见[Tableau Cloud 的 SAML 要求](https://help.tableau.com/v0.0/online/zh-cn/saml_online_requ.htm)。

### 使用 Tableau 已连接应用为嵌入式内容启用 SSO

在 2022 年 1 月初，作为站点管理员，您可以使用 Tableau 已连接应用来创建和管理 Tableau Cloud 站点与嵌入 Tableau 内容的自定义应用程序之间的显式信任关系。通过已连接应用连接，您可以限制可以嵌入的内容以及可以嵌入内容的位置，并使用户能够使用单点登录 (SSO) 访问嵌入式内容，而无需与身份提供程序 (IdP) 集成。有关详细信息，请参见[使用 Tableau 已连接应用进行应用程序集成](https://help.tableau.com/v0.0/online/zh-cn/connected_apps.htm)。

### 在多个私有网络中使更多数据保持最新

站点管理员现在可以配置多个 Bridge 池对数据新鲜度任务进行负载平衡。池可以映射到域，使您能够通过限制对私有网络中受保护域的访问，将池专用于使特定数据保持最新和维护安全。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。

### 直接在 Tableau Cloud 中计划和管理基于文件的数据源的刷新

从 Bridge 版本 2021.4.3 开始，使用 Bridge 的基于文件的数据源的刷新将与 Online 计划集成。发布者可以直接从 Tableau Cloud 中计划和管理基于文件的数据源的刷新计划。有关详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

**注意：**您的站点管理员必须在映射到基于文件的数据源所在域的池中至少拥有一个 Bridge 2021.4.3 客户端。

### 虚拟连接的数据新鲜度支持

使用 Bridge 使连接到私有网络数据的新虚拟连接保持最新。必须为您的站点启用 Data Management 才能创建和使用虚拟连接。有关虚拟连接的详细信息，请参见[关于虚拟连接和数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm)。

### 编辑已发布数据源

在 Tableau Cloud 中，您现在可以编辑已发布数据源。以前，只能编辑嵌入在工作簿中的数据源。

无论您是创建新的已发布数据源还是编辑现有的已发布数据源，您都可以从“数据源”页面创建联接并编辑架构。然后，在发布数据源之前使用 Scratchpad 测试您的更改、创建文件夹、组织层次结构以及重命名字段和别名 — 所有这些操作都无需离开 Tableau。有关详细信息，请参见[编辑已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/edit_datasources.htm)。

![“编辑数据源”按钮](/tableau/next/zh-cn/online/zh-cn/Img/edit_published_data_source.png)

### 复制和粘贴仪表板对象

您现在可以在当前仪表板内或从其他工作表和文件中的仪表板复制和粘贴对象。但是请注意，您无法复制仪表板中的工作表、依赖特定工作表的项（例如筛选器）或设备布局上的对象。有关不受支持的项的完整列表和详细说明，请参见[“复制对象”](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm#Copy)。

![展开的仪表板对象上下文菜单，其中已选中“复制仪表板项”选项。](/tableau/next/zh-cn/online/zh-cn/Img/dashboard_copy_object.png)

### 在仪表板、故事和工作表中重播动画

现在，无论您在何处使用 Tableau，都可以在仪表板、故事和工作表中重放动画。单击“重播”按钮可倒带并重播最近的动画。您还可以选择所需的动画重播速度：实际速度、2 倍速度或 1/2 倍速度。动画可帮助您查看上下文中的数据变化情况，以便您可以对数据做出更好的结论。有关详细信息，请参见[设置动画格式](https://help.tableau.com/v0.0/online/zh-cn/formatting_animations.htm)。

![单击“重播”按钮并更改重播速度的动画](/tableau/next/zh-cn/online/zh-cn/Img/replay_animations.gif)

### 与 Slack 共享“数据问答”(Ask Data) 功能可视化项

如果您的 Tableau 管理员已配置 Slack 集成，您可以与有权访问镜头的任何人快速共享“数据问答”(Ask Data) 功能可视化项。在浏览器的右上角，单击“共享”图标，然后在文本框中输入特定的用户名。

![“共享”图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_link.png)

有关详细信息，请参见[通过电子邮件、Slack 或链接共享“数据问答”(Ask Data) 功能可视化项](https://help.tableau.com/v0.0/online/zh-cn/ask_data.htm#Share)。

### 使用先前为“数据问答”(Ask Data) 功能中的分析功能保留的术语

以前，“数据问答”(Ask Data) 功能会忽略在数据源字段名称和值中找到的分析术语。但现在它像处理任何其他形式的数据一样处理“平均”、“组”、“筛选”、“限制”、“排序”和“日期”等术语，让您无需修改其内容即可分析数据源。

### 在“数据问答”(Ask Data) 功能中查询具有表计算的字段

“数据问答”(Ask Data) 功能现在可让您查询具有表计算的字段。请注意，您不能在这些计算的查询表达式中包含筛选器、限制或“年度差异”比较。

### 将“数据问答”(Ask Data) 功能镜头添加到收藏夹

您现在可以将“数据问答”(Ask Data) 功能镜头添加到站点的“收藏夹”列表中，帮助您轻松返回它们。

### 向“数据问答”(Ask Data) 功能镜头作者提供反馈

如果您对镜头的结构或如何最好地将其与“数据问答”(Ask Data) 功能结合使用有疑问，可以将反馈直接发送给作者。

在“数据问答”(Ask Data) 功能查询框的左侧，单击“i”图标。

![将鼠标悬停在信息图标上，显示“数据问答”(Ask Data) 功能提示工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_tips_button.png)

然后，在提示对话框底部，单击“联系镜头作者”。

默认情况下启用此选项，但镜头作者可以按照[让用户通过电子邮件向您发送有关镜头的问题](https://help.tableau.com/v0.0/online/zh-cn/ask_data_lenses.htm#Let)中的步骤将其隐藏。

### 在制作“数据问答”(Ask Data) 功能镜头时重命名字段和表

如果数据源中的字段和表名称未反映您的用户会识别的术语，镜头作者现在可以为每个镜头重命名这些项。

在左侧，将鼠标悬停在单个表或字段上，然后单击铅笔图标：

![字段列表，其中某个值旁边带有编辑图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_synonyms.png)

然后单击右侧的铅笔图标，提供更具代表性的名称。

![带有编辑图标的字段详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_rename.png)

有关详细信息，请参见[在 Tableau 站点上创建或配置镜头页面](https://help.tableau.com/v0.0/online/zh-cn/ask_data_lenses.htm#Create)。

### 将指标嵌入网页

通过嵌入指标，在相关的网页和应用中包含指标。若要嵌入指标，请复制 Tableau 站点上提供的嵌入代码或编写您自己的嵌入代码。嵌入的指标遵循与 Tableau Cloud 或 Tableau Server 上嵌入指标的站点相同的登录和权限限制，因此您的指标数据是安全的。有关详细信息，请参见[“将指标嵌入网页”](https://help.tableau.com/current/pro/desktop/zh-cn/embed_metrics.htm)。

### 为指标配置新的比较和状态

创建指标时，您现在可以调整日期范围、配置历史比较和设置状态指标。您设置的比较和状态显示在指标卡上，为用户提供一个易于理解的指标，表明与之前的时间点或您定义的特定值相比，指标的表现如何。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm)。

![具有良好和不良状态的利润指标网格](/tableau/next/zh-cn/online/zh-cn/Img/metrics_grid.png)

### Salesforce 在线管理见解和非营利云

连接到 Salesforce 后，您现在可以为 Salesforce 在线管理见解和非营利云发布其他工作簿和数据源。内容是为您的组织定制的，允许您在 Tableau Cloud 中浏览您的 Salesforce 数据。有关详细信息，请参见[使用 Salesforce 数据创建工作簿](https://help.tableau.com/v0.0/online/zh-cn/to_connect_salesforce.htm)。

### Data Management

### 虚拟连接和数据策略 - Data Management 的一部分

虚拟连接和数据策略包含在 Tableau Cloud 单独许可的 Data Management 功能中。这些新的数据管理功能使您能够为用户提供单一、集中的数据库连接，并使用数据策略在连接中的表上定义行级安全性。有关详细信息，请参见[关于虚拟连接和数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm)。

#### 通过虚拟连接，您可以获得快速帮助

在您创建和测试新的虚拟连接时，只需单击一下即可获得帮助。产品中提供的快速帮助会根据您在虚拟连接编辑器中的位置或正在执行的操作显示相关的即时帮助内容。只需单击屏幕右上角的“?”图标即可打开可移动的帮助窗口。

![产品中出现快速帮助窗格](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_quick_help.png)

### Tableau Catalog - 数据管理的一部分

**内容世系页面上的自定义 SQL 信息**\- Catalog 世系页面显示的信息可帮助用户更多地了解其内容中的自定义 SQL。

- 世系页面上的横幅标识使用自定义 SQL 的内容。
- 您可以查看自定义 SQL 查询。
- 对于可能导致世系不完整的自定义 SQL 查询，会显示一条警告。

有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[支持的世系](https://help.tableau.com/current/pro/desktop/zh-cn/customsql.htm#supported-lineage)。

**Tableau Catalog 在自定义 SQL 查询中支持 T-SQL 方言** - 支持 T-SQL 方言意味着 Tableau Catalog 在使用自定义 SQL 时可以提供更完整的世系。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[支持的查询](https://help.tableau.com/current/pro/desktop/zh-cn/customsql.htm#supported-queries)。

**电子邮件中的数据质量警告链接会自动打开“数据详细信息”窗格** - 当您单击订阅电子邮件中的数据质量警告时，该视图将打开并显示“数据详细信息”窗格。此外，新的嵌入参数 showDataDetails 可用于打开显示“数据详细信息”窗格的视图。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[嵌入代码的参数](https://help.tableau.com/current/pro/desktop/zh-cn/embed_list.htm)。

**继承的描述出现在世系页面上的字段列表中** - 如果字段上游存在字段描述，则该描述现在会显示在世系页面上的字段列表中，并提供有关该描述从何处继承的信息。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[如何继承字段描述](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#how-field-descriptions-are-inherited-if-tableau-catalog-is-enabled)。

**基于外部资产轻松创建 Prep 流程** - 您现在可以使用数据库和表作为 Prep Web 制作中新流程的起点。有关详细信息，请参见 Tableau Prep 帮助中的[启动新流程](https://help.tableau.com/current/prep/zh-cn/prep_startflow.htm#start-a-new-flow)。

2021 年 9 月新增

### 在 Slack 中共享、协作和跟踪您的数据

您现在可以使用 Tableau for Slack 应用程序在 Slack 中查看 Tableau 通知，该应用程序允许 Tableau Cloud 站点管理员连接到 Slack 工作区。连接之后，获得许可的 Tableau 用户可以在团队成员与他们共享内容、在评论中提及他们或数据达到数据驱动型通知中的指定阈值时在 Slack 中接收通知。有关详细信息，请参见[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm)。

### 在个人空间中保存工作簿

Creator 和 Explorer 现在可以编辑内容并将其保存到个人空间，这是 Tableau 站点上每个 Web 作者的私有位置。保存到个人空间的内容对用户是私有的，并由新增的资源管控功能控制。在“设置”中，您可以启用个人空间并设置用户存储限制。管理员可以继续访问和管理所有内容，包括个人空间内容。有关详细信息，请参见[在个人空间中创建和编辑私有内容](https://help.tableau.com/v0.0/online/zh-cn/personal_space.htm)。

### 设置您的工作簿数据新鲜度策略

通过使用工作簿数据新鲜度策略在性能和数据新鲜度之间取得平衡。尽管缓存数据对于实时连接工作簿的性能非常有用，但在可视化项中看到陈旧的缓存数据可能会导致工作簿用户感到困惑和沮丧。现在有了数据新鲜度策略，工作簿所有者或管理员可以选择精细的数据新鲜度策略，以便在您的业务需要时显示最新鲜的数据。

从 Tableau Cloud 或 Tableau Server 的“工作簿详细信息”对话框中，选择**“编辑数据新鲜度策略”**。然后选择以下各项之一：

- **站点默认值**（在 Tableau Cloud 中为 12 小时）
- **始终为实时**（Tableau 将始终获取最新数据。）
- **确保数据保持最新的间隔**...然后设置您的时间间隔，例如每 12 小时一次。
- **确保数据保持最新的时间**...然后设置您的日期和时间，例如星期一、星期三和星期五太平洋时间上午 09:00。

数据新鲜度策略允许您按满足业务需求的计划优化工作簿性能。有关详细信息，请参见[为查询缓存设置数据新鲜度策略](https://help.tableau.com/v0.0/online/zh-cn/data_freshness_policy.htm)。

![编辑数据新鲜度策略的动画](/tableau/next/zh-cn/online/zh-cn/Img/data_freshness.gif)

### 重命名已发布数据源

在 Tableau Cloud 和 Tableau Server 中，您现在可以重命名您具有**“保存”**权限的已发布数据源。若要重命名已发布数据源，请单击**“更多操作”**菜单，然后选择**“重命名”**— 就像重命名工作簿一样。您还可以使用[更新数据源 REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_data_source)重命名已发布数据源。重命名已发布数据源后，使用该数据源的所有工作簿将在下一次数据源刷新完成后使用新名称。有关详细信息，请参见[“发布的数据源的最佳做法”](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources_about.htm)。

### 使用轴动画查看和理解比例变化

Tableau Desktop、Tableau Cloud 或 Tableau Server 中现在提供了轴动画。例如，当您筛选可视化项以包含新数据组时，您会看到轴的比例因添加了新值而发生变化。轴动画允许您查看上下文中的比例变化，以便您可以对数据做出更好的结论。有关详细信息，请参见[“设置动画格式”](https://help.tableau.com/current/pro/desktop/zh-cn/formatting_animations.htm)。

![筛选类别时轴变化的动画](/tableau/next/zh-cn/online/zh-cn/Img/axes_animations.gif)

### 使用高级筛选

无论您在何处使用 Tableau，现在都可以使用以前仅在 Tableau Desktop 中提供的高级筛选。使用通配符筛选来筛选与您的筛选条件匹配的字符串。或者，制作适用于“条件”或“前 N 个”筛选器的公式。有关详细信息，请参见[筛选分类数据（维度）](https://help.tableau.com/current/pro/desktop/zh-cn/filtering.htm#filter-categorical-data-dimensions)。

### 为指标设置新的权限能力

已为工作簿添加了“创建/刷新指标”权限能力。有关详细信息，请参见“权限”主题中的[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)。

在 2021.3 之前，“创建/刷新指标”能力由“下载完整数据”能力控制。在 2021.3 之前创建的工作簿上，具有“下载完整数据”能力的用户将具有“创建/刷新指标”能力。

这个新能力提供了对数据的更细粒度控制，允许您授予用户创建指标的能力，同时拒绝查看或下载完整视图数据的能力。

### 使用新站点设置和“运行‘数据解释’功能”权限能力控制对“数据解释”功能的访问

Tableau 管理员现在可以在站点设置中控制“数据解释”功能的可用性。在 2021.3 之前，仅使用 tsm configuration set 选项 ExplainDataEnabled 在服务器级别控制启用或禁用“数据解释”功能的能力。

作者现在可以使用“运行‘数据解释’功能”权限能力在工作簿级别控制“数据解释”功能的可用性。有关详细信息，请参见“权限”主题中的[“数据解释”功能](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#explain-data)。

**注意**：若要在查看模式下使“数据解释”功能可用，工作簿作者还必须在“解释数据设置”对话框中选择**“允许在线查看时在此工作簿中使用‘数据解释’功能”**。有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。

### 限制每个项目的标记数量

新设置允许您限制用户可以添加到 Tableau 内容（例如工作簿和指标）以及外部资产（例如数据库和表）的标记数量。此设置可确保标记不会造成资源消耗问题。当您降低标记限制时，它会阻止添加的新标记超出该限制，但不会移除超过限制的项上的现有标记。有关详细信息，请参见[站点设置参考](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm)。

### 确保 Bridge 使用 JDBC 或 ODBC 连接自定义项

如果 [Tableau 数据源自定义 (TDC) 文件](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)用于自定义通用 JDBC 或 ODBC 连接，您可以使用[将 .tdc 文件用于通用 JDBC 或 ODBC 连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#tdc)描述的步骤来确保 Bridge 也使用这些自定义项。

### 使用 JSON 日志监控 Bridge 刷新

通过连接到 Bridge 客户端的 JSON 日志文件，创建数据源和视图以监控刷新作业。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#json)。

### 向“数据问答”(Ask Data) 功能镜头作者提供反馈

如果您对镜头的结构或如何最好地将其与“数据问答”(Ask Data) 功能结合使用有疑问，可以将反馈直接发送给作者。

1.在“数据问答”(Ask Data) 功能查询框的左侧，单击“i”图标。

![将鼠标悬停在信息图标上，显示“数据问答”(Ask Data) 功能提示工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_tips_button.png)

3.在提示对话框底部，单击“联系镜头作者”。

默认情况下启用此选项，但镜头作者可以按照[让用户通过电子邮件向您发送有关镜头的问题](https://help.tableau.com/v0.0/online/zh-cn/ask_data_lenses.htm#Let)中的步骤将其隐藏。  

### 使用先前为“数据问答”(Ask Data) 功能中的分析功能保留的术语

以前，“数据问答”(Ask Data) 功能会忽略在数据源字段名称和值中找到的分析术语。但现在它像处理任何其他形式的数据一样处理“平均”、“组”、“筛选”、“限制”、“排序”和“日期”等术语，让您无需修改其内容即可分析数据源。

### 在“数据问答”(Ask Data) 功能中访问表计算

如果已发布的数据源包含具有进行聚合或排序的表计算的计算字段，“数据问答”(Ask Data) 功能现在可以像其他字段一样对这些字段进行索引和分析。（不支持对数据进行筛选或限制的表计算。）

### 在“数据问答”(Ask Data) 功能中使用更长的字段值

“数据问答”(Ask Data) 功能现在对长度最多为 200,000 个字符的字段值进行索引，远高于之前的限制 10,000。

### 为 Dremio 设置自定义 OAuth

从版本 2021.3 开始，您可以为 Dremio 设置自定义 OAuth。有关详细信息，请参见 [OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm#custom)。

### Data Management

#### Tableau Catalog - 数据管理的一部分

**继承的描述出现在 Web 制作中** - 如果字段上游存在字段描述，则该描述会显示在 Web 制作中，并提供有关该描述从何处继承的信息。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[描述已发布数据源中的字段](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm)。

**个人空间中的资产已编入索引** - Tableau Catalog 为个人空间中的资产编制了索引，但浏览世系工具的用户会看到**“需要权限”**，而不是有关个人空间中工作簿的信息。

**数据质量警告出现在订阅电子邮件中** - 如果工作簿或视图的上游资产有警告，则订阅电子邮件可以包含工作簿或视图的数据质量警告。有关详细信息，请参见[订阅中的数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm#subscriptions)。

2021 年 8 月新增

### 查看“数据问答”(Ask Data) 功能中的颜色编码数据类型和简化的限制和排序措辞

在“数据问答”(Ask Data) 功能中创建查询时，您会看到有用的颜色编码图标，用于标识诸如数字、文本字符串、表等数据类型。限制筛选器和排序的措辞也得到了简化，使“数据问答”(Ask Data) 功能对您的查询的解释更加清晰。

![“数据问答”(Ask Data) 功能 UI，显示带有字段名称的模块化短语。 ](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_simple_phrasing.png)

### 确定“数据问答”(Ask Data) 功能的解释中使用的元素

“数据问答”(Ask Data) 功能添加了关于如何在解释中使用您的输入的视觉反馈。被忽略的词会变灰；将鼠标悬停在剩余单词上突出显示它们是如何被纳入上述解释的。

![“数据问答”(Ask Data) 功能映射。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_mapping.gif)

### 编辑“数据问答”(Ask Data) 功能镜头的字段描述

镜头作者现在可以自定义用户将鼠标悬停在某个字段上时显示的描述，从而更好地向镜头用户的受众解释其目的。若要更改“描述”条目，请单击字段名右侧的铅笔图标 。

![仪表板上选择了“Order Profitable?”（订单盈利吗？）值，并突出显示了以下描述：计算每个订单盈利能力的详细级别表达式。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_description.png)

2021 年 6 月新增

### 带有 MFA 的 Tableau

随着安全形势的发展和可能危及用户凭据的威胁变得越来越普遍，实施强大的安全措施来保护您的组织和用户非常重要。如果您的组织不直接使用单点登录 (SSO) 身份提供程序 (IdP)，您可以使用 Tableau 身份验证启用多重身份验证 (MFA) 以更好地保护您的用户登录过程。

有关详细信息，请参见以下各项之一：

- 如果您是站点管理员，请参见[关于多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm#mfa_requirement)。
- 如果您是用户，请参见[注册多重身份验证](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm#mfa_register_user)。

### “数据问答”(Ask Data) 功能的简化站点设置

“数据问答”(Ask Data) 功能的简化站点设置现在可以在站点范围内为所有数据源禁用或启用该功能。如果它在站点范围内启用，索引频率仍然可以为每个数据源自定义。有关详细信息，请参见[为站点禁用或启用“数据问答”(Ask Data) 功能](https://help.tableau.com/v0.0/online/zh-cn/ask_data_enable.htm)。

### 组织集合中的项

集合就像播放列表，让用户以对他们有意义的方式组织内容。Viewer（查看者）、Explorer 和 Creator 都可以创建和共享集合。有关详细信息，请参见[组织集合中的项](https://help.tableau.com/current/pro/desktop/zh-cn/collections.htm)。

请注意，如果您参与了集合的有限预览，则用于控制公共集合的站点设置将不再存在。现在，集合的权限的控制方式与其他类型的内容相同。有关详细信息，请参见[集合的权限](https://help.tableau.com/current/online/zh-cn/permissions.htm#collections)。

### 使用 Salesforce 数据创建工作簿

您现在可以将 Salesforce 数据集成到 Tableau Cloud 中，为您站点上的用户创建入门内容。连接到 Salesforce 后，Tableau 会发布即用型工作簿和数据源，以帮助您快速启动对销售和服务云的分析。有关详细信息，请参见[使用 Salesforce 数据创建工作簿](https://help.tableau.com/v0.0/online/zh-cn/to_connect_salesforce.htm)。

### 为 Web 制作中的数据提取配置设置

您现在可以为您在 Web 制作中创建的数据提取配置设置。（可选）配置选项来指示 Tableau 如何存储、定义筛选器并限制数据提取中的数据量：有关详细信息，请参见[在 Web 上创建数据提取](https://help.tableau.com/v0.0/online/zh-cn/datasource_extract.htm)。

### 在 Web 上将 Einstein Discovery 预测引入您的 Prep 流程

从版本 2021.2 开始，您可以在 Web 上将在 Einstein Discovery 中构建的预测模型直接引入您的 Prep 流程。

**注意**：您必须拥有配置为访问 Einstein Discovery 的 Salesforce 许可证和用户帐户才能使用此功能。

借助机器学习和人工智能的强大功能，您可以对流程数据进行批量评分并在行级别为预测结果生成新字段，还可以添加首要预测因子和推荐改进字段，以包含有关哪些字段对预测结果有贡献的数据。将预测步骤添加到您的流程中，登录 Einstein Discovery 并从部署的模型中进行选择，然后将其应用于您的流程数据。然后生成您的流程输出，并使用新数据源在 Tableau 中分析预测结果。此功能是 Tableau Prep Builder 版本 2021.1.3 中首次引入的。有关详细信息，请参见 Tableau Prep 帮助中的[将 Einstein Discovery 预测添加到您的流程](https://help.tableau.com/current/prep/zh-cn/prep_predictions.htm)和[在 Web 上创建流程并与其进行交互](https://help.tableau.com/v0.0/online/zh-cn/web_author_flows.htm)。

### 站点中的多个分析扩展程序

从版本 2021.2 开始，您现在可以为每个站点创建多个分析扩展程序连接。这意味着具有不同语言或连接要求的组织可以在同一个 Tableau Server 站点上使用分析扩展程序，不同的工作簿使用不同的连接。有关为站点配置分析扩展程序的详细信息，请参见[配置与分析扩展程序的连接](https://help.tableau.com/v0.0/online/zh-cn/config_r_tabpy.htm)。有关使用分析扩展程序的详细信息，请参见[使用分析扩展程序传递表达式](https://help.tableau.com/current/pro/desktop/zh-cn/r_connection_manage.htm)（Tableau Desktop 和 Web 制作帮助）。  
  
**注意：**自 2021.2 起，Einstein Discovery 分析扩展程序仍仅限于每个站点一个。

### 在已发布仪表板中共享来自“数据解释”功能的解释

“数据解释”功能具有重新设计的用户界面，针对更广泛的业务用户受众进行了优化。作者（具有编辑权限的 Creator 或 Explorer）现在可以为已发布工作簿中仪表板和工作表的 Viewer（查看者）启用“数据解释”功能。Viewer（查看者）可以在视图中选择感兴趣的标记，并运行“数据解释”功能比以前更深入地探索他们的数据。

默认情况下不启用在查看模式下访问“数据解释”功能，因此作者将需要启用此选项。有关如何在查看模式下启用“数据解释”功能的信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm#EnableExplainData)。

有关“数据解释”功能的详细信息，请参见[使用“数据解释”功能更快地发现见解](https://help.tableau.com/v0.0/online/zh-cn/explain_data.htm)、[“数据解释”功能入门](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm)和[使用“数据解释”功能的要求和注意事项](https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm#Control)。

### 配置自定义 OAuth

作为站点管理员，您现在可以为站点配置自定义 OAuth 客户端以覆盖默认 OAuth 客户端。有关详细信息，请参见 [配置自定义 OAuth](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm#custom_oauth_server)。

### 使用 Bridge 使更多数据保持最新

Bridge 新增了对以下连接器的支持：

- Alibaba AnalyticsDB for MySQL
- Alibaba Data Lake Analytics
- Databricks
- Denodo
- Impala
- Kyvos

有关 Bridge 连接的详细信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)。

### 探索新的“在线管理见解”数据源

使用新的“在线管理见解”数据源更深入地了解您的 Tableau Cloud 站点。您现在可以连接到组数据源以识别用户的组成员身份，或连接到站点内容数据源以获取有关站点上内容项的管控信息。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### Tableau Catalog - 数据管理的一部分

**添加字段描述** - 您可以为已发布数据源中的字段添加描述，该描述随后将显示在数据源页面“世系”选项卡上的“描述”列中。您还可以在构建可视化项时在“数据”选项卡上看到描述。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[描述已发布数据源中的字段](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#describe-fields-in-a-published-data-source)。

**数据质量警告更新**

- **警告消息的格式化文本支持** - 创建或编辑数据质量警告消息时，您可以使用粗体、下划线和斜体设置文本格式，并包括链接或图像。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm#how-to-set-a-quality-warning)。
- **警告所需的消息** - 创建数据质量警告时，您现在需要输入一条消息以显示给用户。（这不适用于将 Tableau 设置为监视数据提取刷新或流程故障时生成的警告。）有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm#how-to-set-a-quality-warning)。

**继承的描述出现在 Tableau Desktop 中** - 如果字段上游存在字段描述，则该描述会显示在 Tableau Desktop 中，并提供有关该描述从何处继承的信息。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[描述已发布数据源中的字段](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#describe-fields-in-a-published-data-source)。

**显示完整的表名称** - 完整的表名称已添加到表页面。

**按标记筛选** - 您现在可以在“连接到”对话框中按标记筛选数据库、文件和表。

**按嵌入式或非嵌入式进行筛选** - 在“外部资产”页面上，您可以按资产类别（嵌入式和非嵌入式）筛选数据库、文件和表。

### 在 Web 上创建参数动作

您现在可以在 Tableau Cloud 和 Tableau Server 中创建参数动作。创建参数动作时，您可以自定义数据在可视化项中的显示方式。用户可以通过直接与可视化项交互来更改参数值。有关详细信息，请参见[参数动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_parameters.htm)。

### 在 Web 上创建集动作

您现在可以在 Tableau Cloud 和 Tableau Server 中创建集操作。使用集来定义数据子集，然后使用集动作来控制集中的成员如何与视图中的其他数据进行比较。有关详细信息，请参见[集动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_sets.htm)。

2021 年 4 月新增

### Salesforce 身份验证

如果您的组织使用 Salesforce，则您可以启用 Tableau Cloud 以使用 Salesforce 帐户通过 OpenID Connect 进行单点登录。当您启用 Salesforce 身份验证时，系统会将用户定向到 Salesforce 登录页面，以便输入在 Salesforce 中存储和管理的凭据。可能需要最少的配置。请参见[Salesforce 身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth_sfdc.htm)。

2021 年 3 月新增

### 在重新设计的通知中心查看新评论和共享通知

用户现在可以通过选择 Tableau 站点右上角的钟形图标来查看新评论和共享的通知。重新设计的通知中心还显示流程和数据提取作业的更新。此更新后，旧通知将继续通过电子邮件发送，但不会显示在通知中心。若要继续通过电子邮件接收较旧的通知，请导航到站点设置。在“管理通知”下，为每个通知类型选择“电子邮件”。有关详细信息，请参见[浏览 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)。有关详细信息，请参见[站点设置参考](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm)。

### Tableau Catalog - 数据管理的一部分

**自动数据质量警告**\- 您可以设置 Tableau 来监控数据提取刷新失败和流程运行失败。当发生故障时，Tableau 会生成向用户显示的数据质量警告。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)。

**快速搜索结果已扩展** \- 快速搜索结果现在包括外部资产上的标签。

#### 将 Einstein Discovery 预测添加到 Tableau 仪表板

使用新的 Einstein Discovery 仪表板扩展程序，当用户在视图中选择标记时，他们会看到预测和建议的动态更新，以改进预测结果。作者可以将扩展程序对象拖动到仪表板画布上，从扩展程序库中选择 Einstein Discovery，然后在 Tableau Cloud 中配置扩展程序。有关详细信息，请参见[“使用 Einstein Discovery 仪表板扩展程序在 Tableau 中浏览预测”](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_dashboard_extension.htm)。

有关 Salesforce 和 Tableau 中必需的许可证，访问和权限的信息，请参见[访问要求](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_predictions.htm#Requirem)。

有关 Tableau 中的 Einstein Discovery 的简介，请参见 [tableau.com](https://www.tableau.com/zh-cn/) 上的 [Tableau 中的 Einstein Discovery](https://www.tableau.com/zh-cn/products/add-ons/einstein-discovery) 页面和[演示](https://www.tableau.com/zh-cn/learn/webinars/einstein-discovery-tableau-demo)。

有关启用 Einstein Discovery 仪表板扩展程序所需的配置步骤的详细信息，请参见[配置 Einstein Discovery 集成](https://help.tableau.com/v0.0/online/zh-cn/config_einstein_extensions.htm)。

2020 年 12 月新增

### 在 Web 上创建数据提取

现在，您可以在 Web 制作中直接创建数据提取，而无需使用 Tableau Desktop。有关详细信息，请参见[在 Web 上创建数据提取](https://help.tableau.com/v0.0/online/zh-cn/datasource_extract.htm)。除了现有工作簿之外，还可以提取新的工作簿。或者，数据提取创建可以在后台运行，完成后可以通知您。这将允许您在创建数据提取时关闭制作会话，这可能有助于可能需要很长时间的大型数据提取。

### 在 Web 上创建流程并与其进行交互

现在，您可以使用 Tableau Prep Builder、Tableau Server 或 Tableau Cloud 创建流程来清理和准备数据。连接到数据、构建新流程或编辑现有流程，您的工作每隔几秒钟会自动保存一次。创建只有您可用的草稿流程，或发布流程以使其可供其他人使用。如果您具有 Data Management 功能，则从 Web 中运行单个流程，或者使用 Tableau Prep Conductor 按计划自动运行流程。有关详细信息，请参见[在 Web 上创建流程并与其进行交互](https://help.tableau.com/v0.0/online/zh-cn/web_author_flows.htm)。

### 组织集合中的项（有限预览）

集合就像播放列表，允许您组织 Tableau 内容。创建用于个人参考的私有集合，或创建可由您站点上其他用户查看的公共集合。有关详细信息，请参见[组织集合中的项](https://help.tableau.com/current/pro/desktop/zh-cn/collections.htm)。

作为 Tableau 管理员，您可以通过更改站点设置“允许公共集合”来控制用户是否可将集合设置为公共。

集合可作为 Tableau Cloud 的有限预览获得。除非您的站点是预览的一部分，否则您不会看到集合。如果您是希望加入预览版功能的 Tableau 管理员， [请在此处注册](https://www.surveymonkey.com/r/WPJSL6D)。

### Tableau Catalog 更新 -Data Management 的一部分

Tableau Catalog 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 功能中。有关详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

此版本中包括以下功能：

**“数据质量警告历史记录”** - 站点管理员可以使用预先构建的管理视图“数据质量警告历史记录”查看站点上数据质量警告的使用情况。有关详细信息，请参见[数据质量警告历史记录](https://help.tableau.com/v0.0/online/zh-cn/dm_adminview_dqw.htm)

**查看 Tableau Desktop 中的质量警告详细信息**\- Tableau Desktop 用户可以将鼠标悬停在“数据”选项卡上的警告图标上，以查看有关影响其工作簿中数据的数据质量警告的详细信息。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)。

**指标出现在世系中并显示数据质量警告** \- 数据质量警告现在显示在受警告影响的指标上。指标也会显示在“世系”工具中，使您能够查看在执行影响分析时数据更改会对指标产生怎样的影响。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm#metrics-appear-in-tableau-catalog)。

### Tableau Prep Conductor 更新 - Data Management 的一部分

现在，Data Management 只需要使用 Tableau Prep Conductor 来计划和监视流程。其他与流程相关的任务不再需要您具有 Data Management。有关详细信息，请参见[Tableau Prep Conductor](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_online_intro.htm)。

### 分析扩展程序

分析扩展程序允许您使用 R 和 python 等语言以及其他工具和平台在工作簿中扩展 Tableau 动态计算。这些设置端点使您能够在 Tableau Cloud 中的站点上配置分析扩展程序。请参见[配置与分析扩展程序的连接](https://help.tableau.com/v0.0/online/zh-cn/config_r_tabpy.htm)。

### “数据问答功能数据使用情况和采用”管理视图

现在，您可以使用新的“数据问答功能使用情况”管理视图查看用户如何与站点上的“数据问答”（Ask Data）功能交互。仪表板突出显示了顶部“数据问答”（Ask Data）功能用户、数据源和数据源所有者，以及标题值指标。有关详细信息，请参见[数据问答功能使用情况](https://help.tableau.com/v0.0/online/zh-cn/adminview_ask_data_usage.htm)。

2020 年 9 月和 10 月新增

### Bridge（旧版）计划已移至新位置

对于需要使用 Bridge（旧版）计划来使数据保持最新的数据提取数据源，您可以在数据源页面上的操作菜单中，从新位置查找和配置 Bridge（旧版）计划。有关详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

![Tableau Bridge 下拉菜单，其中包含使用 Bridge 进行计划的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_leg_actions_menu.png)

**注意**：建议的计划没有改变位置，并继续与 Online 刷新计划集成。但是，“建议”计划不再标记为“建议”，以便更好地反映集成。此处描述的所有与 Bridge 相关的更新都已进行，以支持新的 Online [计划体验](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#Add)。

### 自定义数据提取刷新计划

数据提取刷新计划现在可以完全自定义，不再需要从预先填充的计划列表中选择。现在，您可以创建和管理自定义的每小时、每天、每周和每月数据提取刷新计划。

有关详细信息，请参见[“在 Tableau Cloud 上计划刷新”](https://help.tableau.com/current/online/zh-cn/schedule_add.htm)。

### 关闭网页对象

若要防止仪表板中的网页对象显示目标 URL，请在站点设置中取消选择“启用网页对象”。

2020 年 8 月新增

### 为数据提取设置站点时区

站点中基于数据提取的数据源的默认时区是协调世界时 (UTC)。站点管理员现在可以选择设置其他时区。

有关详细信息，请参见[更改时间设置](https://help.tableau.com/v0.0/online/zh-cn/tz_for_extracts.htm)。

### 自动挂起非活动工作簿的数据提取刷新

为了节省资源，Tableau 可以自动挂起非活动工作簿的数据提取刷新任务。此功能仅适用于完全数据提取刷新，不适用于增量数据提取刷新。此功能仅适用于每周运行一次或更频繁运行的刷新计划。

有关详细信息，请参见[自动挂起非活动工作簿和数据源的数据提取刷新](https://help.tableau.com/v0.0/online/zh-cn/extract_auto_suspend.htm)。

### 使用“登录时授予角色”管理用户组的许可证

管理员可以为用户组设置最低站点角色，并在创建或修改该用户组时选择“登录时授予角色”。启用“登录时授予角色”可减少管理许可证的手动工作，因为管理员可以按组指定站点角色能力，并在用户实际需要时预配许可证。通过在用户登录前等待授予许可证，管理员可以简化许可证预配，而无需向非活动用户授予许可证。有关详细信息，请参见[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)。

### 标记用于存档的过时内容

2020.2 中引入的“过时内容管理”视图现在增加了一个功能，允许您将内容标记为过时内容。然后可以选择将标记的内容存档。有关详细信息，请参见“过时内容”。

### Tableau Catalog 更新 -Data Management 的一部分

Tableau Catalog 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 中。有关 Tableau Catalog 的详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

此版本中包括以下功能：

**在 Tableau Desktop 中查看数据质量警告** - 当您在 Tableau Desktop 中打开带有数据质量警告的工作簿时，警告图标（蓝色圆圈或带感叹号的黄色三角形）会出现在工作簿工作表页面的“数据”选项卡上。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)

**添加了“敏感数据”警告类型** - 您可以使用此新警告类型为组织中的敏感数据设置数据质量警告。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)

**嵌入资产列在外部资产中** - 您现在可以看到列在“外部资产”页面中的嵌入资产。有关详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm#embedded-asset-appears-in-external-assets)。

**标记外部资产** - 向数据库、表和列中添加标记，这样，除其他内容外，您可以标记具有个人身份信息 (PII) 的表和列。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[标记项](https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm)。

### Web 制作和与视图交互

与 Web 制作和与 Web 上的视图交互相关的新功能及增强功能列在[Tableau 中针对用户的新增功能和 Web 制作](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_previous_versions_desktop_webauthor.htm#version-20203)和 [Tableau Desktop 功能比较](https://help.tableau.com/current/pro/desktop/zh-cn/server_desktop_web_edit_differences.htm)中。有关与 Web 制作和视图交互相关的主题，请参见[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_home.htm)。

2020 年 6 月新增

### Tableau Bridge

**无需升级或安装 Bridge – 适用于发布者**

对于专门使用连接到本地关系数据的数据源的发布者，您不再需要维护当前客户端或升级到最新版本。只要使用建议计划（下一个要点）迁移刷新计划，并且管理员已安装并设置了至少一个 Bridge 2020.2 客户端，您就已全部设置完毕。有关详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

**集成刷新计划**

Bridge 的刷新计划现在与 Tableau Cloud 刷新计划集成。对于发布者，称为建议计划的的集成刷新计划意味着：

- 您可以更好地控制和灵活地管理自己的数据源。
- 对于某些数据源管理任务（比如更新连接凭据），您对于站点管理员的依赖性会降低。

![“计划数据提取刷新”对话框，其中包含建议的刷新计划。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_rec.png)

有关详细信息，请参见[Bridge 刷新计划与 Bridge 旧版计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#schedules)。

**使私有云数据保持最新**

使用 Bridge 使只能从专用网络内访问的云数据保持最新。有关详细信息，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。

**为数据提取刷新启用的池化功能**

除了实时查询之外，客户端还可以跨网络中的所有 2020.2 客户端对数据提取刷新进行池化。对于站点管理员，数据提取刷新池化意味着：

- 您可以专注于提供可用性、吞吐量和延迟。
- 您可以优化客户端池的组成，以匹配实时查询的特征和数据提取刷新工作负载。

有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。

**更新的“设置”页面**

对于站点管理员，简化的“Bridge 设置”页面允许您配置要在池中包括或排除哪些客户端，并显示一个警告图标，以便于了解哪些客户端需要升级到最新版本。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#registered)。

![显示客户端连接状态的表格。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_settings_pooling_warning.png)

**注意：**仅当有较新的客户端可供下载时，警告图标才会显示。警告图标并不表示客户端或相关 Bridge 数据源存在问题。

2020 年 5 月新增

### 数据提取刷新的站点容量更新

为了提高站点性能并确保一致的计划体验，每天分配站点和并发数据提取刷新容量。有关详细信息，请参见[Tableau Cloud 容量](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm)。

### 使用关系为多表分析合并数据

关系是在 Tableau 中合并数据进行多表分析的一种灵活的新方法。数据源现在支持新逻辑层中的多表数据模型。Tableau 可识别数据源中的单独表，并在本机详细级别为每个表执行聚合。

Creator 可以使用关系合并表。在逻辑表之间使用关系可以更轻松地在正确的详细级别探索和分析多表数据，而无需编写专用计算来控制平均值和总计等聚合。

您无需为关系指定联接类型；在分析期间，Tableau 将根据工作表中的字段和分析上下文自动选择适当的联接类型。

**注意**：您的工作簿必须使用嵌入式数据源，您才能在 Tableau Server 或 Tableau Cloud 中的 Web 制作中的“数据源”页面中编辑关系。无法编辑已发布数据源的数据模型。

为了支持多表分析，Tableau 界面的几个部分已更改。“数据源”页面（画布、数据网格）、“查看数据”窗口和工作表中的“数据”窗格均已更新，以支持多表分析体验。有关详细信息，请参见[界面不同部分的变化](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_whatschanged.htm#data-source-page-changes)。

**注意**：在 Tableau 2020.2 及更高版本中，“查看数据”列顺序已更改。为了支持关系和逻辑表，此更改是必需的。有关详细信息，请参见 [Tableau 2020.2 及更高版本中的“查看数据”列顺序更改](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_whatschanged.htm#ViewDataColOrderChange)。

有关关系和数据源更改的详细信息，请参见以下主题：

- [2020.2 中数据源和分析的变化](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_whatschanged.htm)
- [有关 2020.2 中关系、数据模型和数据源的问题](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_faq.htm)
- [Tableau 数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm)
- [关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)和[使用性能选项优化关系](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_relationships_perfoptions.htm)
- [分析如何适用于使用关系的多表数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_analysis_overview.htm)
- [多表分析疑难解答](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_analysis_overview.htm#Troubles)
- [演练：不要害怕关系](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_dont_be_scared.htm)

另请参见此 Tableau 博客文章：[关系，第 1 部分：在 Tableau 中引入新的数据建模](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)

### 创建指标以跟踪数据

指标可帮助用户跟踪其数据的更改。用户可以从视图中创建指标，并使用它们来监视关键数字（如每日销售额）。有关用户如何创建指标的信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm)。

![网格中的多个指标](/tableau/next/zh-cn/online/zh-cn/Img/metrics_grid.png)

Tableau Cloud 管理员可以确保用户能够为站点创建指标或禁用指标。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

### 添加集控件，允许用户快速修改集的成员

使用集控件，受众无需编辑模式即可选择集的成员。用户只需直接与视图中的卡片交互，即可添加或移除集成员。再加上“集动作”，您拥有两个功能强大的补充功能，便于对您感兴趣的集进行可视化。

有关详细信息，请参见[创建集](https://help.tableau.com/current/pro/desktop/zh-cn/sortgroup_sets_create.htm)，或查看此博客文章：[使用集控件在用户友好的包中进行强大的分析](https://www.tableau.com/about/blog/2020/4/powerful-analytics-user-friendly-package-set-control)。

### 通过与可视化项直接交互，在集内添加或移除值

现在，使用“集动作”，您和您的受众可以使用可视化项本身以增量方式向集内添加值或从中移除值。只需与可视化项交互，并选择要包含或排除的标记。再加上新的“集控件”功能，您可以通过两种强大的方式来深入了解数据。

有关详细信息，请参见[集动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_sets.htm)。

### 使用浏览器上载和打开工作簿

用户现在可以将 Tableau 工作簿上载到 Tableau 站点，而无需通过 Tableau Desktop、REST API 或 TabCmd 进行发布。在 Tableau 站点中，具有“Creator”或“Explorer（可发布）”站点角色的用户可以选择“新建”\>“工作簿上载”以将 .twb 或 .twbx 文件（最多 50 MB）上载到项目。有关详细信息，请参见[将工作簿上载到 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/upload.htm)。

![带有用于创建新项目、工作簿或流程，或上载现有工作簿的选项的菜单。](/tableau/next/zh-cn/online/zh-cn/Img/uploadworkbook.png)

### 通过 Tableau Cloud 的主页访问仪表板起始模板

站点管理员 Creator 现在可以从 Tableau Cloud 的主页中访问仪表板起始模板。使用这些预先设计的仪表板可以对来自常见业务应用程序（如 Salesforce 或 ServiceNow ITSM）的数据进行快速可视化。有关详细信息，请参见[使用加速器快速可视化数据](https://help.tableau.com/v0.0/online/zh-cn/accelerators.htm)。

### Tableau Catalog 更新 -Data Management 的一部分

Tableau Catalog 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 功能中。有关 Tableau Catalog 的详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

此版本中包括以下功能：

**提高重要警告的可见性** \- 您可以将数据质量警告设置为高度可见，以便受警告影响的可视化项的用户看到通知，并且警告在 Tableau 的其他地方以更突出的黄色显示。有关详细信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)，以及 Tableau Desktop 和 Web 制作帮助中[在视图中浏览和分析数据](https://help.tableau.com/current/pro/desktop/zh-cn/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information)中的“使用‘数据详细信息’查看可视化项信息”。

**仪表板显示在“世系”窗格中** \- 当您在世系中选择“仪表板”项时，可以看到下游仪表板的列表。有关详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm)。

**针对“已认证”和数据质量警告进行筛选外部资产** \- 除了使用搜索来缩小针对外部资产的选择之外，您现在还可以按“已认证”和数据质量警告筛选数据库、文件和表。

**连接时有更多的筛选器** \- 连接到数据时，可以依据连接类型筛选数据库和表。

### 有关新增功能的详细信息

与 Web 制作和与 Web 上的视图交互相关的其他新功能及增强功能列在 [Tableau 中针对用户的新增功能](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_previous_versions_desktop_webauthor.htm#version-20202)以及 [Web 制作和 Tableau Desktop 功能比较](https://help.tableau.com/current/pro/desktop/zh-cn/server_desktop_web_edit_differences.htm)中。有关与 Web 制作和视图交互相关的主题，请参见[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_home.htm)。

2020 年 2 月新增

### 使用动态参数自动刷新参数

现在，您可以将参数的当前值设置为独立于视图的单值计算的结果。此外，还可以基于某个数据源列刷新参数的值列表（或域）。这意味着，每次打开工作簿且 Tableau 连接到参数引用的数据源时，工作簿中引用该参数的每个位置都将使用最新的值或域。

有关详细信息，请参见[创建参数](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_create.htm)。

### 通过外部身份提供程序自动进行用户配置和组同步

您可以使用标识提供程序 (IdP) 自动在 Tableau Cloud 中组添加或移除用户，或者从组中添加或移除成员。Tableau Cloud IdP 用户管理使用跨域身份管理 (SCIM) 标准，这是一种用于自动交换用户身份信息的开放式标准。目前我们支持具有以下 IdP 的 SCIM：

- Okta
- OneLogin

SCIM 用于对诸如 Tableau Cloud 等云应用程序中的用户进行配置。云 IdP 集中管理用户身份，包括将用户分配给应用程序和组。IdP 使用 SCIM 标准来确保“下游”应用程序与使用 IdP 设置的这些配置分配保持同步。通过这种方式管理用户可以提高安全性，并且可大大减少 Tableau Cloud 站点管理员管理站点用户和组成员身份所需执行的手动工作量。

有关详细信息，请参见[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)。

### 支持基于登录名的许可证管理

基于登录名的许可证管理 可帮助您为在 Tableau Server 和 Tableau Cloud 上具有 Creator 角色的用户管理许可。具有 Explorer 或 Viewer（查看者）角色的用户无法使用此功能。如果将基于角色的订阅与 Tableau Server 或 Tableau Cloud 结合使用，则可以使用 基于登录名的许可证管理 来简化许可证管理，从而不必使用单独的 Tableau Desktop 和 Tableau Prep Builder 产品密钥。您只需要管理本地 Tableau Server 的一个或多个产品密钥，或者，如果是 Tableau Cloud，您根本无需管理任何产品密钥。

有关详细信息，请参见[使用基于登录名的许可证管理激活 Tableau](https://help.tableau.com/current/online/zh-cn/license_lblm.htm)。

### 权限对话框的更新

使用新的权限对话框更快地设置权限。新的权限[模板](https://help.tableau.com/current/online/zh-cn/permissions.htm#templates)和功能分组与常见用户方案匹配。使用直接编辑（双击进入编辑模式），编辑权限规则比以往更容易。在不预先选择的情况下同时搜索组和用户。[复制](https://help.tableau.com/current/online/zh-cn/permissions.htm#copy-and-paste-permissions)自定义权限规则并将为其他组或用户粘贴该规则。通过新的设置，更直观地将项目管理交给[项目主管](https://help.tableau.com/current/online/zh-cn/permissions.htm#set-a-project-leader)。有关权限的详细信息，请参见[权限](https://help.tableau.com/current/online/zh-cn/permissions.htm)。

### 锁定嵌套项目

监管权限现在更加灵活。可以针对嵌套项目单独锁定项目权限。顶层项目可以充当具有不同权限模型的项目的组织容器。非管理员可以创建新的锁定项目。有关详细信息，请参见[“锁定内容权限”](https://help.tableau.com/current/online/zh-cn/permissions.htm#lock-content-permissions)。

### **“立即运行”**设置

这个新的设置允许服务器管理员配置是允许还是阻止用户手动运行数据提取刷新、流程运行和订阅。“立即运行”设置位于“常规设置”页面上，并且默认情况下处于选定状态以允许允许用户手动运行作业。

### Tableau Catalog 更新 -Data Management 的一部分

Tableau Catalog 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 功能中。有关 Tableau Catalog 的详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

此版本中包括以下功能：

**增加了连接器**\- 连接到来自外部资产的更多数据。我们增加了对以下连接器的支持：Google Big Query、Google 云端硬盘、Google 表格、Box、Dropbox 和 OneDrive。

**创建工作簿**\- 从“外部资产”页面或者数据库或表页面为 Catalog 支持的连接创建工作簿。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中 [Creator：Web 制作入门](https://help.tableau.com/current/pro/desktop/zh-cn/getstarted_web_authoring.htm#tableau-catalog-users-create-workbooks-from-external-assets)中的“Tableau Catalog 用户通过外部资产创建工作簿”。

**针对“已认证”和数据质量警告进行筛选** \- 按“已认证”筛选数据源、数据库、文件和表，按连接筛选数据源，以及按数据质量警告筛选数据库和表。有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中 [Creator：连接到 Web 上的数据](https://help.tableau.com/current/pro/desktop/zh-cn/creator_connect.htm#open-the-connect-to-data-page)中的“打开‘连接到数据’页面”或[使用 Tableau Server 或 Tableau Cloud 连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/examples_tableauserver.htm#connect-from-tableau-desktop)中的“通过 Tableau Desktop 连接”。

**增强的“数据详细信息”窗格** -

- 查看一个迷你图，其中包含过去 12 周内查看工作表或仪表板的次数。
- 很容易看到视图上有警告。
- 展开字段以查看字段元数据，例如说明或计算。
- 当工作簿中的字段继承其说明时，查看说明的来源。
    
    有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中[在视图中浏览和分析数据](https://help.tableau.com/current/pro/desktop/zh-cn/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information)中的“使用‘数据详细信息’查看可视化项信息”。

2020 年 10 月新增

### Web 制作和与视图交互

有关与 Web 制作和 Web 视图交互相关的新功能及增强功能的列表，请参见 [Tableau 中针对用户的新增功能](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#whatsnew_desktop.htm)以及 [和 Web 制作和Tableau Desktop 功能比较](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#server_desktop_web_edit_differences.htm)中的“准备、制作和查看数据”下列出的功能。有关与 Web 制作和视图交互相关的主题，请参见[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_home.htm)。

### 视图建议

Tableau Cloud 现在提供视图建议，以帮助用户发现相关内容。若要详细了解这些建议，请参见[发现建议的视图](https://help.tableau.com/current/pro/desktop/zh-cn/recommendations.htm)。

通过“设置”页面上“视图建议”下的选项，可以控制建议是否显示在您的站点上，或者用户名是否显示在建议工具提示中。

### 表可视化项增强功能

作者现在可以创建最多包含 50 列的宽表。具有离散字段的宽表现在也可以水平滚动。有关更多详细信息，请参见[定义表结构](https://help.tableau.com/current/pro/desktop/zh-cn/formatting_tableoptions.htm)。此外，请参见 [datavis.blog](https://datavis.blog/) 上 Tableau Public 大使 Ambassador Marc 发布的有关[包含 50 列的表](https://datavis.blog/2019/10/07/50-column-tables/)的这篇博文。

### 在 Web 上创建数据提取

现在，您可以在浏览器中创建数据提取，而无需使用 Tableau Desktop。有关详细信息，请参见[在 Web 上创建数据提取](https://help.tableau.com/v0.0/online/zh-cn/datasource_extract.htm)。您还可以使用 tabcmd 中新的 `createextracts` 和 `deleteextracts` 命令为已发布工作簿或数据源创建或删除数据提取。有关详细信息，请参见 [tabcmd 命令](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm)。

### 使用“在线管理见解”（测试版）获取视图加载时间

最新版本的“在线管理见解”附带了“可视化项加载时间向下钻取”仪表板和“TS Web 请求”数据源。您可以使用这两种资源来帮助制作视图的用户更好地了解使用这些视图的用户的体验。有关详细信息，请参见[浏览预先构建的工作簿](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm#dashboards)和[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm#datasources)。

仪表板和数据源可_按请求_作为版本内测试版功能提供给您。要加入测试版计划或提供有关新的“在线管理见解”内容的想法和理念，请登录[早期反馈](https://prerelease.tableau.com/key/online_admin)站点。

### 在 Tableau Bridge 客户端未运行时禁用电子邮件通知

如果计划刷新似乎未按计划运行，或者要停止接收有关客户端未运行的通知，您可以禁用电子邮件通知。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#notrunning)。

### 请求访问权限

当用户没有查看权限时，他们现在可以请求访问权限以查看项目、工作簿或视图。当有人请求访问内容时，Tableau 会通过电子邮件将电子邮件发送给控制该内容权限的人员，其中包含有关请求的信息以及有关进行访问权限更改的说明。有关管理权限的信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

### 限制用户信息的可见性

“用户可见性”站点设置允许管理员管理具有“Viewer”（查看者）和“Explorer”站点角色的用户是否能查看站点上的其他用户和组，这一点对于多个客户端使用的站点非常重要。当“用户可见性”设置为“受限”时，Explorer 和 Viewer（查看者）将无法查看其他用户的相关信息，其中包括别名、项目所有权、注释等。Creator 和管理员（包括站点管理员 Explorer）仍可以查看用户信息。默认情况下，“用户可见性”设置为“完整”。有关详细信息，请参见[管理站点用户可见性](https://help.tableau.com/v0.0/online/zh-cn/user_visibility.htm)。

### 为站点启用或禁用“数据问答”(Ask Data) 功能

作为站点管理员，您可以在站点设置的“常规”区域控制“数据问答”（Ask Data）功能的可用性。有关详细信息，请参见[为站点禁用或启用“数据问答”(Ask Data) 功能](https://help.tableau.com/v0.0/online/zh-cn/ask_data_enable.htm)。

### 管理沙盒化扩展程序

Tableau 现在支持沙盒化扩展程序，这是一种在 Tableau 托管的受保护环境中运行的新型仪表板扩展程序。像支持网络的扩展程序一样，沙盒化扩展程序是一些 Web 应用程序，这些应用程序运行在自定义仪表板区域中，并可使用 [Tableau Extensions API](https://tableau.github.io/extensions-api/) 与仪表板的其他部分交互。尽管支持网络的扩展程序具有对 Web 的完全访问权限，但沙盒化扩展程序无法共享数据或在 Tableau 外部进行网络调用。沙盒化扩展程序为 Tableau 用户和管理员提供了新的安全级别。

若要了解有关控制扩展程序的详细信息，请参见[在 Tableau Cloud 中管理仪表板扩展程序和可视化项扩展程序](https://help.tableau.com/v0.0/online/zh-cn/dashboard_extensions_server.htm)。若要详细了解扩展程序安全性和部署策略，请参见 Tableau Server 帮助中的[扩展程序安全性](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。

2019 年 9 月新增

### 增加了对意大利语的支持

Tableau 已增加了对意大利语的支持。现在可将 Tableau 设置为用十一种语言之一来显示用户界面：

- 中文（简体）
- 中文（繁体）
- 英语（英国）
- 英语（美国）
- 法语
- 德语
- 意大利语
- 日语
- 朝鲜语
- 葡萄牙语
- 西班牙语

有关详细信息，请参见 Tableau 用户帮助中的[更改语言和区域设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm#change-language-and-locale)。

除了在所有 Tableau 产品中支持意大利语之外，还提供了这些语言版本的帮助。若要阅读您的首选语言版本的帮助，请在 Tableau 网站上导航到 [Tableau 帮助](https://www.tableau.com/zh-cn/support/help)页面的底部，并从页脚中选择语言。

![语言选项菜单](/tableau/next/zh-cn/online/zh-cn/Img/language_footer_generic.png)

### Tableau Data Management

Data Management 能力通过一个新许可证提供，可帮助客户在其 Tableau Server 或 Tableau Cloud 环境中管理 Tableau 内容和数据资产。Tableau Prep Conductor 和 Tableau Catalog 包含在 Data Management 中。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。

### Tableau Prep Conductor — Data Management 的一部分

Tableau Prep Conductor 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 功能中。Tableau Prep Conductor 利用 Tableau Cloud 的计划和跟踪功能，因此您可以自动运行流程来更新流程输出，而不是在数据更改时登录到 Tableau Prep 来手动运行单个流程。有关详细信息，请参见[Tableau Prep Conductor](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_online_intro.htm)。

### Tableau Catalog 功能 — Data Management 的一部分

Tableau Catalog 包括在单独许可的 Tableau Server 和 Tableau Cloud Data Management 功能中，为您在数据管理空间中提供了各种各样的功能。您可以使用 Tableau Catalog 来发现数据、呈现数据资产、传达数据质量、执行影响分析，以及跟踪 Tableau 内容中使用的数据的世系。有关详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

### Tableau 元数据 API

如果您是开发人员，并且有兴趣访问通过 Tableau Catalog 建立索引或显示的元数据，请参见 [Tableau 元数据 API 帮助](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html)。

### 使用“数据解释”功能浏览和检查视图

使用“数据解释”功能检查、发现和深入了解可视化项中的标记。“数据解释”功能可为所选标记提出统计解释的建议，包括不在当前视图中的数据源中可能相关的数据，使您能通过一种新的方式来浏览数据。

当具有编辑权限的 Creator 和 Explorer 在 Desktop 中编辑视图，或者在 Tableau Cloud 或 Tableau Server 中的 Web 上编辑视图时，他们可以使用“数据解释”功能。

解释为您提供有关数据点可能会如何影响标记值的相关信息及可视化项。您可以随后打开可视化项以进一步研究。有关详细信息，请参见 Tableau 用户帮助中的[使用“数据解释”功能检查视图](https://help.tableau.com/current/pro/desktop/zh-cn/explain_data.htm)。

![选择一个标记并选择“数据解释”功能以了解有关基础数据的详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_overview.gif)

### “数据问答”（Ask Data）功能（Ask Data）改进之处

用户现在能够在 HTML 页面中嵌入“数据问答”（Ask Data）功能（Ask Data）、调整相对日期筛选器，以及查看上下文中的顶部和底部离群值。有关详细信息，请参见 Tableau 用户帮助中的[使用“数据问答”（Ask Data）功能（Ask Data）自动生成视图](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm)。

![仪表板部分中突出显示的嵌入图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_embed.png)

除了字段名之外，数据源所有者和 Tableau 管理员现在可以为字段值添加同义词。有关详细信息，请参见 Tableau 用户帮助中的[针对“数据问答”（Ask Data）功能（Ask Data）优化数据](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_optimize.htm)。

![行业字段详细信息窗口，其中的 85 个唯一值已展开，显示行业值及其同义词的示例。例如，贷款人和信用合作社显示为银行业的同义词。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_value_synonyms_expanded.png)

### 作业管理

站点管理员现在可以查看、监视和管理作业。有关详细信息，请参见[在 Tableau Cloud 中管理后台作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm)。  

2019 年 5 月新增

### 为 Tableau 选择十种不同的语言

Tableau 新增了对两种新语言的支持：中文（繁体）和英语（英国）。现在可将 Tableau 设置为用十种语言之一来显示用户界面：

- 中文（简体）
- 中文（繁体）
- 英语（英国）
- 英语（美国）
- 法语
- 德语
- 日语
- 朝鲜语
- 葡萄牙语
- 西班牙语

有关详细信息，请参见 Tableau 用户帮助中的[更改语言和区域设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm#change-language-and-locale)。

除了在所有 Tableau 产品中支持两种新语言之外，还提供了这些语言版本的帮助。若要阅读您的首选语言版本的帮助，请在 Tableau 网站上导航到 [Tableau 帮助](https://www.tableau.com/zh-cn/support/help)页面的底部，并从页脚中选择语言。

![语言选项菜单](/tableau/next/zh-cn/online/zh-cn/Img/language_footer.png)

### 帮助设计

每个帮助页面的右下角会显示一个蓝色的“发送反馈”图标，使您能更轻松地发送有关主题中的内容的反馈。单击该图标可以让我们知道主题对您是否有帮助，还可以针对需要改进的方面提出意见。  

### 使用“在线管理见解”创建自定义管理视图

为站点用户启用“在线管理见解”，以便创建有关 Tableau Cloud 采用情况、站点流量、许可证分配的自定义管理视图。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 针对未完成的数据提取刷新配置电子邮件通知

作为 Tableau Bridge 执行的数据提取刷新的数据源所有者，您可以将 Tableau Cloud 配置为针对未完成的刷新向您发送电子邮件通知。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#refresh-alert)。

### Tableau Bridge 改进之处

下面是对 Tableau Bridge 客户端和工作流的一些其他改进之处。

- 从客户端菜单访问 Tableau Bridge 相关管理视图。
- 直接客户端中快速确定是否支持实时查询。
    
    ![Tableau Bridge 链接到您的数据源，站点上禁用了实时连接。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_client_livequery_disabled.png)
- 当计划的刷新由于客户端未运行而无法启动时，会收到电子邮件通知。  
    **注意：**Tableau Cloud 升级到 2019.2 后，某些数据源所有者可能会看到有关 Tableau Bridge 客户端未运行的通知大量出现。有关详细信息，请参见[计划刷新似乎未按计划运行：](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm#notrunning)。

### “数据问答”（Ask Data）功能（Ask Data）改进之处

对于用户，“数据问答”（Ask Data）功能（Ask Data）现在允许您以对话方式提出问题，应用简单的计算，并创建多个工作表。有关详细信息，请参见 Tableau 用户帮助中的[使用“数据问答”（Ask Data）功能（Ask Data）自动生成视图](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm)。

![用于向可视化项中添加字段或筛选器的搜索字段。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_adjust_textbox.png)

对于数据管理员和站点管理员：

- 诸如“year”和“date”等单词为分析函数保留，应避免在字段名中使用。
- 现有只有数据源所有者和 Tableau 管理员才能为字段名添加同义词，从而为用户提供了更一致的体验。
- “使用情况分析”仪表板显示最常用的查询、主要的用户和其他有用信息。
    
    ![仪表板显示“数据问答”(Ask Data) 功能 使用情况分析，例如唯一用户、用户查询、建议结果、随时间推移的使用情况、主要用户和主要字段。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_usage_viz.png)

有关详细信息，请参见 Tableau 用户帮助中的[针对“数据问答”（Ask Data）功能（Ask Data）优化数据](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_optimize.htm)。

### 主页和导航改进之处

对于用户和管理员，新的导航更改和页面使他们可以更轻松地开始操作和找到相关内容：

- 使用新的主页可以访问最近的视图、查找收藏夹内容以及查看站点上的热门内容。欢迎横幅和操作由站点角色定制，可帮助用户开始操作。

![主页内容概述](/tableau/next/zh-cn/online/zh-cn/Img/home_overview.png)

- 专用的“收藏夹”和“最近”页面使用户可以访问他们所有最重要的内容。使用每页右侧的排序和筛选选项查找相关内容。
- 利用左侧新的导航面板，用户能够在站点上的重要页面之间快速跳转，包括“浏览”页面，他们可在该页面上集中看到所有站点内容。该面板会根据屏幕大小自动调整，并且可以折叠。

![导航面板折叠](/tableau/next/zh-cn/online/zh-cn/Img/Site_menu.gif)

- 当用户查看或创建可视化项时，左侧的导航面板会消失，以便为分析留出更多空间。紧凑的标题让您可以轻松地浏览项目分层结构、搜索网站以及根据需要访问收藏夹。

若要了解详细信息，请参见 Tableau 用户帮助中的[浏览 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)。

### “通知”侧边面板

当用户在任何视图中选择“通知”时，一个新的面板将显示可视化项已存在的通知。若要创建其他人可见的通知，请在创建通知时选择“对其他人可见”。在 2019.2 之前创建的通知对其他人不可见，但可以更新为对其他人可见。若要了解详细信息，请参见 Tableau 用户帮助中的[从 Tableau Cloud 或 Tableau Server 中发送数据驱动型通知](https://help.tableau.com/current/pro/desktop/zh-cn/data_alerts.htm)。

### 对于 Viewer（查看者）角色支持的自定义视图

以前，创建自定义视图需要 Creator 或 Explorer 许可证，但现在 Viewer（查看者）也可以创建视图。有关详细信息，请参见 Tableau 用户帮助中的[使用自定义视图](https://help.tableau.com/current/pro/desktop/zh-cn/customview.htm)。

### 设置默认站点开始页面

管理员可以为站点上的每个人设置默认开始页面。当站点用户登录到 Tableau Cloud，他们将进入管理员设置的开始页面。有关详细信息，请参见[为所有用户设置默认开始页面](https://help.tableau.com/v0.0/online/zh-cn/maintenance_startpg.htm)。

### Web 制作改进之处

- 在创建数据源时添加带有参数的存储过程。
- 查看 Web 制作中的状态栏以查找有关视图的信息，包括选定标记与总标记之比、行和列以及聚合。有关状态栏的详细信息，请参见 Tableau 用户帮助中的[状态栏信息](https://help.tableau.com/current/pro/desktop/zh-cn/environment_workspace.htm#StatusBar)。
- 使用下拉字段菜单更改字段的聚合。右键单击并拖动（在 macOS 上，右键单击并按住 Option，然后拖动）任何卡或功能区上的字段，并选择一种聚合类型。这会将该字段与所选的聚合一起放在卡或功能区上。
- 创建、编辑和移除参数。

2019 年 2 月新增

### 改进的内容浏览

您可以通过一种新方式来浏览共享内容。打开某个项目时，您将能够看到在一个网格或列表中看到该项目包含的所有内容（工作簿、视图、数据源、流程和嵌套项目）。由于您不再需要为不同的内容类型导航单独的页面，因此查找内容更加容易。有关详细信息，请参见[浏览 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)。

![显示内容类型混合的项目](/tableau/next/zh-cn/online/zh-cn/Img/mycontent_project.png)

### 进行“数据问答”（Ask Data）以自动创建可视化项

“数据问答”（Ask Data）功能引入了一种全新的数据交互方式，使您能键入问题并立即在 Tableau 中得到回答。答案以自动数据可视化项的形式体现，不再需要手动拖放字段或了解数据结构的细微差别。

利用对像时间系列和空间分析这样的关键分析概念的支持，以及对像“last year”（去年）、“earliest”（最早）和“most popular”（最热门）这样的对话短语的理解，“数据问答”（Ask Data）使您能自然地提出复杂的问题。

拥有数据源直接访问权限的所有用户角色（Creator、Explorer 和交互者）都可使用“数据问答”（Ask Data）功能（Ask Data）。

有关详细信息，请参见 Tableau 用户帮助中的[使用“数据问答”（Ask Data）功能（Ask Data）自动生成视图](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm)。

![按国家/地区和品种划分的葡萄酒总价的树状图。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_intro.png)

### 矢量平铺背景地图

在 Tableau Cloud 或 Tableau Public 上创建或发布到其中的地图现在使用矢量平铺图来提高地理数据浏览速度。现在，当您平移或缩放时，地图显示得更清晰且更平滑，并且标签和图标可动态调整大小或形状以适应视图。新的矢量平铺地图取代了驱动 Tableau 背景地图的基础技术，带来了更平滑且更清晰的体验。Tableau 地图的背景绘图法也已更新。

![放大地图。](/tableau/next/zh-cn/online/zh-cn/Img/MapZoom.gif)

### 新的用于 Web 制作的云连接器

使用 Box、Dropbox、Google 云端硬盘、Google BigQuery 和 OneDrive 连接器将 Tableau Cloud Tableau Server 连接到您的数据。有关详细信息，请参见 [Creator：连接到 Web 上的数据](https://help.tableau.com/v0.0/online/zh-cn/creator_connect.htm)。

### 项目卡图像

项目卡图像将不再显示在项目卡上，除非它们作为项目说明中的最后一项添加，并且括在 **!** （感叹号）内。有关详细信息，请参见[添加项目图像](https://help.tableau.com/v0.0/online/zh-cn/custom_projectimage.htm)。

### 挂起的订阅通知

如果订阅了视图或工作簿，您将会定期收到包含该内容的电子邮件快照。现在，如果某些原因导致订阅失败，您将收到电子邮件通知，其中包含用于恢复或删除失败通知的链接。有关详细信息，请参见[创建视图或工作簿订阅](https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm)。

### 在 Tableau Cloud 和 Tableau Public 中查看新的人口统计数据

Tableau Cloud 和 Tableau Public 具有与 Tableau Desktop 相比不同的新人口统计数据来源。如果您的地图在 Tableau Desktop 中使用人口统计数据层，则在将地图发布到 Tableau Cloud 或 Tableau Public 时，您可能会注意到一些细微差异，包括时间段和图例中的值间断。此外，当发布到 Tableau Cloud 或 Tableau Public 时，Tableau Desktop 中使用“块组”数据层选项的地图将自动更新为“人口普查区”。将地图发布到 Tableau Cloud 或 Tableau Public 时，Tableau Desktop 中出现的六个人口统计数据层将不会出现：

- 人口增长预测
- 家庭增长预测
- 住房单元增长预测
- 有效购买收入（中值）
- 年建造建筑（中值）
- 居住时间（年平均值）

将地图从 Tableau Desktop 发布到 Tableau Server 不会导致任何差异。

### 筛选器改进

按住 Ctrl 并单击（在 Mac 上按住 Control 并单击）可以在视图的多值筛选器中选择多个值。所选值可以是非连续的，并用灰色突出显示指明。选择了值之后，您可以单击其中任何一个复选框来同时清除或选择值。

### Web 制作增强功能

- 新的用于 Web 制作的云连接器：使用 Box、Dropbox、Google 云端硬盘、Google BigQuery 和 OneDrive 连接器将 Tableau Cloud 或 Tableau Server 连接到您的数据。
- 数据改进：在 Tableau Cloud 或 Tableau Server 中连接到新数据源的作者现在可以运行初始 SQL，并可以连接到自定义 SQL 查询，以及添加联接计算来解决联接中字段之间的不匹配。
- 为了更好地区分仪表板项目，您现在可以使用“布局”窗格的“项目分层结构”区域或画布上每个对象的下拉菜单来重命名这些项目。
- 发布到 Web 后，在浏览器中单击“预览设备布局”可查看您的设计在台式计算机、平板电脑和手机上的外观。

有关新功能的相关信息，另请参见 Tableau Desktop 和 Web 制作帮助中的[新增功能](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_desktop.htm)。

### 使用管理视图查看和监视 Tableau Bridge 数据提取刷新任务

使用管理员视图查看和监视 Tableau Bridge 执行的数据提取刷新任务。有关详细信息，请参见[Bridge 数据提取](https://help.tableau.com/v0.0/online/zh-cn/adminview_bridge_extract.htm)。

### 在 Tableau Bridge 中为数据提取刷新配置超时限制

为了确保长时间运行的刷新任务不会阻止其他数据提取刷新，您可以为 Tableau Bridge 客户端执行的刷新任务强制实施超时限制。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#timeout)。

### 在 Tableau Cloud 上查找 Tableau Bridge 客户端版本号

作为站点管理员，您可以在 Tableau Cloud 上检查与您的站点关联的 Tableau Bridge 客户端的版本号。

![“客户端状态”表，其中“版本”列突出显示。 ](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_admin_client_version.png)

**注意：**如果客户端的版本号缺失，请登录到安装了客户端的计算机，并从客户端登录到 Tableau Cloud。如果执行该操作后版本号未显示，请考虑升级到最新的客户端。

### 帮助设计

已经进行了更新来帮助您在我们的内容中导航，其中包括用于快速扫描并在页面上选择不同主题的新的右键菜单。

2018 年 10 月新增

### Web 制作增强功能

- 构建密度地图和图表。使用密度标记来创建可帮助您标识数据中的“热点”的地图和图表。
- 向仪表板中添加图像对象。轻松调整您的图像，添加目标 URL，并添加替代文本来改善仪表板的辅助功能。
- 向仪表板中添加导航按钮。按钮可帮助用户导航到另一个仪表板、工作表或故事。根据需要使用您自己的图像自定义按钮，或者添加引导性工具提示文本。
- 通过将工作表背景颜色设置为“无”，使工作表变为透明。
- 选择“复制为交叉表”以向工作簿中插入一个新工作表，并用原始工作表中的数据交叉表视图来填充该工作表。
- 创建、移动点、标记和区域注释并调整其大小。

有关新功能的相关信息，另请参见 Tableau Desktop 和 Web 制作帮助中的[新增功能](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_desktop.htm)。

### 产品帮助搜索、导航和布局改进

产品帮助内的搜索结果已扩展为包括所有 Tableau 产品和帮助文章的结果。帮助布局和导航（例如目录位置和浏览路径）已更新，创造出更加一致的跨产品帮助体验。

### 在行级别保护数据提取数据的安全

使用现有方法在行级别保护数据提取数据的安全，在 Tableau 中实现行级别安全性。有关详细信息，请参见 Tableau 用户帮助中的[在数据行级别限制访问权限](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#publish_userfilters.htm)。

2018 年 7 月新增

Tableau Cloud 已迁移到 Linux 服务器。有关详细信息，请参见 Tableau 网站上的 [Tableau Cloud Pod 迁移](https://www.tableau.com/zh-cn/support/online-upgrade#tpVxeRf3YBvOXQLW.99)。

### Tableau 帮助的更改

产品帮助内的搜索结果已扩展为包括所有 Tableau 产品和帮助文章的结果。帮助布局和导航（例如目录位置和浏览路径）已更新，创造出更加一致的跨产品帮助体验。

### 独立于 Tableau Desktop 安装 Tableau Bridge

从版本 2018.2 开始，您可以独立于 Tableau Desktop 安装 Tableau Bridge。有关 Tableau Bridge 要求、与 Tableau Desktop 以前版本的兼容性以及 Tableau Bridge 客户端安装的详细信息，请参见[“安装 Tableau Bridge”](https://help.tableau.com/current/online/zh-cn/to_bridge_install.htm)。

### Tableau Bridge 不会自动重新启动

独立的 Tableau Bridge 客户端不会使用自动重新启动间隔来自动重新启动。有关以前版本的 Tableau Bridge 需要的自动重新启动间隔的详细信息，请参见 Tableau 知识库中的 [Tableau Bridge 常见问题](https://kb.tableau.com/articles/HowTo/tableau-online-sync-client-frequently-asked-questions?lang=zh-cn)。

**注意：**如果从 Tableau Bridge 2018.1 及更低版本升级到 Tableau Bridge 2018.2，则会忽略配置文件中保留的自动重新启动间隔。

### Tableau Cloud 中的字体支持

Tableau Cloud 包括以下“可在 Web 上正常显示的”字体：Arial、Courier New、Georgia、Tableau、Times New Roman、Trebuchet MS 和 Verdana。

如果可视化项使用 Tableau Cloud 上没有的字体，Tableau Cloud 将改用默认系统字体显示可视化项。有关详细信息，请参见 Tableau 网站上的[发布后未按预期显示字体](http://kb.tableau.com/articles/Issue/fonts-not-displaying-as-expected-after-publishing-to-public?lang=zh-cn)知识库文章。

### 使用“应用程序”模式在 Tableau Bridge 中验证实时连接

您现在可以使用“应用程序”模式在 Tableau Bridge 中快速验证实时连接。这意味着，如果站点管理员启用了此选项，则只有在登录到 Windows 后，您还可以选择运行实时查询。有关详细信息，请参见 [Tableau Bridge 的工作方式](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm#how-sync-works)。

### 在 Tableau Cloud 中管理仪表板扩展程序

仪表板扩展程序是一些 Web 应用程序，它们为用户提供了直接在 Tableau 中与其他应用程序中的数据交互的新方式。您可以控制允许在 Tableau 中运行的仪表板扩展程序，并可管理扩展程序对数据的访问权限。若要了解有关控制扩展程序的详细信息，请参见[在 Tableau Cloud 中管理仪表板扩展程序和可视化项扩展程序](https://help.tableau.com/v0.0/online/zh-cn/dashboard_extensions_server.htm)。

### 借助 @提及让同事加入数据对话

若要让用户参与到讨论您在视图中找到引人注目的数据的对话中来，请在注释中 @提及他们。在您开始键入名称时，组织中具有 Tableau 帐户的匹配用户将出现在列表中，您可从中进行选择。有关详细信息，请参见 Tableau 用户帮助中的[向视图添加注释](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#comment.htm?)。

![用于添加要在评论中提及的个人姓名的字段。](/tableau/next/zh-cn/online/zh-cn/Img/comment_mention.png)

站点管理员可在站点设置的“常规”部分禁用 @提及。

### Web 制作增强功能

- 通过使用仪表板扩展程序连接到外部应用程序来增强仪表板功能。请参见 Tableau 用户帮助中的[使用仪表板扩展程序](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_extensions.htm)。
- 将仪表板项目与可视网格对齐。请参见 Tableau 用户帮助中的[设置仪表板大小和布局](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_organize_floatingandtiled.htm#Grid)。

- 使用键盘快捷方式在 Web 上快速创建和编辑视图。请参见 Tableau 用户帮助中的[键盘快捷方式](https://help.tableau.com/current/pro/desktop/zh-cn/shortcut.htm#Shortcuts_webauth)。
- 创建多连接数据源并联接来自不同数据库的数据（跨数据库联接）。请参见 Tableau 用户帮助中的[联接数据](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm)。
    
    ![连接列表和图表，显示了“Orders”（订单）数据源如何连接到包含销售数据的数据源。](/tableau/next/zh-cn/online/zh-cn/Img/online_crossjoin.png)
- 在 Web 上合并来自同一数据连接的数据。请参见 Tableau 用户帮助中的[合并数据](https://help.tableau.com/current/pro/desktop/zh-cn/union.htm)。
- 在处理基于文件的数据源时，您可以对数据进行转置，从交叉表格式转换为分列格式。请参见 Tableau 用户帮助中的[对数据进行转置（从列到行）](https://help.tableau.com/current/pro/desktop/zh-cn/pivot.htm)。
- 通过按 Ctrl+C (Windows) 或 (Command+C) (macOS) 复制数据网格中的选定值。或者，若要复制元数据网格中的选定值，请右键单击，并选择“复制”。
- 使用架构搜索在“数据”窗格中查找字段。
    
    ![数据窗格上的“搜索”功能。](/tableau/next/zh-cn/online/zh-cn/Img/search_schema_web.png)
- 更好地控制排序。使用嵌套排序在每个区的上下文内对维度值进行排序。您不再需要创建计算字段或合并维度。有关详细信息，请参见 Tableau 用户帮助中的[对可视化项中的数据排序](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#sortgroup_sorting_computed_howto.htm#nested)。
    
    此外，您现在可以通过在视图中的“行”或“列”功能区上右键单击维度字段来访问“排序”对话框。
- 如果更改了视图（例如，通过调整筛选器），您现在可以创建数据通知，而无需先保存自定义视图。
- 现在可通过两种方式打开“编辑轴”对话框。将光标悬停在靠近轴顶部（垂直轴）或右侧（水平轴）的位置，并单击出现的下拉箭头。或者双击轴。
    
    ![光标悬停在散点图轴上的向下箭头图标上。](/tableau/next/zh-cn/online/zh-cn/Img/editaxis_web_arrow1.png) ![向下箭头图标展开以显示“编辑轴”选项。](/tableau/next/zh-cn/online/zh-cn/Img/editaxis_web_arrow.png)
- 为轴选择“对数”标度时，您现在可以选择指定 “对称”以在对数标度轴上显示包含 0 或负值的数据。有关详细信息，请参见 Tableau 用户帮助中的[编辑轴](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#formatting_editaxes.htm#Scale)。
    
    ![散点图说明了销售额和利润之间的相关性，并附有“编辑轴”对话框，其中突出显示了“比例”选项。](/tableau/next/zh-cn/online/zh-cn/Img/editaxis_symlog.png)
- 通过右键单击视图（在工作表或仪表板中），然后选择点或标记注释来创建和删除注释。再次右键单击注释可编辑或移除注释。
    
    ![显示带有标记和点的地图，并带有注释标记或注释点的选项。](/tableau/next/zh-cn/online/zh-cn/Img/annotate_web1.png) ![突出显示地图上带注释的图标，并带有删除或编辑注释的选项。](/tableau/next/zh-cn/online/zh-cn/Img/annotate_web.png)

### 在已发布到 Tableau Cloud 的数据提取中实现计算

如果需要以追溯方式在已发布到 Tableau Cloud 的数据提取中实现计算，您可以使用 tabcmd 通过 `--addcalculations` 选项来刷新发布的数据提取。有关在数据提取中实现计算的详细信息，请参见 Tableau 用户帮助中的[在数据提取中实现计算](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#extracting_optimize.htm#materialize_on_server)。有关 tabcmd 选项的详细信息，请参见[refreshextracts workbook-name 或 datasource-name](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm#id4cdb3410-1c41-4dad-b1d2-306542ac9b32)。

2018 年 4 月新增

### 新的基于用户的短期许可证现在可用

Tableau 现在提供了不同类型基于用户的短期许可证，以各种价位授予一系列 Web 制作及其他能力。这样，组织将能更灵活地使用适合的许可证来满足不同用户的数据分析和可视化需求。若要了解详细信息，请参见[基于用户的许可证](https://help.tableau.com/current/server/zh-cn/license_server_overview.htm#user-based)，或者，若要查看每个许可证的能力，请参见 [Tableau 定价](https://www.tableau.com/zh-cn/pricing)。

### 使用仪表板起始模板快速分析基于云的数据

仪表板起始模板可帮助您快速制作并对来自基于云的系统（比如 Salesforce、ServiceNow、Oracle Eloqua 和 Marketo）的数据进行分析。只需创建一个新工作簿，并选择若干针对关键业务指标量身定制的美观、信息丰富的设计即可。有关详细信息，请参见[使用加速器快速可视化数据](https://help.tableau.com/v0.0/online/zh-cn/accelerators.htm)。

### 配置附加 Tableau Bridge 客户端来平衡实时连接的负载

站点管理员可以在不同计算机上配置附加 Tableau Bridge 客户端，以便平衡实时查询的负载。有关详细信息，请参见[允许发布者维护本地数据的实时连接](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm#set-up-more-clients)。

### 使用 Tableau Bridge 取消正在进行的已计划数据提取刷新

在某些情况下，您可能需要取消正在进行的数据提取刷新。如果已将数据提取配置为按计划刷新，您可以使用 Tableau Bridge 取消正在进行的数据提取刷新。有关详细信息，请参见[为 Tableau Bridge 数据源创建计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm#cancel)。

![包含站点、订单和模式选项的 Tableau Bridge 窗口。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_cancelrefresh.png)

### 在 Web 上连接到数据

利用 Creator 用户许可证，您可以在浏览器中直接连接到数据。上载 Excel 或基于文本的数据源、连接到云数据库中或企业中的服务器上存储的数据，或连接到保存到站点的已发布数据。有关详细信息，请参见 [Creator：在 Web 上连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_connect.htm)。

### 在 Web 上准备数据

通过“Creator”用户许可证，使用“数据源”选项卡来准备数据进行分析。创建联接、添加新数据源、使用 Data Interpreter 清理数据等。有关详细信息，请参见 [Creator：在 Web 上准备数据](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#creator_data_prep.htm)。

### 向嵌入视图中添加可访问工具栏

作者可以启用可访问工具栏，以便所有用户都能添加注释、下载视图或将其与其他人共享。有关详细信息，请参见[针对辅助功能制作视图](https://help.tableau.com/current/pro/desktop/zh-cn/accessibility_create_view.htm)中的[发布和嵌入视图](https://help.tableau.com/current/pro/desktop/zh-cn/accessibility_create_view.htm#Publish)。

### 在较早版本的 Tableau 中下载工作簿

![下载图标，带有选择下载格式的选项。](/tableau/next/zh-cn/online/zh-cn/Img/export1_92.png)

举例来说，如果需要在较早版本的 Tableau Desktop 中打开工作簿，您可能需要将工作簿下载到其他版本的 Tableau。您可以选择下载工作簿的当前版本，或将其降级为较早版本。有关版本兼容性的详细信息，请参见[使工作簿在版本之间兼容](https://help.tableau.com/current/pro/desktop/zh-cn/publish_version_compatibility.htm)。

### Web 制作增强功能

- 在 Web 上编辑视图时，您可以调整行标题的宽度和列标题的高度。
    
    ![Tableau Cloud 调整标题大小图标，左右调整标题大小。](/tableau/next/zh-cn/online/zh-cn/Img/online_resizeheader2.png) ![Tableau Cloud 调整标题大小图标，上下调整标题大小。](/tableau/next/zh-cn/online/zh-cn/Img/online_resizeheader1.png)
- “智能显示”现在可用于仪表板。
- 双击注释可编辑其文本。
- 隐藏或显示工具提示内部可视化项工作表。在用作工具提示内容可视化项的目标工作表中，单击“隐藏”。若要再次显示工具提示内部可视化项工作表，请在源工作表中单击“取消隐藏所有工作表”。
- 通过使用“分层结构中的所有值”筛选选项来筛选视图中的分层数据。
- 通过在“标记”卡中单击“路径”属性，将“线”标记类型更改为阶梯线或跳跃线。
- 双击轴可编辑轴设置。

2018 年 2 月新增

### 通过删除注释来简化讨论主题

如果注释不必要或不准确，您可以快速将其删除。只需单击右上角的“X”。有关详细信息，请参见 Tableau 用户帮助中的[向视图添加注释](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#comment.htm)。

2018 年 1 月新增

Tableau Cloud 服务器已升级到版本 10.5。

### 推荐的数据源

推荐的数据源向 Tableau Desktop 用户显示发布到 Tableau Server 和 Tableau Cloud 的相关数据源。这些建议基于组织中使用行为与当前用户类似的其他用户所使用的已发布数据源。

为了保持建议的准确性和最新状态，服务器每天都会检查以下内容：

- 新内容 - 例如新的或更新的数据源。
- 新的使用信息 - 例如，Laura Rodriguez 使用“Food Catering”（食品餐饮）数据源，Henry Wilson 使用“Monthly Sales”（月销售额）数据源。

有关推荐的数据源的信息，请参见 Tableau 用户帮助中的[使用已认证和已推荐数据源及表](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#datasource_recommended.htm)。

### 嵌套项目

如果要将内容分段为更大区域内的小节，您现在可以创建项目分层结构。例如，您可能会为每个部门创建一个项目。在每个顶级项目中，您可以根据受众使用内容的方式（例如，正在连接到验证的数据相对于正在进行协作）分离内容。有关详细信息，请参见以下文章：

- [使用项目管理内容访问权限](https://help.tableau.com/current/online/zh-cn/projects.htm)
- [在 Web 上导航 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#navigating.htm "在单独的浏览器选项卡中打开文章")一文中的“**项目导航**”

### 数据提取使用新的 .hyper 格式

当您创建数据提取时，它将使用新的 .hyper 格式。这种新格式的数据提取利用改善的数据引擎，后者支持的分析和查询性能与之前的数据引擎相同，但适用于更大的数据提取。同样，当您对 .tde 数据提取执行数据提取任务，数据提取将升级为 .hyper 数据提取。有关详细信息，请参见[“数据提取升级为 .hyper 格式”](https://help.tableau.com/current/online/zh-cn/extracting_upgrade.htm)。

### 值计算方式的更改

为了提高数据源效率和可扩展性，并生成与商用数据库一致的结果，版本 10.5 中数据源中值的计算方式可能不同。在某些情况下，这些变化可能会导致版本 10.4（及更早版本）与版本 10.5（及更高版本）之间视图中的值和标记出现差异。这适用于数据提取数据源，并且可能适用于多连接数据源、使用文件数据实时连接的数据源、连接到 Google Sheets 数据的数据源、基于云的数据源、纯数据提取数据源以及 WDC 数据源。有关详细信息，请参见 Tableau 用户帮助中的[视图中值和标记的变化](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#extracting_data.htm#semantics)。

### 桌面操作系统要求（64 位取代 32 位）

从版本 10.5 开始，Tableau Desktop、Tableau Reader 和 Tableau Public（桌面版）只能在 64 位操作系统上运行。版本 10.4 是 Tableau Desktop、Tableau Reader 和 Tableau Public 支持 32 位 Windows 操作系统的最后一个版本。

### 在 Web 制作中新建

- 向仪表板中添加文本对象并对其进行编辑。
- 编辑工作表和仪表板标题。双击标题打开“编辑标题”对话框。
- 编辑趋势线并查看趋势模型的说明。若要查看趋势模型，请将光标悬停在趋势线的任何部分上。若要在 Web 上编辑趋势线，请单击趋势线并将光标保持在原处，然后单击“编辑”菜单。
- 趋势线现在包括“幂次”选项。
- 通过将一个维度拖到“数据”窗格中的另一个维度上来创建分层结构。
- 为字段设置默认颜色属性。
- 对于定量颜色图例，提供了高级设置（未包括日期）。
- 在 Web 上编辑轴。若要在 Web 上打开“编辑轴”对话框，请在视图中双击轴。“编辑轴”对话框中可用的选项包括“**同步双轴”**、清除轴范围（“**重置**”）以及编辑刻度线。您还可以在字段上下文菜单（在“行”或“列”功能区上右键单击度量字段）中启用或禁用“**双轴**”。

### 默认情况下隐藏的经筛选的搜索

经筛选的搜索选项现在位于页面的右侧，默认情况下处于隐藏状态。如果“筛选器”窗格已打开，则切换图标为深色 (![筛选器类型滑块图标。](/tableau/next/zh-cn/online/zh-cn/Img/qs_content_filters_icon01.png))，如果“筛选器”窗格已关闭，则切换图标为浅色 (![筛选器类型滑块图标。](/tableau/next/zh-cn/online/zh-cn/Img/qs_content_filters_icon02.png))。有关搜索的详细信息，请参见[搜索内容](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#search.htm)。

若要使用经筛选的搜索，请单击 ![筛选器类型滑块图标。](/tableau/next/zh-cn/online/zh-cn/Img/qs_content_filters_icon02.png)。

![切换筛选器以显示搜索框。](/tableau/next/zh-cn/online/zh-cn/Img/filtered_search_toggle.gif)

2017 年新增

## 2017 年 9 月新增

Tableau Cloud 服务器已升级到版本 10.4。

### 数据驱动型通知

当数据达到重要业务阈值时，数据驱动型通知会自动向您指定的关键人员发送电子邮件通知。有关如何创建和管理这些通知的信息，请参见 Tableau 用户帮助中的[发送数据驱动型通知](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#data_alerts.htm)。

### 数据源认证

认证提供了一种通过策展来提升数据源的方法。站点管理员和项目负责人可以验证符合组织安全和合规标准或您定义的任何其他标准的数据源。有关详细信息，请参见[使用认证来帮助用户查找受信任的数据](https://help.tableau.com/current/online/zh-cn/datasource_certified.htm)。

### Tableau Bridge 对实时连接的支持

Tableau Bridge 中的实时查询功能现在可以由站点管理员启用，而无需向 Tableau 请求访问权限。使用 Tableau Bridge 来维持与本地关系数据的实时连接并执行计划的数据提取刷新。有关详细信息，请参见[使用 Tableau Bridge 扩展数据新鲜度选项](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)。

### 视图上的增强注释

注释已经完全重新设计，以启动有关数据发现的对话。新的“注释”窗格显示在视图右侧，而不是底部，因此您可以同时查看讨论和数据。个人资料图片也会自动显示，可帮助您快速识别其他用户。若要与他们共享已筛选的视图，请添加交互式快照以及您的注释，以突出显示您要描述的数据。

您在台式机浏览器中添加的任何注释也会出现在 Tableau Mobile 中（反之亦然），因此您可以轻松地在行动中与同事沟通。即使修改包含内容的工作簿（只要视图名称保持不变），视图仍将保留注释。有关详细信息，请参见[向视图添加注释](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#comment.htm)。

### 了解谁查看了视图

如果您拥有自己的视图，则可以快速找出组织中何人查看了您的视图。在主站点页面顶部，单击“视图”。然后将光标悬停在您感兴趣的具体视图中，从右上角的菜单中选择“谁查看了此视图？”。

### 嵌入式视图中符合 WCAG 标准的下拉式筛选器

在嵌入式视图中访问时，单值（下拉）和多值（下拉）筛选器现在符合 WCAG 标准。有关详细信息，请参见[针对辅助功能构建数据视图](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#accessibility_overview.htm)和[针对辅助功能制作视图](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#accessibility_create_view.htm)。

### Web 制作的新增功能

#### 精确的仪表板间距，带边框和背景颜色控制

如果您以前使用空白对象来完善仪表板布局，则您真的会非常喜欢新的间距控件。利用填充，您可以精确地在仪表板上放置各个项，同时边框和背景颜色可使其非常醒目。有关更多详细信息，请参见[在项周围添加填充、边框和背景颜色](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#dashboards_organize_floatingandtiled.htm)。

#### 在 Web 上打开视图工具栏

在以前的版本中，当在 Web 上制作时，您只能在使用地图视图时查看和使用“视图工具栏”。现在，您可以在 Web 制作过程中为工作簿中的任何视图或仪表板打开视图工具栏。从顶部菜单中，选择“工作表”\>“显示视图工具栏”，并选择选项。

#### 编辑组

从 Tableau 版本 10.4 开始，您可以编辑组。若要编辑组，请在“数据”窗格中，右键单击组字段，并选择“编辑组”。在打开的“编辑组”对话框中，可以在现有组中添加或删除成员，以及在组字段中创建新组。您也可以选择“包括其他组”。有关详细信息，请参见[对数据进行分组](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#sortgroup_groups_creating.htm)。

#### 创建别名

从 Tableau 版本 10.4 开始，您可以为维度中的成员创建别名，以使其标签在视图中以不同方式显示。若要为字段创建别名，请在**“数据”**窗格中，右键单击维度，并选择“别名”。在“编辑别名”对话框的“**值(别名)**”下，选择成员并输入新名称。有关详细信息，请参见[在视图中创建别名以重命名成员](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_fieldproperties_aliases_ex1editing.htm)。

#### 设置线条格式

当您在 Web 上制作时，您可以快速更改工作簿中的所有行。选择“格式”\>“工作簿”，然后展开“设置工作簿格式”中的“线条”部分，并进行选择。有关详细信息，请参见[在工作簿级别设置格式](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#formatting_workbook.htm)。

## 2017 年 7 月新增

### 订阅计划的用户特定时区

订阅计划以前局限于一个时区，但现在用户可以选择任何时区。在浏览器窗口的顶部，单击您的姓名，然后选择**“我的帐户设置”**。然后，在**“订阅时区”**下面，选择您创建的计划的时区。

## 2017 年 6 月新增

### 所有数据提取刷新的默认任务优先级

为了确保所有 Tableau Cloud 客户处理的合理分布，我们移除了站点管理员为计划数据提取刷新设置任务优先级的能力。所有以前设置的优先级将恢复为默认值。

## 2017 年 5 月新增

Tableau Cloud 服务器已升级到版本 10.3。

### Tableau Cloud sync client 发展成为 Tableau Bridge

**受限版本，依照请求提供。**Tableau Online sync client 已经获得了一些新的功能和一个新的名称。使用 Tableau Bridge 来维持与本地关系数据的实时连接。Bridge 还具有 sync client 中提供的所有功能，以用于计划数据提取刷新。您现有的计划将继续按照 sync client 中以前定义的方式运行。 

站点管理员只有发出请求才能使用实时查询功能。有关详细信息，请参见[使用 Tableau Bridge 扩展数据新鲜度选项](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)。

### 身份提供程序的 SAML 加密断言

Tableau Cloud 现在支持身份提供程序的 SAML 加密断言。若要了解有关配置 SAML 单点登录的更多信息，请参见[在站点上启用 SAML 身份验证](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm)。

### 支持用户的站点访问权限

Tableau Cloud 管理员可以允许批准的 Tableau 支持技术人员访问其 Tableau Cloud 站点，以帮助进行客户支持案例疑难解答。若要了解更多信息，请参见[启用支持访问权限](https://help.tableau.com/current/online/zh-cn/enable_support_access.htm)。

### 帮助重新设计

从版本 10.3 开始，Tableau Desktop 帮助现在称为 Tableau 帮助。Tableau 帮助包含与在 Tableau Desktop、Tableau Server 和 Tableau Cloud 中分析和使用数据相关的所有帮助主题。此帮助适用于创建工作簿或数据源并发布它们的人员，以及想要在 Tableau 中查看视图、与视图交互和共享视图的人员。

我们欢迎您提供有关此更改的反馈，以及您可能具有的关于如何使我们的内容更好的任何反馈或想法。请使用任何页面顶部的反馈栏（“此页面是否有帮助？”），以打开注释字段并提交您的反馈。

[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_home.htm) 提供了曾位于 Tableau Server 和 Tableau Cloud 帮助中的主题链接。

### Web 制作的新增功能

从版本 10.3 开始，Tableau Server 和 Tableau Cloud 的 Web 制作主题现在位于 [Tableau 帮助](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm)中。

#### 保存数据源

现在，您可以选择将已发布工作簿中嵌入的数据源另存为 Tableau Server 和 Tableau Cloud 上其他用户可以连接到的已发布的单独数据源。保存数据源时，可以选择更新工作簿以连接到新保存的数据源。

![下拉菜单中包含刷新、关闭、保存和查看当前维度的选项。](/tableau/next/zh-cn/online/zh-cn/Img/datasource_saveonweb1.png) ![出现一个对话框，询问您是否要保存数据源“Sales Target”（销售目标）以供服务器上共享使用。](/tableau/next/zh-cn/online/zh-cn/Img/datasource_saveonweb2.png)

#### 编辑定量颜色图例

您现在可以在 Web 制作中编辑连续颜色图例的调色板。您可以从“标记”卡中或通过单击图例上的下拉箭头打开“编辑颜色”对话框。

<table><tbody><tr><td><b>“标记”卡：</b></td><td><b>图例：</b></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/editquantiativecolors_markscard.png" alt="“标记”卡上突出显示的“编辑颜色”按钮以及单击该按钮时打开的“编辑颜色”对话框。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/editquantiativecolors_legend.png" alt="“编辑颜色”对话框，其中包含用于自定义利润图表颜色的选项，图表图例的快照显示了打开对话框的向下箭头菜单。"></td></tr></tbody></table>

您还可以通过输入十六进制值为起始和结束颜色设置自定义颜色。

![“编辑颜色”对话框，其中包含用于自定义利润图表颜色的选项。](/tableau/next/zh-cn/online/zh-cn/Img/editquantiativecolors_hex.png)

#### 在分离的图例上编辑颜色

当您为视图中的度量创建单独的颜色图例时，您不再仅限于从 Tableau Desktop 中发布视图后只能使用默认调色板或分配给每个颜色图例的调色板。

在 Web 制作模式下，您可以为每个图例选择不同的调色板。单击图例上的下拉箭头以打开“编辑颜色”对话框，然后选择调色板。您还可以使用十六进制值设置自定义的开始和结束颜色。

![“图例”上下文菜单展开以显示编辑图例调色板的选项。](/tableau/next/zh-cn/online/zh-cn/Img/LPM_separatecolor.png)

#### 自定义用户与您的地图交互的方式

在 Web 制作模式下，您现在可以使用“地图选项”对话框，通过以下方式来自定义受众与地图视图的交互方式。

- 显示地图标度
- 隐藏地图搜索
- 隐藏视图工具栏
- 关闭平移和缩放

有关详细信息，请参见[自定义用户与地图的交互方式](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#maps_customize_interaction.htm)。

#### 在 Web 上设置数字格式

现在，您可以在 Tableau Server 和 Tableau Cloud 上指定视图中度量的基本数字格式。有关详细信息，请参见“在 Tableau Server 或 Tableau Cloud 上设置数字和 Null 值的格式”。

![一个下拉菜单中，包含用于将数字格式设置为自动、标准数字、自定义数字、标准货币、自定义货币、百分比、科学或自定义的选项。](/tableau/next/zh-cn/online/zh-cn/Img/format_numbers_web2.png)

#### 创建故事

在 Web 制作模式下，您现在可以创建故事以讲述数据，提供上下文，演示决策与结果的关系，或者只是创建一个极具吸引力的案例。有关详细信息，请参见[创建故事](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#story_create.htm)。

![Tableau Cloud 上的故事。](/tableau/next/zh-cn/online/zh-cn/Img/story_web.png)

#### 创建和编辑数据桶

在 Tableau Server 和 Tableau Cloud 中依据连续度量创建数据桶并编辑它们，这类似于您在 Tableau Desktop 中的操作方法。有关详细信息，请参见[依据连续度量创建数据桶](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#calculations_bins.htm)。

#### 在视图中将字段拖到“智能显示”

选择感兴趣的维度和度量并将其拖到视图区域。“智能显示”视图会自动创建。然后，您可以单击其他“智能显示”选项来尝试不同的视图类型。

![将字段拖到视图上即可查看“智能显示”框。](/tableau/next/zh-cn/online/zh-cn/Img/showme_drag_web.gif)

#### 在视图中向上和向下钻取连续的层次结构

在具有连续层次结构的视图中，将鼠标悬停在连续轴上的标题附近以显示 + 和 - 控件。单击以向下或向上钻取。

![在 Web 上进行上钻和下钻查询。](/tableau/next/zh-cn/online/zh-cn/Img/drillupdown_web1.gif)

## 2017 年 3 月新增

### Google 身份验证

Google 验证使您能方便地将您的 Google ID 和密码用于 Tableau Cloud，从而可减少访问 Tableau Cloud 时出现的登录提示的数量。站点管理员可以集中管理这些凭据，因此您不再需要重置多个密码。有关 Google 身份验证的详细信息，请参见[身份验证](https://help.tableau.com/current/online/zh-cn/security_auth.htm)。

### 自定义订阅计划

订阅计划过去常常被限制为一组标准选项，但现在您可以收到有关最适合您的计划的电子邮件。若要了解详细信息，请参见[订阅视图](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#subscribe_user.htm)。

![数据订阅表单，提供多种订阅频率选项。](/tableau/next/zh-cn/online/zh-cn/Img/self_subscribe_whatsnew.png)

## 2017 年 2 月新增

Tableau Cloud 服务器已升级到版本 10.2。

[Tableau Server 新增功能](https://help.tableau.com/current/server/zh-cn/whatsnew_server.htm)中的以下各项也适用于 Tableau Cloud。

- 支持辅助功能合规性
    
    此项中提到的功能适用于想要创建发布到 Tableau Cloud 或 Tableau Server 的可访问视图的 Tableau Desktop 作者。
- Web 制作增强功能

2016 年新增

## 2016 年 11 月新增

Tableau Cloud 服务器已升级到版本 10.1。

### Web 制作增强功能

- 在视图中显示或隐藏标题。
- 查看仪表板的只读设备布局。

### 全屏视图

若要扩展视图，请单击工具栏最右侧的“全屏”。若要将视图恢复为以前的大小，请按 Esc。

![用于扩大窗口以填满屏幕的选项。](/tableau/next/zh-cn/online/zh-cn/Img/full_screen.png)

### 发送高优先级通知的订阅

如果您已将视图配置为仅当存在高优先级信息时才包含数据，请选择新的订阅选项“视图为空的情况下不发送”。有关详细信息，请参见[订阅视图](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#subscribe_user.htm)和[管理订阅设置](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#useracct.htm)。

### 用于下载 tabcmd 的新位置

tabcmd 安装程序现在可从 Tableau 网站上的 [Tableau Server Releases](https://www.tableau.com/zh-cn/support/releases/server) 页面中获得。在此位置中，您始终可找到 tabcmd 的最新版本。

tabcmd 下载位于发行说明上的版本号下方。

Tableau Cloud 帮助中的链接也已更改。如果将此链接加入书签，您可以在[安装 tabcmd](https://help.tableau.com/current/online/zh-cn/tabcmd.htm#tabcmd-install) 时对其进行更新。

<!-- document id=5571f668c3ff09d3b1e2e9bafac1f4f37f6adb1ff46664adf21717970741f07b url=/tableau/next/zh-cn/online/to_bridge_eds_performance.md -->

[跳转到主要内容](#main-content)

# 优化 Bridge 刷新性能

Tableau Bridge 支持已发布数据源和嵌入式数据源的数据提取刷新。已发布数据源允许您扩大组织内数据分析的受众范围。嵌入式数据源保存到工作簿中，可以轻松共享，而无需单独共享数据源。

已发布数据源和嵌入式数据源各有优势。一般来说，通过 Bridge 进行的已发布数据源刷新最适合长时间运行的刷新任务。通过 Bridge 进行的嵌入式数据源刷新最适合短期运行的刷新任务和集成数据源。

下表显示了使用 Bridge 时根据性能在已发布数据源和嵌入式数据源之间进行选择的一些建议。

**注意**：性能可能会有所不同，具体取决于您运行的硬件和基础设施。

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 280px;"><col style="width: 300px;"></colgroup><tbody><tr><td><b>使用已发布数据源 </b></td><td><b>使用嵌入式数据源</b></td></tr><tr><td>发布数据源是实现数据集中管理的一步。您可以与多个工作簿共享数据源，并创建旨在最大限度地减少数据源扩散并帮助人们找到适合其工作的数据的策略。有关已发布数据源的更多信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources_about.htm">发布的数据源的最佳做法</a>。</td><td>您不想共享数据源。数据只能用于工作簿内部；无法供要连接到的其他用户使用。</td></tr><tr><td>当连接到仅包含专用网络连接的集成数据源时，或者在只有轻量级公共连接和专用网络连接的情况下。</td><td>嵌入式数据源包括来自公共网络数据源的大型数据集和来自专用网络连接的短期运行任务。</td></tr><tr><td>对于长时间运行的刷新任务，根据您的 Bridge 部署，已发布数据源可以提供更好的性能。</td><td><p>适用于短期运行的刷新任务。如果在现有的已发布数据源或直接连接数据的工作簿上数据源的刷新时间预计超过 10 分钟，则使用嵌入式数据源可能无法提供最佳性能。</p><p>为了确保长时间运行的刷新任务不会占用所有系统资源，并且不会阻止站点上其他数据提取的刷新，Tableau Cloud 将为刷新任务强制实施 （120 分钟）的超时限制。请参见<a href="https://help.tableau.com/current/online/zh-cn/schedule_add.htm">数据提取刷新的时间限制</a>。</p></td></tr></tbody></table>

## 嵌入式数据源数据提取刷新故障排除

如果刷新任务达到超时限制，您可以尝试使用以下选项解决问题。

- 减少数据提取的大小。有关详细信息，请参见[优化数据提取](https://help.tableau.com/current/server/zh-cn/perf_optimize_extracts.htm)。
- 如果您使用完全刷新，则在某些情况下使用增量刷新可能会有所帮助。有关详细信息，请参见[不要超过超时限制](https://help.tableau.com/current/online/zh-cn/schedule_add.htm)。
- 将嵌入式数据源转换为已发布数据源。

<!-- document id=6a406b15e7288a59ad9af5aace46be459f2e7da42be1a75400cb73fe0cc1b40f url=/tableau/next/zh-cn/online/datasource_mfr_when_to_use.md -->

[跳转到主要内容](#main-content)

# 何时使用多事实关系模型

多事实关系模型是一种数据模型，它允许您在单个数据源中添加不相关的表，然后在可视化分析期间使用相关字段根据上下文将表实质上拼接在一起。与混合不同，数据存在于单个数据源中 - 主数据源和辅助数据源的概念不适用，并且不会从左联接中删除任何数据。与单表数据模型不同，多个基表维护自己的关于他们之间共享的表的上下文。多事实关系数据模型为您提供了在 Tableau 中执行多事实分析的更多选项。

想象一下，您想分析天气和冰淇淋销售趋势如何结合在一起。天气和冰淇淋销售都发生在特定的时间和特定的地点，但冰淇淋销售和天气之间没有直接联系。这些是不相关的数据片段，但都与日期和地点的共同概念相关。

这个问题有助于创建多事实关系模型。冰淇淋销售和天气均可添加为基表，并在“Date”（日期）和“Location”（地点）（共享表）上相关。

![具有两个基表和两个共享表的多基表数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_icw_.png)

多基表数据模型，包含两个不相关的表（“Cream Sales”（冰淇淋销售）和“Weather”（天气））和两个共享表（“Date”（日期）和“Location”（地点））。“Ice Cream Sales”（冰淇淋销售）和“Location”（地点）之间有一个中间表，即“Parlor Info”（店铺信息）。

### 为什么我们要构建对不相关表进行建模的能力？

分析通常涉及汇总彼此之间没有直接关系但都与相同的共同信息（例如日期或地点）相关的数据表。多事实关系模型通过引入相关度概念和使用多个不相关基表构建数据模型的能力来支持松散语义耦合。

- 语义耦合是用来描述数据组合紧密程度的术语。_联接_或_并集_是一种紧密的语义耦合；它们将多个表组合成一个新的物理表，然后充当单个表。_关系_是表之间的一种松散耦合，将表在逻辑上联系在一起，保持它们作为单独表的不同状态。语义耦合谱的进一步延伸是 _数据混合_，其中来自不同数据源的结果根据它们之间共享的元素进行可视化组合。_多事实关系模型_更接近于光谱的混合端，但是在单个数据源内而不是跨数据源。

多事实关系模型（具有多个基表的数据模型）允许模型中存在不相关的表，只要模型中也存在共享表。在分析过程中，共享表中的字段根据共同的维度（例如在同一地点或同一时间发生）将原本不相关的数据表“拼接”在一起。关系的所有优点都得以保留，包括保留每个表的粒度或本机详细级别。

与单基表数据模型类似，Tableau 根据可视化项的结构确定后台使用的最佳联接类型。但在多事实关系模型中，联接选项扩展为包括外部联接和交叉联接，以处理不同级别的关联性。有关详细信息，请参见[关于多事实关系数据模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_mfr_multiple_base_tables.htm)。

### 这个名称从何而来？

多事实关系因多事实分析而得名。在数据仓库模型中，数据存储在被维度表包围的中央事实表中。在此上下文中，_事实_ 指测量值或指标，即用于捕获有关数据的事实的数据数字字段，也就是 Tableau 的度量。维度表包含有关这些事实的属性。

基于事实表的架构通常构造为星型或雪花型，具体取决于维度表的组织方式。当需要跨事实表进行分析时，这称为多事实分析。分析是在公共维度表（称为共享维度或一致维度）的上下文中完成的。在 Tableau 中，您可以使用关系构建这些数据模型，因此我们将这套功能命名为多事实关系。

## 何时使用多事实关系数据模型

如果您的数据由彼此相关的表组成，那么您可以坚持使用通过关系构建的单个基表数据源。当您的数据跨越不同的概念（无论是多个事实表的形式还是不同的不相关上下文的形式）时，就需要多事实关系模型。

只要有可能，就使用单个基表构建数据源。在单基表数据模型中，每个表都是相关的，无需考虑相关程度。仅在需要该数据模型结构时才使用多事实关系。

### 多事实分析

多事实分析是 Tableau 中多事实关系的核心用例。在这个例子中，事实 A 和事实 B 共享一个表，即“Date”（日期）。

![多事实数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_use_mfa_model.png)

为了在 Tableau 中对此进行建模，事实表成为基表，并为其共享维度表建立多个传入关系。

![多事实关系数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_use_mfr_model.png)

### 其他场景

然而，多事实关系数据模型不仅仅用于多事实分析。Tableau 不需要严格定义事实表或维度表。任何表都可以作为基表（尽管它应该适合[基表的特征](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_when_to_use.htm#characteristics)）。一些表明多基表数据源可能会有帮助的场景包括： 

- **经历各个阶段**，例如共享学生表的申请表、成绩单表和校友活动表等基表。
- **同一事件的不同上下文**，例如医疗预约和账单发票事件的基表，以及用于将上下文设置为医生或患者的共享表。
- **可能相关的不同领域，**例如以前最好通过数据混合来处理的场景，例如通过共享的日期和地点表关联起来的冰淇淋销售和天气。

在此 Tableau 博客文章中了解有关多事实关系何时有用的更多信息：[何时以及如何在 Tableau 中使用多事实关系](https://www.tableau.com/zh-cn/blog/when-how-use-multi-fact-relationships-tableau)。

## 识别基表

在多事实关系模型中，方向性很重要。也就是说，哪些表是模型左侧的基表，以及哪些表在下游共享会影响如何评估关系以返回分析结果。

考虑一下发票、预约、医生和患者的概念性领结：

![一个领结数据模型，外部是发票和预约，中间是医生和患者](/tableau/next/zh-cn/online/zh-cn/Img/mfr_bowtie1.png)

在 Tableau 中构建数据模型的正确方法是以“Invoices”（发票）和“Appointments”（预约）作为基表，以“Doctors”（医生）和“Patients”（患者）作为共享表（而不是以“Doctors”（医生）和“Patients”（患者）作为基表）。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p><b>正确</b>：“Invoices”（发票）和“Appointments”（预约）作为基表</p></td><td><p><b>错误</b>：“Doctors”（医生）和“Patients”（患者）作为基表</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_bowtie2.png" alt="以发票和预约为基表、以医生和患者为下游共享表的多基表数据模型"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_bowtie3_wrong.png" alt="以医生和患者为基表，以发票和预约为下游共享表的多基表数据模型"></td></tr></tbody></table>

从概念上讲，患者（或医生）是将预约事件和发票事件拼接在一起的实体。

如果您的数据模型是逆向的（例如以医生和患者作为基表，而不是预约和发票）， [外部联接拼接行为](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#Stitched)就没那么有用了。您的分析可能会显示出很多表范围的度量和歧义。如果您发现自己拥有意想不到的模糊相关字段，请重新评估用作基表的表，并查看数据模型是否需要反转。

### 基表和共享表的特征

如果您正在执行多事实分析，则事实表将成为基表，任何共享维度表都是共享表。Tableau 不要求严格遵守事实表和维度表的特征。但是，某些属性可以帮助您识别哪些表应该是基表，哪些表应该是共享表。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p style="font-weight: bold;">基表</p></td><td><p><b>共享表</b></p></td></tr><tr><td><p>数据仓库架构中的事实表</p></td><td><p>数据仓库架构中的共享或一致维度表</p></td></tr><tr><td><p>具体到上下文或分析</p><p>（航班信息、能源使用情况）</p></td><td><p>在不同上下文中保持一致的概念</p><p>（日期、地点）</p></td></tr><tr><td><p>测量重量</p></td><td><p>主要维度</p></td></tr><tr><td><p>更新/事务性更频繁</p><p>（医疗预约、处方、生命体征）</p></td><td><p>更稳定/持久</p><p>（医生、患者）</p></td></tr><tr><td><p>具有外键字段</p></td><td><p>具有主键字段</p></td></tr><tr><td><p>基于事件</p><p>（课程表、作业成绩）</p></td><td><p>基于实体</p><p>（学生，教室）</p></td></tr></tbody></table>

请注意，如果基表和共享表之间存在中间表，则可以 [交换哪个表是基表](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_build.htm#swap)，而无需从根本上改变数据模型。（例如第一个例子中的“Parlor Info”（店铺信息）和“Ice Cream Sales”（冰淇淋销售）。）重要的是哪些表位于共享表的上游以及哪些表是共享表。

### 尝试使用其他基表

有多种情况可能表明您应该构建具有多个基表而不是单个基表数据源的多事实关系模型：

- 如果您尝试构建具有循环的数据源，则下游表应该是另一个基表。
- 如果您有一系列在同一组关系子句（例如日期和地点）上相关的表，则应该将这些维度拉出来并制成共享表。
    - 这尤其有用，因为多个关系子句必须全部为真（逻辑上为 AND），表才能与这些记录相关。
    - 相反，如果您想要分析一次可能为真的记录（上下文 Or），则可以通过设置具有共享维度表的数据模型来提供这种灵活性。
- 如果您正在使用混合，但希望获得没有主要和辅助数据源的等效混合，请构建一个数据模型，将混合中的数据源与一个或多个共享表中的链接字段相结合。

<!-- document id=3179cd267845eefd1a5d61869faae37444a1e232d456d4734e5064117255e538 url=/tableau/next/zh-cn/online/saml_config_adfs.md -->

[跳转到主要内容](#main-content)

# 使用 AD FS 配置 SAML

您可以将 Active Directory 联合服务 (AD FS) 配置为 SAML 身份提供程序，并将 Tableau Cloud 或 Tableau Cloud Manager (TCM) 添加或 Tableau Cloud Manager (TCM)到支持的单点登录应用程序。如果将 AD FS 与 SAML 和 Tableau Cloud 或 TCM 集成，用户可以使用其标准网络凭据登录到 Tableau Cloud 或 TCM。

**注意：** 

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在您的 IdP 帐户中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 IdP 的文档。
- 自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 先决条件

您的环境必须具有以下各项，然后才能使用 AD FS 配置 Tableau Cloud 或 TCM 和 SAML：

- 运行 Microsoft Windows Server 2008 R2（或更高版本）并安装了 AD FS 2.0（或更高版本）及 IIS 的服务器。
- 我们建议您保护 AD FS 服务器的安全（例如，使用反向代理）。如果可从防火墙外部访问您的 AD FS 服务器，则 Tableau 可将用户重定向到 AD FS 托管的登录页面。
- 对于 Tableau Cloud，使用带有 MFA 的 Tableau 身份验证的站点管理员帐户。如果 SAML 单点登录失败，您仍然能够以站点管理员身份登录到 Tableau Cloud。
- 对于 TCM，使用带有 MFA 的 Tableau 身份验证的站点管理员帐户。如果 SAML 单点登录失败，您仍然能够登录到 TCM。

## 步骤 1：开始

在 Tableau Cloud 中，执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

在 AD FS 中，执行以下操作：

下面的过程导出将导入到 Tableau Cloud 或 TCM 的 AD FS 元数据。您还将确保已针对 Tableau 对元数据进行了正确配置和编码，并验证 SAML 配置的其他 AD FS 要求。

1. 将 AD FS 联合元数据导出到 XML 文件，然后从 **https://_<adfs 服务器名称>_/federationmetadata/2007-06/FederationMetadata.xml** 下载文件。
2. 在文本编辑器（如 Sublime Text 或 Notepad++）中打开元数据文件，并验证它是否正确编码为无 BOM 的 UTF-8。
    
    如果文件显示某种其他编码类型，请使用正确的编码从文本编辑器中保存该文件。
3. 验证 AD FS 是否使用基于表单的身份验证。登录是在浏览器窗口中执行的，因此您需要 AD FS 默认使用这种类型的身份验证。
    
    编辑 **c:\\inetpub\\adfs\\ls\\web.config**，搜索相关标记**，**并移动行以使其显示为列表中的第一行。保存文件，以便 IIS 能够自动重新加载它。
    
    **注意：**如果未看到 **c:\\inetpub\\adfs\\ls\\web.config** 文件，则 AD FS 服务器上未安装和配置 IIS。
4. 配置其他 AD FS 信赖方标识符。这使得您的系统能够解决 SAML 注销的任何 AD FS 问题。
    
    执行以下操作之一：
    
    Windows Server 2008 R2：
    
    1. 在 **AD FS 2.0** 中，右键单击您之前为 Tableau Cloud 或 TCM 创建的信赖方，并单击**“属性”**。
    2. 在**“标识符”**选项卡上的**“信赖方标识符”**框中，输入 **https://<tableauservername>/public/sp/metadata**，然后单击**“添加”**。
    
    Windows Server 2012 R2：
    
    1. 在**“AD FS 管理”**的**“信赖方信任”**列表中，右键单击您之前为 Tableau Cloud 或 TCM 创建的信赖方，并单击**“属性”**。
    2. 在**“标识符”**选项卡上的**“信赖方标识符”**框中，输入 **https://<tableauservername>/public/sp/metadata**，然后单击**“添加”**。

## 步骤 2：在 Tableau Cloud 或 TCM 中配置 SAML

按照上一部分所述，保存来自 AD FS 的 SAML 元数据文件后，完成以下过程。

**对于 Tableau Cloud**

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 AD FS 导出的 SAML 元数据文件 (FederationMetadata.xml)。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 跳过“3.地图属性”，因为您将在 AD FS 中创建声明规则，以匹配 Tableau Cloud 在以下部分中期望的属性名称。
3. 在“4.选择嵌入视图的默认设置(可选)”下，选择您要在用户访问嵌入内容时启用的体验。
4. 单击“保存并继续”按钮。
5. 在“5.获取 Tableau Cloud 元数据”下，单击“导出元数据”按钮，并将 Tableau 元数据文件保存到您的计算机。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。

**对于 TCM**

1. 返回 TCM，在“身份验证”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 AD FS 导出的 SAML 元数据文件 (FederationMetadata.xml)。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 跳过“3.映射属性”，因为您将在 AD FS 中创建声明规则，以匹配 TCM 在以下部分中期望的属性名称。
3. 单击“保存并继续”按钮。
4. 在“4.获取 Tableau Cloud 元数据”下，单击“导出元数据”按钮，并将 Tableau 元数据文件保存到您的计算机。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。

## 步骤 3：在您的 IdP 中配置“Tableau Cloud 应用程序”

将 AD FS 配置为接受 Tableau Cloud 或 TCM 登录请求是一个多步骤过程，此过程从将 Tableau Cloud 或 TCM 元数据文件导入 AD FS 开始。

1. 执行以下操作之一以打开**添加依赖方信任向导**：

Windows Server 2008 R2：

1. 单击**“开始”菜单** >**“管理工具”**\>**“AD FS 2.0”**。
2. 在**“AD FS 2.0”**中的**“信任关系”**下，右键单击**“信赖方信任”**文件夹，然后单击**“添加信赖方信任”**。

Windows Server 2012 R2：

1. 打开**“服务器管理器”**，然后在**“工具”**菜单上单击**“AD FS 管理”**。
2. 在**“AD FS 管理”**中的**“操作”**菜单上，单击**“添加信赖方信任”**。

6. 在**“添加信赖方信任向导”**中，单击**“开始”**。
7. 在**“选择数据源”**页面上，选择**“从文件导入有关信赖方的数据”**，然后单击**“浏览”**找到 Tableau Cloud 或 TCM 元数据文件。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。
8. 单击**“下一步”**，然后在**“指定显示名称”**页面上的**“显示名称”**和**“备注”**框中，为信赖方信任键入名称和说明。
9. 单击“下一步”跳过**“立即配置多重身份验证”**页面。
10. 单击“下一步”跳过**“选择颁发授权规则”**页面。
11. 单击“下一步”跳过**“准备好添加信任”**页面。
12. 在**“完成”**页面上，选中**“向导关闭时打开此信赖方信任的‘编辑声明规则’对话框”**复选框，然后单击**“关闭”**。

接下来，您将在**“编辑声明规则”**对话框中进行操作，以添加一个规则，来确保 AD FS 发送的断言与 Tableau Cloud 或 TCM 需要的断言匹配。 Tableau Cloud或 TCM 至少需要一个用户名（电子邮件地址格式）。不过，如果除电子邮件之外还包括名字和姓氏，则可确保 Tableau Cloud 或 TCM 中显示的用户名与 AD 帐户中的用户名相同。

1. 在“编辑声明规则”对话框中，单击**“添加规则”**。
2. 在**“选择规则类型”**页面上，针对**“声明规则模板”**，选择**“以声明方式发送 LDAP 特性”**，然后单击**“下一步”**。
3. 在**“配置声明规则”**页面上，针对**“声明规则名称”**，输入对您有意义的规则名称。
4. 对于**“特性存储”**，选择**“Active Directory”**，按如下所示方式完成映射，然后单击**“完成”**。

映射区分大小写，并且需要准确的拼写，因此请仔细检查您输入的内容。此处的表显示了常见的属性和声明映射。使用特定的 Active Directory 配置验证属性。

**注意：**Tableau Cloud 或 TCM 需要 SAML 响应中的 **NameID** 属性。您可以提供其他属性来映射 Tableau Cloud 或 TCM 中的用户名，但响应消息必须包含 **NameID** 属性。

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>LDAP 特性</th><th>传出声明类型</th></tr><tr><td><p>取决于 AD FS 的版本：</p><p>User-Principal-Name<br><i>或</i><br>E-Mail-Addresses</p></td><td><p>&nbsp;</p><p>email<br><i>或</i><br>电子邮件地址<br></p></td></tr><tr><td>Given-Name</td><td>firstName</td></tr><tr><td>Surname</td><td>lastName</td></tr></tbody></table>

如果运行的是 AD FS 2016 或更高版本，则必须添加一个规则以经历所有声明值。如果运行的是早期版本的 AD FS，请跳到下一个过程以导出 AD FS 元数据。

1. 单击“**Add Rule**”（添加规则）。
2. 在“**Claim rule template**”（声明规则模板）下，选择**“Pass Through or Filter an Incoming Claim”（经历或筛选传入声明）。**
3. 在“**Claim rule name**”（声明规则名称）下，输入“Windows”。
4. 在“**Edit Rule - Windows**”（编辑规则 - Windows）弹出窗口中：
    - 在“**Incoming claim type**”（传入声明类型）下，选择“**Windows account name**”（Windows 帐户名）。
    - 选择“**Pass through all claim values**”（传递所有声明值）。
    - 单击**“确定”**。

在 Tableau Cloud 中，执行以下操作：

1. 返回 Tableau Cloud，在“新配置”页面的“3.地图属性”下，在 Tableau Cloud 中填充来自 AD FS 的声明值。
2. 单击“保存并继续”按钮。

或者，在 TCM 中执行以下操作：

1. 返回 TCM，在“身份验证”页面的“3.映射属性”下，在 TCM 中填充来自 AD FS 的声明值。
2. 单击“保存并继续”按钮。

## 步骤 4：在 Tableau Cloud 或 TCM 中测试 SAML 配置

1. 在 Tableau Cloud 或 TCM 中，向 ADFS 和 Tableau Cloud 或 TCM 添加示例用户以测试 SAML 配置。
    
    - 若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
    - 若要在 TCM 中添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。

## 步骤 3.在您的 IdP 中配置 Tableau Cloud 应用程序

将 AD FS 配置为接受 Tableau Cloud 登录请求是一个多步骤过程，此过程从将 Tableau Cloud 元数据文件导入 AD FS 开始。

1. 执行以下操作之一以打开**添加依赖方信任向导**：

Windows Server 2008 R2：

1. 单击**“开始”菜单** >**“管理工具”**\>**“AD FS 2.0”**。
2. 在**“AD FS 2.0”**中的**“信任关系”**下，右键单击**“信赖方信任”**文件夹，然后单击**“添加信赖方信任”**。

Windows Server 2012 R2：

1. 打开**“服务器管理器”**，然后在**“工具”**菜单上单击**“AD FS 管理”**。
2. 在**“AD FS 管理”**中的**“操作”**菜单上，单击**“添加信赖方信任”**。

6. 在**“添加信赖方信任向导”**中，单击**“开始”**。
7. 在**“选择数据源”**页面上，选择**“从文件导入有关信赖方的数据”**，然后单击**“浏览”**找到 Tableau Cloud 元数据文件。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。
8. 单击**“下一步”**，然后在**“指定显示名称”**页面上的**“显示名称”**和**“备注”**框中，为信赖方信任键入名称和说明。
9. 单击“下一步”跳过**“立即配置多重身份验证”**页面。
10. 单击“下一步”跳过**“选择颁发授权规则”**页面。
11. 单击“下一步”跳过**“准备好添加信任”**页面。
12. 在**“完成”**页面上，选中**“向导关闭时打开此信赖方信任的‘编辑声明规则’对话框”**复选框，然后单击**“关闭”**。

接下来，您将在**“编辑声明规则”**对话框中进行操作，以添加一个规则，来确保 AD FS 发送的断言与 Tableau Cloud 需要的断言匹配。Tableau Cloud 至少需要一个用户名（电子邮件地址格式）。不过，如果除电子邮件之外还包括名字和姓氏，则可确保 Tableau Cloud 中显示的用户名与 AD 帐户中的用户名相同。

1. 在“编辑声明规则”对话框中，单击**“添加规则”**。
2. 在**“选择规则类型”**页面上，针对**“声明规则模板”**，选择**“以声明方式发送 LDAP 特性”**，然后单击**“下一步”**。
3. 在**“配置声明规则”**页面上，针对**“声明规则名称”**，输入对您有意义的规则名称。
4. 对于**“特性存储”**，选择**“Active Directory”**，按如下所示方式完成映射，然后单击**“完成”**。

映射区分大小写，并且需要准确的拼写，因此请仔细检查您输入的内容。此处的表显示了常见的属性和声明映射。使用特定的 Active Directory 配置验证属性。

**注意：**Tableau Cloud 需要 SAML 响应中的 **NameID** 属性。您可以提供其他属性来映射 Tableau Cloud 中的用户名，但响应消息必须包含 **NameID** 属性。

<table class="simple-table"><colgroup><col><col></colgroup><tbody><tr><th>LDAP 特性</th><th>传出声明类型</th></tr><tr><td><p>取决于 AD FS 的版本：</p><p>User-Principal-Name<br><i>或</i><br>E-Mail-Addresses</p></td><td><p>&nbsp;</p><p>email<br><i>或</i><br>电子邮件地址<br></p></td></tr><tr><td>Given-Name</td><td>firstName</td></tr><tr><td>Surname</td><td>lastName</td></tr></tbody></table>

如果运行的是 AD FS 2016 或更高版本，则必须添加一个规则以经历所有声明值。如果运行的是早期版本的 AD FS，请跳到下一个过程以导出 AD FS 元数据。

1. 单击“**Add Rule**”（添加规则）。
2. 在“**Claim rule template**”（声明规则模板）下，选择**“Pass Through or Filter an Incoming Claim”（经历或筛选传入声明）。**
3. 在“**Claim rule name**”（声明规则名称）下，输入“Windows”。
4. 在“**Edit Rule - Windows**”（编辑规则 - Windows）弹出窗口中：
    - 在“**Incoming claim type**”（传入声明类型）下，选择“**Windows account name**”（Windows 帐户名）。
    - 选择“**Pass through all claim values**”（传递所有声明值）。
    - 单击**“确定”**。

在 Tableau Cloud 中，执行以下操作：

1. 返回 Tableau Cloud，在“新配置”页面的“3.地图属性”下，在 Tableau Cloud 中填充来自 AD FS 的声明值。
2. 单击“保存并继续”按钮。

## 步骤 4：在 Tableau Cloud 中测试 SAML 配置

1. 在 Tableau Cloud 中，向 ADFS 和 Tableau Cloud 添加示例用户以测试 SAML 配置。若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
2. 返回“新配置”页面，在“7.测试配置”下，单击“测试配置”按钮。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

## 步骤 5：将其他用户添加到启用 SAML 的 Tableau Cloud 站点

使用下面的步骤将其他用户添加到您的站点。本部分中描述的程序是在 Tableau Cloud 的“用户”页面上执行的。

1. 完成上述步骤后，从左侧窗格导航至“用户”页面。
2. 按照[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题中描述的过程进行操作。或者，您可以按照[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)主题中描述的程序使用 .csv 文件添加用户 。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

## 步骤 5：将其他用户添加到启用 SAML 的 Tableau Cloud 站点 或 TCM

使用下面的步骤将其他用户添加到您的站点。本部分中描述的程序是在 Tableau Cloud 或 TCM 的“用户”页面上执行的。

1. 完成上述步骤后，从左侧窗格导航至“用户”页面。
2. 按照以下主题之一中描述的步骤进行操作：
    
    - 对于 Tableau Cloud，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。或者，您可以按照[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)主题中描述的程序使用 .csv 文件添加用户 。
    - 对于 TCM，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。或者，您可以按照同一主题中的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm##bulk-import-users)部分描述的程序，使用 .csv 文件添加用户。

## AD FS 的 SAML 支持的其他要求和提示

- 在 AD FS 和 Tableau Cloud 或 TCM之间设置 SAML 集成之后，您必须更新 Tableau 以反映在 Active Directory 中所做的特定用户更改。例如，添加或移除用户。
    
    您可以自动或手动添加用户：
    
    - **自动添加用户**：（使用 PowerShell、Python 或批处理文件）创建一个脚本，将 AD 更改推送到 Tableau Cloud 或 TCM。脚本可以使用 [tabcmd](https://help.tableau.com/v0.0/online/zh-cn/tabcmd_cmd.htm) 或 [Tableau REST API](https://help.tableau.com/v0.0/online/zh-cn/dev_resources.htm) 与 Tableau Cloud 交互。脚本可以使用 [Tableau Cloud Manager REST API](https://help.tableau.com/v0.0/online/zh-cn/dev_resources.htm) 与 TCM 交互。
    - **手动添加用户：**登录到 Tableau Cloud 或 TCM UI，转到“用户”页面，单击“添加用户”，选择“按用户名添加用户”，并输入用户的用户名或上载包含用户信息的 .csv 文件。
    
    **注意：**如果要移除用户但保留用户拥有的内容资产，请在移除用户之前更改内容的所有者。删除用户也会删除他们拥有的内容。
- 在 Tableau Cloud 或 TCM 中，用户的用户名是其唯一标识符。如用于配置 AD FS 以接受来自 Tableau Cloud 或 TCM的登录请求的步骤中所述，用户的 Tableau Cloud 或 TCM 用户名必须与 AD 中存储的用户名匹配。
- 在[步骤 3：在您的 IdP 中配置“Tableau Cloud 应用程序”](#idp)中，您在 AD FS 中添加了一个声明规则，以在 AD FS 和 Tableau Cloud 之间匹配名字、姓氏和用户名属性。或者，您可以使用使用步骤 **“3.地图属性**”（在 Tableau Cloud 中）来执行相同的操作。

<!-- document id=6811df86bab85d4de81e00c86b26ca087ebc562d1b6dc39c18fde3883c75e929 url=/tableau/next/zh-cn/online/qs_refresh_local_data.md -->

[跳转到主要内容](#main-content)

# 使用 Bridge 使数据保持最新

对于 Tableau Cloud 无法直接访问的数据源或虚拟连接数据，您可以使用 Tableau Bridge 来使数据保持最新。例如，当数据源连接到防火墙后托管的数据时，请使用 Bridge。

**注意：**如果数据源连接到云中托管的基础数据，并可通过公共互联网访问，则连接会直接从 Tableau Cloud 中运行。

## 什么是 Bridge

Tableau Bridge 客户端是一种在网络中的计算机上运行的客户端软件。客户端与 Tableau Cloud 结合使用，可以使连接到私有网络数据（Tableau Cloud 无法直接访问）的数据源保持最新。私有网络数据包括本地数据和虚拟网络云数据。

## Tableau Bridge 的工作方式

Tableau Bridge 的功能类似于私有网络数据（例如 Excel 文件和 SQL Server 数据）和 Tableau Cloud 之间的管道。客户端通过出站加密连接与 Tableau Cloud 通信，以便在防火墙后面的数据与 Tableau Cloud 站点之间实现连通性。

![显示防火墙后面的数据与 Tableau Cloud 之间的连接](/tableau/next/zh-cn/online/zh-cn/Img/bridge_basic_overview_cloud2_sz.png)

有关 Bridge 如何与 Tableau Cloud 通信的详细信息，请参见[Tableau Bridge 安全性](https://help.tableau.com/current/online/zh-cn/to_bridge_security.htm)。

## 谁可以使用它

尽管 Tableau Cloud 的任何授权用户都可以使用 Bridge，但 Bridge 已针对在组织中执行以下功能的用户进行了优化：站点管理员和数据源所有者。

**站点管理员**，或在 Tableau Cloud 上具有“站点管理员”或“站点管理员 Creator”角色的用户负责安装和管理 Bridge 客户端。有关详细信息，请参见[计划 Bridge 部署](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm)。

**内容所有者**，或在 Tableau Cloud 上具有“Creator”或“Explorer（可发布）”角色的用户通常负责发布和管理其自己的内容。内容所有者使用 Bridge 来促进 Tableau Cloud 和私有网络数据之间的实时连接和数据提取连接。

- 对于**实时连接**，在数据源或虚拟连接发布过程中会自动检测 Bridge。通过池化启用对实时连接的支持。
    
    **有关数据源的更多信息：**用户可以在发布过程中看到通过实时连接发布数据源的选项。当只有从网络内部才能访问的关系数据库或云数据库支持实时连接时，此选项可用。
    
    用户发布数据源后，池中的可用客户端便于实时查询。就是这样。
    
    首先，用户将数据源发布到 Tableau Cloud，并选择该选项来维护实时连接。或者，发布工作簿，然后指定实时连接。有关发布数据源的详细信息，请参见[发布包含实时连接的 Bridge 数据源](https://help.tableau.com/current/online/zh-cn/to_bridge_livequery.htm)。
    
    **注意**：如果发布连接到私有云数据库的数据源，请按照[发布基于云的私有数据源](https://help.tableau.com/current/online/zh-cn/to_bridge_vpc.htm)中所述的步骤进行操作，以确保使用 Bridge 来促进数据新鲜度任务。
- 对于**数据提取连接**，用户可以为数据源或虚拟连接设置刷新计划。有关详细信息，请参见[设置 Bridge 刷新计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm)。
    
    **注意**：如果发布连接到私有云数据库的数据源，请按照[为基于云的私有数据源设置计划](https://help.tableau.com/current/online/zh-cn/to_bridge_vpc.htm)中所述的步骤进行操作，以使用 Bridge 来促进刷新计划。

<!-- document id=b1d95b95a56fece4a8c68e0299c6a93c3b23b73d42cff9b044c836ecdaa9de04 url=/tableau/next/zh-cn/online/cmt-command_line.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Content Migration Tool 命令行界面

Tableau Content Migration Tool 包括一个命令行界面 `tabcmt.cmd`（位于安装文件夹中）。默认安装文件夹为 `%PROGRAMFILES%\Tableau\Tableau Content Migration Tool`（32 位 Windows）或 `%PROGRAMFILES(x86)%\Tableau\Tableau Content Migration Tool`（64 位 Windows）。

**注意：**`tabcmt.cmd` 实用工具与 Content Migration Tool 控制台运行程序 `tabcmt-runner.exe` 不同。控制台运行程序是一种用于从命令行中运行迁移的单独命令行实用工具。有关运行 Content Migration Tool 控制台运行程序的信息，请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。

下面是可用于 `tabcmt` 命令行的命令：

- [migrate](#migrate)
- [help](#help)
- [update](#update)
- [version](#version)

## migrate

打开迁移计划文件到 GUI 中的迁移步骤：

tabcmt migrate <plan file>

## help

显示有关命令行界面和可用命令的一般帮助。

### 示例

显示所有可用命令：

tabcmt help

显示特定命令的帮助和用法信息：

tabcmt help <command>

## license

2022 年 7 月已弃用。

此命令仅适用于旧版许可证。管理当前用户的应用程序许可证。

### 示例

显示当前许可证信息：

tabcmt license

移除/停用当前许可证：

edt license remove

设置/激活系列密钥或脱机许可证密钥：

tabcmt license <key>

使用许可证文件设置/激活：

tabcmt license <file path> \[--passphrase=<password>\]

## update

管理用于应用程序更新的选项。

### 示例

显示当前更新设置：

tabcmt update

启用或禁用自动更新通知：

tabcmt update --disabled=<true|false>

设置从中检测/下载更新的 URL：

tabcmt update --url=<url>

启用或禁用显示测试版更新。设置为 false 以仅显示稳定版更新。

tabcmt update --beta=<true|false>

## version

显示当前应用程序版本信息。

tabcmt version

## 谁可以执行此操作

为了使用命令行界面，您必须具有以下所有各项：

- Content Migration Tool 计算机上的管理员权限。
- 具有 Explorer 角色或更高级别角色的 Tableau 站点用户帐户。
- 源站点上的“查看和下载工作簿”/“保存副本”权限。
- 目标站点的“发布”权限。

<!-- document id=cbfbbcc19dbda31378d29d35cdf676db139f4154c52d29f5c8203a8918fdeae4 url=/tableau/next/zh-cn/online/data_connect_publish.md -->

[跳转到主要内容](#main-content)

# 使用 Data Connect 进行发布

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 是由站点管理员管理的产品。但它可以为 Tableau Cloud Site 上的所有用户提供查询服务。发布内容的 Creator 在使用 Data Connect 连接到私有网络数据时需要记住一些事项。这些事项概述如下。Explorer 和 Viewer（查看者）将使用 Data Connect，但基本上不知道它是否正在使用。

## 数据库连接

Data Connect 部署了提供数据库查询服务的 Bridge 客户端。Data Connect 中使用的 Bridge 客户端是适用于容器的 Linux 版 Tableau Bridge 的单独部署。因此，Data Connect 支持适用于容器的 Linux 版 Tableau Bridge 支持的所有数据库连接器和数据库身份验证模式。有关详细信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)。

Data Connect 支持实时数据源和数据提取数据源。

Data Connect 仅支持为 Linux 构建的数据库驱动程序。驱动程序必须包含在站点管理员在 Data Connect 设置期间配置的基础映像中。

## 使用 Data Connect 查询私人数据

需要使用 Data Connect 连接私有网络数据的 Creator [遵循的流程与用 Tableau Desktop 连接数据并发布到 Tableau Cloud 的流程相同](https://help.tableau.com/current/pro/desktop/zh-cn/basicconnectoverview.htm)。使用 Data Connect 保持数据最新还需要两个额外步骤：

- 设置 Data Connect 时，站点管理员会创建池。池定义将使用 Data Connect 的数据库域。对该数据库域的查询被发送到 Data Connect Bridge 客户端。
- （仅限已发布的数据源）将每个数据源发布到 Tableau Cloud 后，数据源所有者必须对每个数据源执行一项额外操作才能使用 Data Connect。

发布数据源后，您可以轮换该数据源的凭据并更新连接信息的其他方面。请参见[更新 Bridge 连接信息](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm)。

- **使用嵌入式数据源**：Data Connect 支持查询嵌入式数据源。使用已发布数据源来扩展集中式数据源有很多优点。有关详细信息，请参见[使用嵌入式数据源](https://help.tableau.com/current/online/zh-cn/to_bridge_eds.htm)。
- **设置刷新计划**：Data Connect 允许您定期计划数据提取数据的刷新。请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。
- **管理电子邮件通知**：如果站点管理员已启用，您将收到有关您拥有的所有数据源刷新失败情况的电子邮件通知。当通过 Data Connect 管理数据源刷新时，您接收的通知的类型、接收通知的时间以及您可以配置的通知将与 Tableau Cloud 通知不同。请参见[针对 Bridge 管理电子邮件通知](https://help.tableau.com/current/online/zh-cn/to_bridge_eds.htm)。

## 解决单个查询的错误

单个作业由 Data Connect Bridge 客户端处理。若要确定根本原因，所需的故障排除步骤将取决于用户场景。

站点管理员可以访问有关 Data Connect 提供的所有刷新作业的数据。有关访问此数据的详细信息，请参见[监控 Data Connect 查询运行状况](https://help.tableau.com/v0.0/online/zh-cn/data_connect_admin.htm#Monitori)。

“在线管理见解”作业性能数据源对于识别问题是普遍发生在同一个数据库还是发生在同一个 Data Connect 代理上特别有用。

如果节点运行状态不佳，Bridge 客户端及其执行的查询可能会失败。若要排除节点运行状况故障，请参见[服务初始化和运行状况故障排除](https://help.tableau.com/v0.0/online/zh-cn/data_connect_admin.htm#Troubles)。

### 实时查询错误

当用户打开配置为使用 Data Connect 的实时数据源的仪表板时，会出现实时查询错误。这些错误表明数据库连接存在问题。有关常见故障排除步骤，请参见[确定实时查询问题的原因](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm#livequery)。

### 数据提取刷新失败

如果数据提取刷新不成功，数据源所有者将收到电子邮件通知。这些电子邮件通知将包含可支持解决问题的错误消息。有关数据源所有者如何排查其作业问题的详细信息，请参见[确定已计划刷新问题的原因](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm#refresh)。

<!-- document id=d22cee10e88441ff5df7eea2a9060b44bed70ca3829202385fdc8030d2dc4b40 url=/tableau/next/zh-cn/online/saml_config_azure_ad.md -->

[跳转到主要内容](#main-content)

# 使用 Microsoft Entra ID 配置 SAML

如果已将 Microsoft Entra ID（也称为 Microsoft Azure Active Directory (Azure AD)）配置为您的 SAML 身份提供程序 (IdP)，请使用本主题中的信息以及 Microsoft Entra 文档将 Tableau Cloud 或 Tableau Cloud Manager (TCM) 添加到您的单点登录应用程序。

**注意：** 

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在您的 IdP 帐户中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 IdP 的文档。
- 自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 先决条件

您的环境必须具有以下各项，然后才能使用 Entra ID 配置 Tableau 和 SAML：

- [满足先决条件](https://learn.microsoft.com/en-us/entra/identity/saas-apps/tableauonline-tutorial#prerequisites)，如“教程：Microsoft Entra SSO 与 Tableau Cloud 的集成”文档中所述

- [创建 Microsoft Entra 测试用户](https://learn.microsoft.com/en-us/entra/identity/saas-apps/tableauonline-tutorial#create-a-microsoft-entra-test-user)，如“教程：Microsoft Entra SSO 与 Tableau Cloud 的集成”文档中所述

## 步骤 1：开始

在 Tableau Cloud 中，执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

在 Entra 中，执行以下操作：

**注意：**对于 TCM，您可以使用 IdP 中的“Tableau Cloud 应用程序”来配置 TCM 身份验证。

1. 至少以云应用程序管理员身份登录 [Microsoft Entra 管理中心](https://entra.microsoft.com/)。
2. 导航至“Enterprise applications”）企业应用程序\>“New application”（新应用程序）。
3. 在 “Browse Microsoft Entra Gallery”（浏览 Microsoft Entra 库）页面中，在搜索框中输入“Tableau Cloud”。
4. 在搜索结果中选择“Tableau Cloud”，在右侧面板中根据需要更改应用程序实例的默认名称，然后单击“Create”（创建）。  
    **注意：** 
    
    - 添加 Tableau Cloud 应用程序实例可能需要一些时间。
    - 通过库创建 Tableau Cloud 应用程序实例时，SAML 是唯一支持与 Tableau 集成的配置类型。
5. 在左侧窗格中，导航到“Single sign-on”（单点登录）。
6. 在“Select a single sign-on method”（选择单点登录方法）页面上，选择“SAML”。
7. 在“Set up Single Sign-On with SAML”“使用 SAML 设置单点登录”页面上“Basic SAML Configuration”（基本 SAML 配置）的旁边， 单击“Edit”（编辑），然后执行以下操作：
    
    1. 在 “Identifier (Entity ID)”（标识符（实体 Id））文本框中，输入以下占位符 URL，您将在步骤 3 中再次编辑该 URL：:`https://sso.online.tableau.com/public/sp/metadata?alias=<entityid>`
    2. 在“Reply URL”（回复 URL）文本框中，输入您将在步骤 3 中再次编辑的以下占位符 URL： `https://sso.online.tableau.com/public/sp/`
    3. 选择“保存”。
8. 接下来，在“SAML Signing Certificate”（SAML 签名证书）的旁边，单击“Edit”（编辑）。
9. 单击“Download”（下载）以下载联合元数据 XML。
10. 最后，在“Attributes & Claims”（属性与声明）旁边，选择“Edit”（编辑）为下面的步骤 2.2 做准备。

## 步骤 2：在 Tableau Cloud 或 TCM 中配置 SAML

按照上一部分所述，保存来自 Entra 的 SAML 元数据文件后，完成以下过程。

**对于 Tableau Cloud**

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 Entra 保存的 SAML 元数据文件。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 在“3.地图属性”下，从 Entra 的“Attributes & Claims”（属性与声明）部分复制相应的属性名称（断言）：
    
    1. 对于“用户名”字段，输入您的组织使用的正确断言值。例如，您的组织可能会使用 `nameID`、`mail`、`userprincipalName`、`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`、URL 或其他断言值。
    2. 对于其余的可选字段，复制 URL 声明名称。
3. 在“4.选择嵌入视图的默认设置(可选)”下，选择您要在用户访问嵌入式 Tableau 内容时启用的体验。
4. 选择“保存并继续”按钮。
5. 转到“5.获取 Tableau Cloud 元数据”为下面的步骤 3.1 做准备。

**对于 TCM**

1. 返回 TCM，在“身份验证”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 Entra 保存的 SAML 元数据文件。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 在“3.地图属性”下，从 Entra 的“Attributes & Claims”（属性与声明）部分复制相应的属性名称（断言）：
    
    1. 对于“用户名”字段，输入您的组织使用的正确断言值。例如，您的组织可能会使用 `nameID`、`mail`、`userprincipalName`、`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`、URL 或其他断言值。
    2. 对于其余的可选字段，复制 URL 声明名称。
3. 选择“保存并继续”按钮。
4. 转到“4.获取 Tableau Cloud 元数据”为下面的步骤 3.1 做准备。

## 步骤 3：在您的 IdP 中配置“Tableau Cloud 应用程序”

1. 返回 Entra，在“Set up Single Sign-On with SAML”（使用 SAML 设置单点登录）页面上的“Basic SAML Configuration”（基本 SAML 配置）旁边，单击“Edit”（编辑），然后执行以下操作：
    
    1. 对于“Identifier (Entity ID)”（标识符（实体 Id），执行以下操作之一：
        
        - 在 Tableau Cloud 的“5.获取 Tableau Cloud 元数据”下，复制“Tableau Cloud 实体 ID”URL。
        - 在 TCM 的“4.获取 Tableau Cloud 元数据”下，复制“Tableau Cloud 实体 ID”URL。
    2. 对于“Reply URL”（回复 URL），执行以下操作之一：
        
        - 在 Tableau Cloud 的“5.获取 Tableau Cloud 元数据”下，复制“Tableau Cloud ACS URL”。
        - 在 TCM 的“4.获取 Tableau Cloud 元数据”下，复制“Tableau Cloud ACS URL”。
    3. 选择“保存”。

## 步骤 4：测试 SAML 配置

在 Entra 中，执行以下操作：

- 分配 [Microsoft Entra 测试用户](https://learn.microsoft.com/en-us/entra/identity/saas-apps/tableauonline-tutorial#assign-the-microsoft-entra-test-user)，如“教程：Microsoft Entra SSO 与 Tableau Cloud 的集成”文档中所述。

在 Tableau Cloud 或 TCM 中，执行以下操作：

1. 将该 Entra 用户添加到 Tableau Cloud 或 TCM 以测试 SAML 配置。
    
    - 若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
    - 若要在 TCM 中添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。
2. 执行以下操作_之一_：
    
    - 在 Tableau Cloud 中“新配置”页面上的“7.测试配置”下，单击“测试配置”按钮。
    - 在 TCM 中“身份验证”页面的“6.测试配置”下，单击“测试配置”按钮。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

## Microsoft Entra ID 支持 SAML 的其他注意事项

- 为了避免启用 SP 发起的单点注销 (SLO)，请确保上载到 Tableau Cloud 或 TCM SAML 设置的 IdP 元数据不包含 SLO 端点。或者，在您上载到 Tableau Cloud 或 TCM SAML 设置的 IdP 元数据中，您可以将现有的“SingleLogoutService”值替换为“https://sso.online.tableau.com/public/idp/SSO”。
- 如果您的应用程序使用 IdP 发起的 SSO，请不要在 Entra 中的库中提供 Tableau Cloud 或 TCM 应用程序中的“登录 URL”值。为此字段提供一个值将绕过 IdP 发起的 SSO。
- 如果您为 Tableau Cloud 站点配置[将自定义域与 Tableau Cloud 配合使用](https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm)，则必须更新 IDP 应用程序设置中的 Tableau Cloud 实体 ID 和 ACS URL 以反映自定义域。举例来说，如果您的自定义域是 `analytics.example.com`，请更新这些 URL 以使用该域，而不是默认的 Tableau Cloud URL。
    
    例如，更新 Entra ID 的**“标识符”**（实体 ID）和**“回复 URL”**(ACS URL)。

<!-- document id=929a8e487cc244fdaa743700d8508752fbd85084bef6a8f45d6bd8ecc3f2c4e7 url=/tableau/next/zh-cn/online/scim_config_azure_ad.md -->

[跳转到主要内容](#main-content)

# 使用 Microsoft Entra ID 配置 SCIM

您可以通过 Microsoft Entra ID（也称为 Azure Active Directory (AD)）配置用户管理、预置组以及分配 Tableau Cloud 站点角色。

当您完成以下步骤时，准备好 Entra ID 文档会有所帮助。请参见教程[为 Tableau Cloud 配置自动用户预配](https://docs.microsoft.com/zh-cn/azure/active-directory/saas-apps/tableau-online-provisioning-tutorial)。

**注意：**

- 如果您已经为您的应用程序启用了预置并且想要更新以使用 Tableau SCIM 2.0 端点，请参见 Microsoft 文章[更新 Tableau Cloud 应用程序](https://docs.microsoft.com/zh-cn/azure/active-directory/saas-apps/tableau-online-provisioning-tutorial#update-a-tableau-cloud-application-to-use-the-tableau-cloud-scim-20-endpoint)。如果您正在为 Tableau Cloud 应用程序的新实例设置预置，请按照以下步骤操作。

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在 IdP 帐户中看到的屏幕不匹配，您可以使用常规的[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)主题以及 IdP 的文档。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：执行先决条件

SCIM 功能要求您将站点配置为支持 SAML、OIDC 或 Google 单点登录 (SSO)。

1. 如果使用 SAML 身份验证，请完成[使用 Microsoft Entra ID 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_azure_ad.htm)中的“将 Tableau Cloud 添加到 Microsoft Entra ID 应用程序”部分。
2. 如果使用 OIDC 身份验证，请完成[针对 OpenID Connect 配置 Tableau Cloud 或 TCM](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm)。
3. 通过 Azure Marketplace 添加 Tableau Cloud 后，保持已登录 Entra 门户和 Tableau Cloud 的状态，并显示以下页面：
    
    - 在 Tableau Cloud 中，显示“设置”\>“身份验证”页面。
    - 在 Entra 门户中，显示 Tableau Cloud 应用程序 >“Provisioning”（预置）页面。

## 步骤 2：启用 SCIM 支持

使用以下步骤通过 Microsoft Entra ID 启用 SCIM 支持。另请参见下面的 [Azure Active Directory SCIM 支持的注意事项和分区限制](#azure-ad-support-notes)部分。

**注意：**对于 Entra 门户中的步骤，请确保您使用库中的 Tableau Cloud 应用程序。

### 在 Tableau Cloud 中

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 执行以下操作：
    
    1. 在“身份验证”页面的“跨域身份管理系统 (SCIM)”下，单击**“新配置”**按钮。
    2. 在“新的 SCIM 配置”对话框中，执行以下操作：
        
        1. 为 SCIM 配置输入一个名称。
        2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
        3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 身份验证配置。
        4. 单击**“保存”**。
            
            **注意：**这将填充“SCIM 令牌”部分。
            
            ![新的 SCIM 配置](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_new.png)
    3. 在“SCIM 令牌”下，执行以下操作：
        
        1. 单击“新建密文”按钮。
        2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_newsecret_newsecret.png)
        3. 复制密文，并将其存储在安全位置。
            
            **重要信息：**
            
            - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
            - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_secret.png)
        4. 单击**“关闭”**。

### 在 Microsoft Entra 中

1. 在 Entra 门户中的“Provisioning”（预置）页面上，执行以下操作：
    
    - 对于“Provisioning Mode”（预置模式），选择“Automatic”（自动）。
    - 对于“Authentication Method”（身份验证方法），选择“Bearer Authentication”（Bearer 身份验证）。
    - 对于“Tenant URL”（租户 URL），复制并粘贴 Tableau Cloud SCIM 设置中显示的基本 URL。
    - 对于“Secret Token”（密文令牌），复制并粘贴生成的 Tableau Cloud SCIM 密文。
    
    ![带有用于预置 Tableau Cloud 的设置的配置屏幕。](/tableau/next/zh-cn/online/zh-cn/Img/scim-azure-ad-configure-provisioning.png)
2. 单击“Test Connection”（测试连接）以验证凭据是否按预期工作，然后单击“Save”（保存）。
3. 在“Mappings”（映射）部分，验证是否启用了“Provision Microsoft Entra ID Groups”（预置 Microsoft Entra ID 组）和“Provision Microsoft Entra ID Users”（预置 Microsoft Entra ID 用户）。
    
    ![设置页面，用于定义数据在 Microsoft Entra ID 和 Tableau Cloud SCIM 之间流动的方式。](/tableau/next/zh-cn/online/zh-cn/Img/scim-azure-ad-mappings.png)
4. 选择“Provision Microsoft Entra ID Groups”（预置 Microsoft Entra ID 组） ，然后在“Attribute Mappings”（属性映射）页面上，查看从 Entra ID 同步到 Tableau Cloud 的属性。若要保存任何更改，请单击“Save”（保存）。
    
    ![Tableau Cloud SCIM 属性映射到 Microsoft Entra ID 属性。](/tableau/next/zh-cn/online/zh-cn/Img/scim-azure-ad-groups.png)
5. 选择“Provision Microsoft Entra ID Users”（预置 Microsoft Entra ID 用户） ，然后在“Attribute Mapping”（属性映射）页面上，查看从 Entra ID 同步到 Tableau Cloud 的属性。若要保存任何更改，请单击“Save”（保存）。
    
    ![显示定义同步的属性映射的表。](/tableau/next/zh-cn/online/zh-cn/Img/scim-azure-ad-users.png)

## 步骤 3：将组分配给 Tableau Cloud 应用程序

使用以下步骤将组分配给 Microsoft Entra ID 中的 Tableau Cloud 图库应用程序。

1. 从应用程序页面中，选择“Enterprise Apps”（企业应用）\>“Users and groups”（用户和组）。
2. 单击“Add user/group”（添加用户/组）。
3. 在“Add Assignment”（添加分配）页面上，选择一个组并分配以下站点角色之一：
    
    - _Creator_
    - _SiteAdministratorCreator_
    - _Explorer_
    - _SiteAdministratorExplorer_
    - _ExplorerCanPublish_
    - _Viewer_
    - _Unlicensed_
    
    **注意：**如果您选择的角色不在上述列表中，您将收到错误。有关站点角色的详细信息，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。
4. 单击“Assign”（分配）。

### 为站点角色创建组

一个用户可以是 Entra ID 中多个组的成员，但他们只会获得 Tableau Cloud 中权限最高的站点角色。举例来说，如果用户是具有站点角色 Viewer（查看者）和 Creator 的两个组的成员，则 Tableau 将分配 Creator 站点角色。

若要跟踪角色分配，我们建议在 Entra ID 中创建特定于角色的组，例如_“Tableau - Creator”_、_“Tableau - Explorer”_等。然后您可以使用这些组为 Tableau Cloud 中的正确角色快速预置新用户。

下面按权限从最高到最低的顺序列出了站点角色：

- 站点管理员 Creator
- 站点管理员 Explorer
- Creator
- Explorer（可发布）
- Explorer
- Viewer（查看者）

**注意：**用户及其属性应通过 Entra ID 进行管理。在 Tableau Cloud 内直接进行的更改可能导致意外行为和覆盖值。

## 步骤 4：预置组

在您启用 SCIM 支持并将组分配给 Entra ID 中的 Tableau Cloud 应用程序后，下一步是将用户预置到您的 Tableau 站点。

1. 在“Provisioning”（预置）页面上，展开“Settings”（设置）部分，然后在“Scope”（范围）中定义您要预置到 Tableau Cloud 的组。
    
    ![设置菜单用于选择接收故障电子邮件通知并建立同步用户和组的参数。](/tableau/next/zh-cn/online/zh-cn/Img/scim-azure-ad-enable.png)
    
    **注意：**Tableau Cloud 不支持 Entra ID 设置“同步所有用户和组”。
2. 将“Provisioning Status”（预置状态）切换为“On”（打开）。
3. 单击“Save”（保存）。

保存操作将启动“Scope”（范围）中定义的组的初始同步。只要 Entra ID 预置服务运行，就会大约每 40 分钟进行一次同步。若要在计划之外手动预置用户，请选择“Provision on demand”（按需预置）。有关按需预置的详细信息，请参见 Microsoft 文章 [Microsoft Entra ID 中的按需预配](https://docs.microsoft.com/zh-cn/azure/active-directory/app-provisioning/provision-on-demand)。

预置完成后，您应该会在 Tableau Cloud 中的“站点用户”页面上看到来自 Entra ID 的组。

### 在 Tableau Cloud 中更改用户身份验证

默认情况下，将为预置的用户分配与 SCIM 关联的身份验证类型。若要更改用户的身份验证类型，请使用以下步骤。

1. 在 Tableau Cloud 中，选择“用户”。
2. 在“站点用户”页面上，选中要向其分配身份验证类型的用户旁边的复选框。
3. 在“操作”菜单上，选择“身份验证”。
4. 在“身份验证”对话框中，选择用户的首选身份验证类型。

有关 Tableau Cloud 中的不同身份验证类型的详细信息，请参见[身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)。

## Azure Active Directory SCIM 支持的注意事项

- 您必须为要使用 SCIM 管理的每个站点添加单独的 Tableau Cloud 应用。
- 在 Azure AD 的 Tableau Cloud 应用程序中取消预置用户时，或者如果从 Azure AD 中完全删除用户，该用户将转换为 Tableau Cloud 中的未许可站点角色。如果用户拥有任何内容，您必须首先重新分配这些内容资产的所有权，然后才能手动删除在 Tableau Cloud 中的用户。
- 从 2024 年 2 月 (Tableau 2023.3) 开始，支持使用 SCIM 和[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)(GLSI)。GLSI 要求如下：
    
    1.手动启用组选项，并为 Tableau Cloud 中_直接_为该组成员的用户选择最低站点角色。无法在 Azure AD 中设置具有 GLSI 属性的组，但您可以在 Tableau Cloud 中为从 Azure AD 预置的组设置属性。  
    2.必须从 IdP 将用户预置为_未许可_。

<!-- document id=dd70e12b5540129edd43ea5e7e60c9d73300f6ba6eeb8bc5feb24f9a243c4d5b url=/tableau/next/zh-cn/online/connected_apps_eas.md -->

[跳转到主要内容](#main-content)

# 使用 OAuth 2.0 信任配置已连接应用

作为 Tableau Cloud 站点管理员，您可以使用 OAuth 2.0 标准协议注册一个或多个外部授权服务器 (EAS) 以在 Tableau Cloud 站点和 EAS 之间建立信任关系。

**重要信息：**

- 本主题中的某些过程需要使用第三方软件和服务进行配置。我们已尽最大努力验证用于在 Tableau Cloud 上启用 EAS 功能的过程。但是，第三方软件和服务可能会发生变化，或者您的组织可能会有所不同。如果遇到问题，请参考第三方文档以获得权威的配置详细信息和支持。
- 为了使会话令牌有效，外部应用程序和托管外部应用程序的服务器的时钟必须设置为协调世界时 (UTC)。如果任何一个时钟使用不同的标准，连接的应用软件将不被信任。

## Tableau 已连接应用如何与 OAuth 2.0 信任配合使用

Tableau Cloud 站点和外部应用程序之间的信任关系通过 JSON Web Token (JWT) 标准中的身份验证令牌建立和验证。

在外部应用程序中加载嵌入的 Tableau 内容时，将使用授权代码流程 OAuth 流程。用户成功登录到其 IdP 后，将会自动登录到 Tableau Cloud。按照下面描述的步骤将您的 EAS 注册到 Tableau Cloud 站点。

### 已连接应用的关键组件

已连接应用的以下组件与外部应用程序中的 JWT 一起工作，以验证用户身份并显示嵌入的内容。

- **外部授权服务器 (EAS)：**该服务器（通常是您的 IdP）充当用户和外部应用程序之间的接口。服务器对用户进行身份验证并授权其访问受保护的 Tableau 内容。
- **颁发者 URL：**唯一标识 EAS 实例的 URL。

### 已连接应用工作流程

#### 嵌入工作流

下图说明了外部授权服务器 (EAS)、外部应用程序（Web 服务器及网页）和 Tableau 已连接应用之间的身份验证工作方式。

![](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_how_EAS.png)

1. **用户访问网页：**当用户访问网页上的嵌入内容时，网页会向外部应用程序发送 GET 请求。
2. **外部应用程序将请求重定向到 EAS：**外部应用程序通过重定向到外部授权服务器 (EAS)的网页进行响应。
3. **用户使用 EAS 进行身份验证：**用户使用 EAS 进行身份验证和授权。
4. **EAS 使用授权代码响应网页：** EAS 使用授权码响应页面并重定向回网页。
5. **EAS 将授权代码转换为 JWT：**网页调用 EAS 将授权代码转换为 JWT，网页将 JWT 放入嵌入式内容的 URL 中。
6. **网页向 Tableau 请求内容：**网页加载 iFrame 并向 Tableau 发送 GET 请求。
7. **Tableau 验证令牌：**Tableau 使用签名验证 URL 中的 JWT，使用内容进行响应，并尊从 JWT 中定义的嵌入范围。

## 创建已连接应用

### 步骤 1：开始之前

若要将 EAS 注册到您的 Tableau Cloud 站点，您必须已配置 EAS。此外，EAS 必须发送包含下表中列出的已注册声明和标头的有效 JSON Web 令牌 (JWT)。

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">声明</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">名称</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">描述或必需值</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>kid</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">键 ID</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">“<code>iss</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">颁发者</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">必需（在标题中或作为声明）。标识受信任的已连接应用及其签名密钥的唯一颁发者 URI（在 HTTPS 中）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>alg</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">算法</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">必需（在标题中）。JWT 签名算法。javadoc.io 文档的 <a href="https://www.javadoc.io/doc/com.nimbusds/nimbus-jose-jwt/2.21/com/nimbusds/jose/JWSAlgorithm.html" target="_blank">Class JWSAlgorithm</a> 页面中列出了支持算法名称。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>sub</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">使用者</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">经过身份验证的 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 用户的用户名（电子邮件地址）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>aud</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">受众</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>值必须是：“<code>tableau</code><code>:&lt;site_luid&gt;</code>”</p><div><p>若要获得站点 LUID，您可以使用 Tableau REST API 的<a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#sign_in">登录</a>方法或按照下面的步骤复制站点 ID。<b>注意：</b>在复制站点 ID 之前，您必须使用<a href="#step2">此处</a>描述的过程注册一个 EAS。<br></p><ol><li value="1">选择<span class="uicontrol">“设置”</span>&gt;<span class="uicontrol">“已连接应用”</span>，然后选择<span class="uicontrol">“外部授权服务器”</span>已连接应用。</li><li value="2"><p>单击<span class="uicontrol">“复制站点 ID”</span>按钮。</p><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/connectedapp_eas_button_luid.png" alt="外部授权服务器的详细信息，带有复制站点 ID 的按钮。"></p></li></ol></div></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>exp</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">到期时间</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>有效的 JWT 不得过期。JWT 的过期时间 (UTC) 必须在最长有效期（即 10 分钟）内。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>jti</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT ID 声明为 JWT 提供唯一标识符，并且区分大小写。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>scp</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">范围</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>对于<i>嵌入工作流</i>，支持的值包括：</p><p>“<code>tableau:views:embed</code>”<br>“<code>tableau:views:embed_authoring</code>”<br>“<code>tableau:metrics:embed</code>”（于 2023 年 10 月已停用 (Tableau 2023.3)）<br>“<code>tableau:ask_data:embed</code>”（于 2024 年 2 月已停用 (Tableau 2024.1)）</p><p><b>注意：</b></p><ul><li>值必须作为列表类型传递。</li><li>对于 <code>tableau:views:embed</code>，范围遵循已在 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 中配置的用户权限，并允许用户与嵌入视图中的工具进行交互（如果在原始视图中可用）。</li><li>我们建议嵌入代码排除工具栏参数。有关详细信息，请参见下面的<a href="#known_issues" class="xref">已知问题（仅限嵌入工作流）</a>。</li></ul><p>对于 <i>REST API 授权工作流</i>，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm#scopes" class="xref">支持 JWT 授权的 REST API 方法</a>。</p><p>对于<i>使用 REST API 进行身份验证的元数据 API 工作流</i>，唯一支持的范围是 <code>tableau:content:read</code>。</p><p>对于<i>使用 REST API 进行身份验证的 VizQL Data Service 工作流</i>，唯一支持的范围是 <code>tableau:viz_data_service:read</code>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>https://tableau.com/oda</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">按需访问 - 声明（启用功能）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须是“<code>true</code>”，并且必须指定一个或多个 Tableau Cloud 组（请参见下一行）。有关详细信息，包括诸如“嵌入分析”或“基于容量的 Viewer（查看者）块”许可证之类的先决条件，请参见 Tableau Embedding API v3 帮助中的<a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">自定义和控制数据访问</a>页面。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2"><code>https://tableau.com/groups</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">按需访问 - 声明（指定组名称）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须与 Tableau Cloud 中的一个或多个组的名称匹配。有关详细信息，包括诸如“嵌入分析”或“基于容量的 Viewer（查看者）块”许可证之类的先决条件，请参见 Tableau Embedding API v3 帮助中的<a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">自定义和控制数据访问</a>页面。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">动态组成员身份</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须与 Tableau Cloud 中的一个或多个组的名称匹配。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#assertions" class="xref">使用断言的动态组成员身份</a>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（用户属性）</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（用户属性值）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>仅适用于<i>嵌入工作流</i>。</p><p> 您可以在 JWT 中包含用户属性。然后，当在嵌入内容中使用用户属性函数时，Tableau 会检查经过身份验证的用户的上下文并确定哪些数据可以在运行时显示。</p><p><b>注意：</b></p><ul><li><p>查看 <a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#known-issues" target="_blank">Tableau Embedding API v3</a> 帮助以了解可能影响您的工作流程的<i>已知问题</i>和<i>限制</i>。</p></li><li>为了使用户属性起作用，1) 您必须启用<span class="uicontrol">“在身份验证工作流程中控制用户访问”</span>设置，并且 2) 内容作者必须创建一个<a href="https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm#user_attributes" target="_blank">用户属性函数</a>。</li><li>用户属性区分大小写。</li></ul></td></tr></tbody></table>

**注意：**上述 JWT 声明记录在 Internet 工程任务组 (IETF) 组织分发的文档中的[注册声明名称](https://datatracker.ietf.org/doc/html/rfc7519#section-4.1)部分。

### 步骤 2：向 Tableau Cloud 注册您的 EAS

通过向 Tableau Cloud 注册您的 EAS，您可以在 EAS 和 您的Tableau Cloud站点之间建立信任关系。这意味着当用户访问嵌入在您的外部应用程序中的 Tableau 内容时，他们将被重定向以使用 IdP 进行身份验证。EAS 生成身份验证令牌，该令牌会传递给 Tableau Cloud 进行验证。在验证信任关系后，授予用户对嵌入内容的访问权限。

**注意：**某些 EAS 支持显示同意对话框的选项，该对话框要求用户批准应用程序访问 Tableau 内容。为确保您的用户获得最佳体验，我们建议您将 EAS 配置为代表用户自动同意外部应用程序的请求。

1. 以站点管理员身份登录 Tableau Cloud。
2. 从左侧窗格中，选择“设置”\>“已连接应用”。
3. 单击“新建已连接应用”按钮下拉箭头，并选择“OAuth 2.0 信任”。
4. 在“创建已连接应用”对话框中，执行以下操作：  
    1. 在“名称”文本框中，输入已连接应用的名称。
    2. 在“颁发者 URL”文本框中，粘贴 EAS 的颁发者 URL。
    3. 选择“启用已连接应用”。出于安全考虑，已连接应用在创建时默认设置为禁用。
    4. 完成后，单击“创建”按钮。
    ![用于创建已连接应用的表单，其中包含名称、URL 和用于启用应用的复选框。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_create_eas.png)
5. 创建已连接应用后，复制已连接应用的站点 ID。站点 ID 用于上面步骤 1 中描述的 JWT 的“aud”（受众）声明。
    
    ![外部授权服务器的详细信息，带有复制站点 ID 的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_eas_button_luid.png)

### 步骤 3：后续步骤

#### 对于嵌入工作流

将您的Tableau Cloud站点配置为使用您的 EAS 后，您必须将嵌入代码添加到您的外部应用程序。确保在外部应用程序调用的 Web 组件中包含 EAS 生成的有效 JWT，如步骤 1 中所述。

有关嵌入 Tableau 内容的详细信息，请参见以下主题：

- 使用 [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/zh-cn/index.html) 嵌入 Tableau 内容。
- 有关基于属性的访问控制 (ABAC)、按需访问和动态组成员身份的用户属性，请参见 Tableau Embedding API v3 中的[自定义和控制数据访问](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html)。
- 嵌入指标，请参见 Tableau 帮助中的[将指标嵌入网页](https://help.tableau.com/current/pro/desktop/zh-cn/embed_metrics.htm)主题。（在 2023 年 10 月版 (Tableau 2023.3) 中，Tableau 停用了嵌入指标的功能。）

**注意：**为了让用户在访问嵌入式内容时成功进行身份验证，浏览器必须配置为允许第三方 Cookie。

##### 使用嵌入域白名单控制内容的嵌入位置

从 2023 年 6 月（Tableau 2023.2） 开始，您和您的用户可以使用 Tableau REST API 中的“更新站点嵌入设置”方法来控制是否可以不受限制地嵌入 Tableau 内容或限制为某些域。

默认情况下，`unrestrictedEmbedding` 站点嵌入设置设为 `true` 以允许不受限制的嵌入。或者，您和您的用户可以将廖设置设为 `false`，并使用 `allowList` 参数指定可以嵌入外部应用程序中的 Tableau 内容的域。

有关详细信息，请参阅以下一项或两项：

- Tableau REST API 帮助中的[更新站点的嵌入设置](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#update_embedding_settings_for_site)
- Tableau 嵌入 API v3 帮助中 [Tableau 站点的嵌入设置](https://help.tableau.com/current/api/embedding_api/en-us/docs/embedding_api_site.html#about-tableau-site-settings-for-embedding)。

#### 对于 REST API 授权工作流

配置 JWT 后，您必须将有效的 JWT 添加到 REST API 登录请求以进行授权访问。有关详细信息，请参见[已连接应用的访问范围](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm)。

#### 对于元数据 API 工作流

配置 JWT 后，您必须将有效的 JWT 添加到 REST API 登录请求。有关详细信息，请参见[已连接应用的访问范围](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm)。

#### 对于 SCIM 工作流的外部令牌

配置 JWT 后，您必须配置 SAML 身份验证并启用 SCIM 功能。有关详细信息，请参见[使用 OAuth 2.0 信任配置已连接应用](#scim)。

### 已知问题（仅限嵌入工作流）

使用已连接应用时存在一些已知问题，这些问题将在未来版本中解决。

- **工具栏功能：**当嵌入式内容定义了工具栏参数时，并非所有工具栏功能都可以使用。为了解决此问题，我们建议您像下面的示例一样隐藏工具栏参数。
    
    <tableau-viz id='tab-viz' src='https://online.tableau.com/t/<your\_site>/...'
    	toolbar='hidden'>
    </tableau-viz>

- **已发布数据源：**将不会显示设置为提示用户提供数据库凭据的已发布数据源。为了解决此问题，如果可能，我们建议数据源所有者改为嵌入他们的数据库凭据。

### 疑难解答

当嵌入内容无法在您的外部应用程序中显示或 Tableau REST API 授权失败时，您可以使用浏览器的开发人员工具来检查和识别可能与您的Tableau Cloud站点上启用的 EAS 功能相关联的错误代码。

请参阅下表以查看错误代码和潜在解决方案的描述。

<table style="width: 90%;margin-left: 0;margin-right: auto;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"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">错误代码</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">摘要</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">描述</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">潜在的解决方案或解释</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SYSTEM_USER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到 Tableau 用户</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 JWT 中的“<code>sub</code>”（使用者）声明值是否为经过身份验证的 Tableau Cloud 用户的用户名（电子邮件地址）。此值区分大小写。<br></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">LOGIN_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">登录失败</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">此错误通常是由 JWT 中的以下声明问题之一引起的：<ul><li>“<code>exp</code>”（过期时间）超过了默认的最长有效期。若要解决此问题，请查看有效 JWT 所需的<a href="https://help.tableau.com/current/online/zh-cn/connected_apps_eas.htm#jwt" target="_blank">已注册声明</a>并确保正确的值不超过 10 分钟。</li><li>“<code>sub</code>”（使用者）正在调用未知用户。若要解决此问题，请验证“<code>sub</code>”值是否为经过身份验证的 Tableau Cloud 用户的用户名（电子邮件地址）。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">67</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">FEATURE_NOT_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅可通过获得许可的 Tableau Cloud 站点进行按需访问。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">142</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EXTERNAL_AUTHORIZATION_SERVER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到 EAS</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">143</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EXTERNAL_AUTHORIZATION_SERVER_LIMIT_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">超过 EAS 限制</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">该站点已达到注册外部授权服务器 (EAS) 的最大允许数量 (1)。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">144</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">INVALID_ISSUER_URL</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">无效的颁发者 URL</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">颁发者 URL 无效或 JWT 中缺少“<code>iss</code>”（颁发者）属性。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">149</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EAS_INVALID_JWKS_URI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少 JWKS URI</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">IdP 元数据中不存在 JWKS URI，或者 Tableau 中未配置 JWKS URI。为了解决此问题，请配置有效的 JWKS URI。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">150</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EAS_RETRIEVE_JWK_SOURCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">检索密钥源失败</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证是否正确配置了 JWKS URI。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">151</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EAS_RETRIEVE_METADATA_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">从 issuerUrl 检索元数据失败</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证是否正确配置了 JWKS URI。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10081</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_RETRIEVE_IDP_METADATA</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少 EAS 元数据端点</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 EAS 是否配置正确并且调用了正确的颁发者。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10082</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AUTHORIZATION_SERVER_ISSUER_NOT_SPECIFIED</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">10083</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BAD_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 标头包含问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 标头中缺少“<code>kid</code>”（密文 IDd）或“<code>clientId</code>”（颁发者）声明。若要解决此问题，请确保包含此信息。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10084</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_PARSE_ERROR</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 包含问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证以下各项：<ul><li>JWT 中引用的“<code>aud</code>”（受众群体）值是否使用“tableau”值。此值区分大小写。</li><li>JWT 中包含“<code>aud</code>”（受众群体）和“<code>sub</code>”（使用者）。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10085</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_FETCH_JWT_KEYS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 找不到密钥</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">找不到密文。<p>若要解决此问题，请验证是否调用了正确的颁发者。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10087</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BLOCKLISTED_JWS_ALGORITHM_USED_TO_SIGN</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 签名算法存在问题</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">10088</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">RSA_KEY_SIZE_INVALID</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 签名要求存在问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请使用 EAS 或 IdP 验证 JWT 是否使用大小为 2048 的 RSA 密钥进行签名。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10091</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_ALREADY_USED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">需要唯一的 JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 已在身份验证过程中使用。若要解决此问题，EAS 或 IdP 必须生成新的 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10092</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">NOT_IN_DOMAIN_ALLOW_LIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">未指定嵌入内容的域</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请确保 <code>unrestrictedEmbedding</code> 设置设为 <code>true</code> 或者 <code>domainAllowlist</code> 参数包括使用 Tableau REST API 中的<a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#embedding_settings_for_site" target="_blank">更新站点嵌入设置</a>方法嵌入 Tableau 内容的域。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10094</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MISSING_REQUIRED_JTI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少 JWT ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 JWT 中包含“<code>jti</code>”（JWT ID）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10095</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EXTERNAL_AUTHZ_SERVER_DISABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EAS 已禁用</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">注册到站点的 EAS 已连接应用已禁用。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10096</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">“<code>exp</code>”（过期时间）超过了默认的最长有效期。若要解决此问题，请查看有效 JWT 所需的<a href="https://help.tableau.com/current/online/zh-cn/connected_apps_eas.htm#jwt" target="_blank">已注册声明</a>并确保正确的值不超过 10 分钟。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10097</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MALFORMED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">范围声明的问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">当“<code>scp</code>”（范围）声明在 JWT 中缺失或未作为列表类型传递时，可能会发生此错误。若要解决此问题，请验证“<code>scp</code>”包含在 JWT 中并作为列表类型传递。有关 JWT 的故障排除帮助，请参见 auth0 站点上的<a href="https://jwt.io/" target="_blank">调试器</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10098</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_UNSIGNED_OR_ENCRYPTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 未签名或已加密</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Tableau 不支持未签名或已加密的 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10099</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MISSING_IN_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少范围声明</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 缺少所需的“<code>scp</code>”（范围）声明。若要解决此问题，请验证 JWT 中是否包含“<code>scp</code>”。有关 JWT 的故障排除帮助，请参见 auth0 站点上的<a href="https://jwt.io/" target="_blank">调试器</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10100</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_PERSISTENCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">意外的 JWT ID 错误</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">存在意外的“<code>jti</code>”（JWT ID）错误。若要解决此问题，必须生成带有新的“<code>jti</code>”的新 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10101</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EPHEMERAL_USER_LOGIN_FAILED_SITE_NOT_UBP_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">该站点未获得启用按需访问所需的基于嵌入式分析使用情况的模型。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#embedded-analytics" class="xref">了解许可证模式</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10102</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EPHEMERAL_USER_NOT_SUPPORTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">启用 iframe-auth 属性时不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">启用 iframe-auth 属性时可能会出现此错误。为了解决此问题，请验证是否正在使用 Tableau Embedding API 版本 3.6 或更高版本。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10103</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_MAX_SIZE_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 超出最大大小</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">当 JWT 大小超过 8000 字节时，可能会发生此错误。为了解决此问题，请确保仅将必要的声明传递给 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">10113</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">EPHEMERAL_USER_LOGIN_FAILED_SITE_NOT_ENTITLED_FOR_ODA_ACCESS</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">此站点未使用基于嵌入式分析使用情况的模型获得许可；或基于容量的 Viewer（查看者）块未随 Cloud+ 或 Tableau+ 版本启用，这是按需访问所必需的。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#UsageBased" class="xref">基于使用情况的许可证模式</a>或<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#capacity" class="xref">基于容量的许可证模式</a>。</td></tr></tbody></table>

<!-- document id=961df45f82da1f7e7967d2d03a8875c66e25254b59b4c4eee9fae760eb356ea9 url=/tableau/next/zh-cn/online/saml_config_okta.md -->

[跳转到主要内容](#main-content)

# 使用 Okta 配置 SAML

如果使用 Okta 作为 SAML 身份提供程序 (IdP)，您可以使用本主题中的信息来为 Tableau Cloud 或 Tableau Cloud Manager (TCM) 设置 SAML 身份验证。您还可以使用 Okta 文档中的[如何为 Tableau Cloud 配置 SAML 2.0](https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Tableau-Online.html)主题。

Tableau Cloud 与 Okta 的 SAML 集成支持服务提供商 (SP) 发起的 SSO、身份提供程序 (IdP) 发起的 SSO 和单点注销 (SLO)。

**注意：** 

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在您的 IdP 帐户中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 IdP 的文档。
- 自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：开始

在 Tableau Cloud 中，执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

在 Okta 管理员控制台中，执行以下操作： 

**注意：**对于 TCM，您可以使用 IdP 中的“Tableau Cloud 应用程序”来配置 TCM 身份验证。

1. 打开一个新浏览器选项卡或窗口并登录到 Okta 管理员控制台。
2. 从左侧窗格中，选择“Application”（应用程序）\>“Applications”（应用程序），然后单击“Browse App Catalog”（浏览应用程序目录）按钮。
3. 搜索并单击“Tableau Cloud”，然后单击“Add Integration”（添加集成）按钮。这将打开“General Settings”（常规设置）选项卡。
4. （可选）如果有多个 Tableau Cloud 站点，请在“Application label”（应用程序标签）字段中编辑站点名称，帮助您区分 Tableau Cloud 应用程序实例。
5. 导航至“登录”选项卡，单击“编辑”，然后执行以下操作：
    
    1. 在“Metadata details”（元数据详细信息）下，复制元数据 URL。
    2. 将 URL 粘贴到新浏览器中，并使用默认的“metadata.xml”将结果保存为文件。

## 步骤 2：在 Tableau Cloud 或 TCM 中配置 SAML

按照上一部分所述，保存来自 Okta 的 SAML 元数据文件后，完成以下过程。

**对于 Tableau Cloud**

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 Okta 保存的 SAML 元数据文件。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 将“3.地图属性”下的属性名称（断言）映射到 Okta 管理员控制台的“Tableau Cloud 用户配置文件映射”页面中的相应属性名称（断言）。
3. 在“4.选择嵌入视图的默认设置(可选)”下，选择您要在用户访问嵌入内容时启用的体验。有关详细信息，请参见下面的[关于启用 iFrame 嵌入](#enable-iframe-embedding)部分。
4. 单击“保存并继续”按钮。

**对于 TCM**

1. 返回 TCM，在“身份验证”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 Okta 保存的 SAML 元数据文件。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 将“3.地图属性”下的属性名称（断言）映射到 Okta 管理员控制台的“Tableau Cloud 用户配置文件映射”页面中的相应属性名称（断言）。
3. 单击“保存并继续”按钮。

## 步骤 3.在您的 IdP 中配置“Tableau Cloud 应用程序”

对于 Tableau Cloud，本节中的程序将使用“5.获取 Tableau Cloud 元数据”（位于 Tableau Cloud 中“新配置”页面上的“方法 2：复制元数据并下载证书”）中的信息。对于 TCM，本节中的程序将使用“4.获取 Tableau Cloud 元数据”（位于 TCM 中“身份验证”页面上的“方法 2：复制元数据并下载证书”）中的信息。

**注意：**对于 TCM，您可以使用 IdP 中的“Tableau Cloud 应用程序”来配置 TCM 身份验证。

1. 在 Okta 管理员控制台中，单击“Assignments”（分配）选项卡以添加您的用户或组。
2. 完成后，单击“Done”（完成）。
3. 单击“Sign On”（登录）选项卡，然后在“Settings”（设置）部分中单击“Edit”（编辑） 。
4. （可选）如果您想要启用单点注销 (SLO)，请执行以下操作：
    
    1. 选中“Enable Single Logout”（启用单点注销）复选框。
    2. 从 Tableau Cloud 元数据文件中复制“Single Logout URL”（单点注销 URL）值。例如， <md:SingleLogoutService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://xxxx/public/sp/SLO/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"/>。有关详细信息，请参见 Tableau 知识库中的[使用 SAML 与 Okta，配置单点注销](https://kb.tableau.com/articles/howto/configure-single-logout-using-saml-with-okta?lang=zh-cn)。
    3. 在“Advanced Sign-on Settings”（高级登录设置）文本框中，输入您在步骤 b 中复制的值。
    4. 在“Signature Certificate”（签名证书）旁，单击“Browse”（浏览）按钮并导航到您在上一节下载的证书文件。
    5. 选择文件并单击“Upload”（上传）按钮。
    6. 完成后，单击“Save”（保存）。
5. 选择“Applications”（应用程序）\>“Application”（应用程序），单击“Tableau Cloud application”（Tableau Cloud 应用程序），选择“Sign On”（登录）选项卡，并执行以下操作：
    
    1. 单击“Edit”（编辑）。
    2. 在“Advanced Sign-on Settings”（高级登录设置）下，对于 Okta 管理员控制台中的“Tableau Cloud entity ID”（Tableau Cloud 实体 ID）文本框，粘贴来自 Tableau Cloud 或 TCM 的 Tableau Cloud 实体 ID 值。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_okta_entityID.png)
    3. 对于 Okta 管理员控制台中的“Tableau Cloud ACS URL”文本框，粘贴来自 Tableau Cloud 或 TCM的 Tableau Cloud ACS URL 值。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_okta_ACS.png)
    
    **注意**：Tableau Cloud 和 TCM SAML 配置设置以不同于 Okta 设置页面的顺序显示。为了防止 SAML 身份验证问题，请确保已在 Okta 中的正确字段中输入了“Tableau Cloud 实体 ID” 和“Tableau Cloud ACS URL”。
6. 完成后，单击“保存”。

## 步骤 4：测试 SAML 配置

在 Okta 中，执行以下操作：

- 将示例用户添加到 Okta 并将其分配给“Tableau Cloud 应用程序”

在 Tableau Cloud 或 TCM 中，执行以下操作：

1. 将该 Okta 用户添加到 Tableau Cloud 以测试 SAML 配置。
    
    - 若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
    - 若要在 TCM 中添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。
2. 执行以下操作之一：
    
    - 在 Tableau Cloud 中“新配置”页面上的“7.测试配置”下，单击“测试配置”按钮。
    - 在 TCM 中“身份验证”页面的“6.测试配置”下，单击“测试配置”按钮。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

**注意：**如果连接失败，请考虑将 Tableau 中的 `NameID` 属性保留原样。

## 步骤 5：将其他用户添加到启用 SAML 的 Tableau Cloud 站点 或 TCM

如果您计划使用 SCIM 从 Okta 预置用户，请勿手动将用户添加到 Tableau Cloud。有关详细信息，请参见[使用 Okta 配置 SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_okta.htm)。如果您不使用 SCIM，请使用以下步骤将附加用户添加到您的站点。**注意：**SCIM 预置不适用于 TCM。

本部分中描述的程序是在 Tableau Cloud 的“用户”页面上执行的。

1. 完成上述步骤后，从左侧窗格导航至“用户”页面。
2. 按照以下步骤操作：
    
    - 适用于 Tableau Cloud 的[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题
    - 适用于 TCM 的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题

## 关于启用 iFrame 嵌入

**注意：**仅适用于 Tableau Cloud。

在站点上启用 SAML 时，您需要指定用户如何登录来访问网页中嵌入的视图。这些步骤对 Okta 进行配置，以允许为嵌入可视化项使用嵌入式框架 (iFrame) 进行身份验证。嵌入式框架嵌入可以在登录以查看嵌入式可视化项时提供更加完美的用户体验。例如，如果用户已经向您的身份提供程序进行了身份验证，并且启用了 iFrame 嵌入，则当浏览到包含嵌入式可视化项的页面时，用户将无缝地向 Tableau Cloud 进行身份验证。

**警告：**IFrame 框架可能容易受到单击劫持攻击。_单击劫持_是一种针对网页的攻击，在这种攻击中，攻击者会试图在一个不相关页面上的透明层中显示攻击页面，从而诱骗用户单击或输入内容。在 Tableau Cloud 的上下文中，攻击者可能会试图使用单击劫持攻击来捕获用户凭据，或让授权用户更改设置。有关单击劫持攻击的详细信息，请参见开放式 Web 应用程序安全项目网站上的[单击劫持](https://www.owasp.org/index.php/Clickjacking)。

1. 登录到 Okta 管理员控制台。
2. 从左侧窗格中，选择“Customizations”（自定义项） > “Other”（其他），并导航到“IFrame Embedding”（IFrame 嵌入）部分。
3. 单击“Edit”（编辑） ，选中“Allow iFrame embedding”（允许 iFrame 嵌入）复选框，然后单击“Save”（保存） 。

<!-- document id=3174a6f61e4966bdba5f046d342d4b60beb6c1e788d638941039af440835baf3 url=/tableau/next/zh-cn/online/scim_config_okta.md -->

[跳转到主要内容](#main-content)

# 使用 Okta 配置 SCIM

您可以通过 Okta 配置用户管理、预置组以及分配 Tableau Cloud 站点角色。如果您还不熟悉 Tableau 站点角色和每个角色允许的能力，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。

注意：

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在 IdP 帐户中看到的屏幕不匹配，您可以使用常规的[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)主题以及 IdP 的文档。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：执行先决条件

SCIM 功能要求您将站点配置为支持 SAML、OIDC 或 Google 单点登录 (SSO)。

1. 如果使用 SAML 身份验证，请完成[使用 Okta 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_okta.htm)中的以下部分：
    
    - [步骤 1：开始](https://help.tableau.com/v0.0/online/zh-cn/saml_config_okta.htm#enable-saml-online-site)
    - [步骤 3.在您的 IdP 中配置“Tableau Cloud 应用程序”](https://help.tableau.com/v0.0/online/zh-cn/saml_config_okta.htm#add_cloud_to_okta)
2. 如果使用 OIDC 身份验证，请完成[针对 OpenID Connect 配置 Tableau Cloud 或 TCM](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm)。
3. 完成这两个部分中的步骤后，保持已登录 Okta 管理员控制台和 Tableau Cloud 的状态，并显示以下页面：
    
    - 在 Tableau Cloud 中，显示“设置”\>“身份验证”页面。
    - 在 Okta 管理员控制台中，显示“Applications”（应用程序）\>“Applications”（应用程序）\>“Tableau Cloud”\>“Provisioning”（预置）。

## 步骤 2：启用 SCIM 支持

使用以下步骤为 Okta 启用 SCIM 支持。另请参见下面的 [Okta SCIM 支持的注意事项](#okta-support-notes)部分。

### 在 Tableau Cloud 中

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 执行以下操作：
    
    1. 在“身份验证”页面的“跨域身份管理系统 (SCIM)”下，单击**“新配置”**按钮。
    2. 在“新的 SCIM 配置”对话框中，执行以下操作：
        
        1. 为 SCIM 配置输入一个名称。
        2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
        3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 身份验证配置。
        4. 单击**“保存”**。
            
            **注意：**这将填充“SCIM 令牌”部分。
            
            ![新的 SCIM 配置](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_new.png)
    3. 在“SCIM 令牌”下，执行以下操作：
        
        1. 单击“新建密文”按钮。
        2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_newsecret_newsecret.png)
        3. 复制密文，并将其存储在安全位置。
            
            **重要信息：**
            
            - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
            - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_secret.png)
        4. 单击**“关闭”**。

### 在 Okta 中

1. 在 Okta 管理员控制台中，执行以下操作：
    
    1. 从左窗格中，选择“Application”（应用程序）\>“Application”（应用程序），单击“Tableau Cloud”应用程序，然后单击“Provisioning”（预置）选项卡。
    2. 单击“Enable API Integration”（启用 API 集成）按钮。
    3. 选中“Enable API integration”（启用 API 集成）复选框并单击“Save”（保存）。
    4. 执行以下操作：
        
        1. 对于“API Token”（API 令牌），粘贴您在上一步骤中复制的 Tableau Cloud SCIM 密文令牌。
        2. 对于“Base URL”（基本 URL），复制并粘贴 Tableau Cloud SCIM 设置中显示的基本 URL。
2. 单击“Test API Credentials”（测试 API 凭据）按钮以确保配置正确完成。如果配置正确完成，您会看到“Tableau Cloud was verified successfully!”（Tableau Cloud 已成功验证！）消息。
3. 完成后，单击“Save”（保存）。

## 步骤 3：将组分配给 Tableau Cloud 应用程序

对于 Tableau 的用户预置，我们建议您分组管理用户，以便在 Tableau 中更轻松地管理。

在 Okta 中，将组分配给 Tableau Cloud 应用程序，以便可以将用户预置到 Tableau Cloud。更具体地说，您需要两个不同的组，一个组分配给“分配”选项卡，另一个组分配给“推送组”选项卡。“分配”选项卡中的组用于在 Tableau Cloud 中创建用户。“推送组”选项卡中的组用于在 Tableau Cloud 中创建组并管理组成员身份。

**注意：**

- Okta 要求您在“分配”选项卡中有一个组，并在“推送组”选项卡中有一个组，以防止出现竞争情况。有关详细信息，请参见 Okta 文档中的[应用程序分配和组推送](https://help.okta.com/en-us/content/topics/users-groups-profiles/app-assignments-group-push.htm)以及[关于组推送](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-about-group-push.htm)。

- 此过程中的步骤假设您已创建至少两个组。有关在 Okta 中创建组的详细信息，请参见 Okta 文档中的[创建组](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-groups-create.htm)。

您可以使用以下程序添加组并将该组分配给 Tableau Cloud 应用程序。

1. 从左窗格中，选择“Application”（应用程序）\>“Application”（应用程序），单击“Tableau Cloud”应用程序，然后单击“Assignmentsg”（分配）选项卡。
2. 单击“Assign”（分配）下拉列表，然后选择“Assign to Groups”（分配给组）。
3. 执行以下操作：
    
    1. 选择相关的组。
    2. 选择您希望向 Tableau 预置用户的站点角色。选项包括：
        
        - 未许可
        - Viewer（查看者）
        - Explorer
        - Explorer（可发布）
        - Creator
        - 站点管理员 Explorer
        - 站点管理员 Creator
4. 完成后，单击“Save and Go Back”（保存并返回）按钮。
5. 在“Push Group”（推送组）选项卡中重复步骤 1-4，然后单击“Done”（完成）按钮。

## 步骤 4：启用组预置

Okta 允许您将现有组及其成员资格推送至 Tableau Cloud。推送了一个组之后，您可以在 Okta 中管理组成员资格以自动更新 Tableau Cloud 中对应的组。在执行这些步骤之前，我们建议您查看 Okta 文档中的[组推送先决条件](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-group-push-prerequisites.htm)和[关于组推送](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-about-group-push.htm)。

**重要信息：**启用 SCIM 后，应通过 Okta 管理用户及其属性。在 Tableau Cloud 内直接进行的更改可能导致意外行为和覆盖值。

以下程序从您离开上一个部分的位置继续并且假设您已登录到 Okta 管理员控制台。

1. 从左侧窗格中，选择**“Application”（应用程序）**\>“Application”（应用程序），单击 Tableau Cloud 应用程序，然后单击“Push Groups”（推送组）选项卡。
2. 单击“Push Groups”（推送组）按钮，并从下拉菜单中则选择以下选项之一：

- 按名称查找组：选择此选项可按名称搜索组。
- 按规则查找组：选择此选项可创建一个搜索规则，该规则会推送与该规则匹配的任何组。

您可以通过单击“推送状态”列中的“活动”或“非活动”立即停用组推送、取消已推送组的链接或推送组成员资格。若要删除、停用或激活多个组，请单击“批量编辑”。有关详细信息，请参见 Okta 文档中的[启用组推送](https://help.okta.com/en/prod/Content/Topics/users-groups-profiles/usgp-enable-group-push.htm)。

5. （可选）如果推送多个组，请单击“Save & Add Another”（保存并添加另一个）按钮，然后重复上一步。
6. 完成后，单击“保存”。

## SCIM 和登录时授予许可证

从 2024 年 2 月 (Tableau 2023.3) 开始，您可以将 SCIM 与 Okta 的[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)结合使用。

将 SCIM 与 Okta 的 GLSI 结合使用需要以下内容：

1. 在 Okta 中，将用户添加到 Tableau Cloud 应用程序的“分配”和“推送组”选项卡中的组中。
2. 在 Tableau Cloud 中，为组启用 GLSI 选项，并为作为组成员的用户选择最低站点角色。
    
    **注意：**无法在 Okta 中设置具有 GLSI 属性的组。
3. 在 Okta 中，用户将被预置成“Unlicensed”（未许可）。

### 启用 GLSI

若要设置和启用 GLSI，请参见[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)。

### 使用 GLSI 移除 SCIM 用户

尝试在 Okta 中停用 SCIM 用户之前，您必须先将 SCIM 用户从 Okta 中启用 GLSI 的组中移除。停用用户会将用户设置为 Tableau Cloud 中的“未许可”角色。但是，用户无法在 Tableau Cloud 中获得“未许可”角色，直至他们不再是任何启用 GLSI 的组的成员。

1. 在 Okta 中，首先从分配给“Push Group”（推送组）选项卡的启用 GLSI 的组中移除用户。
2. 仍在 Okta 中时，通过从分配给“Assignments”（分配）选项卡的启用 GLSI 的组中移除用户或在 Okta 中删除用户来取消预置用户。执行此操作后，用户将在 Tableau Cloud 中转换为“未许可”。在 Okta 中取消预置用户只会导致用户在 Tableau Cloud 中转换为“未许可”，而不会删除该用户。
    
    **注意：** 
    
    - 如果您想在 Okta 中删除用户，请参见 Okta 文档中的[停用和删除用户帐户](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-deactivate-user-account.htm)。
    - 如果要删除 Tableau Cloud 中的 SCIM 用户（请参见下面的[删除 SCIM 用户](#delete_scim_users)），请从 Tableau Cloud 中手动删除该用户。

如果您遇到问题，请参见[通过 SCIM 尝试取消预置用户时出现错误“用户角色未更新为：未许可（errorCode=10079）”](https://help.salesforce.com/s/articleView?id=002186630&type=1)知识文章。

#### 关于 Tableau Cloud 的“所有用户”组

如果您已使用 GLSI 启用了默认的“所有用户”组，则无法在 Okta 中取消预置用户，因此无法为 Tableau Cloud 中属于启用了 GLSI 的组的任何用户获取“未许可”角色。若要移除启用 GLSI 的“所有用户”组中的 SCIM 用户，您必须从 Tableau Cloud 中手动删除这些用户。

**注意：**如果用户拥有与其关联的内容，则您需要先将内容所有权重新分配给其他用户，然后才能删除这些用户。

### 删除 SCIM 用户

在 Okta 中删除 SCIM 用户只会将他们转换为“未许可”角色，而不会在 Tableau Cloud 中删除他们。如果要删除用户，则必须在 Tableau Cloud 中手动删除用户。

有关删除用户的详细信息，请参见[查看、管理或移除用户](https://help.tableau.com/v0.0/online/zh-cn/users_view.htm)主题中的“从站点中移除用户”。

## Okta SCIM 支持的注意事项

- 在 Okta 用户分配设置中，“用户名”和“主要电子邮件”必须相同。
- 您必须为要使用 SCIM 管理的每个站点添加单独的 Tableau Cloud Okta 应用。
- 如果要迁移站点，您将需要为新站点重新配置 SCIM 配置。
- 在预置新用户时，Okta 中的名字和姓氏属性与 Tableau Cloud 不同步。新用户在首次登录 Tableau Cloud 时必须设置这些字段。
- 当从 Okta 中的 Tableau Cloud 应用程序取消预置用户或从 Okta 中完全停用或删除用户时，该用户将转换为 Tableau Cloud 中的“未许可”站点角色。如果用户拥有任何内容，您必须首先重新分配这些内容资产的所有权，然后才能手动删除在 Tableau Cloud 中的用户。
- 可以在 Okta 中的用户或组级别设置用户的站点角色（例如 Creator、Explorer 或 Viewer（查看者））。建议在组级别分配站点角色。如果为用户直接分配了站点角色，它将覆盖任何组设置。
- 用户可以是多个组的成员。组可以有不同的站点角色。如果为用户分配了具有不同站点角色的组，则用户将在 Tableau Cloud 中获得权限最高的站点角色。举例来说，如果选择 Viewer（查看者）和 Creator，Tableau 将分配 Creator 站点角色。
    
    下面按权限从最高到最低的顺序列出了站点角色：
    
    - 站点管理员 Creator
    - 站点管理员 Explorer
    - Creator
    - Explorer（可发布）
    - Explorer
    - Viewer（查看者）
- 您可以在 Okta 中更新用户的站点角色属性，并且此更改将传播到 Tableau Cloud。无法更新其他属性（例如用户名和主电子邮件）。若要更改这些属性，请移除该用户，更改属性，然后再次添加用户。
- 从 2024 年 2 月 (Tableau 2023.3) 开始，支持使用 SCIM 和[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)(GLSI)。有关详细信息，请参见上面的[SCIM 和登录时授予许可证](#glsi)。

<!-- document id=12449cde29471b7c803f35516e86496944120a09dee0403865d726ce1509726f url=/tableau/next/zh-cn/online/saml_config_onelogin.md -->

[跳转到主要内容](#main-content)

# 使用 OneLogin 配置 SAML

如果使用 OneLogin 作为 SAML 身份提供程序 (IdP)，您可以使用本主题中的信息来为 Tableau Cloud 或 Tableau Cloud Manager (TCM) 设置 SAML 身份验证。

这些步骤假设您具有修改组织的 OneLogin 门户的权限，并且您熟悉读取 XML 并将值传递到属性中的操作。

**注意：** 

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在您的 IdP 帐户中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 IdP 的文档。
- 自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：开始

在 Tableau Cloud 中，执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

在 OneLogin 中，执行以下操作：

1. 打开一个新浏览标签页或窗口，登录到 OneLogin 管理员门户，然后执行以下操作：
2. 在“应用程序”页面上，选择“添加应用”。搜索“Tableau”，并在结果中选择“Tableau Cloud SSO”。在此区域中配置 SAML 连接。
    
    **注意：**适用于 OneLogin 的 Tableau Cloud SSO 选项不适用于 Tableau Server。
3. 在**“Info”（信息）**页面上，设置您的门户首选项。如果有多个 Tableau Cloud 站点，请在“Display Name”（显示名称）字段中包括站点名称，帮助用户了解要选择哪个站点。
4. 在“SSO”页面上，选择并复制 “SLO Endpoint (HTTP)”（SLO 端点(HTTP)）字段中显示的 URI。
    
    **注意：**尽管标签指明 HTTP，但提供的 URI 是 **https** 地址，因为 SLO（单点注销）端点使用 SSL/TLS 加密。
5. 在同一页面上，选择“More Actions”（更多操作）\>“SAML Metadata”（SAML 元数据），并将 OneLogin 元数据文件保存到您的计算机。

## 步骤 2：在 Tableau Cloud 或 TCM 中配置 SAML

按照上一部分所述下载来自 OneLogin 的 SAML 元数据文件后，完成以下步骤。

**对于 Tableau Cloud**

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 OneLogin 下载的 SAML 元数据文件。
    
    **重要信息：**如果您在上载 OneLogin 元数据文件时遇到任何问题，请考虑对 OneLogin 使用非默认证书。若要创建新证书，请从 Onelogin 管理员门户中选择“Security”（安全）\>“Certificates”（证书）。如果您创建新证书，请确保 OneLogin 中的 Tableau Cloud 应用程序使用此新证书。
2. 继续执行“3.地图属性”并按如下方式设置值：
    
    1. 对于“用户名”，输入电子邮件。这是用户用于登录 Tableau Cloud 的电子邮件地址。
    2. 对于“电子邮件地址”，根据 IdP 的文档输入可选属性值。如果与用户名不同，此属性是用户应接收通知的电子邮件地址。电子邮件地址属性仅用于通知目的，不用于登录。
    3. 对于“显示名称”，选择“名”和“姓”单选按钮。
        
        1. 对于“名”，输入 FirstName。
        2. 对于“姓”，输入 LastName。
    
    ![SAML 配置页面的屏幕截图 -- 步骤 3.地图属性](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site_match_assertions.png)
3. 在“4.选择嵌入视图的默认设置(可选)”下，选择您要在用户访问嵌入内容时启用的体验。有关详细信息，请参见下面的[关于启用 iFrame 嵌入](#enable-iframe-embedding)部分。
4. 单击“保存并继续”按钮。

**对于 TCM**

1. 返回 TCM，在“身份验证”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 OneLogin 下载的 SAML 元数据文件。
    
    **重要信息：**如果您在上载 OneLogin 元数据文件时遇到任何问题，请考虑对 OneLogin 使用非默认证书。若要创建新证书，请从 Onelogin 管理员门户中选择“Security”（安全）\>“Certificates”（证书）。如果您创建新证书，请确保 OneLogin 中的 TCM 应用程序使用此新证书。
2. 继续执行“3.地图属性”并按如下方式设置值：
    
    1. 对于“用户名”，输入电子邮件。这是用户用于登录 TCM 的电子邮件地址。  
        
        **注意：**对于 TCM，不会出现上面显示的“电子邮件地址”字段。
    2. 对于“电子邮件地址”，根据 IdP 的文档输入可选属性值。如果与用户名不同，此属性是用户应接收通知的电子邮件地址。电子邮件地址属性仅用于通知目的，不用于登录。
    3. 对于“显示名称”，选择“名”和“姓”单选按钮。
        
        1. 对于“名”，输入 FirstName。
        2. 对于“姓”，输入 LastName。
    
    ![SAML 配置页面的屏幕截图 -- 步骤 3.地图属性](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site_match_assertions.png)
3. 单击“保存并继续”按钮。

## 步骤 3.在您的 IdP 中配置“Tableau Cloud 应用程序”

对于 Tableau Cloud，本节中的程序将使用“5.获取 Tableau Cloud 元数据”（位于 Tableau Cloud 中“新配置”页面上的“方法 2：复制元数据并下载证书”）中的信息。

对于 TCM，本节中的程序将使用“4.获取 Tableau Cloud 元数据”（位于 TCM 中“身份验证”页面上的“方法 2：复制元数据并下载证书”）中的信息。

1. 返回 OneLogin 门户，在 Tableau Cloud 或 TCM 应用程序的**“Configuration”（配置）**页面上，执行以下操作：
    
    1. 对于 OneLogin 门户中的“Consumer URL”（使用者 URL），粘贴 Tableau Cloud 或 TCM 中的“Tableau Cloud ACS URL”值。
    2. 对于 OneLogin 门户中的“Audience”（受众），粘贴 Tableau Cloud 或 TCM 中的“Tableau Cloud 实体 ID”值。
    
    ![Tableau Cloud SAML 的“新配置”页面 --“步骤 5.从 Tableau Cloud 中导出元数据”的屏幕截图](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_onelogin2.png)
2. 导航到“SSO”页面，为“SAML Signature Algorithm”（SAML 签名算法）选择“SHA-256”。
3. 导航到“Parameters”（参数），并确保显示的值如下所示：
    
    | Tableau Cloud 或 TCM 字段 | 值 |
    | --- | --- |
    | 用户名 | Email |
    | 名 | 名 |
    | 姓 | 姓 |

## 步骤 4：测试 SAML 配置

在 OneLogin 中，执行以下操作：

- 将示例用户添加到 OneLogin 并将其分配给“Tableau Cloud 应用程序”。

在 Tableau Cloud 或 TCM 中，执行以下操作：

1. 将该 OneLogin 用户添加到 Tableau 以测试 SAML 配置。
    
    - 若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
    - 若要在 TCM 中添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。
2. 执行以下操作_之一_：
    
    - 在 Tableau Cloud 中“新配置”页面上的“7.测试配置”下，单击“测试配置”按钮。
    - 在 TCM 中“身份验证”页面的“6.测试配置”下，单击“测试配置”按钮。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

## 步骤 5：将其他用户添加到启用 SAML 的 Tableau Cloud 站点 或 TCM

使用下面的步骤将其他用户添加到您的站点。本部分中描述的程序是在 Tableau Cloud 或 TCM 的“用户”页面上执行的。

1. 完成上述步骤后，从左侧窗格导航至“用户”页面。
2. 按照以下步骤操作：
    
    - 适用于 Tableau Cloud 的[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题
    - 适用于 TCM 的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题

## 关于启用 iFrame 嵌入

**注意：**仅适用于 Tableau Cloud。

在站点上启用 SAML 时，您需要指定用户如何登录来访问网页中嵌入的视图。这些步骤对 Okta 进行配置，以允许为嵌入可视化项使用嵌入式框架 (iFrame) 进行身份验证。嵌入式框架嵌入可以在登录以查看嵌入式可视化项时提供更加完美的用户体验。例如，如果用户已经向您的身份提供程序进行了身份验证，并且启用了 iFrame 嵌入，则当浏览到包含嵌入式可视化项的页面时，用户将无缝地向 Tableau Cloud 进行身份验证。

**警告：**嵌入式框架可能容易受到单击劫持攻击。_单击劫持_是一种针对网页的攻击，在这种攻击中，攻击者会试图在一个不相关页面上的透明层中显示攻击页面，从而诱骗用户单击或输入内容。在 Tableau Cloud 的上下文中，攻击者可能会试图使用单击劫持攻击来捕获用户凭据，或让授权用户更改设置。有关单击劫持攻击的详细信息，请参见开放式 Web 应用程序安全项目网站上的[单击劫持](https://www.owasp.org/index.php/Clickjacking)。

1. 打开一个新浏览器标签页或窗口，并登录到 OneLogin 管理员门户。
2. 在“Settings”（设置）菜单上，单击“Account Settings”（帐户设置）。
3. 在“Basic”（基本）页面上的**“Framing Protection”（框架保护）**中，选中“Disable Framing Protection (X-Frame-Options)”（禁用框架保护 (X-Frame-Options)）复选框。

<!-- document id=58aef420f771a716646ac1e2718ef03261398076e70261e52edcda45d1ca1285 url=/tableau/next/zh-cn/online/scim_config_onelogin.md -->

[跳转到主要内容](#main-content)

# 使用 OneLogin 配置 SCIM

您可以通过 OneLogin 配置用户管理、预置组以及分配 Tableau Cloud 站点角色。如果您还不熟悉 Tableau 站点角色和每个角色允许的能力，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。

在您完成这些步骤时，它还使您能够随时浏览 OneLogin 文档。从 OneLogin 文档中的[用户预置简介](https://onelogin.service-now.com/support?id=kb_article&sys_id=92999903db109700d5505eea4b961934 "在单独的浏览器标签页中打开 OneLogin 用户配置帮助。")开始。

**注意：**

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在 IdP 帐户中看到的屏幕不匹配，您可以使用常规的[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)主题以及 IdP 的文档。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：执行先决条件

SCIM 功能要求您将站点配置为支持 SAML、OIDC 或 Google 单点登录 (SSO)。

1. 如果使用 SAML 身份验证，请完成[使用 OneLogin 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_onelogin.htm)中的以下部分：
    
    - [步骤 1：开始](https://help.tableau.com/v0.0/online/zh-cn/saml_config_onelogin.htm#tol-get-metadata)
    - [使用 OneLogin 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_onelogin.htm#add-connector-onelogin)
2. 如果使用 OIDC 身份验证，请完成[针对 OpenID Connect 配置 Tableau Cloud 或 TCM](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm)。
3. 完成这两个部分中的步骤后，保持已登录 OneLogin 门户和 Tableau Cloud 的状态，并显示以下页面：
    
    - 在 Tableau Cloud 中，显示“设置”\>“身份验证”页面。
    - 在 OneLogin 门户中，打开“Configuration”（配置）页面。

## 步骤 2：启用 SCIM 支持

使用以下步骤为 OneLogin 启用 SCIM 支持。另请参见下面的 [OneLogin SCIM 支持的注意事项和限制](#onelogin-support-notes)部分。

**注意：**请记住在进行配置更改后单击 OneLogin 门户右上角的“Save”（保存）。

### 在 Tableau Cloud 中

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 执行以下操作：
    
    1. 在“身份验证”页面的“跨域身份管理系统 (SCIM)”下，单击**“新配置”**按钮。
    2. 在“新的 SCIM 配置”对话框中，执行以下操作：
        
        1. 为 SCIM 配置输入一个名称。
        2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
        3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 身份验证配置。
        4. 单击**“保存”**。
            
            **注意：**这将填充“SCIM 令牌”部分。
            
            ![新的 SCIM 配置](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_new.png)
    3. 在“SCIM 令牌”下，执行以下操作：
        
        1. 单击“新建密文”按钮。
        2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_newsecret_newsecret.png)
        3. 复制密文，并将其存储在安全位置。
            
            **重要信息：**
            
            - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
            - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。
            
            ![](/tableau/next/zh-cn/online/zh-cn/Img/scim_config_secret.png)
        4. 单击**“关闭”**。

### 在 OneLogin 中

1. 在 OneLogin 门户中的“Configuration”（配置）页面上，执行以下操作：
    
    - 对于“API Status”（API 状态），单击“Enable”（启用）。
    - 对于“SCIM Bearer Token”（SCIM Bearer 令牌），粘贴您之前复制的 Tableau Cloud SCIM 密文令牌。
    - 对于“SCIM Base URL”（SCIM 基本 URL），复制并粘贴 Tableau Cloud SCIM 设置中显示的基本 URL。
        
        ![OneLogin 门户的“配置”页面的图像](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-portal-configure.png)
2. 在“Provisioning”（预置）页面上，执行以下操作：
    
    - 选择“Enable provisioning”（启用预置）。
    - 为“When users are deleted in OneLogin, or the user's app access is removed, perform the below action”（在 OneLogin 中删除用户或移除用户的应用访问权限时，执行以下操作）选择“Suspend”（暂停）。
        
        ![OneLogin 门户的“预置”页面（针对 Tableau Cloud 设置）的图像](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-portal-provisioning.png)
3. 单击“Save”（保存）。
4. （可选）在“Parameters”（参数）页面上，将“SCIM Username”（SCIM 用户名）映射到“Email”（电子邮件）属性。如果您未将 SCIM 用户名映射到电子邮件地址格式的属性，则必须在预置过程中为每个用户手动填充此字段。
    
    如果映射值不包含用户电子邮件地址，则预置用户时会显示错误。

如果要完成预置用户和组的步骤，请保持登录到 OneLogin 门户，并继续执行下一部分。

## 步骤 3：预置用户和组

OneLogin 为您提供了多种方式，您可以通过这些方式来分配诸如组或站点角色等用户属性。您可以在 Tableau Cloud 应用级别应用这些属性、创建映射规则或将它们手动应用于单个用户。

在开始之前，请务必注意 OneLogin 的组概念与 Tableau 的组概念的操作方式不同。在 OneLogin 中，组充当安全边界，将特定的安全策略应用于用户。因此，用户一次只能属于一个组。

此外，OneLogin 使用角色作为不同用户群组可以访问的应用程序的容器。为用户分配角色后，您将授予他们对该角色中包含的所有应用程序的访问权限。这类似于 Tableau 的组概念。用户在 OneLogin 中可以有多个角色，可以映射到一个目标应用组，例如 Tableau Cloud。

**注意：**以下步骤假设您已登录 OneLogin 门户和 Tableau Cloud 应用软件。这些步骤提供一些特定于 Tableau 的信息，您可以将这些信息与 OneLogin 文档结合使用，将组和站点角色映射属性到用户。

### 配置用户

使用以下步骤，通过 OneLogin 门户将单个用户预置到 Tableau Cloud。

1. 转到“Users”（用户）选项卡，并选择要预置的用户。这将打开用户设置页面。
2. 从左侧的导航菜单中，选择“Applications”（应用程序）。
3. 在“Applications”（应用程序）页面上，单击加号 (+) 图标为您的 Tableau Cloud 应用程序预置用户，然后单击“Continue”（继续）。
4. 在“站点角色”字段中为用户输入适当的 Tableau Cloud 站点角色。有关站点角色的详细信息，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。
5. 单击“保存”。

### 为多个用户预置 OneLogin 角色

您可以通过在 OneLogin 中分配角色来将多个用户预置到 Tableau Cloud。可以手动或使用映射自动将用户添加到角色。

若要将用户添加到角色，请执行以下操作：

1. 转到“Users”（用户）\>“Roles”（角色），然后选择现有角色或创建新角色。有关详细信息，请参见 OneLogin 的[角色](https://onelogin.service-now.com/support?id=kb_article&sys_id=ea03f767db889c54d5505eea4b961950&kb_category=fdf52dfcdbd45340d5505eea4b96192b)一文。
    
    下面的示例显示了我们稍后将在 Tableau Cloud 中作为一个组使用的角色“Sales”。
    
    ![按用户映射登录条件。](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-role-example.png)
2. 在“Applications”（应用程序）页面上，为角色分配 Tableau Cloud 应用程序的访问权限。这应该会自动将关联的用户预置到该应用程序。
3. 在“Users”（用户）页面上，您可以通过输入用户的名字和姓氏手动将用户添加到角色，或者添加映射以根据特定属性（例如他们的 Active Directory 组）自动将用户添加到角色。
    
    ![按角色和部门映射登录条件。](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-mapping-example.png)
4. 将用户添加到角色后，我们建议您在应用程序中创建规则以基于 OneLogin 角色分配适当的 Tableau Cloud 站点角色。有关详细信息，请参见 OneLogin 文章[配置应用程序](https://onelogin.service-now.com/support?id=kb_article&sys_id=9a6708241b7b38106a0b40c8cc4bcb4f&kb_category=e9866930db185340d5505eea4b9619b7)。
    
    在下图中，具有“Sales”角色的用户将被分配 Tableau Cloud 中的“Creator”站点角色。同样，具有“Marketing”角色的用户将被分配“Viewer（查看者）”站点角色。
    
    ![Tableau Cloud 的 SSO 规则设置。](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-rules-example.png)

### 将用户添加到现有 Tableau Cloud 组

将 Tableau Cloud 组导入 OneLogin，并指定希望在用户配置对话框中默认处于选定状态的组。

1. 打开“Parameters”（参数）页面，单击“Groups”（组），并选中“Include in User Provisioning”（包括在用户配置中）复选框。
2. 转到“Provisioning”（配置）页面，并在“Entitlements”（权利）部分中单击“Refresh”（刷新）。
    
    此操作将从 Tableau Cloud 导入组。
3. 返回到“Parameters”（参数）页面，然后选择要在用户配置页面中显示为选定值的组。
    
    ![用于编辑字段组的表单。](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-group-provision.png)
4. 若要更改组成员身份，请转到“Users”（用户）页面，选择一个用户，并在“Groups”（组）部分修复可用和选定的值。

您也可以创建根据定义的条件将用户自动放入组中的映射。有关详细信息，请参见 OneLogin 文章[映射](https://onelogin.service-now.com/support?id=kb_article&sys_id=95f649acdb285890d5505eea4b961904 "链接将在新浏览器标签页中打开 OneLogin 帮助中心中的文章。")。

### 通过 OneLogin 创建 Tableau Cloud 中的组

使用以下步骤，基于 OneLogin 映射中的属性创建 Tableau Cloud 组。例如，根据用户角色创建 Tableau Cloud 中的组。

1. 转到“Applications”（应用程序），选择 Tableau Cloud 应用程序，然后选择“Rules”（规则）。
2. 在“Rules”（规则）页面上，单击“Add Rule”（添加规则）以打开编辑映射窗口。
3. 在“Actions”（操作）下，从下拉菜单中选择“Set Groups”（设置组），然后选择“Map from OneLogin”（从 OneLogin 映射）。
    
    “with value that matches”（具有匹配值）条件字段使用正则表达式。如果要在 Tableau Cloud 中创建与 OneLogin 中的角色名称匹配的组，请在文本字段中键入 `.*`。
    
    ![用于编辑应用程序映射的表单。](/tableau/next/zh-cn/online/zh-cn/Img/scim-onelogin-editmapping.png)

### 分配 Tableau 站点角色

默认情况下，将为用户分配“Viewer”站点角色，该角色占用“**Viewer**”许可证类型。

无论您在 OneLogin 中使用什么方法来分配站点角色，在某一时刻您都需要在文本框中输入站点角色名称。有关您可键入的允许的值，请参见下面的[有效的 Tableau 站点角色值](#site-role-values-onelogin-provision)。

您可以通过以下一些方式来分配站点角色

对于个别用户：

1. 在“Users”（用户）页面上，选择用户，然后导航到“Applications”（应用程序）选项卡。选择对应的 Tableau Cloud 应用程序。
2. 在用户设置的“Site Role”（站点角色）文本框中键入站点角色名称。

对于一组用户：

1. 在“Parameters”（参数）页面上，单击“Site Role”（站点角色），然后为“Value”（值）选择选项之一来分配站点角色属性。
    
    例如：
    
    - 如果所有用户具有相同的站点角色，请选择“Macro”（宏）并输入站点角色名称。
    - 如果 OneLogin 用户目录包含站点角色，请选择对应的属性。
2. 在“Rules”（规则）页面上，创建一个将角色映射到 Tableau Cloud 中的特定角色的规则。

分配完站点角色后，单击“Save”（保存）。

### 有效的 Tableau 站点角色值

在 OneLogin 门户中的“Provisioning”（配置）页面上，您可以输入的站点角色值取决于当前许可证角色或旧许可证角色。

- **当前许可证角色**包括以下站点角色值：
    
    Creator、Explorer、ExplorerCanPublish、ReadOnly、 ServerAdministrator、SiteAdministratorExplorer、 SiteAdministratorCreator、Unlicensed 或 Viewer（查看者）。
- **旧许可证角色（v2018.1 之前）许可证类型**附带以下站点角色：
    
    Interactor、Publisher、ServerAdministrator、 SiteAdministrator、Unlicensed、UnlicensedWithPublish、 Viewer 或 ViewerWithPublish

若要了解更改用户属性的效果，或了解如何重置您手动更改的单独用户属性，请参见 OneLogin 文章[设置属性：默认值、规则和手动输入的效果](https://onelogin.service-now.com/support?id=kb_article&sys_id=6ea91d03db109700d5505eea4b96199a "在新浏览器标签页中打开 OneLogin 帮助文章")。

## OneLogin SCIM 支持的注意事项和限制

- 您必须为要使用 SCIM 管理的每个站点添加单独的 Tableau Cloud 应用。
- 在 OneLogin 中从 Tableau Cloud 应用程序中取消预置或移除现有用户时，如果用户拥有任何内容资产，该用户将转换为 Tableau Cloud 中的未许可站点角色。如果用户确实拥有内容，您必须首先重新分配这些内容资产的所有权，然后才能手动删除在 Tableau Cloud 中的用户。
- 将 SCIM 与[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)一起使用不受支持，并且可能导致用户或组的站点角色预置不正确。

<!-- document id=e8670437bc8933b9ce1f29a7321a377d6c85c16a88d0bd583950f640bdef5f2a url=/tableau/next/zh-cn/online/scim_config_pingfederate.md -->

[跳转到主要内容](#main-content)

# 使用 PingFederate 配置 SCIM

您可以通过 PingFederate 配置用户管理、预置组以及分配 Tableau Cloud 站点角色。

在您完成下面描述的步骤时，我们建议您准备好 PingFederate 文档以配合下面描述的过程。

**重要信息：**

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在 IdP 帐户中看到的屏幕不匹配，您可以使用常规的[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)主题以及 IdP 的文档。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：执行先决条件

若要执行本文档中描述的过程，您必须满足以下先决条件：

- **SCIM Provisioner：**已安装并配置 SCIM Provisioner 应用程序。有关详细信息，请参见 PingIdentity 文档中的 [SCIM Provisioner（SCIM 预置程序）](https://docs.pingidentity.com/integrations/scim/pf_scim_connector.html)。
- **Ping 数据存储：**配置了数据存储，如 PingDirectory。有关详细信息，请参见 PingIdentity 文档中的[配置 LDAP 连接](https://docs.pingidentity.com/pingfederate/12.3/administrators_reference_guide/help_datasourcetasklet_ldapconfigstate.html)。
- **协议设置中的 SAML：**配置 SAML 联合的协议设置。

## 步骤 2：开始在 Tableau Cloud 中配置 SAML

Tableau Cloud 中的 SCIM 功能要求您将站点配置为支持 SAML 单点登录 (SSO)。在本主题的后面，您将返回并更新此 SAML 配置。

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

1. 跳过“1.从 IdP 中导出元数据。您将在本主题的后面重新访问此步骤。
2. 在“2.将元数据上载到 Tableau”下，上载占位符 .xml 元数据文件。在本主题的后面，您将用 PingFederate 中的有效 .xml 元数据文件替换此文件。
3. 单击“保存”。

## 步骤 3：在 Tableau Cloud 中启用 SCIM 支持

使用以下步骤在 Tableau Cloud 中启用 SCIM 支持。您将使用本部分中的信息在 PingFederate 中启用 SCIM。

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”页面的“跨域身份管理系统 (SCIM)”下，单击“新配置”按钮。
3. 在“新的 SCIM 配置”对话框中，执行以下操作：
    
    1. 为 SCIM 配置输入一个名称。
    2. 复制要在 IdP 的 SCIM 设置中使用的“基本 URL”。
    3. 从“身份验证”下拉列表中，选择要与 SCIM 关联的 SAML 身份验证配置。
    4. 单击“保存”。
        
        **注意：**这将填充“SCIM 令牌”部分。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_tableau_config.png)
4. 在“SCIM 令牌”下，执行以下操作：
    
    1. 单击“新建密文”按钮。
    2. 在“新建密文”对话框中，再次单击“新建密文”按钮。将显示新生成的密文。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_tableau_secret.png)
    3. 复制密文，并将其存储在安全位置。我们将在步骤 4.2.1 中使用该密文。
        
        **重要信息：**
        
        - 如果关闭 SCIM 配置，然后才能将密文添加到 IdP 的 SCIM 设置，您可以编辑 SCIM 配置，但需要再次单击“新建密文”以生成新密文。
        - 该密文与创建 SCIM 配置的 Tableau 站点管理员用户相关联。如果该用户的站点角色发生变化或者用户不再是站点的成员，则密文将变为无效。在这种情况下，另一个站点管理员可以为现有 SCIM 配置生成新密文并将其添加到 IdP 的 SCIM 设置，或者创建新的 SCIM 配置，确保将基本 URL 和密文添加到 IdP 的 SCIM 设置。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_tableau_message.png)
    4. 单击“关闭”。

## 步骤 4：在 PingFederate 中启用单点登录 (SSO)

若要在 PingFederate 环境中启用 SAML SSO，您必须执行以下操作：

1. 创建 IdP 适配器实例
2. 配置 SP 连接
3. 映射 Ping 数据存储中的属性
4. 配置 SAML SSO

**重要信息：**提醒一下，此处描述的步骤和示例仅用于演示目的。

### 步骤 4.1：创建 IdP 适配器实例

按照以下每个部分创建 [HTML 表单适配器](https://docs.pingidentity.com/pingfederate/latest/administrators_reference_guide/pf_html_form_adapt.html)。PingFederate 使用 IdP 适配器（例如 HTML 表单适配器）来验证用户身份。IdP 适配器查找会话信息并向 PingFederate 提供用户标识。

1. 登录到 PingFederate 管理控制台。
2. 选择**“Authentication”（身份验证）**\>**“IdP Adapters”（IdP 适配器）**。
3. 在“IdP Adapters”（IdP 适配器）页面上，单击**“Create New Instance”（创建新实例）**按钮以启动“创建适配器实例”配置。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_create_new_instance.png)

#### 步骤 4.1.1：创建适配器实例（第 1 部分）

1. 在“Create Adapter Instance”（创建适配器实例）页面上的“Type”（类型）选项卡上，执行以下操作：
    
    1. 对于“INSTANCE NAME”（实例名称），输入一个名称。例如，“credentialsValidatoreInstance”。
    2. 对于“INSTANCE ID”（实例 ID），输入一个值。例如，"3"。
    3. 在“TYPE”（类型）下拉列表中，选择“HTML Form IdP Adapter”（HTML 表单 IdP 适配器）。
    4. 将“PARENT INSTANCE”（父实例）保持原样（“None”（无））。
    5. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_cred_validator_create_new_instance.png)

#### 步骤 4.1.2：创建凭据验证程序

1. 在“IdP Adapter”（IdP 适配器）选项卡上，执行以下操作：
    
    1. 滚动到页面底部，然后单击“Manage Password Credential Validators”（管理密码凭据验证程序）按钮。
    2. 在“Manage Password Credential Validators”（管理密码凭据验证程序）页面上，单击“Create New Instance”（创建新实例）按钮。
2. 在“Create Credentials Validator Instance”（创建凭据验证程序实例）页面上的“Type”（类型）选项卡上，执行以下操作：
    
    1. 对于“INSTANCE NAME”（实例名称），输入一个名称。例如，“credentialsValidatorInstance”。
    2. 对于“INSTANCE ID”（实例 ID），输入一个值。例如，"3"。
    3. 从“TYPE”（类型）下拉列表中，选择“LDAP Username Password Credential Validator”（LDAP 用户名密码凭据验证程序）。
    4. 将“PARENT INSTANCE”（父实例）保持原样（“None”（无））。
    5. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_cred_validator_type.png)
3. 在“Instance Configuration”（实例配置）选项卡上，执行以下操作：
    
    1. 从“LDAP DATASTORE”（LDAP 数据存储）下拉列表中，选择以前配置的 Ping Directory 数据源。
    2. 在“SEARCH BASE”（搜索库）字段中，输入以下内容：dc=example,dc=com。
    3. 在“SEARCH FILTER”（搜索筛选器）字段中，输入以下内容：mail=${username}
    4. 将其他设置保留原样。
    5. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_cred_validator_instance_config.png)
4. 在“Summary”（摘要）选项卡上，查看详细信息并单击“Save”（保存）按钮。
5. 返回到“Manage Password Credential Validators”（管理密码凭据验证程序）页面，单击“Done”（完成）按钮。
6. 返回“Create Adapter Instance”（创建适配器实例）页面，在“Password Credential Validator Instance”（密码凭据验证程序实例）部分下，执行以下操作：
    
    1. 单击“Add a new row to \`Credential Validators\`”（将新行添加到‘凭据验证程序’）链接。
    2. 从显示的下拉菜单中，选择您创建的新验证程序实例。例如，“credentialsValidatorInstance”。
    3. 单击“Update”（更新）链接。
    4. 单击“Next”（下一步）按钮。

#### 步骤 4.1.3：创建适配器实例（第 2 部分）

1. 返回到“Extended Contract”（延长协定）选项卡，执行以下操作：
    
    1. 在“Extended the Contract”（延长协定）部分下，执行以下操作：
        
        1. 在文本框中，输入“sn”并单击“Add”（添加）按钮。
    2. 单击“Next”（下一步）按钮。
2. 在“Adapter Attributes”（适配器属性）选项卡上，执行以下操作：
    
    1. 从 “UNIQUE USER KEY ATTRIBUTE”（唯一用户密钥属性）下拉列表中，选择“username”（用户名）。
    2. 对于 “username”（用户名），选中“Pseudonym”（假名）复选框。
    3. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adpaters_adapter_attributes.png)
3. 在“Adapter Contract Mapping”（适配器协定映射）选项卡上，单击“Configure Adapter Contract”（配置适配器协定）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_contract_mapping_configure_adapter_contract.png)

#### 步骤 4.1.4：配置适配器协定映射（第 1 部分）

1. 在“Adapter Sources & Users Lookup”（适配器源和用户查找）选项卡上，单击“Add Attribute Source”（添加属性源）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_add_attribute_source.png)

#### 步骤 4.1.5：配置属性源和用户查找

1. 在“Data Store”（数据存储）选项卡上，执行以下操作：
    
    1. 对于“ATTRIBUTE SOURCE ID”（属性源 ID），输入一个名称。例如，“attributeSourceUserLookup”。
    2. 对于“ATTRIBUTE SOURCE DESCRIPTION”（属性源描述），输入描述。例如，“attributeSourceId”。
    3. 从“ACTIVE DATA STORE”（活动数据存储）中，选择以前配置的 Ping Directory 数据存储。
    4. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_lookup_data_store.png)
2. 在“LDAP Directory Search”（LDAP 目录搜索）选项卡上，执行以下操作：
    
    1. 对于“BASE DN”（基本 DN），输入以下内容：dc=example,dc=com
    2. 在“Attributes to return from search”（要从搜索中返回的属性）部分下，执行以下操作：
        
        1. 在“ROOT OBJECT CLASS”（根对象类）列中，选择“Show All Attributes”（显示所有属性）。
        2. 在“Option”（选项）列下的文本框中，选择“givenName”，然后单击“Add Attribute”（添加属性）按钮。
        3. 在文本框中，选择“sn”，然后单击“Add Attribute”（添加属性）按钮。
    3. 单击“Next”（下一步）按钮。
3. 在“LDAP Filter”（LDAP 筛选器）选项卡中，执行以下操作：
    
    1. 在“FILTER”（筛选器）文本框中，输入以下内容：mail=${username}
    2. 单击“Next”（下一步）按钮。
4. 在“Summary”（摘要）选项卡上，单击“Save”（保存）按钮
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_lookup_summary.png)

#### 步骤 4.1.6：配置适配器协定映射（第 2 部分）

1. 在“Attribute Sources & User Lookup”（属性源和用户查找）选项卡上，选择您创建的新适配器协定。例如，“attributeSourceId”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_contract_mapping_lookup.png)
2. 在“Adapter Contract Fulfillment”（适配器协定履行）选项卡上，执行以下操作：
    
    1. 对于“givenName”，从“Source”（源）下拉列表中选择“LDAP (attributeSourceId)”；从“Value”（值）下拉列表中，选择“givenName”。
    2. 对于“policy.action”，请从“Sourc”（源）下拉列表中保留原样（“Adapter”（适配器））。
    3. 对于“sn”，从“Source”（源）下拉列表中选择“LDAP (attributeSourceId)”；从“Value”（值）下拉列表中，选择“sn”。
    4. 对于“username”，请将值保留原样 （“Adapter”（适配器））。
    5. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_contract_mapping_fulfillment.png)
3. 在“Issuance Criteria”（颁发条件）选项卡上，单击“Next”（下一步）按钮。
4. 在“Summary”（摘要）选项卡上，查看详细信息并单击“Save”（保存）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_adapters_contract_mapping_summary.png)

### 步骤 4.2：创建 SP 连接

按照下面的每个部分创建 SP 连接。PingFederate 将 SP 连接用于 IDP 发起的单点登录 (SSO)。

1. 在 PingFederate 管理控制台中，导航到“Applications”（应用程序）\>“SP Connections”（SP 连接）。
2. 在“SP Connections”（SP 连接）页面上，单击“Create Connection”（创建连接）按钮。
3. 在“连接模板”选项卡上，保持设置不变（不要为此连接使用模板），然后单击“下一步”按钮。
4. 在 “Connection Type”（连接类型）选项卡上，执行以下操作：
    
    1. 选中“BROWSER SSO Profiles”（浏览 SSO 配置文件）复选框。
        
        1. 在“PROTOCOL”（协议）下拉列表下，将值保留原样 (SAML 2.0)。
    2. 选中“OUTBOUND PROVISIONING”（出站预置）复选框。
    3. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_connection_type.png)
5. 在“Connection Options”（连接选项）选项卡上，单击“Next”（下一步）按钮。
6. 在“Import Metadata”（导入元数据）选项卡上，将值保留原样（“NONE”（无）），然后单击“Next”（下一步）按钮。
7. 在“General Info”（一般信息）选项卡上，执行以下操作：
    
    1. 对于“PARTNERS ENTITY ID”（合作伙伴实体 ID），输入您在步骤 2 中启动的 Tableau Cloud 中 SAML 配置中的 Tableau Cloud 实体 ID。例如，“https://sso.online.tableau.com/public/sp/metadata/25db875a-cace-4769-8429-d7b210879ef2/36673dc4-e2c1-4970-976f-255bda6036cb”。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_tableau_cloud_metadata.png)
    2. 对于“CONNECTION NAME”（连接名称），输入一个名称。例如，“SCIM 连接器”。
    3. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_general.png)
8. 在“Outbound Provisioning”（出站预置）选项卡上，单击“Configure Provisioning”（配置预置）按钮。

#### 步骤 4.2.1：创建配置通道

1. 在“Target”（目标）选项卡上，执行以下操作：
    
    1. 对于“SCIM URL”，输入您在步骤 3 中创建的 Tableau Cloud 中 SCIM 配置中的基本 URL。例如，“https://scim.online.tableau.com/pods/cd-main/sites/25db875a-cace-4769-8429-d7b210879ef2/scim/v2”。
    2. 对于“SCIM VERSION”（SCIM 版本），将值保留原样 (2.0)。
    3. 从“AUTHENTICATION METHOD”（身份验证方法）下拉列表中，选择“OAUTH 2 BEARER TOKEN”。
    4. 对于“ACCESS TOKEN”（访问令牌），输入您在步骤 3 中创建的 Tableau Cloud 中 SCIM 配置中的 SCIM 令牌密文。
    5. 对于“UNIQUE USER IDENTIFIER”（唯一用户标识符），将值保留原样 (userName)。
    6. 对于“RESULTS PER PAGE”（每页结果数），输入以下值：25。我们建议更改此值以获得更好的性能。
    7. 对于“PROVISIONING OPTIONS”（预置选项），请确保选中以下复选框：
        
        1. USER CREATE（用户创建）
        2. USER UPDATE（用户更新）
        3. USER DISABLE /DELETE（用户禁用/删除）
        4. PROVISION DISABLED USERS（预置禁用用户）
    8. 对于“REMOVE USER ACTION”（移除用户操作），将该值保留原样（“Disable”（禁用））。如果将用户从 PingFederate IdP 中移除，我们建议使用此选项将用户的角色更改为 Tableau Cloud 中的“未许可”。
    9. 对于“GROUP NAME SOURCE”（组名源），执行以下操作：
        
        1. 在下拉列表中，将值保留原样（“Common Name”（公用名称））。
        2. 选中“USE PATCH FOR GROUP UPDATES”（为组更新使用修补程序）复选框。
    10. 对于“CUSTOM ATTRIBUTE SCHEMA URNS”（自定义属性架构 URN），输入以下值：
        
        urn:ietf:params:scim:schemas:extension:tableau:3.0:User,urn:ietf:params:scim:schemas:extension:tableau:3.0
    11. 单击“Next”（下一步）按钮。
2. 在“Configure Channels”（配置通道）页面的“Target”（目标）选项卡上，单击“Create”（创建）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_target.png)
3. 在“Channel Info”（通道信息）选项卡中，对于“CHANNEL NAME”（通道名称），输入名称并单击“Next”（下一步）按钮。
4. 在“Source”（源）选项卡上，执行以下操作：
    
    1. 从“ACTIVE DATA STORE”（活动数据存储）下拉列表中，选择“Ping data store”（Ping 数据存储）。
    2. 从“TYPE”（类型）下拉列表中，选择“LDAP”。
    3. 单击“Next”（下一步）按钮。
5. 在“Source Settings”（源设置）选项卡中，验证以下值：
    
    1. 对于“ENTRY GUID ATTRIBUTE”（条目 GUID 属性），值为 entryUUID。
    2. 对于“GROUP MEMBER ATTRIBUTE”（组成员属性），值为 uniqueMember。
    3. 对于“USER OBJECTCLASS”（用户对象类），值为 inetOrgPerson。
    4. 对于“GROUP OBJECTCLASS”（组对象类），值为 groupOfUniqueNames。
    5. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_source_settings_top.png)  
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_source_settings_bottom.png)
6. 在“Source Location”（源位置）选项卡中，执行以下操作：
    
    1. 对于“BASE DN”（基本 DN），输入以下内容：dc=example,dc=com
    2. 在“Users”（用户）部分下，为“FILTER”（筛选器）输入以下内容：objectClass=inetOrgPerson
    3. 在“Groups”（组）部分下，为“FILTER”（筛选器）输入以下内容：objectClass=groupOfUniqueNames
    4. 单击“Next”（下一步）按钮。
7. 在“Attribute Mapping”（属性映射）选项卡中，执行以下操作：
    
    1. 通过执行以下操作将 userName 属性编辑为“mail”：
        
        1. 在“userName”行中，单击“Edit”（编辑）。
        2. 在“Root Object”（根对象）类下，选择“<Show All Attributes>”（<显示所有属性>）。
        3. 从“Attributes”（属性）下拉列表中，选择“mail”。
        4. 单击“Add Attribute”（添加属性）按钮。
        5. 在 uuid 属性旁边，单击“Remove”（移除）链接。
    2. 将其余属性保留原样。
    3. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_attribute_mapping.png)
8. 在“Activation & Summary”（激活和摘要）选项卡中，执行以下操作：
    
    1. 对于“Channel Status”（通道状态），选择“Active”（活动）。
    2. 单击“Save Draft”（保存草稿）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_summary_top.png)  
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_channels_summary_bottom.png)

### 步骤 4.3：将 SCIM 属性映射到 Ping 数据存储

按照以下步骤，通过 PingData 管理控制台映射 Ping 数据存储中的 SCIM 属性。

1. 登录到 PingData 管理员控制台。
2. 从左侧导航窗格中，导航到“LDAP Schema”（LDAP 架构），然后单击“Attribute Types”（属性类型）选项卡。

#### 步骤 4.3.1：创建新的属性类型

1. 单击“Actions”（操作）按钮，并选择“New Attribute Type”（新建属性类型）。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_data_store_attribute_type.png)
2. 在“New Attribute Type”（新建属性类型）对话框中，执行以下操作：
    
    1. 对于“Name”（名称），输入以下内容：siteRoles
    2. 对于“Description”（描述），输入描述。例如，“Tableau Cloud 上站点角色的自定义属性”。
    3. 单击“Save”（保存）。
3. 重复上述步骤，并在“New Attribute Type”（新建属性类型）对话框中执行以下操作：
    
    1. 对于“Name”（名称），输入以下内容：entitlements
    2. 对于“Description”（描述），输入描述。例如，“Tableau Cloud 上权利的自定义属性”。
    3. 单击“Save”（保存）。

#### 步骤 4.3.2：创建新的对象类

1. 在页面顶部，单击“Object Class”（对象类）选项卡，单击“Actions”（操作）按钮，然后选择“New Object Class”（新建对象类）。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_data_store_object_class.png)
2. 在“New Object Class”（新建对象类）对话框中，执行以下操作：
    
    1. 对于“Name”（名称），输入以下内容：Tableau。
    2. 对于“Description”（描述），输入描述。例如，“将 siteRoles 属性添加为权利”。
    3. 从“Parent”（父项）下拉列表中，选择“inetOrgPerson”。
    4. 从“Type”（类型）下拉列表中，选择“Structural”（结构）。
    5. 在“Attributes”（属性）部分下，执行以下操作：
        
        1. 对于“Required Attribute”（必需属性），查找并选择“sn”，然后单击“Add item”（添加项）箭头按钮。
        2. 对于“Required Attributes”（必需属性），查找并选择“cn”，然后单击“Add item”（添加项）箭头按钮。
        3. 对于“Required Attributes”（必需属性），查找并选择“objectClass”，然后单击“Add item”（添加项）箭头按钮。
        4. 对于“Optional Attributes”（可选属性），查找并选择“siteRoles”，然后单击“Add item”（添加项）箭头按钮。
        5. 对于“Optional Attributes”（可选属性），查找并选择“entitlements”，然后单击“Add item”（添加项）箭头按钮。
    6. 单击“Save”（保存）。

### 步骤 4.4：配置 SSL

按照下面的过程编辑您之前创建以支持 SAML SSO 的 SP 连接。

1. 在 PingFederate 管理控制台中的页面顶部，选择“Applications”（应用程序）\>“SP Connections”（SP 连接）。
2. 在“SP Connections”（SP 连接）页面上，执行以下操作：
    
    1. 单击您在步骤 4.2 中创建的连接名称。
    2. 单击“Connection”（连接）选项卡。
3. 在“Connection”（连接）选项卡上，保持选择不变，然后单击“Next”（下一步）按钮。
4. 在“Connections Options”（连接选项）选项卡上，将选择保持原样（“BROWSER SSO”（浏览器 SSO）），然后单击“Next”（下一步）按钮。
5. 在“Import Metadata”（导入元数据）选项卡上，保持选择原样（“NONE”（无）），然后单击“Next”（下一步）按钮。
6. 在“General Info”（一般信息）选项卡上，执行以下操作：
    
    1. 对于“PARTNERS ENTITY ID”（合作伙伴实体 ID），将文本替换为您在步骤 2 中启动的 Tableau Cloud 中 SAML 配置中的 Tableau Cloud 实体 ID。例如，https://sso.online.tableau.com/public/sp/metadata/25db875a-cace-4769-8429-d7b210879ef2/36673dc4-e2c1-4970-976f-255bda6036cb。
    2. （可选）更新“CONNECTION NAME”（连接名称）。
    3. 单击“Next”（下一步）按钮。
7. 在“Browser SSO”（浏览器 SSO）选项卡上，单击“Configure Browser SSO”（配置浏览器 SSO）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_broswer.png)
8. 在“SAML Profiles”（SSO 配置文件）选项卡上，执行以下操作：
    
    1. 在“Single Sign-On (SSO) Profiles”（单点登录 (SSO) 配置文件）部分下，执行以下操作：
        
        1. 选中“IDP-INITIATED SSO”（IDP 发起的 SSO）复选框。
        2. 选中“SP-INITIATED SSO”（SP 发起的 SSO）复选框。
    2. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_browser_SAML_profile.png)
9. 在“Assertion Lifetime”（断言生存期）选项卡上，将值保持原样，然后单击“Next”（下一步）按钮。
10. 在“Assertion Creation”（断言创建）选项卡上，单击“Configure Assertion Creation”（配置断言创建）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_browser_assertion_creation.png)
11. 在“Identity Mapping”（身份映射）选项卡上，保持选择原样（“STANDARD”（标准）），然后单击“Next”（下一步）按钮。
12. 在“Attribute Contract”（属性协定）选项卡上，执行以下操作：
    
    1. 在“Subject Name Format”（使用者名称格式）部分下，将值保持原样 (urn:oasis:names:tc:SAML:nameid-format:unspecified)。
    2. 在“Extended the Contract”（延长协定）部分下，执行以下操作：
        
        1. 在文本框中，输入以下内容：FirstName
        2. 在“Attribute Name Format”（属性名称格式）下，选择“urn:oasis:names:tc:SAML:2.0:attrname-format:basic”。
        3. 单击“Add”（添加）按钮。
        4. 在文本框中，输入以下内容：LastName
        5. 在“Attribute Name Format”（属性名称格式）下，选择“urn:oasis:names:tc:SAML:2.0:attrname-format:basic”。
        6. 单击“Add”（添加）按钮。
    3. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_attr_contract.png)
13. 在“Authentication Source Mapping”（身份验证源映射）选项卡上，单击“Map New Adapter Instance”（映射新适配器实例）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_source_mapping.png)
14. 在“IdP Adapter Mapping”（IdP 适配器映射）页面上的“Adapter Instance”（适配器实例）选项卡上，选择您在步骤 4.1.1 中创建的适配器，然后单击“Next”（下一步）按钮。例如，“credentialsValidatorInstance”。
15. 在“Mapping Method”（映射方法）选项卡上，将值保持原样（“USE ONLY THE ADAPTER CONTRACT VALUES IN THE SAML ASSERTION”（仅使用 SAML 断言中的适配器协定值）），然后单击“Next”（下一步）按钮。
16. 在“Attribute Contract Fulfillment”（属性协定履行）选项卡上，执行以下操作：
    
    1. 在“FirstName”旁边，执行以下操作：
        
        1. 从“Source”（源）下拉列表中，选择“Adapter”（适配器）。
        2. 从“Value”（值）下拉列表中，选择“givenName”。
    2. 在“LastName”旁边，执行以下操作：
        
        1. 从“Source”（源）下拉列表中，选择“Adapter”（适配器）。
        2. 从“Value”（值）下拉列表中，选择“sn”。
    3. 在“SAML\_SUBJECT”旁边，
        
        1. 从“Source”（源）下拉列表中，选择“Adapter”（适配器）。
        2. 从“Value”（值）下拉列表中，选择“username”。
    4. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_fulfillment.png)
17. 在“Issuance Criteria”（颁发条件）选项卡上，单击“Next”（下一步）按钮。
18. 在“Summary”（摘要）选项卡上，查看详细信息并单击“Done”（完成）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_idp_summary.png)
19. 在“Assertion Creation”（断言创建）选项卡上，查看详细信息并单击“Done”（完成）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_auth_source.png)
20. 在“Assertion Creation”（断言创建）选项卡上，单击“Next”（下一步）按钮。
21. 在“Protocol Settings”（协议设置）页面上，单击“Configure Protocol Settings”（配置协议设置）按钮。
22. 在“Protocol Settings”（协议设置）页面上的“Assertion Consumer Service URL”（断言使用者服务 URL）选项卡上，执行以下操作：
    
    1. 在“Default”（默认值）下，选中复选框。
    2. 在“Binding”（绑定）下，选择“POST”。
    3. 在“Endpoint URL”（端点 URL）下，输入您在步骤 2 中启动的 Tableau Cloud 中 SAML 配置中的 ACS URL，然后单击“Add”（添加）按钮。例如，“https://sso.online.tableau.com/public/sp/SSO/25db875a-cace-4769-8429-d7b210879ef2/36673dc4-e2c1-4970-976f-255bda6036cb”。
    4. 单击“Next”（下一步）按钮。
23. 在“Allowable SAML Bindings”（允许的 SAML 绑定）选项卡上，执行以下操作：
    
    1. 确保选中“POST”和 “REDIRECT”复选框，并移除其他复选框的选择。
    2. 单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_browser_protocol_settings.png)
24. 在“Signature Policy”（签名策略）选项卡上，单击“Next”（下一步）按钮。
25. 在“Encryption Policy”（加密策略）选项卡上，保持选择不变（“None”（无）），然后单击“Next”（下一步）按钮。
26. 在“Summary”（摘要）选项卡上，查看详细信息并单击“Done”（完成）按钮。
27. 在“Browser SSO”（浏览器 SSO）页面上的“Protocol Settings”（协议设置）选项卡上，单击“Next”（下一步）按钮。
28. 在“Summary”（摘要）选项卡上，查看详细信息并单击“Done”（完成）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_browser_summary_top.png)  
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_browser_summary_bottom.png)
29. 在“SP Connection”（SP 连接）页面上的“General Info”（一般信息）选项卡上，单击“Next”（下一步）按钮。
30. 在“Configure Browser SSO”（配置浏览器 SSO）选项卡上，单击“Next”（下一步）按钮。
31. 在“Credentials”（凭据）选项卡上，单击“Configure Credentials”（配置凭据）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_credentials.png)
32. 在“Digital Signature Settings”（数字签名设置）选项卡上，执行以下操作_之一_： 
    
    - 如果已有现有的有效签名证书，请执行以下操作：
        
        1. 从“SIGNING CERTIFICATE”（签名证书）下拉列表中，选择现有证书并单击“Next”（下一步）按钮。
        2. 跳到步骤 38。
    - 如果您没有现有的有效签名证书，请执行以下操作：
        
        1. 单击“Manage Certificates”（管理证书）按钮。
        2. 继续执行步骤 33。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_credentials_digital_sig_settings.png)
33. 在“Certificate Management”（证书管理）页面上，单击“Create New”（新建）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_credentials_certificate_management.png)
34. 在“Create Certificate”（创建证书）页面上的“Create Certificate”（创建证书）选项卡上，执行以下操作：
    
    1. 对于“COMMON NAME”（公用名称），输入一个名称。例如，“PingFedCert”。
    2. 对于“ORGANIZATION”（组织），输入一个名称。例如，“Tableau”。
    3. 对于“COUNTRY”（国家/地区），输入一个国家/地区名称。
    4. 单击“Next”（下一步）按钮。
35. 在“Summar”（摘要）选项卡上，确保选中“MAKE THIS ACTIVE CERTIFICATE”（使此成为活动证书）复选框，然后单击“Save”（保存）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_credentials_cert_manage_cert_summary.png)
36. 在“Certificate Management”（证书管理）页面上，单击“Done”（完成）按钮。
37. 在“Credentials”（凭据）页面上，执行以下操作：
    
    1. 从“SIGNING CERTIFICATE”（签名证书）下拉列表中，选择新创建的证书。
    2. 单击“Next”（下一步）按钮。
38. 在“Summary”（摘要）页面上，单击“Done”（完成）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_sp_connections_sp_credentials_digital_sig_settings_summary.png)
39. 在“SP Connection”（SP 连接）页面上的“Outbound Provisioning”（出站预置）选项卡上，单击“Next”（下一步）按钮。
40. 在“Activation & Summary”（激活和摘要）选项卡上，查看详细信息并单击“Done”（完成）按钮。

## 步骤 5：从 PingFederate 中导出元数据

若要在 Tableau Cloud 中完成设置 SAML，您需要将 SAML 元数据文件 (.xml) 从 PingFederate 中上载到 Tableau Cloud。

1. 在 PingFederate 管理控制台上，选择“System”（系统）\>“Protocol Metadata”（协议元数据）\>“Metadata Export”（元数据导出）。
2. 在“Metadata Export”（元数据导出）页面上的“Metadata Role”（元数据角色）选项卡上，保持选择不变（“I AM THE IDENTITY PROVIDER (IDP)”（我是身份提供商 (IDP)）），然后单击“Next”（下一步）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_metadata_export_role.png)
3. 在“Metadata Mode”（元数据模式）选项卡上，保持选择不变（“USE A CONNECTION FOR METADATA GENERATION”（使用连接生成元数据）），然后单击“Next”（下一步）按钮。
4. 在“Connection Metadata”（连接元数据）选项卡上，从下拉列表中选择您在步骤 4.2 中创建的 SP 连接，然后单击“Next”（下一步）按钮。
5. 在“Metadata Signing”（元数据签名）选项卡上，从“SIGNING CERTIFICATE”）签名证书下拉列表中选择您在步骤 4.4 中创建的证书，然后单击“Next”（下一步）按钮。
6. 在“Export & Summary”（导出和摘要）选项卡上，单击“Export”（导出）按钮以下载 PingFederate 元数据文件，然后单击“Done”（完成）按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/pingfed_scim_metadata_summary.png)

## 步骤 6：在 Tableau Cloud 中完成 SAML 配置

需要在 Tableau Cloud 中执行以下步骤。

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到您在步骤 5 中从 PingFederate 保存的 SAML 元数据文件。这会自动填充“IdP 实体 ID”和“SSO 服务 URL”值。
2. 将“3.映射属性”下的属性名称（断言）映射到 PingFederate 中的相应属性名称。
3. 在“4.选择嵌入视图的默认设置(可选)”下，选择您要在用户访问嵌入内容时启用的体验。有关详细信息，请参见下面的[关于启用 iFrame 嵌入](#enable-iframe-embedding)部分。
4. 单击“保存并继续”按钮。

## 关于启用 iFrame 嵌入

**注意：**仅适用于 Tableau Cloud。

在站点上启用 SAML 时，您需要指定用户如何登录来访问网页中嵌入的视图。这些步骤对 Okta 进行配置，以允许为嵌入可视化项使用嵌入式框架 (iFrame) 进行身份验证。嵌入式框架嵌入可以在登录以查看嵌入式可视化项时提供更加完美的用户体验。例如，如果用户已经向您的身份提供程序进行了身份验证，并且启用了 iFrame 嵌入，则当浏览到包含嵌入式可视化项的页面时，用户将无缝地向 Tableau Cloud 进行身份验证。

**警告：**嵌入式框架可能容易受到单击劫持攻击。_单击劫持_是一种针对网页的攻击，在这种攻击中，攻击者会试图在一个不相关页面上的透明层中显示攻击页面，从而诱骗用户单击或输入内容。在 Tableau Cloud 的上下文中，攻击者可能会试图使用单击劫持攻击来捕获用户凭据，或让授权用户更改设置。有关单击劫持攻击的详细信息，请参见开放式 Web 应用程序安全项目网站上的[单击劫持](https://www.owasp.org/index.php/Clickjacking)。

## PingFederate 的 SCIM 支持注意事项

- 由于 PingFederate 中的限制，组上的 siteRole 更新不会对该组中的用户启动 siteRole 更新。这可能导致过时的 siteRole 属性分配。为了解决此问题，您可以将非自定义属性更新与 siteRole 属性更新一起使用来启动 siteRole 更新。这可以手动完成，也可以使用以下选项之一自动完成：
    
    - 仅在用户对象上管理 siteRoles。
    - 组更新后，手动更新该用户的任何属性。它不必像站点角色那样是 SCIM 支持的属性。它可以是描述或名称属性。
    - 在 PingFederate 中设置 OGNL 表达式，并在 Ping Server 启动之前执行组成员身份更新。启动 Ping Server 后，它将触发 siteRole 属性更新。
    - 在 PingFederate 中设置 OGNL 表达式。此外，设置一个反向静态组和 cron 作业以触发 siteRole 更新。
- PingFederate 中的 OGNL 表达式将评估用户及其组成员身份的属性，以确定其 siteRole。

<!-- document id=530af6a7af2dd515ffdcf7c8bc0870334bca04f048efe9fcf7ac9cef80be34f5 url=/tableau/next/zh-cn/online/saml_config_pingone.md -->

[跳转到主要内容](#main-content)

# 使用 PingOne 配置 SAML

如果使用 PingOne 作为 SAML 身份提供程序 (IdP)，您可以使用本主题中的信息来为 Tableau Cloud 或 Tableau Cloud Manager (TCM) 设置 SAML 身份验证。

**注意：** 

- 这些步骤反映第三方应用程序，并且会在我方不知道的情况下发生更改。如果此处描述的步骤与您在您的 IdP 帐户中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 IdP 的文档。
- 自 2022 年 2 月起，Tableau 要求通过 SAML SSO 身份提供程序 (IdP) 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau 中看到的顺序不同。

## 步骤 1：开始

在 Tableau Cloud 中，执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

在 PingOne 中，执行以下操作：

**注意：**对于 TCM，您可以使用 IdP 中的“Tableau Cloud 应用程序”来配置 TCM 身份验证。

1. 打开新的浏览器标签页或窗口，登录您的 PingOne 账户，然后单击“Applications”（应用程序）选项卡。
2. 在“Application Catalog”（应用程序目录）中，搜索并选择 Tableau Cloud。
3. 依次单击“Setup”（设置）按钮和“Save & Publish”（保存并发布）按钮，然后单击“SAML Metadata”（SAML 元数据）旁边的“Download”（下载）链接，并将 PingOne SAML 元数据文件保存到您的计算机。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_pingone3.png)

## 步骤 2：在 Tableau Cloud 或 TCM 中配置 SAML

按照上一部分所述下载来自 PingOne 的 SAML 元数据文件后，完成以下过程。

**对于 Tableau Cloud**

1. 返回 Tableau Cloud，在“新配置”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 PingOne 帐户下载的 SAML 元数据文件。
2. 继续执行“步骤 3: 地图属性”，并按所述方式完成其余步骤。
3. 在“4.选择嵌入视图的默认值”下，您可以选择用户如何对嵌入视图进行身份验证。
4. 单击“保存并继续”按钮。
5. 在“5.获取 Tableau Cloud 元数据”下，单击“导出元数据”按钮，并将 Tableau 元数据文件保存到您的计算机。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。

**对于 TCM**

1. 返回 TCM，在“身份验证”页面的“2.将元数据上载到 Tableau”下，单击“选择文件”按钮，并导航到从 PingOne 帐户下载的 SAML 元数据文件。
2. 继续执行“步骤 3: 匹配断言”，并按所述方式完成其余步骤。
3. 单击“保存并继续”按钮。
4. 在“4.获取 Tableau Cloud 元数据”下，单击“导出元数据”按钮，并将 Tableau 元数据文件保存到您的计算机。
    
    默认情况下，文件名为 **saml\_sp\_metadata.xml**。

## 步骤 3.在您的 IdP 中配置“Tableau Cloud 应用程序”

**注意：**对于 TCM，您可以使用 IdP 中的“Tableau Cloud 应用程序”来配置 TCM 身份验证。

1. 返回您的 PingOne 帐户，在 Tableau Cloud 应用程序中，导航到“Setup”（设置）。
2. 在“1.SSO Instructions”（1. SSO 说明）页面上，单击“Continue to Next Step”（继续执行下一步）。
3. 在“2.Configure your connection”（2. 配置连接）页面上，对于“Upload Metadata”（上载元数据），单击“Select File”（选择文件），并上载您从 Tableau Cloud 或 TCM 中保存的 Tableau Cloud 或 TCM 元数据文件。
4. 单击“Continue to Next Step”（继续执行下一步）。

导入 Tableau Cloud 或 TCM 元数据作为 PingOneSAML 配置的一部分时，元数据中嵌入的证书不会应用到 IdP 应用程序定义。这可能会导致用户在注销 SAML 站点时发生以下错误：

_似乎未配置签名证书。_

### 配置 PingOne 证书

若要解决注销错误，您可以从 Tableau Cloud 或 TCM 下载证书，将其从 DER 编码转换为 Base-64 编码，然后将其上载到 PingOne。

用于转换证书的步骤特定于 Windows。

在 Tableau Cloud 中，执行以下操作：

1. 返回 Tableau Cloud，确保已选中“SAML”，并且您位于“新配置”页面上。
2. 在“5.获取 Tableau Cloud 元数据”下，对于“方法 2：复制元数据并下载证书”，单击“下载证书”按钮，然后将 .cer 文件保存到您的计算机。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_pingone5.png)

或者，在 TCM 中，执行以下操作：

1. 返回 TCM，确保已选中“SAML”，并且您位于“身份验证”页面上。
2. 在“4.获取 Tableau Cloud 元数据”下，对于“方法 2：复制元数据并下载证书”，单击“下载证书”按钮，然后将 .cer 文件保存到您的计算机。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_pingone5.png)

在计算机上，执行以下操作：

1. 双击下载的 .cer 文件，并单击“打开”。
2. 在“证书”对话框中，选择“详细信息”选项卡并单击“复制到文件”。
3. 在证书导出向导中，执行以下操作：
    
    1. 在打开的屏幕上单击“下一步”，然后选择“Base-64 编码 X.590 (.CER)”。
    2. 单击“下一步”，并指定所导出的文件的名称和位置。
    3. 单击“下一步”，查看摘要信息，然后单击“完成”。

在 PingOne 中，执行以下操作：

1. 在您的 PingOne 帐户中，返回到 Tableau Cloud 或 TCM 的应用程序设置页面。
2. 在“Step 2.Configure your connection”（步骤 2. 配置连接）中，为“Verification Certificate”（验证证书）单击“Choose File”（选择文件），并上载您创建的新 .cer 文件。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_pingone6.png)

## 步骤 4：测试 SAML 配置

在 PingOne 中，执行以下操作：

- 将示例用户添加到 PingOne 并将其分配给 Tableau Cloud 或 TCM 应用程序。

在 Tableau Cloud 中，执行以下操作：

1. 将该 PingOne 用户添加到 Tableau Cloud 以测试 SAML 配置。
    
    - 若要在 Tableau Cloud 中添加用户，请参见 [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题。
    - 若要在 TCM 中添加用户，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题。
2. 执行以下操作_之一_：
    
    - 在 Tableau Cloud 中的“7.测试配置”下，单击“测试配置”按钮。
    - 在 TCM 中“身份验证”页面的“6.测试配置”下，单击“测试配置”按钮。

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

## 步骤 5：将其他用户添加到启用 SAML 的 Tableau Cloud 站点 或 TCM

使用下面的步骤将其他用户添加到您的站点。本部分中描述的程序是在 Tableau Cloud 或 TCM 的“用户”页面上执行的。

1. 完成上述步骤后，从左侧窗格导航至“用户”页面。
2. 按照以下步骤操作：
    
    - 适用于 Tableau Cloud 的[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)主题
    - 适用于 TCM 的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题

<!-- document id=af4579f9074ba6ce506ff7da43c5def8f91e105595814fad8a1aabe386c4a54e url=/tableau/next/zh-cn/online/to_connect_salesforce.md -->

[跳转到主要内容](#main-content)

# 使用 Salesforce 数据创建工作簿

您可以在 Tableau 中快速制作和分析 Salesforce 数据。直接从您的 Tableau Cloud 站点登录到 Salesforce，并选择要探索的云。Tableau 会集成您的 Salesforce 数据，以使用现成的入门工作簿和数据源创建项目 - 选择自己探索它们或与您站点上的其他用户共享。

## Salesforce 项目附带什么内容

Salesforce 项目包括入门工作簿和数据源，所有这些都是使用您的 Salesforce 数据构建的。使用入门工作簿快速回答有关您的非营利组织、销售和服务云的问题，或连接到 Salesforce 在线管理见解以查看您组织中的使用情况趋势。

![带有图表和筛选器的仪表板，显示团队的开放销售渠道。](/tableau/next/zh-cn/online/zh-cn/Img/connect_salesforce_starter.png)

### 非营利云

连接到非营利云以分析您组织的计划并推动影响。

包括以下入门工作簿：_Nonprofit Case Management - Service Delivery and Staff Capacity（非营利案例管理 - 服务交付和员工能力）_、_Nonprofit Case Management Assessments（非营利案例管理评估）_、_Nonprofit Case Management Enrollment（非营利案例管理注册）_、_Nonprofit Case Management Intake（非营利案例管理接收）_和 _Nonprofit Fundraising Overview（非营利筹款概述）_。

### 销售云

连接到销售云以可视化您的销售渠道并更好地支持您的销售团队。

包括以下入门工作簿：_Account Tracking（客户跟踪）_、_Open Pipeline（开放管道）_、_Opportunity Overview（机会概览）_、_Opportunity Tracking（机会跟踪）_、_Quarterly Sales Results（季度销售结果）_、_Top Accounts（主要客户）_和 _Marketing Leads（营销线索）_。

### Salesforce 在线管理见解

连接到 Salesforce 在线管理见解以可视化使用情况趋势和与您的组织的互动。

包括以下入门工作簿：_Salesforce Admin Insights（Salesforce 在线管理见解）_。

### 服务云

连接到服务云以分析和探索您的关键服务指标和案例。

包括以下入门工作簿：_Service Overview（服务概览）_和 _Case Tracking（案例跟踪）_。

## 连接到 Salesforce

连接到您的 Salesforce 数据很简单。在您登录并选择要探索的云后，Tableau 会创建一个新项目并在您的站点上发布工作簿和数据源。发布过程完成后，您可以像编辑任何其他工作簿一样[编辑生成的工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#web_author_build_view.htm)，根据需求快速对其进行自定义。

若要连接到 Salesforce，您必须是具有站点管理员 Creator 站点角色的管理员，并且对您的 Salesforce 实例具有 API 访问权限。API 访问需要 Salesforce Professional Edition 或更高版本。有关详细信息，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。

1. 以管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“集成”。
2. 在“集成”选项卡上，单击“连接到 Salesforce 数据”并完成提示以授权访问 Salesforce。
3. 在“连接到 Salesforce”对话框窗口中，选择要探索的云。
4. 为项目指定名称和初始权限。您可以为**“仅管理员”**设置权限，或选择**“从默认项目继承权限”**。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。
5. 检查您的选择并单击“发布”。

此时，您已经创建了一个新项目，并发布了入门工作簿。在 Tableau 为您的 Salesforce 数据准备数据提取时，示例数据将出现在工作簿中，以便您能够探索布局。当您的 Salesforce 数据刷新并添加到工作簿时，您将收到一封电子邮件。

**注意：**根据数据源的大小，创建数据提取可能需要一些时间。您可以在[数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd.htm)管理视图中查看 Salesforce 数据提取的状态。

若要查看您的项目和您有权访问的其他内容，请从导航菜单中单击“探索”。

![Tableau Cloud 中的 Salesforce 项目文件夹。](/tableau/next/zh-cn/online/zh-cn/Img/connect_salesforce_project.png)

### 使用现有的 Salesforce 凭据

如果您已连接到 Salesforce，则可以使用现有凭据创建其他入门工作簿。

在“集成”选项卡中，单击“连接到 Salesforce 数据”，然后从下拉菜单中选择要使用的 Salesforce 凭据。每次在您的站点上发布工作簿时，Tableau 都会创建一个新项目。

**注意：**工作簿将在站点上发布，并嵌入您的 Salesforce 凭据。所有有权查看工作簿的用户都将能够查看基于这些凭据的数据。

![用于连接到 Salesforce 数据的选项。](/tableau/next/zh-cn/online/zh-cn/Img/connect_salesforce_credentials.png)

## 计划刷新以使数据保持最新

为确保在查看工作簿或连接到数据源时看到最新信息，您需要计划刷新。默认情况下，发布入门工作簿时创建的 Salesforce 数据提取不会自动刷新。有关刷新计划的详细信息，请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)

按照以下步骤计划数据提取刷新：

1. 在 Tableau Cloud 中，导航到包含您的 Salesforce 内容的项目。
2. 选择要刷新的数据源，单击“操作”，然后选择“刷新数据提取...”
3. 在“创建数据提取刷新”对话框窗口中，选择**“刷新类型”**和**“刷新频率”**，然后单击“创建”。

## 订阅

您将自动订阅 Salesforce 工作簿，并在每次刷新数据时收到通知电子邮件。如果要更新订阅首选项，请参见[创建视图或工作簿订阅](https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm)。

## 更改项目、工作簿和数据源的权限

连接到您的 Salesforce 数据后，您可以选择用户如何与您站点上发布的 Salesforce 项目、工作簿和数据源交互。权限是确保合适的用户可以访问入门内容并使他们能够构建自己的工作簿的好方法。有关在您的站点上配置权限的详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

## 在 Tableau Cloud 中创建工作簿

借助 Salesforce 数据源，您可以通过 Tableau Cloud 中的“Web 制作”创建新工作簿，或使用“数据问答”(Ask Data) 功能自动查询和创建可视化项。

- **Web 制作：**直接连接到 Tableau Cloud 中的数据以探索和创建您自己的自定义数据可视化项。有关详细信息，请参见 Tableau Desktop 帮助中的 [Creator：Web 制作入门](https://help.tableau.com/current/pro/desktop/zh-cn/getstarted_web_authoring.htm)。
- **“数据问答”(Ask Data) 功能：**只需键入一个问题即可与您的数据进行交互，并在响应中查看自动数据可视化项。有关详细信息，请参见 Tableau Desktop 帮助中的[使用“数据问答”(Ask Data) 功能自动生成视图](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm)。

## 通过替换字段名称修复显示为灰色的视图

如果组织自定义了 Salesforce 数据的数据结构，当您的数据在入门工作簿中加载之后，您可能需要在其中匹配这些更改。举例来说，如果组织已将 Salesforce 的“Account”字段重命名为“Customer”，您将需要在工作簿中进行对应的更改，以避免出现像下面这样显示为灰色的视图：

![灰色的销售绩效仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_grayed_out.png)

若要修复显示为灰色的视图，请执行以下操作：

1. 在仪表板上方，单击“编辑”。
2. 直接导航到显示为灰色的工作表。
3. 在左侧的“数据”窗格中，查找字段名称旁边的红色感叹号 (!)，其指明组织使用不同的名称。
4. 右键单击其中的每个字段，并选择“替换引用”。然后从列表中选择正确的字段名称。

![从度量中展开的上下文菜单，其中突出显示了替换参照的选项。](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_replace_references.png)

<!-- document id=be129f8b8a2ea7e322b664799e3b89f633bb5cd29db1fc2f433b89246d02d79c url=/tableau/next/zh-cn/online/saml_config_salesforce.md -->

[跳转到主要内容](#main-content)

# 使用 Salesforce 配置 SAML

如果已将 Salesforce 配置为您的 SAML 身份提供程序 (IdP)，请使用本主题中的信息以及 Salesforce 文档将Tableau Cloud 或 Tableau Cloud Manager (TCM) 添加到您的单点登录应用程序。

**注意：** 

- 这些步骤反映了 Salesforce 应用程序，并且可能会在我们不知情的情况下发生变化。如果此处描述的步骤与您在 Salesforce中看到的屏幕不符，您可以使用一般 [SAML 配置步骤](https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#SAML) ，以及 Salesforce 文档。
- 从 2022 年 2 月开始，Tableau Cloud 和 Salesforce 要求使用 Salesforce 进行多重身份验证 (MFA)。
- IdP 中的配置步骤的顺序可能与您在 Tableau Cloud 或 TCM 中看到的顺序不同。

## 步骤 1：在 Tableau Cloud 或 TCM 中配置 SAML

为了配置 Salesforce 应用程序，您将需要使用 Tableau Cloud 或 TCM SAML 设置中的信息。

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

## 步骤 2：在您的 IdP 中配置“Tableau Cloud 应用程序”

若要将服务提供商与您的 Salesforce 组织集成，请使用实现 SAML 2.0 的外部客户端应用。有关详细信息，请参见 Salesforce 帮助中的[配置外部客户端应用的 SAML 2.0 设置和策略](https://help.salesforce.com/s/articleView?id=xcloud.configure_external_client_app_saml.htm&type=5)。

或者，如果您仍然可以使用 Salesforce 已连接应用，您可以按照[配置从 Salesforce 到 Tableau Cloud 的 SSO](https://help.salesforce.com/articleView?id=identity_provider_examples_tableau_online.htm&type=5)（已弃用）中所述的步骤进行操作。

## 步骤 3：将用户添加到启用 SAML 的 Tableau Cloud 站点或 TCM

1. 完成 Salesforce 配置步骤后，返回到 Tableau Cloud 站点或 TCM。
2. 通过选择现有 Tableau Cloud 或 TCM 用户，将您在 Salesforce 应用程序配置文件分配页面中分配的用户添加到 Tableau Cloud 或 TCM 来完成 SAML 配置，或者添加您要批准用于 SAML 的新用户。
    
    在添加或导入用户时，还要指定用户的身份验证类型。在“用户”页面上，可以在添加用户后随时更改用户的身份验证类型。有关详细信息，请参见以下各项之一：
    
    - [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)或适用于 Tableau Cloud 的[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)主题
    - 适用于 TCM 的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题

<!-- document id=d576db19a3990f4ab29db2f7a2857291394616035f050ba7a4f33dd899204dd2 url=/tableau/next/zh-cn/online/to_tabcmd_section.md -->

[跳转到主要内容](#main-content)

# 使用 tabcmd 自动执行任务

使用 tabcmd 命令行实用程序，在 Tableau Cloud 站点上自动执行站点管理任务。例如，可以使用 tabcmd 创建或删除用户、项目和组。此部分中的主题包含有关安装和使用 tabcmd 命令的信息。

## 此部分中的其他文章

<!-- document id=606a663456929da8fe173a01d1777d60e5d1fb8b6a442ed1bad68561bff1ab68 url=/tableau/next/zh-cn/online/web_author_einstein.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Agent 探索您的数据

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

Tableau Agent 是一项生成式 AI 功能，可帮助您在对话助手的帮助下探索数据、创建可视化项并发现见解。连接到工作簿或数据源，并使用自然语言进行可视化分析。结合使用 Tableau Agent 和 Tableau UI 来更快地获得见解。借助 Tableau Agent，盯着空白画布的烦恼已成为过去。

在 Tableau 制作体验中，您可以在工作表中打开 Tableau Agent 对话窗格。Tableau Agent 可以帮助完成以下任务：

- **快速启动分析**：Tableau Agent 可以根据您的数据提出分析问题
- **构建可视化项**：“每位导演拍了多少部动作片？”
- **选择最适合分析的图表类型**：“显示学生成绩的分布”
- **执行时间序列分析**：“与上个月相比，哪个月的捐赠者数量增长最多？”
- **创建计算字段**：“创建一个字段，计算案件开庭日期和结案日期之间的差值，并四舍五入到周数”
- **解释计算**：“解释一下‘实际发货天数’的计算方法”
- **对数据进行筛选和排序**：“只看海水，给我看鱼缸最小的鱼”

Tableau Agent 根据您的数据创建可视化项，就像 Tableau 中的“智能显示”。Tableau Agent 目前支持的图表类型包括：

- 文本
- 热图
- 条形图
- 堆叠条形图
- 折线图
- 双折线图
- 区域
- 甘特图
- 盒形图
- 散点图
- 直方图
- 符号图
- 填充地图
- 树形图
- 饼图
- 靶心图
- 气泡图

有关 Tableau 图表类型的详细信息，请参见[选择适用于您的数据的正确图表类型](https://help.tableau.com/current/pro/desktop/zh-cn/what_chart_example.htm)。

**注意**：若要使用此功能，您必须登录到具有 Tableau+ 的 Tableau Cloud 站点，并且必须在站点设置中启用 Tableau 中的 AI。如果您没有 Tableau+，但想要尝试 Tableau Agent 功能，您可以报名免费试用 Tableau Cloud，现已包含 Tableau Agent 功能。若要开始试用，请填写此[表单](https://www.tableau.com/zh-cn/products/trial)，或联系您的客户经理。有关免费试用版或配置 Tableau 中的 AI 的详细信息，请参见[为您的站点启用 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm)。  
  
从版本 2025.3 开始，如果您登录到启用了 Tableau 中的 AI 的 Tableau Server 站点，您也可以使用 Tableau Agent。有关详细信息，请参见[在 Tableau Server 站点中启用 AI](https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm)。  

## Tableau Agent 和信任

Tableau Cloud 中的 Tableau Agent 建立在 [Einstein 信任层](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust_layer.htm)之上，并继承了其所有安全、治理和信任功能。当您与 Tableau Agent 交互时，发送到大型语言模型 (LLM) 的数据和对话都不会保存到 LLM，并且不会使用任何客户数据来训练模型。

Tableau Agent 仅适用于您的工作簿连接到的数据源。它不知道任何其他 Tableau 数据源，因此无法建议相关内容、回答数据世系问题或回答常识问题。尊重用户定义的行和列级别安全策略。用户在使用 Tableau Agent 时可以访问的数据符合您制定的任何行或列级安全策略。

当您第一次打开 Tableau Agent 时，它会对您的数据进行索引以了解上下文。这有助于 Tableau Agent 根据您的问题和数据源返回相关结果。它建立索引的信息包括字段元数据，例如字段标题、Tableau Desktop 或 Tableau Catalog 中注释（前 150 个字符）中的字段描述、数据角色和数据类型。如果数据类型为字符串（文本），则它还会对多达 1000 个唯一字段值进行采样。

Tableau Agent 使用字段标题或别名，而不是原始字段名称。例如，如果您将“Host”重命名为“Owner”，Tableau Agent 将识别“Owner”，但可能无法识别“Host”。同样，如果为“SessionType1”创建像“Breakout”这样的[别名](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_fieldproperties_aliases_ex1editing.htm) ，它将识别“Breakout”，但不能识别“SessionType”。Tableau Agent 可以索引作为注释包含的字段描述。有关添加注释的详细信息，请参见[为特定字段添加默认注释](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_fieldproperties.htm?#add-default-comments-for-specific-fields)。

Einstein 信任层可用于在将个人身份信息 (PII) 发送到 LLM 之前使用基于模式的数据屏蔽对其进行屏蔽。使用机器学习和模式匹配技术，提示中的 PII 会替换为通用标记，然后在响应中使用原始值解除屏蔽。有关如何配置数据屏蔽的详细信息，请参见 Salesforce 帮助中的[选择要屏蔽的数据](https://help.salesforce.com/s/articleView?id=ai.generative_ai_mask_select.htm&type=5)或[大型语言模型数据屏蔽](https://help.salesforce.com/s/articleView?id=ai.generative_ai_mask_data.htm&type=5)。

为了提供额外的保护，Einstein 信任层保证在 LLM 处理提示和答复之后，LLM 会忘记提示和答复。

如果您在 Tableau Server（版本 2025.3 及更高版本）中使用 Tableau Agent，它不使用 Einstein 信任层。相反，您可以直接连接到大型语言模型提供程序。有关详细信息，请参见 [Tableau 中的 AI 和信任](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm)。

## Tableau Agent 计费注意事项

**注意**：从 2025 年 10 月开始，Tableau 中的 AI 不再消耗 Einstein Request 积分来使用 AI。其他服务（如 Data 360 服务）仍可能消耗其他类型的积分。Data 360 积分包括数据服务积分和 Flex 积分。消耗的积分类型和数量因您为 Salesforce 组织选择的积分模型而异。有关详细信息，请参见 Salesforce 帮助中心中的 [Einstein Request & Flex Credit Rate Card Updates 常见问题解答](https://help.salesforce.com/s/articleView?id=005197697&type=1)和[审计和反馈的计费注意事项](https://help.salesforce.com/s/articleView?id=ai.generative_ai_audit_feedback_usage_types.htm&type=5) 。

当您在 Tableau Cloud 中使用 Tableau 中的生成式 AI 功能时，如果您使用 Einstein 数据收集和存储（也称为审计跟踪）功能作为 Tableau 中的 AI 设置的一部分，它可能会消耗 Data 360 积分。有关详细信息，请参见 [Tableau 中的 AI 应用](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_usage.htm)。

您可以使用预先构建的仪表板和数字钱包在 Salesforce 组织中查看您的积分消耗情况，或者从 Tableau 连接到您的 Data 360 数据并使用数字钱包表中的数据构建可视化项。有关详细信息，请参见[“查看积分消耗情况”](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_usage_view.htm)。

## Tableau Agent 入门指南

**注意**：如果您使用的是 Salesforce Government Cloud 组织，则不支持 Tableau Agent。

当为您的站点启用 Tableau 中的 AI 时，可通过 Web 制作环境中的对话窗格使用 Tableau Agent。在 Tableau Cloud 中，您可以选择为单个用户组或站点上的所有用户启用它。有关详细信息，请参见[配置 Tableau 中的 AI](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm#configure-ai-in-tableau)。

在以下位置使用 Tableau Agent：

- Tableau Cloud（需要 Tableau+）
- Tableau Server（版本 2025.3 及更高版本）
- Tableau Desktop（版本 2025.1 及更高版本）- 登录到启用了 Tableau 中的 AI 的 Tableau Cloud 或 Tableau Server 站点进行 Web 制作时

在 Tableau Cloud 中，您还必须具有 Creator 或 Explorer 站点角色才能使用此功能。

Tableau Agent 目前也已在测试版中面向仪表板开放可用。此功能使 Tableau Agent 能够：

- 查看您的仪表板并快速提供摘要，告诉仪表板使用者该仪表板的相关内容
- 基于仪表板中的图表创建见解
- 让您通过使用自然语言提出问题来更深入地了解数据
    
    有关详细信息，请参见[仪表板中的 Tableau Agent（测试版）](https://help.tableau.com/current/pro/zh-cn/dashboard_narratives_overview.htm)。

从版本 2025.1 开始，Tableau Agent 支持英语 (en\_US) 和其他一些语言。如果您的 Cloud 站点、Server 站点，或 Tableau Desktop 应用程序设置为不受支持的语言，则 Tableau Agent 响应将采用英语 (en\_US)。有关受支持语言的详细信息，请参见 [Tableau 中的 AI 支持的语言和区域设置](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm#supported_language)。

首先创建一个新的工作簿或打开一个现有的工作簿。对于新的工作簿，首先要连接到数据。为了最快获得结果，我们建议将 Tableau Agent 与数据提取一起使用。但是，您也可以将 Tableau Agent 与实时数据库连接一起使用，并上载以下文件类型的文件：

- .hyper
- .csv
- .txt
- .xlsx

Tableau Agent 不支持多维数据集。此外，如果您使用数据混合，Tableau Agent 只能与主数据源一起使用。

### 启动 Tableau Agent

若要打开 Tableau Agent 对话窗格，请执行以下操作：

1. 选择工具栏中“智能显示”旁边的 Tableau Agent 图标。
    
    ![突出显示了 Tableau Agent 按钮的空白 Tableau 工作表](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_icon_webauth.png)
2. 窗格打开后，选择“知道了”确认免责声明并开始使用。
    
    ![一个空白工作表，打开了 Tableau Agent 对话窗格，显示免责声明文本和“知道了”按钮](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_gotit.png)

### 构建和更改可视化项

Tableau Agent 不是一个开放式的聊天机器人。它只能在您的数据集内工作，并围绕分析和可视化项创建执行一组特定的操作。为了了解您的数据，Tableau Agent 首先对您所连接的数据集进行索引。如果您连接到多个数据集，它将使用“数据”窗格中显示的选定数据集。Tableau Agent 仅适用于数据混合中的主要数据源。

**注意**：如果您在 Tableau Agent 处理请求时切换到其他数据源，则可能会导致错误。等待 Tableau Agent 响应后再更改数据源；然后使用该数据源发出新请求。

索引操作会扫描字段名称、数据类型（例如日期、文本或数字字段），并对 1000 个唯一字段值进行采样，以了解该字段中的数据类型。当发生更改（例如重命名字段或创建新的计算字段）时，会定期重新编制索引。

索引完成后，Tableau Agent 会提供一些建议问题，您可以询问有关数据的问题以帮助您入门，或者使用自然语言在文本框中输入您自己的问题来描述您想要的内容。

![展示由 Tableau Agent 构建的可视化项的工作表。对话窗格已打开并显示突出显示的问题。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_web_auth_questions.png)

在 Tableau Agent 创建可视化项后，您可以进行交互并对其进行修改，就像分析师构建并与您共享可视化项一样。通过 Tableau Agent 询问更多问题，以进一步迭代和探索您的数据，使用“建议”来获得更多关于您可以提问的问题的想法，或者直接在 Tableau 界面中掌控全局并继续自己的分析。

如果 Tableau Agent 创建的可视化项不符合您的预期，您可以通过在文本框中输入所需内容来提供其他信息，或者尝试选择“使用 Einstein 重试”![带有弯曲箭头的按钮用于重新生成建议的问题](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_retry_button.png)，Tableau Agentn 将再次查询 LLM 并对您的请求提供新的响应。

### 使用建议快速开始分析

无论您面对的是一张空白画布还是进行更深入的分析，Tableau Agent 都可以通过提出问题来帮助您更深入地挖掘数据。在开始之前，请选择“建议”按钮，Tableau Agent 将根据您的数据源创建三个您可能会问的问题。若要查看更多问题，请选择“使用 Tableau Agent 重试”![带有弯曲箭头的按钮用于重新生成建议的问题](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_retry_button.png)。

选择一个问题，Tableau Agent 就会为您创建相应的可视化项。

![一个空白画布，其中打开了 Tableau Agent 窗格，显示“建议”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_blank_slate.png)

与 Tableau Agent 创建的可视化项进行交互时使用建议来更深入地进行分析。

此外，从版本 2025.1 开始，当您使用 Tableau Agent 创建或修改计算并接受该计算时，Tableau Agent 会提供有关如何在分析中使用该计算的建议。

在 Tableau Agent 的确认回复底部，选择“建议”按钮，Tableau Agent 将建议您可以采取一些措施来发现有关数据的更多见解。当您执行此操作时， “建议”按钮将转换为“重新创建”按钮，以便您可以返回并重新创建上一个可视化项（如果需要）。

只需选择一个选项即可将建议的操作应用于您的可视化项。如果您不喜欢这些建议，只需选择“使用 Tableau Agent 重试”![带有弯曲箭头的按钮用于重新生成建议的问题](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_retry_button.png)查看更多选项。

![打开了 Tableau Agent 窗格的可视化项，显示了后续分析步骤的建议。 ](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_viz_suggestions.png)

### 创建计算

在 Tableau 中构建计算有时会很棘手。如果您是 Tableau 新手，您可能不知道应使用正确的语法或如何正确格式化您的计算。Tableau Agent 可以为您完成繁重的工作，让您保持分析的流畅。

只需让 Tableau Agent 帮助您使用自然语言创建计算来描述您想要做的事情。Tableau Agent 可以执行以下操作：

- 打开计算编辑器
- 添加建议的语法
- 命名计算
- 在 Tableau Agent 窗格中提供计算的解释，以帮助您评估其准确性并提高熟练程度

检查计算，根据需要进行编辑并接受。Tableau Agent 将新的计算字段添加到“数据”窗格，可供您在分析中使用。

有两种方法可以寻求计算帮助：

1. **在对话窗格中**：在对话流程中，请 Tableau Agent 为您进行计算。只需使用自然语言描述您的计算，Tableau Agent 就会完成剩下的工作。
    
    ![带有条形图和计算编辑器对话框的工作表已打开，其中显示了由 Tableau Agent 创建的计算。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_calc.png)
2. **在计算编辑器中**：打开计算编辑器并选择 Tableau Agent ![Tableau Agent 图标](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_desktop_agent_icon.png) 图标。如果对话窗格尚未打开，此操作会将其打开。如果对话窗格已打开，只需在文本框中输入您的计算描述，Tableau Agent 就会将建议的语法直接添加到打开的计算编辑器中。
    
    ![“计算编辑器”对话框，其中突出显示了 Einstein 图标](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_calc_editor.png)

#### 创建计算的提示

当要求 Tableau Agent 帮助您进行计算时，为了获得最佳结果，请具体说明。当您的目标是让 Tableau Agent 为您编写计算时，请使用该特定语言。例如，“创建一个计算...”，“编写一个计算...”，“创建一个计算字段...”，或者只是“计算...”

避免太过笼统也很重要。例如，不要说“找出我最赚钱的产品”，而是尝试“根据产品名称计算利润率”。

这有助于 Tableau Agent 理解您的意图（创建计算）以及您想要计算的字段的含义。

#### 计算描述

理解计算的作用与创建计算本身一样重要。Tableau Agent 可帮助完成该操作。

无论是 Tableau Agent 为您创建的计算，还是作为数据集的一部分存在的计算，您都可以要求 Tableau Agent 解释该计算。例如，“解释订单和发货之间的工作日计算。”

这不仅可以帮助您验证计算是否符合您的需要，还可以帮助您熟练地在 Tableau 分析中使用计算字段。

![显示计算描述的 Tableau Agent 对话窗格。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_calc_description_extended.png)

#### 编辑计算

您可以随时编辑 Tableau Agent 为您创建的任何计算。您可以手动编辑计算，也可以让 Tableau Agent 帮助您。

若要编辑计算，请执行以下操作：

1. 在对话窗格中，找到要编辑的计算。
2. 单击“Edit”（编辑）。
3. 在计算编辑器中手动进行更改，然后单击“确定”，或者在 Tableau Agent 对话窗格中描述您想要进行的更改，然后让 Tableau Agent 为您进行更改。
    
    ![显示条形图的可视化项，其中打开了计算编辑器和 Tableau Agent 对话窗格。在对话窗格中，“编辑”按钮突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_calc_edit.png)

若要让 Tableau Agent 更新“数据” 窗格中的现有计算，请先在“计算编辑器”中打开计算。

1. 在“数据”窗格中右键单击按住 Cmd 单击 (MacOS) 字段。
2. 选择“编辑…”
3. 在计算编辑器中手动进行更改，然后单击“确定”，或者在 Tableau Agent 对话窗格中描述您想要进行的更改，然后让 Tableau Agent 为您进行更改。

#### 计算限制

使用 Tableau Agent 创建计算时，以下功能尚不受支持：

- 在创建计算时，Tableau Agent 还不能提出澄清问题。您可能需要具体说明或进行迭代，例如，如果有多个字段的名称中包含“name”一词，则指定“将字段 FIRST NAME 更改为正确的大小写”。
- 可用的计算可能因连接类型而异。例如，某些日期函数（例如 [DATEPARSE](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_date.htm#dateparse)）仅受数据提取和一部分可能的连接器支持。
    
    如果您的请求涉及实时数据连接不支持的函数，Tableau Agent 可能会为您创建计算，但计算将处于错误状态。若要使用计算，您首先需要提取数据源。在某些情况下您可以请求替代函数，例如使用 DATE 而不是 DATEPARSE。有关这些替代项的详细信息，请参见[函数文档](https://help.tableau.com/current/pro/desktop/zh-cn/functions_all_categories.htm)。
- Tableau Agent 无法创建计算，然后自动在可视化项中使用它。相反，这是一个两步过程。请求计算并将其添加到“数据”窗格;然后请求可视化项并按名称引用新的计算字段。

### 使用筛选器

您可以要求 Tableau Agent 使用自然语言筛选您的可视化项。虽然 Tableau Agent 会尽力理解您的请求并返回解决方案，但有时它可能需要您的帮助才能返回您想要的答复。例如，如果您有高基数字段，即具有很多值的字段，Tableau Agent 可能会要求您选择所需的值。

在这种情况下，您可以在 Tableau Agent 窗格中选择“添加筛选器”，Tableau Agent 会为您打开“筛选器”对话框。只需选择所需的值并选择“确定”即可将筛选器添加到可视化项。

![带有 Tableau Agent 窗格的可视化项画布，描述如何添加筛选器和打开筛选器对话框。](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_filter.png)

### 对话历史记录和可视化项重新创建

您可以在对话窗格中与 Tableau Agent 进行交互。该窗格是 Tableau Agent 提供分析建议并维护该会话的对话历史记录的地方。如果您提出新问题，可视化项本身会更新，但对话窗格会保留您的所有请求和 Tableau Agent 的回复的历史记录。

它还具有交互元素，例如“使用 Tableau Agent 重试”![带有弯曲箭头的按钮用于重新生成建议的问题](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_einstein_retry_button.png) 要求 Tableau Agent 使用相同请求再次查询 LLM 并创建可视化项的另一个版本，或者“重新创建” ![“重新创建”按钮](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_recreate_button.png)返回返回到之前的可视化项而不查询 LLM，保持相同的结果。

如果您在同一会话中关闭并重新打开对话窗格，您的对话历史记录将会保留。如果您关闭工作簿，这将清除与 Tableau Agent 的对话。对话历史记录未保存，并且不会在您下次打开已发布或已保存的工作簿时出现。

Tableau Agent 是一种基于每张工作表的体验。您无法了解工作簿中的其他工作表，并且无法在工作表之间共享对话。如果您切换到新的工作表，这将开始新的对话。

如果您想让 Tableau Agent 忘记您迄今为止所做事情的背景，请开始一个新工作表，这样对话窗格中就没有历史记录。

## 从 Tableau Agent 获得最佳结果的技巧

Tableau Agent 尽力理解您的意图和数据。但它仍在学习中。使用以下技巧可以帮助 Tableau Agent 发挥最佳作用并为您提供出色的结果。

<table style="width: 100%;" class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><th>技巧</th><th>问题</th><th>要执行的操作</th></tr><tr><td><b>使用整洁的数据</b></td><td>杂乱的数据很难分析，而且 Tableau Agent 不知道如何为您清理和准备数据。</td><td><ul><li><p>使用<a href="https://help.tableau.com/current/pro/desktop/zh-cn/datasource_recommended.htm" target="_blank">已认证数据源</a>。数据质量越好，Tableau Agent 返回的结果就越好。</p></li><li><p>在分析之前清理并准备杂乱的数据。</p></li><li><p>确保字段名称具有描述性且唯一。</p></li></ul></td></tr><tr><td><b>隐藏不相关的字段</b></td><td>数据集中类似命名的字段可能会让 Tableau Agent 感到困惑。</td><td>隐藏您不需要的字段，Tableau Agent 将不会使用这些隐藏字段。</td></tr><tr><td><b>谨慎使用同义词</b></td><td>Tableau Agent 对于常见同义词的理解做得很好。例如，它知道“片名”和“影片”可以应用于名为“电影”的领域。但是，它不知道您可能使用的任何公司特定术语或缩写。</td><td>参考您感兴趣的特定字段，以帮助 Tableau Agent 更加准确。</td></tr><tr><td><b>明确您的意图</b></td><td>Tableau Agent 会尽力推断您的意图，但可能并不总是正确的。</td><td>如果您知道您想要 Tableau Agent 生成可视化项，请在请求中使用诸如“向我展示”、“创建可视化项”、“构建条形图”之类的线索。或者，如果您希望 Tableau Agent 创建一个计算，请尝试以短语“创建一个计算...”作为您的请求的开头</td></tr><tr><td><b>指定如何评估“顶级”</b></td><td>诸如“顶级产品”、“最佳销售人员”、“最高季度”之类的请求对于 Tableau Agent 来说可能会很模糊，它可能不知道如何评估什么是“顶级”、“最佳”或“最高”。</td><td>说明如何衡量和显示“排名靠前”。例如，尝试让 Tableau Agent 向您展示“按利润排名前 10 的产品”或“按销量排名前 3 的产品”。</td></tr><tr><td><b>在请求中使用特定术语</b></td><td>Tableau Agent 可以扫描您的数据源以查找字段名称和这些字段中的数据，但它无法像人类一样真正理解数据。</td><td>您的请求描述得越详细，Tableau Agent 提供相关的可视化项的能力就越强。如果您知道应该使用 MEDIAN 而不是 AVERAGE 聚合来评估您的数据，请指定该聚合。</td></tr><tr><td><b>分解复杂任务</b></td><td>Tableau Agent 无法更新数据模型并作为单个步骤的一部分生成可视化项。</td><td><p>将任务分解成几个部分并进行迭代。例如：</p><ul><li><p>&lt;任务 1&gt;“创建一个名为利润的计算”</p></li><li><p>&lt;任务 2&gt;“向我展示利润随时间如何变化”</p></li></ul></td></tr><tr><td><b>只询问有关您的数据的问题</b></td><td>Tableau Agent 并不是一个通用的聊天机器人。它无法回答诸如“我应该如何分析我的数据？”之类的咨询问题，也无法回答诸如“哪种猫最适合做宠物？”之类的一般性问题。</td><td>提出针对分析数据的问题，并迭代和深入挖掘可视化项结果。</td></tr></tbody></table>

## 实现人机回环

与所有 AI 一样，回顾使用 Tableau Agent 时获得的结果非常重要。当您提出问题时，Tableau Agent 会尽力理解您的数据和意图，但它可能并不总是正确的。

例如，Tableau Agent 尝试为日期粒度（如年、月或日）或聚合（如中位数或平均值）选择默认值。如果您知道您想要的聚合，最好在请求中指定它。

如果 Tableau Agent 弄错了，您可以重新陈述您的请求并阐明您想要什么，也可以直接与可视化项进行交互。毕竟，您处于标准制作环境中，可以访问 Tableau 的所有功能。

您还可以随时通过每个 Tableau Agent 回复中显示的“赞成”或“反对”按钮对结果提供反馈。

![突出显示了反馈按钮的 Einstein Copilot 对话窗格](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_feedback1.png)

如果您单击“反对”选项，请提供其他反馈以帮助改善 Tableau Agent 回复。

![显示 Einstein Copilot 反馈选项的对话框](/tableau/next/zh-cn/online/zh-cn/Img/tab_gai_feedback2.png)

## Tableau Agent 限制

Tableau 为人类分析师提供了强大的工具，Tableau Agent 也不例外。Tableau 中的 AI 并非旨在取代分析师和数据探索者；它只是为您提供助力。您的参与对于这一过程至关重要。

### 分析的类型

Tableau Agent 还不能处理诸如“我应该如何分析我的数据？”或“这些数据有季节性吗？”之类的咨询性问题。相反，您需要指定您想要看到的内容，例如“我的销售额在一段时间内是多少？”

### 不支持的功能

Tableau Agent 暂时还无法使用 Tableau 的所有制作功能。目前，如果您连接到在站点设置中启用了 Tableau+ 和 Tableau 中的 AI 的 Tableau Cloud 站点，或者连接到启用了 Tableau 中的 AI 的 Tableau Server 站点（版本 2025.3 及更高版本），则可以在 Web 制作和 Tableau Desktop（从版本 2025.1 开始）中使用。

Tableau Agent 目前无法实现的功能包括：

- 为您选择数据源或进行数据建模（例如创建联接或关系）
- 更改数据类型、字段角色或标题名称
- 设置可视化项的格式。例如，向“标记”卡属性添加字段。例如详细信息或工具提示。
- 添加参考线
- 使用组、集或参数来组织或自定义字段
- 使用筛选器控件、参数和操作等元素创建交互性
- 构建仪表板
- 分析大型数据集。如果您的数据集中有数百或数千个字段，尤其是当它们的名称相似时，Tableau Agent 将无法正常工作。如果您尝试筛选高基数的字段（单个字段有许多不同的值），Tableau Agent 可能需要您手动执行筛选操作。
- 块索引在数据模型更改后刷新
- 支持所有语言。Tableau Agent 支持英语 (en\_US) 和其他一些语言。如果您的数据源字段名称和值与您的用户语言设置不同或与您与 Agent 交互的语言不同，请在您的请求中使用准确的字段名称和值。有关 Tableau Agent 当前支持的语言的信息，请参见 [Tableau 中的 AI 支持的语言和区域设置](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm#supported_language)。

## 此部分中的其他文章

<!-- document id=747632e790609b6fe53e90e5aaa71c7399aefc696f98a738011f506df6a8c80d url=/tableau/next/zh-cn/online/data_fresh_sync_section.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Bridge

## 入门指南

![Bridge 入门指南](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Bridge_big.png)

- [使用 Bridge 使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm)
- [安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)
- [设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)
- [连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)
- [Tableau Bridge 常见问题解答](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_faq.htm)

## 站点管理员快速参考

![站点管理员快速参考](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_InstallConfigure_big.png)

- [关于 Bridge 客户端](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm)
- [配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)
- [管理池](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_manage.htm)
- [更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm)

## 发布者快速参考

![发布者快速参考](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_RefreshData_big.png)

- [发布包含实时连接的私有网络数据源](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_livequery.htm)
- [通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm)
- [管理 Tableau Bridge 的通知](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_alerts.htm)
- [排查私有网络问题](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm)

## 企业

![Enterprise Bridge](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_Deploy_big.png)

- [计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)
- [Data Connect 和 Tableau Bridge 的最佳实践](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)
- [监视 Bridge 数据提取活动](https://help.tableau.com/current/online/zh-cn/adminview_bridge_extract.htm)
- [监视到 Bridge 连接数据源的流量](https://help.tableau.com/current/online/zh-cn/adminview_bridge_datasources.htm)
- [监视 Bridge 刷新作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm#bridge)

## 连接

![与 Bridge 的连接](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ConnectToData_big.png)

- [与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)
- [更新 Bridge 连接信息](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm)

## 安全性

![发布者快速参考](/tableau/next/zh-cn/online/zh-cn/Img/Help_Spot_ManageData_big.png)

- [Bridge 安全性](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_security.htm)

## 此部分中的其他文章

<!-- document id=79732117a41a86eae14862bd17643d215652e9f489ffd27129c6994280f50900 url=/tableau/next/zh-cn/online/cloud_manager_intro.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Cloud Manager

Tableau Cloud Manager (TCM) 为管理员提供了一个集中管理界面，用于监督其组织的 Tableau Cloud 站点。通过 TCM，云管理员可以从一个位置创建和编辑站点、管理用户以及监控多个站点的许可证消耗情况。TCM 中所做的任何更改都将应用于顶层或租户，然后在所有相关站点之间共享，从而确保简化的管理和治理。

有关 Tableau Cloud Manager REST API 功能的信息，请参见 [Tableau Cloud Manager REST API](https://help.tableau.com/current/api/cloud-manager/zh-cn/index.html)。

云管理员是唯一有权访问 Tableau Cloud Manager 的用户，该角色是在 TCM 中明确分配的。虽然大多数云管理员通常访问单个 TCM 租户，但您的组织结构可能允许访问多个租户。

现在我们已经讨论了 TCM 的功能，让我们探索一下它在 Tableau Cloud 中管理的概念。

## 了解 Tableau Cloud 中的租户和站点管理

在进入 Tableau Cloud Manager (TCM) 之前，了解租户和站点的概念以了解 Tableau Cloud 的管理结构非常重要。

**租户：**Tableau Cloud 中的租户是包含您组织的 Tableau Cloud 部署的顶级管理层。将租户视为包含所有站点、用户和许可证的容器。云管理员通过 TCM 在此级别进行操作，确保对 Tableau Cloud 的集中控制。在这种结构中，TCM 作为集中位置来配置多个站点的更改，例如添加或删除用户和许可证管理。

**站点：**相比之下，站点属于租户，可以被视为特定团队、部门或项目的工作区或专用环境。每个站点都有自己的一套内容、用户和权限，由站点管理员进行管理。虽然站点管理员可以控制其各个站点，包括管理工作簿、数据源和用户访问，但他们在租户级别设置的限制范围内操作。站点为协作和分析提供了一个集中区域，但不公开租户的管理功能。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_tenant_sites.png)

总而言之，租户是包含所有站点的管理层，站点是团队可以独立工作的封闭环境。这种结构允许在租户级别进行集中控制并在站点级别进行灵活管理，使组织能够高效、安全地扩展对 Tableau Cloud 的使用。

## 此部分中的其他文章

<!-- document id=ce5020ec8c5f94a6d02e2579b3a1b8cb4943695ed29d8f16d5e3832fad4975e9 url=/tableau/next/zh-cn/online/cloud_manager_users.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Cloud Manager 管理用户

访问 Tableau Cloud 的任何人（无论是浏览、发布、编辑内容还是执行管理任务）都必须作为用户添加。云管理员可以通过以下选项添加用户：

- 单独输入用户的电子邮件地址
- 通过您使用[CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)创建的 CSV 文件导入用户

## 如何在 Tableau Cloud 中管理用户

在 Tableau Cloud 中，用户管理通过两个不同的页面进行处理：“云用户”页面和“站点用户”页面。只有 Tableau Cloud Manager (TCM) 中的云管理员才能访问“云用户”页面，该页面是将用户分配到多个站点以及从 Tableau Cloud 中移除用户的中心位置。同时，站点管理员可以使用“站点用户”页面，以管理其特定站点内的用户。

**注意：**只有在用户未拥有任何内容（项目、工作簿、视图或数据源）的情况下，您才能移除该用户。有关详细信息，请参见[从 Tableau Cloud 中移除用户](#remove-users)。

使用 TCM，可以在租户级别添加用户，然后根据需要将其分配到适当的站点。通过 TCM 添加用户可以改善入职流程，减少站点管理员的管理负担，使他们能够更加专注于特定站点的管理任务。作为云管理员，您还可以随时修改用户的站点成员身份和角色。有关详细信息，请参见[管理用户的站点成员身份](#manage-site-membership)。

## 将用户添加到 Tableau Cloud Manager

您可以通过上载包含用户信息的 CSV 文件将用户单独或批量添加到 Tableau Cloud Manager (TCM)。

### 单独添加用户

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航至“用户”页面，然后选择“添加用户”\>“通过电子邮件添加用户”。
3. 填写“添加用户”对话框中的字段：
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_users_add.png)
    
    1. **电子邮件地址：**用户的电子邮件地址。
    2. **（可选）用户是云管理员：**选择是否将用户添加为云管理员。默认情况下，云管理员登录 TCM 时使用带有 MFA 的 Tableau 进行身份验证。如果配置了外部身份验证方法，请从下拉菜单中选择替代身份验证类型。
    3. **站点：**选择要添加用户的一个或多个站点。
    4. **站点角色：** 在每个选定站点上为用户分配一个站点角色。有关站点角色和能力的详细信息es，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。
    5. **站点身份验证：**为用户选择一种身份验证方法。默认的身份验证方法是带有 MFA（多重身份验证）的 Tableau。如果站点管理员配置了多种身份验证方法，请从下拉菜单中选择替代身份验证类型。
4. 单击“添加用户”。系统将向用户发送一封电子邮件，其中包含登录 Tableau Cloud 的后续步骤。

如果新用户的电子邮件地址已经与 tableau.com 上的帐户关联，则此用户需要使用此帐户的现有电子邮件地址和密码登录。

如果新用户的电子邮件地址未与 tableau.com 上的帐户关联，则此用户需要提供姓名和密码。

### 批量导入用户

若要自动完成添加用户的过程，您可以创建一个包含用户信息的 CSV 文件，然后将该文件导入 Tableau Cloud Manager (TCM)。导入 CSV 文件时，您可以指定用户的站点成员身份、站点角色和身份验证类型。以下列和值为 TCM 独有：

- **站点 URI：**站点的统一资源标识符。若要将用户导入为云管理员，请包含站点 URI 列并将其留空。
- **管理员级别：**若要添加用户作为云管理员，请将值设置为 `Cloud`。
- **身份验证类型：**访问站点或 TCM 的用户身份验证类型。

**注意：**本部分包含导入步骤，并且假定您已创建了该 CSV 文件。如果您尚未创建该文件，请参见 [CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)，以查看文件格式要求和导入选项的列表。导入到 TCM 时，请确保 CSV 文件为 UTF-8 格式，不含字节顺序标记 (BOM)。

若要从 CSV 文件添加或修改用户，请按照以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航至“用户”页面，然后选择“添加用户”\>“从文件导入用户”。
3. 若要上载文件，请将 CSV 文件拖到对话框中，或单击“选择文件”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_users_import.png)
4. 单击“导入用户”。

> [!IMPORTANT]
> 
> **重要信息：**导入具有不同站点角色的 CSV 文件会自动将现有用户更新为指定的角色，即使这些角色的限制更严格。此变化影响所有用户，包括云管理员。

## 管理用户的站点成员身份

站点成员身份是指分配给租户中每个用户的站点和角色。云管理员可以随时修改用户的站点成员身份，例如授予对其他站点的访问权限或更改其指定的站点角色和身份验证。对用户的所有更改均在站点成员身份对话框中执行，然后在站点之间共享。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_users_site_membership.png)

若要修改站点成员身份，请按照下列步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航至“用户” 页面并选择要修改的用户。
    
    **注意：**您一次最多可以选择 50 个用户。若要修改超过 50 个用户，请导入包含所需更改的 CSV 文件。有关批量修改用户的详细信息，请参见[批量导入用户](#bulk-import-users)。
3. 选择“操作”\>“站点成员身份”。
4. 在对话框中，修改用户的站点成员身份，包括他们的站点角色和身份验证方法。
    
    修改多个用户的站点成员身份时，“站点角色”和“站点身份验证”下拉菜单会在用户在站点上被分配不同的值时显示“多个值”。从列表中选择一个新值会将相同的值分配给选定的用户。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_users_site_membership_multiple_values.png)
5. 单击“保存”。

### 分配或移除云管理员权限

Tableau Cloud Manager (TCM) 中最多可以拥有 100 名云管理员。若要分配或移除云管理员角色，请在修改站点成员身份时选中“用户是云管理员”复选框。当用户被分配云管理员权限时，他们可以访问 TCM Web 界面和 Tableau Cloud Manager REST API。

**注意：**如果已为 TCM 身份验证配置了除带 MFA 的 Tableau 之外的身份验证类型，则 TCM 在添加新 Tableau Cloud 管理员时将默认使用非默认身份验证类型。可以随时通过上图所示的“站点成员身份”对话框中的“Tableau Cloud Manager 的身份验证”下拉菜单更改此设置。

## 从 Tableau Cloud 中移除用户

只有在用户未拥有任何内容（项目、工作簿、视图或数据源）的情况下，您才能移除该用户。如果尝试移除拥有内容的用户，则会将用户站点角色设置为“未许可”，但不会从 Tableau Cloud Manager 中移除用户。

如果用户属于多个站点并拥有其中任何站点的内容，则会从用户未拥有内容的站点中将用户移除。用户将仍然是他们拥有内容的站点上的成员，但被降级为“未许可”站点角色。

若要从 Tableau Cloud 中移除用户，请执行以下步骤：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航至“用户”页面，并选择一个或多个要移除的用户。
    
    **注意：**您一次最多可以选择 50 个用户。若要修改超过 50 个用户，请导入包含所需更改的 CSV 文件。有关批量修改用户的详细信息，请参见[批量导入用户](#bulk-import-users)。
3. 选择“操作”\>“移除”。
4. 在确认对话框中，选择“移除用户”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_users_remove.png)

<!-- document id=449d8cf3ab0194479ea657adbdf454b9ae15ce9fa3518f74968f92109e648a8e url=/tableau/next/zh-cn/online/cmt-using.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Content Migration Tool

以下步骤旨在引导您完成使用 Tableau Content Migration Tool 的过程：

- [迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm)
    - [迁移计划：站点](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_servers.htm)
    - [迁移计划：源项目](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_source_projects.htm)
    - [迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)
    - [迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)
    - [迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)
    - [迁移计划：迁移脚本](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_scripts.htm)
    - [迁移计划：计划选项](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_options.htm)
- [使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)

<!-- document id=e6a0151d84fd2d5a1929d89f77e62ccec980ca557b9112411b89ee8bab973437 url=/tableau/next/zh-cn/online/cmt-deployment_console_runner.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Content Migration Tool 控制台运行程序

Tableau Content Migration Tool 包括一个用于运行迁移的命令行实用工具 `tabcmt-runner.exe`（位于安装文件夹中）。默认安装文件夹为 `%PROGRAMFILES%\Tableau\Tableau Content Migration Tool`。

**注意：**`tabcmt-runner.exe` 实用工具与 `tabcmt.cmd` 命令行实用工具不同，后者用于配置 Content Migration Tool 图形应用程序。有关 `tabcmt.cmd` 的详细信息，请参见[使用 Tableau Content Migration Tool 命令行界面](https://help.tableau.com/v0.0/online/zh-cn/cmt-command_line.htm)。

用法：

- tabcmt-runner \[选项\] <plan\_file.tcmx>
- tabcmt-runner license --remove
- tabcmt-runner license <新许可证密钥>
- tabcmt-runner license <许可证文件路径> \[--passphrase=<许可证文件密码>\]
- tabcmt-runner encryption --reset
- tabcmt-runner encryption <新密钥>
- tabcmt-runner improvement \[on|off\]
- tabcmt-runner --help
- tabcmt-runner --version
- tabcmt-runner script-warning \[on|off\]

选项：

- \--version
- \--help
- \--quiet
- \--info
- \--logfile=值
- \--src-user=值
- \--src-password=值
- \--dest-user=值
- \--dest-password=值
- \--https=值
- \--allow-scripts

## 运行计划

立即执行迁移计划。

tabcmt-runner \[options\] <plan file>

### 可用选项：

- `--logfile=<file name>` 设置日志输出的文件名
- `--https=<secure|legacy>` 设置 HTTPS 模式
- `--quiet` 禁止记录到 stdout
- `--src-user=<username>` 设置源连接的用户名
- `--src-password=<password>` 设置源连接的密码
- `--dest-user=<username>` 设置目标连接的用户名
- `--dest-password=<password>` 设置目标连接的密码

### 退出代码：

- 0 表示迁移成功。
- 1 表示迁移已成功，但记录了警告消息。
- 2 表示迁移失败。特定错误将包括在日志输出中。

## 显示计划摘要

显示迁移计划的摘要，然后退出。

tabcmt-runner --info <plan file>

### help

显示命令行实用工具的用法信息。

tabcmt-runner --help

### version

显示当前应用程序版本信息。

tabcmt-runner --version

### encryption

重置加密密钥或指定新密钥。您必须在使用 `tabcmt-runner` 实用工具之前指定加密密钥，即使您已经通过 Content Migration Tool UI 这样做了也是如此。

tabcmt-runner encryption <new\_key> | --reset

### improvement

默认值：`on`

允许或禁止应用程序收集匿名使用情况信息。此信息完全匿名，并且会定期发送到 Tableau 来帮助我们改进 Content Migration Tool。

#### 示例

显示改进计划是处于启用还要禁用状态：

tabcmt-runner improvement

启用或禁用改进计划：

tabcmt-runner improvement <on|off>

### license

2022 年 7 月已弃用。

此命令仅适用于旧版许可证。管理当前用户的旧版应用程序许可证。使用旧版密钥时，若要使用 `tabcmt-runner` 实用工具，您必须使用此命令激活许可证，即使您已经通过 Content Migration Tool UI 激活了许可证也是如此。

#### 示例

显示当前许可证信息：

tabcmt-runner license

设置/激活系列密钥或脱机许可证密钥：

tabcmt-runner license <key>

移除/停用当前许可证：

tabcmt-runner license --remove

使用许可证文件设置/激活：

tabcmt-runner license <file path> \[--passphrase=<password>\]

### script-warning

默认值：`on`

运行包含迁移脚本的迁移计划时显示警告消息。

**注意：**此命令会更新您在“设置”页面上的选择。有关详细信息，请参见[Tableau Content Migration Tool 设置](https://help.tableau.com/v0.0/online/zh-cn/cmt-settings.htm)。

#### 示例

显示脚本警告是打开还是关闭。

tabcmd-runner script-warning

打开或关闭脚本警告

tabcmd-runner script-warning <on|off>

如果打开，您必须包括 `--allow-scripts` 选项以执行迁移计划。

tabcmd-runner --allow-scripts <plan file>

## 谁可以执行此操作

为了使用控制台运行程序，您必须具有以下所有各项：

- Content Migration Tool 计算机上的管理员权限。
- 具有 Explorer 角色或更高级别角色的 Tableau 站点用户帐户。
- 源站点上的“查看和下载工作簿”/“保存副本”权限。
- 目标站点的“发布”权限。

## 此部分中的其他文章

<!-- document id=f34745b9188c694b0593fa0bdb84d2f068fc12db7ad772e3b43e895cd85b2d38 url=/tableau/next/zh-cn/online/pulse_create_metrics.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Pulse 创建指标

Tableau Pulse 根据您定义的指标提供有关数据的见解。创建指标后，您可以将组织成员添加为关注者，他们将收到有关其数据的定期电子邮件或 Slack 摘要。该摘要显示趋势、异常值和其他变化，让关注者随时了解与其工作相关的最新数据。若要了解有关数据的更多信息，这些用户可以调查 Tableau Cloud 上的指标，并了解不同因素如何影响数据变化。这些见解为他们提供了做出数据驱动决策所需的信息，而不要求他们在 Tableau 中进行复杂的分析。

![Pulse 主页](/tableau/next/zh-cn/online/zh-cn/Img/pulse_home.png)

## 指标定义和指标

Tableau Pulse 中的每个指标背后都有一个指标定义。查看者与指标互动。指标定义指定这些指标的核心元数据。

![定义和指标之间的父子关系](/tableau/next/zh-cn/online/zh-cn/Img/pulse_metric_definition_diagram.png)

**指标定义**是一组元数据，充当基于它们的所有指标的单一事实来源。由具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色的用户定义。下表提供了指标定义捕获的元数据的示例。

<table class="table--plain"><caption>超市销售额的指标定义</caption><tbody><tr><th>定义字段</th><th>示例值</th></tr><tr><td>名称</td><td>超市销售额</td></tr><tr><td>度量和聚合</td><td>销售总额</td></tr><tr><td>时间维度</td><td>订购日期</td></tr><tr><td>相比</td><td>去年</td></tr><tr><td>可调指标筛选器</td><td>地区、类别</td></tr><tr><td>数字格式</td><td>货币</td></tr><tr><td>数据源目标度量</td><td>销售目标</td></tr><tr><td>目标度量的粒度</td><td>每天</td></tr><tr><td>上升的值是</td><td>有利</td></tr></tbody></table>

**指标**是位于定义前面的交互对象。当用户调整筛选器或时间选项时创建，这意味着可以有许多与定义相关的指标。用户关注并探索指标以获得见解。下表提供了为指标配置的选项示例。这些选项应用于指标定义指定的核心值之上。

<table class="table--plain"><caption>超市销售额 - 技术的指标</caption><tbody><tr><th>指标选项</th><th>示例值</th></tr><tr><td>时间段</td><td>本季度至今</td></tr><tr><td>筛选器</td><td>类别：技术</td></tr><tr><td>手动目标</td><td>80K</td></tr></tbody></table>

<table class="table--plain"><caption><p>&nbsp;</p><p>超市销售额 - 办公用品的指标</p></caption><tbody><tr><th>指标选项</th><th>示例值</th></tr><tr><td>时间段</td><td>年初至今</td></tr><tr><td>筛选器</td><td>类别：办公用品</td></tr><tr><td>手动目标</td><td>200K</td></tr></tbody></table>

若要开始使用 Tableau Pulse，您需要创建一个指标定义来捕获您想要跟踪的核心价值。在最基本的层面上，该值是基于时间维度跟踪的聚合度量。该定义还指定了一些选项，例如查看者可以筛选的维度、值的格式设置方式以及显示的见解类型。

当您创建此定义时，Tableau 会自动创建一个初始指标并将您转到该指标的页面。为定义创建的初始指标未应用任何筛选器，但每当您或组织的其他成员以新方式调整指标筛选器或时间选项时，Tableau Pulse 都会创建其他相关指标。

您组织中的人员关注指标，而不是指标定义。通过跟踪各个指标，他们可以获得对他们重要的维度的特定见解。定义的存在是为了让您可以从单个父对象管理指标的数据。如果数据源中的字段发生更改，您可以更新定义以反映此更改，并且基于该定义的所有指标也将反映此更改。

假设您是销售组织的成员，该组织需要跟踪不同地区和产品线的指标。在 Tableau Pulse 中，您将创建一个指标定义，其中包括每日销售额总和的核心值以及针对区域和产品线的可调整指标筛选器。然后，您将为每个区域和产品线创建指标。最后，您可以将组织成员作为关注者添加到涵盖其销售地点和产品的指标中。

## Tableau Pulse 有何不同

Tableau Pulse 提供了创建指标定义的简化方式，因此您只需进行几个选择，就可以做出通常需要复杂计算才能在传统 Tableau 可视化项制作中构建的定义。您的组织成员使用该指标定义作为起点，通过根据不同维度或时间选项对数据进行切片，使指标与其需求相关。由于有关这些指标的见解会直接发送给关注者，因此您的同事可以在工作流程中获得所需的数据。

借助 Tableau Pulse，用户可以通过简单的自助方式参与引导式数据探索。他们可以提出建议的问题，以了解不同维度如何影响数据。这种引导式探索补充了传统 Tableau 可视化项制作体验中可能实现的更自由形式的分析，并允许不熟悉 Tableau 分析的用户了解他们的数据。

![有关指标数据的问题和解答](/tableau/next/zh-cn/online/zh-cn/Img/pulse_qa.png)

请注意，虽然 Tableau Pulse 的某些部分与其他 Tableau 功能类似，但 Tableau Pulse 将指标和见解结合到了简化的体验中。2024 年 2 月，随着 Tableau Pulse 的发布，“数据问答”(Ask Data) 功能和 Tableau 的旧版指标功能已停用。与“数据问答”(Ask Data) 功能一样，Tableau Pulse 可让您对数据提出问题，以便您了解所看到的数字背后的方式和原因。Tableau Pulse 还允许您创建和跟踪指标，就像旧版指标功能一样，但 Tableau Pulse 指标并不是独立的。这些指标是有关数据的见解的来源。

## 指标定义的数据源要求

您可以通过连接到已发布的数据源来创建指标定义。有关如何构造该数据源的信息，请参见[为 Tableau Pulse 设置数据](https://help.tableau.com/v0.0/online/zh-cn/pulse_data_source_requirements.htm)。

## 配置核心定义

确保您的数据源适用于 Tableau Pulse 后，您就可以开始创建定义了。定义编辑器针对更大的屏幕进行了优化，因此您应该使用台式机或笔记本电脑而不是移动设备来创建定义。

若要创建指标定义，您需要 Tableau Cloud 上的 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色。如果您具有 Viewer（查看者）站点角色，则可以关注指标并发现见解，但无法创建指标定义。

1. 从 Tableau Pulse 主页中，选择“新建指标定义”。
2. 选择要连接的数据源，然后选择“连接”。
3. 对于“名称”，输入其他指标定义未使用的名称。
    
    此名称出现在基于定义的所有指标上，因此请选择一个便于他人理解的名称。
4. 对于“描述”（可选），请提供简短的详细信息以帮助其他人理解数据。
    
    描述出现在定义页面上。在每个指标的见解探索页面上，当用户选择信息图标时会显示描述。
5. 对于“链接”（可选），最多添加 5 个链接。这些链接出现在指标的见解探索页面上。链接必须以 `https://` 开头。
6. 对于“标记”，最多添加 10 个标记。您可以重用其他 Tableau 内容的现有标记或创建新标记。这些标记出现在指标定义上以及基于该定义的所有指标上。在 Tableau Pulse 主页上，用户可以对其关注的指标进行排序，并按标记筛选指标定义。

### 定义指标值

1. 对于“度量”，选择要跟踪的字段。
    
    您可以选择度量或维度，但维度必须聚合为计数或计数（不重复），以便它们生成可跟踪的度量。
2. 对于“聚合”，选择 Tableau Pulse 应如何聚合您正在跟踪的字段。
    
    如果您需要更复杂的聚合，请参见[创建高级定义](#advanced)。
3. 对于“时间性”，选择“跨时间段累积”或“最近时间点”。
    
    时间性设置控制指标值和指标图表上的点值是一段时间内的累积值，还是最近日期的快照值。例如，具有月初至今时间段和跨时间段累积时间性的指标将在每月的第 15 天显示第 1-15 天的累积值。具有时间点时间性的同一指标将显示一个值，该值捕获 15 日当天的数据。
    
    此设置还会影响可用于“显示迄今为止的迷你图值”设置的选项。具有时间点时间性的指标始终具有非累积图表。除了整体图表是非累积的之外，对于时间点时间性，指标图表上的每个点都显示该点所涵盖期间中最新日期的值。因此，对于每个点表示一周数据的图表，该值代表该周中的最后一个日期。
4. 对于“将迄今为止的迷你图值显示为”，选择是否希望指标图表上的点显示为运行总计或非累积值。
    
    此设置适用于迷你图、概述折线图和适用的见解。对于总和指标，指标顶部显示的当前值始终是您跟踪期间的运行总计。
5. 对于“定义筛选器”（可选），选择值以限制指标数据。
    
    定义筛选器会影响基于定义的所有指标的数据，查看者无法对其进行调整。作为定义筛选器添加的字段会更改定义的含义。例如，定义筛选器可能会排除退回的订单以定义净销售额。如果您只想使用字段来细分数据，请添加可调整的指标筛选器（可在“选项”部分下找到）。有关详细信息，请参见[定义指标选项](#options)。
6. 对于“时间维度”，选择字段来定义时间序列。2025 年 3 月，高级时间设置转移到“时间”步骤。若要配置这些选项，请参见[配置时间设置](#time-settings)。

#### 会计日历如何与指标配合使用

如果您的时间维度配置为使用会计日历，Tableau Pulse 将使用该日历。基于会计日历定义的指标在图表和见解上显示会计年度和会计季度。创建定义时，会计开始月份会列在时间维度字段下（如果已设置）。您无法在 Tableau Pulse 中调整会计日历。若要对其进行更改，请编辑定义使用的数据源。有关详细信息，请参见[会计日期](https://help.tableau.com/current/pro/desktop/zh-cn/dates_fiscal.htm)。

#### 创建高级定义

如果您喜欢在传统 Tableau 可视化项制作环境中灵活工作，或者需要创建计算字段，请使用高级分析编辑器。高级分析编辑器的使用是可选的。

1. 在定义面板上，选择“创建高级定义”。
2. 将字段添加到度量、时间维度和筛选器功能区。
    
    编辑器仅保存您添加到这些功能区的字段，包括计算字段。在高级编辑器中进行的数字格式更改、粒度调整或表计算不会延续。相反，使用定义设置来设置[最小时间粒度](#minimum-time)或[更改数字格式](#number-format)。
3. 选择“应用”。
    
    您在编辑器中添加的字段将替换定义面板中的等效字段。若要编辑这些字段，请重新打开编辑器。您无法编辑在定义面板的高级分析编辑器中配置的字段。

### 定义指标选项

1. 对于“可调指标筛选器”，至少添加一个选项。
    
    这些筛选器选项出现在指标上，并允许用户调整数据范围以满足他们的需求。筛选操作会根据定义创建额外的指标。您添加为可调整指标筛选器的前 20 个字段还确定用于生成有关数据的见解的维度。如果添加超过 20 个字段，这些选项仍会显示为筛选器，但它们不会用于生成见解或用作细分选项。
2. 对于“数字格式”，您可以指定要为值显示的自定义单位，也可以将值设置为显示为货币或百分比。
3. 对于“小数位”，选择要为指标值显示的小数位数。默认情况下，Tableau Pulse 会自动确定要显示的小数位数。随着数字变大，Tableau Pulse 显示的小数位数会越来越少。

## 配置时间设置

时间设置是可选的，可让您调整指标的时间序列和比较，使其适合您的数据。

### 设置日期偏移

日期偏移将指标时间序列中的终点从今天更改为过去的某一天。如果指标数据源中的数据刷新延迟，则偏移很有用。否则，如果时间序列中的终点没有任何数据，则指标将显示 null 值。

偏移有两种类型：固定和动态。固定偏移将时间序列的结束时间偏移指定天数。固定偏移量为 2 天的指标显示时间段“2 天前”而不是“今天”。

动态日期偏移会自动调整以显示包含数据的最近日期，而不是“今天”。因此，如果数据源在几天内未更新，则偏移量会增加以继续显示包含数据的最近日期。

1. 对于“日期偏移”，选择“固定”或“动态”。
2. 对于固定偏移，请输入要将时间序列偏移的天数。

#### 编写适用于动态偏移的计算字段

如果指标定义的度量使用计算来聚合多个字段，则任何具有日期 null 值的字段都会导致该日期的聚合值为 null。动态偏移会跳过具有 null 值的日期，以查找包含数据的最近日期。

为了确保 Tableau Pulse 不会跳过有数据的日期，请在计算中使用 IF 语句来识别至少具有一个非 null 字段的任何日期，然后应用 ZN（如果为 null，则为零）函数。ZN 函数将 null 值转换为零，以便它们可以与具有数据的其他字段聚合，然后动态偏移量将该日期标识为具有数据。有关这些函数的详细信息，请参见 [数字函数 (ZN)](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_number.htm#zn) 和[逻辑函数 (IF)](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_logical.htm#if)。

### 设置最小粒度

最小粒度控制用户筛选指标时可用的时间选项。这样，用户就无法选择没有数据的选项。

1. 对于“最小时间粒度”，如果根据您的数据，天或周等较小的单位不合理，请选择较大的粒度。

### 自定义比较

1. 对于“时间比较”>“主要”，选择“前一期间”以与前一天、前一周、前一个月、前一个季度或前一年进行比较，或选择“前一年”以与一年前的同一时间范围进行比较。主要时间比较显示在摘要和见解以及指标概述卡上。
2. 对于“时间比较”>“次要”，如果不希望指标显示次要比较，请选择“无”。在指标的见解探索页面上，除了主要比较之外，还会显示次要比较。

#### 设置自定义每日比较

自定义每日比较允许您覆盖时间范围为“今天”或“昨天”的指标的标准比较。自定义比较需要数据源中的两个字段：自定义每日比较和参考日期。参考日期定义哪些日期显示自定义比较，自定义每日比较提供替代日期。参考日期和自定义每日比较的字段必须属于数据源中的同一个表。

使用此设置可以比较每年日期不一致的事件。例如，您可以将今年的黑色星期五与一年前的黑色星期五进行比较。在没有自定义比较的情况下，显示 2025 年 11 月 28 日数据的指标会显示与 2024 年 11 月 28 日的上一年比较。通过自定义比较，您可以为参考日期 2025 年 11 月 28 日指定 2024 年 11 月 29 日的每日比较。这样，Tableau Pulse 就会比较同一事件的销售数据。

1. 对于“自定义每日比较”，选择一个日期字段。此字段包含每日比较的替代日期。
2. 对于“参考日期”，选择一个日期字段。此字段确定哪些日期显示自定义比较。您可以重用核心定义中的时间维度，只要它与自定义每日比较属于同一个数据表。

### 设置自定义日历

必须在数据源中定义日历，并且所有日历字段必须来自同一个表。有关详细信息，请参见[指标定义的数据源要求](#ds-requirement-calendar)。

1. 在“日历”下，选择“设置日历”。
2. 选择数据源中定义自定义日历的字段。

- 一年中的某天（数据类型：数字）
- 一年中的某周（数据类型：数字）
- 一年中的某月（数据类型：数字）
- 月份名称（数据类型：字符串）
- 季度（数据类型：数字）
- 年份（数据类型：数字）
- 参考日期（数据类型：日期）

4. 选择“应用”。

## 配置数据源目标和阈值

配置数据源目标或阈值是可选的。有关为目标和阈值构建数据源的信息，请参见[指标定义的数据源要求](#ds-requirement-goals)。

数据源目标或阈值使用数据源中的字段在指标上显示动态目标或阈值。对于目标，Tableau Pulse 显示指标在目标值方面的进展。如果开启了目标进度见解，您还会看到该指标是否有望在周期结束时达到目标。对于阈值，Tableau Pulse 显示指标与阈值的距离。

数据源目标或阈值根据定义出现在所有指标上。如果存在该粒度级别的目标数据，则通过应用于指标的筛选器筛选目标或阈值。如果特定值或维度不存在目标数据，Tableau Pulse 将显示具有目标数据的更高详细级别的目标值或阈值。该更高级别的目标值或阈值可能与经过筛选的指标无关，因此请确保您的数据源具有适当粒度的数据。

1. 在“目标和阈值”步骤上，选择“类型”。您可以配置目标或阈值，但不能同时配置两者。
2. 对于“度量”，选择数据源中用于目标值或阈值的字段。
3. 数据源目标和阈值从核心定义继承定义筛选器，除非在高级编辑器中设置了这些筛选器。如果没有继承定义筛选器，请添加任何相关筛选器。
4. 对于“聚合”，选择如何聚合大于目标粒度的时间段内的数据。
5. 对于“时间维度”，选择用于时间序列的字段。
6. 对于“最小粒度”，选择度量的每一行所代表的详细级别。时间范围小于粒度的指标不会显示目标或阈值。
7. 如果您要设置阈值，请为“不利范围”选择高于或低于阈值是否不利。不利范围在指标图表上显示为红色阴影。当聚合指标值进入此范围时，关注者将收到通知。有关详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。
8. 若要更改目标或阈值的标签，请在“自定义目标标签”下输入名称。此自定义标签显示在目标进度指标、图表和见解中。

### 高级目标和阈值

若要配置使用计算字段的数据源目标或阈值，请创建高级目标或阈值。高级分析编辑器让您可以使用熟悉的 Tableau 可视化项制作环境来创建定义目标或阈值的计算。

使用高级编辑器，您可以使用数据源中的字段编写计算，也可以编写为目标或阈值定义静态数值的计算。这些静态值根据定义出现在所有指标上。如果定义静态值，则可以使用逻辑函数来定义这些值如何与不同条件对应。例如，使用 if 语句定义为特定筛选器值显示的目标或阈值。有关编写逻辑计算的详细信息，请参见[逻辑函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_logical.htm)。

### 手动目标和阈值覆盖

手动目标或阈值是具有权限的任何人都可以在单个指标上设置的单个数字。如果有人对指标设置了手动目标或阈值，则该值会覆盖任何数据源目标或阈值。如果移除手动覆盖，则数据源目标或阈值将再次出现。若要了解手动目标和阈值，请参见[使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm)。

## 配置见解

1. 选择“见解”选项卡。
    
    “见解维度”下的字段与您添加为可调整指标筛选器的字段相同。Tableau Pulse 在监控数据时使用这些维度来显示相关见解，如见解预览中所示。
2. 对于“上升的值是” ，选择变化是中性、有利还是不利。
    
    此选项控制变更值的颜色：蓝色表示中性，绿色表示有利，红色表示不利。它还会影响涉及变更的见解中使用的语言。
3. 您可以通过打开或关闭指标来选择为指标显示的见解。在“见解类型”下，选择“启用”或选择“...”菜单，然后选择“关闭”以调整显示的见解类型。将鼠标悬停在信息图标上可查看每种类型的说明。  
      
    **相关指标**：启用此见解后，您将需要选择最多五个可以考虑与您定义的指标相关联的指标定义。仅当两个指标之间的相关系数为 0.7 或更大时，才会为指定为相关性候选项的指标显示相关指标见解。此外，就 Pulse 中的 Tableau Agent 而言，必须在指标所涵盖的时段或您所查询的时段内找到相关性。  
    
    1. 选择“添加候选项”。
    2. 在“管理相关候选项”对话框中，选择您希望 Tableau Pulse 关注相关性的指标定义。尝试选择感兴趣的指标定义，这些定义还没有明显的因果关系。
    3. 完成后，选择“应用”。
    
      
    **记录级别异常值**：启用此见解后，需要额外的配置。
    
    1. 对于“记录标识符”，选择数据中每个记录都有唯一值的字段，例如订单 ID。
    2. 对于“记录标识符名称”（可选），选择数据中具有与记录标识符相对应的名称的字段，例如订单名称。
    3. 对于“单数”和“复数”（可选），添加记录的名称，因为它们应该出现在见解文本中，例如 Order 和 Orders。
4. 验证指标和见解预览是否符合预期，然后选择“保存定义”。
    
    Tableau Pulse 创建定义以及基于该定义的初始指标，该定义没有应用可调指标筛选器。您可以在 Tableau Pulse 主页的“浏览指标”选项卡下找到定义。

有关见解类型和见解平台的概述，请参见[Tableau Pulse 中的见解平台和见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm)。

## 配置治理

指标定义的治理设置是可选的。

### 认证定义

基于认证定义的指标会显示一个徽章，指示其“受信任”和“推荐”状态。认证指标以告诉其他人他们可以依赖该数据来制定业务决策。

1. 在“背书”下，打开“已认证定义”开关。

若要对指标定义进行认证，您必须对该定义所连接的数据源具有“创建指标定义”权限能力。认证指标定义是与认证数据源不同的操作，并且数据源认证不会出现在指标上。若要了解已认证数据源，请参见[使用认证来帮助用户查找受信任的数据](https://help.tableau.com/v0.0/online/zh-cn/datasource_certified.htm)。

### 限制对定义以及手动目标和阈值的编辑

默认情况下，任何具有正确站点角色的用户都可以编辑或删除指标定义。所有用户都可以根据该定义设置、编辑或删除指标的手动目标或阈值。您可以将这些操作限制为特定用户和组。Tableau 管理员始终具有编辑权限，因为他们的站点角色授予他们访问权限。

具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色的用户都可以编辑指标定义。如果您授予 Viewer（查看者）编辑定义的访问权限，该用户将无法编辑定义，因为站点角色不允许这样做。编辑手动目标和阈值的能力不受站点角色的限制。

1. 在“编辑定义”或“编辑手动目标和阈值”下，选择“任何人都可以编辑”。
2. 选择“限制编辑”切换按钮。
3. 输入要添加为编辑者的用户和组。
4. 选择“添加”。
5. 关闭“管理编辑者”对话框。

## 创建指标

创建指标定义后，您将转到该定义的初始指标。此页面是该指标的见解探索页面。在其上，您可以根据您选择的维度查看见解，并且可以通过调整筛选器创建更多指标。

1. 在您的定义的指标上，选择“筛选”。筛选器标签变为交互式。
2. 选择按钮以更改时间和筛选器选项。
3. 选择复选标记按钮。如果具有该筛选器组合的指标尚不存在，Tableau Pulse 会创建一个。

若要了解查看者如何与这些指标交互，请参见[使用 Tableau Pulse 探索指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm)。

### 为什么指标的图表不完整？

当您创建具有不同时间段的指标时，它可能会揭示您的数据问题。如果缺少图表所涵盖期间的数据，则指标值或预期范围可能看起来不完整。

#### 指标值不完整或缺失

如果指标值不完整，则可能表示数据存在问题，或者可能是图表所涵盖时间段的正常结果。在年初至今指标的周期开始时，图表仅显示单个数据点。如果您希望查看最近 7 天、30 天或 90 天的数据，请进行筛选以显示滚动时间窗口。如果没有当前期间的数据，但有以前期间的数据，则指标连接到的数据源可能会延迟刷新。您可以设置日期偏移量来考虑此延迟。

#### 预期范围不完整

图表上有数据的点会出现预期范围。在非累积图表上，对于没有数据的点，指标值和预期范围都缺失。对于显示汇总的指标，如果期间内至少有两个点的数据，则图表将显示指标值的累积线，但没有数据的点没有预期范围。

对于具有季度至今时间范围的指标，季度可能在一周的中间开始。如果季度的第一周是部分周，则不会显示该周的预期范围。

## 管理关注者

有关在指标中添加和移除关注者的信息，请参见[在 Tableau Pulse 中关注指标并管理关注者](https://help.tableau.com/v0.0/online/zh-cn/pulse_manage_followers.htm)。

## 编辑指标定义

如果您的数据源发生更改，并且基于该数据源的指标出现故障，请编辑指标定义以考虑这些更改。您对定义所做的任何更改都将影响基于该定义的所有指标。

1. 打开您要编辑的定义的指标。
2. 选择操作菜单，然后选择“编辑定义”。
    
    ![编辑定义按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_definition.png)

### 编辑定义会如何影响指标和目标

当您编辑定义时，您的更改可能会影响基于该定义的指标以及基于这些指标的目标。

<table class="table--plain"><tbody><tr><th>更改的字段</th><th>受影响的功能</th><th>影响</th></tr><tr><td>定义筛选器、可调整指标筛选器</td><td>指标</td><td>如果移除可调整标筛选器或添加排除指标筛选器中使用的值的定义筛选器，则不会删除使用该筛选器的指标。受影响指标的现有关注者可以调整筛选器并添加其他关注者。但是，尚未关注的用户无法自行关注该指标。<p>为了使用户不再看到基于已删除筛选器的指标，请从这些指标中移除关注者。或者，如果您想删除某个定义的所有指标，请删除该定义。</p></td></tr></tbody></table>

## 克隆指标定义

如果需要创建多个类似的指标定义，请克隆现有定义。克隆指标定义会复制原始定义中除治理步骤外的所有配置。由于 Tableau Pulse 中不能有两个相同的指标定义，因此您必须在保存之前调整克隆的定义。

1. 在指标定义页面上，选择“克隆定义”。您还可以从指标的见解探索页面上的操作 (⋯) 菜单中选择“克隆定义”。
2. 在克隆定义的“核心定义”步骤中，更改度量、聚合、时间维度或可调指标筛选器中的至少一个。
3. 查看其他步骤并进行所需的任何调整。
4. 选择“保存”。克隆的定义在您保存之前不会保留。

## 删除指标定义

删除指标定义也会删除基于该定义的所有指标。

1. 从 Tableau Pulse 主页中，选择“浏览指标”选项卡。
2. 在要删除的指标定义上，选择操作 ( ... ) 菜单，然后选择“删除”。

## 向仪表板中添加指标和从仪表板创建指标

有关 Pulse 指标仪表板对象的信息以及基于仪表板数据的指标建议，请参见[使用 Tableau Pulse 指标和仪表板](https://help.tableau.com/v0.0/online/zh-cn/pulse_dashboard.htm)。

## 嵌入指标

您可以使用嵌入 API 将 Tableau Pulse 指标嵌入网页中。有关详细信息，请参见[启用 Tableau Pulse](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_pulse.html)。

<!-- document id=5887a38174d69a297afa003b7d8296ec23e3a7d53005431561a667f3d1dc9731 url=/tableau/next/zh-cn/online/pulse_dashboard.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Pulse 指标和仪表板

使用 Pulse 仪表板对象将 Tableau Pulse 指标引入仪表板，并根据仪表板中使用的数据创建推荐的指标。

## 向仪表板中添加指标

若要在仪表板中显示指标以及其他内容，请添加 Pulse 指标对象。可添加到仪表板的指标是那些连接到工作簿使用的相同已发布数据源的指标。有关仪表板对象的详细信息，请参见[添加仪表板对象并设置其选项](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm#add-dashboard-objects-and-set-their-options)。

1. 在仪表板上，从“对象”部分，将“Pulse 指标”对象拖到仪表板。
2. 选择一个指标定义以查看基于该定义的指标列表。如果没有显示指标定义，请在 Tableau Pulse 中创建一个。
3. 选择一个指标。
4. 对于指标显示，选择是否显示完整卡片或紧凑卡片。
5. 若要将指标样式设置为与 Tableau Pulse 主页上的卡片相同，请打开“使用 Tableau Pulse 样式”。Tableau Pulse 风格添加了圆角和凸起的边框。如果没有此样式选项，仪表板上的指标将类似于其他无边框仪表板对象。
6. 为了在用户选择仪表板筛选器时对指标进行筛选，请打开“响应筛选器选择”。若要了解哪些筛选器适用于 Pulse 指标，请参见[仪表板筛选器如何影响 Pulse 指标](#filters)。
7. 若要将指标卡片链接到 Tableau Pulse 的见解探索页面，请打开“链接至 Tableau Pulse”。此链接将在新选项卡中打开。
8. 选择“添加到仪表板”。

添加 Pulse 指标对象后，您可以通过从对象的上下文菜单中选择“配置”来更改指标或调整设置。

![仪表板对象上下文菜单](/tableau/next/zh-cn/online/zh-cn/Img/pulse_dashboard_object_configure.png)

### 仪表板筛选器如何影响 Pulse 指标

为了使 Pulse 指标响应仪表板筛选器，筛选器必须满足特定条件。

- 筛选器来自指标定义连接到的同一数据源。
- 筛选器是指标定义上的可调整指标筛选器。
- 筛选器是一个维度。仪表板中的时间和度量筛选器不会筛选 Pulse 指标。
- 通过公开的筛选器（请参见[在视图中显示交互式筛选器](https://help.tableau.com/current/pro/desktop/zh-cn/filtering.htm#ShowFilter)），或者通过在标记或标题上选择“只保留”或“排除”（请参见[选择以在视图中保留或排除数据点](https://help.tableau.com/current/pro/desktop/zh-cn/filtering.htm#SelectData)）来应用筛选器。在工作表之间发送信息的筛选动作（请参见[筛选动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_filter.htm)）不会筛选 Pulse 指标。

如果仪表板上的同一维度有多个筛选器，Pulse 指标将根据这些规则响应筛选器的组合。

- 如果筛选器集既包含值又都排除值，则选定值的组合集将应用于指标。因此，如果筛选器 1 包含值 A 和 B，并且筛选器 2 包含值 B 和 C，则 A、B 和 C 的筛选器将应用于指标。
- 如果筛选器 1 包含一组值，而筛选器 2 排除了同一组值，则筛选器将抵消，并且不会将筛选器应用于指标。
- 如果筛选器 1 包含值，而筛选器 2 排除值，并且值不相同，则未抵消的值将应用于指标。因此，如果筛选器 1 包括 A、B 和 C，而筛选器 2 排除 A 和 B，则包含的唯一值是 C。
- 如果选择了筛选器 1 的所有值（包括或排除），则将其视为与无筛选器相同。因此，只有已进行选择的筛选器 2 应用于指标。

## 查看仪表板的推荐指标

为了在创建指标定义时抢占先机，您可以从为仪表板显示的推荐指标列表中创建一个指标定义。

1. 查看要从中创建指标定义的仪表板时，选择工具栏中的“数据指南”按钮。
2. 在仪表板上，选择包含要使用的数据的可视化项。
    
    数据指南显示了此可视化项的推荐指标。根据可视化项中的数据与指标要求的契合程度，您可能看不到推荐的指标。如果数据指南无法推荐完整的指标，它会显示推荐的度量或维度，或者用于连接到的主要数据源。  
      
    ![显示推荐指标的“数据指南”窗格](/tableau/next/zh-cn/online/zh-cn/Img/pulse_data_guide_bootstrapping.png)
3. 选择一个建议以在 Tableau Pulse 中配置它。
4. 该推荐指标已预先填充在 Tableau Pulse 定义编辑器中。若要完成定义的设置，请参见[配置核心定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#create)。

<!-- document id=cc3e0272b63f990dcd0d75b29b9bddd5e6d7b4784a687e8970f478c2acfe938f url=/tableau/next/zh-cn/online/pulse_explore_metrics.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Pulse 探索指标

Tableau Pulse 向您发送有关您所关注的指标的见解，让您能够在工作流程中做出数据驱动的决策。举例来说，如果您定期报告某个指标，Tableau Pulse 可以向您发送有关数据重要变化的见解。借助 Tableau Pulse，具有 Creator、站点管理员 Explorer 或 Explorer（可发布）站点角色的用户可以创建为所有相关指标提供元数据的指标定义。所有用户都可以关注指标并与之交互，这些指标使用核心定义和可选筛选器来确定不同受众和目的的数据范围。当您关注指标时，有关数据的见解将直接在您工作的地方（通过电子邮件或 Slack）提供。

每个摘要都包含有关您所关注指标的上下文见解，您可以探索各个指标以获得进一步的见解。若要了解有关Tableau 中的 AI 的详细信息，请参见[适用于 Tableau 的 Einstein 生成式 AI](https://help.tableau.com/current/tableau/zh-cn/about_tableau_gai.htm)。

## Tableau Pulse 入门指南

1. 从 Tableau Cloud 主页中，展开左侧窗格，然后选择“Pulse”。
2. 在 Tableau Pulse 中，如果尚未创建指标，请[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。
3. 使用“搜索”栏或“浏览指标”选项卡查找现有指标，然后选择“关注”以开始接收有关特定指标的见解。
4. 从指标卡的“更多操作”菜单 (...) 中，您可以管理关注者、查看详细信息或查看相关指标（共享核心指标定义但具有不同筛选器或时间上下文的指标）。

有关指标定义和指标如何工作的详细说明和示例，请参见[指标定义和指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Metric)。

## 详细探索指标、调整时间范围或应用筛选器

通过“见解探索”页面，您可以对指标一目了然，包括：

- 当前指标值。
- 与上一时期相比的百分比变化。
- 应用于指标定义的筛选器。
- 以及关于该指标的见解。

从指标页面中，选择“筛选”以更改所分析的时间段。您还可以调整应用于指标的筛选值。

所有用户都可以调整筛选器值，并根据相同的定义关注不同的指标。当用户关注某个指标时，时间段和筛选器选择将保留在其主页和摘要中。

“概述”选项卡显示指标性能的折线图，包括指标的趋势方向。将鼠标悬停在折线图的不同点上可查看不同时间点的指标值。

![显示 Super Store 销售额折线图的“见解探索”页面。](/tableau/next/zh-cn/online/zh-cn/Img/pulse_explore_insights.png)

“细分”选项卡显示指标中的不同值对总价值的贡献情况。您可以选择查看指标细分的维度。例如，此指标默认显示区域，但您也可以按区域经理或市场细分来细分指标。

![“细分”选项卡显示按区域划分的 Super Store 销售额的条形图。](/tableau/next/zh-cn/online/zh-cn/Img/pulse_breakdown.png)

如果指标定义中设置了数据源目标或阈值，您可以调整图表详细信息以显示每个促成因素的目标或阈值数据。默认情况下，细分图表显示与前一期间的数据的比较。对于设置了手动目标或阈值的指标，不会出现图表详细信息选项。

![图表详细信息选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_chart_detail.png)

Tableau Pulse 通过针对它检测到的指标的每个见解提出问题，提供了探索数据的途径。当您点击有关数据的建议问题时，答案会显示在易于阅读的图表中，其中包含有关基础数据的见解。

![引导式问答体验，并通过条形图显示区域经理的最高销售额。](/tableau/next/zh-cn/online/zh-cn/Img/pulse_q_and_a.png)

如果您没有看到您正在寻找的见解，请单击可用问题左侧的“询问”按钮，然后输入有关该指标的新问题。根据您的问题，Tableau Pulse 将查找并排列它针对您正在调查的同一指标检测到的见解的语义匹配。然后，它会针对每个检测到的见解列出一个问题。指标可用的筛选器设置和数据会影响 Tableau Pulse 可以检测到的见解。

如果在 Tableau Pulse 中启用了 Pulse 中的 Tableau Agent，您可以在 Tableau Pulse 主页中看到基于按数据源、定义或时间范围分组的指标的建议问题。选择一个问题将带您进入一个页面，其中包含关键见解、相关可视化项、来源参考以及建议的后续问题，以帮助您深入挖掘。Pulse 中的 Tableau Agent 由 Tableau 中的 AI 提供支持，因此您可以用自己的语言提出问题，以获得与您的数据相关的自然语言答案。有关详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)。

## 关注指标

关注指标以在 Tableau Pulse 主页和摘要中对其进行跟踪。有关以下指标的信息，请参见 [在 Tableau Pulse 中关注指标并管理关注者](https://help.tableau.com/v0.0/online/zh-cn/pulse_manage_followers.htm)。

## 自定义主页和摘要

通过对指标进行排序、分组或筛选，自定义 Tableau Pulse 主页。按时间范围或最近关注对指标进行排序。对共享指标定义或数据源的指标进行分组。筛选指标以仅显示您收藏的指标。

1. 在 Tableau Pulse 主页上，选择“排序依据”或“筛选依据”。
2. 选择所需的指标筛选或排序方式，例如按指标定义分组。
3. 对于排序顺序，选择“设置为默认顺序”将其应用于您的 Tableau Pulse 主页、Tableau Mobile Pulse 选项卡、Slack 摘要和电子邮件摘要。若要筛选您在摘要中收到的指标，请参见[管理您的 Tableau Pulse 摘要](#manage-digest)。

您还可以将见解摘要中的指标静音，而无需取消关注指标。您的见解摘要显示在主页顶部和摘要中。已静音指标的卡片仍显示在 Tableau Pulse 主页和摘要中。

1. 打开 Tableau Pulse 主页。
2. 从要屏蔽的指标中，选择“更多操作”选项 （三个垂直点）。
3. 选择“从见解摘要中屏蔽”。

若要取消屏蔽指标，请在 Tableau Pulse 主页上找到该指标，然后选择“更多操作”选项（三个垂直点）。然后选择“包含在见解摘要中”。

**注意：**您的见解摘要会在您关注两个或更多指标时生成。如果您的见解摘要未生成，请关注更多指标或取消屏蔽已关注指标。

## 管理您的 Tableau Pulse 摘要

您可以选择接收 Tableau Pulse 摘要的渠道以及接收摘要的频率。默认情况下，摘要会每周发送。摘要包括对数据重要变化的见解，以便您及时了解最新情况。

1. 从 Tableau Pulse 中，选择右上角的用户图标，然后选择“首选项”。
2. 选择您希望如何接收摘要（电子邮件、Slack 和 Microsoft Teams）。如果您的管理员针对特定渠道关闭了摘要，您将无法开启该渠道。
3. 选择您希望接收摘要的频率（每日、每周或每月）。
4. 选择是接收您关注的所有指标还是仅接收收藏的指标。此设置仅影响摘要中显示的指标卡片。您将继续收到您关注的所有指标的通知。
5. 选择“保存”。

电子邮件和 Slack 摘要会发送到与您的 Tableau 站点关联的电子邮件地址。Teams 摘要将发送到已映射到您的 Tableau 帐户的 Teams 帐户。此映射由您的 Teams 管理员在针对 Microsoft 365 设置 Tableau 应用程序时完成。

若要在 Slack 中接收 Tableau Pulse 摘要，您的管理员必须首先[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm)。您会在适用于 Slack 的 Tableau 应用程序中自动接收 Tableau Pulse 摘要。这些摘要显示在适用于 Slack 的 Tableau 应用程序的“消息”选项卡中。若要体验适用于 Slack 的 Tableau 应用程序所提供的所有功能（例如搜索可视化项、共享可视化项和接收通知），您必须将适用于 Slack 的 Tableau 应用程序连接到您的 Tableau 站点。有关适用于 Slack 的 Tableau 应用程序的详细信息，请参见[使用适用于 Slack 的 Tableau 应用程序接收通知、搜索和共享](https://help.tableau.com/v0.0/online/zh-cn/slack_tableau.htm)。

若要在 Microsoft Teams 中接收 Tableau Pulse 摘要，您的管理员必须首先设置适用于 Microsoft 365 的 Tableau 应用程序。此外，您必须至少打开一次 Tableau 应用程序并至少关注一个指标，才能接收摘要。这些摘要显示在适用于 Microsoft Teams 的 Tableau 应用程序的“活动”选项卡中。有关在 Teams 中访问 Tableau 应用程序的信息，请参见[使用 Teams 应用](https://help.tableau.com/v0.0/online/zh-cn/teams_explore.htm#explore)。有关以管理员身份设置应用程序的信息，请参见[为 Microsoft 365 设置 Tableau 应用](https://help.tableau.com/v0.0/online/zh-cn/teams_set_up.htm)。

## Tableau Pulse 疑难解答

Tableau Pulse 仅在 Tableau Cloud 上可用。如果您的 Tableau Pulse 摘要中没有 AI 生成的见解，则您的管理员可能没有为您的站点启用这些功能。有关详细信息，请参见[为 Tableau Pulse 设置站点](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm)。

确认您的首选渠道（电子邮件、Slack 和 Microsoft Teams）已打开以接收您的 Tableau Pulse 摘要。电子邮件和 Slack 摘要将发送到与您的 Tableau 帐户关联的电子邮件地址。如果您没有收到摘要，请检查与您的帐户关联的电子邮件地址。如果您使用某些电子邮件客户端（例如 Thunderbird 或旧版本的 Outlook），Tableau Pulse 电子邮件摘要的格式可能不正确。

您还可以检查您的 Tableau Pulse 首选项，以确认您的摘要是否以所需的频率（每天、每周或每月）通过电子邮件、Slack 和 Microsoft Teams 发送。如果您的 Tableau Pulse 摘要未及时准备好，您可以在 Tableau Pulse 主页上查看您的指标。

如果您关注的指标不再出现在您的摘要中或 Tableau Pulse 主页上，则该指标已被删除。

<!-- document id=f55e812c88b941e4daad53f4fe327b6f195c462f03bb8142c37b01747b6830fe url=/tableau/next/zh-cn/online/pulse_goals.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau Pulse 设置手动目标

Tableau Pulse 可让您跟踪重要指标并在工作地点（通过电子邮件或 Slack）接收更新。如果您在 Tableau Pulse 中设置了目标或阈值，则可以跟踪与该值相关的指标性能。对于目标，Tableau Pulse 显示指标在目标值方面的进展。如果开启了目标进度见解，您还会看到该指标是否有望在周期结束时达到目标。对于阈值，Tableau Pulse 显示指标与阈值的距离。

有两种方法可以在 Tableau Pulse 中定义目标和阈值：作为数据源的一部分定义，或者手动定义。数据源目标和阈值是根据指标定义设置的。这些目标和阈值依赖于数据源中的字段来显示可筛选的动态值。若要了解数据源目标和阈值，请参见[配置数据源目标和阈值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#ds-goal)。

手动目标或阈值是根据单个指标设定的，并且是一个单一的静态数字。如果您根据具有数据源目标或阈值的指标设置手动目标或阈值，则手动值将覆盖数据源值。查看该指标的任何人都可以看到您创建的手动目标或阈值。

## 创建手动目标或阈值

当您创建手动目标或阈值时，它基于应用于当前指标的筛选器。例如，月初至今指标具有每月目标值。

1. 打开电子邮件或 Slack 摘要中或 Tableau Pulse 主页中的某个指标。
2. 从右上角选择“操作”菜单 (...)。
3. 选择“设置目标或阈值”。如果存在数据源目标或阈值，则选项为“覆盖目标或阈值”。
4. 对于“类型”，选择是设置目标还是阈值。
5. 输入值。您可以输入正数、负数或 0。
6. 如果您要设置阈值，请为“不利范围”选择高于或低于阈值是否不利。不利范围在指标图表上显示为红色阴影。当聚合指标值进入此范围时，关注者将收到通知。有关详细信息，请参见[获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm)。
7. 若要更改目标或阈值的标签，请在**“自定义目标标签”**下输入名称。此自定义标签显示在目标进度指标、图表和见解中。
8. 选择“保存”。

创建手动目标或阈值后，您将在 Tableau Pulse 摘要和 Tableau Pulse 主页上看到该目标或阈值。

![已达到 30.0k 目标的 53.6% 的 Tableau Pulse 指标。距离实现此目标还有 9 天。](/tableau/next/zh-cn/online/zh-cn/Img/Pulse_goals.png)

若要更改值，请返回“见解探索”页面，选择“操作”菜单 (...)，然后选择“编辑目标或阈值”。您也可以从“设置手动目标或阈值”对话框中选择“删除”。编辑或删除操作会改变关注该指标的所有用户的目标或阈值。

## 管理谁可以创建、编辑或删除手动目标或阈值

默认情况下，所有用户都可以创建、编辑和删除目标和阈值。如果您有权编辑指标定义，则可以限制谁可以修改手动目标和阈值。有关指标定义的权限设置的信息，请参见[限制对定义以及手动目标和阈值的编辑](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#edit-permissions)。

## 了解限制

您无法为筛选到上一个完整期间的指标设置手动目标或阈值。这包括日期范围为昨天、上周、上个月、上个季度和去年的指标。

如果编辑了指标定义，则基于该定义的所有指标也会更新。举例来说，如果编辑定义以使用其他度量或时间维度，则现有的手动目标和阈值仍然存在，即使指标数据可能已更改。检查任何预先存在的手动目标或阈值，以确认它们对更新后的指标数据仍然有意义。

<!-- document id=e40900217d5e9874767033429203666d69f9b9ebaab7cd46f144fcbea0a4b989 url=/tableau/next/zh-cn/online/connected_apps.md -->

[跳转到主要内容](#main-content)

# 使用 Tableau 已连接应用进行应用程序集成

从 2022 年 1 月初开始，Tableau 已连接应用通过促进您的 Tableau Cloud 站点与嵌入 Tableau 内容的自定义应用程序之间建立明确的信任关系，实现无缝且安全的身份验证体验。2022 年 6 月，Tableau 已连接应用扩展了其功能以支持 REST API 授权。自 2023 年 10 月起，Tableau 元数据 API 尊重使用已连接应用进行的 REST API 授权。截至 2025 年 2 月，Tableau VizQL Data Service 已支持通过已连接应用进行 REST API 授权。

**注意：**Tableau 已连接应用和 Salesforce 已连接应用不同并且提供不同的功能。如今，Tableau 已连接应用已针对在外部应用程序中嵌入 Tableau 视图和指标进行了优化，并用于授权对 Tableau REST API 的访问。（2023 年 10 月，Tableau 取消了将指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能）。

您可以配置两种类型的已连接应用：直接信任或 OAuth 2.0 信任。

### 直接信任

使用_直接信任_，您可以：

- 限制对哪些内容可以嵌入以及该内容可以嵌入的位置的访问
- 为用户提供使用单点登录 (SSO) 访问嵌入内容的能力，而不必与身份提供程序 (IdP) 集成
- 为用户提供直接从外部应用程序进行身份验证的能力
- 使用 JSON Web 令牌 (JWT) 以编程方式代表用户授权访问 Tableau REST API 和 Tableau 元数据 API （从 Tableau Cloud 2023 年 10 月版开始）
- 使用 JSON Web 令牌 (JWT) 以编程方式代表用户授权访问 Tableau REST API 和 Tableau VizQL Data Service（从 Tableau Cloud 2025 年 2 月版开始）
- 确定用户或应用程序可执行 Tableau REST API 能力的范围
- 启用其他功能，比如：
    - 用户属性函数（2023 年 3 月）
    - 按需访问（2023 年 10 月）
    - 使用断言的动态组成员身份（2024 年 6 月）
    - SCIM 的外部令牌（2025 年 6 月）

有关此已连接应用类型的更多信息，请参见[使用直接信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)。

### OAuth 2.0 信任

使用 _OAuth 2.0 信任_，您可以：

- 限制对哪些内容可以嵌入以及该内容可以嵌入的位置的访问
- 为用户提供使用单点登录 (SSO) 通过身份提供程序 (IdP) 访问嵌入内容的能力
- 使用标准 OAuth 2.0 标准协议提供访问
- 以编程方式代表用户授权访问 Tableau REST API 和元数据 API（从 Tableau Cloud 2023 年 10 月版开始）
- 以编程方式代表用户授权访问 Tableau REST API 和 VizQL Data Service（从 Tableau Cloud 2025 年 2 月版开始）
- 确定用户或应用程序可执行 Tableau REST API 能力的范围
- 启用其他功能，比如：
    - 用户属性函数（2023 年 3 月）
    - 按需访问（2023 年 10 月）
    - 使用断言的动态组成员身份（2024 年 6 月）
    - SCIM 的外部令牌（2025 年 6 月）

有关已连接应用类型的详细信息，请参见[使用 OAuth 2.0 信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm)。

## 此部分中的其他文章

<!-- document id=6a4fa142887f6c981dca6ff1c404c78342313ca1319e0bde83844a664c868483 url=/tableau/next/zh-cn/online/dm_vconn_test_preview.md -->

[跳转到主要内容](#main-content)

# 使用“以用户身份预览”测试行级安全性

使用“以用户身份预览”测试您的数据策略。您可以看到用户看到的数据，并确保行级安全性按预期工作。当数据策略阻止您查看表中的行时（例如，如果只有销售人员可以查看行，而您不是销售人员），这会有所帮助。

在应用数据策略时预览数据：

1. 选择一个表。
2. 在“表详细信息”部分，选中“策略已应用”复选框。
3. 单击“以用户身份预览”，选择一个组（可选）和一个用户。
4. 验证策略在表详细信息中是否显示该用户的正确数据。
5. 根据需要为其他用户重复该操作。

> [!TIP]
> 
> **提示：**在“表详细信息”中，单击 ![显示数据策略列中值范围的窗格图标。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Panes_show_16px_medium.png) 显示列的值范围，包括显示的值和数据策略筛选掉的值。选择很好地表明策略正在正确筛选数据的一两列。

## 谁可以执行此操作

若要测试虚拟连接，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

## 后续步骤

测试数据策略后，当您准备好与他人共享虚拟连接时，请参见[发布虚拟连接并设置权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_publish_save.htm)。

<!-- document id=d21a2df75ccf7c46c46883b554a146da3c58d1964fa376338cec00b786fd5538 url=/tableau/next/zh-cn/online/adminview_insights.md -->

[跳转到主要内容](#main-content)

# 使用“在线管理见解”创建自定义视图

您可以通过使用“在线管理见解”来更详细地了解 Tableau Cloud 部署。

“在线管理见解”是预先填充了精心策划的数据源和预先生成的站点数据工作簿的仅 Tableau Cloud 项目。使用通过“在线管理见解”项目提供给您的资源，您可以创建自定义视图来帮助回答有关站点的一系列常见问题：

例如：

- 我的组织中 Tableau Cloud 采用率是多少？
- 站点部署展现出哪些常见趋势？
- 哪些内容受欢迎？
- 我的用户在做些什么？
- 应如何分配许可证？

## 连接到“在线管理见解”数据

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。

**从 Tableau Cloud 中**

1. 登录到 Tableau Cloud，并导航到“在线管理见解”项目。
2. 选择“创建”\>“工作簿”，并选择数据源之一以开始操作。

**从 Tableau Desktop 中**

1. 打开 Tableau Desktop，并在“连接”下选择“Tableau Server”。
    
    **注意：**如果您尚未登录到 Tableau Cloud，请在 Tableau Server 的“登录”对话框中单击“Tableau Cloud”超链接。输入您的 Tableau Cloud 凭据，然后单击“登录”。
2. 在搜索框中，键入您要查找的数据源的名称。
3. 选择数据源并单击“连接”以开始分析。

## 开始创建自定义视图

在考虑要如何处理站点和用户指标分析时，请考虑组织通常会提出的以下某些问题：

- 哪些视图或数据源最常用？
- 哪些用户最活跃（也就是说，哪些用户是高级用户）？
- 站点上执行的最常见任务是什么？
- 有多少许可证正在使用？
- 那些用户未登录站点超过 90 天？

### 浏览预先构建的工作簿

为了帮助您回答前面的问题（及更多问题），请转到预先构建的工作簿“在线管理见解起始模板”，了解它可以提供哪些类型的见解。该工作簿可用作创建更详细的仪表板和工作簿的模板，以解决与您的站点或组织相关的独特问题。

自 2024 年 10 月起，本地化版本的 Admin Insights Starter 工作簿将作为加速器在 [Tableau Exchange](https://exchange.tableau.com/search?q=admin+insights+starter) 上提供。

![包含有关用户、登录活动、流量和管理模板采用的数据的仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/insights_workbook.png)

**焦点：**站点活动  
**数据源：**TS 用户

使用此仪表板可以按用户角色浏览高级站点活动。

此仪表板显示可用于分析站点日志和活动指标的一些方法。默认情况下，“在线管理见解”可捕获最多 90 天的数据，使用 [Advanced Management](https://help.tableau.com/current/online/zh-cn/itm_intro.htm) 许可证可捕获最多 365 天的数据。“上次发布”和“上次访问”日期可追溯到站点创建日期，但以下字段除外：

- last\_datasource\_access\_date
- last\_datasource\_publish\_date
- last\_view\_access\_date
- last\_workbook\_publish\_date
- web\_authoring\_last\_access\_date

**使用此仪表板执行更多操作：**

- 使用右上角的参数控件更改“非活动阈值”（默认情况下为黄色）。
- 创建可根据用户的活动类型向用户发送电子邮件的 URL 动作。例如，如果用户在过去 90 天内未登录站点、访问内容或发布内容，则向用户发送电子邮件。
- 为此仪表板创建其他视图，将过去 90 天（默认值）的活动（登录、访问或发布）与过去 30 天、60 天和所有天数进行比较。

**焦点：**组成员资格和许可  
**数据来源：**组、TS 事件、TS 用户

仪表板向您显示站点上的组和分组用户的数量。使用筛选器或单击“组细分”工作表中的行或标记来选择组。选择单个组后，您可以查看成员资格和许可证详细信息。

仪表板向您显示以下类型的信息：

- 组成员资格：站点上有多少组和分组用户
- 许可证使用：登录时使用许可证的组的百分比
- 站点角色和许可证类型：哪些用户是组成员以及为他们分配了什么站点角色

**使用此仪表板执行更多操作：**从成员资格工作表中选择一个用户，向所有组成员发送电子邮件。

**焦点：**登录活动  
**连接到：**TS 事件（主要）,TS 用户（辅助）

使用此仪表板可浏览登录活动的趋势。

使用左侧的“选择事件或不同参与者”选择器，您可以看到站点的每周、每天和每小时与登录相关的活动。由于此仪表板后面有两个数据源，因此可以看到所有用户的登录，而不仅仅是具有登录活动的用户。

**使用此仪表板执行更多操作：**复制仪表板，并仅保留“登录用户细分”。然后，将“上次登录日期”上的筛选器更改为 null，以查看从未登录到站点的用户的列表。您还可以根据您希望用户执行的操作类型向他们发送电子邮件。

**焦点：**内容访问和使用情况  
**连接到：**TS 事件

仪表板显示以下类型的信息：

- 视图访问活动：视图何时被访问以及由谁访问。
- 数据源访问活动：当 1）已发布数据源已通过 Web 制作或 Tableau Desktop 连接时，或 2）用户已查看或发布使用已发布数据源的工作簿时。
- 工作簿发布活动：工作簿何时发布以及由谁发布。
- 数据源发布活动：已发布数据源何时发布以及由谁发布。

**使用此仪表板执行更多操作：**使用右上角的“项目名称”选择器，选择站点上要筛选的项目。此筛选器会影响在线管理见解起始模板中的所有工作表。

**焦点：**内容使用情况和磁盘空间  
**连接到：**站点内容、TS 活动

仪表板向您显示以下类型的信息：

- 按活动划分的磁盘空间使用情况：过时内容和被视为活动的内容使用的空间量 - 在低于过时阈值的时间范围内访问的内容。
- 项目使用的空间：站点上内容使用的空间量。x 轴显示自上次查看内容以来经过的天数。y 轴显示大小。
- 陈旧和未使用的内容使用的空间：陈旧和未使用的内容使用的空间总量。您可以使用此信息来确定哪些内容最陈旧或占用的空间最大。

**使用此仪表板执行更多操作：**

- 使用不活动阈值来确定内容在被视为过时之前可以不使用的时间长度。更改此值会筛选不符合阈值的内容项。
- 使用项目名称选择器按项目筛选内容。此筛选器会影响在线管理见解起始模板中的所有工作表。
- 为了要保持站点干净，请移除不再使用的内容。如果您不确定，请选择一项，在删除之前通过电子邮件发送给内容所有者。

**焦点：**内容所有权和磁盘空间  
**连接到：**站点内容、TS 活动

仪表板向您显示以下类型的信息：

- 站点容量：所使用的空间量与站点总容量的关系。
- 按项目划分的空间使用情况：顶级项目使用的空间量。选择一个项目会筛选其他工作表以显示内容项、大小和所有权详细信息。
- 项的空间使用情况：内容项（例如工作簿、数据源、流程和虚拟连接）使用的空间量。
- 用户的空间使用情况：检查内容所有者正在使用多少空间，并确定是否有任何组或用户超出了其分配的空间。

**使用此仪表板执行更多操作：** 

- 使用项目名称选择器按项目筛选内容。此筛选器会影响在线管理见解起始模板中的所有工作表。
- 选择要发送电子邮件的项或用户并阐明内容的使用方式。

**焦点：**仪表板性能  
**连接到：**可视化项加载时间

仪表板向您显示以下类型的信息：

- 成功指标：查看平均仪表板加载时间、请求总数和内容所有者总数。
- 性能评级：用户可以设置性能阈值，以查看属于每个评级的仪表板的百分比。通过使用性能评级，您可以快速确定需要改进的内容。
- 请求数：用户可以按请求数进行筛选，以查看最受欢迎的内容。了解内容的查看频率有助于确定性能修复的优先顺序。
- 内容列表：查看项目、工作簿和视图的计数和平均加载时间。用户可以按项名称筛选列，或按工作簿所有者筛选整个仪表板。

**使用此仪表板执行更多操作：** 

- 使用性能评级来了解仪表板的整体运行状况。若要查看问题最严重的仪表板，请选择每个性能分级中较低的百分比以筛选内容。
- 识别一段时间内的性能问题和趋势。若要与内容所有者合作解决性能问题，请将光标悬停在“视图”列中的标记上或选择这些标记以查看其用户名。

### 浏览数据源

您可以从 Tableau Cloud 和 Tableau Desktop 连接到“在线管理见解”数据源。直接连接到数据源允许您探索数据并构建特定于您的组织的仪表板或工作簿。有关如何连接的详细信息，请参见本主题中的[连接到“在线管理见解”数据](#connect)。

下表概述了每个数据源。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col></colgroup><tbody><tr><th>数据源</th><th>描述</th></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_events.htm">TS 事件</a></td><td>TS 事件充当主审核数据源。它包含有关站点上发生的各种事件的数据，包括登录、发布和访问的视图。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_users.htm">TS 用户</a></td><td>TS 用户包含用户相关数据，例如剩余许可证、站点角色以及用户拥有的工作簿。它包含 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>、Tableau Prep、Web 制作和站点角色特定功能的产品激活和使用数据。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_groups.htm">组</a></td><td>“组”数据源标识了站点上用户的组成员身份。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_site_content.htm">站点内容</a></td><td>“站点内容”数据源提供有关站点上资产（例如项目、工作簿、流程和视图）的基本治理信息。它还包括 Tableau Pulse 信息。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_viz_load_times.htm">可视化项加载时间</a></td><td>可视化项加载时间包含您站点上视图的加载时间信息，帮助内容作者了解加载视图时的用户体验。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_job_performance.htm">作业性能</a></td><td>“作业性能”包含事件和站点上后台作业的运行时信息，例如数据提取刷新和流程运行。它还包括 Tableau Bridge 刷新数据，例如 Bridge 客户端名称、池化数据以及刷新开始和完成时间。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_permissions.htm">权限</a></td><td>权限包含对站点上所有用户和内容的有效权限。站点管理员可以使用数据源来识别权限安全方面的漏洞，并确保只有适当的用户才能访问内容项。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_subscriptions.htm">订阅</a></td><td>订阅数据源提供有关站点订阅的详细信息，包括创建者和收件人的姓名、内容项、作业状态和计划。它还包括 Tableau Pulse 信息。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/adminview_insights_tokens.htm">令牌</a></td><td>令牌包含有关站点上活动的、未过期的用户令牌的信息，包括个人访问令牌 (PAT)、刷新令牌和 OAuth 令牌。站点管理员可以通过数据源监控令牌的使用情况和过期情况，根据需要轮换必要的令牌。</td></tr></tbody></table>

## 此部分中的其他文章

<!-- document id=fba613a02a50c0f2cf53da3486ffed0dd00987352f4b781bbec3eb86f62dfe61 url=/tableau/next/zh-cn/online/explain_data.md -->

[跳转到主要内容](#main-content)

# 使用“数据解释”功能更快地发现见解

在浏览数据时，“数据指南”中的“数据解释”功能可帮助检查、发现和深入了解可视化项中的标记。您可以使用“数据解释”功能来分析仪表板、工作表或选定的标记，以找出基础数据中可能的异常值和相关性。“数据解释”功能会生成统计模型，并针对可视化项中的单独标记提出可能的解释，包括当前视图中未使用的数据源中的潜在相关数据。

有关运行“数据解释”功能和探索解释的信息，请参见[“数据解释”功能入门](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm)。

**注意**：本主题介绍了“数据解释”功能在 Tableau 2021.2 及更高版本中的工作方式。如果您有以前版本的 Tableau，请阅读[“数据解释”功能版本 2021.1 帮助](https://help.tableau.com/v2021.1/pro/desktop/zh-cn/explain_data.htm "Tableau 版本 2021.1 中此帮助主题以前版本的链接")中的此主题。

在构建不同的视图时，使用“数据解释”功能作为出发点来帮助您更深入地探索数据并提出更好的问题。有关详细信息，请参见[“数据解释”功能如何帮助增强您的分析](#How)。有关哪些特征使数据源与“数据解释”功能一起使用更有趣的信息，请参见[使用“数据解释”功能的要求和注意事项](https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm)。

## 访问“数据解释”功能

默认情况下在站点级别启用“数据解释”功能。服务器管理员 (Tableau Server) 和站点管理员 (Tableau Cloud) 可以控制“数据解释”功能是否可用于站点。有关详细信息，请参见[为站点禁用或启用“数据解释”功能](https://help.tableau.com/v0.0/online/zh-cn/explain_data_enable.htm)。

可以编辑工作簿并具有工作簿的“运行数据解释”权限能力的作者可以在编辑模式下运行“数据解释”功能。 所有具有运行“数据解释”功能能力的用户都可以在 Tableau Cloud 和 Tableau Server 中以查看模式运行“数据解释”功能。

在站点管理员允许的情况下，解释可以通过电子邮件或 Slack 以查看模式与其他 Tableau Cloud 和 Tableau Server 用户共享。有关详细信息，请参见[配置 Tableau 以允许用户通过电子邮件和 Slack 共享解释](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm#ConfigureSlackEmail)。

作者可以使用“数据解释设置”来控制在“数据指南”窗格中显示哪些解释类型。

有关控制对“数据解释”功能、解释类型和字段的访问的信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。

## “数据解释”功能如何帮助增强您的分析

“数据解释”功能是一种工具，用于发现和描述数据中的关系。它无法告诉您导致关系的原因或如何解释数据。**您是数据的专家。**在帮助您决定哪些特征对于使用不同视图进一步探索可能很有趣时，您的领域知识和直觉非常关键。如需了解相关信息，请参见[“数据解释”功能的工作原理](https://help.tableau.com/v0.0/online/zh-cn/explain_data_explained.htm)以及[使用“数据解释”功能的要求和注意事项](https://help.tableau.com/v0.0/online/zh-cn/explain_data_requirements.htm)。

有关“数据解释”功能的工作原理以及如何使用“数据解释”功能来增强分析的详细信息，请参见以下 Tableau 会议演示文稿：

- [From Analyst to Statistician: Explain Data in Practice（从分析师到统计师：“数据解释”功能实际运用，1 小时）](https://www.tableau.com/zh-cn/events/tc/2019/analyst-statistician-explain-data-practice)
- [Leveraging Explain Data（利用“数据解释”功能，45 分钟）](https://www.tableau.com/zh-cn/events/tc/2019/leveraging-explain-data)

## 此部分中的其他文章

<!-- document id=55c2efce3b9b6fe6867c9e57fb95dc98bdf5baa5188af7a656f792c345b7c683 url=/tableau/next/zh-cn/online/explain_data_requirements.md -->

[跳转到主要内容](#main-content)

# 使用“数据解释”功能的要求和注意事项

在 Tableau Desktop 中，作者始终可以使用“数据解释”功能。

对于 Tableau Cloud 和 Tableau Server：为站点启用“数据解释”功能时，具有相应编辑权限的 Creator 和 Explorer 可以在编辑工作簿时运行“数据解释”功能。所有具有适当权限的用户都可以在已发布工作簿中以查看模式运行“数据解释”功能。有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm)。

## 什么使可视化项非常适合于“数据解释”功能

“数据解释”功能最适用于需要更深入探索和分析的可视化项，而不是传达汇总数据的信息图样式的描述性可视化项。

- “数据解释”功能需要行级数据来创建数据模型并生成解释。具有底层行级数据的可视化项（其中关系可能存在于未可视化的字段中）非常适合于运行“数据解释”功能。
- 基于预聚合数据且无法访问行级数据的可视化项对于“数据解释”功能执行的统计分析来说并不理想。

## 什么数据最适合于“数据解释”功能

在工作表中使用“数据解释”功能时，请记住“数据解释”功能适用于：

- **仅限单个标记** —“数据解释”功能分析单个标记。不支持多标记分析。
- **聚合数据** — 视图必须包含使用 SUM、AVG、COUNT 或 COUNTD 聚合的一个或多个度量。视图中还必须至少存在一个维度。
- **仅限单一数据源** — 必须从单一主数据源中提取数据。“数据解释”功能不适用于混合数据源或多维数据集数据源。

在为工作簿准备数据源时，如果打算在分析期间使用“数据解释”功能，请记住以下注意事项。

- 使用具有足够宽的基础数据的数据源。除了要解释的一个（或多个）聚合度量之外，理想的数据还至少有 10-20 个列。
- 给出易于理解的列（字段）名称。
- 消除冗余列和数据准备人为工作。有关详细信息，请参见[更改用于统计分析的字段](https://help.tableau.com/v0.0/online/zh-cn/explain_data_lm_status.htm#IncludeExcludeFields)。
- 不要丢弃数据源中未可视化的列。在分析标记时，“数据解释”功能会考虑基础数据中的字段。
- 低基数维度效果更好。如果分类维度的基数不太高（少于 20 个类别），则其解释更易于解读。不会考虑将包含超过 500 个唯一值的维度用于分析。
- 作为一般规则，不要预先聚合数据。但是，如果数据源很大，请考虑将数据预先聚合到适当的详细级别。
- 在实时数据源上使用数据提取。与实时数据源相比，数据提取运行速度更快。使用实时数据源，创建解释的过程可能会创建多个查询（大致为每个候选解释一个查询），这可能会导致解释要更长的时间才能生成。

## “数据解释”功能不可用的情况

有时“数据解释”功能对于所选标记将不可用，具体取决于数据源或视图的特征。如果“数据解释”功能无法分析所选标记，则“数据解释”图标和上下文菜单命令将不可用。

<table class="table--stripes"><colgroup><col style="width: 40%;"><col style="width: 60%;"></colgroup><tbody><tr><td>“数据解释”功能无法在使用以下各项的视图中运行：</td><td><ul><li>地图坐标筛选器</li><li>混合数据源</li><li>带参数的数据源</li><li>不支持 COUNTD 或 COUNT(DISTINCT ...) 语法的数据源，例如 Access。</li><li>聚合度量上的筛选器</li><li>解聚的度量<br></li></ul></td></tr><tr><td><p>如果选择以下各项，“数据解释”功能将无法运行：</p></td><td><ul><li>多个标记</li><li>轴</li><li>图例</li><li>总计</li><li>趋势线或参考线</li><li>包含很少量标记的视图中的标记</li></ul></td></tr><tr><td>当要用于解释的度量满足以下条件时，“数据解释”功能无法运行：</td><td><ul><li>未使用 SUM、AVG、COUNT、COUNTD 聚合</li><li>是表计算</li><li>在度量值中使用</li></ul></td></tr><tr><td><p>当维度满足以下条件时，“数据解释”功能无法为其提供解释：</p></td><td><ul><li>是计算字段</li><li>是参数</li><li>在度量名称和度量值中使用</li><li>包含超过 500 个唯一值的字段。不会考虑将包含超过 500 个唯一值的维度用于分析。</li></ul></td></tr></tbody></table>

<!-- document id=4e1fd5a43725f9fa9e589674bb3f5a89178452eb140a76e25c1153ab7103e51f url=/tableau/next/zh-cn/online/ask_data.md -->

[跳转到主要内容](#main-content)

# 使用“数据问答”（Ask Data）功能自动生成视图

**“数据问答”(Ask Data) 功能和指标的重要变化**

Tableau 的“数据问答”(Ask Data) 和指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见 [Tableau AI 和 Tableau Pulse 如何重新构想数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-gpt)。

通过“数据问答”(Ask Data) 功能，您可以用通用语言键入问题，并立即在 Tableau 中获得答复。答案以自动数据可视化项的形式体现，不再需要手动拖放字段或了解数据结构的细微差别。

利用对诸如时间系列和空间分析这样的关键分析概念的支持，以及对诸如“last year”（去年）和“most popular”（最热门）这样的对话短语的理解，“数据问答”（Ask Data）使您能自然地提出复杂的问题。  
  
![使用“数据问答”(Ask Data) 功能创建可视化项](/tableau/next/zh-cn/online/zh-cn/Img/askdata_1.gif)  

## 导航到“数据问答”(Ask Data) 功能镜头

在使用“数据问答”(Ask Data) 功能查询数据源之前， [Tableau 作者必须首先创建一个镜头](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_lenses.htm)，该镜头指定镜头使用的数据字段的子集。

在 Tableau 中，以下是可以访问“数据问答”(Ask Data) 功能镜头的所有位置：

- 在 Tableau Cloud 或 Tableau Server 站点顶级的“所有镜头”页面上。
    
    ![“数据问答”(Ask Data) 功能的广告活动和运输分析镜头。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_all_lenses.png)
- 在已为其创建镜头的数据源的“数据问答 (Ask Data) 功能”选项卡上
    
    ![Super Store 数据源页面显示，其中突出显示三个连接的镜头选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_connected_lenses.png)
- 在仪表板上的“数据问答”(Ask Data) 功能对象中。
    
    ![带有地图、散点图和客户排名列表的仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_in_dashboard.png)

## 镜头页面或仪表板对象中的“数据问答”(Ask Data) 功能

### 导航到镜头并了解有关其数据的更多信息

1. 通过 Tableau 站点的“所有镜头”页面，数据源的“数据问答”(Ask Data) 功能选项卡或仪表板上的“数据问答”(Ask Data) 功能对象导航到镜头。
2. （可选）在“建议的可视化项”下，单击条目以快速查看镜头作者为您的组织创建的可视化项。
    
    如果这些建议不能满足您当前的数据分析需求，请[构建一个查询](#Build)来创建您自己的问题。
3. 在左侧的“数据”窗格中，将鼠标悬停在每个字段上以了解有关其包含的数据的详细信息。
    
    ![可视化项在侧窗格中突出显示了国家/地区字符串，并显示了国家/地区详细信息，包括唯一国家/地区值的数量和国家/地区名称列表。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_tooltip.png)
    
    在较窄的仪表板对象中，“数据”窗格可能是隐藏的，但是您可以通过单击“字段”下拉菜单来查看相同的信息。
    
    ![突出显示“字段”菜单的仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_dashboard_fields.png)

### 通过输入文本构建查询

1. 请在“搜索字段或值以创建可视化项”框中键入。
    
    ![用于向可视化项中添加字段或值的搜索字段。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_ask_textbox.png)
2. 在您键入时，“数据问答”(Ask Data) 功能会搜索数据字段、函数和字符串值，并在下拉列表中显示结果。单击列表中的项将它们添加到当前条目中，显示在搜索框上方。若要使用当前条目自动创建可视化项，请随时按 Enter。
    
    ![用于搜索的“数据问答”(Ask Data) 功能 UI，其中显示自动填充下拉菜单](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_entity_search.png)
    
    通过搜索字段和分析函数来修改查询
    
    A. 当前条目 B. 当前筛选器 C. 搜索框 D. 返回的字段 E. 返回的分析函数 F. 返回的字段值

### 通过添加建议的短语来构建查询

Tableau 将根据您镜头中和组织中其他人提出的最常见的查询来推荐短语。当您打开镜头时，您会注意到一些建议，它们会帮助您快速找到常见问题的答案。

您可以通过单击将这些建议添加到您的查询中。当您向查询中添加短语时，建议会随着更相关的短语动态更新。视图会随着每次选择自动构建。  
  
![使用“数据问答”(Ask Data) 功能创建可视化项](/tableau/next/zh-cn/online/zh-cn/Img/askdata_2.gif)  

### 通过添加字段和筛选器来构建查询

1. 单击“添加字段”或“添加筛选器”。
    
    ![“数据问答”(Ask Data) 功能短语生成器，其中突出显示了“添加字段”和“添加筛选器”选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_click_phrasebuilder.png)
2. 单击所需的字段。（若要缩小长列表的范围，请先在“搜索字段”框中键入。）
    
    ![“数据问答”(Ask Data) 功能短语生成器，选择了“Sales”（销售额）指标进行可视化。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_click_phrasebuilder_2.png)
3. 设置任何子选项（例如数字字段的聚合类型，或字符串和日期字段的分组）。
4. 若要添加更多字段或筛选器，请单击加号。
    
    ![突出显示加号图标的“数据问答”(Ask Data) 功能短语生成器。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_click_phrasebuilder_3.png)

### 查看查询元素的应用方式

若要查看查询的元素的应用方式，请将鼠标悬停在文本框中的元素上或其上方的解释上。未使用的词会变灰，帮助您以对“数据问答”(Ask Data) 功能更清晰的方式重新表述查询。

![“数据问答”(Ask Data) 功能映射。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_mapping.gif)

## 改写你的问题

您可以通过在用户界面中单击相关选项、数据字段和筛选器来调整问题的措辞。

### 更改可视化项类型

如果默认可视化项未完全显示您的数据，请单击右上方的菜单，然后从支持的可视化项类型中进行选择：

- 条形图
- 甘特条
- 热图
- 直方图
- 折线图
- 地图
- 饼图
- 散点图
- 堆叠条形图
- 文本表
- 树状图

![美国地图的可视化项显示了每个城市的平均利润，并突出显示了下拉菜单以显示用于更改可视化项类型的以下选项：地图、条形图、文本表、堆叠条形图、热图和树状图。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_viz_change.png)

**注意：**为了自动创建特定可视化项类型，“数据问答”（Ask Data）有时会向输入内容中添加诸如“Number of Records”（记录数）这样的字段。

### 更改字段、筛选器和显示的数据

“数据问答”（Ask Data）为您提供了若干方式来微调字段的显示方式。

- 若要切换用于垂直轴和水平轴的字段，请单击可视化项选择菜单左侧的“交换轴”按钮 ![“交换轴”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/environ_swap.png)：
    
    ![交换轴图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_swap_axes_context.png)
- 若要更改字段，请先在查询条目中单击它，然后单击下面的字段名称。（若要更改差异计算中使用的字段，请参见[比较随时间发生的变化](#Compare)。）
    
    ![突出显示了二氧化碳排放量指标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_change_field.png)
- 若要更改字段的聚合或分组类型（例如，从平均值更改为总和），请在文本框中单击字段名称，然后选择不同的聚合或分组。
    
    ![显示总和、平均值或中位数的聚合方法选择选项（已选择平均值）。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_aggtype_short.png)
- 对于分类筛选器，请单击值（例如下面的示例中的“排除美国”）以更改特定值或输入通配符参数。
    
    ![显示“数据问答”(Ask Data) 功能筛选器调整，其中排除了国家/地区值。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_adjust_filter.png)
- 若要调整数值范围，请单击诸如“high”（高）或“cheap”（便宜）这样的单词。
    
    ![显示“数据问答”(Ask Data) 功能筛选器调整，其中包含利润范围调整选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_adjust_range.png)
- 若要删除某个字段或筛选器，请将光标悬停在其上，并单击“X”。

### 调整日期筛选器

若要调整相对日期筛选器，请单击诸如“last”（最后一个）或“previous”（上一个）这样的单词。然后单击以下各项之一：

- 特定日期：用于输入特定时间段或日期值
- 相对日期：用于显示相对于当前日期的日期范围
- 日期范围：用于输入特定起点和终点

“特定日期”在“日期详细信息”菜单中提供了独特的选项：

- “时间段”选项显示单个连续日期范围
- “日期值”选项显示可以在多个时间段内重复的范围。例如，若要查看多年第 1 季度的综合销售业绩，请在“日期值”下选择“季度”。

![用于特定日期的日期筛选器对话框。 ](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_specific_date.png)

## 比较随时间发生的变化

“数据问答”（Ask Data）功能允许您使用诸如“year over year”（年同比）或“quarter over quarter”（季度环比）等短语来比较时间段。在从“数据问答”（Ask Data）功能保存的工作簿中，结果显示为差异或差异表计算百分比。

![显示订单日期销售总额的同比差异的折线图，突出显示同比差异。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_yoy.png)

在文本框中，单击差异计算以选择其他字段、聚合方法和时间段。

![对话框显示用于计算订单日期或发货日期的平均销售额差异的选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_yoy_revise.png)

## 应用简单的计算

“数据问答”（Ask Data）功能支持两个度量值之间的简单计算，您可以使用以下符号来应用计算 ：

+ 对度量进行加总

\- 得出度量的差

\* 乘

/ 除

在通过“数据问答”（Ask Data）功能保存的工作簿中，这些计算未成为计算字段，而是成为了“列”、“行”或“标记”功能区上的临时计算。

![突出显示了“数据问答”(Ask Data) 功能计算选项的可视化项，其中显示了利润总额除以销售额总额的等式。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_calculations.png)

## 添加包含其他可视化项的工作表

若要通过一个镜头快速创建多个不同的可视化项，请在“数据问答”(Ask Data) 功能中添加工作表。

在网页底部，执行以下任何操作：

- 单击指定工作表右侧的“添加工作表”图标。
    
    ![标有 Sheet 1 和 Sheet 2 的工作表标签，带有用于添加新工作表的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_sheets.png)
- 右键单击工作表名称，并选择“复制”或“删除”。
    
    （若要从“数据问答”（Ask Data）功能中重命名工作表，您需要将它们保存在新工作簿中。）

## 通过电子邮件、Slack 或链接共享“数据问答”(Ask Data) 功能可视化项

您可以与有权访问镜头的任何人快速共享“数据问答”(Ask Data) 功能可视化项。

1. 在浏览器的右上角，单击“共享”图标。
    
    ![“共享”图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_link.png)
2. 执行以下操作之一：

- 若要通过电子邮件或 Slack 共享可视化项，请在文本框中输入特定用户名。（电子邮件和 Slack 集成必须事先由您的 Tableau 管理员配置。）
- 若要复制可以粘贴到自定义电子邮件和其他消息中的 URL，请单击“复制链接”。

## 发送反馈给镜头所有者

如果您对镜头的结构或如何最好地将其与“数据问答”(Ask Data) 功能结合使用有疑问，可以将反馈直接发送给作者。（此选项默认情况下处于启用状态，但是镜头作者可以禁用它。）

1. 在“数据问答”(Ask Data) 功能查询框的左侧，单击“数据问答提示”图标。
    
    ![将鼠标悬停在信息图标上，显示“数据问答”(Ask Data) 功能提示工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_tips_button.png)
2. 在提示对话框底部，单击“联系镜头作者”。

## 成功查询的提示

在为“数据问答”(Ask Data) 功能构建问题时，应用这些提示以获得更好的结果。

- **使用关键字** — 例如，请尝试“by airport and country”（按机场和国家/地区），而不是“I want to see all the countries that these airports are in”（我想要查看这些机场所在的所有国家/地区）。
- **为字段名和值使用精确的措辞** — 举例来说，如果您的镜头包括“Airport Code”（机场代码）、“Airport Name”（机场名称）和“Airport Region”（机场区域）字段，请通过名称指定这些字段。
- **查看排名表** —“数据问答”(Ask Data) 可能会将诸如“best”（最好）和“worst”（最坏）这样的词语分别映射到“Top 1”（第 1 名）和“Bottom 1”（最后 1 名）。如果要查看更广泛的排名，请改用“high”（高）和“low”（低）。例如，输入“houses with low sale prices”。
- **查询表计算** — 在表计算字段的查询表达式中，请注意您不能筛选、限制或包含“年同比差异”。
- **将超长的值放在引号内** — 如果要分析包含换行符、制表符或超过十个单词的长字段值，请将它们放在引号内。为了提高性能，“数据问答”(Ask Data) 功能不会为该长度的字段或前 200,000 个唯一字段值以外的任何字段建立索引。

## 此部分中的其他文章

<!-- document id=f286171cb33ef43a58effed1a1aa0f2a120df7889c54c0c660be2d0d43279802 url=/tableau/next/zh-cn/online/lwc_seamless_auth.md -->

[跳转到主要内容](#main-content)

# 使用令牌身份验证配置 Tableau Lightning Web 组件和单点登录 (SSO)

Tableau Lightning Web 组件 (LWC) 允许 Salesforce 客户将 Tableau 视图和 Tableau Pulse 指标拖放到 Salesforce Lightning 页面上。

- Tableau 视图组件允许您从 Tableau Cloud 或 Tableau Server 添加嵌入视图。
- Tableau Pulse 组件允许您添加来自 Tableau Cloud 的嵌入式 Tableau Pulse 指标。

Tableau LWC 无缝身份验证允许您使用已连接应用可信令牌查看 Tableau 内容，而无需登录。无缝身份验证对于 Tableau 视图 LWC 是可选的，对于 Tableau Pulse LWC 是必需的。

> [!IMPORTANT]
> 
> **重要信息**：  
> • [Salesforce 控制台](https://help.salesforce.com/s/articleView?id=sf.console2_about.htm&type=5)应用程序不支持使用 Tableau Lightning Web 组件。  
> • 案例记录页面不支持将 Tableau Lightning Web 组件与 Chatter 电子邮件一起使用。

## 添加可信 URL

您想要添加到 Lightning 页面的 Tableau 视图或 Pulse URL 必须以可信 URL 的形式添加。

1. 从您的 Salesforce 应用中，选择右上角的齿轮，然后选择“Setup”（设置）。
2. 在左侧导航窗格的“快速查找”搜索栏中输入“可信 URL”。
3. 选择“可信 URL”设置页面。
4. 选择“新的可信 URL”。
5. 按照设置页面上的说明输入“API 名称”和“URL”。**注意**：URL 必须以 https:// 开头
6. 对于“CSP 上下文”，选择“全部”。
7. 对于“CSP 指令”，请选中所有复选框。
8. 选择“保存”。

## 为 Tableau LWC 启用无缝身份验证

Tableau 视图和 Tableau Pulse LWC 可在 Lightning App Builder 中使用，无需任何配置。但是，Tableau Pulse LWC 需要令牌身份验证才能运行。

### 配置 Salesforce 设置

以下步骤只需由一名 Salesforce 管理员完成一次：

1. 从您的 Salesforce 应用程序中，选择右上角的齿轮，然后选择“设置”。
2. 在左侧导航窗格的“Quick Find”（快速查找）搜索栏中输入“Tableau”。
3. 选择“Tableau Embedding”设置页面。
4. 选中“打开基于令牌的单点登录身份验证”复选框。
    
    **注意**：必须选中此复选框才能配置 Tableau Pulse LWC。对于 Tableau View LWC，您可以选择不设置令牌身份验证，而是在组件加载时手动登录。  
      
    若要在 Mobile 上使用 Tableau View LWC，您必须打开基于令牌的身份验证并设置无缝身份验证。
5. 对于“选择 Tableau 用户身份”字段，设置组织级别用户字段以对 Tableau 中的用户进行身份验证。您必须选择与 Tableau 用户名对应的 Salesforce 用户字段。下拉列表显示当前用户的字段值，如果未定义值，则显示 null。如果没有任何用户字段与 Tableau 用户名匹配，请选择一个空字段（例如，联合 ID 或自定义字段）。然后，使用您的用户的 Tableau 用户名填充空字段。
    
    **注意**：Tableau 用户身份字段设置适用于所有用户，不需要单独设置。
6. 保存所做的更改。
7. 如果您是 Tableau 管理员，请在下一部分中配置 Tableau 设置时保持 Salesforce 设置“Tableau 嵌入”选项卡打开。如果您不是管理员，请与您的 Tableau 管理员共享问题 URL 和 JWKS URI。

> [!TIP]
> 
> **提示**：Tableau 用户身份字段设置适用于所有用户，不需要单独设置。

### 配置 Tableau 设置

在一个选项卡中，打开 Salesforce 组织中的 Tableau Embedding 设置页面。在另一个选项卡中，转到您的 Tableau 站点并按照这些说明设置已连接应用。

对于 Tableau Server，执行以下步骤：

1. 以 Tableau Server 管理员身份登录到 Tableau 服务管理器 (TSM) Web 界面。
2. 导航到“用户身份和访问”，然后选择“授权服务器”选项卡。
3. 选中“为嵌入内容启用 OAuth 访问权限”复选框。
4. 输入“问题 URL”和“JWKS URI”，您可以在 Salesforce 组织的 Tableau Embedding 设置页面上找到这两项。使用 Salesforce 组织设置页面上的“复制”按钮复制颁发者 URL 值，然后将其粘贴到 TSM Web 界面。对 JWKS URI 值重复此过程。

**注意**：JWKS URI 字段在 TSM Web 界面中标记为可选，但使用 Tableau LWC 无缝身份验证需要该值。Tableau Server 需要能够访问 JWKS URI 才能成功进行无缝身份验证。

6. 选择“保存未完成的更改”。
7. 在页面的右下角选择“未完成的更改”，然后选择“应用更改并重新启动”以停止并重新启动 Tableau Server。

有关详细信息，请参见[向 Tableau Server 注册您的 EAS](https://help.tableau.com/current/server/zh-cn/connected_apps_eas.htm#step-2-register-your-eas-with--tableau-server)。

对于 Tableau Cloud，执行以下步骤：

1. 打开 Tableau 的“设置”页面，然后选择“已连接应用”选项卡。
2. 从“新已连接应用”下拉列表中，选择“OAuth 2.0 Trust”。
3. 在“创建已连接应用”对话框中，输入“问题 URL”和“JWKS URI”，您可以在 Salesforce 组织的 Tableau View Embedding 设置页面上找到这两项。使用 Salesforce 组织设置页面上的“复制”按钮复制颁发者 URL 值，然后将其粘贴到 Tableau 设置页面。对 JWKS URI 值重复此过程。

> [!IMPORTANT]
> 
> **重要信息：** “创建已连接应用”对话框将 JWKS URI 字段标记为可选，但使用 Tableau LWC 无缝身份验证需要该值。

5. 选中“启用已连接应用”复选框。
6. 选择“创建”。

**注意：**“已连接应用程序”被命名为“外部授权服务器”。

有关详细信息，请参见[向 Tableau Cloud 注册您的 EAS](https://help.tableau.com/current/online/zh-cn/connected_apps_eas.htm?_gl=1*1rfpjn7*_ga*NDAxMzE5Mi4xNjg5ODczMzE5*_ga_8YLN0SNXVS*TmVlZHMgR1RNIENvbmZpZ3VyYXRpb24uMi4xLjE2ODk4ODkwMDAuMC4wLjA.#step-2-register-your-eas-with--tableau-cloud)。

如果要为此站点创建主机映射，请将“已连接应用”选项卡保持打开状态。您可以使用此页面的 URL 和“复制站点 ID”按钮来填充以下部分中的主机映射字段。

## 允许捕获用户属性（仅限 Tableau Cloud）

若要将[用户属性函数](https://help.tableau.com/current/online/zh-cn/lwc_uaf.htm)与 Tableau LWC 一起使用，您必须在身份验证工作流中启用访问。

1. 打开 Tableau 的“设置”页面，然后选择“身份验证”选项卡。
2. 导航至“在身份验证工作流程中控制用户访问”部分。
3. 选中“在身份验证工作流中启用用户属性捕获”复选框。

## 设置或编辑主机映射

在设置 Tableau LWC 时，了解主机映射和站点 ID 的工作方式以及身份验证选项如何影响配置非常重要。

主机映射是可选的，但对于初次使用的用户来说是一项有用的功能，因为它允许用户避免在组件面板中输入站点 ID。本质上，它将特定 Tableau 站点映射到其对应的站点 Id，因此当有人嵌入来自具有现有主机映射的站点的视图时，他们无需手动输入站点 ID。如果同时指定了主机映射和站点 ID，则主机映射优先。

对于身份验证：

- **Tableau 服务器范围身份验证**不应自动添加站点 ID。
- **Tableau 站点范围身份验证**应添加站点 ID 以确保正确访问。

按照以下步骤创建或编辑主机映射。

### 创建新的主机映射

1. 从您的 Salesforce 应用中，选择右上角的齿轮，然后选择“Setup”（设置）。
2. 在左侧导航窗格的“Quick Find”（快速查找）搜索栏中输入“Tableau”。
3. 选择“Tableau Embedding”设置页面。
4. 从“Tableau 主机映射”部分，选择“新建”。
5. 填写主机映射详细信息：
    
    1. **Tableau 站点 URL**：输入要映射的 Tableau 站点的 URL。URL 应包含站点名称，除非它是使用“默认”站点的本地安装。
        
        Tableau 站点 URL 应类似于以下各项之一：
        
        - `https://<CloudPOD>.online.tableau.com/#/site/SITENAME/`
        - `https://<CloudPOD>.online.tableau.com/#/site/SITENAME/Home`
        - `https://<CloudPOD>.online.tableau.com/#/site/SITESAML/connectedApplications`
    2. **Tableau 站点 ID**：输入要映射的 Tableau 站点的站点 ID。您可以使用“已连接应用”设置页面或“共享”对话框上的“复制站点 ID”按钮。
    3. **Tableau 站点主机类型**：选择“Tableau Cloud”、“Tableau Server（站点级 EAS）” 或 “Tableau Server（服务器范围的 EAS）”。
    
    **注意**：如果要为此站点创建主机映射，请将“已连接应用”选项卡保持打开状态。您可以使用此页面的 URL 和“复制站点 ID”按钮来填充以下部分中的主机映射字段。
6. 选择“保存”。或者，如果要返回 Tableau 嵌入设置页面而不保存，请选择“取消”。

### 编辑主机映射

**注意**：如果您保存了版本 254.10 之前中的主机映射，则必须更新 Tableau 主机类型。有关详细信息和补救说明，请参见[更新已保存的 Tableau 主机映射的主机类型](#Update)。

您可以更新现有映射的站点 ID 和主机类型。如果您需要更改站点 URL，请删除现有映射，然后使用正确的 URL 创建一个新映射。

1. 在 Salesforce 应用 Tableau 嵌入设置页面中，选择现有主机映射旁边的“编辑”。
2. 根据需要编辑“Tableau 站点 ID”或“Tableau 站点主机类型”字段。
3. 选择“保存”。或者，如果要返回 Tableau 嵌入设置页面而不保存，请选择“取消”。

## 创建用户属性声明定义

您可以将用户属性函数 (UAF) 与 Tableau 视图和 Pulse Lightning Web 组件 (LWC) 一起使用，根据查看可视化项的用户的属性显示特定数据。有关详细信息，请参见[将用户属性函数 (UAF) 与 Tableau Lightning Web 组件一起使用](https://help.tableau.com/current/online/zh-cn/lwc_uaf.htm)。

## 使用 Lightning 应用程序生成器将 Tableau LWC 添加到 Lightning 页面

Tableau LWC 仅在“应用”、“主页”和“记录”Lightning 页面上可用。有关 Lightning 页面类型和使用 Lightning 应用程序生成器的详细信息，请参阅 Salesforce 帮助中的“Lightning 应用程序生成器”。

**注意：**案例记录页面不支持将 Tableau Lightning Web 组件与 Chatter 电子邮件一起使用。

若要将 Tableau 视图或 Tableau Pulse LWC 添加到现有 Lightning 页面，请执行以下步骤：

1. 导航到要编辑的 Lightning 页面。
2. 选择右上角的齿轮图标。
3. 选择“编辑页面”。
4. 继续执行下面的**“将 Tableau LWC 添加到 Lightning 页面”**部分。

若要将 Tableau 视图或 Tableau Pulse LWC 添加到新的 Lightning 页面，请执行以下步骤：

1. 从您的 Salesforce 应用中，选择右上角的齿轮，然后选择“Setup”（设置）。
2. 在左侧导航窗格的“快速查找”搜索栏中输入“Lightning 应用程序生成器”。
3. 选择“Lightning 应用程序生成器”设置页面。
4. 选择“新建”。
5. 选择要创建的页面类型。Tableau LWC 在“应用”、“主页”和“记录”页面上可用。
6. 选择“下一步”。
7. 输入名称并选择新页面的布局，然后选择“完成” 。

### 将 Tableau LWC 添加到 Lightning 页面

1. 从页面左侧的“组件”列表中，将 Tableau 视图或 Tableau Pulse 组件拖放到页面上。
2. 配置 LWC：
    - [配置 Tableau 视图 Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_tableau_view.htm)
    - [配置 Tableau Pulse Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_tableau_pulse.htm)

### 保存并激活页面

1. 添加和配置 Tableau 视图或 Tableau Pulse LWC 后，选择“保存”。
2. 如果您创建了新页面，系统会提示您激活该页面，以便用户可以看到它。选择“激活”。
3. 在“激活”页面的“页面设置”选项卡上，输入名称，选择图标，然后选择您的可见性首选项。
4. （可选）在“激活”页面的“Lightning Experience”选项卡上，您可以将该页面添加到各种 Lightning Experience 应用。
5. （可选）：在“激活”页面的“移动导航”选项卡上，您可以将页面添加到移动导航菜单。
6. 选择“保存”。

## 可组合 Tableau Lightning Web 组件

Tableau Lightning Web 组件现在是可组合的，允许其嵌入到自定义 Lightning Web 组件和更灵活的页面布局中。

这使开发人员能够将 Tableau 可视化项作为 Salesforce 中更大的定制体验的一部分，而不是局限于在页面上的独立放置。该组件可以在其他 LWC 中使用，并根据应用程序逻辑动态渲染。

在可组合上下文中使用 Tableau LWC 时，请确保无缝身份验证所需的所有配置仍然到位，包括：

- 已连接应用配置
- 可信 URL
- JWT 身份验证设置
- 主机映射和用户属性函数 (UAF) 配置

可组合用法遵循与标准用法相同的身份验证和数据访问模式。

## 嵌入多个 Tableau 视图

您可以在 Salesforce Lightning 页面上嵌入多个 Tableau 视图，只要所有视图都来自同一站点。Tableau 仅支持单个会话，并且该会话特定于站点。最近授予的会话将清除前一个会话。

若要嵌入来自多个站点的 Tableau 视图，您必须创建一个特定于站点的单独 Lightning 页面。

## 适用于移动设备的 Tableau LWC 单点登录

**注意：**Tableau 视图和 Pulse LWC 在 iOS 17.2.1+ 上可用。

请考虑以下最佳实践来防止移动用户出现问题：

- Lightning 页面类型：移动用户可以访问应用程序页面和记录页面，但不能访问主页。  
    
    **注意：**记录页面必须与特定类型的记录相关联。
- 如果您为台式机和移动设备用户使用同一页面，请选择“激活”以验证 Lightning 页面是否已设置为台式机和手机外形规格的组织默认值。
- 考虑为台式机和移动设备创建单独的 Lightning 页面，以提供量身定制的视觉体验。Tableau 视图组件的高度是固定的，不会动态调整以适应不同的屏幕尺寸。
- 若要向视图中添加滚动条，请从 Tableau 视图组件属性窗格中选择“显示工具栏”。
- 对于“应用程序页面”类型，选择“激活”，然后选择“Lightning Experience”选项卡。将您的页面添加到 LightningBolt 列表，以便更轻松地在移动设备上找到该页面。
- 在移动设备上，iOS 默认情况下会阻止跨站点流量。打开您的移动设备设置，选择 Salesforce 设置，然后启用“允许跨网站跟踪”。有关详细信息，请参见[启用跨网站跟踪](https://help.salesforce.com/s/articleView?id=sf.branded_apps_cross_site_tracking.htm&type=5)。

## 使用令牌身份验证对 Tableau LWC SSO 进行故障排除

### 更新已保存的 Tableau 主机映射的主机类型

如果您保存了版本 254.10 之前中的主机映射，则必须更新 Tableau 主机类型。

1. 在“Tableau 嵌入”设置页面中，验证您保存的主机映射是否具有以下 Tableau 主机类型之一： “Tableau Cloud”、“Tableau Server（服务器范围的 EAS）”， 或者“Tableau Server（站点级 EAS）”。
2. 如果映射具有其他 Tableau 主机类型（例如 TABLEAU\_CLOUD 或 TABLEAU\_SERVER），请选择“编辑”以编辑主机映射。
3. 在“编辑 Tableau 主机映射”页面上，从 Tableau 站点主机类型下拉列表中选择适当的设置，然后选择“保存”。
4. 根据需要为所有已保存映射重复步骤 1-3。

### 验证 Salesforce 和 Tableau 配置

1. 验证 Salesforce 和 Tableau 设置中的颁发者 URL 和 JWKS URI值是否匹配，并且 JWKS URI 以 id/keys 结尾。
    
    - 对于 Tableau Cloud，在一个选项卡中打开“Salesforce 设置 Tableau Embedding”页面。在另一个选项卡中，打开“Tableau 设置已连接应用”选项卡。在“已连接应用”选项卡上，选择“外部授权服务器”，然后选择“编辑”。验证颁发者 URL 和 JWKS URI 值是否匹配，并且 JWKS URI 以 id/keys 结尾。
    - 对于 Tableau Server，在一个选项卡中打开“Salesforce 设置 Tableau Embedding”页面。然后，登录到 Tableau 服务管理器 (TSM) Web 界面，导航到“用户身份和访问”，然后打开“授权服务器”选项卡。
2. 验证主机映射：如果您已保存主机映射，请验证它是否具有正确的站点 ID 和主机类型。

### 验证 JWT 令牌

在 Tableau 视图 Lightning Web 组件属性编辑器中，选择“调试模式”以验证 JWT 令牌是否按预期工作。

1. 打开控制台日志并复制令牌。
2. 访问 [jwt.io](https://jwt.io/) 网站并将令牌粘贴到“Encoded”（编码）字段中。
3. 验证以下内容：

- 主体（“sub”）与 Tableau 用户名匹配。
- 对于 Tableau Cloud 和 Tableau Server（站点级 EAS），受众（“aud”）为“tableau: {site ID}”。  
    对于 Tableau Server（服务器范围的 EAS），受众 (“aud”) 为“tableau”。
- 范围（“scp”）包括“tableau:views:embed”和“tableau:insights:embed”。
- 颁发者（“iss”）EAS 服务器是准确的。

### 验证页面激活

有时，用户创建了 Lightning 页面，但尚未在任何地方激活或分配，因此用户无法找到它。选择“激活”以验证 Lightning 页面是否已设置为预期外形规格的组织默认值。

> [!TIP]
> 
> **提示：**调试时，将富文本组件拖放到页面上会很有帮助。添加页面类型的简短描述以及您尝试嵌入的视图 URL。这使您可以确保最终用户正在查看的页面是管理员正在编辑的页面。

### 确认 Tableau 视图 LWC 在没有无缝身份验证的情况下正常工作（仅限 Tableau 视图 LWC）

1. 在 Lightning 页面上的“Tableau 视图”窗格中，清除“启用单点登录”复选框，然后保存更改。
2. 对于 Tableau Server，请验证“站点 ID”字段是否为空。
3. 如果您在另一个选项卡中登录到 Tableau，请注销。确保导航到视图 URL 将您重定向到 Tableau 登录页面。不要登录。
4. 导航到 Lightning 页面。Tableau 视图 LWC 应显示“登录 Tableau”按钮。
5. 选择“登录 Tableau”，然后输入您的 Tableau 凭据以登录。  
    **注意：**如果视图没有加载，这表明对 Tableau 进行身份验证存在更广泛的问题。

### 错误：不再支持 LWC 组件版本（仅限 Tableau 视图 LWC）

若要解决此错误，请执行以下步骤：

1. 在“组件”列表中，搜索“Tableau”，然后将新的“Tableau 视图”组件拖放到页面上。
2. 将旧组件的 Tableau 视图窗格中的所有属性复制到新组件。
3. 选择旧组件上的删除图标。

### 错误：若要启用 Tableau Pulse LWC，请联系您的 Salesforce 管理员为 Tableau 配置无缝身份验证（仅限 Tableau Pulse LWC）

若要解决此错误，请按照此页面上的步骤**为 Tableau LWC 启用无缝身份验证**。

## 另请参见

[对已连接应用进行故障排除](https://help.tableau.com/current/online/zh-cn/connected_apps_troubleshoot.htm#)

[注册 EAS 以启用嵌入内容的 SSO](https://help.tableau.com/current/server/zh-cn/connected_apps_eas.htm)

<!-- document id=b780f0eacee6a819d1a7b95a659d8e693952ab25d99ed5bd78c3ee1ac30493ce url=/tableau/next/zh-cn/online/dashboard_extensions.md -->

[跳转到主要内容](#main-content)

# 使用仪表板扩展程序

扩展程序使您能向仪表板中添加独特的功能，或直接将它们与 Tableau 外部的应用程序集成。添加扩展程序很容易；只需像加入其他仪表板对象一样将它们加入仪表板布局即可。

借助第三方开发者创建的 Web 应用程序的帮助，扩展程序可以扩展仪表板的功能。如果您是开发者，并且想要创建自己的扩展程序，请参见 GitHub 上的 [Tableau Extensions API 文档](https://tableau.github.io/extensions-api/)。

**注意**：Tableau 管理员可为 [Tableau Desktop](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_setting_changes.htm#dashboard_extensions)、[Tableau Server](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm) 和 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dashboard_extensions_server.htm) 关闭仪表板扩展程序。

## 向仪表板中添加扩展程序

1. 在 Tableau 工作簿中，打开一个仪表板工作表。
2. 从“对象”部分将“扩展程序”拖到仪表板中。
    
    ![显示如何向仪表板添加扩展程序的箭头。](/tableau/next/zh-cn/online/zh-cn/Img/dashboard_extension_add.png)
3. 在“添加扩展程序”对话框中，执行以下任一操作：
    
    - 搜索和选择应用程序。
    - 单击“访问本地扩展程序”，并导航到之前下载的 .trex 文件。
4. 如果出现提示，请允许或拒绝仪表板扩展程序访问工作簿中的数据。有关详细信息，请参见[数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序](#Data)。
    
    如果您允许访问，请按照屏幕上任何说明进行操作来配置扩展程序。
    
    **注意：**如果您使用的是 Tableau Server 或 Tableau Cloud，在打印件、PDF 和仪表板的图像（包括订阅电子邮件中的图像）中，扩展程序对象将显示为空白。

### 配置仪表板扩展程序

某些仪表板扩展程序提供配置选项，使您能自定义功能。

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“配置”。
2. 按照屏幕上的说明进行操作来配置扩展程序。
    
    ![用于在仪表板上配置扩展程序的上下文菜单。](/tableau/next/zh-cn/online/zh-cn/Img/dashboard_extension_configure.png)

### 重新加载仪表板扩展程序

如果仪表板扩展程序失去响应，您可能需要重新加载扩展程序，这类似于在浏览器中刷新网页。

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“重新加载”。
    
    仪表板扩展程序将刷新，并会设置为其原始状态。
2. 如果重新加载扩展程序未能将其恢复到可用状态，请尝试从仪表板中将其移除，并再次添加。

## 数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序

扩展程序是采用两种标准的 Web 应用程序：

- _Tableau 可信扩展程序_已由 Tableau 管理的主机专门审查并部署在其中。其中包括由 Tableau 开发和管理的扩展程序、由 Tableau Exchange 合作伙伴构建并使用 Tableau 的扩展程序审查和主机服务部署的扩展程序，以及我们旧版沙盒化扩展程序主机内的扩展程序。
- _支持网络的扩展程序_由第三方主机托管。这些扩展程序允许开发人员管理其扩展程序的交付，而无需 Tableau 的中介。其中包括合作伙伴直接管理以提供更好的生产支持的扩展程序、在您的本地网络中托管和部署的扩展程序，以及需要与 Tableau 外部的第三方服务通信的扩展程序。

在您允许支持网络的扩展程序之前，请确保您信任开发人员和托管扩展程序的网站。

默认情况下，扩展程序使用 HTTPS 协议，该协议可保障一条用于发送和接收数据的加密通道，并确保一定的隐私性和安全性。有关使用仪表板扩展程序时的数据安全性的详细信息，请参见[扩展程序安全性 - 部署最佳做法](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。

### 允许或拒绝支持网络的扩展程序

默认情况下，支持网络的扩展程序必须请求运行权限。此权限对话框将提供有关从中托管它的第三方服务器的信息，以及扩展程序所需的数据访问级别。我们建议您在允许运行扩展程序之前查看此信息。

扩展程序通常访问视图中的可见数据。当扩展程序请求“完整数据访问权限”时，它可能会请求工作簿中的更深层次的数据访问权限。这可能包括访问完整的基础数据、数据源中的表和字段名称，以及有关数据源连接的信息。在允许扩展程序在工作簿中运行之前，您应查看扩展程序权限对话框中声明的信息，并决定是要允许还是拒绝扩展程序运行和访问此数据。

如果您要查看的仪表板包含需要完整数据访问权限的扩展程序，而该访问权限被拒绝，则会出现一条消息，而不是扩展程序。如果您信任扩展程序并且想要使用它，您可以重置权限并允许扩展程序运行。

![用于重置仪表板上的扩展程序的上下文菜单。](/tableau/next/zh-cn/online/zh-cn/Img/dashboard_extension_reset_perms.png)

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“重置权限”。
2. 单击“允许”以允许扩展程序运行和访问数据，或单击“拒绝”阻止扩展程序运行。

### 确保在 Tableau Desktop 中启用了 JavaScript

仪表板扩展程序使用 Tableau Extensions API 库（一个 JavaScript 库）与数据交互。如果要使用扩展程序，请确保在仪表板安全设置中启用了 JavaScript：

选择“帮助”\>“设置和性能”\>“设置仪表板 Web 视图安全性”\>“启用 JavaScript”。

## 确保扩展程序在 Tableau Cloud 或 Tableau Server 上运行

您可以将扩展程序添加到从 Tableau Desktop 中发布的工作簿，或直接在 Tableau Cloud 和 Tableau Server 的 Web 制作模式下添加。Tableau 管理员必须允许扩展程序在站点上运行，并将支持网络的扩展程序添加到安全列表。管理员只应允许您测试过并信任的扩展程序。

如果要在 Tableau Cloud 或 Tableau Server 中使用仪表板扩展程序，请指引您的管理员阅读[在 Tableau Cloud 中管理仪表板扩展程序](https://help.tableau.com/current/online/zh-cn/dashboard_extensions_server.htm)或[在 Tableau Server 中管理仪表板扩展程序](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm)。

### 确保扩展程序具有访问工作簿或视图的权限

如果发布包含扩展程序的工作簿，请确保扩展程序能够访问视图中的可见数据。可见数据也称为摘要数据。若要在 Tableau Server 或 Tableau Cloud 上授予此访问权限，请确保工作簿或视图允许“下载摘要数据”的权限。扩展程序不会下载您的数据。扩展程序只需要权限，就可以与视图中的数据交互。

根据您在发布工作簿时是否选择了将工作表显示为标签，您可以在工作簿或视图级别设置“下载摘要数据”权限。如果工作表未显示为标签，则可以在视图级别设置权限。

如果将工作簿或视图发布到 Tableau Public，扩展程序还需要访问可见数据。若要授予权限，请打开“设置”并选择“允许访问”。

### 沙盒化扩展程序支持的 Web 浏览器

沙盒化扩展程序可在支持 [Tableau Server](https://www.tableau.com/zh-cn/products/techspecs#server) 和 [Tableau Cloud](https://www.tableau.com/zh-cn/products/techspecs) 的所有浏览器（除 Internet Explorer 11 外）中运行。

### 沙盒化扩展程序支持的 Tableau Server 版本

您可以在 Tableau Server 2019.4 及更高版本中使用沙盒化扩展程序。

## 获取对第三方和 Tableau 合作伙伴构建的仪表板扩展程序的支持

Tableau 不直接支持 Tableau 合作伙伴构建的扩展程序和第三方扩展程序。但是，如果您需要帮助，您可以在一些地方寻找更多信息。

- Tableau Exchange 上的一些合作伙伴页面提供了直接的**“支持”**链接来为您提供帮助。
- 通过 Tableau Exchange 中的**“开发人员网站链接”**联系扩展程序的创建者。

对于有关 Extensions API 的问题，我们鼓励开发人员通过 [DataDev Slack 频道](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)分享问题并寻求帮助，或[在 GitHub 上提交](https://github.com/tableau/extensions-api/issues) Extension API 的问题。

<!-- document id=c8575d3f4085c37396de3f43d728789992c8e7e6c18dc08810fb8d58f11c44ef url=/tableau/next/zh-cn/online/to_fresh_data_saved_credentials.md -->

[跳转到主要内容](#main-content)

# 使用保存的凭据刷新数据

若要针对 Salesforce、Google Analytics、Google BigQuery、OneDrive、Dropbox、Quickbooks Online、Anaplan、Oracle Eloqua 和 ServiceNow ITSM 使数据保持最新，您必须执行以下操作：

1. 将凭据嵌入数据连接。本主题介绍了这些步骤
2. 如果您的数据源或工作簿包含数据提取，则可以将数据提取添加到刷新计划。有关计划刷新的步骤，请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)。
    
    如果您的数据源或工作簿包含数据直接（实时）连接，则数据始终是最新数据，您不需要创建计划任务来刷新它。

## 将凭据嵌入数据连接

您可以按照以下步骤为连接嵌入凭据。

1. 登录到 Tableau Cloud，并导航到“数据源”页面。
2. 选择包含要刷新的连接的数据源，并在“动作”菜单上选择“编辑连接”。
3. “编辑连接”对话框中的选项将因您选择的数据源而有所不同。查看可用的选项，并选择满足您需求的选项。
    
    如果您选择“提示用户输入 <连接器名称> 凭据”，则需要手动刷新数据。您可以通过要求用户从 Tableau Desktop 重新发布数据源或通过在 Tableau Cloud 上启动刷新任务来执行此操作。

## 特定于连接器的凭据信息

### 使用 OAuth 凭据

使用 Google Analytics、Google BigQuery、Google 表格、OneDrive、Dropbox、Salesforce 和 QuickBooks Online 数据连接的 OAuth 访问令牌进行安全数据连接。只要凭据存在（或手动撤销访问权限），就可以从 Tableau Cloud 登录数据并批准 Tableau Cloud 数据访问权限，从而创建访问令牌。当您添加新帐户时，将会显示登录页面。登录时将为您提交的凭据创建一个新的访问令牌。

注意：Dropbox 使用 OAuth 凭据，但是 Tableau 目前不支持使用 Google 帐户验证 Dropbox。

您可以嵌入共享凭据，就好像在为用户组使用专用数据库帐户的情况下所做的一样。或者，您可以嵌入单独用户的凭据。用于创建访问令牌的帐户必须允许用于运行刷新任务的访问级别。

### 使用其他凭据

Anaplan、Oracle Eloqua 和 ServiceNow ITSM 每个都支持使用保存的凭据（例如用户名和密码）连接到数据。

### 使用 Salesforce 安全令牌

如果嵌入标准 Salesforce 凭据，Salesforce 可能需要安全令牌才允许您访问数据。例如，要从未包含在组织的可信 IP 列表中的 IP 地址访问 Salesforce 连接。此安全令牌必须附加到数据连接中使用的密码。

安全令牌可能会过期。当 Tableau 由于安全令牌过期而无法刷新 Salesforce 连接时，Tableau 将向以下用户显示一条通知：

- 相关工作簿和数据源的作者。
- 连接到相关数据源的工作簿的作者。
- 站点管理员。

可以通过在服务器上编辑数据连接来续订过期的安全令牌。

有关 Salesforce 身份验证和安全令牌的详细信息，请参见 Salesforce.com 上_《SOAP API 开发人员指南》_中的[安全性和 API](https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_concepts_security.htm)。

<!-- document id=b6c62ddbbfbb2be9c28d179c840c68e6e4a7ca8723ba76b5817d34ade486d478 url=/tableau/next/zh-cn/online/datasource_multitable_normalized.md -->

[跳转到主要内容](#main-content)

# 使用关系进行多表数据分析

拖到数据源选项卡画布中的表使用关系。关系是在 Tableau 中合并数据进行分析的一种灵活方法。

将关系视为两个表之间的协定。当您使用这些表中的字段构建可视化项时，Tableau 会使用该协定引入数据，以构建具有适当联接的查询。

我们建议使用关系作为合并数据的第一种方法，因为它使数据准备和分析更加轻松直观。[仅在绝对需要时才使用联接](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_faq.htm#can-i-use-joins-between-logical-tables)。在这个时长 5 分钟的视频中详细了解创建关系的基础知识。

**注意**：本视频中显示的用于编辑关系的界面与当前版本略有不同，但具有相同的功能。

在以下 Tableau 博客文章中详细了解关系的工作方式：

- [关系，第 1 部分：在 Tableau 中引入新的数据建模](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [关系，第 2 部分：提示和技巧](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [关系，第 3 部分：跨多个相关表提出问题](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

另请参见 [Action Analytics](https://action-analytics.com/library/) 中有关关系的视频播客，例如[为什么 Tableau 发明了关系？](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/)单击 [Library（库）](https://action-analytics.com/library/)中的“Video Podcast”（视频播客）以查看更多信息。

在 Tableau 版本 2024.2 及更高版本中，Tableau 数据模型支持多事实分析和通过多事实关系共享维度。有关详细信息，请参见[关于多事实关系数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm)、[何时使用多事实关系模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_when_to_use.htm)和[构建多事实关系数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_build.htm)。

您是否正在构建新的数据源和工作簿？

将表拖到“数据源”页面画布以开始构建数据源。

数据源可以由单个表组成，该表包含分析所需的所有维度和度量字段...

![采用单表分析的数据模型。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_singletableanalysis.gif)

或者，您可以通过拖出更多表并定义它们的关系来创建多表数据源...

![在数据源窗格上创建数据关系。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_createrelationship.gif)

观看这个有关开始使用关系的视频（时长 1 分钟）。

**注意**：本视频中显示的用于编辑关系的界面与当前版本略有不同，但具有相同的功能。

有关使用关系的详细信息，请参见[关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)、[关系与联接有何不同](https://help.tableau.com/v0.0/online/zh-cn/datasource_relationships_learnmorepage.htm)、[“Tableau 数据模型”](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm)以及 [创建和定义关系](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-and-define-relationships)。

有关详细信息，请参见[数据源和分析的变化](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_whatschanged.htm)以及[有关关系、数据模型和数据源的问题](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_faq.htm)。

是否正在打开较旧的工作簿或数据源？

当您在 2020.2 中打开 2020.2 之前的工作簿或数据源时，数据源将在画布中显示为单个逻辑表，名称为“迁移的数据”或原始表名称。数据将会保留，并且您可以像以前那样继续使用工作簿。

![如果数据源包含多个联接或合并的表，则会显示名为“迁移的数据”的单个逻辑表。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_migrated_data.gif)

若要查看构成单个逻辑表的物理表，请双击该逻辑表，在物理层中将其打开。您将看到其基础物理表，包括联接和并集。

有关详细信息，请参见[数据源和分析的变化](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_whatschanged.htm)以及[有关关系、数据模型和数据源的问题](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_faq.htm)。

## 此部分中的其他文章

<!-- document id=0bd17e57a542be28609f334db528de3a158e9d18a5a087ff5b5535896509a035 url=/tableau/next/zh-cn/online/accelerators.md -->

[跳转到主要内容](#main-content)

# 使用加速器快速可视化数据

Tableau 加速器是预先构建的仪表板，旨在帮助您快速启动数据分析。加速器专为特定行业和企业应用量身定制，由样本数据构建而成，您可以用样本数据替换自己的数据，从而以最少的设置发现洞察。

![加速器示例](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_example.png)

Salesforce Sales Cloud Pipeline 加速器

## 在哪里可以找到加速器

您可以在 [Tableau Exchange](https://exchange.tableau.com) 和 Tableau Desktop 中访问整套加速器。此外，当您在 Tableau Cloud 中创建工作簿时，可以使用所选加速器。

### 在 Tableau Exchange 网站上

1. 请访问 Tableau Exchange 网站上的[“加速器”页面](https://exchange.tableau.com/accelerators)。您可以根据加速器适用的行业和它们所连接的数据类型进行筛选以查找加速器。
2. 登录到 Tableau Exchange 网站。如果没有帐户，请创建一个。
3. 当您找到想要使用的加速器时，选择“下载”以获取 TWBX 文件。
    
    由于加速器只是打包的工作簿，因此您可以在 Tableau Desktop 中打开下载的文件，或者将其上传到您在 Tableau Cloud 或 Tableau Server 上的站点。有关上载工作簿的信息，请参见[将工作簿上载到 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/upload.htm)。

### 在 Tableau Desktop 中

1. 在 Tableau Desktop 的开始页面上，选择“更多加速器”。
    
    ![开始页面上的加速器](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_desktop_more.png)
2. 此列表中的加速器与 Tableau Exchange 网站上显示的加速器相同，更方便的是，您可以在不离开 Tableau Desktop 的情况下打开加速器。
3. 当您找到想要使用的加速器时，选择“打开”以开始使用该加速器。

### 在 Tableau Cloud 中

当您在 Tableau Cloud 中创建工作簿时，可用的加速器数量有限。这些加速器连接到基于云的数据，比如 Salesforce、ServiceNow ITSM、LinkedIn Sales Navigator、Marketo 和 Oracle Eloqua。

1. 如果您是 Tableau Cloud 中的 Creator，请转到主页或“浏览”页面，然后选择“新建”按钮并选择“工作簿”。
    
    ![创建按钮选项](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_new_workbook.png)
    
    **注意**：站点管理员还可以从主页中名为“加速器”的部分下访问加速器。
2. 在“连接到数据”窗口的顶部，选择“加速器”浏览 Tableau Cloud 上可连接到的加速器。

您还可以将其他加速器从 Tableau Exchange 上载到 Tableau Cloud，并像在 Tableau Desktop 中一样使用它们。但是，您将需要按照 Tableau Desktop 说明将数据放入加速器，而不是按照 Tableau Cloud 说明操作。

## 使用 Tableau Exchange 中的加速器

按照此部分中的说明使用从 Tableau Exchange 网站下载或从 Tableau Desktop 中打开的加速器。有关在 Tableau Cloud 中创建工作簿时使用加速器的说明，请参见[在 Tableau Cloud 中直接使用加速器](#Create)。

### 在 Tableau Desktop 中将您的数据添加到加速器

#### 使用数据映射器

Tableau Desktop 在 2023.1 中为有限数量的加速器引入了数据映射。

从 2023.2 开始，数据映射器现在：

- 如果您关闭它，则保存您的选择，以便您可以从上次中断的地方继续
- 允许您在不同的已连接数据源之间切换
- 支持更多加速器

数据映射器可帮助您连接到数据并将数据中的字段映射到加速器所需的字段。如果您下载的加速器支持数据映射器，则会出现提示以帮助您开始使用。若要查找支持数据映射器的加速器，请在 [Tableau Exchange 网站](https://exchange.tableau.com/accelerators)上选择“启用数据映射”筛选器。

对于不支持数据映射器的加速器，请按照下一节中的说明[手动添加您的数据](#manual)。

当您打开支持它的加速器时，数据映射器将会打开。

1. 选择“开始”。
    
    如果关闭数据映射器，您可以随时通过从“数据”菜单中选择“打开数据映射器”来重新打开它。
2. 如果您已经连接到数据，请选择要用于映射的数据源。否则，选择“连接到数据”，然后选择要用于加速器的文件或基于云的数据。
3. 对于具有多个表的未发布数据源，您必须将数据添加到画布，以便 Tableau 可以访问字段。如果您看到设置数据的提示，请将一个或多个表或工作表拖到数据源画布上。您添加的数据将可映射到加速器。
    
    ![数据源画布](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_data_source.gif)
    
    有关构建数据源的详细信息，请参见[使用关系进行多表数据分析](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_normalized.htm)。
4. 添加数据后，您的字段将显示在数据映射器的“至”列中。对于每个加速器字段（“自”），请选择一个与您的数据（“至”）具有相同数据类型的字段。将鼠标悬停字段上以查看有关它们的详细信息。
    
    - 如果您注意到数据中的某个字段被标记为错误类型，请更改[数据类型](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles_datatypes.htm)以便可以对其进行映射。
    
    - 如果要切换放入加速器的数据源，请在“至”之后选择数据源名称，然后选择已连接的不同数据源，或选择“新数据源”。切换数据源会清除您对单独字段所做的所有选择。
    
    ![数据映射器选择屏幕](/tableau/next/zh-cn/online/zh-cn/Img/data_mapper.png)
5. 数据映射器左下方的指示器显示您已经分配的字段数。完成分配后，选择“替换数据”。
    
    您未映射的任何字段都会导致使用这些字段的仪表板中断。这是因为当您替换数据时，所有示例数据都将从加速器中移除。
6. 您的数据将替换加速器中的示例数据。在关闭数据映射器之前，检查仪表板以确保数据已按预期映射。如果您发现数据有问题，请选择“进行更改”返回分配页面。进行调整，然后再次替换数据。

从 Tableau Desktop 2023.2 开始，如果您想在关闭数据映射器后进行调整，请选择“数据”\>“打开数据映射器”以优化您的选择。在 Tableau Desktop 2023.1 中，您所做的选择不会持续存在，并且，如果您重新打开数据映射器，您将需要重复添加数据源和为每个字段进行分配的过程。

#### 手动添加您的数据

有两种方法可将数据添加到加速器中：用新数据源替换数据源（方法 1）或添加与现有数据源的新连接（方法 2）。

| 方法 1：替换数据源 | 方法 2：添加新连接 |
| --- | --- |
| 使用具有多个表的数据源。 | 数据源必须只有一个物理表。 |
| 允许您更改字段名以匹配加速器。 | 数据源中的字段名必须与加速器中的字段相匹配。 |
| 不保留加速器中的文件夹结构。 | 保留文件夹结构，这使加速器使用的字段保持有序。 |

#### 方法 1：替换数据源

如果要添加具有多个表的数据源，请使用此方法。

1. 在 Tableau Desktop 中打开加速器后，选择“数据”\>“新建数据源”。
    
    ![“数据”菜单](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_new_datasource.png)
2. 连接到要使用的数据。有关详细信息，请参见[连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/basicconnectoverview.htm)。如果您使用 Salesforce 加速器，请确保您的帐户具有对 Salesforce 实例的 API 访问权限。
3. 在“数据源”选项卡上，将表拖到画布上以构建新的数据源。有关详细信息，请参见[使用关系进行多表数据分析](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_normalized.htm)。
4. 打开仪表板，然后选择列出的任何工作表的“转到工作表”图标。
    
    ![“转到工作表”按钮](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_go_to_sheet.png)
    
    此步骤是必需的，因为您只能替换工作表中的数据，而不能替换仪表板或故事选项卡中的数据。有关工作簿中工作表类型的详细信息，请参见 [工作簿和工作表](https://help.tableau.com/current/pro/desktop/zh-cn/environ_workbooksandsheets.htm)。
5. 选择“数据”\>“替换数据源”。有关详细信息，请参见[替换数据源](https://help.tableau.com/current/pro/desktop/zh-cn/connect_basic_replace.htm)。
    
    ![“数据”菜单](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_replace_datasource.png)
6. 在“替换”下，选择您添加的数据源，然后选择“确定”。
7. 在“数据”窗格中，右键单击原始数据源，然后选择“关闭”。有关详细信息，请参见[关闭数据源](https://help.tableau.com/current/pro/desktop/zh-cn/close_connection.htm)。
    
    ![“数据源”菜单](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_datasource_close.png)

#### 修复损坏的引用

如果新数据源与原始数据源的字段名不同，加速器的某些部分将为空白。替换损坏的引用，以便它们使用新数据源中的正确字段。

1. 打开仪表板，然后选择列出的其中一个工作表的“转到工作表”图标。
    
    ![“转到工作表”按钮](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_go_to_sheet.png)
2. 在“数据”窗格中，确定加速器的必填字段。[Tableau Exchange](https://exchange.tableau.com) 上的加速器页面应会在描述部分列出这些字段。
3. 替换任何标有红色感叹号的字段的字段引用。
    - 为此，请右键单击字段名称，并选择“替换引用...”。然后从列表中选择正确的字段名称。
    - 有关详细信息，请参见[替换字段引用](https://help.tableau.com/current/pro/desktop/zh-cn/howto_connect.htm#replace-field-references)。
    
    ![损坏的引用指示符](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_broken_references.png)

#### 方法 2：编辑数据源

如果您的数据源只有一个物理表，可以直接替换加速器中的物理表，请使用此方法。

1. 在 Tableau Desktop 中打开加速器后，选择“数据源”选项卡。
    
    ![“数据源”选项卡](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_datasource_tab.png)
2. 在“连接”旁边，选择“添加”。连接到要使用的数据。有关详细信息，请参见[连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/basicconnectoverview.htm)。
    
    ![添加连接](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_add_datasource.png)
3. 在数据源画布上，双击逻辑表打开物理表。有关逻辑表和物理表的信息，请参见[数据模型的层](https://help.tableau.com/current/online/zh-cn/datasource_datamodel.htm#layers-of-the-data-model)。
    
    ![数据源逻辑表](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_table.png)
4. 将表从您添加的数据源中拖放到现有的物理表上，以替换示例数据。数据源必须只有一个物理表。
    
    ![拖动新表以替换物理表](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_table_replace.png)
5. 在“连接”下，右键单击示例数据的连接，然后选择“移除”。
    
    ![移除连接](/tableau/next/zh-cn/online/zh-cn/Img/accelerator_connection_remove.png)

## 在 Tableau Cloud 中直接使用加速器

当您在 Tableau Cloud 中创建工作簿时，可以使用的加速器数量有限。这些加速器会提示您直接连接到基于云的数据源，而不是要求您手动添加数据。

1. 在 Tableau Cloud 上，创建一个新工作簿。
2. 在“连接到数据”窗口的顶部，选择“加速器”。
3. 从预先构建的设计的列表中，查找与您需要的数据源和业务指标相符的选项，并选择“使用仪表板”。
4. 若要使用示例数据快速查看工作簿的效果，请选择“继续而不登录”。或者选择“继续”用您的数据创建工作簿。
5. 为工作簿指定名称和包含项目。
6. 如果选择用您的数据创建工作簿，请连接到您的数据源。在 Tableau 为您的数据准备数据提取时，会显示示例数据，以便您能够探索布局。

**注意：**如果您从 Tableau Exchange 下载加速器并打算将其上载到 Tableau Cloud，您将需要按照[使用 Tableau Exchange 中的加速器](#exchange)下的说明替换数据。

## 更改权限以与同事共享加速器

为了避免暴露机密数据，默认情况下只有作者和管理员才能看到加速器的工作簿。为了与同事共享加速器，请执行以下步骤：

1. 在 Tableau Cloud 中，[导航到加速器的工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)。
2. 在工作簿上，选择“操作”\>“权限”。
3. 为希望其查看仪表板的任何用户或组授予“查看”权限。有关详细信息，请参见 Tableau Cloud 帮助中的[编辑权限](https://help.tableau.com/current/online/zh-cn/permissions.htm)。

## 将示例数据替换为您的数据

如果选择在仪表板中使用示例数据，您可以随时将其替换为自己的数据。

1. 在 Tableau Cloud 中，[导航到加速器的工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)。
2. 在“数据源”选项卡上，选择数据源。从“操作”菜单中，选择“编辑连接”。
3. 为身份验证选择“连接中的嵌入式凭据”，并选择现有用户帐户或添加新帐户。然后选择“保存”。
4. 在“刷新计划”选项卡上，选择计划。从“操作”菜单中，选择“立即运行”。

## 通过替换字段名称修复显示为灰色的视图

如果组织为基于云的系统自定义了数据结构，当您的数据在加速器中加载之后，您可能需要在其中匹配这些更改。举例来说，如果组织已将 Salesforce 的“Account”字段重命名为“Customer”，您将需要在加速器中进行对应的更改，以避免出现像下面这样显示为灰色的视图：

![灰色的销售绩效仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_grayed_out.png)

替换字段引用以修复损坏的字段。

1. 在仪表板上，选择“编辑”。
2. [直接导航到显示为灰色的工作表](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#environ_workbooksandsheets_sheets_hideshow.htm#Temporar)。
3. 在左侧的“数据”窗格中，查找字段名称旁边的红色感叹号 (!)，其指明组织使用不同的名称。
4. 右键单击其中的每个字段，并选择“替换引用...”。然后从列表中选择正确的字段名称。
    
    ![从度量中展开的上下文菜单，其中突出显示了替换参照的选项。](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_replace_references.png)

## 通过更改默认日期范围修复空仪表板

如果仪表板看起来完全为空，可能的原因是默认日期范围与源数据中的日期不对应。

1. [下载工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#export.htm)，然后在 Tableau Desktop 中打开。
2. 选择“数据源”选项卡。
3. 在左上角选择数据源名称旁边的箭头，并选择“编辑连接”。然后登录。
    
    ![连接的上下文菜单，其中包含编辑所选连接的选项。](/tableau/next/zh-cn/online/zh-cn/Img/jumpstarts_empty_connection.png)
4. 指定与数据中的日期对应的日期范围，然后选择“连接”。
5. 选择“服务器”\>“发布数据源”，在 Tableau Cloud 上更新数据的数据提取。

<!-- document id=971515737cc81b8759d1abea20a2a8535e070d5f5d21da336ed5e7d7692b86de url=/tableau/next/zh-cn/online/dynamic_zone_visibility.md -->

[跳转到主要内容](#main-content)

# 使用动态区域可见性

仪表板空间很有价值，尤其是当您想要逐步揭示关于数据的洞察时。使用动态区域可见性，您可以根据字段或参数的值隐藏或显示区域（平铺或浮动仪表板元素）。当您进行交互时，仪表板上的区域会出现或消失。结果是一个动态的仪表板，不会损害您想要的布局。

虽然您可以[通过单击仪表板上的按钮来显示或隐藏对象](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm#Show)，但动态区域可见性允许您自动显示和隐藏对象。这非常适合不同用户组使用的仪表板。例如，当不同的用户组访问您的仪表板时，您可能希望向他们显示不同的区域。

您还可以将动态区域可见性与[参数动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_parameters.htm)结合使用。例如，当用户单击可视化项上的标记时，会出现一个先前隐藏的区域。这是复杂仪表板的理想选择，因为它允许您选择何时显示更深层次的数据。

## 支持的字段类型

若要用于动态区域可见性，字段或参数必须为：

- 布尔值。
- 单个值。
- 独立于可视化项，这意味着该字段返回一个独立于可视化项结构的常数值，例如 FIXED 详细级别 (LOD) 计算。

## 配置动态仪表板区域

下面的示例有两个使用 [Superstore 数据](https://help.tableau.com/current/guides/get-started-tutorial/zh-cn/get-started-tutorial-connect.htm)的工作表：第一个工作表具有按类别划分的销售额条形图，第二个工作表具有按子类别划分的销售额条形图。通过使用动态区域可见性，只有在“按类别划分的销售额”区域中单击标记后，第二个工作表才可见。此示例依赖于布尔计算字段，该字段用作参数动作的源字段。要将计算用作参数动作的源字段，必须将计算添加到标记卡中。

1. 从“按类别划分的销售额”工作表中，[创建一个参数](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_create.htm)。在此示例中，参数“数据类型”必须设置为“布尔值”。
2. 从“按类别划分的销售额”工作表中，[创建一个计算字段](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields_formulas.htm)。此示例使用以下计算：`True`
3. 在“按类别划分的销售额”工作表上，将您创建的计算拖到标记卡上的“详细信息”。
4. 创建仪表板。
5. 将您希望始终可见的工作表拖到仪表板上。在我们的例子中，我们希望“按类别划分的销售额”是可见的。
6. 在您的仪表板中，单击“按类别划分的销售额”区域（仪表板对象）。然后，从仪表板上的“工作表”菜单中，[创建一个参数动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_parameters.htm)。此示例使用以下“更改参数”动作：  
    源工作表设置为使用您创建的仪表板和“类别销售额”工作表。  
    “目标参数”是您创建的参数。  
    “源字段”是您创建的计算。  
    ![按照此图像前面的文本中所述配置的参数动作](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_zone_action.png)
7. 将“按子类别划分的销售额”工作表拖到仪表板上。
8. 单击“按子类别划分的销售额”区域。从右上角，单击下拉箭头并选择“用作筛选器”。
9. 单击“按子类别划分的销售额”区域，然后单击“布局”选项卡。
10. 选中“使用值控制可见性”复选框。
11. 从下拉列表中，选择您创建的用于控制区域可见性的参数。

**注意：**如果“使用值控制可见性”选项不包含要使用的字段，请确保该字段是受支持的字段类型。

![选中“使用值控制可见性”框，并选择名为“使用参数隐藏区域”的参数](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_zone_visibility.png)

现在，当您单击“按类别划分的销售额”区域中的类别标记时，“按子类别划分的销售额”区域就会出现在您的仪表板中。

![单击仪表板上的一个标记以使用动态区域可见性显示另一个图表的动画](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_zone_demo.gif)

## 了解限制和极端情况

在[故事](https://help.tableau.com/current/pro/desktop/zh-cn/stories.htm)（一系列协同工作以传达信息的可视化项）中使用工作表时，动态区域可见性不起作用。

<!-- document id=948042aac07556866a3544df0708ca2466db71ef6723eac720d1934312965805 url=/tableau/next/zh-cn/online/dynamic_axis_titles.md -->

[跳转到主要内容](#main-content)

# 使用动态轴标题

Tableau 的灵活性使作者能够快速分析不同的数据集，并以不同方式可视化数据以进行更深入的分析。但有了这种灵活性，就有责任准确地传达可视化项中使用的数据。例如，传达根据参数值而变化的度量单位至关重要。想象一下，您正在查看显示 25 度预报的天气可视化项。在华氏温度下，该预报可能意味着一次很棒的滑雪旅行。但在摄氏温度下，该预测可能意味着需要去海滩旅行。

作为作者，您可以使用动态轴标题根据参数值或单值字段（例如，LOD 计算）更新轴标题。如果您使用[交换参数](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_swap.htm)，轴标题将更新以匹配正在使用的数据。

## 支持的字段类型

若要用作动态轴标题，字段必须是：

- 单值和 [固定 LOD 计算](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields_lod_fixed.htm)
- 参数
- 计算字段
- 排名前 1 位的集

## 配置动态轴标题

1. 从 Tableau 工作表中，将一个连续字段拖到功能区上。
2. 双击标题打开“编辑轴”对话框。
3. 在“轴标题”部分下，从列表中选择要用于轴标题的字段。
4. 关闭“编辑轴”对话框：

对于更复杂的用例，首先按照[示例：使用参数交换度量](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_swap.htm)中的步骤操作。然后，执行以下步骤：

1. 双击 X 轴打开“编辑轴”对话框。
2. 在“轴标题”部分下，选择“参数”，然后选择“占位符 2”选择器。
3. 关闭“编辑轴”对话框：
4. 为使用“占位符 1”的 Y 轴重复这些步骤。

现在，当参数更改时，轴标题会更新以反映所显示的数据。

## 了解限制和极端情况

使用“智能显示”更改可视化项类型时，动态轴标题会被清除。此外，如果您使用子标题，则子标题会出现在动态轴标题之后，就像自定义标题一样。只有当您有一个连续的日期值轴被筛选到至少有两个时间段的一年时，才会填充自动子标题。在[故事](https://help.tableau.com/current/pro/desktop/zh-cn/stories.htm)（一系列协同工作以传达信息的可视化项）中使用工作表时，动态轴标题功能不起作用。

<!-- document id=8c892de6b352dc8cf9d341e96999c1712fc30ffd43cf55623d86da0e562a4bf3 url=/tableau/next/zh-cn/online/dynamic_axis_ranges.md -->

[跳转到主要内容](#main-content)

# 使用动态轴范围

用户必须了解可视化项中表示的范围，以便他们能够正确分析数据，这一点至关重要。特别是在同时分析仪表板或多个工作表中的多个可视化项时，当可视化项之间的轴范围不同时，用户很容易误解数据。例如，当两个条形图彼此相邻出现时，两个图表中的条形可能看起来大小相等。但是，轴的范围可能非常不同，从而使图表产生误导。

为了帮助用户了解轴的范围，在 2023.3 及更高版本中，作者可以使用动态轴范围通过数字参数或日期参数来设置轴范围的最小值和最大值。然后，当用户在可视化项之间导航时，轴会同步更新。这使您的用户可以更轻松、准确地跨可视化项分析数据。通过限制数据范围，您可以查看数据子集，而无需筛选基础数据或影响数据的移动平均值。

动态轴范围还可用于扩展或缩短轴的范围，而无需筛选掉基础数据。这非常适合显示目标进度或显示移动平均值。

## 支持的字段类型

动态轴范围支持与所选连续轴兼容的任何参数，例如：

- 数字参数
- 时间参数（日期或日期时间）

## 基于选择配置动态轴范围

从 Tableau 25.3 开始，您可以根据区域选择自动更新轴范围，从而不再需要单独的参数和参数动作工作流。

1. 从工作表中，右键单击轴并选择“编辑轴…”
2. 对于“范围”，选择“自定义”。
3. 展开下拉菜单，为开始和结束范围点选择“交互时更新”。
4. 关闭该对话框。
5. 返回到您的可视化项，并在可视化项上选择一个区域，为所选范围点设置相应的值。  
      
    ![“编辑轴”对话框，带有根据交互设置自定义范围开始和结束的选项。](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_axis_selection.png)

## 使用现有参数配置动态轴范围

您还可以通过将动态轴范围绑定到现有参数来配置动态轴范围。

1. 从工作表中，为您的轴[创建参数](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_create.htm)。
2. 右键单击轴，并选择“编辑轴”。
3. 对于“范围”，选择“自定义”。然后，选择您为起始轴或结束轴范围创建的参数。
4. 关闭对话框。
5. 如果您在仪表板上使用多个工作表，请对不同工作表上的轴重复这些步骤。

![显示用于创建动态轴范围的参数的动画，然后该动画显示动态范围如何影响筛选。](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_axis_ranges.gif)

## 了解限制和极端情况

动态轴范围不会在[故事s](https://help.tableau.com/current/pro/desktop/zh-cn/stories.htm)中更新。如果删除用于轴的参数，则最新的参数值仍保留为轴范围。下次编辑轴时，错误消息将提示您选择要使用的新参数。

<!-- document id=1fc03190afb92741840553d5fd4ac970513e91e60b355850838cdb29061d2959 url=/tableau/next/zh-cn/online/license_lblm.md -->

[跳转到主要内容](#main-content)

# 使用基于登录名的许可证管理激活 Tableau

基于登录名的许可证管理 是 Creator 角色在 Tableau Cloud 内的首选许可证管理和激活选项，默认情况下已在站点上启用。基于登录名的许可证管理 允许授权用户通过登录到 Tableau Cloud 来激活和解锁 Tableau Desktop 以及/或者 Tableau Prep Builder。利用 基于登录名的许可证管理 将无需分发和管理 Tableau Desktop 和 Tableau Prep Builder 的产品密钥。

您只需要一个 Tableau Cloud 站点来授权个人 Tableau Desktop 或 Tableau Prep Builder。 您可以为使用 Tableau Desktop 和 Tableau Prep Builder 的用户分配 Creator 角色来进行许可证激活和集中许可证管理。此外，基于登录名的许可证管理 还能使您更深入地了解许可证使用情况。

您可以使用 Tableau Cloud 上的管理视图来集中查看 Creator 席位的分配和使用情况。管理视图提供有关谁正在使用 Creator 许可证的信息，并显示最新的许可证租约以及 Tableau Desktop 和 Tableau Prep Builder 的版本，这有助于监视 Tableau 部署。

以下 Tableau 产品支持 基于登录名的许可证管理：

- Tableau Cloud
- Tableau Server
- Tableau Desktop
- Tableau Prep Builder

## 基于登录名的许可证管理的工作方式

使用 基于登录名的许可证管理 时，Tableau Desktop 或 Tableau Prep Builder 会定期联系 Tableau Cloud 以便验证用户是否为 Creator，并获取运行授权。Tableau Cloud 会联系 Tableau 托管的授权运行 (ATR) 服务，以验证 Tableau Desktop 客户端是否允许激活。ATR 服务 将验证和管理许可证和“授权窗口”的长度。下图显示了客户端 (Tableau Cloud) 和许可服务之间的通信过程。

Tableau 使用公共端口（80 和 443）进行 Internet 请求。大多数情况下，安装 Tableau Desktop 或 Tableau Prep Builder 的计算机和它在其上运行的网络已配置为允许必要的访问。有关 Tableau 使用的端口的详细信息，请参见 [Internet 访问要求](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_proxy.htm)。

#### 基于登录名的许可证管理 与 Tableau Cloud

![该图表显示了使用 Tableau Cloud 进行基于登录名的许可证管理的许可证和许可组件之间的通信过程。](/tableau/next/zh-cn/online/zh-cn/Img/virtual_desktop_online_lblm.png)

1. 您安装 Tableau Desktop 或 Tableau Prep Builder，并选择**“使用凭据激活”**。您登录到 Tableau Cloud 站点。
2. Tableau Cloud 会验证您是否为 Creator。如果不是，则会收到错误。如果是，Tableau Cloud 将与 ATR 服务通信。
3. ATR 服务将 ATR 租约返回给 Tableau Cloud。
4. Tableau Cloud 将 ATR 租约提供给 Tableau Desktop 或 Tableau Prep Builder 以最终完成激活。

## 使用基于登录名的许可证管理

若要使用基于登录名的许可证管理，您需要安装 Tableau Desktop 并将其与 Tableau Cloud 一起使用。

### 步骤 1：启用基于登录名的许可证管理

基于登录名的许可证管理 默认情况下已为 Tableau Cloud 和 Tableau Desktop 启用。若要使用 基于登录名的许可证管理，您需要安装 Tableau Desktop 并将其与 Tableau Cloud 一起激活。如果您正在激活 Tableau Desktop，请跳转到[步骤 3：激活 Tableau Desktop](#Step_3)。

安装时在 Tableau Desktop 或 Tableau Prep Builder 上更改 基于登录名的许可证管理 设置

若要在命令提示符处更改 基于登录名的许可证管理 设置，您可以用管理员身份从计算机的命令行运行安装程序 .exe 文件。如果需要提取 .msi 文件，请按照[提取并运行 Windows (MSI) 安装程序](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_automate.htm#msi)中的说明进行操作。

若要使用默认值 14 天/1209600 秒以外的其他持续时间长度，请包括 `ATRREQUESTEDDURATIONSECONDS` 开关。例如：

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 ATRREQUESTEDDURATIONSECONDS=43200`

您必须从 .exe 文件所在的目录运行命令，或指定计算机上 .exe 文件位置的完整路径。不要从网络上的共享目录中运行安装程序。而是要将 .exe 文件下载到您进行安装的计算机上的某个目录。

以下示例显示用于禁用基于登录名的许可证管理的 Windows 安装程序命令：

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 LBLM=disabled`

或

`tableauPrepBuilder-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 LBLM=disabled`

若要设置您希望用户在使用 基于登录名的许可证管理 时用于激活的 Tableau Server 的默认 URL，请添加 `ACTIVATIONSERVER` 或 `WorkGroupServer` 选项。

若要更新 exe，请执行以下操作：

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 ACTIVATIONSERVER=http://<tableau_online_site_url>`

若要更新注册表，请执行以下操作：

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\Tableau 2024.2\Settings /f /v WorkGroupServer /d https://<tableau_server_url>`

**注意：**`ACTIVATIONSERVER` 选项仅用于首次激活。如果您以前已登录到此版本的 Tableau，则使用 `WorkGroupServer` (Windows) 或 `WorkgroupServer` (macOS) 选项。举例来说，如果您使用的是 Windows 版 Tableau Desktop，并且以前已成功登录，则将使用 `WorkGroupServer` 选项指定激活服务器。在 macOS 版 Tableau Desktop 上，您将使用 `WorkgroupServer` 选项。在 macOS 上，此选项区分大小写并使用小写“g”。

通过编辑注册表在 Tableau Desktop 上更改基于登录名的许可证管理设置

如果已安装 Tableau Desktop，则可以通过编辑 Windows 注册表来更改 基于登录名的许可证管理 设置。

若要关闭 基于登录名的许可证管理，请执行以下操作：

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR /f /v LBLM /d disabled`

若要使 基于登录名的许可证管理 成为唯一的登录选项，请执行以下操作：

`reg.exe add HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR /f /v LBLM /d required`

或者，您可以通过直接编辑注册表来启用、禁用或要求 基于登录名的许可证管理：

1. 作为运行 Tableau Desktop 的计算机上的管理员，请在对注册表文件进行任何更改之前将其备份。
2. 编辑注册表，在 `HKEY_LOCAL_MACHINE\SOFTWARE\Tableau` 中查找名为 ATR 的配置单元，并修改 LBLM 值以反映所需的设置：
    
    1. 名称：LBLM。
    2. 数据：Enabled、disabled 或 required。
3. 重新启动 Tableau 以使更改生效。

在 macOS 的 Tableau Desktop 上更改 基于登录名的许可证管理 设置

若要在 macOS 上更改 基于登录名的许可证管理 设置，请在终端窗口中运行以下命令以更新首选项文件，然后安装或重新启动 Tableau Desktop。

若要关闭 基于登录名的许可证管理，请执行以下操作：

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "disabled"`

若要使 基于登录名的许可证管理 成为唯一的登录选项，请执行以下操作：

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "required"`

设置您希望用户在使用 macOS 版 基于登录名的许可证管理 时用于激活的 Tableau Server 的默认 URL。

首次激活：

`sudo defaults write /Library/Preferences/com.tableau.ATR LBLM "required"`

后续激活：

`sudo defaults write /Library/Preferences/com.tableau.Tableau-<version> Settings.WorkgroupServer "https://<tableau_server_url>"`

**注意：**在 macOS 版 Tableau Desktop 上，您将使用 `WorkgroupServer` 选项。在 macOS 上，此选项区分大小写并使用小写“g”。

#### 基于登录名的许可证管理 设置

您可以使用以下设置来更改 基于登录名的许可证管理、设置 ATR 持续时间，以及设置激活服务器 URL。

<table class="simple-table" style="width: 100%;"><colgroup><col style="width: 154px;"><col style="width: 155px;"><col style="width: 587px;"></colgroup><tbody><tr><td><b>设置</b></td><td><b>值</b></td><td><b>描述</b></td></tr><tr><td><code>LBLM</code></td><td>Enabled、disabled 或 required</td><td><p>设置为 <code>enabled</code>（默认值），许可屏幕将显示两个激活选项（产品密钥或凭据）。</p><p>设置为 <code>disabled</code>，<span class="mc-variable Variables.IBA_lowercase variable">基于登录名的许可证管理</span> 将不会显示在许可屏幕上。</p><p>设置为 <code>required</code>，只能通过 <span class="mc-variable Variables.IBA_lowercase variable">基于登录名的许可证管理</span> 来激活 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>（许可屏幕显示时仅提供凭据激活选项）。</p><p class="note"><b>注意：</b>将 <code>LBLM</code> 设置为 enabled 或 required 时，也会启用报告。</p></td></tr><tr><td><code>ATRREQUESTEDDURATIONSECONDS</code></td><td>1209600</td><td><p>设置授权运行 (ATR) 持续时间（以秒为单位），即 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 和 Tableau Prep Builder 实例获得授权运行的时间长度。默认值为 1209600 秒（14 天）。不要在值中使用逗号作为分隔符。</p></td></tr><tr><td><code>ACTIVATIONSERVER</code></td><td><p>http://&lt;tableau_online_site_url&gt;</p></td><td>对于首次激活，设置希望用户用于激活的 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 站点的默认 URL。</td></tr><tr><td><code>WorkGroupServer</code> (Windows) <code>WorkgroupServer</code> (macOS)</td><td><p>http://&lt;tableau_server_url&gt;</p></td><td><p>对于 Windows 注册表或 macOS plist 的更新，设置您希望用户用于激活的 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 的默认 URL。</p><p class="note"><b>注意：</b>在 macOS 版 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 上，您将使用 WorkgroupServer 选项。在 macOS 上，此选项区分大小写并使用小写“g”。</p></td></tr><tr><td><code>REPORTINGFREQUENCYSECONDS</code></td><td>3600</td><td>为将 <span class="mc-variable Variables.IBA_lowercase variable">基于登录名的许可证管理</span> 报告发送到 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 或 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 的频率设置默认值（以秒为单位）。最小设置为 60 秒，默认值为 3600 秒（1 小时）。更改此设置以减少 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 上的负载或减少网络流量。无论授权运行 (ATR) 租约期限设置为什么，<code>REPORTINGFREQUENCYSECONDS</code> 都会将 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> 客户端报告 <span class="mc-variable Variables.IBA_lowercase variable">基于登录名的许可证管理</span> 激活的时间间隔设置回 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 或 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>。</td></tr></tbody></table>

虚拟部署的其他配置

Tableau Desktop 和 Tableau Prep Builder 将定期联系 Tableau Cloud 或 Tableau Server ，根据其许可证验证 Tableau 是否有权运行。Tableau Cloud 或 Tableau Server 随后将联系 ATR 服务以验证许可证和“授权窗口”的长度。

配置Tableau Desktop 或 Tableau Prep Builder 的虚拟（非持久性）部署时 ，持续时间应设置为某个较低的值，例如 4 或 8 小时，以避免过度使用激活错误消息。返回虚拟机 (VM) 后，ATR 服务将处理激活监视。

在将 Tableau Desktop 发布给最终用户之前，应在源映像上使用以下标志。每个最终用户都将在交付了每个 VM 后通过登录 Tableau Server 或 Tableau Cloud 来激活软件。如果最终用户是Tableau Server 或 Tableau Cloud 上的 Tableau Creator，则无需输入产品密钥。

如果您在 VM 上为 Tableau Desktop 或 Tableau Prep Builder 使用基于登录名的许可证管理，则每次为 Tableau Desktop 或 Tableau Prep Builder 启动新的 VM 时都可能会收到指出许可证信息已更改的错误消息。此错误会强制重新启动，因而会随后要求您再次激活 Tableau Desktop。出现此错误的原因是 ATR 服务会发送一个与许可证缓存不匹配的新令牌。

#### Microsoft Windows

为了防止在 Microsoft Windows 上发生该错误，可以将 `SYNCHRONOUSLICENSECHECK` 和 `SILENTLYREGISTERUSER` 选项与 Windows 安装程序一起使用。例如：

`tableau-setup-std-tableau-2024 SYNCHRONOUSLICENSECHECK="true" SILENTLYREGISTERUSER="true" ATRREQUESTEDDURATIONSECONDS=14400`

或

`tableauDesktop-64bit-2024-2-0.exe /quiet /norestart ACCEPTEULA=1 ATRREQUESTEDDURATIONSECONDS=14400 ACTIVATIONSERVER=http://<tableau_online_site_url> SYNCHRONOUSLICENSECHECK="true" SILENTLYREGISTERUSER="true"`

如果 Tableau Prep Builder 和 Tableau Desktop 正在一个虚拟桌面上传递，则只需在 Tableau Desktop 安装过程中设置 `ATRREQUESTEDDURATIONSECONDS`。 但是，如果您计划独立安装 Tableau Prep Builder，则需要在 Tableau Prep Builder 安装过程中设置 `ATRREQUESTEDDURATIONSECONDS`。

或者，您可以在源映像上编辑以下注册表项：

`Reg key path: HKLM\SOFTWARE\Tableau\<Tableau version>\Settings\`

`Reg key (String value, need to set to true to make that feature enabled)`

`SynchronousLicenseCheck`

`SilentlyRegisterUser`

#### MacOS

为了防止在 macOS 上发生该错误，请运行以下命令将 `LicenseCache.Desktop` 标志设置为 `'false'`。

`sudo defaults write ~/Library/Preferences/com.tableau.Tableau-<version>.plist LicenseCache.Desktop false`

### （可选）步骤 2：更改授权运行 (ATR) 持续时间

授权运行 (ATR) 持续时间的 基于登录名的许可证管理 默认设置适用于大多数环境，但如果需要，您可以更改这些默认设置。基于登录名的许可证管理 将使用默认授权运行 (ATR) 持续时间 1,209,600 秒（14 天），即 Tableau Desktop 和 Tableau Prep Builder 实例获得授权运行的时间长度。这意味着，在初始授权之后，您可以在没有任何网络连接的情况下使用 Tableau 14 天，之后激活将过期。

基于登录名的许可证管理 的默认持续时间值不适合向最终用户交付非持久性 VM 交付解决方案。ATR 持续时间应降低到 4 或 12 小时，具体取决于 VM 的使用。将新 VM 交付给最终用户时，将创建运行令牌的新权限。返回 VM 后，此令牌也会返回，并能够用在新的 VM 授权运行请求上。

**注意：**基于登录名的许可证管理在确定 ATR 持续时间时使用以下分层结构。

1. **ATR 服务** – 建立适用于所有用户/安装的最短（4 小时/14400 秒）和最长（90 天/7776000 秒）ATR 持续时间。如果 Tableau Server 或 Tableau Desktop 未指定任何内容，则它指定默认 ATR 持续时间（14 天/1209600 秒）。
2. **Tableau Desktop** – 可以根据需要为安装它的计算机指定 ATR 持续时间 (`ATRREQUESTEDDURATIONSECONDS`)。如有必要，您可以将默认 ATR 持续时间（14 天/1209600 秒）更改为 ATR 服务最小值（4 小时/14400 秒）和最大值（90 天/7776000 秒）内的设置。此本地 ATR 持续时间将覆盖 ATR 服务或 Tableau Server 设置的任何持续时间。但是，此默认 ATR 持续时间不能超过 Tableau Server 上设置的最长 ATR 持续时间。

通过编辑注册表在 Tableau Desktop 上更改 ATR 持续时间

若要使用默认值 14 天/1209600 秒以外的其他持续时间长度，请更新 `ATRRequestedDurationSeconds` 注册表设置。例如：

1. 作为运行 Tableau Desktop 的计算机上的管理员，请在对注册表文件进行任何更改之前将其备份。
2. 编辑注册表，并在 `HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ATR` 中更新 ATRRequestedDurationSeconds，如下所示（0 使用默认设置）：
    1. 名称：查找名为 `ATRRequestedDurationSeconds` 的字符串值。
    2. 数据：更新持续时间应该持续的秒数。例如，添加 43200 以设置 12 小时的持续时间。
3. 重新启动 Tableau 以使更改生效。

在 macOS 版 Tableau Desktop 上更改 ATR 持续时间

若要使用默认值 14 天/1209600 秒以外的其他持续时间长度，请包括 `ATRRequestedDurationSeconds` 首选项设置。例如：

`sudo defaults write /Library/Preferences/com.tableau.ATR ATRRequestedDurationSeconds -string "43200"`

### 步骤 3：激活 Tableau Desktop

1. 运行 Tableau Desktop 安装程序。
2. “激活 Tableau”屏幕将包括“通过登录到服务器进行激活”选项。
    
    ![Tableau 许可证激活窗口。](/tableau/next/zh-cn/online/zh-cn/Img/license_lblm.png)
3. 单击“通过登录到服务器进行激活”，然后单击 Tableau Cloud 链接。
    
    出现提示时，输入有效凭据以具有 Creator 角色订阅的用户身份登录 Tableau Cloud 站点，然后单击“确定”。

## 查看基于登录名的许可证使用情况

您可以查看 Tableau Cloud 或 Tableau Server 基于登录名的许可证使用情况。报告将显示用户、主机、用户角色、产品、版本、激活、已使用的 Creator 座席、未使用的 Creator 座席，以及上次使用 Creator 座席的时间。您可以查看过去 30 天的数据，最多可查看 183 天的数据。

若要查看“基于登录名的许可证管理 许可证使用情况”管理视图，请执行以下操作：

1. 在 Tableau Cloud 或 Tableau Server 的导航窗格中，单击“站点状态”。
    
    ![“站点状态”页面，显示监控站点活动的仪表板的列表。](/tableau/next/zh-cn/online/zh-cn/Img/lblm.png)
2. 在“站点状态”页面上，单击“基于登录名的许可证使用情况”。
3. 可选。在报告屏幕上，可以更改时间范围以显示上次使用座席的时间、筛选操作、筛选用户名以及按列进行排序。
    
    ![基于登录名的许可证管理使用情况报告的示例。](/tableau/next/zh-cn/online/zh-cn/Img/lblm_usage_report.png)

## 疑难解答

使用 基于登录名的许可证管理 时，您可能会遇到以下错误消息之一。使用以下信息解决问题。

如果 基于登录名的许可证管理 已可用作 Tableau Desktop 上的激活选项，但在 Tableau Cloud 站点上未启用，则可能会显示以下错误消息：

_基于登录名的许可证管理 is not enabled on the server you connected to.（基于登录名的许可证管理 在连接到的服务器上未启用。）Select a different server to connect to, use a product key to activate your license, or start a trial to begin working immediately.（选择要连接到的其他服务器，使用产品密钥激活许可证，或开始试用以立即开始工作。）_

请与您的管理员和/或 Tableau 客户经理联系，确保已为 基于登录名的许可证管理 启用 Tableau Cloud 站点。

### Tableau Desktop 上未启用 基于登录名的许可证管理

如果 基于登录名的许可证管理 在 Tableau Desktop 上未启用，您将无法选择使用凭据激活 Tableau。

如果在安装期间或更新期间关闭了 基于登录名的许可证管理 选项，请参见[步骤 1：启用基于登录名的许可证管理](#Step_1)。

### 购买一年订阅后，产品密钥到期日期不会改变

购买 Tableau Cloud 的续订后，似乎您的 Tableau Desktop 许可证即将到期。情况并非如此。在“管理产品密钥”中，新 Tableau Cloud 订阅的到期日期在上一个站点到期日期前两周才会更新。

### 您没有 Creator 许可证

尝试从 Tableau Desktop 中激活时，可能会显示以下错误消息：

_You do not have a Creator license.Contact your administrator to obtain one.（您没有 Creator 许可证。请与您的管理员联系以获取。）_

如果还没有为您分配 Creator 角色，则会显示此错误。如果您属于 Tableau Cloud 或 Tableau Server 上的多个站点，则需要在使用 基于登录名的许可证管理 时登录到您具有 Creator 角色的站点。否则，您会收到此错误。

为了验证您在服务器上激活的产品密钥是否包含 Creator 许可证，请打开 TSM Web UI 并单击“配置”，然后单击“许可”。

### 您已激活了最大数量的计算机

尝试从 Tableau Desktop 中激活时，可能会显示以下错误消息：

_You have activated Tableau the maximum number of times allowed under your account.You must wait for the license activation on another computer to expire before you can activate Tableau again.（您激活 Tableau 的次数已超过您的帐户所允许的最大次数。您必须等待另一台计算机上的许可证激活过期，然后才能再次激活 Tableau。）_

当您从具有相同 Creator 用户凭据的多台计算机激活 Tableau 并超出了最大激活数量时，将会显示此错误。您必须等待授权运行 (ATR) 令牌在一台现有计算机上过期，然后再尝试激活新计算机。如果使用非持久性虚拟机 (VM)，则可以缩短 ATR 持续时间以防止此错误再次发生。

#### 缩短 ATR 令牌持续时间以实现最大激活数量

如果在使用非持久性虚拟部署时遇到此最大使用错误，则可以将 ATR 持续时间缩短到 4 小时 (14400) 秒，以避免将来出现该错误。

以下步骤缩短了先前激活的计算机上的租约，基于登录名的许可证管理 将不再使用，以便腾出一个席位以在新计算机上激活：

1. 在将不再使用的 Tableau Desktop 计算机上以管理员身份打开命令提示符。
2. 使用以下命令导航到 Tableau 二进制文件 (\\bin) 目录。
    
    Windows：`cd Program Files\Tableau\Tableau <version>\bin`
    
    Mac：`cd /Applications/Tableau\ Desktop\ <version>.app/Contents/MacOS`
3. 运行以下命令将持续时间设置为 4 小时（以秒为单位，例如 14400）。
    
    Windows：`atrdiag.exe -setDuration 14400`
    
    Mac：`sudo ./atrdiag -setDuration 14400`
4. 使用以下命令删除之前的 ATR 令牌：
    
    Windows：`atrdiag.exe -deleteAllATRs`
    
    Mac：`./atrdiag -deleteAllATRs`
5. 接下来，覆盖现有 ATR 令牌。打开 Tableau Desktop。Tableau 显示“许可证已更改”消息。单击“退出”自动关闭并重新打开 Tableau Desktop。
6. 在注册对话框中，单击“激活”，然后通过 Tableau Server 使用 基于登录名的许可证管理 重新激活 Tableau Desktop，这将覆盖现有令牌。
7. 关闭 Tableau Desktop 并等待 ATR 持续时间（例如 4 小时）过去，以便 ATR 令牌过期并释放用户席位。在 ATR 持续时间结束之前，不要打开 Tableau Desktop。检查以确保 ATR 持续时间已结束。ATR 令牌 TTL 结束应显示未来的日期和时间（例如，从现在起 4 小时）。
    
    Windows：`atrdiag.exe`
    
    Mac：`./atrdiag`
8. ATR 令牌过期后，您可以在新计算机上成功登录 Tableau Server。

#### 将计算机恢复为未许可状态

1. 以管理员身份打开命令提示符。
2. 使用以下命令导航到 Tableau 二进制文件 (\\bin) 目录：
    
    `cd Program Files\Tableau\Tableau <version>\bin`
3. 运行以下命令：
    
    Windows：`atrdiag.exe –deleteAllATRs`
    
    Mac：`./atrdiag.exe –deleteAllATRs`

**注意：**这只会从计算机中移除 ATR 令牌。它不释放任何用户席位。仅当已删除的 ATR 令牌过期后，才会释放用户席位。

### 您的 Tableau 凭据无效

尝试从 Tableau Desktop 中激活时，可能会显示以下错误消息：

_Your Tableau credentials are invalid.Contact your administrator to reset your account.（您的 Tableau 凭据无效。请与管理员联系以重置您的帐户。）_

当系统无法识别 Tableau 许可证时，将显示此错误。与管理员联系。

### 计算机的时钟未与当前时间同步

尝试从 Tableau Desktop 中激活时，可能会显示以下错误消息：

_Your computer’s clock is not synchronized to the current time.Synchronize your computer’s clock to the current time and then try to activate Tableau.（计算机的时钟未与当前时间同步。将计算机的时钟与当前时间同步，然后尝试激活 Tableau。）_

当计算机时钟未与当前时间同步时，将显示此错误。将计算机的时钟与 Internet 上的时间服务器同步，或启用自动时间同步。

<!-- document id=cdd252f3d2682ea3c0ad5912b4ac50d16a6f9354f972506af36c0d0093294469 url=/tableau/next/zh-cn/online/to_external_kms.md -->

[跳转到主要内容](#main-content)

# 使用外部 KMS 进行密钥管理

许多组织需要直接控制用于保护其关键业务数据的加密密钥。使用外部密钥管理服务 (KMS) 允许客户通过可信的外部密钥管理供应商来保持对其加密密钥的控制，从而满足了此要求。通过提供对加密密钥的直接控制，使用外部 KMS 可以显著增强组织的安全状况，特别是那些担心这些关键密钥被未经授权访问的组织。

此外，对于许多组织来说，在外部控制其加密密钥的能力对于满足各种法规和合规性要求至关重要。对加密密钥的直接控制有助于组织维护数据主权，这对于数据存储和访问的法律和地理考虑非常重要。

自 2026 年 2 月起，Tableau Cloud 仅通过 Amazon Web Services (AWS) KMS 提供外部密钥管理。

注意：如果您拥有 Tableau +、Tableau Enterprise 或 Advanced Management，则从 Tableau Cloud 2026 年 2 月版开始提供外部 KMS 功能。如果在某个时候您不再拥有 Tableau +、Tableau Enterprise 或 Advanced Management，您仍可正常使用加密对象，但将无法管理密钥。

## 支持外部 KMS 的功能

您可以使用外部 KMS 来存储以下各项的加密密钥：

- 数据提取加密
- 数据凭据加密

注意：若要使用外部 KMS 进行数据凭据加密，请先为数据提取加密启用外部 KMS。

Tableau 使用 Salesforce 标准 AES-GCM 算法对数据提取和数据凭据进行加密。

## 此部分中的其他文章

<!-- document id=af8a722e543e54d99f2989611104cccb26ce578da4fa07a044819fa52d563c74 url=/tableau/next/zh-cn/online/activity_log_entity_snapshots.md -->

[跳转到主要内容](#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)。

<!-- document id=0007523434a286be73c8e9395c4d86c3bc5a728982a3edaf95aa4c2c6f18dec6 url=/tableau/next/zh-cn/online/to_bridge_eds.md -->

[跳转到主要内容](#main-content)

# 使用嵌入式数据源

Tableau Bridge 支持嵌入式数据源 (EDS) 和已发布数据源。借助 EDS 支持，可以按原样迁移需要 Bridge 的现有内容，而不是将嵌入式数据源转换为已发布数据源。

**注意**：对于包含嵌入式数据源的 Bridge 数据提取刷新连接，您可以合并来自多个源的数据。请参见[多个连接方案](https://help.tableau.com/current/online/zh-cn/to_bridge_manage.htm)。

## 注意事项

- Bridge 最多可支持每个客户端 16 个实时查询。借助嵌入式数据源支持，刷新配额会有额外计数。
- 有关 Tableau Bridge 如何影响站点容量的信息，请参见 [Bridge 站点容量](https://help.tableau.com/current/online/zh-cn/to_bridge_site_capacity.htm)。
- 当数据嵌入到工作簿中时，它是工作簿独有的；其他 Tableau Desktop 用户无法连接到它。您可以设置数据提取刷新计划，就像为已发布的数据源设置计划一样。
- 每个嵌入的数据源具有单独的数据连接。当连接到重复的数据副本时，性能可能会受到影响，例如，当连接到相同的原始数据并且每个工作簿都有自己的刷新计划时。
- 一旦配置了数据源的池映射和私有网络允许列表，现有的计划作业将被路由到 Bridge。这是因为嵌入式数据源的网络类型由池映射和私有网络允许列表确定。
- 已发布数据源通常是长时间运行的数据提取刷新任务的最佳选择。有关详细信息，请参见[优化 Bridge 刷新性能](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_eds_performance.htm)。
- 使用 Tableau Bridge 刷新的嵌入式数据提取使用实时查询。数据提取是在 Tableau Cloud 服务器上写入的，而不是在 Tableau Bridge 客户端计算机上写入的。因此，在计划组织的嵌入式数据提取使用量时，请考虑实时查询超时。请参见[超时限制](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#timeout)。

### 限制

- 不支持 Bridge 旧版计划。
- 默认池不支持嵌入式数据源。您必须使用已配置的池。有关详细信息，请参见[配置 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。
- 当连接是嵌入式数据源时，Bridge 不支持文件数据（例如 .cvs 和 .xlsx）的实时连接。
- Bridge Windows 客户端支持嵌入式数据源文件的数据提取刷新。您必须对嵌入式数据源使用已配置的池，并且文件路径必须使用 UNC 格式。Tableau 建议将文件大小限制为 5 GB。
- 适用于容器的 Linux 版 Bridge 不支持文件数据。
- 如果数据源是嵌入式，则使用 Tableau REST API 发布的工作簿或使用 API 的工具（例如 Content Migration Tool）不支持通过 Tableau Bridge 进行数据刷新。
    - 此限制也适用于直接在 Tableau Cloud Web 界面中使用“上载”选项手动上载的工作簿。
    - 对于指向 UNC 路径的 Excel 或平面文件，使用 REST API 进行发布将导致 [`FAKEPATH` 错误](https://help.salesforce.com/s/articleView?id=005232592&type=1)。出现此错误的原因是，基于 API 的发布过程无法正确解析 Bridge 客户端的本地或网络文件路径。
    - 解决办法：为了确保嵌入的 Excel 数据源可以使用 Tableau Bridge 成功刷新，您必须直接从 Tableau Desktop 中发布工作簿。或者，我们建议将数据源单独发布到 Tableau Cloud，然后将工作簿连接到该已发布的数据源。

### 具有实时连接的嵌入式数据源

1. 为数据源设置池映射。有关详细信息，请参见[“配置 Bridge 客户端池”](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。
2. 从 Tableau Desktop 中将数据源连接设置为“实时”。
3. 从工作表中，单击“服务器”\>“发布工作簿”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_wb.png)

5. 若要查看工作簿中嵌入的数据源，请单击“数据源”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_ds.png)

7. 单击“发布”。

发布工作簿后，将使用工作簿中包含的数据源来呈现工作簿。

### 具有数据提取连接的嵌入式数据源

1. 为数据源设置池映射。有关详细信息，请参见[“配置 Bridge 客户端池”](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。
2. 从 Tableau Desktop 中将数据源连接设置为“数据提取”。
3. 单击工作表，然后在“将数据提取另存为”表单中，为数据提取数据源提供一个名称。
4. 从工作表中，单击“服务器”\>“发布工作簿”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_EDS_extract2.png)

6. （可选）在“管理数据源”菜单中，选择允许刷新访问。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_EDS_extract_access.png)

8. 单击“发布”。

发布工作簿后，将使用工作簿中包含的数据源来呈现工作簿。

### 编辑数据源

或者，在发布工作簿后，您可以从“数据源”选项卡或工作簿将连接类型从“实时”更改为“数据提取”。您也可以将工作簿中的连接类型从“数据提取”更改为“实时”。

若要从“数据源”选项卡中将连接类型从“实时”更改为“数据提取”：

1. 转到“数据源”选项卡。
2. 从“操作”菜单中，选择“数据提取”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_extract.png)

若要从工作簿中将连接类型从“实时”更改为“数据提取”：

1. 转到“视图”选项卡。
2. 单击“编辑工作簿”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_edit_workbook.png)

4. 单击左下角的“数据源”选项卡，然后单击右上角的“数据提取”。
5. 单击“创建数据提取”。

当工作簿数据源更改为“数据提取”时，会自动创建一个作业。

若要将连接类型从“数据提取”更改为“实时”，请从工作簿中更改连接。请勿从“数据源”选项卡中将数据源从“数据提取”更改为“实时”。

1. 转到“视图”选项卡。
2. 单击“编辑工作簿”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_edit_workbook.png)

4. 单击左下角的“数据源”选项卡，然后单击右上角的“实时”。
5. 单击“发布”并刷新工作簿页面。

### 查看刷新作业

可以从“作业”页面查看多种任务类型。

对于使用 Bridge 的嵌入式数据源，任务类型为“数据提取刷新/创建”。对于使用 Bridge 客户端的已发布数据源，任务类型为“Bridge 刷新”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_eds_jobs2.png)

> [!IMPORTANT]
> 
> **注意**：将已发布工作簿连接类型从“实时”更改为“数据提取”时，将创建一个计划作业。但是，“任务类型”并不表明 Bridge 客户端已用作计划作业刷新或运行“立即刷新”时的数据源。任务类型列为“数据提取刷新/创建”。

### 刷新数据提取

您可以直接在 Tableau Cloud 上刷新使用大部分云数据提供程序托管的数据的数据提取。

1. 登录到向其发布数据源的 Tableau Cloud 站点。
2. 在“数据源”页面上，选择要刷新的数据源旁边的“更多操作”图标 (…)，然后从菜单中选择“刷新数据提取”。

![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_edsextract_refresh.png)

4. 选择“刷新数据提取”会计划刷新，但不会立即运行刷新。若要运行刷新，请转到“数据提取刷新”选项卡，选择数据源旁边的“更多操作”图标 ( ... )，然后单击“立即运行”。

## 此部分中的其他文章

<!-- document id=8015425039861b8098f9894ef39e03a7fe6fdfc6528e3dffcf8aca93fe620828 url=/tableau/next/zh-cn/online/datasource_relationships_perfoptions.md -->

[跳转到主要内容](#main-content)

# 使用性能选项优化关系查询

性能选项是定义关系中两个表之间的基数（唯一性）和引用完整性（匹配记录）的可选设置。这些设置可帮助 Tableau 在分析期间优化查询。

- **如果您不确定要选择什么**，请使用 Tableau 指明的推荐默认设置。使用默认值是安全的，在分析期间将自动生成正确的聚合和联接。如果您不知道基数或引用完整性，则无需更改这些设置。
- **如果您知道数据的形状**，则可以选择更改这些设置来表示两个表中的记录之间的唯一性和匹配。

在许多分析方案中，使用关系的默认设置将为您提供分析所需的所有数据。在某些情况下，您可能需要调整“性能选项”设置，以便更准确地描述数据。有关使用关系来合并和分析数据的更多详细信息，请参见[关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)和此 Tableau 博客文章：[关系，第 1 部分：在 Tableau 中引入新的数据建模](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)。

## 基数和引用完整性设置的含义

![用于编辑关系的性能选项设置，包括基数和引用完整性。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_perfoptions.png)

### 基数选项

基数设置确定 Tableau 在分析期间自动联接数据之前或之后是否聚合表数据。

- 如果字段值不唯一，或者您不知道，请选择**“多”**。在分析期间形成联接之前，Tableau 将聚合相关数据。
- 如果字段值是唯一的，请选择**“一”**。在分析过程中，相关数据将在聚合之前联接。当关系中的字段值唯一时，正确设置此选项将可优化工作簿中的查询。但是，当字段值不唯一时选择**“一”**可能会导致视图中显示重复的聚合值。

> [!TIP]
> 
> **注意**：选择**“一”**会将记录视为好像每个键值是唯一的，并且最多只有一行具有 null 值。

### 引用完整性选项

引用完整性设置确定在分析期间用于为度量获取维度值的联接类型。

- 如果字段中的某些值在其他表中没有匹配项，或者您不知道，请选择**“某些记录匹配”**。在分析期间，Tableau 使用外部联接来为度量获取维度值。所有度量值都将显示在视图中，即使是不匹配的度量。
- 如果字段中的值保证在其他表中具有匹配项，请选择**“所有记录匹配”**。此设置将在分析期间生成更少、更简单的联接，并优化查询。如果此表中存在不匹配的值，则在分析期间您可能会看到不一致的结果（视图中不匹配的值已移除或缺失）。

**注意**：选择“**所有记录匹配**”会将记录视为用于关系的字段中不存在 null 值。 在分析期间，Tableau 使用内部联接来为度量获取维度值。默认情况下，Tableau 永远不会联接 null 键。

有关关联基数和引用完整性概念的详细信息，请参见[关联基数和引用完整性](https://help.tableau.com/current/pro/desktop/zh-cn/cardinality_and_ri.htm)。

## 在何处使用联接？

您仍然可以在数据源的物理层中指定表之间的联接。双击逻辑表以转到联接画布。

每个顶层逻辑表至少包含一个物理表。打开逻辑表以查看、编辑或创建其物理表之间的联接。右键单击逻辑表，然后单击“打开”。或者，只需双击表即可将其打开。

![具有两个联接的数据模型。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_singletable_joins.gif)

创建数据源时，数据源有两个层。顶层是数据源的逻辑层。使用关系在逻辑层中的表之间合并数据。

下一个层是数据源的物理层。使用联接在物理层的表之间合并数据。有关详细信息，请参见[数据模型中的逻辑表和物理表](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm#dm_log_phys)。

![数据模型图显示一个由关系链接的两个表的逻辑层，以及一个说明如何从物理表构建逻辑表的物理层。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_layers_sm.png)

## 有关使用性能选项的提示

如果您知道数据的形状，则可以使用性能选项中的可选设置来建立表相对于彼此的关联基数（一对一、一对多、多对多），并指示引用完整性（一个表中的值始终在其他表中具有匹配项）。

不要将性能选项中的设置想像为“是”和“否”，而是要其想像为“是”和“我不知道”。如果确定表的值是唯一的，请选择**“一”**。 如果确定一个表中的每条记录与另一个表中的一条或多条记录匹配，请选择**“所有记录匹配”**。否则，请保留默认设置不变。

如果您不确定数据的形状，请使用默认设置。当 Tableau 无法检测数据中的这些设置时，默认设置为：

- 基数：多对多
- 引用完整性：某些记录匹配

如果 Tableau 在数据中检测到关键关系或引用完整性，则会使用这些设置，并指示为“已检测到”。

若要重新应用默认设置，请单击“恢复为默认值”。

### 定义的术语

_关联基数_是指字段（列）或字段组合中包含的数据的唯一性。当要分析的表包含许多行数据时，查询可能会很慢（并且会影响整个数据源的性能），因此我们建议您根据表之间相关列的基数来选择一种合并数据的方法。

- 低关联基数：当相关列有很多重复数据时。例如，名为“Products”（产品）的表可能包含一个“Category”（类别）列，其中包含三个值的：“Furniture”（家具）、“Office Supplies”（办公用品）和“Technology”（技术）。
- 高关联基数：当相关列具有高度唯一的数据时。例如，名为“Orders”（订单）的表可能包含一个“Order Id”（订单 ID）列，其中包含每个产品订单的唯一值。

_引用完整性_意味着一个表将始终在另一个表中具有匹配的行。例如，“Sales”（销售额）表始终在“Product Catalog”（产品目录）表中具有匹配的行。

<!-- document id=600c259463caa328bc0a9917a0a136b3ce110089c0de95e707bfb7b21dcb9dae url=/tableau/next/zh-cn/online/data_guide.md -->

[跳转到主要内容](#main-content)

# 使用数据指南浏览仪表板

您是否发现了一个新的 Tableau 仪表板，并想知道数据的含义或如何使用它？或者，您是否曾经发布过一个新的仪表板，并希望能够包含如何使用仪表板的说明？

数据指南提供了关于仪表板的有用信息以及关于仪表板背后数据的洞察。数据指南允许仪表板创建者直接在仪表板中为最终用户提供更多解释性上下文，比如描述和资源链接。并且，数据指南自动显示由[“数据解释”功能](https://help.tableau.com/current/pro/desktop/zh-cn/explain_data.htm)提供支持的洞察，以帮助用户发现异常值，并了解标记的解释。“可视化项解释”（由“数据解释”功能提供支持）识别异常值度量及其背后的潜在关键驱动因素。

这些上下文相关的详细信息可以帮助仪表板用户更容易地导航和使用新的仪表板，允许用户更快地找到洞察，相信他们正在查看正确的数据，为数据提供上下文，并建立对可视化项理解的信心。

或者，如果您有一个带有 Tableau+ 的 Tableau Cloud 站点，您可以通过 Tableau Agent 的仪表板叙述功能，使用 AI 来探索您的仪表板。有关详细信息，请参见[使用 Tableau Agent（测试版）创建仪表板叙述](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard-narratives.htm)。

## 以作者身份自定义数据指南

1. 从您的仪表板中，选择“编辑”按钮。
2. 在工具栏中选择“数据指南”。
3. 在“数据指南”窗格中，键入描述以帮助最终用户理解仪表板的用途。
4. 选择“添加链接”，并为链接文本和 URL 输入描述性标签。
5. 选择“确定”。
6. 选择可视化项（仪表板中的一个工作表）。数据指南会自动更新，因此您可以在仪表板中添加与每个可视化项相关的描述和资源。
7. 键入描述，并添加与可视化项相关的链接。
8. 选择“确定”。

> [!TIP]
> 
> **提示：**若要使用数据指南编写自定义替代文本以提高可视化项的可访问性，请参见[显示更多文本并使其有用](https://help.tableau.com/v0.0/pro/desktop/zh-cn/accessibility_create_view.htm#show-more-text-and-make-it-helpful)。

## 以仪表板用户身份浏览数据指南

1. 从仪表板中，选择工具栏中的“数据指南”。
2. 阅读仪表板的描述并浏览仪表板作者提供的资源。
3. 展开“此仪表板中的数据”和“检测到的异常值”，以了解有关仪表板中使用的基础数据的详细信息。
4. 选择可视化项（仪表板中的一个对象）。
5. 阅读可视化项的描述并浏览仪表板作者提供的资源。
6. 展开“数据摘要”和“检测到的异常值”，以了解有关该可视化项中的数据的详细信息。
7. 选择一个标记（或多个标记），例如图表上的条形或地图上的区域，以查看有关此标记中的数据和应用的筛选器的信息。选择单个标记以查看其值的可能解释。  
      
    ![简短的动画展示了当您单击仪表板、可视化项或标记时数据指南如何显示不同的信息](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_ovw.gif)

## 探索不同级别的数据指南

默认情况下，数据指南会在您打开工作簿时显示。您可以在工具栏中打开数据指南。在“数据指南”窗格的顶部，您会看到您选择的仪表板或可视化项的名称。作为仪表板作者，您可以为仪表板和组成仪表板的各个可视化项编写描述。

### 了解仪表板级别详细信息

在仪表板级别，数据指南：

- 显示仪表板的名称、作者和上次发布日期。
- 可以包括由仪表板作者编写的描述和相关资源（例如视频或 wiki 页面）的链接。
- 列出仪表板使用的数据源以及有关数据的详细信息，例如使用了哪些维度和度量。
- 显示仪表板中检测到的异常值，这些异常值由“数据解释”功能确定。有关详细信息，请参见[“数据解释”功能入门](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm)。  
      
    ![仪表板级别的“数据指南”窗格](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_dashboard_level.png)

### 了解可视化项级别详细信息

当用户选择特定的可视化项（仪表板对象）时，数据指南：

- 显示可视化项的名称。
- 可以包括由仪表板作者编写的描述和相关资源（例如视频或 wiki 页面）的链接。
- 列出仪表板使用的数据源，包括使用的维度和度量。
- 列出可视化项中应用的筛选器和使用的数据，因此您可以确定用户与之交互的筛选器如何影响数据。仅显示用户可以更改的筛选器。
- 总结了可视化项中使用的数据，包括数据点的数量和排序详细信息。
- 显示可视化项中检测到的异常值，这些异常值由“数据解释”功能确定。有关详细信息，请参见[“数据解释”功能入门](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm)。  
      
    ![可视化项级别的“数据指南”窗格](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_viz_level.png)

### 了解标记项级别详细信息

当用户选择诸如地图上的区域等一个（或多个）标记时，数据指南：

- 显示标记的名称。
- 列出可视化项中应用的筛选器和使用的数据，这样您就知道哪些被包含，哪些被排除。
- 显示可视化项中检测到的异常值，这些异常值由“数据解释”功能确定。有关详细信息，请参见[“数据解释”功能入门](https://help.tableau.com/v0.0/online/zh-cn/explain_data_basics.htm)。
    
      
    ![标记级别的“数据指南”窗格](/tableau/next/zh-cn/online/zh-cn/Img/data_guide_mark_level.png)

### 获取 Tableau Pulse 指标建议

在 Tableau Cloud 中，当用户选择可视化项时，数据指南会根据该可视化项中使用的字段显示推荐指标。用户可以选择一项推荐的指标以继续在 Tableau Pulse 中对其进行配置。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)。

如果没有可以推荐的字段，但可视化项使用的数据源是已发布的数据源，则用户可以在 Tableau Pulse 中选择要连接到的数据源。如果 Data Guide 无法推荐指标、字段或数据源，用户仍然可以打开 Tableau Pulse 从头开始创建指标。

![显示推荐指标的“数据指南”窗格](/tableau/next/zh-cn/online/zh-cn/Img/pulse_data_guide_bootstrapping.png)

## 控制数据指南的可见性

默认情况下，数据指南会在您打开工作簿时显示。当您打开或关闭数据指南时，它会为站点上的所有工作簿保持此状态。在 2023.1 或更高版本中，站点管理员可以为所有用户隐藏数据指南。这将从站点上所有工作簿的 Tableau 工具栏中移除“数据指南”按钮。若要隐藏数据指南，请执行以下操作：

1. 从左侧的窗格中，选择“设置”。
2. 从“常规”选项卡中，滚动到“数据指南的可用性”。
3. 选择“隐藏”。
4. 选择“保存”。

<!-- document id=cb8c7de15da50545eb3fa0336a2024d8926949c185304a79628db024632413cf url=/tableau/next/zh-cn/online/viewer_controlled_themes.md -->

[跳转到主要内容](#main-content)

# 使用查看器控制的主题

从 Tableau Cloud 版本 2026.2 开始，您可以通过更改查看器主题来自定义在 Tableau Cloud 中的观看体验。您可以将工具栏和导航区域（也称为界面框架）切换为深色主题。

此时，可视化项区域继续以默认的浅色主题显示。这包括工作表标签、卡片、标题、轴和图表背景等元素。

## 主题可用性

查看器控制的主题当前仅在查看模式下可用。当您构建或编辑可视化项时，深色主题尚不可用。当您进入制作模式时，界面会自动切换回默认的浅色主题。离开制作模式后，界面会重新进入您选择的深色主题。  
  
![Tableau Cloud 主页上设置的深色模式主题。](/tableau/next/zh-cn/online/zh-cn/Img/VCT_darkmode.png)

## 更改查看器主题

若要更改主题设置，请打开帐户设置页面。

1. 转到您的用户设置页面。
2. 向下滚动到“辅助功能”部分。
3. 在“主题”下，选择“深色”。

界面会更新工具栏和导航区域以使用深色主题。若要随时切换回来，请重复这些步骤并选择“默认值/浅色”。  
  
![Tableau Cloud 中辅助功能设置下的主题设置。](/tableau/next/zh-cn/online/zh-cn/Img/VCT_setting.png)

**注意：**更改查看器主题只会影响您的个人帐户视图。您的选择不会改变查看相同可视化项的任何其他用户的体验。

<!-- document id=d5a27ac01101841bf4f46f8cc8299e13ea5ae8306d8dd09d0b7b5ebb3f905bba url=/tableau/next/zh-cn/online/activity_log_audit_permissions.md -->

[跳转到主要内容](#main-content)

# 使用活动日志审核权限

权限审核允许系统管理员监控哪些用户修改了对 Tableau 内容的访问控制。可通过两种方式修改权限控制： _明确的_ 更改（通过更改项目或内容项的权限能力）和 _有效_ 更改（通过更改用户站点角色、组成员身份、移动内容等）。所有这些更改都被记录下来，因此管理员可以证明安全和访问控制得到维护。

有关如何评估权限规则的详细信息，请参见[有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)。

## 日志格式

修改用户或组对内容的访问权限的每个操作都将获得一个日志条目。每个日志条目都以 JSON 格式构建，具有代表不同信息片段的特定键。日志条目包含两部分：

- 元数据：包括有关操作发生的时间和地点以及执行操作的用户的信息。
- 操作：包含有关哪些内容的权限已更改、哪些功能已更改以及功能已更改为哪些值的信息。

**注意：**活动日志记录通过权限对话框 UI 和 REST API 所做的更改。有关 API 方法的详细信息，请参见[权限方法](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_permissions.htm)。

活动日志条目未格式化，并且日志中的键未按任何特定顺序排序。审核权限时，您可以将活动日志数据与其他数据源（例如[在线管理见解](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)）相结合，将 ID 链接到名称并使事件更易于解释。

### 示例

以下是一个示例日志条目，显示一个组被允许连接到一个数据源。

{  
"actorUserId": 39872,  
"actorUserLuid": "4e6b42bf-9040-4e60-b326-1c56a4fb96f8",  
"authorizableType": "DATASOURCE",  
"capabilityId": 32,  
"capabilityValue": "connect",  
"contentId": 2099835,  
"contentName": "Superstore ExtractNeal3",  
"eventTime": "2023-01-31T22:44:23.650058Z",  
"granteeId": 22,  
"granteeLuid": "dae0717a-d524-436d-b469-fadeaa22a5dd",  
"granteeType": "Group",  
"granteeValue": "GROUP\_ALLOW",  
"initiatingUserId": 39872,  
"initiatingUserLuid": "4e6b42bf-9040-4e60-b326-1c56a4fb96f8",  
"isError": false,  
"eventCategory": "security",  
"eventType": "set\_permissions",  
"eventVersion": "1.0",  
"permissionType": "explicit",  
"siteLuid": "b45e272d-10c7-49d5-9037-e53ce47dbf4e"  
}

日志条目捕获有关事件的基本信息，其中包括：

- `eventType` 显示发生了设置权限事件
- `permissionType` 显示对权限的明确更改
- `contentId` 显示修改的内容的 ID
- `authorizableType` 显示内容类型，在本例中为数据源
- `capabilityValue` 显示已更改的能力
- `granteeId` 显示受影响的被授权人
- `actorUserId` 显示执行更改的用户的 ID
- `eventTime` 显示更改的日期和时间

## 事件

日志条目包含权限更改的各种事件类型，例如 `content_owner_change`（当内容所有者发生变化时）或 `set_permissions`（当创建或更新权限规则时）。不同的操作会产生不同的事件。有关事件类型、属性及其记录时间的详细信息，请参见[活动日志站点事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm)。

<!-- document id=5f08a65f041cce8b6cb3ae9f6c6a653bacb56bef5882f3f3bc4eabb4d3d316ad url=/tableau/next/zh-cn/online/activity_log_monitor_data_exports.md -->

[跳转到主要内容](#main-content)

# 使用活动日志监控数据导出

监控公司数据的使用方式是管理员的重要工作职责。使用活动日志，您可以实时查看数据导出，以保持数据安全性和合规性。

本主题介绍管理员如何使用不同的事件类型来查看哪些用户导出了数据，包括：

- **下载已发布内容：**这是指下载 Tableau Cloud 站点上发布的工作簿、数据源和流程。
- **从已发布内容访问或导出数据：**这是指从已发布的视图或仪表板导出数据。例如，以 .png 格式下载视图图像，或将数据导出为逗号分隔值 (.csv) 文件。

## 先决条件

若要监控数据导出，您的活动日志数据必须采用结构化且可查询的格式。在继续之前，请确保满足以下先决条件：

- **活动日志配置：**设置活动日志以将日志文件写入 AWS S3 存储桶。
- **数据导入：**将活动日志生成的日志文件导入监控工具，例如 Splunk 或 Amazon EventBridge。或者，您可以将它们导入云数据仓库，比如 Snowflake 或 Google BigQuery。目标是将数据转换为易于查询和分析的格式。

**注意：**本主题未介绍将活动日志数据导入数据存储的过程。有关详细说明，请参阅[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)和适用于您选择的数据平台的文档。

## 监控数据导出的原因

对于以下方案，您可以使用活动日志来监控数据导出：

- **增强的安全性和合规性：**确定是否在未经授权的情况下导出了敏感信息。这有助于确保满足内部安全策略和外部法规遵从性要求，例如 GxP、GDPR 或 HIPAA。
- **数据治理：**了解谁在导出什么数据有助于控制您的数据资产。借助更高的可见性，您可以发现数据复制、误用或意外数据蔓延的情况。这有助于确保您的数据治理政策得到遵守。
- **了解用户行为：**通过分析数据导出模式，可以了解用户与数据的交互方式。这可以帮助您确定数据访问策略、确定需要额外培训的领域或使数据更易于查找的方法。

## 了解活动日志中的导出事件

我们已经介绍了为什么监控数据导出很重要，但让我们讨论用户作在活动日志中的显示方式。此部分可帮助您识别用户在站点上执行的特定操作及其相应的活动日志事件。

根据导出数据的方式，您可能需要事件类型的端点筛选器。

### 从操作菜单下载

下表显示了在 Tableau Cloud 内容菜单上执行的下载操作在活动日志中的显示方式。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 30%;"><col></colgroup><tbody><tr><th>用户交互</th><th>活动日志事件名称</th><th>端点名称 (endpointName)</th></tr><tr><td>下载工作簿</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-download-workbook" class="xref">hist_download_workbook</a></td><td>不可用</td></tr><tr><td>下载数据源</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-download-datasource" class="xref">hist_download_datasource</a></td><td>不可用</td></tr><tr><td>下载流程</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-download-flow" class="xref">hist_download_flow</a></td><td>不可用</td></tr></tbody></table>

**示例**

查看哪些用户导出了工作簿：

1. 打开您设置的监控工具，例如 Splunk 或 Amazon EventBridge。
2. 在 `endpointName = hist_download_workbook` 上进行筛选。

![下拉菜单显示用于编辑、共享、下载和移动工作簿的选项。](/tableau/next/zh-cn/online/zh-cn/Img/export_from_action_menu.png)

### 从视图导出

下表显示了对视图执行的导出操作在活动日志中的显示方式。有关特定导出格式的详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[下载视图和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/export.htm)。

**注意：**活动日志不记录使用 Tableau REST API 启动的导出（例如 PNG、CSV 或 PDF）。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 30%;"><col></colgroup><tbody><tr><th>用户交互</th><th>活动日志事件名称</th><th>端点名称 (endpointName)</th></tr><tr><td>导出摘要数据</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-export-summary-data" class="xref">hist_export_summary_data</a></td><td>不可用</td></tr><tr><td>导出基础数据</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-export-underlying-data" class="xref">hist_export_underlying_data</a></td><td>不可用</td></tr><tr><td>导出工作簿*</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#hist-download-workbook" class="xref">hist_download_workbook</a></td><td>不可用</td></tr><tr><td>导出到图像</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#vizql-http-request" class="xref">vizql_http_request</a></td><td>executeCommand.tabsrv.export-image-server</td></tr><tr><td>导出到交叉表*</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#vizql-http-request" class="xref">vizql_http_request</a></td><td>executeCommand.tabsrv.export-crosstab-to-excel-server</td></tr><tr><td>导出到 CSV*</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#vizql-http-request" class="xref">vizql_http_request</a></td><td>executeCommand.tabsrv.export-crosstab-to-csvserver</td></tr><tr><td>导出到 PDF*</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#vizql-http-request" class="xref">vizql_http_request</a></td><td>executeCommand.tabsrv.export-pdf-server</td></tr><tr><td>导出到 PowerPoint*</td><td><a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm#vizql-http-request" class="xref">vizql_http_request</a></td><td>executeCommand.tabsrv.power-point-export-server</td></tr></tbody></table>

\*对于此下载格式，将显示确认对话框。如果用户继续，则会在日志中记录一个 `getSessionTempFile` 端点。如果用户在未确认的情况下关闭对话框，则不会记录任何值。

**示例**

查找已导出到 CSV 的用户：

1. 打开您设置的监控工具，例如 Splunk 或 Amazon EventBridge。
2. 在以下值上进行筛选：
    
    1. `eventType = vizql_http_request`。
    2. `endpointName = executeCommand.tabsrv.export-crosstab-to-csvserver`。
    3. `endpointName = getSessionTempFile`。

![下拉菜单包含文件格式选项，如图像、数据或 PDF。](/tableau/next/zh-cn/online/zh-cn/Img/export_from_view.png)

<!-- document id=8e6f48a33d1fc86e72dfa06f17193d82ca75d3c4b8020a1d2df56dfe33e7f275 url=/tableau/next/zh-cn/online/activity_log_monitor_view_load_times.md -->

[跳转到主要内容](#main-content)

# 使用活动日志监控视图加载时间

确保视图以最佳方式为用户呈现是管理员的重要职责。使用活动日志，您可以实时识别性能问题并解决出现的问题，以保持站点平稳运行。

本主题介绍管理员如何使用 `vizql_http_request` 事件类型来了解视图加载时间并解决性能瓶颈问题。

## 先决条件

若要监控视图加载时间，您的活动日志数据必须采用结构化且可查询的格式。在继续之前，请确保满足以下先决条件：

- **活动日志配置：**设置活动日志以将日志文件写入 AWS S3 存储桶。
- **数据导入：**将活动日志生成的日志文件导入监控工具，例如 Splunk 或 Amazon EventBridge。或者，您可以将它们导入云数据仓库，比如 Snowflake 或 Google BigQuery。目标是将数据转换为易于查询和分析的格式。

**注意：**本主题未介绍将活动日志数据导入数据存储的过程。有关详细说明，请参阅[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)和适用于您选择的数据平台的文档。

## 入门指南

那么我们从哪里开始呢？您可以通过关注仪表板或视图的初始加载（称为“引导程序会话”事件）来监控视图性能。此事件通常会捕获呈现视图所需的大部分时间，让您清楚地知道加载所花费的时间。

监控引导程序事件：

1. 打开您设置的监控工具，例如 Splunk 或 Amazon EventBridge。
2. 在以下值上进行筛选：
    
    1. `eventType = vizql_http_request`。
    2. `endpointName = bootstrapSession`。
    3. `eventOutcome = success`。
3. 在结果中，查找 `duration` 字段。

Vizql\_http\_request 事件的 duration 字段表示操作完成所需的时间（以毫秒为单位）。这有助于跟踪和分析 Tableau 视图的初始加载时间。

> [!TIP]
> 
> **提示：**不知道从哪里开始？使用 Admin Insights Starter 工作簿中包含的“Dashboard Load Times”（仪表板加载时间）仪表板。此仪表板显示内容的加载时间和性能评级，帮助您识别有问题的视图。然后，您可以使用活动日志实时查看哪些用户正在遇到问题，以及工作簿修订可能会如何影响性能。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

## 监控错误

除了性能之外，您还可以使用引导程序会话数据来查看用户在查看内容时是否遇到错误。若要查看这些错误，请搜索 eventOutcome 和 eventOutcomeReason 字段。这些字段对于设置监视通知和提供调查起点非常有用。举例来说，如果用户在查看仪表板时报告错误，您可以查看引导程序会话以查看历史用户交互。这有助于查明触发错误的原因并确定问题开始的时间。了解此信息对于排查问题的根本原因非常重要。

- **eventOutcome：**此字段记录每个操作的高级成功或失败类别（success、failure、client\_error 或 internal\_error）。
- **eventOutcomeReason：**此字段提供有关所出错情况的更多详细信息，通常记录描述错误的 HTTP 状态代码。

监控错误：

1. 打开您设置的监控工具，例如 Splunk 或 Amazon EventBridge。
2. 在以下值上进行筛选：
    
    1. `eventType = vizql_http_request`。
    2. `endpointName = bootstrapSession`。
    3. `eventOutcome != success`。
3. 在结果中，查看 `eventOutcomeReason` 以了解有关错误的更多详细信息。

## 排查性能问题

有许多因素会导致性能问题，从而使问题难以调查。不过，您可以采用几种方法来简化流程。此部分概述了使用引导程序会话排查工作簿性能问题的常见方式。首先，确定问题是出在一个工作簿还是几个工作簿上。然后，按照相关部分中的说明进行操作。

### 排查单个工作簿的问题

如果性能问题出现在单个工作簿上，请使用这些步骤。

1. **确定工作簿修订：**
    
    请检查性能问题是否是新的工作簿修订引入的。您可以通过在引导程序会话中查看 `workbookRevision` 属性来执行此操作。此过程可能需要将用户访问与工作簿的早期版本进行比较。
    
    如果新修订版导致性能问题，请与工作簿所有者联系，并与他们一起改进设计。
2. **检查用户特定问题：**
    
    如果性能问题不是特定于工作簿修订的，请确定它是否仅影响某些用户。您可以通过在引导程序会话中查看 `requestUri` 和 `actorUserLuid` 属性来执行此操作。`requestUri` 属性提供正在访问的工作簿或视图的 URL，`actorUserLuid` 属性提供访问视图的用户。使用这两种方法都可以帮助您区分单独的用户会话。
    
    如果问题是特定于用户的，请查找用户之间的相似之处。例如，问题可能是由于这些用户正在访问的自定义视图，或者他们与视图交互的某些方式所导致的。您将需要解析 `requestURI` 属性以标识特定视图。
3. **查看行级安全性：**
    
    如果某些用户遇到性能问题，并且自定义视图不是原因，则问题可能与工作簿中实施的行级安全性 (RLS) 有关。RLS 可能会显著影响性能，特别是在安全规则复杂或数据集很大的情况下。有关详细信息，请参见[Tableau 中的行级安全性选项概述](https://help.tableau.com/v0.0/online/zh-cn/rls_options_overview.htm)。

### 排查工作簿子集问题

如果性能问题出在工作簿子集上，请使用这些步骤。

1. **确定常用数据源：**
    
    查找受影响工作簿使用的数据源中的共性。
    
    如果受影响的工作簿使用与数据库服务器或云数据仓库的实时连接，则性能问题可能出在实时连接上。
    
    如果受影响的工作簿正在使用数据提取，请检查它们最近是否有更新。您可以使用活动日志中的 `hist_publish_datasource` 事件类型或“在线管理见解”中的“TS 事件”数据源来识别最近的更改。
2. **查看数据源性能：**
    
    对于实时连接，请监控数据库服务器或云数据仓库的性能。检查服务器端是否有任何最近的更改或问题。此步骤在 Tableau 外部执行。
    
    对于提取的数据源，请查看提取过程和任何最近的更新。请确保数据提取经过优化，并且数据不会太大或太复杂。有关详细信息，请参见[在 Web 上创建数据提取](https://help.tableau.com/v0.0/online/zh-cn/datasource_extract.htm)。

## 重要注意事项

使用活动日志来监控视图加载时间是掌握仪表板性能和用户参与度的好方法。但是，并非每个仪表板或视图呈现操作都会生成引导程序会话事件。下面是一些不需要引导程序会话事件的情况：

- **缓存的仪表板：**如果仪表板或视图是从以前的缓存中检索的。
- **标签切换：**如果用户在同一工作簿中切换标签，并且加载或缓存新标签的内容。

通过使用 `vizql_http_request` 事件类型并关注 `bootstrapSession` 事件，您可以获得对视图性能的宝贵见解并主动解决问题。

<!-- document id=856643cd619740faa370cc3a2638685985bbd12b904e5b9b986362dd0974ef82 url=/tableau/next/zh-cn/online/connected_apps_direct.md -->

[跳转到主要内容](#main-content)

# 使用直接信任配置已连接应用

从 2022 年 1 月初开始， Tableau 已连接应用通过促进您的 Tableau Cloud 站点与外部应用程序之间建立明确的信任关系，实现无缝且安全的身份验证体验。

**注意：**为了使会话令牌有效，外部应用程序和托管外部应用程序的服务器的时钟必须设置为协调世界时 (UTC)。如果任何一个时钟使用不同的标准，连接的应用软件将不被信任。

## Tableau 已连接应用如何与直接信任协同工作

您的 Tableau Cloud 站点和外部应用程序之间的信任关系是通过 JSON 网络令牌 (JWT) 标准中的身份验证令牌建立和验证的，该令牌使用由 Tableau 已连接应用提供并由您的自定义应用程序签名的共享密文。

### 已连接应用的关键组件

已连接应用的以下组件与外部应用程序中的 JWT 一起工作，以验证用户身份并显示嵌入的内容。

- **密文：**密文是 Tableau 和您的外部应用程序共享的密钥。它们在形成 JWT 的签名中使用。使用已连接应用进行嵌入身份验证或 REST API 授权时需要密文。密文可以在已连接应用中创建，不会过期，并且在删除之前一直有效。
- **域允许列表（仅限嵌入工作流）：**您可以在每个已连接应用中指定允许的域的列表。通过已连接应用嵌入的 Tableau 内容仅允许在指定的域下使用。这有助于确保内容在您的企业保护和批准的域下公开。
- **访问级别（仅限嵌入工作流）：**您可以通过将已连接应用与一个项目或所有项目相关联来指定可通过已连接应用嵌入哪些内容。如果指定一个项目，则只能通过已连接应用嵌入所选项目中的内容。如果要指定多个项目，则必须使用 Tableau REST API。

### 已连接应用工作流程

#### 嵌入工作流

下图说明了外部应用程序（Web 服务器及网页）和 Tableau 已连接应用之间的身份验证工作方式。

![该图表说明了网页、外部应用程序和 Tableau 之间的数据流。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_how.png)

1. **用户访问网页：**当用户访问网页上的嵌入内容时，网页会向您的外部应用程序发送 GET 请求以检索该网页上的 HTML。
2. **外部应用程序构建身份验证令牌：**外部应用程序构建 JWT，其中包含来自已连接应用的密文（有关其他 JWT 要求，请参见下面的“步骤 3”）以及用户对嵌入内容的访问范围。该密文由外部应用程序签名，用于后续步骤中的信任关系验证。
3. **外部应用程序使用身份验证令牌响应：**外部应用程序使用网页调用的嵌入内容 URL 中的 JWT 响应页面。
4. **网页从 Tableau 请求内容**：尝试加载嵌入内容时，网页调用嵌入内容的 URL，后者向 Tableau 发送 GET 请求。
5. **Tableau 验证令牌：** Tableau 接收 JWT 并通过识别 JWT 中使用的已连接应用和共享密文来验证与外部应用程序的信任关系。然后 Tableau 为用户创建一个会话。会话不仅遵守 JWT 中定义的嵌入范围，还遵守已连接应用中指定的限制，包括允许的域和允许的项目。
6. **Tableau 根据受限制的嵌入上下文返回内容：**嵌入的内容仅在页面位于允许的域下并且内容发布到允许的项目（如果适用）时加载。经过身份验证的用户只能通过 JWT 中定义的范围与嵌入的内容进行交互。

## 创建已连接应用

### 步骤 1：创建已连接应用

从 Tableau Cloud 的“设置”页面创建已连接应用。

1. 以站点管理员身份登录 Tableau Cloud。
2. 从左侧窗格中，选择“设置”\>“已连接应用”。
3. 选择“新建已连接应用”按钮下拉箭头，并选择“直接信任”。
4. 在“创建已连接应用”对话框中，执行以下操作_之一_：
    - 对于_REST API 授权工作流（包括使用 REST API 进行身份验证的元数据 API 工作流）_，在“已连接应用名称”文本框中，输入已连接应用的名称，然后选择“创建”按钮。
        
        **注意：**在为 REST API 和元数据 API 授权配置已连接应用时，您可以忽略“访问级别”和“域允许列表”。
    - 对于_嵌入工作流_，请执行以下操作：
        1. 在“已连接应用名称”文本框中，输入已连接应用的名称。
        2. 从“应用于”下拉菜单中，选择“所有项目”或“仅一个项目”来控制可以嵌入哪些视图或指标。如果您选择“仅一个项目”选项，请选择要确定范围的特定项目。有关这两个选项的详细信息，请参见[访问级别（仅限嵌入工作流）](#projects)。
            
            **注意：** 
            
            - 在 2023 年 10 月版 (Tableau 2023.3) 中，Tableau 停用了嵌入指标的功能。
            - 在 2024 年 2 月 (Tableau 2024.1) 中，您可以使用 Tableau REST API 指定多个项目。有关详细信息，请参见 REST API 帮助中的 [Create Connected App（创建已连接应用）](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_connected_app.htm#create_connectedapp)和 [Update Connected App（更新已连接应用）](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_connected_app.htm#update_connectedapp)方法。
        3. 在“域允许列表”中，使用下面的[域格式设置](#domain_formatting)中描述的规则指定域，以控制可以嵌入视图或指标的位置。
            
            **重要信息：**我们建议使用域允许列表作为安全最佳实践，以确保 Tableau 内容仅嵌入在您允许的位置。
        4. 完成后，选择“创建”按钮。
            
            ![用于创建已连接应用的表单，包括应用名称、访问级别和域允许列表字段。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_create.png)
5. 在已连接应用的名称旁边，选择操作菜单并选择“启用”。出于安全考虑，已连接应用在创建时默认设置为禁用。
    
    ![启用、编辑或删除已连接应用对话框。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_action_menu.png)
6. 记下已连接应用的 ID（也称为客户端 Id），以在下面的“步骤 3”中使用。
    
    ![您的客户 ID 和“复制”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_clientid.png)

### 步骤 2：生成密文

您可以为每个已连接应用生成总共两个密文。第二个密文可用于密文轮换目的，以帮助防止密文泄露时出现问题。

1. 在您在“步骤 1”中创建的已连接应用的详细信息页面上，选择“生成新密文”按钮。
2. 记下要在下面的“步骤 3”中使用的密文 ID 和密文值。
    
    ![动作的生成日期、ID 和值。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_secret.png)

### 步骤 3：配置 JWT

生成密文后，您希望使外部应用程序能够发送有效的 JWT。JWT 是用于在两方之间安全传输信息的标准。JWT 由您的外部应用程序签名，以安全地将信息发送到 Tableau Cloud。JWT 引用已连接应用、为其生成会话的用户以及用户应具有的访问级别。

有效的 JWT 包括以下信息：

- 来自“步骤 1”的已连接应用 ID（也称为客户端 ID）
- “步骤 2”中生成的密文 ID 和密文值
- 注册的声明和标题：<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 126px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 126px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">声明</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">名称</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">描述或必需值</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>kid</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">密文 ID</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">“<code>iss</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">颁发者</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">必需（在标题中）。标识受信任的已连接应用及其签名密钥的唯一颁发者 URI。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>alg</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">算法</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">必需（在标题中）。JWT 签名算法。仅支持 HS256。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>sub</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">使用者</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">经过身份验证的 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 用户的用户名（电子邮件地址）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>aud</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">受众</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">值必须是：“<code>tableau</code>”。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>exp</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">到期时间</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">有效的 JWT 不得过期。JWT 的过期时间（UTC 时间）必须在最长有效期（即 10 分钟）内。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>jti</code>”</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">要求采用声明形式。JWT ID 声明为 JWT 提供唯一标识符，并且区分大小写。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">“<code>scp</code>”<p><b style="font-style: normal;">重要：</b>不要使用“<code>scope</code>”。</p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">范围</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">对于<i>嵌入工作流</i>，支持的值包括：<p>“<code>tableau:views:embed</code>”<br>“<code>tableau:views:embed_authoring</code>”<br>“<code>tableau:metrics:embed</code>”（于 2023 年 10 月已停用 (Tableau 2023.3)）<br>“<code>tableau:ask_data:embed</code>”（于 2024 年 3 月停用 (Tableau 2024.1) 中停用）</p><p><b>注意：</b></p><ul><li>值必须作为列表类型传递。</li><li>对于 <code>tableau:views:embed</code> 和 <code>tableau:views:embed_authoring</code>，范围遵循已在 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 中配置的用户权限，并允许用户与嵌入视图中的工具进行交互（如果在原始视图中可用）。</li><li>我们建议嵌入代码排除工具栏参数。有关详细信息，请参见下面的<a href="#known_issues" class="xref">已知问题（仅限嵌入工作流）</a>。</li></ul><p>对于 <i>REST API 授权工作流</i>，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm#scopes" class="xref">支持 JWT 授权的 REST API 方法</a>。</p><p>对于<i>使用 REST API 进行身份验证的元数据 API 工作流</i>，唯一支持的范围是 <code>tableau:content:read</code>。</p><p>对于<i>使用 REST API 进行身份验证的 VizQL Data Service 工作流</i>，唯一支持的范围是 <code>tableau:viz_data_service:read</code>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>https://tableau.com/oda</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">按需访问 - 声明（启用功能）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须是“<code>true</code>”，并且必须指定一个或多个 Tableau Cloud 组（请参见下一行）。有关详细信息，包括诸如“嵌入分析”或“基于容量的 Viewer（查看者）块”许可证之类的先决条件，请参见 Tableau Embedding API v3 帮助中的<a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">自定义和控制数据访问</a>页面。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="2"><code>https://tableau.com/groups</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">按需访问 - 声明（指定组名称）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须与 Tableau Cloud 中的一个或多个组的名称匹配。有关详细信息，包括诸如“嵌入分析”或“基于容量的 Viewer（查看者）块”许可证之类的先决条件，请参见 Tableau Embedding API v3 帮助中的<a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">自定义和控制数据访问</a>页面。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">动态组成员身份</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>值必须与 Tableau Cloud 中的一个或多个组的名称匹配。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#assertions" class="xref">使用断言的动态组成员身份</a>。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（用户属性）</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（用户属性值）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">仅适用于<i>嵌入工作流</i>。<p>您可以在 JWT 中包含用户属性。然后，当在嵌入内容中使用用户属性函数时，Tableau 会检查经过身份验证的用户的上下文并确定哪些数据可以在运行时显示。</p><p><b>注意：</b></p><ul><li><p>查看 <a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#known-issues" target="_blank">Tableau Embedding API v3</a> 帮助以了解可能影响您的工作流程的<i>已知问题</i>和<i>限制</i>。</p></li><li><p>为了使用户属性起作用，1) 您必须启用<span class="uicontrol">“在身份验证工作流程中控制用户访问”</span>设置，并且 2) 内容作者必须创建一个<a href="https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm#user_attributes" target="_blank">用户属性函数</a>。</p></li><li>用户属性区分大小写。</li></ul></td></tr></tbody></table>

#### 示例 JWT

以下是 Java 和 Python 语言的示例 JWT。Java 和 Python 示例分别使用 nimbus-jose-jwt 库和 PyJWT 库。

**Java**

import com.nimbusds.jose.\*;
import com.nimbusds.jose.crypto.\*;
import com.nimbusds.jwt.\*;

import java.util.\*;

...

String secret = "secretvalue";
	String kid = "connectedAppSecretId";
	String clientId = "connectedAppClientId";
	List<String> scopes = new
ArrayList<>(Arrays.asList("tableau:views:embed"));
	String username = "user@domain.com";
	JWSSigner signer = new MACSigner(secret);
	JWSHeader header = new
JWSHeader.Builder(JWSAlgorithm.HS256).keyID(kid).customParam("iss", clientId).build();
	JWTClaimsSet claimsSet = new JWTClaimsSet.Builder()
		.issuer(clientId)
		.expirationTime(new Date(new Date().getTime() + 60 \* 1000)) //expires in 1 minute
		.jwtID(UUID.randomUUID().toString())
		.audience("tableau")
		.subject("username")
		.claim("scp", scopes)
		.claim("https://tableau.com/oda", "true")
		.claim("https://tableau.com/groups", "Contractors", "Team C", "Group1", "Group2")
		.claim("Region", "East")
		.build();
	SignedJWT signedJWT = new SignedJWT(header, claimsSet);
	signedJWT.sign(signer);
	model.addAttribute("token", signedJWT.serialize());

**Python**

import jwt

token = jwt.encode(
	{
		"iss": connectedAppClientId,
		"exp": datetime.datetime.utcnow() + datetime.timedelta(minutes=5),
		"jti": str(uuid.uuid4()),
		"aud": "tableau",
		"sub": user,
		"scp": \["tableau:views:embed", "tableau:metrics:embed"\],
		        "https://tableau.com/oda":"true",
		        "https://tableau.com/groups": \["Contractors", "Team C", "Group1", "Group2"\],
		        "Region": "East"
	},
		connectedAppSecretKey,
		algorithm = "HS256",
		headers = {
		'kid': connectedAppSecretId,
		'iss': connectedAppClientId
        }
  )

配置 JWT 后，当代码由您的外部应用程序运行时，它将生成一个令牌。

### 步骤 4：后续步骤

#### 对于嵌入工作流

配置 JWT 后，您必须向外部应用程序中添加嵌入代码。确保在外部应用程序调用的 Web 组件中包含您在上述“步骤 3”中配置的有效 JWT。

有关嵌入 Tableau 内容和嵌入工作流中支持的功能的详细信息，请参见以下主题：

- 使用 [Tableau Embedding API v3](https://help.tableau.com/current/api/embedding_api/zh-cn/index.html) 嵌入 Tableau 内容。
- 有关基于属性的访问控制 (ABAC)、按需访问和动态组成员身份的用户属性，请参见 Tableau Embedding API v3 中的[自定义和控制数据访问](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html)。
- 嵌入指标，请参见 Tableau 帮助中的[将指标嵌入网页](https://help.tableau.com/current/pro/desktop/zh-cn/embed_metrics.htm)主题。（在 2023 年 10 月版 (Tableau 2023.3) 中，Tableau 停用了嵌入指标的功能。）

**注意：**为了让用户在访问嵌入式内容时成功进行身份验证，浏览器必须配置为允许第三方 Cookie。

#### 对于 REST API 授权工作流

配置 JWT 后，您必须将有效的 JWT 添加到 REST API 登录请求以进行授权访问。有关详细信息，请参见[已连接应用的访问范围](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm)。

#### 对于元数据 API 工作流

配置 JWT 后，您必须将有效的 JWT 添加到 REST API 登录请求。有关详细信息，请参见[已连接应用的访问范围](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_scopes.htm)。

#### 对于 SCIM 工作流的外部令牌

配置 JWT 后，您必须配置 SAML 身份验证并启用 SCIM 功能。有关详细信息，请参见[使用直接信任配置已连接应用](#scim)。

## 管理已连接应用

您可以在“已连接应用”页面上管理站点的所有已连接应用。您可以执行诸如以下任务：创建、删除和禁用已连接应用；以及在现有密文已泄露的情况下撤销或生成新密文。

1. 以站点管理员身份登录 Tableau Cloud。
2. 从左侧窗格中，选择“设置”\>“已连接应用”。
3. 选中您要管理的已连接应用旁边的复选框，然后执行以下一项或多项操作：
    
    - 根据您组织的安全策略指定的轮换时间线**生成新密文**。若要生成额外的密文，请单击已连接应用的名称，然后单击“生成新密文”按钮。一个已连接应用最多可以有两个密文。这两个密文可以同时处于活动状态，不会过期，并且在被删除之前一直有效。
    - 通过选择已连接应用的名称查看已连接应用的创建时间、其 ID、项目和域范围及其密文，**查看已连接应用详细信息**。
    - **更改项目范围或域**，在“操作”菜单中，选择“编辑”。进行更改并选择“更新”。
        
        **注意：**如果您更改项目或域范围，并且新项目或新域中不存在嵌入的内容，则嵌入的视图或指标无法显示，用户在访问嵌入的内容时会看到错误。
    - 通过选择已连接应用的名称来**删除密文**。在已连接应用页面上，单击密文旁边的“操作”并选择“删除”。在确认对话框中，再次选择“删除”。
        
        **注意：**如果外部应用程序正在使用已连接应用的密文，则删除密文后无法显示嵌入的视图或指标。有关详细信息，请参见下面的[禁用或删除已连接应用或删除密文的影响](#effects)。
    - **禁用已连接应用**，在“操作”菜单中，选择“禁用”。如果外部应用程序正在使用已连接应用，则在禁用已连接应用后无法显示嵌入的视图或指标。有关详细信息，请参见下面的[禁用或删除已连接应用或删除密文的影响](#effects)。
    
    ![显示两个随机生成的客户代码的表单。](/tableau/next/zh-cn/online/zh-cn/Img/connectedapp_details.png)

### 禁用或删除已连接应用或删除密文的影响

若要通过已连接应用向您的用户显示嵌入式内容或启用 REST API 访问权限，必须启用已连接应用并生成其密文。如果已连接应用正在您的外部应用程序中使用并且被禁用或删除，或者其密文被删除或替换，则用户将收到 403 错误。

为了避免此问题，请确保启用已连接应用并且 JWT 使用正确的密文 ID 和值。

### 访问级别（仅限嵌入工作流）

在配置已连接应用的访问级别时，您可以选择以下两个项目类型之一：访问级别控制可以嵌入哪些内容。

- **所有项目：**此选项允许嵌入所有项目中的内容
- **仅一个项目：**此选项仅允许嵌入指定项目中的内容。如果指定的项目包含嵌套项目，则不会启用在这些嵌套项目中嵌入内容。

**关于多个项目**

从 2024 年 2 月 (Tableau 2024.1) 开始，您可以仅使用 Tableau REST API 为已连接应用启用多个项目中的内容。要指定哪些项目，请使用[创建已连接应用](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_connected_app.htm#create_connectedapp)或[更新已连接应用](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_connected_app.htm#update_connectedapp)方法中的“项目 ID”。

**注意：**当为已连接应用配置多个项目时，Tableau 会针对已连接应用的访问级别显示**“多个项目”**。如果您选择“仅一个项目”或“所有项目”并更新已连接应用，“多个项目”选项将不再可见。如果您需要再次为多个项目配置已连接应用，则必须使用 REST API。

### 域允许列表规则（仅限嵌入工作流）

已连接应用的域允许列表使您能够将对嵌入式 Tableau 内容的访问限制为所有域或某些域；或者排除某些域或阻止所有域。

**重要信息：**我们建议使用域允许列表作为安全最佳实践，以确保 Tableau 内容仅嵌入在您允许的位置。

#### 域选项

在配置已连接应用的域允许列表时，您可以选择以下两个选项之一：

- **所有域：**作为默认选项，此选项启用对嵌入内容的无限制访问。
- **仅特定域：**此选项使您能够缩小对嵌入内容的访问范围。如果使用此选项，请遵循下面的[域格式设置](#domain_formatting)部分指定的格式设置规则。

#### 域格式设置

在域允许列表文本框中，您可以使用下面的格式示例输入一个或多个域。

**注意：**在 Tableau REST API 中使用[已连接应用方法](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_connected_app.htm)时，域格式设置规则也适用。

以下是一些基于常见场景的格式设置示例：

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">若要指定...</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">示例</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">嵌入访问</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">域范围</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">*.myco.com</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">可以从 myco.com 下的所有子域访问嵌入的内容。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">所有端口</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com:*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">可以通过 myco.com 的所有端口访问嵌入式内容。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">特定端口</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com:8080</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">只能通过 myco.com 的 8080 端口访问嵌入式内容。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">多个离散域</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">myco.com<br>events.myco.com<br>ops.myco.com<br></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>嵌入的内容可从所有三个域访问。</p><p><b>注意：</b>指定多个域时，请在新行中键入每个域，或使用空格将各个域分开。对于 REST API，域必须用空格分隔。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">仅安全流量</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://</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">进入一系列域的所有端口的安全流量</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://*myco.com:*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">可以通过 myco.com 下的所有子域上的所有端口访问嵌入式内容。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">没有域</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">[没有域]</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">对嵌入内容的访问被阻止。</td></tr></tbody></table>

### 已知问题（仅限嵌入工作流）

使用已连接应用时存在一些已知问题，这些问题将在未来版本中解决。

- **工具栏功能：**当嵌入式内容定义了工具栏参数时，并非所有工具栏功能都可以使用。为了解决此问题，我们建议您像下面的示例一样隐藏工具栏参数。
    
    <tableau-viz id='tab-viz' src='https://online.tableau.com/t/<your\_site>/...'
    	toolbar='hidden'>
    </tableau-viz>

- **已发布数据源：**将不会显示设置为提示用户提供数据库凭据的已发布数据源。为了解决此问题，如果可能，我们建议数据源所有者改为嵌入他们的数据库凭据。

- **嵌入式仪表板中的“数据问答”(Ask Data) 功能对象：**不会加载嵌入式仪表板中的“数据问答”(Ask Data) 功能对象。（在 2024 年 2 月 (Tableau 2024.1) 中，Tableau 停用了“数据问答”(Ask Data) 功能。）
- **指标和域允许列表：**尽管在已连接应用的域允许列表中可能指定了访问限制，嵌入式指标视图仍将显示。**注意：** 从嵌入式视图的工具栏访问的指标数据将按预期工作。（在 2023 年 10 月版 (Tableau 2023.3) 中，Tableau 停用了嵌入指标的功能。）

## 疑难解答

您可以参考[已连接应用故障排除 - 直接信任](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_troubleshoot.htm)来了解可能与已连接应用相关的错误以及建议的故障排除步骤。

<!-- document id=72436652065e739d43cf05e55139ee02af97ef6f78a24357bf790cb7d7d405ae url=/tableau/next/zh-cn/online/group_sets.md -->

[跳转到主要内容](#main-content)

# 使用组集

从 2024 年 6 月版 (Tableau 2024.2) 开始，您可以使用组集为您的组创建一个容器。组集可以包含一个或多个组，并可用于应用依赖于组集的内容权限的更细粒度的规则。根据组集启用功能时，属于该组集的组中的用户必须是所有组的成员，才能评估该功能。通过这种方式，组集强制执行“AND”逻辑。

**组集的好处：**

- 您可以在权限规则中将同步组与本地组混合搭配，以实现更加动态的访问控制场景。
- 在权限规则中对组使用 AND 逻辑，这可以在某些情况下简化访问控制。

**注意：**

- 组集权限规则在用户和组规则之后进行评估。有关这些规则的详细信息，请参见[评估权限规则](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm#EvaluatePermRules)。
- 群组集只能由站点管理员创建。
- 组集不能被用作多个组中的一个组。

## 启用组集

在使用组集进行权限管理之前，必须先启用组集设置。

1. 以站点管理员身份登录到 Tableau Cloud。
2. 导航到“设置”页面。
3. 在“组集”部分下，选中“允许组集”复选框。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/abac_groupset_setting.png)

启用组集后，导航窗格中将显示专用的“组集”页面。

## 创建组集

若要创建组集，请导航至“组集”页面并像创建组一样创建组集。

1. 以站点管理员身份登录到 Tableau Cloud。
2. 导航到“组集”页面并单击“新群组集”按钮。
3. 为组集输入一个名称，并单击“创建”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/abac_groupset_create.png)
4. 在“组集”表中，单击刚刚创建的组集的名称，然后单击“添加组”按钮。
5. 从可用组列表中，选择要添加到组集的组，然后单击 “添加”按钮。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/abac_groupset_add_groups.png)

## 设置组集的权限

若要使用组集，请以站点管理员、项目负责人或内容所有者的身份添加或编辑内容的权限以使用组集。

例如，假设您是"Batters"工作簿的所有者。若要根据组集应用权限，请执行以下操作：

1. 转到工作簿并从操作菜单中选择“权限”。
2. 在“权限”对话框中，单击“添加组/用户规则”按钮，然后执行以下操作：
    1. 在文本框中输入组集名称，例如“所有承包商”。
    2. 在模板中选择所需的功能。
    3. 单击“保存”。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/abac_groupset_permissions.png)

使用组集模型应用权限时，您可以创建影响在组集中的_全部_组中具有成员资格的用户的权限。

例如，您可以根据用户的区域组隶属关系限制对不同工作簿视图的访问：假设您有承包商、承包商经理、全职员工和全职经理访问这些工作簿视图。

具有查看工作簿的默认权限的组：全部、北部、南部、东部、西部、全职和经理。

- 对于北部区域详细视图：
    
    - 权限基于组集：北部区域
    - 组集中的组：全职、北部
    
    结果：只有北部的全职员工和全职经理才能看到北部区域详细视图中的数据。
- 对于全部区域详细视图：
    
    - 组集名为“Managersn”（经理）
    - 组集中的组：全部、经理
    
    结果：只有承包商经理和全职经理才能看到所有区域详细视图中的数据。

有关权限的详细信息，请参见[为托管自助服务配置项目、组、组集和权限](https://help.tableau.com/v0.0/online/zh-cn/projects_data_gov.htm)。

<!-- document id=20455e1229d7b6f184a71dce2d41b58c50d15734cdc3aabfffc3f22a0032d354 url=/tableau/next/zh-cn/online/custom_smtp.md -->

[跳转到主要内容](#main-content)

# 使用自定义 SMTP 服务器进行电子邮件通知

当用户订阅工作簿和视图或接收数据驱动型通知时，Tableau Cloud 会发送电子邮件通知。默认情况下，这些电子邮件来自内置的 Tableau 电子邮件服务器 (`@cloudmail.tableau.com`)。

您可以更新此设置以通过您自己的简单邮件传输协议 (SMTP) 服务器路由电子邮件。使用自定义服务器时，通知来自您的域，并且订阅附件最大可以为 10 MB，而不是默认的 2 MB。Tableau Cloud 支持基本身份验证和 Microsoft SMTP 的 OAuth 2.0。

## 先决条件

在使用自定义邮件服务器之前，请确认您具有站点的站点管理员访问权限。组织的电子邮件网关和垃圾邮件筛选器必须允许来自您在站点设置中配置的特定域和发件人值的电子邮件。

您的网络还必须允许来自以下专用 Tableau Cloud IP 地址的入站流量：

- `155.226.128.24/32`
- `155.226.128.25/32`
- `155.226.128.26/32`

根据您的身份验证方法，请收集所需信息：

### 基本身份验证的要求

- **SMTP 服务器地址。**例如，`mail.example.com`。
- **端口号。**使用端口 `587` 实现安全传输。
- **用户名和密码。**这是发送邮箱帐户的身份。

### 适用于 Microsoft SMTP 的 OAuth 2.0 的要求

- **SMTP 服务器地址。**通常为 `smtp.office365.com`。
- **端口号。**使用端口 `587` 实现安全传输。
- **Microsoft Entra 应用凭据和 API 权限。**您需要 `Tenant ID`、`Client ID` 和 `Client Secret`。您的 Microsoft 管理员必须在 Microsoft Entra 管理中心注册应用程序并分配 SMTP 访问所需的特定邮件权限。如果您的团队尚未配置这些设置，请参见在 Microsoft Learn 上的[使用 OAuth 对 IMAP、POP 或 SMTP 应用程序进行身份验证](https://learn.microsoft.com/en-us/exchange/client-developer/legacy-protocols/how-to-authenticate-an-imap-pop-smtp-application-by-using-oauth#add-the-pop-imap-or-smtp-permissions-to-your-microsoft-entra-application)，了解确切的权限分配步骤。

**注意：**这些要求反映第三方应用程序，并且会在我方不知情的情况下发生变更。如果字段名或标签与您的 Microsoft Entra 管理中心不匹配，请参阅 Microsoft 的文档。

## 在 Tableau Cloud 中配置自定义 SMTP 设置

若要为站点使用自定义 SMTP 服务器，请执行以下操作：

1. 以站点管理员身份登录到 Tableau Cloud 站点。
2. 在导航窗格中，选择“设置”。
3. 在“常规”选项卡上，滚动到“自定义电子邮件通知”部分。
4. 选择“使用您的 SMTP 服务器（链接会转到您设置的域）”选项。
5. 在“SMTP 服务器地址”字段中输入您的邮件服务器地址。
6. 在“端口号”字段中输入您的网络端口。
7. 选择“SMTP 身份验证方法”的选项之一：
    
    - **基本身份验证：**输入邮件帐户的用户名和密码。
    - **适用于 Microsoft SMTP 的 OAuth 2.0**：输入您的 Microsoft 租户、客户端 ID 和客户端密文值，与 Microsoft Entra 管理中心中显示的值完全相同。
8. 在“用于链接的域”字段中输入希望 Tableau Cloud 用于导航超链接的域名。
9. 输入“电子邮件发件人姓名”和“电子邮件本地名称或电子邮件地址”，以自定义通知的“发件人”行。
10. 如果要包括返回到 Tableau Cloud 的链接，请选中“在通知电子邮件中包括链接”复选框。始终包含取消订阅链接。
11. 选择“保存”。

## SMTP 字段参考

使用此表可以将邮件设置映射到 Tableau Cloud 中的字段：

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 30%;"><col style="width: 70%;"><col></colgroup><tbody><tr><th>文件名</th><th>描述</th></tr><tr><td>SMTP 服务器地址</td><td>出站邮件服务器的地址。例如，<code>smtp.office365.com</code>。</td></tr><tr><td>端口号</td><td>服务器用于安全邮件的网络端口。</td></tr><tr><td>SMTP 身份验证方法</td><td>邮箱的安全类型。<span class="uicontrol">“基本身份验证”</span>或<span class="uicontrol">“适用于 Microsoft SMTP 的 OAuth 2.0”</span>。</td></tr><tr><td>租户</td><td>用于 Microsoft 应用注册的租户 ID。此字段仅针对 OAuth 2.0 显示。</td></tr><tr><td>客户端 ID</td><td>用于 Microsoft 应用注册的应用程序 ID。此字段仅针对 OAuth 2.0 显示。</td></tr><tr><td>客户端密文</td><td>为 Microsoft 应用注册生成的密文值（也称为应用程序密码）。此字段仅针对 OAuth 2.0 显示。</td></tr><tr><td>用于链接的域</td><td><span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 在电子邮件内添加到导航链接的域名。</td></tr><tr><td>电子邮件发件人姓名</td><td>用户在其收件箱的“发件人”行中看到的名称。例如，<code>Internal Analytics Alerts</code>。</td></tr><tr><td>电子邮件本地名称或电子邮件地址</td><td>发送邮件的电子邮件地址，例如 <code>no-reply@yourdomain.com</code>。</td></tr><tr><td>在通知电子邮件中包含链接</td><td>用于在电子邮件文本内添加指向视图的链接的选项。始终包含取消订阅链接。</td></tr></tbody></table>

## 恢复为默认 Tableau 电子邮件服务器

若要停止使用自定义 SMTP 配置，请在站点设置中选择默认的 Tableau 电子邮件服务器选项。

确认您组织的安全策略允许来自以下地址的流量，以避免用户帐户被阻止和传输失败：

- **默认域：**`@cloudmail.tableau.com`
- **默认 IP 地址：**`54.240.86.205`、`54.240.86.204`、`54.240.119.142` 和 `54.240.119.141`

## 自定义 SMTP 连接疑难解答

### 电子邮件附件缺失或不完整

自定义 SMTP 服务器支持最大 10 MB 的订阅附件。如果工作簿超出此大小，Tableau Cloud 会尝试发送部分附件。如果附件仍然太大而无法传输，订阅者将收到错误通知。

### 电子邮件停止发送

如果您的自定义 SMTP 帐户密码更改或者您的 Microsoft 客户端密文过期，则身份验证握手将失败，并且 Tableau Cloud 停止发送通知。为防止服务中断，请定期检查凭据生命周期。

<!-- document id=9f12944e0633240e7f4725366a9bdd7f4f65989673f27b437fe5afdff3d540b1 url=/tableau/next/zh-cn/online/customview.md -->

[跳转到主要内容](#main-content)

# 使用自定义视图

自定义视图是已发布可视化项的特定交互状态（例如筛选器选择和排序）的快捷方式。自定义视图不会影响基础内容。如果您发现自己每次查看可视化项时都调整相同的筛选器或放大相同的数据，那么它们是一个不错的选择。

自定义视图与 Web 编辑不同，Web 编辑会更改基础已发布内容本身。请参见[在 Web 上编辑 Tableau 视图](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_build_view.htm)。

如果自定义视图专门用于筛选器设置，请考虑在共享 URL 中使用嵌入筛选器参数。请参见通过 [The Data School](https://www.thedataschool.co.uk/) 中的[通过编辑 URL 来筛选已发布的仪表板](https://www.thedataschool.co.uk/paul-hunt/filter-a-published-dashboard-by-editing-the-url)。

## 自定义视图的注意事项

- 自定义视图不会修改其所构建的内容。
- 删除原始内容也会删除其自定义视图。
- 如果原始内容更新或重新发布，则自定义视图也将更新。
    
    > [!TIP]
    > 
    > **提示**：对原始内容的某些更改可能会破坏自定义视图。有关使用自定义视图修改内容的最佳实践，请参见[使用自定义视图维护内容](https://help.tableau.com/current/pro/desktop/zh-cn/customview_update.htm)。
- 如果从站点中移除用户，他们拥有的任何共享自定义视图也会丢失。
- 基于自定义视图的订阅和数据驱动型通知可能比基于原始内容的订阅和数据驱动型通知更脆弱。

**注意**：从版本 2022.3 开始，Tableau 将自定义视图 URL 中的用户名替换为 ID。加入书签的 URL 仍然有效，但会重定向到新的 URL 架构。这一变化是为了增加更多的公司和用户数据保护。

## 创建自定义视图

首先转到单独的视图。进行您想要在自定义视图中捕获的任何更改，例如选择标记、筛选数据或更改排序。

1. 当您准备好将所做的更改保存为自定义视图时，请从工具栏中选择“保存自定义视图”。
    
    **注意**：对当前视图进行任何更改后， “保存自定义视图”按钮将出现在工具栏中。
2. 在“保存自定义视图”对话框中，输入自定义视图的名称。
3. （可选）选择“设为我的默认值”。
4. （可选）选择“使其他人可见”。这使得可以看到原始内容的每个人都可以使用自定义视图。但是，在某些情况下此选项不可用：
    - 用户的站点角色为 Viewer（查看者）。
    - 该站点的[用户可见性设置](https://help.tableau.com/current/server/zh-cn/user_visibility.htm#limit-user-visibility)被设置为“受限”。
    - 工作簿上的[“共享自定义”](https://help.tableau.com/current/server/zh-cn/permissions_capabilities.htm#workbooks)权限能力被拒绝。
5. 保存所做的更改。

## 查找自定义视图

### 通过视图

当您查看可视化项时，可以通过选择工具栏中的“视图”图标来更改为不同的自定义视图。如果工具栏中有空间，则会显示您正在查看的自定义视图的名称。

您创建的任何自定义视图以及其他用户创建的所有可见自定义视图都会显示在列表中。

### 通过作业簿

当您查看工作簿级别的内容时，请使用“自定义视图”选项卡查看该工作簿的所有可用自定义视图。

![包含名称、操作、原始视图和所有者信息的自定义视图表格。列表中某个视图的上下文菜单已展开，显示更改所有者或删除的选项。](/tableau/next/zh-cn/online/zh-cn/Img/customviews_tab.png)

## 设置默认自定义视图

找到或创建自定义视图后，可以将其设置为打开该可视化项时看到的默认视图。

1. 选择工具栏中的“视图”图标。
2. 选中“将此视图设置为默认”选项。
3. 关闭对话框进行保存。

下次打开该可视化项时，您将进入该自定义视图。

## 共享自定义视图

默认情况下，自定义视图是私有的，仅向创建它们的用户显示。

**注意**：具有 Viewer（查看者）站点角色的用户无法使自定义视图对其他人可见。但是，他们可以通过复制和共享 URL 来共享自定义视图。

具有 Explorer 或更高站点角色的用户可以将自定义视图设置为对其他人可见。此设置允许任何有权访问原始内容的人查看自定义视图。

若要将现有私有自定义视图更改为对其他人可见（或将可见视图设为私有），请执行以下操作：

1. 选择工具栏中的“视图”图标。
2. 将您想要共享的视图的眼睛图标切换到所需的状态。
3. 关闭对话框进行保存。

眼睛有斜线 ![“隐藏自定义视图”图标，是一只带有对角线的眼睛。](/tableau/next/zh-cn/online/zh-cn/Img/customviews_hide.png) 表示该视图对您来说是私有的。眼睛 ![“显示自定义视图”图标，是一个睁开的眼睛的符号。](/tableau/next/zh-cn/online/zh-cn/Img/customviews_show.png) 指明视图对其他人可见。

## 删除自定义视图

若要删除自定义视图，请执行以下操作：

1. 选择工具栏中的“视图”图标。
2. 选择要删除的视图的垃圾桶图标。
3. 确认您想要删除视图。

### 删除时要小心

如果您是对其他人可见的自定义视图的所有者，请记住，如果您将其删除，那么也会为每个人删除该视图。

删除自定义视图也会删除基于该自定义视图的任何订阅或数据驱动型通知。

## 管理自定义视图

管理员可以更改自定义视图的所有权并删除其他用户创建的自定义视图，除非[用户可见性](https://help.tableau.com/current/server/zh-cn/user_visibility.htm)对于站点设置为“受限”。

可以针对一段内容或针对特定用户管理自定义视图。

1. 转到工作簿或用户的“自定义视图”选项卡。
2. 使用操作菜单更改所有者或删除自定义视图。

![包含名称、操作、原始视图和所有者信息的自定义视图表格。列表中某个视图的上下文菜单已展开，显示更改所有者或删除的选项。](/tableau/next/zh-cn/online/zh-cn/Img/customviews_tab.png)

> [!TIP]
> 
> **提示**：最佳做法是先更改属于用户的任何自定义视图的所有权，然后再将其从站点中删除。删除用户也会删除他们的自定义视图，包括其他人可能正在使用的公共视图。

### 使用自定义视图安全地更改内容

如果您修改具有自定义视图（或构建该视图的数据源）的视图，请注意某些更改可能会破坏自定义视图。有关详细信息，请参见[使用自定义视图维护内容](https://help.tableau.com/current/pro/desktop/zh-cn/customview_update.htm)。

<!-- document id=65439b36b87eec373101bd5dc6b07e1041f44c6bc27b134628629b72971cb190 url=/tableau/next/zh-cn/online/customview_update.md -->

[跳转到主要内容](#main-content)

# 使用自定义视图维护内容

作为内容创建者，务必要了解对工作簿和数据源进行的更新会对最终用户产生怎样的影响。自定义视图是实现可视化项使用方式个性化的普遍方法，但如果源内容发生更改，自定义视图可能会损坏。如果可能，请避免进行已知会影响自定义视图的更改。需要进行更改时，请按照本主题后面概述的步骤进行操作。

一般来说，在处理已知使用自定义视图的内容时，有一些最佳实践。

- 建议最终用户仅基于稳定内容创建自定义视图。
    - 使用项目或命名系统来识别正在修改的工作簿，并建议用户不要在其上创建自定义视图。
- 在暂存或开发环境中测试更改。测试代表预期筛选器、用户操作、参数设置和其他自定义项的自定义视图。
- 在发布可能破坏自定义视图的更改之前主动通知用户。（[使用 Tableau 的 REST API 中的自定义视图方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#list_custom_views)检索应用于工作簿的所有自定义视图的列表。）

## 已知会影响自定义视图的更改

虽然最好测试任何更改以验证其对自定义视图的影响，但已知有一些更新会影响自定义视图。

此列表并不全面，仅供参考。

### 工作簿更改

- **名称更改**。更改工作簿（或与自定义视图关联的工作表）的名称会破坏自定义视图。
- **参数**。添加或移除参数可能会导致自定义视图损坏或无法按预期更新。
    - 如果在原始内容中添加参数，自定义视图可能会损坏。
    - 如果移除参数控件，则使用其输入的计算字段将保留其最后的值并且不再可调整。
- **筛选器**。移除筛选器会移除筛选器控件，但会将数据保留为已筛选状态。
    - 通常，如果删除原始内容中的筛选器，使用该筛选器的自定义视图将继续工作。但是，数据仍处于已筛选状态，且不存在筛选器控件。这意味着用户无法从自定义视图中更改筛选器选择。
    - 将筛选器控件从滑块更改为相对日期不会调整筛选器以准确反映预期的相对日期。
    - 如果使用自定义视图来控制筛选器选择，请考虑在共享 URL 中使用嵌入筛选器参数。
- **隐藏工作表**。将工作表设置为隐藏，即使后来取消隐藏，也会破坏该工作表上的自定义视图。
- **重新发布**。删除并重新发布工作簿会破坏其自定义视图。
- **默认值**。如果自定义视图由默认值（例如参数、集或筛选器）定义，并且默认值发生更改，则自定义视图会更新以反映新值。如果自定义视图需要绑定到特定值，请使用它而不是依赖于<默认值 >。

### 数据源更改

- **数据源更改**。使用“替换数据源”功能替换数据源或使用同一数据源的已发布副本替换嵌入式数据源会破坏自定义视图。
- **数据类型**。更改与自定义视图相关的字段的数据类型会破坏自定义视图。
- **移除字段**。移除自定义视图所依赖的字段、计算、组或集会破坏自定义视图。

## 安全更新内容

以下是一组最佳实践，可最大限度地降低破坏现有自定义视图的风险。

- 分别编辑工作簿和对数据源的更改。
- 不要重新发布具有已替换数据源的工作簿。
- 编辑工作簿或数据源的本地版本并使用相同名称重新发布。

### 修改工作簿

这些步骤假设工作簿使用与单独发布的数据源的实时连接，并且具有现有的自定义视图。

#### 使用 Web 编辑修改工作簿

Web 编辑是修改工作簿的首选方法。如有必要，请仅使用 Tableau Desktop。

1. 在浏览器中编辑工作簿，避免前面提到的已知会破坏自定义视图的各项操作。
    - 如果需要对数据进行更改，请不要立即进行更改。请参见有关修改数据源的部分。
2. 使用相同的名称将工作簿发布到同一位置，并覆盖现有版本进行保存。

#### 使用 Tableau Desktop 修改工作簿

如果可能，请在浏览器中修改工作簿。如有必要，请仅使用 Tableau Desktop。

1. 打开工作簿的本地版本（如有必要，请先下载工作簿）。
2. 编辑工作簿，避免前面提到的已知会破坏自定义视图的各项操作。
    - 如果需要对数据进行更改，请不要立即进行更改。请参见有关修改数据源的部分。
3. 使用相同的名称将工作簿发布到同一位置，替换现有版本。
    - _不要_选择“更新工作簿以使用已发布数据源”选项。

### 修改数据源

1. 通过下载工作簿并创建数据源的本地副本，在 Tableau Desktop 中打开数据源的本地版本：
    
    1. 下载工作簿，并在 Tableau Desktop 中打开。
    2. 右键单击数据源并选择“创建本地副本”。
    3. 右键单击新数据源并选择“替换数据源...”
    4. 将与已发布数据源的现有连接交换为新创建的本地副本。
    
    **注意**：在工作簿中使用本地版本是首选方法，因为它允许您直接在工作簿中验证数据源更改。或者，您可以下载数据源或使用本地存储的副本。
2. 编辑数据源，避免前面提到的已知会破坏自定义视图的各项操作。
3. 发布数据源。
    1. 使用相同的名称并覆盖现有数据源进行保存。
    2. 不要选择“更新工作簿以使用已发布数据源”选项。
    3. 不要发布包含已修改数据源的工作簿。如果需要更改工作簿内容，请参见有关修改工作簿的部分。

## 调查损坏的自定义视图

**注意**：本节假设您熟悉 XML 和基本的命令行交互。

在 .twb 工作簿文件中，工作簿的 XML 包含工作簿元素的标识标记。创建自定义视图时，会拍摄交互式元素（例如筛选器或设定值、参数或选定标记）及其值的快照。访问自定义视图时，Tableau 会将随自定义视图一起存储的属性值应用到相关元素 ID。如果元素 ID 发生更改或无法加载属性值，自定义视图就会损坏。

通过比较更改前后的 .twb，可以确定哪些更改破坏了自定义视图。

1. 当自定义视图运行时，您需要工作簿的 .twb 文件（在进行任何更改之前保存内容副本）。
2. 在工作簿的另一个副本中，进行更改以导致自定义视图损坏，并将其另存为不同的 .twb。
3. 在命令行中，运行以下命令（将第一步中的文件替换为 file1.twb，将第二步中的文件替换为 file2.twb）。
    
    vimdiff file1.twb file2.twb
4. 结果突出显示文件之间的更改。

已知某些 ID 或属性值（在 **\[方括号\]** 中）如果更改会破坏自定义视图：

```
<datasources>
	<datasource name='[ID]'>

<worksheets>
	<worksheet name='[ID]'>
<table>
<view>
<datasource-dependencies datasource='[ID]'>
<column datatype='[Value]' name='[Value]'>

<dashboards>
	<dashboard name='[ID]'>
```

<!-- document id=89d703113d980fc4cd4ec7ef220e57e048c5360bb7de7d7e7825d43c8dc65a59 url=/tableau/next/zh-cn/online/dm_vconn_use.md -->

[跳转到主要内容](#main-content)

# 使用虚拟连接

发布虚拟连接并设置权限后，用户可以使用与用户访问 Tableau 中的所有数据相同的方式连接到数据。当您必须编辑虚拟连接或连接中的数据策略时（例如，当基础架构更改时），只需在虚拟连接编辑器中打开连接，进行更改，然后保存或发布更新。您还可以使用虚拟连接替换工作簿中的现有数据源。

## 连接到虚拟连接

对于 Tableau Cloud 或 Tableau Server 中的 Web 制作

1. 在主页或“浏览”页面上，单击“新建”。
2. 选择要创建的内容类型：工作簿、流程或已发布数据源。
3. 在“连接到数据”>“此站点上”>“连接类型”下拉菜单中，选择“虚拟连接”。
4. 选择连接的名称，然后单击“连接”。

对于 Tableau Desktop 和 Tableau Prep：

1. 在“连接”窗格上的“搜索数据”下，单击“Tableau Server”。
2. 输入服务器名称并单击“连接”，或单击“Tableau Cloud”。
3. 输入提示您提供的信息。
4. 在“搜索数据”对话框中，从“内容类型”下拉菜单中选择“虚拟连接”。
5. 选择连接的名称，然后单击“连接”。

**注意：**使用虚拟连接进行连接时无需输入凭据。用于访问数据的凭据嵌入在连接中。

## 编辑虚拟连接或数据策略

编辑已发布虚拟连接时，连接在当前已发布状态下仍可供用户使用。有关详细信息，请参见[发布虚拟连接并设置权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_publish_save.htm)。

若要编辑连接，请从“浏览”页面导航到该连接。请注意，即使数据库凭据嵌入在连接中，也只有拥有数据库凭据的用户才能对虚拟连接进行任何更改。

1. 从下拉菜单中，选择A“所有虚拟连接”，然后选择要编辑的连接。
2. 单击“编辑虚拟连接”。
3. 输入提示您提供的用于连接的信息。若要编辑连接，您必须输入访问数据所需的凭据。
4. 单击“登录”。
5. 在虚拟连接编辑器中，进行更改，然后保存草稿或发布连接。

### 响应基础架构更改

当虚拟连接中的基础架构发生更改时（例如，添加或删除表，或者添加或重命名列），您必须编辑虚拟连接以反映架构更改，然后重新发布连接。（如果连接有数据提取，请记得刷新数据提取。）这样，您可以在向所有人公开新数据之前添加或编辑连接中的表、列和策略。

## 使用虚拟连接修订历史记录

当您发布虚拟连接时，版本将保存在 Tableau Cloud 或 Tableau Server 的修订历史记录中。您可以随时恢复到以前的版本。

若要访问修订历史记录，您必须具有“Creator”站点角色以及“查看”和“覆盖”权限。

若要查看虚拟连接修订历史记录，请单击虚拟连接的操作菜单 (...)，然后单击“修订历史记录”。

![包含“修订历史记录”的操作菜单将突出显示](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_rev_hist_menu.png)

### 恢复或删除虚拟连接修订

若要恢复虚拟连接修订，请选择一个修订，然后单击“打开”。然后系统会提示您放弃现有版本的连接。当您单击“放弃并继续”时，您选择的修订版将成为连接的当前版本。

![包含“放弃并继续”的“打开修订”对话框将突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_rev_hist_replace.png)

若要删除修订，请从修订的操作菜单 (...) 中，单击“删除”。

![包含“删除...”的修订操作菜单将突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_rev_hist_del.png)

## 用虚拟连接替换工作簿中的现有数据源

对于 Tableau Cloud 或 Tableau Server 中的 Web 制作

1. 下载工作簿。有关详细信息，请参见 Tableau Desktop 帮助中的[下载视图和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/export.htm)。
2. 在 Tableau Desktop 中，打开工作簿并将其现有数据源替换为虚拟连接。有关详细信息，请参见 Tableau Desktop 帮助中的[替换数据源](https://help.tableau.com/current/pro/desktop/zh-cn/connect_basic_replace.htm)。
3. 在 Tableau Desktop 中，将工作簿上载到您的 Tableau Cloud 或 Tableau Server 站点。有关详细信息，请参见 Tableau Desktop 帮助中的[将工作簿上载到 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/upload.htm)。
4. 在 Tableau Cloud 或 Tableau Server 中，单击“发布”将更改保存到服务器。

对于 Tableau Desktop：

1. 打开工作簿并将其现有数据源替换为虚拟连接。有关详细信息，请参见 Tableau Desktop 帮助中的[替换数据源](https://help.tableau.com/current/pro/desktop/zh-cn/connect_basic_replace.htm)。
2. 重新发布工作簿。有关详细信息，请参见 Tableau Desktop 帮助中的[用于发布工作簿的简单步骤](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_share.htm)。

## 谁可以执行此操作

若要使用虚拟连接，您必须是服务器管理员、站点管理员 Creator 或 Creator。

若要编辑虚拟连接或数据策略，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

若要迁移现有内容以使用虚拟连接，您必须

- 是服务器或站点管理员，或者
- 是同时担任数据源所有者的 Creator。

<!-- document id=f502abab8b4d3c7b252af3d6b53ad3794cab29f03e8b20a34ddbc9f5e6deebee url=/tableau/next/zh-cn/online/datasource_certified.md -->

[跳转到主要内容](#main-content)

# 使用认证来帮助用户查找受信任的数据

在具有多个发布者的自助服务环境中，Tableau Cloud 上的项目通常包含各种内容，这些内容命名方式相似、基于相同或相似的基础数据，或者是在没有任何关于它们的描述性信息的情况下发布的。在这种情况下，分析师可能会对他们应使用的数据缺乏信心。

为了帮助您的用户查找受信任且为其分析类型推荐的数据，您可以_验证_符合组织数据标准的数据。

除了认证已发布数据源之外，如果您拥有适用于 Tableau Server 或 Tableau Cloud 的 Data Management：

- 如果 Tableau Catalog 已启用，您可以认证与您的 Tableau 内容关联的数据库和表。(有关 Tableau Catalog 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。)
- 从 Tableau 2022.1 开始，您可以认证虚拟连接和虚拟连接表。

## 认证如何帮助用户查找受信任的数据

当您认证资产时，用户会看到绿色徽章或绿色复选标记，具体取决于查看资产的位置。

![数据库上的认证徽章](/tableau/next/zh-cn/online/zh-cn/Img/datasource_cert_badge_1.png)

![出现在 Web 制作或 Desktop 中的数据源上的认证徽章](/tableau/next/zh-cn/online/zh-cn/Img/datasource_cert_badge_2.png)

![在“服务器列表”视图中显示的数据源上的认证徽章](/tableau/next/zh-cn/online/zh-cn/Img/datasource_cert_badge_3.png)

认证数据源在搜索结果中排名较高，并被添加到推荐的数据源中。

此外，您可以提供有关认证状态的注意事项，当用户在 Web 制作或 Tableau Desktop 中将光标悬停在数据源图标或卡上时，该注意事项将显示在工具提示中。该信息还显示了谁对数据源进行了认证。

![](/tableau/next/zh-cn/online/zh-cn/Img/datasource_cert_badge_tooltip.png)

## 创建关于选择要认证的数据的准则

与大多数 Tableau 功能一样，认证具有灵活性。您可以为组织定义用于确定资产验证时间的标准。在执行此操作时，请记录并分享您的准则。这些准则可以帮助您、其他管理员和项目负责人与您的认证选择保持一致。它们还可以帮助用户了解认证的含义。

无论您是在所有项目中使用相同的认证标准，还是为每个项目定义独特的标准，重要的是要清楚认证在您的环境中的意味着什么。

## 谁可以认证数据

若要对数据源进行认证，您必须

- 是服务器或站点管理员，_或者_
- 具有“Explorer（可发布）”或“Creator”站点角色，_并且_是项目所有者或对包含要认证的数据的项目具有“项目主管”能力。

若要对虚拟连接和虚拟连接表进行认证，您的环境中必须有 Data Management 许可证，并且您必须

- 是服务器或站点管理员，_或者_
- 具有“Explorer（可发布）”或“Creator”站点角色，_并且_是项目所有者或对包含要认证的数据的项目具有“项目主管”能力。

若要对数据库或表进行认证，您必须在环境中启用 Tableau Catalog，并且您必须

- 是服务器或站点管理员，_或者_
- 具有数据库的“设置权限”能力，用于对该数据库或该数据库内的任何表进行认证。

## 如何认证数据

您可以认证的数据取决于您拥有的权限，以及您是否在您的环境中启用了 Data Management 许可证 Tableau Catalog。

- 具有权限的所有用户都可以对数据源进行认证。
- 如果您有 Data Management 许可证，具有权限的用户还可以对虚拟连接和虚拟连接表进行认证。
- 如果启用了 Data Management 许可证和 Tableau Catalog，具有权限的用户也可以对数据库、表和文件进行认证。

若要认证资产，请执行以下操作：

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除认证，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

1. 搜索或导航到资产。导航的步骤取决于您要认证的资产类型：
    - 数据源或虚拟连接 - 在“浏览”页面上，选择“所有数据源”或“所有虚拟连接”。
    - 虚拟连接表 - 在“浏览”页面上，选择“所有虚拟连接”，然后选择包含要认证的虚拟连接表的虚拟连接。然后选择虚拟连接表。
    - 数据库或表 - 在“浏览”页面上，导航到数据库或表。或在“外部资产”页面上选择“数据库和文件”或“表和对象”。
2. 在该页面上，选择要认证的资产名称旁边的“更多操作”菜单 (...)。
3. 选择“数据标签”\>“认证”（或者，在 Tableau Server 2023.1 及更低版本中，选择“编辑认证”）
4. 选中“已认证”复选框。（在 Tableau Server 的早期版本中，使用开关。）
5. 如果需要，添加一条消息。该消息为用户提供认证状态的上下文、数据的预期用途或其他有用的信息。添加到“消息”部分中的信息将显示在[认证如何帮助用户查找受信任的数据](#certify-how-it-helps)中前面提到的认证徽章工具提示中。您可以使用粗体、下划线和斜体来设置消息中文本的格式，并包含链接或图像。若要查看文本格式设置提示，请单击“保存”按钮上方的信息 (i) 图标。（从 Tableau Cloud 2024 年 2 月开始，该消息是可选的。早期版本的 Tableau Cloud 和 Tableau Server 需要它。）
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/datasource_cert_certify_checkbox.png)
6. 选择“保存”。

## 自定义认证

从 Tableau Cloud 2023 年 6 月开始，管理员可以使用“数据标签”页面或 REST API 更改用户在认证对话框中看到的认证描述。有关详细信息，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

<!-- document id=2b7f767ae60d8f7725777339b155714ebb0538975b7ee3de149eb41cf0afc095 url=/tableau/next/zh-cn/online/accessible_viz_authoring.md -->

[跳转到主要内容](#main-content)

# 使用辅助技术制作可视化项

从 Tableau 2026.1 开始，您只需使用键盘即可在 Tableau Cloud 和 Tableau Public 上制作和编辑可视化项。这种仅使用键盘的功能允许用户在没有鼠标的情况下创建内容，从而为使用屏幕阅读器或喜欢键盘导航的用户提供一致的体验。Tableau 会在您导航时提供通知，确保您了解界面的哪个部分处于焦点位置。

## 使用键盘上编辑视图

您可以使用标准键盘操作在“数据”窗格中导航、向可视化项中添加字段，以及重新排列功能区上的项目。

### 从“数据”窗格向工作表中添加字段

1. 使用 Tab 键将焦点移至“数据”窗格。
2. 使用向上和向下箭头键在字段列表中移动。
3. 若要选择或取消选择字段，请按空格键。若要选择字段并打开其上下文菜单，请按 Enter。

使用上下文菜单，您可以将字段准确地放在可视化项上想要的位置。

1. 从上下文菜单中，从菜单中选择“添加到”。
2. 使用箭头键选择要放置字段的位置。当您用箭头浏览各个位置时，目标区域（如“列”功能区或“页面”卡）上将出现一个橙色焦点指示器。
3. 按空格键将项目拖放到指定位置。Tableau 会将字段添加到视图并立即更新可视化项。

将字段拖放到指定位置时，焦点将返回到“数据”窗格。

如果要取消操作或关闭上下文菜单而不进行选择，请按 Esc。这会将焦点返回到“数据”窗格中的字段。

您也可以通过与“智能显示”面板交互，使用键盘构建可视化项。若要了解有关使用“智能显示”构建视图的详细信息，请参见[使用“智能显示”启动视图](https://help.tableau.com/current/pro/desktop/zh-cn/buildauto_showme.htm)。

### 配置“筛选器”和“标记”卡的选项

将字段拖到“筛选器”或“标记”卡上时，还需要完成一些步骤。

#### 对于筛选器：

1. 将字段放到“筛选器”卡上。此时会打开“筛选器配置”对话框。
2. 使用 Tab 键可在筛选对话框的各个部分（例如，“常规”或“条件”）之间移动。
3. 按 Enter 打开一个部分或选项列表。
4. 使用箭头键浏览可用选项。
5. 再次按 Enter 选择要筛选的项目。
6. 配置筛选器后，按 Tab 直到到达所需的操作按钮（例如，“重置”、“应用”、“取消”或“确定”）。
7. 按 Enter 确认您的选择。筛选器将保存，对话框将自动关闭。

#### 对于“标记”卡：

1. 将所需字段放在“标记”卡上。
2. 使用箭头键选择用于编码的特定视觉属性（例如，颜色、大小、标签）。
3. 按空格键将字段放在该编码框上。

##### 若要为“标记”卡上的现有字段配置设置，请执行以下操作：

1. 确保相关卡或字段处于焦点位置，然后按 Enter 打开其上下文菜单以获取更多可视化选项。
2. 使用 Tab 键在菜单中的各种设置之间移动（例如，在“颜色”卡中，在“编辑颜色”、“不透明度”、“边框”和“光环”之间导航）。
3. 在设置处于焦点位置时，使用箭头键调整该值。例如，在“不透明度”处于焦点位置时，使用向左 键或向下键减少不透明度，使用向右 键或向上键增加不透明度。

### 使用键盘与可视化项上的字段进行交互

放在可视化项上的字段通常称为“胶囊”。您可以将它们移动到其他位置、将它们复制到其他位置，以及从可视化项中移除它们，但键盘操作方式略有不同。

1. 使用 Tab 键在工作表中移动，直到您想要与之交互的胶囊处于焦点位置。
2. 按 Enter 打开胶囊的上下文菜单。
3. 使用箭头键导航到下一个操作，例如“移动到”或“复制到”，然后再次按 Enter。
4. 如果要移动或复制胶囊，请使用箭头键选择要放置胶囊的位置。当您用箭头浏览各个位置时，目标区域上会出现一个橙色焦点指示器。
5. 按空格键将项目移动或复制到新位置。
6. 如果要从可视化项中移除胶囊，请使用箭头键导航到“移除”，然后按 Enter。

焦点仍然在原地。举例来说，如果已将胶囊复制到“行”功能区，则焦点将始终位于“行”功能区上。

## 用于制作的键盘控件

### 可视化项制作键击方式

使用这些键盘控件无需鼠标即可构建可视化项。

<table style="width: 100%;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"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1">Action</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">在可视化项元素间将焦点向前移动</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Tab</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">在可视化项元素间将焦点向后移动</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Shift + Tab</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>选择并打开上下文菜单</p><p>展开或折叠卡片</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Enter </span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">打开上下文菜单</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Enter</span> 或 <span class="uicontrol">Shift + F10</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">选择或取消选择架构中的某项</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">空格键</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">将胶囊向左移动</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Ctrl + 向左键</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">将胶囊向右移动</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">Ctrl + 向右键</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">取消操作并返回上一个位置</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><span class="uicontrol">Esc</span></td></tr></tbody></table>

### 拖放键击方式

使用这些键盘控件无需鼠标即可拖放项目。

| Action | 键击方式 |
| --- | --- |
| 进入拖放模式 | 通过上下文菜单在目标（例如，“列”）上按 Enter |
| 向前移动 | 向右键或向下键 |
| 向后移动 | 向左键或向上键 |
| 放下项目 | 空格键 |
| 取消 | Esc |

## 演练：分三个步骤使用键盘向工作表中添加字段

**第一步：**从“数据”窗格中，使用箭头键导航到一个字段，然后按 Enter 选择该字段并打开其上下文菜单。  
![Tableau 的“数据”窗格，其中选择了一个名为“Genre”（流派）的维度。](/tableau/next/zh-cn/online/zh-cn/Img/accessible_authoring_step1.png)  

**第二步：**使用箭头键导航各个选项，然后按 Enter。例如，将所选内容移至“添加到”，然后按 Enter。  
  
![已选择“Genre”（流派）的 Tableau 数据窗格。流派的上下文菜单处于打开状态，焦点位于“工作表（自动）”上。](/tableau/next/zh-cn/online/zh-cn/Img/accessible_authoring_step2.png)

**第三步**：使用箭头键导航到字段的所需位置，例如“工作表（自动）”，然后按 Enter。  
  
![Tableau 工作区，在执行执行创建可视化项的步骤后，现在可以在其中创建表。](/tableau/next/zh-cn/online/zh-cn/Img/accessible_authoring_step3.png)

Tableau 会自动创建包含字段的可视化项，并根据数据类型和当前视图放在最合乎逻辑的位置。

<!-- document id=6dea341f7f0f2458e977677b54accd10b34cc439a93633d17626833e05c217aa url=/tableau/next/zh-cn/online/viz_navigation.md -->

[跳转到主要内容](#main-content)

# 使用辅助技术导航可视化项

从 Tableau 版本 24.3 开始，您可以使用键盘和其他辅助技术在 Tableau Cloud 上的所有在线可视化项类型上导航标记。

注意：可视化项导航目前不支持服务器呈现的可视化项。若要了解有关服务器端和客户端呈现的详细信息，请参见[配置客户端呈现](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

## 导航可视化项中的标记

1. 若要激活体验，请导航到可视化项并按 Enter。
2. 再次选择 Enter 以导航标记。
3. 使用箭头键在标题、列和行之间导航。
    
    如果您的可视化项具有双轴，或者它是散点图或地图，则会出现额外的导航功能。使用箭头键将焦点移动到一组标记，然后选择 Enter 以导航组中的标记。
4. 若要退出文本表，请按 Esc。

注意：在进入标记级导航之前，您可以使用箭头键导航视图的不同区域，例如标题和轴。

## 在“查看数据”窗格中导航标记

1. 若要打开“查看数据”窗格，请将焦点移至可视化项并按 Shift + Enter。
2. 使用箭头键在标题、列和行之间导航。
3. 若要关闭“查看数据”窗格，请按 ALT + F4 (Windows) 或 Cmd + W (Mac OS)。

若要了解有关 Tableau 上键盘导航的更多信息，请参见 [Tableau 视图的键盘辅助功能](https://help.tableau.com/current/pro/desktop/zh-cn/access_keyboard_navigation.htm)。

<!-- document id=181acd154960638a16bf9cea851c4a9f09ba6082be4af1eedd0ffac05c85d6a9 url=/tableau/next/zh-cn/online/slack_tableau.md -->

[跳转到主要内容](#main-content)

# 使用适用于 Slack 的 Tableau 应用程序接收通知、搜索和共享

适用于 Slack 的 Tableau 应用程序让您可以在 Slack 中工作和协作。在 Tableau 2023.1 或更高版本中，您可以搜索视图和工作簿，并通过适用于 Slack 的 Tableau 应用程序轻松访问您最喜爱的和最近查看的 Tableau 内容。借助适用于 Slack 的 Tableau 应用程序，您还炣以查看可视化项的快照，并提供返回 Tableau 站点的链接以供进一步探索。某些功能（例如从 Slack 共享和搜索 Tableau 内容）在 Tableau Server 中尚不可用。现在，Tableau Server 用户可以收到通知。

在 Tableau 2021.3 及更高版本中，您可以针对数据驱动型通知、共享活动和评论提及在 Slack 中获得 Tableau 通知。如果通知包含您有权访问的视图或工作簿，则通知还将包含可视快照。

管理员可以将他们的 Tableau 站点连接到 Slack 工作区，以便为整个组织启用适用于 Slack 的 Tableau 应用程序。有关详细信息，请参见 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/slack_admin.htm) 或 [Tableau Server](https://help.tableau.com/current/server/zh-cn/slack_admin.htm) 帮助中的“将 Tableau 与 Slack 工作区集成”。

在您的 Tableau 管理员将您的 Tableau 站点连接到 Slack 工作区后：

1. 添加适用于 Slack 的 Tableau 应用程序。
2. 选择**“连接到 Tableau”**。
3. 登录到您的 Tableau 站点。
4. 通过选择**“允许”**授权应用程序。

**注意：**有关隐私的信息，请参见[隐私政策](https://www.salesforce.com/company/privacy)。

## 从 Slack 搜索、共享和访问最近的内容和收藏夹

从适用于 Slack 的 Tableau 应用程序的**“主页”**选项卡中，您可以在 Tableau Cloud 站点上搜索视图和工作簿。

找到要查找的 Tableau 内容后，选择 Tableau 内容的名称以直接在 Tableau 中将其打开，或选择“共享”以将内容发送到个人或 Slack 频道。您还可以编写自定义消息来提供有关您共享的 Tableau 内容的上下文。

![适用于 Slack 的 Tableau 应用程序中的“搜索”弹出窗口，显示两个 Tableau 工作簿的结果。](/tableau/next/zh-cn/online/zh-cn/Img/slack_search.png)

选择**“带快照共享”**以在消息中包含 Tableau 内容的预览（Slack 链接展开）。如果 Tableau 内容不包含限制数据访问的筛选器（例如，行级安全性），您可以共享快照。快照对您与之共享的所有人可见，无论他们的访问级别如何。

![在 Slack 中共享的 Tableau 链接，包括带有工作簿预览图像和工作簿详细信息的展开链接。](/tableau/next/zh-cn/online/zh-cn/Img/slack_unfurl.png)

无需离开 Slack，您就可以访问最近查看的 Tableau 内容和您的 Tableau 收藏夹。从适用于 Slack 的 Tableau 应用程序的**“主页”**选项卡，您会看到最近访问的五个 Tableau 视图或工作簿。您还可以访问五个您最喜欢的 Tableau 视图或工作簿。

选择 Tableau 视图或工作簿的名称以直接在 Tableau 中将其打开，或选择更多操作菜单 (...) 以共享收藏夹或最近查看的 Tableau 内容。

## 在 Slack 中接收 Tableau 通知

#### 评论

当您在评论中被@提及时收到通知，以保持对话继续进行。有关详细信息，请参见[向视图添加注释](https://help.tableau.com/current/pro/desktop/zh-cn/comment.htm)。

![一个 Slack 通知，显示另一个用户在 Tableau 的评论中提到了您。](/tableau/next/zh-cn/online/zh-cn/Img/slack_mention.png)

#### 共享

查看团队成员何时向您发送 Tableau 资产，包括视图、工作簿等。有关共享的详细信息，请参见[“共享 Web 内容”](https://help.tableau.com/current/pro/desktop/zh-cn/shareworkbooks.htm)。

![与您共享的 Tableau 工作簿的 Slack 预览](/tableau/next/zh-cn/online/zh-cn/Img/slack_share.png)

#### 数据驱动型通知

您可以指定一个数据阈值，以便在达到该阈值时收到通知。有关详细信息，请参见[“从 Tableau Cloud 或 Tableau Server 中发送数据驱动型通知”](https://help.tableau.com/current/pro/desktop/zh-cn/data_alerts.htm)。

![关于已达到定义阈值的 Tableau 仪表板的 Slack 通知 ](/tableau/next/zh-cn/online/zh-cn/Img/slack_dda.png)

## 在 Slack 中管理 Tableau 通知

您的 Tableau 站点管理员可以启用或禁用整个站点的所有通知。Tableau 管理员和 Slack 工作区管理员将您的 Tableau 站点与 Slack 集成，并控制站点用户是否能接收通知。如果已启用并且您的 Tableau 站点管理员允许通知，则所有站点用户都可以通过适用于 Slack 的 Tableau 应用程序在 Slack 中接收通知。有时通知首选项设置不可用，因为站点配置了影响通知的其他设置。

若要控制在 Slack 工作区中显示哪些通知，或禁用 Slack 通知，请在页面顶部单击您的个人资料图片或姓名缩写，然后选择**“我的帐户设置”**。

![Tableau 中的“我的帐户设置”菜单](/tableau/next/zh-cn/online/zh-cn/Img/useracct_menus_acct.png)

在“通知”下，为评论提及、共享和数据通知选中或清除**“Slack”**下的复选框。

![Slack 通知首选项，包括评论提及、分享和数据通知](/tableau/next/zh-cn/online/zh-cn/Img/slack_notifysettings.png)

选择“保存更改”。

有关详细信息，请参见[管理您的帐户设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm)中的**“更改通知设置”**。

## 通过将 Slackbot 连接到 Tableau 模型上下文协议 (MCP) 来获得可信答案

连接 Tableau 模型上下文协议 (MCP) 和 Slackbot 后，您可以用简单的语言向 Slackbot 提出有关您的数据的问题。Tableau MCP 以您的上下文和数据为基础，因此您可以管理您的 Tableau 站点，并通过 Slack 消息、Slack 画布或通过 MCP 连接到 Slackbot 的任何其他工具向 Slackbot 提出后续问题。若要详细了解 Tableau MCP，请参见 [GitHub 上的 Tableau MCP 文档](https://tableau.github.io/tableau-mcp/)。

1. [将 Tableau 与 Slack 工作区集成](https://help.tableau.com/current/online/zh-cn/slack_admin.htm)。如果 Tableau 和 Slack 已集成，您的 Tableau 管理员可能需要[断开 Tableau 站点与 Slack 的连接](https://help.tableau.com/current/server/zh-cn/slack_admin.htm#disconnect-a-tableau-site-from-slack)并重新连接以获取最新更新。
2. [添加适用于 Slack 的 Tableau 应用程序](https://slack.com/help/articles/202035138-Add-apps-to-your-Slack-workspace)。您可能需要 Slack 管理员来执行此步骤。
3. 打开 Slack，然后打开与 Slackbot 的对话。
4. 单击“应用程序”图标（插头）以确认 Tableau MCP 已连接。
5. 使用对话语言向 Slackbot 询问有关您的数据的问题。

设置 Tableau MCP 后，尝试向 Slackbot 询问一个问题，例如“您可以访问哪些数据源？”或“您可以通过 Tableau 中的我的数据生成哪些见解？”

您可以创建技能来指定公司的特定工作流或使用 Tableau 的最佳做法。例如，创建一个 Slackbot 技能，通过聚合视图、数据源和 Tableau Pulse 指标的见解来生成每周报告。有关详细信息，请参见[如何使用 Slackbot](https://slack.com/help/articles/202026038-How-to-use-Slackbot)。

[跨多个 Tableau 站点将 Tableau MCP 与 Slackbot 结合使用](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/oauth#hosted-tableau-mcp)：

1. 断开 Slack 与 Tableau 站点的连接。
2. 在 Slack 中登录到另一个 Tableau 站点。
3. 在 Slackbot 中重新连接。

<!-- document id=57805f0c38d5cdf51e2e97617bbe46856b2a5cf9521b4f5aca58ef0290d1623c url=/tableau/next/zh-cn/online/projects.md -->

[跳转到主要内容](#main-content)

# 使用项目管理内容访问权限

当 Tableau Desktop 用户将内容发布到 Tableau Cloud 上的站点时，他们可选择一个_项目_以将其发布到其中。

项目可用于工作簿、数据源、镜头和嵌套项目等资产的导航、组织和访问权限管理。从 Tableau Cloud 2022 年 10 月版/Server 2022.3 开始，如果 Data Management 获得许可并启用 Catalog，项目还可以包含数据库等外部资产。

下图显示了 Web 制作环境中的顶层“操作”项目内的内容。“操作”项目包含一些嵌套项目（突出显示）和发布的工作簿。项目还可以包含其他资产类型。

![](/tableau/next/zh-cn/online/zh-cn/Img/project_and_content.png)

## 为何使用项目

项目可帮助您创建可扩展的过程，用于管理对发布到 Tableau Cloud 的内容的访问。项目具有以下优势：

- 项目使管理员能够将内容管理委派给与项目关系更密切的项目主管，而不必为他们授予站点或服务器设置的管理员访问权限。
    - 项目主管可以在其顶层项目下创建嵌套项目，从而使他们能够将其团队的内容保持在单一分层结构内。
    - **注意**：项目所有者可删除他们拥有的顶层项目。项目主管无法删除顶层项目。
- 项目使自助服务用户能够更轻松地在站点中导航。
    - 项目可将 Tableau Cloud 站点分为多个区域，根据用户对发布到这些区域的数据的使用方式，或者根据项目所使用的 Tableau 用户组来为用户授予访问权限。
    - 您可以针对无需使用项目的组将项目隐藏，创建可区分的项目命名架构，或者利用项目说明来阐明如何使用项目。
- 项目使您能够有效地跟踪权限。
    - 您可以基于组中的用户所需的内容访问权限级别来创建组，并设置项目的默认权限。这样，您将能确切知道新用户默认情况下将获得哪些能力，同样也可知道创建新项目时所有用户将获得哪些能力。

### 何时创建项目分层结构（示例）

许多组织都有若干或者更多个不同的 Tableau 用户组，其中每个组都有自己的优先级和主管。这些组可能共享一些组织级内容（或者甚至从组织级数据源池中提取内容），但他们主要使用特定于其团队的数据和报告。在这种情况或者类似情况下，使用项目分层结构的例子可能如下所示：

1. 作为站点管理员或服务器管理员，您可以为各个不同的 Tableau 团队创建顶层项目。
2. 在每个顶层项目上，您可以为项目负责人分配项目主管身份，以及更改项目所有权。项目主管实际上是内容管理员，因此他们务必要了解 Tableau 中权限的工作方式，以及 Tableau 内容管理最佳做法。
3. 每个项目主管可以管理其项目，同时在项目内创建适合于其团队的结构。也就是说，项目主管可以根据其团队成员协作处理和共享数据及报告的方式创建所需的子项目。

对站点管理员而言，优点在于您可以把主要精力放在系统运行状况上。而对于 Tableau 用户，优点则在于，了解 Tableau 及数据最佳处理做法的用户将能够管理自己团队的相关事宜，而不必提交 IT 请求来更改权限或添加项目。

### 使用项目树导航项目

默认情况下，“浏览”窗格会显示一个项目树，以帮助您轻松导航项目。您可以使用项目树查找项目文件夹中的子项目。您还可以使用项目树来搜索项目。  

![Tableau Cloud 中浏览窗格上的项目树。](/tableau/next/zh-cn/online/zh-cn/Img/Cloud_ProjectTree.png)  

您可以通过单击位于“浏览”窗格上的项目树图标来隐藏和取消隐藏项目树。  
  
![Tableau Cloud 中浏览窗格上的项目树图标。](/tableau/next/zh-cn/online/zh-cn/Img/Cloud_ProjectTreeIcon.png)  

> [!TIP]
> 
> **注意**：为确保项目树可见，请在“浏览”页面上保持浏览器窗口宽度至少为 1441 像素。较窄的窗口（1440 像素或更小）或分辨率较低的显示将隐藏项目树。  

## 项目级管理

有关管理项目的详细信息，请参见[使用项目管理权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm)。

## 此部分中的其他文章

<!-- document id=0224100362bb7490ffb4bb2fd95182713a9bd05b3a6cf7639ed5beb521c60de0 url=/tableau/next/zh-cn/online/permissions_projects.md -->

[跳转到主要内容](#main-content)

# 使用项目管理权限

项目可以通过嵌套项目、项目可见性、非管理员项目负责人和锁定权限等功能简化权限管理。

> [!TIP]
> 
> **提示：**在项目级别设置权限的方式很重要，特别是对于“默认”项目。创建新的顶层项目时，它将从“默认”项目继承其（适用于所有内容类型的）默认权限规则。在另一个项目内以嵌套方式创建新项目时，子项目将从父项目继承其默认权限规则。

## 项目管理

项目是用于组织内容和管理内容访问权限的容器。通过为非管理员授予管理项目的特权，将能在项目级别处理某些内容管理任务。

**项目主管：**项目可能有项目主管，即已设置为“项目主管”的用户。此设置自动为用户授予其针对该项目及其中的所有内容的最大能力（取决于用户的站点角色）。具有“Explorer（可发布）”及更高站点角色的项目主管拥有所有能力。项目主管本质上是项目的本地管理员，无法访问站点或服务器设置。

**分层结构：**只有管理员才能创建顶层项目。项目所有者和项目主管可在其项目内创建嵌套项目。

项目所有者和主管对项目及其内容以及其中包含的任何嵌套项目拥有完全管理访问权限。在分层结构中，系统将为项目主管隐式授予对所有子内容的项目主管访问权限。若要移除项目主管访问权限，您必须在分层结构中显式分配了角色的级别进行移除。

**所有权：**一个项目可以有多个项目主管，但每个项目只有一个所有者。默认情况下，项目所有者是创建项目的用户。 

现有所有者或管理员可以更改项目的所有者。（项目负责人不能更改项目所有权，只能更改内容所有权）。项目可以由具有 Explorer（可发布）、Creator 或管理员站点角色的用户所有。即使项目已锁定，也可以更改项目所有权。

**删除：**大多数内容只能存在于项目内。只有管理员才能创建和删除顶层项目，但项目主管可以创建或删除嵌套项目。

删除项目还会删除它们包含的所有 Tableau 内容和嵌套项目。若要删除某个项目而不丢失其内容，请首先将内容转移到另一个项目。删除项目操作无法撤消。

外部资产的处理方式不同。他们不必位于项目中。如果外部资产的项目被删除并继续出现在“外部资产”中，则外部资产不会被删除。有关详细信息，请参见[不在项目中的外部资产](https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm#external_assets_not_in_projects)。

如需深入了解项目管理，请参见[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)和[添加项目并将内容移至其中](https://help.tableau.com/v0.0/online/zh-cn/projects_add.htm)。

## 特殊项目

默认：名为“默认”的项目是一个特殊项目。创建其他顶级项目时，它们使用“默认”项目作为模板，并从中复制所有权限规则（但不包括“资产权限”设置）。“默认”项目无法删除、移动或重命名，但可以更改其描述。它默认没有所有者，但可以指定一个。

外部资产默认项目：在 Tableau Cloud 和 Tableau Server 2023.1 及更高版本中，如果您拥有启用 Catalog 的 Data Management 许可证，则当 Catalog 需要将新的或现有的外部资产移动到其中时，将出现名为“外部资产默认项目”的项目。Catalog 将新的外部资产和已删除项目的外部资产放在“外部资产默认项目”中。默认情况下，项目没有权限规则，因此，除非增加了权限，否则服务器管理员和站点管理员是唯一可以查看它的用户。它不能被删除、移动或重命名，但可以更改其描述。它默认没有所有者，但可以指定一个。

## 设置项目主管

项目主管是对特定项目或项目分层结构类似管理员的访问权限的用户。

将项目主管身份分配给组或用户

1. 打开相应项目的权限对话框。
2. 选择现有权限规则，或单击“+添加组/用户规则”并选择所需的组或用户。
3. 打开该权限规则的操作菜单 (...)，并选择“设置项目主管...”。

**注意**：如果操作菜单包含"设置项目主管"的选项，则需要在将组或用户设置为项目主管之前选择此选项。仅当该组或用户被拒绝“项目主管”能力能（在 2020.1 之前）时，才会显示此选项。在将他们设置为项目主管之前，需要移除该已拒绝能力。

权限规则建立项目主管后，模板和能力将不可编辑，因为对于项目主管所有能力均为已允许。如果在包含嵌套项目的项目上建立了项目主管，他们将在所有嵌套项目及其内容上具有已继承项目主管身份。

项目主管身份始终在整个项目分层结构中向下应用，并且只能从设置它所在的级别中移除。若要移除项目主管身份，请按照相同步骤进行操作，但从操作菜单中选择“作为项目主管移除”。将组或用户作为项目主管移除后，该权限规则的所有能力将设置为“未指定”。这可能意味着，如果没有其他权限规则授予他们对内容的权限，则将删除他们对该项目的访问权限和能力。若要保留用户或组对项目及其内容的访问权限，他们需要像任何其他组或用户一样设置能力。

**注意**：在大多数情况下，项目主管可以刷新其项目中的数据提取。如果他们只是嵌套项目（而不是顶级项目）的项目主管并且顶级项目已_锁定（包括嵌套项目）_，则他们无法刷新数据提取。

## 锁定资产权限

在项目级别设置的权限规则充当该项目及其包含的任何嵌套项目中保存的内容的默认值。这些项目级别的默认规则是强制执行还是仅作为初步规则，取决于“资产权限”设置。可通过两种方式配置此设置：“已锁定”（推荐）或“可自定义”。锁定项目将移除内容所有者修改其内容的权限规则的能力。锁定权限可应用于嵌套项目，也可以仅应用于父项目本身。

- 当“资产权限”为“已锁定”（包括嵌套项目）时，将为项目及所有嵌套项目中的所有资产强制实施在项目级别设置的权限规则。
- 当“资产权限”为**“已锁定”**（_不_包括嵌套项目）时，将为项目中的资产强制实施在项目级别设置的权限规则。嵌套项目可以使用自己的权限规则独立配置，并设置为锁定或可自定义。
- 当“资产权限”为“可自定义”时，默认情况下，在项目级别设置的权限规则将应用于项目中的所有资产。但是，可以在发布期间或发布后针对单独的资产修改权限规则。

**注意**：无论权限规则是已锁定还是可自定义，都始终会应用内容权限。_已锁定_和_可自定义_仅指项目中的内容如何继承项目级别权限，以及谁可以更改这些权限。即使在具有可自定义权限的项目中，也只有特定用户可以修改权限（内容或项目所有者、项目主管、管理员或具有“设置权限”能力的用户）。

在已锁定项目中：

- 每个内容类型的项目权限规则将应用于所有资产。
- 只有管理员、项目所有者和项目主管才能修改权限。
- 内容所有者会丢失“设置权限”能力，但保留对其内容的所有其他能力。
- 项目中的所有内容的权限都是可预测的。

在可自定义项目中：

- 将内容发布到项目中或者创建嵌套项目时，默认情况下会应用项目权限规则，但可以在发布期间或创建内容之后修改权限。
- 具有“设置权限”能力的任何用户可以修改该内容的权限规则。
- 项目所有者对其内容拥有所有能力。
- 项目中不同内容的权限可能不同。
- 对可自定义父项目的任何权限更改都不会应用于嵌套项目。

### 设置资产权限（锁定项目）

新的顶层项目会从“默认”项目继承所有初始权限，但不继承“资产权限”设置，后者设置为“可自定义”。如果需要，可以将此项更改为“已锁定”。

若要配置“资产权限”，请执行以下操作：

1. 您必须以管理员、项目所有者或项目主管身份登录到站点
2. 打开某个项目的权限对话框
3. 在左上角的“资产权限”旁边，单击“编辑”链接，并在“资产权限”对话框中选择所需选项

![选择了“锁定”选项的“资产权限”对话框。](/tableau/next/zh-cn/online/zh-cn/Img/perms_lockproject.png)

**注意**：如果在上面的步骤 3 中左上角未显示**“编辑”**链接，则您可能位于 (a) 锁定项目中的嵌套项目或内部部分的权限对话框中，在这种情况下，该链接应会引导您进入管理项目功能；(b) 可自定义项目中的内容部分的权限对话框中，该对话框不显示任何内容；或者 (c) 视图的权限对话框中，该对话框指明视图权限如何绑定到工作簿。有关视图和工作簿权限的相互作用的详细信息，请参见[显示或隐藏工作表标签](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#sheettabs)。

### 更改资产权限

更改项目的“资产权限”设置时，结果取决于新设置。必须在管理项目级别对已锁定分层结构中的权限规则进行更改。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 60%;"></colgroup><tbody><tr><td style="font-weight: bold;">更改自</td><td style="font-weight: bold;">更改为</td><td style="font-weight: bold;">结果</td></tr><tr><td rowspan="2" style="font-weight: normal;">已锁定（包括嵌套项目）</td><td style="font-weight: normal;">已锁定</td><td><p>不修改现有权限规则。</p><p>任何嵌套项目变为可自定义。</p></td></tr><tr><td style="font-weight: normal;">可自定义</td><td><p>不修改现有权限规则，尽管这些规则可自定义。</p><p>任何嵌套项目变为可自定义。</p></td></tr><tr><td style="font-weight: normal;" rowspan="2">已锁定</td><td style="font-weight: normal;">已锁定（包括嵌套项目）</td><td><p>覆盖所有嵌套项目及其内容的现有自定义权限规则。此操作无法撤消。</p></td></tr><tr><td style="font-weight: normal;">可自定义</td><td><p>不修改现有权限规则，尽管这些规则可自定义。</p><p>任何嵌套项目都保留其内容权限设置和权限规则。</p></td></tr><tr><td style="font-weight: normal;" rowspan="2">可自定义</td><td style="font-weight: normal;">已锁定（包括嵌套项目）</td><td>覆盖项目以及所有嵌套项目及其内容中内容的现有自定义权限规则。此操作无法撤消。</td></tr><tr><td style="font-weight: normal;">已锁定</td><td><p>覆盖项目中内容的现有自定义权限规则。此操作无法撤消。</p><p>任何嵌套项目都保留其权限规则并保持可自定义。</p></td></tr></tbody></table>

### 移动项目和内容

#### 移动 Tableau 内容和外部资产

当 _Tableau 内容_或_外部资产_ 在具有不同权限设置的项目之间移动时，“资产权限”设置确定如何应用权限的逻辑。

- 将资产移到已锁定项目中会覆盖现有权限规则并强制执行目标的权限。
- 将资产移到可定制的项目中将维持资产的现有权限规则。

**注意**：在 Tableau Server 2022.3 和 Tableau Cloud 2022 年 6 月版之前，外部资产不能在项目中，对表的权限通过父数据库的“表权限”设置来管理。从 Tableau Server 2022.3 和 Tableau Cloud 2022 年 6 月版开始，外部资产可以在项目中。如果将数据库或表移动到项目中，则通过数据库控制表权限的旧设置将被忽略，并且数据库或表权限遵循其他资产的逻辑。

#### 移动项目

当_项目_移动到另一个项目时，将保留所移动项的权限设置，除非目标项目的范围已限定为包括嵌套项目。（在这种情况下，项目权限是指项目本身的“查看”和“发布”能力。）

- 如果目标项目设置为**“已锁定”（包括嵌套项目）**，则所移动项目_及其内容_的权限将被覆盖。
- 如果目标项目设置为**“已锁定”**（不包括嵌套项目），则不会覆盖所移动项目的权限。已移动项目是否已锁定或可自定义是从其原始设置中保留的。
- 如果目标项目设置为**可自定义，**则所移动项目的权限不会被覆盖，但它们现在可编辑。

如果所移动的项目以前嵌套在_已锁定（包括嵌套项目）_的父项目下，那么在移动时，项目将接受_已锁定（包括嵌套项目）_设置，并成为它所包含的任何项目的管理项目。注意：如果移动项目使其成为顶层项目，结果也相同。

移动锁定的嵌套项目时要小心

在_锁定（包括嵌套项目）_环境中移动嵌套项目可能很棘手。项目可能会进入使用户无法再次将其移出的情况。

如果嵌套项目由与管理项目不同的用户所有，并且管理项目设置为_锁定（包括嵌套项目）_，则嵌套项目可能最终无法被管理员以外的任何人移动。

例如，考虑用户 A 拥有的一个锁定（包括嵌套项目）顶级项目，以及用户 B 拥有的两个嵌套项目。如果用户 B 将一个嵌套项目移到另一个项目中，则他们无法将其移回原位 — 用户 A 也不能。

- 用户 B 无法移动**嵌套项目 2**，因为他们无权移动作为目标的**顶层项目**上的权限。
- 用户 A 无法移动**嵌套项目 2**，因为他们没有移动权限。
- **顶层项目**的项目主管无法移动它，即使项目主管向下渗透到嵌套项目也是如此。
- 只有管理员可以在此设置中移动**嵌套项目 2**。

![一个顶层项目，旁边有一个锁图标和名称“用户 A”，里面有“嵌套项目 1”和“嵌套项目 2”。两个嵌套项目都归用户 B 所有。](/tableau/next/zh-cn/online/zh-cn/Img/move_locked_nested_projects.png "移动内容窗口的屏幕截图")

## 集合

与包含内容的项目不同，可以将集合视为指向内容的链接列表。项目权限可以由项目中的内容继承，但集合的权限对添加到集合中的内容没有影响。这意味着不同的用户可能会在集合中看到不同数量的项，具体取决于他们有权查看哪些项。为了确保用户可以查看集合中的所有项，请分别调整这些项的权限。

如果您是管理员或集合所有者，则可以通过使用权限对话框或在共享集合时授予访问权限来更改集合的权限。有关详细信息，请参见[管理集合权限](https://help.tableau.com/current/pro/desktop/zh-cn/collections.htm#permissions)。

#### 私有集合

创建集合时，默认情况下它是私有的。私有集合会出现在所有者的“我的集合”页面上，但不会出现在站点上所有集合的列表中。私有集合只是没有添加权限规则的集合。与其他类型的内容不同，集合默认没有添加“所有用户”组。当您向集合添加权限规则时，它不再被标记为私有。若要将集合恢复为私有状态，请移除权限规则。

私有集合可由集合所有者和管理员查看，其站点角色赋予他们查看所有集合的有效权限。

<!-- document id=006da4d2803fbfc480ef6a17712c69665dd2ac5cc5e5c4a62357c3d8ae18c3b7 url=/tableau/next/zh-cn/online/to_bridge_window_unlink.md -->

[跳转到主要内容](#main-content)

# 停止通过 Windows 客户端刷新数据

本主题介绍数据源所有者在运行 Bridge 计划时通过 Tableau Bridge Windows 客户端停止刷新数据的几种方式。

## 移除数据源

通过从客户端中移除数据源，可以阻止客户端刷新使用 Bridge（旧版）计划的数据源。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 将光标悬停在数据源名称上，并单击数据源名称旁边的“移除”图标。

## 暂时或永久停止使用 Bridge

- 若要停止使用客户端并暂停客户端执行的数据源更新，请从系统托盘中打开客户端，并在右上方的设置菜单上选择“退出”。
    
    当您退出时，数据源及连接设置保持不变。
- 若要停止客户端并永久移除它链接到 Tableau Cloud 的数据源，请右键单击系统托盘中的 Bridge 图标，并选择“取消链接”。
    
    ![取消链接以移除所有数据信息并停止发送刷新到 Tableau Cloud](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_unlink.png)
    
    取消链接客户端也会从客户端中移除所有连接信息，包括存储的数据库凭据和 Tableau Cloud 帐户凭据。

### 退出和取消链接的影响

如果在客户端暂时停止时退出客户端并进行下一次刷新，数据源所有者将在 Tableau Cloud 中看到警报并收到电子邮件通知。

如果取消链接客户端，我们建议您删除客户端运行的 Bridge（旧版）计划。有关详细信息，请参见下面的[取消链接客户端后删除 Bridge（旧版）计划](#Delete)。

### 取消链接客户端后删除 Bridge（旧版）计划

取消链接客户端时，还应删除客户端运行的 Bridge （旧版）刷新计划。如果未删除计划，刷新将尝试按计划运行。在类似于这种情况下，您可能会收到刷新失败通知。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 在数据源页面上，单击“**数据提取刷新**”选项卡。
3. 选中计划旁边的复选框，并选择“操作”\>“删除”。

## 从站点中永久移除客户端

可以从站点中永久移除客户端，这将使客户端在设置 Bridge（旧版）计划时不再可见。

1. 登录到 Tableau Cloud，并导航到“帐户设置”页面。
2. 在“连接的客户端”下，单击要从站点中永久移除的客户端旁边的“删除”。

<!-- document id=0816658cd2f6ac640b4bac607065abbd9de7f6256e5cd94aed3f1344beebb322 url=/tableau/next/zh-cn/online/Request_access.md -->

[跳转到主要内容](#main-content)

# 允许站点用户请求访问内容

权限确定用户是否具有项目内工作簿、数据源或其他内容的查看访问权限。如果用户单击他们无权访问的内容或项目，他们可以向控制该内容权限的所有者发送访问请求。

![请求访问权限对话框](/tableau/next/zh-cn/online/zh-cn/Img/request_access.png)

当有人请求访问权限时，（在项目级别或工作簿级别）控制该内容权限的所有者将收到一封电子邮件，其中包含请求者的姓名和电子邮件、请求的内容或项目，以及授予内容访问权限的链接。在 Tableau Server 版本 2022.3 及更低版本中，所有者会收到指向要管理权限的内容的链接，，而不是用于直接授予访问权限的链接。

1. 在电子邮件通知中，选择“授予访问权限”。
2. 在出现的对话框中，若要授予查看权限模板，请选择“授予访问权限”。若要授予视图模板以外的权限，请选择“管理权限”。
    
    ![授予访问权限对话框](/tableau/next/zh-cn/online/zh-cn/Img/grant_access.png)

如果用户请求访问工作簿，并且内容权限已锁定到项目，则项目所有者将收到请求。同样，如果用户请求访问工作簿，并且项目权限由工作簿所有者管理，则工作簿所有者将收到请求。

授予权限后，所有者可以发送电子邮件给请求者，让他们知道他们对项目或工作簿具有查看能力。

## 默认设置

默认情况下，“请求访问权限”设置在新站点上已启用。若要在该设置处于禁用状态的情况下将其启用，请执行以下操作：

1. 转到站点的“设置”页面的“常规”选项卡。
2. 在“常规”选项卡上，向下滚动到“请求访问权限”，然后选择“允许用户请求访问项目、工作簿和视图”。
3. 单击“保存”。

## 配置项目权限

您可以通过调整项目的内容权限来控制谁接收访问请求。如果内容权限为：

- 锁定到项目：项目所有者接收请求。
- 可自定义：工作簿所有者接收请求。

若要使用项目管理内容访问权限，请参见[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)和[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#lock-project-permissions)。

有关如何评估权限规则的详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#evaluate-permission-rules)。

## 更改项目权限

_适用于管理员和项目主管_

可以在项目级别为项目本身和项目中的任何内容设置权限。举例来说，如果在项目级别配置了工作簿权限，则发布到该项目的所有工作簿都将继承这些默认权限。但是，Creator 可以选择在发布期间更改权限，或者某些用户可以更改已发布内容的权限。若要强制实施在项目级别建立的权限，可以将**内容权限**锁定到项目。 有关详细信息，请参见[锁定资产权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#LockProject)。

若要在项目级别设置权限，请执行以下操作：

1. 导航到项目
2. 打开“操作”菜单 (...)，并单击“**权限**”。 权限对话框将打开。

此对话框有两个主要区域：顶部的权限规则和下面的有效权限网格。使用选项卡在内容类型之间导航。

![项目权限窗口，其中突出显示了“组”行。](/tableau/next/zh-cn/online/zh-cn/Img/perms_projectwrkbkperms.png)

在顶部选择一行后，有效权限网格中将填充内容。使用此选项来验证权限。将鼠标悬停在能力指示符上可提供有关针对该特定用户允许或拒绝该能力的原因的信息。

6. 若要修改现有权限规则，请选择该规则并单击能力框以在允许/拒绝/未指定之间切换。
7. 若要创建新规则，请执行以下操作
    1. 选择“+添加组/用户规则”。
    2. 从下拉框中选择组或用户。这将创建一个行，您可以在其中配置权限规则。
8. 在权限规则的行中
    1. 从每个内容类型选项卡的下拉框中选择一个现有权限角色模板。
    
    ![“权限规则”窗口，其中从“自定义模板”菜单中选择了“探索”选项。](/tableau/next/zh-cn/online/zh-cn/Img/perms_projwkbk_templates.png)
    
    3. 或者通过导航到内容类型选项卡并单击能力来创建自定义规则。单击一次可将能力设置为**“已允许”**，单击两次将其设置为**“已拒绝”**，第三次单击将清除所选内容（**“未指定”**）。
9. 完成后，单击**“保存”**。

## 更改内容权限

_适用于管理员、项目主管和内容所有者_

如果项目权限可自定义，则可以修改单独的内容部分的权限。

> [!WARNING]
> 
> **警告**：Tableau 建议锁定项目权限。这些步骤仅与权限可自定义的项目中的内容相关。

### 设置内容权限

1. 导航到内容（工作簿、数据源、流程、数据角色）
2. 打开“操作”菜单 (...)，并单击“**权限**”。权限对话框将打开。

此对话框有两个主要区域：顶部的权限规则和下面的有效权限网格。

![用户权限和站点角色表。](/tableau/next/zh-cn/online/zh-cn/Img/perms_workbook_siteroles.png)

在顶部选择一行后，有效权限网格中将填充内容。使用此选项来验证权限。将鼠标悬停在能力方块上可提供有关针对该特定用户允许或拒绝该能力的原因的信息。

6. 若要修改现有权限规则，请打开该行的“操作”菜单 (...)，然后单击“**编辑**”。
7. 若要创建新规则，请执行以下操作
    1. 选择“+ 添加用户或组规则”。
    2. 如有必要，使用右侧的下拉框在组和用户之间进行切换。
    3. 从下拉框中选择组或用户。这将创建一个行，您可以在其中配置权限规则。
8. 在权限规则的行中，从下拉框中选择现有权限角色模板，或通过单击能力来创建自定义规则。

单击一次可将能力设置为**“已允许”**，单击两次将其设置为**“已拒绝”**，第三次单击将清除所选内容（**“未指定”**）。

10. 完成后，单击**“保存”**。

### 设置视图权限

在某些情况下，独立于包含视图的工作簿来指定视图权限可能很有价值。若要对已发布视图设置权限，请导航到已发布工作簿中的视图，然后按照上述步骤操作。

> [!WARNING]
> 
> **警告**：尽管可以在工作簿中设置视图级别权限，但我们强烈建议尽可能在项目（或工作簿）级别管理权限。为了使视图继承权限，必须锁定项目，或者必须使用**“将工作表显示为标签”**来发布工作簿。有关详细信息，请参见[允许站点用户请求访问内容](#sheettabs)。

<!-- document id=51736f1382250252a5ba2359850c2e9ddbfa5ed2984b33ec022722d7a4c5438a url=/tableau/next/zh-cn/online/private_connect_inbound.md -->

[跳转到主要内容](#main-content)

# 入站私人连接

适用于 AWS 的入站私人连接允许组织创建从其网络直接连接到 Tableau Cloud 的安全、私有和专用连接。通过在 AWS PrivateLink 之上预置这些连接，您的环境和 Tableau Cloud 之间的流量将使用私有 IP 地址空间，并且永远不会通过公共 Internet。

入站私人连接的私密性和安全性可以满足处理分析数据的关键要求，帮助您满足严格的数据隐私和合规性法规，例如 GDPR、HIPAA 和 CCPA。

入站私人连接从 Tableau Cloud 262 开始提供，并且需要使用 Enterprise 或 Tableau+ 许可版本进行 Tableau Cloud 部署。组织为建立的每个专用连接购买附加的私人连接端点产品。

## 支持的交互

创建专用连接并配置 DNS 后，用户和 API 客户端将正常与 Tableau Cloud 交互，但流量不会穿过公共 Internet。支持的交互包括：

- **Web 浏览器**：访问 Tableau Cloud 站点和 Tableau Cloud Manager (TCM)。
- **Tableau Desktop**：发布工作簿和数据源。
- **Tableau Bridge**：将客户端安全连接到 Tableau Cloud 站点。
- **API**：Tableau REST API、TCM REST API 和元数据 API。

注意：

- 您的 AWS Virtual Private Cloud (VPC) 和 Tableau Cloud pod 必须位于同一区域。
- 不支持 SCIM、Tableau ID 身份验证、TabGPT 和 CloudFront 静态资产等功能，这些功能需要标准 Internet 路由。

## 示例用例

### 场景 1：为合规而避免使用公共 Internet

您的组织处于严格监管的行业，必须遵守严格的数据隐私规则。网络安全策略可防止用户浏览器会话和 API 调用通过公共 Internet 到达 Tableau Cloud。

**使用入站私人连接**

数据完全通过 AWS 主干网在您的网络边缘和 Tableau Cloud 之间安全、私密地传输。

### 场景 2：完全网络隔离

您的组织希望确保外部参与者无法从公共 Web 访问您的 Tableau Cloud 登录页面。

**使用入站私人连接**

您建立入站专用连接，并为 Tableau Cloud 站点配置自定义域，该站点托管在 VPC 内的私有托管区域中。Tableau 会阻止通过基于默认公共路径的 URL 进行的所有访问，确保可从您的私有公司网络内以独占方式访问该站点。

## 高级设置概述

设置入站私人连接需要 AWS 管理员和 Tableau Cloud 管理员之间的协调。该过程涉及：

1. 在 AWS 中针对 Tableau 服务创建接口 VPC 端点。
2. 在 Tableau Cloud Manager 中注册端点 ID 以供审批。
3. 配置 AWS 安全组以允许 HTTPS 流量。
4. 在 AWS Route 53 中创建私有托管区域
5. 在您的私有托管区域中创建 DNS 记录，以通过您的私人连接端点安全地路由流量。

有关详细信息，请参见[设置入站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm)。

## 此部分中的其他文章

<!-- document id=df163293be00ef80a94fa99f605486177905bb92fbd65eb0bd75730c4013029f url=/tableau/next/zh-cn/online/private_connect_inbound_dns.md -->

[跳转到主要内容](#main-content)

# 入站私人连接的 DNS

本主题介绍如何为入站私人连接设置 DNS。首先设置连接组和安全组。有关详细信息，请参见[设置入站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm)中的步骤 1、2 和 3。

## 步骤 4：创建私有托管 DNS 区域

VPC 中的私有托管 DNS 区域可确保您的 Tableau Cloud 流量通过 VPC 端点而不是公共 Internet 路由。有关详细信息，请参见 AWS 文档中的“使用私有托管区域”和“创建私有托管区域”。

为以下各项创建私有托管区域：

1. `cloudmanager.tableau.com`
2. `{pod_name}.online.tableau.com`  
    `{pod_name}` 是您在[设置入站私人连接先决条件](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm#prerequisites)期间记录的 Tableau Cloud pod 名称 。
3. `bridge-{pod_name}.online.tableau.com`  
    `{pod_name}` 是您在[设置入站私人连接先决条件](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm#prerequisites)期间记录的 Tableau Cloud pod 名称 。
4. `sso.online.tableau.com`

创建每个区域时：

- 对于“域名”，输入您要创建的私有托管区域（域）。（区域 #2 示例： `10ay.online.tableau.com`）
- 对于“类型”，选择“私有托管区域”。
- 在“VPC ID”列表中，选择要与托管区域关联的 VPC。

## 步骤 5：在专用区域中创建 DNS 记录

添加将 Tableau Cloud 主机名指向 VPC 端点的 DNS 记录。有关详细信息，请参见 AWS 文档中的[使用 Amazon Route 53 控制台创建记录](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html)。

#### 所有 4 个区域共有的 DNS 记录

在[步骤 4](#step-four) 中的每个私有托管区域中创建以下 DNS 记录：

- _（将记录名称留空）_
- 记录类型：A
- 启用“别名”开关。
- 将流量路由到：选择“PC 端点的别名”。
- 选择 VPC 端点的区域。
- 搜索并选择您在[设置入站私人连接步骤 1](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm#step-one) 结尾记录的 VPC 端点“DNS 名称”。
- 路由策略：选择“简单路由”。
- 评估目标运行状况：保留为“否”。
- 选择“创建记录”。

为[步骤 4](#step-four)的**每个**其他私有托管区域重复此过程。

#### cloudmanager.tableau.com 的其他 DNS 记录

在 `cloudmanager.tableau.com` 区域 中创建一个额外的 DNS 记录：

- 记录名称：`*`  
    星号是一个通配符，将与 `cloudmanager.tableau.com` 域中的任何主机匹配。
- 记录类型：A
- 启用“别名”开关。
- 将流量路由到：选择“PC 端点的别名”。
- 选择 VPC 端点的区域。
- 搜索并选择您在[设置入站私人连接步骤 1](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_setup.htm#step-one) 结尾记录的 VPC 端点“DNS 名称”。
- 路由策略：选择“简单路由”。
- 评估目标运行状况：保留为“否”。
- 选择“创建记录”。

一旦 DNS 记录有机会传播，请通过从 VPC 内的主机登录到 Tableau Cloud 来测试您的连接。

## DNS 注意事项

- 如果您将灾难恢复区域与 Tableau Cloud pod 一起使用，入站私人连接将不会进行故障转移。
- 对于 VPC 内的主机，私有托管区域优先于同名的公共区域。只有私有托管区域中的记录才会解析。
- 如果 VPC 中的用户需要通过公共主机名访问其他 pod 上的 Tableau Cloud 站点，请在创建私有托管区域之前规划备用 DNS 策略。如需选择方法方面的帮助，请联系您的客户团队。

<!-- document id=3b359e1aaae17a7e4f5ceb59b30a43278415a9a5fc12ffe4da4170daee107f67 url=/tableau/next/zh-cn/online/private_connect_inbound_billing.md -->

[跳转到主要内容](#main-content)

# 入站私人连接计费

## 使用情况和计费

专用连接数据使用量根据通过专用连接的数据量进行计量和计费。AWS 将端点使用情况指标发布到 CloudWatch，后者跟踪 VPC 端点上的传入和传出流量使用情况。Tableau 根据此聚合流量进行计费。

有关使用情况或定价的信息，或者如果您有兴趣将私人连接添加到您的环境，请与您的 Tableau 客户经理联系。

<!-- document id=93545ba5e9bbdbff89584e726e5851b234eb671e1211f1f7d89ae0ddcb50f44e url=/tableau/next/zh-cn/online/to_get_started.md -->

[跳转到主要内容](#main-content)

# 入门指南

Tableau Cloud 是一种基于云的安全解决方案，用于制作、共享、分发和协作处理在 Tableau Cloud 中创建的内容。有关简要概述，请观看 [Tableau Cloud 和 Tableau Server 入门指南](https://www.tableau.com/zh-cn/learn/tutorials/on-demand/getting-started-tableau-cloudserver?playlist=509087)培训视频（2 分钟）。

## 此部分中的其他文章

<!-- document id=874175342b23cc51afa026aa9f916591c7af3c577286e444dfdd682800f46ded url=/tableau/next/zh-cn/online/itm_intro.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Cloud 上的 Tableau Advanced Management

**重要信息：**自 2024 年 9 月 16 日起，Advanced Management 不再作为独立的附加选项提供。仅当您先前购买了 Advanced Management，或者购买了某些许可证版本：Tableau Enterprise、Tableau Cloud+ 或 Tableau+ Bundle（适用于 Tableau Cloud），或者 Tableau Enterprise 或 Tableau Server+（适用于 Tableau Server）时，Advanced Management 功能才可用。

Tableau Advanced Management 是一组功能，旨在为您的 Tableau Cloud 部署提供增强的安全性、可管理性和可扩展性功能。

## Advanced Management 许可

Advanced Management 在 Tableau Cloud 中作为 Tableau Enterpris、Tableau Cloud+ 或 Tableau+ Bundle 的一部分，按部署进行许可。

- Advanced Management 只能用于 Tableau Cloud 部署。有关如何为现有 Tableau Cloud 部署购买 Advanced Management 的详细信息，请与您的客户经理联系。
- 如果 Advanced Management 已移除或从您的部署中停用时，您将无法再使用与 Advanced Management 关联的功能。

## 功能表

下表列出了 Advanced Management 附带的功能：

<table style="width: 100%;" class="table--plain"><colgroup><col><col><col></colgroup><thead><tr><th>功能</th><th>描述</th><th>使用该功能的要求</th></tr></thead><tbody><tr><td><span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span></td><td><span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 提供了一种在 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 部署的 Tableau 项目之间复制或迁移内容的简便方式。<p>有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cmt-intro.htm" class="xref">关于 Tableau Content Migration Tool</a>。</p></td><td><ul><li><span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 必须安装在支持 .NET 4.6.1 的 Microsoft Windows 版本（Windows 7 或更高版本、Windows Server 2008R2 或更高版本）上。</li></ul></td></tr><tr><td>活动日志</td><td>活动日志记录租户和站点级别的事件，以供进一步审核和分析。根据您要查看的事件，使用 Tableau Cloud Manager (TCM) REST API 或 Amazon Simple Storage Service (S3) 访问日志数据。数据更新时间不到 15 分钟，保留时间长达 365 天。<p>有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm" class="xref">活动日志</a>。</p></td><td><ul><li><p>TCM REST API：需要具有云管理员角色的 Tableau 用户和能够进行 API 调用的客户端。有关详细信息，请参见 <a href="https://help.tableau.com/current/api/cloud-manager/zh-cn/index.html" target="_blank">TCM REST API 概述</a>。</p></li><li><p>Amazon S3：需要 Amazon Web Services (AWS) 帐户、用于接收数据的 Amazon S3 存储桶，以及 AWS Key Management Service 密钥。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm" class="xref">设置活动日志</a>。</p></li></ul></td></tr><tr><td>“在线管理见解”数据保留</td><td>“在线管理见解”数据源最多可保留 365 天的站点数据。<p>有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm" class="xref">使用“在线管理见解”创建自定义视图</a>。</p></td><td>&nbsp;</td></tr><tr><td>客户管理的加密密钥</td><td>客户管理的加密密钥允许您使用客户管理的站点特定密钥加密站点数据提取，从而为您提供额外的安全性。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_customer_managed_encryption_keys.htm" class="xref">客户管理的加密密钥</a>。</td><td>&nbsp;</td></tr><tr><td>增加了站点容量</td><td>利用 <span class="mc-variable Variables.ITM_name variable">Advanced Management</span>，您获得许可的站点的容量在以下方面会增加：<ul><li>存储高达 5 TB</li><li>建议文件大小为 25 GB</li></ul><p>有关站点容量的详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm" class="xref">Tableau Cloud 容量</a>。</p></td><td>&nbsp;</td></tr></tbody></table>

## 此部分中的其他文章

<!-- document id=c3b900f4b5906e5584e54421b4830983231a09ae7b9d979a4510a66f84645a7f url=/tableau/next/zh-cn/online/to_bridge_client.md -->

[跳转到主要内容](#main-content)

# 关于 Bridge 客户端

本主题介绍 Bridge 客户端以及运行和使用该客户端的要求。大多数情况下，站点管理员负责安装和管理客户端。

**注意**：Tableau Cloud 2025.2（2025 年夏季）版本中新增了对 OAuth 连接的一次性刷新令牌（有时称为一次性刷新令牌、滚动刷新令牌或刷新令牌轮换）的支持，并在 Tableau Server 2025.3 版本中添加了支持（如果数据源提供商的 IDP 支持）。这些令牌在 Tableau Bridge 与 Tableau Cloud 的连接上尚不受支持。如果为连接使用外部 OAuth 配置，请参见 GitHub 中的 [OAuth 配置和使用文档](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 配置文档")了解详细信息。

## Linux 和 Windows 客户端概述

- Bridge 客户端需要在 Tableau Cloud 和私有网络数据之间启用连接。
- 站点的已连接客户端选项必须为启用状态，以允许 Tableau Bridge 客户端在无人值守的情况下运行，并且如果启用，则支持多重 Tableau 身份验证。
- 客户端会话由刷新令牌管理，刷新令牌是从 Bridge 客户端成功登录 Tableau Cloud 后生成的。如果刷新令牌在 14 天内未使用，则它将过期。刷新令牌过期后，需要重新登录 Tableau Cloud。如果刷新令牌会定期使用，其有效期取决于站点的激活时间。在 2023 年 6 月 (Tableau 2023.2) 或更高版本激活的站点上生成的刷新令牌将在 180 天后过期。所有其他站点上生成的刷新令牌将在一年后过期。
- 对于 Windows，一台计算机上只能安装一个客户端。对于 Linux，群集内的每个容器只能安装一个客户端。
- 必须在运行客户端的计算机上安装相应的数据库驱动程序。
- 对于数据提取连接，从客户端登录到 Tableau Cloud 的用户必须具有“Creator”、“Explorer（可发布）”角色，或两种类型的站点管理员角色之一：“站点管理员 Creator”或“站点管理员 Explorer”。如果用户不是站点管理员，则其必须是内容所有者。
- 对于实时连接，从客户端登录到 Tableau Cloud 的用户必须具有两种类型的站点管理员角色之一：“站点管理员 Creator”或“站点管理员 Explorer”。
- 若要维护实时连接，则_无法_从公共 Internet 访问 Tableau 内容连接到的数据库。

### 关于 Linux Bridge 客户端

您可以在 Linux 上的容器内部署 Tableau Bridge 客户端。若要在 Linux 上使用 Bridge，您必须创建自定义 Docker 映像，安装 RPM 包，然后从容器映像内部运行 Bridge。请参见[为容器安装 Linux 版 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_linux_install.htm)。

### 关于 Windows Bridge 客户端

当客户端运行时，可从安装客户端的计算机上的 Windows 系统托盘中访问该客户端。

![与在线数据源的 Tableau Bridge 连接。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_client_overview.png)

客户端由以下几部分组成：

1. **客户端名称**，同时也是安装了客户端的计算机的名称。
2. **连接状态**指明客户端是否已连接到 Tableau Cloud。
3. **站点**：客户端注册到的 Tableau Cloud 站点。
4. **设置菜单**，其中包含用于禁用错误报告和从站点取消链接客户端的选项。
5. **数据源**：默认情况下，此区域显示整个站点中客户端正在对其进行负载平衡（或池化）的实时查询的列表。此列表还可以包含已使用 Bridge（旧版）计划分配给此特定客户端的数据源。
    
    **注意：**此列表不显示使用 Bridge 刷新计划刷新的数据源或虚拟连接。若要查看使用 Bridge 刷新计划刷新的数据源或虚拟连接，请转到“作业”页面，并在“Bridge 刷新”上进行筛选。
6. **池化状态**：这显示数据源是否为客户端池的一部分。
    - 实时：实时状态指明数据源具有实时连接，并且是客户端池的一部分。**注意：**具有实时连接的虚拟连接未显示在此列表中。
    - 空白：空白状态指明客户端不是池的一部分。这是因为数据源正在使用 Bridge（旧版）计划。
7. **旧版选项**：这些选项在悬停时显示，以编辑或查看连接信息、转到计划，并在悬停时为使用 Bridge （旧版）计划的数据源运行手动刷新。
8. **客户端模式**指明客户端是以 Windows 应用程序形式还是服务形式运行。有关详细信息，请参见下面的部分。

### Windows 对数据提取连接的要求

- 若要刷新数据提取，客户端可以作为 Windows 服务或应用程序运行。
- 如果将客户端设置为以应用程序形式运行，则仅当计算机开机并且 Windows 用户登录并运行 Bridge 时，它才会完成刷新。
    
    如果计算机已关闭、用户注销 Windows 或者退出客户端，则该客户端上运行的数据源或虚拟连接的更新（通过池或手动方式）将无法到达 Tableau Cloud，并且数据源或虚拟连接不会刷新，直到用户再次登录。在此期间，内容所有者将收到来自 Tableau Cloud 的刷新失败通知电子邮件。有关详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm)。
- 为了确保基于文件的数据源的刷新在没有任何问题的情况下完成，设置为以服务方式运行的客户端必须引用源文件的完整 UNC 路径，而不是映射的驱动器路径。例如，使用“\\\\filesrv\\Data\\file.csv”而不是“C:\\Data\\file.csv”。
    
    对于设置为以应用程序形式运行的客户端，我们强烈建议客户端也引用完整 UNC 路径。有关详细信息，请参见[更改数据源的文件路径](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#file-path)。

### Windows 对实时连接的要求

- 若要运行实时查询，客户端可以作为 Windows 服务或 Windows 应用程序运行。

- 每个 Tableau Cloud 站点都可以有多个维护实时连接的客户端。也可以使用这些客户端来刷新数据提取。
- 如果将客户端设置为以应用程序形式运行，则仅当计算机开机并且 Windows 用户登录并运行 Bridge 时，实时查询才能进行。
    
    如果计算机已关闭、用户注销 Windows 或者退出客户端，则对数据源或虚拟连接的更新将无法到达 Tableau Cloud，并且内容无法保持最新。

### 应用程序模式与服务模式

客户端可在两种模式之一下操作：应用程序或服务。

客户端可以运行的模式取决于它运行所采用 Windows 用户帐户、客户端注册到的 Tableau Cloud 站点设置以及一般数据新鲜度需求。

- **应用程序：**当客户端设置为在“应用程序”模式下运行时，它将以 Windows _应用程序_形式运行。
    
    在这种模式下，当专门的用户登录到 Windows 时，客户端可方便地对连接到私有网络数据的内容进行实时查询和计划刷新。如果专门的用户退出 Windows，则客户端无法维护实时查询和按计划刷新数据提取。
- **服务：**当客户端设置为在服务模式下运行时，它将以 Windows _服务_形式运行。
    
    在此模式下，即使用户退出 Windows，客户端也会持续运行。Windows 用户帐户必须是“本地管理员”组的成员，才能在服务模式下运行客户端。帐户还必须能够以用户身份登录并缓存凭据。对于对实时查询和计划刷新进行负载平衡的池化客户端，建议使用此模式。服务模式为默认模式。

模式准则

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 33%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 33%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 33%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">包含已计划刷新的数据提取连接</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">实时连接</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">应用程序模式</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" colspan="2"><ul><li colspan="2">快速设置并验证客户端是否使内容保持最新。</li><li colspan="2">更大程度地控制客户端何时执行数据新鲜度任务。</li><li colspan="2">不要求用户是计算机上的本地管理员。</li><li colspan="2">要求用户登录到 Windows。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;" rowspan="2">服务模式</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" colspan="2"><ul><li>设置客户端一次 — 如果计算机必须重新启动，客户端将自动重新连接到 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span>。</li><li>要求 Windows 用户帐户是计算机上的“本地管理员”组的成员。此外，若要刷新基于文件的数据源，帐户必须对托管文件数据的网络共享驱动器具有域访问权限。</li><li>不要求用户登录到 Windows。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>推荐用于对刷新进行负载平衡。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm" class="xref">配置池</a>。</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>推荐用于对实时查询进行负载平衡。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm" class="xref">配置池</a>。</p></td></tr></tbody></table>

### Windows 客户端要求

为了运行和使用客户端，必须满足一组特定要求以及数据新鲜度任务独有的一些附加要求。

### 核心要求

- Microsoft Windows 10 或更高版本，64 位
- Windows Server 2016、Windows Server 2019、Windows Server 2022
    
    **注意**：尚不支持 Windows Server 2025。有关详细信息，请参见产品知识文章 [Tableau Server 与 Windows Server 2025 不兼容](https://help.salesforce.com/s/articleView?id=004811287&type=1)。
- Tableau 建议在防火墙后面的专用计算计算安装 Bridge 客户端。
- 客户端在其上运行的计算机必须位于相同的 Windows 域上，并且可以访问数据源或虚拟连接中指定的基础数据库。
- 计算机和 Windows 用户帐户必须能够访问数据源或虚拟连接中指定的基础数据。
- Tableau Cloud 的_已连接客户端_选项必须保持启用状态，以允许客户端在无人值守的情况下运行，如果启用，则支持多重 Tableau 身份验证。有关已连接客户端选项的详细信息，请参见[Tableau Bridge 的已连接客户端要求](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm#bridge)。

有关详细信息，请参见[池化容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#Pooling)。

### 针对“服务”模式的额外要求

- 若要在“**服务**”模式下运行客户端，运行 Bridge 的 Windows 用户帐户必须是计算机上的“本地管理员”组的成员。用户不需要登录到 Windows，但计算机必须开机并运行 Windows。
- 在“服务”模式下使用客户端并连接到网络共享驱动器中托管的文件数据时，要求帐户是有网络共享驱动器的域访问权限。

## 修复在“服务”模式下运行的客户端

有时，某些原因会导致内容连接正常停止工作。发生这种情况时会出现通知，并且通知通常会提供相关信息，引导您找到问题的原因。但是，如果 Tableau Cloud 无法在通知中提供故障排查信息，并且您以服务形式运行 Tableau Bridge，则可以使用“修复”命令来尝试重置连接。

为了帮助在“服务”模式下修复客户端，在 Windows 系统托盘中，右键单击 Bridge 图标并选择“修复”。这将停止并重新启动服务，已足以解决该问题。

## 临时文件

Bridge 临时文件位于 `C:\Users\<username>\AppData\Local\Temp` 文件夹中。

连接到 Tableau Cloud 时或关闭客户端后，临时文件会定期移除。

- 刷新后，`TEMP_*` 文件会被移除。
- Bridge 客户端关闭后，`hyper_` 文件将被删除。
- 由于系统要求，TableauTemp 文件夹不会被移除。

`cleanUpTempDirOnStartUp` 客户端设置确定是否在 Bridge 客户端启动时移除临时文件。设置为 false 时，不会移除临时文件。

<!-- document id=2c2bff34e4124e65e6ca652930a987a5e86e1061e83c0fe6d197e4a77b8b8465 url=/tableau/next/zh-cn/online/data_connect_about_overview.md -->

[跳转到主要内容](#main-content)

# 关于 Data Connect

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 允许 Tableau Cloud 用户访问您的私有网络或云服务上的数据源。Data Connect 采用责任共担模式运行。在这种模型中，客户提供物理或虚拟计算资源，Tableau 在这些资源上托管和管理 Data Connect Kubernetes 群集。

在您的环境中，Data Connect Kubernetes 群集负责监督一组容器。容器支持由一个或多个 Bridge 客户端组成的运行时环境。Bridge 客户端是运行任务并实现组织之间跨防火墙安全通信的程序。

Data Connect 服务包括：

- 群集监控和故障排除：Tableau 监控 Bridge 客户端的运行状况和使用情况。收集遥测数据是为了确保以最有效、最有效率的方式使用资源。
- 群集维护：升级自动部署，群集运维由 Tableau 拥有并全权执行。Data Connect 会根据需求和可用的计算池自动优化您的工作负载部署。
- 警报监控：持续提供事件管理，以快速解决问题并限制业务影响。

## 连接器支持

Data Connect 支持与 Linux 版 Tableau Bridge 支持的相同连接器。若要全面了解连接选项，请参阅[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)。

## 环境支持

Data Connect 目前支持本地和 VCP 环境：Amazon Web Services (AWS)、Microsoft Azure 和 Google Cloud Platform (GCP)。Data Connect 节点与单个 Tableau Cloud 站点兼容。节点必须与数据安装在同一个网络中。因此，客户应为每个专用网络规划至少三个节点，以保持服务的可用性。Data Connect 节点必须专用于 Data Connect。您不能将任何其他容器部署到 Tableau 拥有的群集。并且您不能为 Data Connect 使用现有群集。

## 架构

Data Connect 架构由三个主要组件和责任边界组成。虽然存在一些重叠，但 Tableau 主要负责应用程序和业务流程层，而客户负责基础设施（计算、操作系统、网络和存储）及其位置。

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_setup_579x566.png)

1. Tableau Cloud 与 Kubernetes 业务流程服务通信，以部署、监视和管理 Kubernetes 业务流程。
2. 初始化 Data Connect 时，通过端口 443 与业务流程提供程序服务建立安全连接。
3. 配置服务后，Kubernetes 群集将部署带有 Bridge 客户端的容器。这些 Bridge 客户端将负责执行 Tableau 工作负载。
4. Tableau Cloud 用户登录 Tableau Cloud 以与 Data Connect 服务进行交互。
5. 在设置时，Bridge 客户端使用 HTTPS 初始化与 Tableau Cloud 的连接。成功连接后，Bridge 客户端使用 WebSocket (wss://) 连接与您的 Tableau Cloud 环境建立安全的双向通信。
6. 从 Tableau Cloud 发起的查询针对您的数据库运行，以支持最终用户分析。

## 安全性

请参见[Data Connect 安全性](https://help.tableau.com/v0.0/online/zh-cn/data_connect_security.htm)。

## Data Connect 组件

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_object_relationship.png)

Data Connect 解决方案的主要组件是群集。群集是一个由一个或多个节点组成的 Kubernetes 群集。每个 Kubernetes 节点至少托管一个容器，而该容器又托管 Bridge 客户端。Bridge 客户端执行实时和数据提取查询。

池是网络规则的逻辑分组，用于指定哪些群集应该完成特定的查询。在部署规划的上下文中，池托管一组端点（域或 IP 地址），以实现负载平衡。域包括私有云数据、关系数据、文件数据等。

为了允许群集访问和刷新数据源，每个池都被分配给一个群集。为了分配负载，您可以向群集添加多个池。

## 部署概述

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_admin-tasks.png)

首先，在每台 Linux 服务器上运行一个脚本。此脚本在您的环境中配置 Tableau 管理的 Kubernetes 群集。Kubernetes 群集由 Tableau 管理。

配置 Kubernetes 后，将 Docker 容器部署到群集。然后，Tableau 将在容器内部署并远程管理 Bridge 客户端。与 Tableau 建立此配置后，您将映射连接到您的私有网络数据源。

有关部署 Data Connect 的详细信息，请下载白皮书[使用 Tableau Cloud 访问您的私有网络数据 - Data Connect 和 Tableau Bridge 最佳实践](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)。

## 数据库连接

查询通过群集中的 Bridge 客户端进行管理。您的数据直接从 Bridge 客户端传输到 Tableau Cloud。Data Connect 不需要外部网络访问、防火墙漏洞或远程机器访问。

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_query_data_flow.png)

1. Bridge 客户端使用安全 WebSockets (wss://) 建立到 Tableau Cloud Data Connect 服务的持久连接。然后，客户端等待 Tableau Cloud 的请求。
2. - 对于具有实时连接或虚拟连接的数据源，Tableau Cloud 向 Bridge 客户端发起查询。
    - 对于包含使用刷新计划的数据提取连接的数据源，客户端接收刷新计划请求，并使用适用于数据源 (.tds) 文件的安全连接 (https://) 来联系 Tableau Cloud。
3. Bridge 客户端使用作业请求中包含的凭据连接到私有网络数据。
4. 数据库返回查询的结果。
5. Bridge 客户端接收有效负载并将其返回给 Data Connect 服务。

<!-- document id=6797db45620a69d233f48180ad3eb1830cddf4b355a46411e5da5b5f055b25a4 url=/tableau/next/zh-cn/online/dm_overview.md -->

[跳转到主要内容](#main-content)

# 关于 Data Management

**重要信息：**自 2024 年 9 月 16 日起，Data Management 不再作为独立的附加选项提供。仅当您先前购买了 Data Management，或者购买了某些许可证版本：Tableau Enterprise、Tableau Cloud+ 或 Tableau+ Bundle（适用于 Tableau Cloud），或者 Tableau Enterprise 或 Tableau Server+（适用于 Tableau Server）时，Data Management 功能才可用。

Data Management 是一组特性和功能，可帮助客户在其 Tableau Server 或 Tableau Cloud 环境中管理 Tableau 内容和数据资产。

从 Tableau Server 2019.1 开始，Tableau Prep Conductor 可用于本地 Tableau Server 部署，在版本 2019.3 中，Tableau Prep Conductor 可用于 Tableau Cloud。您可以使用 Tableau Prep Conductor 来计划和监视流程。

从 Tableau 2019.3 开始，Data Management 包括了 Tableau Catalog，为您在数据管理空间中提供各种各样的其他功能。您可以使用 Tableau Catalog 来发现数据、呈现数据资产、传达数据质量、执行影响分析，以及跟踪 Tableau 内容中使用的数据的世系。

从 Tableau 2021.4 开始，Data Management 中添加了更多治理和安全功能：虚拟连接和数据策略。使用虚拟连接编辑器，您可以创建：

- 提供可共享的数据中央访问点的虚拟连接。
- 在连接级别应用行级安全性的数据策略。

## Data Management 功能

下表列出了 Data Management 的功能，其中包括：

- Tableau Catalog
- Tableau Prep Conductor
- 虚拟连接
- 数据策略

### Tableau Catalog

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th><strong>功能</strong></th><th colspan="2">描述</th></tr></thead><tbody><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm#perms" class="xref">元数据权限</a></td><td colspan="2">通过 <span class="mc-variable Variables.DM_catalog variable">Tableau Catalog</span>，您可以通过设置权限来控制谁可以查看和管理外部资产，以及通过世系显示哪些元数据。</td></tr><tr><td>扩展的连接体验 - 数据发现</td><td colspan="2">不管是在 Web 上还是在 <a href="https://help.tableau.com/current/pro/desktop/zh-cn/examples_tableauserver.htm" target="_blank">Tableau Desktop</a> 中进行制作 ，您现在都可以搜索并连接到 <a href="https://help.tableau.com/current/server/zh-cn/creator_connect.htm" target="_blank">Tableau Server</a> 或 <a href="https://help.tableau.com/current/online/zh-cn/creator_connect.htm" target="_blank">Tableau Cloud</a> 站点上已发布数据源和工作簿使用的特定数据库和表。</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/search.htm">扩展的搜索</a></td><td colspan="2"><span class="mc-variable Variables.DM_catalog variable">Tableau Catalog</span> 扩展搜索以包括基于列、数据库和表的结果。</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm" target="_blank">标记外部资产</a></td><td colspan="2">您可以使用标记对 Tableau Server 和 Tableau Cloud 上的项进行分类，从而帮助用户筛选外部资产（数据库、文件、表和列）。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/datasource_certified.htm" target="_blank">认证数据库和表</a></td><td colspan="2">通过认证数据库和表，帮助用户查找符合您设置的标准的可信数据。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/dm_dqw.htm">设置数据质量警告</a></td><td colspan="2">您可以设置警告，将数据质量问题（例如过时或已弃用的数据）告知用户。</td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/dm_lineage.htm" target="_blank">世系和影响分析</a></td><td colspan="2">“世系”工具跟踪数据的来源。您可以使用它分析更改对数据影响，确定哪些用户可能受到影响，并以及<a href="https://help.tableau.com/current/online/zh-cn/dm_lineage.htm#email" target="_blank">通过电子邮件</a>有将关数据相关更新的信息告知工作簿、数据源或流程的所有者，或者数据库或表的联系人。</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information">数据详细信息</a></td><td colspan="2">通过查看有关所用数据的信息，使用户能够更好地了解已发布的可视化项。</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#add-or-edit-descriptions">为资产添加说明</a></td><td colspan="2">向数据库、表和列添加说明，帮助用户查找要查找的数据。</td></tr><tr><td rowspan="3">开发人员资源</td><td>Tableau REST API - <a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm" target="_blank">元数据方法</a></td><td>以编程方式添加、更新和移除外部资产；并将其他元数据添加到 Tableau 内容和外部资产（如描述）。</td></tr><tr><td><a href="https://help.tableau.com/current/api/metadata_api/zh-cn/index.html" target="_blank">Tableau 元数据 API</a></td><td>以编程方式查询发布到 Tableau Server 或 Tableau Cloud 的内容中的元数据。使用 Tableau Server REST API 中的<a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm" target="_blank">元数据方法</a>以编程方式更新某些元数据。 <br><b>注意：</b>元数据 API 不需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span>。</td></tr><tr><td><a href="https://help.tableau.com/current/api/metadata_api/zh-cn/docs/meta_api_start.html#explore-the-metadata-api-schema-using-graphiql" target="_blank">GraphiQL</a></td><td>使用名为 GraphiQL 的交互式浏览器中工具探索和测试针对元数据 API 架构的查询。 <br><b>注意：</b> GraphiQL 不需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span>。</td></tr></tbody></table>

### Tableau Prep Conductor

| 功能 | 描述 |
| --- | --- |
| [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/prep_conductor_online_schedule_flow_task.htm) 或 [Tableau Server](https://help.tableau.com/current/server/zh-cn/prep_conductor_schedule_flow_task.htm) 帮助中的“计划流程任务”。 | 您可以创建计划流程任务，以在特定时间或定期运行流程。 |
| [监视流程运行状况和性能](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_monitor_flow.htm) | 在流失败时在站点或服务器级别设置电子邮件通知，查看和恢复挂起的流程任务，以及查看错误和通知。 |
| [流程的管理视图](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_admin_views.htm) | 使用管理视图，在服务器或站点级别监视与流程、性能历史记录和已用磁盘空间相关的活动。 |
| Tableau REST API - [流程方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_flow.htm) | 以编程方式计划流程。 |

### 虚拟连接和数据策略

| 功能 | 描述 |
| --- | --- |
| [创建虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm) | 一种 Tableau 内容类型，可让您创建到精选数据的可共享、可重用的连接。 |
| [为行级安全性创建数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_rlspolicy.htm) | 使用虚拟连接编辑器创建具有策略条件的数据策略，这些策略条件将行级安全性应用于连接级别的数据。 |
| [使用“以用户身份预览”测试行级安全性](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_test_preview.htm) | 使用“以用户身份预览”测试数据策略，以确保用户只能看到他们的数据。 |
| [为虚拟连接计划数据提取刷新](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_extract.htm) | 为连接中的表创建数据提取刷新计划，确保使用该虚拟连接的任何内容的数据保持最新。 |

## 此部分中的其他文章

<!-- document id=cd5bb76f855edcfa3ad18bef695b45bd17892b8b6d2fd7f9d0f0b556f3967fd7 url=/tableau/next/zh-cn/online/dm_catalog_overview.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Catalog

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

数据在卷、格式和重要性方面不断增加，使环境变得更加复杂。随着数据的快速变化，将很难跟踪该数据以及它在这种复杂的环境中的使用情况。同时，更多的用户需要在更多地方访问更多的数据，而且用户很难找到正确的数据。最终，这会导致对数据缺乏信任，因为人们会对自己是否正在使用正确来源或者数据是否为最新有疑问。

Tableau Catalog 集成了世系、影响分析、数据字典、数据质量警告和 Tableau 应用程序内搜索等功能，可帮助您通过独立的目录以不同方式解决这些问题。它对 IT 和最终用户都有所侧重，因此使用 Tableau Server 或 Tableau Cloud 的每个人都更加信任并能更深入地查看数据，同时还能发现更多内容。Tableau Catalog 依据您的组织使用的 Tableau 内容中构建一个目录，从而实现了诸如以下的全面功能：

- **影响分析和世系。**
    - 您可以查看依赖于您管理的表或数据源中的特定列或字段的工作簿和其他 Tableau 内容。在需要更改数据时，您可以使用电子邮件通知受影响的 Tableau 作者。
    - 作为工作簿作者，您可以使用世系来跟踪工作簿所依赖的字段。
    - 作为用户，当您使用 Tableau 可视化项时，您可以看到用于创建的数据来自何处。
- **策展和信任。**作为数据专员，您可以添加有用的元数据（如说明和证书），以便用户可找到正确的数据。您可以设置数据质量警告、在“数据详细信息”窗格中查看数据详细信息、对资产进行认证，以及从目录中移除资产。
- **数据发现。**在 Tableau Desktop 或 Tableau Web 制作中，您可以使用 Tableau Catalog 来搜索数据库、表、数据源和虚拟连接，以便在 Tableau 中进行分析，并从搜索结果中连接到它们。

从 2019.3 开始，Tableau Catalog 作为适用于 Tableau Server 和 Tableau Cloud 的 Data Management 的一部分提供。当产品密钥处于活动状态并启用时，上述目录功能已集成到您使用的产品中，这样您就可以在发现数据的地方就地对其进行处理。

## Tableau Catalog 的工作方式

Tableau Catalog 可发现您的站点上的所有内容（工作簿、数据源、工作表、虚拟连接和流程）并对其建立索引，以收集有关内容的元数据。根据元数据，可以识别外部资产（数据库、表和其他对象）。了解内容与外部资产之间的关系使 Tableau 能够显示内容和外部资产的世系。利用 Tableau Catalog，用户还能够使用 Tableau Server 或 Tableau Cloud 连接到外部资产。

您站点上的用户可以发布或删除内容，可以附加数据质量警告或认证，或者执行任何其他更改站点上的内容或其元数据的操作，Tableau Catalog 将相应地更新其信息。

有关如何使用 Tableau Catalog 为在组织中进行数据管控提供支持的信息，请参见 Tableau Blueprint 帮助中的 [Tableau 的管控](https://help.tableau.com/current/blueprint/zh-cn/bp_governance_in_tableau.htm)。

## Tableau Catalog 关键术语

- 元数据 - 有关数据的信息。
- Tableau 内容 - 在 Tableau 中创建的内容，例如工作簿、数据源、虚拟连接和流程。
- 外部资产 - Tableau 内容使用的发布到 Tableau Server 或 Tableau Cloud 的数据库（包括数据文件）和表（包括类似表的对象）。

## Tableau Catalog 许可

Tableau Catalog 通过 Data Management 获得许可。有关 Data Management 许可的工作方式的信息，请参见[许可 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_license.htm)。

## 启用 Tableau Catalog

Tableau Server 或 Tableau Cloud 获得 Data Management 功能许可后，您可通过执行以下任务之一来启用 Tableau Catalog：

- **对于 Tableau Cloud**，无需进行操作。Tableau Catalog 默认情况下已启用，配置为使用派生权限，可以马上使用。有关派生权限的详细信息，请参见[元数据权限](https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm#perms)主题。
- **对于 Tableau Server**，服务器管理员必须首先使用 `tsm maintenance metadata-services` 命令启用 Tableau 元数据 API。有关详细信息，请参见[启用 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_enable.htm)。
    
    启用元数据 API 后，Tableau Catalog 默认情况下已启用，配置为使用派生权限，可以马上使用。有关派生权限的详细信息，请参见[元数据权限](https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm#perms)主题。

## 特性和功能

若要详细了解可用于 Tableau Catalog 的功能，请参见以下帮助文章：

### 数据发现

- 在 Tableau Desktop 的“连接”窗格中的“搜索数据”下，选择“Tableau Server”以[使用 Tableau Server 或 Tableau Cloud 连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/examples_tableauserver.htm)。启用 Tableau Catalog 之后，除了搜索要连接的已发布的数据源之外，您现在可以搜索并连接到 Tableau Server 或 Tableau Cloud 站点上已发布数据源和工作簿使用的特定数据库、表和对象。
- 启用 Tableau Catalog 之后，[搜索](https://help.tableau.com/current/pro/desktop/zh-cn/search.htm)范围得到扩展，可包括基于列、数据库、表和其他对象的结果。
- 如果您在 Web 上进行制作，则除了已发布数据源外，您还可以[连接到数据库和表](https://help.tableau.com/current/pro/desktop/zh-cn/getstarted_web_authoring.htm#tableau-catalog-users-create-workbooks-from-external-assets)。
- 如果您在 Web 上使用 Tableau Prep，则可以[基于外部资产（例如数据库和表）创建新流程](https://help.tableau.com/current/prep/zh-cn/prep_startflow.htm#start-a-new-flow)。
- 如果您[连接到 Salesforce Data Cloud](https://help.tableau.com/current/pro/desktop/zh-cn/examples_data_cloud.htm) ，您将看到对 Tableau Catalog 中内置的原生 Data Cloud 对象的支持。数据湖对象 (DLO)、数据模型对象 (DMO) 和计算见解在搜索、连接和世系页面中显得截然不同，这使得发现、连接和重用它们变得更加简单。

### 策展和信任

- [对数据资产进行认证](https://help.tableau.com/current/online/zh-cn/datasource_certified.htm)，帮助用户查找受信任的数据和推荐的数据。
- 设置[数据质量警告](https://help.tableau.com/current/online/zh-cn/dm_dqw.htm)，将数据质量问题（例如过时或已弃用的数据）告知用户。
- 添加[敏感度标签](https://help.tableau.com/current/online/zh-cn/dm_labels_sensitivity.htm)可警告用户需要小心处理的数据。
- 添加[自定义标签](https://help.tableau.com/current/online/zh-cn/dm_labels_custom_categories.htm)以适合您组织需求的方式对数据进行分类
- [管理数据标签](https://help.tableau.com/current/online/zh-cn/dm_labels_manage.htm)以扩展用户可用的标签名称和类别。
- 使用[标记](https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm)对 Tableau Server 和 Tableau Cloud 上的项目进行分类，以帮助用户筛选外部资产。
- 通过使用[“数据详细信息”](https://help.tableau.com/current/pro/desktop/zh-cn/data_explore_analyze_interact.htm#use-data-details-to-see-visualization-information)选项卡来查看所使用数据的信息，从而更好地了解发布的可视化项。
- 向数据库、表和列[添加说明](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#add-or-edit-descriptions)，帮助用户查找所需数据。

### 世系和影响分析

- 使用[世系](https://help.tableau.com/current/online/zh-cn/dm_lineage.htm)来跟踪数据的来源，以及分析数据更改的影响并确定哪些用户可能受到影响。
- [通过电子邮件](https://help.tableau.com/current/online/zh-cn/dm_lineage.htm#email)将有关数据相关更新的信息告知工作簿、数据源或流程的所有者。对数据库、表或对象联系人执行相同的操作。

### 开发人员资源

您可以使用 Tableau REST API 中的元数据方法以编程方式更新某些元数据。有关元数据方法的详细信息，请参见 Tableau Server REST API 中的[元数据方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm)。

除了 REST API 外，您 可以使用 [Tableau 元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html) 以编程方式查询发布到 Tableau Server 或 Tableau Cloud 的内容中的元数据。元数据 API 快速且灵活，当您想要了解有关元数据及其结构之间的关系的特定信息时，它是最佳选择。使用名为 [GraphiQL](https://help.tableau.com/current/api/metadata_api/zh-cn/docs/meta_api_start.html#explore-the-metadata-api-schema-using-graphiql) 的交互式浏览器中工具探索和测试针对元数据 API 架构的查询。

**注意**：使用元数据 API 或 GraphiQL 不需要 Data Management。

<!-- document id=94c728feff5aca56bf9504fa85401b821a2ef1ecaf70c9759f391e5f4ef34662 url=/tableau/next/zh-cn/online/to_tab_cloud_plus_features.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Cloud+ 版本

Tableau Cloud+ 版本仅适用于 Tableau Cloud。它专门为全面采用 AI 驱动的自助分析而量身定制。它包含为更大或更复杂的部署定制的高级功能（如“发布预览”和 50 个站点的限制）、高级 AI 功能（如 Tableau Agent）和 Premier Success for Tableau Cloud。

**注意：**Tableau Cloud+ 版本还作为 Tableau+ Bundle 的一部分提供，其中包括 Tableau Next。有关 Tableau+ Bundle 的详细信息，请参见[关于 Tableau+ Bundle](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_features.htm)。有关许可版本的比较，请参见 Tableau.com 网站上的[定价页面](https://www.tableau.com/zh-cn/pricing)。

## Tableau Cloud+ 许可

Tableau Cloud+ 版本按用户出售，用户按角色区分 - Creator、Explorer 和 Viewer（查看者）。Tableau Cloud+ 版本提供了一套独特的产品功能供每个用户使用。Tableau Cloud 的 Tableau Cloud+ 版本中的精选 AI 功能可与 Data 360 中的[审计跟踪](https://help.salesforce.com/s/articleView?id=release-notes.rn_einstein_audit_trail_intro.htm&release=248&type=5)功能结合使用。Data 360 使用的 Flex 积分可通过 Salesforce Foundations 获得，并在所有 Salesforce 产品之间共享。有关 Data 360 计费的详细信息，请参见 Salesforce 帮助中的[审计和反馈的计费注意事项](https://help.salesforce.com/s/articleView?id=ai.generative_ai_audit_feedback_usage_types.htm&type=5)。

从 2026 年 7 月开始，Tableau Cloud+ 客户可以随 Tableau Cloud+ 一起购买基于容量的 Viewer（查看者）块。基于容量的 Viewer（查看者）块取代了每用户 Viewer（查看者）许可证。基于容量的许可提供无限制的 Viewer（查看者）用户帐户，并根据并发使用情况而不是指定用户定义容量。Creator 和 Explorer 继续按用户获得许可。部署可以使用基于容量或基于角色的 Viewer（查看者）许可，但不能同时使用两者。有关详细信息，请参见[基于容量的许可证模式](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#capacity)。

## Tableau Cloud+ 功能表

下表列出了 Tableau Cloud+ 附带的功能。以下功能适用于 Creator。Creator、Explorer 和 Viewer（查看者）之间的可用功能存在差异。

有关配置 Tableau Cloud+ 功能的信息，请参见[Tableau Cloud+ 版本入门指南](https://help.tableau.com/v0.0/online/zh-cn/to_tab_cloud_plus_get-started.htm)。

<table style="width: 100%;" class="table--plain"><colgroup><col style="width: 189px;"><col></colgroup><tbody><tr><td>功能</td><td>描述</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/default.htm" target="_blank" title="Tableau Desktop 和 Web 制作帮助">Tableau 制作</a></td><td>使用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 Tableau Cloud 上的 Tableau Web 制作来创建、协作和分享有关数据的见解。Tableau 为您提供了一种以直观且易于理解的方式识别和解决问题或突出显示关键发现的方法。</td></tr><tr><td><a href="https://help.tableau.com/current/prep/zh-cn/prep_welcome.htm" target="_blank" title="Tableau Prep 帮助">Tableau Prep</a></td><td>Tableau Prep 是一种数据准备工具，用于清理、整理和合并数据以供分析。</td></tr><tr><td><a href="https://www.tableau.com/zh-cn/learn/training/elearning-courses" target="_blank" title="Tableau eLearning">eLearning</a></td><td>基于角色的培训 Tableau 学习路径提供了一条清晰的途径，可帮助您熟练掌握最新的 Tableau 培训内容。评估可以帮助您评估您在学习路径上的进展情况，并让您对新技能充满信心。加快新员工的入职流程，并帮助更有经验的用户充分利用 Tableau 功能。<p>此功能适用于 Creator 和 Explorer 许可证。此功能不适用于基于容量的 Viewer（查看者）块许可。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/pulse_intro.htm" target="_blank" title="Tableau Pulse 概述">Tableau Pulse</a></td><td>Tableau Pulse 以摘要的形式提供有关您的数据的见解，发送给组织的订阅成员。这些 Pulse 见解的摘要显示趋势、异常值和其他变化，让您随时了解与您的工作相关的最新数据。<a href="https://help.tableau.com/current/online/zh-cn/pulse_ask_discover_qa.htm" target="_blank">增强型问答（发现</a>）是 Tableau Pulse 中的一项高级功能。 <p>有关设置 Pulse 的信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm" class="xref">为 Tableau Pulse 设置站点</a></p></td></tr><tr><td><a href="https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm" target="_blank">Prep 中 Tableau 中的 Tableau Agent</a><p><a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#gen-ai-description" target="_blank" alt="Opens a Help page about Tableau Agent in Catalog" title="在 Catalog 中打开有关 Tableau Agent 的帮助页面">Catalog 中 Tableau 中的 Tableau Agent</a></p></td><td>Tableau Agent 是一款智能助手，可加速 Tableau Prep 和 Catalog 中的见解获取时间。<p>有关为 Tableau 中的 AI 配置 Tableau Cloud 站点的信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm" class="xref">在您的 Tableau Cloud 站点中启用 AI</a>。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/web_author_einstein.htm" target="_blank" title="Tableau Cloud Web 制作中的 Tableau Agent">Tableau Cloud Web 制作中的 Tableau Agent</a></td><td>Authoring Cloud Web 制作中的 Tableau Agent 是一款智能助手，可通过自动数据分析来加速见解获取时间。<p>有关在 Tableau Cloud Web 制作中启用 Tableau Agent 的信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm" class="xref">在您的 Tableau Cloud 站点中启用 AI</a>。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/private_connect.htm" target="_blank" class="xref">私人连接</a></td><td>适用于 AWS (Amazon Web Services) 的私人连接允许云管理员在 Tableau Cloud 和 AWS 托管的数据提供商之间创建安全、私有的专用连接。这些专用连接在 AWS PrivateLink 之上预置，使用私有 IP 地址空间，这意味着数据流量不会遍历公共互联网。专用连接的私有和安全特性满足了将数据流量限制到专用网络的关键要求。<p>Tableau Cloud+ 默认不包含该功能，但可单独购买。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/dm_overview.htm" target="_blank" title="Data Management 概述">Data Management</a></td><td>Data Management 是一组特性和功能，可帮助客户在其 Tableau Cloud 环境中管理 Tableau 内容和数据资产。<p>包括一个资源块节点。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/itm_intro.htm" target="_blank" title="Advanced Management 概述">Advanced Management</a></td><td>Advanced Management 是一组功能，旨在为 Tableau Cloud 提供增强的安全性、可管理性和可扩展性功能。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm" class="xref">使用 Tableau Cloud Manager</a></td><td>Tableau Cloud Manager (TCM) 为管理员提供了一个集中管理界面，用于监督其组织的 Tableau Cloud 站点。通过 TCM，云管理员可以从一个位置创建和编辑站点、管理用户并监控其租户中多个站点的许可证消耗情况。<p>云管理员可以使用 Tableau Cloud+ 许可证管理最多 50 个站点。</p></td></tr><tr><td><a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_customer360_lm.htm&amp;type=5" target="_blank" title="Salesforce Data 360">Data 360</a><p>（以前称为 Data Cloud）</p></td><td>Salesforce Data 360 使所有 Salesforce 数据都可以在 Tableau 中原生使用，让您可以统一企业数据、利用元数据的强大功能并根据这些数据获取 AI 结果。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm" target="_blank">用于数据提取加密的外部 KMS</a></td><td>外部密钥管理使组织能够使用在其自己的 AWS 密钥管理服务 (KMS) 中控制的密钥来加密其数据提取。这增强了安全性，有助于满足合规性要求，并通过允许客户直接控制其加密密钥来提供更大的数据主权。</td></tr><tr><td><a href="https://www.salesforce.com/services/success-plans/overview/premier-success-plans/" target="_blank" alt="Link to Salesforce  Premier Success Plans web page">Premier Success</a></td><td>通过 Premier Success Plan，您可以强势起步、拓展业务，并通过专家指导和快速支持从 Salesforce 中获取更多价值。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/release_preview.htm" class="xref">关于 Tableau 发布预览</a></td><td>发布预览允许云管理员创建和维护在升级其他生产环境之前接收主要发布更新的 Tableau Cloud 站点。</td></tr><tr><td><a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">嵌入工作流程的按需访问</a></td><td>按需访问允许客户向外部用户提供可视化项访问权限，而不要求每个用户都有指定的 Viewer（查看者）许可证。用户经过身份验证，但不需要在 Tableau Cloud 中添加为用户。<p>当 Tableau Cloud 使用基于容量的模型“基于容量的 Viewer（查看者）块”获得许可时，此功能可用。不适用于基于角色的 Viewer（查看者）许可。</p></td></tr></tbody></table>

## 此部分中的其他文章

<!-- document id=c69b5f32de8fafba82715730cbccf286989780e646cb85e13d1638e67a833699 url=/tableau/next/zh-cn/online/cmt-intro.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Content Migration Tool

这一组文章将引导您完成设置、使用和维护 Tableau Content Migration Tool 的过程。

**注意**：从 Tableau Server 迁移到 Tableau Cloud 时，不建议使用 Tableau Content Migration Tool。若要从 Tableau Server 迁移到 Tableau Cloud，请使用 [Tableau 迁移 SDK](https://help.tableau.com/current/api/migration_sdk/zh-cn/index.html)。有关 Tableau Content Migration Tool 推荐用例，请参见[Tableau Content Migration Tool 用例](https://help.tableau.com/v0.0/online/zh-cn/cmt-use-cases.htm#cmt-use-cases)

## 什么是 Content Migration Tool？

Content Migration Tool 提供了一种在项目之间复制或迁移内容的简便方式。Content Migration Tool 用户界面将引导您完成构建一个“迁移计划”所必需的步骤，您可以只使用该计划一次，或作为多次部署的模板使用。

**注意：**如果您有 Tableau Server 部署，您可以在 Tableau Server 安装和 Tableau Cloud 站点上的项目之间迁移内容。两种部署都必须具有有效的 Advanced Management 许可证。

在迁移内容之前，我们建议查看 Tableau 蓝图中的[内容管控](https://help.tableau.com/current/blueprint/zh-cn/bp_governance_in_tableau.htm#content-governance-in-tableau)部分。

## 帮助和支持

如果有无法使用此文档解决的问题，请与 [Tableau 技术支持](http://www.tableau.com/zh-cn/support/request)联系。

## 此部分中的其他文章

<!-- document id=92b3635a8019f594430666cc381ebf5999bbf9b5abebd2717539291ebf8e885d url=/tableau/next/zh-cn/online/to_tab_enterprise_features.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Enterprise

Tableau Enterprise 是我们先进的软件包，可帮助您更快地使用 Tableau Cloud 探索和管理数据。它还使购买需要高级数据和部署管理选项的组织所需的功能变得更加容易。

## Tableau Enterprise 许可

截至 2026 年 3 月，Tableau Enterprise 通过以下模式销售：

- **Tableau Server 或 Tableau Cloud 基于角色的版本**
    
    基于角色的版本采用基于每个用户角色的许可模式出售，包括 Creator、Explorer 和 Viewer（查看者）。该模型围绕组织内的特定角色构建，每个角色都需要不同级别的功能。使用 Tableau Enterprise，每个基于角色的许可证都包括 Data Management、Advanced Management 以及面向 Creator 和 Explorer 的 eLearning。适用于 Tableau Server 或 Tableau Cloud。
- **Tableau Server 核心版本**
    
    核心版本基于容量，以 8 个核心为增量销售，并将 Advanced Management 和 Data Management 捆绑到许可证中。仅适用于 Tableau Server。

从 2026 年 7 月开始，Tableau Enterprise 客户可以随 Tableau Enterprise 一起购买基于容量的 Viewer（查看者）块。基于容量的 Viewer（查看者）块取代了每用户 Viewer（查看者）许可证。基于容量的许可提供无限制的 Viewer（查看者）用户帐户，并根据并发使用情况而不是指定用户定义容量。Creator 和 Explorer 继续按用户获得许可。部署可以使用基于容量或基于角色的 Viewer（查看者）许可，但不能同时使用两者。有关详细信息，请参见[基于容量的许可证模式](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#capacity)。

## Tableau Enterprise 功能表

下表列出了Tableau Enterprise 许可版本包含的功能。以下功能可用性是针对 Creator 而注明的。Creator、Explorer 和 Viewer（查看者）之间的可用功能存在差异。

<table style="width: 100%;" class="table--plain"><colgroup><col style="width: 286px;"><col></colgroup><tbody><tr><td>功能</td><td>描述</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/default.htm" target="_blank" title="Tableau Desktop 和 Web 制作帮助">Tableau 制作</a></td><td>在 Tableau Cloud 上使用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 Tableau Web 制作创建、协作和分享有关您的数据的见解。Tableau 为您提供了一种以直观且易于理解的方式识别和解决问题或突出显示关键发现的方法。</td></tr><tr><td><a href="https://help.tableau.com/current/prep/zh-cn/prep_welcome.htm" target="_blank" title="Tableau Prep 帮助">Tableau Prep</a></td><td>Tableau Prep 是一种数据准备工具，用于清理、整理和合并数据以供分析。</td></tr><tr><td><a href="https://www.tableau.com/zh-cn/learn/training/elearning-courses" target="_blank" title="Tableau eLearning">eLearning</a></td><td>基于角色的培训 Tableau 学习路径提供了一条清晰的途径，可帮助您熟练掌握最新的 Tableau 培训内容。评估可以帮助您评估您在学习路径上的进展情况，并让您对新技能充满信心。加快新员工的入职流程，并帮助更有经验的用户充分利用 Tableau 功能。</td></tr><tr><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_intro.htm" class="xref">Tableau Pulse 发行说明</a></p><p>(权限 Tableau Cloud)</p></td><td>Tableau Pulse 以摘要的形式提供有关您的数据的见解，发送给组织的订阅成员。这些 Pulse 见解的摘要显示趋势、异常值和其他变化，让您随时了解与您的工作相关的最新数据。<p>有关设置 Pulse 的信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm" class="xref">为 Tableau Pulse 设置站点</a></p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm" target="_blank" class="xref">关于 Data Management</a></td><td>Data Management 是一组特性和功能，可帮助客户在其  或 Tableau Cloud 环境中管理 Tableau 内容和数据资产。<p>Tableau Enterprise 中包含一个资源块节点。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm" class="xref">关于 Tableau Cloud 上的 Tableau Advanced Management</a></td><td>Advanced Management 是一组特征和功能，旨在为 Tableau Cloud 提供增强的安全性、可管理性和可扩展性。</td></tr><tr><td><p><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm" class="xref">使用 Tableau Cloud Manager</a></p></td><td><p>Tableau Cloud Manager (TCM) 为管理员提供了一个集中管理界面，用于监督其组织的 Tableau Cloud 站点。通过 TCM，云管理员可以从一个位置创建和编辑站点、管理用户并监控其租户中多个站点的许可证消耗情况。</p><p>云管理员可以使用企业许可证管理最多 10 个站点。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/data_connect_about_overview.htm" class="xref">关于 Data Connect</a></td><td>Data Connect 允许无缝访问 Tableau Cloud 中本地和私有云环境中的数据，并且不会显著增加 IT 开销。<p>Tableau Enterprise 默认不包含该功能，但可单独购买。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/private_connect.htm" target="_blank" class="xref">私人连接</a></td><td><p>适用于 AWS (Amazon Web Services) 的私人连接允许云管理员在 Tableau Cloud 和 AWS 托管的数据提供商之间创建安全、私有的专用连接。这些专用连接在 AWS PrivateLink 之上预置，使用私有 IP 地址空间，这意味着数据流量不会遍历公共互联网。专用连接的私有和安全特性满足了将数据流量限制到专用网络的关键要求。</p><p>Tableau Enterprise 默认不包含该功能，但可单独购买。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm" target="_blank">用于数据提取加密的外部 KMS</a></td><td><p>外部密钥管理使组织能够使用在其自己的 AWS 密钥管理服务 (KMS) 中控制的密钥来加密其数据提取。这增强了安全性，有助于满足合规性要求，并通过允许客户直接控制其加密密钥来提供更大的数据主权。</p></td></tr></tbody></table>

<!-- document id=0c89dcedaa570de1f5f1ba6a2a4fedddb5f35ae2f0fadd2c6440bb3a4bf24290 url=/tableau/next/zh-cn/online/pulse_about.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau Pulse

借助 Tableau Pulse，用户可以获得有关他们所关注指标的个性化数据见解。这些见解会通过电子邮件、Slack 和 Microsoft Teams 摘要直接发送给用户，使他们能够在已使用的工具中访问所需的数据。如果用户想要了解有关其数据的更多信息，他们可以打开 Tableau Cloud 上或 Tableau Mobile 中的指标详细信息页面。在该页面上，用户可以进行引导式数据分析，以了解是什么推动了数据的变化。

Tableau Pulse 可用于 Tableau Cloud。若要让站点为 Tableau Pulse 做好准备，站点管理员必须首先打开 Tableau Pulse 的站点设置，并确保有适当的数据可供使用。然后，用户可以创建指标定义，指定指标的核心元数据。用户通过调整筛选器和时间选项来根据这些定义创建指标，以对不同关注者群体有用的方式确定数据范围。

此部分中的文章可帮助您开始使用 Tableau Pulse，无论您是设置站点的 Tableau 管理员、定义指标所基于的元数据的 Creator、探索现有指标的 Viewer（查看者）还是嵌入指标的开发人员。

| 文章 | 受众 | 关于 |
| --- | --- | --- |
| [Tableau Pulse 发行说明](https://help.tableau.com/v0.0/online/zh-cn/pulse_intro.htm) | Creator、Explorer 和 Viewer（查看者） | Tableau Pulse 版本的功能公告 |
| [为 Tableau Pulse 设置站点](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm) | 站点管理员 | Tableau Pulse 的设置、权限和要求 |
| [使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm) | Creator、站点管理员 Explorer 和 Explorer（可发布） | 如何创建指标定义和指标 |
| [为 Tableau Pulse 设置数据](https://help.tableau.com/v0.0/online/zh-cn/pulse_data_source_requirements.htm) | Creator、站点管理员 Explorer 和 Explorer（可发布） | 创建指标定义的数据源要求 |
| [使用 Tableau Pulse 探索指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm) | Creator、Explorer 和 Viewer（查看者） | 可以使用指标进行的分析类型 |
| [在 Tableau Pulse 中关注指标并管理关注者](https://help.tableau.com/v0.0/online/zh-cn/pulse_manage_followers.htm) | Creator、Explorer 和 Viewer（查看者） | 如何关注指标并将其他人添加为关注者 |
| [使用 Tableau Pulse 设置手动目标](https://help.tableau.com/v0.0/online/zh-cn/pulse_goals.htm) | Creator、Explorer 和 Viewer（查看者） | 允许您跟踪指标性能的目标和阈值 |
| [在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm) | Creator、Explorer 和 Viewer（查看者） | 来自 Pulse 和 Ask Q&A 中的 Tableau Agent 的见解 |
| [Tableau Pulse 中的见解平台和见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm) | Creator、Explorer 和 Viewer（查看者） | Tableau Pulse 中的见解类型以及见解平台的工作原理 |
| [获取 Tableau Pulse 通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm) | Creator、Explorer 和 Viewer（查看者） | 有关您关注的指标发生不利变化的通知 |
| [使用 Tableau Pulse 指标和仪表板](https://help.tableau.com/v0.0/online/zh-cn/pulse_dashboard.htm) | Creator、站点管理员 Explorer 和 Explorer（可发布） | Pulse 仪表板对象和仪表板的推荐指标 |
| [高级 Tableau Pulse 功能](https://help.tableau.com/v0.0/online/zh-cn/pulse_capabilities.htm) | Creator、Explorer 和 Viewer（查看者） | Tableau+ 用户可用的 Tableau Pulse 功能 |
| [Tableau Pulse REST API 方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_pulse.htm) | 开发者 | 用于创建 API指标、获取指标详细信息、生成见解等的 API 方法 |
| [嵌入 Tableau Pulse](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_pulse.html) | 开发者 | Tableau 嵌入 API Web 组件，用于在网页中嵌入指标 |
| [设置 Pulse for Salesforce 应用程序](https://help.tableau.com/v0.0/online/zh-cn/pulse_salesforce.htm) | Salesforce 客户 | Salesforce 客户可以购买的 Pulse 应用（不再出售） |
| [配置 Tableau Pulse Lightning Web 组件](https://help.tableau.com/v0.0/online/zh-cn/lwc_tableau_pulse.htm) | Salesforce 客户 | 适用于 Salesforce Lightning 页面的 Tableau Pulse Lightning Web 组件 |
| [与 Tableau Mobile 上的数据交互](https://help.tableau.com/current/mobile/mobile-user/zh-cn/tableau_mobile_interact.htm) | Creator、Explorer 和 Viewer（查看者） | Tableau Mobile 上的 Tableau Pulse |

## 此部分中的其他文章

<!-- document id=b327788d270bb184a7fe8f8db368db294d0abe87c78f56aba3057d84f9e57907 url=/tableau/next/zh-cn/online/release_preview.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau 发布预览

从 2025 年 4 月开始，[云管理员](https://help.tableau.com/current/online/zh-cn/cloud_manager_admin.htm)可以创建发布预览站点，以在将 Tableau Cloud 主要版本中的功能更改应用于生产环境之前对其进行评估。本主题概述了创建发布预览版站点有益的场景，例如用于集成测试、合规性和发布准备。它还提供了有关如何使用 Tableau Cloud Manager (TCM) 创建发布预览站点的详细说明。

**注意：**发布预览仅适用于 Tableau+ 客户。有关详细信息，请参见[关于 Tableau+ Bundle](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_features.htm)。

## 入门指南

发布预览站点允许管理员和授权用户在 Tableau Cloud 中进行生产升级之前评估新特性和功能更改。这些站点托管在专用的有限发布预览环境中，并与标准 Tableau Cloud 站点分开更新。您创建的每个预览站点都将计入作为 Tableau+ 版本的一部分授予您的 50 个站点。

考虑为以下场景创建发布预览版站点：

- **集成测试：**测试您独特的配置以及与即将发布的版本的集成。这有助于您为更改做好准备，并在将更改应用于生产站点之前进行任何必要的调整。
- **合规：**确保组织的分析实践和程序符合监管标准和内部政策，例如 GxP 和 SOX。
- **发布准备：**了解新增功能及其工作方式，以便为最终用户制定沟通、培训和采用计划。

## 发布沟通

发布预览站点的云和站点管理员将在发布前两周和更新完成后在预览站点内收到产品内通知。通知包括暂定发布时间表和 Tableau Cloud 帮助文档链接。

发布预览站点的发布部署与标准 Tableau 发布过程是分开的。发布预览站点将至少比标准 Tableau Cloud 站点提前两周更新主要版本。有关 Tableau Cloud 维护通信和发布节奏的详细信息，请参见[Tableau Cloud 系统维护](https://help.tableau.com/v0.0/online/zh-cn/to_maintenance_schedule.htm)。

## 创建发布预览站点

与租户中的其他站点类似，云管理员可以通过 Tableau Cloud Manager (TCM) 创建发布预览站点。若要创建发布预览站点，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在“站点”页面上，选择“新建站点”。
3. 在“新建站点”对话框中，转到“站点位置”，然后从下拉菜单中选择一个带有“发布预览”前缀的位置。例如，`Release Preview - US West - Oregon`。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/release_preview_site_location.png)
4. 填写对话框中的其余字段，然后选择“创建”。

有关在 TCM 中管理站点的详细信息，请参见[添加、重命名、删除或激活站点](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_sites.htm)。

## 使用 Tableau Release Navigator 探索功能更改

您可以使用 Tableau Release Navigator 仪表板来浏览部署到发布预览站点的更改。在将更改应用于生产环境之前，所包含的功能在仪表板中可见。

![](/tableau/next/zh-cn/online/zh-cn/Img/release_preview_navigator.png)

若要查看发布预览网站中包含的功能，请按照下列步骤作：

1. 转到[Tableau Cloud 发行说明](https://help.tableau.com/v0.0/online/zh-cn/whatsnew_online.htm)，并向下滚动到“Tableau 版本导览”仪表板。请记住，嵌入的表看起来可能会有所不同，具体取决于浏览器的缩放级别。为了获得更好的查看体验，您可以在 [Tableau Public](https://public.tableau.com/app/profile/tableau.core.product.marketing/viz/ReleaseNavigator-V21/FeaturesInVersionDash) 上查看完整的仪表板。
2. 在每个项描述的开头查找“\[发布预览\]”，查看预览站点上的可用功能。发布预览更新位于仪表板的顶部。
3. 若要访问特定于功能的文档，请选择功能或将鼠标悬停在功能上。将出现一个工具提示，其中包含指向 Tableau Cloud 帮助主题的链接。
    
    **注意：**发布预览链接使用临时 URL，例如 `https://help.tableau.com/**release-preview**/online/en-us/<feature_name>`。这些主题描述即将推出的功能，可能会发生变化。有关生产升级后的最终功能详细信息，请参见最新版本的 Tableau 帮助。例如：`https://help.tableau.com/**current**/online/en-us/<feature_name>`。

<!-- document id=3b0ddb34cca63bbc0d91be08f8822dc0be73ff7d730b46b5a0f21951e6eacd59 url=/tableau/next/zh-cn/online/to_tab_plus_features.md -->

[跳转到主要内容](#main-content)

# 关于 Tableau+ Bundle

Tableau+ Bundle 是一个专为在 Tableau Cloud 和 Tableau Next 中全面采用自助式代理分析而定制的综合软件包。它包含针对更大或更复杂的部署定制的高级功能，例如带有 Tableau Agent 的高级 AI 功能、50 个站点限制、发布预览和 Tableau Cloud 的 Premier Success。借助 Tableau+ Bundle，客户还可以访问全球首个代理分析平台 [Tableau Next](https://help.salesforce.com/s/articleView?id=analytics.tua.htm&type=5 "Salesforce H&T 站点上的 Tableau Next 文档链接")。

## Tableau+ Bundle 许可

Tableau+ Bundle 按用户出售，用户按 Tableau Cloud 角色区分 - Creator、Explorer 和 Viewer（查看者）。Tableau+ Bundle 提供了一套独特的产品功能供每个用户使用。每个 Creator 还会在 Tableau Next 中获得一个 Creator 角色许可证。每个 Explorer 和 Viewer（查看者）都会在 Tableau Next 中获得一个使用者角色许可证。Tableau Cloud 的 Tableau+ Bundle 版中的精选 AI 功能可与 Data 360 中的[审计跟踪](https://help.salesforce.com/s/articleView?id=release-notes.rn_einstein_audit_trail_intro.htm&release=248&type=5)功能结合使用。

每个 Tableau+ Bundle 部署都包含一定数量的积分。这些积分可能是数据服务积分或 Flex 积分，具体取决于您的组织购买的许可证。有关 Data 360 的详细信息，请参见 Salesforce 帮助中的[审计和反馈的计费注意事项](https://help.salesforce.com/s/articleView?id=ai.generative_ai_audit_feedback_usage_types.htm&type=5)。

从 2026 年 7 月开始，Tableau+ Bundle 客户可以随 Tableau+ Bundle 一起购买基于容量的 Viewer（查看者）块。基于容量的 Viewer（查看者）块取代了每用户 Viewer（查看者）许可证。基于容量的许可提供无限制的 Viewer（查看者）用户帐户，并根据并发使用情况而不是指定用户定义容量。Creator 和 Explorer 继续按用户获得许可。部署可以使用基于容量或基于角色的 Viewer（查看者）许可，但不能同时使用两者。有关详细信息，请参见[基于容量的许可证模式](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#capacity)。

## Tableau+ Bundle 功能表

下表列出 Tableau+ Bundle 许可版本包含的功能。以下功能适用于 Creator。Creator、Explorer 和 Viewer（查看者）之间的可用功能存在差异。

有关配置 Tableau+ Bundle 功能的信息，请参见[Tableau+ Bundle 入门指南](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_get-started.htm)。

<table style="width: 100%;" class="table--plain"><colgroup><col style="width: 189px;"><col></colgroup><tbody><tr><td>功能</td><td>描述</td></tr><tr><td><a href="https://help.salesforce.com/s/articleView?id=analytics.tua.htm&amp;type=5" target="_blank" title="Tableau Next 帮助">Tableau Next</a></td><td>由 Data 360 和 Salesforce 平台支持的 Tableau Next 是一个可组合的 AI 分析平台，具有语义 AI，可为您的数据分析见解添加上下文和含义。</td></tr><tr><td><a href="https://help.tableau.com/current/pro/desktop/zh-cn/default.htm" target="_blank" title="Tableau Desktop 和 Web 制作帮助">Tableau 制作</a></td><td>使用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 Tableau Cloud 上的 Tableau Web 制作来创建、协作和分享有关数据的见解。Tableau 为您提供了一种以直观且易于理解的方式识别和解决问题或突出显示关键发现的方法。</td></tr><tr><td><a href="https://help.tableau.com/current/prep/zh-cn/prep_welcome.htm" target="_blank" title="Tableau Prep 帮助">Tableau Prep</a></td><td>Tableau Prep 是一种数据准备工具，用于清理、整理和合并数据以供分析。</td></tr><tr><td><a href="https://www.tableau.com/zh-cn/learn/training/elearning-courses" target="_blank" title="Tableau eLearning">eLearning</a></td><td>基于角色的培训 Tableau 学习路径提供了一条清晰的途径，可帮助您熟练掌握最新的 Tableau 培训内容。评估可以帮助您评估您在学习路径上的进展情况，并让您对新技能充满信心。加快新员工的入职流程，并帮助更有经验的用户充分利用 Tableau 功能。<p>此功能适用于 Creator 和 Explorer 许可证。此功能不适用于基于容量的 Viewer（查看者）块许可。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/pulse_intro.htm" target="_blank" title="Tableau Pulse 概述">Tableau Pulse</a></td><td>Tableau Pulse 以摘要的形式提供有关您的数据的见解，发送给组织的订阅成员。这些 Pulse 见解的摘要显示趋势、异常值和其他变化，让您随时了解与您的工作相关的最新数据。<a href="https://help.tableau.com/current/online/zh-cn/pulse_ask_discover_qa.htm" target="_blank">Pulse 中的 Tableau Agent</a>是 Tableau Pulse 中的一项高级功能。 <p>有关设置 Pulse 的信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm" class="xref">为 Tableau Pulse 设置站点</a></p></td></tr><tr><td><a href="https://help.tableau.com/current/prep/zh-cn/prep_einstein.htm" target="_blank">Prep 中 Tableau 中的 Tableau Agent</a><p><a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#gen-ai-description" target="_blank" alt="Opens a Help page about Tableau Agent in Catalog" title="在 Catalog 中打开有关 Tableau Agent 的帮助页面">Catalog 中 Tableau 中的 Tableau Agent</a></p></td><td>Tableau Agent 是一款智能助手，可加速 Tableau Prep 和 Catalog 中的见解获取时间。<p>有关为 Tableau 中的 AI 配置 Tableau Cloud 站点的信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm" class="xref">在您的 Tableau Cloud 站点中启用 AI</a>。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/web_author_einstein.htm" target="_blank" title="Tableau Cloud Web 制作中的 Tableau Agent">Tableau Cloud Web 制作中的 Tableau Agent</a></td><td>Authoring Cloud Web 制作中的 Tableau Agent 是一款智能助手，可通过自动数据分析来加速见解获取时间。<p>有关在 Tableau Cloud Web 制作中启用 Tableau Agent 的信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm" class="xref">在您的 Tableau Cloud 站点中启用 AI</a>。</p></td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/private_connect.htm" target="_blank" class="xref">私人连接</a></td><td>适用于 AWS (Amazon Web Services) 的私人连接允许云管理员在 Tableau Cloud 和 AWS 托管的数据提供商之间创建安全、私有的专用连接。这些专用连接在 AWS PrivateLink 之上预置，使用私有 IP 地址空间，这意味着数据流量不会遍历公共互联网。专用连接的私有和安全特性满足了将数据流量限制到专用网络的关键要求。<p>Tableau+ Bundle 默认不包含该功能，但可单独购买。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/dm_overview.htm" target="_blank" title="Data Management 概述">Data Management</a></td><td>Data Management 是一组特性和功能，可帮助客户在其 Tableau Cloud 环境中管理 Tableau 内容和数据资产。<p>包括一个资源块节点。</p></td></tr><tr><td><a href="https://help.tableau.com/current/online/zh-cn/itm_intro.htm" target="_blank" title="Advanced Management 概述">Advanced Management</a></td><td>Advanced Management 是一组功能，旨在为 Tableau Cloud 提供增强的安全性、可管理性和可扩展性功能。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm" class="xref">使用 Tableau Cloud Manager</a></td><td>Tableau Cloud Manager (TCM) 为管理员提供了一个集中管理界面，用于监督其组织的 Tableau Cloud 站点。通过 TCM，云管理员可以从一个位置创建和编辑站点、管理用户并监控其租户中多个站点的许可证消耗情况。<p>云管理员可以使用 Tableau+ Bundle 许可证管理最多 50 个站点。</p></td></tr><tr><td><a href="https://help.salesforce.com/s/articleView?id=sf.c360_a_customer360_lm.htm&amp;type=5" target="_blank" title="Salesforce Data 360">Data 360</a><p>（以前称为 Data Cloud）</p></td><td>Salesforce Data 360 使所有 Salesforce 数据都可以在 Tableau 中原生使用，让您可以统一企业数据、利用元数据的强大功能并根据这些数据获取 AI 结果。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/to_external_kms.htm" target="_blank">用于数据提取加密的外部 KMS</a></td><td>外部密钥管理使组织能够使用在其自己的 AWS 密钥管理服务 (KMS) 中控制的密钥来加密其数据提取。这增强了安全性，有助于满足合规性要求，并通过允许客户直接控制其加密密钥来提供更大的数据主权。</td></tr><tr><td><a href="https://www.salesforce.com/services/success-plans/overview/premier-success-plans/" target="_blank" alt="Link to Salesforce  Premier Success Plans web page">Premier Success</a></td><td>通过 Premier Success Plan，您可以强势起步、拓展业务，并通过专家指导和快速支持从 Salesforce 中获取更多价值。</td></tr><tr><td><a href="https://help.tableau.com/v0.0/online/zh-cn/release_preview.htm" class="xref">关于 Tableau 发布预览</a></td><td>发布预览允许云管理员创建和维护在升级其他生产环境之前接收主要发布更新的 Tableau Cloud 站点。</td></tr><tr><td><a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#on-demand-access-for-users" target="_blank">嵌入工作流程的按需访问</a></td><td>按需访问允许客户向外部用户提供可视化项访问权限，而不要求每个用户都有指定的 Viewer（查看者）许可证。用户经过身份验证，但不需要在 Tableau Cloud 中添加为用户。<p>当 Tableau Cloud 使用基于容量的模型“基于容量的 Viewer（查看者）块”获得许可时，此功能可用。不适用于基于角色的 Viewer（查看者）许可。</p></td></tr></tbody></table>

自 2025 年 9 月 16 日起，Tableau+ Bundle 不再包含 Data Connect。之前购买了 Data Connect 附加 SKU 的客户可以继续使用它们，但 Data Connect 不再可供净新购买。我们建议所有客户使用 Tableau Bridge（请参见 [使用 Tableau Bridge](https://help.tableau.com/v0.0/online/zh-cn/data_fresh_sync_section.htm)）或私人连接（请参见[从 Tableau Bridge 迁移到出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_migrate_from_bridge.htm)）作为替代方案。有关更多详细信息，请参见知识库中的 [Tableau Data Connect 停用](https://help.salesforce.com/s/articleView?id=005167106&type=1)。

## 此部分中的其他文章

<!-- document id=8e61930c8d3eb82787d2c1e01fe87fb6632dc76205581d65ba89250d2a0d529c url=/tableau/next/zh-cn/online/datasource_mfr_multiple_base_tables.md -->

[跳转到主要内容](#main-content)

# 关于多事实关系数据模型

多事实关系可让您构建具有多个_基表_的数据源。在数据模型中使用多个基表允许您在 Tableau 中执行多事实分析。

通过建立以基表为根的_表树_ ，您可以对具有不同概念域的数据结构进行建模，并使用它们的共享特征将它们连接起来。这种类型的分析通常被称为多事实分析、一致维度或共享维度。在 Tableau 中，我们将其称为多事实关系数据模型，因为您使用关系来构建它。多事实关系数据模型始终包含多个基表。基表是数据模型中最左边的表。有关如何确定使用哪些表作为基表的指导，请参见[何时使用多事实关系模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_mfr_when_to_use.htm)。

![多基表模型，其中一个树突出显示](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_highlightedtree.png)

多基表数据模型，其中一个基表的树突出显示。

## 相关程度

具有多个基表的数据模型对于数据片段如何彼此相关（或不相关）具有很大的灵活性。

**注意**：任何级别的相关性仅在具有多个基表的数据模型中相关。在多事实关系数据模型出现之前，要么所有内容都是相关的（在单一数据源内），要么什么都不相关（跨多个数据源混合）。

**数据模型中的相关性**

根据数据模型的结构，表是相关的、不相关的或共享的。在数据源中，表的相关性是一个常量。简要概述如下： 

- _相关表_ 在同一个树中。
    - 在 2024.2 之前，所有数据源都是由单个树组成的单基表数据源，而在单基表数据源中所有表都是相关的。
- _不相关的表_在不同的树中。基表始终彼此不相关。恰好位于一个基表下游的表也与其他树中的表不相关。
- _共享表_具有多个传入关系并属于多个树。
    - 具有多个传入关系的表的下游表也被视为共享表。

**分析过程中的相关性**

字段可以是相关、不相关、尚未相关、模糊相关的，或者可以充当拼接字段。一组字段之间的相关性是根据数据模型的结构、哪些字段正在被积极使用（即，以胶囊形式位于功能区上）以及这些字段是维度还是度量来逐张确定的。

![一个简单的可视化项，包含两个不相关的字段（一个在行上，一个在列上），以及一个不相关的工具提示，显示](/tableau/next/zh-cn/online/zh-cn/Img/mfr_unrelatedtooltip_example.png)

为了对来自多个表的字段进行可视化，Tableau 必须在后台执行联接来计算值。使用的联接类型取决于[字段的相关性](#fieldlevel)。简要概述如下： 

- 在可视化项中使用_相关字段_时，维度是内部联接的，并且度量值按维度细分。
    - 实际情况比这稍微复杂一些 — 可能需要在后台进行额外的连接，以确保[不删除任何度量值](https://www.tableau.com/zh-cn/blog/relationships-tableau-data-model)。但在仅有维度的可视化项 中，相关维度是内部联接的，这是这里的主要概念。
    - 这与单基表模型的行为相同。
- 在可视化项中使用_不相关字段_ ![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_unrelated.png "不相关图标") 时，维度是交叉联接的。度量值是表范围的（即，本地聚合为整个表的单个值）并且重复。
    - 字段也可能_尚未相关_或_模糊_相关，这意味着对于活动字段的组合，有多种方法可以解决它们的表之间的关系。如果 Tableau 遇到不确定性，它会将字段视为不相关。
- 基于共享字段_拼接_ ![](/tableau/next/zh-cn/online/zh-cn/Img/MFR_icon_related.png "拼接图标") 字段时，维度是外部联接的。度量值在任何可以细分的维度级别上进行聚合，并且可以重复。
    - _拼接维度_类似于[数据混合中的链接字段](https://help.tableau.com/current/pro/desktop/zh-cn/multiple_connections.htm#define-blend-relationships-for-blending)。计算每对相关字段的结果，然后将不相关的值通过它们之间共享维度的共享值拼接在一起。

所有这些概念和定义将在本主题后面进行更详细的讨论。

关于维度和度量

在 Tableau 中，_度量_是_聚合_ — 它们聚合到由视图中的_维度_设置的_粒度_。因此，度量的值取决于维度的上下文。例如，“谷物食品盒的数量”取决于我们指的是总库存还是每个品牌的盒数。

_维度_通常是分类字段，例如国家/地区或品牌。在 Tableau 中，维度设置视图的粒度，即_详细级别_。我们通常希望根据某种类别的组合将数据分组为标记。我们用来构建视图的维度确定我们有多少个标记。

当使用没有维度的度量时，它被称为_表范围_。这意味着它的值是整个表的完全聚合值。一旦我们在可视化项中使用诸如品牌之类的维度，度量就会被更细化地细分。现在谷物食品盒的总数是按品牌计算的。

_聚合_是指数据的组合方式。Tableau 的默认聚合为 SUM。您可以将聚合更改为其他选项，其中包括“平均值”、“中值”、“不重复计数”、“最小值”等。_粒度_指的是度量的详细程度或细分程度 — 由维度控制。除非度量的粒度是行级（又称解聚），否则其值必须是聚合的。

#### 示例

![五种品牌、三种包装盒尺寸的谷物食品包装盒数量数值表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_cereal_rawdata.png)

“谷物食品包装盒数量”的值是多少？

嗯，这取决于聚合类型和维度设置的粒度。

- 聚合
    - 总和（或总计）
    - 平均值
- 粒度：
    - 表范围/完全聚合（示例中的蓝色条形）
    - 按**“Brand”（品牌）**维度细分（示例中的彩色条形）

![包含四个可视化项的仪表板，一个用于显示表范围内的盒数总和 (54)，一个用于显示表范围内的平均盒数 (6)，然后这两个版本的可视化项按五个品牌细分](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_cereal.png)

## 字段级相关性指标

有多种视觉线索可以帮助您了解分析中使用的字段的相关程度。

### 工作表上的相关性指标

- **不相关的图标**：Tableau 使用不相关的图标 ![不相关图标](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_unrelated.png) 指明视图中的所有内容并非都是相关的。如果您在视图或“数据”窗格中的某个胶囊上看到不相关图标，则可以将鼠标悬停在该图标上[获取更多信息](https://help.tableau.com/current/pro/desktop/zh-cn/mfr_relatedness_messages.htm)。
    - 相关图标 ![](/tableau/next/zh-cn/online/zh-cn/Img/MFR_icon_related.png "拼接图标") 表示该字段正在将不相关的字段拼接在一起。
- **浅灰色字段名称**：当字段名称与功能区上使用的_任何_字段不相关时，它们在“数据”窗格中显示为浅灰色文本。您仍然可以使用这些字段在该可视化项中进行分析，但是不相关的字段在分析中的[评估方式与相关的字段不同](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#joinsbyrelatedness)。悬停时，这些字段也会显示不相关图标。

![数据窗格，其中一个完整的表显示为灰色，两个带有斜线眼睛图标的字段表示隐藏字段](/tableau/next/zh-cn/online/zh-cn/Img/mfr_gray_datapane.png)

**注意**：在以前版本的 Tableau 中，浅灰色字段名称表示字段已隐藏，并且“显示隐藏字段”处于选中状态。隐藏的字段在显示时，现在用可点击的眼睛图标 ![隐藏字段图标](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_hidden.png) 表示。

### 相关性警告对话框

当在可视化项中一起使用不相关的字段时，Tableau 会显示一个警告对话框，让您知道这些字段不相关。每次添加不相关的字段时都会出现此警告，以防止可能影响性能的意外交叉联接。

- 如果要使用不相关的字段而不进行拼接，请单击“添加”以继续将字段添加到可视化项。
- 如果要拼接不相关的字段，最佳做法是在以其他方式不相关的字段之前显示拼接字段。如果拼接字段已经在使用中，则不会显示该对话框。有关拼接如何防止交叉联接的详细信息，请参见[如何为相关性级别使用联接](#joinsbyrelatedness)。

![相关性警告对话框显示不相关维度的警告](/tableau/next/zh-cn/online/zh-cn/Img/mfr_unrelated_dialog_simple_v2.png)

如果要添加多个字段或视图中已存在多个字段，对话框中将出现“详细信息”区域。展开该区域可查看有关所有正在使用的字段的相关性的更多信息，并确定不相关性问题的来源。

![相关性警告对话框，其中包含不相关维度和度量的消息，并且“详细信息”区域已展开](/tableau/next/zh-cn/online/zh-cn/Img/mfr_unrelated_dialog_details_v2.png)

若要完全停止显示警告信息，请选择“不再显示”选项。您可以随时重新打开这些警告消息以重新启用它们：

- 在 Tableau Desktop 中，打开“帮助”菜单 >“设置和性能”\>“重置忽略的消息”。
- 在浏览器中，清除缓存数据。例如，在 Chrome 中，打开 **3 点式菜单**\>**“删除浏览数据...”**\> 选择**“缓存的图像和文件”**\>**“删除数据”**。

## 数据模型中的表级相关性

在具有多个基表的数据模型中，每个基表定义一组相关的表，并形成概念_树_。这些树必须至少通过一个共享表连接，以确保整体数据源是单一实体。

以前可以使用链接字段混合的两个数据源现在可以是具有两个树的单个数据源，通过包含这些公共字段的共享表连接。

![两个数据模型，一个由两个不同的数据源组成，另一个由两个数据源组成，这两个数据源叠加在它们共同的表上形成一个数据源](/tableau/next/zh-cn/online/zh-cn/Img/mfr_blending_comparison.png)

> [!TIP]
> 
> **提示**：数据模型中表的关联方式会影响分析中字段的关联方式。在分析过程中使用[“查看数据模型”](https://help.tableau.com/current/pro/desktop/zh-cn/viewdatamodel.htm)来查看表如何融入整体数据模型会很有帮助。

让我们使用此示例数据源来了解哪些表是相关、不相关或共享的。有两个树，一个树由基表 A 建立，另一个由基表 B 建立。

### 不相关的表

基表基本上是不相关的。同样，任何仅存在于单个树中的表都与其他树中的表不相关。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>表 A 和表 X 不相关</p></td><td><p>表 B 和表 X 不相关</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_tables_unrelatedbase.png" alt="基表 A 和 X 具有各自轮廓的数据模型。关系以浅灰色显示。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_tables_unrelateddownstream.png" alt="基表 A 与其下游表 B 共享一个轮廓的数据模型。基表 X 有其自己的轮廓。关系以浅灰色显示。"></td></tr></tbody></table>

### 相关表

同一个树中的表被视为相关的。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>表 A 和表 S 相关</p></td><td><p>表 B 和表 S 相关（通过表 A）</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_tables_related1.png" alt="强调基础表 A 与下游表的关系的数据模型"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_tables_related2.png" alt="一个数据模型，其中表 B 与另一个表的关系通过它们与同一基表（即表 A）的关系来强调"></td></tr></tbody></table>

### 共享表

共享表具有多个传入关系。这些表属于多个树并在它们之间共享。

表 S 和表 T 是共享的。

![一个数据模型，其中表 S 和 T 都具有多个传入关系。它们都属于基表 A 的树和基表 X 的树。 ](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_tables_shared.png)

## 分析中的字段级相关性

字段之间的相关性是根据[数据模型的结构](https://help.tableau.com/current/pro/desktop/zh-cn/viewdatamodel.htm)、哪些字段正在被积极使用（即，哪些字段以胶囊形式位于可视化项上）以及这些字段是维度还是度量来逐张确定的。[下一部分](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm#joinsbyrelatedness)介绍了字段相关性如何影响可视化项的结果。

让我们使用相同的示例数据源来演练一下某些场景。每个字段的名称表明它来自哪个表，例如 FieldB 来自表 B。除非另有说明，否则字段可以是维度或度量。

### 相关字段

从高层次来看，当 Tableau 可以根据单个树内的关系路径清楚地确定如何一起评估字段时，字段就是相关的。

例如，FieldB（来自表 B）和 FieldS（来自表 S）是相关的。

![FieldB 和 FieldS 上相关的](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_tables_related2.png)

### 不相关字段

从高层次来看，当字段不相关时，它们在任何情况下都是不相关的。这可能是因为这些字段来自不相关的表，例如使用来自两个基表的字段。在这种情况下，不同基表中的字段基本上不相关。

例如，FieldA 和 FieldX 不相关。

![FieldA 和 FieldX 不相关](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_tables_unrelatedbase.png)

或者，可以将字段视为在某个时间点上不相关 - 例如在模糊相关或尚未相关的情况下。在大多数情况下，当字段在一个可视化项的上下文中不相关时，您可以依靠[相关性指标](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_relatedness_messages.htm)来提醒您。

### 拼接维度

拼接是 Tableau 在分析过程中评估多事实数据模型中不相关表中的字段的方式。在可视化项中，使用共享表中的维度可以将原本不相关的字段拼接在一起，并允许在同一可视化项中同时评估它们。可以将其视为根据共享的维度将两个树的结果并列在一起。

举例来说，如果使用 FieldA 和 FieldX 构建可视化项，则这两个字段是不相关的。添加 DimensionS 会引入拼接字段。

- FieldA 和 DimensionS 一起评估。
- FieldX 和 DimensionS 一起评估。
- 这些中间结果是根据 DimensionS 的值汇总在一起的。
- FieldA 和 FieldX 现在已拼接。

![不相关的基表 A 和 X 通过其共享表 S 拼接在一起](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_fields_stitching.png)

**提示**：最佳做法是在导出不相关的字段之前，在可视化项中使用拼接字段。例如，先拖出 DimensionS，或者先拖出 FieldA，再拖出 DimensionS，再拖出 FieldX，而不是先拖出 FieldA，再拖出 FieldX，再拖出 DimensionS。首先添加拼接字段可确保 Tableau 始终知道如何评估关系，并避免因一起评估不相关的维度和交叉联接而产生的潜在性能问题。

拼接需要共享表中的维度在可视化项中处于活动状态。出于拼接目的，放置在“筛选器”功能区或“标记”卡上“工具提示”属性上的字段不被视为活动字段。

### 尚未相关的字段

字段还可以有多种相关但尚未相关的方式。当两个共享表（或下游共享表）之间可能存在多种关系时，就会发生这种情况。

假设有 FieldS 和 FieldT。它们的表通过基表 A 定义的树和基表 X 定义的树彼此相关。

在仅具有 FieldS 和 FieldT 的可视化项中，对于应该使用哪个树来关联它们，没有相关信息。如果没有其他信息，Tableau 就无法评估是通过基表 A 的树还是基表 B 的树来关联这些字段。

尽管存在多个_潜在_关系，但 FieldS 和 FieldT 被视为不相关。

![相关性较低的模糊字段 S 和 T](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_fields_not-yet_hyporelated.png)

这些可能相关但尚未相关的字段被评估为不相关字段，因为 Tableau 无法清楚地确定它们的关系路径。与只能拼接的真正不相关的字段不同，尚未相关的字段可以被解析并且字段可以直接相关。

### 模糊相关字段

字段也可能模糊相关。当共享表（或下游共享表）之间存在多个活动的可能关系时，就会发生这种情况。与尚未相关的字段（可被认为是低相关或欠相关）不同，模糊相关字段是超相关或过度相关的。

假设有 FieldS 和 FieldT。它们的表通过基表 A 定义的树和基表 X 定义的树彼此相关。

在具有 FieldA、FieldX、FieldS 和 FieldT 的可视化项中，对于应该使用哪个树来关联它们，存在太多的信息。如果不修剪信息，Tableau 就无法评估是通过基表 A 的树还是基表 B 的树来关联这些字段。

尽管存在多个_活跃_关系，但 FieldS 和 FieldT 被视为不相关。

![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_fields_ambiguous_hyperrelated.png "过度相关")

这些模糊相关字段被评估为不相关，因为 Tableau 无法清楚地确定它们的关系路径。与只能拼接的真正不相关的字段不同，模糊相关的字段可以被解析并且字段可以直接相关。

### 共享表中不明确的度量

当从共享表使用维度时，它会将来自其不相关的上游表的字段拼接在一起。但是度量不能拼接，并且度量的值取决于其相关维度。

在具有 DimensionA 和 DimensionX 的可视化项中，这两个维度是不相关的。如果 MeasureS 是从 Table S 中取出的，则它与 DimensionA 和 DimensionX 的组合不相关。虽然它可以独立地与其中任一个相关，但它不能同时在同一个可视化项中与它们两者相关。

![不相关的基表 A 和 X 通过其共享表 S 拼接在一起](/tableau/next/zh-cn/online/zh-cn/Img/mfr_relatedness_fields_stitching.png)

共享度量可被视为一种模糊性或过度相关性，并以相同的方式解析。

### 解析字段之间不明确的关系

每当不确定如何关联字段时，Tableau 不会做出任意决定，而是将它们视为不相关。通过澄清使用哪个树的不确定性来关联这些字段通常更好。

通过添加一个字段来确定使用哪个树来解析沿未相关的字段。通过移除字段来确定使用哪个树来解析模糊相关的字段。

_示例：_

**解析尚未相关**：添加一个字段

- 在 FieldS 和 FieldT 的可视化项中，将表 A、B 或 C 中的字段添加到可视化项会使基表 A 的树处于活动状态，并解决 FieldS 和 FieldT 之间的所需路径。
- 或者，使用表 X 中的字段将 FieldS 和 FieldT 之间的所需路径解析为基表 X 的树。

**解析模糊相关**：移除一个或多个字段

- 在 FieldA、FieldX、FieldS 和 FieldT 的可视化项中，移除 FieldX 只会使基表 A 的树处于活动状态，并解析 FieldS 和 FieldT 之间的所需路径。
- 或者，移除 FieldA 可通过基表 X 的树解析 FieldS 和 FieldT 之间的所需路径。

**解析共享度量**：移除一个或多个字段

- 在 DimensionA、DimensionX 和 MeasureS 的可视化项中，移除 DimensionX 只会使基表 A 的树处于活动状态，并解析 DimensionA 和 MeasureS 之间的所需路径。
- 或者，移除 DimensionA 可通过基表 X 的树解析 DimensionX 和 MeasureS 之间的所需路径。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"><col style="width: 25%;"></colgroup><tbody><tr><td style="text-align: center;" rowspan="2"><b>尚未相关</b></td><td style="text-align: center;" rowspan="2"><b>模糊相关</b></td><td colspan="2" style="text-align: center;"><b>相关性性解析为单一树</b></td></tr><tr><td style="text-align: center;">通过基础表 A 相关</td><td style="text-align: center;">通过基表 X 相关</td></tr><tr><td style="text-align: center;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_not-yet_hyporelated.png" alt="相关性较低"></td><td style="text-align: center;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_ambiguous_hyperrelated.png" title="过度相关" alt=""></td><td style="text-align: center;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_context_a.png" alt="通过 A 相关"></td><td style="text-align: center;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_context_x.png" alt="通过 X 相关"></td></tr></tbody></table>

解析不确定性类似于使用 FIXED 详细级别 (LOD) 表达式。在 FIXED LOD 表达式中，您可以通过定义维度声明来告诉 Tableau 要聚合到哪个详细级别。通过改变可视化项的结构使只有一个树处于活动状态，可以解析不确定性，从而告诉 Tableau 可以考虑哪些关系路径来执行分析。

### 拼接与解析不确定性

拼接和解析不确定性都是处理不相关性的方法，但它们的结果不同：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 50%;"><col></colgroup><tbody><tr><td><p>拼接</p></td><td><p>解析不确定性</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_stitching.png" alt="使用 S 拼接 A 和 X"><p><span class="caption">不相关的 FieldA 和 FieldX 通过 DimensionS 拼接</span></p></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_relatedness_fields_context_a.png" alt="用 A 解析 S 和 T"><p class="caption">通过基表 A 定义的树评估 FieldS 和 FieldT</p></td></tr><tr><td>基于共享属性并列不相关的字段</td><td>当有多个选项（模糊性或共享度量）时缩小要使用的关系路径，或当没有关系路径（尚不相关）时建立关系路径。</td></tr><tr><td><p>使用多基表逻辑来计算结果</p></td><td><p>使用单基表逻辑来计算结果</p></td></tr><tr><td>分析涉及不相关的表</td><td>分析涉及共享表</td></tr></tbody></table>

## 如何为相关性级别使用联接

确定字段级相关性后，Tableau 必须评估结果以创建实际的可视化项。用于计算可视化项中显示的值的查询依赖于联接。字段是相关、不相关还是拼接对执行的联接有不同的影响。请记住，在此上下文中，模糊相关和尚未相关的字段将被视为不相关。

为了解释相关性和联接，本部分将介绍表及其字段以及这些字段中的值。假设有以下具有两个基表（“Classes”（班级）和“Clubs”（俱乐部））和一个共享表（“Students”（学生））的数据模型。

![具有两个基表（“Classes”（班级）和“Clubs”（俱乐部））和一个共享表（“Students”（学生））的数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_model.png)

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col></colgroup><tbody><tr><td><p>Classes（班级）</p></td><td><p>Clubs（俱乐部）</p></td><td><p>Students（学生）</p></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_birds_table_classes.png" alt="查看班级表的数据，显示三个字段的值"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_birds_table_clubs.png" alt="查看俱乐部表的数据，显示三个字段的值"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_ex_birds_table_students.png" alt="查看学生表的数据，显示三个字段的值"></td></tr><tr><td><p>字段：</p><ul><li><b>Classes（班级）</b>：一个维度，其值为“Nesting Basics”（筑巢基础）、“Advanced Songs”（高级歌曲）、“Flying for Fledglings”（雏鸟飞行）和“Alarm Calls 101”（报警电话 101）</li><li><b>Length（长度）</b>， 一个度量</li><li><b>Student（学生）</b>，用于与“Student”（学生）表关联的维度</li></ul></td><td><p>字段：</p><ul><li><b>Clubs（俱乐部）</b>，一个维度，其值为“Photography”（摄影）、“Travel”（旅行）、“Juggling”（杂耍）、“Art”（艺术）和“First Aid”（急救）</li><li><b>Dues（会费）</b>， 一个度量</li><li><b>Student（学生）</b>，用于与“Student”（学生）表关联的维度</li></ul></td><td><p>字段：</p><ul><li><b>Bus Rider（巴士乘客）</b>，一个维度，其值为“yes”（是）或“no”（否）</li><li><b>Student（学生）</b>，一个维度，其值为“Finch”（雀类）、“Cardinal”（红衣凤头鸟）、“Sparrow”（麻雀）、“Robin”（Robin） 和“Jay”（松鸦）。用于与其他两个表关联</li><li><b>Age（年龄）</b>， 一个度量</li></ul></td></tr></tbody></table>

这个非常简单的模型说明了如何计算多事实关系数据模型的高级联接逻辑。有关基于关系构建的单基表数据模型中使用的联接基础知识的详细信息，请参见[分析如何适用于使用关系的多表数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_multitable_analysis_overview.htm)。

这个例子是否应该是一个有多个基表的数据模型？

对于这个三表数据模型，将其设置为单基表模型（如班级-学生-俱乐部或俱乐部-学生-班级）或以学生作为基表可能会很有吸引力。通常，多事实关系数据模型适用于特定类型的数据架构或分析场景。如果您的数据模型[具有最适合多事实关系数据模型的特征](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_when_to_use.htm)，通过这种方式进行设置可以使您的基表在概念上保持不相关。但是，如果您的数据不需要这种类型的结构，则单基表模型会更易于使用。

![班级-俱乐部-学生示例模型的替代数据模型结构](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_model_versions.png)

可以为这三个表构建模型：（1）以“Classes”（班级）和“Clubs”（俱乐部）为基表，以“Students”（学生）为共享表；（2）线性建模，以Classes”（班级）或“Clubs”（俱乐部）开始；（3）以“Students”（学生）为单个基表，以“Classes”（班级）和“Clubs”（俱乐部）为下游表。

在这种特定情况下，这些表、数据或模型并不真正需要多个基表。我们使用好像模型作为示例，以使其保持简单，从而可以将重点放在联接逻辑上。或者您可以想象还有另一个相关的表（“Rooms”（房间）），我们只是忽略它以避免使讨论过于复杂。

![班级-俱乐部-学生模型的一个版本，带有额外的共享表（房间）](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_model_withroom.png)

然而，作为最佳实践，仅当您的数据需要时才使用多事实关系模型。

### 相关维度使用内部联接

相关维度是内部联接的。内部联接会删除两个表之间不共享的任何维度值。

- Tableau 使用额外的逻辑来确保度量值不会丢失。本部分仅使用维度来演示 Tableau 如何将内部联接应用于相关维度的基础知识。

以下示例显示相关维度如何仅返回数据中存在的行。由于没有学生参加“Alarm Calls 101”（报警电话 101）课程，因此结果中不存在该课程。Cardinal 和 Jay 没有参加任何课程，因此他们没有出现在结果中。

![显示了“Classes”（班级）和“Students”（学生）的内部联接的可视化项，其中有两行用于“Finch”（雀科）（“Advanced Songs”（高级歌曲）、“Nesting Basics”（筑巢基础）），两行用于“Robin”（知更鸟）（“Flying for Fledglings”（雏鸟飞行）、“Nesting Basics”（筑巢基础）），两行用于“Sparrow”（麻雀）（“Advanced Songs”（高级歌曲）、“Nesting Basics”（筑巢基础））](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_relateddims_innerjoin.png)

### 不相关的维度使用交叉联接

不相关的维度（单独的、没有拼接维度）是交叉联接的。

在交叉联接中，一个维度中的每个值都会与另一个维度中的每个值进行组合，即使结果组合实际上并不存在于数据中。在此示例中，交叉联接为“Classes”（班级）和“Clubs”（俱乐部）的每种可能组合添加一行。

![一个可视化项，显示了“Classes”（班级）和“Clubs”（俱乐部）的交叉联接，其中行代表“Advanced Songs”（高级歌曲）/“Alarm Calls 101”（报警电话 101）/“Flying for Fledglings”（雏鸟飞行）/“Nesting Basics”（筑巢基础）与“Art”（艺术）/“First Aid”（急救）/“Juggling”（杂耍）/“Photography”（摄影）的每个组合。“行”功能区上的两个维度胶囊上都显示了不相关图标](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_unrelateddims_crossjoin.png)

认识到分析中何时发生交叉联接非常重要。尽管在交叉联接的结果表中有一行“高级歌曲 + 急救”，但实际上没有学生参与这种活动组合（我们将在下一部分的拼接示例中看到这一点的证明）。

为什么认识到并非所有交叉联接接结果都基于数据很重要？想象一下，您试图制定课程和俱乐部的时间表，以免任何学生出现冲突情况。高级歌曲和急救课上没有学生，所以您可以忽略这个结果，同时安排该课程和俱乐部。交叉联接并不代表数据中实际存在的值的组合。

此外，当基数较高（大量唯一值）时，交叉联接可能会影响性能。想象一下将每个电话号码与联系人中的每个电子邮件地址交叉联接的情况。这会造成组合的巨大爆炸式增长，并且可能产生高昂的成本。

### 拼接维度使用外部联接

不相关的维度（在存在拼接维度的情况下）是外部联接的。

在此示例中，“Classes”（班级）表和“Clubs”（俱乐部）表都与共享的“Students”（学生）表相关，但彼此不相关，因此“Classes”（班级）和“Clubs”（俱乐部）字段不相关。添加“Students”（学生）维度可以让 Tableau 知道在分析中应该将“Classes”（班级）中的哪些值与“Clubs”（俱乐部）中的哪些值并列。我们称之为外部联接行为_拼接_。

![一个可视化项，显示了学生-班级内部联接和以及学生-俱乐部内部联接的外部联接结果。“行”功能区上的“Classes”（班级）和“Clubs”（俱乐部）胶囊上有一个不相关图标。“Students”（学生）胶囊位于“标记”卡的“颜色”属性上，并且没有不相关图标。并非所有班级和俱乐部的组合都有显示，并且有几行代表没有班级的学生和俱乐部](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_stitched_outerjoin.png)

拼接与数据混合的相似之处在于，将中间结果重新组合在一起以获得总体结果。然而，与混合不同的是，拼接是外部联接，而不是左联接，并且不会从任何一侧删除值。当所有数据源都为一个时，就没有主要数据源或次要数据源的概念，因此两个不相关的字段都具有同等的优先级。

#### 中间结果是外部联接的

拼接字段的外部联接中包含什么？依次为拼接字段和每个不相关的字段计算中间内联接，然后基于拼接维度的值对这些中间结果进行外部联接。

**示例**

“Students”（学生）和“Classes”（班级）的内部联接...

![三个学生值和三个班级值的结果表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_stitched_inner1.png)

...以及“Students”（学生）和“Club”（俱乐部）的内部联接...

![四个学生值和五个俱乐部值的结果表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_stitched_inner2.png)

...然后在“Students”（学生）上进行外部联接。

![四个学生值、三个班级值和五个俱乐部值的结果表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_stitched_outerjoin.png)

### 保留度量的附加联接

除了维度的联接逻辑之外，度量还可以引入额外的联接。当 Tableau 首次引入关系时， [核心原则之一是度量值不会丢失](https://www.tableau.com/zh-cn/blog/relationships-tableau-data-model)。这也在多事实关系数据模型中得到维护。

基本细节如下：

- 度量值仅按相关维度细分。
- 对于不相关的维度，度量值会重复。
- 如果有相关的度量值与之关联，则可能会返回在仅有维度的可视化项中删除的维度值。

**注意**：请记住，度量是聚合 — 它们是在可视化项中的维度组合所设置的详细级别（粒度）上计算的。这称为度量按维度_细分_。当使用没有任何维度的度量时，它被称为 _表范围_的度量。这意味着该度量的值是完全聚合的值。一旦我们在可视化项中使用维度，度量就会根据维度值更细化地细分。因此，分析中度量的值取决于维度的上下文。

#### 相关度量

考虑在相关维度（**“Students”（学生）**和**“Classes”（班级）**）上进行内部联接所返回的维度值子集有_三个_学生值，分别是雀科、知更鸟和麻雀；以及_三个_班级值，分别是高级歌曲、筑巢基础和雏鸟飞行。

![学生和班级之间内部联接的结果表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_inner_student_class.png)

如果我们从“Classes”（班级）表添加**“Length”（长度）**度量，我们会看到所有_四个_班级都显示出来，并且有一个空值表示“Students”（学生）。每个班级**“Length”（长度）**显示在**“Classes”（班级）**级别。

![尽管维度是内部联接的，但对于学生仍显示为空值](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_related_measurefrombase.png)

如果我们改为通过“Students”（学生）表添加 **“Age”（年龄）**度量，我们看到显示了所有_五名_学生，并且班级有两个空值。结果保留了每个学生，即使他们不在同一个班级。每个学生**“Age”（年龄）**显示在**“Students”（学生）**级别。

![尽管维度是内部联接的，但仍为班级显示空值](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_related_measurefromshared.png)

#### 不相关的度量

对于不相关的维度值，度量值会重复。

如果我们查看“Classes”（班级）表中的**“Length”（长度）**度量和不相关的**“Club”（俱乐部）**维度，度量是表范围的，并在**“Club”（俱乐部）**的所有维度值中重复。

![在不相关的维度值中重复的表范围度量](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_unrelateddim-measure.png)

在存在拼接维度的情况下，度量既可以分解，也可以重复。

在这里，度量**“Age”（年龄）** 来自“Students”（学生）表，并细分到学生级别。每次学生根据**“Classes”（班级）**和 **“Club”（俱乐部）**的维度重复时，**“Age”（年龄）**值会重复。

![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_ex_birds_unrelateddims_sharedmeasure.png)

## 疑难解答

### 使用多事实关系数据模型时的注意事项

**针对每个表的数据提取筛选器**

多事实关系数据模型数据提取的所有数据提取筛选器都是针对每个表的（而非普遍的）。因此，实时连接和数据提取连接之间的筛选结果可能会有所不同。

**行级计算**

行级计算只能引用共享同一上游基表的字段。也就是说，不能跨树执行行级计算。

**合并字段**

合并字段中的所有字段必须共享一个上游表。也就是说，您不能使用不同树中的字段创建合并字段。

**集**

只能使用涉及共享相同上游基表的字段的定义来创建集。但是，在可视化项中，当标记由与用于定义集的字段不相关的字段定义时，可以从标记中使用“添加到集”选项。如果选择“添加到集”，Tableau 会仅将相关字段添加到集定义中。这与单基表数据源中的“添加到集”的行为不同，“添加到集”会添加定义标记的所有内容。

**验证 INCLUDE 详细级别表达式**

不能跨不相关的字段评估 INCLUDE LOD 表达式。由于字段之间的相关性是按工作表进行评估的，因此“数据”窗格或计算编辑器中可能存在有效的 LOD 表达式，但在特定可视化项的上下文中（存在不相关的维度）可能会变得无效。发生这种情况时，LOD 胶囊将变成红色。您可以更新 LOD 表达式以移除不相关的字段冲突、更改可视化项的结构，或从可视化项中移除 LOD 表达式。

**更新已发布数据源**

作为最佳做法，如果您计划将现有已发布数据源修改为多事实关系数据模型（但并非所有连接的工作簿都需要新的数据模型），请创建现有已发布数据源的副本。除非所有工作簿都需要新表，否则不要更新数据源的现有版本。将修改后的数据源发布为新数据源并从中创建新的工作簿。当现有工作簿不需要该功能时，这将阻止其转换为使用 VDS 而不是数据服务器，从而避免潜在的性能影响。

### 已解决的问题

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 60%;"><col></colgroup><tbody><tr><td><b>已解决的问题</b></td><td><b>修复截止日期</b></td></tr><tr><td><p><b>数据提取</b></p><p><i>本地数据源（在工作簿中）：</i>尝试提取多事实关系数据源将出现“No such table”（没有这样的表）错误。</p><p><i>已发布数据源：</i>提取已发布的多事实关系数据源似乎成功，但字段值可以交换。</p></td><td rowspan="3"><ul><li><a href="https://www.tableau.com/zh-cn/support/releases/online">Tableau Cloud</a> ：截至 7 月中旬更新已解决。这也适用于 <a href="https://public.tableau.com/app/discover">public.tableau.com</a>。</li><li><a href="https://www.tableau.com/zh-cn/support/releases"><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span></a>：截至 2024 年 7 月 24 日发布的维护版本 2024.2.1 已解决</li><li><a href="https://www.tableau.com/zh-cn/support/releases/server">Tableau Server</a>：截至 2024 年 7 月 24 日发布的维护版本 2024.2.1 已解决</li></ul><p>如果您在 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 Tableau Server 中仍然看到这些问题，请升级到 2024 年 7 月 24 日或更高版本。</p></td></tr><tr><td><p><b>EXCLUDE 详细级别表达式</b></p><p>仅当存在不相关字段时才应验证 INCLUDE LOD。然而，在相同条件下，EXCLUDE LOD 也可能被错误地标记为无效。</p></td></tr><tr><td><p><b>嵌套用户计算</b></p><p>嵌套用户计算在具有多事实关系数据模型的已发布数据源中不可用。</p></td></tr></tbody></table>

### 已知问题

**具有多个“标记”卡的相关性指标**

当在“行”功能区或“列”功能区上使用多个度量构建可视化项时，每个度量都会获得自己的“标记”卡。用于确定相关性指标（不相关图标、工具提示中的文本以及相关性警告对话框）的逻辑可能不会给出预期的结果，具体取决于打开的“标记”卡。但是，可视化项本身是根据每对字段的相关性正确计算的。我们已经计划修复此行为。

**BatchQueryProcessor**

必须启用 BatchQueryProcessor 才能支持多事实关系数据模型。这是预期行为，目前没有计划修复。

**Tableau Pulse**

Tableau Pulse 可能不适用于多事实关系数据模型。您可能无法创建指标定义，或者创建的任何指标可能都是空白的。这不是预期的行为，但目前还没有计划修复。

**使用参数更改维度**

Tableau 可让您[使用参数交换字段](https://help.tableau.com/current/pro/desktop/zh-cn/parameters_swap.htm)。但是，对于多事实关系，用参数交换维度将失败，并且不会出现任何提示。可以创建参数及其计算，并且可以显示参数控件，但参数更改时字段不会更改。在评估维度的相关性以及按操作顺序评估参数时，会出现这种情况。

<!-- document id=9ac25525373d21ce216d1b4739925c6766043631176d68f57f17ff574e470bc9 url=/tableau/next/zh-cn/online/extracting_upgrade.md -->

[跳转到主要内容](#main-content)

# 数据提取升级为 .hyper 格式

在 Tableau 版本 2018 中，我们引入了 `.hyper` Tableau 数据提取格式以替换旧的 `.tde` 格式。自 2018 年以来，`.hyper` 格式一直是 Tableau 用于创建数据提取的标准格式，现在大部分数据提取都是 `.hyper` 文件。从 2023 年初开始，Tableau 将停止在 Tableau Cloud 和 Tableau Public 上支持 `.tde` 格式。有关此次弃用的更多详细信息，请参见 [Tableau 社区文章](https://community.tableau.com/s/feed/0D54T00001BHiGwSAL)。

## 停止支持 .tde 文件

从 2023 年开始，`.tde` Tableau 数据提取格式已弃用。此格式在 2018 年被替换为 `.hyper` 格式，但在 2023 年 3 月之前对上载的文件仍然有效。

- 自 2023 年 3 月起，此更改适用于 Tableau Cloud 和 Tableau Public。
- 从 Tableau Server 版本 2023.1.0 开始，已禁用上载 `.tde` 格式文件。
- 2024.2 是支持任何基于 .tde 的工作簿、数据源或书签的 Tableau Desktop 的最后一个版本。版本 2024.3 及更高版本仅支持 .hyper 格式。

## 使用 Tableau Desktop 手动升级 .tde 数据提取

如果在本地管理数据提取，您可以使用 Tableau Desktop 手动将 `.tde` 数据提取升级为 `.hyper` 数据提取。

**注意**：此功能仅在 Tableau Desktop 版本 2024.2 及更低版本中可用。

1. 在 Tableau Desktop 中，打开使用 `.tde` 数据提取的工作簿。
2. 从“数据”菜单中选择数据提取数据源，然后选择“数据提取”\>“升级”。
3. 选择“文件”\>“保存”，该操作将保存工作簿，并同时完成数据提取升级。

<!-- document id=b5d704aabdc16a0ad019763664266a505b8756286f3d17b716081a386ffc84ba url=/tableau/next/zh-cn/online/ipa_vconn_about_data_policy.md -->

[跳转到主要内容](#main-content)

# 关于数据策略

当您想要将行级安全性应用于连接中的一个或多个表时，请使用数据策略。数据策略适用于实时连接和数据提取连接。

数据策略有三个主要组成部分：

![数据策略的三个组成部分的示例](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_policy_components.png)

1. 应用该策略的表称为策略表。这些表是经过筛选的表。
2. 定义表之间（例如，权利表和事实表之间）以及表列和策略列之间关系的映射字段。策略列是用于筛选数据的列。
3. 策略条件，它是在查询时针对每一行进行计算的表达式。当为 TRUE 时，该行显示在查询中。

若要开始操作，请单击 ![“创建新策略”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Create_New_Policy_btn.png)。

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_rlspolicy.htm)

## 相关任务

[关于虚拟连接编辑器](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_editor.htm)

[将表添加到连接](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_add_tables.htm)

[创建和测试数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_create_data_policy.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=5b6a7cb194140e18331c849e84aa6735652757a458288ab64d92707aca7bf452 url=/tableau/next/zh-cn/online/prep_conductor_workspace.md -->

[跳转到主要内容](#main-content)

# 关于流程工作区

发布流程后，您可以在 Tableau Cloud 中计划任务或链接任务（版本 2021.3 及更高版本），以便定期自动运行您的流程，从而使您的输出数据保持最新。您也可以随时手动运行流程（不需要 Data Management）。

Tableau Prep Conductor 利用在 Tableau Cloud 中通过 Tableau Desktop 管理工作簿或数据源可能看到的许多相同功能来管理流程。例如，就像数据提取刷新一样，计划流程任务和按需流程运行作为后台任务进行排队。但是在使用流程时，则存在一些差异。

## “流程概述”页面

流程“概览”页面是主要的登录页面，您可以在其中查看有关流程的数据并且计划、监视和维护流程。如果没有 Data Management，您将有不同的选择。

单击列表中的流程打开流程“概览”页面。您可以从“内容”\>“探索”\>“所有流程”中或通过打开包含您的流程的项目来导航。

![Tableau Prep 流程概述页面。](/tableau/next/zh-cn/online/zh-cn/Img/prep_parameters_flow_overview.png)

1. 标题列出了流程的名称、流程所有者和流程的上次修改日期。从版本 2020.4 开始，单击“编辑”以编辑现有流程。
    
    将流程添加到您的收藏夹，或者，从“更多操作”![“更多选项”菜单选项由 3 个点表示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_rmoremenu.png)菜单中，您还可以编辑、运行、下载流程、设置权限、更改流程所有者、还原以前的流程版本等。
2. 查看和编辑流程描述，并设置标签以帮助其他人找到所查找的流程。
3. 查看流程的输出步骤以及应用于流程的任何参数（版本 2021.4 及更高版本）、上次更新的状态、输出分配到的任何计划以及上次流程运行的任何错误。您也可以单击“运行”![显示为圆圈内向右的箭头的“运行流程”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_run_button.png)按钮以按需运行所有输出步骤或单个输出步骤。
    
    <table style="width: 100%;" class="simple-table"><colgroup><col><col></colgroup><tbody><tr><td><span class="uicontrol">参数</span></td><td><p>如果流程包含用户参数，则显示流程中上次运行的参数值，您可以在<span class="uicontrol">“输出”</span>列中看到所有生成的输出。运行流程时，系统会提示您输入参数值。</p><p>系统参数（版本 2023.2 及更高版本）在流程运行时自动生成，系统参数的类型显示在<span class="uicontrol">“参数”</span>列中。若要查看应用于流程的最后一个系统参数值，请编辑流程。</p><p>有关在流程中使用参数的详细信息，请参见 Tableau Prep 帮助中的<a href="https://help.tableau.com/current/prep/zh-cn/prep_parameters.htm" target="_blank">在流程中创建和使用参数</a>。</p></td></tr><tr><td><span class="uicontrol">状态</span></td><td>流程成功运行后，作为数据源的输出将变为链接，您可以单击这些链接打开<span class="uicontrol">“数据源”</span>页面，以查看有关数据源的更多信息或编辑流程输入连接。</td></tr><tr><td><span class="uicontrol">计划</span></td><td><p>在<span class="uicontrol">“计划”</span>字段中，查看输出步骤分配到的计划任务。一个流程输出可以分配给一个或多个任务。</p><p>如果尚未分配任何计划，请单击<span class="uicontrol">“创建新任务”</span>以将输出步骤添加到计划。若要立即运行流程以更新特定输出步骤，请单击行左侧的<span class="uicontrol">“运行”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_server_run_button.png" alt="显示为圆圈内向右的箭头的“运行流程”按钮。">按钮。</p></td></tr><tr><td><span class="uicontrol">错误</span></td><td><p>如果流程有错误，则流程运行将失败。通过导航到流程的<span class="uicontrol">“连接”</span>选项卡并编辑输入连接，可以直接解决连接错误。</p><p>若要解决任何其他流程错误，请编辑该流程，然后重新发布流程并尝试再次运行它。如果您使用的是早期版本的 Tableau Prep Builder，则从<span class="uicontrol">“更多操作”</span><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/prep_server_rmoremenu.png" alt="“更多选项”菜单选项由 3 个点表示。">菜单，您还可以在 Tableau Prep Builder 中下载并打开流程，然后重新发布流程并再次尝试运行它。</p></td></tr></tbody></table>
4. 查看流程的图像。

### 没有 Data Management 的“流程概览”页面

如果服务器上未安装 Data Management，您仍然可以将流程发布到 Tableau Cloud，但可用于管理流程的选项较少。

![Tableau Prep 连接。](/tableau/next/zh-cn/online/zh-cn/Img/prep_webauth_no_dm_addon.png)

## “流程概览”页面

查看流程的输入和输出位置、连接类型、身份验证设置、输入和输出步骤以及任何连接错误。您可以在发布流程时设置身份验证设置。有关详细信息，请参见[发布流程](https://help.tableau.com/current/prep/zh-cn/prep_conductor_publish_flow.htm)。

对于数据库输入类型，单击输入连接的“更多操作”![“更多选项”菜单选项由 3 个点表示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_rmoremenu.png)菜单以编辑连接并更改服务器名称、端口、用户名和密码。

![Tableau Prep 中的连接类型及其来源的表格。](/tableau/next/zh-cn/online/zh-cn/Img/prep_serverconnections.png)

## “流程计划任务”页面（需要 Data Management）

查看流程分配到的任何计划、包括在这些计划中的输出以及应用于水族中的所有参数（版本 2021.4 及更高版本）。作为管理员，您可以单击计划链接打开“计划”页面并查看分配给该计划的流程列表。有关为计划分配流程的详细信息，请参见 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/prep_conductor_online_schedule_flow_task.htm) 或 [Tableau Server](https://help.tableau.com/current/server/zh-cn/prep_conductor_schedule_flow_task.htm) 帮助中的“计划流程任务”。

若要查看计划的输出或分配给链接任务的任务（版本 2021.3 及更高版本），请单击“计划类型”列中的链接。

您还可以从通过此页面添加新任务或管理现有任务。若要对现有任务执行操作，请选中任务卡上的复选框，然后单击“操作”下拉菜单以运行、编辑或删除任务。

如果流程任务连续 5 次尝试运行失败，则流程将自动挂起。

您可以在“概览”选项卡和此选项卡上看到该状态。您可以通过此菜单恢复挂起的任务。

有关挂起的流程任务的详细信息，请参见[查看和解决错误](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_monitor_flow.htm#View_Errors)。

**注意**：流程的“计划任务”页面已在版本 2021.3 中重新设计。根据您的服务器版本，您的视图可能会有所不同。

![已选中“计划任务”选项卡的“流程”页面](/tableau/next/zh-cn/online/zh-cn/Img/prep_parameters_scheduled_tasks.png)

## “计划”页面

在“计划”页面上，您可以查看分配给计划的流程以及有关流程运行的详细信息。如果计划包括链接任务（版本 2021.3 及更高版本），则会显示链接任务中包括的流程数。

您可以按需运行计划并运行分配给它的所有流程。您还可以选择一个或多个流程，然后使用“操作”菜单更改流程计划或优先级、从计划中删除选定的流程或恢复挂起的流程。

![显示流程详细信息的表格，包括优先级、状态、上次运行、下次计划运行和错误。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_schedules_page.png)

## 流程运行历史记录（需要 Data Management）

查看、搜索和排序流程的历史运行列表。此页面还包含有关流程运行的详细信息，例如运行类型、应用于每个流程运行中包含的流程的参数值（版本 2021.4 及更高版本）、持续时间和生成的行数。

如果流程输出有错误，请将鼠标悬停在错误上以查看消息。如果适用，请单击错误消息中的“转到连接”链接以导航到“连接”页面以修复连接错误。您还可以直接编辑流程以修复任何错误，或单击“下载流程”以在 Tableau Prep Builder 中下载并修复流程错误，然后重新发布流程以继续使用 Tableau Prep Conductor 对其进行管理。

**注意**：除非删除流程，否则流程的运行历史记录将持续存在。

![选择了“运行历史记录”选项卡，“错误”列显示有关错误的消息。](/tableau/next/zh-cn/online/zh-cn/Img/prep_parameters_run_history.png)

## 流程修订历史记录

如果您需要将流程恢复到以前的版本，请从流程的“更多操作”![“更多选项”菜单选项由 3 个点表示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_rmoremenu.png)菜单中，选择“修订历史记录”。在“修订历史记录”对话框中，从列表中选择要恢复到的流程版本。

![“修订历史记录”表格，其中包含恢复修订的选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_revisionhistory.png)

## 谁可以执行此操作

服务器管理员可以激活 Data Management 许可证密钥。

服务器管理员可以启用 Tableau Prep Conductor。

Creator 可以手动创建、编辑和运行流程。如果安装了 Data Management，Creator 可以按计划运行流程。

<!-- document id=0d27695a7d95950d03529dcbe76a37ede9f27e220f7184de11b527251d158a88 url=/tableau/next/zh-cn/online/dm_vconn_overview.md -->

[跳转到主要内容](#main-content)

# 关于虚拟连接和数据策略

虚拟连接是一种 Tableau 内容类型，连同数据源、工作簿和流程一起、可帮助您查看和理解数据。虚拟连接为数据提供了一个中央访问点。虚拟连接引入的另一个关键特性是数据策略，它支持连接级别（而不是工作簿或数据源级别）的行级安全性。行级安全性数据策略应用于任何使用虚拟连接的工作簿、数据源或流程。

虚拟连接可以访问多个数据库中的多个表。虚拟连接使您可以在连接级别集中管理提取数据和安全性。

![图表显示了虚拟连接如何集中管理连接和安全性](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_diagram_centralized.png)

有关行级安全性选项的信息，请参见[Tableau 中的行级安全性选项概述](https://help.tableau.com/v0.0/online/zh-cn/rls_options_overview.htm)。

并非每个虚拟连接都有关联的数据策略。您还可以将虚拟连接简单地用作管理连接凭据的中心位置。

## 关键术语

- 虚拟连接。提供数据的中央访问点的可共享资源。
- 连接。用于访问数据的服务器名称、数据库和凭据。一个虚拟连接有一个或多个连接。每个连接访问一个数据库或文件。
- 虚拟连接表。虚拟连接中的一个表。
- 数据策略。一种应用于虚拟连接中的一个或多个表以筛选用户数据的策略。例如，使用数据策略将行级安全性应用于虚拟连接中的表。
- 策略表。数据策略中已筛选的事实或数据表。
- 策略列。用于筛选策略表中数据的列。策略列可以在策略表或权利表中。
- 权利表。一个表，其中包含可用于筛选策略表的策略列，以及可关联（映射）到策略表中的列的另一列。
- 策略条件。在查询时针对每一行求值的表达式或计算。如果策略条件为 TRUE，则该行将显示在查询中。

## 为虚拟连接和数据策略授予许可

虚拟连接和数据策略通过 Data Management 获得许可。有关 Data Management 许可的工作方式的信息，请参见[许可 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_license.htm)。

## 启用虚拟连接和数据策略

使用 Data Management 在 Tableau Server 和 Tableau Cloud 上自动启用虚拟连接和数据策略。

## 权限

虚拟连接的权限的工作方式与其他 Tableau 内容的权限非常相似。发布虚拟连接后，任何人都可以查看该连接。但是，只有连接创建者和管理员才能访问使用该连接的数据，直到连接创建者明确授予更多权限为止。

创建虚拟连接时，您必须设置“连接”能力的权限，以允许其他用户使用虚拟连接来连接到数据。“连接”能力允许您共享一个虚拟连接，并允许用户查询它。使用连接权限，用户可以查看虚拟连接中的表，并使用这些表创建内容。有关详细信息，请参见[设置虚拟连接的权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_publish_save.htm#set-perms)。

### 权限与数据策略

权限定义了一个人可以或不能对 Tableau 中的一段内容执行的操作。权限由能力（即执行像查看内容、Web 編輯、下载数据源或删除内容这样的操作的能力）组成。权限规则定义允许或拒绝用户或组对一段内容使用的能力。许可证级别、站点角色和潜在的多个权限规则之间的相互作用是最终确定用户可以做什么或不可以做什么（即他们的有效权限）的因素。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

数据策略筛选虚拟连接中的数据，确保用户只看到他们应该看到的数据。在 Tableau 内容（例如，工作簿或流程）中查看数据时，将应用数据策略并筛选数据。数据策略中的策略条件是定义数据访问权限的计算或表达式。用户函数通常用于将访问权限限制到用户或组。访问权限可能基于用户名、用户所属的组或区域值。有关详细信息，请参见[为行级安全性创建数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_rlspolicy.htm)。

权限和数据策略都控制着访问。简而言之，权限决定了您可以查看、访问、使用或创建哪些_内容_；数据策略确定您可以查看哪些_数据_。

#### 权限和数据策略如何协同工作

Tableau 权限首先应用于 Tableau 内容。人们只能做他们有能力处理 Tableau 内容的事情 — 数据策略不会覆盖 Tableau 权限。评估权限后，应用数据策略，根据策略条件确定用户可以看到虚拟连接中的哪些数据。

以下示例描述了权限和数据策略对包含工资数据的虚拟连接的影响：

- 虚拟连接位于 HR 项目中，仅限 HR 组中的 Tableau 用户使用。HR 组之外的任何人都无法查看 HR 项目中的内容，这意味着他们无法浏览、连接或查看虚拟连接。
- 虚拟连接具有仅授予 HR 业务合作伙伴组成员的“连接”权限。HR 组中的所有其他人都可以看到虚拟连接存在，但他们无法查看其中包含的数据。当他们查看使用该虚拟连接的工作簿时，他们看不到任何数据。
- 虚拟连接还包含一个数据策略，该策略根据个人用户筛选工资数据，因此 HR 业务合作伙伴只能看到与其业务部门中的员工相关的行。当他们查看使用该虚拟连接的工作簿时，他们只会看到其业务部门的数据。

## 特性和功能

对于数据管理器，虚拟连接提供：

- **安全管理的服务帐户。**如果您使用“服务帐户”模型，现在不必与任何想要访问该数据的用户共享该服务帐户信息，而是可以将服务帐户凭据提供给有权创建虚拟连接的少数分析师。
- **敏捷的物理数据库管理。**您必须仅在虚拟连接中对数据库进行一次更改（例如，添加字段或更改表名），而不是在使用数据的每一段内容中进行更改。
- **减少数据扩散。**通过集中管理数据提取刷新计划，只要计划刷新一次，就可确保从该虚拟连接访问数据的任何人都能看到新数据。
- **集中式行级安全性。**您可以创建数据策略，将行级安全性应用于连接级别的 Tableau 数据提取和实时查询。数据策略应用于使用虚拟连接的任何工作簿、数据源或流程。

**注意：**数据策略对流程输入数据有效，但对流程输出数据无效。有权访问流程输出数据的用户将看到所有数据，而不仅仅是仅与他们相关的数据子集。

作为数据用户，您可以从虚拟连接中受益，因为您知道将能获得：

- **适当的访问权限**，以便仅访问您应该看到的数据，因为已向数据应用了行级安全性。
- **灵活性**，可使用经过策划和保护的数据。虚拟连接存储并共享连接信息。您所要做的就是使用特定于您的需求的数据模型创建数据源。
- **信任**，相信数据是最新的，因为已经设置了数据提取刷新计划。
- 自由**共享**内容的能力，确保不会危及安全性，因为会始终强制执行数据策略。

## 虚拟连接编辑器工作流程

虚拟连接编辑器使您能够创建：

- 虚拟连接，这是一种 Tableau 内容类型，可提供可共享的数据中央访问点。
- 在连接级别支持行级安全性的数据策略。

创建虚拟连接及其关联的数据策略后，您可以发布它并设置权限以与其他共享。您还可以计划数据提取刷新，以便使用虚拟连接的所有内容都可以访问新数据。

下图显示了创建虚拟连接的工作流。在此过程中，您可以随时发布或保存连接的草稿，但必须先发布连接，然后才能计划数据提取刷新或者使用（或编辑）虚拟连接。您还必须设置权限，其他人才能使用该连接。

![创建虚拟连接的工作流图表](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_workflow_diagram.png)

单击流程中的一个步骤以转到该帮助主题。

## 后续步骤

第一步是[创建虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm)。

## 此部分中的其他文章

<!-- document id=eefd9adc25f9ab9b3261de4b4f2638d9a038afc5137f34791f48bc90ba394408 url=/tableau/next/zh-cn/online/ipa_vconn_about_editor.md -->

[跳转到主要内容](#main-content)

# 关于虚拟连接编辑器

使用以下功能集中和管理组织的数据访问：

- **虚拟连接** – 可重用的托管数据访问点。
- **数据策略** – 用于设置行级安全性。
- **集中数据提取** – 多次重用相同的数据提取。

使用虚拟连接编辑器创建虚拟连接和数据策略。下图显示了该过程：

![图中概述了创建虚拟连接和数据策略的过程](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_workflow_diagram.png)

若要开始操作，请选择一个数据库（如果需要）。然后，选择一个表并将其拖到“表”选项卡中。

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_overview.htm)

## 相关任务

[将表添加到连接](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_add_tables.htm)

[关于数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_data_policy.htm)

[创建和测试数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_create_data_policy.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=08cf8b68ab57dcdbd61d46c610b0a984b106e396ce26c00d303f0cb70cdd5ae7 url=/tableau/next/zh-cn/online/datasource_relationships_learnmorepage.md -->

[跳转到主要内容](#main-content)

# 关系与联接有何不同

关系是为分析合并来自多个表的数据的一种动态、灵活的方式。您无需为关系定义联接类型，因此在创建关系时将不会看到维恩图。

将关系视为两个表之间的协定。当您使用这些表中的字段构建可视化项时，Tableau 会从这些表中引入数据，使用该协定借助适当的联接生成查询。

- **没有预先选择的联接类型**。您只需要选择匹配字段来定义关系（[没有联接类型](#WhereAreJoins)）。Tableau 首先尝试基于现有键约束和匹配字段名称来创建关系。您可以随后检查以确保它们是要使用的字段，或者添加更多字段对以更好地定义表应如何关联。
- **自动和上下文感知**。关系根据分析的时间和上下文来延迟进行联接。Tableau 根据可视化项中使用的字段自动选择联接类型。在分析过程中，Tableau 会智能地调整联接类型，并在数据中保留本机详细级别。您可以在可视化项中字段的详细级别查看聚合，而不必考虑基础联接。您无需使用 LOD 表达式（例如 FIXED）来消除关联表中的重复数据。
- **灵活**。关系可以是多对多，并支持完全外部联接。使用关系合并表时，它类似于为每个可视化项创建自定义、灵活的数据源，所有这些都在工作簿的单个数据源中。由于 Tableau 仅基于可视化项中的字段和筛选器查询所需的表，因此可以构建可用于各种分析流程的数据源。

有关详细信息，请参见[关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm)和[不要害怕关系](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_dont_be_scared.htm)。

> [!TIP]
> 
> 联接仍可作为数据合并选项使用。双击逻辑表以转到联接画布。有关详细信息，请参见[在何处使用联接？](#WhereAreJoins)

**观看视频**：有关在 Tableau 中使用关系的简介，请观看这个时长 5 分钟的视频。

**注意**：本视频中显示的用于编辑关系的界面可能与当前版本略有不同，但具有相同的功能。

另请参见 [Action Analytics](https://action-analytics.com/library/) 中有关关系的视频播客，例如[为什么 Tableau 发明了关系？](https://action-analytics.com/ep-1-why-did-tableau-invent-relationships/)单击 [Library（库）](https://action-analytics.com/library/)中的“Video Podcast”（视频播客）以查看更多信息。

若要了解关系查询工作方式的相关信息，请参见以下 Tableau 博客文章：

- [关系，第 1 部分：在 Tableau 中引入新的数据建模](https://www.tableau.com/about/blog/2020/5/relationships-part-1-meet-new-tableau-data-model)
- [关系，第 2 部分：提示和技巧](https://www.tableau.com/about/blog/2020/5/relationships-part-2-tips-and-tricks)
- [关系，第 3 部分：跨多个相关表提出问题](https://www.tableau.com/about/blog/2020/6/relationships-part-3-asking-questions-across-multiple-related-tables)

## 关系和联接的特征

关系是为分析合并来自多个表的数据的一种动态、灵活的方式。我们建议使用关系作为合并数据的第一种方法，因为它使数据准备和分析更加轻松直观。[仅在绝对需要时才使用联接](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel_faq.htm#can-i-use-joins-between-logical-tables)。

以下是使用关系来合并表的一些优点：

- 使数据源更易于定义、更改和重用。
- 能够以正确的详细级别 (LOD) 跨多个表分析更轻松地分析数据。
- 无需使用 LOD 表达式或 LOD 计算在不同详细级别进行分析。
- 仅查询具有当前可视化项中所使用字段的表中的数据。

### 关系

- 显示为逻辑表之间的灵活关系线
- 需要您选择两个逻辑表之间的匹配字段
- 不需要您选择联接类型
- 使关联表中的所有行和列数据在数据源中可能可用
- 在数据源中和分析期间保留每个表的详细级别
- 在多个详细级别创建独立域。在数据源中，表不会合并在一起。
- 在分析期间，根据正在使用的字段自动创建相应的联接。
- 不会重复聚合值（当性能选项设置为“多对多”时）
- 保留不匹配的度量值（当性能选项设置为“某些记录匹配”时）

### 联接

联接是一种更静态的数据合并方式。联接必须在分析之前提前在物理表之间定义，并且不能在不影响使用该数据源的所有工作表的情况下进行更改。联接的表始终合并为单个表。因此，有时联接的数据会缺少不匹配的值，或重复聚合值。

- 在物理表之间显示时带有维恩图图标
- 需要您选择联接类型和联接子句。
- 联接的物理表将合并到具有固定数据组合的单个逻辑表中
- 可能会删除不匹配的度量值
- 如果字段处于不同的详细级别，则可能会导致聚合值重复
- 支持需要单个数据表的方案，例如数据提取筛选器和聚合

## 使用关系的要求

- 在关联表时，定义关系的字段必须具有相同的数据类型。更改“数据源”页面中的数据类型不会更改此要求。Tableau 仍将使用基础数据库中的数据类型进行查询。
- 不能基于地理字段定义关系。
- 数据模型中不支持循环关系。
- 无法定义已发布数据源之间的关系。

### 限制使用关联表的好处的因素

- 表中的脏数据（即创建时未考虑结构良好的模型且包含多个表中度量值和维度混合的表）可能会使多表分析更加复杂。
- 使用数据源筛选器将限制 Tableau 在数据中执行联接剔除的能力。联接剔除是定义 Tableau 如何通过移除不必要的联接来简化查询的术语。
- 具有许多跨关系的不匹配值的表。
- 在版本 2020.2 至 2024.1 中：将多个事实数据表与多个维度表相关联（尝试对共享或一致的维度建模）。在版本 2024.2 及更高版本中，您可以使用多事实关系来解决这些情况。有关详细信息，请参见[具有关系的多事实分析](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm#multifact-analysis)和[关于多事实关系数据模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_multiple_base_tables.htm)。

## 在何处使用联接？

您仍然可以在数据源的物理层中指定表之间的联接。双击逻辑表以转到物理层中的“联接/并集”画布并添加联接或并集。

每个顶层逻辑表至少包含一个物理表。打开逻辑表以查看、编辑或创建其物理表之间的联接。右键单击逻辑表，然后单击“打开”。或者，只需双击表即可将其打开。

![具有两个联接的数据模型。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_singletable_joins.gif)

创建数据源时，数据源有两个层。顶层是数据源的逻辑层。使用关系在逻辑层中的表之间合并数据。

下一个层是数据源的物理层。使用联接在物理层的表之间合并数据。有关详细信息，请参见[数据模型中的逻辑表和物理表](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm)。

![数据模型图显示一个由关系链接的两个表的逻辑层，以及一个说明如何从物理表构建逻辑表的物理层。](/tableau/next/zh-cn/online/zh-cn/Img/data_model_layers_sm.png)

<!-- document id=4ef03a5d7bf17a6e0c4ac2608219cbf6f5f70f30f6702ecbd40a2d59cab6dbe2 url=/tableau/next/zh-cn/online/dm_labels_custom_categories.md -->

[跳转到主要内容](#main-content)

# 具有自定义类别的标签

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

Tableau 提供多种数据标签（认证、质量警告和敏感性标签），涵盖多种数据分类方法。尽管如此，有时用户可能需要与其他用例相匹配的其他标签和类别。从 Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 开始，用户可以使用具有管理员定义的自定义类别的标签对资产进行分类。例如，管理员可以创建一个名为“部门”的类别，其中包含可供应用于资产的销售、服务和运营部门的标签。

具有自定义类别的标签需要启用了 Tableau Catalog 的 Data Management 许可证，并且可以附加到与其他数据标签相同类型的资产。但是，具有自定义类别的标签不会像数据质量警告和敏感度标签那样显示在下游资产上。

注意：如果您是想要创建自定义类别和标签的管理员，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

## 将带有自定义类别的标签附加到资产

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除具有自定义类别的标签，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

将带有自定义类别的标签附加到资产：

### 在 Tableau Cloud 和 Tableau Server 2024.2 及更高版本中

1. 搜索或导航到资产。导航步骤取决于您要添加标签的资产类型：
    - 数据源或虚拟连接 - 在“浏览”页面上，选择“所有数据源”或“所有虚拟连接”。
    - 虚拟连接表 - 在“浏览”页面上，选择“所有虚拟连接”，然后选择包含要认证的虚拟连接表的虚拟连接。然后选择虚拟连接表。
    - 数据库或表 - 在“浏览”页面上，导航到数据库或表。或在“外部资产”页面上选择“数据库和文件”或“表和对象”。
    - 列 - 在“浏览”页面上，导航到表。或在“外部资产”页面上选择“表和对象”并导航到表。然后在列表中找到该列。
2. 选择操作菜单 (...)，然后选择“数据标签”\>“所有数据标签”。
3. 选择对话框左侧与自定义标签类别对应的垂直选项卡。或者，如果您知道标签的名称，则可以在对话框顶部搜索它。
4. 选中要附加到资产的标签旁边的复选框。
5. 如果需要，输入要向用户显示的消息。您可以使用粗体、下划线和斜体来设置消息中文本的格式，并包含链接或图像。若要查看文本格式设置提示，请光标悬停在“保存”按钮上方的信息 (i) 图标上。
6. 为要添加的每个标签重复步骤 3 至 5。
7. 选择“保存”。  
    ![自定义类别选项卡上的“数据标签”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_data_labels_dialog_custom_category.png)

### 在 Tableau Server 2023.3 中

1. 选择资产旁边的操作菜单 (...)，然后选择“数据标签”\>“更多数据标签”。
2. 选择“标签”下拉列表。标签名称按标签类别排列，您可以滚动浏览它们。  
    ![在“更多数据标签”对话框中选择标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_custom_category_add_1_246.png)
3. 选择要附加的标签，然后选择“标签”下拉列表旁边的“添加” 。该标签出现在对话框右侧的“已应用标签”列表中。
4. 若要在此特定资产上添加可选标签消息，请选择“消息（可选）”列中的铅笔，然后选择“保存”。  
    ![在“更多数据标签”对话框中添加消息](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_custom_category_add_2_246.png)
5. 为要添加的每个标签重复步骤 2。
6. 添加完标签后，关闭对话框。（选择对话框右上角的 X 或选择对话框外部的某些内容以将其关闭。）

## 从资产中移除具有自定义类别的标签

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除具有自定义类别的标签，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

从资产中移除具有自定义类别的标签：

### 在 Tableau Cloud 和 Tableau Server 2024.2 及更高版本中。

1. 搜索或导航到资产。导航步骤取决于您要添加标签的资产类型：
    - 数据源或虚拟连接 - 在“浏览”页面上，选择“所有数据源”或“所有虚拟连接”。
    - 虚拟连接表 - 在“浏览”页面上，选择“所有虚拟连接”，然后选择包含要认证的虚拟连接表的虚拟连接。然后选择虚拟连接表。
    - 数据库或表 - 在“浏览”页面上，导航到数据库或表。或在“外部资产”页面上选择“数据库和文件”或“表和对象”。
    - 列 - 在“浏览”页面上，导航到表。或在“外部资产”页面上选择“表和对象”并导航到表。然后在列表中找到该列。
2. 选择操作菜单 (...)，然后选择“数据标签”\>“所有数据标签”。
3. 选择对话框左侧与自定义标签类别对应的垂直选项卡。或者，使用“选定标签”垂直选项卡查看附加到资产的所有标签。或者，如果您知道标签的名称，则可以在对话框顶部搜索它。
4. 取消选中要从资产中移除的标签旁边的复选框。
5. 为要移除的每个标签重复步骤 3 和 4。
6. 选择“保存”。

### 在 Tableau Server 2023.3 中

1. 选择资产旁边的操作菜单 (...)，然后选择“数据标签”\>“更多数据标签”。
2. 在对话框的“已应用标签”部分，选择要移除的标签所在行中的垃圾桶图标。  
    ![移除“更多数据标签”对话框中的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_custom_category_remove_246.png)
3. 为要移除的每个标签重复步骤 2。
4. 完成移除标签后，关闭对话框。（选择对话框右上角的 X 或选择对话框外部的某些内容以将其关闭。）

## 带有自定义类别的标签出现的位置

浏览 Tableau Cloud 和 Tableau Server 时，自定义标签会显示在资产上。

![表页面上显示的带有自定义类别的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_custom_category_masthead.png)

在 Web 制作中，您可以选择数据源或列，然后选择“目录详细信息”以查看其所有标签。

与质量警告和敏感度标签不同，具有自定义类别的标签不会出现在其所附加的资产的下游。例如，假设您的组织有一个名为“部门”的自定义标签类别，一个名为“销售”的自定义标签属于该类别。如果将“销售”标签附加到名为“订单”的表，则该标签仅显示在“订单”表上，而不显示在其下游的工作簿上。

## 谁可以添加自定义类别标签

若要将具有自定义类别的标签添加到资产（或从资产中移除标签），您必须

- 是服务器或站点管理员，或者
- 对资产具有“覆盖”能力。

## 使用自定义类别自定义标签

有关管理员如何创建或编辑“更多数据标签”对话框中显示的自定义类别和标签的信息，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

<!-- document id=ab9320df5a490e9c37a44e3245c6c916ac7aea9d01045af4931c0b364be8b319 url=/tableau/next/zh-cn/online/private_connect_setup_aws.md -->

[跳转到主要内容](#main-content)

# 出站专用连接设置：AWS

如[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)主题中所述，AWS 托管数据提供程序和 AWS 终端节点服务的设置各不相同。

有关数据提供程序的设置信息，请参见下面的相应子主题了解具体说明。

然后，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)主题。

## 此部分中的其他文章

<!-- document id=54a94483e28a4f80c2b18d0a58f133fe040fd7901efdf60b61140602ce3db052 url=/tableau/next/zh-cn/online/private_connect_setup_tableau_cloud.md -->

[跳转到主要内容](#main-content)

# 出站专用连接设置：Tableau Cloud

云管理员在 Tableau Cloud Manager (TCM) 中创建、编辑和删除专用连接。它们还将专用连接分配给站点，并可以向创建者和支持它们的组提供连接信息。

## 先决条件

- **已设置 AWS 端点服务和 AWS 托管数据提供程序。**有关设置 AWS 和 AWS 托管数据提供程序的信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)主题。
- **您是云管理员**，能够使用 Tableau Cloud Manager (TCM)。
- **您在“TCM 设置”中看到“私人连接”选项卡。**当您拥有带有 Enterprise 或 Tableau+ 许可版本的 Tableau Cloud，并且您至少有一个私人连接端点附加许可证时，“私人连接”选项卡将显示。
- **TCM 显示可用的专用连接容量。**在专用连接表上方，容量表示为 X/Y，其中 X 是当前专用连接数，Y 是最大数量。如果没有可用容量，请删除专用连接，或与您的 Tableau 客户经理讨论更多容量。
- **您知道 AWS 端点服务名称。**端点服务名称以“com.amazonaws.vpce”开头，看起来如下所示：`com.amazonaws.vpce.us-west-1.vpce-svc-0123456789abcdef0`。您也许能够获取端点服务名称，也可能需要依靠第三方来获取。具体取决于数据提供程序。有关详细信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下的主题。
- **您了解有关连接自定义地址的限额或要求。**有关详细信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下的主题。

### 创建专用连接

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 选择“创建”。

在“创建专用连接”对话框中：

1. 输入“名称”。云管理员和站点管理员可以看到专用连接名称。它对专用连接没有功能影响，但可以帮助管理员将此专用连接与其他连接区分开来。
2. （可选）输入“描述”。云管理员和站点管理员可以看到专用连接描述。它对专用连接没有功能影响，但可以帮助管理员区分不同的专用连接。
3. 选择“区域”。为您的 Tableau Cloud 站点选择区域。该区域还与 AWS 端点服务上允许作为主体的 IAM ARN 相匹配。对于与 Athena、Heroku Postgres 或 Teradata Vantage Cloud 的专用连接，您的 Tableau Cloud 站点和 AWS 托管的数据提供程序必须位于同一 AWS 区域。有关包含 Tableau Cloud pod 和关联区域的表，请参见 [Tableau Cloud 的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#ip-addresses-for-tableau-cloud)。
4. 输入 AWS 中的“端点服务名称”。端点服务名称以“com.amazonaws.vpce”开头。
5. 如果端点服务需要或允许，请输入端点服务的“自定义地址”。管理 AWS 端点服务的组可以帮助确定您是否需要或有权选择此字段中的自定义地址。
6. 选择“创建”以创建专用连接。

![“创建专用连接”对话框](/tableau/next/zh-cn/online/zh-cn/Img/private_connect_create_private_connection.png)

新的专用连接将添加到专用连接表中，并以“Allocating”状态开始。

## 专用连接状态

在专用连接的“操作”菜单 (...) 中选择“同步”以检查专用连接状态的更新。

<table class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><td><strong>状态</strong></td><td><strong>描述</strong></td><td><strong>后续步骤</strong></td></tr><tr><td>Allocating</td><td>正在预置专用连接。这是一个待定状态，以成功或失败结束。</td><td>在<span class="uicontrol">“操作”</span>菜单 (...) 中选择<span class="uicontrol">“同步”</span>以每隔几分钟检查一次状态是否有更新，直到状态发生变化。如果状态从未从“Allocating”更改，请检查以确保您的 Tableau Cloud 站点和端点服务位于同一 AWS 区域中。</td></tr><tr><td>PendingAcceptance</td><td>预置正在等待，因为专用连接需要被 AWS 中的端点服务接受。</td><td>在 AWS 中接受连接。（可选）在 AWS 中配置端点服务，使其不需要接受。</td></tr><tr><td>RejectedRemotely</td><td>AWS 中的端点服务拒绝了专用连接。这是错误状态。</td><td>确保端点服务配置为允许来自 Tableau Cloud 的连接。验证 IAM ARN 是否为 AWS 终端节点服务上允许的主体。</td></tr><tr><td>Ready</td><td>预置已完成，可以将专用连接分配给站点。</td><td>在<span class="uicontrol">“操作”</span>菜单 (...) 中选择<span class="uicontrol">“分配给站点”</span>，将专用连接分配给站点。将专用连接分配给站点后，站点管理员可以在站点设置的<span class="uicontrol">“私人连接”</span>选项卡中看到它，并且 Creator 可以使用它来创建内容。</td></tr><tr><td>Inactive</td><td>专用连接已配置但处于非活动状态。处于“Inactive”状态 30 天后，专用连接将被删除。</td><td>如果专用连接未被使用，请将其删除，或解决其处于“Inactive”状态的原因。</td></tr></tbody></table>

![云管理员的专用连接表](/tableau/next/zh-cn/online/zh-cn/Img/private_connect_cloud_admin_private_connection_table.png)

## 将专用连接分配给站点

在专用连接的状态为“Ready”后，可以将其分配给站点。将专用连接分配给站点后，站点管理员可以在站点设置的“私人连接”选项卡中看到它，并且创建者可以使用它来创建工作簿和数据源。使用专用连接的数据流量永远不会通过公共互联网。

若要将专用连接分配给站点，请执行以下操作：

1. 在专用连接列表中查找专用连接。
2. 在“操作”菜单 (...) 中选择“分配给站点”。
3. 选择或取消选择站点以更改专用连接分配。您可以使用搜索栏搜索站点，或选中表标题中的复选框以选择或取消选择所有站点。“保存分配”按钮中的数字指示专用连接将分配到的站点总数。
4. 选择“保存分配”。

## 编辑专用连接描述

若要编辑专用连接的描述，请执行以下操作：

1. 在专用连接列表中查找专用连接。
2. 在“操作”菜单 (...) 中选择“编辑描述”。
3. 编辑描述。
4. 选择“保存”。

描述对专用连接没有功能影响，但可以帮助管理员将一个专用连接与另一个专用连接区分开来。

## 删除专用连接

若要删除专用连接，请执行以下操作：

1. 在专用连接列表中查找专用连接。
2. 在“操作”菜单 (...) 中选择“删除”。
3. 在**“删除专用连接”**对话框中选择“删除”。

您无法撤消删除操作。删除专用连接后，使用专用连接的工作簿和数据源将无法工作。此外，由于每个专用连接在创建时都分配有唯一的连接地址，因此重新创建专用连接无法解决损坏的工作簿和数据源问题。但是，如果已删除的专用连接和重新创建的专用连接都使用自定义地址，并且这些地址相同，则在删除和重新创建专用连接后，工作簿和数据源将继续工作。

<!-- document id=a8b057f03a782bae8e780635224fe4318b73c7a49632f13a0317099d9decbf55 url=/tableau/next/zh-cn/online/private_connect_setup_overview.md -->

[跳转到主要内容](#main-content)

# 出站私人连接

适用于 AWS (Amazon Web Services) 的出站私人连接允许云管理员在 Tableau Cloud 和 AWS 托管的数据提供商之间创建安全、私有的专用连接。这些专用连接在 AWS PrivateLink 之上预置，使用私有 IP 地址空间，这意味着数据流量不会遍历公共互联网。专用连接的私有和安全特性满足了将数据流量限制到专用网络的关键要求。

![专用连接图，包括 AWS 和 Tableau 云、端点、端点服务和数据提供程序](/tableau/next/zh-cn/online/zh-cn/Img/private_connect_diagram.png)

创建并准备好专用连接后，创建者可以像工作簿和数据源连接对话框中的任何其他数据库地址一样使用连接地址。同样，管理员和 Creator 在创建虚拟连接时使用连接地址。

支持的 AWS 数据提供程序包括：

- Athena
- Aurora MySQL
- Databricks
- Dremio
- Heroku Postgres
- MariaDB
- Microsoft SQL
- MySQL
- Oracle
- Palantir
- PostgreSQL
- Redshift
- Snowflake
- Teradata Vantage Cloud
- Teradata Vantage On-Premise

您是否能使用出站专用连接取决于您的角色：

- **云管理员**在 Tableau Cloud Manager (TCM) 中创建出站专用连接，并将其分配给站点。他们还可以向 Creator 和支持他们的组提供连接信息。
- 站点管理员对分配给其站点的出站专用连接的相关信息具有只读访问权限。他们还可以向 Creator 和支持他们的组提供连接信息。
- Creator 使用出站专用连接安全地连接到 AWS 中存储的数据。在工作簿、数据源或虚拟连接中使用出站专用连接与使用常规非专用连接一样简单，只是 Creator 使用站点管理员或云管理员提供的特殊连接地址。数据流量不会遍历公共互联网，而是仅限于 AWS 虚拟专用云 (VPC) 之间的专用连接。

## 示例用例

### 场景 1：避开公共互联网

您的组织的数据位于 Snowflake 中。网络安全策略可防止 Tableau Cloud 通过公共互联网访问 Snowflake 数据。

**使用出站私人连接**

您可以在 Tableau Cloud 站点和 Snowflake 数据之间创建出站专用连接。数据在 Tableau Cloud 和 Snowflake 之间安全、私密地传输，无需穿越公共互联网。

### 场景 2：从 Bridge 迁移，使用专用地址空间

您的组织的数据位于 Redshift 中。网络安全策略要求 Tableau Cloud 使用专用 IP 地址访问 Redshift 数据，因此您使用 Tableau Bridge 连接到该数据。Tableau Bridge 是免费的，但有管理开销。

**使用出站私人连接**

您可以在 Tableau Cloud 站点和 Redshift 数据之间创建出站专用连接。现在，数据使用专用 IP 地址在 Tableau Cloud 和 Redshift 之间安全、私密地传输，无需穿越公共互联网，也无需 Tableau Bridge。使用出站私人连接可以简化管理，但数据传输需要成本。

有关从 Bridge 或 Data Connect 迁移到出站私人连接的信息，请参见[从 Tableau Bridge 迁移到出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_migrate_from_bridge.htm)。

## 许可要求

出站私人连接可在具有 Enterprise 或 Tableau+ 许可版本的 Tableau Cloud 上运行，并且每个专用连接都需要一个附加许可证。有关许可和定价的信息，请与您的客户经理联系。

出站专用连接数据使用按 TB 计费。有关出站私人连接使用情况的信息，请参见[私人连接许可](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#private-connect-licensing)。

## 高级设置概述

出站专用连接包括：

- 数据提供程序（托管在 AWS 上）
- 端点服务 (AWS)
- 端点 (Tableau Cloud)

对于与 Athena、Heroku Postgres 和 Teradata Vantage Cloud 的出站专用连接，您的 Tableau Cloud 站点和 AWS 托管的数据提供程序必须位于同一 AWS 区域。有关包含 Tableau Cloud pod 和关联区域的表，请参见 [Tableau Cloud 的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#ip-addresses-for-tableau-cloud)。

## 数据提供程序和 AWS 组件

AWS 托管的数据提供程序和 AWS 端点服务在 AWS 中配置。

对于大多数 AWS 托管的数据提供程序，AWS 端点服务需要明确允许来自您的 Tableau Cloud 站点的连接。AWS 端点服务使用其区域的身份和访问管理 (IAM) Amazon 资源名称 (ARN) 来识别 Tableau Cloud 站点。

若要允许访问，AWS 端点服务需要将 Tableau Cloud 的 IAM ARN 添加到允许的主体列表中。

## Tableau Cloud 组件

出站专用连接的 Tableau Cloud 端在 Tableau Cloud Manager (TCM) 中配置。

Tableau Cloud 需要 AWS 端点服务名称。如果数据提供程序需要，Tableau Cloud 可能还需要有关端点服务的自定义地址信息。

## 典型设置步骤

设置出站专用连接的_典型_过程如下：

1. **AWS**：设置数据提供程序并创建端点服务。（您可能需要依赖第三方。有关更多详细信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下针对单个数据提供程序的特定主题。）
2. **TCM**：获取区域的 Tableau Cloud IAM ARN。
3. **AWS**：将 Tableau Cloud IAM ARN 添加为端点服务上允许的主体。（您可能需要依赖第三方。有关更多详细信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下针对单个数据提供程序的特定主题。）
4. **AWS**：获取端点服务名称。
5. **TCM**：使用 AWS 端点服务名称创建出站专用连接。（自定义连接地址也可能是必需的或允许的。有关更多详细信息，请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下针对单个数据提供程序的特定主题。）

典型设置过程的例外情况取决于数据提供程序，并且位于[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下针对各个数据提供程序的特定主题中。

在两端都配置正确并且专用连接准备就绪后，创建者可以使用专用连接以安全、私密的方式连接到 AWS 托管的数据提供程序。

## 创建您的出站专用连接

若要为您的站点创建和配置出站专用连接，请执行以下操作：

1. 请参见[出站专用连接设置：AWS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_aws.htm)下适用于您的 AWS 托管数据提供程序的子主题
2. 请参见主题[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 此部分中的其他文章

<!-- document id=e7335f61694a13448869f006083aef36f5af631bf94b6e1f7dcb87a95c31481a url=/tableau/next/zh-cn/online/private_connect_list_share.md -->

[跳转到主要内容](#main-content)

# 列出和共享出站专用连接

## 云管理员

作为云管理员，使用 Tableau Cloud Manager (TCM)“设置”中的“私人连接”选项卡查看所有专用连接：

- 登录 Tableau Cloud Manager (TCM)。
- 转到“设置”。
- 选择“私人连接”选项卡。

![云管理员的专用连接表](/tableau/next/zh-cn/online/zh-cn/Img/private_connect_cloud_admin_private_connection_table.png)

TCM 设置中的专用连接列表包括所有专用连接，无论状态或站点分配如何。

如果您看不到“私人连接”选项卡，请与您的 Tableau 客户经理联系，并确认您正在将 Tableau Cloud 与 Enterprise 或 Tableau+ 许可版本结合使用，并且您至少有一个私人连接端点加载项许可证。

## 站点管理员

作为站点管理员，使用站点“设置”中的“私人连接”选项卡查看可用的专用连接：

1. 登录到您的 Tableau Cloud 站点。
2. 转到“设置”。
3. 选择“私人连接”选项卡。

![站点管理员的专用连接表](/tableau/next/zh-cn/online/zh-cn/Img/private_connect_site_admin_private_connection_table.png)

如果您看不到“私人连接”选项卡，或者专用连接列表看起来不准确或不完整，请咨询您的云管理员。

## 与 Creator 共享专用连接

Creator 需要专用连接的“连接地址”才能连接到 AWS 托管的数据。云管理员和站点管理员从专用连接表中获取“连接地址”，并将其提供给 Creator 或支持他们的组。由于长度的原因，完整地址经常被截断，复制“连接地址”的最简单方法是使用“操作”菜单 (...)：

1. 在专用连接列表中查找专用连接。
2. 在“操作”菜单 (...) 中选择“复制连接地址”，将完整的“连接地址”复制到剪贴板。
3. 与 Creator 共享连接地址。
    
    **注意：**按原样共享连接地址。请勿在地址中添加 `https://` 或任何其他元素。

在工作簿和数据源连接对话框中，Creator 可以像输入任何其他服务器名称一样输入专用连接的“连接地址”。Creator 填写其他连接对话框字段（例如，端口、数据库名称或身份验证），其填写方式与常规非私有版本的连接相同。

<!-- document id=360265bb4a30fb7b46f875e1aed840fa701dfe1232085bfcee5864c811eab7d9 url=/tableau/next/zh-cn/online/data_stories.md -->

[跳转到主要内容](#main-content)

# 创建 Tableau 数据故事（仅限英文）

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

如果您曾经编写过 Tableau 仪表板的执行摘要，您就会知道这可能很耗时。选择要分享的见解需要时间，而且每次更新数据时都必须重写摘要。Tableau 数据故事会在您的仪表板中自动生成叙述性见解，从而节省时间并呈现相关见解。当您探索仪表板中的可视化项时，数据故事 编写的故事会调整，让您更深入地研究数据并更快地识别关键见解。

从您已经在 Tableau 中工作的位置，您可以快速将“数据故事”对象添加到仪表板。您可以自定义故事中使用的术语和指标，因此 数据故事 采用的是您的企业使用的语言。

如今，您可以在使用 Tableau 的任何地方编写和查看 Tableau 数据故事。创建故事后，您还可以在 Tableau Mobile 中查看数据故事。但是，如果您导出仪表板（例如导出为 PDF），则不会包含数据故事。

## 了解数据故事如何处理数据

为了编写数据故事，Tableau 使用在您的 Tableau Cloud 或 Tableau Server 环境中托管的服务。当您[将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)或从仪表板查看数据故事时，Tableau 使用[云中的安全性](https://help.tableau.com/current/online/zh-cn/to_security.htm)和 [Tableau Server 中的安全性](https://help.tableau.com/current/server/zh-cn/security.htm)中概述的安全标准将关联的工作表数据发送到您登录的环境（即，您的 Tableau Cloud 站点或您的 Tableau Server 实例）。可以在使用 Tableau 的任何地方编写和查看数据故事。

## 了解如何编写数据故事

Tableau 数据故事由基于规则的模板化自然语言生成 (NLG) 提供支持。数据故事执行自动分析，以确定有关基础数据的相关且准确的事实 - 从基本计算到更高级的统计数据。为了编写故事，数据故事使用预定义语言模板库将这些事实合成为自然语言见解。数据故事在运行时处理这些模板，使用其连接到的 Tableau 工作表中的最新摘要数据。您可以利用[自定义语言功能](https://help.tableau.com/current/pro/desktop/zh-cn/data_stories_customize.htm)生成自己的语言模板、添加功能并定义业务规则，从而帮助您构建更相关和更有上下文关系的数据故事。

**注意：**数据故事不使用生成式人工智能、大型语言模型 (LLM) 或机器学习来撰写见解和故事。

## 为您的站点管理数据故事

Tableau 管理员可以选择 Tableau 数据故事是否可用于他们的站点。数据故事 默认开启。

1. 登录您的 Tableau 站点。
2. 从左侧的窗格中，选择**“设置”**。
3. 从**“常规”**选项卡中，滚动到**“数据故事的可用性”**部分。
4. 选择是要**打开**还是**关闭**数据故事。

**注意：**如果数据故事已关闭，则重新打开该功能会恢复仪表板中已有的数据故事。

## 此部分中的其他文章

<!-- document id=8cab55143f196317c2041e60dc8a473509dfbbba494b9adc45cc83242cabf638 url=/tableau/next/zh-cn/online/ipa_vconn_create_data_policy.md -->

[跳转到主要内容](#main-content)

# 创建和测试数据策略

使用数据策略筛选使用虚拟连接的任何视图、数据源或流程中的数据。使用策略表或权利表中的列将数据筛选为仅用户应该看到的内容。

- **策略表**\- 被筛选的表。
- **策略列**\- 用于筛选数据的列。
- **权利表**\- 包含可用于筛选数据的列的表。当策略表不包含策略列时使用。

将表添加到策略

创建数据策略：

1. 单击 ![“创建新策略”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Create_New_Policy_btn.png)
2. 单击选项卡上的默认名称以重命名策略。
3. 双击左侧窗格中的表名称以将表添加到数据策略。

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_conn.htm#select-tables-to-include-in-the-connection)

映射表的列

对于每个策略表，将策略表中的一列映射到策略列或权利表。

### 映射到策略列

1. 单击 ![“将列添加到地图”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_add_col_map_btn.png) 添加要用于筛选数据的一个或多个列。
2. 为策略列命名。您将在策略条件中使用此名称。
3. 对于每个策略表，使用下拉菜单选择映射到策略列的表列。
4. 为要在策略条件中使用的尽可能多的策略列重复此过程。

**快速剪辑：**将表列映射到策略列，并为用于按销售员筛选发票的数据策略编写策略条件。

Your browser does not support the video tag.

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_rlspolicy.htm#filter-with-a-policy-column-from-a-policy-table)

### 映射到权利表

1. 选择权利表，将该表拖到右侧并将其放在“添加为权利表”上。您可以将来自任何连接或数据库的表用作中央权利表，以保护许多其他数据库中的表。
2. 对于每个策略表，单击下拉菜单并选择列以将策略中的表映射到权利表。

**快速剪辑：**将权利表（包含“EmployeeId”和“Full Name”列）映射到策略表列，并为数据策略编写策略条件。

Your browser does not support the video tag.

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_rlspolicy.htm#filter-with-policy-column-from-an-entitlement-table)

编写策略条件

策略条件是一个经常使用用户函数来定义行级访问权限的计算。在线帮助中有关[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm)的详细信息。

一个策略条件：

- 在数据策略中是必需的。
- 评估结果必须为真或假。
- 当策略条件为真时显示行。

示例：

`FULLNAME() = [EmployeeName]`

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_rlspolicy.htm#write-a-policy-condition)

使用“以用户身份预览”对数据策略进行测试

测试您的策略以查看用户看到的数据，并确保您的策略按预期工作。

1. 选择一个表。
2. 在“表详细信息”部分，选择 ![标有“已应用策略”的复选框。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_with_policy_applied.png)
3. 单击“以用户身份预览”，选择一个组（可选）和一个用户。
4. 验证策略在表详细信息中是否显示该用户的正确数据。
5. 根据需要为其他用户重复该操作。

[阅读完整主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_test_preview.htm)

发布连接并设置权限

### 保存草稿或发布连接

在您工作时，您的连接会自动保存为草稿。通过单击 ![“保存”图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Save_16px_medium.png) 来手动保存草稿。

若要与其他用户共享新的虚拟连接，您需要发布它。

1. 单击编辑器右上角的 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)。
2. 在“名称”字段中键入连接的名称。
3. 选择一个项目来保存连接。
4. 单击 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)

当您编辑现有连接时，它在当前已发布状态下仍可供用户使用。

- 若要将更新保存到草稿，请单击 ![“保存”图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Save_16px_medium.png)。
- 若要使更新的连接对用户可用，请单击 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)

### 设置权限以便其他人可以使用连接

您已发布连接，并准备好让其他人使用它。为此，请将“连接”功能设置为“允许”。

1. 导航到虚拟连接。
2. 打开“操作”菜单 (...)，并单击“权限”。
3. 选中“连接”图标下的框，以便所有用户都可以使用连接。
    
    ![“权限规则”下的“连接”功能复选框](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_connect_capability.png)
4. 单击“保存”。

[阅读发布和权限主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_publish_save.htm)

## 相关任务

[关于虚拟连接编辑器](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_editor.htm)

[将表添加到连接](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_add_tables.htm)

[关于数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_data_policy.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=5fdade7ca8a3358e404b8afc7ed146aebab7e3bde0452647d30cc8c08bd5e009 url=/tableau/next/zh-cn/online/metrics_create.md -->

[跳转到主要内容](#main-content)

# 创建指标并排查其问题（已停用）

## 停用旧版指标

本文介绍 Tableau 的旧版指标功能，该功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。

Tableau Pulse 引入了一种跟踪指标的新方法。借助 Tableau Pulse，您创建的指标用于生成有关数据的见解。这些数据见解会直接发送给跟踪指标的用户，以便他们了解工作流程中数据的变化。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)。

如果您有想要保留的旧版指标，请记下这些指标的数据源、度量和时间维度，并在 Tableau Pulse 中重新创建它们。旧版指标不会自动迁移到 Tableau Pulse。

指标提供了一种快速了解数据的方法。由于指标会自动更新并在内容的网格和列表视图中显示其当前值，因此您可以在几秒钟内查看您关心的所有关键数字。

![具有良好和不良状态的利润指标网格](/tableau/next/zh-cn/online/zh-cn/Img/metrics_grid.png)

在最基本的层面上，指标显示了一个聚合度量的价值，比如销售额的总和。更复杂的指标可以包括时间线、比较和状态，它们提供了一个易于理解的指标，表明您相对于之前的时间点或您定义的值的表现。

如果您有一组定期检查仪表板，请为要监控的数字创建指标，然后通过将这些指标添加到收藏夹或集合，或在同一项目中创建它们，对这些指标进行集中跟踪。这样，除非您想更深入地挖掘数据，否则您无需加载和筛选仪表板。

## 在您的站点上查找指标

有几种方法可以在您的 Tableau 站点上查找指标。若要浏览您有权查看的所有指标，请导航到“浏览”页面，然后从内容类型菜单中选择“所有指标”。

如果您要查找与特定视图或工作簿相关的指标，请检查该内容的关联指标。若要查看视图的已连接指标，请打开视图，然后单击视图工具栏中的“观看”\>“指标”。显示的指标按从最新创建日期到最旧日期排序。

![视图工具栏和连接到视图的指标](/tableau/next/zh-cn/online/zh-cn/Img/metrics_connected_view.png)

若要查看工作簿中所有视图的已连接指标，请导航到工作簿，然后单击“已连接指标”选项卡。可以使用“排序依据”菜单对这些指标进行排序。

![“工作簿”页面和连接到工作簿的指标](/tableau/next/zh-cn/online/zh-cn/Img/metrics_connected_workbook.png)

## 指标的组成部分

定义指标所需的唯一数据是聚合度量。度量是依据视图中的标记创建的，与该标记关联的度量定义了指标。度量必须聚合，因为未聚合的标记不会随时间变化。有关 Tableau 中的维度和度量的信息，请参见[维度和度量（蓝色和绿色）](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles.htm)。

指标可以根据需要由日期维度定义，您可以为指标配置比较和状态。这些组件中的每一个都将为指标卡上显示的数据添加上下文。

仅具有定义它们的度量的指标将显示为单个数字。这个数字会在数据更新时更新，但卡上不会有时间线。

![单个数字指标](/tableau/next/zh-cn/online/zh-cn/Img/metrics_single_number.png)

### 时间线

当您选择一个标记来定义指标时，如果该标记具有与其关联的日期维度，则该维度将成为指标定义的一部分。具有日期维度的指标显示时间线，您可以配置指标的历史比较。默认情况下，历史比较是与前一个标记进行比较。

打开指标的详细信息页面时，时间线根据日期维度的粒度（例如，每日销售额或每月用户数）显示度量的值。将光标指针悬停在时间线上以查看历史值。

![每月销售额的时间线](/tableau/next/zh-cn/online/zh-cn/Img/metrics_timeline.gif)

### 比较

您可以为指标配置两种类型的比较：历史比较和常量比较。仅当指标具有与其关联的日期维度时，您才能配置历史比较，但可以为任何类型的指标添加常量比较。

历史比较是当前值与之前指定的小时数、天数或其他时间单位之间的相对比较。例如，您可以设置月销售额的当前值与 12 个月前的值之间的比较。每次将数据添加到指标时，历史比较都会相对于新数据的日期或时间进行调整。

![指标在比较期间上涨了 20%](/tableau/next/zh-cn/online/zh-cn/Img/metrics_historical_comp.png)

常量比较针对的是一个在添加新数据时不会改变的值。例如，如果您需要保持 90% 的准时送货率，您可以设置一个比较来表示保持在某个阈值之上。或者，您可以定义一个您正在努力实现的累积目标，例如，每月销售目标。

![指标 4640 美元高于比较值](/tableau/next/zh-cn/online/zh-cn/Img/metrics_constant_comp.png)

### 状态

对于具有常量比较的指标，您可以定义高于、低于或等于比较值是良好、不良还是中性。状态为“良好”的指标将在比较值旁边显示复选标记，并且指标卡的顶部将有一个绿色条带。状态为“不良”的度量将在比较值旁边显示一个 X，并且指标卡的顶部将有一个红色条带。具有“中性”状态的指标与没有状态指示器的指标相同；没有应用于卡的图标或颜色。

![具有中性、不良和良好状态的指标](/tableau/next/zh-cn/online/zh-cn/Img/metrics_status.png)

## 从视图创建指标

如果您具有 Creator 或 Explorer（可发布）站点角色，并具有相关工作簿的“创建/刷新指标”能力，则可以在 Tableau Cloud 或 Tableau Server 上创建指标。

在创建指标之前，请检查视图的已连接指标以确保您计划创建的指标尚不存在。与其创建重复的指标，不如打开现有指标并将其添加为收藏夹。

### 选择标记以定义您的指标

1. 导航到要从中创建指标的视图。
2. 在视图工具栏上，选择“观看”\>“指标”。
    
    ![突出显示指标按钮的“视图”工具栏](/tableau/next/zh-cn/online/zh-cn/Img/metrics_toolbar.png)
    
    指标窗格将打开。
3. 如果窗格显示已连接指标，请选择“创建”按钮进入制作模式。
4. 选择一个标记。如果遇到错误，请参见[何时无法创建指标](#when-you-cant)。
    
    ![在多图表视图上选择标记](/tableau/next/zh-cn/online/zh-cn/Img/metrics_mark_selection.png)
    
    与此标记关联的度量定义了您的指标。适用于此标记的任何筛选器将应用于您的指标。如果此标记具有与其关联的日期维度，则该日期维度还定义了您的指标，并且您的指标将显示时间线。
    
    指标窗格显示指标的预览。预览中的值是指标的最新值，如果它不是时间序列中的最新值，则可能与您选择的标记值不同。当您尝试不同的配置时，预览会更新。
    
    ![指标配置预览](/tableau/next/zh-cn/online/zh-cn/Img/metrics_preview.gif)

### 描述和配置您的指标

可用于配置指标的选项取决于您选择的标记和您选择的比较类型。

1. “名称”字段会根据您选择的标记预先填充。您可以为指标指定不同的名称。指标在其所属的项目中必须具有唯一名称。
2. 在“说明”下，输入一条可选消息，以帮助其他人了解您的指标。例如，描述应用于指标的筛选器或指明指标使用的数据源。
3. 对于“日期范围”（仅适用于具有日期维度的指标），选择默认选项之一，或设置自定义范围。如果您的指标有大量标记，则限制日期范围可以使时间线更易于阅读。
4. 为指标选择“比较类型”：历史或常量。
5. 对于“历史”比较：
    
    - 输入要比较的先验距离。比较的时间单位与数据的粒度相同，例如小时或月。
    - 选择“显示比较线”以在时间线上包含比较时段的第二行。
6. 对于“常量”比较：
    
    - 输入要比较的值。不要在此字段中包含逗号或符号。若要输入百分比，只需键入不带百分号的数字，例如，对于 25% 的目标，请输入 25 而不是 0.25。当您输入有效的目标值时，预览会更新以显示当前值高于或低于目标的程度。
    - 设置比较的“状态”以指示高于、等于或低于该值是良好、不良还是中性。默认情况下，状态设置为中性。检查指标预览以了解不同状态如何影响您的指标。
7. 在“定义”\>“度量”下，从下拉列表中选择要用于定义的度量。仅当所选标记有多个与之关联的度量时，才会显示此选项。

![从下拉菜单中选择度量](/tableau/next/zh-cn/online/zh-cn/Img/metrics_disambiguate.png)

### 最终确定您的指标

1. 在“项目”下，选择“更改位置”以便为指标选择不同项目。默认情况下，您的指标将添加到视图所属的同一项目中。
    
    项目中的每个指标都必须有唯一名称。由于指标的名称和项目最初是根据您选择的标记设置的，所以当您尝试保存指标时可能会遇到冲突，如果另一个用户已经从该标记创建了度量。为您的指标选择其他项目或名称，或者，如果您想覆盖现有指标，请参见[覆盖指标](#overwrite)。
2. 单击“创建”按钮。
    
    将显示一条消息，其中包含一个链接，指向您在其中添加了指标的项目中的指标。
    
    ![成功消息](/tableau/next/zh-cn/online/zh-cn/Img/metrics_success.png)
3. 按照[设置权限](https://help.tableau.com/current/server/zh-cn/permissions.htm#set-permissions)中的指导验证您的指标的权限是否正确。
    
    默认情况下，指标会继承创建它的项目的权限。有权访问您的指标的任何人都将能够查看该指标的数据，即使他们无权访问连接的视图或数据源。

现在您已经创建了一个指标，您可以像管理 Tableau 站点上的其他独立内容一样管理该指标。尽管指标是依据视图创建的，但它们独立于视图而存在，这与数据驱动的通知或订阅不同。您可以将指标移动到其他项目，而无需移动已连接视图。有关管理 Tableau 站点上的内容的信息，请参见[管理 Web 内容](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm)。

### 覆盖指标

创建指标后，您可以更改指标的名称、描述和配置，但无法更改指标的定义方式。如果要更改指标使用的数据，则必须覆盖它。为了覆盖指标，您需要成为指标所有者或被授予正确的权限能力。

1. 若要覆盖指标，在要覆盖的指标所在的同一项目中创建具有相同名称的指标。
    
    将显示“覆盖指标”对话框。
2. 单击“覆盖”按钮。

覆盖指标时，该指标将继续为将其添加到收藏夹的用户显示，对上一个指标的权限所做的任何更改都将应用于新指标。

### 何时无法创建指标

如果在不支持指标的图表上选择标记，则会收到一条错误消息，说明为何无法创建指标。下表总结了这些方案。

<table class="table--plain"><colgroup><col style="width: 34%;"><col></colgroup><thead><tr><th>原因</th><th>方案</th></tr></thead><tbody><tr><td>您没有正确的权限。</td><td><ul><li>工作簿所有者或管理员拒绝了“创建/刷新指标”能力。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/permissions.htm">“权限”</a>。</li></ul></td></tr><tr><td>您无法访问完整数据。</td><td><ul><li>行级安全性或用户筛选器限制您可以看到的数据。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/publish_userfilters.htm">在数据行级别限制访问</a>。</li></ul></td></tr><tr><td>工作簿数据源的密码未嵌入或不再有效。</td><td><ul><li>工作簿将提示输入密码。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm">设置凭据以访问您发布的数据</a>。</li></ul></td></tr><tr><td>数据没有位于正确的粒度级别。</td><td><ul><li>图表中的数据未聚合。指标使用聚合，例如总和或平均值。有关详细信息，请参见 <a href="https://help.tableau.com/current/pro/desktop/zh-cn/calculations_aggregation.htm">Tableau 中的数据聚合</a>。</li><li>每个数据单元格有多个值，这是数据混合的结果。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/multipleconnections_troubleshooting.htm">数据混合疑难解答</a>。</li></ul></td></tr><tr><td>不支持日期维度。</td><td><ul><li>图表同时包括日期部分和日期值。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/dates_levels.htm">更改日期级别</a>。</li><li>日期维度使用 ISO 8601 日历，而不是标准公历。有关详细信息，请参见 <a href="https://help.tableau.com/current/pro/desktop/zh-cn/dates_calendar.htm">ISO-8601 基于周的日历</a>。</li><li>日期维度在自定义级别“月/年”或“月/日/年”进行聚合。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/dates_custom.htm">自定义日期</a>。</li></ul></td></tr></tbody></table>

## 编辑指标的配置

从 2022.2 开始，您可以更改指标的配置。指标的配置包括比较、日期范围和状态指标。可用配置选项取决于指标的类型。带有时间线的指标允许您设置历史比较或持续比较。单一数字指标仅支持持续比较。

指标的配置不包括指标定义（生成指标值的度量和日期维度）。如果要更改定义，请用新指标覆盖指标。

若要编辑指标的配置，您必须具有该指标的覆盖能力。

1. 打开要编辑的指标的指标详细信息页面。
2. 将鼠标悬停在配置部分上。单击该部分的任意位置以进入编辑模式。
    
    ![鼠标悬停时的指标配置部分](/tableau/next/zh-cn/online/zh-cn/Img/metrics_edit_config.png)
3. 对于时间线指标，设置要在指标卡和详细信息上显示的日期范围。
4. 选择比较类型。对于持续比较，请设置比较值和状态。对于历史比较，设置要比较的时间范围，并选择是否在时间线上显示比较线。
5. 单击“保存”。查看该指标的任何人都会看到您的配置更改。

## 指标如何刷新

指标刷新时，它会检查已连接视图（依据其创建指标的视图）中是否有新数据。刷新不一定会更新指标的值，因为数据可能没有更改。

指标刷新的频率取决于数据提取的刷新计划，或者对于实时数据，频率为每 60 分钟刷新一次。上次刷新的时间显示在指标上。

## 修复失败的刷新

如果指标无法访问连接的视图或其基础数据，刷新将失败。如果指标的刷新失败，您将收到一个通知，其中将注明失败的时间和受影响的指标。

由于以下原因之一，指标刷新可能会失败。

- 连接的视图已删除或修改。
- 连接r 视图的权限已更改。
- 数据源的密码不再嵌入或不再有效。
- 指标所有者没有刷新指标所需的站点角色。需要 Creator 或 Explorer（可发布）站点角色。
- 存在临时连接问题，该问题将自行解决。

若要确定失败原因，请查看指标详细信息。确保指标所有者具有刷新指标所需的站点角色。然后检查“连接的视图”。

![“指标详细信息”下突出显示的指标已连接视图](/tableau/next/zh-cn/online/zh-cn/Img/metric_details.png)

### 如果连接的视图仍然列出

打开视图以调查失败的原因。

如果视图加载，请检查定义指标的度量和（可选）日期维度是否仍然存在于视图中。

- 如果视图看起来没有变化，您可能不再有权从中刷新指标。内容所有者或 Tableau 管理员可以更改“创建/刷新指标”权限能力。有关详细信息，请参见[“权限”](https://help.tableau.com/current/server/zh-cn/permissions.htm)。
- 如果度量不再存在，则视图已被修改，因此指标无法连接到刷新所需的数据。内容所有者或 Tableau 管理员可以检查修订历史记录并还原以前的版本。有关详细信息，请参见[查看修订历史记录](https://help.tableau.com/current/pro/desktop/zh-cn/qs_revision_history.htm#view-revision-history)。

如果视图未加载，而是在连接到数据源时提示输入密码或显示错误，则数据源的密码未嵌入或不再有效。内容所有者或 Tableau 管理员可以编辑数据源连接以嵌入密码。有关详细信息，请参见[编辑连接](https://help.tableau.com/current/online/zh-cn/to_connections_modify.htm)。

### 如果未列出连接的视图

视图已删除，或者您不再具有访问该视图的权限。请与您的 Tableau 管理员联系以获得帮助。

## 恢复挂起的刷新

如果刷新失败的次数足够多，则刷新将挂起。如果指标的刷新已挂起，您将收到通知。

当指标刷新挂起时，Tableau 将不再尝试获取该指标的新数据。具有挂起刷新的指标将继续显示历史数据。

如果故障原因已修复，则可以恢复刷新。

1. 打开受影响的指标。
2. 在警告消息上，单击“恢复刷新”。

Tableau 尝试执行刷新。如果此尝试成功，您将收到通知，刷新将按计划恢复。如果尝试失败，刷新将保持挂起状态。

如果连接的视图仍然可用，请尝试覆盖指标。有关详细信息，请参见[覆盖指标](#overwrite)。否则，您可以保留指标以引用过去的数据，或者删除指标。

**注意：**如果指标刷新因您没有刷新指标所需的站点角色而挂起，您将无法恢复刷新或删除指标。

## 指标出现在 Tableau Catalog 中

从 2019.3 开始，Tableau Catalog 随 Tableau Cloud 和 Tableau Server 中的 Data Management 一起提供。在您的环境中启用 Tableau Catalog 时，您可以在 Catalog 世系工具中查看指标，受数据质量警告影响的指标将显示这些警告。有关 Tableau Catalog 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。

当您为要监视的数字定义了指标时，了解指标所依赖的数据是否受到任何影响非常重要。您可以通过多种方式使用 Catalog 来了解这一点。首先，根据指标所基于的数据设置的数据质量警告显示在指标上。当您在 Tableau Mobile 中打开指标时，并在 Tableau Server 和 Tableau Cloud 中将鼠标悬停在网格视图和指标详细信息页上的指标上时，将显示这些警告，如下所示：

![包含数据质量警告的指标](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_metrics.png)

有关详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_dqw.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_dqw.htm) 帮助中的“设置数据质量警告”。

您还可以使用 Tableau Catalog 中的世系工具查看指标所依赖的上游来源。执行影响分析时，您可以查看如果更改或弃用某个列或表，或者移除某些工作簿，哪些指标会受到影响。在世系中包含指标意味着 Catalog 可以全面了解更改对环境中资产的影响。

![按字段筛选时对世系的影响](/tableau/next/zh-cn/online/zh-cn/Img/dm_lineage_filter.png)

有关详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_lineage.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_lineage.htm) 帮助中的“为影响分析使用世系”。

<!-- document id=5351e384e2b8178ba03ccbd9cac1c6c89677dcadfde8936da0e25c61ca7888fa url=/tableau/next/zh-cn/online/subscribe_user.md -->

[跳转到主要内容](#main-content)

# 创建视图或工作簿订阅

订阅会通过电子邮件定期向您发送视图或工作簿的图像或 PDF 快照 - 而无需您登录 Tableau Cloud。

**注意**：如果为站点启用 Tableau Catalog，管理员可以确定订阅电子邮件是否包含相关的上游数据质量警告。Tableau Catalog 作为 Data Management 产品的一部分提供。有关详细信息，请参见[关于 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_overview.htm)。

## Tableau Cloud SMTP 地址

为确保成功发送订阅电子邮件，您公司的安全软件和策略必须允许来自域 `@cloudmail.tableau.com` 以及 IP 地址 54.240.86.205、54.240.86.204、54.240.119.142 和 54.240.119.141 的电子邮件。无法送达的订阅可能会导致收件人被暂时阻止。

如果您的 Tableau 站点使用自定义 SMTP 服务器，请让您的站点管理员确认，除了 IP 地址 155.226.128.24/32、155.226.128.25/32 和 155.226.128.26/32 之外，您的公司还允许来自站点设置中指定电子邮件和域值的电子邮件。

## 为自己或他人设置订阅

在 Tableau Cloud 中打开视图时，如果您在工具栏中看到订阅图标 (![订阅图标。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_icon.png)) 时，则可以订阅该视图或整个工作簿。如果您是具有相应站点角色的项目负责人，或者您是管理员，则可以为具有内容查看权限的其他用户订阅。

**注意：对于**依赖于使用 Bridge 来使数据保持最新的数据源的视图或工作簿，不支持数据刷新发起的订阅电子邮件。

1. 从站点的“浏览”部分，选择“所有工作簿”或“所有视图”，或者打开包含要订阅的视图的项目。
    
    ![“内容类型”菜单](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_content_1a.png)
2. 直接或在打开包含视图的工作簿后打开视图。应用于视图的任何筛选器都不会反映在订阅中。若要为用户订阅筛选的视图，请保存包含这些筛选器的自定义视图，然后为用户订阅该视图。有关创建自定义视图的信息，请参见[使用自定义视图](https://help.tableau.com/v0.0/online/zh-cn/customview.htm)。
3. 在视图工具栏上，选择“观看”\>“订阅”。
    
    ![Tableau Cloud 工具栏上的订阅路径。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_toolbar.png)
4. 添加您想要接收订阅的 Tableau 用户或组。若要接收订阅，用户必须有**“查看”**和**“下载图像/PDF”**权限。
    
    如果您拥有工作簿，请选择“为我订阅”。
    
    注意： 
    
    - 在为组订阅时，将在创建订阅时单独添加每个用户。如果稍后向该组中添加了更多用户，您必须为该组重新订阅，这些新用户才能收到订阅。同样，稍后从组中移除的用户的订阅也不会自动移除，除非移除了其对已订阅视图的权限。
    - 您无法订阅组集。
5. 选择订阅电子邮件是包含当前视图还是整个工作簿。如果仅当存在高优先级信息时视图才包含数据，请选择“视图为空的情况下不发送”。
6. 选择快照的格式：PNG 图像格式、PDF 附件格式或两者。请注意，Pulse 指标包含在 PNG 快照中，但不包含在 PDF 中。
    
    - 如果为 PDF 格式，请选择您要接收的纸张大小和方向。
        
        ![PDF 格式菜单，带有纸张大小和方向的下拉列表。](/tableau/next/zh-cn/online/zh-cn/Img/subscription_paper.png)
7. 要澄清订阅电子邮件，请自定义主题行，并添加一条消息。
    
    **注意：**若要更新订阅消息，您必须取消订阅现有订，阅并使用其他消息创建新订阅。有关详细信息，请参见[更新或取消订阅](#Unsubscribe)。
8. 当工作簿在已发布的连接上使用一个数据提取时，您可以选择频率：
    
    - 数据刷新时：仅在通过运行刷新计划刷新视图或工作簿中的数据时发送。
    - 按选定计划：为订阅选择计划。
9. 如果频率未设置为“数据刷新时”，请单击当前设置左侧的下拉箭头选择一个计划：
    
    ![计划为每周五天，每天 8:00。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_options_online_sched.png)
    
    然后指定可根据需要随时发送订阅电子邮件的自定义计划。（如果服务器负荷很高，则准确交付时间可能会不同。）
    
    ![计划配置为每周一至周五，从 9:00 到 17:00 每小时重复一次。](/tableau/next/zh-cn/online/zh-cn/Img/self_subscribe_topic.png)
    
    若要更改时区，请单击“时区”链接以转到您的帐户设置页面。
10. 单击“订阅”。

收到订阅电子邮件时，您可以选择图像（或者，对于 PDF 订阅，选择邮件正文中的链接）进入 Tableau Cloud 中的视图或工作簿。

## 更新或取消订阅

您可以取消现有订阅，或者对订阅的格式、计划、主题或空视图模式进行更改。

1. 通过执行以下操作之一访问您的 Tableau Cloud 帐户设置：
    
    - 单击订阅电子邮件底部的“管理我的订阅”。
        
        ![用于管理您的订阅的链接。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_remove.png)
    - 登录到 Tableau Cloud。在页面的顶部，选择您的用户图标，然后选择“我的内容”。
        
        ![包含“我的内容”选项的订阅菜单。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_remove2.png)
2. 单击“订阅”。
3. 选中要取消订阅的视图旁边的复选框，单击“操作”，然后单击“取消订阅”，或者选择要更改的订阅选项。

## 恢复或删除挂起的订阅

有时，由于工作簿问题或加载视图时出现问题，订阅会失败。如果订阅失败超过五次，您将会收到一封通知电子邮件，指明您的订阅已挂起。如果您是订阅所有者或管理员，则可通过以下几种方式来恢复挂起的订阅：

- 从 Tableau 网页的“我的内容”区域中，一个图标出现在“上次更新”列中，指明订阅已挂起。选择“...”\>“恢复订阅”以进行恢复。
- 从受影响的工作簿的“订阅”选项卡中，一个图标出现在“上次更新”列中，指明订阅已挂起。选择“...”\>“恢复订阅”以进行恢复。

订阅恢复正常时，您将收到一封电子邮件通知。

## 另请参见

Tableau Desktop 和 Web 制作帮助中的[更改订阅设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm#change-subscription-settings)。

Tableau Cloud 帮助中的[项目级管理](https://help.tableau.com/current/online/zh-cn/projects.htm#project-admin "链接会在新浏览器标签页中打开文章")，了解哪些站点角色允许完全项目主管能力。

<!-- document id=925e2ab86865c4fe628906790cb88c4b2b3bcd7670dad09e039e36e0dba59fb8 url=/tableau/next/zh-cn/online/to_add_users_groups.md -->

[跳转到主要内容](#main-content)

# 创建组并向其中添加用户

作为站点管理员，可以将 Tableau Cloud 用户组织到组中以便更轻松地管理多个用户。用户（例如站点管理员、项目所有者和内容所有者）还可以使用组来应用 Tableau 内容的权限规则。

用户可以属于多个组。

## 创建组

1. 在站点上，单击**“组”**，然后单击“新建组”。
2. 为组键入一个名称。
    
    ![“新建组”表单，其中包含组名称、按需访问和许可用户的选项。](/tableau/next/zh-cn/online/zh-cn/Img/online_new_group.png)
3. （可选）执行以下一项或两项操作：
    
    1. 如果您的站点通过[基于嵌入式分析](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#embedding)基于使用情况的模型获得许可，请选中“允许按需访问”复选框以启用嵌入工作流的按需访问功能。
        
        有关详细信息，请参见以下内容之一：[使用具有直接信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm#ondemand)或[使用具有 OAuth 2.0 信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm#ondemand)。
    2. 选择“登录时授予角色”，并为组选择最低站点角色。有关详细信息，请参见[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)。
4. 单击“创建”。

**注意：**添加到 Tableau Cloud 站点的每个用户（不包括具有按需访问权限的用户）都会自动成为“所有用户”组的成员。默认情况下每个站点中都存在“所有用户”组。您无法删除此组，但可以为其设置权限。

## 向组中添加用户（“用户”页面）

- 在站点上，单击“用户”。
- 选择要添加到组中的用户，然后选择“操作”\>“组成员身份”。
    
    ![带有显示名称的用户列表，其中两个被选为组操作的一部分。](/tableau/next/zh-cn/online/zh-cn/Img/users7.png)
- 选择组，然后单击“保存”。

## 向组中添加用户（“组”页面）

- 从左侧的导航窗格中，单击**“组”**，然后单击组的名称。
- 在组的页面中，单击**“添加用户”**。
    
    ![显示“添加用户”按钮的组页面。](/tableau/next/zh-cn/online/zh-cn/Img/groups_addusers.png)
- 选择要添加的用户，然后单击**“添加用户”**。

![“添加用户”屏幕，每个用户名前都有一个复选框。](/tableau/next/zh-cn/online/zh-cn/Img/groups_addusers2.png)

## 使用断言的动态组成员身份

从 2024 年 6 月 (Tableau 2024.2) 开始，如果您配置了 OIDC 或 SAML 身份验证，;或者使用 Tableau 已连接应用或统一访问令牌 (UAT) 来嵌入工作流，则您可以通过断言动态控制组成员身份。配置后，在运行时用户身份验证期间，Tableau 会收到断言，然后评估组中的成员身份，从而评估权限依赖于这些组的内容。系统根据断言将用户分配到组，并且成员身份仅在用户登录时有效。

通过断言动态控制组成员身份的过程需要 1) 启用设置和 2) 确保组成员身份声明包含在断言中。

**注意：**通过断言动态添加的用户不会显示为 Tableau Cloud 中的用户。

### 步骤 1：启用设置

出于安全目的，仅当站点设置处于启用状态时，才会在身份验证工作流中验证组成员身份。

1. 登录到 Tableau Cloud 并转到“设置”\>“常规”。
2. 在“组成员资格断言”标题下，选中“允许组断言以通过 SAML、OIDC 或 JWT 断言启用组成员身份”复选框。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/abac_assertions_setting_cloud.png)
3. 然后选中适用的断言类型复选框以启用。

有关站点设置的详细信息，请参见[组成员身份断言](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#assertions)。

### 步骤 2：确保断言中包含组成员身份声明

必须（使用 Tableau 已连接应用或统一访问令牌）在相应的 OIDC、SAML 或 JWT 断言中包含两个自定义组成员身份声明，才能指定组成员身份。这两个自定义组成员身份声明为：

- 组：`https://tableau.com/groups`
- 组名称。这些名称应该与 Tableau Cloud 中的本地组名称完全匹配。

**注意：**组集不能被断言。

有关断言的示例，请参阅以下部分之一：

- [OIDC 声明中的动态组成员身份](https://help.tableau.com/v0.0/online/zh-cn/openid_auth.htm#assertions)
- [使用 SAML 断言的动态群组成员身份](https://help.tableau.com/v0.0/online/zh-cn/saml_online_requ.htm#assertions)
- 已连接应用 - 直接信任：[示例 JWT](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm#example)
- 已连接应用 - OAuth 2.0 信任：[步骤 1：开始之前](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm#jwt)

<!-- document id=b6d7f4adae1e0338c9fe9707c652c0d0fd5a2317becbd0f3e1ff4d8672e51dbb url=/tableau/next/zh-cn/online/dm_vconn_create_conn.md -->

[跳转到主要内容](#main-content)

# 创建虚拟连接

虚拟连接是一种 Tableau 内容类型，它提供可共享的数据中央访问点，并在连接级别支持行级安全性。创建虚拟连接是一个多步骤过程。本主题介绍连接到要共享的数据，以及在虚拟连接编辑器的“表”选项卡中工作。

## 连接到数据

在 Tableau Cloud 和 Tableau Server 中创建虚拟连接：

1. 从主页或“浏览”页面上，单击“新建”\>“虚拟连接”。
2. 在“连接到数据”对话框中，选择适用于您的数据的连接器。有关虚拟连接支持的连接器列表，请参见 Tableau Desktop 和 Web 制作帮助中的 [Creator：连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/creator_connect.htm#connector_list)。
3. 输入提示您提供的信息。您输入的凭据保存在虚拟连接中，因此连接用户无需输入凭据即可连接到数据。
4. 如果出现提示，请单击“登录” 。若要添加另一个连接，请单击 ![虚拟连接编辑器中的添加连接加号](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_add_connection_plus.png) 并选择一个连接器，输入凭据，然后登录。

一个虚拟连接可以有多个连接。每个连接访问一个数据库或文件。

**注意：**对于 Tableau Cloud，连接到私有网络数据的虚拟连接使用 Tableau Bridge 来使数据保持最新。有关配置 Tableau Bridge 的信息，请参见[配置和管理 Bridge 客户端池](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)。有关支持的连接的信息，请参见[与 Bridge 的连接](https://help.tableau.com/current/online/zh-cn/to_sync_local_data.htm)。

## 添加另一个连接

根据需要，将另一个连接添加到虚拟连接并通过单击**“连接”**旁边的 ![虚拟连接编辑器中的添加连接加号](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_add_connection_plus.png) 连接到多个数据库。您可以将连接添加到不同的服务器或数据库，或者添加到同一服务器或数据库。

使用多个连接，您可以：

- 使用来自任何连接或数据库的表作为数据策略中的权利表，以保护来自其他连接和数据库的表。
- 使用来自不同数据库的表添加或替换虚拟连接中的表。例如，假设您将数据从一个数据库迁移到另一个数据库。在虚拟连接编辑器中，您可以添加与第二个数据库的连接，并将第一个数据库中的现有表替换为第二个数据库中的表。
- 向同一服务器或数据库添加多个连接。例如，当您需要使用不同的凭据访问同一数据库中的数据时，这会很有帮助。
- 共享一组相关或旨在一起使用的表，无论它们位于何处。例如，您可以从多个数据库中将与员工信息相关的表分组。

当您打开虚拟连接进行编辑时，如果出现提示，您必须按顺序对连接进行身份验证。如果任何连接未能通过身份验证，则无法编辑虚拟连接。

## 选择要包含在连接中的表

如有必要，选择一个数据库以查看其中的表。

1. 在左侧的“表”下，选择表并单击或将它们拖到右侧的“表”选项卡。您可以包括来自不同连接的表。如果您正在使用权利表，请包括该表。
2. （可选）单击“新建自定义 SQL”以创建自定义表架构。

**注意：**虚拟连接不支持具有空间数据类型的表。

## 为表选择实时或数据提取模式

您可以在同一个虚拟连接中将单独的表（无论它们是否来自多个连接）设置为实时或数据提取模式。

- 实时 - 直接从数据库查询表。（“实时”为默认值。）
- 数据提取 - 提取表并保存到 Tableau。

例如，您可以将一些表设置为数据提取模式，这样它们就不会受到报告生成或大量客户流量的影响。

在“表”下，选择要更改模式的一个或多个表，然后依次选择“操作”和“更改为实时”或者“更改为数据提取”。或者，选择表格行中的操作菜单 (...)，然后选择“实时”或“数据提取”。

### 增量数据提取

从 Tableau Cloud 2024 年 6 月版和 Tableau Server 2024.2 开始，您可以配置表数据提取以进行增量刷新。

配置增量数据提取时，您可以指定用于标识新行的关键列。当刷新增量数据提取时，只有关键列增加的行才会添加到数据提取中。处理的行数越少，意味着数据提取刷新作业的速度越快，数据库的负载越少。

例如，假设我们有一个 **Batters** 表的数据提取，数据提取中的数据包括：

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>Year（年份）</strong></td><td><strong>Team（团队）</strong></td></tr><tr><td>1978</td><td>Lions</td></tr><tr><td>1979</td><td>Tigers</td></tr></tbody></table>

**Batters** 表配置为增量数据提取刷新，关键列为**“Year”（年份）**。

实时表已更新为包含 **1980 年**的新行：

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>Year（年份）</strong></td><td><strong>Team（团队）</strong></td></tr><tr><td>1978</td><td>Lions</td></tr><tr><td>1979</td><td>Tigers</td></tr><tr><td>1980</td><td>Bears</td></tr></tbody></table>

当 **Batters** 表的数据提取以增量方式刷新时，仅添加超过数据提取的关键列中最大值的行。在这种情况下，这意味着会在数据提取中添加**“1980”**行。不需要刷新整个数据提取文件，而只需处理和附加 1 行。

如果您想刷新整个数据提取，您仍然可以对配置为增量刷新的数据提取进行完全刷新。

若要为表数据提取配置增量刷新，请执行以下操作：

1. 将表从“实时”更改为“数据提取”。
2. 选择表行中的操作菜单 (...)，然后选择“数据提取设置...”。
3. 选中“启用增量刷新”。
4. 选择一个递增列来用于确定要添加哪些行。
5. 选择“保存设置”。  
    ![启用增量刷新的“数据提取设置”对话框](/tableau/next/zh-cn/online/zh-cn/Img/vconn-extract-settings.png)

### 转换为自定义 SQL

从 Tableau Cloud 2024 年 6 月和 Tableau Server 2024.2 开始，您可以估算用于连接表的 SQL，并将其用作您自己的自定义 SQL 的起点。自定义 SQL 允许您筛选或进行其他可以修改结果集的查询更改。以这种方式创建自定义 SQL 而不是在数据窗格中使用新的自定义 SQL对现有虚拟连接的影响较小。下游资产将该表视为同一个表，而不是新表。

若要将表转换为自定义 SQL，请执行以下操作：

1. 选择表行中的操作菜单 (...)。
2. 选择“转换为自定义 SQL”。
3. 在“编辑自定义 SQL”对话框中，根据需要编辑 SQL。
4. 选择“生成表”。

注意：对话框中首先出现的 SQL 应被视为起点，如果不进行修改可能无法工作。虚拟连接编辑器缺少有关连接中使用的特定 SQL 语法的详细信息。如果在选择“生成表”按钮时遇到错误，请尝试移除或更改单引号、双引号、反引号和方括号，以使 SQL 符合您正在使用的数据库的要求。

若编辑自定义 SQL，请执行以下操作:

1. 选择表行中的操作菜单 (...)。
2. 选择“编辑自定义 SQL”。
3. 在“编辑自定义 SQL”对话框中，编辑 SQL。
4. 选择“生成表”。

若要将表恢复到其默认状态（不含自定义 SQL），请执行以下操作：

1. 选择表行中的操作菜单 (...)。
2. 选择“替换”。
3. 在替换表对话框中，选择原始表名称。
4. 选择“确定”。

### 提取表数据

在一个或多个表从实时更改为数据提取但尚未提取后，单击“创建挂起的数据提取”以运行挂起的数据提取。运行所有挂起的数据提取后，单击“刷新所有数据提取”以提取当时的所有表数据。

或者，在 Tableau Cloud 2024 年 6 月或 Tableau Server 2024.2 及更高版本中，选择表行中的“操作菜单”(...)，然后选择“刷新数据提取...”。如果表没有配置增量刷新，则只能选择“刷新（完整）”。如果配置了增量刷新，您可以选择“刷新（完整）”以完全刷新数据提取，或者选择“刷新（增量）”以增量刷新数据提取。

在发布虚拟连接之前，您必须运行任何挂起的数据提取。生成数据提取时，您无法编辑连接。

发布连接后，在虚拟连接页面上计划虚拟连接中表的数据提取刷新。请参见[为虚拟连接计划数据提取刷新](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_extract.htm)。

## 设置表可见性状态

使用“表”选项卡上的“可见性”开头以向用户显示或隐藏表及其数据。

![选中标记表示显示](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_check_mark_show.png) 用户可以查看表数据。您可以创建一个数据策略来管理用户可以看到哪些数据。（“可见”为默认值。）

![X 表示隐藏](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_x_hide.png) 用户看不到表数据。您可以在数据策略中使用隐藏表并将其用作权利表。

## 查看表详细信息

单击“表”选项卡顶部的表可查看其详细信息。您可以在“表详细信息”部分进行简单的编辑，例如更改表名称、隐藏或重命名列，或者更改数据类型。

使用这些图标切换您看到的表信息：

<table style="width: 100%;"><colgroup><col style="width: 30px;"><col></colgroup><tbody><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/ipa_Tag_16px_medium.png" alt="“标记”图标表示列数据类型。"></td><td>表中的列的列表和每列的数据类型。</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/ipa_Table_16px_medium.png" alt="“表”图标代表列示例数据。"></td><td>每列的示例数据和链接键（如果有）。链接键显示哪些列链接到其他表。仅当数据库具有主键和外键信息时，链接键才可见。</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/ipa_Panes_show_16px_medium.png" alt="“配置文件”图标表示列值范围。"></td><td>直方图中所选的每一列的值范围。</td></tr></tbody></table>

Your browser does not support the video tag.

## 从数据库中刷新数据

单击工具栏中的刷新图标 ![虚拟连接编辑器工具栏上的刷新图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_refresh_icon.png) 为虚拟连接中的所有连接从数据库中获取最新数据，包括：

- 数据库、表和列的列表。包含在虚拟连接中和不包含的表都会刷新。
- 表和直方图数据。

对于实时模式下的表，刷新会检索最新的数据库、表和列列表以及最新的表和直方图数据。对于数据提取模式下的表，刷新会检索表和列的更新列表。但是，若要查看最新的表和直方图数据，您必须开始新的数据提取。例如，当数据库表中有一个新列并且您单击刷新图标时，新列会出现在编辑器中，但其数据不会出现。若要查看最新数据，您必须开始新的数据提取。

刷新数据会使所有当前缓存的数据失效。关闭并重新打开编辑器、将表从数据提取模式切换到实时模式以及更改用户名或密码等连接凭证也会刷新数据。

## 谁可以执行此操作

若要创建虚拟连接，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

## 后续步骤

在“表”选项卡上添加和配置表后，您可以选择[为行级安全性创建数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_rlspolicy.htm)或[发布虚拟连接并设置权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_publish_save.htm)。

## 另请参见

[使用 .properties 文件自定义 JDBC 连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm) — 如果要自定义基于 JDBC 的连接，则还可以。在 .properties 文件中进行自定义。

<!-- document id=fd5dd845d3f67ba686b35f5f8c7f0d59b3fa722a142d0b06387b64ab422de754 url=/tableau/next/zh-cn/online/ask_data_lenses.md -->

[跳转到主要内容](#main-content)

# 创建针对特定受众聚焦“数据问答”(Ask Data) 功能的镜头

**“数据问答”(Ask Data) 功能和指标的重要变化**

Tableau 的“数据问答”(Ask Data) 和指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见 [Tableau AI 和 Tableau Pulse 如何重新构想数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-gpt)。

大多数人不需要来自整个数据源的信息，而是需要与其工作职能（比如销售、营销或支持）相关的数据可视化项。为了针对这些不同的受众优化“数据问答”(Ask Data) 功能，Tableau 作者创建了单独的“数据问答”(Ask Data) 功能_镜头_，用于查询选定的字段子集。对于选定的字段，作者可以为字段名称和值指定同义词，以反映镜头受众使用的通用语言术语（例如，“SF”代表“旧金山”）。然后，镜头作者自定义出现在“数据问答”(Ask Data) 功能查询框下方的建议可视化项，只需单击即可为用户提供答案。

**注意：**只能为单独发布到 Tableau 站点的数据源创建“数据问答”(Ask Data) 功能镜头。无法为嵌入在工作簿中的数据源或具有虚拟连接的数据源创建镜头。

## 在 Tableau 站点上创建或配置镜头页面

在 Tableau 站点上，每个镜头都有一个单独的页面，用户可以在其中查询“数据问答”(Ask Data) 功能，而作者可以配置镜头字段、同义词和建议的问题。

![“数据问答”(Ask Data) 功能镜头](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_lens_page.png)

Tableau 站点上的镜头页面

1. 若要在 Tableau 站点上创建镜头页面，请转到数据源页面，然后选择“新建”\>“‘数据问答’(Ask Data) 功能镜头” 。
    
    若要配置现有镜头，请转至您的站点上的镜头页面。（从仪表板中的现有“数据问答”(Ask Data) 功能对象中，您可以单击右上角的弹出菜单，然后选择“转到镜头页面”。）
2. 如果要创建新镜头，请输入名称、描述和项目位置，然后单击“发布镜头”。
3. 在左侧“字段”窗格的顶部，单击铅笔图标：然后为镜头用户选择相关字段，并点击“保存”。
    
    ![带有突出显示的字段数的“数据问答”(Ask Data) 功能镜头。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_lens_fields.png)
4. 在左侧，将鼠标悬停在单个表或字段上，然后单击铅笔图标：
    
    ![字段列表，其中某个值旁边带有编辑图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_synonyms.png)
    
    然后执行以下任意操作：
    
    - 单击右侧的铅笔图标，提供更具代表性的名称。
        
        ![带有编辑图标的字段详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_rename.png)
    - 添加镜头用户可能在其查询中输入的字段名称和值的常见同义词。
    - 编辑用户将鼠标悬停在字段上时显示的描述。

## 更改建议可视化项的列表

为了解决来自镜头用户的常见查询，您可以自定义显示在查询框下方的建议可视化项。

### 添加或替换建议可视化项

1. 在文本框中输入查询，然后按 Enter 或 Return。
2. 可视化项出现后，从工具栏中的大头针图标中，选择“固定到建议可视化项”或“替换建议”。
    
    ![下拉菜单有两个选项：“固定到建议可视化项”和“替换建议”。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_pin_recommended.png)
3. 对于新建议，请输入名称，然后选择要在其中显示的部分。对于替换建议，请选择要覆盖的现有建议。

### 编辑部分标题和建议名称，或者删除建议

- 若要编辑节标题，请单击标题右侧的铅笔图标 ![铅笔图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_edit_pencil.png)。
- 若要更改建议的名称，请将鼠标悬停在建议上，然后单击铅笔图标 ![铅笔图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_edit_pencil.png)。若要删除建议，请单击 X。
    
    ![建议可视化项](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_lens_questions.png)

## 将“数据问答”(Ask Data) 功能镜头添加到仪表板

在仪表板上，您可以添加一个“数据问答”(Ask Data) 功能对象，该对象使用户可以通过 Tableau 站点上的镜头查询已发布的数据源。

1. 在 Tableau Cloud 或 Tableau Server 中编辑仪表板时将“数据问答”(Ask Data) 功能对象拖到画布上。
    
    **注意：**在 Tableau Desktop 中，您还可以将“数据问答”(Ask Data) 功能对象拖到画布上以进行放置。但为了选择镜头，您需要发布到 Tableau Cloud 或 Tableau Server 并在那里编辑对象。
2. ![强调了“数据问答”(Ask Data) 功能的对象区域。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_extension_to_canvas.png)
3. 选择一个以前连接到工作簿的已发布数据源。
4. 若要使用现有镜头，请选择它，然后单击“使用镜头”。
    
    若要创建新镜头，请执行以下操作之一：
    
    - 如果没有用于数据源的镜头，请单击“转到数据源页面”。
    - 如果已经存在镜头，请单击对话框底部的数据源名称。
5. （仅限新镜头）完成[在 Tableau 站点上创建或配置镜头页面](#Create)中的步骤。
6. 在“镜头用户的工具栏选项”下，选择您希望用户可用的按钮。
    - “将可视化项添加到固定”允许用户[添加到推荐的可视化项列表](#Change)，该列表显示在查询框的正下方。
    - “发布为工作簿”允许用户[将可视化项作为工作簿工作表保存](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_share.htm#Save)到他们的 Tableau 站点。
    - “共享可视化项”允许用户[通过电子邮件、Slack 或链接进行共享](https://help.tableau.com/v0.0/online/zh-cn/ask_data.htm#Share)。
        
        在镜头中，发布（保存图标）、固定和共享选项出现在右上角：
        
        ![“数据问答”(Ask Data) 功能工具栏中突出显示了“保存”、“固定”和“共享”选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_toolbar_options.png)
7. （仅限新镜头）完成创建镜头后，返回到仪表板中的“镜头”对象，然后单击“刷新”。然后选择新镜头，并单击“使用镜头”。

## 将其他镜头应用于“数据问答”(Ask Data) 功能仪表板对象

1. 从对象顶部的弹出菜单中，选择“配置”。
    
    ![可视化项部分，其中突出显示了“数据问答”(Ask Data) 功能配置选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_dashboard_configure.png)
2. 转到[将“数据问答”(Ask Data) 功能镜头添加到仪表板](#Add)，然后重复前面的步骤 2。

## 更改镜头名称、描述或项目位置

1. 导航到 Tableau Cloud 或 Tableau Server 上的镜头页面。
2. 在页面顶部镜头名称的右侧，单击三个点 (...)，然后选择“编辑工作簿”。
3. 单击“编辑镜头详细信息”。

## 了解用户如何将“数据问答”(Ask Data) 功能与镜头结合使用

对于数据源所有者和镜头作者，“数据问答”(Ask Data) 功能提供了一个仪表板，其中显示最常见的查询和字段、用户单击的可视化项结果数以及其他有用信息。筛选器使您能够将数据范围缩小到特定用户和时间范围。这些统计信息可帮助您进一步优化镜头以提高用户的成功率。

**注意：**如果使用 Tableau Server，您可以在 Tableau Server 存储库中访问此数据来创建自定义仪表板。

1. 在 Tableau Server 或 Tableau Cloud 中，导航到一个镜头页面。
2. 在“数据问答”(Ask Data) 功能文本框的左侧，单击“数据问答提示”图标。
    
    ![将鼠标悬停在信息图标上，显示“数据问答”(Ask Data) 功能提示工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_tips_button.png)
3. 在提示对话框的左下角，单击“使用情况分析”。

## 让用户通过电子邮件向您发送有关镜头的问题

镜头所有者还可以允许用户通过电子邮件向您发送有关数据结构、预期结果等方面的问题。默认情况下此选项处于启用状态，但您可以使用以下步骤将其关闭。

1. 在 Tableau Server 或 Tableau Cloud 中，导航到一个镜头页面。
2. 在“数据问答”(Ask Data) 功能文本框的左侧，单击上方[了解用户如何将“数据问答”(Ask Data) 功能与镜头结合使用](#See)中显示的“i”。
3. 在提示对话框的底部，单击“联系镜头作者”旁边的眼睛图标以启用或禁用反馈。
    
    ![针对“数据问答”(Ask Data) 功能对话框进行优化，突出显示眼睛图标以显示或隐藏联系镜头作者的选项。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_disable_feedback.png)

## 发布和观看镜头的权限

对于仪表板中的“数据问答”(Ask Data) 功能对象，应该不需要更改权限：默认情况下，现有工作簿作者可以创建镜头，而现有仪表板受众可以查看它们。但作为参考，这里详细概述了仪表板和通过数据源页面直接访问所需的镜头权限。

若要创建和发布镜头，用户需要：

- Creator 或 Explorer 用户角色
- 数据源的“镜头创建”权限（默认情况下从“连接”权限继承）
- 镜头发布到的父项目的写入权限

若要访问已发布的镜头并与之交互，用户需要：

- Viewer 角色或更高权限角色
- 数据源的连接权限
- 镜头的查看权限

**注意：**默认情况下，“查看”之类的镜头权限反映了项目对工作簿的权限。如果 Tableau 管理员想要更改默认镜头权限，则可以为每个项目单独更改，也可以使用权限 API 批量更改。

<!-- document id=17d2b780067dc878dec30afb6f5d1bc44635b4d1e2fa28096e5f413ba083e561 url=/tableau/next/zh-cn/online/groups_delete.md -->

[跳转到主要内容](#main-content)

# 删除组

您可以从中删除任何组（除“所有用户”组之外）。删除组时，将移除该组中的用户，但不会从站点删除这些用户。

1. 以站点管理员身份登录到Tableau Cloud 。
2. 从左侧的导航窗格中，单击“组”。
3. 在“组”页面上，选择一个或多个要删除的组。
4. 选择“动作”\>“删除”。
    
    ![组页面，显示两个选定的组，并突出显示“删除组”操作。](/tableau/next/zh-cn/online/zh-cn/Img/groups6.png)

## 删除组的影响

### 具有按需访问权限的组

自 2023 年 10 月起，部分站点可为组组启用按需访问功能。当您删除一个或多个启用了按需访问功能的组时，这些组成员无法再访问嵌入的 Tableau 内容。

### 组集中的组

从 2024 年 6 月 (Tableau 2024.2) 开始，可以将组添加到组集中。如果内容权限依赖于组集，当用户属于组集中的所有组时，会评估内容能力。如果删除属于组集的组，则当内容权限依赖于组集时，它可以更改用户对 Tableau 内容的访问权限。

<!-- document id=15d2ca9f77a3d2446f43676c916a3a72d373dc894ef1b8ebfde4722cc9575b91 url=/tableau/next/zh-cn/online/lwc_uaf.md -->

[跳转到主要内容](#main-content)

# 利用 Tableau Lightning Web 组件实现用户属性函数 (UAF)

您可以将用户属性函数 (UAF) 与 Tableau 视图和 Pulse Lightning Web 组件 (LWC) 一起使用，根据查看可视化项的用户的属性显示特定数据。[用户属性函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm) 提供行级安全性，以便查看可视化项的人只能看到与他们相关的数据。有关 UAF 的详细信息，请参见[利用用户属性函数释放个性化分析的力量](https://www.tableau.com/zh-cn/blog/unlock-power-personalized-analytics-user-attribute-functions)。

先决条件

- 为 Tableau Lightning Web 组件配置了具有令牌身份验证的单点登录 (SSO)。请参见[使用令牌身份验证配置 Tableau Lightning Web 组件和单点登录 (SSO)](https://help.tableau.com/current/server/zh-cn/lwc_seamless_auth.htm)。
- Tableau 配置为在身份验证工作流中捕获用户属性。请参见[允许捕获用户属性](https://help.tableau.com/current/server/zh-cn/lwc_seamless_auth.htm#allow-capture-of-user-attributes)。
- 要嵌入的 Tableau 内容包括[用户属性函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm)。有关如何在 Tableau 工作簿中使用用户属性函数的示例，请参见[确保内容作者包含用户属性函数](https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html#4-ensure-the-content-author-includes-user-attribute-functions)。

## Salesforce 中的 Tableau UAF 声明定义

Tableau UAF 声明定义允许您在 JWT 中包含对用户属性的声明。这些属性的值可以从 Salesforce 中的“Account”（帐户）、“User”（用户）、“Opportunity”（商机）或“Case”（案例）对象中提取。当与 Tableau 内容中的用户属性函数结合使用时，仅显示与指定属性匹配的数据。

例如，Tableau 仪表板可以配置为仅显示其 \[州/省/市/自治区\] 数据列中的值与属性“state”的 JWT 声明中的某个值匹配的销售数据。

**语法**：USERATTRIBUTEINCLUDES（'attribute\_name'，预期值）

**示例**：USERATTRIBUTEINCLUDES('state'，\[州/省/市/自治区\])

在 Salesforce 中创建声明定义可以将适当的用户特定信息包含在 JWT 中。在此示例中，可以通过从“账单州/省/市/自治区”字段中提取值，用当前用户作为帐户所有者的帐户的值填充属性“state”。

**声明定义示例**

- 定义名称：state\_Account\_BillingState
- 属性名称：state
- 目标对象：帐户
- 目标对象字段：账单州/省/市/自治区
- 查看者目标对象关系：当前查看者是帐户所有者

对于在华盛顿州、俄勒冈州和加利福尼亚州拥有帐户的销售代表，JWT 将包含“state”声明，其值为 \[WA, OR, CA\]。Tableau 仪表板将仅显示 \[州/省/市/自治区\] 值与 WA、OR 或 CA 匹配的数据。

## Experience Cloud 中对外部用户的支持

通过 Experience Cloud 站点访问 Tableau 的**外部用户**支持用户属性函数 (UAF) 和主机映射。这允许将与登录的外部用户关联的 Salesforce 属性包含在 JWT 中，从而启用基于该用户数据的个性化 Tableau 视图。

外部用户包括经过身份验证的 Experience Cloud 用户，例如合作伙伴和客户社区用户。**不支持来宾用户。**

为确保功能正常，请执行以下操作：

- 外部用户必须有权访问 UAF 和主机映射使用的相关记录。
- 必须将以下对象配置为允许外部访问（例如，Public 只读）：
    - 分析用户属性函数令牌
    - 主机映射
- UAF 声明必须由具有“设置”访问权限的内部 Salesforce 用户创建和配置。

使用适当的共享配置后，UAF 和主机映射对外部用户的功能将与对内部用户的功能相同。

## 创建定义

若要创建用户属性定义，请执行以下步骤：

1. 从您的 Salesforce 应用中，选择右上角的齿轮，然后选择“Setup”（设置）。
2. 在左侧导航窗格的“Quick Find”（快速查找）搜索栏中输入“Tableau”。
3. 选择“Tableau UAF Claims Definition”（Tableau UAF 声明定义）设置页面。
4. 选择“Create New”（创建新定义）。
5. 填写定义值：
    
    1. 定义名称：输入一个唯一名称。（例如：state\_Account\_BillingState）
    2. 属性名称：输入Tableau中用户属性函数指定的属性名称。（例如：state）
    3. 目标对象：选择您想要从中提取值的目标对象。Tableau LWC 目前支持用户和帐户对象。
    4. 目标对象字段：选择您想要从中提取值的目标对象上的字段。（例如：账单州/省/市/自治区）
    5. 查看者目标对象关系：选择当前查看者和目标对象之间的关系。（例如：当前查看者是帐户所有者）。
6. 选择“保存”。或者，如果要返回 Tableau UAF 声明定义设置页面而不保存，请选择“取消”。

## 向 Tableau Lightning Web 组件页面添加定义

### 主页、应用程序和记录 Lightning 页面

若要添加定义，请执行以下操作：

1. 选择“选择…”。
2. 使用箭头将可用的定义移动到“已选定”字段。
3. 选择“确定”。
4. 对同一页面上的所有 Tableau Lightning Web 组件重复上述步骤。有关详细信息，请参见[同一页面上多个组件的注意事项](#Consider)。

### Experience Cloud 页面和 Utility Bar

输入以逗号分隔的 UAF 声明定义名称列表。若要复制定义名称，请从 Salesforce 应用程序中导航到“Tableau UAF Claims Definition”（Tableau UAF 声明定义）设置页面，然后选择“Copy”（复制）。

### 同一页面上多个组件的注意事项

如果将多个 Tableau 视图或 Tableau Pulse Lightning Web 组件添加到同一页面，则每个组件必须具有相同的一组 UAF 定义名称。只有一个组件向 Tableau 进行身份验证，并且该会话将用于加载两个组件。这意味着无论哪个组件执行身份验证，两个组件的相关用户属性信息都必须存在于该会话中。

例如：

- 如果您有两个 Tableau 视图组件，其中一个需要定义 A 中的用户属性信息，另一个需要定义 B 中的用户属性信息，则这两个组件都必须同时包含定义 A 和 B。
- 如果 Tableau 视图组件需要定义 A，但同一页面上的 Tableau Pulse 组件不需要任何用户属性信息，则两个组件都必须包含定义 A。

## 删除定义

若要删除用户属性定义，请执行以下步骤：

1. 从您的 Salesforce 应用中，选择右上角的齿轮，然后选择“Setup”（设置）。
2. 在左侧导航窗格的“Quick Find”（快速查找）搜索栏中输入“Tableau”。
3. 选择“Tableau UAF Claims Definition”（Tableau UAF 声明定义）设置页面。
4. 针对要删除的定义选择“Delete”（删除）。

### 主页、应用程序和记录 Lightning 页面

如果删除已添加到 Tableau LWC 的定义，请刷新 Lightning App Builder 中的页面以更新可用的定义。已删除的定义将被自动移除。

### Experience Cloud 页面和 Utility Bar

已删除的定义不会自动从 Tableau LWC 组件字段中移除。“UAF 定义名称”组件字段中的已删除定义不会导致问题，但会造成不必要的和令人困惑的混乱。若要从 Tableau LWC 组件字段中移除定义，请选择“UAF 定义名称”字段，然后手动删除不再使用的任何名称。

<!-- document id=50405142d7dae9970eb38c33d486f89d77834ebe2031902a5229140f245ed633 url=/tableau/next/zh-cn/online/adminview_bridge_datasources.md -->

[跳转到主要内容](#main-content)

# 到 Bridge 连接数据源的流量

“到 Bridge 连接数据源的流量”管理视图使站点管理员能够查看包含实时连接的数据源的使用情况。此视图可帮助您确定使用量最大的数据源以及较少使用的数据源。可通过选择 Bridge 客户端名称、数据源以及时间范围来筛选看到的信息。

此视图显示过去 30 天内 Tableau Cloud 活动的快照。

![显示过去七天 Bridge 数据源使用情况和用户活动的仪表板。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_bridge_datasources.png)

视图顶部显示在指定时间范围内（默认值为过去 7 天）数据源的使用情况：

- 项目使用的数据源用量是多少 — 此视图基于设置的筛选器显示项目的数据源总用量。将光标悬停在标记上以查看数据源的使用次数。选择标记以根据所选的内容更新视图上的其他部分。
- 数据源总用量(按天)是多少 — 此视图基于设置的筛选器显示按天列出的数据源总用量。将光标指针悬停在折线上以查看计数。选择点以根据所选的内容更新视图上的其他部分。

视图底部的两个条形图显示按“最少交互”筛选出的结果。这些条形图显示使用量最大的数据源，以及最经常使用数据源的用户。只会显示交互计数大于或等于最小交互值的那些数据源和用户：

- 使用次数最多的是哪些数据源 — 此视图列出使用次数最多的数据源。与视图的其他部分类似，信息由筛选器和您所选的任何内容限制。
- 谁最经常使用数据源 — 此视图显示最经常使用数据源的用户。此项受筛选器和您所选的任何内容影响。

<!-- document id=7e8ef30ebc8d76fc17d4a1a868a291e9b629e6dccaf50e03479ad2f8241ed2fc url=/tableau/next/zh-cn/online/data_fresh_section.md -->

[跳转到主要内容](#main-content)

# 刷新 Tableau Cloud 上的数据

本部分中的主题介绍如何手动刷新数据以及计划数据刷新。

## 此部分中的其他文章

<!-- document id=5a6cb301c4d00cc8f425cb906e9904411e603b508035be4283991c5f5c75e851 url=/tableau/next/zh-cn/online/data_stories_parameter_refresh.md -->

[跳转到主要内容](#main-content)

# 刷新 Tableau 数据故事中的参数

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

如果您已将参数添加到仪表板并正在使用数据故事，您会注意到单击参数会刷新您的可视化项，但不会刷新故事。发生这种情况是因为参数不会像筛选器那样刷新基础数据。

若要使用参数数据刷新您的 Tableau 数据故事，请向您的仪表板添加一个“刷新”按钮，以更新您的故事以与您的参数保持一致。

1. 在工作簿中创建新工作表。
2. 使用以下信息在新工作表中创建一个计算字段：

> > 名称：Refresh
> > 
> > 内容：“refresh”

![一个名为“Refresh”并包含“refresh”一词的计算字段](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_parameter_calcfield.png)

1. 单击“确定”，然后将新计算字段（“Refresh”）拖到新工作表上。
2. 右键单击该字段，并单击“显示标题”以隐藏标题。

![选择了“显示标题”的“Refresh”字段的打开菜单。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_parameter_showheader.png)

1. 为您的按钮选择一个形状。

![选择了方形的“标记”的打开菜单。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_parameter_shape.png)

1. 返回仪表板并将包含刷新按钮的工作表拖到仪表板上的参数旁边。
2. 将光标悬停在按钮上，选择“更多选项”，然后单击“标题”以隐藏标题。
3. 将光标悬停在按钮上，然后单击“用作筛选器”。

![对象处于选定状态，筛选器图标已单击，并且“用作筛选器”已选定。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_parameter_refreshfilter.png)

1. 调整您的参数，然后单击新的刷新按钮。该按钮会更新您的故事以与参数保持一致。

<!-- document id=b499fcf2cf8dcb4005487c845faf31435339ec635ddf9658be8fcbb054a3bded url=/tableau/next/zh-cn/online/Dynamic_Color_Ranges.md -->

[跳转到主要内容](#main-content)

# 动态颜色范围

使用动态颜色范围，您可以将颜色范围链接到参数的值，从而使您能够更有效地可视化数据趋势。通过使用参数动作，可以根据选择或标记悬停来动态更新颜色范围，并且可以将颜色范围的起点、中心点和终点链接到参数。这不仅允许自定义，还有助于忽略可能使调色板产生偏差的异常值数据。您还可以在仪表板上的可视化项之间同步范围值，从而更快地获得见解。

## 使用支持的字段和调色板类型

您可以将动态颜色范围与连续字段（通常是度量）结合使用。它们可应用于 Tableau 中的定量调色板，包括连续调色板和发散调色板。

### 连续调色板

通常，连续调色板显示浓度不同的单一颜色。您必须至少指定连续颜色范围中的两种结束颜色。  
  
![橙色连续调色板选项。](/tableau/next/zh-cn/online/zh-cn/Img/dcr_sequential.png)

### 发散调色板

发散调色板像是两个连续的调色板，它们中间共用一种颜色，但极端不同。这种类型的调色板显示两个范围的值，使用颜色强度（多暗或多亮）来显示数字的大小，使用实际颜色（橙色或蓝色）来显示数字所在范围。发散调色板最常用于区分正数与负数。  
  
![Tableau 中的红色和蓝色发散调色板选项。](/tableau/next/zh-cn/online/zh-cn/Img/dcr_divergeng.png)

## 根据标记选择配置动态颜色范围

从 Tableau 25.3 开始，您可以根据所选标记自动更新颜色范围，从而消除了对单独参数和参数动作工作流的需求。

配置颜色范围的起点、中心点或终点：

1. 在“标记”卡上选择“颜色”，然后选择“编辑颜色…”
2. 从所需范围点（起点、中心点或终点）的下拉菜单中，选择“交互时更新”。
3. 返回到您的可视化项，然后单击标记以为所选范围点设置相应的值。

对要动态更新的任何其他范围点重复此过程。  
  
![“编辑颜色”对话框，其中包含用于设置起点、中心点和终点以在交互时更新的选项。](/tableau/next/zh-cn/online/zh-cn/Img/dynamic_color_selection.png)

## 使用现有参数配置动态颜色范围

您可以在现有参数中使用的任何定量连续字段上配置动态颜色范围。

1. 设置参数后，在“标记”卡上选择“颜色”。
2. 选择“编辑颜色…”
3. 在“编辑颜色”对话框中，展开起点和终点旁边的下拉列表。您可以选择“自动”或“自定义”，也可以使用参数来设置颜色范围以通过参数动作动态更新。  
      
    ![使用“编辑颜色”对话框配置动态颜色范围。](/tableau/next/zh-cn/online/zh-cn/Img/dcr_edit_colors.png)

## 将动态颜色范围连接到参数动作

您可以在参数控件中键入所需的任何值，以确保更有效的颜色对比度。对于更具交互性的解决方案，您可以配置参数，以便颜色范围点与参数动作相关联。

1. 为此，请创建具有以下属性的[参数动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_parameters.htm#Create)：
2. 将“源工作表”设置为工作表或仪表板上的工作表。
3. 将 “目标参数”设置为要绑定到动态颜色范围的参数。
4. 将“源字段”设置为用于对颜色进行编码的连续度量。
5. 设置“聚合”：
    
    - 使用“最小值”或“第一个四分位点”作为颜色范围的起点。
    - 使用“最大值”或 “第三个四分位点”作为颜色范围的终点。
6. 确保将“清除选择”设置为“保留当前值”。这可确保您的调色板更改在交互之间保持不变。  
      
    ![“添加参数动作”对话框，其动态颜色范围设置为连续字段。](/tableau/next/zh-cn/online/zh-cn/Img/dcr_parameteraction.png)

使用此参数动作，您的颜色范围会在您与可视化项上的标记交互时动态更新。

## 了解限制和极端情况

动态颜色范围不会在[故事](https://help.tableau.com/current/pro/desktop/zh-cn/stories.htm)中更新。

如果删除用于动态颜色范围的参数，则范围值将设置为最新的参数值。下次编辑颜色时，您将收到一条消息，要求为动态颜色范围选择新参数。

<!-- document id=e941dd48a8ab53bd518c22b4733e1b737be823782982b7b4b2a6b0cf6bad1bae url=/tableau/next/zh-cn/online/ipa_online_whats_new.md -->

[跳转到主要内容](#main-content)

# 发布亮点

**注：**创新通过全球基础设施交付至 Tableau Cloud。对它们的访问可能早于或晚于宣布的时间。

在 2025 年 11 月版 Tableau Cloud 中：

- **对数据模型表的注释：**您可以在数据模型中的表上添加富文本注释。
- **Tableau Agent 权限：**客户可以为您站点上的所有用户或仅作为选定安全组成员的用户启用 Tableau 中的 AI 功能访问权限。
- **OIDC 和 SAML 工作流中的用户属性：**您现在可以包括在登录期间通过 OIDC 声明或 SAML 断言传递的用户属性，以自定义和控制用户可以看到的内容。
- **数据提取加密密钥的外部密钥管理**：允许客户直接控制其用于加密数据提取的 AWS Key Management Servic (KMS) 加密密钥。
- **Tableau 可信扩展程序：**Tableau Exchange 中经过安全审查的扩展程序的新子集现在可用，这些扩展程序由 Tableau 托管，提供受管控的无缝功能。
- **Tableau Mobile 更改：**用于恶意软件检测的 Tableau Mobile 应用程序安全设置已停用。

[查看完整列表](https://help.tableau.com/current/online/zh-cn/whatsnew_online.htm)

## 此部分中的其他文章

<!-- document id=abbd0f55b1c5aaef2894d0eb719d6d215fc4d43af56ae80085a800b44c5c169c url=/tableau/next/zh-cn/online/to_bridge_livequery.md -->

[跳转到主要内容](#main-content)

# 发布包含实时连接的私有网络数据源

本主题介绍数据源所有者如何发布使用私有数据实时连接的数据源。连接到私有网络（包括私有云）数据的数据源依赖于 Tableau Bridge。本主题中描述的任务假定 Bridge 已设置，并且由站点管理员维护。

- Bridge 支持使工作簿中嵌入的数据源的数据保持最新。若要发布具有嵌入数据源的工作簿，请参见[使用嵌入式数据源](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_eds.htm)。
- 若要发布使用实时连接的基于私有云的数据源，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。
- 若要使用实时连接发布虚拟连接，请参见[创建虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm##select-table-mode-live-or-extract)

## 发布数据源

以下过程介绍如何发布使用实时连接的数据源。为了支持连接到私有网络数据的数据源的实时连接，Bridge 使用称为实时查询的功能。为了使数据源保持最新，Bridge 会直接查询数据库并返回查询结果，以供在数据源中使用。

1. 在 Tableau Desktop 中，创建数据源。
2. 选择“服务器”\>“发布数据源”以开始发布过程。如果您尚未登录到 Tableau Cloud，系统将提示您登录。
3. 在“将数据源发布到 Tableau Cloud”对话框中，配置各种数据源选项，并确保执行以下操作：
    
    - 在“身份验证”下，单击“编辑”并选择“嵌入式密码”或“服务器运行身份帐户”，具体取决于您看到的选项。
    - 根据数据源连接到的数据或者您配置数据源的配置方式，该对话框可以默认发布实时连接，或为您提供发布实时连接或数据提取的选项。如果提供了选项，请选择“维护实时连接”。
4. 单击“发布”按钮。这将打开一个浏览器窗口，并显示 Tableau Cloud。
5. 在“发布完成”对话框中，单击“完成”按钮。

<!-- document id=df0bbeec5c1e8e9583453514523856ef0fbc23f3964c6497b449e720d18d5efd url=/tableau/next/zh-cn/online/dm_vconn_publish_save.md -->

[跳转到主要内容](#main-content)

# 发布虚拟连接并设置权限

当您在虚拟连接编辑器中工作时，所做的更改会在您工作时自动保存为草稿。若要与其他用户共享新的虚拟连接，您需要发布它。

## 保存草稿

您可以通过单击工具栏中的保存图标 ![“保存”图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Save_16px_medium.png) 或从菜单中选择“文件”\>“保存草稿”来手动保存草稿。

编辑已发布虚拟连接时，连接在当前已发布状态下仍可供用户使用。在编辑器中处理连接时，您可以将更新另存为草稿。若要与其他用户共享虚拟连接的更新，您需要发布它。

### 正在起草

如果您在更新已发布的虚拟连接时关闭编辑器，则下次在 7 天内在编辑器中打开连接时，您可以选择继续编辑现有草稿、开始新草稿或通过单击“取消”打开处于当前已发布状态的连接。

![“草稿已经存在”消息](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_draft_exists.png)

若要返回未发布的虚拟连接的草稿版本，您需要关闭编辑器**之前**手动保存草稿的 URL。下次要在 7 天内处理连接时，可以使用 该URL 在编辑器中打开草稿。例如：

`https://yourserver.test.com/published-connection-editor/?draft=d1789edc-5d9f-40ae-988d-9fc879f37a98`

## 发布连接

发布新连接：

1. 单击编辑器右上角的“发布”按钮，或从菜单中选择“文件”\>“发布”。
2. 在“发布”对话框中：
    1. 在“名称”字段中键入名称。
    2. 选择一个项目来保存连接。
3. 单击“发布”。

若要发布更新的连接，请单击编辑器右上角的“发布”按钮，或从菜单中选择“文件”\>“发布”。

## 设置虚拟连接的权限

发布虚拟连接后，您需要设置权限，以便其他人可以使用它。默认情况下，所有用户都可以查看连接，即看到它在 Tableau 中的“虚拟连接”下列出，但除非您将“连接”能力设置为“允许”，否则只有您和管理员才能使用虚拟连接。有关“连接”能力的详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm#VConnOverviewPermissions)。

设置权限：

1. 导航到虚拟连接。
2. 打开“操作”菜单 (...)，并单击“权限”。
3. 选中“连接”图标下的框，以便所有用户都可以使用连接。
    
    ![连接“允许”权限复选框](/tableau/next/zh-cn/online/zh-cn/Img/dm_vconn_connect_allowed.png)
    
    > [!TIP]
    > 
    > **提示：**如果您只想将权限授予某些用户或组，您可以添加其他规则。
4. 单击“保存”。

有关 Tableau 内容上的权限的详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#contentlevel-permissions)。有关在发布 Tableau 内容（例如使用虚拟连接的数据源或工作簿）时嵌入密码的信息，请参见 Tableau Server 帮助中的[虚拟连接](https://help.tableau.com/current/server/zh-cn/publishing_sharing_authentication.htm#virtual-connection-embedded-password)。

## 谁可以执行此操作

若要发布虚拟连接或设置权限，您必须

- 拥有虚拟连接所连接到的数据库的凭据，并且
- 是服务器或站点管理员，或是 Creator。

## 后续步骤

发布虚拟连接并设置其权限后，您可以[使用虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_use.htm)。

<!-- document id=53ce2cca73179ad07210674f6cc06249c67ef13f75367d183fc5dd7e1922085b url=/tableau/next/zh-cn/online/sites_addusers.md -->

[跳转到主要内容](#main-content)

# 向站点添加用户

需要访问 Tableau Cloud 的任何人（无论是浏览、发布、编辑内容还是管理站点）都必须作为用户添加。管理员可以通过以下选项添加用户：

- 单独输入用户的用户名（电子邮件地址）。
- 通过您使用[CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)创建的 CSV 文件[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)。

本主题适用于站点管理员，讨论如何在站点级别添加用户。对于将用户添加到 Tableau Cloud Manager 的云管理员，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

### 添加用户

1. 在登录 Tableau Cloud 站点时，选择**“用户”**。
2. 在“用户”页面上，单击“添加用户”，然后单击“按用户名添加用户”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/users_add_online.png)
3. 选择您希望导入的用户登录 Tableau Cloud 时使用的身份验证方法。如果站点上未配置身份验证，则将为导入的用户分配带有 MFA 的 Tableau 身份验证方法。
    
    **注意：**在添加用户后，您随时可以转到“用户”页面以更改用户的身份验证类型。
4. 在**“输入用户名”**文本框中，输入用户的用户名（电子邮件地址格式）。如果添加多个用户，请用分号分隔每个用户名。
    
    例如，_tdavis@example.com; jjohnson@example.com; hwilson@example.com_
5. 从下拉列表中选择一个站点角色，以便将该站点角色分配给您添加的所有用户。
    
    有关站点角色定义，请参见[“设置用户的站点角色”](https://help.tableau.com/current/online/zh-cn/users_site_roles.htm)。
6. 单击“添加用户”。

如果新用户的用户名已经与 tableau.com 上的帐户关联，则此用户需要使用此帐户的现有电子邮件地址和密码登录。

如果新用户的用户名尚未与 tableau.com 上的帐户关联，则此用户需要提供姓名和密码。

在用户提供这些值之前，其在 Tableau Cloud 用户列表中的条目将显示电子邮件地址，前面有一个句点。例如：

`.snguyen@example.com`

用户登录后，条目将更新为显示全名。例如：

`Susan Nguyen`

<!-- document id=8ef9e41c58a0a7ca8cf395378616928fdff544470a21fba20121c1fb5165348f url=/tableau/next/zh-cn/online/dm_catalog_enable.md -->

[跳转到主要内容](#main-content)

# 启用 Tableau Catalog

[Tableau Catalog](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 发现 Tableau Cloud 站点或 Tableau Server 上的所有内容（包括工作簿、数据源、工作表、指标和流程）并对其进行索引。(Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)。) 索引用于收集有关内容的信息，或收集有关内容的架构和世系的元数据。然后，Catalog 通过元数据确定 Tableau Cloud 站点或 Tableau Server 上的内容使用的所有数据库、文件和表。

Catalog 随 Data Management 许可证一起提供。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。

除了 Catalog 外，还可以分别通过 [Tableau 元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html) 和 Tableau REST API（使用[元数据方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm)）访问有关内容的元数据。

## Tableau Cloud 上的 Catalog

使用 Data Management 为 Tableau Cloud 授予许可时，将会自动启用 Catalog。

使用 Data Management 为 Tableau Cloud 站点授予许可后，将立即为 Tableau Cloud 站点上已存在的内容建立索引。为内容建立索引所需的时间取决于您拥有的内容量。在对内容进行初始索引之后，Catalog 将监视新发布的内容和其他资产更改，并继续在后台建立索引。

## Catalog 疑难解答

使用 Catalog时，您或您的用户可能会遇到以下问题之一。

#### 超时限制和超过节点限制消息

为了确保必须返回大量结果的 Catalog 任务不会占用所有 系统资源，Catalog 会同时实施超时和节点限制。

- **超时限制**
    
    当 Catalog 中的任务达到超时限制时，您和您的用户将看到以下消息：
    
    “_显示部分结果，超过请求时间限制。请稍后重试。_”或 TIME\_LIMIT\_EXCEEDED
- **节点限制**
    
    当 Catalog 中的任务达到节点限制时，您和您的用户将看到以下消息：
    
    NODE\_LIMIT\_EXCEEDED

<!-- document id=7778eee231ef36434743cefd2870d204a8237b4d27ee5f949615faf0ebea0e4d url=/tableau/next/zh-cn/online/to_refresh_enable_emails.md -->

[跳转到主要内容](#main-content)

# 数据提取刷新失败时通知所有者

由于各种原因，如嵌入式凭据或文件路径过时，计划数据提取刷新可能无法完成。对于直接从 Tableau Cloud 运行的计划刷新，刷新连续失败 5 次之后，Tableau Cloud 会暂停计划，直到站点管理员或数据源所有者采取行动以解决原因为止。

站点管理员可以启用 Tableau Cloud，以在其计划数据提取刷新未成功完成时向数据源的所有者发送电子邮件。然后，数据源所有者可以选择单独退出其帐户设置。

电子邮件包含以下信息：

- 数据提取或工作簿名称。
- 上次成功刷新的日期和时间。或者，如果上次刷新时间超过 14 天前，则电子邮件会显示“未在最后 _N_ 天”。
- 刷新连续失败次数。
- 采取建议的措施以解决故障原因，如更新嵌入式凭据或文件路径，并链接到 Tableau Cloud 以采取措施。

当收到有关 Tableau Bridge 刷新的数据源的电子邮件时，情况将有所不同。有关详细信息，请参见本主题后面的[Tableau Bridge 刷新的差异](#sync)。

## 启用刷新失败电子邮件

作为站点管理员，您可以使用下面的过程为站点启用（或禁用）刷新失败电子邮件。

1. 以站点管理员身份登录到 Tableau Cloud，并单击“设置”。
2. 在“管理通知”下，选中或清除复选框为所有站点用户允许或禁用通知。

如果启用刷新失败电子邮件，则个别用户可以在其个人帐户设置中选择不接收刷新失败电子邮件。

## 其他人拥有的内容的刷新失败电子邮件

**注意：**此选项不适用于通过 Bridge 创建或刷新的已发布数据源。

默认情况下，如果刷新数据提取时出现问题，只有内容所有者才会收到通知。但是，其他用户也可以选择在数据刷新提取失败时接收通知。

如果其他用户想要在数据提取失败时启用电子邮件通知，请在数据提取仪表板中打开上下文菜单 (**...**)，选择“数据提取失败通知”，然后选择**“是”**以接收通知，或选择**“否”**以停止通知。

![包含数据提取失败通知的菜单](/tableau/next/zh-cn/online/zh-cn/Img/extract_failure_notify_menu.png "上下文菜单")

**注意**：如果当前用户是数据提取的所有者，则无法使用上下文菜单选择接收或禁用失败通知。

## Tableau Bridge 刷新的差异

对于通过 Tableau Bridge 刷新的数据源，通知会有所不同。有关详细信息，请参见[管理 Tableau Bridge 的通知](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_alerts.htm)。

<!-- document id=de35cf0ae8aefd87275709f1bcd0cf684d7b7611b0e791ec59f94c47ea7018a4 url=/tableau/next/zh-cn/online/enable_support_access.md -->

[跳转到主要内容](#main-content)

# 启用支持访问权限

Tableau Cloud 管理员可允许经过批准的 Tableau 支持技术人员访问其 Tableau Cloud 站点来帮助进行客户支持案例疑难解答。默认情况下，已为所有站点禁用此功能。启用功能以允许支持访问权限。

1. 在 Web 浏览器中，以站点管理员身份登录到 Tableau Cloud，并转到要在其中启用支持访问权限的站点。
2. 从导航面板中，单击“设置”。
3. 在“Tableau 支持访问”下，选择**“允许 Tableau 支持访问您的站点”**。
4. 单击“保存”。

如果启用，则会为 Tableau 支持技术人员分配**“支持用户”**角色，并为他们授予其您的站点及其内容的管理员级别访问权限。Tableau 支持技术人员使用此访问权限来收集信息，以便诊断和重现问题。Tableau 支持技术人员不会对站点进行更改，除非您授权他们这样做。

只能为 Tableau 支持技术人员分配“支持用户”角色。您不能为新的或现有站点用户添加此角色。分配有**“支持用户”**角色的用户不会计入站点的用户限制。若要查看在站点上具有**“支持用户”**角色的用户，请单击**“用户”**选项卡。

## 禁用支持访问权限

如果禁用支持访问权限，则已登录到站点的具有“支持用户”角色的用户将会自动注销。如果不禁用支持访问权限，则任何具有“支持用户”角色的用户都需要在最多 16 天内删除自己。“支持用户”拥有的任何内容都将重新分配给任期最长的站点管理员。

<!-- document id=5380341ead1739f9cb9aa611f9ba1cb1a5bd57d88fb8022e0d7f4bd58097b456 url=/tableau/next/zh-cn/online/recycle_bin.md -->

[跳转到主要内容](#main-content)

# 回收站

回收站允许站点管理员、服务器管理员和具有 Explorer（可发布）或 Creator 站点角色证的作者恢复以前删除的项目、工作簿、数据源和流程。

您可以从 Tableau 站点的主页访问回收站。展开侧窗格，然后选择“回收站”。如果您没有看到回收站，则该功能必须由您的管理员启用。

> [!IMPORTANT]
> 
> **重要信息**：随着 Tableau Cloud 版本 2025.1 中回收站的发布，技术支持团队不再接受帮助恢复意外删除内容的请求。这包括从回收站中删除的内容。

## 回收站中存储了什么内容？

启用回收站后，以下内容类型在删除后会暂时移至回收站：

- 工作簿（包括修订历史记录、视图、嵌入式凭据、嵌入式数据源和数据提取）
- 数据源（包括数据提取和嵌入式凭证）
- 项目（包括包含的工作簿和数据源）
- Tableau Prep 流程（注意：Tableau Prep 流程草稿仍会被永久删除，并且不会进入回收站）

但是，当您删除和恢复工作簿、数据源和项目时，原始内容的某些元素将会丢失，其中包括：

- 自定义视图
- 订阅
- 数据驱动型通知
- 权限
- 关于已删除项的汇总统计信息（查看和使用计数器）
- 标记
- 收藏夹信息（如果收藏了该项）
- 注释
- 流程计划
- 数据提取刷新计划

> [!TIP]
> 
> **提示**：如果您没有看到回收站中预期的内容，请验证是否选择了正确的“内容类型”。

### 内容：注意事项和最佳做法

- 删除后，支持的内容类型将保留其原始名称。如果恢复到的项目已经具有同名项，则恢复操作将失败。为了解决此问题，请恢复到不同的项目，重命名刚刚恢复的内容，然后将内容移至所需的位置。
- 存储在回收站中的工作簿和数据源仍然占用站点的空间。如果工作簿或数据源使用数据提取，则该数据提取大小仍会计入站点配额。
- 删除后，支持的内容类型不会改变其所有者。最初拥有内容的用户仍被视为所有者。
- 恢复时，恢复的项将采用为您恢复到的容器设置的默认权限。恢复关键内容时，操作用户应验证是否按需要设置了权限。恢复操作不会恢复原始内容权限。
- 用户可以在回收站中查看他们删除的内容，即使他们不是管理员或不拥有这些内容。

### 项目：注意事项和最佳做法

项目可以包含多种内容或嵌套项目。启用回收站后，请注意以下有关项目的情况。

**注意**：在原始删除操作和恢复内容时，回收站会考虑嵌套项目的分层结构。例如，您可以从根项目中删除整个项目分支，以将根项目和所有嵌套项目发送到回收站；如果您恢复根项目（并且所有嵌套项目仍在回收站中），则可以从回收站恢复整个项目分支。但是，当您从回收站中删除内容时，将不会考虑分层结构。若要从回收站中删除原始项目分支中的所有项目，您需要单独删除每个项目。

**示例项目**：项目 A 包括 2 个工作簿（A 和 B）、一个数据源和一个流程。

- 当最初删除项目并将其发送到回收站时，该项目中与回收站兼容的所有内容都将单独存储。对于项目 A，您将在回收站中看到项目、工作簿 A、工作簿 B 和数据源。其他类型的内容（如流程）会被立即删除并且无法恢复。
- 可以单独恢复或删除项目中的所有兼容内容。例如，您可以从项目 A 中永久删除工作簿 A，仅在回收站中留下项目、工作簿 B 和数据源。
- 如果您恢复项目，则当时仍存储在回收站中的所有兼容内容也将被恢复。对于项目 A，如果您已经删除工作簿 A，然后恢复项目 A，则该项目将仅恢复工作簿 B 和一个数据源。
- 如果从回收站中删除项目，则仅删除该项目。例如，如果您从回收站中删除项目 A，则工作簿 B 和数据源将保留在回收站中，直到它们被单独删除、恢复或存储时间到期。

**示例项目**：项目 A 包括工作簿 A、工作簿 B、数据源以及包含工作簿 C 的嵌套项目 B。

- 如果已删除的项目包含嵌套项目，则在恢复顶级项目时，任何当时仍存储在回收站中的嵌套项目都将被恢复。例如，恢复根项目 A 会将顶级项目 A、工作簿 B、数据源、项目 B 和工作簿 C 恢复到选定的恢复位置。
- 回收站中的嵌套项目可以独立于其顶级项目进行恢复。如果独立恢复嵌套项目，然后稍后恢复顶级项目，则顶级项目恢复时不会包含嵌套项目的任何内容。例如，如果您单独恢复项目 B，然后稍后恢复项目 A，则项目 A 将与顶级项目、工作簿 B 和数据源一起恢复。恢复后的项目 B 将不再嵌套在项目 A 中。

**示例项目**：项目1（P1）是一个包含4个嵌套项目（P2-P3-P4-P5）的项目分支。

**设想**：您首先删除 P1，然后将整个分支（根 P1 和嵌套的 P2-P3-P4-P5）发送到回收站。

- 从回收站中，您可以从原始分层结构 (P1-P2-P3-P4-P5) 中删除任何单个项目。
- 从回收站中删除嵌套的项目将会破坏原始的项目分层结构。
    
    - 如果删除 P3，P1、P2、P4 和 P5 将保留在回收站中，但 P4 不再与 P2 连接。原来单一的项目分支现分为 P1-P2、P4-P5 两个分支。
    - 删除 P3 后，如果您恢复 P1，则恢复操作也会恢复 P2，但 P4 和 P5 会留在回收站中。
    - 删除 P3 后，如果恢复 P4，则恢复操作也将恢复 P5，因为 P4 现在被视为 P5 的根。
    - 您可以单独恢复任何原来嵌套的项目。
- 您不能从回收站中移除整个项目分层结构。您必须单独删除每个项目。

## 从回收站恢复内容

您可以在管理员配置的存储时间范围内将回收站中的内容恢复到项目。

1. 从“主页”中展开侧边窗格，然后选择“回收站”。
2. 对于“内容类型”，选择“工作簿”、“项目”、“数据源”或“流程”。
3. 选择“更多操作”菜单，然后选择“恢复”。
4. 选择一个项目作为恢复位置。
5. 选择“恢复”。

## 从回收站删除内容

您可以在管理员配置的存储时间范围结束之前永久删除回收站中的内容。_此操作无法撤消。_

1. 从“主页”中展开侧边窗格，然后选择“回收站”。
2. 对于“内容类型”，选择“工作簿”、“项目”、“数据源”或“流程”。
3. 选择“更多操作”菜单，然后选择“删除”。
4. 选择“删除”。

## 启用回收站

管理员可以在 Tableau [站点设置](https://help.tableau.com/current/online/zh-cn/sites_add.htm)中为 Tableau 站点启用回收站 。

1. 从“常规”选项卡中，滚动到“回收站”部分。
2. 选中“允许此站点使用回收站”复选框。
3. 选择内容在回收站中存储的天数。您可以选择 1 天、7 天或 30 天。
    
    > [!IMPORTANT]
    > 
    > **重要信息**：系统会在所选天数后永久删除内容。
4. 选择“保存”。

## 关闭回收站

> [!WARNING]
> 
> **警告**：如果管理员关闭回收站，则回收站中存储的任何内容都将被永久删除。

管理员可以在 Tableau [站点设置](https://help.tableau.com/current/online/zh-cn/sites_add.htm)中为 Tableau 站点关闭回收站 。

1. 从“常规”选项卡中，滚动到“回收站”部分。
2. 清除“允许此站点使用回收站”复选框。
3. 选择“保存”。

## 与管理员联系

回收站只能由 Tableau 站点管理员或服务器管理员启用和配置。若要查看管理员的联系信息，请从主页中选择“显示帮助菜单”图标，然后选择“联系 Tableau 管理员”。

<!-- document id=641a4f8a0462d8639b58caf43ea073d19003580b7194e68028551c4aec46980c url=/tableau/next/zh-cn/online/gworkspace_explore.md -->

[跳转到主要内容](#main-content)

# 在 Google Workspace 中访问 Tableau 内容

Google Workspace 的 Tableau 加载项可让您从 Google Docs、Google Slides 和 GoogleSheets 中安全地访问 Tableau 内容。您可以将 Tableau 视图和 Pulse 指标作为图像嵌入到文档和演示文稿中，将实时数据从 Tableau Cloud 导入 Google Sheets，以及将数据从 Google Sheets 导出到 Tableau Cloud 进行分析。

为了使 Tableau 加载项在 Google Workspace 中可用，您的 Google Workspace 管理员必须将 Tableau 加载项添加到允许列表中。有关以管理员身份安装 Tableau 加载项的信息，请参见[为 Google Workspace 设置 Tableau 加载项](https://help.tableau.com/current/online/zh-cn/gworkspace_set_up.htm)。

## 最低要求

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border.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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">功能</th><th class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau Cloud</th><th class="TableStyle-Basic-Border-BodyD-Column1-Body1">Tableau Server 最低版本</th></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">在 Google Docs 和 Slides 中嵌入 Tableau 图像</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">支持</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">2023.1 或更高版本</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">将自定义视图与 Google Sheets 配合使用</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">支持</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">2024.3 或更高版本 (REST API 3.24)</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">将数据导入 Google Sheets</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">支持</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">2026.1 或更高版本。仅当与 Tableau Cloud 或 Tableau Server 版本 2026.1 或更高版本建立连接时，“导入”按钮才会出现。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">从 Google Sheets 发布到 Tableau Cloud</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">支持</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Tableau Server 上不支持。</td></tr></tbody></table>

**Tableau Server 版本要求**：Tableau 加载项的主要功能需要 Tableau Server 2024.3 或更高版本。

**Google Sheets 中的特定功能具有更高的版本依赖关系：**

**数据导入**：此功能使用 VDS API，仅与 Tableau Server 2026.1 或更高版本兼容。

**发布到 Tableau Cloud**：此功能依赖于“在 Tableau API 中浏览”，后者仅在 Tableau Cloud 上可用，在 Tableau Server 上不受支持。

## 在 Google Docs 和 Google Slides 中使用 Tableau 加载项

使用 Tableau 加载项将 Tableau 视图和 Pulse 指标作为图像快照直接嵌入到 Google Docs 和 Google Slides 中。您可以使用直接 URL 或通过浏览 Tableau 站点来查找资产。如果基础数据更新，您可以将刷新这些图像以显示最新版本。

### 插入 Tableau 图像

1. 打开 Google 文档或 Google 幻灯片，然后单击右侧面板中的 Tableau 图标。
2. 从下拉菜单中选择您的 Tableau 站点。
3. 使用以下方法之一查找要嵌入的 Tableau 内容：
    
    - URL：输入 Pulse 指标或 Tableau 视图的直接链接，以在加载项中生成预览。
    - 搜索视图：输入视图名称以搜索您的站点，并选择相应结果进行预览。
    - 搜索 Pulse 指标：在嵌入之前查找特定的 Pulse 指标以预览其当前趋势线。
4. 预览内容，然后选择要插入图像的幻灯片或文档选项卡。
5. 选择“Insert”（插入）。图像将添加到您的文档中。  
      
    ![Google Workspace 中的 Tableau 加载项，用于嵌入 Tableau 图像。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_embedimages.png)

### 刷新 Tableau 图像

从 Tableau 嵌入的图像是静态快照。您可以刷新这些图像，以确保它们在基础源更改时表示最新数据。

1. 若要刷新文件中的所有 Tableau 图像，请选择“All”（全部）。
2. 若要仅刷新某些映像，请选择“Some”（部分）。
3. 选中要更新的图像旁边的框，然后单击“Refresh”（刷新）。

Tableau 加载项将每次刷新的结果记录为文件中的注释，从而提供审核跟踪。此跟踪可识别启动刷新的用户、刷新发生的时间以及每个图像的状态。如果您的图像没有正常更新，请查阅“疑难解答”部分以获取常见问题的解决方案。

### 查看 Smartchips 和 PreviewLinks（仅限 Tableau Cloud）

当您将链接到 Tableau 视图或 Pulse 指标的 URL 粘贴到 Google 文档或 Google 幻灯片中时，它会自动扩展为包含缩略图和有关视图或指标的元数据的丰富预览。

在 Google Docs 中，URL 会展开为 Smartchips，即您可以将鼠标悬停其上以查看更多详细信息的交互式内联预览。

在 Google Slides 中，URL 会展开为 PreviewLinks。Slides 会提示您将 URL 替换为标题。这是一次性替换 - 如果视图标题或指标值稍后更改，链接标题不会自动更新。

## 在 Google Sheets 中使用 Tableau 加载项

Google Sheets 的集成支持双向数据流：它允许您将 Tableau 视图或已发布数据源中的信息提取到电子表格中，还支持将 Google Sheets 数据发布回 Tableau Cloud。  
  
![Google Sheets 中的 Tableau 加载项扩展程序，用于导入和导出数据。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_import.png)

### 从 Tableau 导入数据

您可以从 Tableau 已发布数据源或特定工作表或视图导入数据。体验会因选择哪种方式而异 — 已发布数据源提供带有字段选择和聚合控件的完整查询生成器，而工作表和视图导入则按原样引入数据，无需额外筛选。

1. 打开 Google 工作表，然后单击右侧面板中的 Tableau 图标。
2. 从下拉菜单中选择您的 Tableau 站点。
3. 选择一种数据源类型。

#### 从工作表或视图导入

1. 按名称搜索视图，或将 Tableau URL 直接粘贴到 URL 字段中。
2. 选择结果以查看数据预览。
3. 指定要导入哪些行。

最多可导入 500 万个单元格。如果所选的数据量超过此数量，数据将在 500 万个单元格处被截断。  
  
![Google Workspace 上的 Tableau 加载项扩展程序中的“Rows to import”（要导入的行）下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_rowstoimport.png)  

1. 选择“Rows to import”（要导入的行）下的下拉箭头，并指定要导入哪些行。
    
    - “Autofit to capacity”（自动适应容量）：导入行，直到导入达到 500 万个单元格的限制。
    - “First N rows”（前 N 行）：导入前 N 行，具体行数由您在“Number of rows”（行数）字段中输入的数字确定。
    - “Last N rows”（最后 N 行）：导入最后 N 行，具体行数由您在“Number of rows”（行数）字段中输入的数字确定。
2. 选择“Import Data from Tableau”（从 Tableau 导入数据）。该工作表中的完整数据将以表格形式写入您的工作表。字段选择和聚合对于工作表和视图导入不可用。

**注意：**如果选择仪表板，则只能导入第一个工作表。若要导入仪表板中的特定工作表，请直接导航到该工作表，而不是选择仪表板。

#### 从已发布数据源导入

1. 确保您要导入的已发布数据源标有“GoogleSheets”。只有带有此标记的数据源才会出现在下拉列表中。  
    有关标记数据源的详细信息，请参见[使用标记](https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm)。
2. 选择下拉箭头以查看可用于导入的数据源。  
      
    ![从适用于 Google Workspace 的 Tableau 加载项中的 Tableau 数据源下拉菜单导入。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_importdatasource.png)
3. 选择要导入的数据源，并选择“Build new query”（生成新查询）。
4. 使用字段选择器选择要导入的字段。
5. 使用“Select All”（全选）或“Select None”（全不选）来快速管理您的选择。
6. 如果需要行级别未聚合数据，请选择“Disaggregate Data”（解聚数据）。（可选）。  
    
    **注意**：解聚大型数据源可能需要一段时间或导致超时。应用聚合后，字段级别解聚不再可用。
7. 修改字段特征和聚合（可选）。
8. 选择“Configure Import”（配置导入）。
9. 查看导入预览，然后选择“Import Data from Tableau”（从 Tableau 导入数据）。

**注意：**当前，当您从包含大量字段的已发布数据源导入数据时，您可能会看到此警告：“The list has been truncated to fit the Google add-on card limit”（该列表已被截断以适应 Google 加载项卡限制）。Google Workspace 面板一次只能显示有限数量的项。如果数据源包含大量的维度和度量（通常为 50 个或更多），则无法显示完整列表。为了解决此问题，请创建一个较小版本的已发布数据源，其中仅包含 Google Sheets 导入所需的字段。

#### 从 URL 导入

1. 将 Tableau URL 粘贴到搜索框中，然后选择“Search”（搜索）。
2. 预览内容，然后选择“Import Data from Tableau”（从 Tableau 导入数据）。
3. 选择“OK”（确定）。

### 刷新 Tableau 数据

1. 从 Tableau 加载项菜单中选择“Update Data”（更新数据）。
2. 选中要刷新的数据对应的复选框。
3. 选择您的刷新行为。您可以选择将刷新的数据插入到新工作表中，或覆盖现有数据。  
      
    ![适用于 Google Workspace 的 Tableau 加载项中的数据刷新选项。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_datarefresh.png)
4. 选择“Refresh Data”（刷新数据）。

Tableau 加载项将每次刷新的结果记录为文件中的注释，从而提供审核跟踪。此跟踪标识启动刷新的用户、刷新发生的时间以及每次刷新的状态。如果您的数据未正常更新，请查阅“疑难解答”部分以获取常见问题的解决方案。

### 配置数据导入

最多可导入 500 万个单元格。如果所选的数据量超过此数量，数据将在 500 万个单元格处被截断。

如果您正在使用大型数据集，请考虑以下方法以保持在限制范围内：

- 通过在数据源级别应用筛选器以减少行计数，在导入之前筛选 Tableau 中的数据。
- 在查询编辑器中选择较少的字段。
- 使用聚合而不是行级别数据来减少单元格计数。

#### 数据聚合

默认情况下，Tableau 加载项会根据您在字段选取器中的选择将聚合应用于度量字段（例如 SUM 或 AVG）。如果需要行级别数据，请在完成字段选择之前选择解聚。

#### 刷新区块中的数据

为了处理大量数据，Tableau 加载项设计为以增量段的形式刷新数据，而不是通过一个大的请求来刷新数据。这种分块方法可以防止 API 超时，并确保可靠地交付大量数据集。您可以通过工作表注释中显示的指示器监视此操作的进度。

**注意**：单个查询受 Google 的超时限制约束。如果查询运行时间超过 30 秒，则会出现通知，并且该过程将在后台继续。

### 将 Google Sheets 数据导出到 Tableau Cloud

您可以将数据从 Google 工作表发布到您的 Tableau Cloud 站点。Tableau 加载项使用“在 Tableau API 中浏览”打开预加载了工作表数据的 Tableau Cloud Web 制作会话。

1. 打开 Google 工作表，然后从右侧面板中选择 Tableau 加载项。
2. 从下拉菜单中选择您的 Tableau Cloud 站点。
3. 选择“Export Data”（导出数据），然后选择要发布的工作表。
4. 选择“Export to Tableau Cloud”（导出到 Tableau Cloud）。  
      
    ![Google Workspace 中 Tableau 加载项的“Export Data”（导出数据）对话框。](/tableau/next/zh-cn/online/zh-cn/Img/gworkspace_export.png)

这将启动到 Tableau Web 制作体验中，使用 Google 工作表数据作为 Tableau 已发布数据源。

1. 选择“Publish”（发布），将数据源导出到 Tableau Cloud 站点。

注意：Google Sheets 中的数据透视表、合并单元格和图像与 Tableau Cloud 不兼容。如果您的工作表包含不兼容的内容，则在移除该内容之前无法将其导出。

### 共享 Tableau 内容

当您共享包含 Tableau 内容的 Google 文档、幻灯片或工作表时，系统会将 Tableau 图像或数据作为文档的一部分进行共享，就像任何其他内容一样。但是，Tableau 权限不会随文档共享。想要刷新 Tableau 映像或重新导入数据的每个用户都必须对相关数据源或视图具有适当的权限。

Docs 和 Slides 中的刷新活动将记录为文档上的注释。每个刷新注释都会记录触发刷新的用户、时间戳以及每次图像刷新的状态。这提供了审计跟踪，用于了解数据上次更新的时间以及由谁更新。

## 数据连接疑难解答

我没有看到我的所有数据

如果未看到您的所有数据，则您的查询可能已超过 500 万个单元格的限制。若要成功导入整个数据集，请尝试使用以下方法减少导入的数据量：

- 应用 Tableau 筛选器以限制导入的数据量。
- 减少为导入选择的字段数。
- 在开始导入过程之前，使用聚合来压缩信息。

导入花费很长时间或似乎处于卡滞状态

大量导入内容是以区块形式导入的，这对于大型数据集可能需要一些时间。如果刷新在后台运行，您可以在文件的注释部分中跟踪刷新的状态。

我无法刷新数据

如果尝试刷新与您共享的 Tableau 内容，请确保您具有访问 Tableau 中的数据的适当权限。无论是否共享了 Google 文档，基础 Tableau 数据权限始终适用。

我在 Tableau 加载项中找不到我的已发布数据源

已发布数据源必须在 Tableau 中标记为“GoogleSheets”，才会出现在加载项的数据源列表中。

连接仪表板时，我只能看到一个数据工作表

该应用程序只能从仪表板内的第一个数据工作表中检索数据。若要从仪表板内的特定工作表导入数据，我们建议您转到工作簿中的该工作表并从该处导入。

我找不到我的自定义视图

如果要访问自定义视图，则需要选择“从 URL 导入”功能。

我看不到我的 Smartchips 或 PreviewLinks

Smartchips (Google Docs) 和 PreviewLinks (Google Slides) 仅适用于 Tableau Cloud。由于 Google Workspace 平台存在需要全局 URL 允许列表的限制，因此 Tableau Server 不支持它们。如果您正在使用 Tableau Cloud 但仍未看到智能内容，请确保粘贴受支持的 Tableau URL。

我无法修改字段的聚合

选择解聚按钮后，导入将在行详细级别呈现。若要聚合行级别数据，请在完成字段选择并运行导入之前取消选择“解聚”按钮。

我无法发布我的 Google Sheets 数据

将数据从 Google Sheets 发布到 Tableau 的功能仅在 Tableau Cloud 上可用。此功能不可用于 Tableau Server。

我无法导入 Tableau 自定义视图

自定义视图支持需要 Tableau Server REST API 版本 3.23 或更高版本。

我的已发布数据源中缺少字段

目前，当您从包含大量字段的已发布数据源导入数据时，您的数据可能会被截断以适应 Google 加载项卡的限制。Google Workspace 面板一次只能显示有限数量的项。如果数据源包含大量的维度和度量（通常为 50 个或更多），则无法显示完整列表。

为了解决此问题，请创建一个较小版本的已发布数据源，其中仅包含 Google Sheets 导入所需的字段。

我无法导出某个 Google 工作表

Google Sheets 中的数据透视表、合并单元格和图像与 Tableau Cloud 不兼容。如果您的工作表包含不兼容的内容，它将在导出对话框中显示为灰色，您无法将其导出。请从 Google 工作表中移除所有数据透视表、合并单元格或图像，然后重试。

<!-- document id=96a1654a5cf9a6c412645b4a474be7ff46944c27d1839c5e830b861470004b49 url=/tableau/next/zh-cn/online/teams_explore.md -->

[跳转到主要内容](#main-content)

# 在 Microsoft 365 中访问 Tableau 内容

适用于 Microsoft 365 的 Tableau 应用在 Teams、Word 和 PowerPoint 中可用。使用 Teams 应用，您可以与视图（可视化项）和指标进行交互，并在消息、频道和会议中共享它们。使用 Word 和 PowerPoint 加载项，您可以将视图和指标的图像快照添加到文档和幻灯片中，并刷新这些快照以使其保持最新。

为了使 Tableau 应用在 Microsoft 365 中可用，管理员必须部署它并将其连接到 Tableau 站点。有关以管理员身份安装 Tableau 应用的信息，请参见[为 Microsoft 365 设置 Tableau 应用](https://help.tableau.com/v0.0/online/zh-cn/teams_set_up.htm)。

注意：如果已将 Tableau 或 Microsoft 365 中的语言设置为 Tableau 支持的语言，而不是英语（美国），则您可能会看到未本地化的英语文本。

## 使用 Teams 应用

如果您的管理员没有为您预安装该应用，但已经为您的组织部署了该应用，您可以自己安装该应用。若要了解如何操作，请参见 Microsoft Teams 文档中的[将应用添加到 Microsoft Teams](https://support.microsoft.com/en-us/office/add-an-app-to-microsoft-teams-b2217706-f7ed-4e64-8e96-c413afd02f77)。

Teams 应用有三个选项卡：“Tableau”、“Pulse”和“Configuration”（配置）。“Tableau”选项卡显示您添加为收藏夹的视图。“Pulse”选项卡显示您关注的指标以及有关这些指标的见解摘要。请注意，只有 Tableau Cloud 站点才会显示“Pulse”选项卡。通过“Configuration”（配置）选项卡，您可以设置 Microsoft Teams 在搜索内容时检查的站点，如果您是 Tableau 管理员，则可以添加和移除站点配置。

如果您没有任何收藏夹视图或已关注指标，您将不会在应用中看到任何内容。直接登录您的 Tableau 站点以将视图添加为收藏夹并关注指标。有关详细信息，请参见[标记收藏夹](https://help.tableau.com/current/pro/desktop/zh-cn/favorites.htm)和[关注指标](https://help.tableau.com/current/online/zh-cn/pulse_explore_metrics.htm#follow-metrics)。尽管可以将其他类型的内容添加为收藏夹，但除了视图之外，您的收藏夹内容都不会出现在 Tableau 应用中。如果要查看工作簿中的所有视图，请将每个单独的视图添加到收藏夹。

### 浏览 Teams 中的内容

在“Tableau”或“Pulse”选项卡上，单击视图或指标的卡片以打开完整的交互式版本。交互式视图或指标允许您查看有关数据的更多详细信息，并根据不同维度或时间范围筛选数据。

#### 搜索内容

如果您知道视图或指标的名称，则可以在 Tableau 应用中搜索它。您还可以在搜索栏中输入视图的 URL 以访问特定内容或自定义视图。

1. 在“Tableau”或“Pulse”选项卡上，选择搜索图标。
    
    ![Tableau 应用搜索入口点](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_search.png)
2. 输入视图或指标的名称。
3. 选择视图或指标名称旁边的“打开”按钮以转到交互式版本。

#### 关注指标

每个指标表示一组唯一的筛选器。筛选现有指标时，如果不存在具有这些筛选器的指标，则会创建一个新的指标。关注新指标，在您的“Pulse”选项卡和见解摘要中查看它。

1. 在指标上，选择关注（订阅此指标）图标。
    
    ![指标上的“关注”图标](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_follow.png)
    
    您可以通过再次选择该按钮来取消关注指标。

#### 共享内容

1. 在视图或指标上，选择共享图标。
    
    ![“Share”（共享）图标。](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_share.png)
2. 选择要与之共享的人员、群聊或频道。
3. 选择“Share”（共享）。

#### 切换站点

1. 在“Tableau”或“Pulse”选项卡上，从导航菜单中选择站点名称。如果多个站点连接到 Tableau 应用，您将看到站点列表。
    
    ![站点切换选项](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_switch_site.png)
2. 选择要切换到的站点。

### 将 Tableau 内容添加到频道和会议

#### 将内容固定在频道选项卡中

1. 在要固定 Tableau 内容的频道中，选择“+”图标以添加选项卡。
    
    ![添加渠道选项卡选项](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_channel_tab.png)
2. 从应用列表中，选择 Tableau 应用。
3. 选择要固定的内容。若要固定自定义视图，请选择搜索按钮并输入视图 URL。您可以固定一个视图，每个选项卡最多五个指标。若要固定更多 Tableau 内容，请添加第二个选项卡。
    
    ![要固定的 Tableau 视图和指标](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_pin_content.png)
4. 选择“Save”（保存）。
5. 或者，若要重命名选项卡，请选择选项卡上的下拉菜单，然后选择“Rename”（重命名）。
    
    ![Tableau 选项卡的“Rename”（重命名）选项](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_rename_tab.png)

#### 将 Tableau 内容添加到会议

您必须先创建会议，然后添加 Tableau 内容。您无法在创建会议期间添加第三方应用。

1. 在“Calendar”（日历）应用中，找到您想要向其中添加 Tableau 内容的会议，然后选择“Edit”（编辑）。
2. 选择“More options”（更多选项）。
3. 从工具栏中选择“Apps”（应用）。
4. 从应用列表中，选择 Tableau 应用。
5. 选择要固定的内容。
6. 选择“Save”（保存）。
7. 保存对会话所做的更改。
8. 开始会议后，选择“Tableau”选项卡。这将在只有您才能看到的侧边面板中打开 Tableau 内容。
9. 在侧边面板上，选择“share to stage”（共享到舞台）按钮。这将使内容对会议中的其他人可见。请注意，您共享的内容会以您看到的方式显示给其他人，这与屏幕共享的工作方式类似。如果数据存在行级安全性，则会议中的每个人都可以看到您的数据视图。

### 在消息中共享 Tableau 内容

如果您知道视图或指标的 URL，则可以通过将 URL 粘贴到消息中来快速共享该内容。Tableau 消息扩展程序将链接变成一张显示内容标题和缩略图的卡片，并带有一个用于打开完整交互式视图或指标的按钮。如果您不知道要发送的内容的 URL，则可以搜索要共享的内容。

1. 在消息上，选择“+”（操作和应用）图标。
2. 选择 Tableau 应用。
3. 在 Tableau 站点中搜索您要共享的视图或指标。
4. 选择视图或指标。为此内容生成卡片需要一些时间。
    
    ![Teams 消息中的“Metric”（指标）卡](/tableau/next/zh-cn/online/zh-cn/Img/teams_app_metric.png)
5. 发送消息。

### 接收 Tableau Pulse 摘要和通知

如果您关注 Tableau Pulse 中的指标，您会收到有关这些指标的摘要以及这些指标的任何通知。这些摘要和通知由 Tableau 应用程序在聊天消息中发送，并且这些消息也会显示在 Tableau 应用程序的“活动”选项卡中。

您在 Tableau Cloud 站点上配置 Tableau Pulse 摘要，而不是在 Teams 应用程序中。您的 Tableau 站点中的配置会延续到您接收摘要的所有渠道。

- 若要对摘要中的指标进行排序，请参见[自定义主页和摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#Grouping)。
- 若要调整摘要的频率、仅在摘要中显示收藏夹指标或关闭摘要，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)。
- 若要关闭特定指标的通知，请参见[针对指标关闭通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm#turn-off)。

摘要最多包含 10 个您关注的指标。如果您关注的指标超过 10 个，请转到 Tableau 应用程序中的 Pulse 选项卡以查看您的所有指标。

## 使用 Word 和 PowerPoint 加载项

Tableau 加载项显示在 Microsoft Word 和 PowerPoint 中的“Home”（主页）选项卡上。若要了解如何访问加载项，请参见 Microsoft 文档中的[开始使用 Office 加载项](https://support.microsoft.com/en-us/office/start-using-your-office-add-in-82e665c4-6700-4b56-a3f3-ef5441996862)。请注意，为了使 Tableau 应用可供您使用，您的 Microsoft 365 管理员必须首先部署该应用，并将其连接到 Tableau 站点。

### 向文档和幻灯片中添加可视化项或指标

使用 Tableau 加载项，您可以将可视化项或指标的图像快照添加到文档和幻灯片中。请注意，Tableau Pulse 指标仅适用于 Tableau Cloud。

这些图像显示添加时间以及添加它们的用户，并且图像链接到 Tableau Cloud 或 Tableau Server 中的内容。图像对于所有用户都是相同的，因此如果向数据应用了行级别安全性，则图像将显示特定于添加图像的用户的数据视图。如果其他用户在 Tableau Cloud 或 Tableau Server 中打开图像链接，这些用户将看到应用了凭据的交互式视图或指标。

1. 从“Home”（主页）选项卡中，选择 Tableau 加载项。
2. 选择“Insert Viz Image”（插入可视化项图像）或“Insert Pulse Image”（插入 Pulse 图像）。
    
    ![Microsoft 365 加载项的插入可视化项或指标选项](/tableau/next/zh-cn/online/zh-cn/Img/microsoft_365_add_in.png)
3. 搜索要添加的视图或指标的名称，或者从您最喜欢的视图或关注的指标中进行选择。
4. 在视图或指标的预览中，选择“Insert Image”（插入图像）。

如果您有要添加的内容的 Tableau 站点 URL，则可以改为选择“Insert Content from URL”（从 URL 插入内容）。

#### 使用自定义视图显示筛选的数据

若要添加数据的筛选视图，请插入自定义视图。

1. 在 Tableau Server 或 Tableau Cloud 中打开视图。
2. 筛选视图以显示要包括在快照中的数据，然后创建自定义视图。有关详细信息，请参见[“使用自定义视图”](https://help.tableau.com/current/server/zh-cn/customview.htm)。
3. 在 Word 或 PowerPoint 中打开 Tableau 加载项。
4. 选择“Insert Content from URL”（从 URL 插入内容），然后粘贴自定义视图的 URL。

### 刷新可视化项或指标

图像是在添加图像时拍摄的快照。如果图像不再表示最新数据，请刷新它。

1. 从“Home”（主页）选项卡中，选择 Tableau 加载项。
2. 选择“Refresh Data”（刷新数据）。Tableau 加载项可识别文档或幻灯片中的所有 Tableau 图像。
3. 选择要刷新的内容，然后选择“Refresh Selected”（刷新选定内容）。

<!-- document id=3c5970cfc8640eb31a0d68d5db05d09040a29251e650d515688545681329631e url=/tableau/next/zh-cn/online/config_cors_sfdc.md -->

[跳转到主要内容](#main-content)

# 在 Salesforce.com 中为 Tableau Cloud 中的 Einstein Discovery 集成配置 CORS

在版本 2021.1.0 中，添加了将 Einstein Discovery 预测集成到 Tableau 仪表板中的功能。您可以使用 Einstein Discovery 仪表板扩展程序执行此操作。要做到这一点，前提条件是在托管 Tableau CRM 的 Salesforce org 中配置跨域资源共享 (CORS)，并包括将要使用的模型和预测。

此过程描述 Salesforce.com 组织中的管理员如何进行此配置。您可以在 Salesforce 文档[配置 Salesforce CORS 允许列表](https://help.salesforce.com/s/articleView?id=sf.extend_code_cors.htm)中找到有关 CORS 的更多信息。

## 针对 Einstein Discovery 配置 CORS。

**注意：**此程序记录了 Salesforce Lightning 中的过程。如果您使用的是传统界面，导航可能会有所不同，但配置是相同的。

1. 登录您的 Salesforce.com 开发人员帐户，单击右上方您的用户名，然后选择“设置”。
    
    ![带有“设置”工具提示的齿轮图标。](/tableau/next/zh-cn/online/zh-cn/Img/config_oauth_einstein_cxapp_setup.png)
2. 在左侧导航列中，搜索“cors”并选择“CORS”。
    
    ![输入 CORS 作为搜索词的搜索字段，并显示 CORS 搜索结果。](/tableau/next/zh-cn/online/zh-cn/Img/config_cors_einstein_search.png)
3. 在“CORS”中的“Allowed Origins List”（允许的来源列表）部分，单击“New”（新建）。
    
    ![CORS 设置窗口，其中显示“Allowed Origins List”（允许的来源列表），并且光标悬停在“新建”按钮上。](/tableau/next/zh-cn/online/zh-cn/Img/config_cors_einstein_new.png)
4. 在“CORS Allowed Origin List Edit”（CORS 允许的来源列表编辑）中，输入您的 Tableau Cloud 的 URL，以“https://”开头。
    
    ![CORS 设置窗口，其中输入了原始 URL 模式，并且光标悬停在“保存”按钮上。](/tableau/next/zh-cn/online/zh-cn/Img/config_cors_einstein_allow_list.png)
    
    有关 URL 模式的详细信息，请参见 Salesforce 开发人员文档：[https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/extend\_code\_cors.htm](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/extend_code_cors.htm)
5. 单击“保存”。

<!-- document id=57ae2c45721a966a25c00f0e90e03312c0ba214aba50cd605800ad2efc2d7005 url=/tableau/next/zh-cn/online/schedule_add.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Cloud 上计划刷新

您可以直接在 Tableau Cloud 上针对云托管数据的数据提取计划刷新任务。这可能包括以下数据类型的数据提取：

- Salesforce.com 或 Google Analytics。
- Google BigQuery 或 Amazon Redshift（如果不想使用实时连接）。对于本地 Redshift，必须使用 Tableau Bridge。
- 基于 SQL 的数据或云平台（例如 Amazon RDS、Microsoft Azure 或 Google Cloud Platform）上承载的其他数据（如果不想使用实时连接，或该数据源不支持实时连接）。
    
    有关支持的数据源的列表，请参见[允许实时连接到云平台上托管的数据](https://help.tableau.com/v0.0/online/zh-cn/to_connect_live_sql.htm)。

使用 Tableau Bridge 创建数据提取刷新时，还可以使用计划。有关详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

**注意：**

- 有关刷新 Microsoft Excel、SQL Server 或 Tableau Cloud 无法直接访问的其他数据的数据提取的信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)。
- 您的 Tableau Cloud 站点具有支持所有用户分析需求的容量。站点的容量包括用于存储的容量，以及用于需要在包括数据提取的站点上执行的任务的容量。有关详细信息，请参见[Tableau Cloud 容量](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm)。

## 创建刷新计划

非常重要！

- **“立即运行”**选项在**“创建数据提取刷新”**对话框中不再可用。“**立即运行**”选项现在列在“**操作**”下拉菜单中。
- 不能将任务配置为按顺序（连接）运行。相反，您可能希望错开数据提取刷新的开始时间，以便任务依次运行。
- 如果将现有任务迁移到自定义计划，请注意，除非更改这些任务的开始时间，否则这些任务将并行运行，这可能是不需要的。
- 如果您为同一工作簿或已发布数据源计划多个数据提取刷新，则这些作业会连续运行，一个作业等待前一个作业完成后再运行。

1. 登录到 Tableau Cloud，从左侧的导航窗格中选择“浏览”，然后，根据想要刷新的内容的类型，从下拉菜单中选择“所有工作簿”或“所有数据源”。
2. 选中要刷新的工作簿或数据源的复选框，然后选择“**操作”>“刷新数据提取**”。
3. 在“刷新数据提取”对话框中，选择“计划刷新”，然后完成以下步骤：
    
    ![用于设置数据刷新的表单，其中包含配置频率、时间和日的选项。](/tableau/next/zh-cn/online/zh-cn/Img/online-custom-extract-refresh-dialog.png)
    
    - **刷新类型**：选择所需要的刷新类型。默认情况下执行完全刷新。只有在发布数据提取之前，在 Tableau Desktop 或 Tableau Cloud 的 Web 制作中为其配置了增量刷新，增量刷新才可用。如果选择已设置为执行完全刷新的多个工作簿或数据源之一，则禁用选择增量刷新的选项。有关详细信息，请参见 [Tableau 帮助中的“刷新数据提取”](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm)。
    - **刷新频率**：设置数据提取刷新的运行频率。您可以将频率设置为每小时、每天、每周或每月运行。时间和日间隔取决于您选择的重复频率，如下所述：
        
        - **每小时：**可用频率是每小时从特定时间到特定时间。这意味着任务将在指定时间每小时运行一次。
        - **每日：**可用频率为每两小时、四小时、六小时、八小时或十二小时一次，或每天一次。除了开始和结束时间之外，您还可以选择一周中的一个或多天。这意味着您可以在一周的所有或特定日期以特定小时间隔运行任务，或每天运行一次。
        - **每周**：可用频率是一周中一天的特定时间。这意味着您可以在一周中的某一天运行该任务，每周在某个时间运行一次。
        - **每月**：您可以通过两种不同的方式设置此项：
            
            1. 您可以选择“**日**”作为频率间隔，然后允许您选择该月的特定日期。例如，您可以选择在每月 2 号、15 号和 28 号的下午 2:45 运行。
            2. 您还可以选择在每周的第一天、第二天、第三天、第四天、第五天和最后一天的特定时间运行。例如，您可以选择在每月的第二个星期三下午 2:45 运行该任务。

## 更新现有计划

更改现有计划时，您将不再从现有计划列表进行选择，而是直接更改计划中的重复周期。

## 数据提取刷新的时间限制

为了确保长时间运行的刷新任务不会占用所有系统资源，并且不会阻止站点上其他数据提取的刷新，Tableau Cloud 将为刷新任务强制实施 7200 秒（120 分钟或两小时）的超时限制。超时限制是单一数据提取在被取消之前完成一次刷新允许的最长时间。超时限制不可配置。

### 不要超过超时限制

尽管达到超时限制的情况并不常见，但如果您在大量使用数据提取的环境中工作，您只能对数据提取进行少数修改来帮助避免达到超时限制。

- [在 Tableau Cloud 上计划刷新](#hyper)
- [设置增量刷新](#incremental)
- [减少数据提取的大小](#size)
- [使用替代方法来刷新数据提取](#altmethod)
- [计划在其他时间刷新](#difftime)

#### 设置增量刷新

考虑将数据提取配置为在每次执行刷新任务时进行增量刷新，而不是完全刷新。

默认情况下，数据提取设置为完全刷新。尽管完全刷新可为您提供数据的精确副本，但完全刷新可能需要很长时间才能完成。为了缩短刷新数据提取所需的时间，请考虑改为设置数据提取的增量刷新。有关详细信息，请参见 Tableau 帮助中的[配置增量数据提取刷新](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm#incremental)。

**注意：**您必须在将数据提取发布到 Tableau Cloud 之前设置增量刷新。发布后，您将能够在“创建数据提取刷新”对话框中选择增量刷新选项。

#### 减少数据提取的大小

您可以通过减少数据提取的大小来帮助刷新任务更快完成。

可以通过两种常见方法来减少数据提取的大小：隐藏所有未使用的字段，以及使用数据源筛选器。

- **隐藏所有未使用的字段：**创建数据提取时会排除您在数据源中隐藏的字段。若要在创建数据提取时隐藏字段，请参见 Tableau 帮助中的[创建数据提取](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm#extract)。
- **添加数据源筛选器：**您可以通过添加数据源筛选器来减少数据提取中的行数。有关详细信息，请参见 Tableau 帮助中的[筛选数据源中的数据](https://help.tableau.com/current/pro/desktop/zh-cn/filtering_datasource.htm)。

**注意：**您必须在将数据提取发布到 Tableau Cloud 之前隐藏所有未使用的字段或添加数据源筛选器。

#### 使用替代方法来刷新数据提取

如果可能，请考虑在 Tableau Cloud 外部刷新数据提取。

- **Tableau Desktop：**您可以从 Tableau Desktop 中手动刷新发布的数据提取。有关详细信息，请参见[从 Tableau Desktop 中刷新已发布数据提取](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_desktop.htm)。
- **Tableau Bridge：**根据数据源而定，您可以使用 Tableau Bridge 来设置和按计划刷新发布的数据提取。有关详细信息，请参见[使用 Bridge 使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm)。
- **Tableau 数据提取命令行实用工具（已弃用）：**根据数据源而定，您可以使用 Tableau Desktop 附带的命令行实用工具以编程方式刷新发布的数据提取。有关详细信息，请参见[从命令行中自动执行数据提取刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm)。
    
    **2022 年 10 月已弃用：**此实用工具在以后的版本中不可用。若要刷新 Tableau Cloud 无法直接访问的数据源或虚拟连接数据，请改用 [Tableau Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。若要使用脚本启动刷新作业，请使用 tabcmd [refreshextracts](https://help.tableau.com/current/server/zh-cn/tabcmd_cmd.htm#refreshextracts-workbookname-or-datasourcename) 或 REST API [运行数据提取刷新任务](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#run_extract_refresh_task)。

#### 计划在其他时间刷新

考虑更改进行刷新任务的时间。有关详细信息，请参见[管理任务](https://help.tableau.com/v0.0/online/zh-cn/task.htm)。

### 刷新任务达到超时限制时的错误

如果刷新任务达到超时限制，您或者其他人可能会看到下列错误之一。如果您是数据提取的发布者或所有者，您可能会在电子邮件通知中看到以下错误之一。如果您是站点管理员，您可能会在有关[数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd.htm)的管理视图中看到这些错误之一。

- _The query time resource limit (7200 seconds) was exceeded.（已超出查询时间资源限制(7200 秒)。）_
- _com.tableau.nativeapi.dll.TableauCancelException: Operation cancelled.（com.tableau.nativeapi.dll.TableauCancelException: 操作已取消。）_
- _The query time resource limit (8100 seconds) was exceeded.（已超出查询时间资源限制(8100 秒)。）_

为了帮助解决和在将来避免这些错误，请参见上面的 [不要超过超时限制](#timeout_avoid)部分。

<!-- document id=dcc5de6f6bf96996d72bcd4aa41060d503f10319376412e63f870cfbaeacaaeb url=/tableau/next/zh-cn/online/dashboard_extensions_server.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Cloud 中管理仪表板扩展程序和可视化项扩展程序

Tableau 扩展程序是 Web 应用程序，可帮助扩展 Tableau 工作簿中提供的分析功能。扩展程序可无缝集成，从而使用 [Tableau Extensions API](https://tableau.github.io/extensions-api) 与 Tableau 工作簿的其他部分进行交互。

仪表板扩展程序在自定义仪表板区域中运行，并可与仪表板的其他部分交互。仪表板扩展程序使用户能够直接在 Tableau 中与其他应用程序交互。可视化项扩展程序在工作表中运行，并使用户能够使用自定义可视化项类型。Tableau 用户可以将仪表板扩展程序作为仪表板对象来访问，并通过工作表“标记”卡访问可视化项扩展程序。

**注意：**站点管理员可以将仪表板扩展程序和可视化项扩展程序添加到允许列表，以及控制扩展程序可访问的数据类型。站点管理员还可配置站点上的用户在添加或查看扩展程序时是否将看到提示。有关扩展程序安全性和推荐部署选项的信息，请参见[扩展程序安全性 - 部署最佳做法](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。

有关在 Tableau 中使用仪表板扩展程序的信息，请参见[使用仪表板扩展程序](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_extensions.htm)。  

有关使用可视化项扩展程序的信息，请参见[将可视化项扩展程序添加到您的工作表](https://help.tableau.com/v0.0/pro/desktop/zh-cn/viz_extensions.htm)。

期望使用 Tableau Server？请参见[在 Tableau Server 中管理仪表板扩展程序](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm "在新浏览器选项卡中打开主题")。

## 在 Tableau Cloud 上运行扩展程序之前

扩展程序是一个开放平台，但通常有两个标准需要考虑：

- Tableau 可信扩展程序，即经过专门审查并在 Tableau 托管主机上部署的扩展程序。这些扩展程序包括由 Tableau 构建和管理的解决方案；由 Tableau Exchange 合作伙伴构建的解决方案（使用 Tableau 审查和主机服务进行部署），以及在我们的旧版沙盒化扩展程序的受保护环境中托管的解决方案。
- 支持网络的扩展程序，即托管在任何第三方主机上的扩展程序。当开发人员选择在没有 Tableau 参与的情况下管理其扩展程序的交付时，支持网络的扩展程序可能很有用。这包括合作伙伴为提供更好的生产支持而直接管理的扩展程序；在您自己的本地网络中托管和部署的扩展程序，或需要与 Tableau 外部的第三方服务通信的扩展程序。支持网络的扩展程序具有对 Web 的完全访问权限。

**注意：**Tableau 通过 Einstein Discovery 仪表板扩展程序支持与 SalesforceEinstein Discovery 集成。这是一个特殊的扩展程序，可以访问 Salesforce.com 中的数据，并且默认情况下是允许的。它不被视为支持网络的扩展程序或沙盒化扩展程序。有关 Einstein Discovery 集成的详细信息，请参见[配置 Einstein Discovery 集成](https://help.tableau.com/v0.0/online/zh-cn/config_einstein_extensions.htm#2021-1-einstein-predictions)。

### Tableau 可信扩展程序

从 2025.3 开始，Tableau 可信扩展程序表示 Tableau Exchange 中已提升为可使用的扩展程序的子集。可信扩展程序托管在 Tableau 主机上，并且是限制用户客户端和 Tableau 之间的通信所必需的。这些扩展程序已经过网络通信测试，并在部署前扫描了漏洞。此扩展程序标准用于提供更受管控的扩展程序访问。此标准包括：

- 沙盒化扩展程序由 Tableau 托管，并采用诸如内容安全策略 (CSP) 等 W3C 标准，以确保扩展程序无法在 Tableau 沙盒主机之外进行网络调用。沙盒化扩展程序可以查询数据，但沙盒环境显式阻止在其他地方传输该数据。Tableau 2019.4 及更高版本中支持沙盒化扩展程序。默认情况下，如果为站点启用了扩展程序，则允许运行沙盒化扩展程序。
- Tableau 构建的扩展程序是由 Tableau 开发团队开发并积极维护的解决方案。Tableau 构建的扩展程序被明确设计为将通信定向到用户客户端，而不是查询用户数据。按照设计，这限制了数据泄露和数据保留的风险。Tableau 构建的扩展程序还符合 Salesforce 软件开发生命周期 (SDLC) 标准。默认情况下，如果为站点启用了扩展程序，则允许运行 Tableau 构建的扩展程序。
- Tableau 可信合作伙伴构建的扩展程序是由认可的 Tableau 和 Salesforce 合作伙伴开发并积极维护的解决方案，这些合作伙伴为 Tableau Exchange 做出了贡献。在将这些第三方解决方案部署为 Tableau 可信扩展程序之前，Tableau 开发人员会通过手动测试对其进行验证。Tableau 开发人员在将扩展程序部署到专用 Tableau 主机之前，会对扩展程序进行功能和网络通信测试并自动扫描代码。可以启用 Tableau 可信合作伙伴构建的扩展程序以供 Tableau 管理员使用。

### 支持网络的扩展程序

支持网络的扩展程序是 Web 应用程序，可在任何设置为 Web 服务器上的计算机上运行。其中包括本地计算机、域中的计算机以及第三方 Web 服务。由于支持网络的扩展程序可托管在第三方服务器上，并且可访问工作簿中的数据，因此您需要仅允许信任的扩展程序。请参见[测试支持网络的扩展程序以保障安全性](#Test)。

### 默认扩展程序设置

管理员可以使用 Tableau Cloud 上扩展程序的设置来控制和限制允许运行的扩展程序。

- 默认情况下，除非显式禁用，否则扩展程序将启用运行。站点管理员可以为任何给定站点禁用此选项。
- 我们建议允许使用 Tableau 可信扩展程序。默认情况下，如果为站点启用了扩展程序，则沙盒化扩展程序和 Tableau 构建的扩展程序将启用运行；管理员可以启用 Tableau 可信合作伙伴构建的扩展程序。
- 默认情况下，除非已显式将扩展程序添加到安全列表，否则不允许使用支持网络的扩展程序。只允许使用 HTTPS 协议的扩展程序，该协议可保障一条用于发送和接收数据的加密通道（唯一的例外情况是 `http://localhost`）。某些扩展程序需要完整数据权限（访问基础数据）。除非您显式将扩展程序添加到允许列表，并授予扩展程序访问完整数据的权限，否则这些扩展程序无法在 Tableau Cloud 上运行。

## 控制扩展程序的使用

站点管理员可控制是否为该站点启用扩展程序，以及是否允许在该站点上使用 Tableau 可信扩展程序。默认站点设置允许在站点上运行沙盒化扩展程序和 Tableau 构建的扩展程序，前提是未在服务器上明确阻止该扩展程序。默认站点设置允许支持网络的扩展程序在站点的允许列表中注册后运行。可以将任何扩展程序显式添加到允许列表，从而允许该扩展程序在站点上使用。

1. 若要为站点更改这些设置，请转到“设置”>“扩展程序”。
2. 在“仪表板扩展程序和可视化项扩展程序”下，配置以下选项：
    
    - 允许扩展程序在此站点上运行
    - 允许可信扩展程序在此站点上运行

站点管理员可在站点的安全列表中添加或移除扩展程序。将扩展程序添加到允许列表时，您可以配置允许扩展程序拥有完整数据访问权限（如果需要）的权限。请参见[将扩展程序添加到允许列表并配置扩展程序](#Add)。

## 使用允许列表

使用允许列表以允许特定扩展程序在站点上运行。允许列表主要用于支持网络的扩展程序。与 Tableau 可信扩展程序（由已知 Tableau 主机提供并允许默认运行）不同，除非已显式将支持网络的扩展程序添加到允许列表，否则不允许使用这些扩展程序。允许列表还允许您控制是否要求用户授予权限以允许扩展程序运行，以及扩展程序是否有权访问工作簿中的完整数据（基础数据）。

默认情况下，允许运行 Tableau 可信扩展程序，其中包括沙盒化扩展程序和 Tableau 构建的扩展程序。除非默认设置已更改，并且不再允许这些扩展程序，否则您不需要将它们添加到允许列表。这同样适用于 Tableau 可信合作伙伴构建的扩展程序，如果允许，则无需将它们显式添加到允许列表。

### 标识扩展程序的 URL

作为 Web 应用程序，扩展程序与 URL 关联。您可以使用此 URL 来测试和验证扩展程序。您还使用 URL 将扩展程序添加到允许列表以允许完整数据访问权限，或将扩展程序添加到阻止列表来禁止任何访问。  
若要允许支持网络的扩展程序或其他扩展程序，您需要找到扩展程序的 URL，然后将该 URL 添加到允许列表。将 URL 添加到允许列表即表示您批准了与 Web 应用程序的通信。有几种方法可以确定扩展程序的 URL。  

#### 从 Tableau Exchange 中  

使用从 Tableau Exchange 下载的扩展程序时，您可以在 Exchange 列表页面上找到该扩展程序的 URL。打开扩展程序的图块，在“技术规格”下，查找标题“托管于”下的 URL。

![扩展程序的 Tableau Exchange 图块，显示了在哪里可以找到托管位置 URL](/tableau/next/zh-cn/online/zh-cn/Img/gallery_ext_url_350x187.png)  

#### 从清单文件中  

如果有扩展程序清单文件 (`.trex`)，即一个定义扩展程序属性的 XML 文件，您可以从 `<source-location>` 元素中找到 URL。如果使用 Web 浏览器从 Tableau Exchange 下载扩展程序，则可以检索清单文件。在文本编辑器中打开清单文件。

```

<source-location>
    <url>https://www.example.com/myExtension.html</url>
</source-location>

				
```

#### 使用“关于”对话框识别仪表板扩展程序

对于仪表板扩展程序，您可以从仪表板扩展程序上下文菜单中的扩展程序属性中找到 URL。从“更多选项”菜单中，单击“关于”。

![包含以下选项的上下文菜单：“关于”、“重新加载”、“调试选项”、“浮动”、“固定宽度”、“编辑宽度”、“选择布局容器”、“取消选择”和“从仪表板中移除”。](/tableau/next/zh-cn/online/zh-cn/Img/about_extension_menu_224x217.png)

“关于”对话框列出扩展程序的名称、作者、作者的网站，以及扩展程序的 URL。

![包含有关数据源示例扩展程序的详细信息（例如其 URL、版本号和实例 ID）的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/about_extension_url_281x209.png)

### 将扩展程序添加到允许列表并配置扩展程序

若要允许用户访问支持网络的扩展程序，请将扩展程序添加到站点的允许列表。默认情况下，当您向允许列表添加扩展程序时，该扩展程序仅有权访问摘要（或聚合）数据。您还可以控制用户是否会看到请求他们允许扩展程序访问数据的提示。您可能会只是为了配置用户是否看到提示而需要将扩展程序添加到允许列表（例如，沙盒化扩展程序）。当您向用户隐藏提示时，扩展程序可立即运行。

1. 转到“设置”>“扩展程序”。
2. 在“启用特定扩展程序”下，添加扩展程序的 URL。请参见[标识扩展程序的 URL](#Identify)。
    
    **提示：**您可以使用句点和星号 (`.*` ) 作为 URL 中的通配符，以允许特定域或位置中的所有扩展程序。例如，若要允许 example.com 下使用端口 8080 的域中的所有扩展程序，您可以添加以下 URL：`https://example.com:8080/.*`。有关详细信息，请参见[在安全列表 URL 中使用正则表达式](#RegEx)。
3. 选择以允许或拒绝扩展程序完整数据访问权限。
    
    完整数据访问权限是指访问视图中基础数据的权限，而不仅仅是访问汇总或聚合数据的权限。完整数据访问权限还包括有关其数据源的信息，例如连接、字段和表的名称。通常，如果您要将要使用的扩展程序添加到安全列表中，您还希望允许该扩展程序访问完整数据（如果该扩展程序需要）。在将扩展程序添加到允许列表之前，一定要[测试支持网络的扩展程序以保障安全性](#Test)。
4. 选择以显示或隐藏用户提示。
    
    默认情况下，当用户向仪表板添加仪表板扩展程序或向工作表添加可视化项扩展程序时，或者当他们与具有扩展程序的视图进行交互时，会看到提示。提示告知用户有关扩展程序的详细信息以及扩展程序是否能访问完整数据。用户可以利用提示来允许或拒绝扩展程序运行。您可以向用户隐藏提示，从而允许扩展程序立即运行。

### 确保扩展程序具有访问工作簿或视图的权限

仪表板或可视化项扩展程序需要访问视图中的可见数据。可见数据是显示在工作表或仪表板中的汇总数据。确保工作簿或视图允许下载摘要数据的权限。扩展程序不下载数据。扩展程序只需要权限，就可以与视图中的数据交互。

### 在安全列表 URL 中使用正则表达式

一般情况下，将扩展程序添加到安全列表时，应该使用该扩展程序的具体 URL。但是，有时您可能希望允许从同一域和位置托管多个扩展程序。在这种情况下，在 URL 中使用通配符会很方便。扩展程序设置支持使用正则表达式。

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 162px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 540px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">正则表达式</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">描述</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>.</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">句点 (.) 是用于匹配任何字符的通配符。如果您需要在 URL 中指定句点 (.) 而不是通配符，则可以使用反斜杠 (<code>\.</code>) 对字符进行转义。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>*</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">星号 (*) 是指定前一个字符的一个或多个实例的限定符。</td></tr></tbody></table>

使用通配符时要小心，以免使允许列表过于宽松，并无意中允许不应有访问权限的扩展程序进行访问。

下表显示了在 URL 中使用正则表达式的一些示例。请注意，这些示例未显示扩展程序的协议和完整 URL。仅允许使用 HTTPS 协议的扩展程序（http://localhost 除外）。

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 242px;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 304px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">若要指定...</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">示例</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">指定</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">域范围</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">.*\.example.com</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">example.com 下的所有子域。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">所有端口</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">example.com:.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">允许扩展程序从 example.com 上的所有端口访问。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">域、端口和路径下的所有扩展程序</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">example.com:8080/xyz/.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>域 example.com 下所有使用端口 8080 且位于 zyz 的扩展程序都被允许访问。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">一系列域的所有端口</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">.*\.example.com:.*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">允许访问 example.com 下所有子域上的所有端口上的扩展程序。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">域和路径下与该模式匹配的所有扩展程序</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">example.com/t.c/.*</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">允许访问在 example.com 上与模式 t.c 匹配的文件夹下运行的扩展程序例如，tic、tac、toc。</td></tr></tbody></table>

## 测试支持网络的扩展程序以保障安全性

扩展程序是使用 Extensions API 与 Tableau 中的数据进行交互的 Web 应用程序。如果您选择允许未由 Tableau 直接审查和管理的支持网络的扩展程序，则用户应该知道，这些扩展程序可以进行网络调用并可以访问 Internet 上的资源。Tableau 建议在推出支持网络的扩展程序以供广泛采用之前对其进行测试和了解。  

### 检查源文件

扩展程序包括各种 HTML、CSS 和 JavaScript 文件，以及一个定义扩展程序属性的 XML 清单文件 (\*.trex)。审查支持网络的扩展程序时，我们建议直接联系扩展程序开发人员以获取访问权限和审查权限。Tableau 不分发或提供对其他开发人员源文件的访问权限。

如果扩展程序的代码在 GitHub 上公开提供，可在该处进行检查或下载。在清单文件 (`*.trex`) 中，您可以找到源位置（或指明扩展程序托管位置的 URL）、作者姓名，以及可联系以寻求支持的作者或公司网站。`<source-location>` 元素指定 URL，`<author>` 元素指定可联系以寻求支持的组织名称和网站 (`website="SUPPORT_URL"`)。网站是用户在仪表板扩展程序的“关于”对话框中看到的“获取支持”链接。

扩展程序引用外部 JavaScript 库，如第三方的 jQuery 库或 API 库。验证外部库的 URL 是否指向库的受信任位置。例如，如果扩展程序引用 jQuery 库，请确保该库在一个被认为标准和安全的网站上。

所有扩展程序都需要使用 HTTPS 协议 (`https://`) 来托管其扩展程序。您应检查扩展程序的源文件，确保对外部库的引用也使用 HTTPS 或者托管在扩展程序所在的同一网站上。如果扩展程序托管在 Tableau 所在的同一计算机 (`http://localhost`) 上，则无需使用 HTTPS。

尽可能确保了解代码的作用。尤其是，试着了解代码如何构建至外部站点的请求，以及请求中发送了什么信息。特别是，请检查任何用户提供的数据是否经过验证以防止跨站点脚本。

### 了解数据访问

Tableau 扩展程序主要处理工作表或仪表板中呈现的摘要聚合数据。但是，Tableau Extensions API 提供了在扩展程序声明需要完整数据访问权限时可访问基础数据的方法。这些方法可访问数据源中活动表和字段的名称、数据源连接的摘要描述，以及工作表中的基础数据。如果扩展程序在视图中使用任何这些方法，扩展程序开发者必须在清单文件 (`.trex`) 中声明扩展程序需要完整数据权限。声明如下所示。

```

<permissions>
   <permission>full data</permission>
</permissions>
```

Tableau 使用此声明在运行时向用户提供提示，使用户能够选择是否允许此访问权限。如果扩展程序使用这些方法的其中任何一种，则在清单文件中未声明完整数据权限的情况下，扩展程序将会加载，但方法调用将失败。

有关扩展程序如何访问仪表板中的数据以及所使用的 JavaScript 方法的信息，请参见 Tableau Extensions API 中的[访问基础数据](https://tableau.github.io/extensions-api/docs/security/trex_data_access)。为了更好地了解扩展程序可找出哪些数据相关信息，您可以使用 [DataSources](https://github.com/tableau/extensions-api/tree/master/Samples/Dashboard/DataSources) 示例仪表板扩展程序（可从 [Tableau Extensions API GitHub 存储库](https://github.com/tableau/extensions-api)获得）来查看在调用 `getDataSourcesAsync()` 方法时公开了哪些数据。

### 在隔离环境中测试扩展程序

如有可能，Tableau 建议在与您的生产环境和用户计算机隔离的环境中测试扩展程序。例如，在所运行的 Tableau Cloud 版本并非用于生产的测试计算机或虚拟机上，将仪表板扩展程序或可视化项扩展程序添加到允许列表。

### 监视仪表板扩展程序创建的流量

若要评估支持网络的扩展程序所使用的潜在网络调用，请使用 Web 调试工具（如 [Fiddler](http://www.telerik.com/fiddler)、[Charles HTTP 代理](http://www.charlesproxy.com/)或 [Wireshark](https://www.wireshark.org/)）来检查扩展程序发出的请求和响应。确保您了解扩展程序所请求的内容。检查流量以确保扩展程序不读取与扩展程序的用途不直接相关的数据或代码。

<!-- document id=83ff1dc467e95a86fa8a0ca1285b5038bba0bc64cd8f5b6e0c95096a6c071973 url=/tableau/next/zh-cn/online/server_backgrounder_job_management.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Cloud 中管理后台作业

在 Tableau Cloud 中，用户可以计划定期运行数据提取刷新、订阅或流程。这些计划的项目称为**任务**。后台程序进程启动这些任务的唯一实例，以在计划时间运行它们。作为结果启动的任务的唯一实例称为**作业**。还会为通过单击“**立即运行**”选项手动启动、以编程方式通过 REST API 启动或者通过 tabcmd 命令启动的运行创建作业。

例如，创建一个数据提取刷新任务以在每天上午 9 点运行。这是一个数据提取刷新任务，每天上午 9 点系统将会创建一个作业以供后台程序运行。

运行所有这些作业可能意味着后台程序在一天中的各个时间都会占用大量资源。使用“作业管理”功能，站点管理员可以获取有关在其站点上运行的这些作业的详细信息，并对这些作业采取措施以更好地管理资源使用情况。

“**常规**”设置页面上的“**立即运行”**设置还允许您通过允许或阻止用户手动运行作业来管理资源。默认情况下，此选项处于选定状态，以允许用户手动运行作业。清除复选框以防止用户手动运行作业。

通过导航到左侧导航菜单的“**现有任务**”菜单，可以访问包含作业相关信息的“作业”页面。

**注意：**作业相关信息只能由站点管理员查看。

## 概述

本主题介绍如何查看和了解“作业”页面中显示的信息。

您的 Tableau Cloud 站点具有支持所有用户分析需求的容量。站点的容量包括用于存储的容量，以及用于需要在站点上针对数据提取、指标、订阅和流程执行的任务的容量。(Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)。) 通过作业页面，您可以监视 Tableau Cloud 站点的任务。有关站点容量的详细信息，请参见[Tableau Cloud 容量](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm)。

该页面的顶部显示了过去 24 小时内**“失败”**、**“已完成”**和**“已取消”**作业的详细统计信息。应用筛选器不会更改这些值。

![显示失败、完成和取消的作业数量以及作业筛选器图标位置的作业页面。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_management._siteadmin.png)

对于生成的每个作业，都有一个作业 ID、该作业的状态、优先级、从中生成作业的任务类型，以及当前运行时间（如果作业正在进行）、当前队列时间（如果已排队），以及平均运行时间和平均队列时间。

**注意：**无法在 Tableau Cloud 中调整任务和计划的优先级。

Tableau 会记录历史运行时间和队列时间以计算平均运行时间和平均队列时间。使用以下公式将平均运行时间和平均排队时间计算为加权平均值：（（当前运行时间或队列时间平均值 x 4）+ 最近运行时间或队列时间）/5。

在“**管理视图**”上查看作业时，作业 ID 可能很有用。单击作业 ID 时，您将看到有关作业的更多详细信息，例如作业 LUID、项目名称、计划、内容名称、内容所有者、作业创建者、作业上次成功运行的时间，以及站点名称。

![Job 975 的详细信息包括唯一 ID、项目名称、时间表、内容、所有者、创建者和上次成功运行日期。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_details_siteadmin.png)

**注意：**从**“数据源”**页面中执行**“立即刷新”**将只会在**“作业详细信息”**对话框中显示 LUID 信息。

### 任务类型

有若干类型的任务：

- Bridge 刷新：包括使用 Cloud 计划的完全和增量数据提取刷新。有关详细信息，请参见[关于 Bridge 刷新作业](#bridge)。
- 数据提取：此任务包括数据提取创建、增量数据提取刷新和完全数据提取刷新。。
- 订阅：包括工作簿和视图的订阅。有关详细信息，请参见[创建视图或工作簿订阅](https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm)。
- 流程：此任务包括计划流程和手动流程运行。有关流程的最大运行时间的信息，请参见[作业运行时容量](https://help.tableau.com/current/online/zh-cn/to_site_capacity.htm)；有关运行并发流作业时的容量限制的信息，请参见[并发作业容量](https://help.tableau.com/current/online/zh-cn/to_site_capacity.htm)。计划的流程多于您拥有的资源块的数量可能会导致错误。有关详细信息，请参见知识库文章[流程作业挂起](https://kb.tableau.com/articles/Issue/flow-job-pending-with-cannot-run-because-your-site-has-reached-its-concurrency-limit-for-extract-refreshes?lang=zh-cn)。
    
    从版本 2025.2 开始，“作业详细信息”对话框将显示指向 Tableau Prep 流程的链接。快速导航到“流程位置”页面以获取有关流程的更多详细信息。如果删除了流程，则该链接将不会显示。
    
    ![显示 Tableau Prep 流程链接的“作业详细信息”对话框](/tableau/next/zh-cn/online/zh-cn/Img/prep_jobs_flow_link.png)
- 加密：包括以下各项：
    
    - 数据提取加密和解密
    - 流程加密和解密
    - 更新数据提取和流程的密钥

### 筛选器

您可以进行筛选以便仅查看某些作业。可用筛选器包括“作业状态类型”、“任务类型”和“时间范围”。对于“时间范围”筛选器，您可以选择从过去一小时到 24 小时的范围（以四小时为增量）。

## 取消作业

可以取消数据提取刷新、订阅和流程运行作业。您一次只能取消一个作业，不支持一次选择多个作业进行取消。

取消作业时，会向您在**“取消作业”**对话框中选择的收件人发送一封电子邮件，其中包含作业取消时间、受影响的内容以及取消之前的作业运行时间。此外，还可以添加要包括在电子邮件中的自定义注释。

如果未选择任何收件人，则将取消该作业，但不会发送电子邮件。

若要取消作业，请单击作业 ID 旁边的省略号，然后使用对话框取消作业：

![“取消”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_cancel.png)

## 状态

作业可以处于七种类型的状态，将鼠标光标悬停在每个状态上时，将会显示更多相关信息。

- **已完成：**此作业显示为“**已成功完成**”，并且，您可以在将鼠标光标悬停在状态上时显示的工具提示中看到作业的完成时间。
    
    ![“已完成”一词旁边会出现一个绿色复选标记。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_completed.png)
    
    ![一条消息表明一项作业于 2019 年 6 月 13 日上午 10:23 成功完成。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_completed_tootip.png)
- **正在进行：**此作业显示为“**正在进行**”。作业已运行的时长将显示在将鼠标光标悬停在状态上时显示的工具提示中。
    
    ![“正在进行”图标。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_inprogress.png)
    
    ![显示正在进行的作业运行时间的工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_inprogress_tooltip.png)
- **正在进行：**此作业处于“**正在进行**”状态，但**延迟运行**。Tableau 会跟踪同一作业的平均运行时间，如果当前运行时间长于平均运行时间，则被视为延迟运行。将鼠标光标悬停在状态上时显示的工具提示中显示了作业运行的时间比平均时间长多少，以及作业的平均运行时间。
    
    ![“正在进行”图标表示作业运行时间比之前的运行时间更长。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_late.png)
    
    ![一个工具提示，显示正在进行的作业运行时间超过了之前的运行时间。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_late_tooltip.png)
- **待处理：**作业当前处于“**待处理**”状态，正在等待在有可用后台程序容量时运行。将鼠标光标悬停在状态上时显示的工具提示中提供了作业已处于队列中的时长。
    
    ![“作业排队”图标。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_queued.png)
    
    ![显示正在进行的排队时间的工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_queued_tooltip.png)
- **待处理：**流程无法运行，因为资源块数小于您计划的流程数，且站点已达到其并发限制。
    
    ![“作业排队”图标。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_queued.png)
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_pending_flow.png)
- **待处理：**作业当前处于“**待处理**”状态，但**延迟运行**。Tableau 会跟踪同一作业的平均队列时间，如果当前队列时间长于平均队列时间，则被视为延迟运行。将鼠标光标悬停在状态上时显示的工具提示中显示了作业排队时间比平均时间长多少。
    
    ![表示排队时间比之前的运行更长的“作业排队”图标。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_queued_late.png)
    
    ![显示正在进行的排队时间超过之前排队时间的工具提示。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_queued_late_toolip.png)
- **已取消：**站点管理员**已取消**此作业。将鼠标光标悬停在状态上时显示的工具提示中提供了作业的取消时间以及它在取消之前的运行时长。
    
    ![一个黄色感叹号和“已取消”字样。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_canceled.png)
    
    ![一条消息显示，一项作业在运行了 29.5 分钟后于 2019 年 6 月 11 日晚上 9 点 55 分被取消。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_canceled_tooltip.png)
- **失败：**作业显示为“**失败**”。将鼠标光标悬停在状态上时显示的工具提示中提花了作业的失败时间、它在失败之前的运行时长，以及作业的失败原因。
    
    ![“失败”一词旁边有一个红色感叹号。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_failed.png)
    
    ![消息表明，一项作业由于凭据无效，运行 51.6 分钟后于 2019 年 6 月 11 日凌晨 4:23 失败。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_failed_tooltip.png)
- **挂起：**此作业显示为**“失败”**，并带有暂停图标。如果作业连续五次失败，则作业将挂起。挂起的任务仍可用，但后台程序将不会为这些任务创建作业，直到用户恢复这些作业为止。
    
    ![“作业挂起”图标。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_suspended.png)
    
    ![一个工具提示，解释挂起的任务无法运行。](/tableau/next/zh-cn/online/zh-cn/Img/backgrounder_job_suspended_details.png)

### 关于 Bridge 刷新作业

尽管 Bridge 刷新作业可以生成与其他作业类型相同的状态，但 Bridge 刷新作业在以下方面有所不同：

- **取消作业：**无法从“作业”页面取消 Bridge 刷新作业。相反，请确保为 Bridge 客户端配置了适当的超时限制，以防止任何刷新误用。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#timeout)。
- **“发送到 Bridge”作业状态**：刷新作业已成功发送到池中的 Bridge 客户端。
- **“已完成”作业状态**：刷新已成功完成。
- **“失败”作业状态**：如果刷新因任何原因失败，状态将变为“失败”。发布者（数据源所有者）会通过帐户通知和失败电子邮件通知收到通知。这些通知为发布者提供故障排除步骤，以帮助解决问题。
- **订阅和 Bridge 刷新作业**：不能通过已完成 Bridge 刷新作业来启动订阅作业。这是因为已完成的 Bridge 刷新作业仅指示刷新作业是否已成功发送到池中的 Bridge 客户端，而不指示刷新作业是否已成功完成。

**说明** 

- 不会在“作业”页面上捕获来自“Bridge（旧版）”计划的刷新作业。若要监视“Bridge（旧版）”计划的刷新作业，您可以参考“Bridge 数据提取”管理视图。有关详细信息，请参见[Bridge 数据提取](https://help.tableau.com/v0.0/online/zh-cn/adminview_bridge_extract.htm)。
- 如需对“作业”页面上看到的 Bridge 错误进行故障排查，请参见[池化疑难解答](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#errors)。

### Data Connect 和 Tableau Bridge 的监控解决方案

Tableau Cloud 中提供了多种监视解决方案，可帮助您管理 Data Connect 和 Tableau Bridge 的不同监视场景。所有这些解决方案默认均可供管理员使用。如果需要，可以向其他个人提供“在线管理见解”。

- 作业页面：监控过去 24 小时内执行的作业的实时数据提取作业状态，如本主题前面所述。
- 管理视图：监控实时数据提取作业的状态和性能。包括近期工作历史记录以供长期分析。请参见 [查找管理视图](https://help.tableau.com/v0.0/online/zh-cn/adminview.htm)。
- 在线管理见解：使用在您的环境中发布的 Tableau Cloud 数据源监控作业状态和性能。此数据每天更新，并显示历史数据以供长期分析。如果需要，可以与非管理员用户共享。请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

有关如何使用这些工具以及部署 Data Connect 和 Bridge 的其他最佳做法的详细信息，请下载白皮书 [使用 Tableau Cloud 访问您的私有网络数据 - Data Connect 和 Tableau Bridge 最佳做法](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)。

<!-- document id=b42e4934f721e939e9925e767981e921f546a01fb6172fae5f198cc882cb0ae3 url=/tableau/next/zh-cn/online/prep_conductor_configure_online.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Cloud 站点上启用 Tableau Prep Conductor

购买 Data Management 后，Prep Conductor 会自动在您的 Tableau Cloud 站点上启用。有关如何购买 Data Management 的信息，请与您的客户经理联系。

## 验证 Tableau Prep Conductor 是否已启用

1. 在 Tableau Prep Builder 中，通过选择**“服务器”**\>**“登录”**登录到 Tableau Cloud.
    
    如果您的站点设置为使用 Tableau 身份验证，请输入用于 Tableau Cloud 的用户名（电子邮件地址）和密码，然后单击“登录”。如果通过 Tableau 身份验证启用了多重身份验证 (MFA)，系统会提示您使用您在 MFA 注册过程中选择的验证来验证您的身份。如果您是第一次登录 Tableau Cloud 或注册 MFA，请参见[注册多重身份验证](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm#mfa_register_user)。
    
    验证您的身份后，您将被重定向到您的站点。
2. 打开您的任何流程。
3. 验证是否有**“计划任务”**选项卡。如果有该选项卡，则 Prep Conductor 已启用。

<!-- document id=0a995ba6fb2b7bc0bf00aea17d9071573c7b934d6f2fd81fb11cecc89a98626a url=/tableau/next/zh-cn/online/pulse_manage_followers.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Pulse 中关注指标并管理关注者

您可以通过关注 Tableau Pulse 指标来跟踪这些指标。关注者特定于每个指标，而不是指标定义。这样，您就可以关注您的角色范围内的指标，并仅收到相关的见解。每当您筛选指标时，如果不存在具有唯一筛选器组的指标，则会创建一个新指标。关注者不会从您查看的上一个指标延续下来，因此你需要关注新的指标。有关创建指标的信息，请参见[创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#create-metrics)。

## 关注指标

1. 打开您想要跟踪的指标。
2. 选择“关注”。您还可以从指标卡中选择“更多操作”菜单 (...)，然后选择“关注”。

您将在 Tableau Pulse 主页和摘要中看到此指标。有关配置摘要的信息，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)。

当您关注两个或更多指标时，Tableau Pulse 在摘要和 Tableau Pulse 主页上提供见解摘要，以帮助您快速获取指标的最新更新。为了显示这些摘要，您的 Tableau 管理员必须启用见解摘要的站点设置。有关详细信息，请参见[启用指标见解摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#pulse-insight-summaries)。

## 取消关注指标

1. 打开您不再想要关注的指标。
2. 选择“正在关注”。您还可以从指标卡中选择“更多操作”菜单 (...)，然后选择“取消关注”。

如果您取消关注某个指标，该指标将不再显示在您的 Tableau Pulse 主页或摘要中。如果您作为用户组的一部分关注某个指标，则您无法单独取消关注该指标。必须从关注者列表中移除该组。有关详细信息，请参见[移除关注者](#remove)。

## 添加关注者

您可以将其他用户或组添加为指标的关注者。

1. 打开您想要添加关注者的指标。
2. 选择“关注者”按钮。
3. 在搜索框中，输入要添加的用户或组的名称。
4. 选择“添加”。

如果将用户作为组的一部分添加到指标，这些用户无法单独移除自己。如果您希望用户能够控制他们所关注的指标，请将他们添加为个人。

## 移除关注者

1. 打开您想要从中移除关注者的指标。
2. 选择“关注者”按钮。
3. 在关注者姓名旁边，选择“移除”。

如果关注者被从指标中移除，他们不会收到通知，因此移除关注者组时要小心。如果组内的用户从 Tableau Pulse 接收的摘要比他们想要的多，他们可以关闭频道的摘要或通过调整其首选项来降低摘要频率。用户还可以关闭单个指标的通知。有关详细信息，请参见[管理您的 Tableau Pulse 摘要](https://help.tableau.com/v0.0/online/zh-cn/pulse_explore_metrics.htm#manage-digest)和[针对指标关闭通知](https://help.tableau.com/v0.0/online/zh-cn/pulse_alerts.htm#turn-off)。

<!-- document id=a15f7f2a6d4f9fc4a63c5c516c4ff31a5f2d75d18d5c6ef6cad5dfed3ba01257 url=/tableau/next/zh-cn/online/pulse_ask_discover_qa.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Pulse 中提出问题并发现见解

Tableau Pulse 通过提出见解和建议进一步探索的问题，从而帮助您调查数据。当您点击有关数据的问题时，答案会显示在图表中，其中包含有关基础数据的见解。有两种方式可以探索见解：Ask Q&A 和 Pulse 中的 Tableau Agent。

[Ask Q&A](#Ask) 会针对单个指标的预先检测到的见解提出问题建议。Ask Q&A 始终可用，并且不使用 Tableau 中的 AI 。

[Pulse 中的 Tableau Agent](#Explore) 是一种对话式 AI，可帮助您探索指标组。用您自己的语言提出问题，Pulse 中的 Tableau Agent 使用统计算法来检查分组指标并显示有趣且值得研究的见解。由于 Pulse 中的 Tableau Agent 会查看分组指标，因此它可以揭示您在仅探索单个指标时可能会错过的见解。

## 什么是 Pulse 中的 Tableau Agent？

**注意：**增强型问答 (Discover) 已重命名为 Pulse 中的 Tableau Agent。功能保持不变。只是名称发生了变化。您将在即将发布的版本中看到名称更改。

Pulse 中的 Tableau Agent 是一种由 AI 驱动的工具，可帮助您探索跨指标组的见解。

- **这是一种以对话方式探究指标的方法。**您的第一个问题只是一个开始。通过询问不同的维度和时间段来深入挖掘，以获得更多见解。
- **它适合所有人，无论您的经验水平如何。**您无需数据可视化专业知识即可获得可操作的见解。使用自然语言来了解是什么推动了指标的变化。
- **它的作用是在您探索的过程中提供指引。**如果您不确定要问什么，Pulse 中的 Tableau Agent 会提供建议的初始问题和后续问题。
- **它的范围限于 Tableau Pulse 中的指标。**Pulse 中的 Tableau Agent 是一种专用 AI，可帮助您了解指标，但不适用于一般问答。
- **它植根于可信赖的见解。**每个答案都有基于您的指标的引文支持。这些引文通过可视化项来说明，可帮助您一目了然地了解该数据。
- **它了解指标组。**Pulse 中的 Tableau Agent 比单个指标更广泛地关注您的数据。当您询问更广泛的指标集时，Pulse 中的 Tableau Agent 会查看分组的指标，以发现您在单独查看单个指标时看不到的见解。

## 使用 Pulse 中的 Tableau Agent 探索指标组

当 Pulse 中的 Tableau Agent 启用时，它会显示在 Tableau Pulse 主页上。对于按数据源或定义排序的指标，将显示“向 Pulse 中的 Tableau Agent 提问”按钮。当您使用此按钮提出问题时，Tableau Pulse 会查看组中的所有指标以查找见解。对于按数据源、定义或时间范围排序的指标，有一些建议的问题供您探索。这些问题着眼于组中指标的子集。Pulse 中的 Tableau Agent 突出显示共同的贡献者，检测趋势何时一起或向相反方向移动，标记指标中的异常值，并识别共同高于或低于预期范围的指标。

> [!IMPORTANT]
> 
> **重要信息**：Pulse 中的 Tableau Agent 是一项必须在 Tableau Cloud 站点设置中启用的 Tableau+ 功能。有关详细信息，请参见[启用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-enhancedQA-discover)。如果您的站点没有 Tableau+ 许可版本，您可以使用 Try AI 试用 Pulse 中的 Tableau Agent。有关详细信息，请参见[试用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm)。

### 使用 Pulse 中的 Tableau Agent 提问

若要开始使用 Pulse 中的 Tableau Agent，请在“关注”选项卡上询问有关指标的问题。您还可以通过在电子邮件摘要中选择问题，或选择指标上的“提问”按钮然后选择建议的问题，来访问 Pulse 中的 Tableau Agent。

1. 在 Tableau Pulse 主页上的一组指标下，选择“向 Pulse 中的 Tableau Agent 提问”。仅当您按数据源或指标定义对指标进行排序时，才会显示此按钮。如果您不确定要问什么，可以选择一个建议的问题。
    
    ![Tableau Pulse 主页示例，其中包含一组按数据源排序的已关注指标，以及有关该组指标的建议问题。](/tableau/next/zh-cn/online/zh-cn/Img/pulse_discover_quick_query.png)
2. 在出现的文本框中，输入有关数据的问题。有关您可以提出的问题的示例，请参见[Pulse 中的 Tableau Agent 的示例问题](#example-questions)。
3. 在“Pulse 中 Tableau Agent”页面上，见解摘要回答了这个问题。单击见解末尾的引用链接即可查看其来源。单击“指标来源”查看在生成响应时被视为分析一部分的指标。
    
    ![Pulse 中的 Tableau Agent 页面，包含见解摘要文本和来源指标](/tableau/next/zh-cn/online/zh-cn/Img/pulse_agent_page.png)
4. 选择见解摘要底部的其他问题以探索更多见解，或者在“Pulse 中 Tableau Agent”页面靠近底部的文本框中用您自己的措辞输入问题。
    
    ![Pulse 中的 Tableau Agent 的两个建议问题](/tableau/next/zh-cn/online/zh-cn/Img/pulse_agent_questions.png)

#### Pulse 中的 Tableau Agent 的示例问题

使用这些问题作为灵感来指导您与 Pulse 中的 Tableau Agent 进行对话。

| 见解类型 | 示例问题 |
| --- | --- |
| 期间变化 | 过去 30 天的录取率发生了什么变化？ |
| 相关指标 | 过去 90 天的收入和交付量之间有什么关系？ |
| 记录级别异常值 | 哪些交易是异常值？ |
| 当前趋势 | 本周通话时间的趋势如何？ |
| 意外值 | CSAT 是否低于预期？ |
| 目标和阈值细分 | 西南地区的退款是否低于阈值？ |
| 目标实现速度 | 我们本月的捐赠目标进展如何？ |
| 主要驱动因素 | 哪些产品线正在推动收入增长？ |
| 主要贬损因素 | 哪些产品线对收入的影响最大？ |
| 集中贡献通知 | 有没有存在风险的垄断情况？ |
| 排名靠后促成因素 | 哪些客户经理对本季度销售额的贡献最大？ |
| 排名靠后的促成因素 | 今年哪些菜单项对利润的贡献最小？ |
| 跨指标分析 | 流失率和新增申请情况如何？ |

#### 限制对话范围以获得更好的答案

大型语言模型具有一定数量的可处理信息，称为上下文窗口。您询问的指标和数据的广度、对话的长度以及问题的复杂性都增加了大型语言模型为回答您的问题而处理的上下文。太多的信息可能会使上下文窗口超载，并导致回复不令人满意。按照这些对话提示来优化 Pulse 中的 Tableau Agent 处理的信息。

- 通过选择性地选择您关注的指标，限制您所询问的组中的指标数量。Pulse 中的 Tableau Agent 会查看您为定义或数据源组关注的所有指标。
- 在询问具有大量唯一值（例如客户或帐户的 ID 号）的维度时要小心。相反，通过询问类别（例如细分市场或业务领域）来确定问题的范围。
- 如果您要更改主题以使对话历史记录易于管理，请开始新对话。

### 如何设置 Pulse 中的 Tableau Agent

Pulse 中的 Tableau Agent 需要将 Salesforce 组织连接到 Tableau Cloud。连接设置位于 Tableau Cloud 中“常规设置”的“Tableau 中的 AI”部分的开头。此外，必须为选定的 Salesforce 组织设置 Salesforce 中的 Einstein 生成式 AI。

要使 Pulse 中的 Tableau Agent 在 Tableau Cloud 中可用，您的 Tableau Cloud 管理员必须在 Salesforce 和您的 Tableau Cloud 站点中进行配置更改。帮助主题[为 AI 配置 Tableau Cloud 站点](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm#configure-tableau-cloud-sites-for-ai)中描述了完整的说明。

Pulse 中的 Tableau Agent 试用版不需要专门的 Salesforce 组织。有关如何开始试用的信息，请参见[开始试用 Pulse 中的 Tableau Agent](https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm#start-trial)。

### Tableau Pulse 中的 Tableau Agent 的理想（和不太理想的）数据场景

为了在使用 Pulse 中的 Tableau Agent 时获得最佳体验，请使用干净、结构化且经过验证的数据。连接到格式一致且准确的数据可以生成更好的指标和更可靠的见解。

具有以下特征的数据可为 Pulse 中的 Tableau Agent 提供最佳体验：

- 时间序列数据：随时间而变化的数据（例如，销售、流量、财务指标）。
- 聚合指标：可汇总为指标的关键业务数字（例如，总销售额、平均满意度、贷款批准数量）。
- 清晰维度：具有明确类别（如区域、产品或客户细分）的数据集。

提供不太理想体验的数据场景包括：

- 高粒度数据：具有非常精细粒度的最高详细级别的数据，例如每分钟日志。
- 单一时间点数据：静态数据集，例如一次性调查结果。
- 非结构化数据：缺乏结构的自由格式文本或多媒体。

### 基于时间的筛选

Pulse 中的 Tableau Agent 可以处理基于时间的范围调整。例如，您可以细化您的问题以比较不同时间段的数据，如询问“与本月相比，上个月发生了什么？”使用问题来调整您正在探索的见解的粒度或广度。

### 基于维度的筛选

Pulse 中的 Tableau Agent 可以处理基于维度值（区域、产品、细分市场）筛选指标的问题，或者比较维度成员（西部与东部）以发现有意义的模式。

Pulse 中的 Tableau Agent 支持按维度成员筛选和比较指标。例如，您可以要求“显示加利福尼亚州的销售额”或“比较亚太地区与欧洲、中东和非洲地区”，以自动将您的探索扩展到整套兼容指标。

**注意**：您在“Pulse 中的 Tableau Agent”页面中提出的问题只能筛选或比较具有共同关键特征的指标，例如相同的时间粒度或相同的维度集。如果指标不匹配，它将不会包含在答案中。

### 交叉检查见解来源以确保透明度

使用 Pulse 中的 Tableau Agent 时，您可以通过单击每个见解末尾的链接来交叉检查其生成的见解。这些链接引用了指标来源并在可用时显示见解图表。您可以使用此信息来验证 Pulse 中的 Tableau Agent 提供的见解是否基于正确的数据。有时，如果 Tableau Pulse 无法使用这些特定筛选器生成指标，则指标来源可能无法单击，但见解仍然植根于您的数据。

### Pulse 中的 Tableau Agent 中对问题和回复的多语言支持

Pulse 中的 Tableau Agent 现在支持多语言问题和回复，与 Tableau Cloud 支持的语言保持一致。建议的问题、后续问题和见解简报会根据站点的语言设置进行调整。指标名称和筛选器始终保留其原始制作语言，以保持清晰和一致性。

Pulse 中的 Tableau Agent 可以流畅地适应您输入的查询语言。当您提出问题时，它会检测输入语言，并以该语言返回回复 - 即使它与站点或数据语言不同。

**注意**：Einstein 信任层屏蔽支持 6 种核心语言；其他语言可能会降低响应质量。指标名称保留为原始语言。在不受支持的区域设置中，输入语言检测可能有所不同。

当 LLM 试图协商语言输入之间的差异时，它可能会与某些语言混淆，有时还会在响应中混合这些语言。使用当前的 LLM 功能，对于某些语言（例如中文），结果可能不一致。具体而言，用繁体中文输入问题可能会导致响应包含简体中文，从而使响应难以阅读。

### Pulse 中的 Tableau Agent 的限制

Pulse 中的 Tableau Agent 仅限于处理来自 Pulse 指标的见解，因此它无法从该框架之外的数据生成见解。它无法回答有关数据源的指标或元数据中未使用的列的问题，例如“这些数据是否经过认证？”

它能够筛选或比较具有共同关键特征的指标，例如相同的时间粒度或相同的维度集。如果指标不匹配，它将不会包含在答案中。

虽然 Pulse 中的 Tableau Agent 致力于提供准确且可操作的见解，但偶尔仍会出现幻觉（不准确或离题的答案），尤其是当您提出产生更复杂查询的问题时。LLM 之所以会产生幻觉，是因为它们是根据数据和概率模式生成响应，而不是直接获取现实世界的事实。因此，生成式 AI 很容易产生听起来合理但包含不正确或不相关信息的输出。

有关详细信息，请参见 [Tableau 中的 AI 和信任](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm) 和[审查生成式 AI 输出](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm#reviewing-generative-ai-outputs)。

### Pulse 中的 Tableau Agent 的 Einstein 信任层屏蔽

Einstein 信任层使用先进的模式匹配和机器学习技术来检测提示中的敏感数据。姓名和电子邮件地址等个人身份信息 (PII) 会使用机器学习自动屏蔽。为了获得最佳结果，请考虑使用清晰的实体标识符和一致的字段标签来构建数据，以最大程度地减少歧义并确保在应用屏蔽时获得准确的结果。

## 使用 Ask Q&A 询问有关单个指标的问题

可通过 Ask Q&A 进行单一指标探索。如果您没有看到您正在寻找的见解，请单击可用问题左侧的“询问”按钮，然后输入有关该指标的新问题。根据您的问题，Tableau Pulse 将查找并排列它针对您正在调查的同一指标检测到的见解的语义匹配。然后，它会针对每个检测到的见解列出一个问题。指标可用的筛选器设置和数据会影响 Tableau Pulse 可以检测到的见解。有关详细信息，请参见 [Tableau 如何通过问答方式实现 NLP，从而帮助每个人](https://www.tableau.com/zh-cn/blog/how-tableau-pulse-approaches-nlp-with-qa)。

可以通过在 Tableau 设置中打开 AI 来增强 Ask Q&A，以便在 Tableau Cloud 站点设置中获得更好的语义匹配。有关详细信息，请参见[在 Tableau 中为 Ask Q&A 启用更好的语义匹配](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-better-semantic-match-ask)。

### 使用 Ask 探索单个指标

1. 在 Tableau Pulse 主页上，单击感兴趣的指标。
2. 在指标页面上的“发现热门见解”（图表可视化项之后）下，单击建议的问题。
3. 若要提出您自己的问题，请单击“提问”按钮。
4. 输入有关指标的问题。
    
    尝试询问可能对指标有影响的趋势、变化、异常值或类别的问题。您还可以提出问题来调整时间粒度并为当前指标应用维度筛选器。例如，您可以输入“上周加州的销售额”、“放大技术”或“昨天怎么样？”
5. 根据语义匹配和排名，Pulse 会为每个检测到的见解列出问题。单击一个问题即可查看见解。如果 Pulse 找不到匹配项，它可能会建议其他感兴趣的问题。

<!-- document id=8ec67b758a6332b4499f38c77c7d734bfb685cb171c751dcf2310b766d33a845 url=/tableau/next/zh-cn/online/navigate_admin_settings.md -->

[跳转到主要内容](#main-content)

# 在 Tableau Web 环境的管理区域中导航

作为 Tableau Server 或 Tableau Cloud 的管理员，您可以访问其他用户无法访问的管理设置来配置站点、用户、项目以及执行其他内容相关任务。

如果要查找用于管理已发布内容的设置，请参见 Tableau 用户帮助中的[在 Web 上导航 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm) 和[管理 Web 内容](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm)。

## 基于站点角色和站点数的访问权限

您登录到 Tableau Server 或 Tableau Cloud 时看到的菜单取决于以下条件：

- 您是站点管理员还是服务器管理员。
    
    Tableau Cloud 和 Tableau Server 上提供了站点管理员访问权限。服务器管理员访问权限仅在 Tableau Server 上提供。
- 您是仅具有一个站点的访问权限还是具有多个站点的访问权限。

### 服务器管理员

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>在<strong>单站点</strong>服务器上，站点选择器不会出现，所有其他菜单均相同。</p></td><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/gs_ms_serveradmin_default.png" alt=""></p></td></tr><tr><td><p>在<strong>多站点</strong>环境中，您可以利用左侧的菜单来修改特定站点或所有站点，或者配置用户、组、计划、任务和服务器设置。</p><p>若要访问影响所有站点的服务器管理员设置，请通过单击当前站点名称旁边的箭头打开站点菜单，然后选择<span class="uicontrol">“管理所有站点”</span>。</p><p><span class="uicontrol">“内容”</span>和<span class="uicontrol">“组”</span>选项卡将消失，并且站点菜单文本将变为<span class="uicontrol">“所有站点”</span>，让您知道您在管理服务器范围的设置，并且像<span class="uicontrol">“服务器状态”</span>这样的选项将反映服务器范围视图。</p><p>若要返回到站点管理菜单，请选择<span class="uicontrol">“所有站点”</span>，然后选择要管理的站点。</p></td><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/gs_ms_serveradmin_site.png" alt="没有站点选择器的单站点服务器菜单。"> <img src="https://help.tableau.com/v0.0/online/zh-cn/Img/gs_ms_srvadmin_manage.png" alt="显示“管理所有站点”选定选项的站点菜单。"> <img alt="" src="https://help.tableau.com/v0.0/online/zh-cn/Img/gs_ms_serveradmin_allsites.png"></p></td></tr></tbody></table>

### 站点管理员

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td><p>如果您的 Tableau Cloud 或 Tableau Server 的站点管理员，并且具有多个站点的访问权限，您将看到用于选择要管理的站点的菜单，用于该站点的内容、用户、组、计划和任务的菜单，以及用于监视站点状态的菜单。</p><p>站点选择器将显示当前站点的名称。若要转到另一个站点，请选择站点菜单，然后选择站点名称。</p><p>如果您只有一个站点的访问权限，则站点选择器不会出现，但所有其他菜单均相同。</p></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/gs_ms_siteadmin_contentpage.png" alt="带有可供访问站点的站点选择器的多站点菜单。"></td></tr></tbody></table>

## 服务器管理员任务

服务器管理员（仅 Tableau Server Enterprise 附带）可执行以下操作：

- 监视服务器状态和活动。
- 生成日志文件。
- 添加站点和编辑站点设置。只有服务器管理员才能向服务器中添加站点。
- 向服务器中添加用户，以及为站点分配用户。
- 添加和管理站点组。

若要仅管理特定站点的设置，您必须首先导航到该站点。在每个站点内，您可以执行以下操作：

- 管理内容：创建项目、将内容从一个项目转移到另一个项目、分配权限、更改内容资源的所有权，等等。
- 管理数据提取刷新和订阅计划。
- 监视站点活动，以及记录工作簿性能指标。
- 管理用户发布的内容的存储空间限制。
- 允许 Web 制作。
- 启用修订历史记录。
- 允许站点管理员添加和移除用户。
- 设置站点可为每种许可证类型（Creator、Explorer、Viewer（查看者））使用的最大许可证数。
- 允许用户订阅工作簿和视图，并允许内容所有者为其他人订阅工作簿和视图。
- 为收藏夹启用脱机快照（仅限 iOS）。

## 站点管理员任务

Tableau Cloud 或 Tableau Server 上的站点管理员可执行以下任务：

- 管理内容：创建项目、将内容从一个项目转移到另一个项目、分配权限、更改内容资源的所有权，等等。
- 查看、管理并手动运行数据提取刷新和订阅计划。
- 添加和管理站点用户。
- 添加和管理站点组。
- 监视站点活动。

<!-- document id=375ec3e77ea2bde2c1e1f7cab3218242a5a4201c122b75e8e5ed23c93475ad65 url=/tableau/next/zh-cn/online/data_stories_table_calculation.md -->

[跳转到主要内容](#main-content)

# 在 Tableau 数据故事中使用表计算

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

除了用于创建表计算的度量之外，您还可以将“表计算”用作 Tableau 数据故事中的度量。

1. 从“标记”卡中，单击字段右侧以打开菜单，然后单击“快速表计算”。  
      
    ![右键单击“标记”卡中的字段时打开的菜单。“快速表计算”处于选定状态。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_quick_tablecalc.png)

1. 创建表计算后，将其拖到“数据”窗格中的“度量”并重命名。  
      
    ![将计算从功能区拖到“数据”窗格的动画。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_tablecalc_1.gif)

1. 将您的原始度量（例如，销售额）拖回“行”功能区，然后将您的新计算（例如，销售额总和）拖到“工具提示”中。您的可视化项可能保持不变，但您现在可以访问新度量。  
      
    ![将度量拖到功能区的动画。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_tablecalc_2.gif)

1. 转到您的仪表板并将“数据故事”对象拖到仪表板上。创建故事时会出现这两种度量。

<!-- document id=9f23bbfac3437a310f7159cee0bcd592dc751af73f050bb418bca3285e917056 url=/tableau/next/zh-cn/online/data_stories_relationship_story.md -->

[跳转到主要内容](#main-content)

# 在 Tableau 数据故事中创建自定义度量关系

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

您可以在 Tableau 数据故事中创建关系故事，以查看数据与另一组数据的比较情况。若要构建关系故事，您必须至少有两个度量和一个维度。您要比较的数据通常分组为一列数据，名称为“年”或“月”，其值为“2022”或“三月”。

您可以[创建一个简单计算字段](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields_formulas.htm)以将 2022 年与 2021 年（或三月与二月）分开，以便您可以比较关系故事中的两个时间段。  
  

1. 从要在数据故事中使用的工作表开始。
2. 单击“分析”，并选择“创建计算字段”。
3. 创建一个计算字段，例如“当前期间”。  
      
    ![计算字段如下： If DATETRUNC ('year', \[Year\])= {MAX(DATETRUNC('year', \[Year\]))} THEN \[Number of Records\] END](Img/data_stories_calcfield_current.png)

> [!TIP]
> 
> **提示：**遵循此处显示的计算字段的结构，但替换为您自己的维度或度量名称（橙色文本）。  

1. 创建一个计算字段，例如“上一期间”。  
      
    ![计算字段如下： If DATETRUNC ('year', \[Year\])= DATEADD('year', -1, {MAX(DATETRUNC('year', \[Year\]))}) THEN \[Number of Records\] END](Img/data_stories_calcfield_previous.png)

1. 将新度量拖到“详细信息”标记上。
2. 从您的仪表板中，单击故事并将两个新度量添加到您的数据故事中。  
      
    ![“数据故事”对话框打开到包含可用维度和度量的“字段”选项卡。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_calcfield_addnew.png)

1. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
2. 在“数据故事”对话框中，单击“关系”选项卡。
3. 使用两个自定义度量设置关系故事。  
      
    ![“数据故事设置”对话框打开到“关系”选项卡。“当前/最近与上一期间”框已选中。相关的度量为 SUM(Previous Period) 和 SUM(Current Period)。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_set_relationship.png)

1. 单击“保存”。

您的故事现在编写了用于比较自定义度量的语句。

<!-- document id=fd33fa8bdf7cd40e11c7e3e025ff113d0ded592f9523b70aee641558e12decca url=/tableau/next/zh-cn/online/datasource_extract.md -->

[跳转到主要内容](#main-content)

# 在 Web 上创建数据提取

您可以在 Web 上提取数据源（无需使用 Tableau Desktop），以提高数据源性能并支持其他分析功能。提取数据源时，Tableau 会将数据从远程数据存储复制到 Tableau Server 或 Tableau Cloud。若要详细了解提取数据的好处，请参见[提取数据](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm)。在 Web 上，您可以在 Web 制作过程中或内容服务器中提取。

## 在 Web 制作中创建数据提取

您可以在 Web 制作中使用默认数据提取设置直接创建数据提取。

### 在 Web 制作中提取嵌入式数据源

![显示数据提取连接类型的“数据源”页面](/tableau/next/zh-cn/online/zh-cn/Img/datasource_extract1w_border.png)

完成以下步骤以在 Web 制作中创建数据提取。

> [!TIP]
> 
> **提示**：建议在创建数据提取之前完成数据模型。数据提取创建可能需要很长时间，对数据模型的任何更改（例如添加新逻辑表）都将使数据提取失效。

1. 选择 Web 制作窗格左下角的“数据源”选项卡。对于新的工作簿，您将在“数据源”选项卡中开始。
2. 在右上角，将连接类型从“实时”更改为“数据提取”。
3. 选择“创建数据提取”。您将看到“正在创建数据提取”对话框。

数据提取创建可能需要很长时间，您可以在创建数据提取时关闭制作会话。为确保数据提取创建不会丢失，请在对话框中选择“完成时通知我”以指定要保存的已提取工作簿的位置。如果数据提取成功，您的工作簿将保存到指定位置，并将通知您可以继续 Web 制作会话。

如果数据提取创建失败，系统会通知您无法创建数据提取，并且您可以通过在 Web 制作中重新打开原始工作簿来还原未保存的更改。

### 定义您的数据提取设置

（您可以配置以下一项或多项选项来指示 Tableau 如何存储、定义筛选器并限制数据提取中的数据量。

![显示逻辑表或物理表的选择的“数据提取数据”页面](/tableau/next/zh-cn/online/zh-cn/Img/incremental_refresh_extract_data.png)

**决定应以何种方式存储数据提取数据**

您可以选择让 Tableau 使用两种结构（架构）之一将数据存储在数据提取中：逻辑表（非标准化架构）或物理表（标准化架构）。有关逻辑表和物理表的详细信息，请参见[“Tableau 数据模型”](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_datamodel.htm)。所选的选项取决于您的需求。

逻辑表

逻辑表使用数据源中每个逻辑表的一个数据提取表存储数据。定义逻辑表的物理表与该逻辑表合并并存储在一起。举例来说，如果数据源由单个逻辑表组成，则数据将存储在单个表中。

如果数据源由三个逻辑表组成（每个表包含多个物理表），则数据提取数据将存储在三个表中，每个逻辑表一个。

如果要使用其他数据提取属性（如数据提取筛选器、聚合、“前 N 个”或需要非规范化数据的其他功能）限制数据提取中的数据量，请选择“逻辑表”。当数据使用直通函数 (RAWSQL) 时，也使用“逻辑表”。这是 Tableau 用于存储数据提取数据的默认结构。

如果在数据提取包含联接时使用此选项，则会在创建数据提取时应用联接。  

物理表

物理表使用数据源中每个物理表的一个数据提取表存储数据。

如果您的数据提取由使用一个或多个等值联接合并的表组成，并且满足下面列出的“使用‘物理表’选项的条件”，请选择“物理表”。如果使用此选项，则会在查询时执行联接。

此选项能够潜在地提升性能和减小数据提取文件的大小。有关 Tableau 如何建议您使用“物理表”选项的详细信息，请参见 Tableau Desktop 帮助中的[关于使用“物理表”选项的提示](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm#noramlized_tips)。

在某些情况下，您也可以使用此选项作为行级安全性的解决方法。有关使用 Tableau 的行级别安全性的详细信息，请参见-Tableau Desktop 帮助中的[在数据行级别限制访问权限](https://help.tableau.com/current/pro/desktop/zh-cn/publish_userfilters.htm)。  

### 使用“物理表”选项的条件

若要使用“物理表”选项存储数据提取，数据提取中的数据必须满足下面列出的所有条件。

- 物理表之间的所有联接均为等值 (=) 联接。
- 用于关系或联接的列的数据类型相同。
- 未使用直通函数 (RAWSQL)。
- 未配置增量刷新。
- 未配置数据提取筛选器。
- 未配置“前 N 个”或抽样。
- 如果以“物理表”方式存储数据提取，则无法向其附加数据。
- 对于逻辑表，不能将数据追加到具有多个逻辑表的数据提取。

**注意：**“逻辑表”和“物理表”选项都只会影响数据提取中数据的存储方式。这些选项不影响数据提取中的表在“数据源”页面上的显示方式。

**确定要提取多少数据** 

选择“添加”定义一个或多个筛选器，以限制基于字段及字段值提取的数据量。

**对数据提取中的数据进行聚合** 

选择“聚合可视维度的数据”以使用度量的默认聚合来聚合度量。对数据进行聚合可以合并行，并且可以最大限度地减少数据提取文件的大小并提高性能。

选择对数据进行聚合时，也可以选择按指定的日期级别（例如“年”、“月”等）来“汇总日期”。以下示例说明了如何为您可以选择的每个聚合选项提取数据。

<table class="TableStyle-Basic-Border" style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">原始数据</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/aggregate1.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-family: Merriweather;">每个记录都显示为一个单独行。数据中共有 7 行。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">聚合可视维度的数据</span><p><i>（无汇总）</i></p></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/aggregate2.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-family: Merriweather;">具有相同日期和地区的记录已聚合到一行中。数据提取中共有 5 行。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-family: Merriweather;"><span class="uicontrol">聚合可视维度的数据<br></span><i>（按“月”汇总日期）</i></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1" style="font-family: Merriweather;"><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/aggregate3.png" style="text-align: center;" alt=""></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="font-family: Merriweather;">日期已按“月”级别进行汇总，并且具有相同地区的记录已聚合到一行中。数据提取中共有 3 行。</td></tr></tbody></table>

选择要提取的行

选择要提取的行数。

可以提取所有行或前 N 行。Tableau 首先会应用筛选器和聚合，然后从经过筛选和聚合的结果中提取行数。行数选项取决于要从中进行提取的数据源的类型。

**注意：**

- 并非所有数据源都支持抽样。因此，您在“提取数据”对话框中可能看不到“抽样”选项。
- 数据提取中将不包括您最初在“数据源”页面或工作表标签页中隐藏的任何字段。

配置增量刷新设置

大多数数据源都支持增量刷新。您可以将刷新配置为仅添加自上次提取数据以来新增的行，而不是刷新整个数据提取。

例如，您可能有一个每天都使用新销售交易进行更新的数据源。您只需添加当天发生的新交易，而不是每天重新生成整个数据提取。若要在计划刷新时将增量刷新作为选项，您必须首先定义设置。

您可能需要定期进行完全刷新，以确保拥有最新数据。

**注意：**如果源数据的数据结构发生更改（例如，添加了新列），则需要执行完全数据提取刷新，然后才能再次开始执行增量刷新。

### 设置增量刷新

按照以下步骤将数据提取设置为增量刷新。确保您已在“行数” 部分选择“所有行”。

只有在提取数据库中的所有行时，才能定义增量刷新。不能对示例数据提取进行增量刷新。

1. 展开“增量刷新”部分。
2. 选中**“增量刷新”**框。
3. 选择要刷新的表。
4. 选择用于标识新行的列。
5. （可选）在“要刷新的最小日期范围”字段中输入时间量和时间单位，以提取自上次刷新以来添加的新数据，并替换数据提取中现有数据的子范围，以捕获数据源中可能发生的更改。您可以选择在此字段中以多种方式定义时间长度，从秒到年。例如，您可以输入“2”和“月”以使数据提取刷新获取所有新行，并刷新前两个月的数据。

**注意**：配置数据提取刷新以及要刷新的最小日期可能比较复杂且难以理解。在使用之前，请参见[配置增量数据提取刷新](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm#configure-an-incremental-extract-refresh)。

![](/tableau/next/zh-cn/online/zh-cn/Img/subrange_incremental_refresh.png)

### 使用高级设置

您可以展开**“高级设置”**以确定如何检索新行。

**注意：**如果您已设置刷新的最小日期范围，则“高级设置”功能将不可用。

“高级设置”允许您通过刷新等于或大于最后记录值的值来替换最后添加的行，或者通过仅刷新具有大于最后记录值的值的数据提取来保留最后添加的行。

在第一种方法中，Tableau 允许用户使用非唯一键列（例如日期、日期时间或 Id）增量刷新数据提取。

此方法在执行增量刷新时添加了一个新步骤。Tableau 将首先删除数据提取中等于之前看到的最高值的行。然后，Tableau 查询高于或等于先前最高值的所有行，这将选取所有已删除的行和任何新行。

相反，您仍然可以选择不替换最后添加的行，而仅添加值大于最后记录值的行。

若要完成，请选择**“创建数据提取”**。

#### 刷新数据提取时的注意事项

**编辑数据提取：**

如果要编辑现有数据提取，则将显示上次刷新，这样您可以确保使用正确的数据更新数据提取。

**完全刷新：**

每次刷新数据提取时，完全刷新都会用原始数据源中的数据替换所有行。完全刷新可能需要更长的时间，并且对数据库来说代价高昂。

**日期/时间精度和数据提取：**

数据引擎是 Tableau 创建数据提取所使用的基础机制，存储时间值时最多精确到 3 位小数。

如果为“使用列标识新行”指定日期时间或时间戳列，并且数据库使用比 Tableau 更高的精度，则在增量刷新后最终会出现重复行。

举例来说，如果数据库有两个行，其中一个行的日期时间值为 2015-03-13 17:30:56.502352，另一个行的日期时间值为 2015-03-13 17:30:56.502852，则 Tableau 在存储这两个行时都将使用日期时间值 2015-03-13 17:30:56.502，从而会创建重复行。

### 限制

- 不能为引用已发布数据源的嵌入式数据源创建数据提取。作为解决方法，请直接在已发布的数据源上创建数据提取。有关详细信息，请参见“在内容服务器上连接到发布的数据源”。
- 无法为基于文件的数据源创建数据提取。基于文件的数据源已经具有特殊的性能功能，添加数据提取将没有性能优势。
- 此功能不适用于 Tableau Cloud 中基于桥接的数据源。
- 自定义 SQL 限制：高级设置不支持自定义 SQL 查询。如果依赖自定义 SQL 的用户希望使用高级设置进行增量刷新，则需要调整其方法。

## 在内容服务器中创建数据提取

### 在内容服务器上提取已发布数据源

![显示菜单中的数据提取选项的“数据源”页面](/tableau/next/zh-cn/online/zh-cn/Img/datasource_extract2_wborder.png)

完成以下步骤来提取已发布数据源。

1. 以管理员或数据源所有者的身份登录。
2. 在“内容”选项卡上，选择“浏览”，然后选择“数据源”。
3. 通过单击数据源名称选择数据源。
4. 在屏幕顶部的“数据源”名称下，选择显示“**实时**”的下拉菜单。
5. 将连接类型从**“实时”**更改为**“数据提取”**。如果在站点上启用了静态数据提取加密功能，请选择**“已加密”**或**“未加密”**。
6. 如果看到有关嵌入凭据的错误消息，请将凭据嵌入到数据源中。为此，请选择**“编辑连接”**。选择“连接中的嵌入式密码”，然后选择**“保存”**。

### 在内容服务器上提取嵌入式数据源

![数据源页面上操作菜单中的数据提取选项](/tableau/next/zh-cn/online/zh-cn/Img/datasource_extract3w_border.png)

完成以下步骤以提取嵌入在已发布工作簿中的一个或多个数据源。

1. 以管理员或数据源所有者的身份登录。
2. 导航到已发布的工作簿。
3. 导航到“数据源”选项卡
4. 选择一个或多个数据源。
5. 选择**“操作”**按钮。
6. 选择**“提取”**。如果在站点上启用了静态数据提取加密功能，请选择**“已加密”**或**“未加密”**。

### 限制

- 您的连接凭据必须嵌入到数据源中。
- 不能为引用已发布数据源的嵌入式数据源创建数据提取。作为解决方法，请[直接在已发布的数据源上创建数据提取](#extract-published-data-source)。
- 无法为基于文件的数据源创建数据提取。基于文件的数据源已经具有特殊的性能功能，添加数据提取将没有性能优势。
- 从版本 2023.1 开始，更改内容服务器上数据提取的实时连接将移除之前在 Tableau Desktop 或 Web 制作上创建的任何数据提取筛选器。
- 此功能不适用于 Tableau Cloud 中基于桥接的数据源。

## 使提取的数据保持最新

提取数据后，可以选择设置数据提取刷新计划，以使数据保持最新。有关详细信息，请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)。

## 监视和管理数据提取

服务器管理员可以在“**数据提取后台任务**”管理视图中监视数据提取创建。有关详细信息，请参见[数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd.htm)。

服务器管理员可以在“作业”页面上管理数据提取。有关详细信息，请参见[在 Tableau Cloud 中管理后台作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm)。

<!-- document id=2b21bc235fcef5b7d3c93c757c23caaee9080e56bc285d6e3884485d7e8d63ae url=/tableau/next/zh-cn/online/web_author_flows.md -->

[跳转到主要内容](#main-content)

# 在 Web 上创建流程并与其进行交互

从版本 2020.4 开始，您可以在 Tableau Cloud 上创建流程并与之交互，以清理和准备数据。连接到数据、构建新流程或编辑现有流程，您的工作每隔几秒钟会自动保存一次。创建只有您可用的草稿流程，或发布流程以使其可供其他人使用。从 Web 中直接运行单个流程，或者使用 Tableau Prep Conductor 按计划自动运行许可流程（如果 Data Management 已获许可）。有关详细信息，请参见 [Web 上的 Tableau Prep](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm)。

## 针对站点打开或关闭流程 Web 制作

此选项默认情况下已启用，控制用户是否可以在 Tableau Server 或 Tableau Cloud 上创建和编辑流程

**注意：**您只能在 Tableau Server 中更改此设置。.已为 Tableau Cloud 自动启用 Web 制作，并且无法关闭。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到站点，单击“设置”。
2. 在“**Web 制作**”部分，清除或选择“流程”。允许用户在其浏览器中编辑流程以启用或禁用该功能。
    
    ![Web 制作设置，“流程。允许用户在其浏览器中编辑流程”框处于选中状态并突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_admin.png)
3. 如果您希望更改立即生效，请重新启动服务器。否则，更改将在服务器会话缓存过期后或在用户注销并于下次登录时生效。

## 启用链接任务

_在 Tableau Cloud 和 Tableau Server 版本 2021.3 及更高版本中受支持。_

使用“链接任务”选项最多可以安排 20 个流程按顺序逐个运行。链接任务只能在选择了“链接任务”选项的情况下按计划运行。有关设置链接任务的详细信息，请参见“计划链接任务”。

从版本 2022.1 开始，默认情况下，在“服务器设置”和您创建的任何新流程计划中启用“链接任务”。在以前的版本中，管理员必须首先启用该选项。

如果您有多个站点，您可以通过清除下面描述的复选框来关闭各个站点的“链接任务”。

如果在计划链接任务后关闭该设置，则任何正在运行的任务都将完成，并且计划的链接任务将隐藏并且不再显示在“计划任务”选项卡上。

**启用链接任务**（版本 2021.4 及更低版本）

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中为其流程启用“链接任务”的站点。在该站点中，单击“设置”。
2. 在**“链接任务”**部分，选择“让用户计划链接任务”以允许管理员配置计划以运行链接任务。
3. 选择“让用户使用‘立即运行’手动运行链接的任务”，使用户能够使用“立即运行”运行链接的流程任务。
    
    ![带有两个复选框的站点设置，用于启用链接任务的计划或手动运行。](/tableau/next/zh-cn/online/zh-cn/Img/prep_linked_tasks_settings.png)

## 启用流程参数

使用户能够计划和运行包含参数的流程。参数使用户能够通过构建一次流程，然后更改参数值以适应不同的数据场景，从而扩展流程。  

可以在文件名和路径、表名的输入步骤中输入参数，或者在使用自定义 SQL 查询时、在文件名、路径和表名的输出步骤中以及在筛选器或计算所得值的任何步骤类型中输入参数。

从 Tableau Prep Builder 和 Tableau Cloud 版本 2023.2 开始，您可以将系统参数添加到流程输出名称，以自动包含流程运行开始日期和时间。

流程参数设置可在服务器级别应用以包括 Tableau Server 上的所有站点。可以在站点级别禁用该设置以仅包括特定站点。

有关在流程中使用参数的详细信息，请参见 Tableau Prep 帮助中的[在流程中创建和使用参数](https://help.tableau.com/current/prep/zh-cn/prep_parameters.htm)。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中启用 “流程参数”的站点。在该站点中，单击“设置”。
2. 在**“流程参数”**部分，选择“让用户运行和计划使用参数的流程”以启用该功能。
3. （版本 2023.2 及更高版本）选择“允许系统生成的参数（例如时间戳）应用于输出名称”，使用户能够在运行时向文件和已发布数据源输出类型的流程输出名称添加日期或时间戳。
4. 选择“允许可以接受任何输入的参数”，使运行流程的任何人都能在运行时在流程中输入任何参数值。
    
    > [!IMPORTANT]
    > 
    > **重要信息**：设置此选项使任何流程用户都能在参数中输入任何值，这可能会暴露用户不应访问的数据。
    
    如果未选择此选项，则用户只能从预定义的参数值列表中进行选择，并且任何包含接受任何值的参数的流程都无法运行或计划运行。
    
    ![“流程参数”对话框。所有框均被选中：“让用户运行和计划使用参数的流程”、“允许系统生成的参数（例如时间戳）应用于输出名称”，以及“允许可以接受任何输入的参数”。 ](/tableau/next/zh-cn/online/zh-cn/Img/prep_parameters_settings.png)

## 启用 Tableau Prep Conductor

如果 Data Management 已获许可，请启用此选项以让用户在 Tableau Server 和 Tableau Cloud 中计划和跟踪流程。有关 Tableau Prep Conductor 的其他配置要求的信息，请参见 [Tableau Prep Conductor](https://help.tableau.com/current/server/zh-cn/server_process_prep_conductor.htm)。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中启用 Tableau Prep Conductor 的站点。在该站点中，单击“设置”。
2. 在**“Tableau Prep Conductor”**部分，选择“让用户计划和监控流程”以启用该功能。
    
    ![在 Tableau Prep Conductor 设置下，“让用户计划和监控流程”复选框处于选中状态。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_admin3.png)

## 启用“立即运行”

使用“立即运行”选项控制是用户还是仅管理员可以手动运行流程。手动运行流程不需要 Data Management。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中为其流程启用“立即运行”的站点。在该站点中，单击“设置”。
2. 在**“立即运行”**部分，选择“让用户使用立即运行手动运行作业”以启用该功能。
    
    ![在“立即运行”设置下，“让用户使用立即运行手动运行作业”复选框处于选中状态。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_admin2.png)
    
    如果只有服务器管理员可以手动运行流程，请清除该复选框。

## 流程订阅

控制用户是否可以接收有关成功运行流程的计划任务的流程通知。需要 Data Management 来启用通知。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中启用流程订阅的站点。在该站点中，单击“设置”。
2. 在**“流程订阅”**部分，选择“允许用户发送或接收包含流程输出数据的电子邮件”以启用该功能。 ![“流程订阅”站点设置，显示已选中的发送和接收电子邮件通知复选框。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_site.png)
    
    **注意**：将 .csv 或 .xlsx 文件类型附加到电子邮件的选项仅适用于本地环境。

## 启用 Tableau 扩展程序

_从版本 2021.2.0 开始在 Tableau Server 和 Tableau Cloud 中受支持_

设置此选项以控制用户是否可以连接到 Einstein Discovery 以针对其流程中的数据运行预测模型。

在 Web 上制作流程时，您可以使用由 Einstein Discovery 提供支持的模型对流程中的数据进行批量评分预测。预测可以帮助您做出更明智的决策，并采取行动改善您的业务成果。

您需要配置其他设置以在我们的流程中包含预测。有关详细信息，请参见[将 Einstein Discovery 预测添加到您的流程](https://help.tableau.com/current/prep/zh-cn/prep_predictions.htm)和[配置 Einstein Discovery 集成](https://help.tableau.com/current/server/zh-cn/config_einstein_extensions.htm#einstein-discovery-tableau-prep-extensions)。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要在其中启用 Tableau Prep 扩展程序的站点。在该站点中，单击“设置”\>“扩展程序”。
2. 在**“Tableau Prep 扩展程序”**部分，选择“让用户连接到 Einstein Discovery”以启用该功能。
    
    ![描述 Tableau Prep 扩展程序的文本框。“让用户连接到 Einstein Discovery”复选框处于选中状态。](/tableau/next/zh-cn/online/zh-cn/Img/prep_pwa_admin_einstein_discovery.png)

## 关闭或打开自动保存

默认情况下启用，此功能每隔几秒钟会自动保存用户的流程工作。

虽然不推荐，但管理员可以使用 Tableau Server REST API 方法“更新站点”和 `flowAutoSaveEnabled` 设置在站点上禁用自动保存。有关详细信息，请参见 [Tableau Server REST API 站点方法：更新站点](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_sites.htm#update_site)。有关 Web 上的自动保存的详细信息，请参见[关闭或打开自动保存](#autosave)。

有关如何配置站点设置的详细信息，请参见 Tableau Server 帮助中的 [站点设置参考](https://help.tableau.com/current/server/zh-cn/sites_add.htm)。

## 此部分中的其他文章

<!-- document id=966d1cd6c71137727a1dee9e4157931be0a0dfe45fc4aa241fde27f1b40492ae url=/tableau/next/zh-cn/online/web_author.md -->

[跳转到主要内容](#main-content)

# 在 Web 上创建视图并探索数据

您可以创建视图并在 Tableau Cloud 上与其交互。有关详细信息，请参见 Tableau 用户帮助中的以下主题。

[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_home.htm)

[浏览 Tableau 站点](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)

[在 Web 上编辑视图](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_build_view.htm)

[联接数据](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm)

[创建仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm)

[创建故事](https://help.tableau.com/current/pro/desktop/zh-cn/story_create.htm)

[在网页中嵌入视图和仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/embed_landing.htm)

[使工作簿在版本之间兼容](https://help.tableau.com/current/pro/desktop/zh-cn/publish_version_compatibility.htm)

## 通知和订阅

[订阅疑难解答](https://help.tableau.com/current/server/zh-cn/subscribe_trouble.htm)

[从 Tableau Cloud 或 Tableau Server 中发送数据驱动型通知](https://help.tableau.com/current/pro/desktop/zh-cn/data_alerts.htm)

## 此部分中的其他文章

<!-- document id=2607d4d5f37e7c6969203d7a9434a10d38d2e0a25c2de675e154e48164a7d161 url=/tableau/next/zh-cn/online/datasource_using.md -->

[跳转到主要内容](#main-content)

# 在 Web 制作中连接到已发布数据源

下面的步骤描述如何在登录到 Tableau Server 或 Tableau Cloud 时连接到已发布数据源。有关如何在 Web 上编辑工作簿和视图的详细信息，请参见[在 Web 上构建视图](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_build_view.htm)和[在 Web 上使用 Tableau](https://help.tableau.com/current/pro/desktop/zh-cn/web_author_home.htm)。

有关如何从 Tableau Desktop 连接到发布的数据源的信息，请参见本帮助系统“连接器示例”参考中的 [Tableau Server 或 Tableau Cloud](https://help.tableau.com/current/pro/desktop/zh-cn/examples_tableauserver.htm)。

## 在 Web 制作环境中连接到已发布数据源

如果您有权创建和编辑视图，则可以连接到数据。

1. 登录到 Tableau Server 或 Tableau Cloud 站点时，选择一个要编辑的视图。
2. 在编辑模式下，单击“新建数据源”图标 ![新数据源图标。](/tableau/next/zh-cn/online/zh-cn/Img/datasource_using1.png)。
3. 在“连接到数据”对话框中，搜索并选择已发布数据源，然后单击“连接”。

您也可以在 Tableau Server 或 Tableau Cloud 上直接创建新工作簿时连接到发布的数据源。

1. 登录到站点后，导航到“浏览”页面并选择“所有数据源”。
2. 在数据源列表中，选中要使用的数据源旁边的复选框，然后单击“动作”，并选择“新建工作簿”。

## 此部分中的其他文章

<!-- document id=1d5dc8a63274b62355573f31e00b4f04f757315cc0873521c1fcd851b782889c url=/tableau/next/zh-cn/online/personal_space.md -->

[跳转到主要内容](#main-content)

# 在个人空间中创建和编辑私有内容

个人空间是所有 Explorer 和 Creator 在 Tableau 站点中工作时用于将内容保存在其中的私有位置。个人空间中保存的内容无法与其他用户共享，但可以在您准备好让其他人看到时将其移动到项目中。在个人空间中，您可以创建新工作簿，或将工作簿作为单独的副本保存到个人空间。您还可以将您拥有的现有内容移动到个人空间进行编辑，然后再将其移回项目。Explorer 可以下载个人空间中的工作簿，包括工作簿中包含的所有数据。数据源和流程无法保存到您的个人空间。

## 个人空间中的隐私

保存到您个人空间的内容仅对您和站点管理员可见。站点管理员无法直接访问任何用户的个人空间或编辑其他人的个人空间中的内容，但他们可以查看和管理个人空间工作簿。个人空间工作簿出现在管理员搜索结果中，并作为“浏览”页面上的工作簿位置。此外，当工作簿位于个人空间中时，权限菜单不可用，因为该工作簿是私有的。

### Tableau Catalog 和个人空间

从 2019.3 开始，Tableau Catalog 随 Tableau Server 和 Tableau Cloud 中的 Data Management 一起提供。有关详细信息，请参见 Tableau Server 或 Tableau Cloud 帮助中的“关于 Tableau Catalog”。

在您的工作环境中启用 Tableau Catalog 后，有关您保存在个人空间中的工作簿的信息将由 Catalog 编制索引。这些工作簿包含在世系计数中，但是，只有您可以看到这些工作簿。此外，浏览世系工具的用户会看到所需的权限，而不是您个人空间中有关工作簿的信息。

### 协作工具

当工作簿在个人空间中时，某些功能会被禁用，其中包括共享、指标、评论、通知和订阅。您的现有通知和您的订阅将继续运行，但其他人的通知和订阅将失败，因为内容现在是私有的。无法在个人空间中创建指标，但如果将连接的工作簿移动到那里，指标将继续工作。(Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)。)

当工作簿移动或保存到另一个位置时，这些限制将被移除。举例来说，如果工作簿包含评论并移至个人空间，则现有评论注将被隐藏。当工作簿移动到另一个位置时，评论会恢复。

### 个人空间中的数据提取刷新

为了限制资源消耗，现有数据提取刷新会继续运行（如果已计划），但当工作簿位于个人空间中时，无法计划新的数据提取刷新。

## 在个人空间中查找内容

您可以从左侧导航菜单访问个人空间，以查看您的所有个人空间内容或创建新工作簿，并且可以在站点上的任何位置创建或编辑工作簿时保存到个人空间。

![Tableau Cloud 中的“个人空间”选项卡。](/tableau/next/zh-cn/online/zh-cn/Img/ps-navigation.png)

![将工作簿发布到您的个人空间的路径。](/tableau/next/zh-cn/online/zh-cn/Img/ps-save.png)

当选择“所有工作簿”时，您还可以从“浏览”页面查看个人空间中的工作簿，并且可以筛选到个人空间内容。

![Tableau Cloud 的“探索”选项卡下拉菜单，其中包含工作簿和项目列表。](/tableau/next/zh-cn/online/zh-cn/Img/ps-explore.png)

## 将工作簿发布到个人空间

个人空间的工作方式与私有项目非常相似，您可以从 Tableau Cloud、Tableau Server 或 Tableau Desktop 中发布新的或现有的工作簿。  

如果启用了个人空间，则无论在哪个项目中创建新工作簿，草稿都会自动保存在个人空间中。

如果_未_启用个人空间，则新工作簿的草稿将保存在项目中。但是，如果在顶级项目中创建了新工作簿，则草稿不会保存在任何地方。

### 将工作簿发布到 Tableau Server 或 Tableau Cloud 上的个人空间

1. 在工作簿打开的情况下，选择“文件”\>“发布为”。
2. 在“位置”下，选择“个人空间”。
    
    ![将工作簿发布到您的个人空间的路径。](/tableau/next/zh-cn/online/zh-cn/Img/ps-save.png)

**注意：**Explorer 只能将工作簿保存到个人空间，并且可能看不到位置选择对话框。

### 从 Tableau Desktop 将工作簿发布到个人空间

从 2023.1 开始，您可以将工作簿从 Tableau Desktop 发布到个人空间。

1. 在 Tableau Desktop 中打开要发布的工作簿后，选择“服务器”\>“发布工作簿”。
2. 在“项目”下，选择“个人空间”。
3. 在“数据源”下，选择“编辑”。
4. 在“发布类型”下的“管理数据源”弹出窗口中，为所有数据源选择“嵌入工作簿”。从 Tableau Desktop 发布时必须嵌入数据源，因为您无法将数据源单独发布到个人空间。
5. 像往常一样填写其余的发布选项。有关详细信息，请参见[“用于发布工作簿的全面步骤”](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_howto.htm)。

## 将工作簿移至个人空间

如果您是工作簿的所有者并且您的个人空间中有空间，则可以将现有工作簿移至个人空间。个人空间存储限制由管理员设置。

若要将工作簿移至个人空间，请执行以下操作：

- 选择一个工作簿，然后单击“操作”下拉菜单。
- 选择“移动”。
- 在“位置”下，选择“个人空间”。

**注意：**Explorer 只能将工作簿保存到个人空间并且可能看不到“移动”操作或位置选择对话框。

有关详细信息，请参见“管理 Web 内容”帮助主题中的[执行操作](https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm#perform-actions)。

当您将现有工作簿或数据源移至个人空间时，共享、通知和订阅等工具将被隐藏。现有数据提取刷新会继续运行（如果已计划），但用户无法在其个人空间内计划新的数据提取刷新。

现有订阅和通知也会继续，但无法从个人空间编辑，如果其他用户是收件人，则会失败。现有已连接指标将继续刷新，但其他用户将看不到连接的视图。

## 从个人空间移动工作簿

当您将工作簿移出个人空间时，共享、通知和订阅等协作工具将变得可见，并且所有现有评论都会重新出现。

<!-- document id=2e679caee3bd86776ba4afa4719bec1afb6e2dfb8d0c5640f3bd287251d86389 url=/tableau/next/zh-cn/online/saml_config_site.md -->

[跳转到主要内容](#main-content)

# 在站点或 TCM 上启用 SAML 身份验证

本主题介绍如何在站点或 Tableau Cloud Manager (TCM) 上启用 SAML 和选择单点登录 (SSO) 用户。它还提供了从 SAML 切换到默认 Tableau 身份验证的步骤。在启用 SAML 之前，我们建议您查看[Tableau Cloud 的 SAML 要求](https://help.tableau.com/v0.0/online/zh-cn/saml_online_requ.htm)，包括[更改身份验证类型对 Tableau Bridge 的影响](https://help.tableau.com/v0.0/online/zh-cn/saml_online_requ.htm#bridge-consequences)。

**注意：**为 TCM 启用 SAML 身份验证需要从 Tableau Cloud 进行单独设置和应用程序集成。

本主题假定您熟悉[身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm)以及 [SAML 身份验证的工作原理](https://help.tableau.com/v0.0/online/zh-cn/saml.htm)中的信息。

## 特定于 IdP 的配置信息

本主题后面各节中的步骤提供了您可与 IdP 文档配合使用来为 Tableau Cloud 站点 或 TCM 配置 SAML 的基本步骤。可以为以下 IdP 获取特定于 IdP 的配置步骤：

- [使用 Microsoft Entra ID 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_azure_ad.htm)
- [使用 AD FS 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_adfs.htm)
- [使用 OneLogin 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_onelogin.htm)
- [使用 PingOne 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_pingone.htm)
- [使用 Okta 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_okta.htm)
- [使用 Salesforce 配置 SAML](https://help.tableau.com/v0.0/online/zh-cn/saml_config_salesforce.htm)

## 启用 SAML

**对于 Tableau Cloud**

1. 以站点管理员身份登录到 Tableau Cloud 站点，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，从“身份验证”下拉菜单中选择“SAML”，然后输入配置的名称。
    
    ![Tableau Cloud 站点身份验证设置 - 新配置页面的屏幕快照](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site3.png)
    
    **注意：**2025 年 1 月（Tableau 2024.3）之前创建的配置无法重命名。

**对于 TCM**

或者，在 TCM 中，执行以下操作：

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 选择“启用其他身份验证方法”复选框，然后从“从身份验证”下拉菜单中选择“SAML” 。
3. 单击“配置（必需）”下拉箭头。

## SAML 配置步骤

此部分将引导您完成在 Tableau Cloud 蓝或 TCM 设置页面的“身份验证”选项卡上出现的配置步骤。

**注意：**若要完成此过程，您还将需要 IdP 提供的文档。请查找那些介绍如何为 SAML 连接配置或定义服务提供程序或者添加应用程序的主题。

步骤 1：从 IdP 中导出元数据

转到您的 IdP，登录您的 IdP 帐户，然后使用 IdP 文档提供的说明下载您的 IdP 的元数据。IdP 的元数据使 Tableau Cloud 或 TCM 能够连接到您的 IdP。

对于步骤 1，IdP 的文档将也可在如何向服务提供程序提供元数据方面为您提供指导。它将指示您下载 SAML元数据文件，或者将显示 XML 代码。如果它显示 XML 代码，请将代码复制并粘贴到一个新文本文件中，并使用 .xml 扩展名保存文件。

步骤 2：将元数据上传到 Tableau

对于 Tableau Cloud，在 Tableau Cloud 中的“新配置”页面上，导入您从 IdP 下载或通过它提供的 XML 手动配置的元数据 (.xml) 文件。

对于 TCM，在 TCM 中的“身份验证”页面上，导入您从 IdP 下载或通过它提供的 XML 手动配置的元数据 (.xml) 文件。

**注意：** 

- 上功 IdP 元数据后，“IdP 实体 ID”和“IdP SSO 服务 URL”字段将自动填充。
- 如果编辑配置，您将需要上载元数据文件，以便 Tableau 知道使用正确的 IdP 实体 ID 和 SSO 服务 URL。
- 如果您需要上载新的元数据文件，您可以使用 “清除 IdP 元数据”按钮。

步骤 3：映射属性

属性包含有关用户的身份验证、授权和其他信息。

**注意：**Tableau Cloud 或 TCM 需要 SAML 响应中的 **NameID** 属性。您可以提供其他属性来映射 Tableau 中的用户名，但响应消息必须包含 **NameID** 属性。

- 用户名：（必填）输入存储用户的用户名（电子邮件地址）的属性的名称。
- **电子邮件：** （可选）输入包含 IdP 在身份验证过程中使用的电子邮件地址的属性名称，以便用户能够在不同于用户名的电子邮件地址上接收通知。电子邮件地址属性仅用于通知目的，不用于登录。
- **显示名称：**（可选但建议使用）某些 IdP 为名和姓使用单独的属性，而另一些则将全名存储在一个属性中。
    
    选择对您的 IdP 存储名称的方式对应的按钮。举例来说，如果 IdP 将名和姓合并在一个属性中，请选择“显示名称”，然后输入属性名称。
    
    ![为 Tableau Cloud 配置站点 SAML 的步骤 3 的屏幕快照 - 映射属性](/tableau/next/zh-cn/online/zh-cn/Img/saml_config_site_match_assertions.png)

步骤 4：为嵌入视图选择默认值

**注意：**仅适用于 Tableau Cloud。

选择用户用于登录到嵌入视图的方法。此选项将打开一个显示 IdP 登录表单的单独弹出式窗口，或者使用嵌入式框架 (iframe)。

**重要信息：**由于 iframe 可能容易受到_点击劫持_攻击，因此并非所有 IdP 都支持通过 iframe 登录。利用点击劫持，攻击者会尝试引诱用户点击或输入内容。通过将攻击页面显示在某个不相关页面上的透明层中，攻击者可以达到此目的。对于 Tableau Cloud，攻击者可能会试图捕获用户凭据，或让授权用户更改设置。有关详细信息，请参见开放式 Web 应用程序安全项目网站上的[点击劫持](https://www.owasp.org/index.php/Clickjacking)。

如果您的 IdP 不支持通过 iframe 登录，请选择“在单独的弹出窗口中进行身份验证”。

步骤 4：获取 Tableau 元数据 (TCM)

要在 TCM 与您的 IdP 之间创建 SAML 连接，需要在这两项服务之间交换必需的元数据。若要从 TCM 中获取元数据，请选择以下方法之一：请参见 IdP 的 SAML 配置文档来确认正确的选项。

- 选择“导出元数据”按钮以下载一个包含 Tableau Cloud SAML 实体 ID、声明使用者服务 (ACS) URL 和 X.509 证书的 XML 文件。
- 如果您的 IdP 期望以另一种方式获得所需的信息，请选择“下载证书”。举例来说，它希望您在将临的位置中输入 Tableau Cloud 实体 ID、ACS URL 和 X.509 证书。

步骤 5：获取 Tableau 元数据 (Tableau Cloud)

要在 Tableau Cloud 与您的 IdP 之间创建 SAML 连接，需要在这两项服务之间交换必需的元数据。若要从 Tableau Cloud 中获取元数据，请选择以下方法之一：请参见 IdP 的 SAML 配置文档来确认正确的选项。

- 选择“导出元数据”按钮以下载一个包含 Tableau Cloud SAML 实体 ID、声明使用者服务 (ACS) URL 和 X.509 证书的 XML 文件。
- 如果您的 IdP 期望以另一种方式获得所需的信息，请选择“下载证书”。举例来说，它希望您在将临的位置中输入 Tableau Cloud 实体 ID、ACS URL 和 X.509 证书。
    
    ![从 Tableau Cloud 导出或复制元数据的指南。](/tableau/next/zh-cn/online/zh-cn/Img/saml_site_auth_step1_online.png)

步骤 5：配置 IdP (TCM)

对于步骤 5，请使用 IdP 文档提供的说明提交 TCM 元数据。

步骤 6：配置 IdP (Tableau Cloud)

对于步骤 6，请使用 IdP 文档提供的说明提交 Tableau Cloud 元数据。

步骤 6：测试配置并排查 SAML 问题 (TCM)

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

如果您无法成功登录 TCM，请首先执行“身份验证”页面上建议的故障排除步骤。如果这些步骤无法解决问题，请参见 [SAML 疑难解答](https://help.tableau.com/v0.0/online/zh-cn/saml_trouble.htm)。

步骤 7：测试配置并排查 SAML 问题 (Tableau Cloud)

我们强烈建议您测试 SAML 配置以避免出现任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 SAML 之前正确配置了 SAML。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 SAML 身份验证类型。

如果您无法成功登录 Tableau Cloud，请首先执行“新配置”页面上建议的故障排除步骤。如果这些步骤无法解决问题，请参见 [SAML 疑难解答](https://help.tableau.com/v0.0/online/zh-cn/saml_trouble.htm)。

管理用户

选择现有 Tableau Cloud 或 TCM 用户，或者添加您想批准其进行单点登录的新用户。

在添加或导入用户时，还要指定用户的身份验证类型。在“用户”页面上，可以在添加用户后随时更改用户的身份验证类型。

有关详细信息，请参见以下各项之一：

- [向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)或适用于 Tableau Cloud 的[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)主题
- 适用于 TCM 的[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)主题

嵌入视图的默认身份验证类型

**注意：**仅适用于 Tableau Cloud。

- 允许用户选择其身份验证类型
    
    当选择此选项时，仅支持弹出窗口。在此弹出窗口中，嵌入视图的位置将显示两个登录选项：一个登录按钮（使用单点登录 (SSO) 身份验证）和一个使用 Tableau 凭据作为替代方案的链接。
    
    **提示：**对于此选项，用户需要知道要选择哪个登录选项。作为在将用户添加到单点登录站点后向用户发送的通知的一部分，请告知用户要为各种登录方案选择哪种身份验证类型。例如，嵌入视图、Tableau Desktop、Tableau Bridge、Tableau Mobile，诸如此类。
- 带有 MFA 的 Tableau
    
    此选项要求用户使用 采用多重身份验证的 Tableau 凭据登录，即使在站点上启用了 SAML 也是如此。使用带有 MFA 的 Tableau 登录要求用户设置验证方法，以在用户每次登录 Tableau Cloud 时确认身份。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。
- 身份验证配置列表
    
    选择特定配置选项时，用户登录嵌入式视图的方式由您在上述步骤 6 中为指定配置配置的设置决定。

## 使用 Tableau 身份验证

如果站点或租户配置为使用 SAML，您可以更改设置以要求部分或全部用户使用 Tableau 凭据登录。

- 如果不再需要身份提供程序来处理身份验证，或者要求所有用户都使用其 Tableau 凭据登录，您可以在站点或租户级别更改身份验证类型。请参见下面的[更改站点的身份验证类型](#auth_type_site)部分。
- 如果要为部分用户保持启用 SAML，但要求其他用户使用 Tableau，您可以在用户级别更改身份验证类型。有关详细信息，请参见[设置用户身份验证类型](https://help.tableau.com/v0.0/online/zh-cn/users_set_auth_type.htm)。

### 更改站点的身份验证类型

**对于 Tableau Cloud**

从 2025 年 1 月（Tableau 2024.3）开始，您可以在站点上启用多种身份验证类型和方法。若要更改您希望在站点上提供的身份验证，请启用或禁用身份验证配置。

1. 以站点管理员身份登录到 Tableau Cloud 站点。
2. 选择“设置”\>“身份验证”。
3. 通过单击“操作”菜单并选择“禁用”或“启用”，禁用或启用站点的身份验证配置。

将 SAML 配置设为非活动之后，会保留元数据和 IdP 信息因此，如果想再次启用它，您无需再次与 IdP 建立 SAML 连接。

**对于 TCM**

1. 以云管理员身份登录到 TCM。
2. 选择“设置”\>“身份验证”。
3. 取消选中“启用附加身份验证方法”复选框。

## 更新 SAML 证书

用于 Tableau 站点元数据的证书由 Tableau 提供，不可配置。若要更新 SAML 证书，您必须将新证书上载到 IdP，并与 Tableau Cloud 重新交换元数据。

**对于 Tableau Cloud**

1. 以站点管理员身份登录到站点，并选择“设置”\>“身份验证”。
2. 在“身份验证类型”下，转到要更新的 SAML 配置，然后单击“操作”菜单并选择“编辑”。
3. 打开一个新选项卡或窗口，并登录到您的 IdP 帐户。
4. 使用 IdP 文档提供的说明上载新的 SAML 证书。
5. 下载新的 XML 元数据文件以提供给 Tableau Cloud。
6. 返回到 Tableau Cloud 中的“编辑配置”页面，并在步骤 2 中上载您从 IdP 下载的元数据文件。
7. 向下滚动页面并单击“保存并继续”按钮。

**对于 TCM**

1. 以云管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 从“身份验证”下拉菜单中选择“SAML”\>“配置（必需）”。
3. 打开一个新选项卡或窗口，并登录到您的 IdP 帐户。
4. 使用 IdP 文档提供的说明上载新的 SAML 证书。
5. 下载新的 XML 元数据文件以提供给 TCM。
6. 返回到 TCM 中的“身份验证”页面，并在步骤 2 中上载您从 IdP 下载的元数据文件。
7. 向下滚动页面并单击“保存并继续”按钮。

## 使用用户属性自定义和控制数据访问

用户属性是组织定义的用户元数据。在典型的基于属性的访问控制 (ABAC) 授权模型中，用户属性可用于确定访问权限。用户属性可以是用户配置文件的任何方面，包括工作角色、部门成员身份、管理级别等。它们还可能与运行时用户上下文相关联，例如用户的登录位置或他们的语言首选项。

通过在工作流中包含用户属性，您可以通过数据访问和个性化来控制和自定义用户体验。

- **数据访问**：用户属性可用于实施数据安全策略。这可以确保用户只能看到他们有权查看的信息。
- **个性化**：通过传递位置和角色等用户属性，可以自定义内容以仅显示与访问内容的用户相关的信息，从而使他们能够更轻松地找到所需的信息。

**传递用户属性的步骤摘要**

在工作流中启用用户属性的过程总结为以下步骤：

1. 启用用户属性设置
2. 在断言中包括用户属性
3. 确保内容作者包括用户属性函数和相关筛选器
4. 查看内容

### 步骤 1：启用用户属性设置

出于安全目的，仅当站点管理员启用用户属性设置时，才会在身份验证工作流中验证用户属性。

1. 登录到 Tableau Cloud 并单击“设置”\>“身份验证”。
2. 在“控制身份验证工作流程中的用户访问”标题下，选中“在身份验证工作流中启用用户属性捕获”复选框。

有关站点设置的详细信息，请参见[在身份验证工作流程中控制用户访问](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#user-attributes)。

### 步骤 2：在断言中包括用户属性

请确保断言包含用户属性。

**注意：**SAML 响应中的属性受 4096 个字符限制的约束，但 `scp` 或 `scope` 属性除外。如果响应中的属性（包括用户属性）超过此限制，Tableau 将移除这些属性并改为传递 `ExtraAttributesRemoved` 属性。然后，内容作者可以使用 `ExtraAttributesRemoved` 属性创建一个计算，以确定在检测到该属性后如何向用户显示内容。

**示例**

假设您有一名员工 Fred Suzuki，他是南部区域的经理。您需要确保，当 Fred 审阅报告时，他只能看到南部区域的数据。在这种情况下，您可能会在 SAML 响应中包括 Region 用户属性，如下例所示。

<saml:Assertion xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
	<saml;Issuer">https://myidp.okta.com/saml</saml:Issuer">
   <saml;Subject">
	  <saml:NameId Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"fsuzuki@example.com</saml:NameID">
   <saml:AttributeStatement xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml:Attribute Name="Region" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml:AttributeValue">South</saml:AttributeValue">
    	</saml:Attribute">
   </saml:AttributeStatement">
</saml:Assertion">

### 步骤 3：确保内容作者包括属性函数

确保内容作者包括用户属性函数和相关筛选器，以控制哪些数据可以显示在其内容中。为了确保将用户属性断言传递给 Tableau，内容必须包含以下用户属性函数之一：

- `USERATTRIBUTE('attribute_name')`
- `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`

内容作者使用的函数取决于用户属性是预期返回单个值还是多个值。有关这些函数及其示例的详细信息，请参见 Tableau 帮助中的[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm#user_attributes)。

**注意：**

- 在 Tableau Desktop 或 Tableau Cloud 中进行制作时，无法预览包含这些函数的内容。函数将返回 NULL 或 FALSE 。为确保用户函数按预期工作，我们建议作者在提供内容后查看函数。
- 为了确保内容按预期呈现，内容作者可以考虑包括一个使用 `ExtraAttributesRemoved` 执行以下操作的计算：1) 检查此属性，以及 2) 如果检查到该属性，则确定如何处理该内容，例如显示一条消息。Tableau 只会在 SAML XML 中的属性超过 4096 个字符时添加 `ExtraAttributesRemoved` 属性并移除所有其他属性（ `scp` 或 `scope` 除外）。这是为了确保最佳性能并遵守存储限制。

**示例**

继续上面的[步骤 2：在断言中包括用户属性](#step_pass_user_attribute)中介绍的示例，若要将“Region”用户属性断言传递给工作簿，作者可以包括 `USERATTRIBUTEINCLUDES`。例如，`USERATTRIBUTEINCLUDES('Region', [Region])`，其中“Region”是用户属性，\[Region\] 是数据中的一列。使用新计算，作者可以创建一个包含经理和销售额数据的表。添加计算后，工作簿将按预期返回“False”值。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_calc_view.png)

若要在嵌入式工作簿中仅显示与南部区域关联的数据，作者可以创建一个筛选器并对其进行自定义，以便在南部区域为“True”时显示值。应用筛选器后，工作簿将按预期变为空白，因为函数返回“False”值，并且筛选器自定义为仅显示“True”值。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_filter_view.png)

### 步骤 4：查看内容

查看和验证内容。

**示例**

为了结束上述[步骤 3：确保内容作者包括属性函数](#step_include_uaf)中的示例，您可以看到视图中的销售额数据是针对 Fred Suzuki 自定义的，因为他的用户上下文是南部区域。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_embedded_view_south.png)

工作簿中所代表区域的经理应会看到与其区域关联的值。例如，来自西部区域的 Sawdie Pawthorne 会看到特定于她所在区域的数据。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_embedded_view_west.png)

工作簿中未显示其区域的经理将看到空白工作簿。

### 已知问题和限制

使用用户属性函数时应考虑一些已知问题和限制。

#### 使用 Tableau REST API 的空白图像

Tableau REST API 请求[“查询预览图像](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#query_view_with_preview)”、“[查询工作簿图像”](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#query_workbook_preview_image)和[“获取自定义视图图像”](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#get_custom_view_image)会生成空白图像。

#### 限制

- 不支持已发布数据源 (.pds) 中的用户属性函数。
- 不支持 Tableau Bridge 工作流中的用户属性函数。

## 另请参见

[从连接的客户端中访问站点](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm)

<!-- document id=8726c171ff2c2e91623959e5f43f833e7bd3cef6e1d9fa1dc1e8c7f28c3bb247 url=/tableau/next/zh-cn/online/cloud_manager_capacity_site.md -->

[跳转到主要内容](#main-content)

# 在站点设置的容量

您的 Tableau 站点在创建时设置了容量限制，以针对存储、可视化呈现和系统响应能力进行优化。

本主题介绍在站点级别固定的容量。涵盖的容量并未详尽列出所有产品限制。有关可在租户上的站点之间分配的租户级别容量，请参见[Tableau Cloud Manager 中管理的容量](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm)。

## 在站点级别设置的容量

以下容量类型在站点级别是固定的：

- [存储](#storage)
- [数据提取 - 每日、运行时和内存使用量](#extracts)
- [订阅 - 运行时间和电子邮件大小](#subscriptions)
- [流程 - 用户请求、每日、运行时和内存使用量](#flows)
- [可视化项 - 加载时间、超时、请求率、内存使用情况](#visualizations)
- [其他 API 和命令行调用](#apis)

### 存储

站点具有站点和单独内容存储容量。

- **站点存储：**一个站点有 1 TB 的存储容量。工作簿、已发布数据源和流程将计入此存储容量。
    
    **注意：**
    
    - 安装了 Enterprise 版、Tableau+ 版的站点，或安装了 Advanced Management 加载项的现有站点可获得 5 TB 的站点存储空间。
    - Tableau Bridge 生成的数据提取会影响站点存储容量。有关 Tableau Bridge 会影响哪些容量类型的详细信息，请参见[Bridge 站点容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_site_capacity.htm)。
- **单个工作簿、已发布数据源和流程大小：**单个工作簿、数据源（实时或数据提取）或发布到站点的流程不应超过 25 GB。内容不应超过该大小，以获得最佳性能，并避免其他限制，例如查询使用和运行时限制。
    
    **注意：**
    
    - 如果数据提取数据源的大小超过 10 GB，我们建议您考虑使用与数据库的实时连接、对数据提取中的数据进行聚合以减小其大小，或使用增量数据提取。经常重新发布或刷新大型完全数据提取可能耗费大量时间，通常表示应考虑更高效的数据新鲜度策略。
    - Tableau Bridge 生成的数据提取受大小限制约束。有关 Tableau Bridge 会影响哪些容量类型的详细信息，请参见[Bridge 站点容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_site_capacity.htm)

### 数据提取 - 每日、运行时和内存使用量

站点具有用于数据提取刷新每日作业、运行时和内存使用量的指定容量。

**注意：**Tableau Bridge 对嵌入式数据提取和虚拟连接的刷新操作，会影响站点的每日数据提取、运行时和内存使用容量。有关 Tableau Bridge 会影响哪些容量类型的详细信息，请参见[Bridge 站点容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_site_capacity.htm)。

- **每日作业：**每日作业容量是指每个站点每天每个 Creator 许可证可用于执行站点上所有作业的共用小时数。服务器进程（称为后台程序）启动并执行这些作业。具有更多 Creator 许可证的站点有更多的每日作业，可满足更大站点群体的需求。
    
    例如：
    
    | 如果您的站点有... | 乘以默认时间 | 每日作业容量 |
    | --- | --- | --- |
    | 10 个 Creator 许可证 | 8 小时 | 最多 **80 小时/天** |
    | 50 个 Creator 许可证 | 8 小时 | 最多 **400 小时/天** |
    
    每日作业容量每天在 24:00:00 UTC（协调世界时）重置。
    
    #### 关于数据提取刷新
    
    计入每日作业容量的刷新作业包括完整和增量刷新以及数据提取创建，这些刷新和提取创建可以通过计划刷新、手动刷新以及特定命令行或 API 调用启动。
    
    **注意：**
    
    - 只要您的站点的每日刷新容量还有剩余时间，刷新作业就会开始。
    - 当站点达到其每日刷新容量的 70%、90% 和 100% 时，站点管理员会收到电子邮件通知。
    - 如果某个站点耗尽了每日刷新容量，则将来的任何数据提取刷新都将被取消，并向内容所有者发送电子邮件通知，提醒他们刷新已取消。
- **作业运行时间：**每个数据提取刷新作业的最长运行时间为 2 小时（120 分钟或 7200 秒）。如果刷新作业达到其最长运行时间，您将看到超时错误。有关错误以及可修改数据提取以使刷新作业保持在运行时间容量内的方法的详细信息，请参见[数据提取刷新的时间限制](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#timeout)。
- **刷新内存使用量：**站点可以使用不超过 20 GB 的内存来刷新数据提取。刷新数据提取所需的内存量可能因数据提取的大小和其他因素而异。

#### 优化提取刷新容量的技巧

如果您正在管理大量使用数据提取的环境，Tableau 建议遵循一些最佳做法，以最有效地利用数据提取刷新容量。

- **停止刷新未使用的数据提取**。为站点回收容量的最佳方法之一是通过 Tableau Cloud 上的计划或通过脚本停止未使用的数据提取的自动刷新。有关删除刷新计划的详细信息，请参见[管理任务](https://help.tableau.com/v0.0/online/zh-cn/task.htm)。
- **减小刷新的频率。**另一种为站点回收容量的方法是降低数据提取刷新的频率。例如，请考虑每天刷新一次数据提取，或者仅在新数据最有用的工作时间刷新数据提取，而不是每小时刷新一次数据提取。有关更改刷新计划的详细信息，请参见[管理任务](https://help.tableau.com/v0.0/online/zh-cn/task.htm)。
- **使用增量刷新，而不是完全刷新**。为了缩短数据提取刷新所需的时间，请考虑执行数据提取增量刷新，而不是完全刷新。有关详细信息，请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)。
    
    **注意：**只有在数据提取配置为在发布数据提取之前在 Tableau Desktop 中进行增量刷新时，才能从 Tableau Cloud 完全刷新更改为增量刷新。有关增量刷新的详细信息，请参见 Tableau 用户帮助中的[配置增量数据提取刷新](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm#incremental)。
- **使用实时连接，而不是数据提取连接**。对于需要频繁更新数据的视图、仪表板和工作簿，请考虑将数据源设置为使用实时连接，而不是数据提取连接。
- **优化数据提取中的数据**。提高数据提取的性能也可帮助缩短数据提取刷新所需的时间。您可以对数据提取的数据进行许多更改来帮助提高其整体性能，例如移除未使用的字段、使用筛选器移除未使用的行，以及更改日期范围。

### 订阅 - 运行时间和电子邮件大小

站点具有用于订阅运行时间和电子邮件大小的指定容量。

- **作业运行时间：**每个订阅作业的最长运行时间为 30 分钟（1,800 秒）。
- **电子邮件大小：**订阅电子邮件的最大大小为 2 MB。

### 流程 - 用户请求、每日、运行时和内存使用量

站点具有用于流程用户请求、运行时间和内存使用量的指定容量。

- **用户请求率：**每个用户一次最多可以有 4 个活动流程 Web 编辑会话。如果打开更多会话，则会关闭最旧的会话。
- **每日作业：**每个资源块每天最多可以运行 24 小时的流程。每个资源块表示站点上一次可以运行的并发流程作业数。可以购买额外的并发流程作业容量。有关详细信息，请参见[资源块](https://help.tableau.com/v0.0/online/zh-cn/to_resource_blocks.htm)。有关如何衡量流程容量的详细信息，请参见[流程并发](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#flows)。
- **作业运行时间**：除了每日站点限额外，任何单个流程作业的运行时间上限为最多 6 小时。如果单个流程执行超过此 6 小时阈值，作业将自动超时并失败。
- **流程内存使用量：**站点具有为流程作业使用不超过 19.5 GB 内存的容量。

### 可视化项 - 加载时间、超时、请求率、内存使用情况

站点具有用于加载和查询单个可视化项（也称为视图）的指定容量。您可以在下面找到有关每个容量类型的更多信息。

- **加载时间：**站点具有花费最多 5 分钟来加载视图的容量。
- **空闲超时：**如果用户连续 120 分钟未与视图交互或编辑视图，则用户必须重新加载（例如，刷新页面或在显示横幅时单击“重新连接”按钮）视图或保存的草稿才能与其再次交互。
- **用户请求率：**站点上的每个用户每小时最多可以发出 600 个请求来加载和刷新视图。当达到此容量时，用户可以与'视图交互、进行编辑和保存视图。一小时后，可以刷新视图并加载新视图。
    
    **注意：**
    
    - 如果累计用户请求数超过站点级请求率，用户将无法与视图交互、编辑和保存视图。
    - 虽然每用户请求率适用于所有许可证类型，但基于容量的模型增加了可在 Tableau Cloud Manager (TCM) 中配置的租户范围请求率容量。有关详细信息，请参见[可视化项](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#visualizations)。
- **查询内存使用大小：**站点具有不超过 40 GB 的内存来查询使用数据提取数据源的视图。根据 Tableau 在视图中生成标记所需执行的数据操作的复杂性，查询视图所需的内存量可能会有所不同。

超出这些容量类型的视图可能会被取消，以确保有足够的系统资源可用，以便可以加载站点上的其他视图。

#### 优化可视化项容量的技巧

超出可视化项容量的视图可能表明 Tableau 必须运行才能生成视图的查询可能过于复杂。在这种情况下，您可以使用以下技巧来帮助优化查询，从而最大限度地缩短在 Tableau Cloud 上加载视图所需的时间。大多数技巧要求您编辑数据源或工作簿，然后重新发布到 Tableau Cloud 以使更改生效。

有关更多技巧，请参见 Tableau 帮助中的[工作簿性能](https://help.tableau.com/current/pro/desktop/zh-cn/performance_tips.htm)主题。

- **使用数据源筛选器：**在数据源上添加筛选器时，您可以减少需要在视图中生成的数据量。减少数据量有助于最大限度地缩短视图的加载时间。有关详细信息，请参见 Tableau 帮助中的[筛选数据源中的数据](https://help.tableau.com/current/pro/desktop/zh-cn/filtering_datasource.htm)。
- **使用上下文筛选器：**与数据源筛选器类似，上下文筛选器会减少数据源中的数据，但却是在工作表级别减少。上下文筛选器独立于其他筛选器工作，可以显著减少需要在视图中生成的数据量。减少数据量有助于最大限度地缩短视图的加载时间。有关详细信息，请参见 Tableau 帮助中的[使用上下文筛选器提高视图性能](https://help.tableau.com/current/pro/desktop/zh-cn/filtering_context.htm)。
- **减小日期范围：**通常，日期比其他类型的数据（如数字和布尔值）需要更多的计算能力。如果视图包含日期筛选器，则可以减少日期范围或需要生成的日期数，以帮助最大程度地缩短视图的加载时间。
- **减少标记：**由于 Tableau 必须计算标记才能生成视图，因此标记数可能会影响视图的加载速度。有几种方法可以减少标记，包括使用上面列出的某些筛选器或使用集进行筛选、用于聚合数据的自定义 SQL，等等。有关详细信息，请参见[减少视图上的标记数量](https://help.tableau.com/current/pro/desktop/zh-cn/perf_visualization.htm#reduce-the-number-of-marks-on-the-view)。

### 其他 API 和命令行调用

站点具有用于 API 和命令行调用的指定容量。站点具有用于以下各项的容量：

- **[查询作业](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_job)和[取消作业](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#cancel_job) (Tableau REST API) 以及 [Tableau 客户端 (Python) 库](https://tableau.github.io/server-client-python/docs/)：**站点允许每 24 小时进行 20000 次调用。
- [获取站点上的用户](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_users_and_groups.htm#get_users_on_site) **(Tableau REST API)：**站点允许每分钟进行 5000 次调用。
- [从站点中移除用户](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_users_and_groups.htm#remove_user_from_site) **(Tableau REST API)：**站点允许每分钟进行 1600 次调用。

**注意：**如果调用数超过上述的 API 或命令行调用次数，您会看到以下错误之一：_Unknown 429（未知 429）_或 _ApiCallError: 429000: Too Many Requests – Too many requests for <job type> ‘api.rest.refresh\_extracts’.Please retry after 146 second(s)_.（ApiCallError：429000：请求太多 - 对 <作业类型>“api.rest.refresh\_extracts”的请求太多。请在 146 秒后重试）。

## 监视容量

作为站点管理员，您可以使用一些功能来监视站点的容量。

### 管理工具

有各种管理工具可以帮助您监视站点上不同类型的活动。您可以针对下面列出的功能找到更多容量使用信息。

- **存储：**您可以使用在线管理见解“空间使用情况统计数据”仪表板来监视站点的存储容量，并检查哪些工作簿、数据源和流程占用了站点上最多的空间。选择“浏览”\>“在线管理见解”\>“在线管理见解起始模板”\>“空间使用情况统计数据”。
    
    有关在线管理见解的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。
- **流程：**您可以监视流程运行的性能。选择“站点状态”\>“流程性能历史记录”。使用仪表板，在“流程历史记录”下，单击标记以查看有关流程作业的详细信息。
    
    有关此管理视图的详细信息，请参见[流程的管理视图](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_admin_views.htm)。
- **指标：**您可以使用“非数据提取的后台任务”管理视图来监视站点的指标作业。选择“站点状态”\>“非数据提取的后台任务”，然后从“任务”筛选器下拉列表中，选中“更新视图上的所有指标”复选框。
    
    有关此管理视图的详细信息，请参见[非数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd_nonextract.htm)。

### 活动日志

对于具有 Advanced Management 加载项的站点，您可以使用活动日志来捕获事件数据并跟踪特定操作，例如影响可视化项和作业容量的视图加载时间。

有关详细信息，请参见[活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm)。

<!-- document id=6f8a9c1fe03aee5faf45212746e2d13a787212557e9763195d02d4542ab60ff1 url=/tableau/next/zh-cn/online/portal_dashboard.md -->

[跳转到主要内容](#main-content)

# 基于仪表板的自定义门户

**注意：** 本概述的灵感来源于 Tableau 传道大使 Mark Jackson 的作品。有关相关过程的详细信息，请[查阅 Mark 的博客](http://ugamarkj.blogspot.sg/2013/12/customizing-tableau-server-experience.html)。

[标准 Tableau Cloud 或 Tableau Server 界面](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)对许多组织而言都很适合，但如果您想要创建带有公司品牌的体验，但没有 API 开发人员技能，请考虑基于 Tableau 仪表板创建一个自定义门户。利用自定义门户，您可以特定部门或工作角色的相关内容进行组织，甚至能够包含可帮助用户与数据更全面交互的培训。随着 Tableau 内容量的增长，自定义门户可将用户直接引导到其所需的数据，同时使他们能够立即访问相关的视图和 Tableau Cloud 搜索，从而能更轻松地进一步加以探索。

## 画出门户设计草图

从 Tableau 外部开始，在纸张或线框图应用程序中画出草图。考虑组织的结构，以及适用于每组用户的 Tableau 视图数。您是否只需要直接指向内容的一层导航？或者，您是否可能需要先创建为单独的用户组或报告类型提供导航链接的主页面，然后再创建包含相关仪表板和视图的第二层页面？

![该图表说明了医务人员、设施及其相关数据之间的相互联系。](/tableau/next/zh-cn/online/zh-cn/Img/portal_sketch.png)

在获得主要利益相干方和数据使用者的认可后，您即可进入下一阶段。

## 收集徽标和导航元素的图像

在细化初始版面设计时开始考虑图像事宜，然后从美工图案或许可品牌图形库中收集，或者在像 Photoshop 或 SnagIt 这样的应用程序中从头开始创建图像。如果打算创建常用图表类型的导航缩略图，PowerPoint 也可能是一个很好的来源。

![健康群体门户徽标。](/tableau/next/zh-cn/online/zh-cn/Img/portal_logo.png)

## 设置文本、图像和选定工作表在仪表板上的布局

创建一个包含门户仪表板的工作簿，使用[平铺布局](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_organize_floatingandtiled.htm#Tiled_vs._Floating_Layouts)能够以可预测性更强的方式实现元素在不同设备上的定位和缩放。然后开始添加文本和图像对象，以及想要在门户最前面突出显示的数据视图的任何工作表。为了细化这些仪表板元素之间的间隔，请插入空白对象并调整其大小。有关详细信息，请参见[创建仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm#Add_objects)。

## 将仪表板元素链接到内容

如果门户中有第二层导航，请使用[筛选器动作](https://help.tableau.com/current/pro/desktop/zh-cn/actions_filter.htm)从主要导航指向辅助仪表板。若要创建直接打开数据视图的链接，请右键单击图像对象并选择“设置 URL”（在下面的示例中，每个带颜色的箭头和伴随文本都是一个链接到视图 URL 的图像。）您甚至可以指向包含预加载数据源的空视图，从而鼓励用户在 Web 制作工作区中创建新 Tableau 内容。

**提示：**若要添加文本对象超链接，请包括完整的 URL（例如 `http://www.tableau.com`）。

![显示健康群体数据门户的网页，提供探索地理数据和创建自定义视图的能力。](/tableau/next/zh-cn/online/zh-cn/Img/portal_final.png)

## 发布、测试和细化门户

将工作簿发布到服务器，并将仪表板 URL 分发给用户。如同数据分析本身一样，门户设计是一个周期性的过程。现在，您的门户已公开发布，请开始收集用户反馈，以便能够继续改进体验。

**提示：**最后一道工序是隐藏 Tableau 工具栏，使门户具有自定义外观。在仪表板 URL 末尾的问号后，添加 `:embed=y&amp;:toolbar=n`

<!-- document id=ddd44c0ebf9773772fd74ce0c9ae1c571e1606fb618a3004c3a85f8fd335f11e url=/tableau/next/zh-cn/online/to_security_mfa.md -->

[跳转到主要内容](#main-content)

# 多重身份验证和 Tableau Cloud

[作为更广泛的 Salesforce 生态系统的一部分](https://help.salesforce.com/apex/HTViewSolution?urlname=Salesforce-Multi-Factor-Authentication-FAQ)，我们要求站点所有者为您和您的用户配置帐户安全机制。您启用帐户安全的方式取决于您在您的组织中可以使用哪些技术。从 2022 年 2 月 1 日起，MFA 身份验证成为 Tableau Cloud 要求。MFA 是增强登录安全性和保护组织及其数据免受安全威胁的有效工具。有关详细信息，请参见 Salesforce 帮助中的 [Salesforce 多重身份验证常见问题](https://help.salesforce.com/apex/HTViewSolution?urlname=Salesforce-Multi-Factor-Authentication-FAQ) 。

为了满足 MFA 要求，您可以使用单点登录 (SSO) 身份提供程序 (IdP)。如果您不直接使用 IdP，则可以使用“带有 MFA 的 Tableau”功能为 Tableau 身份验证启用 MFA。

**重要信息：**如果您决定使用“带有 MFA 的 Tableau”，请完整查看本主题，尤其是[在被锁定后重新获得站点访问权限](#mfa_lockedout)。

## 用户帐户和多重身份验证

多重身份验证 (MFA) 是一种安全的帐户身份验证方法，它要求用户在登录 Tableau Cloud 时通过提供两条或更多条信息（因素）来证明其身份。第一个因素是您的用户知道的独特信息 — 他们的用户名和密码。其他因素是用户拥有的验证方法，例如身份验证器应用程序、安全密钥或内置身份验证器。

通过在用户登录 Tableau Cloud 时强制执行多种因素，MFA 使网络钓鱼攻击和帐户接管等常见威胁更难成功。MFA 是增强登录安全性和保护组织及其数据免受安全威胁的有效工具。

> **推荐方法 - 使用 MFA 的 SSO：**如果您当前正在将您组织的 SSO IdP 与 MFA 结合使用来增强您的安全性，请继续这样做。如果没有，为了满足 MFA 要求，请将站点配置为使用 SSO 并通过 SSO IdP 启用 MFA。您可以将站点用户配置为通过 Google、Salesforce 或 SAML 提供提供程序进行身份验证。
> 
> **替代方法 - 带有 MFA 的 Tableau**：如果您不直接使用 SSO IdP，或者您使用 TableauID，则可以通过启用带有 Tableau 身份验证的 MFA 来满足 MFA 要求。此功能支持在成功通过站点身份验证之前使用验证方法的附加步骤。
> 
> “带有 MFA 的 Tableau”支持以下验证方法：
> 
> - Salesforce 身份验证应用软件
> - 第三方基于时间的一次性密码 (TOTP) 身份验证器应用软件，包括 Google Authenticator、Microsoft Authenticator 和 Authy
> - 支持 WebAuthn 或 U2F 的安全密钥，例如 Yubico YubiKey 或 Google Titan 安全密钥
> - 内置身份验证程序，包括 Touch ID、Face ID 和 Windows Hello
> - 恢复码（仅作为备份）
> 
> **重要信息：**从 Tableau Desktop、Tableau Prep Builder、Tableau Bridge 和 Tableau 内容迁移工具对 Tableau Cloud 进行身份验证时，不能使用支持 WebAuthn 或 U2F 和内置身份验证器的安全密钥。如果其中一种验证方法已注册，您（和您的用户）可以通过 Tableau Cloud 中的“我的账户设置”页面注册其他验证方法。
> 
> 若要比较支持的验证方法并查看使用要求，请参见 Salesforce 帮助中的[多重身份验证的验证方法](https://help.salesforce.com/articleView?id=sf.mfa_supported_verification_methods.htm)主题。

## 启用带有 Tableau 身份验证的 MFA

如果您的组织不直接使用 SSO IdP，您可以使用带有 MFA 的 Tableau 默认身份验证满足 MFA 要求。有关详细信息，请参见[关于多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/security_auth.htm#mfa_requirement)。

如果 Tableau 尚未更新您的站点以要求带有 MFA 的 Tableau，请按照这些步骤启用 MFA。您还可以在 YouTube 上的 [Multi-Factor Authentication Enforcement | Tableau Cloud（多重身份验证实施 | Tableau Cloud）](https://www.youtube.com/watch?v=U8909ayNKjI)视频中查看此过程的概述。

1. 使用站点管理员凭据登录到 Tableau Cloud，并转到“用户”页面。
2. 在列出的第一个用户旁边，执行以下操作：
    
    1. 单击“操作”菜单，选择“身份验证”，然后选择“带有 MFA 的 Tableau”。
        
        ![带有使用或不使用多重身份验证来验证用户的选项的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_option_new_sites.png)
    2. 单击“更新”保存更改。
3. 为列出的每个用户（包括站点管理员）重复步骤 2。

用户使用 Tableau 用户名和密码登录 Tableau Cloud 后，系统会提示他们选择支持的验证方法。有关注册和管理验证方法的用户进程的详细信息，请参见[注册多重身份验证](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm#mfa_register_user)。

有关 Tableau Bridge、tabcmd 2.0 和 Tableau REST API 的 MFA 登录体验的概述，请参见 YouTube 上的 [Multi-Factor Authentication: Post Enforcement | Tableau Cloud（多重身份验证：实施后 | Tableau Cloud）](https://www.youtube.com/watch?v=8qMMEQZgMLM)视频。

### 适用于站点管理员帐户的 MFA 最佳做法

为您的用户启用带有 MFA 的 Tableau 时，我们建议对您的站点管理员帐户采用以下最佳做法：

- **至少注册两种验证方法：**对于每个站点管理员帐户，至少注册两种验证方法，以降低被锁定在站点之外的风险。例如，在您注册了主要验证方法后，我们建议您添加“恢复码”选项以生成一组恢复码作为备份。
- **指定至少一个站点管理员帐户来管理用户和 MFA：**指定至少一个有权管理用户和 MFA 设置的站点管理员级别帐户（“站点管理员 Creator”或“站点管理员 Explorer”）。如果另一个管理员被锁定在站点之外，这种冗余可以帮助防止管理员访问延迟。

### 管理验证方法

您（和您的用户）可以从“我的帐户设置”页面管理验证方法。单击“管理 MFA 验证方法”链接后，您可以添加或移除其他验证方法，包括添加恢复码。

![弯曲的箭头指向验证方法列表。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_manage_methods.png)

### 关于恢复码 - 仅限紧急情况

为了帮助降低锁定场景的风险，我们建议您（和您的用户）在注册 MFA 后添加“恢复码”选项作为备份。如果您无权访问常用的 MFA 验证方法，则仅在紧急情况下使用的恢复码允许您登录 Tableau Cloud。如果您添加恢复码选项，则会生成一个包含十个一次性使用代码的列表，您可以使用这些代码登录 Tableau Cloud。

**重要信息：** 

- 由于添加了“恢复码”选项后无法访问恢复码列表，因此请立即复制这些代码并将其存储在安全可靠的位置，以供在紧急情况下使用。
- 恢复码不应用作主要验证方法，而应仅用作**备份**。相反，只有当您无法访问常用的 MFA 验证方法时，恢复码才用于紧急情况。

### 在被锁定后重新获得站点访问权限

**重要信息：**我们强烈建议您（和您的用户）注册“恢复码”选项，以避免被锁定在您的站点之外。恢复码应仅在紧急情况下使用。

如果您丢失了所有常用的验证方法，则必须重置 MFA 验证方法才能重新获得对站点的访问权限。重置 MFA 验证方法的过程取决于您的角色以及您是否属于一个或多个站点。查看下表以确定后续步骤。

<table style="width: 100%;margin-left: 0;margin-right: auto;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"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">您的角色</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">目标用户</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">目标站点成员身份</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">是否可重置 MFA？</td><td style="font-weight: bold;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">原因或后续步骤</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td rowspan="3" class="TableStyle-Basic-Border-BodyE-Column1-Body1">站点管理员</td><td rowspan="3" class="TableStyle-Basic-Border-BodyE-Column1-Body1">站点管理员或站点用户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">单一站点</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">是</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">从<span class="uicontrol">“用户”</span>页面中重置验证方法。有关详细信息，请参见下面的<a href="#reset_verifiers" class="xref">重置验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">多个站点，同一租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">站点管理员无法重置多站点用户的 MFA 验证方法。只有 TCM 云管理员可以重置多站点用户的验证方法。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm#reset_mfa" class="xref">重置验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">多个站点，不同租户</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">出于安全考虑，站点管理员或 TCM 云管理员无法重置多个租户上用户的验证方法。有关详细信息，请参见下面的<a href="#reset_verifiers_multi_tenant" class="xref">关于为多个租户上的用户重置验证方法</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">站点上的唯一站点管理员</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">您自己</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">单一站点</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">否</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">请与您的 Tableau 客户经理联系。有关详细信息，请参见下面的<a href="#reset_verifiers_only_admin" class="xref">以唯一的站点管理员身份重新获得站点访问权限</a>。</td></tr></tbody></table>

#### 重置验证方法

若要启用站点访问权限，请从 Tableau Cloud 中的“用户”页面中重置 MFA 与 Tableau 验证方法。

**重要信息：**出于安全目的，站点管理员只能重置属于单个站点的用户的验证方法。但是，如果您也是云管理员，则可以使用 Tableau Cloud Manager (TCM) [重置多个站点上用户的验证方法](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm#reset_mfa)。如果您不满足这些要求之一，可以联系 Tableau 支持部门来提交支持案例以重置用户的验证方法。有关详细信息，请参见知识文章[如何在 Salesforce 帮助中创建个案](https://help.salesforce.com/s/articleView?id=000393090&type=1)。

1. 以站点管理员身份登录到 Tableau Cloud。
2. 导航到“用户”页面并选择需要重新访问站点的用户。
3. 单击“操作”菜单，并选择“重置 MFA 验证程序”。
4. 在该用户的个人资料页面上，单击“设置”选项卡，然后单击“重置 MFA 验证程序”按钮。  
    **注意：**若要显示“重置 MFA 验证程序”按钮，用户的身份验证方法必须设置为“带有 MFA 的 Tableau”。
5. 重置 MFA 验证方法后，联系用户并要求他们按照[注册多重身份验证](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm#mfa_register_user)中所述的过程再次注册 MFA。

**注意：**若要为多个站点上的用户或 Tableau Cloud Manager (TCM) 用户重置验证方法，请参见[重置验证方法](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm#reset_mfa)（适用于云管理员）。

#### 以唯一的站点管理员身份重新获得站点访问权限

如果您是唯一的站点管理员，并且丢失了所有常用的 MFA 与 Tableau 验证方法，您必须与您的客户经理联系。

为了重新获得 Tableau Cloud 的访问权限，Tableau 必须手动确认您的身份，然后重置验证方法。为帮助确保顺利的帐户恢复过程，请记住以下几点：

- Tableau 可能会使用您的 TableauID 个人资料（在[Tableau.com 上](http://tableau.com/zh-cn)）中的信息来验证您的身份。因此，务必及时更新您的个人资料信息，例如电话号码。有关编辑 TableauID 配置文件的详细信息，请参见 Tableau 社区站点上的[在 Tableau 社区中更改您的姓名、职务或电子邮件地址](https://community.tableau.com/s/changing-contact-information)。
- 如果您有高级支持并在周末需要帮助，您可以提交 Tableau 支持案例。有关详细信息，请参见知识文章[通过 Web 表单提交案例](https://kb.tableau.com/articles/HowTo/submitting-a-case-from-the-webform?lang=zh-cn)。

有关详细信息，请参见知识文章 [Tableau Cloud 使用多重身份验证重置 Tableau ID 的身份验证器](https://kb.tableau.com/articles/issue/reset-authenticator-for-tableau-id-with-multifactor-authentication?lang=zh-cn)。

#### 关于为多个租户上的用户重置验证方法

作为安全最佳实践，您必须联系 Tableau 支持部门，为属于跨多个租户的站点的用户重置 MFA 与 Tableau 验证方法。

若要联系 Tableau 支持，请按照[如何在 Salesforce 帮助中创建个案](https://help.salesforce.com/s/articleView?id=000393090&type=1)知识文章中描述的步骤进行操作。

<!-- document id=23da1e92b32b11edf896054da97474a64fca55300f692134e8d9ae04fc1223b6 url=/tableau/next/zh-cn/online/to_bridge_install.md -->

[跳转到主要内容](#main-content)

# 安装 Bridge

Tableau Bridge 是一种软件，您可以与安装并与 Tableau Cloud 结合使用。请始终安装最新版本的 Bridge 以利用最新的安全性和功能更新。

Tableau Bridge 可用于 Windows 安装，对于 Docker 容器，也可用于 Linux。

**注意**：Tableau Cloud 2025.2（2025 年夏季）版本中新增了对 OAuth 连接的一次性刷新令牌（有时称为一次性刷新令牌、滚动刷新令牌或刷新令牌轮换）的支持，并在 Tableau Server 2025.3 版本中添加了支持（如果数据源提供商的 IDP 支持）。这些令牌在 Tableau Bridge 与 Tableau Cloud 的连接上尚不受支持。如果为连接使用外部 OAuth 配置，请参见 GitHub 中的 [OAuth 配置和使用文档](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 配置文档")了解详细信息。

## 安装 Bridge 之前

无需产品密钥也可使用 Bridge。使用 Bridge 须遵循最终用户许可协议 (EULA)。Bridge 的用户必须是 Tableau Cloud 的授权用户。

您可以在 [Tableau Bridge](https://www.tableau.com/zh-cn/support/releases/bridge) 产品下载和发行说明页面上找到所有可用版本。

### 网络访问

由于 Bridge 可以方便地连接私有网络数据和 Tableau Cloud，因此需要能够通过 Internet 进行出站连接。初始出站连接后，通信是双向的。

#### 所需端口

Tableau Bridge 使用端口 443 向 Tableau Cloud 发出出站 Internet 请求，并使用端口 80 进行证书验证。

### 带有 MFA 的 Tableau

Bridge 支持多重身份验证 (MFA)。有关使用 MFA 的 Tableau 的详细信息，请参见[关于多重身份验证和 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/security_auth.htm#mfa_requirement)。

### 数据库驱动程序

Bridge 使用 Tableau 连接器连接到不同数据库来使数据保持最新。其中一些连接器需要驱动程序来与数据库通信。

若要获取客户端支持的连接器的驱动程序，请转到 Tableau 网站上的[驱动程序下载](http://www.tableau.com/zh-cn/support/drivers)页面。请务必筛选操作系统上的列表，并使用为数据源列出的说明。

## 此部分中的其他文章

<!-- document id=132eed9850d14c3f2363b0e58f67aed39fbe80ee21caa966157cbd14f4a07839 url=/tableau/next/zh-cn/online/cmt-install.md -->

[跳转到主要内容](#main-content)

# 安装 Tableau Content Migration Tool

安装 Tableau Content Migration Tool 非常简单。

## 安装要求

Content Migration Tool 工具从 Windows 计算机运行，并且可以使用有效的 Advanced Management 许可证连接到 Tableau Cloud 站点和 Tableau Server 19.3 及更高版本。有关兼容版本的详细信息，请参见[Tableau Content Migration Tool 入门指南](https://help.tableau.com/v0.0/online/zh-cn/cmt-getting-started.htm)。

您在其上安装 Content Migration Tool 的计算机必须满足以下要求：

- Microsoft Windows 10 或更高版本 (x64)
- Intel Core i3 或 AMD Ryzen 3（双核）
- 4 GB 内存或更大
- 可以连接到源和目标站点。两个站点都必须具有有效的 [Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm) 许可证才能迁移内容。
- 2 GB HDD 或更大。`\temp` 文件夹所在的驱动器必须有足够的磁盘空间来保存在一次迁移中迁移的所有内容的副本。所有内容都存储在本地磁盘上，并在迁移完成后删除。
- 有足够的可用磁盘空间来容纳应用程序及其日志。

此外，请确认已在 Tableau Server 上启用 REST API（这是默认设置）。使用 `tsm configuration get -k api.server.enabled` 命令来确认这一点。返回值 `true` 意味着 REST API 已启用。若要启用 REST API，请使用 `tsm configuration set` 命令：有关详细信息，请参见 Tableau Server 帮助中的 [api.server.enabled](https://help.tableau.com/current/server/zh-cn/cli_configuration-set_tsm.htm#rest_api_enabled)。

## 安装 Content Migration Tool

若要安装 Content Migration Tool，请执行以下操作：

1. 从 [Tableau Advanced Management](https://www.tableau.com/zh-cn/support/releases/advanced-management) 下载页面下载 Content Migration Tool 安装程序 (`Tabcmt-64bit-<version>.exe`)。
2. 运行 Content Migration Tool 安装程序。
    
    **注意：**运行 Content Migration Tool 安装程序将覆盖以前的版本。
3. 阅读 EULA 之后，选择“I agree to the license terms and conditions”，并单击“Install”。
4. 如果“用户帐户控制”对话框打开，单击“Yes”以允许安装程序进行更改。

## 升级 Content Migration Tool

升级到 Content Migration Tool 的最新版本可确保您可以利用每个新版本附带的最新功能和修复。

**重要信息：**

- 运行 Content Migration Tool 安装程序将覆盖以前的版本。
- Content Migration Tool 不支持并排安装以前的版本。

若要升级 Content Migration Tool，请执行以下操作：

1. 登录到安装了 Content Migration Tool 的计算机。如果有 Content Migration Tool 的实例已打开，保存您的迁移计划并退出应用程序。
2. 按照[安装 Content Migration Tool](#install-cmt) 中列出的步骤操作，下载最新的安装程序并完成升级。

## 通过命令行安装 Content Migration Tool

如果您是计算机上的本地管理员，则可以通过命令行安装 Content Migration Tool。

### 安装开关

为安装程序在命令行中指定一个或多个开关。例如：

`Tabcmt-64bit-2022-3-0.exe /quiet /norestart`

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td>开关</td><td>描述</td><td>注释</td></tr><tr><td><code>/install</code> | <code>/repair</code> | <code>/uninstall</code> | <code>/layout</code> "<code>&lt;directory&gt;</code>"</td><td><p>运行安装程序来安装、修复或卸载 <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>，或使用 <code>/layout</code> 在指定目录中创建安装包的完整本地副本。</p></td><td>默认值为进行安装，并显示 UI 和所有提示。如果在全新安装时未指定目录，则使用 <code>C:\Program Files\Tableau\Tableau Content Migration Tool</code>。如果 <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 已安装 ，安装程序将使用与当前安装相同的位置。</td></tr><tr><td><code>/passive</code></td><td><p>运行安装程序并显示最少的 UI，并且不显示提示。</p></td><td>在 <code>/passive</code> 模式下安装时，<span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 不会自动启动。若要启动 <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>，请手动打开应用程序。</td></tr><tr><td><code>/quiet</code> | <code>/silent</code></td><td><p>以无人参与的完全无提示模式运行安装程序。不会显示任何 UI 或提示。</p></td><td>在 <code>/silent</code> 或 <code>/quiet</code> 模式下安装时，<span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 不会自动启动。若要启动 <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span>，请手动打开应用程序。<p class="note"><b>注意：</b>使用 <code>/silent</code> 或 <code>/quiet</code>，不要两者都使用。</p></td></tr><tr><td><code>/norestart</code></td><td><p>运行安装程序而不重新启动 Windows，即使必须重新启动也是如此。</p></td><td><p class="note"><strong>注意：</strong>在某些极少数情况下，即使使用此选项，也无法抑制重新启动。当跳过较低版本系统的重新启动时（例如，在安装其他软件期间），很可能出现这种情况。</p></td></tr></tbody></table>

## 谁可以执行此操作

在计算机上具有管理员访问权限的用户。

<!-- document id=9a7707ae7932dfc61383d70907a5b6ec36668527732207454b8531c2714b63f7 url=/tableau/next/zh-cn/online/to_bridge_window_install.md -->

[跳转到主要内容](#main-content)

# 安装 Windows 客户端

对于 Windows 安装，Tableau 建议将 Bridge 客户端安装在防火墙后面的专用计算机上，这样它就不会与其他应用程序的资源竞争。一台计算机上只能安装一个客户端。

### Bridge 客户端要求

以下是 Bridge 客户端的管理和访问要求。

- 需要 Bridge 客户端 UI 来以交互方式登录到 Tableau Cloud。
- 启动驱动器上的_用户配置文件_，用于存储`My Tableau Bridge Repository.`的内容
- 登录用户必须是或等同于计算机的本地管理员才能在服务模式下运行 Bridge 客户端。
- 访问特定于当前登录用户的操作系统库来存储：
    - 特定于 Windows 会话的当前登录用户的在线服务器登录令牌。
    - 远程数据提取请求的数据连接凭据（简单登录信息）。

### 系统建议

Bridge 可用于 Windows 操作系统。您也可以将客户端安装在虚拟机上。有关受支持的 Windows 版本以及其他建议的详细信息，请查看[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)。[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)

## 安装 Bridge

按照下面的过程安装 Windows Bridge 客户端。无需 Tableau 产品密钥也可安装或使用客户端。

1. 从 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面下载安装程序。我们建议下载页面上列出的最新版本，以利用最新的安全性和功能更新。
2. 运行安装程序。您可以使用共享的 Windows 服务帐户安装客户端。
    
    用于运行客户端的帐户是配置时登录到 Windows 的帐户。
    
    如果客户端设置有单独的本地用户帐户，则在不重新安装 Bridge 的情况下无法将该帐户更改为共享服务帐户。若要更改帐户，请以当前用户身份卸载 Bridge，登录共享服务帐户，然后重新安装并配置 Bridge。
    
    对于服务模式，Windows 用户帐户必须是计算机上的“本地管理员”组的成员。此外，若要刷新基于文件的数据源，帐户必须对托管文件数据的网络共享驱动器具有域访问权限。
3. 出现提示时，接受许可协议以继续。
4. （可选）通过单击“自定义”来自定义安装。您可以更改以下任何选项：
    
    - **安装位置：**您可以指定其他位置来安装客户端。除非 Windows 管理员已显式更改用户的默认配置文件设置，否则 TEMP 目录和用户配置文件将驻留在系统驱动器（例如 C:）上，即使 Bridge 客户端安装在单独的驱动器上（例如D:）。这是进行硬盘容量和性能规划的重要考虑因素。有关详细信息，请参见[Windows 的磁盘空间规划](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#disk-windows)。
    - **创建桌面快捷方式：**如果不想为 Bridge 自动创建桌面快捷方式，请清除该复选框。
    - **创建开始菜单快捷方式：**如果不想向开始菜单中自动添加 Bridge 快捷方式，请清除该复选框。
    - **启用错误报告：**如果 Bridge 出现问题并意外关闭，将会生成崩溃转储文件和日志，并发送给 Tableau。若要关闭此选项，请在安装过程中清除此复选框。也可以在安装之后在客户端中禁用此选项（或重新启用）。有关详细信息，请参见[错误报告](#error_reports)。
5. 单击“安装”开始客户端安装。

安装客户端之后，可通过以下两种方式启动客户端：双击桌面上的 Bridge 快捷方式，或者从 Tableau Desktop 中启动（如果 Tableau Desktop 与 Bridge 安装在同一台计算机上）。

### 关于“我的 Tableau Bridge 存储库”

在 Bridge 安装过程中，会在安装了客户端的计算机上创建一个名为“**我的 Tableau Bridge 存储库**”的文件夹。此存储库文件夹包含重要的子文件夹，例如 **Logs** 和 **Configuration**，Bridge 需要这些文件夹才能正常操作。

将在“文档”文件夹下创建存储库文件夹：_\\Users\\<user>\\Documents\\My Tableau Bridge Repository_。

**重要信息：**我们强烈建议您不要更改 Bridge 用作其存储库的文件夹。

## 升级 Bridge

与 Bridge 的最新版本保持同步可确保您可以利用 Bridge 客户端的每个新版本附带的最新功能和修复。

### 并行升级（推荐）

为了最大限度地减少停机时间，我们建议运行并行升级过程。在这种情况下，您将新的 Tableau Bridge 客户端安装在与现有 Bridge 客户端运行位置不同的硬件上。运行并行升级过程可以确保稳定性，如果升级过程中出现任何问题，可以立即恢复到已知的良好状态。

若要运行 Bridge 客户端的并行升级，请按照以下过程操作。

1. 登录到安装了现有 Bridge 客户端的计算机。
2. 如果在“服务”模式下运行客户端，请在客户端左上角“模式”的旁边选择“**应用程序**”。更改到“应用程序”模式可确保 Tableau Bridge 服务在升级之前完全停止。选择“设置”\>“退出”。
3. 按照上一节[安装 Bridge](#install)所述添加新计算机并安装新的 Tableau Bridge 客户端。
4. 将新的 Bridge 客户端添加到相关池。请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。
5. 在继续下一步之前，请监控 Bridge 作业的运行状况以验证稳定性。
6. 从池中移除之前的 Bridge 客户端。打开池，找到要移除的客户端计算机，然后单击**“删除”**。
7. 等待 Bridge 客户端上的数据提取刷新超时过程完成。默认超时为 24 小时。有关详细信息，请参见[dataSourceRefreshSettings](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#dataSourceRefreshSettings)。
8. 刷新超时期限过后，您可以移除运行 Bridge 先前版本的硬件。

安装完成后，客户端将正常启动。如果升级过程之前客户端在“服务”模式下运行，请切换回“服务”模式。

### 非并行升级

如果无法运行两台并行计算机，请按照以下步骤在同一台计算机上升级 Bridge 客户端。请注意，在步骤 #2 和步骤 #3 之间，作业将无法运行。在移除旧版本之前，您也无法监控 Bridge 作业的稳定性。

1. 登录到安装了现有 Bridge 客户端的计算机。
2. 如果在“服务”模式下运行客户端，请在客户端左上角“模式”的旁边选择“**应用程序**”。更改到“应用程序”模式可确保 Tableau Bridge 服务在升级之前完全停止。选择“设置”\>“退出”。
3. 按照上一节[安装 Bridge](#install)中所述的步骤安装新的 Tableau Bridge 客户端， 。

安装完成后，客户端将正常启动。如果升级过程之前客户端在“服务”模式下运行，请切换回“服务”模式。

## 错误报告

您可通过向 Tableau 自动发送错误报告来帮助改进 Bridge。错误报告包含在 Bridge 客户端不得不意外关闭（崩溃）时发送给 Tableau 的崩溃转储文件。Tableau 使用这些文件来确定和解决导致客户端意外关闭的问题。

**重要信息：**如果您的数据须遵守任何隐私法规，请关闭此选项。

### 错误报告的内容

加密包由以下文件组成：崩溃和核心转储文件，以及与崩溃相关的清单文件。

这些文件可能包含包括以下内容的数据：

- 特定于计算机的信息。例如：硬件、操作系统、域，等等。
- 发生崩溃时内存内容的快照。例如：哪些数据源有刷新的数据提取、哪些数据源有实时查询，等等。
- 发生崩溃时 Bridge 正在处理的信息，包括可能用于纠正错误的可识别客户的信息。例如：谁正在将 Bridge 用于哪个站点，用户所登录到的客户端的名称，等等。

有关 Tableau 如何处理敏感信息的详情，请参见 Tableau 网站上的 [Tableau 隐私策略](https://www.tableau.com/zh-cn/privacy)。

### 配置自动错误报告

您可以将 Bridge 配置为在以下两个位置之一自动发送错误报告：在客户端安装过程中发送，或者安装之后直接在客户端中发送。

#### 在客户端安装过程中启用自动错误报告选项

在安装过程中，用于从客户端中自动发送错误报告的选项默认情况下已选定。但是，您可以移除选择。

![Tableau Bridge 安装屏幕，其中包含创建桌面快捷方式和启用错误报告的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_installer_error_reporting_WOdriver.png)

#### 在客户端中禁用自动错误报告选项

如果在安装过程中决定使用默认设置，而稍后又决定不想允许自动发送错误报告，您可以通过客户端菜单修改选项。

![Tableau Bridge 设置菜单，提供发送错误报告的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_send_error_reports.png)

## 通过命令行安装 Bridge

如果您是计算机上的本地管理员，则可以通过命令行安装 Bridge 客户端。

### 一般命令行语法

用于从命令行中运行 Bridge 安装程序的语法如下：

`tableauBridge<installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2`

有关语法的一些注意事项：

- `tableau<installer_name>.exe` 文件是您所安装的产品和版本的客户端安装程序。
- 这些选项指定安装过程应如何运行。例如，是否应在安装时显示输出，以及是否应创建日志文件。
- 属性设置指定安装程序在安装过程中应进行的配置设置。

#### 示例安装程序命令

以下示例显示具有一些选项和属性设置的安装程序命令：

`TableauBridge-20232.23.0611.2007-x64.exe/quiet /passive ACCEPTEULA=1`

您必须从 .exe 文件所在的目录运行命令，或指定计算机上 .exe 文件位置的完整路径。不要从网络上的共享目录中运行安装程序。而是要将 .exe 文件下载到您要安装客户端的计算机上的某个目录。

### 安装程序选项和属性

您可以为安装程序在命令行中指定一个或多个选项。

#### 安装程序选项

有关选项的一些注意事项： 

- 每个选项都以斜杠 (/) 为前缀。
- 选项必须放在属性前面。

<table class="simple-table"><colgroup><col style="width: 25%;"><col></colgroup><tbody><tr><th>选项</th><th>描述</th></tr><tr><td><code>quiet</code></td><td>运行安装程序时不会显示消息（状态或安装进度），也无需用户交互。客户端在安装完成后不会启动。</td></tr><tr><td><code>passive</code></td><td>运行安装程序并显示对话框以及安装状态。不提示用户输入内容。客户端在安装完成后启动。</td></tr><tr><td><code>norestart</code></td><td>禁止任何尝试重新启动的操作。默认情况下，安装程序将在重新启动之前提示您，除非您在无提示模式下运行安装程序。</td></tr><tr><td><code>log "<em>logfile.txt</em>"</code></td><td>将安装信息记录到指定的路径和文件。指定路径和文件名，例如 <code>/log "c:\logs\logfile.txt"</code>。默认日志文件为系统 <code>%TEMP%</code> 目录。</td></tr><tr><td><code>repair</code></td><td>运行安装程序以修复 Bridge 的现有安装。</td></tr><tr><td><code>h</code></td><td>Help — 列出安装程序的选项和属性。</td></tr></tbody></table>

#### 安装程序属性

您还可以为安装程序在命令行中包括一个或多个属性。

有关属性的一些注意事项：

- 所有这些属性均可用于客户端的初始安装。它们不能用于在初始安装后更新任何设置。
- 属性名称区分大小写。
- 等号的两边没有空格。
- 各个属性集用空格分隔。
- 属性必须放在选项后面。

<table class="simple-table" style="width: 100%;"><colgroup><col title="1" style="width: 22%;"><col title="2" style="width: 40%;"><col></colgroup><tbody><tr><th>属性</th><th>描述</th><th>值</th></tr><tr><td><code>ACCEPTEULA</code></td><td>接受最终用户许可协议 (EULA)。如果未将此选项设置为 <code>1</code>，则无法使用无提示模式安装 Bridge。</td><td>1 = 接受 <br>0 = 不接受（默认值）</td></tr><tr><td><code>CRASHDUMP</code></td><td>您可以将此选项设置为“1”，通过在客户端崩溃时自动向 Tableau 发送错误报告来帮助改进 Bridge。有关详细信息，请参见<a href="#error_reports" class="xref">错误报告</a>。</td><td>1 = 是（默认值）<br>0 = 否</td></tr><tr><td><code>DESKTOPSHORTCUT</code></td><td>创建桌面快捷方式。</td><td>1 = 是（默认值） <br>0 = 否</td></tr><tr><td><code>DRIVERDIR</code></td><td>为数据库驱动程序指定（除默认目录之外的）安装目录。此选项会创建该目录并在 HKEY_LOCAL_MACHINE\ 注册表中创建一个条目。驱动程序的默认位置为 C:\Program Files\Tableau\Drivers。</td><td>诸如 <code>D:\Drivers</code> 之类的路径</td></tr><tr><td><code>INSTALLDIR</code></td><td><p>指定除默认目录之外的安装目录。</p><p>如果为安装位置指定自定义目录，并打算将未来的版本安装到此相同位置，您必须指定要安装到其中的版本特定子文件夹。否则，您必须先卸载以前的版本。</p><p>不支持将多个版本并排安装在同一子目录中。</p></td><td>诸如 <code>D:\Software\Tableau Bridge</code> 等路径。</td></tr><tr><td><code>SKIPAPPLICATIONLAUNCH</code></td><td>您可以将此选项设置为“1”，防止新应用程序在安装过程完成时自动打开。此选项适用于手动安装。此选项不适用于无提示安装，因为在使用该选项时 Tableau Bridge 不会自动打开。</td><td>1 = 是 <br>0 = 否（默认值）</td></tr><tr><td><code>STARTMENUSHORTCUT</code></td><td>在 Windows 的“开始”菜单上创建 Tableau Bridge 条目。</td><td>1 = 是（默认值） <br>0 = 否</td></tr></tbody></table>

## 卸载 Bridge

尽管在安装较新版本时不必卸载以前版本的 Bridge 客户端，但如果计算机上不再需要 Bridge 2018.2 及更高版本，您可以将其卸载。

卸载客户端的主要方法是通过 Windows 控制面板。

或者，您可以使用以下过程通过命令行卸载 Bridge。

1. 以管理员身份打开命令提示符。
2. 在 .exe 的安装位置中，运行以下命令：
    
    `tableau<installer_name>.exe /uninstall /quiet`

<!-- document id=54c1a2c64830ceb376ed6bf9b2f176c525d84552cc62d41a57d9cd6544440244 url=/tableau/next/zh-cn/online/activity_log_entity_snapshots_reference.md -->

[跳转到主要内容](#main-content)

# 实体快照参考

本主题介绍通过 Tableau Cloud Manager REST API 提供的实体快照表和字段。有关实体快照的详细信息，请参见[使用实体快照](https://help.tableau.com/v0.0/online/zh-cn/activity_log_entity_snapshots.htm)和[平台数据](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/platform_data.html)。

## 实体快照表

使用右侧按字母顺序排列的实体表列表，或使用 **ctrl/cmd-f** 直接转到您想到的关键字。

**注意：**时间戳以 ISO 8601 UTC 格式记录。

## 能力

`capabilities` 实体类型包含有关权限可授予或拒绝的能力的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>对能力允许用户执行的操作的描述。</td></tr><tr><td>display_name</td><td>字符串</td><td>向用户显示的能力的名称。</td></tr><tr><td>display_order</td><td>整数</td><td>能力在界面中列出的顺序。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>用于在代码中引用能力的名称或 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr></tbody></table>

## data\_connections

`data_connections` 实体类型包含有关工作簿和数据源使用的连接的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>authentication</td><td>字符串</td><td>用于数据连接的身份验证方法。</td></tr><tr><td>caption</td><td>字符串</td><td>显示在“数据”窗格中的连接的名称。</td></tr><tr><td>cloud_file_request_url</td><td>字符串</td><td>与数据连接关联的云文件的请求 URL。此值可以为 null。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>datasource_id</td><td>整数</td><td>拥有此数据连接的数据源的 ID。</td></tr><tr><td>db_subclass</td><td>字符串</td><td>数据库类的子类。例如，如果数据库类为 web-data-direct，则子类为 intuit-quickbook。</td></tr><tr><td>dbclass</td><td>字符串</td><td>数据连接的类型，例如 MySQL、PostgreSQL 或 SQL 代理。</td></tr><tr><td>dbname</td><td>字符串</td><td>此连接的数据库的名称。</td></tr><tr><td>has_extract</td><td>布尔值</td><td>指明数据连接是否为数据提取。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>keychain</td><td>字符串</td><td>YAML 格式的编码字符串。</td></tr><tr><td>luid</td><td>uuid</td><td>用于在 Tableau REST API 中标识连接的唯一标识符。Tableau 自动生成此值。</td></tr><tr><td>name</td><td>字符串</td><td>数据连接的唯一名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>创建数据连接的工作簿或数据源的 ID。</td></tr><tr><td>owner_type</td><td>字符串</td><td>创建数据连接的内容类型。工作簿或数据源。</td></tr><tr><td>password</td><td>布尔值</td><td>指示密码是否嵌入在所有者中。</td></tr><tr><td>port</td><td>整数</td><td>连接的端口号。</td></tr><tr><td>query_tagging_enabled</td><td>布尔值</td><td>指示针对此数据连接的查询是否使用有关其在 Tableau 中的来源的信息进行标记。</td></tr><tr><td>server</td><td>字符串</td><td>用于连接的服务器的名称。</td></tr><tr><td>site_id</td><td>整数</td><td>数据连接所在站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>state</td><td>字符串</td><td>发布状态。active 或 archived。</td></tr><tr><td>tablename</td><td>字符串</td><td>用于连接的数据库表的名称。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr><tr><td>username</td><td>字符串</td><td>用于连接的用户名。</td></tr><tr><td>using_remote_query_agent</td><td>布尔值</td><td>指示数据连接是否使用 Tableau Bridge。</td></tr></tbody></table>

## datasources

`datasources` 实体类型包含有关已发布数据源的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>certification_note</td><td>字符串</td><td>认证状态的解释。</td></tr><tr><td>certifier_details</td><td>字符串</td><td>认证者信息的快照。</td></tr><tr><td>certifier_user_id</td><td>整数</td><td>认证数据源的用户的 ID。如果数据源未经认证，则此值为 null。</td></tr><tr><td>connectable</td><td>布尔值</td><td>指示数据源是否支持通过 Data Server 进行连接。</td></tr><tr><td>content_version</td><td>整数</td><td>随每次发布更新的数据源的版本号。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>data_engine_extracts</td><td>布尔值</td><td>指示数据是否以 Tableau 数据提取的形式提供。</td></tr><tr><td>db_class</td><td>字符串</td><td>数据连接的类型，例如 Excel 或 Oracle。</td></tr><tr><td>db_name</td><td>字符串</td><td>数据库的名称或数据源的文件路径。</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述。</td></tr><tr><td>document_version</td><td>字符串</td><td>此记录的 .tds 文件的内部版本。</td></tr><tr><td>extracts_incremented_at</td><td>时间戳</td><td>上次增量数据提取刷新的日期和时间。</td></tr><tr><td>extracts_refreshed_at</td><td>时间戳</td><td>上次完全数据提取刷新的日期和时间。</td></tr><tr><td>first_published_at</td><td>时间戳</td><td>数据源首次发布的日期和时间。</td></tr><tr><td>hidden_name</td><td>字符串</td><td>从文件中提取的数据源的自动生成名称。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>incrementable_extracts</td><td>布尔值</td><td>指示是否允许对已发布数据源进行增量数据提取。</td></tr><tr><td>is_certified</td><td>布尔值</td><td>指示数据源是否经过认证。</td></tr><tr><td>is_hierarchical</td><td>布尔值</td><td>如果为 true，则数据源为分层（多维数据集）数据库。</td></tr><tr><td>last_published_at</td><td>时间戳</td><td>数据源上次发布的日期和时间。</td></tr><tr><td>luid</td><td>字符串</td><td>数据源的唯一标识符。</td></tr><tr><td>modified_by_user_id</td><td>整数</td><td>上次修改和发布数据源的用户的 ID。对于较旧的记录，此值与 owner_id 相同。</td></tr><tr><td>name</td><td>字符串</td><td>已发布数据源的名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>数据数据源所有者或上载者的用户 ID。</td></tr><tr><td>parent_type</td><td>字符串</td><td>数据源的父类型。datarole、workbook 或 null。</td></tr><tr><td>parent_workbook_id</td><td>整数</td><td>包含此数据源的工作簿的 ID。对于已发布数据源，此值为 null。</td></tr><tr><td>refreshable_extracts</td><td>布尔值</td><td>指示可刷新数据提取对于已发布数据源是否可用。</td></tr><tr><td>remote_query_agent_id</td><td>整数</td><td>用于远程查询的代理的 ID。</td></tr><tr><td>repository_url</td><td>字符串</td><td>URL 中使用的数据源的唯一名称。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号，每次发布时递增。</td></tr><tr><td>site_id</td><td>整数</td><td>与数据源关联的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>size</td><td>长整数</td><td>数据源的大小（以字节为单位）。</td></tr><tr><td>state</td><td>字符串</td><td>发布状态。active 或 archived。</td></tr><tr><td>table_name</td><td>字符串</td><td>与已发布数据源关联的表或工作表的名称。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr><tr><td>using_remote_query_agent</td><td>布尔值</td><td>指示对此数据源的查询是否使用远程代理。</td></tr></tbody></table>

## flows

`flows` 实体类型包含有关已发布流程的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>content_version</td><td>整数</td><td>随每次发布更新的流程的版本号。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>data_engine_extracts</td><td>布尔值</td><td>指示数据是否以 Tableau 数据提取的形式提供。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述。</td></tr><tr><td>document_version</td><td>字符串</td><td>此记录的 .tfl 文件的内部版本。</td></tr><tr><td>file_type</td><td>字符串</td><td>文件类型。.tfl 或 .tflx。</td></tr><tr><td>hidden</td><td>布尔值</td><td>指示是否从内容管理系统中隐藏流程。</td></tr><tr><td>id</td><td>整数</td><td>流程的唯一标识符。</td></tr><tr><td>is_deleted</td><td>布尔值</td><td>指示流程是否在回收站中。在恢复之前，已删除的流程对活动作业或用户请求不可见。</td></tr><tr><td>kind</td><td>字符串</td><td>流程的类型。</td></tr><tr><td>last_published_at</td><td>时间戳</td><td>上次发布流程的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>流程的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>已发布流程的名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>流程所有者或发布者的用户 ID。</td></tr><tr><td>project_id</td><td>整数</td><td>与流程关联的项目的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>与流程关联的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>size</td><td>长整数</td><td>流程文件的大小（以字节为单位）。</td></tr><tr><td>state</td><td>字符串</td><td>流程的状态。active 或 archived。默认值为 active。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## group\_users

`group_users` 实体类型包含有关分配到组的用户的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>group_id</td><td>整数</td><td>组的 ID。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>site_id</td><td>整数</td><td>组用户的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>user_id</td><td>整数</td><td>用户的 ID。</td></tr></tbody></table>

## groups

`groups` 实体类型包含有关用户组的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>domain_id</td><td>整数</td><td>与组关联的域的 ID。</td></tr><tr><td>external_user_enabled</td><td>布尔值</td><td>指示是否可以将外部用户添加到组。</td></tr><tr><td>grant_license_mode</td><td>字符串</td><td>指示何时向组成员授予许可证。ON_SYNC 或 ON_LOGIN。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>last_synchronized</td><td>时间戳</td><td>Active Directory 组上次同步的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>与站点 ID 组合时唯一的标识符。</td></tr><tr><td>minimum_site_role</td><td>字符串</td><td>为 Active Directory 组的成员分配的最低站点角色。</td></tr><tr><td>minimum_site_role_id</td><td>整数</td><td>组的最低站点角色的 ID。</td></tr><tr><td>name</td><td>字符串</td><td>组的名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有组的用户的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>组所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>system</td><td>布尔值</td><td>指示组是由 Tableau 还是用户创建的。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## next\_gen\_permissions

`next_gen_permissions` 实体类型包含有关分配给用户、组和组集的权限的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>authorizable_id</td><td>整数</td><td>为其指定权限的内容的 ID。</td></tr><tr><td>authorizable_type</td><td>字符串</td><td>为其指定权限的内容的类型。“Project”、“Workbook”、“DataSource”、“View”或“NamedResource”。</td></tr><tr><td>capability_id</td><td>整数</td><td>被授予或拒绝的能力的 ID。</td></tr><tr><td>grantee_id</td><td>整数</td><td>被授予权限的用户、组或组集的 ID。</td></tr><tr><td>grantee_type</td><td>字符串</td><td>被授权者的类型。User、Group 或 GroupAND。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>permission</td><td>整数</td><td>权限级别，指示是向用户或组授予还是拒绝能力。值 1 = 授予组，2 = 拒绝组，3 = 授予用户，4 = 拒绝用户。较高的值优先。例如，特定于用户的授予可以覆盖组级别的拒绝。</td></tr><tr><td>site_id</td><td>整数</td><td>权限所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr></tbody></table>

## projects

`projects` 实体类型包含有关用于组织内容的项目的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>admin_insights_enabled</td><td>布尔值</td><td>指明项目是否为“在线管理见解”项目。</td></tr><tr><td>controlled_permissions_enabled</td><td>布尔值</td><td>指示是否在项目级别控制权限。</td></tr><tr><td>controlling_permissions_project_id</td><td>整数</td><td>控制此项目权限的祖先项目的 ID。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>description</td><td>字符串</td><td>项目的描述。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>luid</td><td>uuid</td><td>记录的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>项目的名称。</td></tr><tr><td>nested_projects_permissions_included</td><td>布尔值</td><td>指示是否在项目级别控制嵌套项目的权限。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有项目的用户的 ID。</td></tr><tr><td>parent_project_id</td><td>整数</td><td>父项目的 ID。对于顶层项目，此值为 null。</td></tr><tr><td>site_id</td><td>整数</td><td>包含项目的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>special</td><td>整数</td><td>指示这是否是系统创建的项目，例如“默认”项目。对于系统创建的项目，值为 1，否则，值为 null。</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。active 或 inactive。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## projects\_contents

`projects_contents` 实体类型包含有关项目中存储的内容的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>content_id</td><td>整数</td><td>项目中存储的内容的 Id，用 project_id 表示。与 content_type 结合使用以唯一标识内容。</td></tr><tr><td>content_type</td><td>字符串</td><td>项目中的内容类型。与 content_id 结合使用以唯一标识内容。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>project_id</td><td>整数</td><td>与记录关联的项目的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>与记录关联的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr></tbody></table>

## published\_connection\_revision\_tables

`published_connection_revision_tables` 实体类型包含有关与已发布连接修订关联的表的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>published_connection_table_luid</td><td>uuid</td><td>关联的已发布连接表的 ID。</td></tr><tr><td>revisable_properties</td><td>jsonb</td><td>用户可以修订的属性。</td></tr><tr><td>revision_id</td><td>整数</td><td>关联修订的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>关联站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>system_properties</td><td>jsonb</td><td>系统元数据。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## published\_connection\_revisions

`published_connection_revisions` 实体类型包含有关已发布连接的修订的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>luid</td><td>uuid</td><td>站点内修订的唯一标识符。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有修订的用户的 ID。</td></tr><tr><td>published_at</td><td>无时区的时间戳</td><td>此修订的发布日期和时间。</td></tr><tr><td>published_connection_id</td><td>整数</td><td>关联的已发布连接的 ID。</td></tr><tr><td>revisable_properties</td><td>jsonb</td><td>用户可以修订的属性。</td></tr><tr><td>revisable_properties_updated_at</td><td>无时区的时间戳</td><td>可修订属性的上次更新日期和时间。</td></tr><tr><td>revisable_properties_version</td><td>整数</td><td>每次更新可修订属性时递增的数字。</td></tr><tr><td>revision_type</td><td>整数</td><td>修订的类型。值 0 = 草稿、1 = 活动、2 = 历史。</td></tr><tr><td>site_id</td><td>整数</td><td>关联站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>system_properties</td><td>jsonb</td><td>系统元数据。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr><tr><td>version_number</td><td>整数</td><td>修订的递增版本号。</td></tr></tbody></table>

## published\_connection\_tables

`published_connection_tables` 实体类型包含有关与已发布连接关联的表的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>description</td><td>字符串</td><td>已发布连接表的描述。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>luid</td><td>uuid</td><td>站点内表的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>已发布连接表的名称。</td></tr><tr><td>published_connection_id</td><td>整数</td><td>关联的已发布连接的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>关联站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## published\_connections

`published_connections` 实体类型包含有关已发布连接的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>activated</td><td>布尔值</td><td>指示已发布连接是否可供使用。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>description</td><td>字符串</td><td>已发布连接的描述。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>luid</td><td>uuid</td><td>站点内连接的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>已发布连接的名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有连接的用户的 ID。</td></tr><tr><td>project_id</td><td>整数</td><td>关联项目的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>关联站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## schedules

`schedules` 实体类型包含有关用于运行任务的计划的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>actionable</td><td>布尔值</td><td>指示计划是否可操作。</td></tr><tr><td>active</td><td>布尔值</td><td>指示计划是否处于活动状态。如果为 false，则触发计划时不运行任何任务。</td></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>day_of_month_mask</td><td>整数</td><td>一个编码值，指示计划在一个月中的哪几天运行。将值转换为二进制进行解读，其中每个二进制位代表一个月中的某一天。值 1 = 第一天，10 = 第二天，100 = 第三天，依此类推。</td></tr><tr><td>day_of_week_mask</td><td>整数</td><td>一个编码值，指示计划在一周中的哪几天运行。将值转换为二进制进行解读，其中每个二进制位代表一周中的某一天。值 1 = 星期日、10 = 星期一、100 = 星期二、1000 = 星期三、10000 = 星期四、100000 = 星期五、1000000 = 星期六。</td></tr><tr><td>defined_by</td><td>整数</td><td>创建计划的机制类型，例如 0 表示系统管理员，1 表示自助服务。</td></tr><tr><td>end_at_minute</td><td>整数</td><td>计划在其频率周期内停止触发的分钟。</td></tr><tr><td>end_schedule_at</td><td>无时区的时间戳</td><td>计划不再触发的日期和时间。</td></tr><tr><td>hidden</td><td>布尔值</td><td>指示计划在界面中是否可见。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>linked_task_enabled</td><td>布尔值</td><td>指示用户是否可以按此计划创建链接任务。</td></tr><tr><td>luid</td><td>uuid</td><td>REST API 中使用的计划的唯一标识符。</td></tr><tr><td>minute_interval</td><td>整数</td><td>计划在启动后重新触发的时间间隔。由 schedule_type、end_at_minute 或 end_schedule_at 定义。</td></tr><tr><td>name</td><td>字符串</td><td>计划的名称。</td></tr><tr><td>priority</td><td>整数</td><td>计划的优先级，从 1（最高）到 100（最低）。</td></tr><tr><td>run_next_at</td><td>无时区的时间戳</td><td>计划下次触发的日期和时间。</td></tr><tr><td>schedule_type</td><td>整数</td><td>计划的频率。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduled_action</td><td>整数</td><td>分配给计划的任务类型。值 0 = 数据提取、1 = 订阅、2 = Active Directory 同步、3 = 自动刷新数据提取，4 = 流程。</td></tr><tr><td>serial_collection_id</td><td>整数</td><td>用于防止同时处理链接作业的 ID。具有相同 serial_collection_id 的作业不能同时运行。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>start_at_minute</td><td>整数</td><td>计划在其频率周期内开始的分钟。例如，对于每日计划，这是午夜过后的分钟数。</td></tr><tr><td>timezoneid</td><td>字符串</td><td>计划的 IANA 时区，例如 America/Los_Angeles。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## subscriptions

`subscriptions` 实体类型包含有关为用户配置的订阅的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>attach_image</td><td>布尔值</td><td>指示是否将图像附加到订阅电子邮件。</td></tr><tr><td>attach_pdf</td><td>布尔值</td><td>指示是否将 PDF 附加到订阅电子邮件。</td></tr><tr><td>content_has_user_references</td><td>布尔值</td><td>指示订阅内容是否包括用户引用。Null 表示订阅尚未运行。</td></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>creator_id</td><td>整数</td><td>创建订阅的用户的 ID。</td></tr><tr><td>data_condition_type</td><td>字符串</td><td>触发订阅的数据条件的类型。默认值为 Always。其他值包括 DataPresent、Constant、Band 等。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>is_refresh_extract_triggered</td><td>布尔值</td><td>指示订阅是否由数据提取刷新触发。</td></tr><tr><td>last_sent</td><td>无时区的时间戳</td><td>上次发送订阅的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>REST API 中使用的订阅的唯一标识符。</td></tr><tr><td>schedule_id</td><td>整数</td><td>触发订阅的计划的 ID。</td></tr><tr><td>site_id</td><td>整数</td><td>订阅所在站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>subject</td><td>字符串</td><td>订阅的主题行或描述。</td></tr><tr><td>subscription_message_id</td><td>整数</td><td>订阅消息的的 ID。</td></tr><tr><td>target_id</td><td>整数</td><td>所订阅内容的 ID。</td></tr><tr><td>target_type</td><td>字符串</td><td>所订阅内容的类型。View 或 Workbook。</td></tr><tr><td>user_id</td><td>整数</td><td>接收订阅的用户的 ID。</td></tr></tbody></table>

## system\_users

`system_users` 实体类型包含有关系统级用户帐户的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>admin_level</td><td>整数</td><td>指示用户是否为系统管理员。值 10 = 系统管理员，0 = 不是系统管理员。</td></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>custom_display_name</td><td>布尔值</td><td>指示是否防止友好名称被 Active Directory 覆盖。</td></tr><tr><td>domain_id</td><td>整数</td><td>用户的域的 ID。</td></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址。</td></tr><tr><td>failed_login_attempts</td><td>整数</td><td>自上次成功登录以来失败登录尝试的次数。</td></tr><tr><td>force_password_update</td><td>布尔值</td><td>指示用户是否必须在下次登录时重置其密码。</td></tr><tr><td>friendly_name</td><td>字符串</td><td>界面中用于引用用户的友好名称。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>last_failed_login</td><td>无时区的时间戳</td><td>用户上次登录失败的日期和时间。</td></tr><tr><td>last_password_update</td><td>无时区的时间戳</td><td>用户上次更新其密码的日期和时间。</td></tr><tr><td>name</td><td>字符串</td><td>用户名。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## taggings

`taggings` 实体类型包含有关标记和标记内容之间的关系的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>site_id</td><td>整数</td><td>标记所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>tag_id</td><td>整数</td><td>标记的 ID。</td></tr><tr><td>taggable_id</td><td>整数</td><td>标记项的 ID。</td></tr><tr><td>taggable_type</td><td>字符串</td><td>所标记的项的类型。此值标识要联接到哪个表。</td></tr><tr><td>user_id</td><td>整数</td><td>拥有标记的用户的 ID。</td></tr></tbody></table>

## tags

`tags` 实体类型包含有关用于标记内容的标记的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>标记的名称。</td></tr><tr><td>site_id</td><td>整数</td><td>标记所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## tasks

`tasks` 实体类型包含有关计划任务的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指示任务是否处于活动状态。如果为 false，则触发计划时不运行任务。</td></tr><tr><td>args</td><td>字符串</td><td>格式为 YAML 的任务参数。</td></tr><tr><td>consecutive_failure_count</td><td>整数</td><td>此任务的失败次数。</td></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>creator_id</td><td>整数</td><td>创建任务的用户的 ID。</td></tr><tr><td>historical_queue_time</td><td>整数</td><td>任务的历史排队时间（以秒为单位）。</td></tr><tr><td>historical_run_time</td><td>整数</td><td>任务的历史运行时间（以秒为单位）。</td></tr><tr><td>id</td><td>整数</td><td>任务的唯一标识符。</td></tr><tr><td>last_success_completed_at</td><td>无时区的时间戳</td><td>任务上次成功完成的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>REST API 中使用的任务的唯一标识符。</td></tr><tr><td>obj_id</td><td>整数</td><td>与任务关联的工作簿或数据源的 ID。</td></tr><tr><td>obj_type</td><td>字符串</td><td>与任务关联的对象的类型。工作簿或数据源。与 obj_id 结合使用以唯一标识对象。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，其中 0 为最高优先级，10 为默认值。</td></tr><tr><td>run_count</td><td>整数</td><td>自添加此字段以来任务已运行的次数。对于在字段存在之前创建的任务，此值可能不准确。</td></tr><tr><td>schedule_id</td><td>整数</td><td>链接到任务的计划的 ID。当计划的 run_next_at 时间到达时，链接的任务将运行。</td></tr><tr><td>site_id</td><td>整数</td><td>与任务关联的站点的 ID。用于特定于站点的任务。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>state</td><td>整数</td><td>任务的当前状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>有关任务的附加信息。</td></tr><tr><td>title</td><td>字符串</td><td>有关任务的附加信息。</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## users

`users` 实体类型包含有关站点用户的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>login_at</td><td>无时区的时间戳</td><td>用户最近登录的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>记录的唯一标识符。</td></tr><tr><td>site_id</td><td>整数</td><td>用户所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>site_role_id</td><td>整数</td><td>用户的站点角色的 ID。值 0 = SiteAdministrator，1 = SupportUser，2 = Publisher，3 = Interacto ，4 = ViewerWithPublish，5 = Viewer，6 = UnlicensedWithPublish，7 = Guest，8 = Unlicensed 以及 9 = BasicUser。</td></tr><tr><td>system_admin_auto</td><td>布尔值</td><td>指示用户是否为未明确分配给站点的系统管理员。</td></tr><tr><td>system_user_id</td><td>整数</td><td>与此用户关联的系统用户的 ID。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr></tbody></table>

## views

`views` 实体类型包含有关工作簿中的视图的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义的工作表描述。</td></tr><tr><td>created_at</td><td>无时区的时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述。</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段。</td></tr><tr><td>first_published_at</td><td>无时区的时间戳</td><td>视图首次发布的日期和时间。此值在包含视图的工作簿后重新发布时不会更改。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>index</td><td>整数</td><td>视图在其工作簿中的索引号。</td></tr><tr><td>is_deleted</td><td>布尔值</td><td>指示视图是否位于回收站中。</td></tr><tr><td>luid</td><td>uuid</td><td>记录的唯一标识符。</td></tr><tr><td>name</td><td>字符串</td><td>视图的名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有视图的用户的 ID。</td></tr><tr><td>repository_url</td><td>字符串</td><td>URL 中使用的视图的唯一名称。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。值从 1.0 开始，并在每次重新发布时按 0.1 递增。</td></tr><tr><td>sheet_id</td><td>字符串</td><td>工作表的标识符。</td></tr><tr><td>sheettype</td><td>字符串</td><td>工作表的类型。story、dashboard 或 view。</td></tr><tr><td>site_id</td><td>整数</td><td>视图所属的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>state</td><td>字符串</td><td>视图的状态。active 或 disabled。</td></tr><tr><td>title</td><td>字符串</td><td>从工作簿 .twb 文件中提取的工作表的标题。</td></tr><tr><td>updated_at</td><td>无时区的时间戳</td><td>记录的上次更新日期和时间。</td></tr><tr><td>workbook_id</td><td>整数</td><td>包含视图的工作簿的 ID。</td></tr></tbody></table>

## workbooks

`workbooks` 实体类型包含有关已发布工作簿的信息。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td>content_version</td><td>整数</td><td>随每次发布更新的工作簿的版本号。</td></tr><tr><td>created_at</td><td>时间戳</td><td>此记录的创建日期和时间。</td></tr><tr><td>data_engine_extracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取。</td></tr><tr><td>default_view_index</td><td>整数</td><td>指明默认情况下是否显示视图。</td></tr><tr><td>display_tabs</td><td>布尔值</td><td>如果为 true，则工作表在工作簿中显示为标签。</td></tr><tr><td>document_version</td><td>字符串</td><td>保存工作簿时使用的文档描述的版本。</td></tr><tr><td>first_published_at</td><td>时间戳</td><td>工作簿首次发布的日期和时间。重新发布工作簿时，此值不会更改。</td></tr><tr><td>id</td><td>整数</td><td>记录的唯一标识符。</td></tr><tr><td>incrementable_extracts</td><td>布尔值</td><td>指示此工作簿是否可以进行增量数据提取刷新。</td></tr><tr><td>is_deleted</td><td>布尔值</td><td>指示工作簿是否位于回收站中。在恢复之前，已删除的工作簿对活动作业或用户请求不可见。</td></tr><tr><td>last_published_at</td><td>时间戳</td><td>工作簿上次发布的日期和时间。</td></tr><tr><td>luid</td><td>uuid</td><td>记录的唯一标识符。</td></tr><tr><td>modified_by_user_id</td><td>整数</td><td>上次修改和发布工作簿的用户的 ID。对于较旧的记录，此值与 owner_id 相同。</td></tr><tr><td>name</td><td>字符串</td><td>工作簿名称。</td></tr><tr><td>owner_id</td><td>整数</td><td>拥有此工作簿的用户的 ID。</td></tr><tr><td>published_all_sheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。</td></tr><tr><td>refreshable_extracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新。</td></tr><tr><td>repository_url</td><td>字符串</td><td>URL 中使用的工作簿的唯一名称。</td></tr><tr><td>revision</td><td>字符串</td><td>工作簿的版本号。值从 1.0 开始，并在每次重新发布时按 0.1 递增。</td></tr><tr><td>site_id</td><td>整数</td><td>发布工作簿的站点的 ID。</td></tr><tr><td>site_luid</td><td>字符串</td><td>站点的 LUID。</td></tr><tr><td>size</td><td>长整型</td><td>工作簿的大小（以字节为单位）。</td></tr><tr><td>thumb_user</td><td>整数</td><td>用于生成缩略图的用户的 ID。除非指定，否则此值为 null。</td></tr><tr><td>updated_at</td><td>时间戳</td><td>记录的上次更新日期和时间。</td></tr><tr><td>view_count</td><td>整数</td><td>与此工作簿关联的视图的总数。</td></tr></tbody></table>

<!-- document id=116082cc4ecf2c74e55971ef2e276f6a7adc9866b20b956e343c54eaec972471 url=/tableau/next/zh-cn/online/to_customer_managed_encryption_keys.md -->

[跳转到主要内容](#main-content)

# 客户管理的加密密钥

客户管理的加密密钥允许您使用客户管理的站点特定密钥加密站点数据提取，从而为您提供额外的安全性。Salesforce Key Management System (KMS) 实例为在站点上启用加密的任何人存储特定于站点的默认加密密钥。

若要使用外部密钥管理系统而不是 Salesforce 的系统，请参见[为数据提取加密密钥使用外部 KMS](https://help.tableau.com/v0.0/online/zh-cn/to_external_kms_extracts.htm)。

## 加密过程

加密过程遵循密钥层次结构。首先，Tableau Cloud 对数据提取进行加密。接着，Tableau Cloud KMS 检查其密钥缓存以查找合适的数据密钥。如果未找到密钥，则由 KMS GenerateDataKey API 使用与该密钥关联的密钥策略授予的权限生成一个密钥。KMS 使用 CMK 生成数据密钥，并将明文副本和加密副本返回到 Tableau Cloud。Tableau Cloud 使用数据密钥的明文副本对数据进行加密，并将密钥的加密副本与加密数据一起存储。

## 启用加密

启用加密后，Tableau Cloud 将为您站点上的每个数据提取创建一个作业以进行加密。这些作业的优先级最低。任何先前设置的数据提取作业在加密的数据提取作业之前运行。当有额外资源时，这些作业无需刷新即可对所有数据提取运行加密。

##### 若要启用加密，请完成以下步骤。

1. 登录到您的 Tableau Cloud 站点。
2. 在左侧导航窗格中选择“设置”
3. 选择“安全”选项卡。
4. 在“数据提取加密”部分下，选择“加密数据提取”。
5. 选择“使用 Salesforce KMS”。
6. 阅读有关启用加密的警告，然后选择**“启用加密”**。

**注意：**启用加密后，无法将其禁用。如果在某个时候您不再拥有 Tableau+、Tableau Enterprise 或 Advanced Management，则处理加密的数据提取仍然有效，但您将无法管理密钥。

## 生成和轮换密钥

您可以按公司的计划轮换密钥以提高安全性。轮换密钥会在原始密钥的基础上创建一个密钥。

**注意：**如果刷新率较长或数据提取未刷新，则使用最后一个活动密钥而不是新密钥对数据提取进行加密。

##### 若要轮换密钥，请完成以下步骤。

1. 选择**“安全”**选项卡。
2. 在**“数据提取加密”**下，选择**“生成密钥”**。

## 禁用加密

启用加密后，无法将其禁用。如果在某个时候您不再拥有 Tableau+、Tableau Enterprise 或 Advanced Management，则处理加密的数据提取仍然有效，但您将无法管理密钥。

## 删除密钥（不可恢复的数据提取）

> [!IMPORTANT]
> 
> **警告：**如果删除密钥，则无法重新访问数据提取。

只有在发生严重的安全事件时才删除密钥。删除密钥后，您将无法访问数据提取。与已删除密钥相关的任何数据提取都将永久不可用。

##### 若要删除密钥，请完成以下步骤。

1. 选择**“安全”**选项卡。
2. 在**“数据提取****加密”**下的**“操作”**中，选择**“删除密钥...”**。
3. 在文本字段中，输入**“删除密钥”**。
    
    > [!IMPORTANT]
    > 
    > **警告：**删除密钥后，您将无法访问数据提取。只有在发生严重的安全事件时才删除密钥。
4. 选择**“删除密钥”**或**“取消”**。

## 审核日志

您可以下载审核日志以查看对您的密钥执行的操作，包括创建、轮换、删除、解密和下载日志。审核日志还包括以下信息。

- 日期和时间
- 事件类型
- 成功或失败
- 进行调用的服务的认证身份
- 用户
- 密钥名称

## 常见问题 (FAQ)

问：

如果我不续订 Advanced Management 许可证会怎样？

答：

如果您不续订 Advanced Management 许可证，客户管理的加密密钥功能会自动更改为禁用状态。

问：

如果我不再是 Tableau Cloud 客户，我的关键数据会发生什么情况？

答：

根据 Tableau Cloud 数据策略，在删除您的关键数据之前有 90 天的等待期。

问：

如果我搬到另一个 Tableau Cloud 区域会发生什么？

答：

关键数据位于与您的 Tableau Cloud pod 位于相同区域的 Salesforce (KMS) 实例中。如果您想搬到另一个区域，您必须先关闭该功能并运行您的数据提取。

<!-- document id=3e34b2cb617c2d7e9810976878901458c37882412ee1258b2f481c21bc1f9c9b url=/tableau/next/zh-cn/online/users_import.md -->

[跳转到主要内容](#main-content)

# 导入用户

若要自动完成向站点添加用户的过程，您可以创建一个包含用户信息的 CSV 文件，然后导入该文件。导入 CSV 文件时，您还可指定用户的身份验证类型。

本主题适用于站点管理员，讨论如何将用户导入特定站点。有关如何以云管理员身份在 Tableau Cloud Manager 中导入租户级别的用户的信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

**注意：**本主题包含导入步骤，并且假定您已创建了该 CSV 文件。如果您尚未创建该文件，请参见 [CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)，以查看文件格式要求和导入选项的列表。

## 从 CSV 文件添加用户

1. 在登录 Tableau Cloud 站点时，选择**“用户”**。
2. 单击“添加用户”，然后单击“从文件导入用户”。
    
    ![站点管理员可以通过电子邮件添加用户或从文件导入。](/tableau/next/zh-cn/online/zh-cn/Img/users_add_online.png)
    
    “导入用户”对话框中可用的选项取决于用户登录站点的方式。
3. 如果您尚未在站点上创建或启用身份验证配置，请跳至下一步。
    
    如果已在站点上创建或启用了身份验证配置，您可以为新用户选择一种身份验证方法。
    
    - 如果您已创建并启用 Google、OIDC、SAML 或 Salesforce 身份验证，并希望导入的用户通过该外部身份提供程序 (IdP) 登录 Tableau Cloud，请选择身份验证方法。
    - 如果您希望这些用户拥有默认用户名（电子邮件地址）和密码身份验证，则选择“带有 MFA 的 Tableau”。
4. 对于“文件名”，单击“浏览”，导航到 CSV 文件，并单击**“打开”**。
5. 若要查看帐户特定信息，请选择“查看详细信息”。
    
    若要继续，请单击“导入用户”，然后在最后的对话框中单击“退出”。
    
    如果用户在 Tableau Cloud 站点中已存在，并且导入文件为用户定义了其他站点角色，则他们将获得 CSV 文件中定义的新站点角色，即使该站点角色比其当前站点角色限制性更大。这包括现有站点管理员。

<!-- document id=df8f2c4f21d5b9497f1f0b67d18b18d116180ac45516926cd574eb5047c12057 url=/tableau/next/zh-cn/online/config_oauth_sfdc_cdp_online.md -->

[跳转到主要内容](#main-content)

# 将 Tableau Cloud Web 制作连接到 Salesforce Data Cloud

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

Salesforce Data Cloud 连接器于 2023 年 10 月在 Tableau Cloud 中发布。此连接器将 Tableau 无缝连接到 Data Cloud，并且适用于 Tableau Desktop、Tableau Cloud、Tableau Server 和 Tableau Prep。与旧版 CDP 连接器相比，Salesforce Data Cloud 连接器更易于连接，显示对象标签而不是 API 名称，并由加速查询提供支持。

**注意**：Data Cloud 以前称为 Customer Data Platform (CDP)。Customer Data Platform 连接器于 2023 年 10 月弃用，自 2024 年 6 月起在 Tableau Cloud 中不再可用于新连接，并且自 2024 年 10 月及以后将从 Tableau Cloud 中完全移除。必须使用 Salesforce Data Cloud 连接器重新创建使用 CDP 连接器的现有资产。

通过完成以下步骤，将 Tableau Cloud Web 制作连接到 Customer Data Platform。

1. 在“浏览”页面中，选择“新建” ，然后选择“工作簿”。或者选择“数据”菜单，然后选择“新建数据源” 。
2. 在“连接到数据”窗口中，选择“连接器”选项卡。
3. 选择“Salesforce Data Cloud”。
4. 出现提示时登录并允许访问。
5. 选择“数据空间”。数据空间表示 Data Cloud 中数据的逻辑隔离。在 Salesforce 6 月 23 日版发布之前，数据空间并不存在。
6. 使用“对象”按 Data Cloud 对象的类型进行筛选，或选择“所有对象”。

<!-- document id=443785f15a7dc14aa40c672e0ad47c041a206a0a66616a21f75640ee795d15b8 url=/tableau/next/zh-cn/online/slack_admin.md -->

[跳转到主要内容](#main-content)

# 将 Tableau 与 Slack 工作区集成

从版本 2021.3 开始，Tableau Server 和 Tableau Cloud 支持与适用于 Slack 的 Tableau 应用程序集成，这样您的团队就可以在他们工作的 Slack 工作区中，协作共享 Tableau 快照、搜索 Tableau 内容，并接收有关 Tableau 数据的通知。

适用于 Slack 的 Tableau 应用程序可让您将 Tableau 站点与 Slack 工作区连接起来。启用后，Tableau 用户可以：

- 在团队成员与他们共享内容、在评论中提及他们或数据达到数据驱动型通知中的指定阈值时在 Slack 中看到通知。如果 Tableau Cloud 中的站点管理员或 Tableau Server 中的服务器管理员在站点上启用通知，用户可以通过配置他们的[帐户设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm)来控制他们在 Slack 中接收哪些通知。
- 在将 Tableau URL 粘贴到 Slack 时查看可视化项预览，从而允许用户直接在 Slack 中与上下文共享与数据相关的内容。
- 在 Slack DM 和频道中搜索 Tableau 视图或工作簿。
- 从适用于 Slack 的 Tableau 应用程序访问最近的内容和收藏夹。

有关详细信息，请参见[使用适用于 Slack 的 Tableau 应用程序接收通知、搜索和共享](https://help.tableau.com/current/pro/desktop/zh-cn/slack_tableau.htm)。

**注意：**如果您的站点关闭了通知功能，某些通知首选项可能不可用。例如，如果“用户可见性”设置设置为“受限”，则通知将被关闭。有关详细信息，请参见[站点设置参考](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm)和[管理站点用户可见性](https://help.tableau.com/v0.0/online/zh-cn/user_visibility.htm#user)。

若要将 Slack 与 Tableau 站点集成，您需要采取几个必要的配置步骤，其中一些步骤在 Tableau 站点中执行，一些步骤在想要连接的 Slack 工作区中运行。本概述为 Tableau Cloud 上的 Tableau 站点管理员或 Tableau Server 上的 Tableau Server 管理员以及 Slack 工作区管理员概述了这些步骤。

**要求**

在 Slack 中启用 Tableau 需要 Slack 工作区管理员，以及 Tableau Cloud 中的 Tableau 站点管理员或 Tableau Server 中的 Tableau Server 管理员。

## 将 Tableau Cloud 站点连接到 Slack 工作区

Tableau Cloud 站点管理员可以将一个或多个 Tableau Cloud 站点连接到单一 Slack 工作区。但是，您无法将一个 Tableau 站点连接到多个 Slack 工作区。连接包括以下任务：

- **Tableau 站点管理员**：通过 Tableau 的站点设置请求对 Slack 工作区的权限。
- **Slack 工作区管理员**：通过批准 Tableau 管理员请求访问 Slack 工作区的权限，将适用于 Slack 的 Tableau 应用程序添加到 Slack 工作区。
- **Tableau 站点管理员**：将您的 Tableau 站点连接到 Slack。

### 步骤 1：请求对 Slack 工作区的权限

**Tableau 站点管理员**

1. 登录到要连接到 Slack 的站点。在站点的**“设置”**页面上，选择**“集成”**选项卡。  
    ![Tableau 站点设置中的“集成”选项卡](/tableau/next/zh-cn/online/zh-cn/Img/slack_settings.png)
2. 在**“Slack 连接”**下，选择**“连接到 Slack”**。  
    按照提示登录到您的 Slack 工作区。
3. 请求安装适用于 Slack 的 Tableau 应用程序。此请求发送给 Slack 工作区管理员。如果需要，您可以添加一条发送给工作区管理员的消息。
4. 选择**“提交”**。
    
    Slack 管理员将收到请求通知。有关此过程的详细信息，请参见 Slack 文档中的 [Slack 管理管理员指南](https://slack.com/resources/slack-for-admins/app-management)。
    
    Slackbot（Slack 的通知中心）会在您的请求获得批准时通知您。

### 步骤 2：将适用于 Slack 的 Tableau 应用程序添加到 Slack 工作区

**Slack 工作区管理员**

在“Manage Apps”（管理应用程序）中批准 Tableau 站点管理员提出的请求：将适用于 Slack 的 Tableau 应用程序添加到 Slack 工作区。

有关详细信息，请参见 Slack 文档中的[Slack 管理管理员指南](https://slack.com/resources/slack-for-admins/app-management)。

### 步骤 3：将您的 Tableau 站点连接到 Slack

**Tableau 站点管理员**

在 Slack 工作区管理员批准 Tableau 应用程序后，Tableau 管理员可以完成应用程序与 Tableau 站点的连接。

1. 从站点的**“设置”**页面上，选择**“集成”**选项卡。  
    ![Tableau 站点设置中的“集成”选项卡](/tableau/next/zh-cn/online/zh-cn/Img/slack_settings.png)
2. 在**“Slack 连接”**下，选择**“连接到 Slack”**。
3. 按照提示登录到您的 Slack 工作区。
4. 选择**“允许”**以授予您的 Tableau 站点访问 Slack 工作区的权限。

Tableau 站点和 Slack 工作区现已连接。

## 断开 Tableau 站点与 Slack 的连接

作为站点管理员，您可以通过在站点设置的**“集成”**选项卡中选择**“从 Slack 断开连接”**来断开 Tableau 站点与 Slack 工作区的连接。用户将在一段时间内继续收到通知。您在步骤 2 中添加的 OAuth 客户端信息将保留，如果需要，可用于连接到新工作区。

作为 Slack 用户，您可以通过从适用于 Slack 的 Tableau 应用程序的 **“主页”**选项卡中选择**“断开与 Tableau 的连接”** 来断开与 Slack 的连接。

## 更新适用于 Slack 的 Tableau 应用程序

当适用于 Slack 的 Tableau 应用程序的新版本可用时，Tableau 建议更新该应用程序以保持应用程序性能并使用新功能。

若要更新适用于 Slack 的 Tableau 应用程序，请执行以下操作:

1. 从站点的**“设置”**页面上，选择**“集成”**选项卡。  
    ![Tableau 站点设置中的“集成”选项卡](/tableau/next/zh-cn/online/zh-cn/Img/slack_settings.png)
2. 在**“Slack 连接”**下，选择**“连接到 Slack”**。
3. 选择**“更新”**。

**注意：**任何 Tableau 管理员应用的应用程序更新都会影响连接到同一工作区的所有 Tableau 站点。

## 适用于 Slack 的 Tableau 应用程序疑难解答

[为您的 Slack 工作区管理应用程序批准](https://slack.com/help/articles/222386767-Manage-app-approval-for-your-workspace)是最佳实践。但是，如果您的 Slack 工作区允许非管理员用户移除应用程序，则用户可能会为站点移除适用于 Slack 的 Tableau 应用程序。在这种情况下，其他用户将看到适用于 Slack 的 Tableau 应用程序，但其功能无法按预期工作。为了解决此问题，请让您的 Slack 管理员卸载并重新安装适用于 Slack 的 Tableau 应用程序。然后，让您的管理员按照步骤将 Slack 与您的 Tableau 站点连接起来。

如果 Tableau 链接的预览未在 Slack 中展开，请确认 **files:read** 令牌对于 [Slack 权限范围](https://api.slack.com/scopes)允许 Tableau 应用程序中的**机器人**。

<!-- document id=343eb8829d9744eefcd27cef4bb626757c143cb068f125c75d8b4d4c11a88d2a url=/tableau/next/zh-cn/online/data_stories_create.md -->

[跳转到主要内容](#main-content)

# 将 Tableau 数据故事添加到仪表板

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

[创建仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm)后，您可以将“数据故事”对象添加到仪表板，以显示以自然语言编写的可视化项的相关见解。目前，Tableau 数据故事仅以英文编写，并在 Tableau Cloud、Tableau Server（版本 2023.1 及更高版本）和 Tableau Desktop 中提供。创建数据故事时没有数据大小限制。但是，如果它试图分析大量数据，故事生成会在 45 秒后超时。我们建议使用具有 1,000 个或更少数据点的可视化项的数据故事。

**注意：**Tableau 数据故事会在弹出窗口中打开，因此请务必允许弹出窗口。如果您使用全屏模式，则数据故事可以在新标签页中打开。

1. 将“数据故事”对象拖到您的 Tableau 仪表板中。将工作表添加到仪表板以使用 Tableau 数据故事（如果尚未这样做）。  
    ![仪表板编辑窗格中带有打开书本图标的“数据故事”对象](/tableau/next/zh-cn/online/zh-cn/Img/data_story_object.png)
2. 在“数据故事”对话框中，首先选择要编写的工作表来配置您的故事。当您单击**“下一步”**时，Tableau 会将所有关联的工作簿数据发送到您登录的 Tableau Cloud 或 Tableau Server 实例。  
    ![使用选项配置窗格以选择要编写的工作表](/tableau/next/zh-cn/online/zh-cn/Img/data_story_configure_view.png)
3. 选择要包含在故事中的维度和度量。  
    ![使用选项配置窗格，以拖放要包含在故事中的维度和度量](/tableau/next/zh-cn/online/zh-cn/Img/data_story_configure_field.png)
4. 选择对您的数据描述最为贴切的故事类型：  
    ![使用选项配置窗格，以选择最适合您的数据的故事类型：离散、连续、整体百分比或散点图](/tableau/next/zh-cn/online/zh-cn/Img/data_story_configure_story.png)  
    “离散”最适合用于名称或日期等定性值，例如条形图或柱形图。  
    “连续”最适合随时间变化的定量值，例如折线图中绘制的值。  
    “整体百分比”最适合整体的比例，例如饼图。  
    “散点图”最适合数值之间的关系，例如散点图。
5. 单击“完成”。

要若通过单击可视化项上的不同部分来筛选您的数据故事，请打开可视化项上的菜单，并单击“用作筛选器”。

生成故事后，单击“数据故事”对象顶部的“设置”以获得可帮助您个性化和情境化故事的引导式体验。有关详细信息，请参见[配置 Tableau 数据故事的设置](https://help.tableau.com/v0.0/online/zh-cn/data_stories_configure_edit.htm)。  

**注意：**如果您在 Tableau 数据故事中遇到差异（举例来说，如果您的故事中的数字与您的可视化项中的不同），这可能是由您的可视化设置方式引起的。尝试在不同的工作表上创建新的可视化项，然后使用[使用隐藏工作表](https://help.tableau.com/v0.0/online/zh-cn/data_stories_more_data.htm#Use)技术添加新的数据故事以发现潜在问题。

<!-- document id=d600446fd93369d0cb8da65916e7e4c7904b96dfe7796afc93690943ffd622c4 url=/tableau/next/zh-cn/online/image_role.md -->

[跳转到主要内容](#main-content)

# 将 Web 图像动态添加到工作表

在 Tableau，我们知道图像是分析数据的有力工具。想象一下，您正在查看每月鞋子销售额的可视化项。数据告诉您，您卖出的高跟鞋比坡跟鞋多，但您无法想象这两种鞋的区别。这就是图像角色的用武之地。您可以将 Web 图像动态添加到工作表中，并在标题中使用它们来添加视觉细节。  
  
![包含鞋子图像以及鞋子类型和销售情况的可视化项](/tableau/next/zh-cn/online/zh-cn/Img/imagerole_1.png)  

## 准备数据源

可以将图像角色分配给离散维度字段，其中包含指向 Web 图像的 URL。若要准备您的数据，请确保您的图像字段符合 Tableau 为分配图像角色而设置的要求:

- 确保您的 URL 导航到 .png、.jpeg、.jpg、.svg、.webp、.jfif、.ico 或 .gif 图像文件。
- 验证每个 URL 是否以 http 或 https 开头。如果没有包含传输协议，Tableau 将采用 https。
- 优化数据集中使用的图像数量。通常，每个字段最多可以加载 500 个图像。
- 确保每个图像文件小于 200 kb。

**注意：**如果您使用的是 Tableau 23.1 或更低版本，您的 URL 必须导航到具有 .jpg、.jpeg 或 .png 文件扩展名的图像文件。  
  
在 Tableau 23.2 及更高版本中，支持 .gif 文件，但 .gif **动画**将仅在具有客户端渲染的 Tableau Cloud 和 Tableau Server 上显示。在具有服务器端渲染的 Tableau Desktop 和 Tableau Server 中，.gif 文件将显示为静态图像。  
  
根据可视化项的复杂程度，Tableau 可能默认使用服务器端渲染，这会将图像数量限制为每个字段 100 个。若要了解有关复杂性设置和服务器端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

### 示例数据集：

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border.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" style="width: -1788px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">产品名称</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">产品图像 URL</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">平面</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/flats.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">12,118</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">高跟鞋</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/highheels.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">15,865</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">跑步鞋</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/runningshoes.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">14,200</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">坡跟鞋</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">https://img.example.com/wedges.png</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">8,665</td></tr></tbody></table>

## 为您的 URL 分配图像角色

连接到数据源后，可以从“数据源”页面或工作表的“数据”窗格中为 URL 分配图像角色。

### 从“数据源”页面中：

1. 找到包含图像 URL 的列。
2. 右键单击（在 Mac 上按住 control 键单击）列左上角的图标，然后选择“图像角色”\>“URL”。  
    图标变成图像图标，您的图像就可以使用了。  
      
    ![用于将图像角色分配给 URL 的数据源选项](/tableau/next/zh-cn/online/zh-cn/Img/imagerole_3.png)

### 从工作表中：

1. 打开新工作表。
2. 找到包含图像 URL 的离散维度字段。
3. 右键单击（在 Mac 上按住 control 键单击）维度字段，并选择“图像角色”\>“URL”。  
    图标变成图像图标，您的图像就可以使用了。  
      
    ![用于将图像角色分配给数据的“数据”窗格选项](/tableau/next/zh-cn/online/zh-cn/Img/imagerole_2.png)

## 将图像添加到可视化项

从工作表中，将“图像角色”字段拖到“行”或“列”功能区上。现在，您可以在可视化项上看到图像及其相关数据。  
  
![在数据窗格中创建图像角色。](/tableau/next/zh-cn/online/zh-cn/Img/imagerole_addtoviz2.gif)

## 共享可视化项

您可以导出带有图像的工作簿并共享它们。确保您的可视化项中使用的图像可供与您共享可视化项的每个人查看。举例来说，如果您使用的图像托管在防火墙后的内部服务器上，请确保与您共享可视化项的每个人都有足够的权限访问这些图像。在本例中，在连接到同一服务器时查看可视化项的用户应该不会出现任何查看图像的问题。但是在 Tableau Cloud 服务器上将可视化项导出为 pdf 的用户可能看不到图像。

如果您导出工作簿，并且查看者试图在 Tableau 2022.3 或更低版本中打开它，查看者将看不到图像。

**注意：**最佳做法是始终将“图像角色”字段与文本描述对齐，以便屏幕阅读器和其他辅助功能软件可以访问这些内容。

## 图像连接疑难解答

有时，如果您超过了每个字段允许的图像数量，在复杂的可视化项上有大型图像文件，或者在移动设备上查看可视化项，图像将不会显示。本部分帮助您排除这些错误。

### 我的可视化项中没有显示任何图像

可视化项中的图像太多

根据可视化项的复杂程度，您通常可以在每个字段中加载 500 个图像。如果您有一个复杂的可视化项，它可能默认使用服务器端渲染。使用服务器端渲染，每个字段可以加载 100 个图像。

如果收到可视化项中图像太多的错误消息，请筛选掉图像，然后重试。

Tableau 无法访问图像

如果您收到的是损坏的图像图标，而不是您的图像，请首先确认您有足够的权限查看这些图像（或者举例来说，确认它们是否位于防火墙后面）。Tableau 必须能够访问图像，并且图像不能要求单独的身份验证才能查看。

如果您确定您拥有查看图像的权限，并且它们符合大小要求，请检查您的设置页面上是否启用了 Web 图像。

在 Tableau Desktop 中：

1. 从工作簿中，单击工具栏中的“帮助”。
2. 选择“设置和性能”\>“设置仪表板 Web 视图安全性”。
3. 确保选中了“启用网页对象和 Web 图像”。

在 Tableau Cloud 中：

1. 从主页中，单击“设置”。
2. 在“常规”下，向下滚动并找到“网页对象和 Web 图像”。
3. 确保选中了“启用网页对象和 Web 图像”。

### 我的可视化项中未显示某些图像

图像文件太大

每个图像文件必须小于 200 kb 才能渲染。请检查您的图像文件大小，然后重试。

您使用的是早期版本的 Tableau

如果您使用的是 Tableau 23.1 或更低版本，则仅支持 .png、.jpeg 和 .jpg 图像文件。升级您的 Tableau 版本或使用您正在使用的 Tableau 版本支持的文件类型。

图像 URL 必须以 http 或 https 开头

每个图像 URL 必须以 http 或 https 开头。Tableau 目前不支持 FTP/SMTP 调用。请验证您的 URL 格式，然后重试。

图像文件必须为 URL

图像角色只能分配给导航到 .png、.jpeg 或 .jpg、.svg、.webp、.jfif、.ico、.bmp 或 .gif 图像文件的 URL。请验证您的 URL 格式，然后重试。

不支持图像文件类型

图像角色只能分配给导航到 .png、.jpeg 或 .jpg、.svg、.webp、.jfif、.ico、.bmp 或 .gif 图像文件的 URL。请验证您的 URL 格式，然后重试。

如果您使用的是 Tableau 23.1 或更低版本，则仅支持 .png、.jpeg 和 .jpg 图像文件。升级您的 Tableau 版本或使用您正在使用的 Tableau 版本支持的文件类型。  
在 Tableau 23.2 及更高版本中，支持 .gif 文件，但 .gif **动画**将仅在具有客户端渲染的 Tableau Cloud 和 Tableau Server 上显示。在具有服务器端渲染的 Tableau Desktop 和 Tableau Server 中，.gif 文件将显示为静态图像。  

图像文件包含错误字符

不能将图像角色分配给包含以下字符的 URL：

< > & \\ ^ '

或以下字符序列：

..\\\\.\\r \\n \\t

请验证您的 URL 不包含任何这些字符或字符序列，然后重试。

### 图像没有显示在我的工作表之外

图像没有显示在工具提示内部可视化项中

工具提示内部可视化项是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

有关服务器端和客户端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

有关使用工具提示内部可视化项的详细信息，请参见[在工具提示中创建视图（工具提示内部可视化项）](https://help.tableau.com/current/pro/desktop/zh-cn/viz_in_tooltip.htm)。

图像未以缩略图形式显示在视图中

视图缩略图是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

有关服务器端和客户端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

当我导出工作簿时，图像不显示

所有导出和与导出相关的功能是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

图像没有显示在移动设备上

与计算机相比，移动设备的复杂性阈值更低，因此处理是通过服务器端渲染完成的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

您可以更改移动设备上的复杂性设置。有关复杂性阈值的详细信息，请参见[为计算机和移动设备配置复杂程度阈值](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm#configure-the-complexity-threshold-for-computers-and-mobile-devices)。

<!-- document id=dc6aeaa30f5a1203ac458e351f08bcc09eecda5162a7ecdefeb96a4d7e38cb9b url=/tableau/next/zh-cn/online/viz_extensions.md -->

[跳转到主要内容](#main-content)

# 将可视化项扩展程序添加到您的工作表

可视化项扩展程序是可以扩展 Tableau 原生可视化功能的 Web 应用程序。可视化项扩展程序使用户能够与工作表上的自定义可视化项类型进行交互。

在 Tableau、Tableau 合作伙伴和社区中的第三方开发人员创建的 Web 应用程序的帮助下，Tableau 扩展程序扩展了工作表功能。如果您是开发者，并且想要创建自己的扩展程序，请参见 GitHub 上的 [Tableau Extensions API](https://tableau.github.io/extensions-api/) 文档。

可视化项扩展程序与[仪表板扩展程序](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_extensions.htm?_gl=1*uu9rzu*_ga*MTY0NjQ4Mjc3NS4xNzA3NzcyMzUx*_ga_8YLN0SNXVS*MTcxMjE2NjcxNC41NC4xLjE3MTIxNzA1MzUuMC4wLjA.)类似，因为它是托管在 [Tableau Exchange](https://exchange.tableau.com/zh-cn/) 上的 Web 应用程序。它与仪表板扩展程序的不同之处在于，您在构建可视化项时将其添加到工作表中，而不是将其作为对象添加到仪表板。

## 将可视化项扩展程序添加到工作表

有两种方法可以通过“标记”卡将可视化项扩展程序添加到工作表。如果您已经通过 Tableau Exchange 下载了该扩展程序，则可以将其添加为本地文件。或者您可以在制作可视化项的流程中从 Tableau Exchange 下载它。

### 以本地文件形式添加可视化项扩展程序

如果您已经从 Tableau Exchange 选择并下载了可视化项扩展程序，它将以 .trex 文件形式保存在您的计算机上。

1. 打开 Tableau 工作簿并连接到数据源。
2. 在工作表中的“标记”卡上，展开“标记类型”下拉菜单。
3. 在“可视化项扩展程序”下，选择“添加扩展程序”。  
      
    ![包含“可视化项扩展程序”选项的“标记”卡下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/viz_ext_marks_AddExt.png)
4. 在出现的“添加扩展程序”对话框中，选择“访问本地可视化项扩展程序”。  
      
    ![“添加扩展程序”对话框，其中用于包含访问本地可视化项扩展程序的选项。](/tableau/next/zh-cn/online/zh-cn/Img/viz_ext_addlocal.png)
5. 导航到并打开已保存的 .trex 文件。
6. 如果出现提示，请允许或拒绝可视化项扩展程序访问工作簿中的数据。

可视化项扩展程序在视图中加载，并且标记类型更改为可视化项扩展程序的名称。

### 在制作可视化项时添加可视化项扩展程序

如果您尚未选择并下载可视化项扩展程序，则可以在制作可视化项的流程中进行选择和下载。

1. 打开 Tableau 工作簿并连接到数据源。
2. 在工作表中的“标记”卡上，展开“标记类型”下拉菜单。
3. 在“可视化项扩展程序”下，选择“添加扩展程序”。  
      
    ![包含“可视化项扩展程序”选项的“标记”卡下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/viz_ext_marks_AddExt.png)
4. 在出现的“添加扩展程序”对话框中，选择您想要加载到工作表上的可视化项扩展程序。在此示例中，我们正在加载由 Tableau 构建的桑基图。  
      
    ![“添加扩展程序”对话框，用于从 Tableau Exchange 中搜索并添加扩展程序。](/tableau/next/zh-cn/online/zh-cn/Img/viz_ext_addext.png)
5. 如果出现提示，请允许或拒绝可视化项扩展程序访问工作簿中的数据。有关详细信息，请参见“数据安全扩展程序、支持网络的扩展程序以及沙盒化扩展程序”。
6. 选择“打开”。  
      
    ![Tableau Exchange 中由 Tableau 开发的桑基图的描述页面。\]](Img/viz_ext_exchange.png)

可视化项扩展程序在视图中加载，并且标记类型更改为可视化项扩展程序的名称。  
  
![“标记”卡下拉菜单，在“可视化项扩展程序”部分放大了“桑基图扩展程序”。](/tableau/next/zh-cn/online/zh-cn/Img/viz_ext_add_sankey.png)

## 使用“标记”卡对标记进行编码

将字段拖到“标记”卡上的编码框上以构建可视化项。标记编码框和格式选项由开发人员决定。检查 Tableau Exchange 上的扩展程序描述，以获取有关您正在加载的可视化项扩展程序的信息。

若要使用桑基图扩展程序，请遵循以下编码说明：

构建桑基图扩展程序是为对**级别**和**链接**使用特定于扩展程序的编码。这些可以与内置的标记编码框工具提示和详细信息一起使用，在工作表上构建桑基图。

- **级别** - 桑基图级别表示与桑基图相关的分类维度。在此扩展程序中，您最多可以将 5 个离散维度作为级别。
- **链接**\- 桑基图链接将桑基图中的类别连接起来。此编码将根据数值度量来调整每个链接的宽度。

## 管理工作簿扩展程序

从 Tableau 2026.2 开始，您可以从一个位置查看、删除或替换工作簿中使用的所有扩展程序。

若要管理扩展程序，请执行以下操作：

1. 从工具栏中，选择“分析”，然后选择“管理工作簿扩展程序”。  
      
    ![显示各种设置和突出显示的“管理工作簿扩展程序”选项的“分析”下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/vizext_manageextensions.png)
2. 在“管理工作簿扩展程序”对话框中，选择要管理的扩展程序。  
      
    ![“管理工作簿扩展程序”对话框窗口，显示选定的桑基图扩展程序详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/vizext_manageextension_dialog.png)
3. 选择以下操作之一：
    
    **删除扩展程序**：选择“删除”以从工作簿中移除扩展程序。您可以在“工作簿扩展程序”对话框中查看扩展程序当前在何处使用。删除扩展程序会将其从所有工作表、仪表板和故事中移除。使用扩展程序的可视化项将更改为“标记”卡上的“自动”标记类型。
    
    **替换扩展程序：**选择“替换”以切换到其他扩展程序。选择要切换到的扩展程序，并选择“确认”。替换扩展程序将替换整个工作簿中扩展程序的每个实例。Tableau 会尝试尽可能保留您的设置，但设置可能因扩展程序或版本而异。
4. 完成更新后，选择“确定”。

注意：如果您的工作簿不包含任何扩展程序，则对话框将显示“此工作簿中没有扩展程序”消息。

## 确保 Tableau Cloud 上允许使用扩展程序

如果您无法添加可视化项扩展程序，请检查您的站点上是否允许使用扩展程序。Tableau 管理员必须允许扩展程序在站点上运行，并将支持网络的扩展程序添加到允许列表。管理员只应允许您测试过并信任的扩展程序。

若要了解有关将支持网络的扩展程序添加到允许列表的详细信息，请参见 [Tableau 帮助：更改站点的默认设置](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm#change-the-default-settings-for-a-site)。

### 数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序

扩展程序是采用两种标准的 Web 应用程序：

- _Tableau 可信扩展程序_已由 Tableau 管理的主机专门审查并部署在其中。其中包括由 Tableau 开发和管理的扩展程序、由 Tableau Exchange 合作伙伴构建并使用 Tableau 的扩展程序审查和主机服务部署的扩展程序，以及我们旧版沙盒化扩展程序主机内的扩展程序。
- _支持网络的扩展程序_由第三方主机托管。这些扩展程序允许开发人员管理其扩展程序的交付，而无需 Tableau 的中介。其中包括合作伙伴直接管理以提供更好的生产支持的扩展程序、在您的本地网络中托管和部署的扩展程序，以及需要与 Tableau 外部的第三方服务通信的扩展程序。

在您允许支持网络的扩展程序之前，请确保您信任开发人员和托管扩展程序的网站。您可以在“管理工作簿扩展程序”对话框中找到有关托管扩展程序的 URL 以及开发人员请求的数据访问权限类型的信息。  
  
![“管理工作簿扩展程序”对话框窗口，显示突出显示的扩展程序详细信息部分。](/tableau/next/zh-cn/online/zh-cn/Img/vizext_manageextension_dialog_magnified.png)

默认情况下，扩展程序使用 HTTPS 协议，该协议可保障一条用于发送和接收数据的加密通道，并确保一定的隐私性和安全性。有关使用扩展程序时的数据安全性的详细信息，请参见[扩展程序安全性 - 部署最佳做法](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。

### 允许或拒绝支持网络的扩展程序

默认情况下，支持网络的扩展程序必须请求运行权限。此权限对话框将提供有关从中托管它的第三方服务器的信息，以及扩展程序所需的数据访问级别。我们建议您在允许运行扩展程序之前查看此信息。

扩展程序通常访问视图中的可见数据。当扩展程序请求“完整数据访问权限”时，它可能会请求工作簿中的更深层次的数据访问权限。这可能包括访问完整的基础数据、数据源中的表和字段名称，以及有关数据源连接的信息。在允许扩展程序在工作簿中运行之前，您应查看扩展程序权限对话框中声明的信息，并决定是要允许还是拒绝扩展程序运行和访问此数据。

### 重置支持网络的扩展程序的数据访问权限

如果在扩展程序权限对话框中选择“拒绝”而不是“允许”，扩展程序将不会加载到您的工作表上。如果您信任扩展程序并希望允许访问，您可以通过将相同的可视化项扩展程序再次添加到工作簿中来重置权限，这将重新加载权限提示对话框。

### 确保扩展程序具有访问工作簿或视图的权限

如果发布包含扩展程序的工作簿，请确保扩展程序能够访问视图中的可见数据。可见数据也称为摘要数据。若要在 Tableau Server 或 Tableau Cloud 上授予此访问权限，请确保工作簿或视图允许“下载摘要数据”的权限。扩展程序不会下载您的数据。扩展程序只需要权限，就可以与视图中的数据交互。

根据您在发布工作簿时是否选择了将工作表显示为标签，您可以在工作簿或视图级别设置“下载摘要数据”权限。如果工作表未显示为标签，则可以在视图级别设置权限。

如果将工作簿或视图发布到 Tableau Public，扩展程序还需要访问可见数据。若要授予权限，请打开“设置”并选择“允许访问”。

## 确保在 Tableau Desktop 中启用了 JavaScript

可视化项扩展程序使用 Tableau Extensions API 库（一个 JavaScript 库）与数据交互。如果要使用扩展程序，请确保在安全设置中启用了 JavaScript：

选择“帮助”\>“设置和性能”\>“设置仪表板 Web 视图安全性”\>“启用 JavaScript”。

## 获取对第三方和 Tableau 合作伙伴构建的可视化项扩展程序的支持

Tableau 不直接支持第三方和 Tableau 合作伙伴构建的扩展程序。但是，如果您需要帮助，一些扩展开发人员会提供指向开发人员网站的链接，您可以在其中寻求支持。

获取帮助：

1. 在“管理工作簿扩展程序”对话框上或 Tableau Exchange 的扩展程序描述页面上查找“开发人员网站”链接。
2. 在“管理工作簿扩展程序”对话框中找到扩展程序的 ID 和版本。向开发人员提供这些详细信息对于故障排除至关重要，因为它可以确认是否使用了过时的版本，并有助于查明问题的根源。
3. 请通过开发人员网站直接与扩展程序的开发人员联系。

对于有关 Extensions API 的问题，我们鼓励开发人员通过 [DataDev Slack 频道](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)分享问题并寻求帮助，或[在 GitHub 上提交](https://github.com/tableau/extensions-api/issues) Extension API 的问题。

<!-- document id=55d586cc4b0e6bda140da5cc325f2d0cd4ddf097e54dfef4af16c7e3a3a8c447 url=/tableau/next/zh-cn/online/data_stories_pop_up.md -->

[跳转到主要内容](#main-content)

# 将弹出式 Tableau 数据故事添加到仪表板

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

您可以将 Tableau 数据故事放置在弹出窗口中，让您的用户可以打开故事、阅读故事，然后在完成后将其关闭。这是节省已建立的仪表板使用的空间或减少仪表板上的混乱和信息量的好方法。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 通过单击菜单并选择“浮动”，将容器设置为“浮动”。

> [!TIP]
> 
> **提示：**将容器设置为“浮动”的另一种方法是按住 shift 键，同时将容器拖到仪表板上。

1. 导航到左侧列中的“布局”选项卡，并将背景颜色设置为白色。

![背景设置为 100% 和白色的“布局”窗格。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_white_background.png)

1. 单击与浮动容器关联的菜单以显示其设置，然后选择“添加显示/隐藏”按钮。这将创建一个“X”图标，允许您显示或隐藏您的故事。

![带有大 X 图标的数据故事，该图标允许用户隐藏故事。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_x.png)

**注意：**如果您的故事被选中，那么您的按钮会被作为“数据故事”对象一部分的侧边栏选项部分遮挡。单击故事外的任意位置以显示该按钮。

1. 将光标悬停在“X”图标上以显示打开或关闭故事的说明。在此示例中，系统会提示您在单击“X”图标的同时按下 Alt 键。

![带有大 X 图标（允许用户隐藏故障）和工具提示（显示“隐藏'数据故事'”（Alt+单击隐藏））的“数据故事”对象](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_hide_story.png)

1. 在按下提示中指示的键的同时单击“X”图标来折叠故事。

故事会折叠，但菜单保留在仪表板上，以便用户可以在需要时展开故事。您可以根据需要在仪表板四周移动可折叠的浮动故事。

<!-- document id=3b2a755680a894b8b057f0a5e8c5a219534587977df56efdce90a096cfddbbe5 url=/tableau/next/zh-cn/online/publish_to_salesforce.md -->

[跳转到主要内容](#main-content)

# 将视图发布到 Salesforce

通过将视图发布到 CRM Analytics 应用或 Salesforce Lightning 页面，将您的视图从 Tableau Cloud 或 Tableau Server 直接引入 Salesforce 生态系统。

有关详细信息，请参见 Salesforce 帮助中的[将 Tableau 内容发布到 CRM Analytics](https://help.salesforce.com/s/articleView?id=sf.bi_publish_tableau_online.htm&language=en_US&type=5)。

## 先决条件

在 Salesforce 帮助中查看[先决条件](https://help.salesforce.com/s/articleView?id=sf.bi_tableauviews_setup_prereq.htm&type=5)的完整列表，包括所需的许可证、帐户设置和权限。

## 将视图发布到 Salesforce

选择一个或多个视图，包括仪表板、工作表和故事。然后，从 CRM Analytics 应用列表中选择一个您有权编辑或管理的目标。

1. 选择要发布到 Salesforce 导入到的视图。

**注意**：您一次最多可以选择 25 个视图发布到 Salesforce。

3. 对于“操作”，选择“发布到 Salesforce”。
4. 选择您要用于发布的 Salesforce 凭据。
5. 选择要发布到的目标应用。您只能查看您可以使用已登录的 Salesforce 用户编辑或管理的应用。
  
![“发布到 Salesforce”对话框，显示您可以从中选择的应用列表。](/tableau/next/zh-cn/online/zh-cn/Img/publish-to-salesforce-dialog.png)  
9. 单击“发布”。

## 谁可以在 Salesforce 中查看已发布的视图？

当您将视图发布到 Salesforce 时，有权访问所选 CRM Analytics 应用或 Lightning 页面的任何人都可以看到内容存在。但是，只有使用现有 Tableau 权限登录的用户才能看到该视图。

<!-- document id=a9b8baca1ebfaf7e56d2f24f2f265a8b06145821339d2d6b6d5821f606579300 url=/tableau/next/zh-cn/online/custom_domain.md -->

[跳转到主要内容](#main-content)

# 将自定义域与 Tableau Cloud 配合使用

您可以使用自定义域将流量重定向到您的 Tableau Cloud 站点。自定义域允许您配置子域（如 `analytics.example.com`），以便嵌入和访问已发布的内容，而不会暴露 Tableau 站点详细信息。使用自定义域，您可以使用组织的 URL 将用户定向到内容。

本主题介绍如何在 Tableau Cloud 站点设置中配置自定义域。有关使用 Tableau REST API 配置自定义域的信息，请参见 [Tableau REST API OpenAPI 端点](https://help.tableau.com/current/api/rest_api/zh-cn/REST/TAG/index.html#tag/Custom-Domain-Methods)。

## 开始之前

若要将自定义域添加到 Tableau Cloud，您必须满足以下用户和 TLS 证书要求。

### 用户要求

- **Tableau Cloud 站点的管理员访问权限。**您必须对要添加自定义域的 Tableau Cloud 站点具有管理员访问权限。
- **父域的 DNS 配置的管理员权限。**您必须具有管理员权限才能将 CNAME 记录添加到父域的 DNS 配置中。
    
    父域是 DNS 分层结构中的主域。它包含子域或次级域。例如，`example.com` 是父域，而子域（例如 `abc.example.com` 或 `xyz.example.com` ）位于它下面。

### TLS 证书要求

从受信任的颁发机构（例如 Verisign、Thawte、Comodo、GoDaddy）获取有效的 TLS 证书链文件和私钥。您无法使用您的组织颁发的内部证书。

获取自定义域的 TLS 证书时，请遵循以下准则和要求：

- **包含完整证书链的 TLS 证书。**TLS 证书必须按身份证书 > 中间证书 > 根证书的顺序包括完整的证书链。
- **有效的 PEM 编码 x509 证书。**所有证书文件必须是有效的 PEM 编码 x509 证书。
- **SHA-256 用作签名算法。**证书文件必须使用 SHA-2（256 位或 512 位）签名哈希。
- **RSA 用作加密算法。**证书文件必须使用 RSA 加密算法。
- **与自定义域匹配的公用名称。**证书公用名称 (CN) 必须与在 Tableau Cloud 的“设置”页面上输入的自定义域匹配。Tableau 不支持通配符证书（例如 `*.example.com`），也不会检查“使用者备用名称 (SAN)”字段。
- **90 天至 365 天内过期。**证书到期日期必须在颁发之日起 90 天到 365 天内。公开受信任的 TLS 证书的最长有效期为 397 天，其中包括提供商提供的标准 30 天宽限期。
    
    **注意：**添加或替换证书时，它必须自上载日期起至少还有 88 天的剩余有效期。
- **有效的 RSA 私钥文件。**除了证书文件外，上载对应的 TLS 证书密钥文件。密钥文件必须是扩展名为 `.key` 的有效 RSA 私钥，并且位长度为 2048 位或更高。

### PEM 编码文件示例

此示例显示 PEM 编码的证书和私钥文件的格式。为便于说明，内容已缩短。

> [!IMPORTANT]
> 
> **重要信息：** 证书链文件必须以 `-----BEGIN CERTIFICATE-----` 开头。此外，不要在证书链文件的 `-----END` 和 `-----BEGIN` 部分之间包含注释。

**证书链文件**

\-----BEGIN CERTIFICATE-----
MIIGiTCCBHGgAwIBAgIIY5dpPr2gQjowDQYJKoZIhvcNAQENBQAwgYsxCzAJBgNV
...
A7jcIyoWtoPP1rZ3VjP4LIVVro8pce7MNtD9CzUYN8kQk1iftBKWjcCd20Km
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIGqzCCBJOgAwIBAgIIYifB1rX/1pAwDQYJKoZIhvcNAQELBQAwgYUxCzAJBgNV
...
g+qyDLoAy/td0D8ha8SlWt5ee2cAF9Xu7Y9jNe21Ug==
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDpjCCAyugAwIBAgIQDTYMRISRziTtCzVA2HCg3TAKBggqhkjOPQQDAzBhMQsw
...
7LX35CV+ypuVTbKZkjATTvROgmL5AgTbsAg=
-----END CERTIFICATE-----

**私钥文件**

\-----BEGIN PRIVATE KEY-----
MIIEpAIBAAKCAQEAgN9TePjxsgvjZ8QERQILf3YbofaBHGks5E3k9dRP0cx7sw1O
...
xpAh+dRkr0vjsj/ZnJyYfaUQDcV4wslFcn6eKoINEQrtBj40P1iqig==
-----END PRIVATE KEY-----

## 与 SAML 单点登录 (SSO) 的兼容性

如果您的 Tableau Cloud 站点使用 SAML 身份验证，您必须在添加自定义域后更新身份提供程序 (IdP) 配置。具体而言，请更新 IdP 中的以下值以反映您站点的自定义域：

- 实体 ID
- ACS URL

有关配置 SAML 身份验证的详细信息，请参见[SAML](https://help.tableau.com/v0.0/online/zh-cn/saml.htm)。

**注意：**从 2026 年 6 月开始，自定义域支持 [SCIM](https://help.tableau.com/current/online/zh-cn/scim_config_online.htm) 集成。

## 与自定义 OAuth 连接的兼容性

配置新的 OAuth 客户端时，请为“重定向 URL”使用自定义域。举例来说，如果自定义域为 `analytics.example.com`，则重定向 URL 为 `https://analytics.example.com/auth/add_oauth_token`。无论您的自定义域配置如何，现有工作簿都将继续按预期运行。有关自定义 OAuth 客户端的详细信息，请参见[OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm)。

## 为您的站点添加自定义域

若要将自定义域添加到 Tableau Cloud 站点，请使用以下部分中的步骤。

### 添加域名

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“常规”选项卡上，滚动到“自定义域”。
3. 为您的站点输入域名。值必须是子域。Tableau 不支持为自定义域使用父域，例如 `example.com`。
4. 选择“保存”。
    
    ![三步自定义域设置界面，显示添加域名的有效第一步。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_add.png)

### 验证 CNAME

1. 使用步骤 1 中显示的“Tableau 创建域” ，在 DNS 配置中创建 CNAME 记录。此步骤在外部 Tableau Cloud 执行，并且需要组织中的网络管理员访问权限。CNAME 验证在添加自定义域 48 小时后过期，此时您必须重新启动该过程。
    
    > [!TIP]
    > 
    > **提示：**为 CNAME 记录使用 30–60 分钟的生存时间 (TTL) 值。
2. 选中该复选框以确认您已创建了从所选自定义域到 DNS 配置中的 Tableau CNAME 的 CNAME 记录。
3. 选择“验证”。
    
    ![自定义域设置界面，显示已完成的域名步骤和活动的 CNAME 验证步骤。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_validate.png)

### 上载 TLS 证书和私钥

1. 上载与自定义域关联的完整证书链和私钥文件。证书链必须包括根证书、中间证书和最终用户证书。有关证书要求的详细信息，请参见 [TLS 证书要求](#TLS-certificate-requirements)。
2. 选择“保存”。
    
    ![自定义域设置界面，显示已完成的域名和 CNAME 验证步骤以及活动的 TLS 证书上载步骤。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_upload_cert.png)

成功上载文件后，预置域最多可能需要 60 分钟。状态通知在预置过程中出现，并在自定义域可用时消失。

![自定义域界面，显示预置状态横幅和当前配置详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_provision.png)

## 使用自定义域时应该做什么

使用自定义域时，用户界面会稍作更改。

- 地址栏中的 URL 显示自定义域，而不是托管您站点的 Tableau Cloud pod。此更改不会影响登录，用户仍然可以通过 [https://online.tableau.com](https://online.tableau.com/) 访问站点。
- “共享”对话框链接和嵌入代码指向自定义域，而不是托管您站点的 Tableau Cloud pod。这是因为对话框使用当前 URL 中的信息填充字段。对于之前共享或嵌入的内容，URL 将继续引用 Tableau Cloud pod。若要改用自定义域，您必须使用新的“共享”对话框值更新以前的链接。有关共享 Tableau 内容的详细信息，请参见 Tableau Desktop 帮助中的[共享 Web 内容](https://help.tableau.com/current/pro/desktop/zh-cn/shareworkbooks.htm)。
- 对于属于多个站点的用户，在访问具有自定义域的内容时，站点选择器不可用。若要切换站点，请注销并向所需站点进行身份验证。

## 替换或更新 TLS 证书

在 TLS 证书和密钥文件即将过期时或您的组织需要时替换它们。证书到期日期显示在“设置”页面的“自定义域”部分。

替换 TLS 证书和私钥文件：

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“常规”选项卡上，滚动到“自定义域”。
3. 选择“替换证书”，然后按照[上载 TLS 证书](#upload-certificate-and-private-key)中列出的步骤操作。替换证书的剩余有效期必须至少为 88 天。如果证书在上载日期后不到 88 天后过期，则上载将失败。
    
    ![自定义域界面，显示预置状态横幅、当前配置详细信息以及活动证书和私钥上载字段。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_replace_update.png)

## 移除自定义域

移除自定义域时，用于共享和嵌入内容的 URL 将不再可用。为避免链接断开，请让用户在移除域之前更新其书签和嵌入的内容。更新后的 URL 必须使用托管其站点的 Tableau Cloud pod 的名称。有关 Tableau Cloud pod 的列表，请参见 [Salesforce 信任](https://status.salesforce.com/products/Tableau)。

若要从站点中移除自定义域，请执行以下操作：

1. 以管理员身份登录到 Tableau Cloud 站点，然后选择“设置”。
2. 在“常规”选项卡上，滚动到“自定义域”。
3. 选择“移除域”\>“移除”。
    
    ![显示“移除域”确认对话框的自定义域界面。](/tableau/next/zh-cn/online/zh-cn/Img/custom_domain_remove.png)

## 疑难解答

### 添加 CNAME 记录时延迟 DNS 传播

如果在将 CNAME 记录添加到 DNS 配置时遇到延迟，请验证 CNAME 是否反映预期的映射。您可以使用诸如 `dig` 和 `nslookup` 之类的命令行工具来验证 CNAME 映射。

### 证书错误

若要更正证书错误，请按照屏幕上的说明进行操作，并验证证书是否符合 [TLS 证书要求](#TLS-certificate-requirements)。

<!-- document id=4af06899d01d9555c2fdbb555c0b444a1f3e8304126b2e985387435acf35b58c url=/tableau/next/zh-cn/online/ipa_vconn_add_tables.md -->

[跳转到主要内容](#main-content)

# 将表添加到连接

在“表”选项卡上：

将表添加到连接

**添加表**

选择一个选项：

- 在左侧的**“表”**下，双击表名称或选择并将它们拖到右侧的**“表”**窗格。如果您正在使用权利表，请包括该表。
- 选择 ![“新建自定义 SQL”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_New_Custom_SQL_btn.png) 创建自定义表架构，或者选择现有表上的“转换为自定义 SQL”并将其用作自定义 SQL 的起点。

选择 ![虚拟连接编辑器工具栏中的刷新数据图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconns_refresh_icon.png) 以从数据库中获取所有连接的最新数据。

**查看和编辑表详细信息**

1. 在“表”选项卡中选择一个表。
2. 在“表详细信息”部分，选择列值以进行编辑，比如隐藏或重命名列，或更改数据类型。

为表选择实时或数据提取模式

将单个表设置为实时或数据提取模式：

- 仅实时 - 直接从数据库查询。（“实时”为默认值。）
- 仅数据提取 - 提取并保存到 Tableau。

在“表”下，选择要更改模式的一个或多个表，然后依次选择“操作”和“更改为实时”或者“更改为数据提取”。

- 选择“创建待定数据提取”来创建数据提取，或者选择“刷新所有数据提取”以在创建后刷新它们。
- 选择表的“操作”菜单 (...)>“数据提取设置”配置数据提取以进行增量刷新。
- 发布连接后，在虚拟连接页面上计划数据提取刷新。  
    [阅读计划数据提取主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_extract.htm)

设置表可见性状态

使用“可见性”开头以向用户显示或隐藏表。

![选中标记表示显示](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_check_mark_show.png) 用户可以查看表数据。创建一个策略来管理哪些数据用户可以看到。（“可见”为默认值。）

![X 表示隐藏](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_x_hide.png) 户看不到表数据。您可以在数据策略中使用隐藏表并将其用作权利表。

查看表详细信息

选择“表”选项卡顶部的表可在下方查看其详细信息。

使用这些图标切换您看到的表信息：

![“标记”图标表示列数据类型。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Tag_16px_medium.png) 每列的数据类型。

![“表”图标代表列示例数据。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Table_16px_medium.png) 每列的示例数据。

![“配置文件”图标表示列值范围。](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Panes_show_16px_medium.png) 直方图中所选的每一列的值范围。

**快速剪辑**：查看您的表详细信息。

Your browser does not support the video tag.

通过选择 ![表图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Table_16px_medium.png) 查看哪些列链接到其他表来查看“链接的键”。仅当数据库具有主键和外键信息时，链接键才会显示。

发布连接并设置权限

### 保存草稿或发布连接

在您工作时，您的连接会自动保存为草稿。通过单击 ![“保存”图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Save_16px_medium.png) 来手动保存草稿。

若要与其他用户共享新的虚拟连接，您需要发布它。

1. 单击编辑器右上角的 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)。
2. 在“名称”字段中键入连接的名称。
3. 选择一个项目来保存连接。
4. 单击 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)

当您编辑现有连接时，它在当前已发布状态下仍可供用户使用。

- 若要将更新保存到草稿，请单击 ![“保存”图标](/tableau/next/zh-cn/online/zh-cn/Img/ipa_Save_16px_medium.png)。
- 若要使更新的连接对用户可用，请单击 ![“发布”按钮](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_publish_btn.png)

### 设置权限以便其他人可以使用连接

您已发布连接，并准备好让其他人使用它。为此，请将“连接”功能设置为“允许”。

1. 导航到虚拟连接。
2. 打开“操作”菜单 (...)，并单击“权限”。
3. 选中“连接”图标下的框，以便所有用户都可以使用连接。
    
    ![“权限规则”下的“连接”功能复选框](/tableau/next/zh-cn/online/zh-cn/Img/ipa_vconn_connect_capability.png)
4. 单击“保存”。

[阅读发布和权限主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_publish_save.htm)

[阅读虚拟连接主题](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_conn.htm)

## 相关任务

[关于虚拟连接编辑器](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_editor.htm)

[关于数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_data_policy.htm)

[创建和测试数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_create_data_policy.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=ac1ebe3c4778ee3a66420a257ccbb4c57b9b8cf2d0107bdd8cfe805152ef3228 url=/tableau/next/zh-cn/online/connected_apps_troubleshoot.md -->

[跳转到主要内容](#main-content)

# 已连接应用故障排除 - 直接信任

当嵌入内容无法在您的自定义应用程序中显示，或者 Tableau REST API 授权失败时，您可以使用浏览器的开发人员工具来检查和识别可能与用于显示嵌入内容的 Tableau 已连接应用（直接信任）相关联的错误代码。

**注意：**为了使会话令牌有效，外部应用程序和托管外部应用程序的服务器的时钟必须设置为协调世界时 (UTC)。如果任何一个时钟使用不同的标准，连接的应用软件将不被信任。

请参阅下表以查看错误代码和潜在解决方案的描述。

<table style="width: 90%;margin-left: 0;margin-right: auto;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"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">错误代码</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">摘要</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">描述</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">潜在的解决方案或解释</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">5</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SYSTEM_USER_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到 Tableau 用户</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 JWT 中的“<code>sub</code>”（使用者）声明值是否为经过身份验证的 Tableau Cloud 用户的用户名（电子邮件地址）。此值区分大小写。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">LOGIN_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">登录失败</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">此错误通常是由 JWT 中的以下声明问题之一引起的：<ul><li>“<code>exp</code>”（过期时间）超过了默认的最长有效期。若要解决此问题，请查看有效 JWT 所需的<a href="https://help.tableau.com/current/online/zh-cn/connected_apps.htm#jwt" target="_blank">已注册声明</a>并确保正确的值不超过 10 分钟。</li><li>“<code>sub</code>”（使用者）正在调用未知用户。若要解决此问题，请验证“<code>sub</code>”值是否为经过身份验证的 Tableau Cloud 用户的用户名（电子邮件地址）。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">67</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">FEATURE_NOT_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">仅可通过获得许可的 Tableau Cloud 站点进行按需访问。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">126</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到已连接应用</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证是否已启用已连接应用并且在 JWT 中引用了正确的客户端 ID（也称为已连接应用程序 ID）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">127</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_SECRET_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到已连接应用的密文</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 JWT 中是否引用了正确的已连接应用的密文 ID 和密文值。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">128</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_SECRET_LIMIT_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">已达到密文的最大限制</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">一个已连接应用最多允许使用两个密文。当尝试创建第三个密文时，可能会发生此错误。<p>若要解决此问题，请在创建新密文之前从已连接应用中删除一个密文。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">133</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">INVALID_CONNECTED_APP_DOMAIN_SAFELIST</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">10083</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">BAD_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 标头包含问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 标头中缺少“<code>kid</code>”（密文 IDd）或“<code>clientId</code>”（颁发者）声明。若要解决此问题，请确保包含此信息。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10084</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_PARSE_ERROR</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 包含问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证以下各项：<ul><li>JWT 中引用的“<code>aud</code>”（受众群体）值是否使用“tableau”值。此值区分大小写。</li><li>JWT 中包含“<code>aud</code>”（受众群体）和“<code>sub</code>”（使用者）。</li><li>检查 IssueTime 或确保托管已连接应用的计算机与 Tableau Cloud 之间没有时钟不匹配情况。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10085</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">COULD_NOT_FETCH_JWT_KEYS</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 找不到密钥</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">找不到密文。<p>若要解决此问题，请验证在 JWT 标头中是否使用了正确的“kid”（密文 ID）。 </p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10089</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_NOT_FOUND</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">找不到已连接应用</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请确保颁发者调用正确的已连接应用 ID（也称为客户端 ID）。 </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10090</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">CONNECTED_APP_DISABLED</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">10091</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_ALREADY_USED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">需要唯一的 JWT</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 已在身份验证过程中使用。若要解决此问题，必须生成新的 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10092</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">NOT_IN_DOMAIN_ALLOW_LIST</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">未指定嵌入内容的域</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请确保 <code>unrestrictedEmbedding</code> 设置设为 <code>true</code> 或者 <code>domainAllowlist</code> 参数包括使用 Tableau REST API 中的<a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_site.htm#embedding_settings_for_site" target="_blank">更新站点嵌入设置</a>方法嵌入 Tableau 内容的域。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10094</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MISSING_REQUIRED_JTI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少 JWT ID</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">若要解决此问题，请验证 JWT 中包含“<code>jti</code>”（JWT ID）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10096</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_EXPIRATION_EXCEEDS_CONFIGURED_EXPIRATION_PERIOD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">过期时间问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">“<code>exp</code>”（过期时间）超过了默认的最长有效期。若要解决此问题，请查看有效 JWT 所需的<a href="https://help.tableau.com/current/online/zh-cn/connected_apps_eas.htm#jwt" target="_blank">已注册声明</a>并确保正确的值不超过 10 分钟。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10097</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MALFORMED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">范围声明的问题</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">当“<code>scp</code>”（范围）声明在 JWT 中缺失或未作为列表类型传递时，可能会发生此错误。若要解决此问题，请验证“<code>scp</code>”包含在 JWT 中并作为列表类型传递。有关 JWT 的故障排除帮助，请参见 auth0 站点上的<a href="https://jwt.io/" target="_blank">调试器</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10098</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_UNSIGNED_OR_ENCRYPTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 未签名或已加密</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">Tableau 不支持未签名或已加密的 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10099</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">SCOPES_MISSING_IN_JWT</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少范围声明</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">JWT 缺少所需的“<code>scp</code>”（范围）声明。若要解决此问题，请验证 JWT 中是否包含“<code>scp</code>”。有关 JWT 的故障排除帮助，请参见 auth0 站点上的<a href="https://jwt.io/" target="_blank">调试器</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10100</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JTI_PERSISTENCE_FAILED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">意外的 JWT ID 错误</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">存在意外的“<code>jti</code>”（JWT ID）错误。若要解决此问题，必须生成带有新的“<code>jti</code>”的新 JWT。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10101</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EPHEMERAL_USER_LOGIN_FAILED_SITE_NOT_UBP_ENABLED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">该站点未获得启用按需访问所需的基于嵌入式分析使用情况的模型。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#embedded-analytics" class="xref">了解许可证模式</a>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10102</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">EPHEMERAL_USER_NOT_SUPPORTED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">启用 iframe-auth 属性时不支持按需访问</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">启用 iframe-auth 属性时可能会出现此错误。为了解决此问题，请验证是否正在使用 Tableau Embedding API 版本 3.6 或更高版本。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10103</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT_MAX_SIZE_EXCEEDED</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">JWT 超出最大大小</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">当 JWT 大小超过 8000 字节时，可能会发生此错误。为了解决此问题，请确保仅将必要的声明传递给 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span>。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10105</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ORIGIN_HEADER_NOT_A_VALID_URI</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">无效的 Origin 标头</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">发生此错误的原因可能是：1) 在域白名单中指定了 URL，2) Origin 标头不包含有效的 URL。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">10106</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ORIGIN_HEADER_NOT_SET</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">缺少 Origin 标头</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">发生此错误的原因可能是：1) 在域允许列表中指定了 URL，2) 未设置 Origin 标头。 </td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">10113</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">EPHEMERAL_USER_LOGIN_FAILED_SITE_NOT_ENTITLED_FOR_ODA_ACCESS</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">不支持按需访问</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">此站点未使用基于嵌入式分析使用情况的模型获得许可；或基于容量的 Viewer（查看者）块未随 Cloud+ 或 Tableau+ 版本启用，这是按需访问所必需的。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#UsageBased" class="xref">基于使用情况的许可证模式</a>或<a href="https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#capacity" class="xref">基于容量的许可证模式</a>。</td></tr></tbody></table>

<!-- document id=e212657418fe38556f8bec632224435f024a425bbee5f8b065f9e432a550556d url=/tableau/next/zh-cn/online/connected_apps_scopes.md -->

[跳转到主要内容](#main-content)

# 已连接应用的访问范围

2022 年 6 月开始，使用 Tableau 已连接应用，您可以代表 Tableau Cloud 用户，通过自定义应用程序以编程方式调用和访问 Tableau REST API。对 REST API 的访问由定义为初始登录请求的一部分的 JSON Web 令牌 (JWT) 启用。JWT 必须包含对自定义应用程序及其用户可通过已连接应用使用的 REST API 方法进行定义的范围。

授权使用已连接应用访问 REST API 以：

- 提高效率 — 使用 JWT 作为持有者令牌，只需向登录端点发出一个请求（而不是两个请求），从而可以简化模拟
- 扩展和自动完成复杂的 Tableau 集成和后端查询，例如动态内容检索和高级筛选

## 范围操作

已连接应用使用范围通过[支持 JWT 授权的 REST API 方法](#scopes)（见下文）授予对内容或管理操作的访问权限。范围是一个以冒号分隔的字符串，以命名空间 `tableau` 开头，后跟被授予访问权限的 Tableau 资源，例如 `datasources`,并以允许对资源执行的操作结尾，例如 `update`。

范围可进行的操作包括：

- `create`
- `read`
- `run`
- `update`
- `download`
- `delete`

例如，允许您的自定义应用程序调用[更新数据源](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_data_sources.htm#update_data_source)方法的范围如下所示：`tableau:datasources:update`

## 范围类型

您使用的范围类型取决于您要启用的内容或管理操作。范围通常属于以下类型之一：内容读取、个人、通配符和跨类别。

- **内容读取范围：**内容读取范围 `tableau:content:read` 为 Tableau 内容启用受支持的 GET 方法。使用此范围时，您可以跨 REST API 类别启用操作。更具体地说，使用此范围可以为数据源、指标、视图、工作簿、项目和站点启用 GET 方法。从 Tableau Cloud2023 年 10 月 开始，您还可以在 JWT 中指定此范围，JWT 将用于创建与[元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/docs/meta_api_auth.html) 一起使用的凭据令牌。从 Tableau Cloud2025 年 2 月 开始，您还可以在 JWT 中指定此范围，JWT 将用于创建与 [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/zh-cn/index.html) 一起使用的凭据令牌。
    
    **注意：**若要为用户和组等管理操作启用 GET 方法，您可以使用它们的单独范围。
- **单独范围：**若要启用受支持的内容和管理操作，您可以使用它们的单独范围。单独范围通常与单个方法和 REST API 类别相关联。
    
    示例：
    
    - 若要启用发布或更新数据源操作，您可以分别使用单独的 `tableau:datasources:create` 或 `tableau:datasources:update` 范围。
    - 对于添加或移除用户等管理操作，您可以分别使用单独的 `tableau:users:create` 或`tableau:users:delete` 范围。
    
    **注意：**有一些单独的范围可以跨 REST API 类别启用操作。例如，`tableau:views:download`在视图数据和工作簿 REST API 类别中启用操作。
- **[通配符范围：](#wildcard)**对于某些范围，您可以将操作替换为通配符 (\*)，以启用特定 REST API 类别中支持的操作。
    
    示例：
    
    - 您可以使用 `tableau:projects:*` 通配符范围，用于在项目 REST API 类别中启用创建、删除和更新操作。
    - 您可以使用 `tableau:users:*` 通配符范围启用用户 REST API 类别中的获取/列出、添加、删除、更新操作。
    - 您可以使用 `tableau:tasks:*` 通配符范围启用数据提取和订阅 REST API 类别中的获取/列出、添加、删除、更新和运行操作。此外，此范围还支持更新数据源（如果是数据提取）和更新工作簿。
- **[跨类别范围：](#cross)**除了内容读取范围之外，还有一些额外的范围，如果使用它们，则支持跨不同 REST API 类别的操作。
    
    示例：
    
    - 如果使用 `tableau:tasks:run` 范围，您可以在数据源和工作簿 REST API 类别中启用操作。
    - 同样，如果使用 `tableau:views:download` 范围，您可以在视图数据和工作簿 REST API 类别中启用操作。
    - 如果使用权限范围 `tableau:permissions:update` 或 `tableau:permissions:delete`，您在数据源、工作簿和项目 REST API 类别中启用操作。

## 有关如何授权 REST API 访问的摘要

以下列表总结了通过 JWT 请求访问 REST API 的步骤：

1. 使用以下方法之一**创建已连接应用**：
    - [使用直接信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)
    - [使用 OAuth 2.0 信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm)
2. **生成有效的 JWT** — 在运行时，您的自定义应用程序将生成一个有效的 JWT，并使用您包含的范围进行配置
3. **发出[登录](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_authentication.htm#sign_in)请求** — 您的自定义应用程序将使用 JWT 发出登录请求以返回 Tableau 凭据令牌和站点 ID (LUID)
4. **在后续请求中使用 Tableau 访问令牌** — 在后续 REST API 调用中，使用 1) Tableau 凭据令牌作为 [`X-Tableau-Auth`](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_concepts_auth.htm#using_auth_token) 标头值，以及 2) 使用请求 URI 中的站点 ID (LUID)

### 示例

例如，假设您使用直接信任创建已连接应用。使用直接信任，调用 REST API 的自定义应用程序使用已连接应用生成的客户端 ID 和客户端密文生成有效的 JWT。

**JWT 中的范围**

若要成功授权对 REST API 的访问，JWT 还必须包含定义 REST API 能力的范围。例如，若要启用各种与数据源相关的方法，您可能会在 JWT 中包含以下范围：

`"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"`

或者

`"tableau:content:read","tableau:datasources:*","tableau:tasks:run"`

**注意：**范围值必须以列表类型方式传递。

**登录请求 URI**

若要调用 REST API，自定义应用程序必须首先发出登录请求以生成 Tableau 凭据令牌。

```
POST https://us-west-2b.online.tableau.com/api/3.16/auth/signin
```

**请求正文**

若要使用 JWT 授权 REST API 访问，登录请求正文必须包含有效的 JWT，如下例所示。

```
<tsRequest>
   <credentials jwt="eyJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJhbGciOiJIUzI1NiIsImtpZCI6ImIwMTE1YmY5LTNhNGItNGM5MS1iMDA5LWNmMGMxNzBiMWE1NiJ9.eyJhdWQiOiJ0YWJsZWF1Iiwic3ViIjoicm1vaGFuQHRhYmxlYXUuY29tIiwic2NwIjpbInRhYmxlYXU6c2l0ZXM6cmVhZCJdLCJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJleHAiOjE2NDg2Njg0MzksImp0aSI6IjY1ZWFmMmYxLTNmZTgtNDc5Ny1hZmRiLTMyODMzZDVmZGJkYSJ9.mUv2o4gtBTrMVLEXY5XTpzDQTGvfE2LGi-3O2vdGfT8">
    <site contentUrl="mycodotcom"/>
   </credentials>
</tsRequest>
```

**响应正文**

登录请求会生成以下响应正文，其中包括 Tableau 凭据令牌。

```
<tsResponse>
   <credentials token="12ab34cd56ef78ab90cd12ef34ab56cd">
    <site id="9a8b7c6d5-e4f3-a2b1-c0d9-e8f7a6b5c4d" contentUrl=""/>
    <user id="9f9e9d9c-8b8a-8f8e-7d7c-7b7a6f6d6e6d" />
   </credentials>
</tsResponse>
```

生成 Tableau 凭据令牌后，将其添加到所有后续 REST API 请求的标头中。

**标头**

X-Tableau-Auth:12ab34cd56ef78ab90cd12ef34ab56cd

然后，使用 Tableau 访问令牌的所有后续 REST API 请求都受 JWT 中的范围限制。

## 支持 JWT 授权的 REST API 方法

已连接应用的范围授予您的自定义应用程序代表用户访问 Tableau REST API 功能的权限

### 如何查找范围

您可以在 [Tableau REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api.htm) 帮助中 JWT 支持的方法的属性块中找到该方法所需的范围。如果方法的属性块中未列出范围，则 JWT 无法控制对该方法的访问。

例如，允许您在 Tableau REST API 中调用[查询站点](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_site.htm#query_site)方法的范围是 `tableau:sites:read`。

**注意：**

- 从 2023 年 6 月 (Tableau 2023.2) 开始，JWT 授权支持[登录](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_authentication.htm#sign_in)和[注销](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_authentication.htm#sign_out)方法，但不需要使用范围。
- 对于 Embedding API v3 支持的范围，请参见以下内容之一：
    - [使用直接信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)
    - [使用 OAuth 2.0 信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm)
- 从 2025 年 12 月开始，列出的范围还支持通过统一访问令牌 (UAT) 进行 REST API 授权。这意味着已连接应用和 UAT 范围是相同的。

### 范围类型

#### 关于通配符 (\*) 范围

通配符范围使用通配符 (\*) 而不是特定操作，以在特定 Tableau REST API 类别中启用多个受支持的操作。

#### 示例

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 25%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 75%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">范围</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">启用的方法</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:datasources:*</code></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"><code>tableau:metrics:*</code></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"><code>tableau:workbooks:*</code></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"><code>tableau:groups:*</code></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"><code>tableau:projects:*</code></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"><code>tableau:users:*</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">启用获取/列出、添加、删除和更新用户方法。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tableau:tasks:*</code><p><b>注意：</b>此范围也是跨类别的。</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">启用数据提取和订阅任务的获取/列出、添加、删除、更新和运行方法。<p>启用工作簿数据源的更新方法。</p></td></tr></tbody></table>

#### 关于跨类别范围

跨类别范围启用跨多个 Tableau REST API 类别的多个受支持的操作。

#### 示例

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1" style="width: 25%;"><col class="TableStyle-Basic-Border-Column-Column1" style="width: 75%;"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: center;">范围</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" style="text-align: center;">启用的方法</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:content:read</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">启用 Tableau 内容（包括数据源、指标、视图、工作簿、项目和站点）的读取/列出方法。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tableau:tasks:run</code></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"><code>tableau:views:download</code></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">启用视图数据和工作簿的下载方法。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tableau:tasks:*</code><p><b>注意：</b>此范围也是通配符。</p></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">启用数据提取和订阅任务的获取/列出、添加、删除、更新和运行方法。<p>启用工作簿数据源的更新方法。</p></td></tr></tbody></table>

## 故障排除范围

### 401001 - 登录错误

如果您遇到错误 401001，**登录**响应正文将附加以下附加的特定于已连接应用的错误代码之一：16、10084 或 10085。

例如，在以下响应正文中，“10084”是已连接应用错误代码，您可以使用它来帮助解决使用 JWT for REST API 授权登录 Tableau Cloud 的问题。

<error code="401001">  
  "summary": "Signin Error",
  "detail": "Error signing in to Tableau Cloud (10084)"
</error>

为帮助解决问题，请参阅适用的错误代码及其潜在原因的描述。

- **16：找不到用户** — 这个错误可能是因为指定了不正确的“`sub`”（用户名）

- **10084：无法解析访问令牌** — 出现此错误的原因可能如下：
    
    - JWT 无效或出现意外问题
    - 指定了不正确的“`aud`”（受众）
    - 对于直接信任，签署密文时出现问题
- **10085：无法获取密文以验证客户端 ID 的签名** — 出现此错误的原因可能如下：
    
    - 指定的“`iss`”中的客户端 ID 不正确
    - 对于直接信任，指定了不正确的“`kid`”（密文 ID）
    - 对于 OAuth 2.0 信任 ，无法从 JWKSource 获取密文

### 401002 - 未经授权的访问错误

如果您遇到错误 401002 并且已确认您具有发出请求的适当权限，请确保 JWT 中包含的范围是正确的并且与您尝试发出的请求相匹配。有关端点和受支持范围的列表，请参见上面[支持 JWT 授权的 REST API 方法](#scopes)部分。

<!-- document id=bd495e2a1cea3dcc73d5c2d5457f87bd528fdddc39612e75472b88ed5021f205 url=/tableau/next/zh-cn/online/dev_resources.md -->

[跳转到主要内容](#main-content)

# 开发人员资源

有关与扩展和自动化 Tableau 相关的一切问题，可访问 [Tableau开发人员门户](https://www.tableau.com/zh-cn/developer)。在那里，您可以访问：

- **JavaScript API** — 将 Tableau 视图整合到您自己的 Web 应用程序中。
- **Tableau Cloud Manager REST API** — 在租户中集中管理和配置多个 Tableau Cloud 站点及其用户。
- **Tableau REST API** — 通过 HTTP 在 Tableau Server 或 Tableau Cloud 上管理预置、权限和发布。利用 REST API，您可以访问数据源、项目、工作簿、站点用户和站点背后的功能。您可以使用此访问权限来创建自定义应用程序，或通过脚本与服务器资源交互。
- **Tableau SDK** — 使用 C、C++、Java 或 Python 根据任何数据创建数据提取，然后发布数据提取。
- **Tableau 元数据 API**— 使用 GraphQL，您可以发现和查询 Tableau 内容及相关的外部资产和元数据。
- **Web 数据连接器** — 在 JavaScript 中创建 Tableau 连接，以连接到几乎任何可通过 HTTP 访问的数据。这可能包括内部 Web 服务、JSON 数据、XML 数据、REST API 和许多其他来源。
- ODBC 连接器 — 使用 ODBC（开放式数据库连接）创建连接，ODBC 是一系列广泛的数据源支持的数据访问协议。在 Tableau Desktop 中，您可以使用内置的 ODBC 连接器连接到遵循 ODBC 的任何来源。

除了获得这些资源之外，您还可以获得完整的文档和示例，并与 Tableau 开发人员社区合作。

### **Tableau Cloud 用户须知**

- 对 Tableau Cloud 进行 REST API 调用时，您需要使用您的站点所在实例的 URL。例如，https://10ay.online.tableau.com/
    
    有关信息，请参见[使用 URI 来指定资源](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_fundamentals.htm#using_uris_for_resources)下的**为 Tableau Cloud 指定资源**。
- 并非 Tableau REST API 中提供的所有方法都适用于 Tableau Cloud。有关信息，请参见 [API 参考](https://help.tableau.com/current/api/rest_api/en-us/help.htm#REST/rest_api_ref.htm)中按类别列出的 API 列表。

[转到开发人员社区](https://community.tableau.com/s/topic/0TO4T000000QF8eWAG/developers)

<!-- document id=ec1a0153b86ba0ff24d1791eae8298b3f97f40191a52df1ac696c97c003ee404 url=/tableau/next/zh-cn/online/ipa_vconn_start.md -->

[跳转到主要内容](#main-content)

# 快速帮助

[连接到数据](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_connect.htm)

[关于虚拟连接编辑器](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_editor.htm)

[将表添加到连接](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_add_tables.htm)

[关于数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_data_policy.htm)

[创建和测试数据策略](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_create_data_policy.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=b4fa1cb6b3e43b1833d745ede1887c92dc13e8cb78309934fc193cfec89cb428 url=/tableau/next/zh-cn/online/ipa_server_quick_help_home.md -->

[跳转到主要内容](#main-content)

- [入门](https://help.tableau.com/current/pro/desktop/zh-cn/navigating.htm)

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/getstarted_36px_43x43.png) 了解 Tableau Cloud 的功能

- [快速帮助](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_start.htm)

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/producthelp_36px.png) 就您目前正在执行的操作获取帮助

- [发布亮点](https://help.tableau.com/v0.0/online/zh-cn/ipa_online_whats_new.htm)

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/whatsnew_36px.png) 了解 Tableau Cloud 的新增功能

- [培训](https://trailhead.salesforce.com/en/search?keywords=tableau+online)

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/training_36px.png) 视频培训和教程

- [疑难解答](https://help.tableau.com/current/online/zh-cn/to_refresh_troubleshoot.htm)

![添加图像的描述](/tableau/next/zh-cn/online/zh-cn/Img/troubleshoot_36px.png) 疑难解答和支持文章

## 此部分中的其他文章

<!-- document id=4d86cc4cfd2012d22a10cc27f3a2b0fa3f97b4bef7458fe111507b5e86331bd7 url=/tableau/next/zh-cn/online/qs_permissions.md -->

[跳转到主要内容](#main-content)

# 快速开始：权限

权限规则是一组能力，用于定义组或用户对内容（例如工作簿、项目或数据源）的访问权限。

若要有效地管理权限，请执行以下操作：

- 在创建更多组之前，从“所有用户”组中移除权限
- 在创建更多项目之前，在**“默认”**项目上配置模板权限
- 为组（而不是用户）管理权限
- 为项目（而不是内容）管理权限

## 为项目创建组权限规则

有关以下步骤的详细信息，请参见[有关权限的主要文章](https://help.tableau.com/current/server/zh-cn/permissions.htm)。本快速入门指南是一个概述，并没有包含有关权限和权限管理的许多重要细节。

### 1.将用户添加到组

管理权限的常用方法是为应该具有相同权限的用户使用组。

1. 如有必要，将用户添加到站点。
2. 在站点内，选择**“组”**。
3. 如有必要，使用 **“添加组”**选项创建组。
4. 单击组名称将其打开，然后使用**“添加用户”**按钮将现有用户添加到组中。

### 2.访问项目级别权限设置

“浏览”页面显示站点上的内容。使用下拉列表显示顶层项目或所有项目（也可以查看嵌套项目）。

导航到要更新的项目，打开“操作”(...) 菜单，然后选择“权限”。

![一个下拉菜单，其中包含共享、添加到收藏夹、重命名、移动、更改权限、更改所有者和删除项目的选项。](/tableau/next/zh-cn/online/zh-cn/Img/project_permissions_actionmenu.png)

### 3.创建权限规则

选择 **“+ 添加组/用户规则”**以创建新的权限规则。

模板下拉菜单提供一个快捷方式，用于为组应用初始能力集。

如果需要，通过单击某个能力以将其设置为**“允许”**或**“已拒绝”**，或将其保留为**“未指定”**，对权限规则进行自定义。

![项目的权限级别。](/tableau/next/zh-cn/online/zh-cn/Img/permissionrule.jpg)

用户是否可设置权限取决于用户的站点角色、内容所有权，以及其“设置权限”能力的设置方式。

### 4.查看用户的有效权限

为组保存权限规则之后，您可以查看每个用户的有效权限。单击组名称以查看该组的用户及其有效权限。将光标悬停在能力框上可看到一个工具提示，包含有关能力是已允许还是已拒绝的详细信息。

#### 站点角色

用户的站点角色确定为该用户允许的最大权限。

- 服务器和站点管理员可访问所有站点内容并对其执行操作。
- 所有者始终拥有其发布的内容的完全访问权限。如果父项目权限未锁定，所有者可以更改其发布的内容的权限。

有关详细信息，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)和[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)。

#### 权限逻辑

- **“已拒绝”**优先于**“允许”**。
- 如果未指定其他权限，则**“未指定”**将导致**“已拒绝”**。
- 内容的特定用户权限优先于内容的组权限。换句话说，用户权限优先于组权限。

有关详细信息，请参见[有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)。

<!-- document id=6b004b10a91c81a5496cb1478fbdd96802cab38f7562253cdf09eeab6b596bd4 url=/tableau/next/zh-cn/online/to_refresh_extract_manual.md -->

[跳转到主要内容](#main-content)

# 手动启动刷新任务

您可以直接在 Tableau Cloud 上刷新使用大部分云数据提供程序托管的数据的数据提取。您可以从 Tableau Bridge 中为在该处设置的数据源运行刷新。

如果数据源计划了刷新，则运行手动刷新不会影响计划。

## 在 Tableau Cloud 上运行刷新

1. 登录到向其发布数据源的 Tableau Cloud 站点。
2. 在“数据源”页面上，选择要刷新的数据源旁边的“更多操作”图标 (…)，然后从菜单中选择“立即刷新数据提取”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/data_source_refresh_manual_221x707.png)
3. 在“立即刷新数据提取”下，单击“增量刷新”或“完全刷新”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/data_source_refresh_now_617x132.png)

增量刷新

此选项仅获取新数据并将其附加到数据提取，从而缩短了下载时间。

完全刷新

此选项从头开始重建整个数据提取，这可能需要更长的时间，并且对数据库来说代价高昂。

**注意：** 对于已计划了刷新的数据源，站点管理员也可以通过“任务”\>“数据提取刷新”页面上的“动作”菜单启动刷新。

## 在 Tableau Bridge 客户端上运行刷新

从 Windows 系统托盘中打开 Tableau Bridge，并为数据源选择“立即运行”图标 (![](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_runnow_icon.png))。

<!-- document id=8c04efab4a26b3e3e3a3b55830c5dc2ccbb20eff792cfeec942b1d7d294c880d url=/tableau/next/zh-cn/online/spellcheck.md -->

[跳转到主要内容](#main-content)

# 拼写检查（仅限 Tableau Cloud 和 Tableau Server）

从 Tableau 2024.2 开始，您可以使用 Web 浏览器的内置拼写检查功能来识别拼写错误，并在 Tableau 中的以下富文本制作组件中找到文本内容的正确拼写建议：

- 工具提示
- 说明
- 工作表标题
- 仪表板标题
- 仪表板描述
- 图例标题
- 筛选器控件标题
- 参数控件标题
- 注释
- 荧光笔控件标题
- 页面控件标题
- 故事标题
- 故事描述
- 标记标签
- 可视化项替代文本
- 字段注释
- “编辑组和别名”对话框

在这些丰富的制作组件中输入文本时，系统会标记被识别为可能存在拼写错误的单词。举例来说，如果您使用的是 Google Chrome 或 Safari，单词下面会有一条红色波浪线。您可以右键单击该单词并从 Web 浏览器中查看拼写建议列表。

Tableau 属性目前不支持拼写检查，例如使用 SQL 元素创建自定义字段名称。

由于此功能由您的 Web 浏览器提供支持，因此浏览器提供的外观和拼写建议可能会略有不同。如果您的文本被错误标记，您可以将单词添加到您的 Web 浏览器的本地词库中。

您使用的 Web 浏览器确定了该功能是否启用以及支持哪些语言。如果您想关闭拼写检查，您可以通过 Web 浏览器的拼写检查设置来实现。

## 支持的浏览器和语言

Tableau 支持以下语言：英语（美国）、英语（英国）、荷兰语、法语（法国）、法语（加拿大）、德语、意大利语、西班牙语、巴西葡萄牙语、瑞典语、日语、朝鲜语、繁体中文、简体中文和泰语。

由于此功能由您的网络浏览器支持，因此请务必检查浏览器的文档以确认浏览器支持您所选语言的拼写检查。

<!-- document id=c7ff755a724e3b81a6778402624e823120dada82b12f3d97f00c8cb59d2d11c3 url=/tableau/next/zh-cn/online/to_bridge_troubleshoot.md -->

[跳转到主要内容](#main-content)

# 排查私有网络问题

Tableau Bridge 工作流的不同部分需要与 Tableau Desktop 和 Tableau Cloud 协调。根据您尝试完成的任务、您使用的基础数据、数据源的连接（实时连接或数据提取）以及您看到的症状，除了客户端本身之外，某些故障排查步骤可能要求您在以下一个或两个单独的产品中工作。

这些问题和帮助解决这些问题的步骤可能适用于数据源所有者或站点管理员。

## 了解升级后的常见问题

升级到 Bridge 后，您可能会注意到特定于 Bridge 的工作流发生了一些变化。

**无法配置 15 分钟或 30 分钟刷新**

Bridge 刷新计划仅每 60 分钟运行一次。但是，您可以对同一数据源制定多个刷新计划。为了使刷新更频繁地发生，请在同一数据源上设置四个刷新计划。然后让所有四个计划以 15 分钟为增量开始并每小时重复一次。这将导致每 15 分钟开始刷新一次。

**注意：**使用 Bridge 旧版计划时，数据源所有者必须是登录到指定用于刷新数据源的客户端的同一用户。根据组织管理客户端的方式，站点管理员可能需要拥有数据源的所有权。

**找不到“此数据提取刷新于”或“选择刷新的运行位置”按钮**

从 Bridge 2020.2 开始，Bridge 计划更好地与 Tableau Cloud 计划集成，可以直接在 Tableau Cloud 计划所在的同一位置访问和设置。有关 Bridge 计划的详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

**找不到“立即运行”选项**

Tableau Cloud 中的**“立即运行”**选项在使用 Bridge 旧版计划的数据源的个别数据源页面上不可用。在大多数情况下，只能从数据源链接到的客户端手动刷新使用 Bridge 旧版计划的数据源。

**无法刷新使用关系的数据源**

Bridge 2019.4（或更低版本）不支持使用 Tableau 2020.2（或更高版本）中的[关系](https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_desktop.htm#https://help.tableau.com/current/pro/desktop/zh-cn/whatsnew_desktop.htm#relate_data)创建的数据源。若要使私有网络数据保持最新，请确保运行最新版本的客户端。若要获取最新的客户端，请参见[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面。

**客户端中未列出或缺少某些数据源**

使用 Bridge 刷新计划或其计划已迁移为使用 Bridge 刷新计划的数据源在客户端中不可见。作为站点管理员，您可以使用“作业”页面监视包含 Bridge 刷新计划的数据源。有关详细信息，请参见[关于 Bridge 刷新作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm#bridge)。

使用实时查询和 Bridge 旧版计划（包括使用 Bridge 2020.1 及更低版本创建的计划）的数据源将继续显示在客户端中。

## 查找 Bridge

如果找不到 Bridge 客户端或使用 Bridge 的选项，请尝试下面的一条或多条建议。

**找不到 Bridge 安装程序**

若要下载客户端，请转到 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面，并单击下载按钮。有关 Bridge 安装程序和安装过程的详细信息，请参见 Tableau Cloud 帮助中的[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)主题。

**在我的计算机上找不到 Bridge**

在计算机上安装客户端之后，您可以执行以下任务之一来打开客户端：

- 双击桌面上的 Bridge 快捷方式 (![蓝白相间的标志，带有风格化的十字符号，代表 Tableau Bridge 快捷方式图标。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_shortcut.png))。
- 从桌面上的 Windows 系统托盘上，单击 Bridge 图标 (![带有黑色轮廓的白色加号。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_tray.png))。
- 使用 Windows 文件资源管理器，搜索“**Tableau Bridge**”来查找客户端。
- 如果在客户端所在的同一台计算机上安装 Tableau Desktop，请打开 Tableau Desktop，并选择“服务器”\>“启动 Tableau Bridge 客户端”。
    
    **注意：**如果使用 Tableau Desktop 2018.2 及更高版本，此任务将打开正确的客户端。如果使用 Tableau Desktop 2018.1 及更低版本，使用“启动 Tableau Bridge 客户端”选项将导致较旧版本的客户端打开。

**在发布对话框中找不到 Bridge 选项**

您在发布对话框中可能看不到 Bridge 选项的原因取决于您将什么发布到 Tableau Cloud：数据源还是工作簿。

如果要发布数据源： 

- 数据源基于文件。因此，在您将数据源成功发布到 Tableau Cloud _之后_，将显示使用 Bridge 的选项。
    
    成功发布数据源之后，您将看到“发布完成”对话框，当您在 Tableau Cloud 上工作时，该对话框允许您使用 Bridge 为基于文件的数据源计划刷新。有关在 Tableau Cloud 上时使用 Bridge 计划刷新的详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。
- 数据源连接到 Tableau Cloud 可直接访问的数据。
    
    如果 Tableau Cloud 可直接访问数据，您无需使用 Bridge 即可使数据保持最新。有关 Tableau 可用于直接访问数据的连接器的列表，请参见[允许实时连接到云平台上托管的数据](https://help.tableau.com/v0.0/online/zh-cn/to_connect_live_sql.htm#connectors)。
- 数据源连接到 Bridge 不支持的数据。
    
    有关 Bridge 可支持的连接器的列表，请参见[连接类型](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#connectors)。

## 解决安装问题

**使用 macOS 或 Linux**

macOS（操作系统）上不支持 Bridge。若要使用 Bridge，您必须使用 Windows 或 Linux 计算机。有关其他系统要求的详细信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#reqs)。

**计算机上的本地管理员**

您登录的 Windows 用户帐户必须是“本地管理员”组的成员。有关最低安装要求的详细信息，请参见[安装 Bridge 之前](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm#before)。有关系统要求的详细信息，请参见[关于 Bridge 客户端](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm#client-requirements)。

## 解决登录问题

**使用多个 Tableau Cloud 站点，或者 Bridge 登录到不正确的站点**

确保您输入客户端与之关联的 Tableau Cloud 站点的正确用户名和密码。如果您怀疑为站点保存了不正确的用户名和密码，或者客户端登录到了不正确的站点，请使用客户端中的“取消链接”选项移除其与站点的关联，并清除密码。

## 确定已计划刷新问题的原因

有很多症状可能表明计划的刷新未按预期方式执行。这些症状可能包括（但不限于）以下各项：

- 作为站点管理员或数据源所有者，您在 Tableau Cloud 上看到一条通知，指明计划的刷新无法完成。
- 作为站点管理员或数据源所有者，您从 Tableau 收到一条电子邮件通知，指明 Bridge 刷新无法完成。
- 作为数据源所有者，您收到来自 Tableau 的电子邮件通知，指明 Bridge 刷新无法按计划启动，原因是客户端未运行。
- 您在客户端中无法完成刷新的数据源旁边看到一条通知。
- 视图中的数据过时。

如果上述任何症状适用于您的情况，请按照下面的过程进行操作。如果该过程未解决您的问题，则尝试该过程下方的一项或多项任务，以帮助确定刷新问题的原因。

1. 打开客户端，单击数据源，然后单击“详细信息”按钮查看错误消息。
2. 如果错误消息未提供用于解决问题的足够信息，请转到 [Tableau 知识库](https://www.tableau.com/zh-cn/support/knowledgebase)并搜索刷新问题。

**重要信息：**如果看到“There was a problem and the data engine could not start properly”（存在问题，数据引擎无法正常启动）错误消息，并且您正在运行客户端版本 2018.2-2018.3，Tableau 强烈建议升级到版本 2019.1 或更高版本。有关详细信息，请参见 Tableau 知识库中的[出现“There was problem and the data engine could not start properly”错误](https://kb.tableau.com/articles/Issue/error-there-was-problem-and-the-data-engine-could-not-start-properly-when-refreshing-data-in-tableau-bridge?lang=zh-cn)一文。

如果 Tableau 知识库未解决您的特定问题，则尝试以下一项或多项任务：

- **在客户端中验证身份验证信息：**如果数据源需要身份验证，请确保客户端引用了正确的数据库凭据，即使已经在 Tableau Cloud 中引用了数据库凭据。有关在客户端中嵌入数据库凭据的信息，请参见[嵌入或更新数据库凭据](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#embed-credentials)。
- **升级客户端：**升级到最新版本的客户端。您可以从 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面获取最新版本的客户端。有关安装的详细信息，请参见[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)。  
    **注意：**由于存在使 Bridge 2018.2-2018.3 无法执行数据提取刷新的错误，因此 Tableau 强烈建议您升级到 Bridge 2019.1 或更高版本。
- **确保客户端正在运行：**例如到安装了客户端的计算机，并确保客户端正在运行。验证客户端是否正在运行之后，可以运行数据源的手动刷新，或者等待下一次计划刷新。

- **确认基于文件的数据源使用 UNC 路径：**如果使用 Bridge 旧版计划处理基于文件的数据源，请确保客户端引用 UNC 路径。有关详细信息，请参见[更改数据源的文件路径](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#file-path)。
- **确认是否满足了应用程序模式或服务模式要求：**如果客户端设置为在“应用程序”模式下运行，您必须登录到运行客户端的计算机，计划的刷新才能完成。如果客户端设置为在“服务”模式下运行，则不必登录到运行客户端的计算机。但是，计算机必须已开启。
- **确认 Bridge 支持数据源中的所有连接：**
    
    如果刷新多连接数据源（即使用跨数据库联接的数据源），请确保 Bridge 支持数据源中的所有连接。如果一个或多个连接不受支持，则在移除不支持的连接之前 Bridge 将无法刷新数据源。有关支持的连接的列表，请参见[连接类型](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#connectors)。若要从数据源中移除连接，您必须在 Tableau Desktop 中编辑数据源。有关详细信息，请参见 Tableau 知识库中的[编辑发布的数据源](https://kb.tableau.com/articles/HowTo/edit-a-published-data-source?lang=zh-cn)。
- **手动刷新数据源：**手动刷新数据源可帮助确定问题是由客户端还是 Bridge 工作流的不同部分（例如从 Desktop 或数据源本身发布）导致的。
    
    - **通过客户端** - 若要确定问题是隔离到特定的已计划刷新还是客户端管理的所有已计划刷新，请从客户端中执行已发布数据源的手动刷新。
        
        1. 打开客户端。
        2. 将光标悬停在其计划刷新未工作的数据源上，并单击“立即运行”图标 (![立即运行图标。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_runnow.png)) 手动开始刷新。
        
        如果手动刷新成功，则可以通过一种临时解决方法来解决刷新问题。如果刷新未成功，请在客户端中查看错误来帮助解决问题。
    - **通过 Tableau Desktop** - 若要问题是客户端问题还是已发布数据源的问题，您可以从 Tableau Desktop 中执行数据源的手动刷新。
        
        1. 打开 Tableau Desktop。
        2. 在“连接”窗格中，单击“Tableau Server”，并连接到未刷新的已发布数据源。
        3. 从“数据”菜单上，选择数据源，然后选择“Tableau 数据服务器”\>“源刷新”。
        
        如果从源刷新成功，则可以通过一种临时解决方法来解决刷新问题。如果刷新未成功，并出现客户端中显示的相同错误，请在 Tableau 网站上与 [Tableau 技术支持](https://www.tableau.com/zh-cn/support/case)联系。
    - **通过 Tableau Desktop，创建数据源的本地副本** - 若要确定问题总体而言不是发布过程或 Tableau Cloud 的问题，请首先创建一份本地副本，然后手动刷新发布的数据源。
        
        1. 打开 Tableau Desktop。
        2. 在“连接”窗格中，单击“Tableau Server”，并连接到未刷新的已发布数据源。
        3. 从“数据”菜单中选择数据源，然后选择“创建本地副本”。
        4. 从“数据”菜单中选择数据源的本地副本，然后选择“刷新”。
        
        如果通过数据源的本地副本刷新成功，则可以通过一种临时解决方法来解决刷新问题。问题可能是发布流程的问题。
- **使用 Tableau 数据提取命令行实用工具刷新数据源：**使用 Tableau 数据提取命令行实用工具刷新数据源是另一种方法，用于区分问题是特定于客户端的问题，还是数据源或 Bridge 工作流其他部分的问题。此方法还提供了刷新数据提取的自动化方式或临时方式。有关设置和使用 Tableau 数据提取命令行实用工具的详细信息，请参见[从命令行中自动执行数据提取刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_commandline.htm)。
    
    如果通过命令行实用工具刷新成功，则可以通过一种临时解决方法来解决刷新问题。如果刷新未成功，请在 Tableau 网站上与 [Tableau 技术支持](https://www.tableau.com/zh-cn/support/case)联系。
- **计划刷新似乎未按计划运行：**
    
    Tableau Cloud 升级到 2019.2 后，当即将进行的计划刷新由于客户端未运行的原因而无法启动时，数据源所有者可能会收到多个电子邮件通知。由于数据源所有者每天最多可能收到他们拥有的多达十个数据源的连续五个电子邮件通知，因此，计划刷新未按预定时间运行。作为数据源所有者，您可能会出于以下原因收到通知：
    
    - **客户端从中运行的计算机未打开。**若要在这种情况下停止通知，请在即将进行的计划刷新要执行之前确保安装了客户端的计算机已打开，并且客户端本身正在运行。或者，如果数据提取数据源不需要定期刷新，请考虑移除计划，并在需要时从客户端中手动刷新它。有关移除计划的详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#remove-schedule)。
    - **数据提取数据源继续与不再使用的客户端关联。**若要在这种情况下停止通知，站点管理员可以将客户端从站点中删除。有关详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#remove-client)。  
        如果您不是站点管理员，请考虑进行以下操作：
        - 如果不需要刷新数据提取数据源，您可以从客户端中移除数据源。有关详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#remove-ds)。
        - 如果需要刷新数据提取数据源（尽管不频繁），您可以更改与该提取数据源关联的客户端（及其计划）。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#change-computer)。

**使用基于 JDBC 的连接的数据源刷新停止响应**

**注意：**Bridge 对使用 JDBC 驱动程序连接到不受支持的数据库的数据源提供有限的支持。有关详细信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#limited)。

其连接依赖于基于 JDBC 的驱动程序的数据提取数据源的刷新可能会因超时错误而失败，或者由于 CPU 或 RAM 峰值，刷新本身停止响应或挂起。在大多数情况下，当使用基于 JDBC 的连接的数据源有多个并发刷新时，可能会发生这些刷新问题，这些数据源由没有足够硬件来支持资源密集型基于 JDBC 的连接的计算机上的客户端处理。为了帮助解决此类问题，请查看以下建议：

- **如果您是管理组织中客户端的站点管理员**，请查看位于“我的 Tableau Bridge 存储库”的 Logs 文件夹中的日志文件 _jprotocolserver\_<进程 id>_ 和 _stdout\_jprotocolserver\_<进程 id>_。然后，考虑以下各项之一：
    
    - 减少客户端允许的并发刷新次数。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#poolcapacity)。
    - 考虑增加运行 Bridge 客户端的计算机上的 CPU 内核和 RAM，以更好地处理基于 JDBC 的资源密集型连接。
- **如果您是数据源所有者**，请更新数据源以改用 Tableau 内置连接器。有关详细信息，请参见 Tableau 用户帮助中的[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)。

**将网络类型更改为专用网络后的刷新问题**

更新与数据源关联的网络类型后，从 Tableau Cloud 到 专用网络，或者从专用网络到 Tableau Cloud，必须重新创建与数据源关联的现有计划。有关详细信息，请参见[关于切换网络类型](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm#vpc_type_change)。

**已发布数据源有多个数据连接时的刷新问题**

将基于文件的在线数据源发布到 Tableau Cloud 后，当已发布数据源具有多个数据连接时，数据提取刷新可能会失败。默认情况下，当已发布数据源具有多个数据连接时，Tableau Cloud 使用 Bridge。您可以编辑 Bridge 刷新计划的数据提取刷新连接类型，以使用 Tableau Cloud 而不是 Bridge。有关详细信息，请参见[更改刷新的连接类型以使用 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#use_cloud)。

**从 Mac 版 Tableau Desktop 发布的基于文件的数据的刷新问题**

在 Mac 上使用 1) Tableau Desktop、2) 从 Windows 网络文件共享发布基于文件的数据源以及 3) 配置 Bridge 刷新计划时，刷新将失败。如果此基于文件的数据源是您组织的业务关键资源，请考虑改为配置 Bridge 旧版计划。有关详细信息，请参见[设置 Bridge 旧版计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#Set)。

## 确定实时查询问题的原因

实时查询问题通常是由于选项未启用 Bridge 不支持数据源类型所导致的。

**客户端中未列出“实时”数据源**

需要满足一些条件才能使“实时”数据源显示在客户端中。首先，站点管理员必须为站点启用池化。其次，站点管理员还至少必须向池中添加一个客户端。最后，必须使用实时连接发布数据源。必须满足全部三个条件才能使“实时”数据源显示在客户端中。

**发布期间用于使用实时连接进行发布的选项或“维护实时数据源连接”选项缺失**

Tableau Cloud 站点管理员必须通过池化启用使用 Bridge 支持私有网络数据源实时查询的选项。如果在发布过程中无法使用该选项，请考虑与站点管理员联系来启用选项。如果您是站点管理员，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。

将会提示您输入数据库凭据

如果数据源需要数据库身份验证，则必须在发布时将凭据嵌入在数据源中。如果凭据在发布时未嵌入数据源，则可以在 Tableau Cloud 上将凭据添加到发布的数据源。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 在数据源页面的“连接”选项卡上，选中连接旁边的复选框。
3. 从“操作”菜单中，单击“编辑连接”。
4. 选择“连接中的嵌入式密码”，并输入必要的数据库凭据。
    
    ![允许用户修改数据连接的窗口。](/tableau/next/zh-cn/online/zh-cn/Img/to_datasource_live_embedcredentials.png)

**您在使用基于文件或基于统计文件的数据源**

Bridge 不支持包含基于文件和基于统计文件的数据源实时连接的数据源。若要针对这些类型的数据源使数据保持最新，您可以改为发布数据提取，并为每个数据源设置刷新计划。有关 Bridge 支持的连接器的列表，请参见[连接类型](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#connectors)。有关设置刷新计划的详细信息，请参见[设置私有网络刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm)。

**数据源在客户端中未显示为“实时”：**

如果数据源在客户端中未显示为“实时”，则数据源可能是以数据提取形式发布的。若要验证数据源是否是以数据提取形式发布的，请执行下面的步骤。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 在数据源页面上，检查数据源是否具有“数据提取刷新”选项卡或数据提取图标 (![数据提取图标。](/tableau/next/zh-cn/online/zh-cn/Img/to_ds_extract.png))。如果数据源显示该选项卡，则它是以数据提取形式发布的。
    
    ![数据提取的库存页面及其刷新计划。](/tableau/next/zh-cn/online/zh-cn/Img/to_datasource_extract.png)

为了解决该问题，请从 Tableau Desktop 中重新发布数据源，同时确保选择“维护实时数据源连接”选项。此选项指示 Bridge 维护与数据的实时连接。

![用于将数据源发布到 Tableau Online 的对话框，其中带有实时连接或创建数据提取的选项。](/tableau/next/zh-cn/online/zh-cn/Img/to_publish_bridge_live.png)

**客户端在应用程序模式下运行**

如果使用 Bridge 2018.2 及更高版本，在站点管理员启用池化之后，应用程序模式和服务模式下均支持实时查询。但是，如果客户端在应用程序模式下运行，您必须登录才能保持数据最新。

如果使用 Bridge 2018.1 及更低版本，即使站点管理员启用了实时查询，Bridge 也无法在应用程序模式下支持实时查询。客户端必须在服务模式下运行才能支持实时查询。

有关在应用程序模式或服务模式下运行客户端的详细信息，请参见[应用程序模式与服务模式](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm#mode)。

## 了解其他常见问题

**客户端中的数据源列表填充之前出现延迟**

在客户端中填充数据源列表时会出现短时间的延迟（通常为几秒钟）。这是一种预期行为。客户端会与 Tableau Cloud 联系来获取数据源的列表，然后才能显示该信息。

**客户端中出现“找不到链接的数据”**

如果客户端显示绿色指示符和“已连接”状态，但同时显示“找不到链接的数据”，请根据您期望看到的数据源的类型查看以下建议。

如果期望看到使用 Bridge 旧版计划的数据提取数据源列在客户端中，请尝试以下操作：

- 验证是否为正确的客户端分配了数据提取刷新计划。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#add-computer)。

如果期望看到包含实时连接的数据源或使用 Bridge 刷新计划的数据提取数据源，请尝试以下一项或多项操作：

- 验证数据源是否是使用实时连接发布的。
    
    1. 登录到 Tableau Cloud，并导航到数据源。
    2. 从数据源页面中，检查数据源是否具有“数据提取刷新”选项卡或数据提取图标 (![数据提取图标。](/tableau/next/zh-cn/online/zh-cn/Img/to_ds_extract.png))。如果数据源显示该选项卡，则它是以数据提取形式发布的。
        
        ![数据提取的库存页面及其刷新计划。](/tableau/next/zh-cn/online/zh-cn/Img/to_datasource_extract.png)
- 确保池中至少包含一个客户端，以方便包含实时连接的数据源。为此，请与站点管理员联系。如果您是站点管理员，请验证是否已为站点和客户端启用了池化。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#set-up-bridge-client)。

**客户端中显示红色指示符和“断开连接”状态**

如果客户端显示红色指示符和“断开连接”状态，请按所列顺序尝试以下任务：

1. 在客户端菜单中，单击“修复”。
2. 如果第 1 步未解决问题，请从“模式”下拉菜单中选择“应用程序”，并等待几秒钟。切换回“服务”，并再等待几秒钟。
3. 如果步骤 2 未解决问题，请重新启动计算机。确保没有正在进行的已计划刷新。

在某些情况下，如果客户端在“已锁定”的计算机上运行，客户端会显示红色指示符和“断开连接”状态。这意味着客户端被限制为只能连接最少量的域。有关客户端需要连接才能工作的最少量域的列表，请参见[转发代理筛选](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_security.htm#domain_filtering)。

**缺少订阅电子邮件**

依靠 Bridge 使数据保持最新的视图和工作簿不支持由数据刷新发起的[订阅](https://help.tableau.com/current/online/zh-cn/subscribe_user.htm)。这意味着在满足以下条件时，您不会收到订阅电子邮件：1）为“数据刷新时”配置了订阅，以及 2）您所订阅的视图或工作簿依赖于使用 Bridge 刷新的数据提取数据源。若要在这种情况下使用订阅，请考虑将订阅配置为改为使用“按选定计划”。有关详细信息，请参见[订阅疑难解答](https://help.tableau.com/v0.0/online/zh-cn/subscribe_trouble.htm#cant-set-subscription-frequency-to-when-data-refreshes)。

**“测试连接”按钮不支持 Bridge 连接**

“测试连接”仅支持连接到 Tableau Cloud 的数据源。作为使用此按钮测试连接的替代方法，请考虑改为运行手动刷新来测试连接。有关运行手动刷新的详细信息，请参见[手动启动刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_manual.htm)。

## 了解常见错误

使用 Bridge 时，您可能会看到以下错误之一。

_“An error occurred while communicating with Tableau Server: Tableau Bridge does not have a client configured for your site to handle live connections."_”与 Tableau Server 通信时出错：Tableau Bridge 没有为您的站点配置客户端来处理实时连接。）或“_Cannot connect to database_”（无法连接到数据库）

在连接到其数据新鲜度通过 Bridge 来促进的已发布数据源时，您可能会看到此错误。若要解决这些错误，请按照所列顺序尝试以下任务：

- 确保客户端已添加到池中。为此，请与站点管理员联系。如果您是站点管理员，请验证是否已为站点和至少一个客户端启用池化。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#set-up-bridge-client)。
- 确保客户端显示绿色指示符和“已连接”状态。如果它显示红色或“断开连接”状态，请参见[客户端中显示红色指示符和“断开连接”状态](#disconnected)。

“_This data source requires a correct file path_”（此数据源需要正确的文件路径）或“_Unable to refresh data source because of an unsupported operation_”（由于不支持的操作而无法刷新数据源）

如果正在处理基于文件或基于统计文件的数据源（使用 Bridge 旧版计划），由于客户端引用的路径是映射驱动器路径（而不是 UNC 路径），您可能会看到此错误。为了解决此问题，您必须在客户端中更新文件位置路径。有关详细信息，请参见[更改数据源的文件路径](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#file-path)。

在 Tableau Cloud 上刷新时，您可能会看到以下错误：

**“Error: Failed to queue _n_ tasks”（错误：未能对 n 个任务进行排队）**

如果选择对多个数据源使用“立即运行”选项，并且一个或多个数据源连接到文件数据，则可能发生此错误。“立即运行”选项只能用于使用 Bridge 刷新计划的数据源。

### 虚拟连接

尝试创建虚拟连接时，您可能会看到以下错误之一： 

- **INVALID\_ARGUMENT（无效参数）**：
    
    “_INVALID\_ARGUMENT: Can't display the view because of Tableau Cloud site settings that affect the data source used by this view.Contact your site administrator to connect at least one Tableau Bridge client to the site（无效参数：无法显示视图，因为 Tableau Online 站点设置会影响此视图使用的数据源。联系您的站点管理员以将至少一个 Tableau Bridge 客户端连接到站点。）_”
    
    当池中没有 Bridge 2021.4 客户端为连接私有网络数据的虚拟连接执行数据新鲜度任务时，可能会发生此错误。为了解决此错误，请联系您的站点管理员以确保版本 2021.4 客户端正在运行并处于已连接状态，并且池已映射到基础数据所在的域。
- **UNKNOWN（未知）**：
    
    “_UNKNOWN: There was an unknown connection error to the database.The error message below has additional information, but you might need to ask the database administrator to review the database logs（未知：数据库出现未知连接错误。下面的错误消息包含其他信息，但您可能需要让数据库管理员查看数据库日志。）_”
    
    当虚拟连接的基础数据所在的域没有映射到特定的 Bridge 池时，可能会发生此错误。为了解决此错误，请联系您的站点管理员以确保将基础数据所在的域映射到 Bridge 池，并且至少有一个 Bridge 2021.4 客户端正在运行、处于连接状态并已分配给池。

## 准备日志文件并将其发送给 Tableau 技术支持部门

如果本文中的疑难解答步骤未能帮助隔离或解决使用 Bridge 时遇到的问题，您可以联系 Tableau 来获得帮助。在联系 Tableau 获取帮助之前，请考虑执行以下步骤来收集并发送必要的 Bridge 客户端日志文件，Tableau 将需要这些文件来诊断和帮助解决问题。

### 准备清理日志文件

**在 Windows 客户端上：**

1. 在计算机上，关闭客户端：
    
    - 如果客户端在应用程序模式下运行，请从客户端菜单中选择“退出”。
    - 如果客户端在服务模式下运行，请将客户端更改为应用程序模式，然后从客户端菜单中选择“退出”。
2. 转到并打开“**我的 Tableau Bridge 存储库**”文件夹。
    
    “我的 Tableau Bridge 存储库”文件夹的默认位置为 C:\\Users\\jsmith\\Documents\\我的 Tableau Bridge 存储库。
3. 在“我的 Tableau 存储库”文件夹中，重命名 **Log** 文件夹。例如，Logs\_archive。通过更改此文件夹的名称，客户端将创建一个新的“日志”文件夹。
4. 以管理员身份打开命令提示符。
5. 切换到 Tableau Bridge bin 文件夹。例如：C:\\Program Files\\Tableau\\Tableau Bridge\\bin。
6. 运行以下命令：`TabBridgeClient.exe -DLogLevel=Debug`
    
    **注意：**上述命令区分大小写。如果命令未严格按所示方式键入，则日志文件将不会以帮助诊断问题的所必需的详细级别捕获问题。
    
    此步骤之后，客户端将自动打开。

**在 Linux 客户端（容器）上：**

1. 以 root 管理用户身份打开 shell 终端会话并设置日志环境变量：  
    `export TAB_ENV_LOGLEVEL=debug`
    
    此命令区分大小写。
2. 启动 Bridge 应用程序服务。

  
export TAB\_ENV\_LOGLEVEL=debug  

### 重现问题

准备好客户端来创建新的日志文件之后，请尝试重现您使用 Bridge 时遇到的问题。通过重现问题，新的日志文件可以捕获有关问题的特定详细信息。这些详细信息是 Tableau 隔离、诊断和解决问题所必不可少的。

### 发送日志文件

1. 重现问题后，右键单击 Windows 系统托盘中的 Bridge 图标，然后选择“退出”停止 Bridge。此步骤可确保所有错误都记录在日志文件中。
2. 使用 Windows 文件资源管理器，转到并打开“**我的 Tableau Bridge 存储库**”文件夹。
3. 右键单击“**Logs**”文件夹，并选择“**发送至**”>“**压缩文件夹**”。
4. 请在 Tableau 网站上与 [Tableau 技术支持](https://www.tableau.com/zh-cn/support/case)联系。
    
    **注意：**如果您在步骤 2 中创建的 .zip 文件大于 5 MB，请参见 Tableau 知识库中的[发送大文件](https://kb.tableau.com/articles/howto/alternative-method-for-sending-large-files?lang=zh-cn)。
5. 找到并启动 Bridge。如果客户端以前在服务模式下运行，请确保在客户端中选择“服务”。

<!-- document id=cdb8eb177af0ed51a6c107c2e32f2ff5962c3f41701427c7e539b5442791d619 url=/tableau/next/zh-cn/online/to_refresh_troubleshoot.md -->

[跳转到主要内容](#main-content)

# 排查刷新问题

如果 Tableau Cloud 无法完成计划的刷新，则会出现通知以指明刷新已失败。如果计划的刷新连续失败 5 次，则 Tableau Cloud 会暂停刷新。挂起刷新后，Tableau Cloud 不会尝试重新运行刷新，直到采取措施尝试更正失败原因为止。

若要显示一个描述刷新失败原因的通知，请在浏览器窗口的右上角选择通知图标 (![新通知图标。](/tableau/next/zh-cn/online/zh-cn/Img/notification_indicator.png))。

### 解决错误并恢复挂起的刷新

为了帮助解决刷新问题，可以根据通知中指明的原因采取任何以下措施：

- **与访问令牌验证或用户凭据相关的错误**
    
    若要更正这些问题，请单击通知中的“连接详细信息”链接，转到计划失败的数据源的数据源页面上的“连接”选项卡。在“连接”选项卡上，选择数据连接旁边的复选框，然后单击“编辑连接”，以便可以更新用户名或密码，或选择其他访问令牌。更新连接信息之后，Tableau Cloud 会重启刷新计划。
    
    ![编辑数据提取的连接。](/tableau/next/zh-cn/online/zh-cn/Img/refresh_troubleshoot_connectionstab.png)
    
    从 Tableau Desktop 发布工作簿或数据源时，如果您最初嵌入了凭据或其他数据连接信息，则您也可以重新发布工作簿或数据源。在发布过程中，您可以选择设置一个新的刷新计划。否则，Tableau Cloud 会重新启动现有计划。
- **表明数据库无法访问的错误**
    
    确认基础数据库处于联机状态并且您可以登录以访问其数据。您可以使用通知中的“重试”链接重启刷新计划。
- **与 Tableau Bridge 相关的错误**
    
    若要排查与 Bridge 相关的错误，请参见[排查私有网络问题](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm)。
- **与 Tableau Prep 相关的错误**
    
    若要排查与 Tableau Prep 相关的错误，请参见[监视流程运行状况](https://help.tableau.com/current/online/zh-cn/prep_conductor_monitor_flow.htm)。

<!-- document id=b5c17791921e6dc168f07662d210ce0b4a9d94ef6d669e49fe586420b6ca01d0 url=/tableau/next/zh-cn/online/explain_data_control_access.md -->

[跳转到主要内容](#main-content)

# 控制对“数据解释”功能的访问

您对“数据解释”功能的访问将根据您的站点角色和内容权限而有所不同。在 Tableau Desktop 中，作者始终可以使用“数据解释”功能。具有编辑权限的作者可以在 Tableau Cloud 和 Tableau Server 中的编辑模式下运行“数据解释”功能。

作者还可以控制“数据解释”功能在已发布工作簿中的查看模式下是否可用，以及显示哪些解释类型。

请注意，“数据解释”功能可以显示数据源中未在视图中表呈现的维度和度量中的值。作为作者，您应该运行“数据解释”功能并测试结果解释，以确保敏感数据不会在您发布的工作簿中公开。

## 谁可以访问“数据解释”功能

默认情况下在站点级别启用“数据解释”功能。服务器管理员 (Tableau Server) 和站点管理员 (Tableau Cloud) 可以控制“数据解释”功能是否可用于站点。有关详细信息，请参见[为站点禁用或启用“数据解释”功能](https://help.tableau.com/v0.0/online/zh-cn/explain_data_enable.htm)。

<table class="table--plain"><colgroup><col style="width: 30%;"><col style="width: 70%;"></colgroup><thead><tr><th class="table--plain" style="text-align: left;">模式</th><th class="table--plain" style="text-align: left;">谁可以访问</th></tr></thead><tbody><tr><td class="table--plain"><p><b>查看模式</b></p></td><td class="table--plain"><p>具有“运行‘数据解释’功能”权限能力的 Tableau <b>Viewer（查看者）</b>、<b>Explorer</b>和 <b>Creator</b> 可以在查看模式下运行和探索“数据解释”功能的解释。</p></td></tr><tr><td class="table--plain"><p><b>编辑模式</b></p><p style="font-weight: bold;">&nbsp;</p></td><td class="table--plain"><p>Tableau <b>Creator</b> 可以在 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>、Tableau Cloud 或 Tableau Server 中编辑视图时运行“数据解释”功能。具有“运行‘数据解释’功能”能力和编辑权限的 <b>Explorer</b> 可以在 Tableau Cloud 或 Tableau Server 中编辑工作簿时运行“数据解释”功能。</p><p>具有编辑权限的 Creator 和 Explorer 可以打开新工作表进行进一步分析。</p><p>他们还可以使用“数据解释设置”来控制谁可以使用“数据解释”功能以及他们可以看到什么。</p></td></tr></tbody></table>

## 控制谁可以使用“数据解释”功能以及他们可以看到什么

必须启用设置组合，才能在 Tableau Cloud 和 Tableau Server 的编辑模式和查看模式下使用“数据解释”功能。

### 编辑模式

作者在编辑模式下运行“数据解释”功能或编辑“数据解释”功能设置的要求：

- 站点设置：将“‘数据解释’功能的可用性”设置为“启用”。默认情况下处于启用状态。
- 站点角色：Creator 或 Explorer（可发布）。
- 权限：将“运行数据解释”能力设置为“允许”。默认情况下未指定。如果您在 Tableau 版本 2022.2 或更高版本中打开使用此权限的工作簿（Tableau 版本 2022.1 或更低版本），则需要将“运行数据解释功能”能力重置为“允许”。

**注意：**Creator 或 Explorer（可发布）的“下载完整数据”能力控制他们是否在“极端值”解释中看到“查看完整数据”选项。Viewer（查看者）总是被拒绝“下载完整数据”能力。但是，当在“数据解释”功能设置中启用“极端值”解释类型时，所有用户都可以看到记录级别详细信息。

具有编辑权限和“运行‘数据解释’功能”权限能力的 Creators 和 Explorer 可以访问**“数据解释设置”**，它提供了用于控制的选项：

- “数据指南”窗格中[显示的解释类型](#ControlExpTypes)。
- 统计分析中[包括或排除的字段](#ControlFields)。

这些选项是为整个工作簿设置的，只能在“数据解释设置”对话框中设置。

### 查看模式

所有用户在查看模式下运行“数据解释”功能的要求：

- 站点设置：将“‘数据解释’功能的可用性”设置为“启用”。默认情况下处于启用状态。
- 站点角色：Creator、Explorer 或 Viewer（查看者）
- 权限：将“运行数据解释”能力设置为“允许”。默认情况下未指定。如果您在 Tableau 版本 2022.2 或更高版本中打开使用此权限的工作簿（Tableau 版本 2022.1 或更低版本），则需要将“运行数据解释功能”能力重置为“允许”。

**注意**：若要查看数据指南中对检测到的异常值的解释，可视化项的用户必须拥有工作簿或视图允许的“数据解释”权限。工作簿的所有者需要在 Tableau Server 或 Tableau Cloud 中打开此工作簿的权限设置，并向该用户授予“数据解释”权限。

### 打开“数据解释设置”对话框

1. 从“分析”菜单中，选择“数据解释设置”。或者，在“数据指南”窗格中，单击设置图标（右下角）。  
      
    ![“数据解释设置”图标，以齿轮的形式呈现。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_settingsbutton.png)

### 包括或排除“数据解释”功能显示的解释类型

具有编辑权限的 Creator 和 Explorer 可以选择为所有工作簿用户排除（或包括）显示的解释类型。

1. 在**[“数据解释设置”](#OpenEXDsettings)**对话框中，单击“解释类型”选项卡。  
      
    ![“数据解释”功能的解释类型列表，其中带有用于选择或取消选择每种类型的复选框。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_explanationtypes.png)
2. 在解释类型列表中，选择或清除解释类型。
3. 单击“确定”。

通过保存并关闭已发布工作簿来测试设置，然后在查看模式下从工作簿中打开一个视图。选择一个通常有“极端值”解释的标记，然后运行“数据解释”功能来检查解释结果。

### 包括或排除用于统计分析的字段

具有编辑权限的 Creator 或 Explorer 可以选择排除（或包括）符合分析条件的字段。

1. 在“数据指南”窗格（右下角）中，选择设置图标。或者，选择[“已分析字段”视图](https://help.tableau.com/v0.0/online/zh-cn/explain_data_lm_status.htm#ViewAnalyzed)中的“编辑”按钮。  
      
    ![“已分析字段”窗格上的“编辑”按钮。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_editfields.png)
2. 在**[“数据解释设置”](#OpenEXDsettings)**对话框中，单击“字段”选项卡。
3. 在“包括”下的字段列表中，单击下拉箭头并选择“自动”以在每次为该工作簿运行“数据解释”功能时包括符合条件的字段。  
      
    请注意，要包括在分析中的字段必须少于 500 个唯一值。  
      
    ![“数据解释设置”窗口，其中选择了一个度量，并且下拉菜单展开以显示包含或排除该字段的选项。](/tableau/next/zh-cn/online/zh-cn/Img/explaindata_excludefield.png)  
      
    选择“从不包括”以明确排除该字段。  
    选择“不包括任何内容”以在不考虑字段的情况下对数据运行统计分析。  
    选择“重置”以恢复为默认设置。
4. 单击“确定”。

通过保存已发布工作簿来测试设置。选择一个标记，然后运行“数据解释”功能来检查解释结果。

## 配置 Tableau 以允许用户通过电子邮件和 Slack 共享解释

Tableau 管理员可以控制解释是否可以通过电子邮件或 Slack 在查看模式下共享给其他 Tableau 用户。

按照以下步骤，在 Tableau Cloud 或 Tableau Server 中允许通过电子邮件和 Slack 进行通知和共享：

1. 单击“设置”。
2. 在“常规”选项卡上，向下滚动到“管理通知”。
3. 对于“协作”，请针对“在 Tableau 上”、“电子邮件”和“Slack”选择“共享”。

若要通过 Slack 共享解释，必须为您的 Slack 工作区设置 Tableau 应用程序。Tableau Cloud 中默认启用使用 Slack 共享解释。

在 Tableau Server 中，管理员需要针对 Slack 设置 Tableau 应用程序。有关详细信息，请参见[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/current/server/zh-cn/slack_admin.htm)。

<!-- document id=1ea56fe2318f10122ab609a18558d81b39e0be2dd970531a904096ad771d485f url=/tableau/next/zh-cn/online/dm_labels_sensitivity.md -->

[跳转到主要内容](#main-content)

# 敏感度标签

有些数据需要更仔细地处理。为了确保信任和安全，用户务必要知道是哪些数据。从 Tableau Cloud 2023 年 6 月和 Tableau Server 2023.3 开始，如果您有 Data Management 许可证，Tableau 提供了一类新的数据标签：_敏感度标签_。用户可以使用敏感度标签来指示创建视图或共享信息时应注意的程度。此外，敏感度标签可以与其他标签（例如认证和数据质量警告）共存于同一资产上。而且，使用“数据标签”页面上的标签管理器或 REST API，管理员可以创建新的敏感度标签来满足其组织的需求。

注意：在 Tableau Cloud 2023 年 3 月和 Tableau Server 2023.1 及更低版本中，数据敏感度是使用“敏感数据”数据质量警告来表达的。随着升级到 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3，“敏感数据”数据质量警告已迁移到敏感度标签。

敏感度标签可以附加到与其他[数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#assets)相同类型的资产。

## 将敏感度标签附加到资产

若要将敏感度标签附加到资产，请执行以下操作：

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除敏感度标签，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

1. 搜索或导航到资产。导航步骤取决于您想要添加敏感度标签的资产类型：
    - 数据源或虚拟连接 - 在“浏览”页面上，选择“所有数据源”或“所有虚拟连接”。
    - 虚拟连接表 - 在“浏览”页面上，选择“所有虚拟连接”，然后选择包含要认证的虚拟连接表的虚拟连接。然后选择虚拟连接表。
    - 数据库或表 - 在“浏览”页面上，导航到数据库或表。或在“外部资产”页面上选择“数据库和文件”或“表和对象”。
    - 列 - 在“浏览”页面上，导航到表。或在“外部资产”页面上选择“表和对象”并导航到表。然后在列表中找到该列。
2. 选择数据资产旁边的操作菜单 (...)，然后选择“数据标签”\>“敏感度标签”。
3. 选中要附加到资产的敏感度标签旁边的复选框。或者，如果您知道敏感度标签的名称，则可以在对话框顶部搜索它，然后选中其旁边的复选框。（在 Tableau Server 2023.3 及更低版本中，您只能为每项资产附加一个敏感度标签。使用“显示标签”切换按钮打开该资产的敏感度标签，然后从下拉列表中选择所需的敏感度标签。）
4. 如果需要，输入要向用户显示的消息。您可以使用粗体、下划线和斜体来设置消息中文本的格式，并包含链接或图像。若要查看文本格式设置提示，请光标悬停在“保存”按钮上方的信息 (i) 图标上。
5. 选择“保存”。  
    ![“敏感度标签”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_dialog.png)

## 从资产中移除敏感度标签

若要从资产中移除敏感度标签，请执行以下操作：

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除敏感度标签，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)

1. 选择数据资产旁边的操作菜单 (...)，然后选择“数据标签”\>“敏感度标签”。
2. 取消选中要从资产中移除的敏感度标签旁边的框。（在 Tableau Server 2023.3 及更低版本中，使用“显示标签”开关关闭标签。）
3. 选择“保存”。

## 敏感度标签出现的位置

浏览 Tableau Cloud 时，敏感度标签会显示在资产上。与数据质量警告一样，敏感度标签出现在其所附加的资产的下游。例如，列上的敏感度标签显示在表页面的“列”行中，也显示在表页面的顶部和数据库页面上。

![表页面上的敏感度标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_table_page.png)

![工作簿页面字段上的敏感度标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_workbook_lineage_page.png)

在 Web 制作中，用户在以下情况下会在“数据”窗格中看到数据源旁边的图标

- 工作簿中使用的数据源上有敏感度标签，或者
- 工作簿中使用的数据源上游存在警告

若要查看详细信息，请将光标悬停在图标上。或者，在 Tableau Cloud Web 制作中，您可以选择数据源或列，然后选择“目录详细信息”以查看其所有标签。

### 可见性

高可见度敏感度标签显得更加紧急并出现在更多地方。例如，当任何人制作视图或打开依赖于它的已发布视图时，表上的高可见性敏感度标签将生成通知。

![Web 制作中的高可见度敏感度标签警报](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_hv_alert.png)

高可见度敏感度标签的图标和徽章为紫色，而标准可见度标签的图标和徽章为灰色。默认情况下，名为“敏感数据”的内置敏感度标签具有高可见度。

如果一项资产适用多个敏感度标签（因为资产具有多个敏感度标签或继承了上游敏感度标签），则徽章将包含一个数字，并且颜色由最高可见性标签确定。例如，如果一项资产适用于两个敏感度标签，其中一个是标准可见性，另一个是高可见性，则徽章为紫色。

![带有两个标签的标头上的敏感度徽章 ](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_badge_2_labels.png)

### 电子邮件订阅中的敏感度标签

管理员可以在电子邮件订阅中启用敏感度标签，以便当用户订阅视图时，他们收到的电子邮件包含与该视图关联的高可见性敏感度标签。具有高可见性敏感度标签的电子邮件包含：

- 指向相关视图或工作簿的链接，其“数据详细信息”窗格已打开。
- 指向相关上游资产（例如数据源、表或数据库）的链接。

管理员可以通过在 Tableau Server 或 Tableau Cloud 站点设置页面上选择“视图和工作簿订阅中的高可见性数据标签”选择（以前为“订阅中的数据质量警告”选项）来启用电子邮件订阅中的敏感度标签。有关详细信息，请参见“站点设置参考”中的[视图和工作簿订阅中的高可见性数据标签](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#data-quality-warnings-in-subscriptions)。

## 谁可以设置敏感度标签

若要设置敏感度标签，您必须

- 是服务器或站点管理员，或者
- 对资产具有“覆盖”能力。

## 自定义敏感度标签

只有一种内置敏感度标签：_敏感数据_。从 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023 开始，管理员可以使用“数据标签”页面上的标签管理器或 REST API 创建新的敏感度标签，值或更改现有敏感度标签值的名称和描述。典型的添加内容（名称和描述）可能为：

- **公开**：可供公众查看。
- **内部**：仅限公司员工和承包商查看。这些数据不得公开共享，但可以根据保密协议 (NDA) 与客户、合作伙伴和其他人共享。
- **机密**：可供经批准的员工和承包商团体使用。此数据不受法律、法规或公司主服务协议 (MSA) 的限制。它可以根据保密协议与客户、合作伙伴和其他人共享。
- **受限**：仅可供经批准的员工和承包商群体使用。这些数据可能受到法律、法规、NDA 或公司 MSA 的限制。
- **任务关键**：仅可供一小部分经批准的员工和承包商使用。获得访问权限的第三方可能会受到更高的合同要求的约束。这些数据几乎总是受到法律、法规、NDA 或公司 MSA 的限制。

有关详细信息，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

<!-- document id=510d08d2bf7b24aa1f43e55ea2107ad90a7d62911b8dd18ffbfd3555f9e7b8e6 url=/tableau/next/zh-cn/online/adminview_backgrnd.md -->

[跳转到主要内容](#main-content)

# 数据提取后台任务

“数据提取后台任务”视图显示服务器上运行的特定于数据提取的任务。此视图显示过去 30 天内 Tableau Cloud 活动的快照。

![时间序列图显示过去七天在服务器上运行的数据提取次数，而条形图则显示每日成功和失败的数据提取次数。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_extract.png)

## 了解此视图

为了更好地了解这个预先构建的管理视图，请注意以下各项：

- “此服务器上运行的数据”将列出在“时间表”所指定时段中运行的数据提取。
- 您可以单击“成功”或“错误”以根据状态筛选该表。
- 也可以单击特定任务以更新所选任务的“数据提取花费了多少时间”图形。
- “数据提取成功或失败的次数是多少”表将针对状态（成功或失败）更新，但成功或失败的数据提取的计数不会更改。

### 状态

任务的状态可以是成功或错误。

<table class="table--plain"><thead><tr class="Head-Header1"><th>图标</th><th>描述</th></tr></thead><tbody><tr class="Body-Body1"><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/icon_adminview_error.png" alt="管理视图错误图标。"></td><td><b>错误</b>—服务器无法完成任务。</td></tr><tr class="Body-Body1"><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/icon_adminview_success.png" alt="管理视图成功图标。"></td><td><b>成功</b>—服务器已完成任务。</td></tr></tbody></table>

### 查看任务的详细信息

有关任务的详细信息，请将鼠标指针悬停在成功或错误图标上。

![有关数据提取状态的信息。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_extract_details.png)

#### 任务详细信息中的错误

如果刷新任务达到其超时限制，您可能会在任务详细信息中看到以下错误之一：

- _The query time resource limit (7200 seconds) was exceeded.（已超出查询时间资源限制(7200 秒)。）_
- _com.tableau.nativeapi.dll.TableauCancelException: Operation cancelled.（com.tableau.nativeapi.dll.TableauCancelException: 操作已取消。）_
- _The query time resource limit (8100 seconds) was exceeded.（已超出查询时间资源限制(8100 秒)。）_

有关刷新任务的超时限制以及解决这些错误的建议的详细信息，请参见[数据提取刷新的时间限制](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm#timeout)。

<!-- document id=a90c021575a922e2d4980174b12fd2fe6e39a740a0ac59430d1a1d426cadffee url=/tableau/next/zh-cn/online/dm_labels.md -->

[跳转到主要内容](#main-content)

# 数据标签

数据标签是可以附加到数据资产的元数据。数据标签有助于对数据进行分类并将信息传递给用户。例如：

- 一个已发布的数据源比其他类似名称的数据源更权威。认证数据标签可以帮助您告知用户推荐使用哪个数据源。
- 数据库中的列包含过时的信息。警告数据标签可以帮助您告诉工作簿作者和查看者数据不是最新的。
- 员工收入表包含不应共享的敏感信息。敏感度数据标签可以告知用户在使用表中的数据时必须小心。
- 某些已发布数据源可以根据发布它们的部门进行分组。带有自定义标签的自定义标签类别可以确定负责不同数据源的部门。

注意：数据标签是一种更新的、可扩展的元数据分类方式。认证和数据质量警告，这是早在“数据标签”一词出现之前就已经存在的 Data Management 许可证，现在与 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3 中发布的敏感度标签一起被视为更广泛的数据标签概念中的类别。

除与已发布数据源认证相关的操作外，所有数据标签操作都需要 Data Management 许可证。

## 您可以标记的资产

您可以向以下 Tableau 内容和外部资产添加标签：

- 数据库
- 表
- 列（认证除外） _（Tableau Cloud 2022 年 10 月版/Server 2022.3 中引入的列标签）_
- 数据源
- 流程
- 虚拟连接
- 虚拟连接表

## 标签名称和类别

每个标签都有名称和类别。Tableau 内置的名称和类别包括：

<table class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><strong>名称</strong></td><td><strong>类别</strong></td></tr><tr><td>已认证</td><td>认证</td></tr><tr><td>已弃用</td><td>数据质量警告</td></tr><tr><td>过时数据</td><td>数据质量警告</td></tr><tr><td>正在维护</td><td>数据质量警告</td></tr><tr><td>警告</td><td>数据质量警告</td></tr><tr><td>数据提取刷新失败</td><td>数据质量警告</td></tr><tr><td>流程运行失败</td><td>数据质量警告</td></tr><tr><td>敏感数据<sup>1</sup></td><td>敏感度</td></tr></tbody></table>

1_在 Tableau Cloud 2023 年 3 月版/Server 2023.1 及更低版本中，敏感数据标签使用数据质量警告类别。_

从 Tableau Cloud October 2023 年 10 月版和 Tableau Server 2023.3 开始，管理员可以使用“数据标签”页面上的标签管理器或 REST API 自定义内置标签或创建全新的标签名称和类别。（自 2023 年 6 月起，Tableau Cloud 管理员可以使用 REST API 修改一些内置标签并在某些类别中添加其他标签。）有关详细信息，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

## 标签类别

标签的类别会影响标签的显示位置和显示方式、是否显示在下游资产上以及哪些部分是可自定义的等等。

### 认证

在具有多个发布商和大量资产的自助服务环境中，可能很难找到推荐内容。使用认证，您可以将资产标记为可信，并且资产会在 Tableau 的不同位置显示标记。有关完整信息，请参见[使用认证来帮助用户查找受信任的数据](https://help.tableau.com/v0.0/online/zh-cn/datasource_certified.htm)。

### 数据质量警告

识别有问题的数据对于与用户建立信任非常重要。数据质量警告允许您标记存在已知问题的数据资产。当您将数据质量警告附加到资产时，该资产以及使用该资产的任何下游资产上都会显示警告，从而使数据使用者意识到源数据的问题。举例来说，如果您将数据库表标记为已弃用，则查看基于该表的工作簿的用户可能会看到警告。

此外，当数据提取刷新或流程运行失败时，可以自动设置数据质量警告，并在成功时再次移除。并且外，使用“数据标签”页面或 REST API，管理员可以创建新的、自定义的数据质量警告标签，为用户可以选择的警告添加细微差别和特异性。有关完整信息，请参见[设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm)。

### 敏感度标签

有些数据需要以不同的方式处理。使用敏感度标签，您可以将数据敏感度信息转发给该数据的使用者。当您将资产标记为敏感时，浏览 Tableau Cloud 的用户会看到该资产以及使用该资产的任何下游资产上的标记。举例来说，如果您将某个表列标记为敏感，则基于该表制作新工作簿的用户可能会看到警告。此外，使用“数据标签”页面或 REST API，管理员可以创建自定义的敏感度标签，为用户在使用敏感度标签时可以选择的分类范围添加细微差别和特异性。

注意：敏感度标签是在 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3 中引入的。早期版本的 Tableau Cloud 和 Tableau Server 通过“敏感数据”数据质量警告而不是使用专用的敏感度类别来传递数据敏感度。

有关完整信息，请参见[敏感度标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_sensitivity.htm)。

### 自定义标签类别

有时，您需要以认证、数据质量警告或敏感度标签未涵盖的方式对数据进行分类。使用管理员定义的自定义类别，您可以使用标签以组织认为合适的任何方式对资产进行分类。例如，您组织中的管理员可能会创建一个名为“部门”的类别，其中包含销售、营销和其他部门的标签，准备好应用于您站点上的资产。有关完整信息，请参见[具有自定义类别的标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_custom_categories.htm)。

注意：Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 发布了管理员通过标签管理器创建标签名称和类别的功能。Tableau Cloud 管理员可以在 2023 年 6 月以更有限的方式使用 REST API 创建具有内置类别的自定义标签名称。

## 数据标签出现的位置

数据标签出现在不同的地方，例如

- 资产页面（工作簿、数据源、表格等）的顶部  
    ![资产页面上的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_masthead.png)
- 资产列表（“探索”页面、“外部资产”页面等）  
    ![资产页面上的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_list_view.png)
- “Desktop 数据”窗格  
    ![“Desktop 数据”窗格中的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_desktop_data_pane.png)
- Web 制作“目录详细信息”窗口  
    ![Web 制作目录详细信息中的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_web_authoring_catalog_details.png)
- “数据详细信息”窗格  
    ![“数据详细信息”窗格中的标签](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_data_details_pane.png)

颜色表示标签的类别和可见性级别：

- **绿色**表示资产已通过认证
- **蓝色**表示标准可见性质量警告
- **黄色**表示高可见性质量警告
- **灰色**表示标准可见性敏感度标签或具有自定义类别的标签
- **紫色**表示高可见性敏感度标签

选择标签徽章可查看资产上该类别标签的详细信息。对于质量警告标签和敏感度标签，详细信息将包括从上游资产继承的标签。如果您正在检查表上的质量警告标签或敏感度标签，则详细信息将包括下游列上的标签。若要转到相关资产的页面，请选择该资产。认证标签和自定义类别标签不是从上游资产继承的。

每个标签类别都有一个指示符，无论该资产上有多少个该类别的标签或由该资产继承的标签类别。如果指示符所代表的一个或多个标签是高可见性标签，则该指示符会被着色以实现高可见性。例如，假设一个表上有一个标准可见性质量警告，并且该表的上游数据库上有一个高可见性质量警告。您会看到黄色质量警告 (2)指示符，因为该指示符代表两个质量警告，其中之一为高可见性。

![其上带有标签并由其继承的资产](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_labels_on_asset_and_inherited.png)

影响视图和 Web 制作会话的高可见性质量警告和高可见性敏感度标签会导致显示警报。

![高可见度敏感度标签警报](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_sensitivity_hv_alert.png)

这些警报通知用户需要小心处理他们看到的数据。选择“打开数据详细信息”链接会显示有关影响数据的标签的更多信息。

## “数据标签”对话框

从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加、移除和修改资产上的数据标签。（数据提取刷新监控和流程刷新监控仍然通过单独的对话框进行控制。）

若要打开资产的“数据标签”对话框，请选择资产旁边的操作 (...) 菜单，然后选择“数据标签”。选择“认证”、 “数据质量警告”、 “敏感度标签”或“所有标签”以打开“数据标签”对话框，并显示相应的选项卡。

![“数据标签”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_data_labels_dialog.png)

对话框左侧的垂直选项卡对应于数据标签类别，但列表顶部的“所有标签”和“选定标签”选项卡除外。

- “所有标签”选项卡列出了站点所有类别的所有数据标签。将检查为资产选择的每个标签。这包括打开对话框时为资产选择的数据标签，以及此后选择的任何标签。
- “选定标签”选项卡列出了已为资产选择的所有数据标签。这包括打开对话框时为资产选择的数据标签，以及此后选择的任何标签。
- 其他选项卡对应于数据标签类别。这些选项卡列出了与该类别关联的所有数据标签。将检查为资产选择的每个标签。这包括打开对话框时为资产选择的数据标签，以及此后选择的任何标签。

对话框顶部的搜索栏会返回与您提供的搜索词匹配的数据标签。您可以从结果中选择或取消选择所需的任何标签。

若要更改资产上的数据标签，请执行以下操作：

1. 使用搜索栏或垂直选项卡导航到标签以查找标签。
2. 若要将数据标签添加到资产，请选中其旁边的框。
3. 选择可见性级别（如果适用）和消息（如果需要）。
4. 若要从资产中移除数据标签，请清除其旁边的框。
5. 通过重复这些步骤来添加、移除或修改资产的更多标签
6. 若要将更改提交到资产上的数据标签并关闭对话框，请单击“保存” 。或者，如果您想要放弃自对话框打开以来的所有更改，请单击“取消”并确认您想要放弃更改。

注意：选择数据标签而不是其旁边的复选框将显示有关标签的详细信息，而不更改复选框的状态。此操作对于查看标签描述或更改消息而不更改资产上标签的状态非常有用。

合并的“数据标签”对话框在 Tableau Server 中不可用。

有关特定类别标签的详细信息，请参见相应的主题：

- [使用认证来帮助用户查找受信任的数据](https://help.tableau.com/v0.0/online/zh-cn/datasource_certified.htm)
- [设置数据质量警告](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm#dm_dqw)
- [敏感度标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_sensitivity.htm)
- [具有自定义类别的标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_custom_categories.htm)

## 与资产上的数据标签交互所需的权限

查看、添加、更新和删除资产标签所需的权限如下所示：

- 若要查看数据标签，您必须具有关联资产的读取权限。
- 若要添加、更新或删除认证标签以外的数据标签，您必须拥有关联资产的写入权限。
- 若要添加、更新或删除认证标签，您必须是管理员，或者您必须是资产所在项目的项目负责人或产品所有者。
- 若要为_不在_项目中的外部资产添加、更新或删除认证标签，您必须拥有关联资产的更改权限权限。

## 数据标签和标记的比较

Tableau Cloud 和 Tableau Server 还提供另一种资产分类解决方案：标记。数据标签和标记有显著的区别：

<table class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><td><strong>区域</strong></td><td><strong>数据标签</strong></td><td><strong>标记</strong></td></tr><tr><td>结构与控制</td><td>管理员控制数据标签的范围</td><td>对用户添加的标签范围没有管理控制</td></tr><tr><td>权限</td><td>添加/更新/移除数据标签的能力通过资产权限控制</td><td>Explorer 和 Creator 可以标记他们可以查看的任何资产</td></tr><tr><td>外观</td><td>数据标签图标易于查看，并按类别和可见性级别进行颜色编码</td><td>标记出现的地方比数据标签少，并且没有图标</td></tr><tr><td>继承</td><td>一些数据标签（例如警告和敏感度标签）显示在下游资产上</td><td>无继承</td></tr><tr><td>搜索/筛选</td><td>认证和质量警告可以用作某些资产列表中的筛选器</td><td>搜索结果返回带有匹配标记的资产，并且标记可以在某些资产列表中用作筛选器</td></tr><tr><td>可访问API</td><td>可通过 REST API 和元数据 API 进行访问</td><td>可通过 REST API 和元数据 API 进行访问</td></tr><tr><td>许可证要求</td><td>需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 许可证（已发布数据源的认证除外）</td><td>无许可要求</td></tr><tr><td>使用</td><td>结构化分类侧重于提供可以影响用户数据使用的重要信息</td><td>开放式资产分类方法</td></tr></tbody></table>

有关标记的详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[使用标记](https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm)。

## 此部分中的其他文章

<!-- document id=3d8eb4d476038e0d6ab5f9daa29a671b8227a89fd617dfa8e907079e2f46c106 url=/tableau/next/zh-cn/online/dm_adminview_dqw.md -->

[跳转到主要内容](#main-content)

# 数据质量警告历史记录

在环境中启用 Tableau Catalog 后，站点管理员可以使用预先构建的管理视图“数据质量警告历史记录”查看站点上数据质量警告的使用情况。

有关 Tableau Catalog（Data Management 的一部分）的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。

从“站点状态”页面中选择“数据质量警告历史记录”仪表板：

![数据质量警告历史记录管理视图](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_admin_view0.png)

该仪表板显示一段时间内有多少数据质量警告处于活动状态。它还显示在同一时间段内更改（创建、更新和删除）的警告数。

## 查看警告详细信息

折线图下是有关数据质量警告的详细信息，其中包括：

- **日期和时间** \- 创建或上次更改警告的时间。
- **内容类型** - 在其上设置警告的资产类型，例如数据库、表或数据源。
- **内容名称** - 在其上设置警告的资产的名称。
- **更改者** \- 创建或上次更改警告的用户的姓名。
- **状态** \- 警告是处于活动状态还是非活动状态。
- **类型** \- 警告类型可能为“过时数据”、“警告”、“已弃用”、“敏感数据”或“正在维护”。
- **可见性** \- 可将警告配置为具有正常（默认值）或高可见性。
- **消息** \- 警告创建者在用户看到警告的详细信息时，向其发送的消息。

## 筛选警告历史记录

查看数据质量警告历史记录时，可以单击视图上的标记以筛选视图下方显示的详细信息。

![“数据质量警告历史记录”仪表板，显示一段时间内有效和已修改的数据质量警报的数量](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_admin_view.png)

“日”轴上的数字表示时间范围内的日期。举例来说，如果今天是 11 月 18 日，并且您筛选了过去 7 天，则“日”轴会显示 12-18。

单击右上角的筛选器图标时，可使用更多筛选器：按时间范围和内容类型进行筛选。

### 按时间范围筛选

可以配置的最大时间范围是过去 30 天。

![允许您选择时间范围的筛选器菜单](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_admin_view_filter_time.png)

### 按内容类型筛选

可以查看站点上的所有数据质量警告，也可以筛选以查看特定类型的资产（如数据源或表）的警告：

![带有时间范围和内容类型选项的筛选器菜单](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_admin_view_filter_type.png)

## 谁可以执行此操作

若要设置数据质量警告，您必须是服务器或站点管理员。

<!-- document id=5d67a076b6be74dd3a418b619fba57520929cca6874f978bbfd4bc7d148e82cc url=/tableau/next/zh-cn/online/adminview_ask_data_usage.md -->

[跳转到主要内容](#main-content)

# 数据问答功能使用情况

**“数据问答”(Ask Data) 功能和指标的重要变化**

Tableau 的“数据问答”(Ask Data) 和指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见 [Tableau AI 和 Tableau Pulse 如何重新构想数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-gpt)。

“数据问答功能使用情况”视图是一个预构建的仪表板，允许站点或服务器管理员查看和了解站点的“数据问答”(Ask Data) 功能的使用模式和值。管理员可以看到与“数据问答”(Ask Data) 功能的交互度的增长，并监控内部培训或推广的结果。仪表板突出显示了顶部“数据问答”(Ask Data) 功能用户、数据源和数据源所有者，以及一些标题值指标。

![仪表板说明了“数据问答”(Ask Data) 功能的使用情况和采用情况，跟踪了一段时间内用户、查询和数据源的数量。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_ask_data_usage.png)

若要启用“数据问答”(Ask Data) 功能，请参见[为站点禁用或启用“数据问答”(Ask Data) 功能](https://help.tableau.com/v0.0/online/zh-cn/ask_data_enable.htm)。

## 浏览仪表板

“数据问答功能使用情况”视图提供有关整个站点的“数据问答”(Ask Data) 功能的信息。您可以使用以下指标来了解用户交互度，并帮助推动在组织中采用自助分析。

![22 位用户、177 个查询和 930 个数据源证明了“数据问答”(Ask Data) 的使用情况。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_ask_data_usage_top.png)

在仪表板顶部，三个主要指标提供站点上“数据问答”(Ask Data) 功能使用情况的概述。

- “数据问答”(Ask Data) 功能的用户数 - 这显示了站点上“数据问答”(Ask Data) 功能用户的总数。
- “数据问答”(Ask Data) 功能的查询数 - 这显示了站点上发出的“数据问答”(Ask Data) 功能查询总数。
- 与“数据问答”(Ask Data) 功能一起使用的数据源数 - 这显示了与“数据问答”(Ask Data) 功能一起使用的数据源总数。

![两个折线图展示了不同用户和不同数据源所有者随时间的增长情况。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_ask_data_usage_middle.png)

在仪表板的中间，两个折线图显示“数据问答”(Ask Data) 功能在一段时间内的使用情况。

- 一段时间内的不同用户 - 这显示了一段时间内不同的“数据问答”(Ask Data) 功能用户数。
- 一段时间内的不同数据源所有者 - 这显示了一段时间内不同数据源所有者数。

![三个条形图显示位居前列的数据用户、数据源和数据源所有者。](/tableau/next/zh-cn/online/zh-cn/Img/adminview_ask_data_usage_bottom.png)

在仪表板的底部，三个条形图列出位居前列的“数据问答”(Ask Data) 功能用户、数据源和数据源所有者。

- 位居前列的“数据问答”(Ask Data) 功能用户 - 这列出了位居前列的“数据问答”(Ask Data) 功能用户，以及每个用户发出的查询总数。
- 位居前列的“数据问答”(Ask Data) 功能数据源 - 这列出了位居前列的“数据问答”(Ask Data) 功能数据源，以及针对每个数据源发出的查询总数。
- 位居前列的“数据问答”(Ask Data) 功能数据源所有者 - 这列出了位居前列的“数据问答”(Ask Data) 功能数据源所有者，以及每个用户拥有的数据源总数。

<!-- document id=0dda1b9144a194f05f8f2dc1eb3781054b0149ad4d89fc77fedd469feedd0a75 url=/tableau/next/zh-cn/online/to_sync_change_computer_site.md -->

[跳转到主要内容](#main-content)

# 更改 Bridge 客户端设置

站点管理员可以配置若干 Bridge 客户端设置来更改客户端的运行方式。

## Windows 客户端

对于 Windows 客户端，配置文件的默认位置为 `C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt`。必须重新启动客户端以使对配置文件所做的任何更改生效。

## 适用于容器的 Linux 版 Bridge

`TabBridgeClientConfiguration.txt` 文件是在您第一次运行 Bridge 客户端时使用默认配置生成的。

若要更改配置文件，请编辑 `TabBridgeClientConfiguration.txt` 并 使用更新的文件创建一个新的 Docker 容器。有关如何创建和更新容器的详细信息，请参见[容器化应用程序](https://docs.docker.com/get-started/02_our_app/)。

## Bridge 旧版计划

在某些情况下，如果数据源所有者维护自己的客户端以运行 Bridge 旧版计划，则其可能负责执行本主题中描述的某些任务。

## Bridge 客户端设置

### serviceConnectionSettings

配置：`serviceConnectionSettings`

选项：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>serviceUrl</code></td><td>Tableau 站点 URL。<p><i>不可配置</i>。</p></td></tr><tr><td><code>proxyServer</code></td><td>代理服务器和端口。<p><i>可配置</i></p></td></tr></tbody></table>

#### 示例

必须重新启动客户端以使对配置文件所做的任何更改生效。

```
"serviceConnectionSettings" : {
	"serviceUrl" : "https://online.tableau.com",
	"proxyServer" : {
	"serverName" : "http://localhost",
	"serverPort" : 8888
	}
```

### connection

配置：`connection`

选项：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>connectTimeout</code></td><td>Bridge 客户端在尝试连接到 Tableau Cloud 时的等待时间。<p>默认值：1 分钟</p><p><i>可配置。</i></p></td></tr><tr><td><code>operationTimeout</code></td><td>成功连接到 Tableau Cloud 后每个服务器（例如 VizPortal）API 调用的 Bridge 客户端等待时间。<p>默认值：15 分钟</p><p><i>可配置</i>。</p></td></tr><tr><td><code>maxAttemptsToRedirectHttpRequests</code></td><td>对服务器的 API 调用可以从 POD 重定向到 POD。此数字指定每次服务器 API 调用的最大重定向次数。默认值：20<p><i>可配置</i>。</p></td></tr></tbody></table>

#### 示例

```
"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	}
```

### dataSourceRefreshSettings

配置：`dataSourceRefreshSettings`

选项：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>shutdownTimeoutInSeconds</code></td><td><i>不可配置</i>。</td></tr><tr><td><code>downloadDataSourcesInterval</code></td><td>临时下载分配给 Bridge 旧版计划客户端的实时数据源和数据提取数据源的名称的时间间隔。<p>默认值：30 分钟。<br></p><p><i>可配置</i>。<br></p></td></tr><tr><td><code>checkRefreshDataSourcesInterval</code></td><td>Bridge 客户端检查分配给客户端的数据源以确定 Bridge 旧版计划是否需要刷新的时间间隔。<p>默认值：5 秒</p><p><i>可配置</i>。</p></td></tr><tr><td><code>extractRefreshTimeout</code></td><td>强制实施客户端执行的刷新的时间限制。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。如果因为达到超时限制而取消了数据提取刷新，您将在客户端中看到一条消息，并且系统会向数据源所有者发送电子邮件通知。<p>默认值：24 小时</p><p>对于虚拟连接，默认的数据提取刷新超时限制为 2 小时，由 Tableau Cloud 控制。时间限制不能通过 Bridge 客户端控制。</p><p><i>可配置</i>。</p></td></tr><tr><td><code>maxRemoteJobConcurrency</code></td><td>指定单个客户端允许的最大并发远程刷新作业（PDS 数据提取）数。<p>默认值：10</p><p>最小值：1</p><p>最大值：90</p><p><i>可配置</i>。</p><p>若要应用此设置：</p><ol><li value="1"><p>取消关联客户端。</p></li><li value="2"><p>重新链接客户端并登录。</p></li><li value="3"><p>将客户端分配到命名池。</p></li></ol><p><b>注意：</b>对于 Windows 用户，如果应用程序在更改此设置后报告了需要执行其他操作的不正确错误，请从 Windows 安全存储中手动清除 Bridge 凭据。</p></td></tr><tr><td><code>JSONLogForExtractRefresh</code></td><td>设置为 true 时，客户端会生成一个 JSON 格式的附加日志文件。该日志捕获数据提取刷新的指标，包括 Bridge 旧版刷新和远程刷新，每个数据提取一行。<p>JSON 日志文件的格式是 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 可读的，并可用作创建实时可视化项的数据源。有关详细信息，请参见 <a href="https://help.tableau.com/current/pro/desktop/zh-cn/examples_json.htm">JSON 文件</a>。</p><p>日志文件的示例为：<code>
							ExtractRefreshMetrics_&lt;timestamp&gt;.json</code><br>更改此配置选项的值需要重新启动 Bridge 客户端。</p><p><code>loggerSettings </code> 配置选项适用于 JSON 日志文件。</p><p>默认值：false</p><p><i>可配置</i>。</p></td></tr><tr><td><code>dataSources</code></td><td>适用于 Bridge 旧版计划刷新作业。用户不可编辑。<br>为基于文件的数据源提供映射的本地文件位置列表。<p><i>不可配置</i></p></td></tr></tbody></table>

#### 示例

为了数据提取或刷新的滥用，您可以使用 `extractRefreshTimeout`，为客户端执行的刷新强制实施一个时间限制（也称为超时限制）。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。

**注意**：对于虚拟连接的数据提取，`extractRefreshTimeout` 的默认值为 2 小时，并且不能通过 Bridge 客户端控制。或者，您可以修改虚拟连接，在默认的 2 小时期限内进行刷新，或者切换到已发布的数据源。

默认情况下，客户端的超时限制设置为 24 小时。您可以通过 Bridge 配置文件更改客户端的超时限制。如果因为达到超时限制而取消了数据提取刷新，您将在客户端中看到一条消息，并且系统会向数据源所有者发送电子邮件通知。

必须重新启动客户端以使对配置文件所做的任何更改生效。

```
"dataSourceRefreshSettings" : {
	"shutdownTimeoutInSeconds" : "00:00:30",
	"downloadDataSourcesInterval" : "00:30:00",
	"checkRefreshDataSourcesInterval" : "00:00:05",
	"extractRefreshTimeout" : "24:00:00",
	"maxRemoteJobConcurrency" : 10,
	"JSONLogForExtractRefresh" : false,
	"dataSources" : [
	]
}
```

### loggerSettings

配置：`loggerSettings`

选项：

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>maxLogFileSizeInMB</code></td><td>日志文件的最大大小（以 MB 为单位）。当日志文件超出大小限制时，将会创建新日志文件。<p>默认值：25 MB。</p><p><i>可配置</i>。</p></td></tr><tr><td><code>maxBackupLogFileCount</code></td><td>允许的最大 Bridge 日志文件数。当日志文件数量超过限制时，最旧的日志文件将被删除。<p>默认值为 40。<br></p><p><i>可配置</i>。<br></p></td></tr><tr><td><code>remoteRequestLogFileLifeSpan</code></td><td>对于发送到客户端的每个 Bridge 刷新作业，都会创建一组新的日志文件：<p><code>tabbridgeclijob_&lt;process_id, and if the data source is JDBC-based: fjprotocolserver_&lt;process_id&gt;, and stdout_jprotocolserver_&lt;process_id&gt;</code>。</p><p>默认情况下，如果日志文件数量超过 <code>maxBackupLogFileCount</code>，日志文件在删除之前保留在 Logs 文件夹中的最长时间为 8 小时。否则，这些日志文件将无限期保留，而日志文件的数量小于或等于 <code>maxBackupLogFileCount</code>。</p><p><code>&lt;process_id&gt;</code> 表示 Windows 进程 ID。</p><p>默认值：8 小时</p><p><i>可配置</i>。</p></td></tr></tbody></table>

#### 示例

客户端在其正常操作过程中会创建活动的日志。您可以使用这些日志来监视刷新、对 Bridge 问题进行故障排除，或者在 Tableau 支持部门向您请求日志以帮助解决问题时使用。

您可以管理 Bridge 日志文件的大小或增加日志文件在 TabBridgeClientConfiguration.txt 文件中删除之前的保留时间。

注意：名为 tabprotosrv\* 的日志文件与其他 Bridge 日志文件不同。最大大小为 1 MB，允许的日志文件的最大数量为 8192。这些值也是不可配置的。

```
"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
	"maxBackupLogFileCount" : 40,
	"remoteRequestLogFileLifeSpan" : "00:00:00"
}
```

### dataSyncRestartInterval

配置：`dataSyncRestartInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>设置数据同步的重启间隔。</p><p><i>可配置</i>。</p></td></tr></tbody></table>

### internetConnectionMonitorInterval

配置：`internetConnectionMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Bridge ping 互联网以确定是否存在有效连接的时间间隔。</p><p>默认值：30 秒</p><p><i>可配置</i>。</p></td></tr></tbody></table>

### secureStorageMonitorInterval

配置：`secureStorageMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Bridge 确定安全存储的时间间隔。<p><i>不可配置</i>。</p></td></tr></tbody></table>

#### cleanUpTempDirOnStartUp

配置：`cleanUpTempDirOnStartUp`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>确定是否在 Bridge 客户端启动时移除临时文件。</p><p>默认值：true</p><p><i>可配置</i>。</p></td></tr></tbody></table>

#### JSONLogForLiveQuery

配置：`JSONLogForLiveQuery`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>设置为 true 时，客户端会生成一个 JSON 格式的附加日志文件。日志捕获实时查询请求的指标，每个数据提取<p>JSON 日志文件的格式是 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 可读的，并可用作创建实时可视化项的数据源。有关详细信息，请参见 JSON 文件。</p><p>更改此配置选项的值需要重新启动 Bridge 客户端。</p><p>默认值：true</p><p><i>可配置</i>。</p></td></tr></tbody></table>

#### 示例

```
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
```

## 默认配置文件

若要复制默认配置文件，请单击右上角的**“复制到剪贴板”**图标。

```
{
	"serviceConnectionSettings" : {
		"serviceUrl" : "https://online.tableau.com/",
		"connection" : {
			"connectTimeout" : "00:01:00",
			"operationTimeout" : "00:15:00",
			"maxAttemptsToRedirectHttpRequests" : 20
		},
	},
	"dataSourceRefreshSettings" : {
		"shutdownTimeoutInSeconds" : "00:00:30",
		"downloadDataSourcesInterval" : "00:30:00",
		"checkRefreshDataSourcesInterval" : "00:00:05",
		"extractRefreshTimeout" : "24:00:00",
		"maxRemoteJobConcurrency" : 10,
		"JSONLogForExtractRefresh" : false,
		"dataSources" : [
		]
	},
	"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
		"maxBackupLogFileCount" : 40,
		"remoteRequestLogFileLifeSpan" : "08:00:00"
	},
	"dataSyncRestartInterval" : "24:00:00",
	"internetConnectionMonitorInterval" : "00:00:30",
	"secureStorageMonitorInterval" : "00:00:30",
	"cleanUpTempDirOnStartUp" : true,
	"JSONLogForLiveQuery" : true
}
```

## 此部分中的其他文章

<!-- document id=8671d1b5b162a68d6dff9e09222051dff5e7b3fcd6b42ace3e36708d41ad4f68 url=/tableau/next/zh-cn/online/to_bridge_site_settings_win.md -->

[跳转到主要内容](#main-content)

# 更改 Windows 客户端服务

为了将客户端包含在池中，客户端应以 Windows 服务形式运行（“服务”模式）。默认情况下，客户端设置为以 Windows 服务形式运行，以便它可以在后台对实时查询和刷新进行负载平衡，而无需专门的用户登录到计算机。客户端要以 Windows 服务形式运行，运行客户端的 Windows 用户帐户必须是计算机上“本地管理员”组的成员。

**注意：**如果您是数据源所有者并自行管理客户端，则您的客户端将不会包含在池中。但是，如果您希望即使在未登录到计算机的情况下 Bridge（旧版）计划也在后台运行，则客户端必须以 Windows 服务形式运行（“服务”模式）。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 从“模式”下拉菜单中，选择“服务”。将显示登录窗口。
    
    ![以 Windows 服务形式持续运行 Tableau Bridge](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_run_as_service.png)
3. 输入您的本地管理员凭据。
    
    在您的 Windows 服务列表中，Bridge 显示为“Tableau Bridge 服务”。您可以在 Windows 服务控制台中或在任务管理器中的“服务”选项卡上看到此项。

### 重新启动 Windows 客户端

您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。

- 对于应用程序模式：从客户端菜单中选择“退出”。
- 对于服务模式：从“模式”下拉菜单中选择“应用程序”；从客户端菜单中选择“退出”。在对话框中，选中“退出客户端并停止活动”复选框，然后单击“关闭”。
- ![一个对话框，警告关闭 Tableau Bridge 客户端将停止实时查询和计划的刷新操作。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_exit_service.png)

### 取消链接 Windows 客户端

右键单击 Windows 系统托盘中的 Bridge 图标，然后选择“取消链接”。

![菜单显示“帮助”、“取消链接”和“退出”选项。](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_unlink.png)

有关“取消链接”选项的详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#unlink-effects)。

### 停止以 Windows 服务形式运行 Bridge

若要阻止客户端以服务形式运行，请更改其模式。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 从“模式”下拉菜单中，选择“应用程序”。
    
    ![以应用程序而不是服务形式运行 Tableau Bridge。](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_revert_to_application.png)

当客户端在“应用程序”模式下运行时，只有当用户在客户端从中运行的计算机上登录到 Windows 用户帐户时，实时查询和计划刷新才能运行。

### 切换与客户端关联的站点

如果您希望使用客户端使发布到其他 Tableau Cloud 站点的内容保持最新，则可以取消链接现有客户端，并从客户端中向新站点进行身份验证。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 从下拉菜单中，选择“取消链接”。
    
    ![取消链接以移除所有数据信息并停止发送刷新到 Tableau Cloud](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_unlink.png)  
    
    “取消链接”会从使用 Bridge（旧版）计划、计划和连接信息的客户端中移除数据源列表。
3. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
4. 出现提示时，使用站点管理员凭据登录到新站点。
5. 执行以下一项或两项操作来配置客户端：
    
    - 如果此客户端刷新与特定客户端关联的数据源，请要求数据源所有者重新配置其数据源并刷新计划。
    - 如果希望此客户端促进实时连接或使用 Online 计划的数据提取连接，请确保新客户端是池的一部分。有关详细信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)

取消链接客户端时，可能还需要为客户端刷新的数据源移除 Bridge（旧版）计划。其他数据源仍然有由池中的其他注册客户端执行的数据新鲜度任务。

有关详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#unlink-effects)。

<!-- document id=d0f65b6fce18f077566cc219f50ada85f7a32d748c74e7e6d2e18a90d5749cc2 url=/tableau/next/zh-cn/online/to_sync_client_settings.md -->

[跳转到主要内容](#main-content)

# 更新 Bridge 连接信息

本主题介绍数据源所有者如何更新连接到私有网络数据的数据源的连接信息。

**注意：**有关虚拟连接的连接信息的信息，请参见[创建虚拟连接](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm)。

## 嵌入或更新数据库凭据

为了使实时查询和计划刷新按预期方式运行，需要用户身份验证的数据源必须将数据库凭据嵌入数据源。

您可以通过以下两种方式之一嵌入数据源的数据库凭据：1) 在发布期间通过 Tableau Desktop 嵌入，或者 2) 在发布之后通过 Tableau Cloud 中的数据源的“连接”嵌入。下面的过程介绍如何在 Tableau Cloud 上嵌入数据库凭据。有关在 Tableau Desktop 中嵌入数据库凭据的详细信息，请参见[设置凭据以访问您发布的数据](https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm)。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 从数据源页面中，单击“连接”选项卡。
3. 选中连接旁边的复选框，单击“操作”菜单，然后选择“编辑连接”。
4. 在“编辑连接”对话框中，输入访问数据所需的数据库凭据，然后单击“保存”。

### 为 Bridge 旧版计划嵌入或更新数据库凭据

如果使用 **Bridge 旧版**计划来刷新数据源，则必须在 Bridge 客户端的连接信息中嵌入数据库凭据。即使您在 Tableau Desktop 上发布时嵌入了数据库凭据，也必须完成此任务。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 指向数据源，然后单击出现的**“编辑”**图标 (![](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_edit_icon.png))。
3. 在对话框中，输入访问数据所需的数据库凭据，然后单击**“保存”**。

## 更改数据源的文件路径

在某些情况下，您可能需要在以下情形下更新客户端引用的文件位置：

- **源文件位置已更改**
- **数据源是从映射的驱动器中发布的：**如果用于执行刷新的客户端正在服务模式下运行，并且数据源是从映射的驱动器中发布的，则必须更新客户端引用的文件路径以使用完整 UNC 路径。客户端服务运行所采用的 Windows 服务帐户也必须对文件的 UNC 路径位置具有访问权限。我们强烈建议在应用程序模式下运行的客户端也引用其基于文件的数据源的 UNC 路径。

如果您使用的是 Bridge 刷新计划，则可以通过执行以下步骤更改数据源文件路径以使用完整的通用命名约定 (UNC) 路径：

1. 从 Tableau Cloud 下载数据源。
2. 启动 Tableau Desktop。
3. 打开已发布的数据源或工作簿。
4. 导航到“数据源”选项卡。
5. 右键单击数据源名称，然后选择“编辑连接”。
6. 在文件导航器窗口和文件路径字段中，键入文件的 UNC 路径。例如：\\\\服务器名称\\datasource.xls。
7. 选择“服务器”\>“发布数据源”并发布数据源。

您可以通过右键单击数据源并选择“属性”来确认 Tableau Desktop 中的数据源已识别 UNC 路径。

### 更改（旧版）的文件路径

如果使用 **Bridge 旧版**计划进行刷新，则会随数据源一起保存文件的位置。

您可以使用以下步骤更改数据源的文件路径。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 指向数据源，然后单击出现的**“编辑”**图标 (![](/tableau/next/zh-cn/online/zh-cn/Img/to_sync_edit_icon.png))。
    
    ![带有编辑和日历图标的图书馆数据。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_client_editpath.png)
3. 在对话框中，输入路径位置信息，然后单击“保存”。
    
    ![具有文件路径输入字段和保存或取消选项的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_client_filepath.png)

## 将 .tdc 文件用于通用 JDBC 或 ODBC 连接

您可以使用下面描述的步骤来确保通过 Tableau 数据源自定义项 (TDC) 文件启用的通用 JDBC 或 ODBC 连接的自定义项也被 Bridge 使用。

步骤 1：自定义通用 JDBC 或 ODBC 连接

如果您还不熟悉可以对 JDBC 和 ODBC 连接进行的自定义类型以及如何创建 TDC 文件，请参见 Tableau 帮助中的[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)。

步骤 2：将 TDC 文件保存在“我的 Tableau Bridge 存储库”中

为了让 Bridge 使用为通用 ODBC 或 JDBC 连接指定的自定义项，您必须将 TDC 文件保存在以下过程指定的位置。若要通过 Bridge 池刷新 JDBC 或 ODBC 连接，则必须对池中的所有客户端执行此步骤。

1. 在安装了客户端的计算机上，转到“我的 Tableau Bridge 存储库”中的“数据源”文件夹。
    
    文件夹的默认位置为
    
    - Windows：`C:\Users\myuser\Documents\My Tableau Bridge Repository\Datasources`
    - Linux：`/root/Documents/My_Tableau_Bridge_Repository/Datasources/`
2. 将 TDC (.tdc) 文件放入“数据源”文件夹中。
3. 退出并重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
    
    - 对于应用程序模式：从客户端菜单中选择“退出”。
    - 对于服务模式：从“模式”下拉菜单中选择“应用程序”；然后从客户端菜单中选择“退出”。
4. 为池中的所有客户端重复步骤 1-3。

**注意：**

- 有关创建和自定义 TDC 文件的详细信息，请参见 Tableau Desktop 帮助主题[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)。
- 将 TDC 文件保存到所需位置后，自定义项将应用于连接到相同基础数据的所有通用 JDBC 或 ODBC 连接。
- 若要验证是否正在使用 TDC 文件，您可以查看客户端日志文件（例如，C:\\Users\\jsmith\\Documents\\我的 Tableau Bridge 存储库\\Logs）的以下任一日志条目：
    
    - `Found matching TDC`
    - `Applying customization for genericjdbc` 或 `Applying customization for genericodbc`

## 更改连接类型

数据源可以使用两种连接类型之一：实时或数据提取。连接类型确定可更新内容来反映基础数据中的更改的频率。根据所连接到的数据，某些数据源可能有实时连接或数据提取连接，但其他数据源可能只有数据提取连接。有关详细信息，请参见[与 Bridge 的连接](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm)。

若要更改工作簿嵌入数据源的连接类型，请参见[编辑数据源](https://help.tableau.com/v0.0/online/en-us/to_bridge_eds.htm#editing-the-data-source)。

## 修复连接

有时，某些原因会导致一个或多个连接正常停止工作。发生这种情况时客户端中会出现通知，并且通知通常会提供相关信息，引导您找到问题的原因。但是，如果通知无法提供任何故障排除信息，并且客户端在“服务”模式下运行，则可以使用“修复”选项来尝试重置连接。

1. 打开 Windows 系统托盘，并右键单击 Bridge 图标。
2. 从下拉菜单中，选择“修复”。此选项将停止并重新启动服务，已足以解决该问题。

<!-- document id=f60e1a8904f1c74892837c2d7921fd1023fef850dadc076e80cbf92b75ff0093 url=/tableau/next/zh-cn/online/permission_effective.md -->

[跳转到主要内容](#main-content)

# 有效权限

权限规则确定受影响的人员（组集、组或用户），以及他们的哪些[能力](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm#Capabili)的状态为**“已允许”**、**“已拒绝”**或**“未指定”**。尽管简单地设置一个权限规则并将其作为全部似乎很简单，但是由于用户属于多个组以及站点角色和所有权与权限规则之间的相互作用，用户是否具有该功能可能并不清楚。

系统按特定顺序对多个因素进行评估，从而生成针对一部分内容的_有效权限_。

> [!TIP]
> 
> **提示：**为了让事情尽可能简单，我们建议 (1) 为组而不是用户设置权限规则，(2) 管理锁定在项目级别的权限而不是为单个内容设置权限，以及 (3) 删除“所有用户”组的权限规则或将所有能力设置为“无”。

仅当以下三个条件全部得到满足时，才会为用户允许某项能力：

- 该能力在其站点角色的范围内。
- 他们拥有该能力：
    - 基于特定用户方案（例如是内容所有者或项目主管，或者他们是管理员站点角色），  
        或者
    - 他们已被允许作为用户使用该能力，  
        或者
    - 因为他们都位于已允许使用该能力的组中，并且没有规则拒绝他们作为用户或其他组的成员使用该能力。
- 在另一个优先的内容级别没有冲突的权限设置。

任何其他情况拒绝用户使用该能力。

将鼠标光标悬停在能力上会显示一个说明有效权限的工具提示。下面是一些常见的例子，说明为何有效权限（用户实际上可执行或无法执行什么操作）看起来可能与给定权限规则规定的权限不同：

- 用户可能具有在权限规则中被拒绝的能力，原因是其站点角色包括该能力（管理员）。
- 用户可能具有在权限规则中被拒绝的能力，原因是他们的用户方案允许该能力（因为他们拥有内容，或者是项目所有者或主管）。
- 用户可能缺少在权限规则中被允许的能力，原因是其站点角色不允许该能力。
- 用户可能缺少在权限规则中被允许的能力，原因是存在冲突的组或用户规则拒绝了该能力。
- 用户可能缺少在权限规则中的某一内容级别（例如工作簿）允许的能力，原因是另一个内容级别（例如视图）拒绝了该能力。

## 评估权限规则

Tableau 中的权限是限制性的。除非将能力授予用户，否则将拒绝用户的权限。以下逻辑评估某项能力对于某个人是允许还是拒绝：

![有关如何评估权限的规则的流程图](/tableau/next/zh-cn/online/zh-cn/Img/perms_evalflow_basic.png)

1. **站点角色：**如果站点角色不允许某项能力，则会拒绝用户。如果用户的站点角色允许该能力，则会评估特定用户方案。
    - 例如，Viewer（查看者）站点角色无法进行 Web 编辑。有关每个站点角色可执行的操作的详细信息，请参见[允许每个站点角色所具有的一般能力](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm#site-role-capabilities-summary)。
2. **特定用户方案：** 
    
    - 如果用户是管理员，则他们对所有内容具有所有能力。
    - 如果用户是项目所有者或项目主管，则他们对其项目中的所有内容具有所有能力。
    - 如果用户是内容所有者，则他们对自己的内容具有所有能力。
    - 如果这些方案不适用于用户，则评估用户规则。
    
    \*例外情况：在权限已锁定的项目中，内容所有者将没有**“设置权限”**能力。只有管理员、项目所有者和项目主管才能在锁定的项目中设置权限规则。
3. **用户规则：**如果拒绝用户使用某项能力，则拒绝该能力。如果允许用户使用某项能力，则允许该能力。如果能力为未指定，则评估组规则。
4. **组规则：**如果拒绝_任何_组中的用户使用某项能力，则拒绝该能力。如果用户在允许某项能力的组中（并且不在拒绝该能力的任何组中），则允许该能力。
    - 也就是说，如果用户是两个组中的成员，其中一个组被允许拥有某项能力，另一个组被拒绝拥有同一能力，则拒绝行为对于该用户为优先行为，并且用户会被拒绝。
5. **组集规则：**如果用户是组集中某个组的成员，则组集中任何被拒绝功能的组都将被拒绝。
6. 如果以上条件都不适用，则拒绝用户拥有该能力。实际上，这意味着保留为未指定的能力将导致被拒绝。

因此，在三种情况下会出现**“已允许”**最终有效权限：

- 被站点角色（服务器管理员、站点管理员 Creator、站点管理员 Explorer）允许
- 由于用户是内容所有者、项目所有者或项目主管而被允许
- 被组、组集或用户规则允许（并且未被更高优先级的规则拒绝）

在三种情况下会出现**“已拒绝”**：

- 被站点角色拒绝
- 被规则拒绝（并且未被更高优先级的规则允许）
- 未由任何规则授予

## 评估在多个级别设置的权限

如果“资产权限”设置为“可自定义”，则可以在多个地方配置权限规则。有一些用于确定对内容应用什么权限的特定规则。

- 如果存在嵌套项目，则在子级别设置的权限优先于在父级别设置的权限。
- 不会为现有内容强制实施在项目级别权对权限进行的更改。
- 如果在发布期间或发布后对内容（工作簿、数据源或流程）设置了权限，则这些权限优先于在项目级别设置的规则。
- 如果工作簿未显示工作表标签，则对项目级别权限所做的任何更改将_不会_由视图继承，并且任何权限更改必须在视图上完成。
- 将工作簿配置为显示导航工作表标签将覆盖现有视图级别权限，并将其与工作簿级别权限同步。请参见[显示或隐藏工作表标签](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#sheettabs)。

![有关如何使用嵌套项目评估权限的规则的流程图](/tableau/next/zh-cn/online/zh-cn/Img/perms_evalflow_total.png)

此图显示了能力在内容的多个级别中的评估方式。

## 视图的权限

在未处于锁定项目中并且不将工作表显示为用于导航的标签的工作簿中，视图（工作表、仪表板、故事）在发布时会继承工作簿权限，但必须对单独的视图进行任何权限规则更改。“查看”能力与适用于工作簿的那些能力相同，但**“覆盖”**、**“下载工作簿/保存副本”**和**“移动”**除外，这些能力仅在工作簿级别可用。

建议尽可能显示导航工作表标签以便视图继续从工作簿继承其权限。有关详细信息，请参见[显示或隐藏工作表标签](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#sheettabs)。

## 有效权限和按需访问

当为组启用按需访问时，您将看到一条内联通知。按需访问表示当 Tableau 内容的权限依赖于组时，可能会有未在站点上预置的用户可以访问该内容。可能访问内容的用户未在站点上预置，并且没有有效权限。因此，这些用户不会在“有效权限”区域中列出。有关详细信息，请参见[使用具有直接信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm#ondemand)或[使用具有 OAuth 2.0 信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm#ondemand)。

<!-- document id=47bbedea77fcb5459e75d4d8d891e23e2094fac66a90e0725f86a012565596c2 url=/tableau/next/zh-cn/online/permissions.md -->

[跳转到主要内容](#main-content)

# 权限

权限确定用户如何与内容（例如工作簿和数据源）进行交互。权限在权限对话框中或通过 [REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref_permissions.htm) 设置。 在对话框的顶部，权限规则为组或用户配置能力。下方的权限网格显示用户的有效权限。

![显示工作簿选项卡的项目权限对话框](/tableau/next/zh-cn/online/zh-cn/Img/perms_projectwrkbkperms.png "显示工作簿选项卡的项目权限对话框")

有几个相互关联的主题，讨论如何思考、设置和管理权限。主要主题是：

- 本主题涵盖基础知识、如何为项目和其他内容设置权限规则以及特定方案的权限注意事项。
- [权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)，其中详细介绍了用于生成权限规则的各种能力。
- [使用项目管理权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm)，其中介绍了使用项目来管理权限以及嵌套和锁定项目如何影响权限。
- [有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)，其中介绍了如何评估权限规则以及如何确定最终权限。
- [权限、站点角色和许可证](https://help.tableau.com/v0.0/online/zh-cn/permission_license_siterole.htm)，其中介绍了权限如何与站点角色和许可证交互，以确定用户可以对站点执行哪些操作。

此外，如果 Data Management 已获许可，则外部资产的权限还有其他注意事项。有关详细信息，请参见[管理外部资产的权限](https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm)。

## 权限基础知识

**项目和组**

Tableau 站点使用_项目_来组织内容，使用_组_来组织用户。在权限规则为以下各项时，管理权限更加轻松：

- 在项目级别设置，而不是针对单个内容段设置。
- 针对组而不是个人而建立。

只能为用户、组、项目或已存在的资产建立权限。有关创建用户和组、创建项目和发布内容的详细信息，请参见[管理用户和组](https://help.tableau.com/v0.0/online/zh-cn/users.htm)、[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)，以及[发布数据源和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/publish_overview.htm)。

**能力和权限规则** 

权限由_能力_（即执行像查看内容、Web 編輯、下载数据源或删除内容这样的操作的能力）组成。_权限规则_建立允许或拒绝用户或组对资产使用的能力。

有关能力和权限规则模板的详细信息，请参见[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)。

**注意：**一般情况下，当讨论权限时，经常会看到“用户必须具有删除_权限_”之类的短语。在广泛的背景下，这很容易理解。但是，如果像本文中这样在技术级别使用权限时，更准确的说法是“删除_能力_”。在本主题中，我们将使用更精确的术语_能力_，但您应该知道，您可能会在其他地方看到_权限_。

![显示多个权限规则（其中某些功能被允许、拒绝或保留为未指定）的权限对话框](/tableau/next/zh-cn/online/zh-cn/Img/perms_permissionrules.png)

有关能力图标及其含义的细分，请参见[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)。

许可证级别、站点角色和潜在的多个权限规则之间的相互作用是最终确定用户可以做什么或不可以做什么的因素。对于每个用户，这将成为他们的_有效权限_。有关详细信息，请参见[有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)。诸如通过浏览器创建新工作簿（Web 制作）或移动内容等某些任务可能需要对若干能力进行特定配置，而不是在单一能力中捕获。有关详细信息，请参见[特定方案的权限设置](#Permissi)。

## 设置权限

在项目级别、内容级别或从 Tableau Desktop 发布内容时，权限规则的设置方式不同。

**注意**：“项目权限”一词可以有两个含义。项目本身用于控制用户如何与项目进行交互的权限能力（查看和发布）。还有适用于其他内容类型的项目级别权限规则的概念。在本文中，“项目级别权限”是指适用于工作簿、数据源和项目权限对话框中配置的其他资产的权限规则。这与可针对特定工作簿、数据源等设置的“内容级别”权限规则形成对比。

_对于管理员、项目所有者和项目主管_

若要在项目级别设置权限，请执行以下操作：

1. 导航到项目
2. 打开“操作”菜单 (...)，并单击**“权限”**。
    
    ![“操作”菜单](/tableau/next/zh-cn/online/zh-cn/Img/perms_actions_menu.png)
    
    权限对话框将打开。此对话框有两个主要区域：顶部的权限规则，以及下方的有效权限网格。每个内容类型都有一个选项卡。下图显示了“数据源”选项卡。
    
    ![显示“数据源”选项卡的“项目权限”对话框](/tableau/next/zh-cn/online/zh-cn/Img/perms_project_ds_perms.png "显示“数据源”选项卡的“项目权限”对话框")
    
    在顶部选择一行后，有效权限网格中将填充内容。使用此选项来验证权限。悬停鼠标光标将提供有关为何针对该特定用户允许或拒绝该能力的原因。
3. 若要修改现有权限规则，请为该内容类型选择相应的选项卡，然后单击某个能力。
4. 若要创建规则，请单击“+添加组/用户规则”，并开始键入以搜索组或用户。对于每个选项卡，从下拉框中选择一个现有权限角色模板，或通过单击能力来创建自定义规则。

单击一次可将能力设置为**“已允许”**，单击两次将其设置为**“已拒绝”**，第三次单击将清除所选内容（**“未指定”**）。

6. 完成后，单击**“保存”**。
    - 如果选择“无”模板，按钮将显示“删除规则”。

### 设置所有内容类型的项目权限

请记住，项目的权限对话框包含每种内容类型的选项卡。**您必须在项目级别为每种类型的内容设置权限，否则用户将被拒绝访问该内容类型**。只有在明确允许的情况下，才会将能力授予用户。将能力保留为“未指定”将导致该能力被拒绝。

> [!TIP]
> 
> **提示**：每次在项目级别创建权限规则时，请确保查看所有内容类型选项卡。

### 配置资产权限设置

在项目级别设置的权限规则充当该项目及其包含的任何嵌套项目中保存的内容的默认值。这些项目级别的默认规则是是保持统一还是可以编辑取决于“资产权限”设置。可通过两种方式配置此设置：“已锁定”或“可自定义”。有关详细信息，请参见[锁定资产权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#LockProject)。

_适用于管理员、项目主管和内容所有者_

如果项目“资产权限”为“可自定义”，则可以修改单独的资产的权限。以下信息与锁定项目中的资产无关。有关详细信息，请参见[锁定资产权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#LockProject)。

> [!TIP]
> 
> **提示**：尽管可以对“可自定义”项目中的单独资产设置权限，但我们建议在项目级别管理权限。

### 设置资产权限

1. 导航到资产（例如工作簿、数据源、或流程）
2. 打开“操作”菜单 (...)，并单击**“权限”**。
    
    ![“操作”菜单](/tableau/next/zh-cn/online/zh-cn/Img/project_permissions_actionmenu.png)
    
    权限对话框将打开。此对话框有两个主要区域：顶部的权限规则，以及下方的有效权限网格。（请注意顶部缺少选项卡 — 资产级别权限对话框没有选项卡。）
    
    ![工作簿级别的权限对话框，显示权限规则和有效权限](/tableau/next/zh-cn/online/zh-cn/Img/perms_workbookperms.png)
    
    在顶部选择一行后，有效权限网格中将填充内容。使用此选项来验证权限。将鼠标悬停在能力方块上可提供有关针对该特定用户允许或拒绝该能力的原因的信息。
3. 若要修改现有权限规则，请单击某个能力。
4. 若要创建规则，请单击“+添加组/用户规则”，并开始键入以搜索组或用户。从下拉列表中选择一个现有权限角色模板，或通过单击能力来创建自定义规则。

单击一次可将能力设置为**“已允许”**，单击两次将其设置为**“已拒绝”**，第三次单击将清除所选内容（**“未指定”**）。

6. 完成后，单击**“保存”**。
    - 如果选择“无”模板，按钮将显示“删除规则”。

### 设置视图权限

> [!TIP]
> 
> **提示：**尽管可以在工作簿内设置视图级别权限，但我们强烈建议在项目级别（或者，如有必要，在工作簿级别）管理权限。

如果在选中**“将工作表显示为标签”**时发布工作簿，该工作簿中的视图将继承为工作簿设置的所有权限。视图的权限对话框将是只读的。

在某些情况下，独立于包含视图的工作簿来指定视图权限可能很有价值。如果在未选中**“将工作表显示为标签”**（工作表标签已隐藏）时发布工作簿，则视图将从工作簿权限开始，但此后将是独立的，可以独立设置。请注意，这意味着如果为工作簿修改了权限规则，这些更改将不会应用于视图 — 每个视图的权限都需要单独管理。

有关详细信息，请参见[显示或隐藏工作表标签](#sheettabs)。

_对于内容发布者_

如果项目“资产权限”为“可自定义”，则可以在从 Tableau Desktop 发布时针对单独资产设置权限。以下信息与锁定项目中的内容无关。有关详细信息，请参见[锁定资产权限](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#LockProject)。

> [!TIP]
> 
> **提示**：尽管可以对“可自定义”项目中的单独资产设置权限，但我们建议在项目级别管理权限。

1. 从发布对话框中，单击**“权限”**的“编辑”链接。  
    如果“编辑”链接不可用，则权限已锁定到项目，且不能被除项目所有者、项目主管或管理员外的任何用户修改。
2. “添加/编辑权限”对话框显示任何现有权限规则。单击“添加”以添加权限规则，或者单击“编辑”以修改现有权限规则
    
    1. 从左侧窗格中选择组或用户。您可以展开组以查看其包含的用户。
    2. 使用右侧窗格顶部的选择器选择一个现有模板，或使用单选按钮来创建自定义规则。
    
    请注意，无法从发布对话框中检查有效权限。
3. 完成后，单击**“确定”**并继续发布。

**注意：**从 Tableau Prep Builder 中发布流程时，无法设置权限。若要设置流程权限，请参阅适用于项目级别权限或内容级别权限的步骤。

### 清理“所有用户”组

默认情况下，所有用户都将添加到对内容具有基本权限的“所有用户”组中。若要在构建自己的权限规则时从头开始，我们建议您完全删除规则或编辑“所有用户”的规则以移除任何权限（将权限角色模板设置为“无”）。这将减少适用于任何给定用户的规则数量，使有效权限更容易理解，从而有助于防止将来出现任何不明确情况。

## 特定方案的权限设置

某些操作需要权限能力的组合，并可能需要站点角色的组合。下面是一些常见方案及其必要的权限配置

### 保存、发布和覆盖

在权限的上下文中，保存本质上是发布。因此，只能将“覆盖”和“保存副本”能力授予允许发布的站点角色（“管理员”、“Creator”或“Explorer（可发布）”）的用户。“Explorer ”或“Viewer（查看者）”站点角色不能进行发布、覆盖或保存副本操作。

- 项目的“发布”能力允许用户将内容发布到该项目。
- 内容的“覆盖”能力允许用户覆盖现有内容部分进行保存。通过保存内容，用户成为该内容的所有者。“覆盖”能力还允许用户编辑现有内容片段的次要方面，例如指标的描述或数据角色的同义词。以这种方式编辑现有内容不会更改内容的所有者。
- 内容的“下载/保存副本”或“保存副本”能力允许用户使用“发布为...”菜单选项来保存内容的新副本。这通常与 Web 制作结合完成，并意味着用户可以保存其所做的修改。
    - 保存工作簿的副本不同于[自动保存](https://help.tableau.com/current/online/zh-cn/autosave.htm)，后者将所有更改保留为草稿。

#### 发布位置

请务必注意，除非用户具有至少一个项目的“发布”能力，否则无法发布或发布为一段内容，因为所有内容都必须发布到项目中。如果在项目级别没有“发布”能力，则无法发布内容。

#### 覆盖并声明所有权

在 Web 编辑中，只会向内容所有者显示“文件”菜单中的**“发布”**选项。如果不是所有者的用户具有“覆盖”能力（允许他们保存内容），则他们必须使用**“文件”>“发布为...”**，并将工作簿命名为完全相同的名称。这将出现一条警告提示，指出他们将要覆盖现有内容，并且能够这样做。相反，仅具有“保存副本”能力并尝试使用相同名称的用户将看到一条错误，指出他们没有覆盖现有内容的权限。

如果不是内容所有者的用户覆盖内容，他们将成为所有者，拥有需要的所有权限。原始所有者的内容访问权限随后由其作为用户（而不是所有者）的权限确定。

**注意：**“下载/保存副本”是适用于工作簿的联合能力。可以为 Explorer 授予此能力，但他们只能下载工作簿，无法使用“发布为”保存副本。为“Explorer（可发布）”、“Creator”或“管理员”站点角色授予该能力将为他们同时授予下载工作簿_和_使用“文件”菜单中的发布选项保存副本的能力。

### “Web 编辑”和“Web 制作”

Web 编辑和 Web 制作允许用户直接在浏览器中编辑或创建工作簿。

权限能力称为“_Web 编辑_”，站点设置称为“_Web 制作_”。此部分将任何基于 Web 的编辑或发布操作称为 _Web 制作_。

启用此功能需要满足若干要求。

- **用户站点角色：**用户必须具有适当的站点角色。
    - “Viewer（查看者）”永远无法进行 Web 编辑。
    - 可以为“Explorer”授予“Web 编辑”能力，但他们无法发布。本质上，他们可以使用 Web 编辑，动态地根据现有内容来回答更深入的问题，但无法保存所做的编辑。
    - “Explorers（可发布）”或“站点管理员 Explorer”能够发布，但只能使用已发布到站点的数据。
    - “Creator”、“站点管理员 Creator”和“服务器管理员”可以发布和创建数据源。
- **权限能力：**用户必须具有基于所需功能的必要权限能力。

#### 所需的权限能力设置

<table class="table--plain" style="width: 100%;"><colgroup><col><col style="width: 15%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"><col style="width: 12%;"></colgroup><tbody><tr><td>所需的功能</td><td>最低站点角色</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_webedit_icon.png" alt="Web 编辑图标。"> Web 编辑</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloadwkbksaveas_icon.png" alt="“下载工作簿并保存为”图标。"> 下载/保存副本</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖<i>（工作簿）</i></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 发布<i>（项目）</i></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"> 连接（数据源）</td></tr><tr><td>Web 制作（无法保存）</td><td style="font-style: italic;">Explorer</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"> 拒绝</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"> 拒绝</td><td>可选</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td></tr><tr><td>Web 制作和另存为新内容</td><td style="font-style: italic;">Explorer（可发布）</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"> 拒绝</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td></tr><tr><td>Web 制作和保存（覆盖）内容</td><td style="font-style: italic;">Explorer（可发布）</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td></tr><tr><td>使用新数据的 Web 制作和保存新内容</td><td style="font-style: italic;">Creator</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td>可选</td><td>可选</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"> 允许</td><td>可选</td></tr></tbody></table>

“可选”表示所需功能中未涉及此能力

### 仪表板中的 Tableau Agent

仪表板中的 Tableau Agent 允许用户利用 AI 来理解已发布的仪表板，并使用自然语言提出更深入的问题。

启用此功能需要满足若干要求。

**注意**：仪表板中的 Tableau Agent 目前处于测试阶段。在继续设置之前，站点管理员必须选择加入测试版。

- **版本要求**：若要使用仪表板中的 Tableau Agent，您必须登录 Tableau Cloud+ 站点。
- **站点设置：**必须为整个 Tableau 站点启用 Tableau 中的 AI。请参见[在您的 Tableau Cloud 站点中启用 AI](https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm)。如果未启用此设置，则任何用户都无法使用 Tableau Agent，_即使他们具有 AI 访问能力_。
- **用户站点角色**：任何许可的站点角色都可以被授予使用仪表板中的 Tableau Agent 所需的权限。
- **权限能力**：对于想要与 Tableau Agent 一起使用的每个工作簿，每个用户必须允许**“AI 访问”**和**“完整数据查询”**能力。
    - 注意：“完整数据查询”不会授予与“下载完整数据”相同的访问权限，并且仅适用于代理或 API 的上下文。

### 已发布 Tableau 数据源的数据访问权限

发布到 Tableau 站点的数据源可以在 Tableau 环境内具有原生身份验证以及权限。

将数据源发布到 Tableau 站点时，发布者可以选择如何[设置凭据以访问您发布的数据](https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm#workbook-connections-to-tableau-data-sources)，这解决了数据源凭据的处理方式（例如要求用户登录到数据库，或输入其 Google 表格凭据）。这种身份验证由保存数据的任何技术控制，它可在发布数据源时嵌入，或者数据源发布者可以选择提示用户输入其数据源凭据。有关详细信息，请参见[发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources.htm#publishing-steps)。

在 Tableau 的上下文中，还有一些允许或拒绝用户查看（“查看”）和连接到已发布数据源（“连接”）的数据源能力。这些能力的设置与 Tableau 中的任何其他权限一样。

发布使用已发布数据源的工作簿时，作者可以针对使用工作簿的用户控制 Tableau 身份验证的行为方式。作者将工作簿对已发布数据源的访问权限设置为“嵌入密码”（使用作者的数据源“连接”访问权限或“提示用户”（使用查看工作簿的用户的“连接”访问权限），后者可能也需要数据源身份验证。

- 当工作簿设置为**“嵌入密码”**时，查看工作簿的任何人将看到基于作者的数据源访问权限的数据。
- 如果工作簿设置为**“提示用户”**，则会针对数据源检查 Tableau 控制的访问权限。使用工作簿的用户必须具有已发布数据源的“连接”能力才能查看数据。如果已发布数据源已设置为“提示用户”，则查看者还必须输入数据源本身的凭据。

<table class="table--plain"><colgroup><col><col><col></colgroup><tbody><tr><td>工作簿的数据源身份验证</td><td>数据的数据源身份验证</td><td>如何为使用工作簿的用户评估数据访问权限</td></tr><tr><td>嵌入密码</td><td>嵌入密码</td><td>用户可查看数据，就好像他们是工作簿作者一样</td></tr><tr><td>嵌入密码</td><td>提示用户</td><td>用户可查看数据，就好像他们是工作簿作者一样。（提示作者是（而不是用户）进行数据源身份验证。）</td></tr><tr><td>提示用户</td><td>嵌入密码</td><td>用户必须对已发布数据源具有自己的<b>“连接”</b>能力</td></tr><tr><td>提示用户</td><td>提示用户</td><td>用户必须对已发布数据源具有自己的“<b>连接</b>”能力，并且提示用户输入其基础数据凭据</td></tr></tbody></table>

请注意，这适用于使用工作簿，而不是 Web 编辑。若要进行 Web 编辑，用户必须具有自己的“连接”能力。

有关在发布 Tableau 内容（例如使用虚拟连接的数据源或工作簿）时嵌入密码的信息，请参见 Tableau Server 帮助中的[虚拟连接](https://help.tableau.com/current/server/zh-cn/publishing_sharing_authentication.htm#virtual-connection-embedded-password)。

### 允许其他用户刷新数据提取

具有 Explorer（可发布）站点角色或更高级别角色的用户可以被授予针对工作簿或数据源的“数据提取刷新”能力。此能力为用户提供了与资产所有者相同的界面来触发数据提取刷新。数据提取必须是已发布的数据源，或者，如果它是工作簿的本地数据源，则必须具有嵌入式凭据。

由于数据提取刷新可能需要大量资源，并且可能已计划，因此在分配“数据提取刷新”能力时请考虑以下最佳做法：

- **不经常使用的数据提取**：授予用户按需刷新数据提取的能力，并考虑关闭冗余或不需要的计划刷新。
- **定期使用的数据提取**：请考虑计划数据提取刷新，并针对按需刷新限制“数据提取刷新”能力。
    - 分配数据提取刷新能力作为备份，以防止出现依赖于资产所有者或管理员的瓶颈，而不是广泛授予这些权限。

### 移动内容

若要移动某项，请打开其“操作”菜单 (...)，并单击“移动”。为该项选择新项目，然后单击“移动资产”。如果“移动”不可用，或者没有可用的目标项目，请验证是否满足适当的条件：

- 管理员始终可将资产和项目移动到任何位置。
- 项目主管和项目所有者可在其项目之间移动资产和嵌套项目。
    - 请注意，非管理员无法移动项目以使其成为顶层项目
- 只有在以下三个要求均得到满足时，其他用户才能移动资产：
    - “Creator”或“Explorer（可发布）”站点角色。
    - 针对目标项目的发布权限（“查看”和“发布”能力）
    - 内容的所有者，或者（对于工作簿和流程）拥有“移动”能力。

当移动数据库及其表时，用户必须具有数据库_以及_其表的“移动”能力。

有关在移动内容和项目时如何处理权限的信息，请参见[移动项目和内容](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#moveproject)。

### 指标（2024.2 已停用）

> [!TIP]
> 
> **提示：**本部分中的信息针对旧版指标功能，该功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。有关 Tableau Pulse 指标的权限的信息，请参见[为 Tableau Pulse 设置站点](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#permissions)。

**旧版指标功能的停用**

Tableau 的旧版指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。借助 Tableau Pulse，我们开发了一种改进的体验来跟踪指标和询问数据问题。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)以了解新体验，并参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)了解已停用的功能 。

指标是从已发布工作簿中的视图创建的。如果用户满足以下条件，则可以创建指标：

- 具有“Creator”或“Explorer（可发布）”站点角色
- 拥有项目的“**发布**”能力
- 拥有相关工作簿的**“创建/刷新指标”**能力

有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm)以及[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

由于指标是独立的资产，因此请务必注意，指标的权限是通过从中创建指标的视图独立管理的。（这与数据驱动的通知和订阅不同，在这两者中，只有在用户具有视图本身的正确权限时才能查看通知或订阅的内容。）

尽管适用于指标的能力非常明确，但应仔细考虑“**查看**”能力。具有受限权限的工作簿可能是具有更多开放权限的指标的基础。为了保护敏感数据，您可能希望拒绝为特定工作簿创建指标。

#### 指标从所有者的角度显示数据

创建指标时，视图将从您的角度显示数据。这意味着任何可以访问您的指标的用户都将看到显示给您的数据。如果基于您的凭据筛选视图中的数据，则您看到的数据可能与其他用户在访问同一视图时看到的不同。如果您担心暴露您的数据角度，请限制指标的“查看”能力。

### “数据解释”功能

当“数据解释”功能可用时，用户可以在视图中选择一个标记，然后单击标记的工具提示菜单中的“运行数据解释”。必须启用设置组合才能使“数据解释”功能在编辑模式和查看模式下可用。

作者在编辑模式下运行“数据解释”功能或编辑“数据解释”功能设置的要求：

- 站点设置：将“‘数据解释’功能的可用性”设置为“启用”。默认情况下处于启用状态。
- 站点角色：Creator 或 Explorer（可发布）。
- 权限：将“运行数据解释”能力设置为“允许”。默认情况下未指定。如果您在 Tableau 版本 2022.2 或更高版本中打开使用此权限的工作簿（Tableau 版本 2022.1 或更低版本），则必须将“运行数据解释功能”能力重置为“允许”。

**注意：**Creator 或 Explorer（可发布）的“下载完整数据”能力控制他们是否在“极端值”解释中看到“查看完整数据”选项。Viewer（查看者）总是被拒绝“下载完整数据”能力。但是，当在“数据解释”功能设置中启用“极端值”解释类型时，所有用户都可以看到记录级别详细信息。

所有用户在查看模式下运行“数据解释”功能的要求：

- 站点设置：将“‘数据解释’功能的可用性”设置为“启用”。默认情况下处于启用状态。
- 站点角色：Creator、Explorer 或 Viewer（查看者）
- 权限：将“运行数据解释”能力设置为“允许”。默认情况下未指定。如果您在 Tableau 版本 2022.2 或更高版本中打开使用此权限的工作簿（Tableau 版本 2022.1 或更低版本），则需要将“运行数据解释功能”能力重置为“允许”。

### 显示或隐藏工作表标签

在已发布内容的上下文中，工作表标签（也称为选项卡式视图）是与 Tableau Desktop 中的工作表标签不同的概念。在 Tableau Desktop 中显示和隐藏工作表标签是指在制作环境中隐藏工作表。有关详细信息，请参见[管理仪表板和故事中的工作表](https://help.tableau.com/current/pro/desktop/zh-cn/environ_workbooksandsheets_sheets_hideshow.htm)。

显示和隐藏已发布内容的工作表标签（打开或关闭选项卡式视图）是指在已发布工作簿中导航。显示工作表标签时，已发布的内容在每个视图的顶部都有导航工作表标签。

![打开和关闭选项卡式视图的视图导航比较](/tableau/next/zh-cn/online/zh-cn/Img/tabbedviews.png)

此设置还会影响权限的运行，可能具有安全影响（请参见注释）。

**注意：**没有工作簿或其包含的项目的“查看”能力的情况下，可以具有视图的“查看”能力。通常，如果用户缺少项目和工作簿的“查看”能力，则他们不会知道这些资产的存在。如果他们具有视图的“查看”能力，则当用户查看视图时，例如在导航痕迹中查看视图时，也许能够看到项目和工作簿名称。这是预期和接受的行为。

#### 关闭选项卡式视图以允许独立视图权限

虽然一般不建议这样做，但有时独立于包含这些视图的工作簿设置视图权限可能很有用。为此，必须满足三个条件：

1. 工作簿必须已发布 — 无法在发布期间设置视图权限。
2. 工作簿必须在可自定义项目中。
3. 工作簿不能将工作表显示为标签（必须隐藏选项卡视图）。

如果工作簿将工作表显示为标签，则所有视图将继承工作簿权限，并且对工作簿权限进行的任何更改将影响所有其视图。**如果可自定义项目中的工作簿未显示选项卡式视图，则所有视图会在发布时假定工作簿权限，但对工作簿权限规则所做的任何后续更改**_都不会由视图继承_**。**

如果更改已发布工作簿上显示为标签的工作表的配置，则也会影响权限模型。“显示标签”会覆盖任何现有视图级别权限，并恢复所有视图的工作簿级别权限。“隐藏标签”会断开工作簿与其视图之间的关系。

- 若要将工作表配置为已发布工作簿上的标签，请打开该工作簿的“操作”菜单 (...)，并选择**“选项卡式视图”**。根据需要选择“显示标签”或“隐藏标签”。
- 若要在发布过程中将工作表配置为标签，请参阅[将工作表显示为标签](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_howto.htm#show-sheets-as-tabs)。
- 若要设置视图级别权限，请参见[设置资产权限](#contentpermissions)。

> [!IMPORTANT]
> 
> **重要信息：**在可自定义项目中，如果隐藏了导航工作表标签（也称为关闭了选项卡式视图），则不会应用对工作簿级别权限所做的任何修改。权限更改必须在单独的视图上进行。

### 集合

有关管理集合中的权限的信息，请参见[集合](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#collections)。

## 此部分中的其他文章

<!-- document id=8bc4160d0197dd6a377a8619b0fd61353f69bd44efb658226b3840ab0c9bd44d url=/tableau/next/zh-cn/online/permission_license_siterole.md -->

[跳转到主要内容](#main-content)

# 权限、站点角色和许可证

将用户添加到 Tableau Cloud 需要可用的许可证。（用户也可以添加为未获许可和已配置，以便他们仅在首次登录时使用许可证。有关详细信息，请参见[登录时授予许可证](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm)。）对于用户所属的每个站点，他们确切地拥有一个受其许可证所限的站点角色。用户对站点上的内容具有权限，受其站点角色所允许的能力限制。

许可证和站点角色适用于用户。权限能力适用于内容。

系统在 Tableau Server 或 Tableau Cloud 站点上创建**许可证**时（或用户首次登录时），会将其分配给用户。用户以 **Creator**、**Explorer** 或 **Viewer**（查看者）身份获得授权。

- 许可证级别是根据用户在该服务器上可以拥有的最大_站点角色_来使用的。
    - “站点管理员 Creator”和“Creator”站点角色使用 Creator 许可证。
    - “站点管理员 Explorer”、“Explorer（可发布）”和“Explorer”站点角色至少使用 Explorer 许可证。
    - “Viewer（查看者）”站点角色至少使用 Viewer（查看者）许可证。
    - 未许可用户可以存在于站点上，但除非在添加时选择了登录时授予站点角色，否则他们无法登录。
- 在 Tableau Cloud 中，一名用户只消耗每租户的一个许可证，即使他们是多个站点的成员。如果用户是多个站点的成员，则该用户的许可证级别由其最高站点角色确定。（举例来说，如果某名用户在一个站点上拥有“Creator”站点角色，在另外两个站点上拥有“Viewer（查看者）”站点角色，则他们消耗 Creator 许可证。有关如何在 Tableau Cloud Manager 中处理站点角色限制和许可证的详细信息，请参见[管理站点角色限制](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_site_role_limit.htm)。

将针对用户是其成员的每个站点为用户分配**站点角色**。

- 站点角色确定用户在该站点中可拥有的最大能力。（例如，具有“Viewer（查看者）”站点角色的用户永远无法下载数据源，即使针对特定数据源为其显式授予了该能力也是如此。）
- 站点角色并不会固有地在本身中授予任何能力和授予本身的任何能力 — 管理员站点角色除外。管理员始终具有适用于其许可证级别的所有能力。

**权限**由像保存到项目、对工作簿进行 Web 編輯、连接到数据源等这样的_能力_构成。它们针对特定的一部分内容（项目、数据源、工作簿、视图或流程）应用于组或用户。有关详细信息，请参见[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)模板。

- 系统不会在隔绝的环境中将权限能力授予组或用户，而是在内容上下文中授予。对于不同的内容资产，用户可能具有不同的能力。
- 系统根据用户的站点角色与该用户或其所属的任何组的权限规则的相互作用对权限进行评估。
- 诸如 Web 制作等某些操作可能需要能力的组合。有关详细信息，请参见[特定方案的权限设置](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#Permissi)。

## 站点角色及其最大能力

以下各表指明了提供给站点角色的能力。具有某个站点角色的用户可能有其他方式来执行类似的操作。例如，虽然无法为 Viewer（查看者）提供“共享自定义”能力以使其自定义视图对工作簿上的其他人可见，但他们可以通过复制视图 URL 来共享自定义视图。有关每个站点角色可执行的操作的详细信息，请参见[允许每个站点角色所具有的一般能力](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm#site-role-capabilities-summary)。

有关每个能力的详细信息，请参见[权限能力和模板](https://help.tableau.com/v0.0/online/zh-cn/permissions_capabilities.htm)。

### 项目

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 发布</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### 工作簿

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_filter_icon.png" alt="“筛选器”图标。"> 筛选</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_viewcomments_icon.png" alt="“查看注释”图标。"> 查看注释</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_addcomments_icon.png" alt="“添加注释”图标。"> 添加注释</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloadimage_icon.png" alt="“下载完整数据”图标。"> 下载图像/PDF</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloadsumdata_icon.png" alt="“下载总和数据”图标。"> 下载摘要数据</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_explain_data_icon.png" alt="“数据解释”功能图标。"> 使用“数据解释”功能<a href="#dagger">†</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_sharecustomized_icon.png" alt="“共享自定义”图标。"> 共享自定义</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloadfulldata_icon.png" alt="“下载完整数据”图标。"> 下载完整数据</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_webedit_icon.png" alt="Web 编辑图标。"> Web 编辑</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_full_data_query.png" alt="完整数据查询图标。"> 完整数据查询 <a href="#ddagger">‡</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloadwkbksaveas_icon.png" alt="“下载工作簿并保存为”图标。"> 下载工作簿/保存副本</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_ai_access.png" alt=""> AI 访问</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_api_access_icon.png" alt="“移动”图标。"> API 访问</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_metrics_icon.png" alt=""> 创建/刷新指标 <a href="#section">§</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_extract_refresh.jpg" alt="数据提取刷新权限能力的图标"> 刷新数据提取</p></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

† 可以使用“运行‘数据解释’”能力在站点设置和工作簿中控制“数据解释”功能的可用性。查看模式下“数据解释”功能的可用性在“数据解释设置”对话框中的工作簿中进行控制。

‡ 可以为所有站点角色授予“完整数据查询 (FDQ)”。它与 API 或“AI 访问”配合使用，授予这些工具查询完整数据的能力。FDQ 与“下载完整数据”不同。

§ 在 Tableau 2021.3 之前，“创建/刷新指标”能力由“下载完整数据”能力控制。

### 数据源

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"> 连接</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloaddatasource_icon.png" alt="“下载数据源”图标。"> 下载数据源</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_pulse_metric_icon.png" alt="“创建指标定义”图标"> 创建指标定义</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_extract_refresh.jpg" alt="数据提取刷新权限能力的图标"> 刷新数据提取</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### 数据角色

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### 流程

若要按计划运行流程，您必须具有 Data Management 许可证。有关配置流程设置的信息，请参见[在 Web 上创建流程并与其进行交互](https://help.tableau.com/current/server/zh-cn/web_author_flows.htm)。Explorer（可发布）许可证用户可以在 Tableau Server 和 Tableau Cloud 上运行流程。从版本 2020.4 开始，Explorer 许可证用户无法运行流程，即使管理员授予他们“运行流程”权限也是如此。

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloaddatasource_icon.png" alt="“下载数据源”图标。"> 下载流程</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_webedit_icon.png" alt="Web 编辑图标。"> Web 编辑</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"> 运行流程</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### “数据问答”(Ask Data) 功能镜头

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### 指标（2024.2 已停用）

> [!TIP]
> 
> **提示：**本部分中的信息针对旧版指标功能，该功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。有关 Tableau Pulse 指标的权限的信息，请参见[为 Tableau Pulse 设置站点](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#permissions)。

**旧版指标功能的停用**

Tableau 的旧版指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。借助 Tableau Pulse，我们开发了一种改进的体验来跟踪指标和询问数据问题。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)以了解新体验，并参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)了解已停用的功能 。

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

### 集合

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr></tbody></table>

### 虚拟连接

虚拟连接需要 Data Management 许可证。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。

<table class="table--plain"><colgroup><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"><col style="width: 20%;"></colgroup><tbody><tr><td>能力</td><td>Creator</td><td>Explorer（可发布）</td><td>Explorer</td><td>Viewer（查看者）</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 视图</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"> 连接</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#dasterisk">**</a></td><td><a href="#dasterisk">**</a></td><td><a href="#dasterisk">**</a></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"> 移动</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><a href="#asterisk">*</a></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"> 删除</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_allow_icon.png" alt="“允许权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/permissions_deny_icon.png" alt="“拒绝权限”图标。"></td></tr></tbody></table>

\*尽管可为“Explorer”角色授予“移动”能力，但他们无法具有项目的“发布”能力，因此没有地方让他们移动内容。因此，对于“Explorer”站点角色，“移动”能力应被视为无法实现。

\*\* 尽管可以为 Explorer（可发布）角色赋予虚拟连接的**“连接”**能力，但只有具有 Creator 站点角色的用户才能够创建任何类型的新数据源（包括虚拟连接）。同样，Explorer 和 Viewer（查看者）角色用户无法访问 UI 来连接到新的或现有的数据源。除了 Creator 之外，其他任何角色都不可能具备**“连接”**能力。

<!-- document id=a262583a94e35a67bdd29501ad0ec41f39f9bb565942dbe67b64e5f515128689 url=/tableau/next/zh-cn/online/adminview_insights_permissions.md -->

[跳转到主要内容](#main-content)

# 权限数据源

权限包含对站点上所有用户和内容的显式权限。管理员可以使用数据源来识别权限安全方面的漏洞，并确保只有适当的用户才能访问内容项。

**注意：**站点角色确定用户可以拥有的最大能力。例如，Viewer（查看者）不能进行 Web 编辑，即使在用户或组规则中允许他们这样做。根据评估权限的顺序，用户可能具有与数据源中所列出能力不同的能力。有关详细信息，请参见[有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：哪些用户和组有权访问内容？

使用这些步骤创建一个视图，显示哪些用户和组有权访问内容。

1. 连接到“权限”数据源。
2. 从“数据”窗格中，将“Item Type”（项类型）、“Item Name”（项名称）、“Item Parent Project Name”（项父项目名称）和“Controlling Permissions Project Name”（控制权限项目名称）拖到“行”功能区。这将创建站点内容的分层视图并显示权限的确定方式，例如，权限是在项目级别还是在个别内容项上设置的。
3. 从“数据”窗格中，将“Grantee Name”（被授权人名称）和“Grantee Type”（被授权人类型）拖到“行”功能区。添加这些维度可以显示有权访问内容的用户和组。
4. 从“数据”窗格中，将“Capability Type”（能力类型）拖到“行”功能区。显示用户和组的能力。

## 锁定的项目和继承的权限

当项目被锁定时，它包含的内容项会从该项目继承其权限。这些项包括工作簿、数据源和 Prep 流程。他们没有自己的明确权限规则。

在“Permissions”（权限）数据源中，锁定项目中的内容项显示为一行，其中“Grantee Name”（被授权人名称）和“Capability Type”（能力类型）为 null。null 值意味着该项从控制项目继承其权限，“Controlling Permissions Project Name”（控制权限项目名称）字段标识该项目。它们并不表示数据中存在空白或缺少访问权限。

若要查找适用于内容项的权限，请使用以下步骤：

1. 连接到“Permissions”（权限）数据源。
2. 从“数据”窗格中，将“Item Name”（项名称）、“Item Type”（项类型）、“Controlling Permissions Project Name”（控制权限项目名称）、“Grantee Name”（被授权人名称）和“Capability Type”（能力类型）拖到“行”功能区。
3. 从“数据”窗格中，将“Item Name”（项名称）拖到“筛选器”功能区，然后从锁定项目中选择一个内容项。该项显示的“Grantee Name”（被授权人名称）和“Capability Type”（能力类型）值均为 null。
4. 编辑“Item Name”（项名称）筛选器，然后按“Controlling Permissions Project Name”（控制权限项目名称）字段中的项目名称进行筛选。该视图显示适用于内容项的被授权人和能力。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将“权限”与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“项 LUID = 项 LUID”上将“站点内容”联接到“权限”（左联接）
- 在“用户 LUID = 用户 LUID”上将“权限”联接到“TS 用户”
- 在“被授权人 LUID = 组 LUID”上将“权限”联接到“组”（右联接）

> [!TIP]
> 
> **提示：**若要简化分析，请删除“所有用户”组规则或编辑规则以移除权限。

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了“权限”数据源中包含的字段。每行数据对应用户、内容项和权限能力的组合。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="3">Capabilities</td><td>Capability Type</td><td>字符串</td><td>对项执行给定操作的能力。选项包括查看、筛选、下载或删除，并且对于项类型而言是唯一的。对于已锁定项目中的内容项，此值为 null。</td></tr><tr><td>Permissions Description</td><td>字符串</td><td>权限值的描述。</td></tr><tr><td>Permission Value</td><td>数字</td><td>内容项的显式权限的数字表示形式。较低的值表示优先。例如，允许向某个组中的用户授予能力 (7) 优先于拒绝向该组授予能力 (8)。</td></tr><tr><td rowspan="3">Grantees</td><td>Grantee LUID</td><td>字符串</td><td>被授权人的 LUID。用户 LUID 或组 LUID。主要用于通过 REST API 引用内容。</td></tr><tr><td>Grantee Name</td><td>字符串</td><td>被授权人的名称。用户电子邮件或群组名称。对于已锁定项目中的内容项，此值为 null。</td></tr><tr><td>Grantee Type</td><td>字符串</td><td>被授权人的类型。用户或组。</td></tr><tr><td rowspan="7">Items</td><td>Controlling Permissions Project Name</td><td>字符串</td><td>控制嵌套项目权限的项目的名称。对于锁定项目中的内容项，此字段标识该项从中继承其权限的项目。有关详细信息，请参见<a href="#locked-projects" class="xref">锁定的项目和继承的权限</a>。</td></tr><tr><td>Item Hyperlink</td><td>字符串</td><td>站点上指向该项的完整 URL。对于在仪表板上创建超链接很有用。</td></tr><tr><td>Item LUID</td><td>字符串</td><td>项的 LUID。LUID 在每个项类型和站点内都是唯一的。主要用于通过 REST API 引用内容。</td></tr><tr><td>Item Name</td><td>字符串</td><td>项的显示名称。</td></tr><tr><td>Item Parent Project Name</td><td>字符串</td><td>项的父项目的名称。</td></tr><tr><td>Item Type</td><td>字符串</td><td>内容项的类型。例如数据源、Prep 流程、项目或工作簿。</td></tr><tr><td>Top Parent Project Name</td><td>字符串</td><td>项的顶级项目的名称。</td></tr><tr><td rowspan="2">Site</td><td>Site LUID</td><td>字符串</td><td>Tableau Cloud 站点的 LUID。主要用于通过 REST API 引用内容。</td></tr><tr><td>Site Name</td><td>字符串</td><td>Tableau Cloud 站点的名称。</td></tr><tr><td rowspan="5">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)。</td></tr><tr><td>User Email</td><td>字符串</td><td>拥有显式权限的用户的电子邮件地址。</td></tr><tr><td>User LUID</td><td>字符串</td><td>拥有显式权限的用户的 LUID。</td></tr><tr><td>User Site Role</td><td>字符串</td><td>用户的站点角色。</td></tr><tr><td>Has Permission?</td><td>计算字段</td><td>指明是否允许被授权人访问某个项。不考虑“站点管理员”能力。站点管理员拥有的权限多于计算捕获的权限。</td></tr></tbody></table>

<!-- document id=925581465fc232f2e7dde4f0cc723d4ed54dd77aa9514d4ee2983fc4e4cb4d61 url=/tableau/next/zh-cn/online/permissions_capabilities.md -->

[跳转到主要内容](#main-content)

# 权限能力和模板

权限由能力（即对一部分内容执行给定操作的能力，例如查看、筛选、下载或删除）组成。对话框的“权限规则”区域中的每一行是一条_权限规则_。权限规则是该行中组或用户的每个能力（已允许、已拒绝或未指定）的设置。权限规则具有可用的_模板_，使快速分配能力变得更加容易。也可以复制和粘贴权限规则。

**注意**：在项目的权限对话框中，有适用于每种内容类型的选项卡： “项目”、“工作簿”、“数据源”等。添加权限规则后，所有内容类型中所有能力的默认值均为“未指定”。若要允许或拒绝针对每种内容类型的能力，必须依次转到权限对话框的每个选项卡。这将为项目中该类型的所有内容（例如所有工作簿）设置模式。在特定内容的权限对话框中，没有选项卡，并且权限规则仅适用于该内容。

## 模板

模板将通常根据常见用户方案分配在一起的能力集（“查看”、“浏览”、“发布”和“管理”）分组。分配模板会将其包含的能力设置为“已允许”，并将其余能力保留为“未指定”。模板是累积的，因此“浏览”模板包括“查看”模板中的所有能力加上其他能力。所有内容还具有**“无”**（将所有能力设置为未指定）和**“已拒绝”**（将所有能力设置为已拒绝）模板。

模板是一个起点，可以在应用模板后进行调整。也可以在完全不使用模板的情况下授予或拒绝能力。在这两种情况下，模板列随后都将显示“自定义”。

## 复制和粘贴权限

如果需要将权限规则分配给多个组或用户，则可以将权限规则从一个规则复制并粘贴到另一个规则。不能在包含“项目主管”状态的规则中复制或粘贴。

1. 打开要从中复制的现有规则的操作菜单 (...) ，然后选择“复制权限”。仅当规则未处于编辑模式时，此选项才可用。
2. 选择要在其上粘贴的现有规则。您也可以通过单击“+添加组/用户规则”并选择组或用户来创建新规则。
3. 打开“操作”菜单 (...)，然后选择“粘贴权限”。

## 有效权限

请记住，仅仅因为用户被授予给定规则中的能力并不意味着他们将有能力执行该操作。用户可以执行的操作有站点角色上限（请参见[权限、站点角色和许可证](https://help.tableau.com/v0.0/online/zh-cn/permission_license_siterole.htm)），并且可能需要比较多个权限规则以评估给定用户的最终能力（请参见[有效权限](https://help.tableau.com/v0.0/online/zh-cn/permission_effective.htm)）。

## 能力

每个内容类型都有特定的能力：

### 项目

项目只有两个能力和两个模板。有关项目主管以及如何分配他们的详细信息，请参见[项目管理](https://help.tableau.com/v0.0/online/zh-cn/permissions_projects.htm#projectpermissions)。

#### “查看”模板

![“查看”图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_view_icon.png)**“查看”**使用户能够查看项目。如果没有授予用户“查看”能力，则他们将看不到项目。授予项目的“查看”能力并不意味着用户可以看到项目中的任何内容，而只是意味着项目本身存在。

#### “发布”模板

![“保存”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_save_icon.png)**“发布”**使用户能够通过 Tableau Desktop 或 Tableau Prep Builder 将内容发布到项目。通过 Web 制作将内容移到项目中或将内容保存到项目也需要“发布”能力。

### 工作簿

#### “查看”模板

![“查看”图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_view_icon.png)**“查看”**使用户能够查看工作簿或视图。如果没有授予用户“查看”能力，则他们将看不到工作簿。

![“筛选器”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_filter_icon.png)**“筛选器”**使用户能够与视图中的筛选器（包括“只保留”和“排除”筛选器）交互。缺少此能力的用户将不会在视图中看到筛选器控件。

![“查看注释”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_viewcomments_icon.png)**“查看注释”**使用户能够查看与工作簿中的视图关联的注释。

![“添加注释”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_addcomments_icon.png)**“添加注释”**使用户能够为工作簿中的视图添加注释。

![“下载完整数据”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_downloadimage_icon.png)**“下载图像/PDF”**使用户能够以 PNG、PDF 或 PowerPoint 格式下载每个视图。

![“下载总和数据”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_downloadsumdata_icon.png)**“下载摘要数据”**使用户能够查看视图或他们选择的标记中的聚合数据，并（以 CSV 格式）下载该数据。

#### “浏览”模板

![“共享自定义”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_sharecustomized_icon.png)**“共享自定义”**使用户能够将他们的自定义视图添加到工作簿上可见的“其他视图”列表中。

- 如果此能力被拒绝，用户在创建自定义视图时将看不到“对其他人可见”选项。有关详细信息，请参见[“使用自定义视图”](https://help.tableau.com/current/pro/desktop/zh-cn/customview.htm)。此能力不会影响通过共享对话框或通过复制链接共享自定义视图的能力。

![“下载完整数据”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_downloadfulldata_icon.png)**“下载完整数据”**使用户能够查看视图或他们选择的标记中的基础数据，并（以 CSV 格式）下载该数据。

- 下载完整数据与完整数据查询不是一回事，后者由 API 代表用户使用。

![Web 编辑图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_webedit_icon.png)**“Web 编辑”**使用户能够在基于浏览器的制作环境中编辑视图。

- 在浏览器中创建新内容或者通过 Web 编辑界面保存视图需要特定的能力组合。有关详细信息，请参见[“Web 编辑”和“Web 制作”](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#webauthor)。
- 还必须为整个站点启用“Web 编辑”功能，否则，即使具有此能力的用户也无法进行 Web 编辑。有关详细信息，请参见[设置站点的 Web 制作访问权限](https://help.tableau.com/current/server/zh-cn/web_author_enable.htm)。

![](/tableau/next/zh-cn/online/zh-cn/Img/perms_explain_data_icon.png)**“运行‘数据解释’功能”**使用户能够在编辑和查看模式下对标记运行“数据解释”功能。

- 为了在用户选择工作簿中的标记时将“数解释据”功能显示为选项，还必须启用该功能作为站点设置。若要在查看模式下使用“数据解释”功能，作者还必须从“数据解释”功能设置中的工作簿内允许该功能。有关详细信息，请参见[控制对“数据解释”功能的访问](https://help.tableau.com/current/pro/desktop/zh-cn/explain_data_control_access.htm)。

![完整数据查询](/tableau/next/zh-cn/online/zh-cn/Img/perms_full_data_query.png) **完整数据查询**允许 API 或代理访问工作簿数据源中的基础数据。

- 完整数据查询 (FDQ) 与下载完整数据不同。FDQ 是一种直通权限能力，它与“API 访问”或“AI 访问”结合使用，允许 API 或智能体代表用户查询工作簿的数据。
- FDQ 保证用户筛选器仅在是数据源筛选器（而不是工作簿或工作表级别的筛选器）时强制执行。必须将具有用户筛选器的行级安全性设置为数据源筛选器。
- VizQL Data Service 与工作簿数据的交互需要 FDQ 和 API 访问权限能力。
- 如果不允许 FDQ，仪表板中的 Tableau Agent 只能访问摘要数据，因此发现更深入见解和分析的能力有限。FDQ 是 Tableau Agent 的全部功能所必需的。

#### “发布”模板

![“下载工作簿并保存为”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_downloadwkbksaveas_icon.png)**“下载工作簿/保存副本”**使用户能够（以 TWBX 格式）下载打包工作簿。使用户能够从 Web 编辑界面中将副本保存（发布）为新工作簿。

![“保存”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_save_icon.png)**“覆盖”**使用户能够覆盖（保存）服务器上的内容或资产。

- 允许时，用户可以在 Web 制作过程中重新发布工作簿、数据源或流程，或者保存工作簿或流程，从而成为所有者并获得所有权限。所有权更改后，就像任何其他用户一样，原始所有者对工作簿的访问权限由其权限确定。

![“API 访问”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_api_access_icon.png)**API 访问**允许用户使用 VizQL Data Service 查询工作簿的数据源。有关详细信息，请参见 [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/zh-cn/index.html)。

![](/tableau/next/zh-cn/online/zh-cn/Img/perms_ai_access.png)**AI 访问**允许用户使用仪表板中的 Tableau Agent，包括“仪表板概述”、“仪表板见解”和“仪表板问答”。

- 同时授予“完整数据查询”，以便 AI 工具可以访问可视化项中的摘要数据之外的更多内容。

![](/tableau/next/zh-cn/online/zh-cn/Img/perms_metrics_icon.png)**“创建/刷新指标”**使用户能够在工作簿中的视图上创建指标，并使用户能够从这些视图创建的任何指标进行刷新。Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)。

#### “管理”模板

![“移动”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_move_icon.png)**“移动”**使用户能够项目之间移动工作簿。有关详细信息，请参见[移动内容](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#MoveContent)。

![“删除”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_delete_icon.png)**“删除”**使用户能够删除工作簿。

![“设置权限”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_setperms_icon.png)**“设置权限”**使用户能够为工作簿创建权限规则。

![数据提取刷新权限能力的图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_extract_refresh.jpg)**“刷新数据提取”**使用户能够触发该工作簿的数据提取刷新。

### 视图

在未处于锁定项目中并且不将工作表显示为用于导航的标签的工作簿中，视图（工作表、仪表板、故事）在发布时会继承工作簿权限，但必须对单独的视图进行任何权限规则更改。“查看”能力与适用于工作簿的那些能力相同，但**“覆盖”**、**“下载工作簿/保存副本”**和**“移动”**除外，这些能力仅在工作簿级别可用。

建议尽可能显示导航工作表标签以便视图继续从工作簿继承其权限。

### 数据源

#### “查看”模板

![“查看”图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_view_icon.png)**“查看”**使用户能够查看服务器上的数据源。

![“连接”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_connect_icon.png)“**连接”**使用户能够在 Tableau Desktop、Tableau Prep Builder、“数据问答”(Ask Data) 功能或 Web 编辑中连接到数据源。

- 如果工作簿作者将其凭据嵌入已发布工作簿中发布的数据源，则本质上是嵌入了他们的**“连接”**能力。因此，用户将能够查看工作簿中的数据，而不管他们自己对于该数据源的**“连接”**能力如何。如果工作簿作者未将其凭据嵌入发布的数据源，则用户需要自己的数据源**“连接”**能力才能使用工作簿。有关详细信息，请参见[已发布 Tableau 数据源的数据访问权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#PublishedData)。
- 用户必须具有数据源的**“连接”**能力才能使用“数据问答”(Ask Data) 功能和创建“数据问答”(Ask Data) 功能镜头。有关详细信息，请参见[“为站点和数据源启用‘数据问答’（Ask Data）功能”](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_enable.htm#ensure-that-users-can-access-a-data-source)。

#### “浏览”模板

![“下载数据源”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_downloaddatasource_icon.png)**“下载数据源”**使用户能够（以 TDSX 格式）从服务器下载数据源。

#### “发布”模板

![“保存”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_save_icon.png)**“覆盖”**使用户能够将数据源发布到服务器，并覆盖服务器上的数据源。

![](/tableau/next/zh-cn/online/zh-cn/Img/perms_api_access_icon.png)**API 访问**允许用户使用 VizQL Data Service 查询数据源。有关详细信息，请参见 [VizQL Data Service](https://help.tableau.com/current/api/vizql-data-service/zh-cn/index.html)。

![“创建指标定义”图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_pulse_metric_icon.png) **创建指标定义**允许用户连接到数据源来创建 Tableau Pulse 指标定义。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)。

#### “管理”模板

![“删除”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_delete_icon.png)**“删除”**使用户能够删除数据源。

![“设置权限”图标。](/tableau/next/zh-cn/online/zh-cn/Img/perms_setperms_icon.png)**“设置权限”**使用户能够为数据源创建和编辑权限规则。

![数据提取刷新权限能力的图标](/tableau/next/zh-cn/online/zh-cn/Img/perms_extract_refresh.jpg)**“刷新数据提取”**使用户能够触发数据源的数据提取刷新。

### 其他类型的资产

<table class="table--plain" style="width: 100%;"><colgroup><col><col style="width: 22%;"><col style="width: 22%;"><col style="width: 22%;"><col style="width: 22%;"></colgroup><tbody><tr><td>&nbsp;</td><td>“查看”模板</td><td>“浏览”模板</td><td>“发布”模板</td><td>“管理”模板</td></tr><tr><td>流程</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看流程。</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_downloaddatasource_icon.png" alt="“下载数据源”图标。"><b>“下载流程”</b>使用户能够（以 TFLX 格式）下载流程。</td><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"><b>“运行”</b>使用户能够运行流程。</p><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够发布流程和覆盖已发布流程。</p></td><td rowspan="7"><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。"><b>“移动”</b>使用户能够项目之间移动资产。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#MoveContent" class="xref">移动内容</a>。</p><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_delete_icon.png" alt="“删除”图标。"><b>“删除”</b>使用户能够删除资产。</p><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"><b>“设置权限”</b>使用户能够为资产创建权限规则。</p><p>&nbsp;</p></td></tr><tr><td>数据角色</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看数据角色。</td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够发布数据角色、覆盖已发布数据角色，并编辑已发布数据角色的同义词。</td></tr><tr><td>指标（已停用）</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看指标。</td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够<span>覆盖指标并编辑指标的详细信息。 </span></td></tr><tr><td>“数据问答”(Ask Data) 功能镜头</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看镜头。</td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够编辑镜头。</td></tr><tr><td>虚拟连接</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看虚拟连接。 <p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_connect_icon.png" alt="“连接”图标。"><b>“连接”</b>使用户能够使用虚拟连接来连接到数据。</p></td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够编辑虚拟连接。</td></tr><tr><td>数据库</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看数据库。</td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够编辑数据库的元数据。</td></tr><tr><td>表</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看表。</td><td>不适用</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"><b>“覆盖”</b>使用户能够编辑表的元数据。</td></tr><tr><td>集合</td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"><b>“查看”</b>使用户能够查看集合。</td><td>不适用</td><td>不适用</td><td>不适用</td></tr></tbody></table>

\*默认情况下，虚拟连接有一个自定义模板，该模板将“查看”能力设置为“已允许”，但不设置“连接”能力。请务必将“连接”能力设置为“已允许”，以便用户可以使用虚拟连接进行连接。

<!-- document id=3b3b9daf6fcd5f1d9248e881330cd87bbc881e604a82bd12086e290c0d61a3b4 url=/tableau/next/zh-cn/online/datasource_mfr_build.md -->

[跳转到主要内容](#main-content)

# 构建多事实关系数据模型

分析通常涉及汇总彼此没有直接关系但都与相同的常见信息（例如日期或地点）相关的数据表。这种类型的分析有时被称为具有共享维度的多事实分析。

若要在 Tableau 中执行此类分析，请创建一个使用通过共享表连接的多个基表的数据源。

- _基表_是“数据源”选项卡上数据模型中最左侧的表。有关如何确定使用哪些表作为基表的指导，请参见[何时使用多事实关系模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_mfr_when_to_use.htm)。
- _共享表_是具有多个传入关系的下游表。这些表包含可在可视化项分析过程中将不相关的字段拼接在一起的字段。“Date”（日期）和“Location”（地点）是常用共享表的示例。

## 构建模型

构建多事实关系数据模型本质上与创建任何其他使用关系的数据源相同，但增加了两个部分：附加基表和共享表的多个传入关系。

1. [连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/basicconnectoverview.htm)。如果您的表不都在同一个数据库中，可以使用 [多个数据连接](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_plan.htm#tableau-data-sources)。
2. 将表拖到画布上以创建第一个基表。
3. 将另一个表从左侧窗格拖到“新基表”放置区域。
    
    ![具有现有基表和新基表放置区域的数据建模画布](/tableau/next/zh-cn/online/zh-cn/Img/mfr_new_base_table.png)
    
    Tableau 显示一条警告，提示您正在构建具有多个基表的数据模型。我们建议您仅在数据需要时才设置多基表模型。否则，使用单基表模型来避免多基表模型带来的复杂性。
    
    ![具有两个基表的数据模型，其中一个具有多个基表的警告](/tableau/next/zh-cn/online/zh-cn/Img/mfr_multi_base_table_warning.png)
4. 将另一个字段拖到画布上并将其与其中一个基表关联。[如果需要，配置每个关系](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-and-define-relationships)。
    
    ![添加到数据模型的下游表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_downstream.png)
5. 将鼠标悬停在尚未相关的基表上以显示加号（昵称“肉丸”）。
    
    ![“Clubs”（俱乐部）基表，上面有一个光标，并显示加号“肉丸”](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_meatball_base.png)
6. 将加号图标拖到共享表上，即可创建新的传入关系（也称为“面条”）。
    
    ![“肉丸”将新的“面条”拖到下游的现有表上](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_meatball.png)
7. _可选修：_继续添加下游表和基表。单击并拖动加号图标来根据需要构建共享表。

**注意**：您也可以先构建单个基表模型，然后再添加更多基表，而不是从基表开始。

## 探索模型

具有多个基表的数据模型是通过关系构建的，但并非所有表都具有相同程度的相关度。每个基表定义一个_树_，其中包含与该基表相关的每个表，无论是直接相关表还是相关表的下游表。共享表存在于多个树中。有关相关程度的详细信息，请参见[关于多事实关系数据模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_mfr_multiple_base_tables.htm)。

当您查看具有多个基表的模型时，有多种选项可用于探索和管理数据模型。当数据模型复杂时，这些选项特别有用。

![具有四个基表和多个共享表以及非共享下游表的数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_complex_model.png)

具有四个基表、多个共享表和下游表的复杂数据模型示例。下游表在基表之间既有共享的，也有不共享的。

2024.2 为数据模型引入了一些新的布局细节。在多事实关系数据模型中，关系捆绑在一起以帮助跟踪表具有多少个传入关系。与非共享表相比，共享表（以及下游共享表）具有更粗的轮廓。

### 术语

多基表数据模型中的表具有特定的角色。基表和共享表是多事实关系数据模型中必须存在的唯一表。（如果没有多个基表，它就不是多事实关系数据模型。如果没有连接基表的共享表，它就不是有效的数据模型。）

由于这些模型通常具有复杂的特性，建立一套共享的术语体系是非常有帮助的：

- _基表_位于最左边，没有传入关系。
    - 在示例中，“Inventory”（库存）、“Marketing”（营销）、“Sales”（销售）和“Support”（支持）是基表。
- _子基表_位于基表和共享表之间。
    - 在示例中，“Parts”（零件）是一个子基表。
- _共享表_具有多个传入关系。
    - 在示例中，“Products”（产品）、“Dates”（日期）、“Customer”（客户）和“Supplier”（供应商）是共享表。
- _下游共享表_恰好有一个传入关系，并且在它们上游某处有一个共享表。
    - 在示例中，“Subcategory”（子类）和“Category”（类别）是下游共享表。
- _下游非共享表_恰好有一个传入关系，并且其上游没有共享表。
    - 在示例中，没有下游非共享表。

![一个数据模型，列出了基表、子基表、下游非共享表、共享表和下游共享表等术语。](/tableau/next/zh-cn/online/zh-cn/Img/mfr_terminology.png)

测试您的理解：识别示例数据源中的表类型

![具有四个基表和多个共享表以及非共享下游表的数据模型](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_complex_model.png)

- **基表**：“Inventory”（库存）、“Marketing”（营销）、“Sales”（销售）和“Support”（支持）
- **子基表：**“Parts”（零件）
- **共享表：**“Products”（产品）、“Dates”（日期）、：“Customer”（客户）和“Supplier”（供应商）
- **下游共享表：**“Subcategory”（子类）和“Category”（类别）
- **下游非共享表：**无

### 识别关系树

将鼠标悬停在表上以突出显示与其相关的表。Tableau 强调该表的树并弱化不相关的表。

![复杂模型，其中一个基表的树突出显示，其他表则变暗](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_highlightedtree.png)

“Marketing”（营销）基表树由两个共享表（“Dates”（日期）和“Products”（产品））以及下游共享表（“Subcategory”（子类）和“Category”（类别））组成。

### 查看关系详细信息

将鼠标悬停在某个关系或一组关系上即可在工具提示中查看详细信息。

![一个三重“面条”包，带有一个工具提示，其中每行显示每一种关系的详细信息](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_noodle_bundle.png)

与“Products”（产品）表的传入关系包括与“Inventory”（库存）、“Marketing”（营销）和“Sales”（销售）基表的三种单独的关系。

### 选择关系

当选择一个关系时，它会在画布中以蓝色突出显示，并且其详细信息将显示在“表详细信息”窗格中。您可以在“表详细信息”窗格中[检查或修改关系子句](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-a-relationship)。

有多种选择关系的方式：

- 单击画布中的关系线（面条）。每个关系都有一个只选择那条“面条”的可点击区域。
- 右键单击或按住 Control 键单击画布中的表以打开其菜单。选择“选择关系”选项并选择您想要的表的关系。
- 单击画布中的关系包即可调出持久工具提示（将鼠标悬停在包上即可调出工具提示，单击使其持续显示）。然后在工具提示详细信息中选择一行来突出显示模型中的该关系。
- 打开“表详细信息”窗格工具栏中的菜单，并选择所需的关系。您还可以使用此菜单选择特定的表以在窗格中查看其预览。
    
    ![“表详细信息”窗格中的菜单](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_table_details_menu.png)

### 与基表交换

基表和共享表之间的关系中的中间表使您可以选择将下游表与基表交换。这纯粹是视觉上的变化，有助于概念理解，并不会改变数据模型的结构。

右键单击或按住 Control 键单击下游表，并选择“与基表交换（表名）”。交换选项也仅存在于下游表中，而不存在于基表中。

交换选项不适用于交换后会改变数据模型的表，例如共享表或下游共享表。只有下游非共享表或子基表才可以与基表交换。

#### _示例_

在此示例中，**“Parlor Info”（店铺信息）**和**“Ice Cream Sales”（冰淇淋销售）**可以交换表而不改变数据模型的基本结构。不可交换其他表。

- “Ice Cream Sales”（冰淇淋销售）表与“Parlor Info”（店铺信息）和“Date”（日期）共享表相关。
- “Parlor Info”（店铺信息）与“Ice Cream Sales”（冰淇淋销售）和“Location”（地点）共享表相关。
- “Weather”（天气）与“Date”（日期）和“Location”（地点）共享表相关。

这两个模型在概念上是等效的：

![两个版本的等效数据模型，其中基表与其非共享下游表交换](/tableau/next/zh-cn/online/zh-cn/Img/mfr_swapbase_icecream.png)

### 折叠基表

您还可以将关系路径或树折叠为其基表，以简化数据模型的视图。

在基表上单击“折叠”![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_collapse.png) 或“展开”![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_expand.png) 按钮可以折叠或展开其整个树。或者，右键单击或按住 Ctrl 键单击下游表并选择 “折叠此路径” 或“折叠其他路径”。此选项在共享表或共享表的下游表上不可用。

将树折叠到其基表纯粹是视觉上的，不会触发“不相关的表”通知。折叠路径由带有堆叠表和“展开”按钮的基表表示。折叠会影响仅与该树相关的所有表和关系，因此与未折叠路径共享的表不会被隐藏。

使用“展开”![](/tableau/next/zh-cn/online/zh-cn/Img/mfr_icon_expand.png) 按钮重新打开基表和树中的所有内容。

![支持基表的树被折叠和展开](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_collapsetree_gif.gif)

## 疑难解答

### 创建单一数据源

所有表都必须以某种方式与整个数据源相关。如果有任何表未与整体数据模型相关，则会出现通知。通知将一直持续，直到没有表或树与数据模型的其余部分完全分离为止。当通知处于活动状态时，无法发布数据源，并且您无法在分析中使用该数据源。

您可以打开通知并设置“视觉上分离不相关的表”来识别哪些表触发了通知。当您有一个复杂的模型并且需要确定哪个表或哪些表尚未与数据模型的其余部分相关时，此选项很有用。

#### _示例_

在[构建模型](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_mfr_build.htm#Build)下的步骤中，在添加关系以连接第二个基表之前，步骤 4 中会出现一条通知。

![不相关的表通知消息](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_unrelated_alert.png)

将“视觉上分离不相关的表”设置为“启用”会将表**“Clubs”（俱乐部）**移至“不相关的表”线下方。将**“Clubs”（俱乐部）**与**“Students”（学生）**相关可解决通知。

![一个数据模型，在标有“不相关的表”的红色虚线下有一个不相关的表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_visuallyseparate.png)

#### 解决循环

即使某些表彼此之间不直接相关，整个数据模型也必须是一个内聚的整体。在这个例子中，每个基表定义了一个树，但没有连接它们的共享表。这不是一个有效的分析模型。

![具有两个基表的数据模型，其不同的树不重叠](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_unrelated1.png)

两组相关表需要通过共享表合并...

![相同的数据模型，现在与共享表连接](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_unrelated2.png)

...或者需要将数据模型创建为两个独立的数据源。

![相同的数据模型，分为两个数据源](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_unrelated3.png)

### 数据模型限制

多基表模型中不支持表之间的某些关系路径。如果您在尝试在表上创建第二个传入关系时无法放下“肉丸”，请确保您尝试创建的结构在 Tableau 中受支持。不受支持的模型示例包括：

#### 循环

不支持循环（从上游表到同一个下游表存在多条关系路径）。这种不支持的结构有时被称为领结结构。若要在 Tableau 中对表之间的这种关系进行建模，请通过将下游表转换为另一个基表来使用多个基表而不是领结。

![一个领结图和另一个将下游表更改为附加基表的图](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_bowtie_tableauified.png)

数据模型必须是_有向无环图_。这意味着表的每个传入关系都必须可追溯到上游的不同基表。

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 34%;"><col style="width: 33%;"><col></colgroup><tbody><tr><td><b>不支持</b>。表 X 具有两个传入关系，它们均来自基表 A 的下游表</td><td><b>支持</b>。表 S 和 T 都具有多个传入关系，但每个关系都来自不同的基表。</td><td><b>支持</b>。尽管从视觉上看起来像是一个循环，但表 S 和表 T 的传入关系可以追溯到不同的基表。</td></tr><tr><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_build_cycle1.png" alt="由于循环而不支持的数据模型"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_build_cycle2.png" alt="支持的数据模型，其中领结转换为第二个基表"></td><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/mfr_build_cycle3.png" alt="支持的数据模型，具有可追溯到不同基表的共享表的传入关系"></td></tr></tbody></table>

#### 嵌套共享表

不支持嵌套共享表。共享表（具有多个传入关系的表）下游的任何表只能有一个传入关系。

![不支持的模型，带有嵌套共享表](/tableau/next/zh-cn/online/zh-cn/Img/mfr_build_nestedshared.png)

不支持。表 T 位于共享表的下游，无法接收其他传入关系。

<!-- document id=7b137f01ecfecf223ad46ebd0fd95bb828ddcf3326eb1b915fbb27d12d2fe5d1 url=/tableau/next/zh-cn/online/adminview.md -->

[跳转到主要内容](#main-content)

# 查找管理视图

“站点状态”页面包含一个带各种管理视图的嵌入式 Tableau 工作簿。这些视图帮助您监控不同类型的站点活动。

- 允许访问“在线管理见解”项目，可以使用该项目来构建有关您的站点的自定义管理视图。
- 向您显示 Tableau Cloud 的一般站点活动。
- 向您显示一般 Tableau Bridge 活动。

## 导航到管理视图

若要查看“在线管理见解”项目或管理视图，请单击“站点状态”。站点管理员可以看到适用于其站点的管理视图。

<!-- document id=2e45d3570d63c74598f1932900b8c79b20a4a61d4babb7fb483174d95ca24f76 url=/tableau/next/zh-cn/online/users_view.md -->

[跳转到主要内容](#main-content)

# 查看、管理或移除用户

站点管理员可以管理站点的用户，例如添加和移除用户、设置用户所属的组、设置用户的站点角色，诸如此类。

查看和管理站点上的用户

以站点管理员身份登录到站点，然后选择“用户”。在此页面上，您可以执行以下任何操作来管理用户：

- 设置组成员身份、设置站点角色或从站点中移除用户。如果已将站点配置为使用单点登录 (SSO)，您可以设置所选用户的身份验证方法。
    
    ![操作菜单中突出显示了“站点角色”的“站点用户”列表。](/tableau/next/zh-cn/online/zh-cn/Img/user_site_view_settings_cloud.png)
- 选择一个用户的名称以查看其相关详细信息，例如用户拥有的内容、用户订阅的视图，以及用户的帐户设置。
    
    只有当用户是您作为站点管理员的站点的成员时，您才可以使用用户的“设置”页面。在“帐户”下，您可以更新用户接收通知的电子邮件地址。电子邮件地址仅用于通知目的，不用于登录。出于安全考虑，您只能更新仅属于一个站点的用户的电子邮件地址。

搜索用户（或组）

若要搜索特定用户（或组），请使用右上方的筛选器开关显示搜索框和站点角色筛选器。然后使用搜索框或筛选器查找所需的用户（或组）。搜索操作会检查显示名称和用户名属性。

搜索框支持通配符 (\*)。例如，搜索 `John*` 将会返回所有以 _John_ 开头的名称。

此外，您可以执行以下操作：

- 将通配符 (\*) 与特殊字符结合使用来搜索包含特殊字符的名称。例如，`sync-*` 或 `*sync-*`。
- 筛选用户名时将通配符 (\*) 与 AND 或 OR 条件结合使用。例如，搜索 `*aw* AND John*` 将返回用户名包含 _aw_ 和名称以 _John_ 开头的所有用户。
    - 请注意，带有 AND 或 OR 的通配符仅在筛选用户名（而不是显示名称）时可用。
- 搜索带有变音符号的名称时，必须输入带有准确变音符号的名称才能返回相关结果。例如，若要搜索 _José_，请输入 `José`。搜索 `Jose` 不会返回结果。

![用于按站点角色进行筛选的搜索栏和下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/user_view_search.png)

从站点中移除用户

只有在用户未拥有任何内容（例如，项目、工作簿、视图、数据源、集合或数据通知）的情况下，数据源，，您才能移除该用户。如果尝试移除拥有内容的用户，则会将用户站点角色设置为**“未许可”**，但不会移除用户。

如果默认的“所有用户”组启用了“登录时授予站点角色”，则必须将该用户的内容重新分配给其他用户或删除，然后才能取消许可或移除。有关“登录时授予角色”的详细信息，请参见[移除受“登录时授予角色”影响的用户](https://help.tableau.com/v0.0/online/zh-cn/grant_role.htm#remove)。有关更改内容所有权的详细信息，请参见[管理内容所有权](https://help.tableau.com/v0.0/online/zh-cn/owner.htm)。[管理内容所有权](https://help.tableau.com/v0.0/online/zh-cn/owner.htm)

**注意：**在 Tableau Server 上，当管理员从站点中移除用户（并且用户只属于该站点）时，还会从服务器中删除该用户。

1. 以管理员身份登录到站点，并转到“用户”页面。选择要移除的一个或多个用户，然后选择“动作”\>“从站点移除”。
    
    ![带有操作菜单的“站点用户”列表。](/tableau/next/zh-cn/online/zh-cn/Img/user_site_remove_server.png)
2. 在确认对话框中单击**“移除用户”**按钮。

<!-- document id=54486952d442340fda80d45a647b2f7f2b2f0aaad6fb3f0921de084732defec7 url=/tableau/next/zh-cn/online/activity_log_overview.md -->

[跳转到主要内容](#main-content)

# 活动日志

> [!TIP]
> 
> **重要信息：**从 2026 年 3 月 16 日开始，Tableau Cloud 中的活动日志功能已迁移到 Hyperforce。迁移根据 Tableau Cloud pod 和地区分阶段进行。若要维护服务，您必须在计划的迁移日期之前和之后更改您的身份和访问管理 (IAM) 角色权限。有关详细信息，请参见 Salesforce 帮助中的[由于 Hyperforce 迁移而对 Tableau Cloud 活动日志造成的更改](https://help.salesforce.com/s/articleView?id=005232922&type=1)。

Tableau Cloud 以 JSON 文本文件的形式记录租户和站点活动的事件日志。您的许可版本确定访问日志的方式、日志的更新频率以及数据保留多长时间。有关详细信息，请参见[事件更新频率和数据保留](#update-frequency-and-data-retention)。

使用这些日志可以：

- **查看和分析事件数据：**访问 Tableau Cloud 的详细事件数据，捕获合规性信息并跟踪您的租户和站点上的活动。所有事件都包括时间戳和参与者的 Id，如果相关，还包括受影响内容的 ID。
- **审核权限变更：**跟踪和审核权限变更，例如在组中添加或移除用户、在项目之间移动内容以及明确更改内容权限。这对于实施强有力的合规控制至关重要。
- **补充“在线管理见解”**增强“在线管理见解”和“管理视图”提供的信息，以跟踪站点活动和使用情况指标。您可以将活动日志数据与监控工具（例如 Splunk 或 Amazon EventBridge）集成，以查询日志字段并回答问题，例如用户执行的最后 10 个操作、谁最后对内容执行了事件，以及对内容执行的最后操作是什么。活动日志数据还可以导入到云数据仓库进行分析，例如 Snowflake、Data Bridge、Google BigQuery。

如果您有 Tableau Enterprise 或 Tableau+ 许可证，您还可以通过 Tableau Cloud Manager REST API 访问实体快照。这些是一种单独的数据类型，可捕获站点内容、用户和关系在某个时间点的完整状态。实体快照无法通过活动日志 S3 集成获得。有关详细信息，请参见[使用实体快照](https://help.tableau.com/v0.0/online/zh-cn/activity_log_entity_snapshots.htm)。

## 访问活动日志事件

在进入活动日志之前，了解 Tableau Cloud 中的不同事件类型以及如何访问它们非常重要。

### 租户事件

租户事件记录 Tableau Cloud Manager (TCM) 内发生的更改。这些事件包括分配用户站点角色、更改站点角色容量限制以及监控站点的许可证消耗等活动。具有云管理员角色的用户可以使用 TCM REST API 中的平台数据方法获取租户事件。有关详细信息，请参见 TCM REST API 参考中的[平台数据](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/platform_data.html)。

有关租户事件的完整列表，请参见[活动日志租户事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_tenant_schema.htm)。

### 站点事件

站点事件记录 Tableau 站点内发生的变化。这些事件包括登录成功和失败、权限更改以及用户与内容的交互等活动。

您可以通过两种方式获取站点事件。

- **TCM REST API：**使用平台数据方法。您必须是云管理员才能使用此 API。有关详细信息，请参见 TCM REST API 参考中的[平台数据](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/platform_data.html)。
- **Amazon S3：**配置活动日志将日志数据发送到 Amazon Simple Storage Service (S3) 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

有关站点事件的完整列表，请参见[活动日志站点事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm)。

## 事件更新频率和数据保留

根据许可版本，日志更新频率和数据保留的值有所不同。

<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">Tableau（默认）</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">Advanced Management、Tableau Enterprise 和 Tableau+</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</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">Tableau Cloud Manager REST API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>Tableau Cloud Manager REST API</p><p>客户管理的 Amazon S3 存储桶</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td style="background-color: #d3d3d3;" class="TableStyle-Basic-Border-BodyD-Column1-Body1">&nbsp;</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">1 天*</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">少于 15 分钟</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #d3d3d3;">&nbsp;</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>365 天</p><ul><li><p>2025 年 12 月 2 日开始为 TCM REST API 平台数据方法保留数据。如果从 Tableau 许可版本升级到 Enterprise 或 Tableau+ 许可证，您将最多可以访问 365 天的历史数据。</p></li><li><p>Amazon S3 的数据保留取决于您的存储桶的 S3 生命周期配置。有关详细信息，请参见 AWS 帮助中的<a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-set-lifecycle-configuration-intro.html" target="_blank">在存储桶上设置 S3 生命周期配置</a>。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"></tr><tr class="TableStyle-Basic-Border-Body-Body1"></tr></tbody></table>

**\*注意：**日志每天进行批处理，通常会在前一天活动的午夜过后几个小时到达。可用时间基于站点 pod 的本地时区。例如，对于托管在 prod-useast-a 上的站点，日志将根据东部时间变为可用。

## 此部分中的其他文章

<!-- document id=232b8c72ea5ed7f3db9efa1aa944dbe4a5d26d1a89c7836cbf617d98c26105f4 url=/tableau/next/zh-cn/online/activity_log_tenant_schema.md -->

[跳转到主要内容](#main-content)

# 活动日志租户事件类型参考

本主题描述了活动日志租户事件类型和属性。有关站点事件的信息，请参见[活动日志站点事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm)。

## 事件类型详细信息

以下内容描述了活动日志中的租户事件类型和属性。使用右侧按字母顺序排列的事件类型列表，或使用 **ctrl/cmd-f** 直接转到您想到的关键字。

**注意：**事件的时间戳以 ISO 8601 UTC 格式记录。

## 通用属性

下表包含所有活动日志租户事件的通用属性。对于特定于事件的属性，请查看本主题中的各个事件表。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>eventId</td><td>字符串</td><td>事件的唯一标识符</td></tr><tr><td>eventOutcome</td><td>字符串</td><td>表示操作的最终结果。可能的值包括：<ul><li><b>success：</b>尝试的操作已成功完成。</li><li><b>unauthorized：</b>发起用户无权执行该操作。</li><li><b>client_error：</b>由于客户端/调用方的原因，操作失败。例如，API 请求参数无效、客户端连接超时或限制。</li><li><b>internal_error：</b>由于意外的内部错误，操作失败。</li></ul></td></tr><tr><td>eventOutcomeReason</td><td>字符串</td><td>提供有关事件结果的更多详细信息</td></tr><tr><td>eventProcessedTime</td><td>字符串</td><td>事件在活动日志中可用时的时间戳。若要查看事件发生时间的时间戳，请使用 <code>eventTime</code> 属性。</td></tr><tr><td>eventTime</td><td>字符串</td><td>事件发生时间的时间戳</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型</td></tr><tr><td>eventVersion</td><td>字符串</td><td>事件的架构版本</td></tr><tr><td>initiatingSessionId</td><td>字符串</td><td>发起操作的用户会话的 ID</td></tr><tr><td>initiatingUrl</td><td>字符串</td><td>与发起操作的请求关联的 URL，例如调用的 REST API 端点的 URL。</td></tr><tr><td>initiatingUserAgent</td><td>字符串</td><td>与发起操作的请求关联的用户代理 HTTP 标头</td></tr><tr><td>initiatingUserDisplayName</td><td>字符串</td><td>发起操作的用户的显示名称</td></tr><tr><td>initiatingUserEmail</td><td>字符串</td><td>发起操作的用户的电子邮件地址</td></tr><tr><td>initiatingUserId</td><td>字符串</td><td>发起操作的用户的 ID</td></tr><tr><td>initiatingUserIpAddress</td><td>字符串</td><td>发起操作的请求的远程客户端 IP 地址。有效的 IPv4 或 IPv6 地址。</td></tr><tr><td>initiatingUserRole</td><td>字符串</td><td>允许发起用户执行操作的角色或权限级别</td></tr><tr><td>podUri</td><td>字符串</td><td>发生操作的 pod 的统一资源标识符 (URI)</td></tr><tr><td>siteId</td><td>字符串</td><td>发生操作的站点的 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>发生操作的站点名称</td></tr><tr><td>siteUri</td><td>字符串</td><td>发生操作的站点的统一资源标识符 (URI)</td></tr><tr><td>tenantId</td><td>字符串</td><td>发生操作的租户的 ID</td></tr><tr><td>tenantName</td><td>字符串</td><td>发生操作的租户名称</td></tr><tr><td>tenantUri</td><td>字符串</td><td>发生操作的租户的统一资源标识符 (URI)</td></tr><tr><td>traceUuid</td><td>字符串</td><td>在批次中所有事件中都相同的自动生成的 UUID，例如单个用户操作更改的多个权限。</td></tr></tbody></table>

## batch\_revoke\_personal\_access\_token

当租户被暂停或删除，或者用户被移除时，会发生 `batch_revoke_personal_access_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>patUserId</td><td>字符串</td><td>被撤销 PAT 的用户的 ID。如果整个租户的 PAT 被撤销，则不包括在内。</td></tr></tbody></table>

## batch\_revoke\_session

当与租户或用户关联的所有会话都被撤销时，会发生 `batch_revoke_sessions` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>sessionUserId</td><td>字符串</td><td>会话被撤销的用户的 ID。如果整个租户的会话被撤销，则不包括在内。</td></tr></tbody></table>

## create\_or\_update\_oidc\_config

当 OIDC 配置更改时，会发生 `create_or_update_oidc_config` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>isSecretUpdated</td><td>布尔值</td><td>指示密文是否已更新。不会记录实际的密文值。此属性可帮助管理员跟踪组织中的变化，例如影响系统功能的变化或确保正确执行计划的密文轮换的变化。</td></tr><tr><td>newSettingsValue</td><td>字符串</td><td>新的 OIDC 配置设置</td></tr><tr><td>oldSettingsValue</td><td>字符串</td><td>以前的 OIDC 配置设置</td></tr><tr><td>resourceId</td><td>字符串</td><td>OIDC 配置的资源 ID</td></tr></tbody></table>

## create\_or\_update\_saml\_config

当 SAML 配置更改时，会发生 `create_or_update_saml_config` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newSettingsValue</td><td>字符串</td><td>新的 SAML 配置设置</td></tr><tr><td>oldSettingsValue</td><td>字符串</td><td>以前的 SAML 配置设置</td></tr><tr><td>resourceId</td><td>字符串</td><td>SAML 配置的资源 ID</td></tr></tbody></table>

## create\_or\_update\_uat\_configuration

对统一访问令牌 (UAT) JSON Web 令牌 (JWT) 配置进行更改时，将发生 `create_or_update_uat_configuration` 事件。此事件用于跟踪安全合规性和故障排除的更改。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>configId</td><td>字符串</td><td>UAT JWT 配置的唯一标识符 (UUID)</td></tr><tr><td>isSecretUpdated</td><td>布尔值</td><td>指示密文是否已更新。不会记录实际的密文值。此属性可帮助管理员跟踪公钥或 jwks_uri 值的更改。</td></tr><tr><td>issuer</td><td>字符串</td><td>JWT 颁发者声明值。用于标识受配置更改影响的 IdP。</td></tr><tr><td>newSettingsValue</td><td>字符串</td><td>新的 UAT JWT 配置设置。这些值经过 JSON 序列化，并且不包括敏感键，例如 publicKey 和 publicKeyActive。</td></tr><tr><td>oldSettingsValue</td><td>字符串</td><td>以前的 UAT JWT 配置设置。这些值经过 JSON 序列化，并且不包括敏感键，例如 publicKey 和 publicKeyActive。</td></tr></tbody></table>

## create\_personal\_access\_token

生成个人访问令牌 (PAT) 时，会发生 `create_personal_access_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>expiresAt</td><td>字符串</td><td>PAT 到期时的时间戳。如果创建尝试失败，则不包括在内。</td></tr><tr><td>tokenId</td><td>字符串</td><td>创建的 PAT 的 ID。如果创建尝试失败，则不包括在内。</td></tr><tr><td>tokenName</td><td>字符串</td><td>PAT 的名称</td></tr></tbody></table>

## create\_private\_connection

创建专用连接时，会发生 `create_private_connection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>专用连接的描述</td></tr><tr><td>endpointServiceName</td><td>字符串</td><td>专用连接的 AWS 端点服务名称</td></tr><tr><td>名称</td><td>字符串</td><td>专用连接的名称</td></tr><tr><td>privateConnectionId</td><td>字符串</td><td>创建的专用连接的 ID</td></tr><tr><td>region</td><td>字符串</td><td>创建专用连接的 AWS 区域</td></tr></tbody></table>

## create\_site

在租户中创建站点时，会发生 `create_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## create\_tenant

创建租户时，会发生 `create_tenant` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## create\_user

在租户中创建新用户时，会发生 `create_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>添加到租户的用户的电子邮件</td></tr><tr><td>language</td><td>字符串</td><td>添加到租户的用户的语言代码</td></tr><tr><td>locale</td><td>字符串</td><td>添加到租户的用户的区域设置代码</td></tr><tr><td>userId</td><td>字符串</td><td>添加到租户的用户的唯一标识符</td></tr><tr><td>userName</td><td>字符串</td><td>添加到租户的用户的用户名</td></tr></tbody></table>

## create\_uat\_revocation

将 JSON Web 令牌 (JWT) 添加到阻止列表时，将发生 `create_uat_revocation` 事件。此事件用于跟踪安全合规性和访问控制的更改。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>revokedJwtRecords</td><td>字符串</td><td>已添加到阻止列表的 JWT 记录的 JSON 数组。每条记录包含“jti”(JWT ID) 和“exp”（以 Unix 纪元秒为单位的到期时间戳）。</td></tr></tbody></table>

## delete\_oidc\_config

当删除 OIDC 配置时，会发生 `delete_oidc_config` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>idpConfigurationId</td><td>字符串</td><td>IdP 配置的 ID</td></tr><tr><td>idpConfigurationName</td><td>字符串</td><td>IdP 配置的名称</td></tr><tr><td>resourceId</td><td>字符串</td><td>OIDC 配置的资源 ID</td></tr></tbody></table>

## delete\_private\_connection

在租户中删除私有连接时，会发生 `delete_private_connection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>privateConnectionId</td><td>字符串</td><td>删除的私有连接的 ID</td></tr></tbody></table>

## delete\_saml\_config

当删除 SAML 配置时，会发生 `delete_saml_config` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>idpConfigurationId</td><td>字符串</td><td>IdP 配置的 ID</td></tr><tr><td>idpConfigurationName</td><td>字符串</td><td>IdP 配置的名称</td></tr><tr><td>resourceId</td><td>字符串</td><td>SAML 配置的资源 ID</td></tr></tbody></table>

## delete\_site

从租户中删除站点时，会发生 `delete_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## delete\_tenant

删除租户时，会发生 `delete_tenant` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## delete\_user

从租户中删除用户时，会发生 `delete_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>移除的用户的电子邮件</td></tr><tr><td>userId</td><td>字符串</td><td>移除的用户的 ID</td></tr><tr><td>userName</td><td>字符串</td><td>移除的用户的用户名</td></tr></tbody></table>

## delete\_uat\_configuration

为身份提供程序 (IdP) 移除 JSON Web 令牌 (JWT) 配置时，将发生 `delete_uat_configuration` 事件。此事件用于跟踪安全合规性和访问监视的更改。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>configId</td><td>字符串</td><td>已删除 UAT JWT 配置的唯一标识符 (UUID)</td></tr><tr><td>issuer</td><td>字符串</td><td>已删除配置的 JWT 颁发者声明值。用于标识受影响的 IdP。</td></tr></tbody></table>

## delete\_uat\_revocation

从阻止列表中删除 JSON Web 令牌 (JWT) 时，将发生 `delete_uat_revocation` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>jti</td><td>字符串</td><td>从阻止列表中删除的 JWT ID</td></tr></tbody></table>

## get\_sites

当请求租户下的站点列表时，会发生 `get_sites` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## get\_users

当请求租户或站点内的用户列表时，会发生 `get_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## jwt\_login

使用 JSON Web 令牌 (JWT) 登录 Tableau Cloud Manager (TCM) 时，会发生 `jwt_login` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>jti</td><td>字符串</td><td>JWT ID 声明。用于在登录 TCM 时跟踪令牌。</td></tr><tr><td>jwtType</td><td>字符串</td><td>用于登录请求的 JWT 类型</td></tr><tr><td>newSessionId</td><td>字符串</td><td>登录请求创建的会话的 ID。对于失败的登录尝试，不包括此属性。</td></tr></tbody></table>

## list\_personal\_access\_tokens

当请求 Tableau Cloud Manager (TCM) 中所有有效的个人访问令牌 (PAT) 时，会发生 `list_personal_access_tokens` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## merge\_tenant

当 Tableau Cloud Manager 租户合并到另一个租户时，会发生 `merge_tenant` 事件。通过这种合并，云管理员可以管理一个租户下的所有站点并从统一治理中受益。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>sourceTenantId</td><td>字符串</td><td>合并操作中源租户的 ID</td></tr><tr><td>sourceTenantName</td><td>字符串</td><td>合并操作中的源租户名称</td></tr><tr><td>sourceTenantUri</td><td>字符串</td><td>合并操作中源租户的统一资源标识符 (URI)</td></tr></tbody></table>

## migrate\_site

将站点迁移到租户时，会发生 `migrate_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## personal\_access\_token\_login

使用个人访问令牌 (PAT) 登录 Tableau Cloud Manager 时，会发生 `personal_access_token_login` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newSessionId</td><td>字符串</td><td>此登录请求创建的会话的 ID。如果登录失败，则不包括在内。</td></tr><tr><td>tokenId</td><td>字符串</td><td>用于登录的 PAT 的 ID</td></tr><tr><td>tokenName</td><td>字符串</td><td>PAT 的名称</td></tr></tbody></table>

## reactivate\_site

重新激活租户中的站点时，会发生 `reactivate_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## revoke\_personal\_access\_token

在 Tableau Cloud Manager 中撤销个人访问令牌 (PAT) 时，会发生 `revoke_personal_access_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>tokenId</td><td>字符串</td><td>已撤销 PAT 的 ID</td></tr><tr><td>tokenName</td><td>字符串</td><td>PAT 的名称</td></tr></tbody></table>

## revoke\_session

当用户因会话撤销而注销时（例如用户明确注销或会话过期），会发生 `revoke_session` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td colspan="3">此事件仅使用通用属性。有关详细信息，请参见本主题中的<a href="#common-attributes">通用属性</a>。</td></tr></tbody></table>

## site\_capacity\_change

当特定站点的容量分配更改时，会发生 `site_capacity_change` 事件。每个事件适用于一种容量类型。更改多个容量会为每个容量生成一个单独的事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>capacityName</td><td>字符串</td><td>已更改的容量类型的规范名称</td></tr><tr><td>newCapacityAmount</td><td>整数</td><td>分配给站点的新容量</td></tr><tr><td>oldCapacityAmount</td><td>整数</td><td>以前分配给站点的容量</td></tr></tbody></table>

## site\_capacity\_default\_change

在租户级别更改默认站点容量分配时，会发生 `site_capacity_default_change` 事件。默认值适用于添加到租户的新站点，并且不会更改现有站点。由于更改设置租户默认值而不是修改特定站点，因此 `siteId`、`siteName` 和 `siteUri` 属性为 null。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>capacityName</td><td>字符串</td><td>已更改的容量类型的规范名称</td></tr><tr><td>newCapacityAmount</td><td>整数</td><td>新的默认容量</td></tr><tr><td>oldCapacityAmount</td><td>整数</td><td>之前的默认容量</td></tr></tbody></table>

## site\_limits\_change

当站点角色（Creator、Explorer 或 Viewer（查看者））的站点级许可证容量限制发生变化时，会发生 `site_limits_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newCreatorCapacity</td><td>整数</td><td>Creator 站点角色限制的新值。如果新限制是默认云限制，则不包括在内。</td></tr><tr><td>newCreatorCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>新的 Creator 限制已设置为默认云限制</td></tr><tr><td>newExplorerCapacity</td><td>整数</td><td>Explorer 站点角色限制的新值。如果新限制是默认云限制，则不包括在内。</td></tr><tr><td>newExplorerCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>新的 Explorer 限制已设置为默认云限制</td></tr><tr><td>newViewerCapacity</td><td>整数</td><td>Viewer（查看者） 站点角色限制的新值。如果新限制是默认云限制，则不包括在内。</td></tr><tr><td>newViewerCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>新的 Viewer（查看者）限制已设置为默认云限制</td></tr><tr><td>oldCreatorCapacity</td><td>整数</td><td>Creator 站点角色限制的先前值。如果以前的限制是默认云限制，则不包括在内。</td></tr><tr><td>oldCreatorCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>之前的 Creator 限制已设置为默认云限制</td></tr><tr><td>oldExplorerCapacity</td><td>整数</td><td>Explorer 站点角色限制的先前值。如果以前的限制是默认云限制，则不包括在内。</td></tr><tr><td>oldExplorerCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>之前的 Explorer 限制已设置为默认云限制</td></tr><tr><td>oldViewerCapacity</td><td>整数</td><td>Viewer（查看者）站点角色限制的先前值。如果以前的限制是默认云限制，则不包括在内。</td></tr><tr><td>oldViewerCapacityIsDefaultCloudLimit</td><td>布尔值</td><td>之前的Viewer（查看者）限制已设置为默认云限制</td></tr></tbody></table>

## suspend\_site

当租户中的站点被暂停时，会发生 `suspend_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>suspensionSource</td><td>字符串</td><td>站点暂停的来源</td></tr></tbody></table>

## tcm\_activity\_log\_access

访问 Tableau Cloud Manager (TCM) 活动日志数据时，会发生 `tcm_activity_log_access` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>eventProcessedTimeEnd</td><td>字符串</td><td>访问数据的结束时间（基于事件的处理时间戳）。如果未包括，则假定已访问所有可用数据。</td></tr><tr><td>eventProcessedTimeStart</td><td>字符串</td><td>访问数据的开始时间（基于事件的处理时间戳）。如果未包括，则假定已访问所有可用数据。</td></tr><tr><td>eventTypeAccessed</td><td>字符串</td><td>访问的事件类型。如果未包括，则假定已访问所有可用数据。</td></tr></tbody></table>

## track\_private\_connection\_usage

`track_private_connection_usage` 事件监视租户中的专用连接使用情况，每小时记录一次数据。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>endpointId</td><td>字符串</td><td>专用连接的虚拟私有云 (VPC) 端点 ID</td></tr><tr><td>endpointServiceName</td><td>字符串</td><td>专用连接的 AWS 端点服务名称</td></tr><tr><td>endpointServiceRegion</td><td>字符串</td><td>专用连接的 AWS 端点服务区域</td></tr><tr><td>usageQuantity</td><td>长整数</td><td>通过专用连接传输的数据量（以字节为单位）。此值反映了日志条目前一小时的使用情况。</td></tr></tbody></table>

## update\_personal\_access\_token

更新个人访问令牌 (PAT) 时，会发生 `update_personal_access_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>expiresAt</td><td>字符串</td><td>PAT 到期时的时间戳</td></tr><tr><td>tokenId</td><td>字符串</td><td>创建的 PAT 的 ID。如果创建尝试失败，则不包括在内。</td></tr><tr><td>tokenName</td><td>字符串</td><td>PAT 的名称</td></tr></tbody></table>

## update\_private\_connection

更新私有连接时，会发生 `update_private_connection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newDescription</td><td>字符串</td><td>专用连接的新描述</td></tr><tr><td>newSiteIds</td><td>字符串</td><td>新专用连接站点 ID 的逗号分隔列表。</td></tr><tr><td>oldDescription</td><td>字符串</td><td>专用连接的先前描述</td></tr><tr><td>oldSiteIds</td><td>字符串</td><td>以前的专用连接站点 ID 的逗号分隔列表。</td></tr><tr><td>privateConnectionId</td><td>字符串</td><td>更新的私有连接的 ID</td></tr></tbody></table>

## update\_session

当会话的到期时间更新时，会发生 `update_session` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>expiresAt</td><td>字符串</td><td>会话的新过期时间</td></tr></tbody></table>

## update\_tenant

当租户名称或状态更新时，会发生 `update_tenant` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newStatus</td><td>字符串</td><td>更新后的租户状态</td></tr><tr><td>newTenantName</td><td>字符串</td><td>更新后的租户名称</td></tr><tr><td>newTenantOrg62Id</td><td>字符串</td><td>更新后的租户 Org62 ID</td></tr><tr><td>newTenantUri</td><td>字符串</td><td>更新后的租户统一资源标识符 (URI)</td></tr><tr><td>oldStatus</td><td>字符串</td><td>更新前的租户状态</td></tr><tr><td>oldTenantOrg62Id</td><td>字符串</td><td>更新前的租户 Org62 ID</td></tr></tbody></table>

## update\_user

当租户中的现有用户更新时，会发生 `update_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>newEmail</td><td>字符串</td><td>用户的新电子邮件</td></tr><tr><td>newLanguage</td><td>字符串</td><td>用户的新语言代码</td></tr><tr><td>newLocale</td><td>字符串</td><td>用户的新区域设置代码</td></tr><tr><td>oldEmail</td><td>字符串</td><td>用户之前的电子邮件</td></tr><tr><td>oldLanguage</td><td>字符串</td><td>用户之前的语言代码</td></tr><tr><td>oldLocale</td><td>字符串</td><td>用户之前的区域设置代码</td></tr><tr><td>userId</td><td>字符串</td><td>添加的用户的唯一 ID</td></tr><tr><td>userName</td><td>字符串</td><td>添加到租户的用户的用户名</td></tr></tbody></table>

## update\_user\_site\_role

当用户对站点的访问权限通过添加、更改或删除其站点角色进行更新时，会发生 `update_user_site_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>添加到租户的用户的电子邮件</td></tr><tr><td>newIdp</td><td>字符串</td><td>分配给站点用户的新身份验证方法，如果从站点中移除用户，则为 null。</td></tr><tr><td>newRole</td><td>字符串</td><td>用户在站点上的新角色，如果从站点上移除用户，则为 null。</td></tr><tr><td>oldIdp</td><td>字符串</td><td>先前分配给站点用户的身份验证方法，如果用户之前在站点上没有角色，则为 null。</td></tr><tr><td>oldRole</td><td>字符串</td><td>用户之前在站点上的角色，如果用户之前在站点上没有角色，则为 null。</td></tr><tr><td>userId</td><td>字符串</td><td>用户的唯一 标识符</td></tr><tr><td>userName</td><td>字符串</td><td>添加到站点的用户的用户名</td></tr></tbody></table>

## update\_user\_tenant\_role

通过添加、更改或移除云管理员角色来更新用户对租户的访问权限时，会发生 `update_user_tenant_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>添加到租户的用户的电子邮件</td></tr><tr><td>newIdp</td><td>字符串</td><td>分配给租户用户的新身份验证方法，如果从租户中移除用户，则为 null。</td></tr><tr><td>newRole</td><td>字符串</td><td>用户在租户上的新角色，如果从租户中移除用户，则为 null。</td></tr><tr><td>oldIdp</td><td>字符串</td><td>先前分配给租户用户的身份验证方法，如果用户之前在租户中没有角色，则为 null。</td></tr><tr><td>oldRole</td><td>字符串</td><td>用户之前在租户上的角色，如果用户之前在租户上没有角色，则为 null。</td></tr><tr><td>userId</td><td>字符串</td><td>用户的唯一 标识符</td></tr><tr><td>userName</td><td>字符串</td><td>添加到租户的用户的用户名</td></tr></tbody></table>

## user\_login\_create\_session

当用户通过登录页面或其他交互式登录方式登录 Tableau Cloud Manager (TCM) 时，会发生 `user_login_create_session` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>expiresAt</td><td>字符串</td><td>会话到期时的时间戳。如果创建尝试失败，则不包括在内。</td></tr><tr><td>idpId</td><td>字符串</td><td>IdP 的 ID，指示如何对用户进行身份验证。</td></tr><tr><td>idpName</td><td>字符串</td><td>IdP 的名称，指示如何对用户进行身份验证。</td></tr><tr><td>newSessionId</td><td>字符串</td><td>会话密钥的新 ID。如果创建尝试失败，则不包括在内。</td></tr></tbody></table>

## validate\_uat\_jwt

验证 JSON Web 令牌 (JWT) 时，会发生 `validate_uat_jwt` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>configId</td><td>字符串</td><td>用于验证的 JWT 配置 ID</td></tr><tr><td>jti</td><td>字符串</td><td>JWT ID 声明。用于在登录时跟踪令牌。</td></tr><tr><td>jwtIssuer</td><td>字符串</td><td>JWT 颁发者 (iss) 声明</td></tr><tr><td>resourceId</td><td>字符串</td><td>传递到验证端点的资源的 ID。tenantId 或 siteId。</td></tr><tr><td>scope</td><td>字符串</td><td>用于授权的 JWT 范围声明</td></tr><tr><td>tokenExpirationTime</td><td>字符串</td><td>JWT 过期时间 (exp) 声明值</td></tr><tr><td>username</td><td>字符串</td><td>JWT 中包括的用户名</td></tr></tbody></table>

<!-- document id=e123150cf672abc3b353316d4d397c75a5be5b5ecc49a6af4e2c9c78f5032618 url=/tableau/next/zh-cn/online/activity_log_schema.md -->

[跳转到主要内容](#main-content)

# 活动日志站点事件类型参考

本主题描述了活动日志站点事件类型和属性。有关租户事件的信息，请参见[活动日志租户事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_tenant_schema.htm)。

## 事件类型详细信息

以下内容描述了活动日志中的站点事件类型和属性。使用右侧按字母顺序排列的事件类型列表，或使用 **ctrl/cmd-f** 直接转到您想到的关键字。

**注意：**事件的时间戳以 ISO 8601 UTC 格式记录。

## 通用属性

下表包含所有活动日志站点事件的通用属性。对于特定于事件的属性，请查看本主题中的各个事件表。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorUserId</td><td>整数</td><td>执行启动事件的操作的用户的 ID</td></tr><tr><td>actorUserLuid</td><td>字符串</td><td>执行启动事件的操作的用户的 LUID</td></tr><tr><td>eventOutcome</td><td>字符串</td><td>表示操作的最终结果。可能的值包括：<ul><li><b>success：</b>尝试的操作已成功完成。</li><li><b>unauthorized：</b>发起用户无权执行该操作。</li><li><b>client_error：</b>由于客户端/调用方的原因，操作失败。例如，API 请求参数无效、客户端连接超时或限制。</li><li><b>internal_error：</b>由于意外的内部错误，操作失败。</li></ul><p class="note"><b>注意：</b>目前，并非所有活动日志事件都使用 eventOutcome 属性。对于不受支持的事件（例如登录或访问事件），该值将为 null。若要审核登录请求的成功或失败，请使用 <a href="#login-authentication">login_authentication</a> 事件和 <code>status</code> 属性。</p></td></tr><tr><td>eventOutcomeReason</td><td>字符串</td><td>提供有关事件结果的更多详细信息</td></tr><tr><td>eventProcessedTime</td><td>字符串</td><td>事件在活动日志中可用时的时间戳。此属性适用于 2026 年 1 月和 2 月的 Hyperforce 迁移后写入的事件。若要查看事件发生时间的时间戳，请使用 <code>eventTime</code> 属性。</td></tr><tr><td>eventTime</td><td>字符串</td><td>事件发生时间的时间戳</td></tr><tr><td>initiatingUserId</td><td>整数</td><td>发起用户的 ID。此值通常与 <code>actorUserId</code> 相同，仅在委派身份验证（例如受信票证或模拟）时有所不同。在模拟期间，它是发起会话的管理用户的 ID。当会话没有发起用户或不存在会话时，<code>initiatingUserId</code> 使用 <code>actorUserId</code> 的值。</td></tr><tr><td>initiatingUserLuid</td><td>字符串</td><td>发起用户的 LUID。对于模拟，它是发起模拟的管理用户的 LUID。对于标准登录，该值与 <code>actorUserLuid</code> 相同。</td></tr><tr><td>licensingRoleName</td><td>字符串</td><td>事件发生时用户的许可角色的名称</td></tr><tr><td>siteLuid</td><td>字符串</td><td>发生事件的 Tableau 站点的 LUID</td></tr><tr><td>siteRoleId</td><td>整数</td><td>用户的站点角色 ID。值 0 = SiteAdministratorExplorer、1 = SupportUser、2 = ExplorerCanPublish、3 = Explorer、7 = Guest、8 = Unlicensed、9 = Viewer、10 = Creator 以及 11 = SiteAdministratorCreator。</td></tr><tr><td>systemAdminLevel</td><td>整数</td><td>指明用户是否为系统管理员。如果值为 10，则是系统管理员，如果值为 0，则不是系统管理员。</td></tr></tbody></table>

## add\_delete\_group\_to\_group\_set

在组集中添加或删除组时，会记录 `add_delete_group_to_group_set` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupId</td><td>整数</td><td>组的 ID</td></tr><tr><td>groupLuid</td><td>字符串</td><td>组的 LUID</td></tr><tr><td>groupSetId</td><td>整数</td><td>组集的 ID</td></tr><tr><td>groupSetLuid</td><td>字符串</td><td>组集的 LUID</td></tr><tr><td>groupSetOperation</td><td>字符串</td><td>组集操作，即在组集中添加或删除用户</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## add\_delete\_user\_to\_group

从组中添加或移除用户时，会记录 `add_delete_user_to_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupId</td><td>整数</td><td>组的 ID</td></tr><tr><td>groupLuid</td><td>字符串</td><td>组的 LUID</td></tr><tr><td>groupOperation</td><td>字符串</td><td>组操作，即在组中添加或删除用户</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>userId</td><td>整数</td><td>用户的 ID</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的 LUID</td></tr></tbody></table>

## activity\_log\_settings\_change

当管理员更改活动日志设置时，会发生 `activity_log_settings_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>errorCode</td><td>字符串</td><td>更改活动日志设置时生成的错误代码</td></tr><tr><td>newAwsAccountNumber</td><td>字符串</td><td>将接收活动日志事件的新 AWS 帐号</td></tr><tr><td>newKmsKeyArn</td><td>字符串</td><td>Amazon S3 存储桶的新 AWS Key Management Service (KMS) 单一区域密钥。</td></tr><tr><td>newS3BucketName</td><td>字符串</td><td>将接收活动日志事件的新 AWS S3 存储桶</td></tr><tr><td>oldAwsAccountNumber</td><td>字符串</td><td>先前接收活动日志事件的 AWS 账号</td></tr><tr><td>oldKmsKeyArn</td><td>字符串</td><td>Amazon S3 存储桶之前的 AWS Key Management Service (KMS) 单一区域密钥。</td></tr><tr><td>oldS3BucketName</td><td>字符串</td><td>之前接收活动日志事件的 AWS S3 存储桶</td></tr><tr><td>operationType</td><td>字符串</td><td>操作类型，即创建、更新或删除。</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2024.3.0。</td></tr></tbody></table>

## archive\_content

用回收站从站点中永久删除内容时，会发生 `archive_content` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentId</td><td>整数</td><td>存档内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>存档内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>存档内容的名称</td></tr><tr><td>contentType</td><td>字符串</td><td>存档内容的类型</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## background\_job

`background_job` 事件记录有关作为后台任务运行的作业的信息。对于每个作业，都会创建一个事件来记录其各种状态，包括启动时间、排队、开始时间以及成功或失败。

**注意：**此事件类型的部分数据只能通过 API 获得。若要查看完整的事件日志，请配置活动日志以将日志数据发送到 Amazon S3 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>args</td><td>字符串</td><td>作业的参数</td></tr><tr><td>duration</td><td>长整数</td><td>作业持续时间</td></tr><tr><td>eventInitiatedTime</td><td>字符串</td><td>作业开始时间</td></tr><tr><td>eventState</td><td>字符串</td><td><p>作业的状态</p></td></tr><tr><td>isRunNow</td><td>布尔值</td><td><p>指示作业是通过单击站点上的“立即运行”选项或使用 REST API 手动启动的，还是由计划触发的。</p><p><b>注意：</b>从 2024 年 4 月开始，由计划触发的作业 (<code>False</code>) 包括表中列出的所有属性的数据。手动启动 (<code>True</code>) 的作业的属性正在积极开发中，并暂定包含在未来的版本中。</p></td></tr><tr><td>jobId</td><td>整数</td><td>作业的 ID</td></tr><tr><td>jobLuid</td><td>字符串</td><td>作业的 LUID</td></tr><tr><td>jobType</td><td>字符串</td><td><p>识别与事件相关的后台作业类型</p><p><b>注意：</b>从 2024 年 4 月开始，只有<code> IncrementExtracts</code>、<code>RefreshExtracts</code> 和 <code>RefreshExtractsViaBridge</code> 作业包括表中列出的所有属性的数据。其他作业类型的属性正在积极开发中，并暂定纳入未来的版本中。</p></td></tr><tr><td>notes</td><td>字符串</td><td>作业的备注</td></tr><tr><td>objLuid</td><td>字符串</td><td>某些任务是特定工作簿或数据源所特有的。在这种情况下，object_luid 是工作簿或数据源表（由 obj_type 指示）中的相关项的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>关联对象的名称。与 obj_luid（如前所述）结合使用。</td></tr><tr><td>objOwnerLuid</td><td>字符串</td><td>对拥有作业目标对象的用户的外键引用</td></tr><tr><td>objOwnerName</td><td>字符串</td><td>拥有作业目标对象的用户的名称</td></tr><tr><td>objRepositoryUrl</td><td>字符串</td><td><p>唯一标识工作簿或数据源，并在 URL 中引用对象时使用。该值派生自工作簿或数据源名称中的 ASCII 字符。</p></td></tr><tr><td>objRevision</td><td>字符串</td><td>版本号。从 1.0 开始，并在每次重新发布时按 0.1 递增。</td></tr><tr><td>objSize</td><td>整数</td><td>用于存储作业目标对象信息的字节数</td></tr><tr><td>objType</td><td>字符串</td><td>工作簿或数据源。与 obj_luid 结合使用。</td></tr><tr><td>podName</td><td>字符串</td><td>处理该作业的 Tableau pod 的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>对作业目标对象所在项目的外键引用。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含作业目标对象的项目的名称</td></tr><tr><td>projectOwnerEmail</td><td>字符串</td><td>用户的电子邮件地址，该用户拥有包含作业目标对象的项目</td></tr><tr><td>projectOwnerLuid</td><td>字符串</td><td>对用户的外键引用，该用户拥有包含作业目标对象的项目</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>任务的计划 LUID；如果作业是手动启动的，则可能为 null</td></tr><tr><td>scheduleName</td><td>字符串</td><td>任务的计划名称；如果作业是手动启动的，则可能为 null</td></tr><tr><td>siteId</td><td>整数</td><td>站点的 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>taskId</td><td>整数</td><td>任务的 ID；如果作业是手动启动的，则可能为 null。</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 LUID；如果作业是手动启动的，则可能为 null。</td></tr><tr><td>timeZone</td><td>整数</td><td>作业的时区</td></tr></tbody></table>

## bridge\_client\_register

注册 Tableau Bridge 事件时，会发生 `bridge_client_register` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>agentName</td><td>字符串</td><td>与事件关联的 Bridge 客户端的名称。</td></tr><tr><td>deviceId</td><td>字符串</td><td>Bridge 客户端生成的设备 ID</td></tr><tr><td>poolId</td><td>字符串</td><td>分配给 Bridge 客户端的池的 ID</td></tr><tr><td>siteId</td><td>字符串</td><td>Bridge 客户端注册到的站点的 ID</td></tr><tr><td>timeZoneId</td><td>字符串</td><td>Bridge 客户端注册的时区</td></tr><tr><td>userName</td><td>字符串</td><td>注册 Bridge 客户端的用户的名称</td></tr></tbody></table>

## bridge\_client\_status

`bridge_client_status` 事件记录 Tableau Bridge 客户端的连接状态和元数据。使用此事件来监视站点上 Bridge 客户端的运行状况、版本和池分配。

以下情况下会发生此事件：

- 客户端断开连接。每 30 秒进行一次状态检查。如果客户端没有响应，系统将记录断开连接。
- 客户端重新连接。
- 客户端将保持连接 24 小时。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>bridgeClientComputerName</td><td>字符串</td><td>安装了 Bridge 客户端的计算机的名称</td></tr><tr><td>bridgeClientConnectionStatus</td><td>字符串</td><td>Bridge 客户端的连接状态。<code>Connected</code> 或 <code>Disconnected</code>。</td></tr><tr><td>bridgeClientDeviceLuid</td><td>字符串</td><td>Bridge 客户端计算机的 LUID</td></tr><tr><td>bridgeClientLastConnectedTime</td><td>字符串</td><td>上次成功连接 Bridge 客户端的日期和时间</td></tr><tr><td>bridgeClientOperationSystem</td><td>字符串</td><td>Bridge 客户端计算机上运行的操作系统。<code>Windows</code> 或 <code>Linux</code>。</td></tr><tr><td>bridgeClientOwnerLuid</td><td>字符串</td><td>注册 Bridge 客户端的用户的 LUID</td></tr><tr><td>bridgeClientOwnerName</td><td>字符串</td><td>注册 Bridge 客户端的用户的名称</td></tr><tr><td>bridgeClientVersion</td><td>字符串</td><td>Tableau Bridge 客户端软件的版本</td></tr><tr><td>poolLuid</td><td>字符串</td><td>连接状态更改时为 Bridge 客户端分配的池的 LUID</td></tr><tr><td>siteId</td><td>字符串</td><td>注册 Bridge 客户端的站点的 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>注册 Bridge 客户端的站点的名称</td></tr></tbody></table>

## bridge\_job

`bridge_job` 事件跟踪 Tableau Bridge 客户端执行的作业。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>bridgeClientComputerName</td><td>字符串</td><td>Bridge 客户端计算机的名称</td></tr><tr><td>bridgeClientDeviceLuid</td><td>字符串</td><td>Bridge 客户端主机的设备 LUID</td></tr><tr><td>bridgeClientOwnerLuid</td><td>字符串</td><td>创建 Bridge 客户端的用户的 LUID</td></tr><tr><td>bridgeClientOwnerName</td><td>字符串</td><td>创建 Bridge 客户端的用户的名称</td></tr><tr><td>bridgeClientVersion</td><td>字符串</td><td>计算机上安装的 Bridge 客户端的版本</td></tr><tr><td>duration</td><td>长整数</td><td>作业运行所需的时间（以毫秒单位）。</td></tr><tr><td>eventState</td><td>字符串</td><td>作业的状态</td></tr><tr><td>jobId</td><td>整数</td><td>作业的 ID</td></tr><tr><td>jobLuid</td><td>字符串</td><td>作业的 LUID</td></tr><tr><td>jobType</td><td>字符串</td><td>作业的类型</td></tr><tr><td>notes</td><td>字符串</td><td>关于作业的备注</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键，如 <code>objType</code> 字段所示。</td></tr><tr><td>objName</td><td>字符串</td><td>关联对象（工作簿或数据源）的名称。与 <code>objLuid</code> 结合使用以唯一标识对象。</td></tr><tr><td>objRepositoryUrl</td><td>字符串</td><td>关联对象（工作簿或数据源）的唯一名称，派生自名称中的 ASCII 字符，可在 URL 中使用以引用该对象。</td></tr><tr><td>objRevision</td><td>字符串</td><td>版本号。从 1.0 开始，并在每次重新发布时按 0.1 递增。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 <code>objLuid</code> 结合使用以唯一标识对象。</td></tr><tr><td>poolId</td><td>字符串</td><td>Bridge 客户端分配到的池的 ID</td></tr><tr><td>poolName</td><td>字符串</td><td>Bridge 客户端分配到的池的名称</td></tr><tr><td>siteId</td><td>字符串</td><td>Bridge 客户端注册到的站点的 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>与 Bridge 客户端关联的站点的名称</td></tr></tbody></table>

## content\_owner\_change

当内容所有者更改时记录 `content_owner_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentId</td><td>整数</td><td>已更改所有者的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>已更改所有者的内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更改所有者的内容的名称</td></tr><tr><td>contentType</td><td>字符串</td><td>内容的类型，例如数据源、工作簿或视图</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>newOwnerId</td><td>整数</td><td>新内容所有者的 ID</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新内容所有者的 LUID</td></tr><tr><td>oldOwnerId</td><td>整数</td><td>旧内容所有者的 ID</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>旧内容所有者的 LUID</td></tr></tbody></table>

## create\_delete\_group

创建或删除组时记录 `create_delete_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupDomain</td><td>字符串</td><td>组的域，例如 local</td></tr><tr><td>groupId</td><td>整数</td><td>组的 ID</td></tr><tr><td>groupLuid</td><td>字符串</td><td>组的 LUID</td></tr><tr><td>groupName</td><td>字符串</td><td>权限已更改的组的名称</td></tr><tr><td>groupOperation</td><td>字符串</td><td>组操作，即创建或删除</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## create\_delete\_group\_set

创建或删除组集时会记录 `create_delete_group_set` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupSetId</td><td>整数</td><td>组集的 ID</td></tr><tr><td>groupSetLuid</td><td>字符串</td><td>组集的 LUID</td></tr><tr><td>groupSetName</td><td>字符串</td><td>创建或删除的组集的名称</td></tr><tr><td>groupSetOperation</td><td>字符串</td><td>组集操作，即创建或删除</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## create\_permissions

创建新的显式权限规则时记录 `create_permissions` 事件。

**注意：**2024 年 10 月已弃用。改用 [set\_permissions](#set-permissions) 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td>已更改其权限的内容类型，例如项目或工作簿</td></tr><tr><td>capabilityId</td><td>整数</td><td>能力的 ID。能力是指对内容执行操作（例如查看、筛选、下载或删除）的能力</td></tr><tr><td>capabilityValue</td><td>字符串</td><td>能力的描述</td></tr><tr><td>contentId</td><td>整数</td><td>已更新权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容项的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更新权限的内容的名称</td></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>granteeValue</td><td>字符串</td><td>更新的权限值，例如“用户允许”或“组允许”</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## delete\_all\_permissions

删除内容的所有显式权限规则时（通常在删除内容时）记录 `delete_all_permissions` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td>已更改其权限的内容类型，例如项目或工作簿</td></tr><tr><td>contentId</td><td>整数</td><td>已更新权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更新权限的内容的名称</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## delete\_permissions

通过 REST API 从内容项中移除显式权限规则时记录 `delete_permissions` 事件。有关详细信息，请参见 Tableau REST API 帮助中的[权限方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_permissions.htm)。

移除权限的其他方式会记录为不同的事件：

- 在“权限”对话框中移除功能会在日志中记录为 `set_permissions` 事件，其 `permissionType` 为 `unspecified`，因为被授权人的整个权限集都会被替换。
- 删除内容在日志中记录为 `delete_all_permissions`。
- 删除用户或组在日志中记录为 `delete_permissions_grantee`。

若要捕获所有权限移除，请监视 `set_permissions`、`delete_all_permissions` 和 `delete_permissions_grantee`。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td>已更改其权限的内容类型，例如项目或工作簿</td></tr><tr><td>capabilityId</td><td>整数</td><td>能力的 ID。能力是指对内容执行操作（例如查看、筛选、下载或删除）的能力</td></tr><tr><td>capabilityValue</td><td>字符串</td><td>能力的描述</td></tr><tr><td>contentId</td><td>整数</td><td>已更新权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更新权限的内容的名称</td></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。如果被授权人最近被删除或 LUID 查找服务不可用，则此值可以为 null。<code>granteeId</code> 属性始终存在。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>granteeValue</td><td>字符串</td><td>更新的权限值，例如“用户允许”或“组允许”</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## delete\_permissions\_grantee

删除用户或组的所有显式权限规则时（通常在删除用户或组时），会在日志中记录 `delete_permissions_grantee` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。如果被授权人最近被删除或 LUID 查找服务不可用，则此值可以为 null。<code>granteeId</code> 属性始终存在。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## display\_sheet\_tabs

在工作簿上更新“选项卡式视图”值时记录 `display_sheet_tabs` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>workbookId</td><td>整数</td><td>工作簿的 ID</td></tr></tbody></table>

## hist\_access\_authoring\_view

用户制作视图时会记录 `hist_access_authoring_view` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_access\_datasource

用户访问数据源时记录 `hist_access_datasource` 事件。

**注意：**此事件类型的部分数据只能通过 API 获得。若要查看完整的事件日志，请配置活动日志以将日志数据发送到 Amazon S3 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_access\_datasource\_remotely

用户从 Tableau Bridge 中访问数据源时记录 `hist_access_datasource_remotely` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_access\_metric

当用户在站点上与指标交互时会记录 `hist_access_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询数据的自定义视图的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含指标的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含指标的项目的名称。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询数据的视图的唯一 ID</td></tr></tbody></table>

## hist\_access\_summary\_data

当用户访问“摘要数据”窗口时，将记录 `hist_access_summary_data` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td><p>上次增量数据提取刷新发生的时间戳</p></td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td><p>包含工作簿的项目的唯一 ID。用作外键。</p></td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td><p>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</p></td></tr><tr><td>sheetName</td><td>字符串</td><td>访问数据的工作表的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_access\_underlying\_data

当用户访问“基础数据”窗口时，将记录 `hist_access_underlying_data` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明此工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td><p>上次增量数据提取刷新发生的时间戳</p></td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td><p>包含工作簿的项目的唯一 ID。用作外键。</p></td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td><p>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</p></td></tr><tr><td>sheetName</td><td>字符串</td><td>访问数据的工作表的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_access\_view

用户访问视图时会记录 `hist_access_view` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorExternalId</td><td>字符串</td><td>代理用户的外部 ID。这是一个不透明的标识符，取决于参与者类型，但举例来说，也可以是用户电子邮件。还可以显示通过按需访问方式访问内容的用户的标识符。</td></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_activate\_site

激活 Tableau 站点时会记录 `hist_activate_site event`。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_add\_user\_to\_group

将用户添加到组中时，会记录 `hist_add_user_to_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupLuid</td><td>字符串</td><td>组的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>组的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>添加到组的用户的 LUID</td></tr><tr><td>userName</td><td>字符串</td><td>添加到组的用户的名称</td></tr></tbody></table>

## hist\_append\_to\_datasource\_extract

将数据添加到数据提取时会记录 `hist_append_to_datasource_extract` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_bulk\_delete\_columns

从数据源中删除列时会记录 `hist_bulk_delete_columns` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>columnLuid</td><td>字符串</td><td>列的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>已发布列的描述</td></tr><tr><td>名称</td><td>字符串</td><td>已发布列的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>列所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>列所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td><p>包含列的项目的 LUID</p></td></tr><tr><td>projectName</td><td>字符串</td><td>包含列的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_change\_collection\_ownership

当集合所有者更改时会记录 `hist_change_collection_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>collectionLuid</td><td>字符串</td><td>集合的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>集合的描述</td></tr><tr><td>名称</td><td>字符串</td><td>集合的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新集合所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新集合所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个集合所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个集合所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>集合所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>集合所有者的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_change\_data\_role\_ownership

当数据角色所有权更改时会记录 `hist_change_data_role_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>数据角色的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新数据角色所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新数据角色所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个数据角色所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个数据角色所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_change\_database\_contact

更改数据库联系人时会记录 `hist_change_database_contact` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>databaseLuid</td><td>字符串</td><td>数据库的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>数据库的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据库数</td></tr><tr><td>newContactLuid</td><td>字符串</td><td>新联系人的 LUID</td></tr><tr><td>newContactName</td><td>字符串</td><td>新联系人的姓名</td></tr><tr><td>oldContactLuid</td><td>字符串</td><td>之前联系人的 LUID</td></tr><tr><td>oldContactName</td><td>字符串</td><td>之前联系人的姓名</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据库所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据库所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据库的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据库的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_change\_datasource\_ownership

更改数据源所有者时会记录 `hist_change_datasource_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新数据源所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新数据源所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个数据源所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个数据源所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_change\_flow\_ownership

更改流程所有者时会记录 `hist_change_flow_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新流程所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新流程所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个流程所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个流程所有者的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_change\_metric\_ownership

更改指标所有者时会记录 `hist_change_metric_ownership` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询数据的自定义视图的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新指标所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新指标所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个指标所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个指标所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含指标的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含指标的项目的名称。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询数据的视图的唯一 ID</td></tr></tbody></table>

## hist\_change\_project\_ownership

当项目所有权更改时会记录 `hist_change_project_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>项目的描述</td></tr><tr><td>名称</td><td>字符串</td><td>项目的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新项目所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新项目所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个项目所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个项目所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>项目所有者的 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>项目所有者的名称</td></tr><tr><td>parentProjectLuid</td><td>字符串</td><td>父项目的 LUID。对于顶层项目，该值为 Null。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。默认值为 active。任何其他值都表示该项目处于非活动状态。</td></tr></tbody></table>

## hist\_change\_published\_connection\_ownership

当已发布连接所有权更改时会记录 `hist_change_published_connection_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>activated</td><td>布尔值</td><td>指示已发布的连接是否可供使用</td></tr><tr><td>description</td><td>字符串</td><td>已发布连接的描述</td></tr><tr><td>名称</td><td>字符串</td><td>已发布连接的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新已发布连接所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新已发布连接所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个已发布连接所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个已发布连接所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>已发布连接所有者的 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>已发布连接所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含已发布连接的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含已发布连接的项目的名称</td></tr><tr><td>publishedConnectionLuid</td><td>字符串</td><td>已发布连接的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_change\_site\_extract\_encryption\_mode

historical\_events 中的旧版更改站点数据提取加密模式事件

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_change\_table\_contact

当表联系人更改时会记录 `hist_change_table_contact` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>表的描述</td></tr><tr><td>名称</td><td>字符串</td><td>表的名称</td></tr><tr><td>newContactLuid</td><td>字符串</td><td>新联系人的 LUID</td></tr><tr><td>newContactName</td><td>字符串</td><td>新联系人的姓名</td></tr><tr><td>oldContactLuid</td><td>字符串</td><td>之前联系人的 LUID</td></tr><tr><td>oldContactName</td><td>字符串</td><td>之前联系人的姓名</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>表所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>表所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含表的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含表的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>tableLuid</td><td>字符串</td><td>表的唯一ID</td></tr></tbody></table>

## hist\_change\_workbook\_ownership

当工作簿所有权更改时会记录 `hist_change_workbook_ownership` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明此工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td><p>上次增量数据提取刷新发生的时间戳</p></td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>newOwnerLuid</td><td>字符串</td><td>新项目所有者的 LUID</td></tr><tr><td>newOwnerName</td><td>字符串</td><td>新项目所有者的名称</td></tr><tr><td>oldOwnerLuid</td><td>字符串</td><td>前一个项目所有者的 LUID</td></tr><tr><td>oldOwnerName</td><td>字符串</td><td>前一个项目所有者的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>工作簿所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td><p>包含工作簿的项目的唯一 ID。用作外键。</p></td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td><p>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</p></td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_create\_collection

用户创建集合时会记录 `hist_create_collection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>collectionLuid</td><td>字符串</td><td>集合的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>集合的描述</td></tr><tr><td>名称</td><td>字符串</td><td>集合的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>集合所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>集合所有者的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_create\_column

用户访问列时会记录 `hist_create_column` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>columnLuid</td><td>字符串</td><td>列的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>列的描述</td></tr><tr><td>名称</td><td>字符串</td><td>列的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>列所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>列所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含列的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含列的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_create\_data\_quality\_indicator

用户创建数据质量警告时会记录 `hist_create_data_quality_indicator` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataQualityIndicatorLuid</td><td>字符串</td><td>数据质量指标的唯一 ID</td></tr><tr><td>dataQualityType</td><td>字符串</td><td>数据质量指标的类型：警告、已弃用、过时数据、维护中、敏感数据或自定义值。</td></tr><tr><td>isActive</td><td>布尔值</td><td>指示数据质量指标是否处于活动状态</td></tr><tr><td>isSevere</td><td>布尔值</td><td>指示数据质量指标是否严重</td></tr><tr><td>message</td><td>字符串</td><td>数据质量指标的消息</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userDisplayName</td><td>字符串</td><td>创建或修改了数据质量指标的用户的显示名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>创建或修改了数据质量指标的用户的 LUID</td></tr></tbody></table>

## hist\_create\_database

用户创建数据库时会记录 `hist_create_database` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>databaseLuid</td><td>字符串</td><td>数据库的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>数据库的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据库数</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据库所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据库所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据库的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据库的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_create\_datasource\_extracts

创建新的数据源数据提取时会记录 `hist_create_datasource_extracts` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>包含有关数据源的详细信息的消息</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_create\_datasource\_task

创建新的数据源任务时会记录 `hist_create_datasource_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果任务处于非活动状态，则触发计划时它不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td><p>对象的唯一 ID。用作工作簿或数据源表中的主键。</p></td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>任务标题。提供有关任务的附加信息。</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_create\_datasource\_trigger

`hist_create_datasource_trigger` 事件指定导致创建数据源的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_create\_flow\_task

创建新的流程任务时会记录 `hist_create_flow_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果任务处于非活动状态，则触发计划时它不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td><p>对象的唯一 ID。用作工作簿或数据源表中的主键。</p></td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>任务标题。提供有关任务的附加信息。</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_create\_flow\_trigger

`hist_create_flow_trigger` 事件指定导致创建流程的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_create\_group

创建组时会记录 `hist_create_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupLuid</td><td>字符串</td><td>组的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>组的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_create\_linked\_task

创建顺序运行的链接任务时会记录 `hist_create_linked_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td><p>对象的唯一 ID。用作工作簿或数据源表中的主键。</p></td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>任务标题。提供有关任务的附加信息。</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_create\_materialized\_views

`hist_create_materialized_views` 事件记录在工作簿上成功创建实体化视图的情况。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为什么创建或删除实体化视图）。</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型。创建、删除、加密、解密或重新加密实体化视图。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_create\_metric

当用户在站点上创建指标时会记录 `hist_create_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联项目的唯一 ID。</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr></tbody></table>

## hist\_create\_project

当用户在站点上创建项目时会记录 `hist_create_project` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>项目的描述</td></tr><tr><td>名称</td><td>字符串</td><td>项目的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>项目所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>项目所有者的名称</td></tr><tr><td>parentProjectLuid</td><td>字符串</td><td>父项目的 LUID。对于顶层项目，该值为 Null。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的唯一标识符</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。默认值为 active。任何其他值都表示该项目处于非活动状态。</td></tr></tbody></table>

## hist\_create\_schedule

当用户在站点上创建计划时会记录 `hist_create_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_create\_site

Historical\_events 中的旧版创建站点

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_create\_subscription\_task

创建新的订阅任务时会记录 `hist_create_subscription_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_create\_system\_user

添加系统用户时会记录 `hist_create_system_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_create\_table

在站点上创建数据库表时会记录 `hist_create_table` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>表的描述</td></tr><tr><td>名称</td><td>字符串</td><td>表的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>表所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>表所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含表的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含表的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>tableLuid</td><td>字符串</td><td>表的唯一ID</td></tr></tbody></table>

## hist\_create\_user

将用户添加到站点时会记录 `hist_create_user event`。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_create\_workbook\_extracts

对包含数据提取的工作簿进行更改时会记录 `hist_create_workbook_extracts` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_create\_workbook\_task

为工作簿相关任务记录 `hist_create_workbook_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_decrypt\_datasource\_extracts

旧版解密数据源从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_decrypt\_datasource\_extracts\_request

旧版解密数据源从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的唯一 ID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_decrypt\_flow\_draft\_extracts

旧版解密流程草案从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_decrypt\_flow\_draft\_extracts\_request

旧版解密流程草案从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_decrypt\_flow\_extracts

旧版解密流程从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本，每次发布时加 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_decrypt\_flow\_extracts\_request

旧版解密流程从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本，每次发布时加 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_decrypt\_materialized\_views

hist\_decrypt\_materialized\_views 事件记录工作簿上实体化视图的成功解密。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为什么创建或删除实体化视图）。</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型。创建、删除、加密、解密或重新加密实体化视图。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_decrypt\_site\_extracts\_request

旧版解密站点从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_decrypt\_workbook\_extracts

旧版解密工作簿从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_decrypt\_workbook\_extracts\_request

旧版解密工作簿从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_delete\_access\_token

用户删除访问令牌时会记录 `hist_delete_access_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>siteName</td><td>字符串</td><td>删除访问令牌的 Tableau 站点的名称。</td></tr></tbody></table>

## hist\_delete\_collection

删除集合时会记录 `hist_delete_collection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>collectionLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>集合的描述</td></tr><tr><td>名称</td><td>字符串</td><td>集合的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有集合的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有集合的用户的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_column

删除数据库列时会记录 `hist_delete_column` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>columnLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>列的描述</td></tr><tr><td>名称</td><td>字符串</td><td>列的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有列的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有列的用户的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含列的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含列的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_data\_quality\_indicator

删除数据质量警告时会记录 `hist_delete_data_quality_indicator` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataQualityIndicatorLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>dataQualityType</td><td>字符串</td><td>数据质量指标的类型</td></tr><tr><td>isActive</td><td>布尔值</td><td>指示数据质量指标是否处于活动状态</td></tr><tr><td>isSevere</td><td>布尔值</td><td>指示数据质量指标是否严重</td></tr><tr><td>message</td><td>字符串</td><td>数据质量筛选器消息</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userDisplayName</td><td>字符串</td><td>创建或修改了数据质量指标的用户的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>创建或修改了数据质量指标的用户的唯一 ID</td></tr></tbody></table>

## hist\_delete\_data\_role

删除数据角色时会记录 `hist_delete_data_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_database

删除数据库时会记录 `hist_delete_database` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>databaseLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据库的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据库数</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据库所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据库所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据库的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据库的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_datasource

删除数据源时会记录 `hist_delete_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_delete\_datasource\_task

删除数据源相关任务时会记录 `hist_delete_datasource_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_delete\_datasource\_trigger

`hist_delete_datasource_trigger` 事件指定导致删除数据源的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_delete\_expired\_refresh\_token

当后台程序进程删除过期的刷新令牌时，会记录 `hist_delete_expired_refresh_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>deviceName</td><td>字符串</td><td>与刷新令牌关联的设备的名称</td></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>刷新令牌的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_flow

删除流程时会记录 `hist_delete_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_delete\_flow\_draft

删除流程草案时会记录 `hist_delete_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_delete\_flow\_task

删除流程相关任务时会记录 `hist_delete_flow_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_delete\_flow\_trigger

`hist_delete_flow_trigger` 事件指定导致删除流程的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_delete\_group

删除组时会记录 `hist_delete_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupLuid</td><td>字符串</td><td>组的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>组的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_linked\_task

删除链接并计划连续运行的任务时，会记录 `hist_delete_linked_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_delete\_materialized\_views

`hist_delete_materialized_views` 事件记录工作簿中实体化视图的成功删除

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为什么创建或删除实体化视图）。</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型。创建、删除、加密、解密或重新加密实体化视图。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_delete\_metric

删除指标时会记录 `hist_delete_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联项目的唯一 ID。</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr></tbody></table>

## hist\_delete\_project

删除项目时会记录 `hist_delete_project` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>项目的描述</td></tr><tr><td>名称</td><td>字符串</td><td>项目的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>项目所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>项目所有者的名称</td></tr><tr><td>parentProjectLuid</td><td>字符串</td><td>父项目的 LUID。对于顶层项目，该值为 Null。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的唯一标识符</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。默认值为 active。任何其他值都表示该项目处于非活动状态。</td></tr></tbody></table>

## hist\_delete\_refresh\_token\_session

删除刷新令牌创建的会话时，会记录 `hist_delete_refresh_token_session` 事件。

**注意：**此事件类型的部分数据只能通过 API 获得。若要查看完整的事件日志，请配置活动日志以将日志数据发送到 Amazon S3 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>deviceName</td><td>字符串</td><td>与刷新令牌关联的设备的名称</td></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>刷新令牌的唯一 ID</td></tr><tr><td>sessionId</td><td>字符串</td><td>会话的 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_delete\_schedule

删除计划时会记录 `hist_delete_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_delete\_site

删除站点时会记录 `hist_delete_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_delete\_system\_user

删除系统用户时会记录 `hist_delete_system_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 标识符</td></tr></tbody></table>

## hist\_delete\_table

删除表时会记录 `hist_delete_table` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>表的描述</td></tr><tr><td>名称</td><td>字符串</td><td>表的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>表所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>表所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含表的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含表的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>tableLuid</td><td>字符串</td><td>唯一标识符</td></tr></tbody></table>

## hist\_delete\_user

从站点中删除用户时会记录 `hist_delete_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_delete\_user\_from\_group

从组中移除用户时会记录 `hist_delete_user_from_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>groupLuid</td><td>字符串</td><td>组的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>组的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>从组中删除的用户的 LUID</td></tr><tr><td>userName</td><td>字符串</td><td>从组中删除的用户的名称</td></tr></tbody></table>

## hist\_delete\_view

从站点中删除视图时会记录 `hist_delete_view` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_delete\_workbook

删除工作簿时会记录 `hist_delete_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_delete\_workbook\_task

删除工作簿相关任务时会记录 `hist_delete_workbook_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_disable\_linked\_task\_schedule

当链接的任务计划关闭时，会记录 `hist_disable_linked_task_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_disable\_schedule

当计划关闭时，会记录 `hist_disable_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_download\_datasource

从站点下载数据源时会记录 `hist_download_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_download\_flow

从站点下载流程时会记录 `hist_download_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_download\_flow\_draft

从站点下载流程草案时会记录 `hist_download_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_download\_workbook

从站点中下载工作簿时会记录 `hist_download_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_enable\_linked\_task\_schedule

当链接计划任务打开时，会记录 `hist_enable_linked_task_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_enable\_schedule

当计划打开时，会记录 `hist_enable_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_encrypt\_datasource\_extracts

旧版加密数据源从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_encrypt\_datasource\_extracts\_request

旧版加密数据源从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_encrypt\_flow\_draft\_extracts

旧版加密流程草案从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_encrypt\_flow\_draft\_extracts\_request

旧版加密流程草案从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_encrypt\_flow\_extracts

旧版加密流程从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本，每次发布时加 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_encrypt\_flow\_extracts\_request

旧版加密流程从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本，每次发布时加 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_encrypt\_materialized\_views

`hist_encrypt_materialized_views` 事件记录工作簿上实体化视图的成功加密。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为什么创建或删除实体化视图）。</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型。创建、删除、加密、解密或重新加密实体化视图。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_encrypt\_site\_extracts\_request

旧版加密站点从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_encrypt\_workbook\_extracts

旧版加密工作簿从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_encrypt\_workbook\_extracts\_request

旧版加密工作簿从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_export\_summary\_data

从视图中导出摘要数据时会记录 `hist_export_summary_data` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetName</td><td>字符串</td><td>访问其数据的工作表的名称。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_export\_underlying\_data

从视图中导出基础数据时会记录 `hist_export_underlying_data` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetName</td><td>字符串</td><td>访问其数据的工作表的名称。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_hyper\_data\_update\_job

来自 Historical\_events 的旧版 Hyper 数据更新作业事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为何更新数据）。</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>操作是成功还是失败。</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_impersonate\_user

模拟用户 ID 时会记录 `hist_impersonate_user` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_increment\_datasource\_extract

以增量方式刷新数据提取时会记录 `hist_increment_datasource_extract` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_increment\_workbook\_extracts

以增量方式刷新工作簿中的数据提取时会记录 `hist_increment_workbook_extracts` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_issue\_refresh\_token

颁发刷新令牌或个人访问令牌 (PAT) 时会记录 `hist_issue_refresh_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>刷新令牌或 PAT 的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_lock\_site

锁定站点时会记录 `hist_lock_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_login

用户登录到站点时会记录 `hist_login` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorExternalId</td><td>字符串</td><td>代理用户的外部 ID。这是一个不透明的标识符，取决于参与者类型，但举例来说，也可以是用户电子邮件。还可以显示通过按需访问方式访问内容的用户的标识符。</td></tr><tr><td>groupNames</td><td>字符串</td><td>分配给在登录期间具有按需访问权限的用户的组名称列表</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_login\_with\_pat

当用户使用个人访问令牌 (PAT) 登录时会记录 `hist_login_with_pat` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>clientId</td><td>字符串</td><td>用于 PAT。客户端 ID 通常是 Tableau UI 中显示的 PAT 名称。</td></tr><tr><td>createdAt</td><td>字符串</td><td>首次创建 PAT 时的时间戳</td></tr><tr><td>expiresAt</td><td>字符串</td><td>PAT 到期时的时间戳</td></tr><tr><td>lastUsedAt</td><td>字符串</td><td>上次使用 PAT 时的时间戳</td></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>PAT 的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_logout

用户退出站点时会记录 `hist_logout event`。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_move\_data\_role

将数据角色移动到新项目时会记录 `hist_move_data_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr></tbody></table>

## hist\_move\_database

将数据库移动到新项目时会记录 `hist_move_database` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>databaseLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据库的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>名称</td><td>字符串</td><td>数据库数</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据库所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据库所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据库的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据库的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr></tbody></table>

## hist\_move\_datasource

将已发布数据源移动到新项目时会记录 `hist_move_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_move\_flow

将流程移动到新项目时会记录 `hist_move_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr></tbody></table>

## hist\_move\_flow\_draft

将流程草案移动到新项目时会记录 `hist_move_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_move\_metric

将指标移动到新项目时会记录 `hist_move_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联项目的唯一 ID。</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr></tbody></table>

## hist\_move\_project

移动项目时会记录 `hist_move_project` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>项目的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>名称</td><td>字符串</td><td>项目的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>项目所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>项目所有者的名称</td></tr><tr><td>parentProjectLuid</td><td>字符串</td><td>父项目的 LUID。对于顶层项目，该值为 Null。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的唯一标识符</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。默认值为 active。任何其他值都表示该项目处于非活动状态。</td></tr></tbody></table>

## hist\_move\_published\_connection

将已发布连接移动到新项目时会记录 `hist_move_published_connection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>activated</td><td>布尔值</td><td>此已发布的连接是否可供使用</td></tr><tr><td>description</td><td>字符串</td><td>已发布连接的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>名称</td><td>字符串</td><td>已发布连接的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有已发布连接的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有已发布连接的用户的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联的项目</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>publishedConnectionLuid</td><td>字符串</td><td>已发布连接的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr></tbody></table>

## hist\_move\_table

将表移动到新项目时会记录 `hist_move_table` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>表的描述</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>名称</td><td>字符串</td><td>表的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>表所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>表所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含表的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含表的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>tableLuid</td><td>字符串</td><td>唯一标识符</td></tr></tbody></table>

## hist\_move\_workbook

将工作簿移动到新项目时会记录 `hist_move_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>destinationProjectLuid</td><td>字符串</td><td>目标项目的唯一 ID。</td></tr><tr><td>destinationProjectName</td><td>字符串</td><td>目标项目的名称</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>sourceProjectLuid</td><td>字符串</td><td>源项目的唯一 ID。</td></tr><tr><td>sourceProjectName</td><td>字符串</td><td>源项目的名称</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_pause\_datasource\_extract\_refresh

暂停数据源数据提取刷新时会记录 `hist_pause_datasource_extract_refresh` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_pause\_workbook\_extract\_refresh

暂停工作簿数据提取刷新时会记录 `hist_pause_workbook_extract_refresh` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_publish\_data\_role

发布数据角色时会记录 `hist_publish_data_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_publish\_datasource

在站点上发布数据源时会记录 `hist_publish_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_publish\_flow

在站点上发布流程时会记录 `hist_publish_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_publish\_view

在站点上发布视图时会记录 `hist_publish_view` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_publish\_workbook

发布工作簿时会记录 `hist_publish_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_redeem\_refresh\_token

兑换刷新令牌或个人访问令牌 (PAT) 时会记录 `hist_redeem_refresh_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>刷新令牌或 PAT 的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_refresh\_datasource\_extract

刷新数据提取时会记录 `hist_refresh_datasource_extract` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_refresh\_workbook\_extracts

刷新工作簿中的数据提取时会记录 `hist_refresh_workbook_extracts` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_rekey\_datasource\_extracts

旧版密钥更新数据源从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_rekey\_flow\_draft\_extracts

旧版密钥更新流程草案从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_rekey\_flow\_extracts

旧版密钥更新流程从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本，每次发布时加 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_rekey\_materialized\_views

hist\_rekey\_materialized\_views 事件记录工作簿上实体化视图的成功重新加密。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>操作的详细信息（为什么创建或删除实体化视图）。</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>eventType</td><td>字符串</td><td>事件的类型。创建、删除、加密、解密或重新加密实体化视图。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_rekey\_site\_extracts\_request

旧版更改重新生成密钥站点从 historical\_events 中提取请求事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_rekey\_workbook\_extracts

旧版重新加密工作簿从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_rename\_collection

重命名集合时会记录 `hist_rename_collection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>collectionLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>集合的描述</td></tr><tr><td>formerName</td><td>字符串</td><td>集合以前的名称</td></tr><tr><td>名称</td><td>字符串</td><td>集合的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有集合的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有集合的用户的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_rename\_data\_role

重命名数据角色时会记录 `hist_rename_data_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>formerName</td><td>字符串</td><td>数据角色以前的名称</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_rename\_datasource

重命名数据源时会记录 `hist_rename_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>formerName</td><td>字符串</td><td>数据源以前的名称</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_rename\_flow

重命名流程时会记录 `hist_rename_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>formerName</td><td>字符串</td><td>流程以前的名称</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_rename\_flow\_draft

重命名流程草案时会记录 `hist_rename_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>formerName</td><td>字符串</td><td>流程草案以前的名称</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_rename\_group

重命名组时会记录 `hist_rename_group` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>formerName</td><td>字符串</td><td>组以前的名称</td></tr><tr><td>groupLuid</td><td>字符串</td><td>组的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>组的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_rename\_metric

重命名指标时会记录 `hist_rename_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>formerName</td><td>字符串</td><td>指标以前的名称</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联项目的唯一 ID。</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr></tbody></table>

## hist\_rename\_published\_connection

重命名已发布连接时会记录 `hist_rename_published_connection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>activated</td><td>布尔值</td><td>此已发布的连接是否可供使用</td></tr><tr><td>description</td><td>字符串</td><td>已发布连接的描述</td></tr><tr><td>formerName</td><td>字符串</td><td>已发布连接以前的名称</td></tr><tr><td>名称</td><td>字符串</td><td>已发布连接的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有已发布连接的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有已发布连接的用户的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联的项目</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>publishedConnectionLuid</td><td>字符串</td><td>已发布连接的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_rename\_workbook

重命名工作簿时会记录 `hist_rename_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>formerName</td><td>字符串</td><td>工作簿以前的名称</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_replace\_datasource\_extract

替换数据提取时会记录 `hist_replace_datasource_extract` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_revoke\_refresh\_token

撤销刷新令牌或个人访问令牌 (PAT) 时会记录 `hist_revoke_refresh_token` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>refreshTokenGuid</td><td>字符串</td><td>刷新令牌或 PAT 的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_run\_flow

手动运行流程时会记录 `hist_run_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_run\_flow\_scheduled

通过计划运行流程时会记录 `hist_run_flow_scheduled` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr></tbody></table>

## hist\_save\_flow

保存流程时会记录 `hist_save_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_save\_flow\_draft

保存流程草案时会记录 `hist_save_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_send\_data\_driven\_alert\_email

当数据驱动型通知电子邮件或通知成功发送时，会记录 `hist_send_data_driven_alert_email` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_send\_failing\_data\_alert\_email

当数据驱动型通知电子邮件或通知失败时，会记录 `hist_send_failing_data_alert_email` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_send\_refresh\_pre\_pause\_email\_for\_content

发送刷新预暂停电子邮件时的 `hist_send_refresh_pre_pause_email_for_content` 事件日志。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentLuid</td><td>字符串</td><td>发送刷新预暂停电子邮件的内容项的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>发送刷新预暂停电子邮件的内容项的名称</td></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>内容所有者的 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>内容所有者的姓名</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_send\_subscription\_email\_for\_view

成功发送视图订阅电子邮件时会记录 `hist_send_subscription_email_for_view event` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的 UUID。用于 REST API。</td></tr><tr><td>scheduleName</td><td>字符串</td><td>计划的名称</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_send\_subscription\_email\_for\_workbook

成功发送工作簿订阅电子邮件时会记录 `hist_send_subscription_email_for_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的 UUID。用于 REST API。</td></tr><tr><td>scheduleName</td><td>字符串</td><td>可以为计划指定名称，存储在此处。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_send\_suspended\_data\_alert\_email

当数据驱动型通知暂停时，会记录 `hist_send_suspended_data_alert_email` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>说明</td><td>字符串</td><td>基于工作簿定义为工作表构建的描述性短语</td></tr><tr><td>description</td><td>字符串</td><td>视图的描述</td></tr><tr><td>fields</td><td>字符串</td><td>从工作簿 .twb 文件中提取的字段的列表</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>视图首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>index</td><td>整数</td><td>每个视图都有一个在属于该工作簿的视图之间唯一的索引</td></tr><tr><td>名称</td><td>字符串</td><td>视图的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>视图所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>视图所有者的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识视图，并在 URL 中引用视图时使用。该值派生自视图名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>视图的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>sheetId</td><td>字符串</td><td>工作表的 ID</td></tr><tr><td>sheetType</td><td>字符串</td><td>工作表的类型。故事、仪表板或视图。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>title</td><td>字符串</td><td>工作簿 .twb 文件中的工作表标题</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>包含视图的工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>包含视图的工作簿的名称</td></tr></tbody></table>

## hist\_suspend\_site

暂停站点时会记录 `hist_suspend_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_update\_collection

更新集合时会记录 `hist_update_collection` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>collectionLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>集合的描述</td></tr><tr><td>名称</td><td>字符串</td><td>集合的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有集合的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有集合的用户的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_update\_column

更新列时会记录 `hist_update_column` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>columnLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>列的描述</td></tr><tr><td>名称</td><td>字符串</td><td>列的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>拥有列的用户的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有列的用户的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含列的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含列的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_update\_data\_quality\_indicator

更新数据质量指标时会记录 `hist_update_data_quality_indicator` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataQualityIndicatorLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>dataQualityType</td><td>字符串</td><td>数据质量指标的类型</td></tr><tr><td>isActive</td><td>布尔值</td><td>指示数据质量指标是否处于活动状态</td></tr><tr><td>isSevere</td><td>布尔值</td><td>指示数据质量指标是否严重</td></tr><tr><td>message</td><td>字符串</td><td>数据质量筛选器消息</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userDisplayName</td><td>字符串</td><td>创建或修改了数据质量指标的用户的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>创建或修改了数据质量指标的用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_data\_role

更新数据角色时会记录 `hist_update_data_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>dataRoleLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据角色的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据角色的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据角色所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据角色所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据角色的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据角色的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_update\_database

更新数据库时会记录 `hist_update_database` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>databaseLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据库的描述</td></tr><tr><td>名称</td><td>字符串</td><td>数据库数</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据库所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据库所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据库的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据库的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr></tbody></table>

## hist\_update\_datasource

更新数据源时会记录 `hist_update_datasource` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_update\_datasource\_task

更新数据源相关任务时会记录 `hist_update_datasource_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_update\_datasource\_trigger

`hist_update_datasource_trigger` 事件指定导致数据源更新的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>数据源的 LUID</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的用户 LUID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的 LUID</td></tr><tr><td>projectName</td><td>字符串</td><td>在其中发布数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_update\_flow

更新流程时会记录 `hist_update_flow` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_update\_flow\_draft

更新流程草案时会记录 `hist_update_flow_draft` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>createdAt</td><td>字符串</td><td>创建记录时的时间戳</td></tr><tr><td>flowDraftLuid</td><td>字符串</td><td>流程草案的唯一 ID</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID。如果流程草案未连接到已发布的流程，则该值为 Null。</td></tr><tr><td>名称</td><td>字符串</td><td>流程草案的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>流程草案所有者的唯一 ID。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>ownerName</td><td>字符串</td><td>流程草案所有者的名称。流程草案的所有者可能与流程所有者不同。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含流程草案的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含流程草案的项目的名称</td></tr><tr><td>publishedAt</td><td>字符串</td><td>流程草案上次发布时的时间戳</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>长整数</td><td>流程草案的大小（以字节为单位）</td></tr><tr><td>updatedAt</td><td>字符串</td><td>上次更新记录时的时间戳</td></tr></tbody></table>

## hist\_update\_flow\_task

运行流程更新任务时会记录 `hist_update_flow_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_update\_flow\_trigger

`hist_update_flow_trigger` 事件指定导致流程更新的原因。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>字符串</td><td>流程文件的版本。每次发布时递增 1。</td></tr><tr><td>description</td><td>字符串</td><td>流程的描述</td></tr><tr><td>flowLuid</td><td>字符串</td><td>流程的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>流程的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>流程的大小（以字节为单位）</td></tr></tbody></table>

## hist\_update\_linked\_task

运行链接的更新任务时会记录 `hist_update_linked_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_update\_metric

更新指标时会记录 `hist_update_metric` 事件。

**注意：**Tableau 旧版指标功能已在 2024 年 2 月停用。因此，此事件不再记录用户与站点上的指标的交互。有关详细信息，请参见[针对指标进行设置](https://help.tableau.com/v0.0/online/zh-cn/metrics_admin.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>customizedViewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr><tr><td>description</td><td>字符串</td><td>指标的描述</td></tr><tr><td>metricLuid</td><td>字符串</td><td>指标的唯一 ID</td></tr><tr><td>名称</td><td>字符串</td><td>指标的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>关联项目的唯一 ID。</td></tr><tr><td>projectName</td><td>字符串</td><td>关联项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>suspendState</td><td>整数</td><td>指标的状态。值 0 = 未暂停，1 = 自动暂停，3 = 手动暂停。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>指标从中查询其数据的视图</td></tr></tbody></table>

## hist\_update\_project

更新项目时会记录 `hist_update_project` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>项目的描述</td></tr><tr><td>名称</td><td>字符串</td><td>项目的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>项目所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>项目所有者的名称</td></tr><tr><td>parentProjectLuid</td><td>字符串</td><td>父项目的 LUID。对于顶层项目，该值为 Null。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的唯一标识符</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>字符串</td><td>项目的状态。默认值为 active。任何其他值都表示该项目处于非活动状态。</td></tr></tbody></table>

## hist\_update\_schedule

更新计划时会记录 `hist_update_schedule` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明计划是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>dayOfMonthMask</td><td>整数</td><td>指示计划将在一月内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一月内的天对应于“1 日：1”、“2 日：10”、“3 日：100”、“4 日：1000”、“5 日：10000”等。</td></tr><tr><td>dayOfWeekMask</td><td>整数</td><td>指示计划将在一周内的哪一天运行。此信息采用给定整数编码。要加以解释，请将整数转换为二进制。一周的天对应于“星期日：1”、“星期一：10”、“星期二：100”、“星期三：1000”、“星期四：10000”、“星期五：100000”、“星期六：1000000”。</td></tr><tr><td>endAtMinute</td><td>整数</td><td>指定的 schedule_typ e周期开始后的分钟，指示计划何时应停止触发。</td></tr><tr><td>endScheduleAt</td><td>字符串</td><td>计划应停止触发的时间戳</td></tr><tr><td>isSerial</td><td>布尔值</td><td>指示计划是否连续运行</td></tr><tr><td>minuteInterval</td><td>整数</td><td>一旦触发，计划将按此时间间隔重复，直到按照 schedule_type、end_at_minute 或 end_schedule_at 结束。</td></tr><tr><td>名称</td><td>字符串</td><td>计划的名称</td></tr><tr><td>priority</td><td>整数</td><td>优先级范围为 1 到 100，越低的值对应越高的优先级。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>计划的唯一 ID</td></tr><tr><td>scheduleType</td><td>整数</td><td>计划的类型。值 0（每小时）、1（每天）、2（每周）、和 3（每月）。</td></tr><tr><td>scheduledAction</td><td>整数</td><td>计划操作的类别。值 0 = 数据提取，1 = 订阅。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>startAtMinute</td><td>整数</td><td>每个 Schedule_type 的计划开始时间之后的分钟。例如，在每日计划中，指的是午夜过后的分钟；对于每小时，指的是整点后的分钟。</td></tr></tbody></table>

## hist\_update\_site

更新站点时会记录 `hist_update_site` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>名称</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>siteEventLuid</td><td>字符串</td><td>受事件影响的站点的唯一 ID</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>urlNamespace</td><td>字符串</td><td>在构建以此站点为目标的 URL 时使用</td></tr></tbody></table>

## hist\_update\_system\_user\_email

变更系统用户的电子邮件时会记录 `hist_update_system_user_email` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>formerEmail</td><td>字符串</td><td>用户以前的电子邮件地址。</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_system\_user\_force\_password\_update

这`hist_update_system_user_force_password_update` 事件记录强制更新密码的成功调用。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_system\_user\_image

系统用户更新其个人资料图像时会记录 `hist_update_system_user_image` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_system\_user\_name

系统用户更新其姓名时会记录 `hist_update_system_user_name` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>formerName</td><td>字符串</td><td>用户以前的友好名称。</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_system\_user\_password

系统用户更新其密码时会记录 `hist_update_system_user_password` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_system\_user\_reset\_login\_rate\_limiting

`hist_update_system_user_reset_login_rate_limiting` 事件记录重置登录速率限制值的成功调用

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_table

更新表时会记录 `hist_update_table` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>description</td><td>字符串</td><td>表的描述</td></tr><tr><td>名称</td><td>字符串</td><td>表的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>表所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>表所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含表的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含表的项目的名称</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>tableLuid</td><td>字符串</td><td>唯一标识符</td></tr></tbody></table>

## hist\_update\_task\_state

变更任务的状态时会记录 `hist_update_task_state` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_update\_user\_site\_role

变更用户的站点角色时会记录 `hist_update_user_site_role` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>email</td><td>字符串</td><td>用户的电子邮件地址</td></tr><tr><td>名称</td><td>字符串</td><td>用户的名称</td></tr><tr><td>siteAdminLevel</td><td>整数</td><td>指明用户是否为站点管理员。如果值为 5，则是站点管理员，如果值为 0，则不是站点管理员。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>userLuid</td><td>字符串</td><td>用户的唯一 ID</td></tr></tbody></table>

## hist\_update\_workbook

更新工作簿时会记录 `hist_update_workbook` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_update\_workbook\_task

运行工作簿更新任务时会记录 `hist_update_workbook_task` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>active</td><td>布尔值</td><td>指明任务是否处于活动状态。如果设置为 False，则触发计划时任务将不会运行。</td></tr><tr><td>consecutiveFailureCount</td><td>整数</td><td>任务的失败次数</td></tr><tr><td>creatorLuid</td><td>字符串</td><td>创建任务的用户的用户 ID</td></tr><tr><td>creatorName</td><td>字符串</td><td>创建任务的用户的名称</td></tr><tr><td>historicalQueueTime</td><td>整数</td><td>任务排队的时间（以秒为单位）。用于比较历史排队时间的差异。</td></tr><tr><td>historicalRunTime</td><td>整数</td><td>任务启动后运行的时间（以秒为单位）。用于比较历史运行时间的差异。</td></tr><tr><td>lastSuccessCompletedAt</td><td>字符串</td><td>上次成功完成任务的时间戳</td></tr><tr><td>objLuid</td><td>字符串</td><td>对象的唯一 ID。用作工作簿或数据源表中的主键。</td></tr><tr><td>objName</td><td>字符串</td><td>对象的名称。与 objLuid 一起使用。</td></tr><tr><td>objType</td><td>字符串</td><td>对象的类型。工作簿或数据源。与 objLuid 一起使用。</td></tr><tr><td>priority</td><td>整数</td><td>任务的优先级，范围从 10（默认）到 0（最高）。优先级较高的作业将被更早处理。</td></tr><tr><td>scheduleLuid</td><td>字符串</td><td>关联计划的唯一 ID。任务将在计划的开始时间运行。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>state</td><td>整数</td><td>任务的状态。值 0 = 活动、1 = 暂停、2 = 禁用。</td></tr><tr><td>subtitle</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>taskLuid</td><td>字符串</td><td>任务的 UUID。用于 REST API。</td></tr><tr><td>title</td><td>字符串</td><td>提供有关任务的附加信息</td></tr><tr><td>type</td><td>字符串</td><td>任务的类型。数据提取、订阅、流程、加密或系统。</td></tr></tbody></table>

## hist\_upgrade\_datasource\_extract\_storage

旧版升级数据源从 historical\_events 中提取存储事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_upgrade\_datasource\_tde\_extract

旧版升级数据源 tde 从 history\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>certificationNote</td><td>字符串</td><td>数据源的认证状态的原因</td></tr><tr><td>datasourceLuid</td><td>字符串</td><td>唯一标识符</td></tr><tr><td>description</td><td>字符串</td><td>数据源的描述</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>isCertified</td><td>布尔值</td><td>指示数据源是否经过认证</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>名称</td><td>字符串</td><td>数据源的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>数据源所有者的唯一 ID</td></tr><tr><td>ownerName</td><td>字符串</td><td>数据源所有者的名称</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含数据源的项目的唯一 ID</td></tr><tr><td>projectName</td><td>字符串</td><td>包含数据源的项目的名称</td></tr><tr><td>remoteQueryAgentName</td><td>字符串</td><td>数据源使用的远程查询代理的名称</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识数据源，在 URL 中引用数据源时使用。该值派生自数据源名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>数据源的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>数据源的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>usingRemoteQueryAgent</td><td>布尔值</td><td>指示数据源是否使用远程查询代理</td></tr></tbody></table>

## hist\_upgrade\_workbook\_extract\_storage

旧版升级工作簿从 historical\_events 中提取存储事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## hist\_upgrade\_workbook\_tde\_extract

旧版升级工作簿从 historical\_events 中提取事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentVersion</td><td>整数</td><td>工作簿的版本号。每次发布时递增 1。</td></tr><tr><td>dataEngineExtracts</td><td>布尔值</td><td>指明工作簿是否有关联的数据引擎数据提取</td></tr><tr><td>defaultViewIndex</td><td>整数</td><td>指明默认情况下是否将显示视图</td></tr><tr><td>details</td><td>字符串</td><td>消息字符串</td></tr><tr><td>displayTabs</td><td>布尔值</td><td>指示工作簿的工作表是否显示为标签</td></tr><tr><td>documentVersion</td><td>字符串</td><td>文档描述的版本号。保存工作簿时输入描述。</td></tr><tr><td>extractsIncrementedAt</td><td>字符串</td><td>上次增量数据提取刷新发生的时间戳</td></tr><tr><td>extractsRefreshedAt</td><td>字符串</td><td>上次数据提取刷新发生的时间戳</td></tr><tr><td>firstPublishedAt</td><td>字符串</td><td>工作簿首次发布时的时间戳。重新发布包含视图的工作簿时，该值不会更改。</td></tr><tr><td>incrementableExtracts</td><td>布尔值</td><td>指明是否可以执行增量数据提取刷新</td></tr><tr><td>isFailure</td><td>布尔值</td><td>指示操作是否失败</td></tr><tr><td>isPrivate</td><td>布尔值</td><td>指明工作簿是否为私有。值 True = 私有，Null 或 False = 非私有。</td></tr><tr><td>lastPublishedAt</td><td>字符串</td><td>进行 Web 制作时上次发布或保存工作簿时的时间戳。对于存在此列之前最后发布的工作簿，值将为 Null。</td></tr><tr><td>modifiedByUserLuid</td><td>字符串</td><td>上次在 Web 制作时修改和发布工作簿或保存工作簿的用户。对于存在此列之前最后发布的工作簿，值将与 owner_id 相同。</td></tr><tr><td>名称</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>ownerLuid</td><td>字符串</td><td>工作簿所有者的唯一 ID。用作外键。</td></tr><tr><td>ownerName</td><td>字符串</td><td>拥有工作簿的用户的名称。</td></tr><tr><td>projectLuid</td><td>字符串</td><td>包含工作簿的项目的唯一 ID。用作外键。</td></tr><tr><td>projectName</td><td>字符串</td><td>包含工作簿的项目的名称。</td></tr><tr><td>publishedAllSheets</td><td>布尔值</td><td>指示是否已发布工作簿中的所有工作表。值 True = 已发布所有工作表，False = 一个或多个工作表未发布。</td></tr><tr><td>refreshableExtracts</td><td>布尔值</td><td>指示工作簿中的数据提取是否可刷新</td></tr><tr><td>repositoryUrl</td><td>字符串</td><td>唯一标识工作簿，并在 URL 中引用工作簿时使用。该值派生自工作簿名称中的 ASCII 字符。</td></tr><tr><td>revision</td><td>字符串</td><td>版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr><tr><td>siteName</td><td>字符串</td><td>Tableau 站点的名称</td></tr><tr><td>size</td><td>整数</td><td>工作簿的大小（以字节为单位）</td></tr><tr><td>taskLuid</td><td>字符串</td><td>关联任务的 LUID</td></tr><tr><td>thumbUserLuid</td><td>字符串</td><td>用于生成缩略图的用户的唯一 ID。除非指定，否则为 Null。</td></tr><tr><td>viewCount</td><td>整数</td><td>计算与此工作簿关联的视图的数量</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的唯一 ID</td></tr></tbody></table>

## login\_authentication

`login_authentication` 事件记录身份验证事件（包括默认、SAML、OIDC 以及带有 MFA 的 Tableau）。

**注意：**不成功的登录尝试通常会在到达 Tableau 之前被您的身份验证提供程序记录下来。若要调查这些尝试，请检查提供程序的日志。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>acceptLanguage</td><td>字符串</td><td>The browser <code>Accept-Language</code> request HTTP header</td></tr><tr><td>logRecordType</td><td>字符串</td><td><p>与事件关联的记录类型，可以是 verification 或 authentication。</p></td></tr><tr><td>loginKey</td><td>字符串</td><td><p>唯一的登录跟踪值。用于将用户活动与身份验证事件关联起来。</p></td></tr><tr><td>loginType</td><td>字符串</td><td><p>用于登录的身份验证类型，可以是 DEFAULT、SAML、OIDC 或 TABID_WITH_MFA。</p></td></tr><tr><td>loginUrl</td><td>字符串</td><td><p>用户发送登录请求的 URL，包括协议、主机名以及（如果适用）站点路径前缀。</p></td></tr><tr><td>reason</td><td>字符串</td><td><p>登录失败的失败原因</p></td></tr><tr><td>sourceIp</td><td>字符串</td><td><p>登录请求的源 IP。使用 <a href="https://en.wikipedia.org/wiki/X-Forwarded-For" target="_blank">XFF</a> 或 webRTC 来识别客户端的原始 IP 地址。</p></td></tr><tr><td>status</td><td>字符串</td><td>身份验证结果，可以是 success 或 failure。</td></tr><tr><td>tenantId</td><td>字符串</td><td><p>租户或组织的 ID</p></td></tr><tr><td>timestamp</td><td>字符串</td><td><p>事件的时间戳</p></td></tr><tr><td>userAgent</td><td>字符串</td><td><p>发起登录的代理或浏览器的名称</p></td></tr><tr><td>userId</td><td>字符串</td><td>用户的 ID</td></tr><tr><td>userType</td><td>字符串</td><td>通过用户界面或 API 访问 Tableau 的用户类型。</td></tr><tr><td>username</td><td>字符串</td><td>用于登录的用户名</td></tr><tr><td>uuid</td><td>字符串</td><td><p>请求的唯一 ID</p></td></tr></tbody></table>

## login\_with\_jwt

当用户使用 JSON Web 令牌 (JWT) 登录时，会发生 `login_with_jwt` 事件。审核此事件时，请使用 `type` 属性来区分统一访问令牌 JWT 和已连接应用程序登录尝试。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorExternalId</td><td>字符串</td><td>代理用户的外部 ID。这是一个不透明的标识符，取决于参与者类型，但举例来说，也可以是用户电子邮件。</td></tr><tr><td>configId</td><td>字符串</td><td>用于身份验证的 JWT 配置 ID</td></tr><tr><td>expiresAt</td><td>字符串</td><td>JWT 过期时间 (exp) 声明值</td></tr><tr><td>issuedAt</td><td>字符串</td><td>JWT 签发时间 (iat) 声明值</td></tr><tr><td>jti</td><td>字符串</td><td>JWT ID 声明。用于跟踪和审核令牌。</td></tr><tr><td>jwtIssuer</td><td>字符串</td><td>JWT 颁发者 (iss) 声明</td></tr><tr><td>scope</td><td>字符串</td><td>用于授权的 JWT 范围声明</td></tr><tr><td>sessionId</td><td>字符串</td><td>JWT 成功登录后创建的会话的 ID。用于跟踪与初始登录相关的其他事件。</td></tr><tr><td>siteName</td><td>字符串</td><td>发生JWT 登录的站点的名称</td></tr><tr><td>sourceIp</td><td>字符串</td><td>发起 JWT 登录的客户端的 IP 地址</td></tr><tr><td>type</td><td>字符串</td><td>用于登录的 JWT 类型。已根据 Tableau 已连接应用配置验证的 <code>UAT JWT</code>（适用于统一访问令牌 JWT）或 <code>Connected Apps</code>（适用于 JWT）。</td></tr><tr><td>userAgent</td><td>字符串</td><td>发起 JWT 登录的代理或浏览器的名称</td></tr></tbody></table>

## login\_verification

`login_verification` 事件记录带有 MFA 的 Tableau 身份验证类型的 MFA 验证事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>acceptLanguage</td><td>字符串</td><td>The browser <code>Accept-Language</code> request HTTP header</td></tr><tr><td>flow</td><td>字符串</td><td>需要验证的用户工作流，例如登录、ssh 或权限更改。</td></tr><tr><td>logRecordType</td><td>字符串</td><td><p>与事件关联的记录类型，可以是 verification 或 authentication。</p></td></tr><tr><td>loginKey</td><td>字符串</td><td>唯一的登录跟踪值。用于将用户活动与验证事件相关联。</td></tr><tr><td>reason</td><td>字符串</td><td><p>成功或失败的原因，例如用户批准、无响应或密码无效。</p></td></tr><tr><td>sourceIp</td><td>字符串</td><td><p>身份验证设备的 IP 地址。使用 <a href="https://en.wikipedia.org/wiki/X-Forwarded-For" target="_blank">XFF</a> 或 webRTC 来识别客户端的原始 IP 地址。</p></td></tr><tr><td>status</td><td>字符串</td><td>验证结果，可以是 success 或 failure。</td></tr><tr><td>tenantId</td><td>字符串</td><td>租户或组织的 ID</td></tr><tr><td>timestamp</td><td>字符串</td><td>事件的时间戳</td></tr><tr><td>userAgent</td><td>字符串</td><td>发起登录的代理或浏览器的名称</td></tr><tr><td>userId</td><td>字符串</td><td>用户的 ID</td></tr><tr><td>userType</td><td>字符串</td><td>通过用户界面或 API 访问 Tableau 的用户类型。</td></tr><tr><td>username</td><td>字符串</td><td>用于登录的用户名</td></tr><tr><td>uuid</td><td>字符串</td><td>请求的唯一 ID</td></tr><tr><td>verificationMethod</td><td>字符串</td><td>使用的验证方法，例如身份验证器应用程序、安全密钥或内置身份验证器。</td></tr></tbody></table>

## metric\_subscription\_change

用户在 Pulse 指标中添加或移除订阅时会记录 `metric_subscription_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorGroupLuid</td><td>字符串</td><td>关注或取消关注指标的组的组 LUID。如果用户更改范围指标，<code>actorGroupLuid</code> 值将为空，并改为填充 <code>actorUserLuid</code>。</td></tr><tr><td>scopedMetricId</td><td>字符串</td><td>已更改订阅的范围指标的 ID</td></tr><tr><td>subscriptionOperation</td><td>字符串</td><td>订阅操作，例如“已关注指标”或“取消关注指标”</td></tr></tbody></table>

## move\_content

移动内容（例如，在项目之间移动工作簿）时记录 `move_content` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentId</td><td>整数</td><td>已更改所有者的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>已更改所有者的内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更改所有者的内容的名称</td></tr><tr><td>contentType</td><td>字符串</td><td>内容的类型，例如数据源、工作簿或视图</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>newContainerLuid</td><td>字符串</td><td>新容器的 LUID</td></tr><tr><td>newContainerType</td><td>字符串</td><td>新容器类型，例如项目</td></tr><tr><td>oldContainerLuid</td><td>字符串</td><td>上一个容器的 LUID</td></tr><tr><td>oldContainerType</td><td>字符串</td><td>上一个容器类型，例如项目</td></tr></tbody></table>

## oauth\_settings\_change

在“常规”选项卡上更新 OAuth 客户端注册表设置时，会发生 `oauth_settings_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>clientId</td><td>字符串</td><td>向数据提供程序注册的客户端 ID</td></tr><tr><td>connectionType</td><td>字符串</td><td>连接的类型</td></tr><tr><td>errorCode</td><td>字符串</td><td>更改 OAuth 设置时生成的错误代码</td></tr><tr><td>openAuthInstanceUrl</td><td>字符串</td><td>OAuth 实例 URL</td></tr><tr><td>openAuthProvider</td><td>字符串</td><td>OAuth 提供程序</td></tr><tr><td>operationType</td><td>字符串</td><td>操作类型，即创建或删除。</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2024.3.0。</td></tr><tr><td>uploadedFile</td><td>字符串</td><td>为更改 OAuth 设置而上载的文件的名称</td></tr></tbody></table>

## platform\_configuration\_change

The `platform_configuration_change` event occurs when the outbound connection allowlist for Tableau Prep endpoints is updated.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>errorCode</td><td>字符串</td><td>更改 Tableau Prep 设置时生成的错误代码</td></tr><tr><td>newSettingValue</td><td>字符串</td><td>描述允许列表端点新值的结构化 JSON 字符串</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2024.3.0。</td></tr><tr><td>previousSettingValue</td><td>字符串</td><td>描述允许列表端点的先前值的结构化 JSON 字符串</td></tr><tr><td>settingIdentifier</td><td>字符串</td><td>功能的设置标识符，例如 <code>prep_endpoint_control</code>。</td></tr><tr><td>siteName</td><td>字符串</td><td>发生操作的站点名称</td></tr><tr><td>userAgent</td><td>字符串</td><td><code>actorUser</code> 用于进行更改的客户端软件</td></tr></tbody></table>

## platform\_settings\_change

在“设置”页面上更改安全性和访问配置时，会发生 `platform_settings_change` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>errorCode</td><td>字符串</td><td>更改配置设置时生成的错误代码</td></tr><tr><td>ipAddress</td><td>字符串</td><td>发起请求的计算机的 IP 地址</td></tr><tr><td>isSecretUpdated</td><td>布尔值</td><td>指示密文是否已更新。不会记录实际的密文值。此属性可帮助管理员跟踪组织中的变化，例如影响系统功能的变化或确保正确执行计划的密文轮换的变化。</td></tr><tr><td>newSettingsValue</td><td>字符串</td><td>新的设置值</td></tr><tr><td>oldSettingsValue</td><td>字符串</td><td>以前的设置值</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2024.3.0。</td></tr><tr><td>settingDescription</td><td>字符串</td><td>受影响设置的描述</td></tr><tr><td>settingIdentifier</td><td>字符串</td><td>此功能的设置标识符，例如 <code>prep_endpoint_control</code>。</td></tr><tr><td>siteName</td><td>字符串</td><td>发生操作的站点名称</td></tr><tr><td>tenantName</td><td>字符串</td><td>发生操作的租户名称</td></tr><tr><td>userAgent</td><td>字符串</td><td><code>actorUser</code> 用于进行更改的客户端软件</td></tr></tbody></table>

## prep\_flowruns

The `prep_flowruns` event occurs when flow runs from the Tableau Flow Processor are recorded.

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>connectionEndpoints</td><td>字符串</td><td>Tableau Prep 流程运行中的输入和输出端点列表</td></tr><tr><td>errorCode</td><td>字符串</td><td>更改 Tableau Prep 设置时生成的错误代码</td></tr><tr><td>flowId</td><td>字符串</td><td>Tableau Prep 流程的 ID</td></tr><tr><td>flowName</td><td>字符串</td><td>Tableau Prep 流程的名称</td></tr><tr><td>flowOwnerId</td><td>整数</td><td>制作流程的用户的 ID</td></tr><tr><td>flowRunLuid</td><td>字符串</td><td>Tableau Prep 流程运行的 LUID</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2024.3.0。</td></tr><tr><td>userName</td><td>字符串</td><td>用户的用户名</td></tr></tbody></table>

## project\_lock\_unlock

当项目权限被锁定或解锁时记录 `project_lock_unlock` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>controllingProjectLuid</td><td>字符串</td><td>控制嵌套项目权限的项目的 LUID</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>projectLuid</td><td>字符串</td><td>项目的 LUID</td></tr><tr><td>projectOperation</td><td>字符串</td><td>项目操作，即锁定或解锁</td></tr></tbody></table>

## restore\_content

从回收站恢复内容时，会发生 `restore_content` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>contentId</td><td>整数</td><td>已恢复内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>已恢复内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已恢复内容的名称</td></tr><tr><td>contentType</td><td>字符串</td><td>存档内容的类型</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr></tbody></table>

## set\_permissions

为内容项创建或更新权限规则时（通常是当您在“权限”对话框中保存更改时），会在日志中记录 `set_permissions` 事件。移除权限规则也会记录为此事件，其中 `permissionType` 为 `unspecified`。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td><p>已更改其权限的内容类型，例如项目或工作簿</p></td></tr><tr><td>capabilityId</td><td>整数</td><td>能力的 ID。能力是指对一部分内容执行给定操作（例如查看、筛选、下载或删除）的能力。</td></tr><tr><td>capabilityValue</td><td>字符串</td><td>能力的描述</td></tr><tr><td>contentId</td><td>整数</td><td>已设置权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容项的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已设置权限的内容的名称</td></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。如果被授权人最近被删除或 LUID 查找服务不可用，则此值可以为 null。<code>granteeId</code> 属性始终存在。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>granteeValue</td><td>字符串</td><td>设置的权限值，例如“用户允许”或“组允许”</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>permissionType</td><td>字符串</td><td>权限类型。值为 <code>explicit</code> 表示设置了“允许”或“拒绝”规则。值为 <code>unspecified</code> 表示规则已移除或设置为继承。</td></tr></tbody></table>

## site\_storage\_usage

`site_storage_usage` 事件记录站点的总存储容量（以字节为单位）、已使用的存储量以及总消耗的百分比。管理员可以使用这些数据主动监控存储消耗，并在达到站点的存储限制之前采取行动。

**注意：**此事件类型的部分数据只能通过 API 获得。若要查看完整的事件日志，请配置活动日志以将日志数据发送到 Amazon S3 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>actorUsername</td><td>字符串</td><td><p>执行启动事件的操作的用户的用户名</p></td></tr><tr><td>initiatingUsername</td><td>字符串</td><td>发起用户的用户名</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>totalPercentageStorageQuotaUsed</td><td>浮点数</td><td>存储使用的总百分比</td></tr><tr><td>totalStorageQuotaLimit</td><td>长整数</td><td>总存储容量（以字节为单位）</td></tr><tr><td>totalStorageQuotaUsed</td><td>长整数</td><td>使用的总存储（以字节为单位）</td></tr></tbody></table>

## tabgpt\_registration\_event

`tabgpt_registration_event` 记录 Tableau Agent 设置的更改。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>domain</td><td>字符串</td><td>Salesforce 组织的域</td></tr><tr><td>errorCode</td><td>字符串</td><td>更改 Tableau Agent 设置时生成的错误代码</td></tr><tr><td>instanceName</td><td>字符串</td><td>Salesforce 组织的实例名称</td></tr><tr><td>operationType</td><td>字符串</td><td>操作类型，即创建或删除。</td></tr><tr><td>orgId</td><td>字符串</td><td>注册的 Salesforce 组织 ID</td></tr><tr><td>platform</td><td>字符串</td><td>记录变更的平台，例如 Tableau Cloud。</td></tr><tr><td>platformVersion</td><td>字符串</td><td>平台的版本，例如 2025.1.0。</td></tr><tr><td>pod</td><td>字符串</td><td>在其中执行操作的 Tableau pod 的名称，例如 10ay。</td></tr><tr><td>siteName</td><td>字符串</td><td>发生操作的站点的名称</td></tr><tr><td>username</td><td>字符串</td><td>Salesforce 组织中用户的用户名</td></tr></tbody></table>

## update\_permissions

为内容项更新显式许可规则时记录 `update_permissions` 事件。

**注意：**2024 年 10 月已弃用。改用 [set\_permissions](#set-permissions) 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td>已更改其权限的内容类型，例如项目或工作簿</td></tr><tr><td>capabilityId</td><td>整数</td><td>能力的 ID。能力是指对内容执行操作（例如查看、筛选、下载或删除）的能力</td></tr><tr><td>capabilityValue</td><td>字符串</td><td>能力的描述</td></tr><tr><td>contentId</td><td>整数</td><td>已更新权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更新权限的内容的名称</td></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>granteeValue</td><td>字符串</td><td>更新的权限值，例如“用户允许”或“组允许”</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>permissionType</td><td>字符串</td><td>权限类型，即显式或未指定</td></tr></tbody></table>

## update\_permissions\_template

更新项目的权限模板时记录 `update_permissions_template` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>authorizableType</td><td>字符串</td><td>已更改其权限的内容类型，例如项目或工作簿</td></tr><tr><td>capabilityId</td><td>整数</td><td>能力的 ID。能力是指对内容执行操作（例如查看、筛选、下载或删除）的能力</td></tr><tr><td>capabilityValue</td><td>字符串</td><td>能力的描述</td></tr><tr><td>contentId</td><td>整数</td><td>已更新权限的内容的 ID</td></tr><tr><td>contentLuid</td><td>字符串</td><td>内容的 LUID</td></tr><tr><td>contentName</td><td>字符串</td><td>已更新权限的内容的名称</td></tr><tr><td>granteeId</td><td>整数</td><td>被授权人的 ID</td></tr><tr><td>granteeLuid</td><td>字符串</td><td>被授权人的 LUID。如果被授权人最近被删除或 LUID 查找服务不可用，则此值可以为 null。<code>granteeId</code> 属性始终存在。</td></tr><tr><td>granteeType</td><td>字符串</td><td>被授权人的类型，即用户或组</td></tr><tr><td>granteeValue</td><td>字符串</td><td>更新的权限值，例如“用户允许”或“组允许”</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>permissionType</td><td>字符串</td><td>权限类型。值为 <code>explicit</code> 表示设置了“允许”或“拒绝”规则。值为 <code>unspecified</code> 表示规则已移除或设置为继承。</td></tr><tr><td>templateType</td><td>字符串</td><td>用于更改权限的权限模板的类型，例如工作簿或数据数据源</td></tr></tbody></table>

## user\_create\_delete

创建或删除用户时记录 `user_create_delete` 事件。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>forUserName</td><td>字符串</td><td>创建、更新或删除了帐户的用户名</td></tr><tr><td>isError</td><td>布尔值</td><td>指示审计方案是成功完成还是因错误而失败</td></tr><tr><td>siteRole</td><td>字符串</td><td>用户的站点角色。确定用户可在站点上具有的最高访问权限级别</td></tr><tr><td>targetUserId</td><td>整数</td><td>创建、更新或删除了帐户的用户的 ID</td></tr><tr><td>targetUserLuid</td><td>字符串</td><td>创建、更新或删除了帐户的用户的 LUID</td></tr><tr><td>userOperation</td><td>字符串</td><td>对用户执行的操作，即创建、删除或站点角色更改</td></tr></tbody></table>

## vizql\_http\_request

`vizql_http_request` 事件也称为“视图交互事件”，记录用户与已发布内容的交互方式。此事件可用于监视仪表板性能、提高数据安全性和分析用户参与度。有关详细信息，请参见[使用活动日志监控数据导出](https://help.tableau.com/v0.0/online/zh-cn/activity_log_monitor_data_exports.htm)和[使用活动日志监控视图加载时间](https://help.tableau.com/v0.0/online/zh-cn/activity_log_monitor_view_load_times.htm)。

**注意：**此事件类型的部分数据只能通过 API 获得。若要查看完整的事件日志，请配置活动日志以将日志数据发送到 Amazon S3 存储桶进行分析。有关详细信息，请参见[设置活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_setup.htm)。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 20%;"><col style="width: 10%;"><col></colgroup><tbody><tr><th>属性名称</th><th>类型</th><th>描述</th></tr><tr><td>duration</td><td>长整数</td><td>处理请求所花费的时间（以毫秒为单位）。</td></tr><tr><td>endpointName</td><td>字符串</td><td>被调用端点的名称</td></tr><tr><td>ipAddress</td><td>字符串</td><td>发起请求的客户端计算机或 VPN 的 IP 地址</td></tr><tr><td>method</td><td>字符串</td><td>使用的请求方法，例如 GET、POST、PUT 或 DELETE。</td></tr><tr><td>referrer</td><td>字符串</td><td>HTTP 引用页，或请求的来源。</td></tr><tr><td>requestId</td><td>字符串</td><td>请求 ID</td></tr><tr><td>requestUri</td><td>字符串</td><td>HTTP 请求的 URI</td></tr><tr><td>sessionId</td><td>字符串</td><td>会话密钥的新 ID。如果创建尝试失败，则省略。</td></tr><tr><td>siteName</td><td>字符串</td><td>发生操作的站点的名称</td></tr><tr><td>siteUri</td><td>字符串</td><td>发生操作的站点的 URI 令牌</td></tr><tr><td>userAgent</td><td>字符串</td><td>发起请求的客户端软件，例如应用程序、操作系统或版本。</td></tr><tr><td>viewLuid</td><td>字符串</td><td>视图的 LUID。</td></tr><tr><td>viewName</td><td>字符串</td><td>视图的名称</td></tr><tr><td>viewRepoUrl</td><td>字符串</td><td>视图的存储库 URL</td></tr><tr><td>vizqlSessionId</td><td>字符串</td><td>VizQL 会话 ID</td></tr><tr><td>workbookLuid</td><td>字符串</td><td>工作簿的 LUID</td></tr><tr><td>workbookName</td><td>字符串</td><td>工作簿的名称</td></tr><tr><td>workbookRevision</td><td>整数</td><td>工作簿的版本号。从 1.0 开始，每次发布新版本时递增 0.1。</td></tr></tbody></table>

<!-- document id=c4519380ad14263574c12394e7aff928113191014dd609112d480cfde553d934 url=/tableau/next/zh-cn/online/prep_conductor_admin_views.md -->

[跳转到主要内容](#main-content)

# 流程的管理视图

管理视图可用于监视与流程、性能历史记录和已用磁盘空间相关的活动。**“状态”**页面包含一个带有各种管理视图的嵌入式 Tableau 工作簿，可以使用这些管理视图来监视不同类型的服务器或站点活动。

## 谁可以执行此操作？

Tableau 站点管理员可以查看和使用管理视图。

## 所有用户的操作

使用此视图可收集有关流程使用方式的见解。这包括发布、下载和流程运行等操作。可按操作、站点和时间范围来筛选视图。“用户总数”计数显示执行了动作的用户的数量。此值不受任何筛选影响。“活动用户计数”显示在选定时间段内处于活动状态并执行选定操作之一的用户数。

![一个管理视图，显示流程的折线图及其使用情况。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_action_allusers.png)

## 特定用户的操作

使用此视图可收集有关单个用户如何使用流程的见解。您可以按用户名、操作类型和时间范围筛选视图。

![显示单个用户如何使用流程的管理视图。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_action_specificuser.png)

## 最近用户的操作

此视图显示过去 24 小时内哪些用户在 Tableau Cloud 上处于活动状态。

如果需要在服务器上执行某种维护活动并且想要知道此活动将影响哪些用户及多少用户，以及这些用户执行的操作，则此视图非常有用。

视图显示当前登录到 Tableau Cloud 的**“活动”**、**“最近活动”**和**“空闲”**用户。

对于此视图，活动用户是指在最近 5 分钟执行了动作的用户，最近活动用户是指在 30 分钟内执行了动作的用户，空闲用户是指在超过 30 分钟以前执行了动作的用户。

选择一个用户以仅查看该用户最近执行的动作。将鼠标悬停在某个动作上可查看该动作的详细信息。

![显示过去 24 小时内哪些流程用户在 Tableau Server 或 Tableau Cloud 上处于活动状态的管理视图。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_action_recentusers.png)

## 后台程序任务延迟

此视图显示数据提取刷新任务、订阅和流程任务的延迟，也就是说这些任务的计划运行时间和实际运行时间所相差的时间。您可以使用该视图，通过分配任务计划和优化任务来帮助确定服务器性能的可改进之处。

![显示数据提取、订阅和流程等待时间的管理视图。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_backgrounder_delays.png)

延迟的可能原因和减少延迟的方法包括：

- 同时计划了多项任务。
    
    在示例视图中，显示长时间延迟的任务集中出现在每天的同一时间，从而在等待时间中造成了峰值。您可以针对某一天设置“时间范围”筛选器，以按小时查看任务延迟，并确定一天中同时计划了多项任务的时段。一种解决方案是将任务分摊到非高峰时段来降低服务器上的负载。

## 非数据提取后台任务

创建后台任务以运行流程（计划流程的和临时流程）。您可以使用此视图查看此站点上有多少流程任务成功或失败。若要查看任务的详细信息，请将鼠标悬停在其图标上。

![显示此站点上有多少流程任务成功或失败的管理视图。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_backgrounder_tasks.png)

## 流程运行的性能

使用此视图可以查看站点上所有流程的性能历史记录。您可以按“流程名称”、“输出步骤名称”、“流程所有者”、“运行类型”（“计划”或“临时”）以及流程运行的开始时间进行筛选。

![显示一段时间内的流性能的管理视图。图表上的每个点对应特定的流程运行，显示流程名称、输出步骤、流程所有者、运行类型以及开始和结束时间。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_flow_performance.png)

您可以使用此视图回答的问题包括：

- **当前计划了哪些流程任务？**–为此，请使用“开始时间”筛选器并选择要查看的时间段。例如，若要查看接下来 3 小时内计划的流程任务，请选择“**小时**”->“**下**”，然后输入 **3**。
- **流程任务持续了多长时间？**\- 若要回答此问题，请单击视图中的标记以查看包括任务持续时间在内的详细信息。
- **有多少流程临时运行，有多少流程按计划运行？**\- 若要回答此问题，请使用“**运行类型**”筛选器并选择“**临时**”或“**计划**”。

此视图还可以向您显示以下信息：

- 运行频率最高的流程具有最多的标记。
- 若要查看当前同时运行的流程，请将鼠标指针悬停在显示“**正在进行**”或“**待定”的标记上，并选择**“**只保留**”，以筛选当前正在运行的所有流程运行。
- 若要查看在特定时间范围内有多少流程正在同时运行，请为**“开始时间”**筛选器选择一个范围。例如，选择**“下三个小时”**以查看哪些流程将在接下来的三个小时内将运行。

## 空间使用情况统计数据

使用此视图可确定哪些流程输出占用了服务器上最多的磁盘空间。磁盘空间使用情况按用户、项目以及流程输出的大小显示，并舍入为最接近的数字。

![显示哪些流程输出占用了服务器上最多的磁盘空间的管理视图。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_admin_views_spaceusage.png)

使用“最小大小”筛选器，根据流程输出的空间占用量来控制显示哪些流程输出。对流程使用对象类型筛选器。

- **哪些用户使用最多空间** – 此部分显示拥有占用空间最多的流程（针对流程进行筛选时）的用户。单击用户名以筛选该用户接下来的两个图形。
- **哪些项目使用最多空间** – 此部分显示拥有占用空间最多的流程（针对流程进行筛选时）的项目。
- **哪些工作簿、数据源和流使用最多的空间**\- 此部分显示占用空间最多的流程（针对流程进行筛选时）。

## 谁可以执行此操作

- **Tableau 站点管理员**：
    - 在站点级别设置电子邮件通知
    - 查看错误
    - 恢复挂起的任务
    - 查看通知
- **流程所有者、项目主管和被授予流程查看权限的任何用户**：
    - 查看错误
    - 恢复挂起的任务
    - 查看通知（流程所有者）

<!-- document id=99f9cae986963b994a23a010112dc56b0a622feac613c40dcc01c085ab510003 url=/tableau/next/zh-cn/online/cloud_manager_sites.md -->

[跳转到主要内容](#main-content)

# 添加、重命名、删除或激活站点

在 Tableau Cloud Manager (TCM) 中，您管理的站点与您组织内的 Tableau Cloud 站点相对应。默认情况下，一个租户最多包含 3 个站点，但随着许可证类型的不同，容量也会增加 - 使用[企业](https://help.tableau.com/current/online/zh-cn/to_tab_enterprise_features.htm)许可证最多可管理 10 个站点，使用 [Tableau+](https://help.tableau.com/current/online/zh-cn/to_tab_plus_features.htm) 许可证最多可管理 50 个站点。

**注意：**多站点试点计划客户没有资格使用 Tableau Cloud Manager 管理多个站点。有关功能可用性的详细信息，请联系您的 Tableau 客户代表。

“站点” 页面包含租户中每个站点的数据，包括站点位置、用户计数和存储使用情况。TCM 允许您管理站点和用户，但不扩展到内容和站点设置的治理。这些功能专为具有站点管理员角色的用户保留，他们在站点级别拥有必要的访问权和权限。

本主题引导您完成在 TCM 中添加新站点和修改现有站点的步骤。

## 添加站点

作为云管理员，您可以通过添加新站点来扩展组织在 Tableau Cloud 中的功能。当您必须独立于其他用户管理一组独特的用户及其内容时，Tableau 建议创建站点。考虑为以下场景创建站点：

- **环境分离：**区分开发、测试和生产环境。
- **项目隔离：**适用于需要保密的项目或独立于现有项目的项目。
- **区域要求：**当扩展到新区域或遵守特定数据驻留和隐私法时。

若要添加站点，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在“站点”页面上，单击“新建站点”。
3. 填写“新建站点”对话框中的字段：
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_sites_new.png)
    
    1. **站点名称：**Tableau Cloud 站点的名称。站点名称可以是您的组织的名称或特定团队的名称，例如“销售”或“营销”。提供描述性名称可以让用户快速了解该站点的预期用途。
        
        - 在 Tableau Cloud Manager (TCM) 和托管租户的 Tableau Cloud pod 内必须唯一。
        - 只能包含 Unicode 字母、数字和字符 `!@$%*.?-_,'()&/:#`。
        - 不得超过 80 个字符。
    2. **站点 URI：**用户登录站点时输入的统一资源标识符 (URI)。
        
        - 在所有 Tableau Cloud pod 中必须唯一。
        - 只能包含字母（`A-Z`、 `a-z`）、数字（`0-9`）、连字符 (`-`)或下划线 (`_`)。
        - 必须以字母或数字开头和结尾。
    3. **地点位置：**Tableau Cloud 站点所在的区域或 pod。我们建议选择距离您的用户群最近的位置。
    4. **初始站点管理员：**初始站点管理员的电子邮件地址。若要访问站点的分析和设置，请将自己添加为初始站点管理员。可以稍后添加其他站点管理员。
4. 查看值并单击 “创造”。

初始站点管理员会收到一封电子邮件，其中包含登录站点的步骤。有关详细信息，请参见[登录 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm)。

### 修改站点身份验证

站点身份验证只能由站点管理员直接在站点级别进行配置。如果您是云管理员，您还必须拥有站点管理员权限才能更改身份验证设置。有关详细信息，请参见[为 Tableau Cloud 站点配置身份验证](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm#configure-site-auth)。

### 无法添加新站点

将站点添加到租户时，您会看到以下错误：

_“无法创建站点，因为没有可用容量。请编辑默认站点限制或自定义云限制，然后重试。”_

当没有足够的最小容量来创建新站点时，可能会出现此问题。租户上的每个站点都需要分配最小容量才能运行。若要解决此问题，请查看表格中的最低容量限制（由 Tableau 定义），并为新站点提供更多可用容量。

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>容量类型</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>最小容量限制</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取 API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">订阅并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">1</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">发布 API&nbsp;</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">5</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">流程并发</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">VizQL Data Service API</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">0</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">可视化项（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">10</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Pulse 摘要（如果使用基于容量的模型获得许可）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">0</td></tr></tbody></table>

若要腾出更多可用容量，请考虑从其他站点转移容量以腾出更多未分配容量。

1. 以云管理员身份登录到 [Tableau Cloud Manager](https://cloudmanager.tableau.com/)。
2. 在左侧中导航窗格中，转至“容量”页面。
3. 在“容量”页面上，单击“自定义站点限制”按钮。
4. 确定具有您可腾出的容量的站点和容量类型。
5. 输入一个值或选择容量类型旁边的向下箭头按钮以减少容量限制。
6. 完成后，单击“保存”。

通过自定义容量限制腾出一些容量后，再次添加新站点。有关添加站点的详细信息，请参见[添加、重命名、删除或激活站点](#)。

## 重命名站点

您可以重命名站点以反映组织更改。重命名站点会更新站点统一资源标识符 (URI)，这会使现有站点引用无效。

**重要信息：**更改站点名称是一个破坏性过程，会影响对所有站点内容的访问。更改后，指示站点管理员和用户使用新的站点 URI 更新其书签、嵌入式视图和外部应用程序。

首先重命名测试站点以了解影响。测试可验证您的链接和应用程序是否正常工作，并让您有时间在重命名生产站点之前让用户做好准备。

若要重命名站点，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 在“站点”页面上，选择要重命名的站点。
3. 单击“操作”菜单或省略号图标 (**...**) 并选择“重命名”。
4. 填写“重命名站点”对话框中的字段：
    
    1. **新站点名称：**Tableau Cloud 站点的新名称。
        
        - 在 Tableau Cloud Manager (TCM) 和托管租户的 Tableau Cloud pod 内必须唯一。
        - 只能包含 Unicode 字母、数字和字符 `!@$%*.?-_,'()&/:#`。
        - 不得超过 80 个字符。
    2. **新站点 URI：**用户登录站点时输入的新 URI。此 URI 会自动更新以匹配新站点名称，但您可以输入自定义值。
        
        - 在所有 Tableau Cloud pod 中必须唯一。
        - 只能包含字母（`A-Z`、 `a-z`）、数字（`0-9`）、连字符 (`-`)或下划线 (`_`)。
        - 必须以字母或数字开头和结尾。
5. 查看值并单击 “重命名”。

## 删除站点

删除站点会立即停用该站点，并计划在 30 天后删除。在此期间，用户无法访问该站点，但您可以在 30 天内随时重新激活它。在继续删除之前，请确保站点管理员已通知内容所有者备份所有必要的工作簿和数据源。30 天期限过后，站点删除将不可逆转，并且所有已发布的内容将被永久移除。

**流涕是：**如果您意外删除了某个站点，请等待最多 24 小时以完成该操作，然后再尝试重新激活该站点。

若要删除站点，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航到“站点”页面，并选中要删除的站点旁边的复选框。
3. 单击“操作”菜单或省略号图标 (**...**) 并选择 “删除”。
4. 在确认对话框中，单击“删除”。将出现一条通知，指明该站点已被安排删除。

站点被安排删除后，它将反映“待删除”状态，并在删除后从 Cloud Manager 中的“站点”页面中移除。若要查看删除前的剩余天数，请将鼠标悬停在“状态”列中的信息图标上。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_sites_delete_info.png)

## 激活站点

云管理员可以在 30 天内激活计划删除的站点，以防止永久移除并确保持续可用性。

若要激活站点，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航到“站点”页面，并选中要激活的站点旁边的复选框。
3. 单击“操作”菜单或省略号图标 (**...**) 并选择“启用”。
4. 在确认对话框中，单击“激活”。

站点激活后，将呈现“活动”状态并可供用户再次访问。激活站点将保留所有现有工作簿和数据源，不会发生任何更改。

### 用户激活和站点角色

激活站点时，用户将恢复到站点计划删除之前所拥有的角色。如果可用的许可证不足，例如在暂停状态下其他站点消耗许可证时，则会添加用户，直到可用许可证数量用尽为止。任何剩余的用户均未获得该站点的许可。

若要为受影响的用户授予许可，请跨站点调整站点角色限制。有关详细信息，请参见[管理站点角色限制](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_site_role_limit.htm)。

<!-- document id=bdef2d9f6058acef5c5e8f9ca0b60b4a92f9d57738d331d70897358c5c6db881 url=/tableau/next/zh-cn/online/custom_projectimage.md -->

[跳转到主要内容](#main-content)

# 添加项目图像

为了帮助在 Tableau Cloud 上区分您管理的项目（并帮助您的用户找到它们），您可以添加出现在缩略图中的图像。您的图像必须满足以下要求：

- 必须可以使用 HTTPS 协议访问图像。不支持共享网络目录和相关协议（UNC、SMB、AFP、NFS 等）。Google Chrome 不支持项目图像的 HTTP 协议。
- 访问项目的所有用户至少必须具有目标图像的“只读”权限。
- 图像必须是常见的 Internet 格式：.jpg、png 或 gif。

![“自定义探索”页面，其中项目分为“IT”、“开发”、“客户解决方案”和“统计”。](/tableau/next/zh-cn/online/zh-cn/Img/custom_projectimage.png)

## 设置项目图像

1. 登录到 Tableau Cloud 上的站点。在您有权访问的“顶层项目”列表中，选择或导航到想要更新的项目。在此示例中，我们将向 Statistics 项目文件夹中添加一个图像。
    
    如果您不确定在何处查找子项目，请使用“浏览”下拉列表并选择“所有项目”。
2. 单击“详细信息”图标 (i) 打开“项目详细信息”对话框，然后单击“编辑”。
    
    ![项目详细信息页面，显示所有者、创建日期以及编辑、更改所有者和删除项目的选项。](/tableau/next/zh-cn/online/zh-cn/Img/custom_projectimage_2.png)
3. 在“关于”字段中，您可以输入项目说明（可选），例如“Global and US statistics”（全球和美国统计数据）。在项目说明的结尾，使用以下语法添加图像的 URL：
    
    `!http://www.example.com/image.png!`
    
    ![项目详细信息页面，显示全球和美国的统计数据，并提供项目详细信息和编辑选项。](/tableau/next/zh-cn/online/zh-cn/Img/custom_projectimage_3.png)
    
    选择“显示格式设置提示”以查看可以如何设置说明文本的格式。
    
    **注意：**无法调整项目说明中嵌入的图像的大小或位置。建议大小为（300 x 184 像素）。非 300 x 184 像素的图像可能会被拉伸、缩小或裁剪以适应缩略图的宽度。此外，必须在项目说明结尾添加图像，并将其括在 **!** （感叹号）中，否则图像将不会显示为缩略图。
4. 单击“保存”。
    
    ![“自定义探索”页面，其中项目分为“IT”、“开发”、“客户解决方案”和“统计”。](/tableau/next/zh-cn/online/zh-cn/Img/custom_projectimage_4.png)

<!-- document id=4127205d0a28a6d12406467ec7b7dbfa9ef4d4e68266955d654803906f11eaa0 url=/tableau/next/zh-cn/online/projects_add.md -->

[跳转到主要内容](#main-content)

# 添加项目并将内容移至其中

Tableau 内容（例如工作簿或数据源）必须在项目中。从 Tableau Server 2022.3 和 Tableau Cloud 2022 年 10 月版开始，如果 Data Management 获得许可并启用 Catalog，外部资产（例如数据库和表）也可以在项目中。服务器和站点管理员可在站点中添加或移除项目，并且可以将已发布的内容从一个项目移动到另一个项目。具有适当站点角色的项目主管可以添加或删除子项目，并且可以在项目主管可访问的项目之间移动内容。

本文包含创建和移动项目的步骤。我们建议还要熟悉以下相关内容：

- 要了解项目以及何时或为什么要使用它们，请参阅[使用项目管理内容访问权限](https://help.tableau.com/v0.0/online/zh-cn/projects.htm)。
- 在创建项目层次结构之前，请熟悉[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#projectpermissions)。
- 若要了解允许完全项目主管访问权限的特定站点角色，请参见[项目级管理](https://help.tableau.com/v0.0/online/zh-cn/projects.htm#project-admin)。

## 添加顶级或子级（嵌套）项目

1. 在以管理员或项目主管身份登录到 Tableau Cloud 时，选择“浏览”，然后执行以下操作之一：
    
    - 选择“新建”\>“项目”以创建新的顶层项目（只有管理员才能执行此操作）。
    - 导航到并打开要在其中创建子项目的项目，然后选择“新建”\>“项目”。如果您不确定在哪里可以找到子项目，请从“浏览”旁边的下拉菜单中选择“所有项目”，或者使用右上角的筛选器。
2. 输入项目的名称和说明，然后单击“创建”。
    
    ![新的项目对话框，其中包含项目名称和描述的字段。](/tableau/next/zh-cn/online/zh-cn/Img/projects_new1.png)
    
    您可以在项目说明中包含设置格式和超链接。为语法选择**“显示格式设置提示”**。您还可以[添加项目图像](https://help.tableau.com/v0.0/online/zh-cn/custom_projectimage.htm)。
    
    输入项目描述时，请在大写字母和括号之间添加一个空格以显示其中的内容，例如“PROJECT (a)”。省略此空格将导致项目描述中出现显示问题。
    
    **注意：**若要稍后编辑项目说明，请选择该项目将其打开，选择其名称旁边的信息图标，然后单击“**编辑”**。

## 使用项目树导航项目

默认情况下，“浏览”窗格会显示一个项目树，以帮助您轻松导航项目。您可以使用项目树查找项目文件夹中的子项目。您还可以使用项目树来搜索项目。  

![Tableau Cloud 中浏览窗格上的项目树。](/tableau/next/zh-cn/online/zh-cn/Img/Cloud_ProjectTree.png)  

您可以通过单击位于“浏览”窗格上的项目树图标来隐藏和取消隐藏项目树。  
  
![Tableau Cloud 中浏览窗格上的项目树图标。](/tableau/next/zh-cn/online/zh-cn/Img/Cloud_ProjectTreeIcon.png)  

> [!TIP]
> 
> **注意：**为确保项目树可见，请在“浏览”页面上保持浏览器窗口宽度至少为 1441 像素。较窄的窗口（1440 像素或更小）或分辨率较低的显示将隐藏项目树。

## 将资产移到另一个项目

1. 在“浏览”部分，查找要移动的资产。您可以使用右上角的筛选器进行搜索，也可以在项目层次结构中导航。
2. 在工作簿的“操作”(...) 菜单上，选择“移动”。
3. 为工作簿选择新项目，然后单击“移动内容”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/projects_move_project.png)
    
    移动项目会移动其中的所有内容，包括子项目及其资产。

### 移动项目对权限有何影响

当您移动项目时，项目主管权限会适应新的项目环境。

- 当目标项目层次结构处于**“锁定”**状态时，以前的项目主管权限会被删除，并且会根据目标层次结构顶层设置的内容授予新项目主管权限。
- 当目标项目层次结构为**“可自定义”**时，以前隐式授予的项目主管权限会被删除，显式设置的项目主管权限会被保留，并且会根据目标层次结构顶层设置的内容授予新项目主管权限。

移动项目和资产时，权限可能会受到影响。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#moveproject)。

## 删除项目

删除项目时，该项目中的所有 Tableau 内容也将被删除。如果要删除项目但不删除其内容，请将内容移到另一个项目，然后删除该项目。

数据库和表等外部资产并没有被删除，而是被移动到“外部资产默认项目”中。（在 Tableau Server 2022.3 及更低版本中，可以在外部资产中找到这些资产。）

**重要信息**

- 您无法撤消删除项目。
- 删除项目会删除其中的所有内容，包括子项目及其内容，但不会删除外部资产。
- 您不能删除默认项目或外部资产默认项目。

要删除项目，请执行以下操作：

1. 在“浏览”部分，查找要移除的项目。如果您不确定在哪里可以找到项目，请从“浏览”旁边的下拉菜单中选择“所有项目”，或者使用右上角的筛选器。
2. 在项目的“操作”(...) 菜单上，选择“删除”。
3. 确认您想要删除项目。

## 移动资产的要求

移动资产实际上就像将其从一个项目中移除并将其发布到另一个项目。对于非管理员，源项目上所需的权限与目标项目上所需的权限不同。

### 所需站点角色

若要移动资产，用户必须具有以下站点角色之一：

- 服务器管理员（仅限 Tableau Server）
- 站点管理员 Creator 或站点管理员 Explorer
- Creator 或 Explorer（可发布）

具有服务器管理员或站点管理员站点角色的用户不需要任何其他能力。

### 对用户将内容移动_到_的项目所需的权限

非管理员必须对目标项目具有“发布”权限能力。

### 对用户_从中_移动内容的项目所需的权限

非管理员用户必须

- 是原始项目的项目所有者、项目主管或内容所有者
    
    或者
- 具有内容的“移动”权限能力（或者，对于数据源，必须是数据源所有者）。当移动数据库及其表时，用户必须具有数据库_以及_其表的“移动”能力。

有关移动资产的详细信息，请参见[移动内容](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#MoveContent)。

<!-- document id=ea3b7878fbb4c284969db023cff53ff368d40c12fec5b54aac4a8f14c7afe98d url=/tableau/next/zh-cn/online/to_signin.md -->

[跳转到主要内容](#main-content)

# 登录 Tableau Cloud

您可以从 Tableau _客户端_登录到 Tableau Cloud。客户端的示例包括 Web 浏览器、Tableau Desktop、Tableau Bridge，以及 Tableau Mobile。您可以直接登录到您的站点，也可以通过网页中嵌入的 Tableau 视图登录。

本主题介绍如何登录到 Tableau Cloud 站点。有关如何以云管理员身份登录 Tableau Cloud Manager 的信息，请参见[登录 Tableau Cloud Manager](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_signin.htm)。

> [!WARNING]
> 
> **带有 MFA 的 Tableau 用户的登录变更**  
> 从 2024 年 4 月开始，在 Tableau Cloud 登录页面输入您的用户名后，登录过程会将您重定向到 Tableau 提供商登录页面，您可以在其中输入密码。这一更改将为您提供跨 Tableau 平台的其他产品和服务的更无缝登录体验。有关详细信息，请参见[对于包含“带有 MFA 的 Tableau”的站点](#signin_mfa)。

## 登录选项和步骤

根据站点管理员设置 Tableau Cloud 站点的方式，您将使用以下方式之一进行登录（这些方式也称为_身份验证_类型）：

- **单点登录**
    
    单点登录 (SSO) 意味着您的管理员已设置 Tableau Cloud 站点，以便您可以使用用于公司中的其他应用程序的相同用户名和密码（_凭据_）。
    
    使用 SSO 时，您的凭据由第三方_身份提供程序_ (IdP) 在 Tableau Cloud 外部进行管理。输入您的凭据登录 Tableau Cloud 时，是 IdP 让 Tableau Cloud 知道您是经过批准的用户。
- **带有 MFA 的 Tableau**
    
    当通过 Tableau 身份验证（也称为 TableauID）启用多重身份验证 (MFA) 时，您可以结合使用 TableauID 凭据和验证方法来访问 Tableau Cloud。
    
    TableauID 凭据由用于访问 Tableau Cloud 站点的电子邮件地址和密码组成。利用这些凭据，您还可以访问 Tableau 网站上的其他内容（例如白皮书）。您可以在注册 MFA 后选择一种验证方式。有关详细信息，请参见[注册多重身份验证](#mfa_register_user)。
    
    - **Tableau**
        
        如果 Tableau 尚未更新您的站点以要求带有 MFA 的 Tableau，您可以继续暂时使用此身份验证类型。

### 如何知道您的站点使用何种类型的凭据

如果您的站点设置为使用单点登录 (SSO) 凭据，则站点管理员一般会通知您；您使用的用户名和密码与用于登录到组织中的其他应用程序的用户名和密码相同。

如果您的站点未针对 SSO 进行设置，您可以使用带有 MFA 的 Tableau 登录您的站点。在这种情况下，您会收到一封访问该站点的电子邮件邀请。单击电子邮件中的链接时，您可以创建密码。该电子邮件地址和密码将成为您的 TableauID。然后，系统会提示您注册至少一种验证方法，用于在您每次登录时确认您的身份。

如果您不确定站点的设置方式或者要使用哪些凭据，请咨询您的 Tableau Cloud 站点管理员。

### 登录（包括 Tableau Cloud URL）

根据您的登录位置，执行以下操作之一：

<table style="width: 90%; margin-left: 0; margin-right: auto;" class="simple-table"><colgroup><col style="width: 30%;"><col></colgroup><tbody><tr><td><strong>从以下位置登录时：</strong></td><td><strong>执行以下操作：</strong></td></tr><tr><td>Web 浏览器</td><td>在地址栏中输入 Tableau Cloud URL：<strong>https://online.tableau.com</strong></td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>，以便发布或访问内容</td><td>选择<span class="uicontrol">“服务器”</span>&gt;<span class="uicontrol">“登录”</span>，并输入 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> URL：http://online.tableau.com</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>，用于登录到 Tableau Bridge</td><td>选择<span class="uicontrol">“服务器”</span>&gt;<span class="uicontrol">“启动 Tableau Bridge 客户端”</span>。</td></tr><tr><td>Tableau Mobile 应用</td><td>点按<span class="uicontrol">“登录”</span>，然后点按<span class="uicontrol">“连接到 Tableau Cloud”</span>。</td></tr></tbody></table>

**注意：**如果使用 TableauID，则必须将网络配置为在从客户端应用程序登录时允许访问所需的 Tableau Cloud 域。有关详细信息，请参见 Tableau 帮助中的[服务器的证书不受信任错误](https://help.tableau.com/current/pro/desktop/zh-cn/sign_in_server.htm#certificate_error)。

#### 对于具有 SSO 的站点

1. 在 Tableau Cloud 登录页面上，输入您的电子邮件地址，然后单击“登录”。
    
    如果您只被添加到一个站点，您将被定向到身份提供程序的登录表单。再次输入您的用户名和密码。第三方将对您进行身份验证，并将您定向回 Tableau Cloud。
2. 如果您已被添加到具有 SSO 的多个站点，请输入您要访问的站点的站点_统一资源标识符 (URI)_，然后单击“继续”。
    
    自 2022 年 1 月起，需要站点 URI 来维护站点隐私。站点 URI 是 Tableau Cloud 站点的唯一标识符，并在进行身份验证后显示在站点 URL 中。例如，站点名称“Company X”可能在 URL 中显示为 `https://us-east-1.online.tableau.com/#/site/companyx`。对于站点 URI，您可以输入“companyx”。
    
    为避免记住您的站点 URI，您可以在浏览器中为站点 URL 添加书签，以快速重定向到该 Tableau Cloud 站点并向其进行身份验证。
    
    ![Tableau 站点 URI 登录窗口。](/tableau/next/zh-cn/online/zh-cn/Img/to_signin_multisite.png)
    
    **注意：**如果您不记得站点 URI，请单击“忘记 URI”并按照说明验证您的电子邮件地址。五分钟内仅发送一个验证码，因此如果您没有看到来自 Tableau 的电子邮件，请务必检查您的垃圾邮件文件夹。请务必正确输入验证码，因为多次错误尝试可能会导致验证码过期。验证后，您将被重定向到与您的用户名关联的站点列表。在此客户端上，30 天内您无需再次验证您的电子邮件地址。

#### 对于包含“带有 MFA 的 Tableau”的站点

从 2024 年 4 月开始，在 Tableau Cloud 登录页面输入您的用户名后，登录过程会将您重定向到 Tableau 提供商登录页面，您可以在其中输入密码。这一更改将为您提供跨 Tableau 平台的其他产品和服务的更无缝登录体验。

**注意：**如果在防火墙或代理后面访问 Tableau Cloud 时出现登录问题，请参见[从防火墙或代理后面访问 Tableau Cloud 时出现多个错误](https://help.salesforce.com/s/articleView?id=001473224&type=1)知识文章以获取更多信息。

1. 在 [Tableau Cloud 登录](https://online.tableau.com/)页面上，输入您的用户名（电子邮件地址），并单击“登录”。您将被重定向到 https://identity.idp.tableau.com/login。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/to_sigin_siteSAML_page.png)
2. 在 https://identity.idp.tableau.com/login 页面上，输入您的密码，并再次单击“登录”。您将被重定向到 https://verify.salesforce.com/v1/verify。
    
    **注意：**您无法在 https://identity.idp.tableau.com/login 页面上更改您的用户名。如果您输入了错误的用户名或无法登录，请返回初始 [Tableau Cloud 登录](https://online.tableau.com/)页面，然后重试。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/to_signin_tabid_page.png)
3. 请按照 Tableau Cloud 提示使用您在 MFA 注册期间选择的验证方法验证您的身份。
    
    举例来说，如果您将 Salesforce 身份验证应用程序注册为验证方法，您会看到以下提示。
    
    ![手机显示使用身份验证器应用程序的 Salesforce 登录信息。](/tableau/next/zh-cn/online/zh-cn/Img/sf_auth_prompt.png)
    
    1. 通过转到您的移动设备并点击推送通知来响应提示。
        
        ![适用于 Tableau 的 Salesforce 身份验证器。](/tableau/next/zh-cn/online/zh-cn/Img/sf_auth_notification.png)
    2. 验证请求详细信息是否正确，然后点击“批准”。验证您的身份后，您将被重定向到您的 Tableau Cloud 站点。
        
        ![适用于 Tableau 的 Salesforce 身份验证器。](/tableau/next/zh-cn/online/zh-cn/Img/sf_auth_approve.png)
    
    **注意：**
    
    - 如果您是第一次登录 Tableau Cloud 或注册 MFA，请参见[注册多重身份验证](#mfa_register_user)部分。
    - 如果您在仅注册了一种验证方法（内置验证器、安全密钥或恢复码）的情况下登录 Tableau Cloud，您将被重定向以注册一种附加的备份验证方法。
4. 如果您的站点管理员已将您添加到多个 Tableau Cloud 站点，请从与您提供的凭据关联的可用站点列表中选择一个站点。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/to_signin_sitepicker.png)

### 注销

若要注销，请在任意页面的右上角中选择您的显示名称，然后选择“注销”。

![选择了“注销”选项的下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/to_signout.png)

如果您的站点使用单点登录，并且您未看到“注销”链接，请关闭浏览器选项卡或窗口。如果您的站点和管理公司用户信息的身份提供程序未配置为支持单点注销，“注销”链接不会出现。

## 记住您的登录凭据

如果希望 Tableau Cloud 记住您的用户名，请在登录页面上选择“记住我”。下次登录时，Tableau 会输入您的用户名。您仍然需要键入您的密码。

对于具有 SSO 身份验证的站点，Tableau 也会记住您的用户名并设置默认站点。下次登录时，Tableau 会输入您的用户名并将您重定向到 IdP 进行身份验证，而不提示您输入站点的 URI。

在这两种情况下，如果出现以下情况，默认站点将被替换：

- 您登录到不同的 Tableau Cloud 站点并再次选择“记住我”。
- 您使用深层链接（指向特定站点的 URL）来访问 Tableau Cloud，并在登录该站点时选择“记住我”。

若要让 Tableau 忘记您的用户信息，请使用 Web 浏览器删除 cookie。

### 连接的客户端

您的站点管理员可以选择允许从批准的 Tableau 客户端中直接登录。有关客户端的示例，请参见本主题的介绍。

当您从识别的客户端成功登录后，Tableau 会在安全令牌中存储您的凭据，此令牌会记住您的 Tableau Cloud 连接。采用此令牌后，您可以直接访问 Tableau Cloud 站点，而不必登录。

### 清除已保存的登录

- 如果想要从站点断开连接，则可以从连接的客户端中显式注销。例如，在 Tableau Desktop 中，选择“服务器”\>“注销”。
- 若要从 Tableau Desktop 中删除所有现有服务器连接，请选择“帮助”\>“设置和性能”\>“清除已保存的服务器登录”。

**注意：**站点管理员可以禁用存储用户站点连接的安全令牌。

## 在 Internet Explorer 中登录到嵌入式视图

当您浏览到具有嵌入式视图的网页时，您会在将显示视图的帧中看到登录按钮。如果您使用 Internet Explorer (IE)，并且在输入您的凭据之后，登录按钮没有替换为视图，则浏览器安全设置可能正在阻止访问视图。

IE 使用安全区域来确定网站访问级别。若要在 IE 中显示 Tableau 嵌入式视图，可以将您访问的网站和 Tableau Cloud 地址添加到正确的安全区域中。

### 将 Web 地址添加到 IE 安全区域中

1. 在 Internet Explorer 中，浏览到包含 Tableau 视图的网站。
2. 单击“工具”按钮，然后选择“Internet 选项”。
3. 在“安全”选项卡上，将网站添加到适当的安全区域中，如下所示：
    
    - 如果包含 Tableau 视图的站点在组织内部，请选择“本地 Intranet”，单击“站点”，然后单击“高级”。如果那里还没有该站点，则将其添加到“网站列表”中。
    - 如果该站点在组织外部，请选择“受信任的站点”，单击“站点”，并将其添加到“网站”列表中。
4. 添加 Tableau Cloud：
    
    选择“受信任的站点”，在“将该网站添加到区域”框中，输入“\*.online.tableau.com”。
5. 单击“添加”，然后单击“关闭”。

这些步骤摘自 Microsoft Windows 网页[安全区域：添加或删除网站](http://windows.microsoft.com/zh-cn/windows/security-zones-adding-removing-websites)。

**注意：** 单击提供的链接将离开 Tableau 网站。尽管我们尽最大努力确保外部网站的链接保持正确、最新并相关，但 Tableau 对于外部提供商所维护的页面的准确性或新鲜度不担负任何责任。请与外部网站联系来获取其内容相关问题的答案。

## 注册多重身份验证

为了帮助确保帐户安全，从 2022 年 2 月 1 日开始，多重身份验证 (MFA) 成为 Tableau Cloud 的一项要求。为了满足该要求，可能已启用带有 Tableau 身份验证的 MFA。如果启用了 MFA，则您必须至少注册一种验证方法，以便在您每次登录 Tableau Cloud 时确认您的身份。**注意：**如果您将 Tableau Desktop 或 Tableau Bridge 与 Tableau Cloud 结合使用，则必须运行版本 2021.1 及更高版本。

MFA 是一种安全的帐户身份验证方法，它要求您在登录 Tableau Cloud 时通过提供两条或更多条验证信息（也称为“因素”）来证明您的身份。第一个因素是您用于登录 Tableau Cloud 的用户名和密码（即您的 TableauID 凭据）。附加因素是由身份验证程序应用软件生成的代码，例如 Salesforce Authenticator 或第三方基于时间的一次性密码 (TOTP) 应用软件。

若要比较支持的验证方法并查看使用要求，请参见 Salesforce 帮助中的[多重身份验证的验证方法](https://help.salesforce.com/articleView?id=sf.mfa_supported_verification_methods.htm)主题。

**重要信息：**

- 在大多数情况下，Tableau Cloud 的验证方法是您需要在手机上安装的移动身份验证程序应用软件。
- 从**Tableau Desktop**、**Tableau Prep Builder**、**Tableau Bridge** 和 **Tableau 内容迁移工具**对 Tableau Cloud 进行身份验证时，**不能**使用支持 WebAuthn 或 U2F 和内置身份验证器的安全密钥。
- 仅在注册初始验证方法集后，您才可以使用恢复代码选项。

注册 MFA

1. 使用您的用户名和密码登录到 Tableau Cloud。系统会提示您注册 MFA。
2. 选择验证方法。
    
    例如，单击“Salesforce Authenticator”。
    
    ![有四种验证方法可供选择的 Tableau 页面。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_methods_prompt.png)
3. 按照 Tableau Cloud 对话框中的步骤将选定的验证方法与您的 Tableau Cloud 帐户相关联。
    
    举例来说，如果您在步骤 2 中选择了 Salesforce Authenticator 应用软件，系统会提示您执行以下操作：
    
    1. 在 iOS 或 Android 移动设备上，从 App Store 或 Google Play 下载并安装免费的 Salesforce Authenticator 应用软件。
    2. 在移动设备上，应用软件安装完成后，打开应用软件并点按“添加帐户”。
    3. 在 Tableau Cloud 中的对话框中输入应用软件中的两个词短语，然后单击“连接”。
        
        ![包含有关连接到 Salesforce 身份验证器的说明的 Tableau 表单。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_methods_sfauth_prompt.png)
4. 为了完成登录过程，Tableau Cloud 会提示您通过移动设备上的身份验证器应用程序批准请求。接受请求即表示您在验证您的身份。然后您将被重定向到您的站点。
    
    举例来说，如果使用 Salesforce Authenticator 验证方法，请执行以下操作：
    
    1. 当 Tableau Cloud 向您显示以下提示时，响应移动设备上的推送通知。
        
        ![显示 Salesforce 身份验证器登录界面的手机屏幕。](/tableau/next/zh-cn/online/zh-cn/Img/mfa_desktop_prompt.png)
    2. 在 Salesforce 身份验证器应用程序中，验证请求详细信息是否正确。
    3. 点按“批准”。您将被重定向到您的站点。

### 管理验证方法

开始使用 MFA 后，您可以通过在 Tableau Cloud 的“我的帐户设置”页面中单击“管理 MFA 验证方法”链接来管理验证方法。

在此页面上，您可以添加或移除其他验证方法，包括恢复码。举例来说，如果您获得了新手机，则删除旧手机上的任何验证方法。如果您无法通过将您的身份验证程序应用软件配置从备份中还原到您的新手机来复制它，您必须重新安装并注册一个身份验证程序应用软件。有关详细信息，请参见[管理您的帐户设置](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm)。

![](/tableau/next/zh-cn/online/zh-cn/Img/mfa_methods_manage.png)

### 关于恢复码 - 仅限紧急情况

为了帮助降低锁定场景的风险，我们建议您在注册 MFA 后添加“恢复码”作为备份。如果您无权访问常用的 MFA 验证方法，则仅在紧急情况下使用的恢复码允许您登录 Tableau Cloud。如果您添加恢复码选项，则会为您生成一个包含十个一次性使用代码列表，您可以使用这些代码登录 Tableau Cloud。

**重要信息：** 

- 由于添加了“恢复码”选项后无法访问恢复码列表，因此请立即复制这些代码并将其存储在安全可靠的位置，以便您可以在紧急情况下使用它们。
- 不应将恢复码用作您的主要验证方法。相反，只有当您无法访问常用的 MFA 验证方法时，才应在紧急情况下使用恢复码。

### 在被锁定后重新获得站点访问权限

**重要信息：**我们强烈建议您添加“恢复码”选项以帮助避免被锁定在您的站点之外。恢复码应仅在紧急情况下使用。

如果您丢失了所有常用的 MFA 验证方法，您必须联系您的 Tableau Cloud 站点管理员并请求重置您的 MFA 验证方法。重置 MFA 验证方法后，请按照[注册多重身份验证](#mfa_register_user)中的步骤再次注册 MFA。

<!-- document id=b266f10b21efe480bc4be9dade1e76bb8d26bf354c41d35286231bfe4f0be4e3 url=/tableau/next/zh-cn/online/cloud_manager_signin.md -->

[跳转到主要内容](#main-content)

# 登录 Tableau Cloud Manager

云管理员可以从 Tableau Cloud 登录页面登录 Tableau Cloud Manager (TCM)。如果您有权访问多个资源（例如站点或租户），则可以在经过身份验证后通过站点选择器菜单在它们之间导航。当您被添加为云管理员后，您会收到一封电子邮件，其中包含访问 TCM 的链接。有关添加用户的详细信息，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)。

## 登录选项和步骤

根据 Tableau Cloud Manager (TCM) 的设置方式，您将使用以下方式之一以云管理员身份登录（也称为_身份验证_类型）：

- **单点登录**
    
    单点登录 (SSO) 意味着 TCM 被设置为使用您用于公司中其他应用程序的相同用户名和密码（凭据）。
    
    使用SSO，您的凭据由第三方身份提供程序 (IdP) 在 Tableau 之外进行管理。登录 TCM 时，是 IdP 让 Tableau 知道您是经过批准的用户。TCM 支持通过 Google，OIDC、Salesforce 和 SAML 进行身份验证。

- **带有 MFA 的 Tableau**
    
    当通过 Tableau 身份验证（也称为 TableauID）启用多重身份验证 (MFA) 时，您可以结合使用带有 MFA 的 Tableau 凭据和验证方法来访问 TCM 。
    
    TableauID 凭据由用于访问 TCM 的电子邮件地址和密码组成。利用这些凭据，您还可以访问 Tableau 网站上的其他内容（例如白皮书）。您可以在注册 MFA 后选择一种验证方式。有关详细信息，请参见[注册多重身份验证](#mfa-register-user)。

### 如何知道 TCM 使用何种类型的凭据

如果 Tableau Cloud Manager (TCM) 设置为单点登录 (SSO) 凭据，云管理员会通知您，您可以使用与登录组织中其他应用程序相同的用户名和密码。

如果 TCM 未设置 SSO，您可以使用带有 MFA 的 Tableau 登录。在这种情况下，您会收到一封访问 TCM 的电子邮件邀请。单击电子邮件中的链接时，您可以创建密码。该电子邮件地址和密码将成为您的 TableauID。然后，系统会提示您注册至少一种验证方法，用于在您每次登录时确认您的身份。

### 登录 Tableau Cloud Manager

根据身份验证类型执行以下操作之一：

#### 对于 SSO

1. 在 [ableau Cloud Manager 登录](https://cloudmanager.tableau.com/)页面上，输入您的电子邮件地址，然后单击“登录”。
2. 输入要访问的 Tableau Cloud Manager (TCM) 的统一资源标识符 (URI)，然后单击“继续”。您将被定向到身份提供程序的登录表单以完成身份验证。
    
    URI 是 TCM 的唯一标识符，并在进行身份验证后显示在 URL 中。例如，https://**cloudmanageruri**.cloudmanager.tableau.com。为了快速重定向并向 TCM 进行身份验证，请将 URL 加入书签。
    
    **注意：**如果您不记得 Cloud Manager URI，请单击“忘记 URI”并按照说明验证您的电子邮件地址。五分钟内只能发出一个验证码。如果您没有看到电子邮件，请检查垃圾邮件文件夹中是否有来自 Tableau 的消息。请务必正确输入验证码，因为多次错误尝试可能会导致验证码过期。验证后，您将被重定向到显示与您的用户名相关联的 TCM 和站点的列表。在此客户端上，30 天内您无需再次验证您的电子邮件地址。

#### 对于带有 MFA 的 Tableau

1. 在 [Tableau Cloud Manager 登录](https://cloudmanager.tableau.com/)页面上，输入您的电子邮件地址和密码，然后单击“登录”。
2. 输入要访问的 Tableau Cloud Manager (TCM) 的统一资源标识符 (URI)，然后单击“继续”。
3. 输入您的密码，并再次单击“登录”。
4. 若要完成登录过程，请按照 Tableau Cloud 提示使用您在 MFA 注册期间选择的方法验证您的身份。
    
    - 如果您是第一次登录 TCM 或注册 MFA，请参见[注册多重身份验证](#mfa-register-user)。
    - 如果您在登录 TCM 时只注册了一种验证方法（内置验证器、安全密钥或恢复代码），系统将提示您注册其他备用验证方法。

### 注销

若要注销，请在任意页面的右上角中选择您的显示名称，然后选择“注销”。

![](/tableau/next/zh-cn/online/zh-cn/Img/to_signout.png)

如果 Tableau Cloud Manager (TCM) 使用单点登录，并且您没有看到注销选项，请关闭浏览器标签页或窗口。如果TCM和管理公司用户信息的身份提供程序未配置为支持单点注销，则不会显示注销链接。

## 记住您的登录凭据

如果希望 Tableau Cloud 记住您的用户名，请在登录页面上选择“记住我”。这将在您下次登录时填充您的用户名，但您仍需要输入密码。

对于 SSO 身份验证，Tableau 会记住您的用户名并设置默认的 Tableau Cloud Manager (TCM)。当您再次登录时，您的用户名将被填充，并且您会被重定向到 IdP 进行身份验证，而不会提示您输入 Cloud Manager URI。

在这两种情况下，如果出现以下情况，默认 TCM 将被替换：

- 您登录到不同的 TCM 并再次选择“记住我”。
- 您使用深层链接（指向特定页面的 URL）来访问 Tableau Cloud，并在登录该 TCM 时选择“记住我”。

若要让 Tableau Cloud 忘记您的用户信息，请清除 Web 浏览器的 Cookie。

## 注册多重身份验证

为了帮助确保帐户安全，多重身份验证 (MFA) 是所有 Tableau Cloud 帐户的必需安全措施。启用 MFA 后，每次登录 Tableau Cloud Manager 时，必须注册至少一种身份确认验证方法。

MFA 是一种安全的帐户身份验证方法，它要求您在登录 Tableau Cloud 时通过提供两条或更多条验证信息（也称为“因素”）来证明您的身份。第一个因素是您用于登录 Tableau Cloud 的用户名和密码（即您的 TableauID 凭据）。附加因素是由身份验证程序应用软件生成的代码，例如 Salesforce Authenticator 或第三方基于时间的一次性密码 (TOTP) 应用软件。

若要比较支持的验证方法并查看使用要求，请参见 Salesforce 帮助中的[多重身份验证的验证方法](https://help.salesforce.com/articleView?id=sf.mfa_supported_verification_methods.htm)。

重要信息：

- 在大多数情况下，Tableau Cloud 的验证方法是您必须在手机上安装的移动身份验证程序应用软件。
- 仅在注册初始验证方法集后，您才可以使用恢复代码选项。

注册 MFA：

1. 使用您的用户名和密码登录到 Tableau Cloud Manager。系统会提示您注册 MFA。
2. 选择验证方法。
    
    例如，单击“Salesforce Authenticator”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/mfa_methods_prompt.png)
3. 按照对话框中的步骤将选定的验证方法与您的 Tableau Cloud 帐户相关联。
    
    举例来说，如果您在步骤 2 中选择了 Salesforce Authenticator 应用软件，系统会提示您执行以下操作：
    
    1. 在 iOS 或 Android 移动设备上，从 App Store 或 Google Play 下载并安装免费的 Salesforce Authenticator 应用软件。
    2. 在移动设备上，应用软件安装完成后，打开应用软件并点按“添加帐户”。
    3. 在 Tableau Cloud 中的对话框中输入应用软件中的两个词短语，然后单击“连接”。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/mfa_methods_sfauth_prompt.png)
4. 为了完成登录过程，Tableau Cloud 会提示您通过移动设备上的身份验证器应用程序批准请求。接受请求即表示您在验证您的身份。然后您将被重定向到 Tableau Cloud Manager。
    
    举例来说，如果使用 Salesforce Authenticator 验证方法，请执行以下操作：
    
    1. 当 Tableau Cloud 向您显示以下提示时，响应移动设备上的推送通知。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/mfa_desktop_prompt.png)
    2. 在 Salesforce 身份验证器应用程序中，验证请求详细信息是否正确。
    3. 点按“批准”。您将被重定向到 Tableau Cloud Manager。

<!-- document id=58946c3fd9f74c50c44345cbc908143542ee83b838641af3f2a0ee5a34c5e36d url=/tableau/next/zh-cn/online/grant_role.md -->

[跳转到主要内容](#main-content)

# 登录时授予许可证

登录时授予许可证（登录时授予角色）允许特定组中的未授权用户在登录到 Tableau 站点时获得许可。这简化了管理员的许可证预配，并且用户不再需要在使用 Tableau 之前请求许可证。

有关站点角色能力的详细信息，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。

例如，假设您的公司在“市场营销”组中有 100 人，但只有 25 名成员需要访问 Tableau Cloud。Tableau Cloud 站点管理员不确定哪 25 人需要 Tableau。该管理员可以创建具有 Explorer 最低站点角色的“市场营销”用户组，选择“登录时授予角色”，并将所有 100 名“市场营销”成员添加到该组。“市场营销”组中的 25 个 Tableau 用户在登录到其 Tableau Cloud 站点时，将预配 Explorer 许可证，而不是为整个组预配许可证。不需要 Tableau Cloud 的用户除非登录，否则将保持未许可状态。

**注意**：有关优势和最佳做法的详细信息，请参见 Tableau Blueprint 中的[登录时授予角色](https://help.tableau.com/current/blueprint/zh-cn/bp_license_management.htm#grant-role-on-sign-in)，Tableau Blueprint 是 Tableau 适用于数据驱动型组织的规划工具。

## 激活“登录时授予角色”

可以为新组或现有组启用“登录时授予角色”。以下步骤将演练如何使用“登录时授予角色”来添加新有资格获得许可证但可能未使用许可证的新用户。当您的公司拥有大量符合条件的用户，但 Tableau 许可证有限时，情况可能如此。

1. 在站点上，添加一个新组：
    
    1. 从导航窗格中，单击**“安全组”**，然后单击“新建组”。
    2. 输入组名称。
        
        ![“新建组”表单，其中包含组名称、按需访问和许可用户的选项。](/tableau/next/zh-cn/online/zh-cn/Img/online_new_group.png)
    3. （可选）如果您的站点已获得[基于使用情况的模型](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#embedded-analytics-usagebased-license-model)的许可，请选中“允许按需访问”复选框。
        
        有关详细信息，请参见以下内容之一：[使用具有直接信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)或[使用具有 OAuth 2.0 信任的连接应用程序进行按需访问](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm)。
    4. 选择“登录时授予角色”，并为组选择最低站点角色。此设置意味着许可证和站点角色将仅预配给登录到此 Tableau Cloud 站点的组用户。
    5. 单击“创建”。
2. 通过单独输入用户名（电子邮件地址格式）或使用 CSV 文件批量导入用户，将用户添加到站点。
    
    如果批量添加用户，请按照通过您使用[CSV 导入文件准则](https://help.tableau.com/v0.0/online/zh-cn/csvguidelines.htm)创建的 CSV 文件[导入用户](https://help.tableau.com/v0.0/online/zh-cn/users_import.htm)中的步骤操作。
    
    ![站点管理员可以通过电子邮件添加用户或从文件导入。](/tableau/next/zh-cn/online/zh-cn/Img/users_add_online.png)
    
    如果按用户名添加用户，请执行以下操作
    
    1. 在“用户”页面上，单击“添加用户”按钮。
    2. 输入用户名（电子邮件地址格式）。有关在添加用户时分配 Google、OIDC、SAML ，或 Salesforce 身份验证的信息，请参见[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)。
        
        如果添加多个用户，请用分号 (;) 分隔用户名。
        
        例如，_tdavis@example.com; jjohnson@example.com; hwilson@example.com_
    3. 将这些用户的站点角色设置为“未许可”。
    4. 单击“添加用户”。
3. 将那些新的未许可用户添加到新组。
    
    - 从左侧的导航窗格中，单击**“组”**，然后单击组的名称。
    - 在组的页面中，单击**“添加用户”**。
        
        ![显示“添加用户”按钮的组页面。](/tableau/next/zh-cn/online/zh-cn/Img/groups_addusers.png)
    - 选择要添加的用户，然后单击**“添加用户”**。

有关详细信息，请参见[创建组并向其中添加用户](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm)。

## 使用“登录时授予角色”修改用户角色

如果用户是使用“登录时授予角色”的组的成员，则无论用户是否登录，都无法将该用户角色设置为未授权或降级为低于为组设置的最低站点角色的角色。但是，管理员可以手动升级用户的站点角色。

若要降级用户的站点角色，或从站点中取消许可用户，请从启用了“登录时授予角色”的组中移除用户。

根据[最终用户许可协议](https://mkt.tableau.com/legal/tableau_eula.pdf)的条款，基于“授权用户”授予的许可证可以永久重新分配给新用户。只有当用户将永久停止以较高角色访问服务器软件时，才能将他们降级为较低的站点角色（包括“未许可”）。

## 移除受“登录时授予角色”影响的用户

只有在用户未拥有任何内容的情况下，您才能从站点中移除该用户。如果尝试移除拥有内容的用户，则会将用户站点角色设置为“未许可”并从所有组中移除，但不会从站点中移除用户。若要移除内容所有者，请从启用了“授予站点角色”的组中移除所有者，或将内容所有权重新分配给其他用户。有关详细信息，请参见[查看、管理或移除用户](https://help.tableau.com/v0.0/online/zh-cn/users_view.htm)帮助主题中的“从站点中移除用户”。

如果默认的“所有用户”组已启用“授予站点角色”，则无法从站点站中移除内容所有者用户，或取消这些用户的许可。若要移除或取消许可这些用户，请将内容所有权重新分配给其他用户，然后移除或取消许可用户。

Tableau REST API 可用于重新分配工作簿的内容所有权。有关详细信息，请参见 REST API 帮助中的 [Update Workbook（更新工作簿）](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#update_workbook)。REST API 还可用于从站点中移除用户，并将其内容所有权转让给其他用户。有关详细信息，请参见 REST API 帮助中的 [Remove User from Site（从站点中移除用户）](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_users_and_groups.htm#remove_user_from_site)方法。

有关在 Tableau Cloud 中重新分配内容所有权的详细信息，请参见[管理内容所有权](https://help.tableau.com/v0.0/online/zh-cn/owner.htm#change-the-owner-of-a-content-resource)。

<!-- document id=5fd86c615544822eeea3bee68203edabdfd10fe4620523c14ef6055603e491e2 url=/tableau/next/zh-cn/online/prep_conductor_monitor_flow.md -->

[跳转到主要内容](#main-content)

# 监视流程运行状况和性能

在发布 Tableau Prep 流程并计划定期运行流程后，您希望知道它们正在按预期运行，并在任何问题出现时加以解决。您还需要监视、了解流程的性能并排查其问题。

需要帮助对流程进行故障排查？请参见 [Tableau Prep Builder 疑难解答](https://help.tableau.com/current/prep/zh-cn/prep_troubleshoot.htm)。

本主题介绍 Tableau Cloud 提供的各种方法来帮助您监视 Tableau Prep 流程并排查其问题。

## 在问题出现时检测问题并加以解决

在 Tableau Cloud 中，当流程失败时会自动发送电子邮件通知。您还可以使用“警报”菜单或通过查看您感兴趣的流程k的流程页面来查找和查看服务器上的错误。这种类型的监视允许您在问题发生时检测它们。

### 在流程失败时收到通知：

Tableau Cloud 中默认情况下已为您的站点启用电子邮件通知。可通过转到“**设置**”>“**常规**”页面来验证这一点。

### 查看和解决错误

**注意**：从版本 2020.4.1 开始，您现在可以直接在 Tableau Server 和 Tableau Cloud 中创建和编辑流程。 除非特别指出，此部分中的内容适用于所有平台。有关在 Web 上制作流程的详细信息，请参见[Web 上的 Tableau Prep](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm)。

运行流程时可能会发生以下错误：

- **连接错误：**当 Tableau Cloud 无法连接到一个或多个数据输入或无法在一个或多个输出步骤中建立连接时，通常会发生连接错误。
    
    - 对于输入连接错误，请使用“连接”选项卡上的“编辑连接”选项对连接详细信息进行更改，然后再次运行流程。
    - 对于输出连接错误，请检查流程输出步骤的输出位置。如果流程输出进入网络共享，请确保输出步骤指向安全列出的位置。进行任何更改后，重新发布流程并尝试再次运行。
        
        **注意**：若要修复输出到文件或网络共享的流程的输出连接错误，请将流程下载到 Tableau Prep Builder，然后将流程重新发布到服务器。输出到已发布数据源或数据库的流程可以直接在 Web 上编辑。
- **流程中的错误：**如果流程中一个或多个步骤中存在错误，您将看到一条错误消息。您可以直接在 Web 上编辑流程并重新发布它。您也可以将流程下载到 Tableau Prep Builder，解决错误，将流程重新发布到服务器并则再次运行流程。
- **流程任务挂起：**当计划的流程任务运行失败配置的尝试次数后，流程任务将挂起。默认情况下，流程任务会在连续失败 5 次后挂起。
    
    可以为流程分配多个计划任务，但只会挂起失败的任务。所有其他流程任务将继续运行，除非它们有错误。若要解决挂起的任务，请查看并解决错误，然后按需运行流程，或者让流程基于分配的计划自动运行。

您可以在以下页面上查看错误：

#### “流程概述”页面

在此页面上，您可以看到最近的流程运行的状态，以及任何错误。将光标悬停在错误文本上可查看错误详细信息。如果计划任务已挂起，则计划旁边会显示一个警告图标。将鼠标指针悬停在图标上以查看状态。

解决了导致流程失败或任务挂起的错误之后，您可以手动运行流程，或让流程基于分配的计划运行。对于挂起的流程任务，在挂起的任务的工具提示上单击“转到挂起的任务”链接，导航到“计划任务”页面，并单击“恢复计划任务”按钮恢复挂起的任务。

![标题为“Tableau Prep Crane”的数据集的流程显示一条错误消息：“步骤‘输出’的增量刷新失败”。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_overview_error.png)

#### “连接”页面

“**连接**”页面显示最近的状态和任何相关连接错误。若要纠正输入错误，请单击输入连接的“更多操作”![“更多选项”菜单选项由 3 个点表示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_rmoremenu.png) 菜单，编辑连接并更改服务器名称、端口、用户名和密码。

若要修复输出连接错误，请直接编辑流程，或在 Tableau Prep Builder 中下载流程，更正文件路径，然后重新发布流程以继续运行。

![连接详细信息，其中包含一条错误消息，指出“用户名或密码不正确”。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_connections_error.png)

#### “计划任务”页面

**注意**：需要 Data Management 才能看到此选项卡。

查看分配给流程的计划任务。如果计划任务已挂起，您可以在此查看该任务的状态，并且可以手动从此页面恢复流程任务。恢复挂起的任务之前，请解决流程中的任何错误。

此页面上未显示错误详细信息，但您可以在“概述”或“运行历史记录”页面上查看这些错误。您还可以单击“计划类型”列中的链接以查看计划内容的详细信息并编辑任务。

如果为流程编辑连接或手动运行流程任务，则挂起的计划任务将在重新发布流程时自动恢复。若要手动恢复挂起的任务，请在“计划任务”页面上单击“恢复计划任务”。 这将恢复流程的所有已挂起任务。

若要恢复单独的任务，请单击计划任务的“更多操作”![“更多选项”菜单选项由 3 个点表示。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_rmoremenu.png) 菜单，然后选择“恢复”。也可以单击“立即运行”以立即运行流程的所有任务。

![数据流的计划任务及其状态的列表。](/tableau/next/zh-cn/online/zh-cn/Img/prep_linked_tasks_schedule_error.png)

#### “运行历史记录”页面

**注意**：需要 Data Management 才能看到此选项卡。

“运行历史记录”页面显示每个输出已完成或正在进行的所有流程运行的详细信息。通过将鼠标光标悬停在“**错误**”列中的错误上来查看任何错误详细信息。持续时间列显示流程的运行时间。

**注意**：从版本 2020.2.1 开始，“运行类型”字段显示输出的刷新类型。在以前的版本中，此字段显示输出是按计划运行还是按需运行。有关设置输出刷新类型的详细信息，请参见[使用增量刷新来刷新流程数据](https://help.tableau.com/current/prep/zh-cn/prep_incremental_refresh.htm)。

![Tableau Prep 运行历史记录。](/tableau/next/zh-cn/online/zh-cn/Img/prep_server_runhistory.png)

#### 通知

流程失败时，通知菜单中将会出现错误详细信息，并包含用于重新运行流程或下载流程进行故障排查的选项。

**注意**：流程所有者和站点管理员可以看到此菜单。

![“通知”对话框，显示错误详细信息和通知菜单选项，用于重新运行流程或下载流程进行故障排除。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_server_alerts.png)

### 谁可以执行此操作

- **Tableau 站点管理员：**
    - 在站点级别设置电子邮件通知
    - 查看错误
    - 恢复挂起的任务
    - 查看通知
- **流程所有者、项目主管和被授予流程查看权限的任何用户**：
    - 查看错误
    - 恢复挂起的任务
    - 查看通知（流程所有者）

## 此部分中的其他文章

<!-- document id=f18f2d0ca668bd2378896a608a7cfc6ae97a6d6a2f8093883801bfbdab7deacb url=/tableau/next/zh-cn/online/to_adminview_section.md -->

[跳转到主要内容](#main-content)

# 监视站点活动

使用这些预构建的管理视图和数据源监视站点使用情况和活动。

- **管理视图：**可从“状态”页面访问的一组嵌入式仪表板。这些仪表板显示有关您站点上正在发生的事情的近乎实时的信息。您可以使用这些仪表板查看站点活动，但无法更改或订阅它们。

- **在线管理见解：**在站点上的“在线管理见解”项目中发布的数据源和起始模板工作簿。数据每天更新，可用于为您的组织构建自定义管理仪表板。

若要审核数据的安全性或进行自定义分析，请使用这些附加功能获取租户和站点事件日志。

- **Tableau Cloud Manager (TCM) REST API：**平台数据方法获取租户和站点事件日志。具有云管理员角色的用户可以使用任何能够进行 API 调用的客户端访问这些事件。有关详细信息，请参见 TCM REST API 参考中的[平台数据](https://help.tableau.com/current/api/cloud-manager/zh-cn/docs/platform_data.html)。
- **活动日志：**活动日志将站点事件日志发送到 Amazon Simple Storage Service (S3) 存储桶进行分析。若要使用活动日志，您必须拥有 Amazon Web Services (AWS) 帐户、用于接收数据的 Amazon S3 存储桶以及 AWS Key Management Service (KMS) 密钥。有关详细信息，请参见[活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm)。

## 此部分中的其他文章

<!-- document id=a5777d09236ce0bbf517930ccbfb4f8b6bfbb5716fea4f899ffb712d6e942b40 url=/tableau/next/zh-cn/online/to_connected_clients.md -->

[跳转到主要内容](#main-content)

# 从连接的客户端中访问站点

默认情况下，Tableau Cloud 允许用户直接从 Tableau _客户端_中访问其站点。在用户首次从客户端中登录时提供凭据之后，它将允许进行这种访问。在这种情况下，客户端是指可与 Tableau Cloud 交换信息的 Tableau 应用程序或服务。Tableau 客户端的示例包括 Tableau Desktop、Tableau Prep Builder、Tableau Bridge 和 Tableau Mobile。

Tableau Cloud 通过创建安全 刷新令牌来建立_连接的客户端_，该令牌在用户从客户端中登录时唯一地标识用户。

### Tableau Bridge 的已连接客户端要求

站点的默认_已连接客户端_选项必须保持启用状态，以允许 Tableau Bridge 客户端在无人值守的情况下运行，并且如果启用，则支持多重 Tableau 身份验证。如果为站点禁用了已连接客户端，则 Bridge 只能支持 Tableau 用户名和密码身份验证。

**注意：**如果通过 Tableau 身份验证启用了多重身份验证 (MFA)，则 Bridge 客户端必须运行 Tableau Bridge 版本 2021.1 及更高版本。有关使用 MFA 的 Tableau 的详细信息，请参见[关于多重身份验证和 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/security_auth.htm#mfa_requirement)。

## 关于刷新令牌过期

连接的客户端会话由 刷新令牌管理。从连接的客户端成功登录 Tableau Cloud 后会生成刷新令牌。如果刷新令牌在 14 天内未使用，则它将过期。刷新令牌过期后，需要从连接的客户端重新登录 Tableau Cloud。

如果刷新令牌会定期使用，其有效期取决于站点的激活时间。在 2023 年 6 月 (Tableau 2023.2) 或更高版本激活的站点上生成的刷新令牌将在 180 天后过期。所有其他站点上生成的刷新令牌将在一年后过期。

刷新令牌过期后，用户必须从连接的客户端登录才能重新建立与 Tableau Cloud 的经过身份验证的连接。

## 选择不允许连接的客户端

站点管理员可以禁用此功能，以要求用户在每次访问 Tableau Cloud 时显式登录。

如果在站点上启用了 SAML，并且您希望在从 IdP 的 SAML 目录移除了用户后用户无权访问 Tableau Cloud，则建议不要允许连接的客户端。

1. 使用站点管理员凭据登录到 Tableau Cloud。
2. 选择“设置”，然后选择“身份验证”选项卡。
3. 在“连接的客户端”下面，清除“允许客户端自动连接到此 Tableau Cloud 站点”复选框。

如果选择不使用连接的客户端，请记住以下几点：

- 一些客户端提供了“保存我的信息”复选框，用户可以选中该复选框以记住他们的用户名。用户始终需要提供其密码。
- 对于配置为使用 SAML 身份验证进行单点登录的站点，用户可在首次登录后直接访问站点。如果用户未通过选择“注销”链接显式注销，则可以这样做。

## 移除用户的已连接客户端

举例来说，如果用户不再是站点的成员，或者出现已超过用户帐户中最大客户端数的相关消息，则站点管理员可移除与特定用户关联的客户端（刷新令牌）。

1. 选择“用户”，并在“站点用户”页面上选择用户显示名称上的链接。
2. 在该用户的页面上，选择“设置”选项卡。
3. 在“连接的客户端”部分，移除相应的客户端。

用户也可以转到其自己的“我的帐户设置”页面来移除特定客户端。

## 监控刷新令牌的使用情况

如果您有包含 Advanced Management 的Tableau Cloud，您可以使用活动日志来监控刷新令牌的使用情况。活动日志中捕获刷新令牌使用情况的事件包括但不限于：颁发令牌、兑换令牌和撤销。有关这些事件的详细信息，请参见[活动日志站点事件类型参考](https://help.tableau.com/v0.0/online/zh-cn/activity_log_schema.htm)。

## 另请参见

[登录 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_signin.htm)

[OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm)

<!-- document id=52fada18c8bbecea2e211bec371ea8990a32a6c817665dc38001b3f46f6c7769 url=/tableau/next/zh-cn/online/publishing_sharing_authentication.md -->

[跳转到主要内容](#main-content)

# 设置凭据以访问您发布的数据

将工作簿发布到 Tableau Cloud 或 Tableau Server 时，您可以将它连接到的数据源发布为工作簿部分（_嵌入_到工作簿中）或发布为单独的独立数据源。此外，如果要发布的数据源需要身份验证，则可以自定义凭据的获取方式。

数据源的身份验证类型与人员登录到 Tableau Cloud 或 Tableau Server 站点的方式无关。例如，若要为人员提供工作簿中的数据的直接访问权限，应该将数据库用户凭据嵌入到数据源的连接中。但查看工作簿的任何人仍需要能够登录到 Tableau Cloud 或 Tableau Server 上的站点以打开工作簿。

本主题描述如何在发布过程中针对数据连接设置身份验证。

**注意：** 本主题不适用于不需要身份验证的连接，如文本文件或 Excel 文件。

## 设置身份验证类型

您可以为多种连接类型嵌入数据库用户的名称和密码，或者使用单点登录 (SSO)。本主题后面描述了特定例外。

以下步骤描述如何在发布数据源或工作簿过程中设置身份验证。您可以为数据源中的每个连接执行此操作。

1. 在“发布工作簿”对话框中，转到“数据源”区域（该区域列出工作簿的连接），并选择“编辑”。
2. 在“管理数据源”弹出窗口中确定是要单独还是在工作簿中发布数据源之后，请为数据源中的每个连接选择身份验证类型。可用身份验证类型取决于连接类型，并且可能包括以下一种或多种类型：
    - 提示用户：当视图或工作簿加载时，用户必须输入其自己的数据库凭据才能访问已发布的数据。
    - 嵌入式密码：您连接到数据所使用的凭据将与连接一起保存，并且访问您发布的数据源或工作簿的每个人都将使用此凭据。
    - 服务器运行身份帐户：将使用单一 Kerberos 服务帐户来验证用户的身份。在 Windows 上，这是 Tableau Server 的运行身份帐户。在 Linux 上可以是任何 Kerberos 帐户。
    - Viewer（查看者）凭据：使用 SSO（通常为 Kerberos）将 Viewer（查看者）的凭据传递到数据库。
    - 使用嵌入式帐户模拟或使用服务器运行身份服务帐户模拟：使用嵌入式凭据的模拟通过嵌入式凭据进行连接，然后切换到 Viewer（查看者）的身份（仅适用于支持这一点的数据库）。使用运行身份服务帐户的模拟与之类似，但首先通过 Kerberos 服务帐户进行连接，然后再切换到 Viewer（查看者）的身份。
    - “未启用刷新”或“允许刷新访问权限”：当您发布云数据的数据提取时，例如从 Salesforce 中发布时，将会显示这些选项，并且需要提供数据库凭据以访问基础数据。“允许刷新访问权限”会在连接中嵌入凭据，以便您可以按定期计划设置该数据提取的刷新。

**重要信息：**您想要如何刷新提取的数据也是因素之一。

- 如果要设置自动刷新计划，则必须将密码嵌入连接中。
- 如果您发布与 Tableau Cloud 的云数据连接，则发布步骤将提示您是否必须将 Tableau Cloud 添加到数据提供程序的授权列表。
- 无法发布依据 Kerberos 委派的行级别安全数据源创建的数据提取。

### Dropbox、OneDrive 连接

对于 Dropbox 和 OneDrive，当您发布数据源或工作簿并选择“嵌入式密码”时，Tableau 将创建保存的凭据，并将其嵌入数据源或工作簿。

### 从工作簿连接至 Tableau 数据源

当您发布连接到 Tableau Cloud 或 Tableau Server 数据源的工作簿，而不是设置用于访问基础数据的凭据时，可以设置工作簿是否可以访问它所连接到的已发布数据源。无论原始数据类型是什么，服务器数据源的选择始终嵌入了密码或者会提示用户。

如果您选择提示用户，则打开工作簿的用户必须对数据源具有“查看”和“连接”权限才能查看数据。如果选择嵌入密码，则用户可以看到该工作簿中的信息，即使他们没有“查看”或“连接”权限也不例外。

### 虚拟连接

截至 Tableau Cloud 和 Tableau Server 2022.3 及 Tableau Desktop 2022.4，当您发布 Tableau 内容（如使用虚拟连接的数据源或工作簿）并选择“嵌入密码”或“嵌入凭据”时，内容的查看者将拥有您连接和查询虚拟连接的权限。但是，任何与虚拟连接相关的数据策略总是使用查看者的身份进行评估，而不是您的身份。

例如，您发布一个使用虚拟连接的工作簿。若要让工作簿的查看者通过虚拟连接来连接到和查询数据，请嵌入连接到和查询虚拟连接的权限。然后，与虚拟连接相关联的任何数据策略都会阻止工作簿的查看者访问任何敏感数据。

在评估是否可以查看和访问虚拟连接中的表时，将使用内容创建者的身份。但是，在评估与虚拟连接中的表相关联的任何数据策略时，会使用查看者的身份。内容创建者只能将连接权限嵌入到虚拟连接中，而不是编辑权限。

如果选择不嵌入权限，则只有有权访问工作簿或数据源以及有权连接虚拟连接的用户才能访问工作簿或数据源。

虚拟连接的嵌入密码和嵌入凭据选项在 Tableau Cloud 2022.2、Tableau Server 2022.1 和 Tableau Desktop 2022.3 及更低版本中不起作用。如果您在升级到 2022.3（对于 Tableau Cloud 和 Tableau Server）或 2022.4（对于r Tableau Desktop）之前选择了这些选项，升级后这些选项将按预期工作。然后，您可以嵌入查询虚拟连接的权限。

## 另请参见

- 如果发布到 Tableau Server，请参见 Tableau Server 帮助中的[编辑连接](https://help.tableau.com/current/server/zh-cn/help.htm#connections_modify.htm)。
- 如果发布到 Tableau Cloud 并且工作簿连接到 Salesforce、Google Analytics、Google Sheets、Google BigQuery、OneDrive、Dropbox 和 QuickBooks Online 数据，请参见 Tableau Cloud 帮助中的[使用保存的凭据刷新数据](https://help.tableau.com/current/online/zh-cn/to_fresh_data_saved_credentials.htm)。
- 如果您是想要详细了解身份验证的 Tableau Server 管理员，请参见 Tableau Server 帮助主题“身份验证”([Windows](https://help.tableau.com/current/server/zh-cn/security_auth.htm) | [Linux](https://help.tableau.com/current/server-linux/zh-cn/security_auth.htm))以及“数据连接身份验证”([Windows](https://help.tableau.com/current/server/zh-cn/security_data_connection_auth.htm) | [Linux](https://help.tableau.com/current/server-linux/zh-cn/security_data_connection_auth.htm))。

<!-- document id=aeb0b4e8bb702e68926ace9759070c324d84e9897eb38508b9c1c3982bfccc03 url=/tableau/next/zh-cn/online/cmt-scripting_migration_example.md -->

[跳转到主要内容](#main-content)

# 示例：编写迁移计划脚本

**注意：**本主题包括一个示例脚本，您可以以其为基础来编写可满足您的需求和环境要求的多计划迁移脚本。此脚本仅用作示例，而不是按原样运行。有关运行控制台运行程序的详细说明，请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。

可以使用用于运行迁移的 Tableau Content Migration Tool 命令行实用工具，通过外部计划程序（例如 Windows 任务计划程序）或自定义脚本来自动运行迁移计划。控制台运行程序一次仅运行一个迁移计划（存储在 .edt 文件中）。如果有一组要成组运行的迁移计划，则可以将自定义脚本与 Content Migration Tool 控制台运行程序结合使用。

下面的示例使用 PowerShell 编写，并使用控制台运行程序来成组执行一系列迁移计划。

下面的示例代码演示了：

- 使用控制台运行程序成组运行多个迁移计划。
- 根据需要在组中的任何单个迁移失败时立即停止部署一组计划。
- 使用控制台运行程序的退出代码确定迁移是否失败或记录了警告。

\# List of migration plans to execute as a group.
$planFiles = @(
	'customer 1.tcmx',
	'customer 2.tcmx'
)

# True of false whether to continue with the next plan if a migration fails.
$continueOnFailure = $false
			
# Path to the CMT console runner executable
$runnerExe = 'C:\\Program Files (x86)\\Tableau\\Tableau Content Migration Tool\\tabcmt-runner.exe'

# Store the exit code from the previously run migration plan.
$lastResult = -1
			
# Loop through and run each migration plan one at a time.
$planFiles | % {
	$file = $\_
			
	if ($lastResult -ge 2 -and -not($continueOnFailure)) {
		Write-Warning "Skipping plan because previous migration failed. \`nSkipped plan: $file"
		return
	}
			
	Write-Verbose "Running migration plan: $file"
	& $runnerExe $file
       $lastResult = $LASTEXITCODE
 
 	if ($lastResult -ge 2) {
		Write-Error "Migration failed. See output or log file for error details.\`nPlan: $file" -ErrorAction 'Continue'
	}
	elseif ($lastResult -eq 1) {
		Write-Warning "Migration completed with warnings. See output or log file for warning details.\`nPlan: $file"
	}
}

## 谁可以执行此操作

为了编写迁移计划脚本，您必须具有以下所有各项：

- Content Migration Tool 计算机上的管理员权限。
- 具有 Explorer 角色或更高级别角色的 Tableau 站点用户帐户。
- 源站点上的“查看和下载工作簿”/“保存副本”权限。
- 目标站点的“发布”权限。

<!-- document id=da8a1628dd2b5fbb20b97af17db2b15e5338de423b7a9d35ddf0f95cea1c0749 url=/tableau/next/zh-cn/online/private_connect.md -->

[跳转到主要内容](#main-content)

# 私人连接

私人连接使用 AWS PrivateLink 在您的网络环境和 Tableau Cloud 之间提供安全、私有的专用连接。通过完全经由私有地址空间路由流量，您的数据永远不会遍历公共互联网。这种网络隔离有助于满足严格的安全策略和合规性法规，例如 GDPR、HIPAA 和 CCPA。

## 出站私人连接

出站私人连接允许用户安全地从 Tableau Cloud 连接到云托管数据提供程序。它将数据流量限制到专用网络，并且不再需要使用 Tableau Bridge 等其他工具，从而可简化架构。建立连接后，Creator 只需使用一个特殊的连接地址，就像使用标准数据库连接一样。

有关详细信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)。

## 入站私人连接

入站私人连接可保护从组织网络流向 Tableau Cloud 的流量。它支持通过专用连接进行的标准交互，包括 Web 浏览器访问、Tableau Desktop 发布、Tableau Bridge 连接和 API 调用。这会将您的分析数据、用户会话和登录页面与公共 Web 完全隔离。

有关详细信息，请参见[入站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound.htm)。

## 此部分中的其他文章

<!-- document id=abe8c5c6722bd7e11764953efbf6bd5b34d3aa33e0192b780b56bdfb29e72435 url=/tableau/next/zh-cn/online/to_site_startup.md -->

[跳转到主要内容](#main-content)

# 站点管理员角色和任务

本主题介绍 Tableau Cloud 站点管理员的典型角色，以及它与相关数据管理员角色之间的区别。然后，它列出了网站管理员设置 Tableau Cloud 站点所需完成的核心任务。本部分中的其他主题提供了有关每个步骤的详细信息。

## 我们如何定义站点管理员角色

我们将站点管理员定义为负责创建和维护框架的人员，利用此框架，您组织中的 Tableau Desktop 用户可以发布、共享、管理和连接到数据源和工作簿。例如，与直接使用发布到站点的内容相比，站点管理员使用站点用户及其权限。

Tableau Cloud 站点管理员通常是组织中 IT 团队的成员。如果您的组织没有正式的 IT 团队，则站点管理员可能是担任此角色的专业 Tableau Desktop 用户（可以说是_临时管理员_）。

### 通常在管理员范围之外的任务

在本文档中，我们区分了站点管理员角色与数据管理员角色，后者是创建数据源并将其发布到 Tableau Cloud 的人员的角色。即便如此，在您的组织中，同一个人可能会担任这两个角色。实际上，您将采用最适合您的环境的方法来划分这些责任。若要了解有关数据管理员职责范围的更多信息，请参见[发布数据源和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#publish_overview.htm)。

## 您的站点设置步骤

下表显示了用于设置站点的非严格步骤顺序。您可以按照对您有意义的任何顺序完成步骤。在本主题的底部，您将发现每个步骤的更多资源的链接列表。

在配置站点之前，建议了解站点身份验证选项、用户的站点角色、项目以及权限。创建并记录您的项目、组和总体权限策略的计划。设置测试项目以试验不同的设置是解决这些问题的好方法。在您的用户使用该站点之后，您可以更改许多站点设置，但是请尝试以尽量减少后期制作更改为意图。

<table style="width: 90%; margin-left: 0; margin-right: auto;" class="simple-table"><colgroup><col><col></colgroup><thead><tr><td><strong>上载您的徽标</strong></td><td><p>当您将您的组织品牌纳入到您的站点时，此简单的第一步有助于您熟悉环境。登录、转到<span class="uicontrol">“设置”</span>页，并在指示处上载您的徽标。</p></td></tr></thead><tbody><tr><td><strong>配置站点访问</strong></td><td><p>如果您的组织使用单点登录，您可以将您的站点配置为使用 Google 或 SAML 身份验证。否则，您可以使用默认的 Tableau ID 身份验证，在此身份验证中，每个用户均使用 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 所特有的电子邮件地址和密码进行登录。</p><p>除了确定身份验证类型之外，您还可以确定首次登录后是否允许用户直接从 Tableau <em>客户端</em>登录。默认情况下允许这么做。</p></td></tr><tr><td><strong>创建项目</strong></td><td><p>项目有助于您管理用户对发布到站点的数据源和工作簿的访问（权限）。您可以对<span class="uicontrol">“默认”</span>项目上的所有内容设置默认组和权限、锁定项目，然后使用它作为模板来创建其他项目。</p><p>项目也可以用作临时环境。</p></td></tr><tr><td><strong>设置权限结构</strong></td><td><p>在 Tableau 中，权限与站点角色一起组成用户对站点及其内容的访问权限。</p></td></tr><tr><td><strong>添加用户</strong></td><td><p>每个访问 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 的用户都必须登录。确定希望其能够登录站点的用户。如果您启用了 Google 或 SAML 身份验证，请确定这些用户中哪些将使用其单点登录凭据登录，哪些将使用 TableauID 凭据登录。</p><p>根据用户的身份验证类型同时添加或导入多个用户。</p></td></tr><tr><td><strong>使数据进入<span class="mc-variable Variables.ProductName variable">Tableau Cloud</span></strong></td><td><p>我们建议您指定将审核的数据源发布到站点的 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 用户（即，谁将担任前面提到的数据管理员角色）。这些数据源将是其他 Tableau 用户可以连接到的共享数据源。</p><p>作为站点管理员，您可以集中管理数据源权限。您或数据管理员可以集中维护的其他属性是云数据源的连接信息（凭据、访问令牌）和刷新计划。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm" class="xref">使数据保持最新</a>。</p></td></tr><tr><td><strong>分析站点使用情况和性能</strong></td><td>您可以监视已发布数据源和工作簿的使用量、数据提取刷新任务成功与否、用户活动等等。</td></tr></tbody></table>

## 此部分中的其他文章

<!-- document id=4c861bb2f66cab60c3ae1153d3c67f9613611e69fe71210d8a418e553c84b781 url=/tableau/next/zh-cn/online/sites_add.md -->

[跳转到主要内容](#main-content)

# 站点设置参考

使用以下设置为组织自定义站点。为了查看和编辑站点设置，您必须是 Tableau Cloud 上的站点管理员或 Tableau Server 上的服务器管理员。

站点设置在 Tableau Cloud 和 Tableau Server 中的显示方式不同。可用的设置取决于您的站点配置，以及您是使用 Tableau Cloud 还是 Tableau Server。若要查找下面的特定设置，请按 Ctrl+F (Windows) 或 Command+F (macOS) 并搜索设置。

## 访问站点设置

- (Tableau Cloud) 从主页中展开侧边窗格，然后单击底部的“设置”。
    
    ![带有设置选项的 Tableau Cloud 导航菜单。](/tableau/next/zh-cn/online/zh-cn/Img/site_settings_sidebar.png)
- (Tableau Server) 如果您要编辑现有站点，请在“站点”页面上选择它，然后选择**“编辑设置”**。或者，在单站点部署中，单击侧边窗格底部的“设置”。
    
    ![在 Tableau 站点上编辑设置。](/tableau/next/zh-cn/online/zh-cn/Img/sites_ms_edit.png)

## “常规”选项卡

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>站点名称和 ID（仅限 Tableau Server 管理员）</td><td>指定用户界面中显示的站点名称和在站点 URL 中显示的 ID。（如果编辑的是“默认”站点，则无法更改 ID。）<p>您无法更改 URL 的“#/site”部分（例如，http://localhost/#/site/sales）。在多站点服务器环境中，这些段出现在除“默认”站点之外的站点的 URL 中。</p></td></tr><tr><td>存储（仅限 Tableau Server 管理员）</td><td>选择<span class="uicontrol">“服务器限制”</span>或<span class="uicontrol">“GB”</span>，然后为后者输入所需的 GB 数作为已发布工作簿、数据提取和其他数据源的存储空间限制。<p>如果您设置了服务器限制但站点超过了该限制，则将阻止发布者上载新内容，直至站点再次低于该限制。服务器管理员可以使用站点页面上的“最大存储”和“已用存储”列来跟踪站点的限额使用情况。</p></td></tr><tr><td>修订历史记录（仅限 Tableau Server 管理员）</td><td>指定存储在服务器上的工作簿、流程和数据源的以前版本的数量。</td></tr><tr><td>Tableau Prep Conductor</td><td>控制具有适当权限的用户是否可以计划和监视流程。Tableau Prep Conductor 是 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 的一部分。有关详细信息，请参见 <a href="https://help.tableau.com/current/online/zh-cn/prep_conductor_online_intro.htm" target="_blank">Tableau Prep Conductor</a>。</td></tr><tr><td>Web 制作</td><td>控制是否为站点启用基于浏览器的制作。禁用工作簿的 Web 制作后，用户无法从服务器 Web 环境创建或编辑已发布的工作簿，而必须使用 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 重新发布工作簿。禁用流程的 Web 制作后，用户无法从服务器 Web 环境创建或编辑已发布的流程，而必须使用 <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> 重新发布流程。<p>有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/web_author_enable.htm" target="_blank">设置站点的 Web 制作访问权限和功能</a>。</p></td></tr><tr><td><a name="ManageUsers"></a>管理用户（仅限 Tableau Server 管理员）</td><td>确定是否只有服务器管理员才能添加和移除用户以及更改其站点角色，或者站点管理员也可以这样做。<p>如果您允许站点管理员管理用户，则可通过选择以下选项之一来指定他们可向站点添加多少用户：</p><ul><li>“服务器限制”添加可用服务器席位许可证的数量。对于使用基于内核的许可的服务器，没有限制。</li><li>“站点限制”允许站点管理员根据您指定的限制来添加用户。</li><li>“站点角色限制”允许站点管理员根据您为站点指定的许可证限制添加每个站点角色的用户。</li></ul><p>有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/view_licenses.htm" target="_blank">查看服务器许可证</a>。</p></td></tr><tr><td>来宾访问权限（仅限 Tableau Server 管理员）</td><td>允许缺少 Tableau Server 帐户的用户查看具有来宾访问权限的视图。<p class="note"><b>注意：</b>如果您使用 Tableau Server，管理员可以禁用“来宾访问权限”。</p></td></tr><tr><td>Tableau Catalog</td><td>当 Tableau Server 或 Tableau Cloud 站点获得 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 的许可时，请关闭 Catalog 功能。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/dm_catalog_enable.htm#disable-catalog" target="_blank">禁用 Catalog</a>。</td></tr><tr><td>计划刷新后的工作簿性能（仅限 Tableau Server 管理员）</td><td>预先计算最近查看的工作簿（包含已计划刷新），以更快地打开它们。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/perf_workbook_scheduled_refresh.htm" target="_blank">在计划刷新后配置工作簿性能</a>。</td></tr><tr><td>工作簿性能指标（仅限 Tableau Server 管理员）</td><td>允许站点用户收集有关工作簿性能的指标，例如加载速度。若要开始记录，用户还必须向工作簿的 URL 中添加参数。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/perf_record_create_server.htm" target="_blank">创建性能记录</a>。</td></tr><tr><td>托管密钥链清理（仅限 Tableau Server 管理员）</td><td>允许站点管理员管理站点上 OAuth 连接的已保存凭据密钥链。有关详细信息，请参见 <a href="https://help.tableau.com/current/server/zh-cn/protected_auth.htm#removing-unused-keychain-records" target="_blank">OAuth 连接</a>。</td></tr><tr><td>自动挂起数据提取刷新任务</td><td>为了节省资源，Tableau 可以自动挂起非活动工作簿的数据提取刷新任务。此功能仅适用于每周运行一次或更频繁运行的刷新计划。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/extract_auto_suspend.htm" target="_blank">自动挂起非活动工作簿的数据提取刷新</a>。</td></tr><tr><td><p>链接任务</p><p>（仅限 Tableau Server 和站点管理员）</p></td><td><p>使服务器管理员能够计划流程任务以逐个运行。它们还使用户能够使用<span class="uicontrol">“立即运行”</span>触发计划的流程任务运行。</p><p>此设置可在服务器级别应用以包括 Tableau Server 上的所有站点。可以在站点级别禁用该设置以仅包括特定站点。</p><p>如果在计划链接任务后关闭该设置，则任何正在运行的任务都将完成，并且计划的链接任务将隐藏并且不再显示在<span class="uicontrol">“计划任务”</span>选项卡上。</p><p>有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm#schedule-linked-tasks" target="_blank">计划链接任务</a>。</p></td></tr><tr><td>电子邮件设置（仅限 Tableau Server 管理员）</td><td>指定在通知和订阅的自动电子邮件中显示的“发件人”地址和消息页脚。</td></tr><tr><td>站点邀请通知（仅限 Tableau Cloud）</td><td>对于具有单点登录身份验证的站点，在将新用户添加到站点时发送邀请电子邮件。</td></tr><tr><td>站点徽标（仅限 Tableau Cloud）</td><td>指定与站点名称一起显示的图像。</td></tr><tr><td>开始页面</td><td>控制用户登录时显示的站点页面。默认情况下将显示主页，但您可以打开“所有项目”、“所有工作簿”或其他页面。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/maintenance_startpg.htm" target="_blank">设置默认开始页面</a>。<p class="note"><b>注意：</b>如果您使用 Tableau Server，管理员可以覆盖此站点设置。</p></td></tr><tr><td>Tableau Pulse - 部署（仅限 Tableau Cloud）</td><td>控制 Tableau Pulse 是否对所有用户、一组用户或无用户可用。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#site-setting">“为 Tableau Pulse 设置站点”</a>。</td></tr><tr><td><a name="pulse-digest"></a>Tableau Pulse - 摘要 - 允许用户接收电子邮件和 Slack 摘要及通知（仅限 Tableau Cloud）</td><td>控制用户是否可以通过不同渠道接收 Tableau Pulse 摘要和通知。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#digest-time">为 Tableau Pulse 设置站点</a>。</td></tr><tr><td>Tableau Pulse - 摘要 - 摘要开始时间（仅限 Tableau Cloud）</td><td>确定 Tableau Pulse 开始生成摘要的时间。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#digest-time">为 Tableau Pulse 设置站点</a>。</td></tr><tr><td>Tableau Pulse - 摘要 - 毎周和每月计划（仅限 Tableau Cloud）</td><td>确定生成每周和每月摘要的周中某日和月中某天。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#digest-time">为 Tableau Pulse 设置站点</a>。</td></tr><tr><td>Tableau 中的 AI (Tableau Cloud)</td><td><p>此部分包括多个设置，用于控制是否为 Tableau 功能启用生成式 AI。</p><p>一些生成式 AI 功能需要 Tableau+ 以及与设置了 Einstein 生成式 AI 的 Salesforce 组织的连接。有关如何启用 Tableau 中的 AI 功能的详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/setup_tabAI_site_setting.htm" target="_blank">为您的站点启用 Tableau 中的 AI</a>。</p><p>若要详细了解 Tableau 中的 AI，请参见 <a href="https://help.tableau.com/current/tableau/zh-cn/about_tableau_gai.htm" target="_blank">Tableau 中的 AI</a>。</p></td></tr><tr><td>Tableau 中的 AI (Tableau Server)</td><td><p>此部分包括多个设置，用于控制是否为 Tableau 功能启用生成式 AI。</p><p>此功能从版本 2025.3 开始提供，使您能够连接到您自己的大型语言模型 (LLM ) 提供商，以在 Tableau Server 中为 Tableau Web 制作和 Tableau Prep 启用 Tableau Agent。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/sites_gai_server.htm" target="_blank">在 Tableau Server 站点中启用 AI</a>。</p></td></tr><tr><td>个性化见解排名（仅限 Tableau Cloud）</td><td><p>控制用户是否可以对个人见解提供赞成或反对的反馈。当此设置打开并且用户提供反馈时，Tableau Pulse 见解平台将使用该反馈进一步个性化向用户显示的见解类型，并对其进行排名。</p><p>此设置与部署 Tableau Pulse 的设置无关。当个性化见解排名关闭时，用户将无法对个人见解提交赞成或反对的反馈。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm" target="_blank">为 Tableau Pulse 设置站点</a>中的“关闭个性化见解排名”。</p></td></tr><tr><td>用户可见性</td><td>控制其他用户可见的用户和组名称。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/user_visibility.htm" target="_blank">管理用户可见性</a>。</td></tr><tr><td>“数据问答”(Ask Data) 功能的可用性</td><td>控制是为数据源启用还是禁用“数据问答”(Ask Data) 功能。“数据问答”(Ask Data) 功能允许用户使用对话式语言查询数据，并自动查看可视化项。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/ask_data.htm" target="_blank">使用“数据问答”(Ask Data) 功能自动生成视图</a>。</td></tr><tr><td>“数据解释”功能的可用性</td><td>控制具有适当权限的站点用户是否能够运行“数据解释”功能，以及作者是否能够访问“数据解释”功能设置。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data_control_access.htm" class="xref">控制对“数据解释”功能的访问</a>。若要了解有关“数据解释”功能的详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/explain_data.htm" class="xref">使用“数据解释”功能更快地发现见解</a>。</td></tr><tr><td>自动访问有关数据库和表的元数据</td><td>使用派生权限自动向用户授予针对外部资产的某些功能。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/dm_perms_assets.htm#derived_checkbox" target="_blank">关闭派生权限</a>。</td></tr><tr><td>敏感世系数据</td><td>指定当用户对相关元数据没有适当的权限时，是否应敏感世系数据进行模糊处理或筛选。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/dm_perms_assets.htm#lineage_checkbox" target="_blank">敏感世系数据</a>。</td></tr><tr><td>跨数据库联接</td><td>确定在联接来自多个源的数据时在何处执行联接进程。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm#integration" target="_blank">合并不同数据库中的表</a>。</td></tr><tr><td>静态数据提取加密（仅限 Tableau Server 管理员）</td><td>当 .hyper 数据提取存储在 Tableau Server 上时，允许您对这些数据提取进行加密。服务器管理员可以对其站点上的所有数据提取强制执行加密，或者允许用户对与特定发布的工作簿或数据源关联的所有数据提取进行加密。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/security_ear.htm" target="_blank">静态数据提取加密</a>。</td></tr><tr><td>Tableau 支持访问权限（仅限 Tableau Cloud）</td><td>允许 Tableau 支持技术人员访问站点，以帮助对支持案例进行故障排除。默认情况下，此功能已禁用。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/enable_support_access.htm" target="_blank">启用支持访问权限</a>。</td></tr><tr><td>共享</td><td>允许用户直接与其他用户共享项目。共享项目时，收件人会收到通知，并且该项目将添加到其“与我共享”页面。如果未启用此功能，则用户只能复制要共享的链接。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/shareworkbooks.htm" target="_blank">共享 Web 内容</a>。</td></tr><tr><td>注释</td><td>控制用户是否可以在每个视图的“注释”侧边窗格中添加评论，并 @提及其他 Tableau 用户以通过电子邮件通知他们。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/comment.htm" target="_blank">向视图添加注释</a>。</td></tr><tr><td>数据驱动型通知</td><td>允许用户在数据达到关键阈值时自动接收电子邮件。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/data_alerts.htm" target="_blank">发送数据驱动型通知</a>。</td></tr><tr><td>订阅</td><td>允许站点用户订阅视图并接收视图的定期电子邮件。在 Tableau Server 上时，仅当您先<a href="https://help.tableau.com/current/server/zh-cn/subscribe.htm" target="_blank">配置了订阅设置</a>时，这些选项才可用。</td></tr><tr><td><p><a name="data-quality-warnings-in-subscriptions"></a>视图和工作簿订阅中的高可见性数据标签</p></td><td><p>控制订阅是否在电子邮件中包含相关的上游可见性数据质量警告和敏感度标签。在 Tableau Server 上，仅当您先<a href="https://help.tableau.com/current/server/zh-cn/subscribe.htm" target="_blank">启用并配置了订阅</a>时，这些选项才可用。有关数据质量警告的详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm" class="xref">设置数据质量警告</a>。有关敏感度标签的详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/dm_labels_sensitivity.htm" class="xref">敏感度标签</a>。</p><p>以前的标题为<span class="uicontrol">“订阅中的数据质量警告”</span>。</p><p class="note"><strong>注意：</strong>数据质量警告和敏感度标签是 Tableau Catalog 的一项功能，后者是 <span class="mc-variable Variables.DM_sku variable">Data Management</span> 的一部分。</p></td></tr><tr><td>标记</td><td>指定用户可以添加到项的标记数。默认限制为 50 个标记，最大为 200 个。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm" target="_blank">使用标记</a>。</td></tr><tr><td>视图建议</td><td>控制建议是否显示在站点上，以及查看推荐项目的用户的姓名是否在建议工具提示上显示。<p class="note"><strong>注意：</strong>如果您使用 Tableau Server，管理员可以禁用建议。</p></td></tr><tr><td>请求访问权限</td><td>允许用户向内容或项目所有者发送访问请求。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/Request_access.htm" target="_blank">允许站点用户请求内容访问权限</a>。</td></tr><tr><td>指标内容类型</td><td>控制指标在站点上是否可用。启用指标后，用户可以通过视图创建指标，并且指标显示为内容类型。关闭后，指标不会出现在站点上或继续同步。如果再次启用指标，预先存在的指标将重新出现并恢复刷新。有关详细信息，请参见 <a href="https://help.tableau.com/current/online/zh-cn/metrics_admin.htm" target="_blank">Tableau Cloud 帮助</a>或 <a href="https://help.tableau.com/current/server/zh-cn/metrics_admin.htm" target="_blank">Tableau Server 帮助</a>中的“针对指标进行设置”。<div class="note--warning"><p><strong>旧版指标功能的停用</strong></p><p>Tableau 的旧版指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。借助 Tableau Pulse，我们开发了一种改进的体验来跟踪指标和询问数据问题。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm">使用 Tableau Pulse 创建指标</a>以了解新体验，并参见<a href="https://help.tableau.com/current/online/zh-cn/metrics_create.htm">创建指标并排查其问题（已停用）</a>了解已停用的功能 。</p></div></td></tr><tr><td>网页对象和 Web 图像</td><td>控制这些网页和图像对象是否可以显示目标 URL。有关详细信息，请参见 Tableau 用户帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm#Be_security-savvy" target="_blank">网页对象安全性</a>。</td></tr><tr><td>个人空间</td><td>允许 Creator 和 Explorer 站点用户创建内容并将其保存到私有个人空间。启用个人空间后，您可以设置用户存储限制。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/personal_space.htm" class="xref">在个人空间中创建和编辑私有内容</a>。</td></tr><tr><td>自定义域</td><td><p>允许您使用自定义域将流量重定向到您的站点。您可以配置一个子域，如 <code>analytics.example.com</code>，以便更轻松地嵌入和访问内容。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/custom_domain.htm" class="xref">将自定义域与 Tableau Cloud 配合使用</a>。</p></td></tr><tr><td>集合</td><td>控制集合在站点上是否可用。当您打开集合时，用户可以创建集合来组织内容并浏览其他用户提供的集合。有关详细信息，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/collections.htm">组织集合中的项</a>。</td></tr><tr><td>数据提取的站点时区</td><td>站点中基于数据提取的数据源的默认时区是协调世界时 (UTC)。站点管理员可以设置其他时区。有关详细信息，请参见 Tableau Server 帮助中的<a href="https://help.tableau.com/current/server/zh-cn/tz_for_extracts.htm" target="_blank">为数据提取设置站点时区</a>或 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/tz_for_extracts.htm#tz" target="_blank">为数据提取设置站点时区</a>。</td></tr><tr><td>数据提取配额限制通知</td><td>当数据提取刷新作业因数据提取作业容量问题而取消时，向所有站点管理员发送电子邮件通知。</td></tr><tr><td><p>流程参数</p><p>（仅限 Tableau Server 和站点管理员）</p></td><td><p>使用户能够计划和运行包含参数的流程。<br></p><p>管理员还可以启用流程参数以接受任何值。如果启用此选项，则任何流程用户都可以在参数中输入任何值，这可能会暴露用户不应访问的数据。</p><p>从版本 2023.2 开始，管理员可以启用系统参数，允许用户将日期或时间参数应用于文件和已发布数据源输出类型的流程输出名称。当流程运行时，开始时间会自动添加到流程输出名称中。</p><p>可以在文件名和路径、表名的输入步骤中输入参数，或者在使用自定义 SQL 查询时、在文件名、路径和表名的输出步骤中以及在筛选器或计算所得值的任何步骤类型中输入参数。</p><p>流程参数设置可在服务器级别应用以包括 Tableau Server 上的所有站点。可以在站点级别禁用该设置以仅包括特定站点。</p><p>有关使用参数的详细信息，请参见 Tableau Prep 帮助中的<a href="https://help.tableau.com/current/prep/zh-cn/prep_parameters.htm" target="_blank">在流程中创建和使用参数</a>。</p></td></tr><tr><td>立即运行</td><td>控制谁能够使用 Web、Rest API 和 Tabcmd 中的“立即运行”选项手动运行作业。默认情况下，此选项处于选定状态，以允许用户手动运行作业。如果只应允许管理员手动运行作业，请清除该复选框。<p class="note"><b>注意</b>：如果您使用 Tableau Server，管理员可以禁用此站点设置。</p></td></tr><tr><td>管理通知</td><td>控制站点用户如何接收各个事件（例如数据提取作业、流程运行、其他用户与他们共享内容或在注释中提到他们时）的通知。可以通过通知中心在其 Tableau 站点上查看通知、通过电子邮件发送通知，或者将通知发送到 Slack 工作区。启用通知后，用户可以在“帐户设置”页面上配置其通知首选项。<p class="note"><b>注意</b>：如果您使用 Tableau Server，服务器管理员可以禁用此站点设置。</p></td></tr><tr><td>自定义电子邮件通知（仅限 Tableau Cloud）</td><td><p>控制是否使用 Tableau 电子邮件服务器或您自己的 SMTP 服务器发送数据驱动型通知以及工作簿和视图订阅的电子邮件通知。您可以使用标准基本身份验证或适用于 Microsoft 365 的现代 OAuth 2.0 连接自定义邮件服务器。当您使用自己的 SMTP 服务器时，可以自定义电子邮件发件人的名称、电子邮件地址以及通知电子邮件中链接的域。在 2024 年 2 月版中针对 Tableau Cloud 添加。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/custom_smtp.htm">为电子邮件通知使用自定义 SMTP 服务器</a>。</p><p>除了 SMTP 设置之外，您还可以控制发送给用户的数据驱动型通知和订阅的电子邮件通知是否包含链接。这些链接将用户定向到您的 Tableau 站点以查看内容并管理通知或订阅。无论此设置是否开启，通知电子邮件中始终包含取消订阅的链接。在 2023 年 6 月版中针对 Tableau Cloud 添加。</p></td></tr><tr><td>流程订阅</td><td>控制流程所有者是否可以计划包含流程输出数据的电子邮件，并将其发送给自己和其他人。允许流程订阅时，您可以控制订阅电子邮件中是否包含流程输出数据，以及是否将流程输出文件附加到电子邮件。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_subscribe_to_flow.htm" class="xref">通知用户流程运行成功</a></td></tr><tr><td>OAuth 客户端注册表</td><td>对于一部分连接器，您可以注册自定义 OAuth 客户端以覆盖预先配置的 OAuth 客户端设置。通过注册自定义 OAuth 客户端，您可以启用新连接和现有连接以使用自定义 OAuth 客户端，而不是默认 OAuth 客户端。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/protected_auth.htm#custom_oauth_server" target="_blank">配置自定义 OAuth</a>。</td></tr><tr><td><a name="pat"></a>个人访问令牌（仅限 Tableau Cloud）</td><td>控制是否为所有用户、一组用户或不为用户启用个人访问令牌 (PAT) 创建。还允许自定义 PAT 有效期。对这些设置的更改仅适用于新 PAT。现有 PAT 仍然有效且不变。有关 PAT 的详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/security_personal_access_tokens.htm" target="_blank">个人访问令牌</a>。</td></tr><tr><td>视图加速</td><td>控制 Creator 和 Explorer 站点用户是否可以加速其 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 工作簿中的视图，以加快加载速度。当您允许加速时，您可以设置要加速的最大视图数，并且您可以选择对多次加速任务失败的视图自动暂停加速。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/data_acceleration.htm">“视图加速”</a>。</td></tr><tr><td><a name="assertions"></a>组成员身份断言</td><td><p>通过在用户向 <span class="mc-variable Variables.ProductName variable">Tableau Cloud</span> 进行身份验证时动态声明组成员身份，使本地组成员身份可由您的 SSO IdP 或通过 Tableau 已连接应用进行控制和管理。需要在 SAML 断言、OIDC 断言或 JSON Web 令牌 (JWT) 中进行额外配置。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#assertions" class="xref">使用断言的动态组成员身份</a>。</p></td></tr><tr><td><a name="group_sets"></a>组集</td><td>启用<span class="uicontrol">“组集”</span>页面以及创建组集的功能。某些用户（站点管理员、项目所有者和内容所有者）可以使用组集来应用权限规则，这些规则要求用户必须是组集中所有组的成员才能访问权限依赖于组集的内容。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/group_sets.htm" class="xref">使用组集</a>。</td></tr><tr><td>回收站</td><td>控制是否为站点启用回收站，允许具有 Explorer（可发布）或 Creator 许可证的管理员和作者在选定的时间段内恢复以前删除的项目、工作簿和数据源。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/recycle_bin.htm">回收站</a>。</td></tr><tr><td><a name="scim"></a>跨域身份管理系统 (SCIM) (Tableau Server)</td><td>允许服务器管理员启用站点级别 SCIM，以自动执行用户和组预置和同步。有关详细信息，请参见<a href="https://help.tableau.com/current/server/zh-cn/scim_config_online.htm" target="_blank">“SCIM”</a>。</td></tr><tr><td>在 Tableau 中浏览（仅限 Tableau Cloud）</td><td>允许外部 <a href="https://www.tableau.com/zh-cn/partners" target="_blank">Tableau 合作伙伴</a>将其用户直接转移到 Tableau Cloud Web 制作体验。启用此功能后，新工作簿将连接到用户数据平台中的数据源，使用户能够更快地开始数据分析。有关详细信息，请参见<a href="https://help.tableau.com/current/api/explore-tableau/zh-cn/index.html" target="_blank">在 Tableau API 中浏览</a>帮助。</td></tr></tbody></table>

## “身份验证”选项卡 (Tableau Cloud)

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>身份验证类型</td><td>指定用户如何登录站点，以及如何在第一次登录后访问该站点。身份验证将验证用户的身份。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/security_auth.htm" target="_blank">身份验证</a>。</td></tr><tr><td>嵌入视图的默认身份验证类型</td><td>指定用户如何登录到嵌入视图。默认情况下，“Tableau 身份验证”处于选定状态。</td></tr><tr><td><a name="user-attributes"></a>在身份验证工作流程中控制用户访问</td><td>使内容中使用的用户属性函数能够通过已连接应用、OIDC 声明或 SAML XML 响应接受来自 JSON Web 令牌 (JWT) 的用户属性传递。用户属性会传递到 Tableau，以自定义和控制可在运行时向用户显示的数据。有关详细信息，请参见 <a href="https://help.tableau.com/current/api/embedding_api/zh-cn/docs/embedding_api_user_attributes.html" target="_blank">Embedding API v3</a> 帮助、<a href="https://help.tableau.com/current/online/zh-cn/openid_auth_server_config.htm#user_attributes" target="_blank">OIDC</a> 或 <a href="https://help.tableau.com/current/online/zh-cn/saml_config_site.htm#user_attributes" target="_blank">SAML</a> 主题。</td></tr><tr><td>跨域身份管理系统 (SCIM)</td><td>允许您通过第三方身份提供程序 (IdP) 管理站点上的用户。启用后，将使用要在 IdP SCIM 配置中使用的值填充“基本 URL”和“密文”框。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/scim_config_online.htm" target="_blank">“通过外部身份提供程序自动进行用户配置和组同步”</a>。</td></tr><tr><td>连接的客户端</td><td>允许 Tableau 客户端（例如 Tableau Mobile、Tableau Bridge 等）在用户首次提供登录凭据后保持对服务器的身份验证。关闭后，用户每次访问 Tableau Cloud 时都需要显式登录。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/to_connected_clients.htm" target="_blank">从连接的客户端中访问站点</a>。</td></tr></tbody></table>

## “Bridge”选项卡 (Tableau Cloud)

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>客户端未运行通知</td><td>当客户端似乎与站点断开连接时，向数据源所有者发送电子邮件通知。</td></tr><tr><td>池化</td><td>跨 Bridge 池中的所有客户端分摊实时查询和刷新作业。有关详细信息，请参见 中的<a href="https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm" target="_blank">配置和管理 Bridge 客户端池</a>。</td></tr><tr><td>私有网络允许列表</td><td><p>添加和管理域，这些域使专用 Bridge 池能够代表 Tableau Cloud 访问私有网络数据。</p></td></tr></tbody></table>

## “扩展程序”选项卡

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>仪表板和可视化项扩展程序</td><td>管理和控制仪表板及可视化项扩展程序。仪表板扩展程序是一些 Web 应用程序，这些应用程序在自定义仪表板区域中运行，并可与仪表板的其他部分交互。可视化项扩展是支持新可视化项类型的 Web 应用程序。有关详细信息，请参见 <a href="https://help.tableau.com/current/online/zh-cn/dashboard_extensions_server.htm" target="_blank">Tableau Cloud 帮助</a>或 <a href="https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm" target="_blank">Tableau Server 帮助</a>中的“管理仪表板和可视化项扩展程序”。</td></tr><tr><td>分析扩展程序</td><td>启用一组用户可用来将表达式传递到分析扩展程序以与 R 和 Python 集成的函数。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/en-us/config_r_tabpy_tol.htm" target="_blank">Tableau Cloud 帮助</a>或 <a href="https://help.tableau.com/current/server/zh-cn/config_r_tabpy.htm" target="_blank">Tableau Server 帮助</a>中的“配置与分析扩展程序的连接”。</td></tr><tr><td>Tableau Prep 扩展程序</td><td><p>在 Web 上制作流程时，使用户能够将基于 Einstein Discovery 的模型应用于他们的流程，以对其数据进行批量评分预测。</p><p>有关详细信息，请参见 Tableau Server 帮助中的<a href="https://help.tableau.com/current/server/zh-cn/config_einstein_extensions.htm#einstein-discovery-tableau-prep-extensions" target="_blank">配置 Einstein Discovery 集成</a>。</p></td></tr></tbody></table>

## “集成”选项卡

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>Slack 连接</td><td><p>显示 Slack 工作区和 Tableau 站点之间的连接。连接后，Tableau 站点用户可以在连接的 Slack 工作区中查看其 Tableau 通知。</p><p>在 Tableau Cloud 中，您可以请求 Slack 工作区管理员安装 Tableau for Slack 应用程序，然后在安装后完成连接。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm" class="xref">将 Tableau 与 Slack 工作区集成</a>。</p></td></tr><tr><td>分析扩展程序</td><td>启用一组用户可用来将表达式传递到分析扩展程序以与 R 和 Python 集成的函数。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/en-us/config_r_tabpy_tol.htm" target="_blank">Tableau Cloud 帮助</a>或 <a href="https://help.tableau.com/current/server/zh-cn/config_r_tabpy.htm" target="_blank">Tableau Server 帮助</a>中的“配置与分析扩展程序的连接”。</td></tr><tr><td><p>发布到 Salesforce</p><p>（<span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 和 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 上的测试版）</p></td><td>允许站点用户将视图发布到 Salesforce 应用软件。<p>将视图发布到 Salesforce 时，有权访问所选应用软件或任何人都可以看到内容存在。但是，只有使用现有 Tableau 权限登录的用户才能看到该视图。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/publish_to_salesforce.htm">将视图发布到 Salesforce（测试版）</a>。</p></td></tr></tbody></table>

## “已连接应用”选项卡

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>已连接应用</td><td><p><br>在 Tableau Cloud 站点和自定义应用程序之间创建和管理 Tableau 已连接应用、显式直接信任关系或 OAuth 2.0 信任，并使用 JSON Web 令牌 (JWT) 以编程方式代表用户授权访问 Tableau REST API。有关详细信息，请参见 Tableau Cloud 帮助中的<a href="https://help.tableau.com/current/online/zh-cn/connected_apps.htm" target="_blank">为应用程序集成使用 Tableau 已连接应用</a>。</p></td></tr></tbody></table>

## “Mobile”选项卡

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col style="width: 196px;"><col></colgroup><tbody><tr><td><b>设置</b></td><td><b>描述</b></td></tr><tr><td>应用软件锁定</td><td>用户需要生物识别方法或设备密码才能在 Tableau Mobile 上打开此站点。有关详细信息，请参见 Tableau Mobile 部署指南中的<a href="https://help.tableau.com/current/mobile/mobile-admin/zh-cn/admin_mobile_sso.htm#enable-app-lock-for-added-security" target="_blank">启用应用软件锁定以增强安全性</a>。</td></tr><tr><td>脱机预览</td><td>控制当用户在 Tableau Mobile 上访问站点时，是否生成脱机预览以供显示。有关详细信息，请参见 Tableau Mobile 部署指南中的<a href="https://help.tableau.com/current/mobile/mobile-admin/zh-cn/admin_mobile_snapshots.htm" target="_blank">管理设备上的 Tableau Mobile 数据</a>。</td></tr><tr><td><strong>Mobile 安全策略</strong></td><td>某些安全策略会自动启用，无法禁用。Mobile 安全策略不适用于 Tableau Mobile 的 MAM 版本。</td></tr><tr><td>越狱检测</td><td>控制是否允许使用设备已“越狱”或“root”的 Tableau Mobile 应用程序用户访问 Tableau 上的内容，以及在检测到越狱或 root 设备时发生的响应级别。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/mobile_security_settings-admin.htm" class="xref">Tableau Mobile 应用程序安全设置</a>。</td></tr><tr><td>恶意软件检测（仅限 Android）</td><td>控制是否为移动设备启用恶意软件检测，以及检测到恶意软件时发生的响应级别。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/mobile_security_settings-admin.htm" class="xref">Tableau Mobile 应用程序安全设置</a>。<blockquote><p>[!IMPORTANT]</p><p>2025 年 9 月，Tableau Mobile 已停用对恶意软件检测设置的支持。恶意软件检测设置已于 2025 年 9 月从 Tableau Cloud 设置页面和 Tableau Server 版本 2025.2.3 的 Tableau Server 设置页面中移除。以前版本的 Tableau Server 上恶意软件检测设置的任何配置都不会对 Tableau Mobile 应用程序产生影响。</p></blockquote></td></tr><tr><td>没有刷新策略时的最大脱机天数</td><td>控制是否存在移动设备可以脱机并仍可使用应用程序的最大天数。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/mobile_security_settings-admin.htm" class="xref">Tableau Mobile 应用程序安全设置</a>。<br></td></tr><tr><td>防止调试</td><td>控制是否在移动设备上阻止调试器。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/mobile_security_settings-admin.htm" class="xref">Tableau Mobile 应用程序安全设置</a>。<br></td></tr><tr><td>屏幕共享和屏幕截图（仅限 Android）</td><td>控制 Tableau Mobile 用户是否能够在应用程序中截取屏幕截图或使用屏幕共享。有关详细信息，请参见 <a href="https://help.tableau.com/v0.0/online/zh-cn/mobile_security_settings-admin.htm" class="xref">Tableau Mobile 应用程序安全设置</a>。<br></td></tr></tbody></table>

<!-- document id=e6624727154bc6f3214ba17d1d29e7d451a7958cba0f17e9e75dca65dfb8990d url=/tableau/next/zh-cn/online/data_connect_admin.md -->

[跳转到主要内容](#main-content)

# 管理 Data Connect

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 采用责任共担模式运行。在这种模型中，客户提供物理或虚拟计算资源，Tableau 在这些资源上托管和管理 Data Connect Kubernetes 群集。Tableau 通过远程管理、监控和维护 Kubernetes 群集来减少管理开销。在这种模型中，Tableau 负责安全地操作数据连接服务，客户负责管理基础设施和网络层。

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect-security_616x420.png)

## 管理 Data Connect 节点

作为责任共担模型的一部分，Tableau 负责对部署在 Data Connect 节点上的 Bridge 客户端的运行状况进行故障排除。您负责节点本身的运行状况，保持计算机最新且运行正常并管理网络连接。为了支持管理 Data Connect 节点，当需要节点操作时，Tableau 将在 Tableau Cloud 中提供通知。

### 节点许可证

Data Connect 按节点许可，可供使用 Tableau Cloud Enterprise 或 Tableau+ 版本的客户购买。节点一次只能会添加到一个群集。在[关于 Data Connect](https://help.tableau.com/v0.0/online/zh-cn/data_connect_about_overview.htm)中了解详细信息。

节点许可证在 Tableau Cloud Manager 租户上的所有站点之间共享。这使您可以跨不同站点共享群集，而无需支付单独的节点许可证费用。如果您发现在设置群集之前 Data Connect 节点许可证已被消耗，则意味着租户上的另一个站点已经设置了 Data Connect 节点。考虑与租户上的其他站点共享 Data Connect 节点以降低总体成本。

### 监视节点运行状况

如果某个节点变得不正常或与 Tableau Cloud 失去连接，则会向 Tableau Cloud 站点管理员提供详细信息。

提供节点利用率百分比，以便近乎实时地监控您的部署。提供的值每 15 秒刷新一次，当您刷新浏览器时将显示更新的值。当节点计算机的 CPU 利用率超过 90% 或内存负载超过 80% 时，Tableau Cloud 用户体验中将显示通知。

有关解决节点问题的详细信息，请参见[服务初始化和运行状况故障排除](#Troubles)。

### 在群集中添和移除节点

可以在群集中添加和移除节点以适应不同的使用模式。但是，它们每次只能服务于一个群集，并不适用于在群集之间进行动态更改。若要添加或移除节点，您必须是群集所有者站点上的站点管理员。请参见[从现有群集添加节点](https://help.tableau.com/v0.0/online/zh-cn/data_connect_setup.htm#add-node)和[从现有群集中移除节点](https://help.tableau.com/v0.0/online/zh-cn/data_connect_setup.htm#remove-node)。

### 管理节点容量

随着 Data Connect 工作负载的增长，您可能会开始遇到最初提供的现有基础设施的限制。扩展 Data Connect 服务容量有两种方法。第一种方法是增加用于 Data Connect 节点的计算机的大小。第二种方法是增加群集中的节点数量。

增加计算机的 CPU 将特别有利于节点上的实时查询和嵌入式数据源数据提取的吞吐量。增加内存将特别有利于节点上已发布数据源数据提取的性能。

增加群集内的节点数量将增加整个系统的吞吐量。

有关容量规划的详细信息，请下载白皮书[使用 Tableau Cloud 访问您的私有网络数据](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)。

### 更改现有节点

在 Data Connect 积极部署期间，您可能需要对节点基础设施进行操作更改。这可以包括向您的基础设施添加内存或 CPU、轮换节点新计算机或在节点上执行维护。

更改节点身份（主机名或 IP 地址）或以其他方式影响网络可用性将导致 Data Connect 节点停机。

如果要更改节点身份（主机名或 IP 地址），则需要在进行更改之前采取额外步骤删除 Tableau Cloud 中的节点，然后在更改完成后将该节点作为新节点加入。

**示例场景 #1：无需重启即可向现有计算机添加资源**

一些云提供商允许您向现有计算机添加资源（CPU/内存），而无需重新启动计算机。在这种情况下，不需要进行任何 Data Connect 更改，并且服务将利用额外的资源而不需要 Data Connect 操作。

**示例场景 #2：进行需要重新启动计算机但不影响网络或计算机身份的更改**

通常，计算机维护或为现有计算机添加资源（CPU/内存）需要重新启动计算机本身，但不会影响计算机身份或网络。在这些情况下，需要重新启动的节点将在重新启动期间与 Tableau Cloud 断开连接。重新启动后，还需要在计算机上启动 Data Connect 服务。此过程完成后（通常少于 1 小时），节点将在 Tableau Cloud 中显示为“可用”。启用 Data Connect不需要其他操作。

如果您意外更改了计算机身份，请参见“示例场景 #3”。

如果在维护期间意外影响计算机的网络，请参见[服务初始化和运行状况故障排除](#Troubles)。

**示例场景 #3：进行需要更改节点身份（主机名或 IP 地址）的更改**

在此场景中，您必须先删除节点以断开节点与 Tableau Cloud 的连接，然后再进行任何更改。节点断开连接后，进行必要的维护，并将节点添加回群集。

**示例场景 #4：进行影响网络的更改**

如果您组织中的另一个团队或第三方为您托管计算机，这种场景最为常见。如果他们对计算机进行维护并且影响计算机的网络，则该节点将在 Tableau Cloud 中变得不可用。为了解决此问题，您需要解决网络问题，在某些情况下，还需要重新启动计算机。有关适当网络配置的更多详细信息，请参见[服务初始化和运行状况故障排除](#Troubles)。

## 共享 Data Connect 群集

Tableau Cloud 租户 (Tableau Cloud Manager) 上的所有站点都可以使用 Data Connect 群集及其对应的节点。共享基础设施可降低在 Tableau Cloud 部署中运行 Data Connect 的成本。共享群集允许租户内不同站点上的查询使用相同的节点基础设施。

群集共享后，共享站点上的站点管理员将负责在其站点中设置池。建立池之后，站点上的查询将开始使用 Data Connect 来处理发送到池中指定的域的查询。

请参见[（可选）步骤 4：跨站点共享群集](https://help.tableau.com/v0.0/online/zh-cn/data_connect_setup.htm#\(Optiona)。

### 共享群集的角色和职责

群集所有者和群集接收者共同管理共享群集。

#### 群集所有者

最初配置 Data Connect 群集的站点的站点管理员称为_群集所有者_。群集所有者负责代表使用该群集的所有站点确保 Data Connect 节点的运行状况。群集所有者还负责配置拥有群集的站点上的池，以及监视该站点的各个查询的运行状况。但是，配置池和监控所有其他站点上各个查询的运行状况将由配置这些池的站点负责。

#### 群集接收者

最初未配置 Data Connect 群集的站点的站点管理员称为_群集接收者_。群集接收者无法了解节点的运行状况，也无法从其站点对节点运行状况采取措施。群集接收者站点管理员仅负责建立池和监控各个查询的运行状况。

任何有关跨站点节点运行状况的通信都必须在 Tableau Cloud 之外进行。

#### 共享群集职责摘要

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>职责</th><th>群集所有者</th><th>群集接收者</th></tr><tr><td><p>设置</p></td><td><p>群集设置</p><p>网络配置</p><p>为所有站点安装驱动程序</p><p>为所有接收者站点添加基本映像</p></td><td>向群集所有者提供池 ID 和驱动程序要求</td></tr><tr><td>启用</td><td>共享群集</td><td>&nbsp;</td></tr><tr><td>池配置</td><td>由所属站点的站点管理员管理</td><td>由接收站点的站点管理员管理</td></tr><tr><td>监视</td><td>群集所有者在群集级别监控 Data Connect 运行状况</td><td>&nbsp;</td></tr><tr><td>刷新令牌（90 天）</td><td>在自己的站点上进行刷新</td><td>在自己的站点上进行刷新</td></tr><tr><td><p>刷新基本映像</p><p>注意：</p><ul><li><p>流量将暂停，直到 pod 恢复运行状态。</p></li><li><p>如果您使用较旧的 Bridge 客户端版本运行 Data Connect，并且我们的团队已在云中升级了基础映像版本，则下次刷新基础映像时，将选择升级的 Bridge 客户端版本。</p></li></ul></td><td>在自己的站点上进行刷新</td><td>在自己的站点上进行刷新</td></tr><tr><td>查询运行情况</td><td>在自己的站点上进行监控</td><td>在自己的站点上进行监控</td></tr></tbody></table>

## 服务初始化和运行状况故障排除

Data Connect 使用责任共担模型在您的环境中部署 Tableau Bridge 并使私有网络数据保持最新。本故障排除部分涵盖设置 Data Connect 时可能出现的问题以及导致现有群集和节点不可用的问题。

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_setup_526x514.png)

如果您遇到启动问题，请验证以下连接和访问：

- Data Connect 基础设施、群集和容器需要通过网络访问业务流程提供程序服务（上图中的 #2）和 Tableau Cloud（仅出站，#5）。
- Data Connect 基础设施、群集、容器和代理需要通过网络访问您的数据库 (#6)。

请参见[网络规格](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm#Networki)。

## 监控 Data Connect 查询运行状况

Data Connect 部署并管理 Bridge 客户端。各个 Bridge 客户端负责处理发送到您的私有网络数据的查询。若要了解详细信息，请参见[架构](https://help.tableau.com/v0.0/online/zh-cn/data_connect_about_overview.htm#Architec)。

Tableau Cloud 中提供了多种监视解决方案，可帮助您管理 Data Connect 处理的各个查询的不同监控场景。所有这些解决方案均可供所有管理员使用。管理员可以向非管理员用户提供“在线管理见解”和活动日志。

**实时监控**

- “作业”页面：监控过去 24 小时内执行的作业的实时数据数据提取作业状态。请参见[在 Tableau Cloud 中管理后台作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm)。
- 管理视图：监控实时数据提取作业的状态和性能。包括近期工作历史记录以供长期分析。请参见 [查找管理视图](https://help.tableau.com/v0.0/online/zh-cn/adminview.htm)。

**历史分析**

- 在线管理见解：使用在您的环境中发布的 Tableau Cloud 数据源监控作业状态和性能。此数据每天更新，并显示历史数据以供长期分析。如果需要，可以与非管理员用户共享。请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。
- 活动日志：使用日志数据来监控作业状态和性能，日志数据可以根据您的分析需要保存。如果需要，可以与非管理员用户共享此数据。仅适用于 Tableau Cloud Enterprise 和 Tableau+ 客户。请参见[活动日志](https://help.tableau.com/v0.0/online/zh-cn/activity_log_overview.htm)。

请注意，对于共享 Data Connect 群集，Data Connect 查询的监控是在站点级别进行管理的。站点管理员只能监控使用其站点中的池的查询。

有关通过各种用户场景监控各个作业的完整描述，请下载白皮书[使用 Tableau Cloud 访问您的私有网络数据](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)。

有关对各个错误进行故障排除的信息，请参见“解决单个查询的错误”。

<!-- document id=ad15b87f4029192aabd4479f295c635077b7e0f8f2225c34649885869744289c url=/tableau/next/zh-cn/online/to_bridge_alerts.md -->

[跳转到主要内容](#main-content)

# 管理 Tableau Bridge 的通知

由于各种原因，计划刷新可能会失败。作为数据源所有者，了解这些刷新失败情况非常重要，这样您就能排查任何问题并最大限度地缩短数据新鲜度中的差距。

如果站点管理员已启用，您会收到有关您拥有的所有数据源刷新失败情况的电子通知。当通过 Bridge 刷新或 Bridge 旧版计划来帮助刷新数据源时，您接收的通知的类型、接收通知的时间以及您可以配置的通知与其他 Tableau 通知不同。

## 您如何接收 Bridge 通知

Bridge 作业失败通知通过 Tableau 的统一通知平台传递，该平台也为您的其他 Tableau 通知提供支持。以前，Bridge 仅通过电子邮件发送这些通知。现在，除了电子邮件之外，有关 Bridge 作业失败的通知（例如客户端断开连接、数据提取刷新失败、Prep 流程失败和虚拟连接失败）会与其他 Tableau 通知一起显示。

Bridge 通知发送给与电子邮件通知相同的受众：站点管理员和数据源所有者。

无需进行其他设置即可接收这些通知。确保在常规通知首选项中选中“Tableau”复选框。

## 与 Bridge 通知的差异

- 超过超时限制时，将发送超时刷新失败电子邮件。与直接在 Tableau Cloud 上运行的刷新不同，Bridge 刷新将在 24 小时后超时（默认值）。不过，站点管理员可以通过每个 Bridge 客户端增加（或减少）刷新的超时限制。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#timeout)。

- 根据故障类型，将与 Bridge 相关的刷新问题通知发送给特定收件人：
    
    - **RAS 故障**：这些通知与计划刷新 (RAS) 失败相关，这意味着作业已成功发送到 Bridge 客户端，但在客户端计算机上处理期间或之后失败。通知只会发送给数据源所有者。站点管理员不会收到这些通知。
        
        - **刷新作业失败**：当数据提取刷新由于以下原因以外的原因失败时（这是作业在客户端上运行时发生的所有失败）。
        - **Bridge 客户端未运行：**当链接到数据源的 Bridge 客户端未运行，但池中的其他客户端处于活动状态时。
        - **刷新未完成**：如果计划刷新在指定的时间后未完成。
    - **边缘池故障**：这些通知与边缘池故障相关，这意味着由于池容量或客户端可用性问题，计划的刷新作业在发送到 Bridge 客户端之前未能运行。这些通知发送给数据源所有者和站点管理员。
        
        - **Bridge 池容量已满：**当数据提取刷新由于池容量已满而无法运行时，将收到此通知。
        - **Bridge 池中没有客户端：**未将任何 Bridge 客户端分配给池。
        - **Bridge 池中没有正在运行的客户端：**Bridge 客户端已分配给池，但当前没有任何客户端在运行。这包括池中的单个客户端未运行的情况，或者分配了多个客户端但所有客户端都处于非活动状态的情况。
- 对于特定数据源，Tableau Cloud 会在第一天发送有关前五个连续的刷新相关失败的电子邮件（即，刷新失败、由于客户端未运行而出现警报，或者由于刷新未完成而出现警报）。如果在第一天后数据源仍然有刷新问题，Tableau Cloud 将每天发送一封电子邮件。
- 数据源所有者一天中最多可能收到 10 封电子邮件，具有活动或连续刷新问题的每个数据源一封电子邮件。_一天_的时间段是 24 个小时，从第一次出现刷新问题时开始。
- 依靠 Bridge 数据提取数据源使数据保持最新的视图或工作簿不支持由数据刷新发起的[订阅](https://help.tableau.com/current/online/zh-cn/subscribe_user.htm)。有关详细信息，请参见[缺少订阅电子邮件](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm#subscriptions)。

## 配置池化

数据提取刷新可能会因为 Bridge 池和负载平衡的问题而失败。站点管理员可以通过添加新池或修改池化容量来配置和管理 Bridge 客户端的池化。有关更多信息，请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)和[管理 Bridge 池的大小](https://help.tableau.com/current/online/zh-cn/to_sync_change_computer_site.htm#configurable-options1)。

## 在客户端未运行时停止接收通知

默认情况下，Tableau Cloud 配置为在计划刷新由于链接到数据源的 Bridge 客户端未运行而无法启动时向数据源所有者发出通知。

您可能会收到此电子邮件的原因主要有两个：

- 客户端从中运行的计算机未打开。
- 数据提取数据源继续与不再使用的客户端关联。

如果以下任何原因适用于您的情况：

- 确认 Bridge 客户端是否正在运行，以及
- 如果您是站点管理员，请从站点中删除未使用的客户端。如果您不是站点管理员，则可以从客户端中删除数据源。有关详细信息，请参见[计划刷新似乎未按计划运行：](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_troubleshoot.htm#notrunning)。

<!-- document id=e3c63ffc08b524db45bd95b50ffb9fcd61c3e85c2b4c9a0eb465b31c3f3e6752 url=/tableau/next/zh-cn/online/adminview_insights_manage.md -->

[跳转到主要内容](#main-content)

# 管理“在线管理见解”

“在线管理见解”是预先填充了精心策划的数据源和预先生成的站点数据工作簿的仅 Tableau Cloud 项目。使用通过“在线管理见解”项目提供给您的资源，您可以创建自定义视图来帮助回答有关站点的一系列常见问题：

## “在线管理见解”与管理视图

“在线管理见解”项目和预先构建的管理视图（可从 Tableau Cloud 的“状态”页面访问）都是用于监视 Tableau Cloud 站点运行状况和活动的宝贵工具。两者无法相互替代。

若要确定使用哪个工具，请考虑以下各项：

<table style="width: 100%;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"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><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-BodyB-Column1-Body1"><ul><li>站点流量、采用和范围</li><li>用户角色和登录活动</li><li>发布相关活动</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><ul><li>常规站点活动、站点性能和磁盘空间利用率</li><li>数据提取性能</li><li>Tableau Bridge 流量和数据提取相关活动</li><li>疑难解答</li></ul></td></tr></tbody></table>

## “在线管理见解”项目附带什么内容

“在线管理见解”项目由以下各项组成：

- **“在线管理见解”数据源**\- TS 事件、TS 用户、组、站点内容、可视化项加载时间、作业性能、权限、订阅和令牌。如果需要使用自定义计算或组织中的其他数据丰富数据源的内容，您可以使用这些数据源作为基础来创建新数据源。有关这些数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm#datasources)。
- **“在线管理见解”起始模板 –** 一个预先构建的工作簿，其中包含基于“在线管理见解”数据源的仪表板。这些仪表板旨在作为模板，可依据其构建更多仪表板和视图，这些仪表板和视图可以更深入地分析和回答站点部署或组织特有的问题。有关这些仪表板的详细信息，请参见[浏览预先构建的工作簿](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm#dashboards)。
- **Tableau 系统帐户** —“在线管理见解”项目中的数据源由 Tableau 系统帐户更新。虽然此帐户执行的事件在数据源中不可见，但 Tableau 系统帐户默认列为“在线管理见解”内容的所有者。此帐户的存在是为了向您的“在线管理见解”项目提供“在线管理见解”数据。

**注意：**不应将“在线管理见解”项目从其在“浏览”页面上的默认位置移动。移动项目将停止从 Tableau 更新数据源。如果已移动项目，请备份已发布的任何更改或内容，并删除“在线管理见解”项目以还原功能。第二天将创建一个新的“在线管理见解”项目。

### 关于数据新鲜度

默认情况下，“在线管理见解”数据源都会包括最多 90 天的站点相关数据，或者对于 Advanced Management ，会包括最多 365 天的相关数据。有关详细信息，请参见[关于 Tableau Cloud 上的 Tableau Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm)。这些数据源可能每天或每周更新一次。若要指定“在线管理见解”数据源的更新频率，请转到“设置”，然后在“常规”选项卡上，滚动到**“在线管理见解更新频率”**。

由于“在线管理见解”起始模板基于这些数据源，因此工作簿中的仪表板始终显示最新信息。Tableau 会定期更新工作簿本身。关详细信息，请参见本主题后面的[获取对在线管理见解起始模板的更新](#updates)。

## 共享对“在线管理见解”访问权限

“在线管理见解”内容最初仅对站点管理员可见。考虑将访问权限扩展到组织中的其他站点用户，使他们能够构建、整理和深入了解其需求和工作流，并最终帮助他们更有效地管理其内容。有关将项目权限扩延到非站点管理员的详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#projectpermissions)。

## 移动或重命名在线管理见解起始模板

Tableau 强烈建议您将预先构建的工作簿“在线管理见解起始模板”转移到其他项目，或简单地将其重命名。这样做有助于确保所做的更改得以保留，不会被 Tableau 对预先构建的工作簿所做的定期更新覆盖。

有关详细信息，请参见下面的[获取对在线管理见解起始模板的更新](#updates)。

### 获取对在线管理见解起始模板的更新

Tableau 会定期更新在线管理见解起始模板。更新将自动应用于“在线管理见解”项目中的“在线管理见解起始模板”工作簿。这些更新汇总在“发布说明”工作簿中，该工作簿也可在“在线管理见解”项目中找到。更新可能包括新的字段或字段说明、新视图、现有视图的更新等。

为了确保获得“在线管理见解起始模板”的最新更新，并且您对工作簿所做的任何更改都不会被覆盖，请按照下面所述的步骤进行操作。

**步骤 1：准备更新**

为了保留对工作簿所做的更改并避免 Tableau 覆盖这些更改，Tableau 建议您执行下列任务之一：

- 将工作簿转移到其他项目
- 重命名工作簿

若要同时保留您所做的更改以及 Tableau 的新工作簿改进，您需要在 Tableau 每次更新后重复上述任务之一。

**步骤 2：检查是否有更新**

在更新过程中，Tableau 会重新创建在线管理见解起始模板，然后将其添加到“在线管理见解”项目。

如果已转移或重命名工作簿，将会向“在线管理见解”项目中添加一个_新的_ “在线管理见解起始模板”。可以通过其在修订历史记录中的修改日期或发布日期来验证新工作簿。

**步骤 3：使用修订历史记录撤消更改（可选）**

如果您能够在 Tableau 替换“在线管理见解起始模板”之前转移或重命名工作簿，或者您不在乎更新，则可以使用修订历史记录来恢复更改。有关修订历史记录的详细信息，请参见 Tableau 用户帮助中的 [处理内容修订](https://help.tableau.com/current/pro/desktop/zh-cn/qs_revision_history.htm)。

**步骤 4：手动更新或将更改转移到最新的在线管理见解起始模板**

为了确保所做的更改与 Tableau 所做的更改在同一工作簿中反映出来，您需要遵循下面的过程。

1. 在最新版本的“在线管理见解起始模板”工作簿中，可以执行以下一项或两项操作：
    
    - 将您在您的工作簿版本中所做的更改手动更改到工作簿的最新版本。
    - 将工作表从您的工作簿版本导出，并将其保存到最新版本的工作簿中。有关导出工作表的详细信息，请参见 Tableau 用户帮助中的[在工作簿之间导出和导入工作表](https://help.tableau.com/current/pro/desktop/zh-cn/copy_b_wkbks.htm#export-and-import-sheets-between-workbooks)。
2. 再次转移或重命名最新的工作簿，以便 Tableau 对“在线管理见解起始模板”所做的任何新更新不会覆盖您所做的更改。

## 管理“在线管理见解”的技巧

尽管“在线管理见解”项目的功能就像站点上的任何其他项目一样，但 Tableau 建议您在管理项目时考虑以下以下各项：

- **将在线管理见解起始模板转移到其他位置。**如果打算对在线管理见解起始模板进行更新，Tableau 建议您 1) 将工作簿转移到其他项目，或者 2) 重命名工件簿。执行其中一项任务有助于确保所做的更改得以保留，不会被 Tableau 自动工作簿进行的定期更新覆盖。有关详细信息，请参见[获取对在线管理见解起始模板的更新](#updates)。
- **移动数据源时要小心。**如果将任何“在线管理见解”数据源移到“在线管理见解”项目外，Tableau 将无法刷新它们。Tableau 也会定期更新这些数据源。为了确保这些数据源刷新并且您的更改得以保留，电子邮件订阅，请将“TS 事件”、“TS 用户”、“组”、“站点内容”、“可视化项加载时间”、“作业性能”、“权限”、“订阅”和“令牌”数据源保留在“在线管理见解”项目中。
- **指派其他用户（包括不是站点管理员的用户）来访问和创建项目内容。**例如，电子邮件订阅，允许用户基于“TS 事件”、“TS 用户”、“组”、“站点内容”、“可视项加载时间”、“作业性能”、“权限”、“订阅”和“令牌”数据源创建新视图。有关更改项目权限的详细信息，请参见[设置权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#setpermissions)。

<!-- document id=0662ef0ea1c54a8a66ba6023d2227558ee0be8bd97167ac4e5cfe1dc98868121 url=/tableau/next/zh-cn/online/task.md -->

[跳转到主要内容](#main-content)

# 管理任务

管理员可以手动刷新数据提取或删除其计划。对于 Tableau Prep 流程，管理员可以手动运行流程、编辑和删除计划。

1. 登录到具有您想要管理的计划的站点，然后单击“任务”。
2. 选择一个或多个计划数据提取刷新。
3. 从“动作”菜单中，执行以下任意操作：
    
    - 选择“更改计划”，并从列表中选择一个新计划。
    - 选择“立即运行”以手动刷新。
        
        **注意：** 如果数据提取没有计划刷新，则您可以通过“数据连接”页根据需求刷新数据提取。
    - 选择“删除”以完全删除所选数据源的计划。

## 管理流程任务

管理员可以更改流程计划的频率、更改优先级以及编辑流程计划或手动运行流程，所以这些都可以通过“任务”页面完成。

1. 登录到具有您想要管理的计划的站点，然后单击“任务”。
2. 在“流程”选项卡上，选择要管理的一个或多个流程。
3. 从“操作”菜单中，执行以下任意操作：
    
    - 选择“立即运行”以手动运行流程。
    - 选择“编辑任务”以编辑流程任务。
    - 选择“更改计划”，从列表中选择一个新计划，然后选择“更改频率”。
    - 选择“删除”以完全移除所选流程的计划。

## 另请参见

[数据提取刷新失败时通知所有者](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_enable_emails.htm)

<!-- document id=2a0bd9573d788e25720a64ef52299167b9a26f2deeb29b06cf6ed70343922d42 url=/tableau/next/zh-cn/online/owner.md -->

[跳转到主要内容](#main-content)

# 管理内容所有权

在 Tableau Cloud 上发布数据源、工作簿或流程，或者创建项目时，您成为其_所有者_。内容所有者、具有适当站点角色的项目主管或管理员可以更改内容资产的所有权。在重新分配所有权后，原来的所有者将不具有与该项的特殊联系，并且他们能否访问该项由他们对于项目或该特定项的权限确定。

## 谁可以按内容类型更改所有权或被授予所有权

您能否更改所有权或能否向您授予所有权取决于您的权限以及您与内容资产的关系，如下表中所述。

**注意：**只有某些站点角色才具有完全项目主管访问权限。有关信息，请参见[项目级管理](https://help.tableau.com/v0.0/online/zh-cn/projects.htm#project-admin)。

<table class="simple-table"><colgroup><col style="width: 30%;" title="1"><col style="width: 30%;" title="2"><col style="width: 40%;" title="2"></colgroup><tbody><tr><td><b>内容资产类型</b></td><td><b>谁可以更改所有权</b></td><td><b>可以向谁授予所有权</b></td></tr><tr><td><p><strong>顶层项目</strong></p></td><td><ul><li>服务器管理员<sup>1</sup></li><li>站点管理员</li></ul></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li>Explorer（可发布）</li></ul></td></tr><tr><td><p><strong>子（嵌套）项目</strong></p></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>项目所有者</li></ul></td><td><p>任何管理员或所有者（<i>不包括 <span class="mc-variable Variables.sku-explorer variable">Explorer</span></i> 和 <span class="mc-variable Variables.siterole-basic variable">Viewer（查看者）</span>）。</p></td></tr><tr><td><strong>工作簿和数据源</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>工作簿或数据源所有者</li><li>包含项的项目的项目主管或所有者</li></ul></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li>Explorer（可发布）</li></ul></td></tr><tr><td><strong>指标</strong> (Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/metrics_create.htm">创建指标并排查其问题（已停用）</a>。)</td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>指标所有者</li><li>包含项的项目的项目主管或所有者</li></ul></td><td><p>站点的任何管理员或用户（<i>不包括 <span class="mc-variable Variables.sku-explorer variable">Explorer</span></i> 和 <span class="mc-variable Variables.siterole-basic variable">Viewer（查看者）</span>）。</p></td></tr><tr><td><strong>流程</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>流程所有者（2025.2 及更高版本）</li></ul></td><td><ul><li><p>服务器管理员</p></li><li><p>站点管理员</p></li><li><p><span class="mc-variable Variables.siterole-author variable">Creator</span></p></li></ul><p class="note"><b>注意</b>：在 2025.1 和更低版本中，服务器管理员和站点管理员只能将所有者更改为自己。</p></td></tr><tr><td><strong>数据角色</strong><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>数据角色所有者</li><li>包含项的项目的项目主管或所有者</li></ul></td><td><p>站点的任何管理员或用户（不包括 <span class="mc-variable Variables.sku-explorer variable">Explorer</span> 和 <span class="mc-variable Variables.siterole-basic variable">Viewer（查看者）</span>）。</p></td></tr><tr><td><strong>集合</strong></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>集合所有者</li></ul></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li><span class="mc-variable Variables.siterole-author variable">Creator</span></li><li><span class="mc-variable Variables.sku-explorer variable">Explorer</span></li><li><span class="mc-variable Variables.siterole-basic variable">Viewer（查看者）</span></li></ul></td></tr><tr><td><strong>虚拟连接</strong><sup>2</sup></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>虚拟连接所有者</li></ul></td><td><ul><li>服务器管理员</li><li>站点管理员</li><li>Creator</li></ul></td></tr></tbody></table>

1 “服务器管理员”站点角色仅适用于 Tableau Server；不适用于 Tableau Cloud。

2虚拟连接需要 Data Management。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。请注意，若要编辑虚拟连接，您必须拥有数据库凭据。

## 更改内容所有权的注意事项

- 在从 Tableau Cloud 中移除用户之前，请确保用户未拥有任何内容资产。
    - 如果用户确实拥有内容，您必须首先重新分配这些资产的所有权，然后才能删除用户。否则，这些用户的站点角色将设置为“未许可”，但不会删除用户，并且只有管理员才能对该内容执行特定操作。在将用户的站点角色设置为“未许可”或删除用户之前，请重新分配具有嵌入凭据的工作簿或数据源的所有权。
    - 如果更改包含嵌入式凭据的工作簿、数据源或流程的所有权以连接到基础数据，嵌入式凭据将被删除，您需要重新进行身份验证才能连接。
    
    **注意：**这不适用于使用托管密钥链的嵌入式凭据。在这些情况下，即使在所有权更改后也会保留凭据。
    
    与已发布数据源的连接使用原始流程所有者进行身份验证并根据其权限进行授权。新所有者将需要该数据源的必要读取/写入权限。否则，在尝试连接到数据源或写入数据源时，流程将失败。
    
    - 流程的输入或输出数据源的所有权可能也需要转让给新的所有者，或者可能需要更新其对数据源的权限。
    - 可通过在 Tableau Cloud 上编辑连接信息来更新嵌入式凭据。有关详细信息，请参见[编辑 Tableau Cloud 上的连接](https://help.tableau.com/v0.0/online/zh-cn/to_connections_modify.htm)。对于流程，您可以在 Tableau Prep Web 制作中打开和编辑流程，并使用新凭据重新发布流程。
- 您只能转让已发布流程的所有权。您无法更改流程草稿的所有权。
- 如果未将权限锁定到项目，请确保您为其授予所有权的用户了解您的权限准则，或者您在更改所有权时要考虑权限。在未锁定的项目中，内容所有者默认情况下可对其内容设置权限。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#LockProject)。
- 虽然可以将指标的所有者更改为具有 Viewer（查看者）或 Explorer 站点角色的用户，但不建议这样做，因为这样做会导致指标刷新挂起。刷新、覆盖或删除指标需要 Creator 或 Explorer（可发布）站点角色。

## 更改内容资源的所有者

1. 登录到 Tableau Cloud Web 环境，并从导航菜单中选择“探索”。
2. 导航到要分配给其他人的内容。
    - 如果要重新分配多个相同类型的内容（例如，多个工作簿），请从下拉菜单中选择内容类型。
    - 如果要重新分配同一项目内的多个项，请导航到该项目。
        
        如果您不确定何处查找子项目，请显示筛选器，并选择“ 显示所有项目”。
    - 如果要重新分配具有相同所有者的多个内容项，请在“用户”页面中查找用户。
3. 选择要重新分配的项，然后选择“操作”\>**“更改所有者”**。
    
    您看到的其他菜单命令将取决于内容类型。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/owner_wkbks_change.png)
4. 键入用户的名称或从列表中选择用户。
    
    ![用于更改所选工作簿和流程的所有者的表单。](/tableau/next/zh-cn/online/zh-cn/Img/owner_change_256.png)
5. 选择**“更改所有者”**。

<!-- document id=adafda5d2b13d29ad9cca6c017909f839589bc1a3e91861ff5e8fc4a4b97a2e3 url=/tableau/next/zh-cn/online/permissions_section.md -->

[跳转到主要内容](#main-content)

# 管理内容访问

您可以管理谁可以访问站点上的内容，并设置控制内容所有权的权限。

## 此部分中的其他文章

<!-- document id=ce8cf0cb8072151dbb3d67b9f78f0ff19eb97224a4184d51d7f00d8affa49b06 url=/tableau/next/zh-cn/online/manage_stored_credentials.md -->

[跳转到主要内容](#main-content)

# 为数据连接管理保存的凭据

利用保存的凭据，您可以连接到数据源，而不会提示您输入凭据。为连接保存的凭据可以是 Oauth 访问令牌或其他凭据，例如用户名和密码。您可以在帐户设置页面上管理保存的凭据。

在 Tableau Cloud 上，您可以在“帐户设置”页面上管理保存的凭据。

**注意**：在 Web 上编辑 Tableau Prep 流程时，系统可能仍会提示您重新进行身份验证。

## 使用保存的凭据测试连接

如果连接器支持测试功能，您可以使用保存的凭据测试连接。

1. 登录到 Tableau Server 或 Tableau Cloud，显示您的“帐户设置”页面。
2. 在“保存的凭据”部分，选定要测试的已存储连接旁边的“测试”链接。

此测试确认 Tableau Cloud 或 Tableau Server 可以使用这个对应的已保存凭据访问您的帐户。如果测试成功，但您无法通过此托管连接访问数据，请确认您为此连接提供的凭据可以访问您的数据。

举例来说，如果您意外地使用您的个人 Gmail 帐户创建了连接，但使用其他帐户来访问 Google Analytics 数据库，则您需要删除保存的凭据，并使用相应的 Gmail 帐户登录到数据。

## 更新保存的凭据

在为您的站点配置自定义 OAuth 客户端后，为了帮助确保从现有 Tableau 内容中不间断地访问数据，我们建议您更新保存的凭据。若要更新保存的凭据，您可以删除特定连接器之前保存的凭据，然后重新添加。

当您再次添加保存的凭据时，新的和现有的 Tableau 内容都将使用您的站点管理员配置的自定义 OAuth 客户端访问数据。有关自定义 OAuth 客户端的详细信息，请参见[OAuth 连接](https://help.tableau.com/v0.0/online/zh-cn/protected_auth.htm#custom_oauth)。

1. 登录到 Tableau Server，并导航到“我的帐户设置”页面。
2. 在“保存的数据源凭据”下，执行以下操作：
    
    1. 单击已保存连接器凭据旁边的“删除”。
    2. 在同一个连接器旁边，单击“添加”并按照提示进行操作，以 1) 连接到您的站点管理员通知您的自定义 OAuth 客户端，以及 2) 保存最新的凭据。

## 清除所有已保存凭据

如果选择“清除所有保存的凭据”，则会从您的用户帐户中移除以下各项：

- 您的帐户中存储的连接的所有已保存凭据。
    
    **警告：**如果这些保存的凭据中的任一个与已发布的工作簿或数据源一起存储，则删除它们也会删除对这些位置的数据源的访问权限。实际上，这就像是在任何使用受影响已保存凭据的地方“换锁”。
- 您用于访问连接到它们的已发布数据提取或工作簿的密码。

## 移除保存的凭据

若要移除 Tableau 的数据访问权限，请从帐户中删除关联的已保存数据凭据。删除凭据之后，下次访问数据时您将需要登录。这将创建一个新的已保存凭据。

您的管理员可能选择为所有用户使用相同的共享凭据来连接到数据源。如果是这种情况，保存的凭据将与所有用户的数据连接关联，并且不会显示在您的“帐户设置”页面上的“保存的凭据”下。

**注意：**如果您是 Tableau Server 用户并且无法删除保存的凭据，请询问您的管理员，确认他们是否可能在服务器设置中清除了“Allow users to save data source access tokens”（允许用户保存数据源访问令牌）选项。

<!-- document id=9266e74ef2db1f2bc8c87abe3a65857be95bdc7603c93e43d4e2f837b2f5c7b7 url=/tableau/next/zh-cn/online/dm_perms_assets.md -->

[跳转到主要内容](#main-content)

# 管理外部资产的权限

Tableau Cloud 和 Tableau Server 提供用于访问和管理已发布内容的空间。如果 Tableau Cloud 或 Tableau Server 是使用 Data Management 许可的，则您可以访问 Tableau Catalog。Tableau Catalog 在整个站点中增加了一个互补空间以及一组功能，用于跟踪发布到站点的内容所使用的外部资产的元数据及世系。

## Tableau Catalog 会建立内容和资产的索引

Catalog 会发现、跟踪和存储发布到 Tableau Cloud 或 Tableau Server 的内容中的元数据。

Catalog 会为以下各项的元数据建立索引：

- **Tableau 内容：**工作簿、数据源、流程、项目、指标、虚拟连接、虚拟连接表、用户和站点。(Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)。)
- **外部资产：**与 Tableau 内容关联的数据库（包括数据文件）和表（包括类似表的对象）。
    
    Catalog 将来自 Tableau 环境外部的外部资产的元数据进行分类。外部资产可以以多种不同的格式存储，例如数据库服务器或本地 .json 文件。
    
    Catalog 仅跟踪外部数据的元数据，不会跟踪任何形式的基础数据（原始或聚合）。

Catalog 元数据包括以下各项： 

- **世系信息**或者各项之间的关系。例如，“Sales”（销售额）表与 Superstore 数据源和 Superstore Sample 工作簿都有关系。
- **架构信息**。一些示例包括：
    - 表名称、列名和列类型。例如，表 A 包含列 A、B 和 C，其类型为 INT、VARCHAR 和 VARCHARINT。
    - 数据库名称和服务器位置。例如，Database\_1 是位于 http://example.net 的 SQL Server 数据库。
    - 数据源名称，以及该数据源包含的字段的名称和类型。例如，Superstore 数据源包含字段 AA、BB 和 CC。字段 CC 是同时引用字段 AA 和字段 BB 的计算字段。
- **用户存储**、添加或管理的信息。例如，项目说明、认证、用户联系人、数据质量警告等。

### Tableau Catalog 的工作方式

Tableau Catalog 对发布到 Tableau Cloud 或 Tableau Server 的所有内容进行索引，以跟踪世系和架构元数据。例如，元数据来自工作簿、打包工作簿、数据源，以及 Tableau Server 或 Tableau Cloud 存储库。

作为索引过程的一部分，还会对发布的内容使用的外部资产（数据库、表和其他对象）的世系和架构元数据进行索引。

**注意：**除了通过 Tableau Cloud 或 Tableau Servern 访问 Catalog 外，还可以通过 Tableau 元数据 API 和 Tableau Server REST API 访问编入索引的元数据。有关 Tableau 元数据 API 或 REST API 中的元数据方法的详细信息，请分别参见 [Tableau 元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html) 以及 Tableau Server REST API 中的[元数据方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm)。

## 元数据权限

权限控制允许谁查看和管理外部资产，以及将通过世系显示什么元数据。

**注意：**如果 Tableau Cloud 或 Tableau Server 不是使用 Data Management 获得许可的，则默认情况只有管理员才能通过 Tableau 元数据 API 查看数据库和表元数据。

### 访问元数据

用于通过 Catalog（或元数据 API）访问元数据的权限与用于通过 Tableau Cloud 或 Tableau Server 访问内容的权限工作方式类似，对于可能会通过世系和针对外部资产授予的能力公开的敏感数据有一些额外的注意事项。

#### Tableau 内容的权限

Catalog 采用现有 Tableau 内容上已有的查看和管理能力来控制您可查看和管理的 Tableau 内容相关元数据。有关这些能力的更多常规信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#permissioncapabilities)。

#### 使用_派生权限_的外部资产权限

如果 Tableau Cloud 或 Tableau Server 是使用 Data Management 获得许可的，Catalog 将默认使用_派生权限_为您自动授予对外部资产的相关能力。派生权限是对外部资产的权限，这些权限派生自与之关联的 Tableau 内容。

“查看”能力：

- 如果您是工作簿、数据源或流程的所有者，则可以查看该工作簿、数据源或流程_直接_使用的数据库和表元数据。 请参见[有关世系的其他注意事项](#addnotes)。
- 如果您是项目所有者或项目主管，则可以查看发布到您的项目的内容所使用的所有数据库和表元数据。
- 嵌入式文件使用源内容（例如工作簿、数据源或流程）的权限，而不是外部资产（数据库或表）的派生权限。举例来说，如果您可以看到带有嵌入式文件的工作簿，则可以看到该工作簿使用的嵌入式文件及其元数据。

“覆盖”和“设置权限”能力：

- 如果您是流程的所有者，则可以编辑和管理流程输出使用的数据库和表元数据的权限。

**注意：**对于流程，只有在流程已使用当前所有者身份至少成功运行一次后，上述功能才适用。

**检查权限**

作为管理员或者已被授予为资产权限设置能力的用户，您可通过执行以下步骤来验证谁具有派生权限。

1. 登录到 Tableau Cloud 或 Tableau Server。
2. 从左侧的导航窗格中，单击“外部资产”。
3. 从下拉菜单中，选择“数据库和文件”或“表和对象”。  
    **注意：**本地文件（比如 .json 或 .csv 文件）在“数据库”下分组为外部资产。
4. 选中要修改其权限的数据库或表旁边的复选框，然后选择“操作”\>“权限”。
5. 在“权限”对话框中，单击“+添加组/用户规则”并开始键入以搜索组或用户。
6. 通过单击权限规则中的组名称或用户名来验证权限，在下面查看有效的权限。
    
    ![显示用户有效权限的权限对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_perms_derived.png)

**外部资产上派生权限的优先顺序**

如果为 Tableau Cloud 站点或 Tableau Server 配置了派生权限，则每个用户对外部资产的访问级别取决于关联的 Tableau 内容以及 Tableau 为其内容使用的规则优先顺序。

Tableau 将按以下规则执行，并且只有在当前规则的评估结果为“已拒绝”时，才会继续评估下一条规则。如果任何规则的评估结果为“已允许”，则该能力将得到允许，并且 Tableau 将停止评估。此规则列表基于[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#EvaluatePermRules)。

对于“查看”能力：

1. 管理角色
2. 许可证
3. 项目主管（Tableau 内容）
4. 项目所有者（Tableau 内容）
5. 内容所有者（Tableau 内容）
6. _派生权限_（仅适用于外部资产和“查看”能力）
    1. 管理角色
    2. 许可证
    3. 项目主管（外部资产）
    4. 项目所有者（外部资产）
    5. 内容所有者（外部资产）
7. 显式权限

对于“覆盖”和“设置权限”能力： 

1. 管理角色
2. 许可证
3. 项目主管（Tableau 内容）
4. 项目所有者（Tableau 内容）
5. 内容所有者（Tableau 内容）
6. 显式权限（Tableau 内容）
7. _派生权限_（对于流程输出，仅适用于外部资产以及“覆盖”和“设置权限”能力）
    1. 管理角色
    2. 许可证
    3. 项目主管（外部资产）
    4. 项目所有者（外部资产）
    5. 内容所有者（外部资产）

**关闭派生权限**

作为管理员，您可以为站点关闭派生权限默认设置，以便手动授予对数据库和表的显式权限。

1. 以管理员身份登录到 Tableau Cloud 或 Tableau Server。
2. 从左侧的导航窗格中，单击“设置”。
3. 在“常规”选项卡上的“自动访问数据库和表相关元数据”下，清除“为授权用户自动授予对数据库和表相关元数据的访问权限”复选框。
    
    **注意：**即使未选中该复选框，用户可通过派生权限查看的数据库和表数据质量警告对于这些用户仍然可见。

### 对个别外部资产设置权限

为了向其他用户授予查看、编辑（覆盖）和管理外部资产的权限，站点管理员可以针对个别数据库或表为用户或组明确授予这些能力。

从 Tableau Server 2022.3 和 Tableau Cloud 2022 年 9 月版开始，您可以在项目中组织外部资产。如[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#permissionfundamentals)主题中所述，外部资产的权限继承的工作方式与 Tableau 内容的工作方式相同，并且可以简化权限管理。

**权限能力摘要**

下表显示了可为外部资产设置的能力：

<table class="table--plain"><colgroup><col style="width: 25%;"><col><col style="width: 25%;"></colgroup><tbody><tr><th>能力</th><th>描述</th><th>模板</th></tr><tr><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_view_icon.png" alt="“查看”图标"> 查看<br></p></td><td><p>查看数据库或表资产。</p></td><td>视图</td></tr><tr><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_save_icon.png" alt="“保存”图标。"> 覆盖</p></td><td><p>添加或编辑数据库或表资产的数据质量警告和说明。在版本 2020.1 之前，“覆盖”能力称为“保存”。</p></td><td>发布</td></tr><tr><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_move_icon.png" alt="“移动”图标。">移动</p></td><td>移动数据库或表资产。</td><td>管理</td></tr><tr><td><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/perms_setperms_icon.png" alt="“设置权限”图标。"> 设置权限</p></td><td><p>为数据库或表资产授予或拒绝权限。</p></td><td>管理</td></tr></tbody></table>

**对数据库或表设置权限**

若要对数据库或表设置权限，请使用以下过程。

1. 以管理员或已被授予“设置权限”能力的用户身份登录到 Tableau Cloud 或 Tableau Server。
2. 查找数据库或表。如果您知道数据库或表的当前位置，可以通过“浏览”e（从 Tableau Server 2022.3 和 Tableau Cloud 2022 年 9 月开始）来完成此操作，或者通过“外部资产”来查看所有数据库、表和文件的列表。
    
    - 浏览 - 从左侧导航窗格中，单击“浏览”并找到数据库或表所在的项目。
    - 外部资产 - 从左侧导航窗格中，单击“外部资产”。从下拉菜单中，选择“数据库和文件”或“表和对象”（注意：本地文件，如 .json 或者 .csv 文件在“数据库”下被分组为外部资产。）
3. 选中要修改其权限的数据库或表旁边的复选框，然后选择“操作”\>“权限”。
4. 在“权限”对话框中，单击“+添加组/用户规则”并开始键入以搜索组或用户。
5. 选择一个权限角色模板以为组或用户应用初始能力集，然后单击“保存”。可用模板包括：“查看”、“发布”、“管理”、“无”和“已拒绝”。
6. 若要进一步自定义规则，请单击规则中的一个能力，将其设置为“已允许”或“已拒绝”，或将其保留为“未指定”。完成后单击“保存”。
7. 为其他用户或组配置所需的任何其他规则。
8. 通过单击权限规则中的组名称或用户名来验证权限，在下面查看有效的权限。
    
    ![adventureworks 数据库的用户权限](/tableau/next/zh-cn/online/zh-cn/Img/dm_perms_set.png)

**不在项目中的外部资产**

在某些情况下，外部资产不在项目中：

- Catalog 在外部资产默认项目（Tableau Cloud 2022 年 12 月版/Server 2023.1）存在之前发现的外部资产将不会位于项目中，除非它们从那时起被移到一个项目中。
- 在外部资产默认项目（Tableau Cloud 2022 年 12 月版/Server 2023.1）存在之前已删除其项目的外部资产将不会位于项目中，除非它们从那时起被移到一个项目中。
- 在 Tableau Server 2022.1 及更低版本中，外部资产根本无法移到项目中。

如果外部资产不在项目中，则外部资产的权限与 Tableau Server 2022.1 和 Tableau Cloud 2022 年 6 月版及更早版本中的权限一样。也就是说，数据库和表权限是独立于项目中的内容来控制的，并且表权限可以通过数据库权限来管理。当以这种方式在数据库级别设置权限时，这些权限可以作为该数据库中任何新发现和索引的子表的模板。此外，还可以锁定数据库权限，以便子表始终使用在数据库级别设置的权限。

注意：如果数据库在项目中，则不能锁定（或解锁）该数据库的权限。

若要锁定（或解锁）数据库权限，请使用以下过程：

1. 以管理员或已被授予“设置权限”能力的用户身份登录到 Tableau Cloud 或 Tableau Server。
2. 从左侧的导航窗格中，单击“外部资产”。默认情况下，“外部资产”页面显示数据库和文件的列表。
3. 选中要锁定其权限的数据库旁边的复选框，选择“操作”\>“权限”，然后单击表权限“编辑”链接。
4. 在“数据库中的表权限”对话框中，选择“已锁定”，然后单击“保存”。
5. 若要解锁权限，请再次单击“编辑”，然后选择“自定义”。

### 访问世系信息

Catalog（和元数据 API）可以在 Tableau Cloud 或 Tableau Server 上的 Tableau 内容和外部资产之间公开关系和依赖项元数据（也称为_世系_）。世系显示三项主要内容：

- 项目如何直接或间接地彼此相关
- 这些项目中有多少彼此相关
- 使用适当的权限，显示有关世系中的项目的敏感数据

**敏感世系数据**

在某些情况下，世系可能包含敏感数据，例如数据质量警告消息、内容或资产名称，或者相关的项目和元数据。

默认情况下，完整的世系信息将为所有用户显示， 同时针对没有适当“查看”能力的特定用户屏蔽其敏感数据。屏蔽敏感数据的概念称为模糊处理。

模糊处理允许世系中的所有元数据可见，同时针对没有适当“查看”能力的特定用户屏蔽敏感数据。此默认值支持依赖于完整影响分析的工作流。

如果对组织而言，对世系中的敏感数据进行模糊处理并不足够，则可以筛选世系的某些部分，包括其敏感数据。

通过筛选，可以针对没有敏感数据的适当“查看”能力的特定用户忽略世系（以及世系相关区域，比如数据详细信息）的某些部分。由于筛选会忽略了世系的某些部分，因此它会阻止依赖于完整影响分析的工作流。

若要更改敏感数据的处理方式，请执行以下操作：

1. 以管理员身份登录到 Tableau Cloud 或 Tableau Server。
2. 从左侧的导航窗格中，单击“设置”。
3. 在“常规”选项卡上的“敏感世系信息”下，选择最适合于针对 Tableau Cloud 站点或 Tableau Server 上的所有用户处理世系信息的单选按钮。

**有关世系的其他注意事项**

- **如果您有相关资产的“查看”能力**，您将能看到什么资产和内容何时彼此相关，以及它们的敏感元数据。
    
    例如，您可以看到 1) 相关上游数据库和表的名称、数据质量警告和总数，以及 2) 所评估资产的下游工作簿的世系内的（可见和隐藏）工作表总数。
- **如果您_没有_相关资产的“查看”能力，**您始终可以看到资产何时彼此相关。
    
    例如，您可以查看 1) 相关的上游数据库和表是否存在于世系中，以及 2) 与您所评估的资产相关的数据库总数或表总数。
    
    但是，如果您没有这些资产的查看能力，则无法查看与之关联的元数据。当元数据由于权限受限而被阻止时，或者资产位于个人空间中时，您将看到“需要权限”。
    
    ![需要许可的资产示例](/tableau/next/zh-cn/online/zh-cn/Img/dm_perms_required_related.png)
- **如果您_没有_相关资产的“查看”能力，**您始终可以看到这些资产是否已获得认证。
    
    但是，如果您没有“查看”能力，就看不到与认证相关的敏感信息，比如相关数据库和表的名称。当元数据由于权限受限而被阻止时，或者资产位于个人空间中时，您将看到**“需要权限”**。
    
    ![需要许可的资产示例](/tableau/next/zh-cn/online/zh-cn/Img/dm_perms_required_cert_message.png)
    
    有关世系的详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm)。

**有关可通过世系数据发现的标记的其他注释**

除了 Tableau 内容之外，还可以对外部资产进行标记。尽管标记始终可见，但通过世系数据看到的标记项可能会被模糊处理（默认操作）或筛选，如本主题前面所述。

当标记项被模糊处理时：

- **如果您具有标记项的“查看”能力功能**，则可以看到标记项和相关标记项，以及所有元数据。
- **如果您没有标记项的“查看”能力**：
    
    - 您可以查看标记项和相关标记项的类型，但看不到有关这些项的敏感元数据。例如，假设您使用标记筛选器来查看带“值得注意”标记的项。尽管您可以看到标有“值得注意”的数据库项，但您看不到已标记数据库的名称。
    - 您可以查看有多少相关的标记项。例如，假设您对“值得注意”执行标记查询。查询返回五个标记数据库。

筛选标记项时，您看到的标记项和相关标记项仅限于您对其具有“查看”能力的项。

有关标记的详细信息，请参见 Tableau 用户帮助中的[标记项](https://help.tableau.com/current/pro/desktop/zh-cn/tags.htm)。

资产结果和内容结果之间的潜在不匹配

当 Catalog 显示世系信息时，它会提供有关 Tableau 内容和外部资产的信息。Catalog 世系始终显示关联项目的真正计数或结果。但是，在站点的其他区域，您可能会看到较少的项目。这可能是因为您的“查看”能力导致的。在 Catalog 之外，您只能看到您的权限允许的内容。

例如，假设您正在查看 Superstore 数据源。Superstore 数据源的世系显示该数据源连接到多个上游基础表，以及多少下游工作簿依赖于该数据源。但是，因为您可能没有查看所有下游工作簿的权限，所以 Catalog 世系中相关工作簿的数量（实际总数）可能大于“连接的工作簿”选项卡中工作簿的数量（您有权查看的数量）。

之所以您可能会看到资产计数与内容计数不匹配，可能还有其他与权限无关的原因。有关详细信息，请参见[为影响分析使用世系](https://help.tableau.com/v0.0/online/zh-cn/dm_lineage.htm)。

## 谁可以执行此操作

以下信息总结了可以执行本主题中描述的任务的用户类型。

Tableau Cloud 站点或 Tableau Server 管理员

<table style="width: 100%;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" style="width: 277px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1"><span class="mc-variable Variables.DM_sku variable">Data Management</span></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" rowspan="6"><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">编辑资产及其元数据</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">更改资产及其元数据的权限</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">授予用户查看资产及其元数据的能力</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>默认值：</b>启用“派生权限”时，用户可以查看他们拥有的内容的外部资产相关元数据，或者发布到他们作为项目主管或项目所有者的项目的内容相关元数据。</p><p><b>临时：</b>您可以配置对指定外部资产的显式<span class="uicontrol">“查看”</span>权限。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">授予用户编辑资产及其元数据的能力</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您可以配置对指定外部资产的显式“写入”或<span class="uicontrol">“覆盖”</span>权限（如果由于用户是流程所有者而未自动授予）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">授予用户更改资产及其元数据的权限的能力</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您可以配置对指定外部资产的显式“编辑”或<span class="uicontrol">“设置权限”</span>权限（如果由于用户是流程所有者而未自动授予）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="6"><b>未许可</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">查看所有资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>仅适用于元数据 API</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">编辑资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">更改资产及其元数据的权限</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">授予用户查看资产及其元数据的能力</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>仅适用于元数据 API：</b></p><p>您可以按上述方式启用派生权限。如果“派生权限”已启用，用户可以查看他们拥有的内容的外部资产相关元数据，或者发布到他们作为项目主管或项目所有者的项目的内容相关元数据。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">授予用户编辑资产及其元数据的能力</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="background-color: #dcdcdc;">需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">授予用户更改资产及其元数据的权限的能力</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1" style="background-color: #dcdcdc;">需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span></td></tr></tbody></table>

具有 Creator 或 Explorer 许可证的用户

<table style="width: 100%;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" style="width: 277px;"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1"><span class="mc-variable Variables.DM_sku variable">Data Management</span></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" rowspan="3"><b>已许可</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">查看资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>默认值：</b>当 Tableau Cloud 站点管理员或 Tableau Server 管理员启用“派生权限”后，您可以查看自己拥有的内容的外部资产相关元数据，或者发布到您作为项目主管或项目所有者的项目的内容相关元数据。</p><p><b>临时：</b>您可以查看您已被授予其显式<span class="uicontrol">“查看”</span>权限的外部资产的相关元数据。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">编辑资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您可以编辑您已被授予显式“写入”或<span class="uicontrol">“覆盖”</span>权限的外部资产的相关元数据（如果由于用户是流程所有者而未自动授予）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">更改资产及其元数据的权限</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您可以更改您已被授予显式“编辑”或<span class="uicontrol">“设置权限”</span>权限的外部资产的权限（如果由于用户是流程所有者而未自动授予）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">&nbsp;</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">授予其他用户查看资产及其元数据的权限</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">您可以更改您已被授予显式“编辑”或<span class="uicontrol">“设置权限”</span>权限的外部资产的权限（如果由于用户是流程所有者而未自动授予）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" rowspan="4"><b>未许可</b></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">查看资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>仅适用于元数据 API：</b></p><p>如果 Tableau Cloud 站点管理员或 Tableau Server 管理员启用了“派生权限”，您可以查看自己拥有的内容的外部资产相关元数据，或者发布到您作为项目主管或项目所有者的项目的内容相关元数据。</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">编辑资产及其元数据</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="3" style="background-color: #dcdcdc;"><p rowspan="5">&nbsp;</p><p rowspan="5">需要 <span class="mc-variable Variables.DM_sku variable">Data Management</span></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">更改资产及其元数据的权限</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">授予其他用户查看资产及其元数据的权限</td></tr></tbody></table>

<!-- document id=946e45524b26fad52b0837901944674776d318be457b15364b7ef9ee5e329a19 url=/tableau/next/zh-cn/online/to_publish.md -->

[跳转到主要内容](#main-content)

# 管理数据

使用您的徽标和身份验证选项配置 Tableau Cloud 站点之后，您可以针对自己或用户想要用于分享 Tableau 数据的方式开始组织_内容_框架。为了用内容（数据、报表等）填充 Tableau Cloud 站点，您或组织中的数据专家将_发布_该内容。根据许可证的类型，用户可从 Tableau Desktop 或 Tableau Cloud 编辑环境中连接到内容和发布内容。

可发布的内容的类型包括用户可在多个工作簿之间共享的独立数据源，以及包含_嵌入式_数据连接及基于该数据的可视化项的工作簿。每种类型都有优缺点，下面的[发布资源](#publishing-resources-user-help-links)中对这些优缺点进行了说明。

## 确定组织的发布需求

作为站点管理员，在打开站点进行发布之前，请评估您认为准备工作在多大程度上适合于您的 Tableau Cloud 使用级别：

- 如果您对数据访问权限没有严格的要求 — 您只有少数几个全部共享相同数据的用户 — 您可以深入研究[发布资源](#publishing-resources-user-help-links)，先执行发布步骤，然后随着操作的进行调整您的发布和内容管理做法。
- 如果组织中不同领域的用户使用 Tableau，或者您有大量的 Tableau 用户，我们建议使用[发布资源](#publishing-resources-user-help-links)创建一个测试环境，并解决访问和可发现性问题。您仍然可以随着操作的进行调整做法，但在向一大群活跃用户开放站点之后，想要进行调整将不会很容易。
    
    举例来说，您可能需要考虑授权（有关谁可以访问什么内容的权限）、数据安全性和合规要求这些其他因素，以便在发生用户弄不清在何处发布或查找您的数据等情况时，尽可能无需联系您来获得帮助。有关详细信息，请参见[为托管自助服务配置项目、组、组集和权限](https://help.tableau.com/v0.0/online/zh-cn/projects_data_gov.htm)。

### 发布过程摘要

在 Tableau Desktop 中，您打开要上载到 Tableau Cloud 的工作簿或数据连接，并转到“服务器”菜单来发布工作簿或数据连接。

在执行发布步骤的过程中，您登录到 Tableau Cloud，同时输入 Tableau Cloud 地址 (https://online.tableau.com) 和您的凭据。

发布步骤要求您做出以下相关决定：您和组织中的其他人将如何访问您的数据源或工作簿。在某些情况下，这可能涉及几种复杂程度，并可帮助您了解这几种复杂程度如何组合在一起。使用以下列表中的主题来确定您需要的复杂程度，并帮助建立相应的发布准则。

### 发布资源

这些资源是 Tableau 用户帮助的一部分，并将在 Web 浏览器窗口中打开。

- **发布概念**
    
    [准备发布工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_prepare.htm)
    
    [发布数据源和工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/publish_overview.htm)
    
    [发布的数据源的最佳做法](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources_about.htm)
- **用于非正式协作的基本发布步骤**
    
    [用于共享工作簿的简单步骤](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_share.htm)
- 用于满足合规和安全性标准、创建数据“信任来源”以及使用最佳做法的全面数据源规划和发布步骤
    
    [计划数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_plan.htm "在新浏览器选项卡中打开链接的文章")
    
    [发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources.htm)
    
    [发布工作簿](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_howto.htm)

## Tableau Cloud 存储限制

站点对于工作簿和数据提取有 1 TB 的存储限制。存储限制不可配置。对于需要更多存储空间的企业，Tableau+ 或 Tableau Enterprise 许可可能是一个不错的选择。有关详细信息，请参见[了解许可证模式](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm)。

有关 Tableau Cloud 的其他技术规格，请参见 Tableau 网站上的[技术规格](https://www.tableau.com/zh-cn/products/techspecs)。

## Tableau Cloud 数据连接支持

您可以使用基础数据库直接（实时）连接或数据提取与基础数据库的连接来发布数据源和工作簿。您还可以发布使用任何一种或这两种类型的连接的多连接数据源。工作簿或数据源中定义的数据库连接决定了在 Tableau Cloud 上发布数据并使数据保持最新的方法。

如果您熟悉连接类型，并且想要更具体的数据类型列表及其支持的连接，请参见[使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm)。否则，请继续阅读。

### 支持直接（实时）连接到 Tableau Cloud 的连接器类型

当您使用实时连接时，发布的工作簿和数据源始终反映了基础数据库中的最新内容。

Tableau Cloud 支持实时连接：

- 云平台上托管的 Google BigQuery、Amazon Redshift 数据或基于 SQL 的数据；例如 Amazon RDS、Microsoft SQL Azure 或类似的服务。
    
    对于云数据直接连接，您通常需要将 Tableau Cloud 添加到数据提供程序的授权列表中。
- 使用 Tableau Bridge 维护连接时的本地关系数据，如 SQL Server 或 Oracle 数据。
    
    若要了解有关 Tableau Bridge 的更多信息，请参见[使用 Tableau Bridge 使数据保持最新](https://help.tableau.com/current/online/zh-cn/qs_refresh_local_data.htm)。

您可以在实时连接中嵌入数据库凭据，以便所有访问已发布内容的用户都可以查看基础数据。或者您可以要求用户提供自己的数据库凭据。在这种情况下，即使他们可以在服务器上打开已发布的内容，他们也需要登录基础数据库才能看到它。

### 支持数据提取连接的连接器类型

对于 Tableau 可连接到的任何数据类型，用户可以发布包含嵌入式数据库凭据的数据提取，并设置重复性刷新计划。

您可以在启动发布流程前在 Tableau Desktop 中创建数据提取，以更好地控制连接定义。如果要发布数据样本，或设置增量刷新功能，则可以执行此操作。否则，Tableau 会在发布过程中创建数据提取，您只能进行完全刷新。

Tableau 完成发布步骤后，它将引导您完成用于设置计划和刷新数据的步骤。如果 Tableau 数据源或工作簿连接到云中的基础数据，则会直接从 Tableau Cloud 中运行刷新。如果基础数据位于本地网络上，您可以使用 Tableau Bridge。

若要了解有关 Tableau Bridge 的更多信息，请参见[使用 Tableau Bridge 使数据保持最新](https://help.tableau.com/current/online/zh-cn/qs_refresh_local_data.htm)。

## 此部分中的其他文章

<!-- document id=328d7ad04a780483a6aad58945b15b9c4d5953d615f6fe7a9eff2990d25e1d6f url=/tableau/next/zh-cn/online/dm_labels_manage.md -->

[跳转到主要内容](#main-content)

# 管理数据标签

从 Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 开始，如果您有 Data Management 许可证并且是管理员，您可以使用标签管理器创建或编辑标签名称和标签类别。当用户与标签交互时，这些自定义项会影响标签在整个 Tableau 中的显示方式。

注意：您还可以使用 REST API 的 labelValues 方法和 labelCategories 方法来创建和编辑标签和标签类别。（自 Tableau Cloud 2023 年 6 月版起，Tableau Cloud 管理员已能够使用 labelValues 方法创建和修改标签名称和描述。）有关详细信息，请参见 [REST API 参考](https://help.tableau.com/v0.0/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm)中的“元数据方法”。

## 标签管理器

若要使用标签管理器，请以管理员身份登录并从左侧导航窗格中选择“数据标签”。

![使用“数据标签”菜单项访问“数据标签”页面](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_data_labels_menu_item.png)

或者，如果您以管理员身份登录并打开“数据标签”对话框来标记资产，则会在左下角显示“管理标签”链接。“管理标签”链接可通往“数据标签”页面。（在 Tableau Server 2023.3 及更低版本中， “管理标签”链接显示在个人认证、数据质量警告、敏感度标签和自定义标签对话框的标签选择下拉列表中。）

![使用“管理标签”链接访问“数据标签”页面](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_alt_entry_point_248.png)

标签管理器页面为每个标签显示一行，并按标签类别排序。每行包括标签类别、名称（此处称为值）、用于对该标签执行操作的“操作”菜单 (...)、可见性和描述。

![“数据标签”页面和标签列表](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_label_list_246.png)

使用标签管理器可以：

- **编辑内置标签**
    - 示例：将内置“维护中”质量警告的名称更改为“维护模式”。
    - 示例：您将数据提取刷新监控标签的可见性从标准可见性更改为高可见性，以便它们显示在视图中。
- **创建现有内置类别的新标签**
    - 示例：您添加一个名为“机密”的新敏感度标签。
- **将内置标签恢复为其默认名称、描述和可见性**
    - 示例：您之前将“过时数据”质量警告名称更改为“过时”，并且希望将其恢复为默认名称。
- **创建自定义类别**
    - 示例：您创建一个名为“部门”的新标签类别，旨在为不同业务部门添加标签。
- **在自定义类别中创建新标签**
    - 示例：您为新创建的“部门”类别创建新的“销售”、“服务”和“运营”标签。

## 数据标签的属性

标签具有名称、类别和描述。具有质量警告或敏感度类别的标签也具有可见性级别。

### 名称

标签名称是标签出现在不同位置时的通用名称。例如，此处在“数据标签”对话框的“质量警告”选项卡中选择了标签名称“Deprecated”。

![数据质量警告对话框中的标签名称](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_value_name.png)

这里，标签名称“Warning”显示在“Batters”表页面的顶部，并再次显示在标签详细信息中。

![表页面顶部的标签名称](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_value_name_on_sticker.png)

### 类别

标签类别会影响标签的显示位置和方式、标签是否显示在其所附加的下游资产上以及哪些部分是可自定义的等。例如，质量警告和敏感度标签出现在下游资产上，但其他类别的其他标签则不会出现。另一个例子：您可以更改认证标签的描述，但不能更改名称。

内置类别包括“认证”、“质量警告”和“敏感度”。

对于自定义类别，用户可以在“数据标签”对话框的垂直类别选项卡等位置看到类别名称。例如，这里类别名称“Department”出现在垂直类别选项卡中、标签名称列表的顶部等地方。

![“更多数据标签”对话框中的类别选择](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_category_in_data_labels_dialog_248.png)

### 描述

标签描述出现在不同的位置，包括“数据标签”对话框中，并帮助用户了解标签的用途。例如，此质量警告的标签描述显示“此资产不再维护，不应使用”。

![“数据质量警告”对话框中的标签描述](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_value_description.png)

### 可见性

标签的可见性决定了它的外观。高可见性标签出现在更多地方，并且对用户来说可能显得更紧急。您只能设置质量警告或敏感度标签的可见性级别。此外，如果标签具有质量警告类别，则具有权限的用户可以覆盖他们附加质量警告标签的每个资产的默认可见性。有关详细信息，请参见[“设置数据质量警告”](https://help.tableau.com/v0.0/online/zh-cn/dm_dqw.htm#high_visibility)和[“敏感度标签”](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_sensitivity.htm#visibility)主题。

## 创建数据标签

若要创建标签：

1. 从“数据标签”页面中，选择“新建标签”。
2. 从“标签”类别下拉列表中选择一个类别。
3. 在“标签值”字段中输入标签名称。
4. 在“标签描述”字段中输入标签描述。您可以使用粗体、下划线和斜体来设置文本的格式，并包含链接或图像。若要查看文本格式设置提示，请光标悬停在“保存”按钮上方的信息 (i) 图标上。
5. 如果标签的类别为“质量警告”或“敏感度”，请设置可见性级别。有关详细信息，请参见[可见性](#Visibility)。
6. 选择“保存”。

![“新建标签”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_new_label_248.png)

### 创建标签的限制

- 您无法在认证类别中创建标签。认证类别仅允许单个内置标签。
- 您无法创建新的监控警告。但是，数据提取刷新失败警告和流程运行失败警告可以通过有限的方式进行编辑，如“编辑标签”部分所述。
- 在 Tableau Cloud 和 Tableau Server 2024.2 及更高 版本中，标签名称的最大长度为 128 个字符。在 Tableau Server 2023.3 及更低版本中，标签名称的最大长度为 24 个字符。
- 标签描述的最大长度为 500 个字符。

## 编辑数据标签

若要编辑现有标签：

1. 从“数据标签”页面中，选择标签行中的“操作” (...) 菜单。或者使用左侧的复选框选择该行，然后单击标签列表顶部的“操作”下拉列表。
2. 选择“编辑”。
3. （可选）使用“标签值”字段更改标签名称。
4. （可选）使用“标签描述”字段更改标签描述。
5. （可选）如果标签具有“质量警告”或“敏感度”类别，请设置可见性级别。有关详细信息，请参见[可见性](#Visibility)。
6. 选择“保存”。

### 编辑标签的限制

- 您无法更改现有标签上的类别。
- 在 Tableau Cloud 和 Tableau Server 2024.2 及更高 版本中，标签名称的最大长度为 128 个字符。在 Tableau Server 2023.3 及更低版本中，标签名称的最大长度为 24 个字符。
- 标签描述的最大长度为 500 个字符。

不同的标签类别允许不同程度的标签编辑。下表列出了给定类别的标签的可编辑属性：

<table class="table--plain"><colgroup><col><col><col><col><col></colgroup><tbody><tr><td><p><strong>标签类别</strong></p></td><td><p><strong>可以编辑标签类别</strong></p></td><td><p><strong>可以编辑标签名称</strong></p></td><td><p><strong>可以编辑标签描述</strong></p></td><td><p><strong>可以编辑标签可见性</strong></p></td></tr><tr><td><p>认证</p></td><td><p>否</p></td><td><p>否</p></td><td><p>是</p></td><td><p>不可用</p></td></tr><tr><td><p>质量警告</p></td><td><p>否</p></td><td><p>是<sup>1</sup></p></td><td><p>是</p></td><td><p>是<sup>2</sup></p></td></tr><tr><td><p>敏感度</p></td><td><p>否</p></td><td><p>是</p></td><td><p>是</p></td><td><p>是</p></td></tr><tr><td><p>自定义</p></td><td><p>否</p></td><td><p>是</p></td><td><p>是</p></td><td><p>不可用</p></td></tr></tbody></table>

1_您无法编辑数据提取刷新或流程运行监控警告的标签名称（标签值）。_  
2_您为质量警告设置的可见性级别是默认可见性。拥有权限的用户在向资产附加质量警告时可以覆盖默认可见性。有关详细信息，请参见_[可见性](#Visibility)_。_

## 删除数据标签

若要删除现有标签：

1. 从“数据标签”页面中，选择标签行中的“操作” (...) 菜单。或者使用左侧的复选框选择该行，然后单击标签列表顶部的“操作”下拉列表。
2. 选择“删除”。

### 删除标签的限制

- 您无法删除内置标签。内置标签是 Tableau Cloud 中的默认标签。

## 将内置数据标签恢复为其默认值

如果管理员之前编辑过内置标签，则该标签的“操作”菜单将包含“恢复为默认标签” 。将标签恢复为其默认值会将标签的名称（值）、描述和可见性恢复为其内置默认值。

![将内置标签恢复为其默认值](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_revert_built-in_label_246.png)

## 创建数据标签类别

若要创建标签类别：

1. 从“数据标签”页面中，选择“新建标签”。
2. 在“新建标签”对话框中，选择“新建类别”。
3. 在“类别名称”字段中输入类别名称。
4. 在“类别描述”字段中输入类别描述。您可以使用粗体、下划线和斜体来设置文本的格式，并包含链接或图像。若要查看文本格式设置提示，请光标悬停在“保存”按钮上方的信息 (i) 图标上。
5. 选择“保存”。

![“添加新类别”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_manager_new_category_248.png)

### 创建标签类别的限制

- 在 Tableau Cloud 和 Tableau Server 2024.2 及更高 版本中，类别名称的最大长度为 128 个字符。在 Tableau Server 2023.3 及更低版本中，类别名称的最大长度为 24 个字符。
- 类别描述的最大长度为 500 个字符。

## 编辑数据标签类别

若要编辑标签类别：

1. 在“数据标签”页面中，选择标签类别，然后选择铅笔图标。或者从“新建标签”或“编辑标签”对话框中，在“标签类别”下拉列表中选择类别，然后选择“类别描述”旁边的铅笔图标。
2. （可选）使用“类别名称”字段更改类别名称。
3. （可选）使用“类别描述”字段更改类别描述。
4. 选择“保存”。

### 编辑标签类别的限制

- 您无法编辑内置类别。
- 在 Tableau Cloud 和 Tableau Server 2024.2 及更高 版本中，类别名称的最大长度为 128 个字符。在 Tableau Server 2023.3 及更低版本中，类别名称的最大长度为 24 个字符。
- 类别描述的最大长度为 500 个字符。

## 删除数据标签类别

当前没有方法通过常规 Tableau Cloud 界面删除标签类别。若要使用 REST API 删除类别，请参见 REST API 参考中的[删除标签类别方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm#delete_label_category)。

## 适用于自定义项的场景

### 场景：自定义内置数据标签

假设您决定名为“警告”的数据质量警告可以更具体。作为管理员，您可以将标签名称从默认值（“警告”）更改为您认为对您的组织更有用的名称：“未批准”。当用户选择标签时，标签名称“未批准”现在会显示在标签对话框中。

或者，您可以更改标签描述，以便用户了解有关标签对话框中的警告的详细信息。例如：“此资产不符合营销部门要求的质量标准。”

### 场景：创建自定义数据标签

假设您希望用户对资产敏感度分类有更精细的控制。您创建两个敏感度标签，名称分别为“Public”和“PII”。自定义标签名称“Public”和“PII”现在与内置敏感度标签值一起显示在标签对话框下拉列表和描述中。

### 场景：创建新的数据标签类别和关联的数据标签

假设您需要一种方法来识别负责资产的业务部门。您创建一个名为“部门”的标签类别。然后，您创建三个标签 -“销售”、“服务”和“运营” - 类别为“部门”。“部门”类别和三个关联标签现在显示在“更多数据标签”对话框中，供用户附加到资产。

<!-- document id=da7249e4754a8e662751c46e2f2cc05f6a24771f41652bff7720d3da5c1fce69 url=/tableau/next/zh-cn/online/to_bridge_manage.md -->

[跳转到主要内容](#main-content)

# 管理池

有几种方法可以管理池化 Bridge 客户端。

## 监视数据新鲜度任务

您可以使用“作业”页面和内置管理视图的组合来监视客户端活动。

### 实时查询

若要监视实时查询活动，可以使用[到 Bridge 连接数据源的流量](https://help.tableau.com/v0.0/online/zh-cn/adminview_bridge_datasources.htm)管理视图。

### 刷新作业

若要监视刷新作业，可以使用以下资源：

- **“作业”**页面：“作业”页面可以显示使用 Bridge 刷新计划的已完成、正在进行、待定、已取消和挂起的 Bridge 刷新作业。有关详细信息，请参见[关于 Bridge 刷新作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm#bridge)。
- **“非数据提取后台任务”**管理视图：在“通过 Bridge 刷新数据提取”上进行筛选后，此管理视图显示使用刷新计划的 Bridge 刷新作业。有关详细信息，请参见[非数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd_nonextract.htm)。
- **“Bridge 数据提取”**管理视图：此管理视图显示使用 Bridge 刷新计划和 Bridge 旧版计划的 Bridge 刷新作业。有关此视图的详细信息，请参见[Bridge 数据提取](https://help.tableau.com/v0.0/online/zh-cn/adminview_bridge_extract.htm)。
- **使用客户端日志创建数据源或视图：**使用客户端生成的 JSON 日志文件，创建您自己的数据源和视图以监控刷新作业。有关详细信息，请参见下面的[按客户端刷新作业](#json)部分。

### 多个连接方案

对于包含嵌入数据源的 Bridge 数据提取刷新连接，您可以连接到多个 Bridge 客户端，从而允许组合和访问来自多个来源的数据，就像访问单个来源一样。此行为与已发布数据源不同。

必须将多个已发布数据源连接分配给一个 Bridge 客户端。不支持具有冲突连接的池映射。

**方案 1**

数据源 1：Snowflake 的嵌入式数据源，通过 Tableau Cloud 直接连接到数据源。

数据源 2：Snowflake 的已发布数据源，具有与联合本地数据库的连接。

**池映射**

- 对于嵌入式数据源，请勿将 Snowflake 添加到“私有网络允许列表”。从“连接”选项卡编辑连接类型，并将网络类型设置为“Tableau Cloud”。

**注意**：如果数据源可以直接访问 Tableau Cloud，就不需要使用 Bridge。

- 对于与本地数据库具有联合连接的 Snowflake 已发布数据源，请将连接添加到“私有网络允许列表”，从“连接”选项卡编辑连接类型，并将网络类型设置为“私有网络”。

**方案 2：_不支持_**

- 具有两个连接的已发布数据源：连接 1 分配给“池 1”，连接 2 分配给“池 2”。

### 按客户端刷新作业

作为使用上面列出的管理视图监视刷新作业的替代方法，请考虑创建您自己的数据源和视图来监视 Bridge 客户端执行的刷新。您可以通过使用 Tableau Desktop 连接到运行客户端的计算机上的客户端的 JSON 日志文件来完成此操作。

**注意：**客户端的 JSON 日志文件不会捕获虚拟连接的刷新。

JSON 日志文件由对象“k”和“v”组成。“k”对象捕获刷新作业，“v”对象捕获刷新详细信息。刷新及其详细信息包括：

- 计划类型 - Bridge 刷新或 Bridge 旧版
- 数据源类型和名称
- 刷新起止时间、持续时间、上载发布时间
- 错误

#### 步骤 1：开始之前

如果您想依据一个日志文件的数据构建一个视图，您可以跳转到**“步骤 2”**。

如果客户端的数据位于多个日志文件中，则需要合并这些文件。您可以创建脚本以在本地合并日志文件，或使用 Tableau Desktop 执行合并，如以下过程中所述。

**注意：**

- 下面描述的过程假设您在与客户端相同的计算机上运行 Tableau Desktop。
- 如果您正在处理来自池中不同客户端的多个日志文件，除了为客户端合并多个日志文件之外，您还可以合并来自多个客户端的日志文件以监控池中的刷新。
- 当前不支持直接从 Tableau Cloud Web 制作连接到 JSON 文件。有关详细信息，请参见 [Creator：在 Web 上连接到数据](https://help.tableau.com/current/pro/desktop/zh-cn/creator_connect.htm#open-the-connect-to-data-page)。

#### 步骤 2：连接到 JSON 日志

若要构建数据源和视图，请使用 Tableau Desktop 连接到客户端的日志文件。

1. 启动 Tableau Desktop，并在“连接”下选择“JSON 文件”。执行以下操作：
    
    1. 在“选择架构级别”对话框中，选择顶级架构以包含“k”对象详细信息，并可根据需要选择“v”级别架构以包含“v”对象详细信息，然后单击“确定”。
    2. 导航到要连接到的日志文件（例如，C:\\Users\\jsmith\\文档\\我的 Tableau Bridge 存储库\\Logs），选择它，然后单击“打开”。
2. （可选）在数据源页面，右键单击日志文件，然后单击“转换为并集”以设置并集。执行以下操作：
    
    1. 选择“通配符（自动）”选项卡。
    2. 在“搜索范围”旁边，验证路径是否显示客户端的 Log 文件夹。
    3. 在“匹配模式”下，输入“ExtractRefreshMetrics\_\*”并单击“确定”。
3. 选择工作表标签以开始分析并构建视图。
4. 完成后，将数据源和视图分别发布到 Tableau Cloud。为确保您的数据源保持最新，您可以在发布后为数据源设置 Bridge（旧版）计划。

请注意，您创建的数据源和视图可能会在没有警告的情况下更改，因为在满足特定日志特定限制后，可能会生成新日志文件并删除旧日志文件。有关这些限制以及如何调整它们的详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm)。

## 管理池和客户端

在“池化”部分下，您可以在 Bridge 部署中看到最多五个池化和客户端相关信息表。

**关于池**

第一个表由注册到站点的客户端组成，这些客户端按分配到的池进行组织。

![带有添加新池和表的选项的“池化”对话框，其中包含池名称、池中的客户端、活跃客户端和池状态。 ](/tableau/next/zh-cn/online/zh-cn/Img/bridge_pools_extended.png)

第二个表“未分配的客户端”显示未分配给池的客户端。大多数情况下，这些客户端需要先分配到池中，然后才能对实时查询和数据提取刷新作业进行负载平衡。在其他情况下，此表中的客户端可能专用于使用Bridge（旧版）计划刷新数据源。

![表格显示未分配的客户端，包括计算机名称、所有者、版本、连接状态和上次连接日期。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_pools_unassigned.png)

第三个表“默认池”显示默认池中的客户端。默认情况下，在 Bridge 2021.4 之前配置为使用池化的客户端包含在此池中。由于无法将默认池的域配置为访问特定的私有网络，我们建议您通过创建新池并将其映射到特定域来缩小其访问范围。

![显示计算机名称、所有者、版本、连接状态和上次连接时间的“默认池”表。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_pools_default.png)

您在前三个表中看到的客户端可以告诉您以下信息：

- 客户端名称（也称为计算机名称）是安装并运行客户端的计算机的名称。
- 所有者名称，大多数情况下为站点管理员。这是从客户端向 Tableau Cloud 进行身份验证（登录到其中）的用户。
- 池状态，仅适用于第一个表，可以指示 1) 池中是否有分配的客户端，2) 客户端已连接并可处理数据新鲜度任务，或 3) 池处于脱机状态，因为池中的所有客户端都已断开连接.
- 客户端版本：
    
    - 当客户端未运行最新版本的 Bridge 时，此列中将显示一个警告图标 (![带有感叹号的黄色方块。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_settings_version_warning.png)) 。尽管不是必需的，但我们强烈建议您升级以利用最新的安全性和功能更新。若要下载最新版本的 Bridge，请转到 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面。
        
        **注意：**仅当有较新的客户端可供下载时，警告图标才会显示。警告图标并不表示客户端或相关 Bridge 数据源或虚拟连接存在问题。
- 连接状态 — 有关详细信息，请参见下面的[客户端连接状态](#status)。
- 上次连接 — 显示 Tableau Cloud 上次能够连接客户端的日期和时间。

#### 关于私有网络允许列表

第四个表“允许列表注册表”包含池限定的域列表。

![包含允许域列表的私有网络允许列表。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_pools_allowlist.png)

第五个表“允许列表请求”显示用户在尝试创建虚拟连接时请求连接的待定域。应该尽快处理这些域请求，以解除对用户虚拟连接工作流的阻止。

## 客户端连接状态

在列出客户端的位置，彩色方块和状态标签指示客户端_是否可用于_支持数据新鲜度任务。

- 绿色或“已连接”：绿色或“已连接”状态指明客户端是否已连接并_可支持_实时查询和数据提取刷新。
- 红色或“断开连接”：红色或“断开连接”状态可能表示使客户端暂时处于断开状态的几种情况之一。最常见的情况是，客户端未运行或在启动后无法与 Tableau Cloud 建立通信。可将将光标悬停在状态上来查看描述条件的工具提示。
    
    **注意：**当客户端处于断开连接状态时，实时查询可能会中断。在这种情况下，依赖于具有实时查询的数据源或虚拟连接的视图可能不会正确显示，直到问题得到解决。

上述状态反映您在客户端中看到的状态并与之对应。

![Tableau Bridge 窗口显示连接状态“已连接”，并有“Batters (TestV1)”和“Mariners Only (Batters—TestV1)”选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_client_status.png)

<!-- document id=3b7d8521615e99976dd40fef94f9c1091dbb54784477f2defa5ef4881d763cc2 url=/tableau/next/zh-cn/online/prep_conductor_manage_flow.md -->

[跳转到主要内容](#main-content)

# 管理流程

将流程发布到 Tableau Server 或 Tableau Cloud，您可以管理流程并根据需要对其进行更改。本主题介绍管理流程所需进行的各种操作。

**注意：**本主题中的内容既适用于 Tableau Server，也适用于 Tableau Cloud，特别指出了一些例外情况。

## 管理流程

**下面列出了您可执行的流程管理操作：**

- **创建流程：**从版本 2020.4 开始，作为 Creator，您可以直接在 Web 上创建流程。从“主页”中单击“创建”\>“流程”，或从“浏览”页面中单击“新建”\>“流程”。有关详细信息，请参见[Web 上的 Tableau Prep](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm)。
- **编辑流程：**从版本 2020.4 开始，作为 Creator，您可以直接在 Web 上编辑流程。导航到流程列表，选择“操作”并单击“编辑流程”，或打开流程并单击“编辑”按钮。
    
    编辑流程时，所做的更改将变为草稿状态。完成后，发布流程以提交更改并创建流程的新版本。有关详细信息，请参见[自动保存并使用草稿](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm#autosave)。
    
    您可以使用数据源的“连接”视图的“操作”(…) 菜单中的“编辑连接”菜单选项来编辑数据连接。新的连接将被保存，并在下次在 Tableau Prep Conductor 中运行流程时使用。但是，当您打开流程查看它时，原始连接仍然存在，并且在您编辑流程、更新连接器并重新发布它之前不会更新。
    
    如果您打开、编辑并重新发布流程而不更改原始连接，则使用“编辑连接”菜单所做的任何连接更改都将被覆盖并替换为原始连接。
- **上载流程**（版本 2026.2.4 及更高版本）作为 Creator，您可以从主页或“浏览”页面将流程文件上载到 Tableau Cloud，就像 Tableau 工作簿一样。当前不支持嵌入凭据。上载流程后，您可以编辑连接或编辑流程，并使用嵌入式凭据重新发布流程。
    
    如果上载输出到其他服务器的流程，则上载后，您需要编辑输出以指向新服务器上的正确项目，然后再运行流程。
- **运行流程：**除了创建在特定时间运行的计划流程任务之外，作为 Creator，您还可以手动运行流程。如果服务器管理员授予了此权限，Explorer（可发布）用户也可以运行流程。
- **注意：**若要运行流程，Data Management 不是必需的，但若要计划运行流程，则是必需的。
- 导航到流程列表，选择要运行的一个或多个流程，选择“操作”，并单击“立即运行”。
- **标记：**标记是一些关键字，您可以为流程创建这些关键字来帮助查找、筛选和分类内容。作者可以在发布流程时向其中添加标记。但是，您还可以向允许您访问的任何工作簿、视图或数据源中添加标记，并且可以删除已添加的任何标记。您可以向流程列表添加标记。
    
    导航到流程列表，选择要标记的一项或多项，选择“操作”，并单击“标记”。若要向特定流程中添加标记，您可以通过上述流程列表来执行该操作。从“概述”选项卡中打开“流程”，选择“操作”，然后单击“标记”。
- **更改所有者：**管理员和流程所有者可以将所有者更改为其站点上的任何 Creator。在版本 2025.1 及更低版本中，他们只能将所有者更改为自己。有关详细信息，请参见[管理内容所有权](https://help.tableau.com/current/online/zh-cn/owner.htm？)。
- **权限：**可以为用户设置权限，并指定他们是否能执行像保存、下载、移动到不同项目和删除这样的编辑操作。此外，您还可以指定谁可以查看和运行流程。
- **下载：**您可以下载一个流程，以使用 Tableau Prep Builder 进行查看或修改。若要下载流程，您需要下载权限。默认情况下，如果您是所有者，您将拥有下载权限，但您可能需要为其他用户添加该权限。
- **修订历史记录：**当对流程进行更改并使用相同名称将其重新发布到同一项目时，将创建一个新版本的流程。您可以通过从操作菜单中选择修订历史记录来查看修订历史记录。流程所有者具有还原流程的早期版本的权限。
- **移动：**可以在项目之间移动流程。若要移动流程，用户需要移动权限。默认情况下，您对自己拥有的流程具有移动权限，但您可能需要为其他用户添加该权限。
- **重命名：**可以重命名流程。若要重命名流程，用户需要保存权限。默认情况下，您对自己拥有的流程具有保存权限，但您可能需要为其他用户添加该权限。
- **删除：**可以删除流程。若要删除流程，用户需要删除权限。默认情况下，您对自己拥有的流程具有删除权限，但您可能需要为其他用户添加该权限。从版本 2025.3 开始，您现在可以从回收站中检索已删除的流程。有关详细信息，请参见[恢复已删除的流程](https://help.tableau.com/current/prep/zh-cn/prep_save_share.htm#recover-deleted-flows)。

### 谁可以执行此操作

Tableau Server 管理员

**可以跨所有站点执行下列任务：**

- 创建流程
- 编辑已发布流程
- 上载流程
- 查看所有草稿流程的列表
- 运行流程
- 删除流程
- 启用和配置回收站
- 恢复已删除的流程
- 下载流程
- 更改所有者
- 更改权限
- 更改项目
- 添加/删除标记
- 更改说明
- 更改名称
- 更新流程任务
- 删除流程任务
- 创建流程任务\*
- 版本管理\*

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

Tableau 站点管理员

**可以对发布到站点（它们是其管理员）的流程执行下列任务：**

- 创建流程
- 编辑已发布流程
- 上载流程
- 查看所有草稿流程的列表
- 运行流程
- 删除流程
- 启用和配置回收站
- 恢复已删除的流程
- 下载流程
- 更改所有者
- 更改权限
- 更改项目
- 添加/删除标记
- 更改说明
- 更改名称
- 更新流程任务
- 删除流程任务
- 创建流程任务\*
- 版本管理\*

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

项目主管

**可以对发布到项目（他们在其中具有项目主管权限）的流程执行以下任务：**

- 创建流程
- 编辑已发布流程
- 上载流程
- 运行流程
- 删除
- 下载
- 更改权限
- 更改项目
- 添加/删除标记
- 更改说明
- 更改名称
- 更新流程任务
- 删除流程任务
- 创建流程任务\*
- 版本管理\*

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

项目所有者

**可以对发布到他们所拥有项目的流程执行下列任务：**

- 创建流程
- 编辑已发布流程
- 上载流程
- 运行流程
- 删除
- 下载
- 更改权限
- 更改项目
- 添加/删除标记
- 更改说明
- 更改名称
- 更新流程任务
- 删除流程任务
- 创建流程任务\*
- 版本管理\*

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

流程所有者

**可以对他们拥有的流程执行下列任务：**

- 创建流程
- 编辑草稿（它们拥有的流程）和已发布流程
- 上载流程
- 运行流程
- 删除流程
- 恢复已删除的流程（管理员启用回收站）
- 下载流程
- 更改所有者
- 更改权限
- 更改项目
- 添加/删除标记
- 更改说明
- 更改名称
- 更新流程任务
- 删除流程任务
- 创建流程任务\*
- 版本管理\*

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

具有 Creator 许可证的用户

**可以执行下列任务：**

- 创建流程
- 编辑草稿（它们拥有的流程）和已发布流程
- 上载流程
- 运行流程（使用“运行流程”权限）
- 删除（使用删除权限）
- 恢复已删除的流程（管理员启用回收站）
- 下载（使用下载或另存为以及读取权限）
- 更改权限（使用更改权限）
- 更改项目（使用移动权限，以及对目标项目的写入权限）
- 添加/删除标记（使用读取权限）
- 更改说明（使用保存权限）
- 更改名称（使用保存权限）
- 更新流程任务（使用执行权限）
- 删除流程任务（使用执行权限）
- 创建流程任务\*（使用执行权限）
- 版本管理\*（使用查看、读取、另存为、下载权限）

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

具有 Explorer 许可证的用户

**可以执行下列任务：**

**注意**：从版本 2020.4 开始，Explorer 许可证用户无法再在 Tableau Server 上运行流程，即使服务器管理员分配了“运行流程：允许”权限也是如此。

- 具有“运行流程：允许”权限的 Explorer（可发布）许可证用户可在 Tableau Server 和 Tableau Cloud 上运行流程。
- 删除（使用删除权限）
- 恢复已删除的流程（管理员启用了 Explorer（可发布）权限和回收站）
- 下载（使用下载或另存为以及读取权限）
- 更改权限（使用更改权限）
- 更改项目（使用移动权限以及对目标项目的写入权限）
- 添加/删除标记（使用读取权限）
- 更改说明（使用保存权限）
- 更改名称（使用保存权限）
- 更新流程任务（使用执行权限）
- 删除流程任务（使用执行权限）
- 创建流程任务\*（使用执行权限）
- 版本管理\*（使用查看、读取、另存为、下载权限）

\*某些附加条件适用于这些操作：

- 创建流程任务：
    
    - 流程计划必须可用。在 Tableau Server 中，只有服务器管理员才能创建计划。在 Tableau Cloud 中，有权计划流程任务的用户可以创建自定义计划。有关详细信息，请参见[计划流程任务](https://help.tableau.com/current/online/zh-cn/prep_conductor_schedule_flow_task.htm)。
    - 流程至少必须有一个输出步骤。
    - 流程版本必须与 Tableau Server 版本兼容。
- 版本管理：
    
    - 必须在站点上启用修订历史记录。
    - 允许用户角色发布到项目。

具有 Viewer（查看者）许可证的用户

Viewer（查看者）无法管理流程，但可以查看流程和流程的不同版本。

有关可在流程上设置的完整能力的详细信息，请参见[权限能力](https://help.tableau.com/current/server/zh-cn/permissions.htm)。

<!-- document id=dec5086627fe56132533a34899932f67d0d7f8668b1eb13db6d436b76ce55924 url=/tableau/next/zh-cn/online/user_visibility.md -->

[跳转到主要内容](#main-content)

# 管理站点用户可见性

默认情况下，当权限允许时，所有站点用户都可以查看别名、项目所有权和其他用户的注释。用户可见性设置允许管理员管理具有“Viewer”（查看者）和“Explorer”站点角色的用户是否能查看站点上的其他用户和组，这一点对于多个客户端使用的站点非常重要。若要详细了解站点角色，请参见[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。

## 限制用户可见性

将“用户可见性”设置为**“受限”**会影响某些协作工具，并在 Tableau Cloud 和 Tableau Server 中隐藏用户信息。受限用户可见性要么会为“Viewer（查看者）”和“Explorer”（不包括“站点管理员 Explorer”）禁用功能，要么会从其他区域中移除用户信息。请注意，当“用户可见性”设置为“受限”时，“Creator”和管理员仍将看到用户信息。

若要为“Explorer”和“Viewer（查看者）”（不包括“站点管理员 Explorer”）限制用户可见性，请执行以下操作：

- 导航到站点的“设置”页面
- 在“用户可见性”设置中选择“受限”

下面列出了当“用户可见性”设置为“受限”时影响的站点区域。请注意，除非为所有用户禁用该功能，否则只有非管理员“Explorer”或“Viewer（查看者）”才会受到影响。

<table style="width: 100%;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td style="font-weight: bold;">区域</td><td style="font-weight: bold;">影响</td></tr><tr><td>搜索</td><td>不显示用户信息</td></tr><tr><td>内容所有者</td><td>未显示用户信息（“Explorer”和“Viewer（查看者）”无法查看自身，但可以在“我的内容”中查看其内容）</td></tr><tr><td>个人资料图片</td><td>不显示用户信息</td></tr><tr><td>订阅</td><td><p>不显示用户信息</p><p>&nbsp;</p></td></tr><tr><td>推荐配置</td><td>不显示类似用户（所有用户）</td></tr><tr><td>添加/编辑标记</td><td>“Explorer”和“Viewer（查看者）”可以看到标记，但不能删除或修改它们</td></tr><tr><td>“谁查看了此视图？”</td><td>已禁用</td></tr><tr><td>“数据问答”功能使用情况分析</td><td>已禁用</td></tr><tr><td>权限对话框</td><td>已禁用</td></tr><tr><td>命名共享</td><td>已禁用（所有用户）</td></tr><tr><td>通知</td><td><p>已禁用（所有用户）</p><p>现有通知已暂停</p></td></tr><tr><td>注释</td><td>已禁用（所有用户）</td></tr><tr><td>公共自定义视图</td><td><p>已禁用（所有用户）</p><p>现有公共自定义视图显示为私有视图</p></td></tr><tr><td>请求访问权限</td><td>已禁用（所有用户）</td></tr><tr><td><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span></td><td><p>从 Desktop 中禁用发布工作簿</p><p>用户信息未显示在用户筛选器上</p></td></tr><tr><td>Tableau Pulse</td><td>用于查看和管理关注者的按钮未显示在指标上</td></tr><tr><td>Tableau Catalog（具有 <span class="mc-variable Variables.DM_sku variable">Data Management</span>）</td><td><p>不显示用户信息</p></td></tr></tbody></table>

当“用户可见性”设置为“受限”时，Tableau Server REST API 和元数据 API 调用的行为如上表所述。仍然可以进行引用已知用户 ID 的 API 调用。

站点上的用户可与视图进行交互并修改它们，例如应用筛选器。如果用户与其他人共享其修改的视图，或者用户从该修改的视图中创建内容（例如指标或私有自定义视图），则该用户的名将出现在 URL 中。确保仅将此已修改视图的 URL 分发给允许查看此人姓名的用户。

**注意：**如果用户是多个站点的成员，在 Tableau Cloud 的登录页面上输入电子邮件将返回该用户是其成员的所有站点的名称。

### 限制用户可见性的最佳做法

管理员还可以通过以下方式检查用户和组信息是否不可见：

- 配置权限以仅向相应各方提供内容。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。
    - 受限用户可见性会从搜索中隐藏用户身份信息，但如果进行搜索的用户具有该内容的查看权限，则可能返回用户发布的内容。
    - 在同一项目中发布带有重复标题的工作簿的用户可能会看到一条警告，指出具有该标题的工作簿已存在。
- 必要时应用行级别安全性。
- 检查仪表板内的元数据是否未包含用户信息。
- 检查用户可访问的计算是否未包含用户元数据（例如，用户筛选器）。

## 恢复完全用户可见性

当管理员将“用户可见性”设置为“完全”时，通过“受限用户可见性”为所有用户禁用的功能（例如注释和通知）将保持关闭状态。管理员可以通过网站的“设置”页面重新启用这些功能。

“用户可见性”设置为“完全”时不会保留任何以前的功能设置，并且受影响的功能不会自动启用。

<!-- document id=1e698bd74450b16e54d77fc58e2412d31d1893d9838ddadb189a59da2db54083 url=/tableau/next/zh-cn/online/users.md -->

[跳转到主要内容](#main-content)

# 管理用户和组

您可以将用户添加到 Tableau Cloud 站点并设置其站点角色，该角色确定每个用户的访问级别。为了更轻松地管理多个用户，您可以将用户组织成组。

## 此部分中的其他文章

<!-- document id=05704695feb1647b85efee3d190e0ba3c67a70a51adfaee4342df3d8f2b0b849 url=/tableau/next/zh-cn/online/cloud_manager_site_role_limit.md -->

[跳转到主要内容](#main-content)

# 管理站点角色限制

在 Tableau Cloud Manager (TCM) 中，云管理员可以设置站点角色限制，该限制定义了站点可消耗的每种许可证类型（Creator、Explorer 或 Viewer（查看者））的最大数量。创建角色限制后，站点上的用户将按照云管理员设置的限制自动消耗其分配角色的许可证。

**注意：**云管理员只能访问 TCM，并且不消耗许可证。若要获得站点访问权限，您可以为自己分配一个站点角色，或者由另一个云管理员分配一个站点角色。有关详细信息，请参见[管理用户的站点成员身份](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm#manage-site-membership)。

如果将用户添加到多个 Tableau Cloud 站点，则他们会计入每个单独站点的角色限制。但对于 TCM 内的整体许可证消耗而言，一个用户仅消耗一个许可证。此许可证与他们所属的所有站点中分配的最高站点角色相对应。

让我们考虑以下场景，其中云管理员在两个站点上设置站点角色限制：

- **站点 A：**3 个 Creator、5 个 Explorer、10 个 Viewer（查看者）许可证
- **站点 B：**2 个 Creator、4 个 Explorer、6 个 Viewer（查看者）许可证

在两个站点工作的 Jane 被添加为站点 A上 的 Creator，以及站点 B 上的 Explorer。在站点 A，Jane 被计为 3 个 Creator 之一。在站点 B 上，Jane 被计为 4 个 Explorer 之一

尽管 Jane 是两个站点的成员，但她只消耗 TCM 中的一个 Creator 许可证，因为这是跨站点分配的最高角色。

## 在站点上创建或修改角色限制

默认情况下，Tableau Cloud Manager (TCM) 中的每个站点都使用_云限制_，即购买的许可证总数。向站点添加用户时，TCM 会检查云限制，以确保用户数量不超过可用的许可证总数。

为了管理组织的 Tableau Cloud 许可证，云管理员可以设置站点角色限制。此功能可以控制租户内不同站点之间的许可证分配。

若要设置站点角色限制，请按以下步骤操作：

1. 以云管理员身份登录到 Tableau Cloud Manager。
2. 导航到“站点”页面，并选择要修改的站点。
3. 单击“操作”菜单或省略号图标 (**...**)，并选择 “站点角色限制”。
4. 在对话框中，为想要修改的站点角色选择“站点角色限制”，然后输入所需的值。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_set_site_role_limits.png)
    
    **注意：**站点角色限制必须等于或大于所使用的许可证数量，并且不能超过该站点角色的云限制。
5. 单击“保存”。

设置站点角色限制后，最大许可证数量将显示在 TCM 的“站点”页面上。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_site_role_limits.png)

在站点级别，站点管理员可以在“用户”页面上查看其站点的角色限制。

![](/tableau/next/zh-cn/online/zh-cn/Img/tcm_site_role_limits_info.png)

## 满足站点角色限制时

当将用户添加到站点时，他们会自动消耗分配给其站点角色的许可证。但是，如果已达到该角色的最大许可证数量（站点角色限制），则会发生以下情况：

- 如果某个站点角色的所有许可证都已在使用中，但更高级别角色有可用的许可证，则该用户将被添加到该站点并消耗更高级别角色的许可证。例如，如果没有可用的 Explorer 许可证，则添加为 Explorer 的用户将消耗可用的 Creator 许可证。
- 如果没有更高角色许可证可用，则用户将作为“未许可”用户添加到站点。

消耗与其分配的角色不同的许可证的用户（例如使用 Explorer 许可证的 Viewer（查看者））可能会影响站点角色限制。云管理员可以通过两种方式解决这种情况：

- 取消这些用户的许可，并根据需要更新站点角色限制。有关详细信息，请参见[在站点上创建或修改角色限制](#create-modify-role-limits)。
- 通过 Tableau Webstore 购买其他许可证。有关详细信息，请参见[购买更多许可证](https://help.tableau.com/v0.0/online/zh-cn/to_buy_more_licenses.htm)。

<!-- document id=e702cfbe9482171c04cc9ea079c4da045720c61729540b609d9516aad0172953 url=/tableau/next/zh-cn/online/to_manage_data_sources.md -->

[跳转到主要内容](#main-content)

# 管理连接信息

## 此部分中的其他文章

<!-- document id=b35815375dec1b0e777eb7be1381c55fc81c9dec6f872d0f484f680357fd1524 url=/tableau/next/zh-cn/online/adminview_insights_groups.md -->

[跳转到主要内容](#main-content)

# 组数据源

组数据源标识站点上用户的组成员身份。组和用户配对的每个独特组合都有一行数据。没有成员的组和不在组中的用户将作为一行数据包含在内，null 值表示为“NULL”。

## 创建自定义视图

如果您是站点管理员或被授予“在线管理见解”项目访问权限的用户，您可以使用“Web 制作”直接从 Tableau Cloud 中访问“在线管理见解”数据源，或通过 Tableau Desktop 访问。有关连接到‘在线管理见解’数据源的详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

### 示例：给定组中有哪些用户？

使用下列步骤创建显示组中用户的视图。

1. 连接到组数据源。
2. 从“数据”窗格中，将“Group Name”（组名称）拖到“行”功能区。
3. （可选）在视图中，选择您要探索的组，然后选择“只保留”。
4. 从“数据”窗格中，将“User Email”（用户电子邮件）拖到“行”功能区，并将其放在“组名称”字段的右侧。

## 利用您的数据做更多的事情

使用 Tableau Prep，您可以在以下字段上将组与其他“在线管理见解”数据源连接起来，以便更深入地了解您的站点。如果您要分析来自多个 Tableau Cloud 站点的数据，您还必须在“站点 LUID = 站点 LUID”上进行联接。

- 在“用户 LUID = 用户 LUID”上将组联接到 TS 用户

有关详细信息，请参见 Tableau Prep 帮助中的[聚合、联接或合并数据](https://help.tableau.com/current/prep/zh-cn/prep_combine.htm)。

## 数据架构

下表列出了组数据源中包含的字段。每行数据对应着组和用户配对的唯一组合。

<table class="simple-table" style="max-width: 100%;"><colgroup><col style="width: 25%;"><col style="width: 25%;"><col style="width: 15%;"><col></colgroup><tbody><tr><th>文件夹</th><th>文件名</th><th>类型</th><th>描述</th></tr><tr><td rowspan="4">Group</td><td>Group Is Licensed On Site</td><td>布尔值</td><td>是否启用“登录时授予许可证”</td></tr><tr><td>Group LUID</td><td>字符串</td><td>与用户关联的组的 LUID。主要用于引用 REST API 中的组。</td></tr><tr><td>Group Minimum Site Role</td><td>字符串</td><td>与组关联的最低站点角色。如果未启用“登录时授予许可证”，则为 null。</td></tr><tr><td>Group Name</td><td>字符串</td><td>组的名称</td></tr><tr><td rowspan="2">Site</td><td>Site LUID</td><td>字符串</td><td>与用户关联的站点的 LUID。主要用于在 REST API 中引用站点。</td></tr><tr><td>Site Name</td><td>字符串</td><td>与用户关联的站点的名称</td></tr><tr><td rowspan="2">User</td><td>User Email</td><td>字符串</td><td><p>与用户帐户关联的电子邮件地址</p></td></tr><tr><td>User LUID</td><td>字符串</td><td>用户的 LUID。主要用于在 REST API 中引用用户</td></tr><tr><td rowspan="3">-</td><td>Admin Insights Published At</td><td>日期时间</td><td>“在线管理见解”数据源上次发布的日期和时间 (UTC)</td></tr><tr><td>Count of Distinct Groups</td><td>数字</td><td>站点上组的不同计数</td></tr><tr><td>Count of Distinct Users</td><td>数字</td><td>站点上用户的不同计数</td></tr></tbody></table>

<!-- document id=3c028acf5ed1e22c9d8443196963e4c8d10aa9e5956bb8606d5d54fc8f989ee0 url=/tableau/next/zh-cn/online/to_connections_modify.md -->

[跳转到主要内容](#main-content)

# 编辑 Tableau Cloud 上的连接

管理员和数据源所有者可以管理已发布的数据源连接信息。连接信息描述数据源、其所有者及访问数据的方式。您可以在连接中嵌入数据库凭据，以允许用户直接访问数据或启用数据提取计划刷新。或者，您可以设置连接，以便提示用户登录。您还可以更改基于云的数据的服务器名称。

数据源所有者或站点管理员可以直接在站点上管理此信息。例如，您可以更新标记或更改数据源所有者，而不必重新发布数据源。

1. 在包含要修改的数据的站点上，打开“浏览”页面，然后进行筛选以显示“所有数据源”。
    
    ![浏览筛选到的数据源](/tableau/next/zh-cn/online/zh-cn/Img/connections1.png)
    
    如果有大量数据源，请使用筛选器缩小列表范围。
    
    ![筛选选项](/tableau/next/zh-cn/online/zh-cn/Img/connection_filter.png)
2. 选中要更新的数据源旁边的复选框，并在“动作”菜单上选择“编辑连接”。
    
    **注意：**若要编辑在线计划的数据提取刷新连接类型以使用 Tableau Cloud 而不是 Bridge，请参见[更改刷新的连接类型以使用 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#use_cloud)。
3. 更新连接信息并单击“保存”。
    
    对于支持使用保存的凭据刷新数据的连接，请参见[使用保存的凭据刷新数据](https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm)。
    
    **注意**：“测试连接”按钮不支持 Bridge 连接。作为使用此按钮测试连接的替代方法，请考虑改为运行手动刷新来测试连接。有关运行手动刷新的详细信息，请参见[手动启动刷新任务](https://help.tableau.com/v0.0/online/zh-cn/to_refresh_extract_manual.htm)。
4. 刷新“数据连接”页（按 F5 或 Ctrl+R）以使更改生效。

<!-- document id=884a0117e0705ea83818b83bd21d4a16be56a24ec015666373d517999fcc0113 url=/tableau/next/zh-cn/online/edit_datasources.md -->

[跳转到主要内容](#main-content)

# 编辑已发布数据源

假设您发布了一个数据源，并且您的团队正在多个工作簿中使用该数据源。这是一个良好的开端，但您有一些可以使您的数据源变得更好的更改。在实施这些更改之前，您希望查看您提议的更改在 Tableau 中将如何呈现。最重要的是，您需要测试您的更改以确保它们不会对使用数据源的任何现有工作簿产生负面影响。

编辑已发布数据源允许您测试更改并改进数据源，同时将其作为单一数据源进行维护。

**注意**：只有具有 Creator 站点角色的用户才能在浏览器中编辑已发布数据源。

或者，您可以通过在新数据源中进行更改来_扩展_已发布数据源。扩展的已发布数据源会在不更改原始数据源的情况下您的覆盖层置于新的数据源中，并保持与该原始数据源的连接。有关详细信息，请参见[扩展已发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_extend_compose.htm)。

## 编辑和测试更改

无论您是创建新的已发布数据源还是编辑现有的已发布数据源，您都可以在不离开浏览器的情况下从“数据源”页面创建关系并修改数据模型。然后，在发布数据源之前使用 Scratchpad 测试您的更改、创建文件夹、组织层次结构以及重命名字段和别名。在编辑数据源时，您将拥有在 Tableau Cloud 中制作时的所有特性和功能。有关详细信息，请参见[“Web 制作和 Tableau Desktop 功能比较”](https://help.tableau.com/current/pro/desktop/zh-cn/server_desktop_web_edit_differences.htm)。

编辑已发布数据源：

1. 从“开始”或“浏览”页面，导航到要编辑的数据源。
2. 单击“编辑数据源”。  
    ![“编辑数据源”按钮](/tableau/next/zh-cn/online/zh-cn/Img/edit_published_data_source.png)
3. 单击“数据源”页面以进行联接或编辑架构。
4. 单击“Scratchpad”工作表。
5. 从“数据”窗格中，创建文件夹、组织层次结构、重命名字段及其别名，或更新与已发布数据源一起保存的元数据。
6. 将字段拖放到 Scratchpad 上，以确保您的更改按预期工作。
7. 单击“发布”。

就像可对工作簿所做的那样，如果要建立数据源的副本，您也可以使用“发布为”。

**注意：**个人空间不支持已发布数据源。

## 回滚更改

恢复到已发布数据源的最新版本：

1. 导航到要恢复的数据源。
2. 单击“文件”。
3. 选择“恢复为已发布”。

![“文件”下拉菜单，“恢复为已发布”选项](/tableau/next/zh-cn/online/zh-cn/Img/revert_to_published.png)

这将恢复为该数据源的最新已发布版本。

## 了解支持的连接

编辑已发布数据源不支持在 Tableau Cloud 和 Tableau Server 中使用嵌入式密码的数据源。

此外，“数据源”页面不可用于不支持的已发布数据源连接类型，包括但不限于 .hyper 文件类型。若要查看支持哪些连接类型，请参见[Creator：连接到 Web 上的数据](https://help.tableau.com/v0.0/online/zh-cn/creator_connect.htm)。

## 了解权限

若要编辑已发布数据源，您需要一个 Creator 许可证，该许可证对相应文件夹中的数据源具有“保存”或“另存为”权限。有关详细信息，请参见[“权限”](https://help.tableau.com/current/online/zh-cn/permissions.htm)。

## 编辑流程发布的数据源

如果您对流程发布的数据源进行编辑，更改将在下一个计划的流程期间被覆盖。作为替代，请编辑流程中的数据源。有关详细信息，请参见[将流程发布到 Tableau Server 或 Tableau Cloud](https://help.tableau.com/current/prep/zh-cn/prep_conductor_publish_flow.htm)。

<!-- document id=4e5583c63afc4892285817ce85d5c3c640d8f35af6abc2226c69d44ee9b48d78 url=/tableau/next/zh-cn/online/autosave.md -->

[跳转到主要内容](#main-content)

# 自动保存工作簿

在 Tableau Cloud 中，“自动保存”会保存您在工作时对新工作簿或现有工作簿所做的编辑。

## “自动保存”的工作方式

一旦您开始对新工作簿或现有的工作簿进行更改，我们就会开始将更改自动保存到您工作簿的私人草稿版本中。当您准备好与他人共享您的更改时，请使用“发布”将上次发布的修订替换为您的草稿。

**注意：**“自动保存”不会自动保存每种类型的更改，例如特定类型的资产。在这些情况下，您会看到一条通知，指出您必须“发布”工作簿才能保存编辑。

### 工作簿文件大小

“自动保存”适用于小于 5MB 的工作簿。您必须“发布”才能手动保存较大工作簿文件的更改。

### 如果多个用户编辑同一个工作簿怎么办？

当多个用户在同一工作簿上工作时，每个用户的编辑都会与他们自己的私人草稿中关联，并保存到该草稿。当您开始编辑工作簿时，如果您正在使用的版本包含其他用户的已发布修订，您将收到通知。然后，您可以选择放弃草稿并编辑当前修订，或者继续编辑您的私人草稿。

> [!WARNING]
> 
> **警告：**如果在您开始对您的私人草稿进行编辑后其他用户发布了修订，您将不会收到通知。如果其他用户在您发布您的版本之前发布了他们的草稿，您的更改将覆盖他们的更改。

您可以检查工作簿修订历史记录以查看工作簿上次发布的时间。从修订历史记录中，您可以选择预览修订或还原以前的修订。有关详细信息，请参见[处理内容修订](https://help.tableau.com/current/pro/desktop/zh-cn/qs_revision_history.htm)。

如果您选择放弃草稿以编辑当前修订，则上传的草稿和相关资产文件将被删除。若要保留资产和您在私人草稿中所做的编辑，您可以手动将其他用户的编辑合并到您的私人草稿中。然后，发布包含两组更改的工作簿。

### 权限要求

在工作簿级别具有 Web 编辑能力的 Creator 和 Explorer（可发布可以使用“自动保存”。如果用户仅在视图级别具有 Web 编辑能力，则不会启用“自动保存”。

<!-- document id=7b03c85f709d0a2fb6d6282fc0310fa1cfeb01552c26c7a2f24523b4f74bc54b url=/tableau/next/zh-cn/online/extract_auto_suspend.md -->

[跳转到主要内容](#main-content)

# 自动挂起非活动工作簿和数据源的数据提取刷新

为了节省资源，Tableau 可以自动挂起非活动工作簿和已发布数据源的数据提取刷新任务。此功能仅适用于完全数据提取刷新，并且仅适用于运行频率高于每周的刷新任务。

它不适用于：

- 增量数据提取刷新
- 每周一次或频率低于每周一次的刷新任务
- Bridge 正在更新的已发布数据源。

在工作簿处于非活动状态 32 天后，将会暂停非活动工作簿的数据提取刷新任务。

**注意：**从 Tableau Cloud 2023 年 7 月版开始，支持自动挂起数据源的数据提取刷新。

对于工作簿，如果发生以下任何事件，则会重置工作簿非活动定时器:

- 查看工作簿工作表
- 在工作簿上设置任何数据驱动型通知或订阅
- 下载工作簿
- 移动工作簿的位置或更改所有者

对于已发布数据源，任何从数据源获取数据的事件都会导致其不活动倒数计时器被重置。这些事件包括：

- 加载连接到数据源的工作簿视图
- 访问数据源的“数据问答”页面
- Tableau Desktop 中连接到数据源
- 在 Web 制作中，打开使用已发布数据源的工作簿，即使未发布工作簿
- 使用数据源作为流程输入的 Tableau Prep 流程运行（包括计划的 Prep Conductor 运行）
- 使用已发布数据源的 Tableau Pulse 指标摘要或用户视图
- 用户触发的数据源“立即运行”刷新

## 通知

电子邮件通知会在以下时间发送给工作簿或数据源的所有者：

- 在挂起数据提取刷新计划前三天
- 数据提取刷新计划挂起时

## 恢复挂起的数据提取刷新

如果有人使用工作簿，挂起的数据提取刷新不会自动恢复。它必须由站点管理员手动完成。

若要查看和恢复挂起的数据提取刷新，请执行以下操作：

1. 以管理员身份登录到站点，然后单击**“任务”**。
2. 单击“**数据提取刷新**”选项卡。
3. 选择一个或多个项。
4. 从**“操作”**菜单中，选择**“恢复”**。

<!-- document id=c7bf030e56e38b62b3e361f1e171791d3a54ec830537cd0b120a5e6bc6b3145a url=/tableau/next/zh-cn/online/data_stories_customize.md -->

[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

您可以使用针对您的受众群体量身定制的自定义语言，以针对您的业务的特定洞察来补充您的 Tableau 数据故事。从数据故事中确定对您的受众群体最重要的分析和数据，并使用您自己的语言创建最具影响力的故事。与整体 Tableau 数据故事一样，自定义内容中使用的数据和变量是动态的，会随着仪表板进行调整。  

## 添加您自己的洞察

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 找到您要撰写的部分，然后单击“添加自定义项目”。  
      
    ![“编辑故事”对话框，允许用户选择哪些句子出现在故事中](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_add.png)
3. 在出现的字段中输入您的自定义文本。
4. 单击“保存”。

## 添加页眉和页脚

您可以在数据故事的顶部和底部插入自定义文本。通过页眉和页脚，您可以将自己的定性分析添加到故事中，包括对数据趋势的额外解释，或附加法律和隐私免责声明。  
  

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击“显示注释”开关。
3. 输入您的自定义注释。  
      
    ![“编辑故事”对话框，“显示注释”开关处于“打开”位置。自定义注释显示“This is my custom note”（这是我的自定义注释）。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_note.png)
4. 单击“保存”。

您的注释现在显示在数据故事的顶部或底部。  

## 添加函数

在数据故事中使用函数是自定义故事并找到对您和您的业务最重要的洞察的好方法。

举例来说，如果您想知道一段时间内旅游收入的平均总和，请选择 Average 作为您的函数，然后将度量指定为 SUM(Tourism Inbound)。这将返回入境旅游的平均总和。  
  

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击对话框右侧的菜单，然后选择“添加函数”。  
      
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“添加函数”选项突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_add_function.png)
3. 选择一个数据故事函数并填写必填字段。  
      
    ![用于键入函数的打开字段，以及用于定义自定义函数、维度、度量和筛选器维度值的下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_add_function_complete.png)
4. 单击“添加到版块”。
5. 单击“保存”。  
      
    ![页脚中有自定义注释的示例故事。自定义注释突出显示，故事的其余部分处于阴影中。注释显示“Average Sum per Year 434.09 billion”（每年平均总和为 4340.9 亿）。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_function_story.png)

自定义内容现在显示在您的数据故事中。  
  

## 添加条件

对于您编写的每个自定义句子，您可以添加一个条件来确定该句子是否在您的数据故事中呈现。如果满足条件，自定义句子将出现在您的故事中。如果不满足条件，则不会出现自定义句子。  

您可以对每个自定义句子应用多个条件，并且可以使用“添加条件”对话框中的“任意”或“全部”按钮合并这些条件。

条件语句最常用于数值比较，但该函数还支持使用等号 (=) 或不等号 (!=) 进行字符串匹配。  
  

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 输入您的自定义句子。
3. 单击对话框右侧的菜单，然后选择“添加条件”。
4. 定义用于告知条件逻辑的自定义函数。在这个例子中，“We have met our quota”这句话表明入境旅游总和是否大于 5 万亿。  
    ![您可以在其中输入条件的文本字段。有一个“添加条件”按钮和两个公式字段来定义何时满足条件。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_add_condition.png)
5. 单击“添加到版块”。
6. 单击“保存”。

现在，仅当满足条件时，自定义句子才会出现在您的数据故事中。  

## 复制自定义内容

您可以轻松复制添加到数据故事中的自定义内容，从而更轻松地构建句子的不同变体。我们建议在应用阈值、构建语言变体和创建不同的逻辑变体时复制完全构建的自定义句子。  
  

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 如果需要，创建一个自定义句子，包括函数和条件。
3. 在完成的句子框中，单击框右侧的菜单，然后选择“复制”。  
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“复制”选项突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_duplicate.png)
4. 单击重复的句子，根据需要进行更新，然后单击“添加到版块”。
5. 单击“保存”。

当您复制一个句子时，所有的函数和条件语句也会复制过来。复制的项目符号直接出现在同一版块中原始项目符号的下方。

**注意**：复制的项目符号只能添加到原始项目符号所在的版块。  

## 在向下钻取版块中添加自定义内容

对于具有两个维度的故事，第一个版块之后的每个版块都称为向下钻取版块。向下钻取版块侧重于单个主要维度实体（即以下示例中的美洲）。  

因为向下钻取版块具有相同的内容结构，所以在第一个版块（即欧洲）中添加的自定义内容将应用于每个其他版块（即美洲）。您只能在第一个向下钻取版块中创建或编辑内容。  
  

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 在第一个向下钻取版块中，单击“添加自定义项目”以添加到每个实体。
3. 输入您的自定义内容。
4. 单击“保存”。  
      
    ![“编辑故事”对话框，其中有一个按钮，显示“向每个实体添加自定义项目”](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_drilldown_after.png)

向下钻取版块中的自定义内容已经有一个名为当前类别值（动态）的上下文变量。这将创建一个名为当前类别值（动态）的维度值选项，它始终表示向下钻取版块所涉及的版块。

> [!TIP]
> 
> **提示：**若要创建仅出现在单个特定向下钻取版块中的内容，您可以使用条件逻辑来确保它只在适当的地方写入。

## 此部分中的其他文章

<!-- document id=ca7f825aa14e9171f98bb420f390e9933473071077aa14162762f4a8d6193cc2 url=/tableau/next/zh-cn/online/data_stories_customize_context_variables.md -->

[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事：上下文变量

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

上下文变量是可以被其他函数引用的函数。换句话说，您可以使用上下文变量将函数嵌套在其他函数中。

定义上下文变量后，它会显示为一个函数，您可以在将新函数添加到 Tableau 数据故事时使用该函数。

**注意：**您可以为每个自定义句子设置多个上下文变量，但您必须为每段自定义内容分别定义每个上下文变量。

## 设置上下文变量

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击“添加自定义项”。
3. 单击自定义内容框右侧的菜单，然后选择“设置上下文”。  
      
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“设置上下文”选项突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_set.png)
4. 单击“添加上下文”。
5. 命名上下文变量并单击“设置函数”。
6. 定义您的自定义函数并选择一个维度。  
      
    ![一个用于命名上下文变量的开放字段、一个“添加上下文”按钮，以及用于定义自定义函数的字段。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_add.png)
7. 单击“添加到版块”。
8. 单击返回到您设置上下文变量的句子。
9. 按照[添加函数](https://help.tableau.com/v0.0/online/zh-cn/data_stories_customize.htm#Add)的步骤进行操作。  
      
    ![函数对话框打开，用于定义自定义函数的字段列出了自定义上下文选项。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_shows.png)

现在，当您添加函数时，上下文变量将作为选项列在“维度值”下拉列表中。  

## 何时使用上下文变量：引用两个或多个度量  

假设您想在数据故事中的一个分析句子中引用两个或更多度量。如果没有上下文变量，我们一次只能为一个度量写一个句子。但如果我们使用上下文变量，我们可以在一个句子中引用多个度量。  

若要使用上下文变量引用两个或更多度量，您的数据故事必须有：

> - 1 个维度
> - 2 个或更多度量

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击“添加自定义项”。
3. 单击自定义内容框右侧的菜单，然后选择“设置上下文”。
4. 单击“添加上下文”。
5. 命名上下文变量并单击“设置函数”。
6. 定义您的自定义函数并选择一个维度。
7. 单击“添加到版块”。  
      
    ![显示上下文变量的图像，其中包含排序降序标签、SUM(GDP) 度量、排名 1 和国家/地区维度的定义函数](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_setfuction.png)
8. 单击返回到您设置上下文变量的句子。
9. 添加您的第一个函数并填写必填字段。在此示例中，我们选择了 DimensionValueLabel，从“维度”中选择“国家/地区”，然后从“维度值”中选择 GDP 最高的国家/地区（我们的上下文变量）。  
      
    ![函数对话框打开，步骤 9 中列出的选项处于选定状态。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_context_func1.png)

1. 单击“添加到版块”。
2. 添加您的第二个函数并填写必填字段。在这个例子中，我们选择了 Value，然后从“维度”中选择“国家/地区”，从“度量”中选择“SUM(Lending Interest)”，并从“维度值”中选择 GDP 最高的国家/地区（我们的上下文变量）。  
      
    ![函数对话框打开，步骤 10 中列出的选项处于选定状态。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_context_func2.png)

1. 单击“添加到版块”。
2. 单击“保存”。

您的数据故事编写了一个句子，让我们深入了解我们感兴趣的国家/地区（GDP 最高的国家/地区）的次要衡量标准（贷款利息）。  
  
![图像显示数据故事中呈现的句子，表明美国在该数据集中拥有最高的 AVG (GDP) 和 $0.7B 的贷款利息。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_sentence.png)  

## 何时使用上下文变量：跨周期分析

当您想要分析数据故事中两个不同周期的性能时，上下文变量会很有帮助。您可以创建一个自定义句子来描述在您的向下钻取版块中显示的度量，并将该度量与不同的周期进行比较，例如逐年或逐月。  

若要设置跨周期分析，您的数据故事必须有：

> - 2 个维度：1 个时间段维度（主要）和 1 个非时间段维度（次要）
> - 1-3 个度量

1. 创建数据故事。
2. 在“字段”对话框中，确保您的时间段维度首先排序，然后单击“下一步”。
3. 在“故事”对话框中，选择“连续”，并单击“完成”。
4. 打开“编辑”对话框，然后在第一个向下钻取区域中选择“添加自定义项”。
5. 创建两个代表您的时间段的上下文变量。例如，“Current Quarter”（当前季度）和“Previous Quarter”（上一季度）。  
      
    ![显示两个上下文变量集的图像，一个用于当前季度，一个用于上一季度](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_quarters.png)
6. 通过添加自定义语言和函数来创建一个 _increased_ 句子。这个句子的内容生成“\[CurrentDimensionValueLabel\] increased \[X%\] over the quarter”（\[CurrentDimensionValueLabel\] 在本季度增加了 \[X%\]）。
7. 在自定义文本框中键入函数，后跟单词“increased”。
8. 添加返回您的时间段内度量百分比变化的函数。  
      
    ![函数对话框打开，步骤 1 至步骤 8 中列出的选项处于选定状态。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_increased.png)
9. 单击“添加到版块”。
10. [复制自定义内容](https://help.tableau.com/v0.0/online/zh-cn/data_stories_customize.htm#Duplicat)并通过将单词“increased”替换为“decreased”来创建 _decreased_ 版本。函数保持不变。  
      
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“复制”选项突出显示。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_duplicate.png)
11. 为每个句子[添加条件](https://help.tableau.com/v0.0/online/zh-cn/data_stories_customize.htm#Add2)，以便只写入一个，具体取决于数据。  
      
    ![条件对话框打开，并且为自上一季度以来的增加输入了自定义内容。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_addcondition.png)
12. 对于 _increased_ 句子，请按照以下示例设置条件：

> 左侧参数 = 值函数
> 
> 维度 = Quarter(OrderDate)。选择您的时间段维度
> 
> 度量 = SUM(Total Orders)。选择用于计算的度量
> 
> 维度值 = 当前季度。上下文变量之一
> 
> 筛选维度值 = 当前区域值（动态）。这是预设的上下文变量
> 
> 中间参数 = >（大于）
> 
> 右侧参数 = 值函数
> 
> 维度 = Quarter(OrderDate)。选择您的时间段维度
> 
> 度量 = Total(Total Orders)。选择用于计算的度量
> 
> 维度值 = 上一季度。上下文变量之一
> 
> 筛选维度值 = 当前区域值（动态）。这是预设的上下文变量  
>   
> ![条件对话框打开，并按照步骤 12 中所述输入自定义内容。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_context_period_analysis.png)  

1. 对于 _decreased_ 句子，设置相同的条件，但将 >（大于）符号替换为 <（小于）符号。左侧和右侧参数保持不变。
2. 单击“保存”，您的数据故事会写一个句子，其中包含通过分析两个时间段得出的洞察。

<!-- document id=ecf471aa5833912e906f3e87701fa6b35c223a58d88ef6fd1cfe463b82081561 url=/tableau/next/zh-cn/online/data_stories_customize_functions.md -->

[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事：函数

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

如果您想使用函数自定义 Tableau 数据故事，了解您可以使用哪些函数、每个函数的作用以及每个函数需要哪些维度和度量会很有帮助。

了解如何将[添加函数](https://help.tableau.com/v0.0/online/zh-cn/data_stories_customize.htm#Add)到您的数据故事。  
  

单击某个字母以查看以它开头的函数。如果没有以该字母开头的函数，则将显示以字母表中的下一个字母开头的函数。您也可以按 Ctrl+F（在 Mac 上按 Command-F）打开一个搜索框，您可以使用它来搜索特定功能的页面。

[A](#A) [B](#C) [C](#C) [D](#D) [E](#E) [F](#F) [G](#G) [H](#H) [I](#I) [J](#L) [K](#L) [L](#L) [M](#M) [N](#N) [O](#P) [P](#P) [Q](#R) [R](#R) [S](#S) [T](#T) [U](#U) [V](#V) [W](#W) [X](#X) [Y](#Y) [Z](#Z)

  

#### Average

描述：给定度量的绝对值。

语法：Average(维度, 度量, 筛选器维度值)  
  

#### Count

描述：给定维度内的维度值的数量。

语法：Count(维度)  
  

#### Difference

描述：两个提供的维度值之间的度量值差异。

语法：Difference(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### DifferenceFromMean

描述：给定维度值的平均值和度量值之间的差异。

语法：DifferenceFromMean(维度, 度量, 第一个维度值, 筛选器维度值)  
  

#### Direction

描述：描述两个提供的维度值的度量值之间的方向（例如，增加或减少）的语言。

语法：Direction(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值, 短语)  
  

#### Ending Label

描述：系列中最后一个期间的名称。

语法：Label(度量)  
  

#### EndingValue

描述：给定度量的系列中最后一个期间的值。

语法：EndingValue(度量, 筛选器维度值)  
  

#### Label

描述：给定度量的标签。

语法：Label(度量)  
  

#### LargestNegativeChangeDifference

描述：给定序列中按绝对值计算的最大负周期间差值。

语法：LargestNegativeChangeDifference(度量, 筛选器维度值)  
  

#### LargestNegativeChangeEndingLabel

描述：给定序列中按绝对值计算的最大负期间差异的结束期间的名称。

语法：LargestNegativeChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestNegativeChangeEndingValue

描述：给定序列中按绝对值计算的最大负周期间差异的结束值。

语法：LargestNegativeChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestNegativeChangePercentDifference

描述：给定序列中按绝对值计算的最大负周期间差异的百分比变化。

语法：LargestNegativeChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestNegativeChangeStartingLabel

描述：给定序列中按绝对值计算的最大负期间差异的开始期间的名称。

语法：LargestNegativeChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestNegativeChangeStartingValue

描述：给定序列中按绝对值计算的最大负周期间差异的开始值。

语法：LargestNegativeChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeDifference

描述：给定序列中按百分比计算的最大负周期间差值。

语法：LargestNegativePercentChangeDifference(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeEndingLabel

描述：给定序列中按百分比计算的最大负期间差异的结束期间的名称。

语法：LargestNegativePercentChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeEndingValue

描述：给定序列中按百分比计算的最大负周期间差异的结束值。

语法：LargestNegativePercentChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangePercentDifference

描述：给定序列中按百分比计算的最大负周期间差异的百分比变化。

语法：LargestNegativePercentChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeStartingLabel

描述：给定序列中按百分比计算的最大负期间差异的开始期间的名称。

语法：LargestNegativePercentChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestNegativePercentChangeStartingValue

描述：给定序列中按百分比计算的最大负周期间差异的开始值。

语法：LargestNegativePercentChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestPositiveChangeDifference

描述：给定序列中按绝对值计算的最大正周期间差值。

语法：LargestPositiveChangeDifference(度量, 筛选器维度值)  
  

#### LargestPositiveChangeEndingLabel

描述：给定序列中按绝对值计算的最大正期间差异的结束期间的名称。

语法：LargestPositiveChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestPositiveChangeEndingValue

描述：给定序列中按绝对值计算的最大正周期间差异的结束值。

语法：LargestPositiveChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestPositiveChangePercentDifference

描述：给定序列中按绝对值计算的最大正周期间差异的百分比变化。

语法：LargestPositiveChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestPositiveChangeStartingLabel

描述：给定序列中按绝对值计算的最大正期间差异的开始期间的名称。

语法：LargestPositiveChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestPositiveChangeStartingValue

描述：给定序列中按绝对值计算的最大正周期间差异的开始值。

语法：LargestPositiveChangeStartingValue(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeDifference

描述：给定序列中按百分比计算的最大正周期间差值。

语法：LargestPositivePercentChangeDifference(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeEndingLabel

描述：给定序列中按百分比计算的最大正期间差异的结束期间的名称。

语法：LargestPositivePercentChangeEndingLabel(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeEndingValue

描述：给定序列中按百分比计算的最大正周期间差异的结束值。

语法：LargestPositivePercentChangeEndingValue(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangePercentDifference

描述：给定序列中按百分比计算的最大正周期间差异的百分比变化。

语法：LargestPositivePercentChangePercentDifference(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeStartingLabel

描述：给定序列中按百分比计算的最大正期间差异的开始期间的名称。

语法：LargestPositivePercentChangeStartingLabel(度量, 筛选器维度值)  
  

#### LargestPositivePercentChangeStartingValue

描述：给定序列中按百分比计算的最大正周期间差异的开始值。

语法：LargestPositivePercentChangeStartingValue(度量, 筛选器维度值)  
  

#### LongestStreakDifference

描述：给定系列的最长连续增加或减少的差异。

语法：LongestStreakDifference(度量, 筛选器维度值)  
  

#### LongestStreakDirection

描述：给定系列的最长连续增加或减少的方向（正或负）。

语法：LongestStreakDirection(度量, 筛选器维度值)  
  

#### LongestStreakEndingLabel

描述：给定系列的最长连续增加或减少的结束期间的名称。

语法：LongestStreakEndingLabel(度量, f筛选器维度值)  
  

#### LongestStreakEndingValue

描述：给定系列的最长连续增加或减少的结束值。

语法：LongestStreakEndingValue(度量, 筛选器维度值)  
  

#### LongestStreakLength

描述：给定系列连续增加或减少的最大期间数。

语法：LongestStreakLength(度量, 筛选器维度值)  
  

#### LongestStreakPercentDifference

描述：给定系列的最长连续增加或减少的百分比差异。

语法：LongestStreakPercentDifference(度量, 筛选器维度值)  
  

#### LongestStreakStartingLabel

描述：给定系列的最长连续增加或减少的开始期间的名称。

语法：LongestStreakStartingLabel(度量, 筛选器维度值)  
  

#### LongestStreakStartingValue

描述：给定系列的最长连续增加或减少的开始值。

语法：LongestStreakStartingValue(度量, 筛选器维度值)  
  

#### MaxLabel

描述：具有给定度量最大值的实体的名称。

语法：MaxLabel(维度, 度量, 筛选器维度值)  
  

#### MaxValue

描述：给定度量的最大值。

语法：MaxValue(度量)  
  

#### Median

描述：给定度量的中值。

语法：Median(维度, 度量, 筛选器维度值)  
  

#### MinLabel

描述：具有给定度量最小值的实体的名称。语法：MinLabel(维度, 度量, 筛选器维度值)  
  

#### MinValue

描述：给定度量的最小值。

语法：MinValue(维度, 度量, 筛选器维度值)  
  

#### PercentDifference

描述：两个提供的维度值之间度量值的百分比差异。

语法：PercentDifference(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### PercentOfWhole

描述：给定维度值的度量值占该维度的总度量值的百分比。

语法：PercentOfWhole(维度, 度量, 维度值, 筛选器维度值)  
  

#### PeriodLabel

描述：系列中第 n 个期间的名称，从 1 开始。

语法：PeriodLabel(索引)  
  

#### PeriodLabelNewest

描述：系列中第 n 个期间的名称，从最新开始倒数。

语法：PeriodLabelNewest(索引)  
  

#### PeriodValue

描述：给定度量在序列中第 n 个期间的值，从 1 开始。

语法：PeriodValue(度量, 索引, 筛选器维度值)  
  

#### PeriodValueNewest

描述：给定度量在系列中第 n 个期间的值，从最新开始倒数。

语法：PeriodValueNewest(度量, 索引)  
  

#### Range

描述：给定度量的最大值和最小值之间的差异。

语法：Range(维度, 度量, 筛选器维度值)  
  

#### SortAscendingLabel

描述：给定度量的实体名称，按给定等级按降序排序（从 1 开始）。

语法：SortAscendingLabel(度量, 等级, 维度, 筛选器维度值)  
  

#### SortAscendingValue

描述：给定度量的值，按给定等级按升序排序（从 1 开始）。

语法：SortAscendingValue(度量, 等级, 维度, 筛选器维度值)  
  

#### SortDescendingLabel

描述：给定度量的实体名称，按给定等级按降序排序（从 1 开始）。

语法：SortDescendingLabel(度量, 等级, 维度, 筛选器维度值)  
  

#### SortDescendingValue

描述：给定度量的值，按给定等级按降序排序（从 1 开始）。

语法：SortDescendingValue(度量, 等级, 维度, 筛选器维度值)  
  

#### StartingLabel

描述：系列中第一个期间的名称。

语法：StartingLabel()  
  

#### StartingValue

描述：给定度量的系列中第一个期间的值。

语法：StartingValue(度量, 筛选器维度值)  
  

#### StartToFinishDifference

描述：给定系列中第一个期间和最后一个期间的值之间的差异。

语法：StartToFinishDifference(度量, 筛选器维度值)  
  

#### StartToFinishPercentDifference

描述：给定系列中第一个期间和最后一个期间的值之间的百分比差异。

语法：StartToFinishPercentDifference(度量, 筛选器维度值)  
  

#### StdDev

描述：给定度量的标准偏差值。

语法：StdDev(维度, 度量, 筛选器维度值)  
  

#### Sum

描述：两个提供的维度值的度量值之和。

语法：Sum(维度, 度量, 第一个维度值, 第二个维度值, 筛选器维度值)  
  

#### Total

描述：给定度量的值总和。

语法：Total(维度, 度量, 筛选器维度值)  
  

#### Value

描述：给定维度、度量和维度值的指标值。

语法：Value(维度, 度量, 维度值, 筛选器维度值)  
  

#### Z-Score

描述：给定度量的 z 分数。

语法：Z-Score(维度, 度量, 第一个维度值, 筛选器值)

<!-- document id=877cb08945919836c2ccdc656d22c93396fabd4def652f22577204d3cba3d078 url=/tableau/next/zh-cn/online/data_stories_customize_hide_reorder.md -->

[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事：隐藏和重新排序内容

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

通过隐藏或重新排序故事中的内容，使用对您和您的受众群体最重要的内容自定义您的 Tableau 数据故事。

## 隐藏内容和版块

1. 创建您的数据故事，并单击“编辑”以打开“编辑”对话框。
2. 通过单击“显示部分”开关切换到打开或关闭位置，将版块设置为显示或隐藏。
3. 将光标悬停在每个单独句子右侧的蓝色框上，然后单击该框以在视图中显示或隐藏。
4. 单击“保存”。  
      
    ![“编辑故事”对话框，其中隐藏了三个句子。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_hideshow.png)

现在，只有设置为“显示”的句子和版块才会出现在您的数据故事中。

## 重新排序版块内的内容  

1. 创建您的数据故事，并单击“编辑”以打开“编辑”对话框。
2. 将光标悬停在要重新排序的内容的左侧菜单上。您的光标会变成手形图标。
3. 用光标单击该项并将其拖到同一版块中的任意位置。
4. 单击“保存”。  
      
    ![“编辑故事”对话框，光标（手形）图标悬停在要单击和拖动的句子上。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_custom_reorder.png)

现在，这些句子按照您设置的顺序出现在您的数据故事中。  

**注意：**目前，内容只能在同一版块内移动。尚不支持移动整个版块。

<!-- document id=a58630cf77d56773a33aabeaf6e6c07a5f43bcbab79c0c0c2a8b938b69b0a8f0 url=/tableau/next/zh-cn/online/dates_custom_date_formats.md -->

[跳转到主要内容](#main-content)

# 自定义日期格式

本文论述如何使用自定义日期格式字段来设置视图中日期的格式。有关 Tableau 如何处理日期的概述，请参见[“日期和时间”](https://help.tableau.com/current/pro/desktop/zh-cn/dates.htm)或[“更改日期级别”](https://help.tableau.com/current/pro/desktop/zh-cn/dates_levels.htm)。有关为**数据源**设置日期属性的信息，请参见[“数据源的日期属性”](https://help.tableau.com/current/pro/desktop/zh-cn/date_properties.htm)。

## 如何查找自定义日期格式字段

### 在视图中设置日期字段的格式 (Tableau Desktop)

若要在 Tableau Desktop 中设置视图中日期字段的格式，请右键单击（在 Mac 上按住 Control 单击）该字段，并选择“格式”。

![视图中的上下文菜单突出显示了格式选项。](/tableau/next/zh-cn/online/zh-cn/Img/date_format_view.png)

这将在视图左侧打开“设置格式”面板。选择“日期”字段。

![突出显示日期格式下拉菜单的标题窗格。](/tableau/next/zh-cn/online/zh-cn/Img/date_format_pane.png)

Tableau 会显示可用格式的列表。如果使用离散日期部分，您将看到与该日期部分相关的选项（例如自动、两位数和四位数作为 **YEAR(\[Order Date\])** 的选项）。对于连续日期或“确切日期”离散日期，列表中的最后一项为“自定义”。您将单独使用或以组合方式使用“支持的日期格式符号”表中列出的格式符号来指定自定义日期。

### 设置视图中日期字段的格式（Tableau Cloud 和 Tableau Server）

若要在 Tableau Cloud 和 Tableau Server 中设置视图中日期字段的格式，请右键单击（在 Mac 上按住 Control 单击）该字段，并选择“设置日期格式”。  
  
![](/tableau/next/zh-cn/online/zh-cn/Img/CustomDate_Cloud.png)  
  

### 在“数据”窗格中设置日期字段的格式（仅限 Tableau Desktop）

若要设置“数据”窗格中日期字段的格式，请右键单击该字段，并选择“默认属性”\>“日期格式”。

![默认日期格式窗口，包含各种日期格式选项以及选定的自定义选项。](/tableau/next/zh-cn/online/zh-cn/Img/date_format_custom.png)

当工作簿连接到 Tableau 数据提取或通过实时连接来连接到也支持日期格式的数据源时，支持使用表中的日期格式。（请参阅数据源的文档来验证所需的日期格式是否受支持。）

Tableau 将从数据源中检索日期格式。Tableau Server 还可以从运行 Tableau Server 的服务器上的用户运行身份帐户中检索日期格式。

**注意：** 以下日期格式可能与用于[类型转换](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_typeconversion.htm)函数的日期格式不同。有关使用 DATEPARSE 函数的详细信息，请参见[将字符串转换为日期字段](https://help.tableau.com/current/pro/desktop/zh-cn/data_dateparse.htm)。

## 支持的日期格式符号

使用以下符号来构建自定义日期格式。

<table cols="2" style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 87px;" class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>符号</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>描述</b></td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">(<b>:</b>)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">时间分隔符。某些<span class="unresolvedLink">区域设置</span>中使用不同字符来表示时间分隔符。在设置时间值的格式时，时间分隔符用于分隔小时、分钟和秒。格式化输出中用作时间分隔符的实际字符由您的系统设置确定。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">(<b>/</b>)</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="unresolvedLink">日期分隔符</span>。某些区域设置中使用不同字符来表示日期分隔符。在设置日期值的格式时，日期分隔符用于分隔日、月和年。格式化输出中用作日期分隔符的实际字符由您的系统设置确定。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">c</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">按该顺序将日期显示为 <code>ddddd</code>，并将时间显示为<br><code>ttttt</code>。如果日期系列数字中没有小数部分，则只显示日期信息；如果没有整数部分，则只显示时间信息。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">d</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将天显示为不含前导零的数字 (1 -31)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将天显示为包含前导零的数字 (01 -31)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将天显示为缩写形式 (Sun，Sat)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将天显示为全名 (Sunday，Saturday)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ddddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将日期显示为完整日期（包括日、月和年），格式依据系统的短日期格式设定来设置。默认短日期格式为 <code>m/d/yy</code>。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">dddddd</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将日期系列数字显示为完整日期（包括日、月和年），格式依据系统识别的长日期设定来设置。默认长日期格式为 <code>mmmm dd, yyyy</code>。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">aaaa</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">与 dddd 相同，只不过它是字符串的本地化版本。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">w</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将一周中的一天显示为数字（1 表示星期日，直至 7 表示星期六）。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ww</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将年中的周显示为数字 (1 -54)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">M</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将月份显示为不含前导零的数字 (1 12)。如果 <code>m</code> 紧跟 <code>h</code> 或 <code>hh</code>，则会显示分钟而不是月份。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将月份显示为包含前导零的数字 (01 -12)。如果 <code>m</code> 紧跟 <code>h</code> 或 <code>hh</code>，则会显示分钟而不是月份。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将月份显示为缩写形式 (Jan-Dec)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将月份显示为完整月份名称 (January-December)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">MMMMM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将月份显示为单个字母缩写 (J-D)</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">oooo</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">与 MMMM 相同，但已本地化。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">q</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将年中的季度显示为数字 (1-4)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">y</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将年中的一天显示为数字 (1-366)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">yy</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将年显示为 2 位数字 (00-99)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">yyyy</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将年显示为 4 位数字 (100-9999)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">h</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将小时显示为不含前导零的数字 (0-23)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Hh</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将小时显示为包含前导零的数字 (00-23)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">N</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将分钟显示为不含前导零的数字 (0 59)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Nn</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将分钟显示为包含前导零的数字 (00 59)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">S</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将秒显示为不含前导零的数字 (0 59)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Ss</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将秒显示为包含前导零的数字 (00 59)。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">000</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">显示毫秒。在指定毫秒之前使用句点字符作为分隔符。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">t t t t t</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">将时间显示为完整时间（包括小时、分钟和秒），使用系统识别的时间格式所定义的时间分隔符进行格式设置。如果选择了前导零选项并且时间早于 10:00 A.M. 或 P.M，则显示前导零。默认时间格式为 <code>h:mm:ss</code>。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AM/PM</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">使用 12 小时制并为中午之前的任何小时显示大写 AM；为中午和 11:59 P.M 之间的任何小时显示大写 PM。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">am/pm</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">使用 12 小时制并为中午之前的任何小时显示小写 AM；为中午和 11:59 P.M 之间的任何小时显示小写 PM。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">A/P</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">使用 12 小时制并为中午之前的任何小时显示大写 A；为中午和 11:59 P.M 之间的任何小时显示大写 P。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">a/p</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">使用 12 小时制并为中午之前的任何小时显示小写 A；为中午和 11:59 P.M 之间的任何小时显示小写 P。</td></tr><tr valign="top" class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">AMPM</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">使用 12 小时制，并为中午之前的任何小时显示您的系统定义的 AM <span class="unresolvedLink">字符串文本</span>；为中午和 11:59 P.M 之间的任何小时显示系统定义的 PM 字符串文本。AMPM 可以为大写或小写，但显示的字符串的大小写与系统设置定义的字符串匹配。默认格式为 AM/PM。</td></tr></tbody></table>

## 自定义日期格式示例

可以单独使用或以组合方式使用上表中的任何日期格式符号。

如果指定自定义格式 yyyy-MM-dd HH:mm:ss.000，则会以 2015-05-10 11:22:16.543 格式生成日期。此类格式可能适合于科学数据。

如果指定自定义格式 DDDD DD，则会生成显示工作日和天的日期，如下所示。

![](/tableau/next/zh-cn/online/zh-cn/Img/FormattingNumbersDates_CustomDateFinal.png)

如果指定自定义格式 `yy-mm-dd (dddd)`，则会以 **18-01-04 (Thursday)** 格式生成日期。

如果指定自定义格式 `"Q"1 YYYY`，则会生成显示 **Q1 2018** 的日期。

## 基于日本年号的日期格式的支持

Tableau 支持基于日本天皇年号的日期 (Wareki) 格式。下面介绍了如何将基于年号的日期格式应用于视图中的字段：

1. 将工作簿区域设置设为日语。
2. 右键单击视图中想要为其设置日期格式的字段。
3. 选择“设置格式”。
4. 在“格式”窗格中，从“日期”下拉列表中选择格式。

如果所需的格式未列出，您可以构建自己的日期格式。为此，请在“日期”框中选择“自定义格式”，然后键入使用 Tableau 日期占位符的格式。提供了以下基于年号的年份占位符：

<table style="width: 100%;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"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>符号</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>描述</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">g</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">短年号名称（例如表示平成年号的 H）。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">gg</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">ggg</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">e</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">基于年号的年份，例如表示某个年号元年的 1。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">ee</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">基于年号的年份，例如表示某个年号元年的 01。如果只有一位数，则会在基于年号的年份前面添加一个零。</td></tr></tbody></table>

如果工作簿区域设置不是日语，您可以创建自定义日期格式，然后在格式前面插入语言代码 !ja\_JP!，以使看起来如下所示：

`!ja_JP! gg ee"年"mm"月"dd"日"`

该语言代码会强制将日期作为日语日期处理。

Tableau Server 浏览器视图不完全支持基于年号的日期。特别是，如果发布包含交互式筛选器的工作簿，则不会填入 e 和 g 占位符：

![ ](/tableau/next/zh-cn/online/zh-cn/Img/japaneseEra.png)

为了避免此问题，如果将在浏览器中查看您的工作簿，请不要在交互式筛选器中显示基于年号的日期。

## 在日期格式中使用字面文本

您可能希望日期格式包括某些单词或短语，例如 **Fiscal Quarter q of yyyy**。但是，如果您直接在 Tableau 格式框中键入该文本，则系统可能会像对待日期部分那样对待这些字母：

![ ](/tableau/next/zh-cn/online/zh-cn/Img/dateFormatEscape.png)

为了避免 Tableau 这样做，请在不应作为日期部分处理的字母和单词两边加上双引号：`"Fiscal Quarter" q "of" yyyy`。

如果希望在已加引号的部分内部使用字面引号，请插入此代码：`"\""`。例如，格式 `"Fiscal "\"" Quarter"` 将被格式化为 **Fiscal " Quarter**。

## 数据提取数据源 DATEPARSE 函数的格式语法

如果要在数据提取中使用 DATEPARSE 函数，请使用 Unicode 协会定义的语法。

下表列出了 DATEPARSE 函数支持的格式。

<table class="table-plain"><colgroup><col class="Column-Column1"><col class="Column-Column1"><col class="Column-Column1"></colgroup><tbody><tr class="Body-Body1"><th class="BodyE-Column1-Body1" style="font-weight: bold;">日期部分</th><th class="BodyE-Column1-Body1" style="font-weight: bold;">符号</th><th class="BodyE-Column1-Body1" style="font-weight: bold;">示例输出</th></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">年</td><td class="BodyE-Column1-Body2"><p>yy</p><p>y, yyyy</p><p>Y</p></td><td class="BodyE-Column1-Body2"><p>26</p><p>2026</p><p>2026（用于基于年中某周的日历）</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">年中的季度</td><td class="BodyE-Column1-Body1"><p>Q</p><p>QQ</p><p>QQQ</p><p>QQQQ</p></td><td class="BodyE-Column1-Body1"><p>2</p><p>02</p><p>Q2</p><p>第二季度</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">月</td><td class="BodyE-Column1-Body1"><p>M</p><p>MM</p><p>MMM</p><p>MMMM</p></td><td class="BodyE-Column1-Body1"><p>9</p><p>09</p><p>9 月</p><p>九月</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">一年中的某周</td><td class="BodyE-Column1-Body2">w、ww</td><td class="BodyE-Column1-Body2">47</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">周中的天</td><td class="BodyE-Column1-Body2"><p>E, EE, EEE</p><p>EEEE</p><p>EEEEE</p></td><td class="BodyE-Column1-Body2"><p>周一</p><p>星期一</p><p>M</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">月中的天</td><td class="BodyE-Column1-Body1"><p>d</p><p>dd</p></td><td class="BodyE-Column1-Body1"><p>1、15</p><p>01、15</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">年中的天 (1-365)</td><td class="BodyE-Column1-Body2">D</td><td class="BodyE-Column1-Body2">23、143</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2"><p>小时 (1-12)</p></td><td class="BodyE-Column1-Body2"><p>h</p><p>hh</p></td><td class="BodyE-Column1-Body2"><p>8</p><p>08</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">小时 (0-23)</td><td class="BodyE-Column1-Body2"><p>H</p><p>HH</p></td><td class="BodyE-Column1-Body2"><p>8</p><p>08</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">分钟</td><td class="BodyE-Column1-Body1"><p>m</p><p>mm</p></td><td class="BodyE-Column1-Body1"><p>8</p><p>08</p></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">一分钟中的秒</td><td class="BodyE-Column1-Body2"><p>s</p><p>ss</p></td><td class="BodyE-Column1-Body2"><p>5</p><p>05</p></td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">小数秒</td><td class="BodyE-Column1-Body1"><p>S</p><p>SS</p><p>SSS</p><p>SSSS</p></td><td class="BodyE-Column1-Body1"><p>2</p><p>23</p><p>235</p><p>2350</p></td></tr><tr class="Body-Body2"><td class="BodyB-Column1-Body2">天中的毫秒</td><td class="BodyB-Column1-Body2">A</td><td class="BodyB-Column1-Body2">34532</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">期间（am/pm 标记）</td><td class="BodyE-Column1-Body1">a、aa、aaa</td><td class="BodyE-Column1-Body1">AM、am、PM</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">时区</td><td class="BodyE-Column1-Body2"><p>z、zz、zzz</p><p>zzzz</p><p>Z、ZZ、ZZZ</p><p>ZZZZ</p></td><td class="BodyE-Column1-Body2"><p>PDT</p><p>太平洋夏令时</p><p>-0800</p><p>PST-08:00</p></td></tr></tbody></table>

有关日期符号的更完整列表，请参见“Unicode 国际化组件”页面的[日期和时间格式设置概述](https://unicode-org.github.io/icu/userguide/format_parse/datetime/)。

**注意：** 并非所有数据库和文件类型都支持某些日期格式。

### 有关 .hyper 数据提取中日期格式的注意事项

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;width: 80%;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><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">时间单位</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"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-era" target="_blank">年代</a></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"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-year" target="_blank">年</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>.Hyper 数据提取中支持除“U”之外的所有符号。</p><p><b>注意：</b></p><ul><li><p>负值表示公元前 (BC) 年份。例如，<code>DATEPARSE('y','-10'</code>) 返回公元前 11 年的一月，<code>DATEPARSE('y','-0')</code> 返回公元前 1 年的一月。</p></li><li><p>如果使用日历年的“y”模式“yy”将请求年份的两个低位数。对于小于 70 的数字，DATEPARSE 函数返回年份 2000+x。对于大于或等于 70 的数字，DATEPARSE 函数返回年份 1900+x。</p></li><li><p>如果使用基于“ISO 周日期”的日历中的“Y”，年份过渡将在周边界上进行，可能与日历年过渡不同。“Y”标示与 ISO 年-周日历中的模式字符“w”结合使用。ISO 周日期系统实际上是 ISO 8601 日期和时间标准中规定的一种闰周日历系统。与“y”类似“Y”的负值表示公元前 (BC) 年份。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-month" target="_blank">月</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>.Hyper 数据提取中支持除“I”之外的所有符号。</p><p><b>注意：</b>&nbsp;</p><ul><li><p>月标示与表示日数的“d”结合使用。</p></li><li><p>与 ICU 相反，.hyper 数据提取允许值 1-12。其他值将导致错误。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-week" target="_blank">周</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>.Hyper 数据提取中支持除“W”之外的所有符号。</p><p><b>注意：</b></p><ul><li><p>如果使用“w”，与 ICU 相反，.hyper 数据提取仅允许有效的周数。一年有 52 或 53 周 (ISO 8601)。DATEPARSE 函数会验证输入。例如，2016 年的第 53 周将导致错误，原因是 2016 年不存在第 53 周。</p></li><li><p>如果使用“W”，ICU 将不支持此标示，但它对于像“九月的第 1 个星期一”这样的日期很有用。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-day" target="_blank">日</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>注意：</b></p><ul><li><p>如果使用“d”，与 ICU 相反，.hyper 数据提取仅允许有效的日数。例如，2 月 31 日将发生错误。</p></li><li><p>如果使用“D”，与 ICU 相反，.hyper 数据提取仅允许有效的日数。例如，2017 年的第 336 日将发生错误。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-hour" target="_blank">小时</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>.Hyper 数据提取中仅支持“h”和“H”符号。</p><p><b>注意：</b></p><ul><li><p>如果使用“h”，.hyper 数据提取对于此字段不允许负值。负值将导致错误。</p></li><li><p>如果使用“H”，.hyper 数据提取对于此字段不允许负值。负值将导致错误。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-minute" target="_blank">分钟</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>注意：</b>与 ICU 相反，.hyper 数据提取对于此字段不允许负值。负值将导致错误。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-second" target="_blank">秒</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>注意：</b>&nbsp;</p><ul><li><p>与 ICU 相反，.hyper 数据提取对于此字段不允许负值。负值将导致错误。</p></li><li>如果使用“S”，<code>DATEPARSE('ss.SSSS', '12.3456')</code> 将返回 1990-01-01 00:00:12:3456 AD。</li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-quarter" target="_blank">季度</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>注意：</b>与 ICU 相反，.hyper 数据提取仅允许值 1-4。所有其他值将导致错误。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-weekday" target="_blank">平日</a></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><b>注意：</b>&nbsp;</p><ul><li><p>如果使用“e”和“ee”，与 ICU 相反，.hyper 数据提取仅允许值 1-7。所有其他值将导致错误。</p></li><li><p>如果使用“c..cc”，与 ICU 相反，.hyper 数据提取仅允许值 1-7。所有其他值将导致错误。</p></li></ul></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a href="http://unicode.org/reports/tr35/tr35-dates.html#dfst-period" target="_blank">期间</a></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">不适用</td></tr></tbody></table>

<!-- document id=3dd406b080f9a4a4e1f8203fd464bf9b108522b0796ccbf418f7aead1052a5fe url=/tableau/next/zh-cn/online/pulse_alerts.md -->

[跳转到主要内容](#main-content)

# 获取 Tableau Pulse 通知

当您关注的指标越过不利的阈值范围或出现新的不利趋势时，Tableau Pulse 会提醒您。这些通知会出现在您的电子邮件和 Slack 摘要中，并以移动通知的形式发送，以便您不会错过数据的重要变化。如果您将摘要频率设置为每周或每月，Tableau Pulse 会发送一封电子邮件和 Slack 消息，其中包含在您未收到摘要的日子里发现的任何通知。

## Tableau Pulse 如何识别通知

Tableau Pulse 会每 24 小时检查一次是否有通知。此检查与 Tableau Pulse 生成电子邮件和 Slack 摘要同时进行。如果发现阈值或趋势通知，则会在当天的摘要中包含通知。如果您未计划在当天收到摘要，Tableau Pulse 会发送通知电子邮件和 Slack 消息。这些不定期消息在一天中正常发送摘要的同一时间发送。通知徽章还会在接下来的 24 小时内出现在受影响的指标卡上和该指标的“见解探索”页面上，直到下次 Tableau Pulse 检查是否有通知为止。

### 越过阈值通知

对于定义了不利阈值范围的指标，当聚合指标值进入不利范围时，Tableau Pulse 会提醒您。聚合指标值是指标范围范围内整个时间范围的值，例如当月的度量总和。此聚合值显示在指标卡和“见解探索”页面的顶部。某些指标具有显示非累积值的图表。如果其中一个非累积值进入不利阈值范围，则不会触发通知，除非该更改导致聚合值进入不利范围。

仅当指标最初进入不利范围时，Tableau Pulse 才会通知您。当值保持在不利范围内时，您不会继续收到通知。但是，如果聚合值回到有利范围，然后再次进入不利阈值范围，您将收到另一条通知。

### 趋势变化通知

Tableau Pulse 见解平台监控指标以检测数据的重要变化。趋势变化通知是见解平台寻找的见解类型之一。有关 Tableau Pulse 见解的详细信息，请参见[Tableau Pulse 中的见解平台和见解类型](https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm)。

如果指标出现新的不利趋势，则会触发趋势变化通知。

- 要成为新趋势，趋势必须与当前趋势显著不同。这种变化可能是之前趋势的变陡、变平或逆转。
- 必须在指标定义上设置情绪，以确定值的上升或下降是不利的。
- 趋势变化必须至少发生在三个周期内。从有利方向到不利方向的单日变化并不构成趋势。

Tableau Pulse 只会在最初发现趋势的那一天提醒您。当相同趋势持续时，您将不会继续收到通知。由于见解平台在识别趋势时会考虑数据中的模式，因此您不会收到预期季节性变化的通知。

在指标页面上，选择趋势变化徽章，然后选择“转到见解”以查看有关趋势的详细信息。

![趋势变化徽章](/tableau/next/zh-cn/online/zh-cn/Img/pulse_trend_change_badge.png)

浏览图表以了解构成不利趋势的数据点。

![趋势变化图表](/tableau/next/zh-cn/online/zh-cn/Img/pulse_trend_change_chart.png)

## 查看新通知

通知会出现在电子邮件和 Slack 中、您关注的指标上，并显示为移动通知。

<table class="table--plain"><thead><tr><th width="30%">地点</th><th>通知描述</th></tr></thead><tbody><tr><td>电子邮件和 Slack 摘要</td><td>通知列于摘要的顶部。摘要中显示的通知是在生成摘要时发现的通知。通知不会以每周或每月摘要形式汇总。</td></tr><tr><td>电子邮件和 Slack</td><td>如果 Tableau Pulse 在您未计划接收摘要的那一天发现通知，您将收到包含这些通知的电子邮件和 Slack 消息。</td></tr><tr><td>Tableau 主页</td><td>通知出现在主页顶部的 Tableau Pulse 通知中心。通知会持续出现 24 小时，直到下次 Tableau Pulse 检查是否有新的不利趋势为止。<p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/pulse_homepage_alert_center.png" alt="Tableau Pulse 通知中心"></p><p>通知徽章也会出现在您关注的指标上。当您浏览或搜索您未关注的指标时，您不会看到通知。</p></td></tr><tr><td>Tableau Mobile</td><td>如果您的设备上运行着 Tableau Mobile，您将收到相关通知的移动通知。如果您完全退出 Tableau Mobile 应用，则不会收到通知。若要关闭移动设备上的通知，请调整设备的 Tableau Mobile 通知设置。</td></tr></tbody></table>

## 针对指标关闭通知

您会收到您关注的所有指标的通知。您可以针对单个指标关闭通知。

1. 打开您想要为其关闭通知的指标。
2. 选择操作 (⋯) 菜单，然后选择“关闭通知”。

您可以通过选择操作菜单，然后选择“打开通知”来再次打开通知。

## 控制 Tableau Pulse 是否检查阈值和趋势变化

Tableau Pulse 中没有单独的通知设置。如果指标定义了不利阈值范围，Tableau Pulse 会在该指标进入不利范围时发出通知。

趋势变化通知见解设置控制 Tableau Pulse 是否针对新趋势生成见解，以及是否将新的不利趋势显示为向关注者发出的通知。若要了解如何关闭见解类型，请参见[配置见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights)。

如果您在指标定义上关闭此见解类型，则更改将应用于基于该定义的所有指标。该设置还会关闭指标的“见解探索”页面上的趋势见解。如果不关闭见解，就无法关闭通知。

关闭见解类型不会立即从受影响的指标中删除通知。下次 Tableau Pulse 检查通知并生成摘要时，通知将被移除，这可能需要长达 24 小时。

<!-- document id=217991ea1e0b071f0cd1b2d6540f22f90fd6e8a0b79d07388c6f5252ad5584a6 url=/tableau/next/zh-cn/online/tc_table_extensions.md -->

[跳转到主要内容](#main-content)

# 表扩展程序

表扩展程序允许您使用分析扩展程序脚本创建数据表。您可以编写一个自定义 TabPy 或 Rserve 脚本，并可以选择添加一个或多个输入表。Tableau Cloud、Tableau Server 和 Tableau Desktop 支持表扩展程序。本文档重点介绍 Tableau Cloud。

**注意：**与实时连接类似，每次打开工作簿或刷新数据源时，表扩展程序都会刷新。

### 好处

表扩展程序对新用户和有经验的用户都有以下好处。

- 轻松地将脚本或高级功能集成到 Tableau 中
- 轻松地将 Tableau 数据连接中的数据作为输入拖到脚本中
- 低代码编辑器使向数据源添加代码变得容易
- 与[数据指南](https://help.tableau.com/current/server/zh-cn/data_guide.htm)和[“数据解释”功能](https://help.tableau.com/current/server/zh-cn/explain_data_basics.htm)集成
- 与 TabPy、Rserve 和其他分析扩展程序集成
- 结果可用于构建仪表板或可视化项

## 先决条件

必须先完成以下列表，然后才能使用表扩展程序。

- 在 Desktop 或 Web 制作中打开数据源。
- 配置分析扩展程序
    - 有关配置分析扩展程序连接的步骤，请参见[使用分析扩展程序传递表达式](https://help.tableau.com/current/pro/desktop/zh-cn/r_connection_manage.htm)。

## 创建表扩展程序

若要创建表扩展程序，请完成以下步骤。

1. 打开已发布工作簿。
2. 打开数据源或创建数据源。
3. 在**“连接”**下，选择**“新建表扩展程序”**。
    
    ![连接菜单](/tableau/next/zh-cn/online/zh-cn/Img/new_table_extension.png)
4. 将它拖到数据模型中。
5. （可选）将表从数据连接拖到表扩展程序窗格中，以用作分析扩展程序脚本或函数的输入。
    
    - 默认情况下，来自 Tableau 的数据被传递到分析扩展程序并定义为 `variable _arg1`，一个类似字典的结构，例如： `{‘colum_name’: [1,2,3], ‘column_name_2’: [3,4,5]`
        
        **Python 示例：**可以使用以下方法将输入数据转换为 pandas 数据框。
        
        `import pandas as pddf = (pd.DataFrame(_arg1))`
    - 使用 RServe 时，输入数据被定义为变量 .arg1，数据类型是列表的命名列表。
    - 对于受支持的关系数据源，您可以使用自定义 SQL 作为表扩展程序的输入。在自定义 SQL 查询中使用参数时，更改参数会导致查询重新运行并重新计算脚本。这将创建一个路径来动态更新仪表板中的参数，并筛选或以其他方式将值传递给表扩展程序脚本。
        
        ![关系数据源](/tableau/next/zh-cn/online/zh-cn/Img/table_ext_2.png)
6. 在“脚本”区域中，输入您的脚本或函数调用。该脚本必须返回字典或列表的列表，本质上是一个 JSON 对象。RServe 的脚本必须返回一个 data.frame 或命名列表的列表，而 Python 的脚本必须返回一个字典。
    
    **Python 示例：**我们使用以下显式 return 命令。
    
    `return df.to_dict(orient='list')`

**注意：**如果在 TabPy 中禁用了 TABPY\_EVALUATE\_ENABLE，则表扩展程序不支持直接调用 TabPy 端点。

8. 选择**“应用”**运行脚本。
9. （可选）如果您将表扩展程序与数据模型中的另一个表相关联，请定义每个表中至少一个字段之间的关系。如果字段具有相同的名称，此操作可能会自动进行。
10. 选择**“立即更新”**，结果将显示在**“输出表”**选项卡中。
    
    ![输出结果表](/tableau/next/zh-cn/online/zh-cn/Img/table_ext_3.png)

**注意：**如果您没有在数据模型中定义与表的关系，则“输入表”选项卡为空，并将显示消息“数据预览不可用”。

1. （可选）在**“名称”**字段中，输入表扩展程序的唯一名称。
2. 转到“工作表”选项卡以开始探索和可视化数据。来自表扩展程序的结果将像 Tableau 中从平面文件或关系源查询的任何其他数据一样运行。
3. 发布工作簿以共享。发布目标（Server 或 Tableau Cloud）必须启用和配置适当类型的分析扩展程序。

> [!TIP]
> 
> **故障排除提示**：如果执行脚本时出现问题，来自分析扩展程序的错误将显示在 Tableau 错误消息中。如果您的表扩展程序遇到错误，请确保所有代码和格式正确，并尝试使用位于“保存”按钮旁边的圆形“刷新数据源”按钮，或再次单击“应用”。

### **表扩展程序与分析扩展程序**

虽然这些产品中的一些并不相关，但表扩展程序和分析扩展程序有几个共同的功能。表扩展程序功能依赖于与分析扩展程序的连接才能工作。让我们来分析一下每个功能。

#### 仪表板扩展程序

[仪表板扩展程序](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_extensions.htm)允许使用仪表板扩展 SDK 将自定义 Web 应用程序添加到仪表板，但是，此扩展程序类型与表扩展程序无关。

#### 表扩展程序

表扩展程序功能允许您在数据源中创建一个表，该表可以将数据和脚本发送到您的分析扩展程序，并返回一个任意形状的完整表作为结果。返回的结果在“数据源”选项卡的数据模型中显示为表，并在工作簿中显示为度量和维度。

#### 分析扩展程序

[分析扩展程序](https://www.tableau.com/zh-cn/developer/learning/getting-started-analytics-extensions-api)功能允许您使用编程语言（如 Python、外部工具和外部平台）扩展 Tableau 计算。创建与分析扩展程序的连接后，您可以通过称为 SCRIPT\_X 或 MODEL\_EXTERNAL\_X 的计算字段与外部服务器通信，其中 X 是预期返回值的数据类型。有关详细信息，请参见[使用分析扩展程序传递表达式](https://help.tableau.com/current/pro/desktop/zh-cn/r_connection_manage.htm)。

<!-- document id=7a9a363165712a751b7e7d507c7aeaf45b0226ad19a5204bb69fe5703825ffd8 url=/tableau/next/zh-cn/online/ts_table_extensions.md -->

[跳转到主要内容](#main-content)

# 表扩展程序

表扩展程序允许您使用分析扩展程序脚本创建新的数据表。您可以编写一个自定义 TabPy 或 Rserve 脚本，并可以选择添加一个或多个输入表。Tableau Cloud、Tableau Server 和 Tableau Desktop 支持表扩展程序。本文档重点介绍 Tableau Server。

**注意：**每次打开工作簿或刷新数据源时，数据都会刷新。

### 好处

表扩展程序对新用户和有经验的用户都有以下好处。

- 数据处理速度更快
- 低代码编辑器
- 与[“数据问答”(Ask Data) 功能](https://help.tableau.com/current/server/zh-cn/ask_data.htm)和[“数据解释”功能](https://help.tableau.com/current/server/zh-cn/explain_data_basics.htm)集成
- 与 TabPy 和 Rserve 集成
- 结果可用于构建仪表板或可视化项。

## 先决条件

必须先完成以下列表，然后才能使用表扩展程序。

- 配置分析扩展程序
    - 有关配置分析扩展程序连接的步骤，请参见[使用分析扩展程序配置连接](https://help.tableau.com/current/server/zh-cn/config_r_tabpy.htm)。
- 发布工作簿。

## 创建表扩展程序

若要创建新的表扩展程序，请完成以下步骤。

1. 打开已发布工作簿。

**注意：**必须先发布工作簿，然后才能添加表扩展程序。

3. 在**“工作表”**下，选择**“新建表扩展程序”**。
    
    ![连接菜单](/tableau/next/zh-cn/online/zh-cn/Img/new_table_extension.png)
4. （可选）将工作表拖到表扩展程序窗格中。
5. 在**“选择连接”**下，选择一个分析扩展程序。
    
    ![分析扩展程序下拉菜单](/tableau/next/zh-cn/online/zh-cn/Img/choose_analytics_extension.png)
6. 在**“脚本”**中，输入您的脚本。
7. 选择**“应用”**。
8. 选择**“立即更新”**，结果将显示在**“输出表”**选项卡中。
    
    ![输出结果表](/tableau/next/zh-cn/online/zh-cn/Img/table_extension_output_table.png)
9. 在**“名称”**字段中，输入新的表扩展程序的唯一名称。
10. 转到“工作表”选项卡，发布工作簿并保存它。

**注意：**如果编辑输入表，您必须再次按**“应用”**，然后才能查看或使用更新的输出表数据。

> [!TIP]
> 
> **故障排除提示**：如果您的表扩展程序遇到错误，请尝试使用位于**“保存”**按钮旁边的圆形**“刷新****数据****源”**按钮。

### **表扩展程序与分析扩展程序**

Tableau 有几个名称中带有“扩展程序”的不同功能。虽然这些产品中的一些并不相关，但表扩展程序和分析扩展程序是相关的。表扩展程序功能依赖于与分析扩展程序的连接才能工作。让我们来分析一下每个功能。

#### 表扩展程序

表扩展程序功能允许您创建工作簿计算，将数据和处理脚本发送到您的分析扩展程序。返回的结果在“数据源”选项卡上显示为表，并在工作簿中显示为度量和维度。

#### 分析扩展程序

分析扩展程序功能允许您使用编程语言（如 Python、外部工具和外部平台）扩展 Tableau 动态计算。创建与分析扩展程序的连接后，您将通过计算字段与外部服务器进行通信。有关详细信息，请参见[使用分析扩展程序配置连接](https://help.tableau.com/current/server/zh-cn/config_r_tabpy.htm)。

<!-- document id=316489898051cc692b515b9ffae7e481c17a7919b88a29cabadd5de671298f8a url=/tableau/next/zh-cn/online/data_connect_get_started.md -->

[跳转到主要内容](#main-content)

# 规划您的 Data Connect 部署

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 是面向 Tableau Cloud Enterprise 和 Tableau+ 客户的付费订阅服务。购买 Data Connect 后，站点管理员将能够在 Tableau Cloud 的设置页面中配置该服务。

### 基础设施规格

- **计算**：托管 Data Connect 的位置。这可以是裸机或虚拟机，可以位于私有网络或云中。
- **操作系统 (OS)** ：受支持的 Linux 发行版的最新版本和修补版本。
- **存储**：分配存储空间以托管操作系统、Data Connect 及其在执行刷新时创建的数据提取。
- **网络**：计算必须能够连接到您的数据源和公共互联网上的两个位置。

### 节点规格

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 460px;"></colgroup><tbody><tr><td>节点数</td><td><p>生产工作负载最小值：每个网络三个节点</p><p>开发/测试工作负载最小值：每个网络一个节点</p></td></tr><tr><td>vCPU</td><td>最低：8 个 vCPU<br>建议：16 个 vCPU 或更多</td></tr><tr><td>内存</td><td>最低：16 GB<br>建议：64 GB 或更多</td></tr><tr><td>根卷</td><td><p>最低：100 GB</p><p>建议：200 GB</p></td></tr><tr><td>可变卷</td><td><p>最低：100 GB</p><p>建议：200 GB</p></td></tr><tr><td><p>存储（两个磁盘）</p><p><b>重要信息</b>：辅助磁盘必须是原始的且未格式化。</p></td><td><p>根磁盘 <br>最低：200 GB 磁盘空间 <br>建议：大于 300 GB</p><p>辅助磁盘<br>最低：200 GB<br>建议：大于 500 GB</p></td></tr><tr><td>权限</td><td>主机的 root 访问权限</td></tr></tbody></table>

### Linux 操作系统

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td>支持的发行版</td><td>RHEL-8<br>RHEL-9<br>Ubuntu-20.04<br>Ubuntu-22.04</td></tr></tbody></table>

### 网络规格

有关 Data Connect 组件关系的详细信息，请参见[架构](https://help.tableau.com/v0.0/online/zh-cn/data_connect_about_overview.htm#Architec)。

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 50%;"><col style="width: 50%;"></colgroup><tbody><tr><td>代理筛选</td><td>请参见<a href="https://help.tableau.com/current/online/zh-cn/to_bridge_security.htm">可选的转发代理筛选</a>。</td></tr><tr><td>在端口 443（应用程序层）上与 Tableau Cloud 双向通信</td><td rowspan="2">每个 Tableau Cloud pod 的 IP 地址范围都是唯一的。若要确定您的 IP 地址范围，请参见<a href="https://help.tableau.com/current/pro/desktop/zh-cn/publish_tableau_online_ip_authorization.htm" target="_blank">授权访问发布到 Tableau Cloud 的云数据</a>。</td></tr><tr><td>在端口 80（应用程序层）上的认证验证出站请求</td></tr><tr><td>在端口 443 上进行出站 TLS 客户端身份验证，并进行双向 TLS 身份验证 <br>（业务流程层）</td><td>52.42.211.235<br>52.10.6.79 <br>35.167.70.143</td></tr><tr><td>完全限定域名 (FQDN) 的出站列表<br>（业务流程层）</td><td>tunnel.rafay-edge.net<br>api.rafay.dev<br>control.rafay.dev<br>fluentd-aggr.rafay-edge.net<br>influxdb01.core.rafay-edge.net<br>debug.core.rafay-edge.net<br>edge.core.rafay-edge.net<br>registry.rafay-edge.net<br>app.rafay.dev<br>console.rafay.dev<br>*.connector.kubeapi-proxy.rafay.dev<br>*.user.kubeapi-proxy.rafay.dev<br>event.core.rafay-edge.net<br>repo.rafay-edge.net<br>*.connector.cdrelay.rafay.dev<br>*.user.cdrelay.rafay.dev<br>*.connector.infrarelay.rafay.dev<br>*.user.infrarelay.rafay.dev</td></tr><tr><td><p>内部网络</p></td><td><p>群集节点需要与 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 相同的数据源网络访问权限。</p></td></tr><tr><td><p>入站网络规则</p><p>若要在环境中的节点之间启用通信，请在节点上为这些端口配置网络规则。<br></p></td><td><p>端口范围：</p><ul><li>53，TCP</li><li>6443，TCP</li><li>2379-2380，TCP</li><li>10250，10255，TCP</li><li>10259，10251，TCP</li><li>10257，10252，TCP</li><li>30000-32767，TCP</li><li>8285，8472，UDP</li><li>8500，TCP</li><li>8600，UDP</li><li>8301，TCP/UDP</li><li>9099，TCP</li><li>5656，TCP</li><li>4789，UDP</li></ul></td></tr><tr><td>Tableau Cloud 权限</td><td>站点管理员角色和访问数据源的凭据。</td></tr><tr><td>数据源</td><td>Data Connect 当前支持且可通过群集进行网络访问的数据源的身份验证方法。</td></tr></tbody></table>

### 数据库访问

Data Connect 使用 Tableau 连接器连接到不同数据库来使数据保持最新。其中一些连接器需要驱动程序来与数据库通信。若要获取 Data Connect 支持的连接器的驱动程序，请转到 Tableau [驱动程序下载](http://www.tableau.com/zh-cn/support/drivers)并筛选到 Linux。Data Connect 仅支持 Linux 驱动程序。确保使用针对每个数据库列出的说明。

### 数据库身份验证

数据源、Prep Conductor 流程或虚拟连接所连接到的基础数据通常需要身份验证。如果需要身份验证，发布者或所有者可以配置如何获取数据库凭据。

#### 数据源

数据源的身份验证配置选项包括_“提示用户”_或_“嵌入式密码”_。

- 如果数据源设置为提示用户，则数据库凭据不会随连接一起存储。这意味着，打开数据源（或使用数据源的工作簿）的用户必须输入自己的数据库凭据才能访问数据。
- 如果数据源设置为包含嵌入的密码，则数据库凭据将随连接一起保存，并由访问数据源（或刷新数据源）的任何人使用。

有关详细信息，请参见[设置凭据以访问您发布的数据](https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm)。

#### Tableau Prep Conductor 和虚拟连接

数据库凭据存储在 Prep 流程或虚拟连接中。对于 Prep 流程，凭据在 Prep Conductor 流程运行时使用。对于虚拟连接，任何访问虚拟连接的人都可以使用这些凭据。

有关数据源凭证管理的详细信息，请参见[Data Connect 安全性](https://help.tableau.com/v0.0/online/zh-cn/data_connect_security.htm)。

## 容量规划

管理员可以使用多种工具来管理 Data Connect 上的工作负载容量。

![Data Connect 服务的组件包括私有网络、池、群集和节点。](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_object_relationship.png)

### 群集管理

Data Connect 群集是访问指定私有网络内的数据的节点群集。这些节点可以访问其网络内已配置为访问的任何数据库。该群集所有节点上的所有 Bridge 客户端都可以处理有权访问群集的任何站点的工作负载。为了增加群集的容量，您可以向群集添加节点以增加吞吐量或增加计算机的大小（CPU、内存等）。

### 使用池实现负载平衡

每个群集使用一个池来平衡群集中所有 Bridge 客户端的流量负载。每个群集内有多个节点可确保您有多个 Bridge 客户端可用于处理与池相关的流量。对于添加到池的每个域，到该域的所有流量都会在群集中实现负载平衡。无法将域添加到站点上的多个池中。这种设计可确保流量得到适当的路由。

### 站点限制

对 Data Connect 交付的作业强制实施站点限制，以确保 Tableau Cloud 上的所有客户都能获得良好的体验。强制实施的限制与针对 Tableau Bridge 强制实施的限制相同，因为 Data Connect 代表您部署 Tableau Bridge 来为数据库查询提供服务。有关这些限制的详细信息，请参见[Bridge 站点容量](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_site_capacity.htm)。

有关容量规划的详细信息，请下载白皮书[使用 Tableau Cloud 访问您的私有网络数据](https://www.tableau.com/zh-cn/learn/whitepapers/tableau-bridge-data-connect-best-practices-guide)。

<!-- document id=3a79c44603d455e8ee719f49f5a69c225587a43746c5ef78bf77d139dc4dcfea url=/tableau/next/zh-cn/online/to_bridge_scale.md -->

[跳转到主要内容](#main-content)

# 计划 Bridge 部署

作为站点管理员，如果您是首次设置 Tableau Bridge 或升级，则有一组建议、最佳实践和规划任务需要遵循，以便为您的组织优化 Bridge。

有关 Bridge 的一般概述，请参见[使用 Bridge 使数据保持最新](https://help.tableau.com/v0.0/online/zh-cn/qs_refresh_local_data.htm)。

在部署 Bridge 之前，请查看以下信息，以帮助您（站点管理员）了解 Bridge 的不同组件、这些组件如何协同工作以及它们如何影响您的 Bridge 部署。

### Bridge 软件

Bridge 是独立软件，无需额外费用，可与 Tableau Cloud 结合使用。Bridge 是一种安装在防火墙后面的瘦客户端，用于在私有网络数据和 Tableau Cloud 之间实现连接。

若要利用最新的安全和功能更新，请始终从[下载](https://www.tableau.com/zh-cn/support/releases/bridge) 页面安装最新版本的 Bridge 客户端。有关详细信息，请参见[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm)主题。

大多数情况下，您将拥有组织中若干客户端或者客户端池的设置和管理权限。

- 客户端一次只能注册到一个站点。
- 可以注册到站点的客户端数没有限制。

### 数据库驱动程序

为了帮助在私有网络数据和 Tableau Cloud 之间进行连接，Bridge 需要驱动程序来与某些数据库通信。随客户端一起安装了一些驱动程序软件。其他驱动程序软件必须单独下载和安装。有关详细信息，请参见“安装 Bridge”主题中的[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm#database-drivers)部分。

### 池化容量

默认情况下，使用按照 Bridge 刷新计划刷新的数据提取连接的数据新鲜度任务、实时查询和数据源或虚拟连接将在池中可用客户端的范围内分配和实现负载平衡。

| 数据新鲜度任务 | 池化支持 | 并发容量 |
| --- | --- | --- |
| 实时查询 | 是 | 每个客户端 16 个实时查询 |
| 数据提取连接 - Bridge 刷新计划（已发布的数据源） | 是 | 每个客户端 10 次刷新（[可配置](https://help.tableau.com/current/online/zh-cn/to_sync_change_computer_site.htm#poolcapacity)） |
| 数据提取连接 - Bridge（旧版）计划 | 否 |  每个客户端 1 次刷新 |

Bridge 可用于纵向和横向扩展。配置 Bridge 部署时，请考虑以下事项：

- 对于在较高规格计算机上运行的较小客户端池，可以纵向扩展每个客户端以并行运行更多计划刷新作业。
- 对于在较低规格计算机上运行的较大客户端池，尽管每个客户端可以并行运行较少的刷新作业，但每个客户端仍为整个池提供高吞吐量和容量。

有关 Tableau 站点容量的信息，请参见[并发作业容量](https://help.tableau.com/current/online/zh-cn/to_site_capacity.htm#concurrent-jobs-capacity)。

### 数据访问和身份验证

数据源或虚拟连接所连接到的基础数据通常需要身份验证。如果需要身份验证，发布者或所有者可以配置如何获取数据库凭据。

对于数据源

数据源的身份验证配置选项包括：“提示用户”或“嵌入式密码”。

如果数据源设置为提示用户，则数据库凭据不会随连接一起存储。这意味着，打开数据源（或使用数据源的工作簿）的用户必须输入自己的数据库凭据才能访问数据。如果数据源设置为包含嵌入的密码，则数据库凭据将随连接一起保存，并由访问数据源（或使用数据源的工作簿）的任何人使用。有关详细信息，请参见[设置凭据以访问您发布的数据](https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm)。

**对于虚拟连接**

数据库凭据与虚拟连接的连接一起存储，供访问虚拟连接的任何人使用。

### 内容管理

大多数情况下，站点管理员拥有和管理 Bridge 客户端。内容所有者自己管理从发布到更新数据库凭据和刷新计划等各种任务的数据源或虚拟连接。

### 超时限制

实时查询的超时限制为 15 分钟。此限制不可配置。刷新的默认超时限制为 24 小时，可通过客户端配置。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#timeout)。

### 硬件推荐配置

下表显示了运行 Bridge 的虚拟环境的硬件准则。这些准则基于您需要每个客户端能够并行运行的并发刷新数。

<table style="width: 100%;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" rowspan="2">&nbsp;</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1" colspan="2" style="text-align: center;">每个客户端并行运行的刷新数</th></tr><tr class="TableStyle-Basic-Border-Head-Header1"><th class="TableStyle-Basic-Border-HeadE-Column1-Header1" style="text-align: left;">&lt;=5</th><th class="TableStyle-Basic-Border-HeadD-Column1-Header1">&lt;=10</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">vCPU</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">4</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">8</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">RAM</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">16 GB</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">32 GB</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">NVMe SSD</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">150 GB</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">300 GB</td></tr></tbody></table>

**磁盘空间注意事项**

所需的可用空间由在 Bridge 客户端上并行创建的数据提取（.hyper 文件）的总大小确定。此过程类似于在 Tableau Desktop 中创建数据提取，其中需要暂时将数据提取文件保存到磁盘。

若要规划磁盘空间，请计算预期并发刷新的数据源的最大大小。确保系统驱动器至少具有该数量的可用空间，外加一个缓冲区，以容纳临时文件。

对于 Windows 版 Tableau Bridge，在规划中务必考虑临时磁盘使用情况。请参见下面的[Windows 的磁盘空间规划](#disk-windows)部分。

**虚拟环境**

当 Tableau 的所有产品都配置了适当的底层 Windows 操作系统和最低硬件要求时，它们会在虚拟化环境中运行。

- Amazon EC2
- Citrix 环境（非流式处理）
- Google Cloud Platform
- Microsoft Azure
- Microsoft Hyper-V
- 并行
- VMware

## Linux 部署

若要在 Linux 上使用 Bridge，您必须创建自定义 Docker 映像，安装 RPM 包，然后从容器映像内部运行 Bridge。Linux 版 Bridge 项目仅在 Red Hat 和 Amazon Linux 上受支持。有关详细信息，请参见[为容器安装 Linux 版 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_linux_install.htm)。

## **Windows 部署**

Tableau 建议在防火墙后面的计算计算安装 Bridge 客户端。一台计算计算机只能安装一个客户端。

- Microsoft Windows 10 或更高版本，64 位
- Windows Server 2016、Windows Server 2019、Windows Server 2022
    
    **注意**：尚不支持 Windows Server 2025。有关详细信息，请参见产品知识文章 [Tableau Server 与 Windows Server 2025 不兼容](https://help.salesforce.com/s/articleView?id=004811287&type=1)。
- CPU 必须支持 SSE4.2 和 POPCNT 指令集

有关详细信息，请参见[Windows 客户端要求](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm#reqs)。[Windows 客户端要求](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm#reqs)

### Windows 的磁盘空间规划

在 Windows 上部署 Tableau Bridge 时，磁盘空间规划的主要问题是确保系统驱动器（通常为 C:）上有足够的可用空间，而不管 Tableau Bridge 应用程序安装在何处：

- 默认行为：与会将其所有文件移动到所选安装驱动器的 Tableau Server 不同，Tableau Bridge 客户端使用运行该客户端的用户的默认 Windows 配置文件设置。
- 使用位置：数据提取刷新所需的大量磁盘空间被临时 (TEMP/TMP) 文件和“我的 Tableau Bridge 存储库”文件夹占用。
- 系统驱动器依赖性：除非 Windows 管理员已显式更改用户的默认配置文件设置，否则 TEMP 目录和用户配置文件将驻留在系统驱动器（例如 C:）上，即使 Bridge 客户端安装在单独的驱动器上（例如 D:）。

请始终确认系统驱动器 (C:) 有足够的可用磁盘空间来处理数据提取创建过程中生成的临时文件，因为这是 TEMP/TMP 文件夹的默认位置。

### Windows 所需的帐户

Bridge 部署需要两种类型的帐户：Windows 服务帐户和 Tableau Cloud 帐户。

**Windows 服务帐户**

Bridge 客户端可在两种模式之一下运行：应用程序或服务。若要在“服务”模式下运行客户端，需要一个具有“以用户身份登录”权限的 Windows 服务帐户。“服务”模式允许客户端连续运行，而无需专用登录用户。建议使用“服务”模式来支持 1) 具有私有网络数据实时连接的数据源或虚拟连接，以及 2) 对客户端进行负载平衡（池化）。有关每种模式的详细信息，请参见[关于 Bridge 客户端](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm)。

**注意：**我们建议在单个 Windows 服务帐户下运行的客户端不超过 10 个。

**Tableau Cloud 帐户**

Tableau Cloud 通过登录到和管理客户端的用户对客户端进行身份验证。因此，Tableau Cloud 站点管理员帐户是执行某些管理任务所必需的，例如在客户端和 Tableau Cloud 站点上从池中添加或移除客户端。

管理 Bridge 需要以下站点角色之一：

- 站点管理员 Creator
- 站点管理员 Explorer

非管理员站点角色 Creator 和 Explorer 可以发布数据源，刷新数据，并使用 Bridge 来促进 Tableau Cloud 和专用网络数据之间的实时和数据提取连接。需要 Creator 或 Explorer 角色以及 Data Management 才能使用 Bridge 发布虚拟连接和刷新数据。

#### 计划容量

由于 Bridge 客户端可以轻松连接和断开连接，因此您可以利用脚本在预期数据新鲜度工作负载之前计划 Bridge 容量（即运行客户端计算机的数量）。

举例来说，如果您的 Bridge 客户端在 AWS 上的虚拟机上运行，以下 AWS 资源可以帮助您开始进行计划： 

- [AWS Instance Scheduler](https://docs.aws.amazon.com/solutions/latest/instance-scheduler/welcome.html)
- [如何使用 AWS Instance Scheduler 停止和启动我的实例？](https://aws.amazon.com/premiumsupport/knowledge-center/stop-start-instance-scheduler/)
- [如何使用 Lambda 按固定间隔停止和启动 Amazon EC2 实例？](https://aws.amazon.com/premiumsupport/knowledge-center/start-stop-lambda-cloudwatch/)

### Windows 上的新 Bridge 部署

若要部署 Bridge，请执行以下操作：

1. 对于每台计算机，使用 Windows 服务帐户登录，并安装最新的客户端。
2. 安装后，使用 Tableau Cloud 站点管理员凭据登录到客户端，以确保客户端[在“服务”模式下运行](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm)（默认情况下启用）。
3. 打开浏览器，使用您的站点管理员凭据登录到 Tableau Cloud，然后转到“Bridge 设置”页面以确保：
    
    1. [安装的客户端已正确链接到站点。](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm#step-1-ensure-clients-can-connect-to-the-site)
    2. [客户端是客户端池的一部分。](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm#step-2-enable-pooling)
4. 使用“Bridge 连接的数据源”管理视图[监视](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm#monitor-data-freshness-tasks) Bridge 实时查询，并通过 Tableau Cloud 上的“作业”页面刷新作业。

## 升级现有 Bridge 部署

与以前的版本一样，此版本中的企业改进旨在补充您现有的 Bridge 部署。与其他部署一样，我们建议执行以下步骤。

**注意：** 

- 无法将带有默认池的站点配置为访问特定的私有网络。为减少此池的访问范围并启用更高级的调度功能，我们建议您创建新池并将其映射到特定域。有关详细信息，请参见[步骤 2：配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#step2)。
- 由于 Bridge 池映射到特定域并刷新来自特定域的数据，我们强烈建议通过以下方式之一更新包含与多个域的连接的数据提取数据源：
    
    - 整合基础数据位置，使连接在同一个域中
    - 更改每个连接的连接类型以使用实时查询
    - 向每个连接转换为数据源
- 在 Mac 上使用 1) Tableau Desktop、2) 从 Windows 网络文件共享发布基于文件的数据源以及 3) 配置 Bridge 刷新计划时，刷新将失败。如果此基于文件的数据源是您组织的业务关键资源，请考虑改为配置 Bridge 旧版计划。有关详细信息，请参见[设置 Bridge 旧版计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#Set)。
- 已使用 Bridge 旧版计划配置并与特定客户端相关联的现有数据源（包括所有基于文件的数据源）将继续按预期运行。**重要信息：**版本 2025.2 中将移除对 Bridge 旧版计划的支持。为确保顺利过渡，我们建议您使用 Bridge 刷新计划。有关详细信息，请参见[从 Bridge 旧版计划迁移到 Bridge 刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#migrate)。

### 升级步骤

1. 添加新客户端。
2. 创建新池，将域映射到池，并将版本客户端分配给池。
    
    按照[步骤 2：配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#step2)、[步骤 3：为池指定域](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#step3)以及[步骤 4：将客户端添加到池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#step4)描述的过程进行操作。
3. 如果您有 Bridge 旧版计划，请要求数据源所有者转换（旧版）计划。请参见[从 Bridge 旧版计划迁移到 Bridge 刷新计划](https://help.tableau.com/current/online/zh-cn/to_sync_schedule.htm#migrate-from-bridge-legacy-to-online-schedules)。
    
    > [!IMPORTANT]
    > 
    > **重要信息：**我们建议数据源所有者通过转换对日常业务最不重要的数据提取数据源的刷新计划来开始此过程。这是因为将现有 Bridge 旧版计划转换为 Bridge 刷新计划将立即删除现有的刷新计划。
4. 升级现有客户端。有关详细信息，请参见[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm#upgrade)。
5. 将现有客户端添加到池。

升级后，确保升级的客户端以 Window 服务形式运行，然后将这些客户端添加到池中。有关详细信息，请参见[步骤 4：将客户端添加到池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm#step4)。

## 此部分中的其他文章

<!-- document id=005ec5229a50a64bb76b6d5efd8e8ad0ec4e8847f96581845a610e12323bb882 url=/tableau/next/zh-cn/online/prep_conductor_schedule_flow_task.md -->

[跳转到主要内容](#main-content)

# 计划流程任务

**注意**：可以使用 Tableau Prep Conductor 将流程安排在 Tableau Cloud 或 Tableau Server 上运行。Prep Conductor 通过 Data Management 在每次部署时获得许可。购买并许可 Data Management 后，必须启用 Prep Conductor。  
从版本 2020.4.1 开始，您不再需要 Data Management 许可证即可将流程发布到 Web。作为 Creator，您还可以直接在服务器上创建和编辑流程。有关在 Web 上制作流程的详细信息，请参见 [Web 上的 Tableau Prep](https://help.tableau.com/v0.0/online/zh-cn/prep_web_auth.htm)。  

> [!IMPORTANT]
> 
> **注意**：随着 2024.1 版本的发布，Tableau Cloud 上的流程计划发生了变化。左侧导航窗格上的“计划”选项卡已被移除，有权计划流程任务的用户将计划流程任务现在可以直接从流程的“计划任务”选项卡创建自定义计划。

从版本 2021.3 开始，您可以在计划任务以逐个运行流程时将流程运行链接在一起。有关详细信息，请参见本主题中的[计划链接任务](#linked_tasks)。

从版本 2022.1 开始，您还可以使用新的流程方法“查询链接任务”、“查询单个链接任务”和“立即运行链接任务”，通过 REST API 运行链接任务。有关详细信息，请参见 Tableau REST API 帮助中的[流程方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_flow.htm)。

**运行包含参数的流程**

从版本 2021.4 开始，您可以在流程中包含用户参数以使流程更具动态性。当流程运行时，系统会提示您输入参数值。按计划设置流程时，您可以在那时指定参数值。

您必须为任何必需的参数指定参数值。对于可选参数，您也可以输入这些值，或接受参数的当前（默认）值。有关使用参数运行流程的详细信息，请参见 Tableau Prep 帮助中的[按计划运行流程](https://help.tableau.com/current/prep/zh-cn/prep_parameters.htm#run-flow-schedule)。

从 Tableau Prep Builder 和 Tableau Cloud 版本 2023.2 开始，您可以将日期或时间系统参数应用于文件和已发布数据源输出类型的流程输出名称。开始时间会自动添加到流程输出名称中。

**注意**：您的管理员必须在您的服务器上启用“流程参数”服务器和站点设置，然后您才能运行在 Tableau Server 或 Tableau Cloud 中包含参数的流程。有关详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/web_author_flows.htm#flow-parameters) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/web_author_flows.htm#flow-parameters) 帮助中的**“在 Web 上创建流程并与其进行交互”**。

## 计划流程任务

1. 若要为单个任务创建计划，请执行以下操作之一：
    - 从流程的“概览”页面中，单击“计划任务”选项卡，单击“新建任务”或单击下拉菜单并选择“单个任务”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_single.png)
    
    - 从“浏览”页面中，在“列表”视图中的“操作”菜单中，选择“计划流程”\>“单个任务” 。如果您在列表中选择一个流程，您还可以使用顶部的“操作”菜单。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_schedule_tasks_explore.jpg)
2. 在“新建任务”对话框的“单个任务”选项卡上，单击“定义计划”。
3. 单击“时区”。您将被引导至设置页面。滚动到“计划任务的时区”，选择一个时区，然后单击“保存更改”。
4. 输入任务的频率，然后单击“保存”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_frequency.png)

您可以将频率设置为每小时、每天、每周或每月运行。时间和日间隔取决于您选择的重复频率，如下所述：

- **每小时**：可用频率是每小时从特定时间到特定时间。这意味着任务将在指定时间每小时运行一次。
- **每日**：可用频率为每两小时、四小时、六小时、八小时或十二小时一次，或每天一次。除了开始和结束时间之外，您还可以选择一周中的一个或多天。这意味着您可以在一周的所有或特定日期以特定小时间隔运行任务，或每天运行一次。
- **每周**：可用频率是一周中一天或多天的特定时间。这意味着您可以在一周中的某几天运行该任务，每周在某个时间运行一次。
- **每月**：您可以通过两种不同的方式设置此项：
    - 您可以选择“日”作为频率间隔，然后允许您选择该月的特定日期。例如，您可以选择在每月 2 号、15 号和 28 号的下午 2:45 运行。
    - 您还可以选择在每周的第一天、第二天、第三天、第四天、第五天和最后一天的特定时间运行。例如，您可以选择在每月的第二个星期三下午 2:45 运行该任务。

7. 选择以下选项之一：
    - 自动包括此流程的所有输出步骤：（默认）选择此选项可在计划任务中包含此流程所有当前和将来的输出步骤。随着时间的推移向流程中添加新输出步骤时，这些步骤会在流程运行时自动包括在计划中。
    - 选择要包括在此任务中的输出步骤：选择此选项并手动选择要包括在此计划任务中的输出步骤。
        
        若要在流程任务中包括所有输出步骤，请选中“输出步骤”旁的复选框。如果选中了“为此流程自动包括所有输出步骤”单选按钮，则无法编辑此区域。选择其他单选按钮以启用此部分。
8. 选择一种“刷新类型”。有关这些设置的详细信息，请参见[使用增量刷新来刷新流程数据](https://help.tableau.com/current/prep/zh-cn/prep_incremental_refresh.htm)。
    
    **注意**：如果一个输入配置为使用增量刷新，并且它与多个输出相关联，则这些输出必须一起运行，并且必须使用相同的刷新类型。否则，流程将失败。
    
    - 完全刷新（默认）：根据流程输出设置，刷新所有数据并且创建或将数据追加到表中。
    - 增量刷新：仅刷新新行，并根据流程输出设置创建或将数据追加到表中。仅当将流程配置为使用此刷新类型时，增量刷新选项才可用。
        
        **注意**：如果找不到现有输出，则无论选择什么运行选项，Tableau Prep Conductor 都会为所有输出运行完全刷新。后续流程运行将使用增量刷新过程，并仅检索和处理新行，除非缺少增量刷新配置数据，或者现有输出已移除。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_refresh.png)
9. （可选）如果您是流程所有者，请选择“完成后发送电子邮件”以在流程成功时通知用户。有关如何在流程运行时发送电子邮件通知的详细信息，请参见[通知用户流程运行成功](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_subscribe_to_flow.htm)。
10. 如果您的流程包含参数，请输入任何必需或可选的参数值。您必须输入所需的值才能运行流程。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_param_single.png)
11. 单击“**创建任务**”以创建计划任务。

## 计划链接任务

_在 Tableau Server 和 Tableau Cloud 版本 2021.3.0 及更高版本中受支持。_

**注意**：从版本 2022.1 开始，链接任务功能默认情况下已启用。服务器和站点管理员可以在“设置”页面和“计划”对话框中的流程计划上关闭此功能。在以前的版本中，服务器管理员必须首先启用此功能才能使用和管理它。

使用“链接任务”选项最多可以安排 20 个流程按顺序逐个运行。通过选择计划轻松设置流程列表，然后选择下游流以按您选择的顺序运行。

流程按照列表中指定的顺序运行。使用菜单在列表中移动流程，或随时将新的上游或下游流程添加到列表中。

每个单独链接任务的持续时间计入总流程运行时间限制。如果流程任务运行时达到运行时间限制，流程任务将超时，链接任务将失败，并且任何下游流程都不会运行。有关详细信息，请参见[作业运行时间容量](https://help.tableau.com/current/online/zh-cn/to_site_capacity.htm#jobruntimecapacity)。

选择要包含在流程运行中的输出，并配置设置以指示 Tableau 在上一个流程运行失败时如何处理计划中的剩余流程。

1. 若要为链接任务创建计划，请执行以下操作之一：
    - 从流程的“概览”页面的**“计划任务”**选项卡中，单击**“新建任务”**并选择“链接任务”选项卡，或者单击下拉菜单并选择“链接任务”。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_linked.png)
    - 从“浏览”页面中，在“列表”视图中的“操作”菜单中，选择“计划流程”\>“链接任务” 。如果您在列表中选择多个流程，您还可以使用顶部的“操作”菜单。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_schedule_tasks_explore.jpg)
    
    如果没有为任务分配输出步骤，您也可以通过“概述”页创建新任务。在该页面上的“计划”字段中，单击“创建新任务”。
2. 在“新建任务”对话框的“链接任务”选项卡上，单击“定义计划”。
3. 输入任务的频率，然后单击“保存”。
4. 单击“选择输出步骤”下拉列表以选择要运行的流程输出。默认情况下包括所有流程输出。若要选择特定输出，请清除“包括此流程的所有当前和未来输出步骤”复选框。
    
    启动任务的流程会自动设置为第一个运行的流程，但您可以在将其他流程添加到列表后使用菜单更改运行顺序。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_linked_refresh.png)
5. 从以下选项中选择刷新类型：
    
    **注意**：如果一个输入配置为使用增量刷新，并且它与多个输出相关联，则这些输出必须一起运行，并且必须使用相同的刷新类型。否则，流程将失败。
    
    - 完全刷新（默认）：根据流程输出设置，刷新所有数据并且创建或将数据追加到表中。
    - 增量刷新：仅刷新新行，并根据流程输出设置创建或将数据追加到表中。仅当将流程配置为使用此刷新类型时，增量刷新选项才可用。有关详细信息，请参见[使用增量刷新来刷新流程数据](https://help.tableau.com/current/prep/zh-cn/prep_incremental_refresh.htm)。
        
        **注意**：如果未找到现有输出，Tableau Prep Conductor 会对所有输出运行完全刷新，无论您选择什么运行选项。后续流程运行将使用增量刷新过程，并仅检索和处理新行，除非缺少增量刷新配置数据，或者现有输出已移除。
6. （可选）如果您是流程所有者，请选择“完成后发送电子邮件”以在流程成功时通知用户。有关如何在流程运行时发送电子邮件通知的详细信息，请参见[通知用户流程运行成功](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_subscribe_to_flow.htm)。
7. 设置流程失败选项：
    - 添加数据质量警告：选择此复选框可在流程上设置警告消息，以便数据用户了解问题。该消息会一直保留，直到流程成功运行。如果流程已存在数据质量警告，则此选项显示为已选中且无法关闭。
        
        ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_error.png)
    - 停止剩余任务：选择此选项可防止列表中的下游任务排队运行。
    - 向我发送电子邮件：当流程失败、暂停或取消时，会自动向流程所有者和链接任务创建者发送电子邮件通知。
8. 如果您的流程包含参数，请输入任何必需或可选的参数值。您必须输入所需的值才能运行流程。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_link_param.png)
9. 单击第二个任务的下拉列表以添加下一个流程。使用前一个流程输出的流程会自动显示，或者单击“查看所有流程”以查看所有可用流程
10. 选择一个或多个流程并单击“添加”或单击“添加下一个任务”以将更多流程运行任务添加到您的列表中。
    
    果您无权运行流程，则必须先联系流程所有者授予权限，然后再将流程添加到您的列表中。
11. 重复步骤 4–6 以配置您的流程运行选项。
12. （可选）单击任何编号任务旁边的下拉列表打开菜单以更改流程任务的顺序，或在现有任务之间插入新任务。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_schedule_move.png)
13. 单击**“创建任务”**以创建计划的链接任务。

### 谁可以执行此操作

- 服务器管理员可以在服务器的所有站点上执行此操作。如果启用了允许用户发布和计划任务的站点设置，则站点管理员可以在他们有权访问的站点上执行此操作。
- 对于链接任务，服务器管理员可以在启用了允许用户安排链接任务的服务器设置的所有站点上执行此操作。如果启用了允许用户计划链接任务的站点设置，则站点管理员可以在他们有权访问的站点上执行此操作。
- 具有 Creator 站点角色的流程所有者和项目主管可以分别为他们自己的流程或项目创建流程任务。

站点管理员、流程所有者和项目主管可为分别为他们拥有的流程和项目创建流程任务。只有 Creator 站点角色及以上角色才能创建或编辑流程任务。

有关详细信息，请参见[设置用户的站点角色](https://help.tableau.com/current/online/zh-cn/users_site_roles.htm)以及[内容所有权和权限](https://help.tableau.com/current/online/zh-cn/permissions.htm)

<!-- document id=5163adc072bb191aed9171ed5ffde1956a6e901648afb25189937bb234757844 url=/tableau/next/zh-cn/online/subscribe_trouble.md -->

[跳转到主要内容](#main-content)

# 订阅疑难解答

## "此电子邮件中的视图快照无法正确呈现。”

如果您接收的订阅出现此错误消息，可能是由以下几种原因导致的：

- **缺失凭据**：某些视图在发布时具有嵌入的凭据。如果嵌入式凭据现已过时或视图在重新发布时未包含嵌入式凭据，则您可能会收到以上错误消息。
- **数据库暂时瘫痪**：如果视图具有实时数据库连接，且数据库在生成订阅时暂时瘫痪，则您可能会收到以上错误消息。

## 无法在电子邮件中看到图像

为了使内容图像在订阅电子邮件中显示，订阅视图的用户除了“查看”权限外，还必须拥有“下载图像/PDF”权限。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#permissioncapabilities)。

## 看不到扩展程序或 Pulse 对象

从 Tableau Cloud 2026.1 开始，订阅现在支持许多扩展程序。但是，如果这些扩展程序不符合某些条件，则它们可能会在您的订阅电子邮件或附件中显示为空白：

- **扩展程序类型：**仅支持 Tableau 可信扩展程序（在 Tableau Exchange 中提供）和 Pulse 仪表板对象。如果仪表板使用支持网络的扩展程序，该区域将在订阅图像中显示为空白。
- **查看状态：**订阅基于视图的已发布版本或保存的自定义视图来呈现。如果您进行了未保存的更改或选择，它们将不会出现在订阅电子邮件中。
- **格式：**仅当消息包含图像时，订阅才支持这些对象。这些对象当前不以 PDF 附件形式呈现。
- **工作簿保存：**如果您最近通过 Web 制作添加了可视化项扩展程序，请确保工作簿已保存；否则订阅引擎将无法访问新内容。

## 无法订阅

如果您在 Tableau Server 上可以看到视图并且该视图的右上角有一个订阅图标 (![订阅图标。](/tableau/next/zh-cn/online/zh-cn/Img/subscribe_icon.png))，则您可以订阅该视图。

若要订阅视图，您订阅的视图必须已嵌入其数据源的凭据或者根本不需要凭据。后一种情况的示例连接到不需要刷新的数据提取的工作簿，或其数据位于发布时工作簿附带的文件中的工作簿。嵌入凭据的步骤在 Tableau Desktop 中执行（有关详细信息，请参见 [Tableau 帮助](https://help.tableau.com/current/pro/desktop/zh-cn/publishing_sharing_authentication.htm)）。

## 没有订阅图标

可以看到视图但无法订阅它。发生此错误的：

- **视图使用实时数据库连接：**包含实时数据库连接的视图（当您首次单击视图时，将在该视图中提示您输入数据库凭据）不可用于订阅。订阅包括视图（或工作簿）、数据和计划。为了交付视图所需的数据，Tableau Server 需要嵌入式数据库凭据或不需要凭据的数据。至于实时数据库连接，Tableau Server 没有相关凭据，只有单个用户拥有凭据。这就是为什么您只能订阅不需要凭据或已嵌入凭据的视图的原因所在。
- **实时数据库连接使用 OAuth 身份验证**：如果 OAuth 凭据未嵌入实时数据源或与用户密钥链一起保存，或者 OAuth 刷新令牌已过期，则用户可能无法订阅视图。

## 缺少附件

您可以将 PDF 附件添加到订阅中（如果管理员已启用该功能）。如果订阅中缺少 PDF 附件，可能是因为 PDF 的大小超过了电子邮件大小限制。在 Tableau Cloud 中，每个站点的最大电子邮件大小为 2MB。有关详细信息，请参见 [Tableau Cloud 容量](https://help.tableau.com/v0.0/online/zh-cn/to_site_capacity.htm)。  

从 Tableau 2024.1 开始，您可以使用自己的发送服务器发送电子邮件，这允许您发送最大电子邮件大小为 10MB 的附件。

若要启用此功能，请导航至站点设置，找到“自定义电子邮件通知”部分，然后选中“使用您的 SMTP 服务器”旁边的框。

注意：如果您使用自己的发送服务器，Tableau 将尝试发送包含低于 10MB 限制的附件子集的订阅电子邮件，但不能保证这一点。如果 Tableau 无法发送附件，您将看到一条消息，告知您附件太大而无法发送。

## 挂起的订阅

默认情况下，订阅会在订阅连续五次失败后挂起。

### 恢复挂起的订阅

订阅所有者可以恢复订阅：

- 通过“内容设置”中的“我的订阅”选项卡
- 通过每个工作簿的“订阅”选项卡

订阅恢复之后，通知失败计数将恢复为零。下一次订阅评估将在下次计划的评估时进行。

### 无法将订阅频率设置为“数据刷新时”

如果工作簿使用已发布数据提取连接，则可以将订阅设置为在数据提取刷新时运行。创建或修改订阅时，如果工作簿使用以下各项，则您可能不会看到“频率”选项：

- 通过 Tableau Bridge 进行的数据提取刷新
- 多个数据提取刷新
- 实时数据连接

**注意**：如果工作簿的数据源包含多个连接，其中一个连接指向已发布数据提取，而另一个连接需要 Tableau Bridge，则您可以将订阅频率设置为“数据刷新时”。如果选择，订阅将在数据提取刷新时运行，而不是在 Tableau Bridge 刷新时运行。

## 缺少数据质量警告或敏感度标签

在以下情况下，订阅电子邮件中包含数据质量警告和敏感度标签：

- Tableau Server 或 Tableau Cloud 通过 Data Management 获得许可。有关详细信息，请参见[关于 Data Management](https://help.tableau.com/v0.0/online/zh-cn/dm_overview.htm)。
- Tableau Catalog 已启用。有关详细信息，请参见[启用 Tableau Catalog](https://help.tableau.com/v0.0/online/zh-cn/dm_catalog_enable.htm)。
- 在站点设置中，“视图和工作簿订阅中的高可见性数据标签”下的复选框处于选中状态。（在早期版本中，该复选框位于“订阅中的数据质量警告”下。）

<!-- document id=cdee40aaa8be10ac519cc88193189cac106bab68edec78753ff4efc7643b0434 url=/tableau/next/zh-cn/online/dm_license.md -->

[跳转到主要内容](#main-content)

# 许可 Data Management

**重要信息：**自 2024 年 9 月 16 日起，Data Management 不再作为独立的附加选项提供。仅当您先前购买了 Data Management，或者购买了某些许可证版本：Tableau Enterprise、Tableau Cloud+ 或 Tableau+ Bundle（适用于 Tableau Cloud），或者 Tableau Enterprise 或 Tableau Server+（适用于 Tableau Server）时，Data Management 功能才可用。

Data Management 包括 Tableau Catalog、Tableau Prep Conductor、虚拟连接和数据策略，在您购买 Tableau Enterprise 或 Tableau+ 时可用。请与客户经理联系（或转到 Tableau [定价](https://www.tableau.com/zh-cn/pricing/teams-orgs)页面）了解详细信息。

## Tableau Prep Conductor

当您购买 Tableau Enterprise 或 Tableau+ 许可证时，Prep Conductor 会在您的 Tableau Cloud 站点上自动启用。有关详细信息，请参见[在 Tableau Cloud 站点上启用 Tableau Prep Conductor](https://help.tableau.com/v0.0/online/zh-cn/prep_conductor_configure_online.htm)。

- 至少需要一个资源块才能在 Tableau Cloud 中使用 Tableau Prep Conductor。若要详细了解资源块，请参见[资源块](https://help.tableau.com/v0.0/online/zh-cn/to_resource_blocks.htm)。
- 当 Data Management 处于活动状态并已启用时，您可以在 Tableau Server 或 Tableau Cloud 中计划流程，以及监视流程。
- 如果 Data Management 已移除或停用，或者 Data Management 已过期，则用于计划流程的功能将被禁用。
- 如果 Tableau Server 或 Tableau Cloud 许可证仍然处于活动状态且有效，则可以使用 Tableau Server REST API 下载流程。有关详细信息，请参见[流程方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_flow.htm)。

## Tableau Catalog

购买 Tableau Enterprise 或 Tableau + 许可证时，将自动启用 Catalog。

- 当 Data Management 处于活动状态并已启用时，您可以使用 Tableau Catalog 来发现数据、呈现数据资产、执行影响分析，以及跟踪 Tableau 内容中使用的数据的世系。
- 如果 Data Management 已移除、停用或过期，信息将保留在服务器上。特定于 Tableau Catalog 的信息随后可使用 Tableau 元数据 API 访问；它不再出现在产品中。有关详细信息，请参见[元数据 API](https://help.tableau.com/current/api/metadata_api/zh-cn/index.html)。
- 如果 Data Management 已移除、停用或许可证过期，则所有新的 Tableau Catalog 信息（例如，表说明、数据质量警告、列说明）的写入 API 将被禁用。您仍可以使用元数据 API 读取信息，但无法在产品中对表和数据库的权限进行显式管理。

## 虚拟连接和数据策略

当您购买 Tableau Enterprise 或 Tableau+ 许可证时，会自动在您的 Tableau Cloud 站点上自动虚拟连接和数据策略。

在您购买并获得 Data Management for Tableau 的许可后，会自动启用虚拟连接和数据策略。

- 当 Data Management 处于活动状态并启用后，您可以使用虚拟连接创建可共享资源，提供数据的中央访问点。您还可以创建数据策略，使您能够使用集中的行级安全性为用户筛选数据。
- 如果 Data Management 已移除、停用或许可证过期，信息将保留在服务器上，但无法访问。
- 重新激活 Data Management 后，信息将在服务器上恢复并变得可访问。

## 此部分中的其他文章

<!-- document id=176ec35430e62e571710d56ba7c6bf68fc6b0eb2b6be24f702784f89963f4719 url=/tableau/next/zh-cn/online/config_oauth_redshift_iam_idc.md -->

[跳转到主要内容](#main-content)

# 设置 Amazon Redshift IAM Identity Center OAuth

这些说明适用于较新的 AWS IAM IDC 服务。有关原始 IAM 集成，请参见[设置 Amazon Redshift IAM OAuth](https://help.tableau.com/v0.0/online/zh-cn/config_oauth_redshift_iam.htm)。

根据身份提供程序的不同，配置集成需要执行不同的步骤。这是一个简略概述。Tableau 无法提供有关如何配置 AWS 或 IDP 的详细说明，但这是一般方法。

有关使用 Redshift 实现身份验证的一些详细示例，请参见“[使用 AWS IAM Identity Center 将 Tableau 和 Okta 与 Amazon Redshift 集成](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-okta-with-amazon-redshift-using-aws-iam-identity-center/)”和“[使用 AWS IAM Identity Center 将 Tableau 和 Microsoft Entra ID 与 Amazon Redshift 集成](https://aws.amazon.com/blogs/big-data/integrate-tableau-and-microsoft-entra-id-with-amazon-redshift-using-aws-iam-identity-center/)”。

**注意**：使用 Tableau Bridge 与 Tableau Cloud 的 OAuth 连接不支持一次性刷新令牌（有时称为滚动刷新令牌或刷新令牌轮换）。我们计划在未来的版本中支持这些令牌。

## 步骤 1：配置 IDP

1. 在 IDP 上为 Tableau Desktop 和 Tableau Server 或 Tableau Cloud 创建 OAuth 客户端。Desktop 客户端应启用 `PKCE` 并使用 `http://localhost` 重定向。
2. 添加用于角色授权的任何必需的自定义声明。
3. 创建 Tableau OAuth 配置文件。请参见 [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub 上用于创建 Tableau OAuth 配置文件的文档。") 上的文档和[示例](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub 上用于创建 Tableau OAuth 配置文件的示例。")。我们欢迎提供其他 IDP 的示例。
    
    1. 请务必在 Tableau OAuth 配置 ID 前添加“`custom_`”前缀。
        
        **注意：**Oauth 配置 ID 的最大限制为 36 个字符。长于此长度的 ID 可能不会生成错误，但将不起作用。
    2. 如果您的 IDP 支持动态本地主机端口，则禁用 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`。如果没有，请确保将多个本地主机回调 URL 添加到配置文件和 IDP 上的允许列表中。
4. 在与桌面主机（Tableau Desktop、Tableau Prep Builder、Tableau Bridge）上的每个应用程序以及将使用 OAuth 的每个 Tableau Server 和 Tableau Cloud 站点上每个应用程序关联的 `OAuthConfigs` 文件夹中，安装新的Tableau OAuth 配置文件。

## 步骤 2：配置 IDP 和 AWS 上的角色

有关执行此操作的信息，请参见 AWS 文档。

## 步骤 3：连接到 Redshift

1. 连接到 Redshift。
2. 为“身份验证”选择 OAuth。
3. 为“联合类型”选择 Identity Center。
4. （可选）如有必要，请指定“Identity Center 命名空间”。

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_idc_connect.png "“Redshift 连接”对话框")

正确配置后，您将被重定向到 IDP 以对 Tableau 的令牌进行身份验证和授权。Tableau 将收到访问令牌和刷新令牌。它将访问令牌发送给驱动程序进行身份验证。

## 令牌

默认情况下，edshift OAuth to IAM IDC 将访问令牌传递给驱动程序。对于本地客户（包括使用 Tableau Bridge 的客户），您可以改用 TDC 文件来传递 ID 令牌。

<connection-customization class='redshift' enabled='true' version='10.0'>
	<vendor name='redshift' />
	<driver name='redshift' />
	<customizations>
		<customization name='CAP\_OAUTH\_FEDERATE\_ID\_TOKEN' value='yes'/>
	</customizations>
</connection-customization>

有关配置和安装 .tdc 文件的详细信息，请参见[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)和[将 .tdc 文件与 Tableau Server 配合使用](https://help.salesforce.com/s/articleView?id=001458291&type=1)。

## Okta

如果使用 Okta，最好使用“自定义授权服务器”而不是“组织授权服务器”。自定义授权服务器更加灵活。默认情况下会创建自定义授权服务器，称为“默认”。授权 URL 应如下所示：

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_idc_okta_800x332.png)

## 更新驱动程序

对于使用 IAM IDC 服务的 Redshift OAuth，您需要至少使用 2.x 版本的 ODBC 驱动程序。下载在 [https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "适用于 Redshift ODBC 版本 2 的驱动程序下载") 上找到的最新版本的 Redshift ODBC 驱动程序。请注意，目前没有适用于 OSX 的 v2 驱动程序。

## Redshift IAM IDC OAuth 故障排除

诊断错误的最佳方法是从图片中移除 Tableau。您可以使用驱动程序管理器或类似的工具进行测试。这只是为了故障排除 - 您不应该使用 DSN 或“其他 ODBC”连接器来常规使用此功能。为了确保测试有效，除群集信息、数据库、令牌和命名空间外，参数应与下面所示相同。

如果您在第一次连接时看到来自驱动程序的无效/过期令牌的错误消息（错误消息中将包含类似 \[28000\] 或 \[08001\] 的 SQLState 错误代码），则 Tableau 已成功完成 OAuth 流程，并且驱动程序失败。这意味着 AWS 端或 IDP 端存在配置错误。驱动程序还可能返回权限或授权错误，这也不受 Tableau 的控制。

在开始测试之前，您首先需要获取访问令牌（IAM IDC 的默认设置）或刷新令牌（如果自定义）以发送给驱动程序。

这是 Okta 的示例。几乎所有 IDP 都有一种非常相似的方法来做到这一点。请注意，若要使用此流程，您需要启用资源所有者密码授予类型。替换 IDP URL、客户端密文、客户端 ID、用户名和密码。

curl -X POST "https://OKTA\_URL/v1/token" \\  
\-H 'accept: application/json' \\  
\-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\  
\-H "Content-Type: application/x-www-form-urlencoded" \\  
\-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid"

获得令牌后，您可以使用 DSN 进行测试。对于 Windows，您可以使用 ODBC 驱动程序管理器。在 Linux 上，您可以使用 Tableau Server 附带的 customer-bin 文件夹中的 isql 命令行工具。

Tableau 建议您不要使用其他插件进行测试，因为它们可能无法在服务器环境中工作。他们要么使用固定的 AWS 配置文件，要么需要直接访问浏览器。

下面是在 Windows 上使用 ODBC 驱动程序管理器的示例。

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_idc_troubleshoot.png)

<!-- document id=e878830f2bd462bbc19dbd5f66b957f1bef5e86db1c76e0b5c493244a360ed53 url=/tableau/next/zh-cn/online/config_oauth_redshift_iam.md -->

[跳转到主要内容](#main-content)

# 设置 Amazon Redshift IAM OAuth

这些说明适用于旧版 AWS IAM 服务。对于 IAM IDC 集成，请参见[设置 Amazon Redshift IAM Identity Center OAuth](https://help.tableau.com/v0.0/online/zh-cn/config_oauth_redshift_iam_idc.htm)。

根据身份提供程序的不同，配置集成需要执行不同的步骤。这是一个简略概述。Tableau 无法提供有关如何配置 AWS 或 IDP 的详细说明，但一般方法如下所述。

**注意**：使用 Tableau Bridge 与 Tableau Cloud 的 OAuth 连接不支持一次性刷新令牌（有时称为滚动刷新令牌或刷新令牌轮换）。我们计划在未来的版本中支持这些令牌。

## 步骤 1：配置 IDP

1. 在 IDP 上为 Tableau Desktop 和 Tableau Server 或 Tableau Cloud 创建 OAuth 客户端。Desktop 客户端应启用 `PKCE` 并使用 `http://localhost` 重定向。
2. 添加自定义声明以用于对角色进行授权。特别是，如果您使用原始 IAM，您可能需要为 `DbUser` 和 `DbGroups` 添加声明。这些声明可以稍后在您的 IAM 策略中使用。
3. 创建 Tableau OAuth 配置文件。请参见 [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub 上的 OAuth 文档") 上的文档和[此处的](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub 上的 OAuth 示例。")示例。我们欢迎提供其他 IDP 的示例。
    
    1. 请务必在 Tableau OAuth 配置 ID 前添加“`custom_`”前缀。
        
        **注意：**Oauth 配置 ID 的最大限制为 36 个字符。长于此长度的 ID 可能不会生成错误，但将不起作用。
    2. 如果您的 IDP 支持动态本地主机端口，则禁用 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`。如果您的 IDP 不支持此功能，请确保将多个本地主机回调 URL 添加到配置文件和 IDP 上的允许列表中。
4. 在与桌面主机（Tableau Desktop、Tableau Prep Builder、Tableau Bridge）上的每个应用程序以及将使用 OAuth 的每个 Tableau Server 和 Tableau Cloud 站点上每个应用程序关联的 `OAuthConfigs` 文件夹中，安装新的Tableau OAuth 配置文件。

## 在 AWS 上配置 IDP

1.在 AWS 上创建 IDP 模型。请参见 Amazon 文档 [Web 身份联合](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_oidc.html "有关 Web Identity Federation 的 AWS 文档")和[创建 OIDC 身份提供提供程序](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html "有关创建 OIDC 身份提供程序的 AWS 文档")。

2.专门为 IDP 创建角色和策略。请参见 AWS 文档上中[为 OIDC 创建角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html "用于为 OIDC 创建角色的 AWS 文档")。

## 为 Redshift 用户配置角色

附上 Redshift 所需的策略。您可以使用令牌中的自定义声明来授权角色。[AWS 文档](https://docs.aws.amazon.com/redshift/latest/mgmt/options-for-providing-iam-credentials.html "用于提供 IAM 凭证的 AWS 文档")中有几个使用 SAML 的示例。这些可以轻松适应 OAuth。就 OAuth 而言，声明只是“`DbUser`”、“`DbGroups`”等。

以下是 AWS 文档中的策略示例：

{  
"Version": "2012-10-17",  
"Statement": \[  
    {  
        "Effect": "Allow",  
        "Action": "redshift:GetClusterCredentials",  
        "Resource": \[  
            "arn:aws:redshift:us-west-1:123456789012:dbname:cluster-identifier/dev",  
            "arn:aws:redshift:us-west-1:123456789012:dbuser:cluster-identifier/${redshift:DbUser}",  
            "arn:aws:redshift:us-west-1:123456789012:cluster:cluster-identifier"  
        \],  
        "Condition": {  
            "StringEquals": {  
                "aws:userid": "AROAJ2UCCR6DPCEXAMPLE:${redshift:DbUser}@example.com"  
            }  
        }  
    },  
    {  
        "Effect": "Allow"  
        "Action": "redshift:CreateClusterUser",  
        "Resource": "arn:aws:redshift:us-west-1:12345:dbuser:cluster-identifier/${redshift:DbUser}"  
    },  
    {  
        "Effect": "Allow",  
        "Action": "redshift:JoinGroup",  
        "Resource": "arn:aws:redshift:us-west-1:12345:dbgroup:cluster-identifier/my\_dbgroup"  
    },  
    {  
        "Effect": "Allow",  
        "Action": \[  
            "redshift:DescribeClusters",  
            "iam:ListRoles"  
        \],  
        "Resource": "\*"  
    }  
\]  
}

## 连接到 Redshift

用户必须指定要代入的角色 ARN，然后选择之前安装的 OAuth 配置。

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth__iam_connect.png)

正确配置后，用户将被重定向到 IDP 以对 Tableau 的令牌进行身份验证和授权。Tableau 将接收 openid 和刷新令牌。AWS 能够验证来自 IDP 的令牌和签名、从令牌中提取声明、查找声明到 IAM 角色的映射，以及允许或阻止 Tableau 代表用户承担角色。（换句话说，即 [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html "AssumeRoleWithWebIdentity 的 AWS 文档") ）。

## 令牌

默认情况下，Redshift OAuth IAM 将 ID 令牌传递给驱动程序。对于本地客户（包括使用 Tableau Bridge 的客户），您可以使用 TDC 文件来传递访问令牌。

<connection-customization class='redshift' enabled='true' version='10.0'>
	<vendor name='redshift' />
	<driver name='redshift' />
	<customizations>
		<customization name='CAP\_OAUTH\_FEDERATE\_ACCESS\_TOKEN' value='yes'/>
	</customizations>
</connection-customization>
		

有关配置和安装 .tdc 文件的详细信息，请参见[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)和[将 .tdc 文件与 Tableau Server 配合使用](https://help.salesforce.com/s/articleView?id=001458291&type=1)。

## 关于组联合

当使用具有 IAM 角色的 OAuth 身份验证时，您可以选择是否使用组联合。这将改变连接器与身份验证 API 交互的方式以便与 Redshift 交互。

- 如果在连接时选中了“组联合”复选框（在版本 2025.1 及更高版本中可用），Redshift 驱动程序将使用 [`getClusterCredentialsWithIAM`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentialsWithIAM.html) API 以获取已预置群集中的凭据。
- 未选中“组联合”框时，将改用 [`getClusterCredentials`](https://docs.aws.amazon.com/redshift/latest/APIReference/API_GetClusterCredentials.html) API。

这两个 API 将返回具有略微不同属性的 IAM 令牌。有关详细信息，请查阅上面链接的 AWS API 文档以及 [ODBC 驱动程序选项](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-configuration-options.html "有关使用 AWS 配置 ODBC 2.0 的信息")。

#### 使用说明

- 对于版本 2024.3 之前的 Tableau Desktop 和 Tableau Prep Builder，可以使用“group\_federation=1”在高级驱动程序配置字段中进行设置。还可以通过使用 TDC 文件来定义自定义连接属性来进行配置。有关使用 TDC 的详细信息，请参见[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)。
- 从版本 2024.3 开始，本地（Tableau Desktop、Tableau Prep Builder 和 Tableau Server）的连接对话框中有一个“group\_federation”字段。此功能将于 2025.1（2025 年 2 月上市）开始在 Tableau Cloud 中提供。
- 若要将组联合与 Tableau Server 结合使用，必须将 group\_federation 添加到 ODBC 额外允许列表中。有关详细信息，请参见[自定义本机连接器的连接字符串](https://help.tableau.com/current/pro/desktop/zh-cn/connect_string_custom.htm)。

## Okta

如果使用 Okta，最好使用“自定义授权服务器”而不是“组织授权服务器”。自定义授权服务器更加灵活。默认创建一个自定义授权服务器，称为“默认”。授权 URL 应如下所示：

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_iam_okta_800x332.png)

## 更新驱动程序

对于使用原始 IAM 服务的 Redshift OAuth，您可以使用：

- 从版本 1.59 开始的 Redshift ODBC v1 驱动程序可以从 [https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html](https://docs.aws.amazon.com/redshift/latest/mgmt/configure-odbc-connection.html "从 Amazon 下载 Redshift ODBC V1 驱动程序") 下载。
- 从版本 2.0.1.0 开始的 Redshift ODBC v2 驱动程序可以从 [https://github.com/aws/amazon-redshift-odbc-driver/tags](https://github.com/aws/amazon-redshift-odbc-driver/tags "从 Amazon 下载 Redshift ODBC V2 驱动程序") 下载。请注意，没有适用于 OSX 的 v2 驱动程序。

## 疑难解答

诊断错误的最佳方法是从图片中移除 Tableau。您可以使用驱动程序管理器或类似的工具进行测试。这只是为了故障排除 - 您不应该使用 DSN 或“其他 ODBC”连接器来常规使用此功能。为了确保测试有效，除群集信息、数据库、令牌和命名空间外，参数应与下面所示相同。

**注意：**测试时不要在 DSN 的连接字符串中指定 DbUser 或 DbGroups，因为 Tableau 无权访问它们，并且无法将它们包括在连接字符串中。您可以将其包含在令牌声明中。

如果您在第一次连接时看到来自驱动程序的无效/过期令牌的错误消息（错误消息中将包含类似 \[28000\] 或 \[08001\] 的 SQLState 错误代码），则 Tableau 已成功完成 OAuth 流程，并且驱动程序失败。这意味着 AWS 端或 IDP 端存在配置错误。驱动程序还可能返回权限或授权错误，这也不受 Tableau 的控制。

在开始测试之前，您首先需要获取访问令牌（IAM IDC 的默认设置）或刷新令牌（如果自定义）以发送给驱动程序。

这是 Okta 的示例。几乎所有 IDP 都有一种非常相似的方法来做到这一点。请注意，若要使用此流程，您需要启用资源所有者密码授予类型。替换 IDP URL、客户端密文、客户端 ID、用户名和密码。

curl -X POST "https://OKTA\_URL/v1/token" \\  
\-H 'accept: application/json' \\  
\-H "Authorization: Basic $(echo -n 'CLIENTID:CLIENTSECRET' | base64)" \\  
\-H "Content-Type: application/x-www-form-urlencoded" \\  
\-d "grant\_type=password&username=USER&password=PASSWORD&scope=openid"

获得令牌后，您可以使用 DSN 进行测试。对于 Windows，您可以使用 ODBC 驱动程序管理器。在 Mac 上，您可以使用 iODBC 驱动程序管理器 UI。在 Linux 上，您可以使用 Tableau Server 附带的 customer-bin 文件夹中的 isql 命令行工具。

使用固定 AWS 配置文件的插件将无法工作，除非您希望为该连接的所有用户使用相同的配置文件。其他 OAuth 插件需要直接访问系统浏览器，这在服务器端不起作用。

下面是在 Windows 上使用 ODBC 驱动程序管理器的示例。

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_iam_troubleshoot.jpg)

<!-- document id=059de7bb5fa993a2e8e59f4cc065414b54f91c3f8c95a98a1424f15211e8ef9a url=/tableau/next/zh-cn/online/pulse_salesforce.md -->

[跳转到主要内容](#main-content)

# 设置 Pulse for Salesforce 应用程序

> [!IMPORTANT]
> 
> **重要信息：**自 2025 年 8 月 1 日起，Pulse for Salesforce 不再可用于净新销售。仅当您之前购买了该应用程序时，Pulse for Salesforce 功能才可用。[Tableau Next](https://www.tableau.com/zh-cn/products/tableau-next) 使您的组织能够访问与 Salesforce 平台完全集成的代理分析，包括 Pulse for Salesforce 的许多核心功能，例如指标摘要。

Pulse for Salesforce 应用程序将 Tableau Pulse 与您的 Salesforce 数据集成。通过该应用程序，您的用户可以探索有关其数据的指标并直接在 Salesforce 中获得见解。有关 Tableau Pulse 的详细信息，请参见[关于 Tableau Pulse](https://help.tableau.com/v0.0/online/zh-cn/pulse_about.htm)。

该应用程序可自动执行 Tableau 与 Salesforce 的连接过程。若要设置应用程序，您必须在 Salesforce 组织和 Tableau 站点上完成步骤。在 Salesforce 和 Tableau 之间建立连接后，应用程序会准备您的数据，然后创建销售、机会等指标。分配了正确权限集的用户可以访问 Salesforce 中嵌入的这些指标。

## 满足 Tableau Cloud 先决条件

### 设置 Tableau Cloud 站点

1. 按照 Tableau Cloud 激活电子邮件中的说明创建站点。
2. 复制您的站点名称和 URL，并将其粘贴到安全的位置。您需要这些信息来设置 Pulse for Salesforce 应用程序。

### 将身份验证类型设置为 Salesforce

1. 从 Tableau 站点的导航面板中，选择“设置”。
2. 选择“身份验证”选项卡。
3. 在“身份验证类型”下， 选择“启用其他身份验证方法”。
4. 对于“身份验证”，选择“Salesforce”。
5. 在“嵌入视图的默认身份验证类型”下，选择“Salesforce”。

您可以使用 Salesforce 身份验证应用程序进行多重身份验证。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。

### 启用 Tableau Pulse 和 Tableau 中的 AI

确保您的 Tableau 站点已启用 Tableau Pulse 和 Tableau 中的 AI 的站点设置。

1. 启用 Tableau Pulse。请参见[为您的站点部署 Tableau Pulse](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#site-setting)。
2. 启用 Tableau 中的 AI。请参见[适用于 Tableau Pulse 的 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm#tableau-ai)。

### 创建个人访问令牌

1. 若要为 Tableau 站点启用个人访问令牌设置，请转到站点设置并按照[个人访问令牌的站点设置](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm#Site)中的说明进行操作。
2. 若要创建令牌，请转到您的帐户设置并按照[创建个人访问令牌](https://help.tableau.com/current/pro/desktop/zh-cn/useracct.htm#Create)上的说明进行操作。
3. 复制令牌名称和密文 ，并将其粘贴到安全的位置。您需要这些信息来设置 Pulse for Salesforce 应用程序。

### 创建已连接应用

已连接应用允许在 Salesforce 中无缝嵌入 Tableau Pulse 指标。有关已连接应用的详细信息，请参见[使用直接信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)。

1. 从导航窗格中，选择“设置”。
2. 选择“已连接应用”选项卡。
3. 选择“新建已连接应用”\>“ 直接信任”。
4. 对于“已连接应用名称”，输入一个描述性名称。
5. 对于“访问级别”，选择“所有项目”。
6. 对于“域允许列表”，选择“所有域”。
7. 选择“创建”。
8. 选择“生成新密文”。
9. 复制“密文 ID”、“密文值” （选择眼睛图标以显示值）和“客户端 ID”，然后将其粘贴到安全的位置。您需要这些信息来设置 Pulse for Salesforce 应用程序。

## 在 Salesforce 中安装应用包

Pulse for Salesforce 应用程序是您在 Salesforce 组织中安装的托管程序包。

1. 以 Salesforce 管理员身份登录到您的 Salesforce 组织后，打开 Pulse for Salesforce 程序包。当您购买 Pulse for Salesforce 应用程序时，此程序包的链接已发送给您。
2. 选择“Install for Admins Only”（仅为管理员安装）。
3. 选择“Install”（安装）。
4. 在“Approve Third-Party Access”（批准第三方访问）对话框中，选择“Yes, grant access to these third party web sites”（是，授予这些第三方网站的访问权限）。
5. 选择“Continue”（继续）。Pulse 安装向导已安装在您的组织中。

> [!IMPORTANT]
> 
> **重要信息：**如果您的 Salesforce 管理员帐户的语言设置未设为英语，则您必须暂时将个人语言设置更改为英语才能安装该应用程序。若要了解具体操作方法，请参见[在 Salesforce 中更改语言](https://help.salesforce.com/s/articleView?id=000385317&type=1)。安装应用程序后，将语言设置改回您的首选语言。

## 满足 Salesforce 先决条件

### 将用户分配给权限集

**提示：**设置应用程序时，请考虑将权限集限制为少数用户。完成应用程序自定义后，授予其余用户访问权限，然后重新同步该应用程序。有关详细信息，请参见[同步对 Tableau Pulse 应用的访问权限](#sync-access)。

如果您需要实施行级安全性来保护您的数据，请在设置期间仅将管理员添加到权限集中。Salesforce 访问控制不会延续到 Tableau Cloud，因此您添加的用户可以访问指标中的所有数据，直到您实施额外的安全措施。

Pulse 应用程序在 Salesforce 中创建一个名为“Pulse for Sales Cloud”的权限集。将权限集分配给应该有权访问该应用程序的用户。若要了解具体操作方法，请参见[管理权限集分配](https://help.salesforce.com/s/articleView?id=sf.perm_sets_manage_assignments.htm&type=5)。

当您同步应用程序时，添加到此权限集的用户有权访问 Tableau Pulse 应用程序。至少将您自己添加到权限集中。

### 将 Tableau 添加为远程站点 URL

1. 访问您的 Tableau 站点以确定正确的 URL。您的 URL 应该类似于 `https://us-west-2a.online.tableau.com/#/site/my-site/home`。您将添加以 https 开头、以 .com 结尾的 URL 部分，例如：`https://us-west-2a.online.tableau.com`
2. 导航到您的“Salesforce Setup”（Salesforce 设置）页面。
3. 在“Quick Find”（快速查找）框中，输入 `Remote Site Settings`，然后选择“Remote Site Settings”（远程站点设置）。有关详细信息，请参见[配置远程站点设置](https://help.salesforce.com/s/articleView?id=sf.configuring_remoteproxy.htm&type=5)。
4. 对于“Remote Site Name”（远程站点名称），输入一个描述性名称。
5. 对于“Remote Site URL”）远程站点 URL，输入您在步骤 1 中确定的 URL。
6. 对于“Disable Protocol Security”（禁用协议安全性），不要选中复选框。
7. 对于“Active”（活动），请保持复选框处于选中状态。
8. 选择“Save”（保存）。

### 将 Tableau 添加为重定向的受信任 URL

1. 导航到您的“Salesforce Setup”（Salesforce 设置）页面。
2. 在“Quick Find”（快速查找）框中，输入 `Trusted URLs for Redirects`，然后选择“Trusted URLs for Redirects”（重定向的受信任 URL）。有关详细信息，请参见[管理到外部 URL 的重定向](https://help.salesforce.com/s/articleView?id=sf.security_external_redirects.htm&type=5)。
3. 选择“New”（新建）。
4. 输入您添加为远程站点的相同 URL。
5. 选择“Save”（保存）。

## 设置 Pulse for Salesforce 应用程序

在设置应用程序之前，您必须在 Salesforce 组织中安装该应用程序的托管程序包。如果您尚未安装该程序包，请参见[在 Salesforce 中安装应用包](#install)。

**注意：**Pulse 安装向导提供 Tableau 支持的语言版本。有关当前语言列表，请参见 [Tableau Cloud 的技术规格](https://www.tableau.com/zh-cn/products/techspecs)。对于 Salesforce 支持但 Tableau 不支持的语言，向导将恢复使用英语。

1. 在 Salesforce App Launcher 中，搜索“Pulse Installation Wizard”（Pulse 安装向导）并打开它。
2. 选择“Get Started”（开始）。
3. 输入您的 Tableau 站点信息。如果您没有此信息，请参见[满足 Tableau Cloud 先决条件](#tableau-prereq)。
    1. 对于“Tableau Site Name”（Tableau 站点名称），输入 Tableau Cloud URL 中 /site/ 后显示的名称。对于站点 URL `https://us-west-2a.online.tableau.com/#/site/my-site/home`，您将输入 `my-site`。
    2. 对于“Tableau Site URL”（Tableau 站点 URL），输入 URL 中以 https 开头并以 .com 结尾的部分，例如：`https://us-west-2a.online.tableau.com`
    3. 对于“Personal Access Token (PAT) Name”（个人访问令牌 (PAT) 名称），输入您在创建 PAT 时保存的令牌的名称。请参见[创建个人访问令牌](#PAT)。
    4. 对于“Personal Access Token (PAT) Secret”（个人访问令牌 (PAT) 密文），输入您在创建 PAT 时保存的密文。
    5. 对于“Data Source Refresh Time”（数据源刷新时间），选择每天在 Tableau Cloud 上刷新数据的时间。此时间设置使用您的 Tableau 站点上设置的时区。
    6. 对于“Select Cloud”（选择云），选择 Pulse 应用程序为指标数据连接的云。
4. 选择“Test Connection”（测试连接）。Pulse 应用程序将验证您添加的站点信息。
5. 对于“Sync Users”（同步用户），确认有关同步用户的消息，然后选择“Sync Users”（同步用户）。“Pulse for Sales Cloud”权限集中的用户已添加到您的 Tableau 站点。
6. 对于“Create Pulse Metrics”（创建 Pulse 指标），选择“Publish”（发布）。Pulse for Salesforce 应用程序将根据您的数据创建数据源、流程和指标。
7. 对于“Embed Your Pulse Metrics”（嵌入您的 Pulse 指标），输入您在 Tableau 中创建已连接应用时记下的客户端 ID、密文 ID和密文值。请参见[创建已连接应用](#connected-app)。
8. 对于“Update Tableau Cloud Credentials”（更新 Tableau Cloud 凭据），请按照[在 Tableau 中嵌入数据凭据](#embed-credentials)下的说明进行操作。然后选择“Next”（下一步）。
9. 选择“Finish”（完成）。

## 在 Tableau 中启用已连接应用

除了您在[创建已连接应用](#connected-app)步骤下创建的已连接应用之外，Pulse for Salesforce 应用程序还会创建一个已连接应用。启用这些应用程序，以便 Tableau Pulse 可以嵌入 Salesforce。

1. 从 Tableau Cloud 导航面板中，选择“设置”。
2. 选择“已连接应用”选项卡。
3. 对于您创建的应用程序，从操作（...）菜单中，选择“启用”。
    
    ![为已连接应用启用操作](/tableau/next/zh-cn/online/zh-cn/Img/pulse_connected_app.png)
4. 还要启用名为“TableauPulseForSalesCloud”的已连接应用。这是 Pulse for Salesforce 应用程序创建的应用程序。

## 在 Tableau 中嵌入数据凭据

该应用程序会自动创建 Tableau 数据源和流程，以便为 Tableau Pulse 准备好数据。嵌入您的凭据，以便 Tableau 可以连接到您的数据。

### 嵌入流程的凭证

1. 从 Tableau Cloud 导航面板中，选择“浏览”。
2. 在内容类型菜单中，选择“所有流程”。
    
    ![“内容类型”菜单](/tableau/next/zh-cn/online/zh-cn/Img/pulse_explore_flows.png)
3. 从名为“Open Pipe”（打开管道）的流程的操作 (...) 菜单中，选择“编辑流程”。
    
    ![编辑流程操作](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_flow.png)
4. 在“连接”下，选择“Salesforce 连接”。
5. 输入连接的凭据，然后接受提示以允许访问。
6. 等待 Tableau 连接到您的组织，并解决流程中的任何错误。这应该需要不到一分钟的时间。

### 编辑并运行流程

编辑流程的最后一步，以便输出到达 Pulse for Salesforce 应用程序的正确位置。有关使用流程的详细信息，请参见[构建和组织流程](https://help.tableau.com/current/prep/zh-cn/prep_build_flow.htm)。

1. 右键单击流程的“输出”步骤，然后选择“移除”。
    
    ![移除流程步骤](/tableau/next/zh-cn/online/zh-cn/Img/pulse_remove_flow_step.png)
2. 选择最后一步后的“+”，然后选择“输出”。
    
    ![添加流程步骤](/tableau/next/zh-cn/online/zh-cn/Img/pluse_add_flow_step.png)
3. 对于“输出”步骤：
    1. 对于“项目”，选择“Pulse for SalesCloud”。
    2. 对于“名称”，输入 Open Pipe Datasource。输出的名称必须完全一致，否则指标将无法获取所需的数据。
    3. 在“完全刷新”下，选择“附加到表” 。
4. 在屏幕的右上角，单击“发布”。
5. 当要求为每个连接嵌入凭据时，请选中“嵌入凭据”框。
6. 在通知消息中，选择“查看流程”。
7. 在流程页面上，选择“全部运行”。
    
    ![“运行流程”按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_run_flow.png)

### 嵌入数据源凭据

1. 从 Tableau Cloud 导航面板中，选择“浏览”。
2. 在内容类型菜单中，选择“所有数据源”。
3. 从名为“Sales Cloud Metrics Datasource”的数据源的“操作”(...) 菜单中，选择“编辑连接”。
4. 选择“在连接中嵌入 Salesforce 凭据”，然后选择您的 Salesforce 帐户。
5. 选择“保存”。

### 刷新数据源数据提取

1. 从名为“Sales Cloud Metrics Datasource”的数据源的“操作”(...) 菜单中，选择“立即刷新数据提取”。
2. 选择“完全刷新”。

## 在 Salesforce 中检查应用程序

Pulse for Salesforce 应用程序会根据您的 Salesforce 数据自动创建一组指标。

| 指标 | 描述 |
| --- | --- |
| Average Days to Close - Won（平均关闭天数 - 赢得） | Average time it takes to win an opportunity（赢得机会所需的平均时间） |
| Closed Opportunities (Running Total)（已关闭的机会（运行总计）） | Number of opportunities that are closed（已关闭的机会数量） |
| Conversion Rate（转化率） | Share of the amount of opportunities won in relation to the amount of all closed opportunities (expressed as a percentage)（赢得的机会数量占所有已关闭机会数量的份额（以百分比表示）） |
| Created Opportunities (Running Total)（创造的机会（运行总计）） | Total number of opportunities（机会总数） |
| Open Pipe (Daily)（打开管道（每日）） | Sum of opportunity amount for open opportunities for today（今日开放机会的机会金额总和） |
| Open Pipe (Weekly)（打开管道（每周）） | Sum of opportunity amount for open opportunities for this week（本周开放机会的机会金额总和） |
| Pipe Gen (Running Total)（管道生成（运行总计）） | Sum of opportunity amount for open opportunities (IsClosed = false) by time dimension of Created Date（按创建日期的时间维度计算的开放机会 (IsClosed = false) 的机会金额总和） |
| Total Sales（总销售额） | Sum of opportunity amount for won opportunities by time dimension of Close Date（按结束日期的时间维度计算的赢得机会的机会金额总和） |
| Win Rate（赢得比率） | Share of the number of won opportunities in relation to the number of all closed opportunities (expressed as a percentage)（赢得的机会数量占所有关闭的机会数量的份额（以百分比表示）） |

1. 为了确保应用程序按预期运行，请在 Salesforce App Launcher 中搜索“Pulse”。分配有 Pulse for Salesforce 权限集的用户可以在 Salesforce 中查看此应用程序。
2. 打开 Pulse 应用程序。
3. 选择一个指标即可打开其见解探索页面。
4. 确保您的数据按预期显示。如果这是所显示时间段的第一天，则图表可能为空。
5. 如果您最初限制了可以访问 Pulse 应用程序的用户，则在检查指标后，将其他用户添加到权限集，然后重新同步该应用程序。有关详细信息，请参见[控制访问](#control-access)。

## 自定义指标

您可以通过编辑所基于的指标定义来自定义 Pulse for Salesforce 应用程序创建的指标，并且可以通过调整筛选器来创建其他指标。必须在您的 Tableau Cloud 站点上进行编辑。您无法通过 Pulse for Salesforce 应用程序编辑指标定义。

**提示：**如果您想使用不同的数据从头创建指标，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。

### 在 Tableau Pulse 中访问指标

1. 从 Tableau Cloud 导航面板中，选择“Tableau Pulse”。
2. 选择“浏览指标”以查看所有指标定义。
3. 选择一个定义以查看基于该定义的指标。

指标定义包含指标的核心元数据。对指标定义所做的编辑将影响基于该定义的所有指标。有关指标定义和指标之间关系的详细信息，请参见[指标定义和指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Metric)。

### 更改度量、时间维度或定义筛选器

度量和时间维度是指标定义值的关键组成部分，而定义筛选器是该值的可选限制。编辑指标定义来更改这些字段。有关指标定义的关键组成部分的详细信息，请参见[定义指标值](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Define)。

请注意，如果您想调整指标的时间范围而不更改用作时间维度的字段，则只需筛选现有指标即可。有关详细信息，请参见[创建其他指标](#additional-metrics)。

1. 在 Tableau Pulse 中，打开要更改的指标。
2. 选择操作 (...) 菜单，然后选择“编辑定义”。
    
    ![编辑定义按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_definition.png)
3. 对于“度量” 、 “时间维度”或“定义筛选器”，从数据源中选择不同的字段。如果您没有看到想要添加的字段，请参见[包括来自您的 Salesforce 数据的更多字段](#more-fields)。
    
    ![时间维度选择器](/tableau/next/zh-cn/online/zh-cn/Img/pulse_time_dimension.png)
4. 选择“保存定义”。

**提示：**如果您需要合并来自多个字段的数据，请参见[创建高级定义](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#advanced)。高级编辑器允许您创建计算字段。有关计算字段的详细信息，请参见 [Tableau 中的计算入门指南](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields_create.htm)。

### 更改指标名称

指标上显示的名称是其定义的名称。您可以通过编辑定义来更改此名称。

1. 在 Tableau Pulse 中，打开要重命名的指标。
2. 选择操作 (...) 菜单，然后选择“编辑定义”。
    
    ![编辑定义按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_definition.png)
3. 对于“名称”，输入一个新名称。
4. 选择“保存定义”。

### 更改见解维度

见解维度是 Tableau Pulse 用来生成有关数据的见解的字段。Pulse for Salesforce 应用程序会自动向您的指标添加一组见解维度，您可以添加更多维度来查看数据中的其他维度。除了在见解中使用之外，这些维度还可用作筛选器，并在指标的见解探索页面上的问答体验中使用。

1. 在 Tableau Pulse 中，打开要更改的指标。
2. 选择操作 (...) 菜单，然后选择“编辑定义”。
    
    ![编辑定义按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_definition.png)
3. 在“可调指标筛选器”下，选择“添加筛选器选项”。可调指标筛选器被作见解维度。
4. 选择要添加的字段。
5. 选择“保存定义”。

### 更改货币格式

默认情况下，指标以美元格式显示货币。调整货币设置以更改数字格式和货币符号。

1. 在 Tableau Pulse 中，打开要更改的指标。
2. 选择操作 (...) 菜单，然后选择“编辑定义”。
    
    ![编辑定义按钮](/tableau/next/zh-cn/online/zh-cn/Img/pulse_edit_definition.png)
3. 在“数字格式”下，确保选择了“货币”。
4. 在“货币”下，选择货币代码。

### 包括来自您的 Salesforce 数据的更多字段

每个指标定义都连接到一个数据源，这是您的数据和 Tableau 之间的链接。Pulse for Salesforce 应用程序会根据您的 Salesforce 数据自动创建数据源，并在创建指标定义时使用这些数据源。如果在编辑指标定义时您想要添加为度量或维度的字段不可用，请编辑数据源或流程以添加该字段。编辑数据源或流程后，编辑相关的指标定义并用新添加的字段替换预先存在的字段。

名为“Sales Cloud Metrics Datasource”的数据源提供以下指标的数据：

- Average Days to Close - Won（平均关闭天数 - 赢得）
- Closed Opportunities (Running Total)（已关闭的机会（运行总计））
- Conversion Rate（转化率）
- Created Opportunities (Running Total)（创造的机会（运行总计））
- Pipe Gen (Running Total)（管道生成（运行总计））
- Total Sales（总销售额）
- Win Rate（赢得比率）

名为“Open Pipe”的流程和名为“Open Pipe Data source”的数据源提供以下指标的数据：

- Open Pipe (Daily)（打开管道（每日））
- Open Pipe (Weekly)（打开管道（每周））

Pulse for Salesforce 应用程序从 User、Account 和 Opportunity Salesforce 对象中引入数据。如果需要来自不同对象的数据，请确保它们包含下表中字段的等效项。

| Salesforce 对象 | 字段 |
| --- | --- |
| User | Id、Name |
| Account | Id、Name、BillingState、BillingCountry、Industry |
| Opportunity | Id、AccountId、Amount、OwnerId、CreatedById |

**提示：**如果您需要与预建数据源中包含的数据完全不同的数据，请使用 Salesforce 连接器创建一个新的已发布数据源。有关连接到 Salesforce 数据的详细信息，请参见[连接到 Salesforce 数据](https://help.tableau.com/current/pro/desktop/zh-cn/examples_salesforce.htm)。

如果您的组织使用 Snowflake 之类的平台来存储数据，请直接连接到该数据平台。有关详细信息，请参见[使用支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)。然后使用该数据创建新的指标定义和指标。

#### 编辑 Tableau 数据源以添加新的 Salesforce 数据对象

如果要添加的数据位于尚未添加到数据源的对象中，请将其添加到数据画布。

1. 从 Tableau Cloud 导航面板中，选择“浏览”。
2. 在内容类型菜单中，选择“所有数据源”。
3. 打开名为“Sales Cloud Metrics Datasource”的数据源。
4. 选择“编辑数据源”。有关编辑数据源的详细信息，请参见[编辑已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/edit_datasources.htm)。
5. 将要添加的数据拖到画布上。
6. 将新对象与现有数据关联或联接。请参见[关联您的数据](https://help.tableau.com/current/pro/desktop/zh-cn/relate_tables.htm#create-and-define-relationships)和[联接数据](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm)。
7. 选择“发布”。

现在，如果您编辑指标定义，则当您选择一个字段时就会出现添加的数据。

#### 编辑流程以更改筛选的数据

指标需要时间维度。对于时间点数据，需要使用流程来获取数据快照并创建时间序列。如果您编辑流程以使用不同的字段，则该数据的快照将在您首次运行更新的流程时开始。有关流程的详细信息，请参见[构建和组织流程](https://help.tableau.com/current/prep/zh-cn/prep_build_flow.htm)。

1. 从导航面板中，选择“浏览”。
2. 在内容类型菜单中，选择“所有流程”。
3. 打开名为“Open Pipe”的流程。
4. 调整流程筛选的字段。有关详细信息，请参见[筛选您的数据](https://help.tableau.com/current/prep/zh-cn/prep_filter.htm)。
5. 选择“发布”。
6. 在通知消息中，选择“查看流程”。
7. 在流程页面上，选择“全部运行”。

## 创建其他指标

通过单个指标定义，您可以创建与该定义筛选选项组合数量相同的指标。考虑创建特定于特定角色的指标，并仅添加相关用户或组作为关注者。若要了解如何操作，请参见[创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#create-metrics)。

您只能根据指标定义中包含的字段创建指标。若要使用不同的字段，请编辑指标定义或创建新的定义。

## 添加关注者

您可以将个人用户或用户组添加为指标的关注者。若要了解如何在 Tableau Cloud 上添加关注者，请参见[管理关注者](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Manage)。您还可以使用 REST API 和[批量创建订阅方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_pulse.htm#PulseSubscriptionService_BatchCreateSubscriptions)添加关注者。

关注者会收到一封电子邮件摘要，了解他们的各项指标的进展情况。如果他们关注两个或更多指标，他们还会看到一份见解摘要，突出显示数据的显著变化。

作为组的一部分关注指标的用户不能单独取消关注这些指标。但是，这些用户可以选择不接收他们关注的指标摘要。有关详细信息，请参见[帮助用户管理摘要](#digests)。

## 管理用户组

Pulse for Salesforce 应用程序创建了一个名为“Pulse for Sales Cloud”的 Tableau 用户组。此组包含您在设置应用程序时同步的 Salesforce 权限集的所有用户。

您可以创建一个新组并向其中添加特定用户。若要了解更多信息，请参见[创建组并向其中添加用户](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm)。您无法更改现有组中的用户。若要了解具体操作方法，请参见[向组中添加用户（“组”页面）](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#Add)。组对于将具有相同工作角色的用户添加为关注者很有用。组还可用于限制对指标中的数据的访问。有关详细信息，请参见[控制访问](#control-access)。

## 帮助用户管理摘要

作为 Tableau 管理员，您无法更改用户的摘要设置。用户可以单独选择不接收他们所关注的指标的摘要。

1. 在 Salesforce 中打开 Pulse 应用程序。
2. 在指标页面上，选择右上角的头像图标，然后选择“Preferences”（首选项）。
    
    ![Pulse 首选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_preferences.png)
3. 选择是否接收摘要。
4. 选择接收摘要的频率。
5. 选择“Save”（保存）。

## 控制访问

在 Salesforce 中配置的数据访问控制不会延续到 Tableau Cloud。除非您限制对 Tableau Cloud 中数据的访问，否则您应该考虑所有用户都可以访问 Pulse for Salesforce 应用程序中的数据。

### 同步对 Tableau Pulse 应用程序的访问权限

您添加到 Pulse for Salesforce 权限集的用户可以访问 Salesforce 中的应用程序。从此权限集中添加或移除用户以限制对应用程序的访问。若要了解具体操作方法，请参见[管理权限集分配](https://help.salesforce.com/s/articleView?language=en_US&id=sf.perm_sets_manage_assignments.htm&type=5)。

更新权限集后，打开向导以将用户与 Tableau 重新同步。

1. 在 Salesforce App Launcher 中，搜索“Pulse Installation Wizard”（Pulse 安装向导）并打开它。
2. 选择“Sync New Users”（同步新用户）选项卡。
3. 输入您在设置应用程序时输入的相同站点信息。请参见[设置 Pulse for Salesforce 应用程序](#set-up-app)。
4. 选择“Test Connection”（测试连接）。
5. 确认有关同步用户的消息，然后选择“Sync Users”（同步用户）。“Pulse for Sales Cloud”权限集中的用户与 Tableau 中的“Pulse for Sales Cloud”用户组同步。

### 限制对单个指标的访问

您可以编辑指标定义以将数据访问权限限制为特定 Tableau 组。在编辑定义之前，请创建您计划用于限制访问的用户组。若要了解更多信息，请参见[创建组并向其中添加用户](https://help.tableau.com/v0.0/online/zh-cn/to_add_users_groups.htm#Create)。

1. 在 Tableau Pulse 中，选择您想要限制访问的指标。
2. 选择操作 (...) 菜单，然后选择“编辑定义”。注意度量、聚合、时间维度和任何定义筛选器。
3. 选择“创建高级定义”。
4. 将您在步骤 2 中记下的字段拖到“度量”、 “时间维度”和“筛选器”功能区。
5. 在度量名称上，选择箭头，然后选择聚合类型。
    
    ![聚合选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_advance_aggregation.png)
6. 在字段搜索框旁边，选择箭头，然后选择“创建计算字段”。
    
    ![计算字段选项](/tableau/next/zh-cn/online/zh-cn/Img/pulse_calculated_field.png)
7. 在计算编辑器中，输入包含要限制访问的组的计算，并将 `GroupName` 替换为您的组的名称。
    
    `ISMEMBEROF('GroupName')`
8. 将计算字段器拖到“筛选器”功能区。
9. 对于筛选器，在“列表”下，选择“自定义值列表”。
10. 输入 True ，然后选择“添加”。
11. 取消选中“为空时包含所有值”。
12. 选择“确定”以应用筛选器。
13. 在高级分析编辑器中，选择“应用”。
14. 选择“保存定义”。

### 实现行级安全性

如果您希望用户查看特定于他们的数据（例如基于他们所属的组织或他们销售的地区），则必须为数据实施行级安全性。有多种方法可以为 Tableau Cloud 实现行级安全性，具体取决于您的目标和数据。有关详细信息，请参见[Tableau 中的行级安全性选项概述](https://help.tableau.com/v0.0/online/zh-cn/rls_options_overview.htm)和[具有权利表的行级安全性最佳实践](https://www.tableau.com/zh-cn/learn/whitepapers/row-level-security-entitlements-tables)。

<!-- document id=799693e3c49ed2f6af2344b9aebad77fb6256c5c4968e730d53c81c3ae63f4ba url=/tableau/next/zh-cn/online/private_connect_inbound_setup.md -->

[跳转到主要内容](#main-content)

# 设置入站私人连接

本主题介绍如何为 Tableau Cloud 站点设置入站私人连接。

## 先决条件

- 验证您的组织是否已启用入站私人连接。若要进行检查，请登录 Tableau Cloud Manager，并选择“设置”。如果您没有“私人连接”选项卡上，请联系您的客户主管以启用入站私人连接。
- 记录 Tableau Cloud pod 名称。举例来说，如果您的站点主机名是 `10ay.online.tableau.com`，pod 名称为“10ay”。
- 记录 Tableau Cloud Manager (TCM) 租户名称。举例来说，如果您的 TCM URL 是 `mytenant.cloudmanager.tableau.com`，租户名称为“mytenant”。
- 记录虚拟私有云 (VPC) 和 Tableau Cloud pod 共有的区域。（您的 AWS 帐户必须在 Tableau Cloud pod 所在的同一区域中具有 VPC。）请参见[用于数据提供程序授权的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#safelist)，获取包含 pod 和区域列表的表。
- 记录您的 pod 区域的端点服务名称。“端点服务名称”位于 Tableau Cloud Manager 的“私人连接”页面上的“AWS 区域、IAM ARN 和端点服务名称”表上。
- VPC 必须启用域名系统 (DNS) 主机名和 DNS 解析。有关详细信息，请参见 AWS 文档中的[您的 VPC 的 DNS 属性](https://docs.aws.amazon.com/vpc/latest/userguide/AmazonDNS-concepts.html#vpc-dns-support)。

## 步骤 1：创建 VPC 端点

在连接到 Tableau Cloud 端点服务的 AWS 帐户中创建接口 VPC 端点。有关详细信息，请参见 AWS 文档中的[创建 VPC 端点](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html#create-interface-endpoint-aws)。

1. Name tag（名称标记）（可选）：根据需要为端点命名。
2. Type（类型）：选择“Endpoint services that use NLBs and GWLBs”（使用 NLB 和 GWLB 的端点服务）类别。
3. “Service name”（服务名称）：使用您在先决条件中记录的端点服务名称 。
4. 选择“Verify service”（验证服务）以继续进行设置。
5. 确保“Enable Cross Region endpoint”（启用跨区域端点）未选中。
6. VPC：选择您的 AWSVPC。
7. “Subnets”（子网）：选择至少两个可用区中的子网以实现高可用性。
8. 确保“Enable DNS Name”（启用 DNS 名称）未选中。（在步骤 5 中手动配置私有 DNS。）
9. “Security group”（安全组）：选择现有安全组或创建安全组。（在步骤 3 中配置安全组。）
10. 选择“Create endpoint”（创建端点）。新端点状态应为“Pending acceptance”（待接受）。
11. 选择新端点以查看“Details”（详细信息）。
12. 记录“Endpoint ID”（端点 ID）。（示例： `vpce-0123456789abcdef0`）
13. 记录“DNS names”（DNS 名称）列表中的第一个条目。（示例： `vpce-0123456789abcdef0-12345678.vpce-svc-0123456789abcdef0.us-west-2.vpce.amazonaws.com`）

## 步骤 2：在 Tableau Cloud Manager 中配置端点

配置私人连接的 Tableau Cloud 端。

1. 登录到 TCM。
2. 选择“设置”\>“私人连接”。
3. 在“入站连接”下，选择“创建”。
4. 提供入站专用连接的“名称”和“描述”。
5. 选择“区域”。该区域与 VPC 区域和 Tableau pod 区域匹配。
6. VPC 端点 ID：使用您在步骤 1 中记录的端点 ID。
7. 选择“创建”。新端点状态应为“正在分配”。
8. 预需可能要几分钟。在新专用连接的操作菜单 (...) 中，单击“同步”以刷新状态。
9. 当状态在 TCM 中为“就绪”，在 AWS 的“端点”页面上为“可用”时，则专用连接为已就绪。（使用刷新图标刷新端点列表。）

## 步骤 3：配置安全组

在 AWS 安全组上配置规则以允许流量。有关详细信息，请参见 AWS 文档中的[使用安全组控制进入 AWS 资源的流量](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html)。

- **端点安全组**：允许通过 HTTPS 访问 VPC 端点。

请记住，您的特定网络架构可能需要其他安全组配置。

成功建立连接并配置安全组后，继续执行[入站私人连接的 DNS](https://help.tableau.com/v0.0/online/zh-cn/private_connect_inbound_dns.htm)中的步骤 4 和 5。

<!-- document id=0cf1308a1b579d71aa360e5b9bc211aa5ac3714bac3d2434d3300feff7c4ea5f url=/tableau/next/zh-cn/online/formatting_animations.md -->

[跳转到主要内容](#main-content)

# 设置动画格式

为可视化项设置动画，以更好地突出显示数据中不断变化的模式、显示峰值和异常值，并查看数据点如何进行聚类和分离。

动画在筛选、排序和缩放设置、不同页面以及对筛选器、参数和设置操作的更改之间进行视觉过渡。当可视化项以动画方式显示对这些更改的响应时，查看者可以更清楚地看到数据有何不同，从而帮助他们做出更明智的决策。

## 了解同步动画和顺序动画

制作动画时，您可以在两种不同的样式之间进行选择：同步动画或顺序动画。下面是每种类型的示例。

### 同步动画

在更简单的图表和仪表板中显示值更改时，默认的同步动画更快且效果良好。

![Tableau 动画。](/tableau/next/zh-cn/online/zh-cn/Img/animations.gif)  
单击上图可重播动画。

### 顺序动画

顺序动画需要更多的时间，但通过逐步呈现更改可以来使复杂的更改更加清晰。

![顺序动画。](/tableau/next/zh-cn/online/zh-cn/Img/animations_sequential.gif)  
单击上图可重播动画。

## 为工作簿中的可视化项设置动画

创建新工作簿时，Tableau 默认为您的可视化项启用动画。您可以在用户和工作簿级别打开或关闭动画。  

1. 选择“设置格式”\>“动画”。
2. 如果要为每个工作表设置动画，请在“工作簿默认值”下单击 “打开”。然后执行以下操作：
    - 对于“持续时间”，选择一个预设值，或指定最长 10 秒的自定义持续时间。
    - 对于“样式”，请选择“同步”以一次播放所有动画，或选择“顺序”以淡出效果显示标记，对标记进行移动和排序，然后以淡入效果显示标记。
3. 若要针对特定工作表覆盖工作簿默认值，请在“选定工作表”下更改设置。
    
    **注意：**在“选定工作表”部分，“(默认)”指明自动反映相关工作簿“默认”设置的设置。
    
    ![动画窗格，包含用于在工作簿或工作表级别配置动画的选项。](/tableau/next/zh-cn/online/zh-cn/Img/animations_pane.png)

若要重播动画，请单击工具栏中的“重播”按钮。从“重播”按钮中，您还可以选择动画重播的速度：实际速度、2 倍速度或 1/2 倍速度。

![用于选择重播速度的“重播”按钮下拉菜单](/tableau/next/zh-cn/online/zh-cn/Img/replay_speed.png)

## 重置工作簿的动画设置

您可以重置动画以将整个工作簿恢复为到默认动画设置。请注意，默认情况下这将关闭动画。

1. 选择“设置格式”\>“动画”。
2. 在“动画”窗格的中间，单击“重置所有工作表”。

## 完全禁用所有动画

创建新工作簿时，默认情况已启用动画。如果您在查看可视化项时发现发现动画会分散注意力，则可以完全禁用动画，使它们永远不会播放。（这不是系统范围的设置;每个用户都需要单独应用该设置。）

- 在 Tableau Desktop 中，选择“帮助”\>“设置和性能”，然后取消选择“启用动画”。
- 在 Tableau Cloud 或 Tableau Server 中，单击浏览器右上角的个人资料图像或首字母缩写，然后选择“我的帐户设置”。然后向下滚动到页面底部，取消选择“启用动画”，然后单击“保存更改”。

**注意：**禁用动画后，您仍然可以在制作模式下选择“设置格式”\>“动画”并调整设置，但它们将不起作用。

## 设置轴动画的小数格式

如果度量的小数位数设置为默认值，则轴动画期间显示的小数位数可能会在轴动画期间波动。为避免这种情况，请设置为度量显示的小数位数的格式。有关详细信息，请参见[设置数字和 Null 值的格式](https://help.tableau.com/current/pro/desktop/zh-cn/formatting_specific_numbers.htm)。

## 为什么动画无法播放

### 服务器呈现

如果可视化项是服务器呈现的，则动画不会播放。为了确保可视化项在客户端计算机或移动设备上呈现，请使用以下方法：

- 如果您是可视化项作者，请[降低可视化项复杂性](https://help.tableau.com/current/pro/desktop/zh-cn/perf_visualization.htm)。
- 如果您是 Tableau Server 管理员，请[提高客户端呈现的复杂性阈值](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

**注意：**在处理能力较低的计算机上，动画可能会显得断断续续，但用户可以继续与可视化项进行交互，响应不会出现延迟。

### 不支持的浏览器和功能

除 Internet Explorer 外，所有 Web 浏览器都支持动画。

以下 Tableau 功能不会以动画方式显示：

- Web 浏览器中的地图、多边形和密度标记
- 饼图和文本标记
- 标题
- 预测、趋势和参考线
- 页面历史记录痕迹（如果可视化项包含这些痕迹，请关闭动画以避免意外行为。）

<!-- document id=fa72739276afc8a8fe288259f7af5626cdbc3f5ff64042a47b8ba57c94e7baed url=/tableau/next/zh-cn/online/web_author_who.md -->

[跳转到主要内容](#main-content)

# 设置对内容的 Web 编辑、保存和下载访问权限

如果要在您的站点上启用 Web 制作功能，您可以对站点上的哪些用户可以访问此功能进行更精确的配置。通过在内容级别使用站点角色和权限规则，您可以针对项目、工作簿和数据源授予或拒绝“Web 编辑”、“保存”或“下载”能力。

**注意：**本文档力求使用短语_“Web 编辑”_来指定权限规则中能力的名称，并使用_“Web 制作”_来提及在服务器上创建和修改工作簿的一般功能。但是，您可能会在其他方面看到这两个短语互换使用的情况。

## 为什么允许用户直接在站点上工作

作为管理员，您最初的想法是允许人员在站点中填充内容，这似乎没有什么差别，但可能值得怀疑。但是，您可以通过一些控件限制完成此操作的位置，同时提供集中式内容管理为您和您的用户提供的重要优势。

### Web 制作的优点和缺点

对于发布者和业务用户，Web 制作的一些好处包括：

- 它为协同工作的分析人员团队提供了一个中心位置以便他们在其中提供输入。
- 利用这项功能，没有 Tableau Desktop 的人员可以连接到数据源和创建工作簿。
- 它允许人员在远离 Tableau Desktop 计算机或 VPN 时访问内容，无论是在计算机上还是手持设备上。
- 它可提供一个框架，在 Tableau 报表之间实现一致性。（通过在站点上提供模板工作簿，分析人员可以下载或创建已经部署了数据连接、品牌和格式的新工作簿。）

对于管理员，优点可能包括：

- 减少了要管理和支持的 Tableau Desktop 部署。
- 减少了需要安装数据库驱动程序的计算机。
- 能够管理内容。
- 可以更准确地监视人员利用 Tableau 所进行的操作。

Web 编辑的一些缺点包括：

- 对于分析人员来说，Web 编辑功能不像在 Tableau Desktop 中那样广泛（虽然它仍然在向着同样的趋势发展）。
- 对于管理员来说，在服务器上工作的人员更多，这可能意味着需要升级系统。
- 如果没有发布准则，站点上将会出现内容扩散的情况。  
    这可能会把依赖于已发布 Tableau 仪表板和数据源的人员弄糊涂，还会降低服务器性能和数据质量，并可能影响数据安全性。

## 管理权限以帮助用户避免内容扩散

为了帮助用户避免站点上的内容扩散，许多 Tableau 管理员使用项目来允许不同级别的内容访问。例如，一个项目可能配置为允许所有用户编辑和保存工作簿；另一个项目可能只允许已批准的发布者保存新内容。

要更好地了解其工作原理，请参见以下资源：

- [为托管自助服务配置项目、组、组集和权限](https://help.tableau.com/v0.0/online/zh-cn/projects_data_gov.htm)
- [大规模的受控自助服务](https://www.tableau.com/zh-cn/learn/whitepapers/governed-self-service-analytics-scale "查看描述受控自助服务器环境的白皮书")，这是 Rupali Jain 的 Tableau 白皮书。  
    若要查看 PDF，您可能需要提供您的 Tableau 网站凭据。这些是您在社区论坛中使用或提交支持案例所使用的相同凭据。

## 针对适当的访问级别协调编辑和保存功能以及站点角色

若要编辑、保存和下载工作簿，用户必须具有一个允许执行这些操作的站点角色，以及权限规则中所定义的能够授予或拒绝编辑相关访问权限的以下能力。

### 站点角色访问权限

- 在内容级别设置适当的权限后，“Creator” 或“Explorer（可发布）”站点角色允许“保存（覆盖）”和“另存为/下载”。
    
    请注意，只有工作簿所有者才能使用**“文件”> “保存”**。在项目和工作簿级别授予**“保存”**权限能力后，非所有者用户可通过选择**“文件”> “另存为”**并使用同一工作簿名称，在 Web 制作过程中覆盖现有工作簿。这将覆盖现有内容，并且这些用户将成为所有者并获得对内容的完全访问权限。
- 可以为“Explorer”站点角色授予 **“Web 编辑”**和**“另存为/下载”**能力，但他们将无法进行保存操作（既不能覆盖现有内容，也不能保存对新工作簿所做的更改）。

有关详细信息，请参见[“Web 编辑”和“Web 制作”](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm#webauthor)。

<!-- document id=779ea51f1626fd2c9d87a1a5b040b66998a1725d92778ba0510e7442b116fa8e url=/tableau/next/zh-cn/online/formatting_specific_numbers.md -->

[跳转到主要内容](#main-content)

# 设置数字和 Null 值的格式

您可以为可视化项（包括度量、维度、参数、计算字段和轴标签）中显示的数值指定格式。指定数字格式时，您可以从一组标准格式中进行选择，例如数字、货币、科学和百分比。您还可以定义自定义数字格式，并可选择包含特殊字符。

当度量包含 null 值时，您可以使用格式化以不同的方式处理 null 值，例如用零替换 null 值或隐藏它们。

## 适用于 Tableau Desktop

### 指定数字格式

1. 在视图中右键单击（在 Mac 上按住 Control 单击）数字并选择“设置格式”。
2. 在“设置格式”窗格中，单击“数字”下拉菜单。
3. 选择数字格式。
    
    某些格式需要进行其他设置。举例来说，如果您选择“科学型”，则还必须指定小数位数。
    
    ![格式设置窗格，其中包含选择科学数字的小数点位数的选项。](/tableau/next/zh-cn/online/zh-cn/Img/numbers1.png)

下面是 Tableau 中可用的数字格式及关联选项。

<table class="table--plain"><tbody><tr><td style="text-align: center;">数字格式</td><td style="text-align: center;">格式选项</td></tr><tr><td><b>自动</b>：基于数据源指定的格式或字段中包含的数据自动选择格式。</td><td>无。</td></tr><tr><td><b>数字(标准)</b>：格式基于所选区域设置。</td><td><b>区域设置</b>：数字格式取决于所选地理位置。</td></tr><tr><td><b>数字（自定义）</b>：根据自己的选择自定义格式。</td><td><p><b>小数位数</b>：要显示的小数位数。</p><p><b>负值</b>：将如何显示负值。</p><p><b>单位</b>：数字将使用指定单位进行显示。例如，如果数字为 20,000 并且单位为千，则数字会显示为 20K。</p><p><b>前缀/后缀</b>：位于每个显示的数字之前和之后的字符。</p><p><b>包括千位分隔符</b>：数字是否按千位显示分隔符（例如：100,000 与100000）。</p></td></tr><tr><td><b>货币(标准)</b>：格式和货币符号基于所选区域设置。</td><td><b>区域设置</b>：货币格式基于所选地理位置。</td></tr><tr><td><b>货币（自定义）</b>：根据自己的选择自定义格式和货币符号。</td><td><p><b>小数位数</b>：要显示的小数位数。</p><p><b>负值</b>：将如何显示负值。</p><p><b>单位</b>：数字将使用指定单位进行显示。例如，如果数字为 20,000 并且单位为千，则数字会显示为 20K。</p><p><b>前缀/后缀</b>：位于每个显示的数字之前和之后的字符。</p><p><b>包括千位分隔符</b>：数字是否按千位显示分隔符（例如：100,000 与100000）。</p></td></tr><tr><td><b>科学型</b>：数字以科学表示法显示。</td><td><b>小数</b>：要显示的小数位数。</td></tr><tr><td><b>百分比</b>：数字显示为带百分比符号的百分比。值 1 解释为 100%，0 解释为 0%</td><td><b>小数</b>：要显示的小数位数。</td></tr><tr><td><b>自定义</b>：格式完全基于指定的格式选项。</td><td><b>自定义</b>：键入要使用的格式，包括特殊字符（可选）。有关详细信息，请参见本主题中的“定义自定义数字格式”。</td></tr></tbody></table>

### 自动缩放值

使用 `[scale]` 标记，您可以设置自定义数字字符串的格式以动态换算值，并根据其量级附加适当的国际单位制 (SI) 后缀。

当单个字段跨越多个量级（例如千和百万）时，此标记非常理想，它可确保每个值以可读格式清晰显示，而无需在整个列中使用统一单位。

虽然“显示单位”（例如“千”、“百万”或“十亿”）对字段中的所有值强制使用单一固定单位，但 `[scale]` 标记对每个值应用动态扩展。

- **显示单位**：最适合在所有数字中强制使用统一单位。
- **`[scale]` 标记**：最适合单个字段内的自适应值级别格式设置。

#### `[scale]` 标记的工作方式

将 `[scale]` 应用于自定义格式会触发以下过程：

- Tableau 会单独评估每个数据点。
- 根据情况将值除以 1,000 的幂。
- 输出会附加匹配的 SI 后缀。

#### 换算值格式设置示例

使用 0.0`[scale]`：

- 12 呈现为 12.0
- 1,000 呈现为 1.0k
- 1,500,000 呈现为 1.5M
- 2,300,000,000 呈现为 2.3G
- 0.004 呈现为 4.0m

#### 在自定义值字符串中使用 `[scale]`

1. 在视图中右键单击（在 MacOS 上按住 Control 单击）目标数字，并选择“设置格式”。
2. 导航到“设置格式”窗格，打开“数字”下拉菜单，并选择“自定义”。
3. 将 `[scale]` 标记插入“格式”输入框（例如， `0.0[scale]`）。

#### 关于后缀和单位的重要注意事项

- `[scale]` 使用标准 SI 前缀，包括 `k`、`M`、`G` 和 `T`（用于较大的数字），以及 `m`、`µ` 和 `n`（用于较小的数字）。
- SI 单位前缀与标准“显示单位”标签不同。例如，1,000,000,000 使用 `G` （千兆）显示，而不是 `B`（十亿）。
- `[scale]` 标记直接键入到自定义数字格式文本字符串中。

### 定义自定义数字格式

若要在您的可视化项中应用自定义数字格式，请执行以下操作：

1. 在视图中右键单击（在 Mac 上按住 Control 单击）数字并选择“设置格式”。
2. 在“设置格式”窗格中，单击“数字”下拉菜单，并选择“自定义”。
3. 在“设置格式”字段中，使用以下语法定义您的格式设置首选项：`Positive number format;Negative number format;Zero values`。

定义数字格式代码时，请记住：

- 您最多可以按以下顺序为三种类型的数字指定格式：正数、负数和零。
- 每个数字类型必须用分号 (;) 分隔。
- 如果您仅指定一种数字类型，则该类型的格式将用于所有数字。
- 如果您指定两种数字类型，则第一种类型的格式适用于正数和零，而第二种类型的格式适用于负数。
- 如果您跳过数字格式代码中的类型，则必须为每个缺少的类型添加一个分号 (;)。

#### 自定义数字格式示例

有关可在可视化项中使用的常用自定义数字格式代码示例，请参阅下表。

语法分为三部分：`<positive number format>;<negative number format>;<zero format>`，以分号分隔。

<table class="table--plain"><tbody><tr><td style="text-align: center;">用例</td><td><p style="text-align: center;">数字代码语法</p></td><td style="text-align: center;">示例输出</td></tr></tbody><tbody><tr><td>仅显示正值</td><td><p>#,##; ;</p><p>（注意第二个和第三个分号后的空格）</p></td><td>正值：1,234<br>负值：（仅显示空格）<br>零值：（仅显示空格）</td></tr><tr><td>仅显示负值</td><td>;-#,##;</td><td>正值：（不显示）<br>负值：-1,234<br>零值：（不显示）</td></tr><tr><td>仅显示零值</td><td>;;0;</td><td>正值：（不显示）<br>负值：（不显示）<br>零值：0</td></tr><tr><td>隐藏零值</td><td>#,###;-#,###;;</td><td>正值：1,234<br>负值：-1,234<br>零值：（不显示）</td></tr><tr><td>在括号中显示负值</td><td>#,###;(#,###);;</td><td>正值：1,234<br>负值：(1,234)<br>零值：（不显示）</td></tr><tr><td>为值添加字符前缀</td><td>$#,###.##;-$#,###.##;$0;</td><td>正值：$1,234.56<br>负值：-$1,234.56<br>零值：$0</td></tr><tr><td>为值添加字符后缀</td><td>#%;-#%;0%;</td><td>正值：12%<br>负值：-34%<br>零值：0%</td></tr><tr><td>添加文本描述符</td><td>"$"#,#"盈余";$"-##"短缺"; "$"0;</td><td>正值：$1,234 盈余<br>负值：$-1,234 短缺<br>零值：$0</td></tr></tbody></table>

可通过多种方法来自定义数字格式以满足您的需求。有关更多代码指南和示例，请参见 Microsoft 知识库中的[查看有关自定义数字格式的准则](https://support.microsoft.com/zh-cn/office/review-guidelines-for-customizing-a-number-format-c0a1d1fa-d3f4-4018-96b7-9c9354dd99f5)。

**注意：**Microsoft 描述的选项与 Tableau 中可用的选项之间存在细微差异。例如，在列内对齐文本的自定义数字格式在 Tableau 中不相关。此外，颜色代码文本的自定义数字格式不适用，因为您可以使用“标记”卡将颜色应用于文本。(有关应用颜色的详细信息，请参见[控制视图中标记的外观](https://help.tableau.com/current/pro/desktop/zh-cn/viewparts_marks_markproperties.htm)。)请务必仅使用适用于 Tableau 的自定义数字格式。

#### 在自定义数字格式中包含特殊字符

自定义数字格式的好处之一是能够包含特殊字符或符号。符号可以让您更轻松地快速了解可视化项中度量和计算之间的比较。

例如，假设您想显示公司最畅销的三种产品的利润逐月比较。与其使用标准标签来显示这些产品的利润与上个月相比变化了 +5%、-2% 和 0% 的标签，您可以按如下方式设置自定义数字格式，以将这些变化显示为 ▲5%，▼2% 和 ►0。

![使用特殊字符定义的自定义数字格式](/tableau/next/zh-cn/online/zh-cn/Img/CustomNumberFormatCode.png)

### 为字段设置默认数字格式

在“数据”窗格中右键单击（在 Mac 上按住 Control 单击）字段，并选择“默认属性”\>“数字格式”。

在随后出现的对话框中，指定每当将该字段添加到视图时要使用的数字格式。默认数字格式会随工作簿一起保存。在导出连接信息时，也会导出该格式。

**注意：**使用“设置格式”窗格设置数字格式将会覆盖在其他位置应用的任何数字格式设置。

### 将度量格式设置为货币

下图中的视图显示了一段时间内的利润。请注意，垂直轴上的利润数字未设置为货币格式。

![](/tableau/next/zh-cn/online/zh-cn/Img/FormattingNumbersDates_InitialView.png)

**将数字设置为货币格式：**

1. 右键单击“Profit”（利润）轴，并选择**“设置格式”**。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/FormattingNumbersDates_FormatAxis.png)
2. 在“设置格式”窗格中“轴”选项卡上的“比例”下，选择**“数字”**下拉列表，然后选择以下各项之一：
    
    选择**“货币(标准)”**以向数字中添加一个美元符号和两个小数位。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/FormattingNumbersDates_FormatCurrency.png)
    
    选择**“货币(自定义)”**以指定小数位数、如何处理负值、单位、是否包括前缀或后缀以及是否包括分隔符字符。

### 使用区域设置来指定数字格式

默认情况下，Tableau 使用您的计算机的区域设置和语言设置来设置数字格式。但您可以在**“设置格式”**窗格中显式地设置其他区域设置。

下面的步骤演示如何使用与前面部分中相同的视图来设置“瑞士德语”货币。

1. 右键单击“Profit”（利润）轴，并选择**“设置格式”**。
2. 在“轴”选项卡上的“比例”下，选择**“数字”**下拉列表，然后选择**“货币(标准)”**。
3. 在**“区域设置”**下拉列表中，各项以**“语言(国家/地区)”**格式显示。对于此示例，选择**“德语(瑞士)”**。视图将更新，显示以瑞士法郎为单位的销售额数字，格式针对德语设置。

**提示：**您可以更改默认货币设置，以便每次将“Profit”（利润）度量拖到视图时，该度量都使用所需的设置。在“数据”窗格中，右键单击**“Profit”（利润）**（或其他货币度量），并选择**“默认属性”**\>**“数字格式”**。然后按如上所示的方式设置字段格式。

### 设置 null 值格式

当度量包含 null 值时，这些值通常在视图中绘制为零。但是，有时这会改变视图，因此最好禁止显示 null 值。可以设置每个度量的格式，通过特定的方式处理 null 值。

**为特定字段设置 null 值的格式：**

1. 右键单击（在 Mac 上按住 Control 单击）视图中具有 null 值的字段，并选择“设置格式”。
2. 转到**“区”**选项卡。
3. 在“特殊值”区域中，指定是在视图右下角使用指示器显示 null 值、在默认值处（例如，数字字段为零处）绘制它们、隐藏值但连接线还是隐藏并断开线以指示存在 null 值。
    
    ![格式设置窗格，其中包含有关如何显示 null 值的选项。](/tableau/next/zh-cn/online/zh-cn/Img/nullvalues3.png)
4. 如果在**“文本”**字段中指定文本，它将在启用了标记标签后在视图中为 null 值显示。请参见[显示和隐藏标记标签](https://help.tableau.com/current/pro/desktop/zh-cn/annotations_marklabels_showhideworksheet.htm#show-and-hide-individual-mark-labels)。

**注意**：“特殊值”区域对于维度或离散度量不可用。

## 对于 Tableau Server 或 Tableau Cloud

### 指定数字格式

在 Web 上制作视图时，您可以为视图中使用的字段指定数字格式。

1. 在 Web 编辑模式中，右键单击视图中的度量，并选择**“设置数字格式”**。
    
    ![度量上下文菜单，带有用于设置数字格式的选项。](/tableau/next/zh-cn/online/zh-cn/Img/format_numbers_web1.png)
2. 在出现的对话框中，选择一种数字格式。
    
    某些格式提供其他设置。举例来说，如果您选择“货币”，您也可以指定小数位数以及单位，并指定是否包括分隔符，例如逗号。
    
    在此示例中，“Sales”（销售额）的格式设置为小数位数为零并且带千 (k) 单位的货币。视图中的“Sales”（销售额）数字将使用这些设置更新。标签和工具提示也会更新。
    
    ![一个下拉菜单中，包含用于将数字格式设置为自动、标准数字、自定义数字、标准货币、自定义货币、百分比、科学或自定义的选项。](/tableau/next/zh-cn/online/zh-cn/Img/format_numbers_web2.png)
    
    下面是 Tableau 中可用的数字格式及关联选项。
    
    <table class="table--plain"><tbody><tr><td style="text-align: center;">数字格式</td><td style="text-align: center;">格式选项</td></tr></tbody><tbody><tr><td><b>自动</b>：基于数据源指定的格式或字段中包含的数据自动选择格式。</td><td>无。</td></tr><tr><td><b>数字（自定义）</b>：根据自己的选择自定义格式。</td><td><p><b>小数位数</b>：要显示的小数位数。</p><p><b>单位</b>：数字将使用指定单位进行显示。例如，如果数字为 20,000 并且单位为千，则数字会显示为 20K。</p><p><b>包括分隔符</b>：数字是否按千位显示分隔符（例如：100,000 与100000）。</p></td></tr><tr><td><b>货币（自定义）</b>：根据自己的选择自定义格式和货币符号。</td><td><p><b>小数位数</b>：要显示的小数位数。</p><p><b>单位</b>：数字将使用指定单位进行显示。例如，如果数字为 20,000 并且单位为千，则数字会显示为 20K。</p><p><b>包括分隔符</b>：数字是否按千位显示分隔符（例如：100,000 与100000）。</p></td></tr><tr><td><b>百分比(自定义)</b>：数字显示为带百分比符号的百分比。值 1 解释为 100%，0 解释为 0%</td><td><b>小数位数</b>：要显示的小数位数。</td></tr><tr><td><b>科学型(自定义)</b>：数字以科学计数法显示。</td><td><b>小数位数</b>：要显示的小数位数。</td></tr></tbody></table>

<!-- document id=349b0241985b696c5424511251f1205e0886d85ed25dbadc8d4c9a2931df8d48 url=/tableau/next/zh-cn/online/dm_dqw.md -->

[跳转到主要内容](#main-content)

# 设置数据质量警告

数据质量警告是 Tableau Catalog（适用于 Tableau Server 和 Tableau Cloud 的 Data Management 产品的一部分）的一项功能。有关 Tableau Catalog 的详细信息，请参见 [Tableau Server](https://help.tableau.com/current/server/zh-cn/dm_catalog_overview.htm) 或 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dm_catalog_overview.htm) 帮助中的“关于 Tableau Catalog”。

在您的环境中启用 Tableau Catalog 后，您可以对数据资产设置数据质量警告，以便该数据的用户了解问题。例如，您可能希望让用户知道某个数据源已被弃用，或者刷新对于数据提取数据源已失败。

您可以对数据源、数据库、表、流程、虚拟连接、虚拟连接表和列设置数据质量警告。

Tableau Cloud 和 Tableau Server 的版本 2019.3 中引入了数据源、数据库、表和流程的数据质量警告。Tableau Cloud 2022 年 3 月版和 Tableau Server 2022.1 中新增了虚拟连接和虚拟连接表的数据质量警告，Tableau Cloud 2022 年 10 月版和 Tableau Server 2022.3 中新增了列的数据质量警告。

## 关于数据质量警告

有两种数据质量警告：您设置的质量警告，以及数据提取刷新或流程运行失败时 Tableau 设置的质量警告（也称为监视质量警告）。

- **您设置的质量警告**：您设置的质量警告对用户可见，直到您或其他用户将其移除。
- **监视质量警告**：如果您为数据提取或流程资产启用监视质量警告，则当数据提取刷新或流程运行失败时，Tableau 会自动向资产添加质量警告。稍后，如果数据提取刷新或流程运行成功，Tableau 会自动移除质量警告。

从 Tableau Cloud October 2023 和 Tableau Server 2023.3 开始，除了在资产级别设置监视警告之外，您还可以立即打开或关闭整个站点的数据提取刷新和流程运行监视。有关站点范围监控的信息，请参见[站点范围内的数据提取刷新和流程运行故障监控](#sitewide_monitoring_dqw)。

**注意：**您可以使用 REST API 启用和修改这两种数据质量警告。有关详细信息，请参见 Tableau REST API 帮助中的“标签和数据质量警告”[元数据方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_metadata.htm)。

## 数据质量警告出现的位置

在 Tableau Cloud 和 Tableau Server 中，当您对数据源、流程、数据库、表、列、虚拟连接或虚拟连接表设置警告时，该警告对资产用户及其下游的任何资产都是可见的。例如，查看依赖于某个表的仪表板的用户可以看到该表上设置的警告。用户会在仪表板的“数据详细信息”选项卡上看到警告图标，并且可以打开该窗格以查看更多信息。

![“数据详细信息”窗格上的数据质量警告](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_server_wkbk.png)

在列表视图中探索某些类型的内容时，会出现数据质量警告：

![列表视图中的数据质量警告列](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_list_view.png)

注意：如果您看到数据质量警告列，但没有包含 Data Management 的许可证，则选择列标题会显示 Data Management 的升级信息。可以在您的帐户设置中关闭升级。

数据质量警告也会出现在资产页面的顶部：

![资产页面上的数据质量警告](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_dqw_masthead.png)

在 Tableau Desktop 中，用户在以下情况下会在“数据”窗格中看到数据源旁边的图标

- 工作簿中使用的数据源上有警告，或者
- 工作簿中使用的数据源上游存在警告

注意：列和虚拟连接的数据质量警告不会出现在 Tableau Desktop 中。

若要查看警告的详细信息，请选择警告图标。

![“数据”窗格中的数据质量警告](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_label_in_data_pane.png)

在 Tableau Cloud Web 制作中，您可以通过选择数据连接或字段上的“目录详细信息”来查看数据窗格（数据连接或字段）中对象的所有标签属性。

### 可见性

数据质量警告可归类为高可见性。高可见性质量警告显得更加紧急并出现在更多地方。例如，当任何人打开依赖于数据源的视图时，数据源上的高可见性警告将生成通知。

![包含数据质量警告信息区域的已发布视图](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_hv_alert.png)

高可见性质量警告的图标和徽章为黄色或橙色，而标准可见性质量警告为蓝色。

如果多个质量警告适用于一项资产（因为资产具有多个质量警告或继承了上游质量警告），则徽章将包含一个数字，并且颜色由最高可见性标签确定。例如，如果一项资产收到两个质量警告，其中一个是标准可见性，另一个是高可见性，则徽章为黄色或橙色。

![](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_dqw_badge_2_labels.png)

## 订阅中的数据质量警告

管理员可以在电子邮件订阅中打开数据质量警告。如果启用此功能，用户收到的电子邮件将包含该视图的高可见性数据质量警告，并包含指向以下内容的链接：

- 相关视图或工作簿，其“数据详细信息”窗格已打开。
- 相关上游资产，例如数据源、表或数据库。

管理员可以通过在 Tableau Server 或 Tableau Cloud 站点设置页面上选择“视图和工作簿订阅中的高可见性数据标签”选择（以前为“订阅中的数据质量警告”选项）来启用电子邮件订阅中的数据质量警告。有关详细信息，请参见“站点设置参考”中的[视图和工作簿订阅中的高可见性数据标签](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#data-quality-warnings-in-subscriptions)。

## 如何设置质量警告

您可以对资产设置多种不同的数据质量警告。从 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3 开始，管理员可以通过[自定义数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)添加到可用数据质量警告列表中。

从 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3 开始，“敏感数据”不再是数据质量警告，而是敏感度标签。有关详细信息，请参见[敏感度标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_sensitivity.htm)。在 Tableau Server 2023.1 及更低版本中，“敏感数据”仍然是数据质量警告。

内置以下数据质量警告：

- 警告
- 已弃用
- 过时数据
- 正在维护

若要将数据质量警告附加到资产，请执行以下操作：

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除质量警告，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

1. 搜索或导航到资产。导航步骤取决于您想要添加质量警告的资产类型：

- 数据源或虚拟连接 - 在“浏览”页面上，选择“所有数据源”或“所有虚拟连接”。
- 虚拟连接表 - 在“浏览”页面上，选择“所有虚拟连接”，然后选择包含要认证的虚拟连接表的虚拟连接。然后选择虚拟连接表。
- 数据库或表 - 在“浏览”页面上，导航到数据库或表。或在“外部资产”页面上选择“数据库和文件”或“表和对象”。
- 列 - 在“浏览”页面上，导航到表。或在“外部资产”页面上选择“表和对象”并导航到表。然后在列表中找到该列。

3. 选择数据资产旁边的操作菜单 (...)，然后选择“数据标签”\>“数据质量警告”。（对于 Tableau Server 2022.3 及更低版本中的列，请改为选择该列，然后单击“操作”下拉列表并选择“质量警告” 。）  
    ![“数据标签”下拉菜单，光标选择“数据质量警告…”](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_quality_warning_menu.png)
4. 选中要附加到资产的质量警告旁边的复选框。或者，如果您知道质量警告的名称，则可以在对话框顶部搜索它，然后选中其旁边的复选框。（在 Tableau Server 2023.3 及更低版本中，您只能为每项资产附加一个质量警告。使用“显示警告”开关或“启用警告”复选框打开该资产的质量警告，然后从下拉列表中选择所需的警告。）
5. 设置可见性级别。
6. 如果需要，输入要向用户显示的消息。（在 Tableau Server 2023.3 及更低版本中，消息是必需的。）您可以使用粗体、下划线和斜体来设置消息中文本的格式，并包含链接或图像。若要查看文本格式设置提示，请单击“保存”按钮上方的信息 (i) 图标。  
    ![选择了“质量警告”选项卡的“数据标签”对话框](/tableau/next/zh-cn/online/zh-cn/Img/dm_label_data_labels_dialog_dqw.png)
7. 选择“保存”。

## 移除数据质量警告

当警告不再适用时，您可以通过导航到带有警告的数据资产来将其移除。

注意：从 Tableau Cloud 2024 年 2 月版和 Tableau Server 2024.2 开始，您可以使用合并的“数据标签”对话框添加和移除质量警告，而不是针对每种类型的标签使用单独的对话框。有关“数据标签”对话框的信息，请参见[“数据标签”对话框](https://help.tableau.com/v0.0/online/zh-cn/dm_labels.htm#data-labels-dialog)。

1. 选择数据资产旁边的操作菜单 (...)，然后选择“质量警告”。（对于 Tableau Server 2022.3 及更低版本中的列，请改为选择该列，然后单击“操作”下拉列表并选择“质量警告” 。）
2. 取消选中要从资产中移除的质量警告旁边的框。（在 Tableau Server 2023.3 及更低版本中，使用“显示警告”开关或“启用警告”复选框来关闭该资产的质量警告。）
3. 关闭警告。
4. 选择“保存”。

## 如何开启监视质量警告

您可以将 Tableau 设置为监视两个事件：数据提取数据源刷新失败和流程运行失败。发生该事件时，Tableau 将生成质量警告，该警告将显示在出现手动质量警告的同一位置。

您可以对数据提取或流程显式启用监视，或者从 Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 开始，您可以对所有数据提取刷新和流程运行失败启用站点范围的监控。有关站点范围监控的信息，请参见[站点范围内的数据提取刷新和流程运行故障监控](#sitewide_monitoring_dqw)。

若要显式监控数据提取刷新或流程运行失败：

1. 选择数据资产旁边的操作菜单 (...)，然后选择适当的选项：

- 在 Tableau Cloud 和 Tableau Server 2023.3 及更高版本中:

- “数据标签”\>“数据提取刷新监视”
- “数据标签”\>“流程运行监视”

- 在 Tableau Server 2023.1 及更低版本中：

- “质量警告”\>“数据提取刷新监视”
- “质量警告”\>“流程运行监视”

3. 启用警告。
4. 设置可见性级别。（较旧版本的对话框有一个高可见性复选框。）
5. 如果需要，输入一条消息，如果数据提取刷新或流程运行失败，用户将在警告详细信息中看到该消息。您可以使用粗体、下划线和斜体来设置消息中文本的格式，并包含链接或图像。若要查看文本格式设置提示，请单击“保存”按钮上方的信息 (i) 图标。
6. 单击“保存”。

![“流程运行监控”窗口，其中的示例消息为“此流程运行失败。请联系 Ashley Garcia。”](/tableau/next/zh-cn/online/zh-cn/Img/dm_dqw_flow_run_dialog.png)

## 如何关闭监视质量警告

若要为数据提取刷新或流程运行失败关闭监控，请执行以下操作：

1. 选择数据资产旁边的操作菜单 (...)，然后选择适当的选项：
    - 在 Tableau Cloud 和 Tableau Server 2023.3 及更高版本中:
        - “数据标签”\>“数据提取刷新监视”
        - “数据标签”\>“流程运行监视”
    - 在 Tableau Server 2023.1 及更低版本中：
        - “质量警告”\>“数据提取刷新监视”
        - “质量警告”\>“流程运行监视”
2. 关闭警告。
3. 单击“保存”。

## 站点范围内的数据提取刷新和流程运行故障监控

从 Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 开始，管理员可以打开站点范围的监视，以添加或移除针对数据提取刷新失败和流程运行失败的数据质量警告。您可以通过“设置”页面的“数据提取刷新和流程运行监控”部分控制此功能：

![数据提取刷新和流程运行监控设置](/tableau/next/zh-cn/online/zh-cn/Img/monitoring_dqw_setting.png)

默认情况下，所有新站点都会启用这些设置。更改之前存在的站点将关闭这些设置，但管理员可以将其打开。

**注意**：对于使用 Tableau Bridge 的数据提取刷新，不会显示数据质量警告通知。

### 站点范围监控与显式监控的互动

对资产的显式监控和对所有资产的站点范围监控的交互如下：

- 如果对资产显式打开监控_并_打开站点范围的监控，则资产上的显式设置优先于站点设置。设置包括可见性级别和消息等属性。
- 当您关闭站点范围监控时：
    - 显式启用监控_的_资产不会更改。
    - _未_明确启用监控的资产将停止监控数据提取刷新或流程运行失败，并且将移除以前这些资产上因数据提取刷新或流程运行失败而产生的警告。
    - 由于 Catalog 重新摄取可能不再具有警告标签的资产，Catalog 摄取性能可能会暂时降低。

站点范围监控在 Tableau Cloud 2023 年 10 月版和 Tableau Server 2023.3 中发布。早期版本中没有显式监控和站点范围监控的交互。

## 谁可以设置质量警告

若要设置数据质量警告，您必须

- 是服务器或站点管理员，或者
- 对资产具有“覆盖”能力。

## 自定义数据质量警告

从 Tableau Cloud 2023 年 6 月版和 Tableau Server 2023.3 开始，管理员可以使用“数据标签”页面上的标签管理器或 REST API 更改用户在数据质量警告对话框中看到的数据质量警告，或创建全新的警告。有关详细信息，请参见[管理数据标签](https://help.tableau.com/v0.0/online/zh-cn/dm_labels_manage.htm)。

<!-- document id=79e681c54597cf73c955fd062b458932d9ec7048a8338f45a6ffb7cb4dc86a81 url=/tableau/next/zh-cn/online/activity_log_setup.md -->

[跳转到主要内容](#main-content)

# 设置活动日志

> [!TIP]
> 
> **重要信息：**从 2026 年 3 月 16 日开始，Tableau Cloud 中的活动日志功能已迁移到 Hyperforce。迁移根据 Tableau Cloud pod 和地区分阶段进行。为了维持服务，您必须在计划的迁移日期之前和之后更改 S3、KMS 和 VPC 策略。更改包括 Hyperforce 身份和访问管理 (IAM) 角色权限。有关迁移阶段、迁移后必需操作和计划更新的详细信息，请参见 Salesforce 帮助中的[由于 Hyperforce 迁移而对 Tableau Cloud 活动日志造成的更改](https://help.salesforce.com/s/articleView?id=005232922&type=1)。

活动日志包含您的 Tableau 部署的详细事件，您可以将其用于合规性、监控和审核。您必须完成以下步骤才能使用活动日志。

### 先决条件

为了使用活动日志，您必须具有以下所有各项：

- 包含 Advanced Management 的 Tableau Cloud
- Amazon Web Services (AWS) 帐户
    
    - 您需要自己的 AWS 帐户来完成这些步骤。
    - 您还需要下面步骤 3 中的 Tableau AWS 帐号 (`061095916136`)，以便在您的 Amazon Simple Storage Service (S3) 存储桶中接收活动日志。
- 用于接收数据的 Amazon Simple Storage Service (S3) 存储桶
    
    - 在设置过程中，您将创建一个 Amazon S3 存储桶。Amazon S3 目前是唯一受支持的数据传输选项。
    - 您必须在托管 Tableau Cloud 站点中的同一 AWS 区域中创建 Amazon S3 存储桶。有关数据位置的详细信息，请参见[云中的安全性](https://help.tableau.com/v0.0/online/zh-cn/to_security.htm#data-location)和[用于数据提供程序授权的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#safelist)。
        
        **重要信息：**作为 Tableau Cloud 向 Hyperforce 迁移的一部分，欧洲 - 爱尔兰区域的 Pod 已迁移至欧洲 - 德国区域。如果您的站点位于欧洲 - 爱尔兰 pod，则需要重新配置活动日志以使用新区域欧洲 - 德国中的 AWS S3 存储桶。有关详细信息，请参见下面的[欧洲 - 爱尔兰 Pod 上站点的 AWS 区域变更](#hyperforce)。
- 您在设置期间创建的 Amazon S3 存储桶的 AWS Key Management Service (KMS) 单一区域密钥。

### 步骤 1.创建 AWS 帐户

如果您还没有 Amazon Web Services (AWS) 帐户，您可以在 AWS 网站上[注册一个 AWS 帐户](https://portal.aws.amazon.com/billing/signup?nc2=h_ct&src=header_signup&redirect_url=https%3A%2F%2Faws.amazon.com%2Fregistration-confirmation#/start/email)。

### 步骤 2.创建 Amazon S3 存储桶并设置权限

1. 创建一个 Amazon S3 存储桶来接收您的日志数据。有关详细信息，请参见 AWS 网站上的[创建存储桶](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html)。
2. 使用以下设置配置 Amazon S3 存储桶：
    
    1. 在“Object Ownership”（对象所有权）下，选择“ACLs disabled”（ACL 已禁用）（推荐）。这可确保存储桶拥有者是写入其中的所有对象的拥有者。
    2. 在“Bucket Versioning”（存储桶版本控制）下，选择“Enable”（启用）。必须启用存储桶版本控制才能复制对象。
    3. 在“Default encryption”（默认加密）下，选择“Enable”（启用）。
    4. 选择“AWS Key Management Service (SSE-KMS)”。
    5. 选择“Enter AWS KMS key ARN”（输入 AWS KMS 密钥 ARN）。
    6. 单击出现的“Create key”（创建密钥）按钮以创建新的 AWS Key Management Service (KMS) 密钥。
        
        **注意：**不支持 KMS 多区域密钥。
    7. 选择“Symmetric Key”（对称密钥）类型和“Encrypt and decrypt Key usage”（加密和解密密钥使用）。
    8. 使用别名为密钥命名，然后一直单击，直到显示“Review”（查看）页面。
    9. 将以下语句添加到密钥策略内的“Statement list”（语句列表）中，以授予 Tableau 访问权限以加密 S3 存储桶中的对象。
        
        **注意：**此语句允许 Tableau IAM 角色加密放置在 Amazon S3 存储桶中的对象。“kms:GenerateDataKey”用于生成数据密钥以加密对象副本。“kms:Encrypt”用于加密在目标 S3 存储桶中创建的对象副本。“Resource”: “\*”仅将 KMS 密钥的权限授予复制角色，不允许角色提升其权限。有关详细信息，请参见 AWS 网站上的[通过 AWS Key Management Service (SSE-KMS) 使用服务器端加密保护数据](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html)。
        
        {
        
        "Sid": "AllowTableauS3ReplicationSourceRoleToUseTheKey",
        
        "Effect": "Allow",
        
        "Principal": {
        
        "AWS": \["arn:aws:iam::061095916136:role/prod-replication-rule-role",
        
        "**HYPERFORCE-IAM-ROLE**"\]},
        
        "Action": \[
        
        "kms:GenerateDataKey",
        
        "kms:Encrypt"
        
        \],
        
        "Resource": "\*"
        
        }
        
        > [!TIP]
        > 
        > **重要信息：**为了在 Hyperforce 迁移期间维持服务，您的策略必须同时包含当前 IAM 角色和 Hyperforce IAM 角色。使用[“按区域映射的角色”](#role-mapping-by-region)表查找特定于区域的角色，然后将其添加到您的策略中，如此示例中所示。迁移完成后，您可以移除以前的角色。有关详细信息，请参见 Salesforce 帮助中的[由于 Hyperforce 迁移而对 Tableau Cloud 活动日志造成的更改](https://help.salesforce.com/s/articleView?id=005232922&type=1)。
    10. 单击“Finish”（完成）创建 KMS 密钥。
    11. 单击“Create bucket”（创建存储桶）创建 Amazon S3 存储桶。
3. 更新 Amazon S3 存储桶策略的权限。

1. 打开 Amazon S3 存储桶，并单击“Permissions”（权限）选项卡。
2. 找到“Bucket policy”（存储桶策略）部分，然后单击“Edit”（编辑）。
3. 将以下内容添加到存储桶策略的“Statement list”（语句列表）中。将 S3-BUCKET-NAME 替换为存储桶的名称。
    
    **注意：**此语句允许 Tableau IAM 角色将对象复制到存储桶中。使用“\*”和“<path> /\*”分别授予对指定存储桶中的所有前缀和存储桶中路径的访问权限。“s3:ReplicateObject”和“s3:ReplicateDelete”权限是成功复制对象和删除标记所需的最低权限。请参见 AWS 网站上的[在源存储桶和目标存储桶由不同 AWS 帐户拥有时授予权限](https://docs.aws.amazon.com/AmazonS3/latest/userguide/setting-repl-config-perm-overview.html#setting-repl-config-crossacct)。
    
    {
    
    "Sid": "TableauS3ReplicationRoleAccess",
    
    "Effect": "Allow",
    
    "Principal": {
    
    "AWS": \[
    
    "arn:aws:iam::061095916136:role/prod-replication-rule-role",
    
    "**HYPERFORCE-IAM-ROLE**"\]},
    
    "Action": \[
    
    "s3:ReplicateObject",
    
    "s3:ReplicateDelete"
    
    \],
    
    "Resource": \[
    
    "arn:aws:s3:::S3-BUCKET-NAME",
    
    "arn:aws:s3:::S3-BUCKET-NAME/\*"
    
    \]
    
    }
    
    > [!TIP]
    > 
    > **重要信息：**为了在 Hyperforce 迁移期间维持服务，您的策略必须同时包含当前 IAM 角色和 Hyperforce IAM 角色。使用[“按区域映射的角色”](#role-mapping-by-region)表查找特定于区域的角色，然后将其添加到您的策略中，如此示例中所示。迁移完成后，您可以移除以前的角色。有关详细信息，请参见 Salesforce 帮助中的[由于 Hyperforce 迁移而对 Tableau Cloud 活动日志造成的更改](https://help.salesforce.com/s/articleView?id=005232922&type=1)。
4. 可选。如果您的目标存储桶具有限制通过 Amazon Virtual Private Cloud (VPC) 端点进行访问的策略，则除了刚刚添加的 TableauS3ReplicationRoleAccess 之外，您还必须更改存储桶策略。有关详细信息，请参见 AWS 网站上的[如何限定只有特定 VPC 终端节点或 IP 地址才能访问 Amazon S3 存储桶？](https://aws.amazon.com/premiumsupport/knowledge-center/block-s3-traffic-vpc-ip/)。
    
    如果当前存储桶策略包含这样的 VPC 限制：
    
    {
    
    "Sid": "Restricted VPC Access",
    
    "Effect": "Deny",
    
    "Principal": "\*",
    
    "Action": "s3:",
    
    "Resource": \[
    
    "arn:aws:s3:::<S3-BUCKET-NAME>",
    
    "arn:aws:s3:::<S3-BUCKET-NAME>/\*"
    
    \],
    
    "Condition": {
    
    "StringNotEquals": {
    
    "aws:SourceVpc": "vpc-<ID>"
    
    }
    
    }
    
    }
    
    然后编辑“Condition”列表以包括以下内容：
    
    "StringNotLike": {
    
    "aws:userId": \["AROAQ4OMZWJUBZG3DRFW5:\*"\]
    
    }
    
    **注意：**对于 Tableau IAM 角色，您必须使用“AROAQ4OMZWJUBZG3DRFW5”RoleId。
    
    编辑后的策略应该如下所示：
    
    {
    
    "Sid": "Restricted VPC Access",
    
    "Effect": "Deny",
    
    "Principal": "\*",
    
    "Action": "s3:",
    
    "Resource": \[
    
    "arn:aws:s3:::<S3-BUCKET-NAME>",
    
    "arn:aws:s3:::<S3-BUCKET-NAME>/\*"
    
    \],
    
    "Condition": {
    
    "StringNotLike": {
    
    "aws:userId": \["AROAQ4OMZWJUBZG3DRFW5:\*"\]
    
    },
    
    "ArnNotLike": {
    
    "aws:PrincipalArn": "**HYPERFORCE-IAM-ROLE**"
    
    },
    
    "StringNotEquals": {
    
    "aws:SourceVpc": "vpc-<ID>"
    
    }
    
    }
    
    }
    
    > [!TIP]
    > 
    > **重要信息：**为了在 Hyperforce 迁移期间维持服务，您的策略必须同时包含当前 IAM 角色和 Hyperforce IAM 角色。使用[“按区域映射的角色”](#role-mapping-by-region)表查找特定于区域的角色，然后将其添加到您的策略中，如此示例中所示。迁移完成后，您可以移除以前的角色。有关详细信息，请参见 Salesforce 帮助中的[由于 Hyperforce 迁移而对 Tableau Cloud 活动日志造成的更改](https://help.salesforce.com/s/articleView?id=005232922&type=1)。
    
    此策略明确允许 Tableau IAM 角色使用 ReplicateObject 和 ReplicateDelete，并且还从现有显式 VPC 拒绝语句中排除该角色。
5. 单击“Save changes”（保存更改）。

### 按区域划分的角色映射

在配置 S3、KMS 和 VPC 策略时，使用此表查找特定于区域的角色。

<table style="width: 100%;" class="simple-table"><colgroup><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"><col style="width: 16%;"></colgroup><tbody><tr><th colspan="2">地点</th><td><b>Hyperforce 区域</b></td><td style="font-weight: bold;">Pod（<b>Pod 名称</b>）</td><td><b>Hyperforce IAM 角色</b></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="6">亚太地区</td><td><p>澳大利亚</p></td><td><p>ap-southeast-2</p></td><td><p>prod-apsoutheast-a</p></td><td><p>arn:aws:iam::667498515984:role/prod-replication-rule-role</p></td></tr><tr><td>印度</td><td>ap-south-2</td><td>prod-in-a</td><td>arn:aws:iam::119877853097:role/prod-replication-rule-role</td></tr><tr><td><p>印度尼西亚</p></td><td><p>ap-southeast-3</p></td><td><p>prod-apsoutheast-c</p></td><td><p>arn:aws:iam::892386869973:role/prod-replication-rule-role</p></td></tr><tr><td><p>日本</p></td><td><p>ap-northeast-1</p></td><td><p>prod-apnortheast-a</p></td><td><p>arn:aws:iam::349070092441:role/prod-replication-rule-role</p></td></tr><tr><td><p>新加坡</p></td><td><p>ap-southeast-1</p></td><td><p>prod-apsoutheast-b</p></td><td><p>arn:aws:iam::005102551263:role/prod-replication-rule-role</p></td></tr><tr><td>韩国</td><td>ap-northeast-2</td><td>prod-kr-a</td><td>arn:aws:iam::943538517075:role/prod-replication-rule-role</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;">加拿大</td><td><p>魁北克</p></td><td><p>ca-central-1</p></td><td><p>prod-ca-a</p></td><td><p>arn:aws:iam::075540750887:role/prod-replication-rule-role</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">欧洲</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">德国</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">eu-central-1</td><td><p>dub01 (DUB01)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="2">arn:aws:iam::337853574888:role/prod-replication-rule-role</td></tr><tr><td><p>eu-west-1a (EW1A)</p></td></tr><tr><td>瑞士</td><td>eu-central-2</td><td>prod-ch-a</td><td>arn:aws:iam::623102672691:role/prod-replication-rule-role</td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="1">英国</td><td><p>eu-west-2</p></td><td><p>prod-uk-a</p></td><td><p>arn:aws:iam::112108976196:role/prod-replication-rule-role</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">美国 - 西部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">俄勒冈州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">us-west-2</td><td><p>10ax (10AX)</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="5">arn:aws:iam::675003682462:role/prod-replication-rule-role</td></tr><tr><td><p>10ay (10AY)</p></td></tr><tr><td><p>10az (10AZ)</p></td></tr><tr><td><p>uw2b (UW2B)</p></td></tr><tr><td><p>prod-uswest-c</p></td></tr><tr><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">美国 - 东部</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">弗吉尼亚州</td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">us-east-1</td><td><p>prod-useast-a</p></td><td style="vertical-align: middle;padding-left: 6px;padding-right: 6px;padding-top: 6px;padding-bottom: 6px;border-left-style: solid;border-left-width: 1px;border-left-color: #bbb;border-right-style: solid;border-right-width: 1px;border-right-color: #bbb;border-top-style: solid;border-top-width: 1px;border-top-color: #bbb;border-bottom-style: solid;border-bottom-width: 1px;border-bottom-color: #bbb;" rowspan="4">arn:aws:iam::792479604904:role/prod-replication-rule-role</td></tr><tr><td><p>prod-useast-b</p></td></tr><tr><td><p>us-east-1 (useast-1)</p></td></tr><tr><td><p>prod-useast-c</p></td></tr></tbody></table>

### 步骤 3.配置 Tableau Cloud

1. 导航到您的 Tableau 站点。
2. 在“设置”页面上，选择“集成”选项卡。
3. 在“活动日志”部分，选择“启用”按钮。
4. 在“设置连接”对话框中输入以下信息：
    
    1. 在“AWS 帐号”框中，输入 12 位的 AWS 帐号。这是与您的 Amazon S3 存储桶位置关联的 AWS 帐号。
    2. 在“S3 存储桶名称”框中，输入将在其中传送活动日志文件的 Amazon S3 存储桶的名称。这是您在[步骤 2.创建 Amazon S3 存储桶并设置权限](#Step2CreateS3Bucket)中创建的 Amazon S3 存储桶。这必须是根据 AWS 存储桶名称要求有效的名称。
    3. 在“KMS 密钥 ARN”框中，输入您在[步骤 2.创建 Amazon S3 存储桶并设置权限](#Step2CreateS3Bucket)中创建的 KMS 密钥 Amazon 资源名称 (ARN)。ARN 中的帐号必须与提供的 AWS 帐号匹配，并且格式有效（即 arn:aws:kms:_<区域>_:_<帐户 id>_:key/_<密钥 id>_）。
5. 单击“提交”。
    
    当系统尝试将文本文件复制到目标 Amazon S3 存储桶以测试连接时，连接状态列将显示“正在进行”。
    
    文件成功复制到目标 Amazon S3 存储桶后，连接状态列将显示“待验证”，并显示一个小部件以输入“测试文件内容”。您可能需要刷新页面才能看到更新。

### 验证安全文件复制

1. 转到目标 Amazon S3 存储桶并找到以 siteLuid 开头的文件夹（名称的其余部分是站点的唯一标识符）。
2. 找到名为 `SECURITY_VERIFICATION_FILE.txt` 的文本文件。
3. 下载并打开该文本文件。
4. 将文本内容复制到文件中：
5. 返回“设置”页面，将文本内容粘贴到“文本文件内容”输入字段中，然后单击“提交”。
6. 如果提交的内容正确，则连接状态变为“活动”。活动日志现已启用，数据将开始复制到目标 Amazon S3 存储桶。
7. 如果提交的内容不正确，将显示错误消息。检查内容是否正确复制，没有多余的字符或空格。

### 疑难解答

#### 没有出现安全验证文件？

- 由于 Amazon S3 的限制，该文件最多可能需要 15 分钟才能出现在目标 Amazon S3 存储桶中。
    
    如果连接状态显示“正在进行”，则文件仍在尝试复制。有关详细信息，请参见 AWS 网站上的[复制疑难解答](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-troubleshoot.html)。
- 连接状态“失败”意味着文件无法成功复制。
    
    确认 Amazon S3 存储桶策略和 AWS Key Management Service (KMS) 密钥策略的权限包含适当的语句。有关详细信息，请参见 AWS 网站上的以下主题：
    
    - [复制疑难解答](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-troubleshoot.html)
    - [当源存储桶和目标存储桶由不同帐户拥有时配置复制](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-walkthrough-2.html)
    - [我在我的存储桶之间设置了复制，但新对象没有复制。我该如何解决这个问题？](https://help.tableau.com/v0.0/online/zh-cn/%3Chttps://aws.amazon.com/premiumsupport/knowledge-center/s3-troubleshoot-replication/#:~:text=To troubleshoot objects that aren,object to the source bucket.>)

#### 日志文件到达 Amazon S3 存储桶所需的其他设置

- Amazon S3 存储桶启用了“存储桶版本控制”（在“属性”\>“存储桶版本控制”下）。
- Amazon S3 存储桶已启用“阻止所有公共访问” （在“权限”\>“阻止公共访问（存储桶设置）”下）。
- Amazon S3 存储桶仅对“存储桶所有者”具有以下 ACL 权限（在“权限”\>“访问控制列表 (ACL)”下）：
    
    - 对象：列出、写入
    - 存储桶 ACL：读取、写入
- KMS 密钥权限策略包含[步骤 2.创建 Amazon S3 存储桶并设置权限](#Step2CreateS3Bucket)中的语句，步骤 2. i.（在“属性”\>“默认加密”下，单击“AWS KMS 密钥 ARN”下的 ARN 以转到 KMS 密钥策略）。
- Amazon S3 存储桶启用了默认加密并启用了存储桶密钥（在“属性”>“默认加密”下）。
- Amazon S3 存储桶权限策略（在“权限” >“存储桶策略”下）与说明中的完全匹配。确保您已将示例值“S3-BUCKET-NAME”替换为您刚刚创建的 Amazon S3 存储桶。

#### 欧洲 - 爱尔兰 Pod 上站点的 AWS 区域变更

在 2024 年 8 月到 2025 年 3 月之间，Tableau Cloud 站点已迁移到 Salesforce 的[Hyperforce](https://help.salesforce.com/s/articleView?id=000388902&type=1)。作为迁移的一部分， 爱尔兰区域的 pod 已迁移到德国区域。如果您的站点位于爱尔兰区域的 pod 上，则需要重新配置活动日志以使用新区域德国中的 AWS S3 存储桶。

<!-- document id=9641602e71c27b39cc52af4c4d688d879fac4104c52fedc67ec9ea31ce0bf557 url=/tableau/next/zh-cn/online/users_site_roles.md -->

[跳转到主要内容](#main-content)

# 设置用户的站点角色

在 Tableau Cloud 上向站点中添加用户时，不管用户的许可证类型如何，您都必须向他们应用一个_站点角色_。站点角色代表了一个用户可在站点上享有的最大访问权限级别。连同内容权限一起，站点角色确定谁可以发布内容、与内容进行交互或仅查看已发布的内容，或者谁可以管理站点的用户和管理站点本身。

## 用户许可证、站点角色和内容权限如何协同工作

用户的许可证类型、站点角色和内容权限的交集确定用户在 Tableau 站点上具有的访问级别。

1. 许可证类型与用户关联。要分配给用户的站点角色确定他们将需要的许可证类型。
    
    如果用户是多个 Tableau Cloud 站点的成员，则他们必须拥有其所属每个站点的许可证。
2. 站点角色也在用户级别设置。如果用户是多个 Tableau Cloud 站点的成员，他们将拥有独立的站点角色。例如，同一用户可在一个站点上具有站点管理员 “Creator”站点角色，并在另一个站点上具有“Viewer（查看者）”站点角色。
    
    站点角色定义用户可以拥有的最大能力。
3. 用户是否能够拥有站点角色的最大能力取决于内容资源（项目、数据源、工作簿）上设置的权限。

例如，假设用户在站点上具有以下访问权限：

- “Creator”许可证
- “Explorer”站点角色
- 项目的“保存”权限能力

在这种情况下，许可证允许在 Web 编辑环境或 Tableau Desktop 中连接和创建新数据源，并且权限规则允许它们保存在项目中。但是，他们的站点角色会阻止他们进行保存，因此他们的有效权限不包括保存能力。因此，用户无法将内容发布到站点。

即使用户具有 Creator 许可证和 Creator 站点角色，如果他们在至少一个项目上没有保存能力，则无法将任何内容发布到站点。

有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

## 更改用户的站点角色

1. 以站点管理员身份登录站点并转到“用户”区域。
2. 选择用户，然后选择“动作”\>“站点角色”。
    
    ![带有打开的下拉菜单的站点用户表，其中显示了移除用户的选项。](/tableau/next/zh-cn/online/zh-cn/Img/users_siterole_change.png)
3. 选择新站点角色，然后单击“更改站点角色”。
    
    ![选择新的站点角色。](/tableau/next/zh-cn/online/zh-cn/Img/users_siterole_change_select_new.png)
    
    您可以将指针悬停在信息图标上以显示一个矩阵，该矩阵显示每个站点角色允许的一般功能的最大级别。有关详细信息，请继续阅读[允许每个站点角色所具有的一般能力](#site-role-capabilities-summary)。

## 允许每个站点角色所具有的一般能力

**注意：**此信息侧重于_站点_角色，并且更加泛化。有关每个_许可证_角色的可用常见具体任务的列表，请参见 Tableau 定价页面上[“团队和组织定价”](https://www.tableau.com/zh-cn/pricing/teams-orgs "在新浏览器窗口中打开适用于基于订阅的许可的 Tableau 定价页面")选项卡上的表格。

### Tableau 站点角色

<table class="simple-table" style="width: 100%;"><colgroup><col style="width:35%"><col style="width:65%"></colgroup><thead><tr><th style="background-color:#ccc;">站点角色名称</th><th style="background-color:#ccc;">此站点角色允许的最大能力</th></tr></thead><tbody><tr><td colspan="2" style="background-color: #eaeaea;"><p><strong>不使用许可证的租户角色</strong></p></td></tr><tr><td colspan="2">— 具有此角色的用户可以访问 Tableau Cloud Manager。</td></tr><tr><td>云管理员</td><td><p>仅在 Tableau Cloud Manager 上可用；不可在 Tableau Cloud 站点上分配。</p><p>此角色是 Tableau Cloud 中最高级别的管理角色，可以在租户级别创建站点、管理用户以及在整个组织内分配许可证。</p><p>云管理员不消耗许可证，只能访问 Tableau Cloud Manager。为了获得站点访问权限，云管理员可以通过 Tableau Cloud Manager 为自己分配站点角色，从而获得对租户内任何站点的访问权限。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_intro.htm" class="xref">使用 Tableau Cloud Manager</a>。</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p><strong>使用 <span class="mc-variable Variables.sku-creator variable">Creator</span> 许可证的站点角色</strong></p></th></tr><tr><td colspan="2"><p>— 具有这些站点角色的用户能够访问诸如 Tableau Prep、<span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span>、Tableau Bridge 和 Tableau Mobile 等 Tableau 客户端。</p></td></tr><tr><td><p><span class="mc-variable Variables.siterole-siteadmin-author variable">站点管理员 Creator</span></p></td><td><p>这是 Tableau Cloud 站点的最高级别访问权限。</p><p>不受限制地访问上述内容（但在站点级别）。在浏览器、<span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 或 Tableau Prep 中连接到 Tableau 或外部数据；构建和发布内容。</p><p>在 Tableau Server 上，服务器管理员可以确定是否允许站点管理员管理用户并分配站点角色和站点成员身份。默认情况下，在 Tableau Server 上，允许站点管理员具有这些能力，并且始终在 Tableau Cloud 上允许站点管理员具有这些能力。</p></td></tr><tr><td><p><span class="mc-variable Variables.siterole-author variable">Creator</span></p></td><td><p>这类似于以前的“发布者”站点角色，但允许新功能。此站点角色为非管理员提供最高级别的<em>内容</em>访问权限。</p><p>在浏览器中连接到 Tableau 或外部数据、构建和发布流程、数据源及工作簿、访问仪表板起始模板，并在发布的视图上使用交互功能。还可以从 Tableau Prep 或 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 中连接到数据、发布（上载/保存）和下载流程、工作簿及数据源。</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p>使用 <span class="mc-variable Variables.sku-explorer variable">Explorer</span> 许可证的站点角色</p></th></tr><tr><td colspan="2"><p>具有这些站点角色的用户可从浏览器或 Tableau Mobile 中访问服务器。</p></td></tr><tr><td><p>站点管理员 Explorer</p></td><td><p>与站点管理员 Creator 具有相同的站点和用户配置访问权限，但无法从 Web 编辑环境中连接到外部数据或虚拟连接。</p><p>可连接到 Tableau 已发布数据源来创建新工作簿，以及编辑和保存现有工作簿。无法编辑和保存现有流程。无法发布 Tableau Prep 流程。</p></td></tr><tr><td><p>Explorer（可发布）</p></td><td><p>可以使用现有数据源从 Tableau Desktop 中发布新内容、浏览发布的视图并与之交互，以及使用所有交互功能。</p><p>在 Web 编辑环境中，可以编辑和保存现有工作簿。可以运行 Tableau Prep 流程（如果被授予<span class="uicontrol">“运行流程”</span>权限）。无法通过工作簿中嵌入的数据连接保存新的独立数据源，并且无法连接到外部数据或虚拟连接，或创建新的数据源。无法编辑和保存现有流程。无法发布 Tableau Prep 流程。</p></td></tr><tr><td><p>Explorer</p></td><td><p>可浏览发布的视图并与之交互。可订阅内容、创建数据驱动型通知、连接到 Tableau 已发布数据源并在 Web 制作环境中打开工作簿以进行临时查询，但无法保存其工作。无法连接到虚拟连接。无法编辑和保存现有流程。无法发布或运行 Tableau Prep 流程。</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p><a name="viewer"></a>使用“Viewer（查看者）”许可证的站点角色</p></th></tr><tr><td><p>Viewer（查看者）</p></td><td><p>可查看其他人创建的已发布视图，并可使用大多数交互功能。可以订阅视图并以图像或摘要数据形式下载。无法连接到数据；创建、编辑或发布内容；或设置数据通知。</p><p>有关特定能力的列表，请参见 <a alt="Link opens the Tableau license pricing page in a new browser tab" href="https://www.tableau.com/zh-cn/pricing/teams-orgs" target="_blank" title="链接将在新浏览器标签页中打开 Tableau 许可证定价页面">Tableau 定价页面</a>上的表格中的“<strong>Viewer</strong>（查看者）”列。</p><p><strong>注意：</strong>尽管以前的版本中存在“Viewer（查看者）”站点角色，但新的“Viewer（查看者）”站点角色具有额外的能力。</p></td></tr><tr><th colspan="2" style="background-color:#eaeaea;"><p>其他站点角色</p></th></tr><tr><td><p>未许可</p></td><td><p>“未许可”用户无法登录到 Tableau Server 或 Tableau Cloud。在以下情况下，会为用户分配“未许可”角色：</p><ul><li><p>您从 CSV 文件导入用户，并且这些用户的许可级别设置为未许可。</p></li><li><p>在添加或导入用户时达到了可用许可证的数量。</p></li><li><p>您删除了拥有站点内容的用户。用户将仍然拥有该内容，但无法对其进行任何操作。</p></li></ul><p></p></td></tr></tbody></table>

## 谁能够发布内容

以下站点角色允许指定级别的发布访问权限。

- 站点管理员 Creator 和 Creator 允许完全连接和发布访问权限。
    
    这包括从 Tableau Desktop 和 Web 编辑环境中连接到数据以及发布新流程、新工作簿和新数据源。这些站点角色还允许编辑和保存现有已发布工作簿，或者将更新发布到现有数据源。
- “Explorer（可发布）”和“站点管理员 Explorer”具有受限的发布能力，如[允许每个站点角色所具有的一般能力](#site-role-capabilities-summary)中所述。
- “Explorer”、“Viewer（查看者）”、“只读”和“未许可”不允许发布。

<!-- document id=84c9d48063fe069e9612dd9963cee86548451303a07f6aa15235713eae1899c9 url=/tableau/next/zh-cn/online/users_set_auth_type.md -->

[跳转到主要内容](#main-content)

# 设置用户身份验证类型

在 Google、OIDC、Salesforce 或启用 SAML 的站点上或 Tableau Cloud Manager (TCM) 租户上，站点或云管理员可以指定用户的身份验证方法。例如，哪些用户可以使用其单点登录 (SSO) 凭据访问 Tableau Cloud 或 TCM。

可以在向 Tableau Cloud 添加用户时分配身份验证方法，也可以在之后的任何时间这样做。

**对于 Tableau Cloud**

1. 在登录 Tableau Cloud 站点时，选择**“用户”**。
2. 在“站点用户”页面上，选中要向其分配身份验证类型的用户旁边的复选框。
3. 在“操作”菜单上，选择“身份验证”。
    
    ![带有身份验证选项的操作菜单。](/tableau/next/zh-cn/online/zh-cn/Img/users_set_authentication.png)
4. 在“身份验证”对话框中，选择身份验证方法或“带有 MFA 的 Tableau”。

**对于 TCM**

1. 在登录 TCM 时，选择**“用户”**。
2. 在“用户”页面上，选择页面左侧的筛选器图标，然后选中“仅显示云管理员”复选框。
3. 选中您想要分配或更改其身份验证类型的用户旁边的复选框。
4. 在“操作”菜单上，选择“站点成员身份”。
5. 在“站点成员身份”对话框的“Tableau Cloud Manager 的身份验证”下拉菜单中，选择身份验证方法或“带有 MFA 的 Tableau”。

## 说明

- 在 Tableau Cloud 中，如果站点的身份验证发生变化，则当为用户分配该身份验证方法时，您会在“用户”页面的“身份验证”列中看到一个警告符号。从 2025 年 1 月 (Tableau 2024.3) 开始，如果为用户分配了配置已被删除的身份验证方法，您将在该用户的“身份验证”列中看到“未定义”。
    
    **注意：**当使用 Tableau REST API 向用户分配身份验证方法时，如果使用 `authSetting` 属性而不是 `idpConfigurationId` 属性，也可能会看到“未定义”。有关详细信息，请参见 Tableau REST API 帮助中的[将用户添加到站点](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_users_and_groups.htm#add_user_to_site)和[更新用户](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_users_and_groups.htm#update_user)方法。
- 如果将用户的身份验证从“带有 MFA 的 Tableau”更改为“Google”，则下次用户登录时，用户将被带到您的身份提供程序的站点以提供其凭据。
- 如果用户使用其外部 IdP 凭据进行登录，而且您将其身份验证类型更改为“带有 MFA 的 Tableau”，那么，如果用户当前没有 Tableau 凭据，则用户会收到 Tableau 发送的电子邮件，其中说明了如何创建新的 Tableau 凭据。
- Tableau 建议您专门指定一个始终为“带有 MFA 的 Tableau”身份验证配置的站点管理员或云管理员帐户。如果 IdP 出现问题，则专用的 Tableau 帐户可确保您始终能够访问站点或租户。
- 有关“带有 MFA 的 Tableau”身份验证选项的的详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。

<!-- document id=59404aa5abdae466851e8120a032b986371ea9199af99236d57c923b016dad62 url=/tableau/next/zh-cn/online/to_sync_schedule.md -->

[跳转到主要内容](#main-content)

# 设置私有网络刷新计划

本主题介绍 Tableau 数据源所有者如何为连接到私有网络数据的数据源设置和更新刷新计划。连接到私有网络数据的数据源的刷新计划依赖于 Tableau Bridge。本主题中描述的任务假定 Bridge 已设置，并且由站点管理员维护。会记录异常。

本主题不包括为虚拟连接设置刷新计划。有关虚拟连接的详细信息，请参见[为虚拟连接计划数据提取刷新](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_extract.htm)。

**注意：**

- Bridge 支持使工作簿中嵌入的数据源的数据保持最新。请参见[使用嵌入式数据源](https://help.tableau.com/current/online/zh-cn/to_bridge_eds.htm)。
- 若要为基于私有云的数据源设置和配置刷新计划，请参见[连接到私有云数据](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_vpc.htm)。

## Bridge 刷新计划与 Bridge 旧版计划

对于设置为使用数据提取连接的数据源，Bridge 使用刷新计划来使数据保持最新。

您可以配置两种类型的刷新计划以供 Bridge 使用： 

- Bridge 刷新计划
- Bridge 旧版计划：为了让客户有更多时间从旧版计划迁移，Bridge 旧版计划的弃用已推迟到 2025.2 版本。在此之前，Tableau 将继续支持旧版计划。有关如何迁移到 Bridge 刷新计划的详细信息，请参见下面的[从 Bridge 旧版计划迁移到 Bridge 刷新计划](#migrate)部分。  
    **注意：**Bridge 旧版计划不支持虚拟连接的刷新。

您使用的计划取决于许多因素，其中包括创建原始计划的版本以及数据源连接到的基础数据类型。总之，Bridge 刷新计划设计为将客户端管理任务留给站点管理员，并使您能够直接在 Tableau Cloud 上执行所有数据源管理任务。

#### 版本

从 Bridge 2021.4.3 开始，基于文件的已发布数据源的数据提取刷新可以使用 Bridge 刷新计划。基于文件的数据源的 Bridge 刷新计划要求站点管理员至少设置一个 Bridge 2021.4.3（或更高版本）客户端并将其添加到客户端池。

从 Bridge 2024.2.1 开始，基于文件的嵌入式数据源的数据提取刷新可以使用 Bridge 刷新计划。基于文件的嵌入式数据源的 Bridge 刷新计划要求站点管理员至少设置一个 Bridge 2024.2.1（或更高版本）客户端并将其添加到指定池。

默认情况下，为在 Bridge 2021.4.3 之前创建的基于文件的数据源创建的计划使用 Bridge 旧版计划。Bridge 旧版计划可以转换为 Bridge 刷新计划。

### 比较计划

下表描述了 Bridge 刷新计划和 Bridge 旧版计划之间的差异。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">&nbsp;</td><th style="font-weight: bold;">Bridge 刷新计划</th><th style="font-weight: bold;">Bridge 旧版计划</th></tr><tr><td><strong>支持的数据类型</strong></td><td><p>关系数据</p><p>文件数据</p><p>本地数据</p><p>私有云数据</p></td><td><p>关系数据</p><p>文件数据</p><p>本地数据</p></td></tr><tr><td><strong>支持的查询类型</strong></td><td><p>已发布数据源</p><p>实时和数据提取</p><p>嵌入式数据源</p><p>虚拟连接</p><p>增量刷新</p></td><td><p>已发布数据源</p><p>实时和数据提取</p></td></tr><tr><td><strong>计划管理</strong></td><td><p>“数据源”页面</p><p>工作簿（仅限实时连接）</p><p>分布式计划管理</p><p>与 Tableau Cloud 计划集成，实现更多控制和共享可见性</p></td><td><p>“数据源”页面</p><p>仅登录 Bridge 客户端的用户可访问</p></td></tr><tr><td><strong>附加功能支持</strong></td><td><p>支持池化负载平衡工作负载</p><p>可用的监控：<a href="https://help.tableau.com/current/online/zh-cn/server_backgrounder_job_management.htm" target="_blank">作业</a>、<a href="https://help.tableau.com/current/online/zh-cn/adminview_insights.htm" target="_blank">在线管理见解</a>和<a href="https://help.tableau.com/current/online/zh-cn/adminview_backgrnd.htm">管理视图</a>。</p><p>REST API：<a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref.htm#run_extract_refresh_task" target="_blank">立即运行数据提取刷新</a></p><p>REST API：<a href="https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_data_source_now" target="_blank">立即更新数据源</a></p></td><td>不支持</td></tr></tbody></table>

## 管理计划

尽管计划任务完全相同，但有两个主要入口点用于为连接到私有网络数据的数据源设置 Bridge 刷新计划。第一个入口点是数据源发布过程中（通过 Tableau Desktop）。第二个入口点是数据源发布过程之后的任何时间。

### 设置计划

大多数情况下，您将在从 Tableau Desktop 中发布数据源时设置一个计划。

**注意**：已发布数据源的计划数据提取不支持多个池。当单个数据源连接到位于两个或多个网络位置的数据源时，可能需要多个池。

1. 在 Tableau Desktop 中，创建数据源。
2. 选择“服务器”\>“发布数据源”以开始发布过程。如果您尚未登录到 Tableau Cloud，系统将提示您登录。
3. 在“将数据源发布到 Tableau Cloud”对话框中，配置各种数据源选项，然后单击“发布”按钮。这将打开一个浏览器窗口，并显示 Tableau Cloud。
    
    **注意**：根据数据源连接到的数据或者您配置数据源的配置方式，该对话框可以默认发布数据提取，或为您提供发布数据提取的选项。如果提供了选项，请选择发布数据提取的选项。
4. 在“发布完成”对话框中，单击“计划数据提取刷新”按钮。
    
    ![对话框确认数据发布成功并提示您计划数据提取刷新。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_online_publish_done_schedule.png)
5. 在“创建数据提取刷新”对话框中，为刷新配置一个计划。有关如何配置计划的详细信息，请参见[在 Tableau Cloud 上计划刷新](https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm)
    
    ![创建数据提取对话框，其中包含选择刷新类型、频率和时区的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_integ.png)
6. 单击“创建”按钮。

### 添加或更新现有计划

无论出于何种原因，您都无法在数据源发布过程中计划刷新，您可以在之后随时添加新计划或更新计划。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 从数据源页面中，单击“数据提取刷新”选项卡。
3. 执行以下操作之一：
    
    1. 若要设置新的计划，请单击“新建数据提取刷新”按钮，然后为您的刷新配置一个计划。
    2. 若要更新现有计划，请选中计划旁边的复选框，单击“操作”菜单，然后选择“更改频率”为刷新重新配置计划。
4. 单击“创建”按钮。

### 更改刷新连接类型

默认情况下，当已发布数据源至少具有一个公共云和一个本地连接时，Tableau Cloud 使用 Bridge。

有关如何编辑连接类型的详细信息，请参见[更改刷新的连接类型以使用 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_sync_signout_unlink.htm#use_cloud)。

## 替代方法：管理 Bridge 旧版计划

（可选）您可以使用 Bridge 旧版计划来使数据保持最新。

**注意：**

- **重要信息：**版本 2025.2 中将移除对 Bridge 旧版计划的支持。为确保顺利过渡，我们建议您使用 Bridge 刷新计划。有关详细信息，请参见[从 Bridge 旧版计划迁移到 Bridge 刷新计划](#migrate)。
- Bridge 刷新计划具有更大的灵活性，支持更多的数据源类型，并提供更简单的 Tableau Bridge 管理。
- 只有当您通过 Bridge 客户端在连接中嵌入数据库凭据时，Bridge 旧版计划才能成功完成。有关详细信息，请参见[嵌入或更新数据库凭据](https://help.tableau.com/v0.0/online/zh-cn/to_sync_client_settings.htm#embed-credentials)。
- 使用 Bridge 旧版计划时，客户端上显示的时间和 Tableau Cloud 上显示的时间对应于运行客户端的计算机的时区。

### 从 Bridge 旧版计划迁移到 Bridge 刷新计划

在 Bridge 2021.4.3 之前创建的基于文件的数据源的刷新计划默认使用 Bridge 旧版计划。您可以迁移 Bridge 旧版计划以使用 Bridge 刷新计划来使数据保持最新。Bridge 刷新计划在站点管理员管理的 Bridge 客户端上运行，并利用可用 Bridge 客户端池来执行刷新。

1. 确保您的命名池至少分配有一个客户端。池用于在可用客户端之间分摊（或平衡）数据新鲜度任务的负载。池还使您能够让客户端专门保持特定数据的最新状态并集中维护安全性。
2. 在该池中，提供您想要代表 Tableau Cloud 让 Bridge 访问的私有网络位置的域。有关详细信息，请参见[配置池化](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm#configure-pooling)。
3. 验证客户端是否配置为在服务模式（而不是应用程序模式）下运行。（更多信息： [Linux](https://help.tableau.com/current/online/zh-cn/to_bridge_linux_install.htm#troubleshooting) | [Windows](https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm#application--versus-service-mode) ）。
4. 在旧版计划中，转到已发布的数据源并单击“数据提取刷新”选项卡以显示“Bridge（旧版）计划”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_legacy_convert.png)
5. 使用操作菜单删除所有旧版计划。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_extract_legacy.png)
6. 在“连接”选项卡上，单击“编辑连接” ，然后输入该连接的用户名和密码。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_edit_conn_legacy.png)
7. 对于所有已发布数据源，必须选择“连接中的嵌入式密码”和“私有网络”。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_embed_legacy.png)
8. 在“数据提取刷新”选项卡上，单击“新建数据提取刷新”以计划命名池的刷新。
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/bridge_new_legacy.png)
9. 单击“创建”以添加替换计划刷新。新计划列为“计划”而不是“Bridge 旧版计划”。
10. 对您站点上运行的任何 Bridge 旧版计划继续此过程。您可以通过登录客户端计算机上的 Bridge 客户端来查找所有当前 Bridge 旧版计划的列表。所有活动的 Bridge 旧版计划都将显示在客户端上。

### 设置 Bridge 旧版计划

**重要信息：**版本 2025.2 中将移除对 Bridge 旧版计划的支持。为确保顺利过渡，我们建议您使用 Bridge 刷新计划。有关详细信息，请参见[从 Bridge 旧版计划迁移到 Bridge 刷新计划](#migrate)。

就像 Bridge 刷新计划工作流一样，在大多数情况下，您将在从 Tableau Desktop 发布数据源时设置 Bridge 旧版计划。

1. 在 Tableau Desktop 中，创建数据源。
2. 选择“服务器”\>“发布数据源”以开始发布过程。如果您尚未登录到 Tableau Cloud，系统将提示您登录。
3. 在“将数据源发布到 Tableau Cloud”对话框中，配置各种数据源选项，然后单击“发布”按钮。这将打开一个浏览器窗口，并显示 Tableau Cloud。
4. 在“发布完成”对话框中，单击“计划数据提取刷新”按钮。将显示“创建数据提取刷新”对话框，您将在对话框中配置 Bridge 旧版计划。
5. 在“创建数据提取刷新”对话框中，按照每个步骤配置计划。
    
    ![Tableau Bridge 下拉菜单，其中包含使用 Bridge 进行计划的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_leg_moved.png)
    
    **注意：** 
    
    - **若要在选定日期的特定时间段内刷新：**选择“每小时”，使用“从”和“到”下拉列表指定一天中的时间范围，然后选择一周中的天数。
        
        若要在服务器上优化性能，请刷新分布在所指定一天中的时间中一系列最多五分钟时间段内的任务。举例来说，如果设置小时计划，则设置为在 1:00 AM 运行的事件可能在 1:00 和 1:05 AM 之间的任何时间运行。
    - **完全刷新或增量刷新：**如果可用，请指定需要完全刷新还是增量刷新。默认情况下，Tableau Cloud 运行完全刷新。仅当在发布之前在 Tableau Desktop 中为增量刷新配置了数据源时，增量刷新才可用。有关信息，请参见 Tableau 帮助中的[刷新数据提取](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm)。
6. 单击“创建”按钮。

### 添加新的或更新现有 Bridge 旧版计划

**重要信息：**版本 2025.2 中将移除对 Bridge 旧版计划的支持。为确保顺利过渡，我们建议您使用 Bridge 刷新计划。有关详细信息，请参见[从 Bridge 旧版计划迁移到 Bridge 刷新计划](#migrate)。

如果在数据源发布过程中无法计划刷新，则可以在之后随时添加新的或更新 Bridge 旧版计划。新建（对于已迁移的站点）

1. 登录到 Tableau Cloud，并导航到数据源。
2. 从数据源页面中，单击“数据提取刷新”选项卡。
3. 执行以下操作之一：
    
    1. 若要设置新的 Bridge 旧版计划，请在数据源的操作菜单中选择“使用 Bridge 旧版进行计划”，配置计划，然后单击“计划刷新”按钮。
        
        ![下拉菜单列出了 Neil 拥有的产品的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_leg_menu.png)
    2. 若要更新现有 Bridge 旧版计划，请选中计划旁边的复选框，单击数据源操作菜单，然后选择“更改计划”。在此工作簿中，无法更改执行刷新的客户端。如果需要更改执行刷新的客户端，请参见[更改执行 Bridge 旧版计划的客户端](#change-computer)。完成后，单击“更改计划”按钮。

### 其他 Bridge 旧版计划管理任务

#### 通过客户端添加新的或更新现有计划

如果您（不是站点管理员）要管理“指定”客户端，则可以直接通过 Bridge 客户端添加新的或更新现有 Bridge 旧版计划。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 将光标悬停在数据源上，并单击“计划”图标。这将打开一个浏览器窗口，并显示 Tableau Cloud 中的数据源页面。
3. 重复上面的[添加新的或更新现有 Bridge 旧版计划](#Add)部分的步骤 2-3 以设置计划。

#### 添加新计算机（客户端）来执行计划的刷新

在计划过程中，您必须在计划对话框中指定计算机。您指定的计算机是执行刷新的 Bridge 客户端。

Bridge 旧版计划显示您登录到的客户端。

![Tableau Bridge 使用下拉菜单刷新数据源，以选择网络上安装了 Bridge 客户端的计算机。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_schedule_leg_client.png)

如果要选择的客户端在下拉列表中不可用，可能是以下几个原因之一造成的： 

- 您尚未登录到客户端。
- 客户端未正确注册或连接到站点。转到并打开客户端，并确保其状态为绿色或“已连接”。
- 您的站点管理员管理组织中的所有客户端。使用 Bridge 旧版计划时，数据源所有者和登录到客户端的用户必须相同。如果您的站点管理员已登录到客户端，则其必须将数据源的所有权重新分配给自己才能计划刷新。

#### 取消正在进行的刷新

在某些情况下，您可能需要取消正在进行的刷新。您可以取消仅使用 Bridge 旧版计划的数据源的刷新。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。
2. 单击“取消刷新”按钮。此操作将取消正在进行的刷新。
    
    ![包含站点、订单和模式选项的 Tableau Bridge 窗口。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_cancelrefresh.png)

**注意：**客户端一次可执行一个 Bridge 旧版刷新。如果需要同时刷新多个 Bridge 旧版刷新，请与站点管理员讨论有关在不同计算机上设置其他客户端来执行数据提取刷新的事宜。

#### 更改执行 Bridge 旧版计划的客户端

如果您正在使用 Bridge 旧版计划，并且想要更改位置或执行刷新的计算机，则必须设置新的刷新计划。只能使用您登录到的客户端来计划刷新。

若要设置新的 Bridge 旧版计划，请参见[设置 Bridge 旧版计划](#Set)。设置完新的刷新计划后，请确保删除与新计划相同的上一个计划。

**重要信息：**如果数据源需要数据库凭据来访问基础数据，您还必须返回到客户端，并编辑连接信息以重新嵌入数据库凭据。您可以使用客户端中的“测试连接”选项来检查数据源是否能访问基础数据。

#### 从站点中移除客户端

更改执行 Bridge 旧版计划的客户端后，请考虑从站点中永久移除客户端（如果该客户端不再用于任何其他数据新鲜度任务）。

1. 登录到 Tableau Cloud。
2. 在浏览器的右上角，单击个人资料图像或姓名首字母缩写，并选择“我的帐户设置”。
3. 在“连接的客户端”下，单击要从站点中移除的客户端旁边的“删除”。

## 验证上一次或即将进行的刷新

您可以检查上次刷新发生的时间，也可以了解下一次刷新将何时进行。

1. 登录到 Tableau Cloud，并导航到数据源。
2. 从数据源页面中，单击“数据提取刷新”选项卡。
3. 在计划旁边，查看“上次更新”和“下次更新”列。

## 删除刷新计划

1. 登录到 Tableau Cloud 并导航到要删除其刷新计划的数据源。
2. 在数据源页面上，单击“数据提取刷新”选项卡。
3. 选中要删除的计划旁边的复选框，并选择“操作”\>“删除”。

<!-- document id=57946292b6097d380bb4da86cd3784ecd846ad18ea1e920a2f50bd884933cdc0 url=/tableau/next/zh-cn/online/web_author_enable.md -->

[跳转到主要内容](#main-content)

# 设置站点的 Web 制作访问权限和功能

Tableau Server 管理员可在站点级别指定是否允许用户在 Web 环境中编辑发布的视图，以及配置其他 Web 制作功能。

默认情况下，针对所有站点启用了 Web 制作功能。具有“Web 编辑”能力的用户可以直接在服务器上创建和编辑工作簿。如果希望用户能够查看发布的工作簿并与之交互，但不能对核心信息进行任何更改，请关闭 Web 制作。

以下步骤说明如何为整个站点设置 Web 制作及其他关联功能。为了更精确地控制哪些用户可以使用 Web 编辑功能，您可以使用项目、组和权限。请参见[设置内容的 Web 编辑、保存和下载访问权限](https://help.tableau.com/current/server/zh-cn/web_author_who.htm)。

有关如何在 Web 上为流程启用制作的信息，请参见[在 Web 上创建流程并与其进行交互](https://help.tableau.com/current/server/zh-cn/web_author_flows.htm)。

## 针对站点打开或关闭 Web 制作

**注意**：此设置仅适用于 Tableau Server。已为 Tableau Cloud 启用 Web 制作，并且无法关闭。

1. 在 Web 浏览器中，以管理员身份登录到服务器并转到要为其启用 Web 制作的站点。在该站点中，单击“设置”。
2. 在“**Web 制作**”部分，选择“工作簿”。允许用户在其浏览器中编辑工作簿以启用该功能。
    
    清除复选框可为该站点关闭 Web 制作。
    
    ![使站点上的视图不可编辑](/tableau/next/zh-cn/online/zh-cn/Img/web_author_disable4.png)
3. 如果您的站点已在生产中，并且您希望更改立即生效，请重新启动服务器。
    
    否则，更改将在服务器会话缓存过期后或在用户注销并于下次登录时生效。

### 说明

- 在启用 Web 制作时，请确保，在适当的工作簿或视图上，适用于某个用户或组的权限规则允许**“Web 编辑”**能力。
- 如果在生产站点上关闭 Web 制作，并且未完成最后一步来重新启动服务器，则用户可以继续具有制作访问权限，直至用户的会话缓存过期或用户注销为止。

## 查看哪些站点允许 Web 制作

若要确认哪些站点允许 Web 制作，请在顶部的站点选择菜单上选择“管理所有站点”，然后转到“站点”页面。

![“站点”页面，显示哪些站点允许进行 Web 制作。](/tableau/next/zh-cn/online/zh-cn/Img/web_author_disable3.png)

## 关于跨数据库联接

为了提高跨数据库联接的性能，Tableau 现在将默认决定是否应使用 Hyper 在 Tableau 内执行联接，或者将数据作为临时表移动到连接的实时数据库中并在那里执行联接。

每个站点的“设置”中用于配置跨数据库联接的选项仍然可见，但不能再更改默认值。

![跨数据库联接设置，选项包括始终在数据库中执行联接接或让 Tableau 决定在何处联接。](/tableau/next/zh-cn/online/zh-cn/Img/cross_database_join_web_setting.png)

有关详细信息，请参见[“提高跨数据库联接的性能”](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm#cross_dbase_joins_perf)。

<!-- document id=05fe1ce794878d1ae8c95a4985b8793b1f2232c796e6996298fb2df791a0cdd8 url=/tableau/next/zh-cn/online/cloud_manager_private_connect.md -->

[跳转到主要内容](#main-content)

# 设置适用于 AWS 的私人连接

适用于 AWS (Amazon Web Services) 的私人连接允许云管理员在 Tableau Cloud 和 AWS 托管的数据提供商之间创建安全、私有的专用连接。这些专用连接在 AWS PrivateLink 之上预置，使用私有 IP 地址空间，这意味着数据流量不会遍历公共互联网。专用连接的私有和安全特性满足了将数据流量限制到专用网络的关键要求。

作为云管理员，您可以创建专用连接并将其分配给站点。他们还可以向 Creator 和支持他们的组提供连接信息。

若要了解有关设置私人连接的详细信息，请参见[私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect.htm)。

<!-- document id=51da11795a1fe341a7cf6cb5f52fe8df653dad4f6f01523f221995af66f8199a url=/tableau/next/zh-cn/online/tableau_gai_trial.md -->

[跳转到主要内容](#main-content)

# 试用 Pulse 中的 Tableau Agent

**注意：**增强型问答 (Discover) 已重命名为 Pulse 中的 Tableau Agent。功能保持不变。只是名称发生了变化。您将在即将发布的版本中看到名称更改。

Try AI 是针对现有 Tableau Cloud 站点的 Pulse 中的 Tableau Agent 的 60 天试用版。通过 Pulse 中的 Tableau Agent，您的用户可以通过对话方式探索指标组并获得见解。试用期间，用户可以提出的问题数量没有限制。有关 Pulse 中的 Tableau Agent 的详细信息，请参见[在 Tableau Pulse 中提出问题并发现见解](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm)。

试用期之外，Pulse 中的 Tableau Agent 需要 Tableau+ 许可版本。试用期结束后，请联系您的销售代表购买 Tableau+ 许可版本，使您的用户能够继续访问。

Try AI 是在现有 Tableau 站点上测试 Pulse 中的 Tableau Agent 的唯一方法。Try AI 不提供对其他 Tableau 中的 AI 功能的访问权限，例如 Web 制作或 Tableau Prep 中的 Tableau Agent。测试这些 Tableau 中的 AI 功能的唯一方法是试用新的 Tableau Cloud 站点。无法在现有 Tableau 站点上测试这些功能。有关详细信息，请参见[使用 Tableau Cloud 新站点试用版启用 Tableau 中的 AI](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm#GenAI_trial)。

Tableau Pulse 的另外两个 Tableau 中的 AI 功能是见解摘要和提问时的语义匹配。这些功能可在没有 Tableau+ 许可版本的情况下使用，因此您无需 Try AI 即可打开它们。

## Tableau 中的 AI 如何保护您的数据

Pulse 中的 Tableau Agent 建立在 Salesforce Einstein 信任层之上，可确保您的数据安全。此外，Pulse 中的 Tableau Agent 使用 Azure OpenAI 来确保数据驻留和地理缩放。Einstein 信任层可检测敏感数据，例如个人身份信息 (PII)，并在向大型语言模型 (LLM) 发送提示词之前自动屏蔽该 PII。您的数据不会被 LLM 提供商保留或用于训练 LLM。若要详细了解 Tableau 中的 AI 如何保护您的数据，请参见 [Tableau 中的 AI 和数据使用](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_data.htm)、[Tableau 中的 AI 和信任](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust.htm)以及 [Tableau 中的 AI 和 Einstein 信任层](https://help.tableau.com/current/tableau/zh-cn/tableau_gai_einstein_trust_layer.htm)。

Einstein 信任层收集提示词和响应数据以及反馈数据。此信息安全地存储在 Salesforce Data 360 中以用于审计目的，但不会与 LLM 提供商共享。若要了解 Einstein 信任层收集的数据，请参见[关于生成式 AI 审计和反馈数据](https://help.salesforce.com/s/articleView?language=en_US&id=ai.generative_ai_feedback_about.htm&type=5)。

## 开始试用 Pulse 中的 Tableau Agent

在开始试用之前，请确保您的站点上已设置 Tableau Pulse。若要了解如何启用 Tableau Pulse，请参见[为 Tableau Pulse 设置站点](https://help.tableau.com/v0.0/online/zh-cn/pulse_set_up.htm)。

试用开始后无法暂停。即使您关闭 Pulse 中的 Tableau Agent 或完全关闭 Tableau Pulse，试用版也会继续运行。

1. 在 Tableau Cloud 导航面板上，选择“设置”。
2. 在“Tableau 中的 AI”>“Try AI”下，选择“开始免费试用”。开始试用还会为您的站点打开 Pulse 中的 Tableau Agent。
3. 在设置页面的顶部，选择“保存”。

> [!TIP]
> 
> **提示：**Pulse 中的 Tableau Agent 以前称为增强型问答/Discover。站点设置可能会显示以前的名称。

试用版不需要进一步的配置。Tableau 中的 AI 由 Salesforce 中的 Einstein 生成式 AI 提供支持，但您无需在试用期间将 Tableau 站点连接到 Salesforce。试用版会自动连接到共享的 Salesforce 组织，这与支持 Tableau Pulse 见解摘要的方法相同。

### 试用结束后的后续步骤

试用结束后，用户将失去对 Pulse 中的 Tableau Agent 的访问权限。如果用户与包含 Pulse 中的 Tableau Agent 链接的旧电子邮件摘要进行交互，这些链接将不再启动 Pulse 中的 Tableau Agent 体验。在试用期间，当 Pulse 中的 Tableau Agent 回答问题时，它会自动创建指标并建议用户关注这些指标。用户仍然可以访问在试用期间创建的任何指标。

您可以购买 Tableau+ 许可版本，以便您的用户继续访问 Pulse 中的 Tableau Agent。如果您购买 Tableau+ 许可版本，系统将为您预置一个专用 Salesforce 组织来支持 Pulse 中的 Tableau Agent。此时，您需要将 Tableau 站点连接到您的专用 Salesforce 组织。有关设置 Salesforce 组织并在试用后将其连接到 Tableau 的信息，请参见[为 AI 配置 Tableau Cloud 站点](https://help.tableau.com/v0.0/online/zh-cn/setup_tabAI_site_setting.htm#GenAI_config_SF_Tab)。

## 将试用限制为特定用户组（可选）

默认情况下，Pulse 中的 Tableau Agent 可供您站点上的所有用户使用。如果您只希望一部分用户能够测试 Pulse 中的 Tableau Agent，请限制为只有特定用户组才能访问。

1. 在 Tableau Cloud 导航面板上，选择“设置”。
2. 在“Tableau 中的 AI”>“按功能划分的 AI 设置”下，选择“Tableau Pulse：使用 Pulse Discover 对指标和见解组进行深入、综合的探索”的操作菜单 (...)。
3. 选择“用户访问权限”。
4. 选择要仅允许其访问的用户组，然后选择“应用”。
5. 在设置页面的顶部，选择“保存”。

## 引导用户入门

为了让用户充分利用 Pulse 中的 Tableau Agent，请确保他们关注他们可以探索的指标，并帮助他们了解可以提出的问题类型。

- 有关创建指标定义和指标的信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm)。
- 有关向指标添加关注者的信息，请参见[管理关注者](https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#Manage)。
- 有关如何访问 Pulse 中的 Tableau Agent 的信息，请参见[使用 Pulse 中的 Tableau Agent 探索指标组](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#Explore)。
- 有关 Pulse 中的 Tableau Agent 可回答的问题类型的信息，请参见[Pulse 中的 Tableau Agent 的示例问题](https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm#example-questions)。

<!-- document id=5f89ba64f5e145460d7329066c5340af3856adef6b2b0172d41ab458f18e1f33 url=/tableau/next/zh-cn/online/to_buy_more_licenses.md -->

[跳转到主要内容](#main-content)

# 购买更多许可证

您可以通过 Tableau Webstore 购买其他许可证，随时扩展 Tableau Cloud 部署。

## 哪些帐户符合条件？

若要通过 Webstore 购买更多许可证，必须满足以下要求：

- [客户门户](https://kb.tableau.com/articles/howto/getting-started-with-the-customer-portal?lang=zh-tw)帐户管理员或 [Tableau Cloud Manager](https://help.tableau.com/current/online/zh-cn/cloud_manager_intro.htm) 云管理员
- 不是政府帐户
- 未获得许可，请参见[基于嵌入式分析](https://help.tableau.com/v0.0/online/zh-cn/license_product_keys.htm#embedding)

如果您目前不符合条件，[请联系我们的销售团队](https://www.tableau.com/zh-cn/about/contact)以完成交易。

## 访问 Tableau Webstore

完成以下步骤，重定向并通过 Tableau Webstore 购买更多许可证：

1. 以管理员身份登录到以下位置之一：
    
    - 对于站点管理员，请登录到 Tableau Cloud 站点并选择“用户”。
    - 对于云管理员，请登录 Tableau Cloud Manager 并选择“用户”。
2. 在“用户”页面上，选择“购买更多许可证”，然后选择“转到 Webstore”。Webstore 在单独的浏览器标签页中打开。
    
    ![一个对话框，提示您确认离开 Tableau Online，前往可以购买更多许可证的网上商店。](/tableau/next/zh-cn/online/zh-cn/Img/to_buy_more_licenses.png)
3. 使用 Tableau 帐户登录到 Webstore。如果您之前已使用 [Tableau 帐户](https://identity.idp.tableau.com/login)进行身份验证，则系统不会提示您再次登录。
    
    ![Tableau 登录页面。 ](/tableau/next/zh-cn/online/zh-cn/Img/to_customer_portal_login.png)
4. 在 Webstore 上，选择要添加到部署中的 **Creator**、 **Explorer** 和 **Viewer（查看者）**许可证的数量。
    
    ![用于向 Tableau 部署添加新席位的表单。](/tableau/next/zh-cn/online/zh-cn/Img/to_buy_more_licenses_selection.png)
5. 选择“添加到当前部署”，并继续访问“联系方式和账单”以及“摘要和付款”部分。

付款后不久将发送订单确认电子邮件。如果您没有看到来自 Tableau 的电子邮件，请务必检查您的垃圾邮件文件夹。交易处理完成后，新的许可证将在站点和 Tableau Cloud Manager 上可用。

**注意：**如果设置了站点角色限制，云管理员必须在 Tableau Cloud Manager 中更新站点角色限制以增加站点的最大许可证数量。有关详细信息，请参见[管理站点角色限制](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_site_role_limit.htm)。

<!-- document id=f427099ac561e816a1df9b3517a9118f6d8a24ff271d747b23f812223918574f url=/tableau/next/zh-cn/online/to_resource_blocks.md -->

[跳转到主要内容](#main-content)

# 资源块

资源块是 Tableau Cloud 中计算容量的单位。资源块运行 Tableau Prep Conductor 流程。每个资源块一次可运行一个流程，因此您可同时运行的流程数与您具有的资源块的数量相等。

默认情况下，每个站点您都会获得一个资源块。一个资源块相当于一个[并发流程作业](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_capacity.htm#flows)。您可以联系您的 Tableau 客户经理购买额外的资源块以获得额外的并发流程作业容量，也可以访问 Tableau [定价](https://www.tableau.com/zh-cn/pricing/teams-orgs)页面了解更多信息。

<!-- document id=93356e8c2688f3eb047a51df373975f4739f845fc5a75623db6e21768cb7b350 url=/tableau/next/zh-cn/online/security_auth.md -->

[跳转到主要内容](#main-content)

# 身份验证

身份验证是指用户如何登录到其 Tableau Cloud 站点以及如何在第一次登录后访问站点的选项。身份验证将验证用户的身份。

Tableau Cloud 支持您可以在“身份验证”页面上配置的多种身份验证类型。

本主题适用于配置站点身份验证的站点管理员。对于为 Tableau Cloud Manager 配置身份验证的云管理员，请参见[Tableau Cloud Manager 身份验证](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_auth.htm)。

无论您为站点配置哪种身份验证类型，访问 Tableau Cloud 时都需要多重身份验证 (MFA)。此合同要求于 2022 年 2 月 1 日生效。有关详细信息，请参见下面的[关于多重身份验证和 Tableau Cloud](#mfa_requirement)。

- **带有 MFA 的 Tableau：**这是内置的默认身份验证类型。它要求用户提供以下各项的组合：1) Tableau 凭据（也称为 TableauID），其中包含通过 Tableau Cloud 存储的用户名和密码，以及 2) MFA 验证方法（例如身份验证器应用程序或安全密钥），用于确认用户的身份。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。
    
    - **Tableau：**如果 Tableau 尚未更新您的站点以要求带有 MFA 的 Tableau，您可以继续暂时使用此身份验证类型。用户可以直接在 Tableau Cloud 登录页面中输入其 TableauID 凭据。
- **Google：**如果您的组织使用 Google 应用程序，则您可以启用 Tableau Cloud 以使用 Google 帐户通过 OpenID Connect (OIDC) 进行使用 MFA 的单点登录 (SSO)。当您启用 Google 身份验证时，系统会将用户定向到 Google 登录页面，以便输入由 Google 存储的凭据。
- **OIDC**：另一种使用 SSO 的方式是通过通用 OpenID Connect (OIDC)。为此，您可以使用带有 MFA 的第三方身份提供程序 (IdP)，并将站点配置为与 IdP 建立信任关系。当您启用 OIDC 时，用户被定向到 IdP 登录页面，他们将在此页面中输入已通过 IdP 存储的 SSO 凭据。
- **Salesforce：**如果您的组织使用 Salesforce，则您可以启用 Tableau Cloud 以使用 Salesforce 帐户通过 OpenID Connect (OIDC) 进行使用 MFA 的单点登录 (SSO)。当您启用 Salesforce 身份验证时，系统会将用户定向到 Salesforce 登录页面，以便输入在 Salesforce 中存储和管理的凭据。可能需要最少的配置。有关详细信息，请参见[Salesforce 身份验证](https://help.tableau.com/v0.0/online/zh-cn/security_auth_sfdc.htm)。
- **SAML**：另一种使用 SSO 的方式是通过安全断言标记语言 (SAML)。为此，您可以使用带有 MFA 的第三方身份提供程序 (IdP)，并将站点配置为与 IdP 建立信任关系。当您启用 SAML 时，用户被定向到 IdP 登录页面，他们将在此页面中输入已通过 IdP 存储的 SSO 凭据。

**注意：**

- 访问和管理权限通过站点角色来实现。站点角色定义哪些用户是管理员，以及哪些用户是站点上的内容使用者和发布者。有关管理员、站点角色、组、来宾用户以及用户相关的管理任务的详细信息，请参阅[管理用户和组](https://help.tableau.com/v0.0/online/zh-cn/users.htm)以及[设置用户的站点角色](https://help.tableau.com/v0.0/online/zh-cn/users_site_roles.htm)。
- 在身份验证上下文中，一定要知道用户无权通过获得帐户从而经 Tableau Cloud 访问外部数据源。换句话说，在默认配置中，Tableau Cloud 作为外部数据源的代理。此类访问需要在 Tableau Cloud 上额外配置数据源，或者在用户从 Tableau Desktop 连接时在数据源中进行身份验证。

### 关于多重身份验证和 Tableau Cloud

为了提前应对可能削弱组织的不断增长和不断演变的安全威胁，从 2022 年 2 月 1 日起，MFA 身份验证成为 Tableau Cloud 要求。MFA 是增强登录安全性和保护组织及其数据免受安全威胁的有效工具。有关详细信息，请参见 Salesforce 帮助中的 [Salesforce 多重身份验证常见问题](https://help.salesforce.com/apex/HTViewSolution?urlname=Salesforce-Multi-Factor-Authentication-FAQ) 。

多重身份验证 (MFA) 是一种身份验证方法，必须与上述其他身份验证方法之一结合使用，以增强帐户安全性。可以通过以下两种方式之一来实施 MFA：

- **SSO 和 MFA（推荐方法）：**为了满足 MFA 要求，请通过 SSO 身份提供程序 (IdP) 启用 MFA。
- **带有 MFA 的 Tableau（替代方法）：**如果您不直接使用 SSO IdP，则可以启用 1) TableauID 凭据（与 Tableau Cloud 一起存储）和 2) 其他验证方法的组合，然后您和您的用户才能访问站点。我们还建议用户设置恢复代码作为仅在紧急情况下的备份验证方法。有关详细信息，请参见[多重身份验证和 Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/to_security_mfa.htm)。

### 关于 Google、OIDC、Salesforce 或 SAML 配置

如果在站点上启用 Google、OIDC、Salesforce 或 SAML 身份验证，则可以选择想要使用外部凭据登录的用户以及想要使用 Tableau 凭据 (Tableau ID) 的用户。您可以允许为站点配置 Tableau 和一个或多个外部提供程序，但每个用户必须设置为使用其中一种类型。您可以在“用户”页面上配置用户身份验证选项。

**重要信息：**除了上述身份验证要求之外，我们建议您专门指定一个始终为“带有 MFA 的 Tableau”身份验证配置的站点管理员帐户。如果 SAML 或 IdP 出现问题，专门的带有 MFA 的 Tableau 帐户可确保您能够访问站点。

#### 有关配置其他身份验证方法的说明

从 2025 年 1 月（Tableau 2024.3）开始，您可以为站点配置一种或多种身份验证方法。

每个身份验证配置都需要一个名称。2025 年 1 月之前创建的现有配置将自动命名。例如，如果您的站点在 2025 年 1 月之前配置了 SAML，则配置名称为“初始 SAML”。现有配置的名称不能更改。

站点可拥有的最大配置数量取决于站点的创建时间以及是否配置了 SAML 或 OIDC。

- 对于 2025 年 1 月升级之前创建的站点：
    
    - 如果您在 2025 年 1 月升级之前仅配置了 SAML 或仅 OIDC，则最多可以创建 19 个配置。
    - 如果您在 2025 年 1 月升级之前配置了 SAML，然后配置了 OIDC，或者先配置了 OIDC，然后配置了 SAML，则最多可以创建 18 个配置。
- 对于 2025 年 1 月升级后创建的站点，您最多可以创建 20 个配置。

**注意：**可以启用、禁用和删除配置。但是，在关闭 SCIM 功能之前，无法停用或删除与 SCIM 关联的 SAML 配置。有关 SCIM 的详细信息，请参见[SCIM](https://help.tableau.com/v0.0/online/zh-cn/scim_config_online.htm)。

## 允许从连接的 Tableau 客户端直接访问

默认情况下，在用户提供其凭据以登录到站点之后，他们以后可以直接从_连接的_ Tableau 客户端访问 Tableau Cloud 站点。若要了解详细信息，请参见[从连接的客户端中访问站点](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm)。

**注意：**（可选）如果为您的站点启用了带有 Tableau 身份验证的 MFA，并且您的环境正在使用阻止客户端访问其他必要服务的代理，您可能需要添加 `*.salesforce.com`。

## 其他身份验证方案：嵌入和集成

通过将 Tableau 集成并嵌入到自定义 Web 门户、应用程序和面向客户的产品中，您可以将分析直接置于用户的工作流中。为了将外部应用程序与 Tableau Cloud 集成并嵌入 Tableau Cloud 内容，还有其他机制可以根据预期的工作流程对访问 Tableau 的用户进行身份验证：

- **与 Tableau 已连接应用一起嵌入：**
    
    - **直接信任** —Tableau 已连接应用通过促进您的 Tableau Online 站点与嵌入 Tableau 内容的自定义应用程序之间建立明确的信任关系，实现无缝且安全的身份验证体验。信任关系为您的用户提供单点登录 (SSO) 体验，而无需与身份提供程序集成。使用已连接应用还支持以编程方式授权使用 JSON Web 令牌 (JWT) 访问 Tableau REST API。有关详细信息，请参见[使用直接信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_direct.htm)。
    - **OAuth 2.0 信任** — 您可以使用 OAuth 2.0 标准协议向 Tableau Cloud 注册外部授权服务器 (EAS)，以在站点和 EAS 之间建立信任关系。信任关系通过您的 IdP 为您的用户提供到嵌入式 Tableau 内容的单点登录体验 (SSO)。此外，注册 EAS 支持以编程方式使用 JSON Web 令牌 (JWT) 授权对 Tableau REST API 的访问。有关详细信息，请参见[使用 OAuth 2.0 信任配置已连接应用](https://help.tableau.com/v0.0/online/zh-cn/connected_apps_eas.htm)。
- **Salesforce 集成：**通过机器学习模型和使用 Einstein Discovery 的全面统计分析来增强您的数据分析。有关详细信息，请参见[配置 Einstein Discovery 集成](https://help.tableau.com/v0.0/online/zh-cn/config_einstein_extensions.htm)。
- **Slack 集成：**让获得许可的 Tableau 用户在他们的 Slack 工作区中可以使用 Tableau 通知。有关详细信息，请参见[将 Tableau 与 Slack 工作区集成](https://help.tableau.com/v0.0/online/zh-cn/slack_admin.htm)。

## 此部分中的其他文章

<!-- document id=e199714bcec63e7d3482d88766e0798f55035374c8a4d00280292bec0fd8a79d url=/tableau/next/zh-cn/online/cmt-migration_extracts.md -->

[跳转到主要内容](#main-content)

# 迁移包含数据提取的工作簿和数据源

Tableau Cloud 用户可以发布作为原始数据副本或子集的数据提取。这些数据提取可能嵌入在工作簿或数据源中。默认情况下，当您使用 Tableau Content Migration Tool 迁移包含数据提取的工作簿或数据源时，该数据提取会随包含它的工作簿或数据源一起迁移。Content Migration Tool 为您提供了一些用于控制此行为的选项：

- **切换到实时连接**
    
    可以将“移除数据提取”添加到迁移计划中，以便在迁移期间从工作簿或数据源中移除数据提取。与往常一样，源工作簿或数据源将不会被修改。迁移到目标项目的工作簿或数据源副本中的数据提取副本将被移除。这会有效地将数据连接切换回实时连接。

- **迁移后刷新数据提取**
    
    您可以在迁移计划中启用“迁移后刷新数据提取”选项，在迁移工作簿或数据源之后立即安计划数据提取刷新任务。
    
    如果迁移计划还使用“设置连接信息”转换将数据连接更改为指向不同的数据集（例如，其他数据库服务器或数据库），则不建议使用“迁移后刷新数据提取”选项。将连接信息更改为指向其他数据并使用“迁移后刷新数据提取”选项时，这可能会以一种会带来潜在安全问题的方式意外地公开数据。
    
    有关详细信息，请参见[选项 3：迁移后刷新数据提取](#refresh-after-migration)。

#### 更改使用数据提取的数据连接

Tableau 数据连接是直接查询数据源的实时连接，或者是数据源的数据提取。数据提取是原始数据的副本或子集，可以嵌入到工作簿或数据源中。存在数据提取时，视图将从数据提取（而不是基础数据源）中查询数据。

通常，您需要在迁移过程中修改数据源连接，以便它指向 目标项目（而不是源项目）中的其他数据库。

举例来说，如果要将工作簿从暂存项目迁移到生产项目，则可能需要更新工作簿内的数据连接以连接到生产数据库。可通过在迁移计划中使用“设置连接信息”转换来实现这一点。现在，您有一个迁移计划，该计划将工作簿从暂存复制到生产，并更新数据连接以指向生产数据库。

如果您的工作簿使用数据提取，则需要进行额外的工作。在这种情况下，将迁移工作簿并更新实时数据连接。但是，视图仍将显示暂存数据库中的数据，因为它仍然包含从源（暂存）项目复制的暂存数据库数据提取。可通过几种方式来解决此问题：

#### 选项 1：使用发布的数据源

您可以更改工作簿，以便它们改用发布的数据源。这样，数据提取将作为已发布数据源的一部分进行管理，并且，因为不必担心是连接到实时数据库还是数据提取，因此迁移使用该数据源的工作簿更新的工作得到了简化。

#### 选项 2：在迁移过程中移除数据提取

您可以向迁移计划中添加“移除数据提取”转换。此转换将从工作簿中移除数据提取，从而有效地将数据源切换到实时连接。

#### 选项 3：迁移后刷新数据提取

您可以在迁移计划中使用“迁移后刷新数据提取”选项。这将随工作簿一起迁移数据提取，但将在迁移完成后为该工作簿安排立即数据提取刷新任务。

在与“设置连接信息”转换一起使用时，通常不建议使用此选项，原因是它可能会带来潜在的安全问题。

问题是，在迁移完成到数据提取刷新任务完成的一段时间内，目标项目中的已迁移工作簿仍然显示旧（源）数据提取数据。如果数据提取刷新任务失败，则在刷新数据提取之前，旧/源数据提取数据将会保留。

在上面概述的从暂存迁移到生产环境的情况下，这可能是可接受的，但您应该注意，工作簿的用户可能不知道，由于工作簿是最近迁移的或者数据提取尚未刷新，因此工作簿正在显示旧/暂存数据。

在您可能使用“设置连接信息”将数据连接更改为指向一组其他客户或客户端数据的情况下，这可能会带来严重的安全问题，在迁移之后刷新数据提取之前，工作簿的数据提取会包含来自其他客户端或客户的数据。

缓解此问题的一种方法是实现 2 阶段迁移。此方法要求您创建两个迁移计划，各用于下面介绍的每个步骤，并确保工作簿和数据源在可访问之前包含最新的数据提取。

- **第 1 阶段：**将内容迁移到只有管理员能够访问的目标站点上的一个项目。通过此迁移，您可以将“迁移后刷新数据提取”选项与“设置连接信息”转换结合使用来更新数据连接，因为没有非授权用户将能看到旧数据，即使数据提取刷新失败也是如此。
- **第 2 阶段：**第 1 阶段完成，并且您确认数据提取刷新成功之后，运行第二个刷新计划，将内容从第 1 阶段的目标迁移到最终用户可以看到的最终目标。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=fc710c625b0942066fa248c4a101f2e738336e88474c7cd3e9de16416824e3e4 url=/tableau/next/zh-cn/online/cmt-migration_embedded_credentials.md -->

[跳转到主要内容](#main-content)

# 迁移包含嵌入式凭据的工作簿和数据源

从版本 2023.1 开始，授权用户可以将包含嵌入式凭据的工作簿和已发布数据源从 Tableau Server 迁移到 Tableau Cloud。使用 Content Migration Tool 迁移之前需要额外的配置。

**注意：**Content Migration Tool 不支持 OAuth 连接的嵌入式凭据迁移。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

## 概述

在连接到 Tableau Server 作为源站点和 Tableau Cloud 作为目标站点时，可以使用 Content Migration Tool (CMT) 迁移嵌入式凭据。两个站点都必须具有 [Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm) 许可证。

现在我们已经介绍了这些要求，让我们讨论迁移的工作方式。您需要与 Tableau Cloud 站点管理员和 TSM 管理员（有时是同一个人）密切合作，以允许该功能并授权站点用户。功能激活后，授权站点用户构建迁移计划并选择发布选项_“迁移工作簿的嵌入式凭据”_和_“迁移数据源的嵌入式凭据”_。

运行迁移计划时，所有必需的内容凭据都在加密的内容清单中从 Tableau Server 传输到 Tableau Cloud.随着 CMT 发布内容，目标 Tableau Cloud 站点将清单中匹配的凭据安全地嵌入到内容（工作簿或已发布数据源）中。迁移过程中出现的任何问题都会出现在 CMT 的“错误和警告”选项卡中。有关详细信息，请参见[迁移规划概述](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm)。

## 允许嵌入式凭据迁移

使用以下步骤允许嵌入式凭据从 Tableau Server 迁移到 Tableau Cloud。

### Tableau Cloud

1. 打开浏览器窗口，并以站点管理员身份登录到 Tableau Cloud。
2. 选择“设置”\>“常规”，然后向下滚动到“管理内容迁移”。
    
    ![管理内容迁移加密密钥接口，并提供创建新密钥的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-manage-content-migration.png)
3. 单击“创建新密钥”以生成加密密钥对。
    
    **注意：**公钥只显示一次。如果您在完成配置之前丢失了密钥，则需要生成一个新密钥。
4. 在出现的窗口中，单击“复制到剪贴板”，然后关闭窗口。
5. 将公钥粘贴到一个文件，并将其存储在安全位置。TSM 管理员将使用公钥来允许迁移。您可以在“设置”页面上查看公钥到期日期。

### TSM 命令行接口

1. 根据您的操作系统，执行以下操作之一：
    
    - Windows 版 Tableau Server ：使用作为群集中某个节点上的管理员组成员的帐户打开 Windows 命令提示符。
    - Linux 版 Tableau Server：使用作为 `tsmadmin` 群集中某个节点上的组成员的帐户打开命令提示符。
2. 使用 `tsm security authorize-credential-migration` 允许嵌入式凭据迁移到 Tableau Cloud 站点。有关详细信息，请参见 Tableau Server 帮助中的 [tsm security](https://help.tableau.com/current/server-linux/zh-cn/cli_security_tsm.htm)。
    
    `tsm security authorize-credential-migration --source-site-url-namespace <Tableau Server site ID> --destination-site-url-namespace <Tableau Cloud site ID> --destination-server-url <Tableau Cloud site url> --authorized-migration-runner <username> --destination-public-encryption-key <public key>`
    
    **注意：**从远程节点运行 TSM 命令时，使用 `tsm login` 在运行 `tsm security authorize-credential-migration` 之前使用 Tableau Server 管理控制器服务对会话进行身份验证。
3. （可选）使用 `tsm security cancel-credential-migrations` 取消授予的授权。默认情况下，迁移授权将在 7 天或使用 `--expiration-time-in-days` 选项指定的天数后过期。

### Content Migration Tool

1. 打开 Content Migration Tool，并选择“创建新计划”或“浏览计划”。
2. 在“站点”页面上，单击“登录到 Tableau”，并连接到 Tableau Server 作为来源和 Tableau Cloud 作为目标。嵌入式凭据迁移仅在从 Tableau Server 迁移到 Tableau Cloud 时可用。
3. 制定迁移计划并选择以下发布选项：
    
    - 在“工作簿发布选项”页面上，选择“迁移工作簿的嵌入式凭据”。有关详细信息，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)。
    - 在“数据源发布选项”页面上，选择“迁移数据源的嵌入式凭据”。有关详细信息，请参见[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)。
4. 准备就绪时，单击“验证并运行”开始迁移。

您选择的工作簿和已发布数据源将迁移到您的 Tableau Cloud 站点，并且不应提示进行身份验证。如果您在迁移嵌入式凭据时遇到问题，请参见[故障排除](#troubleshooting)。

## 疑难解答

本部分包含您可能遇到的一些常见迁移问题，以及解决这些问题的建议。

### 没有迁移嵌入式凭据的选项

您只能将嵌入式凭据从 Tableau Server 迁移到一个 Tableau Cloud 站点。Tableau Server 和 Content Migration Tool 必须运行版本 2023.1 或更高版本。有关详细信息，请参见[安装 Tableau Content Migration Tool](https://help.tableau.com/v0.0/online/zh-cn/cmt-install.htm)。

### 迁移嵌入式凭据失败

在 CMT 的[“错误和警告”](https://help.tableau.com/v0.0/online/zh-cn/cmt-depl_plan_overview.htm)选项卡中，您可能会收到一条错误，指明迁移嵌入式凭据失败。当用于授权迁移的公钥过期时，可能会发生这种情况。

作为 Tableau Cloud 站点管理员，请转到“设置”页面并验证公钥是否有效。如果公钥过期，您必须创建一个新的加密对来授权迁移。有关详细信息，请参见[允许嵌入式凭据迁移](#allow-migration)。

## 谁可以执行此操作？

- 需要 Tableau Cloud 站点管理员和 TSM 管理员来允许嵌入式凭据迁移。
- 授权站点用户必须具有 Explorer 角色或更高级别角色。他们还必须在源站点上具有工作簿的“查看”和“下载”/“保存副本”能力，并在目标站点上具有目标项目的“查看”和“发布”能力。

有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=f0029688827d5081859b87a25e29f04aebd12d196bcb9a3cb613b80505a2d24c url=/tableau/next/zh-cn/online/cmt-depl_plan_overview.md -->

[跳转到主要内容](#main-content)

# 迁移规划概述

Tableau Content Migration Tool 为在项目之间迁移 Tableau 内容创建了一个简化的过程。易于遵循的计划是可审核、可重复的，并且通过批处理过程实现，因此可通过一个简单高效的过程迁移任意数量的工作簿和数据源。

Content Migration Tool 将显示上下文提示，引导您完成创建或编辑迁移计划的过程。选择源站点和目标站点后，屏幕顶部将显示迁移摘要，如下所示：

![从一个网站迁移到另一个网站。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-summary.png)

## 迁移内容时的限制

在开始之前，请确保了解使用 Content Migration Tool 迁移内容时的限制。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

## 加密密钥

生成的每个迁移计划文件都包含一个对于创建计划的应用程序唯一的加密密钥。如果需要通过最初未生成该文件的应用程序运行迁移计划，则可以共享加密密钥。共享加密密钥时，需要覆盖应用程序中的现有密钥才能运行迁移计划。若要查看加密密钥，请选择“Help”>“Settings”。

![包含旧许可证密钥、诊断和安全加密密钥选项的设置菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-encryption.png)

如果将为迁移计划使用 Content Migration Tool 控制台运行程序，则必须使用 `tabcmt-runner encryption` 命令在运行计划之前使用命令指定加密密钥。有关详细信息，请参见[使用 Tableau Content Migration Tool 控制台运行程序](https://help.tableau.com/v0.0/online/zh-cn/cmt-deployment_console_runner.htm)。

## 迁移过程

### 步骤 1：开始

迁移过程的核心是创建计划，您可以将其保存并在将来的迁移中重用，或者根据需要修改和更新。第一步是选择是创建新计划还是选择以前保存的计划。

若要创建新计划，请单击“Create New Plan”。如果已经创建了迁移计划并且想要使用，请单击“Browse for a Plan”。

![标记为“创建新计划”或“浏览计划”的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-start.jpg)

默认情况下，所有已保存的迁移计划都将存储在“我的文档”文件夹的 `Tableau Content Migration Tool Plans` 文件夹中。所有迁移计划均使用 `.tcmx` 扩展名保存，最近访问的计划将单独列出，以便于选择：

![创建新计划、浏览计划和查看最近计划的路径。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-recent.png)

您可以选择最近访问的计划，复制计划以对其进行修改，以及将其另存为新计划。选择要复制的计划，并单击“Duplicate”。

![复制图标。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-icon-duplicate.png)

### 步骤 2：规划

Content Migration Tool 将分六个步骤引导您完成构建和编辑迁移计划的过程。

单击每个步骤以了解详细说明：

- [迁移计划：站点](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_servers.htm)
- [迁移计划：源项目](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_source_projects.htm)
- [迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)
- [迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)
- [迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)
- [迁移计划：迁移脚本](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_scripts.htm)
- [迁移计划：计划选项](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_options.htm)

### 步骤 3：迁移

完成计划后，现在即可运行迁移的批处理过程。到达迁移的最后一步时，将会显示计划摘要供您验证：

![审查计划摘要，其中包含数据源列表，详细说明审查的来源、目标、项目、工作簿、已发布数据源和自动存档。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-summary-verification.png)

如果要更改计划的任何方面，可以单击左边侧边栏中的某个部分直接转到该阶段。准备就绪时，单击“Run ”开始迁移。

单击“Run”时，迁移工具会提示您有关任何未保存的计划元素的情况。默认情况下，单击“Yes”时将保存任何未保存的元素。请记住，您始终可以保留以前的计划，而不通过在迁移过程的“开始”阶段复制该计划来进行任何更改。

![确认计划保存的选项。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-save-confirm.png)

您的迁移计划将运行，并且将为整体计划的进度以及发送到目标服务器的每个工作簿显示一个状态栏。

![显示 2019 年源工作簿和测试数据下载的进度条。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-status.png)

计划完成运行后，可以单击屏幕底部的选项卡来了解有关迁移的详细信息。

#### 已发布工作簿

Published Workbooks 详细列出了新发布的工作簿，以及在其中迁移这些工作簿的项目。

![一个显示已发布工作簿、项目以及用于查看 Tableau Server 上的数据的链接的表格。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-pub-workbooks.png)

#### 已发布数据源

Published Data Sources 详细列出了新发布的数据源，以及在其中迁移这些数据源的项目。

#### 输出

“Output ”选项卡详细列出了计划的迁移日志。

![有关 Tableau Content Migration Tool 运行的信息。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-output.png)

可通过单击“Save Log”来保存此日志。

![“保存日志”图标。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-icon-save-log.png)

#### 错误和警告

“Errors and Warnings”选项卡突出显示迁移过程中发生的任何问题。

![错误和警告表，其中包含消息、工作簿或数据源和项目。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-errors.png)

您可以纠正这些问题并重新运行计划。完成迁移并保存计划之后，单击“Done ”完成操作。

![“完成”图标。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-icon-done.png)

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

## 此部分中的其他文章

<!-- document id=a3c9b9bb319f4b880fd45fcb535e267d23ac21ca34aef0125c1bfef39012b9a7 url=/tableau/next/zh-cn/online/cmt-plan_workbooks.md -->

[跳转到主要内容](#main-content)

# 迁移计划：工作簿

您已成功登录到源站点和目标站点以及选定的项目。下一步是针对迁移准备工作簿。

**注意：**如果您的工作簿或数据源包括数据提取，请确保阅读并理解[迁移包含数据提取的工作簿和数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_extracts.htm)中的信息。

## 步骤 1：工作簿选择

源站点和选定项目中的所有工作簿将出现在“Workbook Selection”屏幕中。

![工作簿选择窗口，其中选择了特定的工作簿选项并显示了所选可视化项的六个预览。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-select.png)

如果在此步骤中对源站点中的工作簿进行任何更改，您可以单击“Refresh ”更新工作簿列表。可通过多种不同方式来选择这些工作簿。

### “特定工作簿”选择

“Specific ”部分中有三个按钮。“基本”部分中的任何选项将立即包括迁移计划中特定选择的工作簿。或者，可通过单击每个工作簿来单独选择特定工作簿。

#### 全选

“全选”按钮将选择或取消选择站点中的所有工作簿。如果在保存计划后向站点中添加了将其他工作簿，则在下次使用计划时将不会自动添加这些工作簿。

#### 显示：

##### 缩略图

默认视图将在缩略图预览中显示工作簿，以帮助您区分每个工作簿。在此视图中，将鼠标指针悬停在缩略图上的将显示该工作簿内的其他工作表和仪表板的预览。

##### 列表

列表视图是一个更简洁的列表，它还提供了附加信息，包括工作簿名称、项目、Tableau 版本和最后修改时间。

单击任一列标题将相应地对工作簿进行排序。此外，将鼠标指针悬停在任何工作簿上时，还将提供该工作簿内的工作表和仪表板的浮动预览。如果站点中有大量工作簿，列表视图尤其有用。

### “基于规则”选择

可以使用“Rule Based”选项来基于特定条件选择工作簿。基于规则的选项将创建要在运行迁移计划时使用的工作簿选择条件。请注意，在任何“Rule Based”选项中选择“全部”与“Specific Workbooks”选择不同。基于规则的“全部”选择将始终包括所有工作簿，因此新添加的任何工作簿将包含在将来的迁移中。

![根据项目标签和发布者设置工作簿迁移规则的界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-rulebased.png)

“Rule Based”单选按钮允许您使用以下选项选择工作簿：

#### Workbooks in projects

此菜单允许您从特定项目中选择工作簿。

#### Workbooks tagged with

此菜单允许您按标记选择工作簿。

#### Workbooks published by

此菜单允许您按作者选择工作簿。

对于每个选项，您可以通过单击每个条目旁边的选项来进行单选或多选。所有选定工作簿将出现在“Selection Description”框中。

### “所有工作簿”选择

最后一个选项是选择“All Workbooks”单选按钮，它可选择站点内所有项目中的所有工作簿。

使用“All Workbooks”单选按钮与使用“Specific Workbook”方法选择所有工作簿不同，因为它也会在将来每次使用迁移计划时使用源站点中的每个工作簿。

![工作簿选择选项，其中选择了所有项目中的所有工作簿。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-select-all.png)

对工作簿选择感到满意后，单击“Next”。

## 步骤 2：工作簿映射

现在，您可以将所选工作簿从源文件映射到目标文件。映射允许您在迁移源工作簿时对其进行重命名，并选择不同的目标。您也可以添加映射以更改工作簿的项目、前缀或后缀。还可以将项目添加到此部分的“目标”中。

如果在此处未进行更改，则只会使用相同的名称迁移所选工作簿，并迁移到与源工作簿相同的项目中。如果未在目标站点中定义项目，则它们将迁移到“默认”项目中。若要添加工作簿映射，请单击“添加映射”按钮。映射区域中将显示以下选项。

![用于添加新工作簿映射的界面，其中包含重命名和更改项目的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-mapping.png)

### 重命名工作簿

![工作簿映射界面，其中包含源和目标项目以及工作簿名称的字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-mapping-rename.png)

此转换允许您按Source 项目筛选，并选择要重命名的所需工作簿。在“Destination ”字段中，选择要将工作簿定向到哪个项目，并输入所需的新名称。

### 更改项目

![用于更改工作簿前缀的界面，并提供移除或替换的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-mapping-chgproj.png)

默认情况下，工作簿将迁移到目标中的相同项目。此映射允许您为源项目中的所有工作簿更改目标项目。

### 添加项目

在重命名工作簿或更改项目时，“Add New”选项允许您创建目标，而不必登录到目标站点并手动创建项目。您可以使用“Add New ”对话框创建项目及嵌套项目。

![用于创建新项目的表单，其中包含位置、项目名称、父项目和描述字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-mapping-chgproj-new.png)

### 更改前缀

![用于更改工作簿前缀的界面，并提供移除或替换的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-mapping-chgprefix.png)

此选项允许您为一个或所有源项目中的工作簿移除或替换前缀。

### 更改后缀

与前缀映射一样，您可以为一个或所有源项目中的工作簿移除或替换后缀。

## 步骤 3：工作簿转换

您可以使用“转换”步骤更改和修改工作簿。

![带有下拉箭头的标有“添加转换”的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-add-transform-button.png)

转换以指定的方式修改工作簿。可以通过插件包含其他转换，将来版本的应用程序中将添加这些转换。单击“添加转换”下拉菜单可查看当前可用的转换选择。

![工作簿转换选项的下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-add-transform-list.png)

选择任何转换将会打开“编辑转换”窗口，该窗口允许您将其自定义为所选工作簿。所有转换将按其列出顺序从上到下完成。

对于所有不同类型的转换，有两个基本步骤。第一步是让您选择转换。在本例中，选择要转换的工作簿。选择区域类似于“规划”阶段的“工作簿选择”部分，具有“基本选择”单选按钮的所有功能：“全选”/“取消全选”、“刷新”、“缩略图”显示，以及“列表”显示。在列表顶部，您可以选择“Select All”工作簿，这是一个用于自动选择所有工作簿以供将来转换的选项。您还可以刷新工作簿显示窗口以反映源站点的所有更改或更新。

![带有编辑转换选项的窗口。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-edit-transform-workbook.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。

![用于编辑参数值的表单，其中包含参数名称、数据类型和值的字段。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-edit-transform-options.png)

每个工作簿转换都有要在选项选项卡上输入的不同值，并且选项卡将具有不同的名称，具体情况视所编辑的信息而定：

### 替换 URL 动作

使用此转换替换工作簿内的部分或全部 URL 动作。在“选项”选项卡上，输入要匹配的文本及其替换值。替换功能用于 URL 动作，不会检查整个工作簿 XML。

![两个带有标签的文本框，“匹配”和“替换”。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-action-url.png)

#### 示例：

URL：`www.exampledev.com`

匹配：`dev`

替换值：`Prod`

结果：`www.exampleProd.com`

### 设置参数值

定义一个新参数。在选项选项卡上，输入参数的名称、下拉菜单中的数据类型以及值。

![包含参数名称、数据类型和值字段的表单。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-parameter.png)

### 移除图像

通过在选项选项卡上输入文件名，移除所选工作簿中的任何图像（例如水印）。另外还有一个复选框，用于指定在迁移期间找不到图像的情况下接收警告。

![标有“文件名”的文本字段和关于在工作簿中找不到匹配图像的警告消息。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-image-remove.png)

### 移除工具提示命令

从所选工作簿中移除所有工具提示命令。没有要为此转换定义的其他选项。

### 替换图像

替换所选工作簿中嵌入的图像。在“选项”选项卡上，输入当前图像和替换图像的文件名。您可以使用本地文件路径或 URL 替换图像。

![标有“文件名”的文本字段和关于在工作簿中找不到匹配图像的警告消息。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-image-replace.png)

#### 示例：

文件名：`image.png`

替换图像 URL：`https://www.exampledev.com/replacementImage.png`

### 缩放控制可见性

在选项选项卡上通过下拉菜单设置可见性模式：“自动”、“悬停时显示”或“隐藏”。

![选择了“自动”的可见性模式下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-zoom.png)

### 网页 URL 替换

使用此转换替换仪表板上使用的部分或全部网页 URL。在“选项”选项卡上，输入应匹配的文本及其替换值。

![标有“匹配”和“替换”的两个空文本字段](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-web-url-replace.png)

#### 示例：

URL：`www.exampledev.com`

匹配：`dev`

替换值：`Prod`

结果：`www.exampleProd.com`

## 步骤 4：数据源转换

为企业迁移规划工作簿的下一步是数据源转换。它的功能与“工作簿转换”步骤类似。这些转换适用于打包在工作簿内的数据源。已发布的数据源将在流程中的其他步骤中处理。

![带有下拉箭头的标有“添加转换”的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-add-button.png)

单击“添加转换”下拉菜单，以下选项将会出现：

![数据源转换列表，包括表名替换和 SQL 设置调整。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-transform-datasource-add-list.png)

选择任何数据源转换将会打开“编辑转换”窗口，该窗口允许您将其自定义为所选数据源。所有转换将按其列出顺序从上到下完成。

对于所有不同类型的数据源转换，有两个基本步骤。第一步是输入所需数据源的匹配条件。根据所选的连接类型，将在“匹配条件”选项卡上显示更多字段。

![数据源转换接口，其中包含用于设置新连接值和匹配条件的字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-transform-datasource-edit-criteria.png)

单击“预览源连接”查找与所输入条件匹配的任何连接。

![预览数据源转换的表。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-preview.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。

![用于数据源转换的自定义 SQL 设置界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-transform-datasources-edit-options.png)

每个数据源转换都有要在选项选项卡上输入的不同值：

#### 设置计算公式

在“选项”选项卡上，您可以替换列计算。

![包含列名和公式字段的表单。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-calc-set.png)

#### 设置连接信息

在“新建连接值”选项卡上，输入新数据源的身份验证方法和连接详细信息。根据所选的连接类型，将显示更多字段。

**使用 CMT 更改已发布的数据源**

选择“Tableau Server（已发布数据源）”连接类型以更改工作簿的已发布数据源。这可以减少在项目之间迁移工作簿时所需的手动步骤，例如，将内容从开发推广到生产。

若要更改已发布数据源，请从下拉菜单中选择一个数据源，并输入 Tableau 用户名进行身份验证。用户必须存在于目标站点上并具有已发布数据源的“连接”能力。

- 对于基于文件的数据源，用户将访问工作簿并根据指定 Tableau 用户的权限查看数据。
- 对于所有其他数据源，在视图或工作簿加载时会提示用户输入他们自己的数据库凭据。

如果未指定 Tableau 用户名，则只有具有“连接”能力的用户才能查看工作簿中的数据。

![包含已发布数据源和您的 Tableau 用户名的字段的表单。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-set-cx.png)

#### 设置自定义 SQL

在“新建自定义 SQL”选项卡上，输入要为“匹配查询名称”修改的自定义 SQL 查询的名称。查询名称必须与数据源物理层的自定义 SQL 查询名称匹配。如果这些名称不匹配，则转换将失败。有关数据建模和物理层的详细信息，请参见[Tableau 数据模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_datamodel.htm)。

输入查询名称后，在文本字段中输入所需的“自定义 SQL”。请注意，如果使用不当，自定义 SQL 可能会对工作簿的性能产生负面影响。

![一个标有“匹配查询名称”的文本框，和一个标有“自定义 SQL”的更大的文本框。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-set-custom-sql.png)

#### 移除数据提取

此转换没有选项选项卡，只需在“Match Criteria”信息中输入内容，迁移过程中即会移除数据提取。

此外，您还可以在“Edit Transformation”窗口左侧的“Comments ”部分输入有关每个转换的注释。

#### 应用保存的凭据

在版本 2022.3 中已弃用。请改用“设置连接信息”数据源转换。

在选项选项卡上，为数据连接输入 Tableau 用户名和相应的已保存凭据用户名。您只能在 Tableau 站点的“帐户设置”页面上为现有数据连接应用保存的凭据。有关详细信息，请参见[为数据连接管理保存的凭据](https://help.tableau.com/v0.0/online/zh-cn/manage_stored_credentials.htm)。

![两个文本框请求 Tableau 用户名和已保存的凭据用户名。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-transform-saved-credentials.png)

## 步骤 5：发布选项

“工作簿”阶段的最后一步是选择发布选项并为标记、数据提取刷新计划和权限创建转换。

![工作簿的发布选项包括覆盖控制和权限设置。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-publish-options.png)

#### 重置仪表板选项

此选项会取消选择仪表板上的所有对象。

#### 覆盖较新的工作簿

如果选中此选项，即使工作簿将覆盖已在同一时间创建或者比移动的工作簿更新的工作簿，也会迁移该工作簿。

#### 复制工作簿权限

选中此选项时，迁移工具将尝试尽可能地匹配源工作簿权限。

#### 复制数据提取刷新计划

选中此选项时，迁移工具将尝试将目标工作簿数据提取刷新计划设置为与源的名称相匹配。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

#### 复制工作簿的嵌入式凭据

复制工作簿中嵌入的数据源的嵌入式凭据。仅在从 Tableau Server 迁移到 Tableau Cloud 站点时可用。有关详细信息，请参见[迁移包含嵌入式凭据的工作簿和数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_embedded_credentials.htm)。

**注意：**CMT 不支持 OAuth 连接的嵌入式凭证迁移。若要将 OAuth 凭据迁移到目标站点，请使用[“设置连接信息”](#plan_wkbk_data_trans)数据源转换。

#### 复制工作簿所有者

从源位置复制工作簿所有者设置以分配工作簿所有者。如果未选中，Content Migration Tool 用户将获得目标位置中工作簿的所有权。

#### 应用用户映射

应用用户映射来分配内容所有权。如果目标位置的用户名语法存在差异，请选择此选项。有关详细信息，请参见[迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)。

### 添加选项

为您可添加的不同类型的转换单击“Add Option”下拉菜单：

![用于添加工作簿发布选项的界面，包括标记管理和权限设置。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-pub-option-add.png)

对于所有不同类型的转换，有两个基本步骤。第一步是让您选择转换。在本例中，选择要转换的工作簿。选择区域类似于“规划”阶段的“工作簿选择”部分，具有“基本选择”单选按钮的所有功能：“Select/Unselect All”、“Refresh”、“Thumbnail Display”，以及“List Display”。在列表顶部，您可以选择“Select All”工作簿，这是一个用于自动选择所有工作簿以供将来转换的选项。您还可以刷新工作簿显示窗口以反映源站点的所有更改或更新。

![工作簿的标记添加界面，其中包含用于标记选择和应用的字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-workbook-pub-option-add-tags.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。**注意：**选项选项卡将具有不同名称，具体情况视所编辑的转换而定。

#### 添加标记

这允许您向工作簿中添加一个或多个标记。如果将鼠标指针悬停在以前输入的标记上，则会显示一个蓝色“X”以允许删除。

![“编辑选项”对话框，其中包含选择工作簿或添加标记的选项。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-tags-add.png)

#### 移除标记

这允许您向工作簿中添加一个或多个标记。如果将鼠标指针悬停在以前输入的标记上，则会显示一个蓝色“X”以允许删除。您也可以选择从源工作簿或目标工作簿中移除标记。

![用于从工作簿中移除标记的窗口。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-tags-remove.png)

#### 应用数据提取刷新计划

在这里，您可以将目标提取刷新计划应用于迁移的工作簿。生成的计划列表来自目标。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

![带有用于应用数据提取刷新计划的选项的对话框，包括月底、周六晚上和工作日清晨。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-sched-refresh.png)

#### 设置权限

此转换是编辑所选工作簿的权限。输入组或用户，然后单击“Add”。根据需要调整权限。四种不同选项为：“Allow 权限”、“Deny 权限”、“Inherit”，或“保留Source Value”。

![显示工作簿权限的窗口。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-permissions-set.png)

#### 设置“将缩略图生成为”

这样，您就可以设置迁移后将用于在工作簿缩略图中生成用户特定数据的用户或组。每个选项都有一个下拉列表，用于选择所需的用户或组。

![作为用户或组生成缩略图的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-workbook-thumbnail-gen.png)

## 步骤 6：继续下一步

选择工作簿和首选项后，单击“Next ”继续进行规划阶段的[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)部分。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=fc4a49689b504873f6b33ee7acbb531f231d32ff3cbf874bcf8022bfdbc36e7e url=/tableau/next/zh-cn/online/cmt-plan_datasources.md -->

[跳转到主要内容](#main-content)

# 迁移计划：已发布数据源

在 Tableau Content Migration Tool 中创建迁移计划的下一步是选择、映射并将任何转换添加到已发布数据源。该过程与规划阶段的“工作簿”步骤非常相似，特别是数据源映射步骤。

**注意：**如果您的工作簿或数据源包括数据提取，请确保阅读并理解[迁移包含数据提取的工作簿和数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_extracts.htm)中的信息。

## 步骤 1：选择

在开始迁移计划的“已发布数据源”阶段时，您将选择要包括在迁移计划中的任何数据源：

![数据映射的数据源选择。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-selection.png)

只有在迁移时才会选择数据源。您有两种选择方法。使用Specific Data Sources选择一个或多个已发布数据源。单击“Refresh ”重新载入可用已发布数据源的列表。

第二个选项是“All Data Sources”，它选择源站点中的每个数据源。

## 步骤 2：映射

下一步是将源数据源映射到新目标。这在功能上类似于映射工作簿。

![“数据源映射”页面，带有“添加映射”下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-mapping.png)

如果未处此处进行更改，则部署所选数据源时将采用与源相同的名称和项目。若要添加数据源映射，请单击“Add Mapping”。映射区域中将显示以下选项。

![包含名称、项目、目的地名称和目标项目字段的表单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-mapping-options.png)

该条目具有以下选项：

### 删除

单击“Delete ”链接将删除此映射条目。

### 名称

使用“Name ”菜单选择希望映射的数据源。可以选择“(All Selected Data Sources)”来选取所有数据源。

### 项目

“Project ”是关联数据源名称的项目。

### 目标名称

默认情况下，Content Migration Tool 将使用相同的Destination Name(Same As Source)，同时保留源文件中的原始名称，但您可以在此处为目标文件夹键入新名称。

### 目标项目

如果您的目标项目已在您的站点上创建，您可以选择放置迁移的工作簿的项目，或单击“Add New”创建一个新项目。您可以为单个数据源创建不同的目标项目。

![用于添加或修改数据源的表单，其中包含名称、项目、目标名称和目标流程字段。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-datasource-mapping-dest-proj.png)

在大多数情况下，如果单个数据源存在多个映射条目，则会显示验证错误，并且必须修复才能继续。这一点有一个重要的例外情况：数据源可以同时匹配特定选择和项目范围映射条目。在这种情况下，将使用更具体的条目。

完成所有必要的数据源映射后，单击“Next ”继续。

![下一步图标。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-icon-next.png)

## 步骤 3：数据源转换

您可以使用转换选项修改数据源。单击“Add Transformation”以查看可用转换的列表。

![用于添加转换的下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-transform-add-list.png)

选择任何数据源转换将打开“Edit Transformation”窗口。使用此功能来自定义所选数据源。转换将按其列出顺序从上到下执行。

对于大多数数据源转换，都有两个基本步骤。第一步是输入所需数据源的“Match Criteria”。根据所选的连接类型，“Match Criteria”选项卡上将显示更多字段。

![用于编辑转换的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-transform-edit-match.png)

第二步取决于您要添加的转换类型。每个数据源转换都有要在第二个选项卡上输入的不同值。

对于添加的每个转换，您可以在“Edit Transformation”窗口左侧的“Comments ”部分中添加注释。

### 替换表/架构名称

在“Options”选项卡上，您可以替换所有或部分表或架构名称。

### 设置计算公式

在“New Calculation Formula”选项卡上，您可以替换某个列的计算。

![用于在列转换设置中定义公式的界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-transform-set-calc.png)

### 设置连接信息

在“新建连接值”选项卡上，输入新数据源的身份验证方法和连接详细信息。根据所选的连接类型，将显示更多字段。

![标有“文件路径”的文本字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-transform-set-cx.png)

### 设置自定义 SQL

在“新建自定义 SQL”选项卡上，输入要为“匹配查询名称”修改的自定义 SQL 查询的名称。查询名称必须与数据源物理层的自定义 SQL 查询名称匹配。如果这些名称不匹配，则转换将失败。有关数据建模和物理层的详细信息，请参见[Tableau 数据模型](https://help.tableau.com/v0.0/online/zh-cn/datasource_datamodel.htm)。

输入查询名称后，在文本字段中输入所需的“自定义 SQL”。请注意，如果使用不当，自定义 SQL 可能会对工作簿的性能产生负面影响。

![一个标有“匹配查询名称”的文本框，和一个标有“自定义 SQL”的更大的文本框。](/tableau/next/zh-cn/online/zh-cn/Img/ptd-plan-transform-set-custom-sql.png)

### 移除数据提取

此转换没有“Options”选项卡。键入“Match Criteria”信息，系统将在迁移期间移除数据提取。

### 使用 Tableau Bridge

此转换没有“Options”选项卡。键入“Match Criteria”信息，系统将允许专用网络中的数据源（无法通过公共 Internet 访问）的数据源使用 Tableau Bridge 刷新。

在迁移数据源之前，目标 Tableau Cloud 站点必须配置 Tableau Bridge。有关 Tableau Bridge 的详细信息，请参见 Tableau Cloud 帮助中的[使用 Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。迁移后，需要通过 Tableau Cloud 为数据源分配刷新计划。

### 应用保存的凭据

在版本 2022.3 中已弃用。请改用“设置连接信息”数据源转换。

在选项选项卡上，为数据连接输入 Tableau 用户名和相应的已保存凭据用户名。您只能在 Tableau 站点的“帐户设置”页面上为现有数据连接应用保存的凭据。有关详细信息，请参见[为数据连接管理保存的凭据](https://help.tableau.com/v0.0/online/zh-cn/manage_stored_credentials.htm)。

![两个文本框请求 Tableau 用户名和已保存的凭据用户名。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-datasource-transform-saved-credentials.png)

## 步骤 4：发布选项

“已发布数据源”阶段的最后一步是为权限和标记创建转换，并完成特定于数据源的发布选项。

![“数据源发布选项”对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-options.png)

#### 覆盖较新的数据源

如果选中，即使数据源将覆盖最近更新过的数据源，也会Publisher该数据源。

#### 复制数据源权限

选中此选项时，迁移工具将尝试尽可能地匹配源忆发布的数据源权限。

#### 复制数据提取刷新计划

选中此选项时，迁移工具将尝试将目标数据源数据提取刷新计划设置为与源的名称相匹配。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

#### 复制数据源的嵌入式凭据

复制已发布数据源的嵌入式凭据。仅在从 Tableau Server 迁移到 Tableau Cloud 站点时可用。有关详细信息，请参见[迁移包含嵌入式凭据的工作簿和数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_embedded_credentials.htm)。

**注意：**CMT 不支持 OAuth 连接的嵌入式凭证迁移。若要将 OAuth 凭据迁移到目标站点，请使用[“设置连接信息”](#plan_datasrc_trans)数据源转换。

#### 复制数据源所有者

从源位置复制数据源所有者设置以分配数据源所有者。如果未选中，则 Content Migration Tool 用户被授予目标位置数据源的所有权。

#### 应用用户映射

应用用户映射来分配内容所有权。如果目标位置的用户名语法存在差异，请选择此选项。有关详细信息，请参见[迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)。

### 添加选项

为您可添加的不同类型的转换单击“Add Option”下拉菜单：

![用于添加或移除标记、应用数据提取刷新计划或设置权限的下拉菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-options-add.png)

对于所有不同类型的转换，有两个基本步骤。第一步是让您选择转换。在本例中，选择您要转换的数据源。在列表顶部，您可以选择“Apply to all published data sources”，该选项用于为将来的转换自动选择所有数据源。您还可以“Refresh ”数据源显示窗口，以反映对源站点所做的任何更改或更新。

![用于设置已发布数据源级别权限的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-perms.png)

第二步是为您选择的转换输入特定选项。

### 移除标记

选择了要从中移除标记的数据源之后，通过在位于底部的字段中输入标记来输入要移除的任何标记，并单击“Add”。在此屏幕中，您还可以选择从源或目标数据源中移除。如果要移除以前输入的标记，请单击该标记，然后按 delete 键。

![用于从已发布数据源中移除标记的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-tags-remove.png)

### 添加标记

选择了所需的数据源后，通过在位于底部的字段中输入标记来输入要分配的任何标记，并单击“Add”如果要移除某个标记，请单击该标记，然后按 delete 键。

![用于向已发布数据源中添加标记的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-tags-add.png)

此外，您还可以在“编辑转换”窗口左侧的“ Comments ”部分输入有关每个转换的注释。

### 应用数据提取刷新计划

此转换将目标数据提取刷新计划应用于迁移的数据源。生成的计划列表来自目标。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_limitations.htm)。

![用于应用数据提取刷新计划的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-extract-sched.png)

### 设置权限

最后一种转换类型是编辑所选数据源的权限。输入组或用户，并单击“Add”。根据需要调整权限。四种不同选项为：“Allow 权限”、“Deny 权限”、“Inherit”，或“保留Source Value”。

![用于设置已发布数据源级别权限的对话框。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-datasource-pub-perms-new.png)

## 步骤 5：继续下一步

准备就绪后，单击“Next”继续进行规划阶段的[迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)部分。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=a034ab7760ba8164a6bfa53257ac3f195c68f6e6ba0815579017405717db5e6c url=/tableau/next/zh-cn/online/cmt-plan_users.md -->

[跳转到主要内容](#main-content)

# 迁移计划：权限和所有权

Content Migration Tool 允许您将工作簿和数据源权限复制到不同的用户。在将内容发布到目标位置之后，您可以创建用户权限映射，以自定义和保护内容。如果已在规划阶段的早期与“应用用户映射”一起选择了Copy Project Permissions、Copy Workbook Permissions或Copy Data Source Permissions，则应用映射。

有关详细信息，请参见[迁移计划：源项目](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_source_projects.htm)、[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)和[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)。

## 映射限制

- 如果 Content Migration Tool 在目标位置中找不到映射的用户或组，它将停止迁移过程。第一次失败后不会检查后续用户或组权限映射，并且必须再次运行计划。
- 如果源内容具有多个具有相同名称的用户和组的权限，则 Content Migration Tool 无法复制权限。仅当存在来自单独域的重复用户或组名称时，才会发生这种情况。

## 步骤 1：添加映射

若要添加用户权限映射，请单击“Add Mapping”，并选择是更改域、用户、组的名称，还是从逗号分隔值 (CSV) 文件导入映射。如果 Content Migration Tool 无法在目标位置中匹配权限，则不会迁移源内容。

![用户映射附加界面，具有域、用户和组映射选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-add.png)

### 域映射

域权限映射适用于目标位置中的所有用户和组。如果您不确定源域或目标域，则可以在 Tableau 站点上检查用户和组页面。如果已选择本地用户预配，则必须将域指定为“`local`”。

![显示源域和目标域字段的域映射界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-domain-mapping.png)

### 用户映射

用户权限映射使用语法 `domain\user` 自动填充来自源和目标位置的用户列表。您不能输入和保存不存在的用户名。

**注意：**在同一站点上的项目之间迁移时，目标位置和用户列表将相同。您可以使用映射在站点上将内容所有权从 `User_A` 更新为 `User_B`。

![用户映射附加界面，具有域、用户和组映射选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-mapping.png)

### 组映射

组权限映射使用语法 `domain\group` 自动填充来自源和目标位置的用户列表。您不能输入和保存不存在的组的名称。

![显示源和目标组映射选项的编辑映射界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-group-mapping.png)

## 从 CSV 文件导入映射

从版本 2021.4 开始，您可以导入包含域、用户和组映射的 CSV 文件，以快速准备数据以进行迁移。导入映射允许您在 Content Migration Tool 外部批量创建和编辑映射，从而减少运行迁移计划所需的手动步骤。若要导入映射，请从“添加映射”菜单中选择“从文件导入”。

### CSV 文件格式要求

在创建用于导入映射的 CSV 文件时，请确保文件满足以下要求：

- 文件不包括列标题。Tableau 假设每一行都代表一个映射。
- 该文件每行包含三个逗号分隔值：映射类型、源域/用户/组以及目标域/用户/组。
- 如果服务器使用 Active Directory 身份验证或“本地”（假设使用了本地身份存储），则为用户名和组包括域。

您必须为映射类型指定“域”、“用户”或“组”，如下表所示。源和目标列提供 Active Directory 和本地身份存储的示例语法。CSV 文件中的实际值会因您的组织而异。

<table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><td style="font-weight: bold;">映射类型</td><td style="font-weight: bold;">源</td><td style="font-weight: bold;">Destination</td></tr><tr><td>domain</td><td><code>&lt;domain&gt;</code></td><td><code>&lt;domain&gt;</code></td></tr><tr><td>用户</td><td><code>&lt;domain&gt;</code>\<code>&lt;user name&gt;</code><br>local\<code>&lt;user name&gt;</code></td><td><code>&lt;domain&gt;</code>\<code>&lt;user name&gt;</code><br>local\<code>&lt;user name</code>&gt;</td></tr><tr><td>组</td><td><code>&lt;domain&gt;</code>\<code>&lt;group name&gt;</code><br>local\<code>&lt;group name&gt;</code></td><td><code>&lt;domain&gt;</code>\<code>&lt;group name&gt;</code><br>local\<code>&lt;group name&gt;</code></td></tr></tbody></table>

### 导入用户权限映射

在 Content Migration Tool 中导入用户权限映射：

1. 单击“添加映射”，然后选择“从文件导入”。
2. 在对话窗口中，单击“导出 CSV”以导出包含源站点中所有用户和组的 .csv 文件。在文本编辑器中编辑生成的文件以添加目标站点的映射。
    
    如果您已有映射文件，请跳至步骤 3。
    
    **注意：**导出的 CSV 文件不包括来自源站点的域。必须手动将域添加到 CSV 以创建域映射。
3. 单击“导入映射”并选择要导入的映射文件。

Content Migration Tool 将在导入文件时验证映射是否存在错误。如果检测到错误，您必须修复 CSV 文件中的每个错误，然后再次导入该文件。

### CSV 导入示例

以下示例显示了一个包含多种映射类型的 CSV 文件。

user,local\\hwilson,companyx.lan\\henry.wilson
user,local\\jjohnson,companyx.lan\\janna.johnson
user,local\\mkim,companyx.lan\\michele.kim
user,local\\fsuzuki,companyx.lan\\fred.suzuki
user,local\\awang,companyx.lan\\alan.wang
user,local\\snguyen,companyx.lan\\susan.nguyen
user,local\\lrodriguez,companyx.lan\\laura.rodriguez
user,local\\agarcia,companyx.lan\\ashley.garcia
group,local\\All Users,companyx.lan\\All Users
group,local\\Finance Team,companyx.lan\\Finance Group
domain,dev.mycompany,prod.mycompany

导入 CSV 时会显示一个预览窗口，其中显示已移除、已添加或更新、未更改和忽略的映射。检查映射更改是否正确，并单击“接受”。

![用户映射附加界面，具有域、用户和组映射选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-import-preview.png)

成功导入映射后，您可以编辑、删除或更改映射顺序，如步骤 2 中所述。

## 步骤 2：更改映射顺序

创建权限映射后，可以使用 Up 或 Down 选项更改顺序，以确定在迁移期间何时处理映射。当在权限映射中处理域、用户或组时，将忽略源域、用户或组的任何后续映射。

在下面的示例中，`User_A` 的权限映射到 `User_B`。 Content Migration Tool 将忽略第二个权限映射，因为已处理 `User_A`。

![用户映射界面，具有编辑、删除和重新排序映射的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-order_example.png)

在下面的示例中，第一个权限映射将所有用户的域关联到 `prod`。Content Migration Tool 将忽略第二个权限映射，因为已处理 `User_A` 的域。

![用户和域映射界面，具有编辑和重新排序选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-user-override_example.png)

## 步骤 3：继续下一步

准备就绪后，单击“Next ”继续进行规划阶段的[迁移计划：迁移脚本](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_scripts.htm)部分。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=1089e0011d072e6b407fbc42ccbea1eb7e3fe7809e4576a6c48abbaae8225ae9 url=/tableau/next/zh-cn/online/cmt-plan_source_projects.md -->

[跳转到主要内容](#main-content)

# 迁移计划：源项目

在 Tableau Content Migration Tool 中创建迁移计划的下一步是选择源项目。源项目是将从中迁移工作簿和已发布数据源的项目。您选择的项目确定在迁移计划的下一步中可以迁移哪些工作簿。

## 步骤 1：选择源项目

选择源项目时有两个选项：“ All Projects”和“Specific Projects”：

![用于选择所有要迁移的项目的界面，带有刷新选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-source-proj-select-all.png)

“All Projects”选项将从您在“服务器”步骤中指定的源站点中选择所有项目。“Specific Projects”选项允许您从源站点中选择特定项目。

**注意：**源项目必须包含工作簿或数据源。Content Migration Tool 不会迁移空项目。

![项目选择界面，其中包含选择要迁移的特定项目的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-source-proj-select-specific.png)

您可以单独选择每个项目，或者使用“Select All”按钮，然后为不想包括的项目清除选择。如果在进行此步骤时对源站点进行了任何更改，您可以使用“Refresh ”按钮来更新项目列表。

![标有“刷新”的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-source-proj-refresh.png)

## 步骤 2：选择项目选项

选择源项目后，选择要应用到目标位置的项目选项。除了从源位置复制项目权限和所有权之外，还可以选择创建不存在的项目。若要根据用户映射分配新的内容所有权，请选择“应用用户映射”。

![迁移项目中的项目创建和用户映射应用程序的选项菜单。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-source-proj-options.png)

- 创建目标项目：自动创建目标位置中不存在的项目。如果源项目为空或未选择工作簿或数据源，Content Migration Tool 将不会创建目标项目。默认情况下，尝试迁移到不存在的项目将导致迁移失败。
- 复制项目权限：尽可能接近地复制源项目权限。
- 复制项目所有者：从源位置复制项目所有权设置以分配项目所有者。
- 应用用户映射：应用用户映射以在目标位置中分配项目的内容所有权。如果目标项目已存在，则不会应用内容所有权。有关详细信息，请参见[迁移计划：权限和所有权](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_users.htm)。

## 步骤 3：继续下一步

选择源项目后，单击“Next”继续进行规划阶段的[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)部分。果您要在同一 Tableau 站点上的两个项目之间迁移工作簿，您将在下一部分中选择您的目标项目。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=d1c2efeebb0f6193d8337d24d3cd8ae5c4519ac7316cee19596a77fda163a77c url=/tableau/next/zh-cn/online/cmt-plan_servers.md -->

[跳转到主要内容](#main-content)

# 迁移计划：站点

在 Tableau Content Migration Tool 中创建迁移计划时的第一步是登录到源站点和目标站点。

在规划阶段的“Sites”部分，您将登录到源站点和目标站点。您使用的用户凭据的权限管理您在创建迁移计划时看到的站点和项目。您只能迁移用户有权访问的内容。

![用于在 Tableau 中选择源和目标连接的双面板界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-servers.png)

## 所需的权限和许可证

用于登录到源和目标站点的用户帐户必须具有 Explorer 角色或者更高级别角色，并对要迁移的内容具有以下权限：

- 查看
- 下载工作簿/保存副本
- 可选：管理员（选择工作簿、访问用户列表）

源站点和目标站点都必须具有 Advanced Management 容量。有关详细信息，请参见[关于 Tableau Cloud 上的 Tableau Advanced Management](https://help.tableau.com/v0.0/online/zh-cn/itm_intro.htm)。

## 步骤 1：源

这里是迁移的起点。登录到 Tableau Cloud，然后选择要用作源的_站点_。站点是在 Tableau 中创建的工作簿、数据和用户列表的独立孤岛，用于为所选用户将相关文件内容在一起。您一次只能从一个站点迁移内容。

### 登录到源站点

使用以下步骤登录到 Tableau Cloud 或 Tableau Server。有关使用单点登录和带有 MFA 的 Tableau 登录 Tableau Cloud 的详细信息，请参见[登录到 Tableau Cloud](https://help.tableau.com/current/online/zh-cn/to_signin.htm)。

1. 单击“登录到 Tableau”。
2. 在“选择连接”对话框窗口中，选择一个已保存的连接并单击“继续”。
    
    ![Tableau Cloud 的连接选择界面，带有编辑连接的选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-select-server.png)
    
    如果没有可用的连接，请单击“添加或编辑已保存连接”以添加新连接。有关详细信息，请参见[保存的连接](#saved-connections)。
3. 输入您的用户名和密码，并单击“登录”。
    
    如果针对 SAML 或单点登录配置了您的服务器，您将重定向到身份提供程序登录页面以完成身份验证过程。
4. 选择要使用的站点。
    
    ![带有搜索字段和可用站点列表的站点选择界面。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-servers-source-sites.png)

若要更改源服务器或更新您的站点选择，请单击“选择其他源”。

## 步骤 2：目标

为目标站点（要将内容迁移到其中的站点）重复登录过程。

如果要在同一 Tableau 站点上的两个项目之间迁移工作簿，则源和目标站点的登录凭据将会相同（包括服务器 URL 和站点名称）。

## 保存的连接

使用保存的连接，您可以通过创建可重用的连接来快速登录到源站点和目标站点。添加保存的连接时，您必须为您的站点指定首选登录方法。

Content Migration Tool 支持以下登录方法：

- **个人访问令牌：**允许用户创建长期存在的身份验证令牌，以提高迁移计划的安全性、审计和自动化。个人访问令牌让用户无需在 Content Migration Tool 中进行交互式登录即可登录。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。
- **基于浏览器的登录：**用户输入其凭据并通过嵌入式 Web 浏览器完成身份验证。此选项可能类似于您通常对 Tableau 进行身份验证的方式。
- **用户名和密码登录：**用户通过 Content Migration Tool 而不是嵌入式浏览器窗口进行身份验证。此选项使用 Tableau REST API 将凭据传递给服务器。您可以使用用户名和密码登录排除阻止使用基于浏览器的登录的问题。

### 添加或编辑已保存的连接

指向“Add or edit saved connections”的链接将显示在 Content Migration Tool 底部，并在登录源站点和目标站点时显示。单击此链接将打开“Manage Tableau Connections”窗口。

![Tableau 连接管理窗口，其中包含个人访问令牌、基于浏览器的登录以及用户名和密码登录选项。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-connections.png)

使用以下步骤添加保存的连接：

1. 在“管理 Tableau 连接”窗口中，单击“新建连接”，或选择现有连接进行更改。
2. 输入“连接名称”（用于描述您的服务器的名称）和“服务器 URL”。
    
    如果您不包括服务器 URL 的前缀，则 Content Migration Tool 将使用 `http://`。
3. 选择适用于您的连接的登录方法。
    
    如果您使用个人访问令牌，请参见[添加包含个人访问令牌的已保存连接](#add-saved-connections-with-personal-access-tokens)。
4. 单击“保存”。

创建保存的连接后，下次登录源站点和目标站点时，它会列在“选择连接”窗口中。

### 添加包含个人访问令牌的已保存连接

添加包含个人访问令牌的已保存连接需要比其他登录方法更多的信息。您需要在源站点和目标站点上创建一个新的个人访问令牌才能开始。个人访问令牌不应在应用程序之间共享。有关详细信息，请参见[个人访问令牌](https://help.tableau.com/v0.0/online/zh-cn/security_personal_access_tokens.htm)。

创建个人访问令牌

1. 在 Web 浏览器中，登录到您的 Tableau 站点。
2. 在页面顶部，单击个人资料图片或姓名首字母缩写，然后选择“我的帐户设置”。
3. 在“个人访问令牌”下的“令牌名称”字段中输入令牌的描述性名称，然后单击“创建新令牌”。
4. 在出现的窗口中，单击“复制到剪贴板”，然后关闭窗口。
5. 将令牌密文粘贴到文件中。将该文件存储在一个安全位置。

添加个人访问令牌

1. 在 Content Migration Tool 中，单击“添加或编辑保存的连接”。
2. 在“管理 Tableau 连接”窗口中，输入“连接名称”和“服务器 URL”。
    
    如果要连接到 Tableau Cloud，则必须输入站点的完整 pod URL。例如，`https://10ay.online.tableau.com`。登录到 Tableau Cloud 后，您的 pod 将显示在站点 URL 的第一部分。
3. 输入上一节中创建个人访问令牌时获得的个人访问令牌名称和个人访问令牌密文。
4. 在“站点名称”字段中，输入出现在 URL 中的站点名称，不带空格。这与友好站点名称不同。例如，“站点 A”在浏览器 URL 中将是“sitea”。
5. 单击“保存”。

## 步骤 3：继续下一步

成功登录源站点和目标站点后，单击“Next”以继续执行规划阶段的[迁移计划：源项目](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_source_projects.htm)部分。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=51e9fdaed03b9be2cc3a1e0981dab81aa1689a6a6547583ecec2241815d2c95a url=/tableau/next/zh-cn/online/cmt-plan_options.md -->

[跳转到主要内容](#main-content)

# 迁移计划：计划选项

在 Tableau Content Migration Tool 中创建迁移计划的最后一步是配置计划选项。

## 步骤 1：配置选项

![计划选项的设置，包括刷新数据提取、错误处理和自动创建计划](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-options02.png)

“Plan Name”是计划将显示在 Content Migration Tool 中的名称。我们建议您为计划名称使用用户友好的名称。

以下是可用选项：

- Refresh Extracts After Migration：如果选中此选项，则任何数据提取将在迁移之后立即刷新（如果 Content Migration Tool 检测到它们在迁移期间已修改）。单击“Filter ”链接排除特定数据提取。有关详细信息，请参见下面的[排除数据提取刷新](#exclude-extract-refreshes)。
- Automatically create Extract Refresh Schedules that do not Exist：自动创建不存在的目标数据提取计划。如果未选中，则不会复制目标站点上不存在的源计划。
- Continue Migration if Workbook or Data Source Fails：如果选中此选项，则迁移工作簿或数据源时的错误将不会导致迁移停止。将会记录错误，并且迁移将继续。版本控制期间的错误将始终会使迁移停止。
- 如果权限或所有权映射失败则继续迁移：如果选中，则复制权限或所有权时出错不会导致迁移停止。将会记录错误，并且迁移将继续。

### 排除数据提取刷新

通过单击“迁移后刷新数据提取”旁边的“筛选”，您可以选择不会自动刷新的工作簿或已发布数据源。使用箭头按钮选择要排除的项，然后单击“OK”。

![版本控制用于存档工作簿和已发布的数据源，以及将它们存档到哪里。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-options-exclude-extract-refresh.png)

## 步骤 2：版本控制

这些选项使您能够避免丢失目标站点中可能被迁移的工作簿替换的现有工作簿。

![版本控制用于存档工作簿和已发布的数据源，以及将它们存档到哪里。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-options-version-control.png)

选择“Enable ”保存以前版本的内容。您可以选择将工作簿和/或发布的数据源存档。启用版本控制后，您必须从“Archive To”菜单中选择一个选项，该菜单列出了站点中的所有项目。我们建议您创建一个单独的存档项目来存储您的版本控制内容。单击刷新按钮以显示站点上已添加或修改的任何项目。

## 步骤 3：保存计划

选择计划选项后，单击“Save Plan”保存您的计划以备将来使用。计划将保存到本地计算机上的 `Documents\Tableau Content Migration Tool Plans` 文件夹。

## 步骤 4：继续下一步

准备就绪时，单击“Verify & Run”结束“规划”阶段，并准备运行计划。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=40f51dff716edf8420583fe82c3fac0cc0e734c827e8f4d7412b7ac7a5dbd330 url=/tableau/next/zh-cn/online/cmt-plan_scripts.md -->

[跳转到主要内容](#main-content)

# 迁移计划：迁移脚本

Tableau Content Migration Tool 中迁移计划的下一步是创建要在迁移前后与计划一起运行的任何脚本。

## 步骤 1：迁移之前

屏幕的“Run Pre Migration”部分专用于将在迁移之前运行的脚本。

![启用运行预迁移的设置。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-script-pre.png)

每个字段都有一个帮助图标，可以通过将光标移到该图标上来从中获取信息。若要开始创建迁移前脚本，请选择“Enable”，它随后将激活下面的字段。

#### Working Directory

这是脚本的工作目录。默认目录与迁移计划位于同一文件夹中。单击浏览按钮可选择其他文件夹。“Reset ”按钮可将当前迁移计划文件夹恢复为工作目录。

#### Run

此下拉框允许您选择运行自定义脚本或带参数的可执行文件。

#### Command Executable

如果从“Run ”菜单中选择了“Executable with Parameters”，此字段将出现。这是要在迁移之前运行的命令可执行文件的文件路径。直接键入该路径，或使用浏览按钮查找可执行文件。这是必填字段。

#### Command Parameters

如果从“运行”下拉菜单中选择了“Executable with Parameters”，此字段将出现。在此处输入命令行参数，以便与命令可执行文件一起使用。

#### 脚本

如果从“运行”菜单中选择了“Custom script”， 请在此处输入您的迁移前脚本。它将作为 \*.cmd 文件执行。这是必填字段。

## 步骤 2：迁移之后

屏幕的“Run Post Migration”部分专用于将在迁移之后运行的脚本。

![用于配置迁移后脚本的界面，其中包含可执行文件和参数的字段。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-plan-script-post.png)

每个字段都有一个帮助图标，可以通过将光标移到该图标上来从中获取信息。若要开始创建迁移之后的脚本，请选择“Enable”，它随后将激活下面的字段。

#### Working Directory

这是脚本的工作目录。默认目录与迁移计划位于同一文件夹中。单击浏览按钮可选择其他文件夹。“Reset ”按钮可将当前迁移计划文件夹恢复为工作目录。

#### Run

此下拉框允许您选择运行自定义脚本或带参数的可执行文件。

#### Command Executable

如果从“Run ”菜单中选择了“Executable with Parameters”，此字段将出现。这是要在迁移之前运行的命令可执行文件的文件路径。直接键入该路径，或使用浏览按钮查找可执行文件。这是必填字段。

#### 命令参数

如果从“Run ”菜单中选择了“Executable with Parameters”，此字段将显示。在此处输入命令行参数，以便与命令可执行文件一起使用。

#### 脚本

如果从“Run ”菜单中选择了“Custom script”， 请在此处输入您的迁移之后的脚本。它将作为 \*.cmd 文件执行。这是必填字段。

## 步骤 3：继续执行下一步

准备就绪时，单击“Next”。

![下一步图标。](/tableau/next/zh-cn/online/zh-cn/Img/cmt-icon-next.png)

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

<!-- document id=933cc94ae24b5b0ea7646666e50097d2893a074f8ad42c7b468fd6118f005849 url=/tableau/next/zh-cn/online/cmt-migration_limitations.md -->

[跳转到主要内容](#main-content)

# 迁移限制

使用 Tableau Content Migration Tool 时存在一些迁移限制。在创建迁移计划之前，请查看以下部分以了解版本兼容性和不会迁移的内容。

## 与 Tableau 内容的兼容性

Content Migration Tool 支持迁移工作簿和保存在 Tableau 的八个最新版本中的已发布数据源。CMT 不支持在版本 2018.1.x 之前保存的工作簿和已发布数据源。有关详细信息，请参见[Tableau Content Migration Tool 入门指南](https://help.tableau.com/v0.0/online/zh-cn/cmt-getting-started.htm)。

如果内容包括以前版本无法识别的功能或格式，则将内容迁移到以前的 Tableau 版本可能会失败。如果发现不兼容，Content Migration Tool 将告知您，并且迁移将失败。

## 配置

使用 Content Migration Tool 时，以下配置不会迁移到目标站点。

- [用户](https://help.tableau.com/current/server/zh-cn/users_add.htm)
- [组](https://help.tableau.com/current/server/zh-cn/users_add_group.htm)
- [站点设置（自定义徽标、视图建议等）](https://help.tableau.com/current/server/zh-cn/sites_add.htm)

## 数据连接

尽管您可以迁移现有数据源，但在迁移过程中只能更改和修改使用下表中的连接类型的数据源。有关详细信息，请参见[迁移计划：工作簿](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_workbooks.htm)和[迁移计划：已发布数据源](https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm)中的“数据源转换”。

<table style="width: 100%;"><colgroup><col><col><col></colgroup><tbody><tr><td><p>Actian Matrix</p><p>Actian Vectorwise</p><p>Amazon Athena</p><p>Amazon Aurora</p><p>Amazon EMR</p><p>Amazon Redshift</p><p>Apache Drill</p><p>Aster Database</p><p>Box</p><p>Cloudera Hadoop</p><p>Delimited Text File</p><p>EXASOL</p><p>Firebird</p><p>Google Analytics（分析）</p><p>Google BigQuery</p><p>Google Cloud SQL</p></td><td><p>Google 云端硬盘</p><p>HortonWorks Hadoop Hive</p><p>HP Vertica</p><p>IBM DB2</p><p>IBM Netezza</p><p>Map R Hadoop Hive</p><p>Microsoft Access</p><p>Microsoft Analysis Services</p><p>Microsoft Excel</p><p>Microsoft Excel Direct</p><p>Microsoft OneDrive</p><p>Microsoft SQL Server</p><p>MySQL</p><p>OData</p><p>Oracle</p><p>Oracle Essbase</p></td><td><p>Pivotal Greenplum Database</p><p>PostgreSQL</p><p>Progress OpenEdge</p><p>Salesforce</p><p>SAP HANA</p><p>SAP Sybase ASE</p><p>SAP Sybase IQ</p><p>Snowflake</p><p>Spark SQL</p><p>统计文件</p><p>Tableau 数据提取</p><p>Tableau Server 数据源</p><p>Teradata</p><p>文本文件</p><p>Web 数据连接器</p><p>其他数据库 (ODBC)</p></td></tr></tbody></table>

## 不支持的内容

以下内容在使用 Content Migration Tool 时不会迁移到目标站点，并且需要额外的配置。

<table style="width: 100%;border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;margin-left: 0;margin-right: auto;" class="table--plain"><colgroup><col><col></colgroup><tbody><tr><td><b>内容</b></td><td><b>需要采取的行动</b></td></tr><tr><td>“数据问答”(Ask Data) 功能镜头</td><td>用户必须在目标站点上重新创建“数据问答”(Ask Data) 功能镜头。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/ask_data_lenses.htm" class="xref">创建针对特定受众聚焦“数据问答”(Ask Data) 功能的镜头</a>。</td></tr><tr><td>集合</td><td>用户必须在目标站点上重新创建集合。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/collections.htm" target="_blank">集合</a>。</td></tr><tr><td>注释</td><td>用户必须为目标站点上的视图重新添加注释。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/comment.htm" target="_blank">向视图添加注释</a>。</td></tr><tr><td>自定义视图</td><td>用户必须在目标站点上重新创建自定义视图。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/customview.htm" target="_blank">使用自定义视图</a>。</td></tr><tr><td>数据新鲜度策略</td><td>默认为发布时的站点默认值。如果需要特定的新鲜度策略，用户必须手动设置它。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 中的<a href="https://help.tableau.com/current/online/zh-cn/data_freshness_policy.htm" target="_blank">设置数据新鲜度策略</a>或 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 帮助中的<a href="https://help.tableau.com/current/server/zh-cn/data_freshness_policy.htm" target="_blank">设置数据新鲜度策略</a>。</td></tr><tr><td>数据角色</td><td>用户必须在目标站点上重新创建数据角色。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductPrepBuilder variable">Tableau Prep Builder</span> 帮助中的<a href="https://help.tableau.com/current/prep/zh-cn/prep_validate_data.htm" target="_blank">使用数据角色验证数据</a>。</td></tr><tr><td>数据源认证</td><td>如果您具有以下站点角色和能力，则可以对目标站点上的数据源进行认证。<ul><li><p>站点管理员 Creator</p></li><li><p>在包含数据源的项目上具有“项目主管”能力的 Creator 或 Explorer（可发布）</p></li></ul><p>有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/datasource_certified.htm" class="xref">使用认证来帮助用户查找受信任的数据</a>。</p></td></tr><tr><td>数据驱动型通知</td><td>用户必须为目标站点上的仪表板和视图重新创建数据驱动型通知。创建数据驱动型通知后，有权访问视图的任何人都可以将自己添加到现有通知中。<p>有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/data_alerts.htm" target="_blank">从 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 或 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 中发送数据驱动型通知</a>。</p></td></tr><tr><td>工作簿和数据源的描述</td><td>如果您是内容项所有者并具有适当的权限，您可以在目标站点上编辑项目的说明。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_content_page.htm" target="_blank">添加或编辑说明</a>。</td></tr><tr><td>嵌入式凭据</td><td><p>出于安全考虑，<span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 在下载过程中会从数据源中移除嵌入式凭据。</p><ul><li><p>若要在从 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 迁移到 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 时包括嵌入式凭据，请使用“迁移工作簿的嵌入式凭据”和“迁移数据源的嵌入式凭据”发布选项。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cmt-migration_embedded_credentials.htm" class="xref">迁移包含嵌入式凭据的工作簿和数据源</a>。</p></li><li><p>若要在发布到 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 站点时包括嵌入式凭据，请使用“设置连接信息”数据源转换。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/cmt-plan_datasources.htm" class="xref">迁移计划：已发布数据源</a>。</p></li></ul><p class="note"><b>注意：</b>CMT 不支持 OAuth 连接的嵌入式凭证迁移。若要迁移 OAuth 凭据，请使用“设置连接信息”数据源转换。</p></td></tr><tr><td>外部资产</td><td>外部资产的自定义属性不会迁移到目标站点。例如，必须重新创建标签、认证、数据质量警告、描述、权限、用户联系人、表和列。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/dm_perms_assets.htm" class="xref">管理外部资产的权限</a>。</td></tr><tr><td>数据提取刷新计划</td><td>数据提取刷新计划无法迁移到 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 目标站点。若要刷新 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span> 上的数据，您可以手动运行数据提取刷新或创建新的数据提取刷新计划。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/schedule_add.htm" class="xref">在 Tableau Cloud 上计划刷新</a>。</td></tr><tr><td>收藏夹</td><td>用户必须在目标站点上重新选择他们的收藏夹内容。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/favorites.htm" target="_blank">标记收藏夹</a>。</td></tr><tr><td>流程</td><td>若要按计划运行流程，用户必须使用 Tableau Prep 将流程重新发布到目标站点。有关详细信息，请参见 Tableau Prep 帮助中的<a href="https://help.tableau.com/current/prep/zh-cn/prep_conductor_publish_flow.htm" target="_blank">将流程发布到 <span class="mc-variable Variables.TabsProductServer variable">Tableau Server</span> 或 <span class="mc-variable Variables.TabsProductOnline variable">Tableau Cloud</span></a>。</td></tr><tr><td>增量数据提取刷新</td><td>在目标站点上，增量数据提取刷新更改为完全数据提取刷新。用户必须在 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 中重新配置增量刷新，并在迁移后将数据提取发布到目标站点。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm#configure-an-incremental-extract-refresh" target="_blank">刷新数据提取</a>。</td></tr><tr><td>指标</td><td><p>指标的历史值将从视图中移除，用户必须在目标站点上重新创建指标。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm" class="xref">创建指标并排查其问题（已停用）</a>。Tableau Cloud 的旧指标功能已于 2024 年 2 月停用，并将在 Tableau Server 版本 2024.2 中停用。有关详细信息，请参见<a href="https://help.tableau.com/current/online/zh-cn/metrics_create.htm">创建指标并排查其问题（已停用）</a>。</p></td></tr><tr><td>修订历史记录</td><td>若要将以前版本的工作簿迁移到目标站点，用户必须下载他们希望保留的版本并将工作簿重新发布到目标站点。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/qs_revision_history.htm" target="_blank">处理内容修订</a>。</td></tr><tr><td>订阅</td><td>用户必须在目标站点上重新订阅视图和工作簿。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/subscribe_user.htm" class="xref">创建视图或工作簿订阅</a>。</td></tr><tr><td>工作簿和视图的缩略图</td><td>使用 <span class="mc-variable Variables.PT_deploy variable">Content Migration Tool</span> 迁移的工作簿和视图将保留其原始缩略图，即使迁移计划包括会导致视图以不同方式呈现的转换（举例来说，如果数据连接发生变化）也是如此。<p>若要更新缩略图，请编辑目标站点上的工作簿或视图并加以保存。有关详细信息，请参见 <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> 帮助中的<a href="https://help.tableau.com/current/pro/desktop/zh-cn/web_author_build_view.htm" target="_blank">在 Web 上编辑 Tableau 视图</a>。</p></td></tr><tr><td><p>虚拟连接</p></td><td>用户必须在目标站点上重新创建虚拟连接。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_create_conn.htm" class="xref">创建虚拟连接</a>。</td></tr></tbody></table>

<!-- document id=d49bb5f24efeb616ef8e2de21dbecdb3d4af1d78b461a8a7e123148d542b44dd url=/tableau/next/zh-cn/online/connect_basic_initialsql.md -->

[跳转到主要内容](#main-content)

# 运行初始 SQL

**注意**：Tableau Prep Builder 版本 2019.2.2 及更高版本支持使用初始 SQL，但尚不支持 Tableau Desktop 支持的所有相同选项。有关将初始 SQL 与 Tableau Prep Builder 结合使用的信息，请参见 Tableau Prep Builder Salesforce 帮助中的[使用初始 SQL 查询您的连接](https://help.tableau.com/current/prep/zh-cn/prep_connect.htm#initial_SQL)。

连接到某些数据库时，您可以指定连接到数据库（例如，打开工作簿、刷新数据提取、登录到 Tableau Server 或发布到 Tableau Server）时运行或使用缓存值的初始 SQL 命令。

**注意：**初始 SQL 与自定义 SQL 连接不同。自定义 SQL 连接定义针对其发出查询的关系（或表）。有关详细信息，请参见[连接到自定义 SQL 查询](https://help.tableau.com/current/pro/desktop/zh-cn/customsql.htm)。

可使用此命令：

- 设置将在会话期间使用的临时表。
- 设置自定义数据环境。

您可以在“服务器连接”对话框中或在“数据源”页上选择添加初始 SQL 命令。

注意：如果您的数据源支持运行初始 SQL 语句，则“服务器连接”对话框的左下角中会出现“初始 SQL”链接。有关数据源的信息，请参见[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)。

## 使用初始 SQL

1. 在“服务器连接”对话框上，单击“初始 SQL”。或者，在“数据源”页面上，选择“数据”\>“初始 SQL”或“数据”\>“查询分段和初始 SQL”，具体取决于您要连接的数据库。
2. 在“初始 SQL”对话框中输入 SQL 命令。可使用“插入”下拉菜单将参数传递给数据源。
    
    ![初始 SQL 设置，其中有一个用于输入 SQL 语句的文本字段。](/tableau/next/zh-cn/online/zh-cn/Img/connect_basic_initialsql.png)

**注意：**Tableau 不会检查语句有无错误。在连接时，此 SQL 语句会发送到数据库。

您的软件许可证可能会限制您针对连接使用初始 SQL。如果发布到 Tableau Server，则必须对该服务器进行配置以允许使用“初始 SQL”语句。默认情况下，已将服务器软件配置为在 Web 浏览器加载工作簿时允许运行这些语句。

管理员可通过使用 `tsm configuration set` 命令将服务器配置为忽略初始 SQL 语句：

`tsm configuration set -k vizqlserver.initialsql.disabled -v true`

如果服务器不允许使用初始 SQL 语句，则该工作簿仍会打开，但不会发送初始 SQL 命令。

有关 `tsm configuration set` 命令的详细信息，请参见 [Tableau Server 帮助](https://help.tableau.com/current/server/zh-cn/cli_configuration_tsm.htm#TSMSet)。

## 初始 SQL 语句中的参数

您可以将参数传递给初始 SQL 语句中的数据源。下面列出了在初始 SQL 语句中使用参数的几个好处。

- 您可以使用 TableauServerUser 或 TableauServerUserFull 参数配置模拟。
- 如果您的数据源支持此功能，则可以设置行级别安全性（例如，针对 Oracle VPD 或 SAP Sybase ASE），以确保用户只看到他们有权看到的数据。
- 您可以在日志记录中提供更多详细，例如，Tableau 版本或工作簿名称。

初始 SQL 语句中支持以下参数：

<table class="table--plain"><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">参数</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">描述</span></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><span class="uicontrol">返回值的示例</span></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauServerUser</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">当前服务器用户的用户名。在服务器上设置模拟时使用。如果用户未登录到 Tableau Server，则返回空字符串。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">jsmith</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauServerUserFull</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">当前服务器用户的用户名和域。在服务器上设置模拟时使用。如果用户未登录到 Tableau Server，则返回空字符串。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">domain.lan\jsmith</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauApp</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau 应用程序的名称。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p><span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> Professional</p><p>Tableau Server</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><span class="uicontrol">TableauVersion</span></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">Tableau 应用程序的版本。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">9.3</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><span class="uicontrol">WorkbookName</span></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">Tableau 工作簿的名称。仅用于具有嵌入式数据源的工作簿。</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">Financial-Analysis</td></tr></tbody></table>

> [!WARNING]
> 
> **警告：**Tableau Desktop 不包含域。如果您不使用委派并设置 tsm configuration set -k DelegationUseFullDomainName=-v true--force-keys，则可以包括它

以下示例显示可以在初始 SQL 语句中使用参数的不同方式。

- 本示例在 Microsoft SQL Server 上设置安全上下文：
    
    `EXECUTE AS USER = [TableauServerUser] WITH NO REVERT;`
- 本示例表明如何在 DataStax 的数据源上使用参数将详细信息添加到日志记录或设置会话变量来跟踪数据：
    
    `SET TABLEAUVERSION [TableauVersion];`
- 本示例可用于帮助设置 Oracle VPD 的行级别安全性：
    
    `begin`
    
     `DBMS_SESSION.SET_IDENTIFIER([TableauServerUser]);`
    
    `end;`
    
    注意：Oracle PL/SQL 代码块需要一个尾随分号来终止代码块。请查阅 Oracle 文档以了解正确的语法。

### 针对服务器延迟执行

您可以延迟初始 SQL 语句，以便只在服务器上执行该语句。针对服务器延迟执行的一个原因是您没有权限执行设置模拟的命令。使用 <ServerOnly></ServerOnly> 标记将只在服务器上执行的命令括起来。

示例：

CREATE TEMP TABLE TempTable(x varchar(25));
INSERT INTO TempTable VALUES (1);
<ServerOnly>INSERT INTO TempTable Values(2);</ServerOnly>

### 安全性和模拟

如果在初始 SQL 语句中使用 TableauServerUser 或 TableauServerUserFull 参数，则您将创建一个不能与其他用户共享的专用连接。这也可能限制缓存共享，从而可以增强安全性，但也可能会降低性能。

## MySQL 和 Oracle 连接的“创建表”疑难解答

#### 对于 MySQL 连接，在使用初始 SQL 创建表后，表未列出

连接到 MySQL 并运行初始 SQL 语句后，则表可能会由于 Tableau 构建查询的方式而无法显示：

CREATE TABLE TestV1.testtable77(testID int);

若要解决此问题，请向 SQL 语句中添加 `IF NOT EXISTS`：

CREATE TABLE IF NOT EXISTS TestV1.TestTable(testID int);

#### 对于 Oracle 连接，使用初始 SQL 创建表会导致 Tableau 停止响应

当您连接到 Oracle 并运行初始 SQL 语句后，Tableau 会由于其构建的查询方式而停止响应，并显示不断旋转的滚轮。

CREATE TABLE TEST\_TABLE (TESTid int)

若要解决此问题，请使用以下 SQL 语句：

BEGIN
EXECUTE IMMEDIATE 'create table test\_table(testID int)';
EXCEPTION
WHEN OTHERS THEN NULL;
END;

<!-- document id=0ff3f15384058eb39147ea08d596c2ecb8d479c2252a83aaabf6e39cd55b77da url=/tableau/next/zh-cn/online/ipa_vconn_connect.md -->

[跳转到主要内容](#main-content)

# 连接到数据

在创建虚拟连接之前，您必须连接到数据。

1. 在“连接”窗格中，单击 ![添加连接](/tableau/next/zh-cn/online/zh-cn/Img/ipa_connect_button.png)。
2. 为您的数据选择连接器。
3. 输入提示您提供的信息。
4. 单击“登录”。若要添加更多连接，请重复这些步骤。然后开始创建虚拟连接。

关于[支持的连接器](https://help.tableau.com/current/pro/desktop/zh-cn/exampleconnections_overview.htm)的更多信息

## 相关任务

[关于虚拟连接编辑器](https://help.tableau.com/v0.0/online/zh-cn/ipa_vconn_about_editor.htm)

未找到您需要的内容？

联机查看[所有 Tableau 帮助](https://www.tableau.com/zh-cn/support/help)

<!-- document id=011944c3eb1016ac5fd6cbbef11ae9659c302f259b033b40f103036e4c1b2029 url=/tableau/next/zh-cn/online/to_bridge_vpc.md -->

[跳转到主要内容](#main-content)

# 连接到私有云数据

本主题介绍数据源所有者如何发布连接到云数据的数据源，如 Amazon Redshift 和 Snowflake，这些数据源只能从专用网络访问。

连接到私有云数据的数据源依赖于 Tableau Bridge 来使数据保持最新。在大多数情况下，Tableau Cloud 在发布过程中将自动检测是否需要 Bridge。但是，在某些情况下，您可能需要手动配置连接，以确保使用 Bridge。

发布连接到云数据的[虚拟连接](https://help.tableau.com/current/online/zh-cn/dm_vconn_create_conn.htm)时，无需额外步骤即可使用 Bridge。

本主题中描述的任务假定 Bridge 已设置，并且由站点管理员维护。

Bridge 支持使工作簿中嵌入的数据源的数据保持最新。请参见[使用嵌入式数据源](https://help.tableau.com/current/online/zh-cn/to_bridge_eds.htm)。

## 限制

对于某些基于私有云的数据源，Bridge 不支持实时连接。其中包括 Google Drive、Box、OneDrive、Dropbox 和 Azure Data Lake Storage Gen2。使用数据提取连接来使数据保持最新。连接到这些基于私有云的数据源时，请使用 Bridge 客户端版本 20224.23.0209.1653 或更高版本。升级客户端后，重新发布您的数据源。

## 为基于私有云的数据源设置计划

使用以下过程确保使用 Bridge 计划来使基于私有云的数据源的数据提取保持最新。

1. 按照 Tableau 用户帮助中[发布数据源](https://help.tableau.com/current/pro/desktop/zh-cn/publish_datasources.htm)主题中的步骤1-7 进行操作。
2. 如果尚未登录到 Tableau Cloud，请登录并导航到数据源。
3. 从数据源页面中，单击“连接”选项卡，并选中连接旁边的复选框。
4. 从连接旁边的“操作”下拉菜单中，选择“编辑连接”。
5. 在“网络类型”旁边的对话框中，选择“专用网络”单选按钮，并单击“保存”。
    
    ![“编辑连接”对话框，突出显示了网络类型选择，其中包括两个选项：“Tableau Online”或“私有网络”。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_site_editconnection_private.png)
    
    **关于切换网络类型**
    
    更改网络类型不会更改数据源的现有计划使用的网络类型。
    
    如果更改具有与其关联的现有计划的数据源的网络类型，则必须创建新计划。这也意味着，如果在更改网络类型之前创建了刷新计划，则必须在使用“立即运行”选项之前将其删除。有关删除刷新计划的详细信息，请参见[删除刷新计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#schedule_delete)。
    
    您可以继续执行下一步，以便在创建新的依赖于 Bridge 的刷新计划时自动删除以前的 Bridge 刷新计划。
6. 据您需要配置的计划，请执行以下步骤之一：
    
    - 对于 Bridge 刷新计划，请按照此处描述的步骤操作：[添加或更新现有计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#new_change_after_publish)。
    - 对于 Bridge 旧版计划，请按照此处描述的步骤操作：[添加新的或更新现有 Bridge 旧版计划](https://help.tableau.com/v0.0/online/zh-cn/to_sync_schedule.htm#Add)。
    
    **注意：**如果您以前设置了 Tableau Cloud 刷新计划，则在保存依赖于 Bridge 的计划时将其自动删除。
7. 单击“计划刷新”按钮。

## 发布使用实时连接、基于私有云的数据源

使用以下过程确保使用 Bridge 实时查询使基于私有云的数据源保持最新。

Bridge 不支持为某些基于私有云的数据源刷新与池的实时连接。有关详细信息，请参见[限制](#limitations)。[限制](#limitations)

1. 在 Tableau Desktop 中，创建数据源。
2. 选择“服务器”\>“发布数据源”以开始发布过程。如果您尚未登录到 Tableau Cloud，系统将提示您登录。
3. 在“将数据源发布到 Tableau Cloud”对话框中，配置各种数据源选项，并确保执行以下操作：
    
    - 在“身份验证”下，单击“编辑”并选择“嵌入式密码”。
    - 根据数据源连接到的数据或者您配置数据源的配置方式，该对话框可以默认发布实时连接，或为您提供发布实时连接或数据提取的选项。如果提供了选项，请选择“维护实时连接”。
4. 单击“发布”按钮。这将打开一个对话框。
5. 在对话框中，单击“使用 Bridge 发布”按钮。这将打开一个浏览器窗口，并显示 Tableau Cloud。
    
    ![Tableau Cloud 错误消息可能会建议将 Tableau Cloud 添加到授权数据提供商列表中。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_publish_vpc_live.png)
6. 在“发布完成”对话框中，单击“完成”按钮。
7. 从数据源页面中，单击“连接”选项卡，并选中连接旁边的复选框。
8. 在“网络类型”旁边的对话框中，如果未自动选择，请选择“专用网络”单选按钮，并单击“保存”。
    
    ![“编辑连接”对话框，突出显示了网络类型选择，其中包括两个选项：“Tableau Online”或“私有网络”。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_site_editconnection_private.png)

## 发布基于已启用 OAuth 的私有云的数据源

Tableau Bridge 在连接到使用 OAuth 的私有数据和使用 OAuth 的公共数据（如果其联接到私有数据）时支持 OAuth。对于大多数数据源，支持实时连接和提取的数据。有关 OAuth 支持的 Bridge 连接器的列表，请参见[身份验证](https://help.tableau.com/v0.0/online/zh-cn/to_sync_local_data.htm#Authenti)”。

**注意**：对于 Azure 数据源，当使用 OAuth 作为身份验证类型时，数据源必须通过 Tableau Cloud 而不是 Tableau Desktop 发布。

OAuth 支持保存的凭据或托管的密钥链连接器。功能类型取决于您使用的连接器。

1. 在 Tableau Desktop 中，连接到存放在私有云数据库中的数据。
2. 根据连接器，系统可能会提示您选择身份验证类型。如果提供了选项，请选择“使用 OAuth 登录”。
3. “数据源”页面将打开，以便您能够准备要分析的数据并开始构建视图。
4. 选择是作为实时连接发布还是作为数据提取发布。某些数据源（例如 Salesforce）不支持实时连接。
5. 对于数据提取，单击“工作表”选项卡以创建并保存数据提取。
6. 选择“服务器”\>“发布数据源”以开始发布过程。如果您尚未登录到 Tableau Cloud，系统将提示您登录。
7. 在“身份验证”下，单击选择身份验证类型。显示的选项取决于数据源。在大多数情况下，建议使用已保存的凭据。有关详细信息，请参见[使用保存的凭据刷新数据](https://help.tableau.com/v0.0/online/zh-cn/to_fresh_data_saved_credentials.htm)。

- 如果您在“我的帐户设置”中保存了凭据数据源，请选择“已嵌入”<_数据源名称_\>。
- 对于提取的数据，选择是否允许刷新访问。当您允许对数据提取进行刷新访问时，系统会提示您设置计划。若要计划刷新，您必须使用嵌入式凭据。

9. 当需要 Bridge 时，您的连接将在发布操作期间被检测为“私有”。若要更改网络连接状态，请单击“操作”菜单，然后选择“编辑连接”。

<!-- document id=021af5a215bab26d052dc535291d62c266fe33b6f66cea69eed1c26ae0610fe0 url=/tableau/next/zh-cn/online/private_connect_setup_aws_athena.md -->

[跳转到主要内容](#main-content)

# 适用于 Athena 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

- 您的 Tableau Cloud 站点和 AWS 托管的数据提供程序必须位于同一 AWS 区域。有关包含 Tableau Cloud pod 和关联区域的表，请参见 [Tableau Cloud 的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#ip-addresses-for-tableau-cloud)。

## 数据提供程序的 Tableau Cloud 信息

不适用。Amazon Athena 不需要端点服务配置。这意味着不必从 Tableau Cloud 获取身份和访问管理 (IAM) Amazon 资源名称 (ARN) 并将其添加到端点服务。

## Tableau Cloud 的数据提供程序信息

Tableau Cloud 需要 Amazon Athena 提供的端点服务名称。从 [Amazon Athena 端点和配额](https://docs.aws.amazon.com/general/latest/gr/athena.html)中的列表中选择站点区域的端点服务名称。（使用“endpoint”（端点）列。）

注意：反转域名元素，以使其符合 Tableau Cloud 的“创建专用连接”对话框中的预期“端点服务名称”格式。

**示例**

- **从 [Amazon Athena 端点和配额](https://docs.aws.amazon.com/general/latest/gr/athena.html)页面中：**  
    端点：athena.us-east-2.amazonaws.com
- **在“创建专用连接”对话框中：**  
    端点服务名称：com.amazonaws.us-east-2.athena

<!-- document id=7dddc83ab9abd628a6fcf00d3e71625a1838c536a5b4c678824c99d09c69ac5c url=/tableau/next/zh-cn/online/private_connect_setup_aws_aurora_mysql.md -->

[跳转到主要内容](#main-content)

# 适用于 Aurora MySQL 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. [创建 Aurora MySQL 数据库集群并连接到该集群](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.Aurora.html)
2. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Aurora MySQL 实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
3. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Aurora MySQL 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Aurora MySQL 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=1e582739e98bacb9e5515878e12d8f6ab0d8b6ef7831d0ab692eb27b78a7d254 url=/tableau/next/zh-cn/online/private_connect_setup_aws_databricks.md -->

[跳转到主要内容](#main-content)

# 适用于 Databricks 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

- 您的 Databricks 工作区采用支持前端 PrivateLink 的计划（例如，AWS 上的 Enterprise 层）。确认您的工作区满足 Databricks 主题[配置入站 PrivateLink](https://docs.databricks.com/aws/en/security/network/front-end/front-end-private-connect) 中描述的 Databricks 先决条件 。
- 您的 Databricks 工作区配置为前端 PrivateLink，具有附加到工作区的私有访问设置对象。有关详细信息，请参见 Databricks 文档中的[配置 入站 PrivateLink](https://docs.databricks.com/aws/en/security/network/front-end/front-end-private-connect)。

注意：通过私人连接连接到 Databricks 的 Tableau Cloud 连接支持以下身份验证方法：服务主体 (OAuth M2M) 和个人访问令牌 (PAT)。不支持其他身份验证方法（例如，通过外部身份提供程序进行的 OAuth）

## 数据提供程序的 Tableau Cloud 信息

Databricks 前端 PrivateLink 不需要在 Databricks 端配置端点服务以允许来自 Tableau Cloud 的连接。这意味着无需从 Tableau Cloud 获取身份和访问管理 (IAM) Amazon 资源名称 (ARN) 并将其添加到端点服务。

## Tableau Cloud 的数据提供程序信息

从 Databricks 帐户控制台中，获取：

- 端点服务名称：Tableau Cloud 站点的 AWS 区域的区域前端 VPC 端点服务名称（例如， `com.amazonaws.vpce.us-east-1.vpce-svc-1234567890abcdef1`）。这是由 Databricks 按区域发布的。查看 Databricks 主题[配置入站 PrivateLink](https://docs.databricks.com/aws/en/security/network/front-end/front-end-private-connect)了解您所在区域的服务名称。  
    
    注意：如果您的 Databricks 工作区和 Tableau Cloud 站点位于不同的 AWS 区域，请使用您的 Tableau Cloud 站点区域（而不是工作区区域）的端点服务名称。
- 工作区 URL：您希望 Tableau Cloud 连接到的工作区的默认工作区 URL（例如，`dbc-12345678-abcd.cloud.databricks.com`）。

获得值后，在 Tableau Cloud 的“创建专用连接”对话框中输入它们：

- 在“端点服务名称”字段输入端点服务名称。
- 在“自定义地址”字段中输入工作区 URL。

有关“创建专用连接”对话框的说明，请参见 Databricks 主题[配置入站 PrivateLink](https://docs.databricks.com/aws/en/security/network/front-end/front-end-private-connect)。

## 在 Databricks 中注册 VPC 端点

在 TCM 中创建专用连接后，Tableau 会预置一个 VPC 端点并为其分配 VPC 端点 ID。使用您的 Databricks 帐户注册此 VPC 端点 ID 以完成专用连接设置。

1. 在 TCM 中，找到专用连接并记录 VPC 端点 ID（例如，`vpce-1234567890abcdef1`）。
2. 在 Databricks 帐户控制台中，转到“Cloud resources”（云资源）>“VPC endpoints”（VPC 端点），然后选择“Add VPC endpoint”（添加 VPC 端点）。
3. 为端点命名，然后输入您在步骤 1 中记录的 TCM 中的 VPC 端点 ID。选择与您的 Tableau Cloud 站点区域匹配的 AWS 区域。
4. 将注册的 VPC 端点附加到工作区的私人访问设置（前端 VPC 端点列表）。

有关完整说明，请参见“为前端连接配置 AWS PrivateLink”。

Databricks 接受连接后，返回到 Tableau Cloud Manager。在专用连接的“操作”菜单 (...) 中，选择“同步” 观察状态是否会变为“就绪”。

注意：如果您需要对同一 Databricks 工作区进行公共和私有访问（例如，从 Tableau Cloud 进行私有访问，从用户浏览器进行公共访问），则在设置私人连接之前，必须在 Databricks 中配置[自定义工作区 URL](https://www.databricks.com/blog/announcing-public-preview-custom-urls)。配置自定义 URL 后，使用 Tableau Cloud Manager 中“自定义地址”字段中的默认工作区 URL，并确保在 Databricks 帐户控制台中工作区的私人访问设置中启用公共访问。

<!-- document id=89d83702bad5e1a2e4433fc52c0d009edc2ce94dd329cc8c29455cfbd68dfa75 url=/tableau/next/zh-cn/online/private_connect_setup_aws_dremio_server.md -->

[跳转到主要内容](#main-content)

# 适用于 Dremio Server 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

注意：不支持 Dremio Cloud。

1. 您在私有子网中有一个 AWS 托管的 Dremio 服务器。
2. [在实例前面创建网络负载均衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Dremio 服务器实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。
3. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Dremio 服务器实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Dremio 服务器和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=708afd66e3e86d79614b2f3d3009401e8f9b3d1f0e5d4ecebc983a737a0dd463 url=/tableau/next/zh-cn/online/private_connect_setup_aws_heroku.md -->

[跳转到主要内容](#main-content)

# 适用于 Heroku Postgres 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

注意：没有适用于 Heroku Postgres 的专用 Web 制作连接器。若要连接到 Heroku Postgres，最终用户可将专用连接中的连接地址与标准 Postgres 连接器一起使用。

## 先决条件

1. 在 Private Space 或 Shield Private Space 中运行的 Heroku 应用程序，并附加了 Heroku Postgres 数据库。
2. 您的 Tableau Cloud 站点和 Heroku Postgres 数据库必须位于同一 AWS 区域。有关包含 Tableau Cloud pod 和关联区域的表，请参见 [Tableau Cloud 的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#ip-addresses-for-tableau-cloud)。
3. 已预置 Heroku Postgres 端点。请参见[预置 Heroku Postgres 端点](https://devcenter.heroku.com/articles/heroku-postgres-via-privatelink#provisioning-the-heroku-endpoint)的步骤 1-3。

## 数据提供程序的 Tableau Cloud 信息

若要获取预置 Heroku Postgres 端点所需的帐号，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 从“IAM ARN”列中，_仅_复制 ARN 中的帐号和资源信息。举例来说，如果完整 ARN 为 `arn:aws:iam::012345678910:role/tab-private-connect`，请复制 `012345678910:role/tab-private-connect`。

## Tableau Cloud 的数据提供程序信息

请参见[步骤 4：获取端点的服务名称](https://devcenter.heroku.com/articles/heroku-postgres-via-privatelink#step-4-obtain-your-endpoint-s-service-name)（在 Heroku 的“通过 PrivateLink 连接到 Private 或 Shield Space 中的 Heroku Postgres”帮助主题中），获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

<!-- document id=0ce990c33e154ca0ce7f4411a9030cf3ba92a9547a5861cbbb92d8bb2a7867e4 url=/tableau/next/zh-cn/online/private_connect_setup_aws_mariadb.md -->

[跳转到主要内容](#main-content)

# 适用于 MariaDB 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 如果您的数据库托管在 RDS 中：[设置 Amazon RDS 环境](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SettingUp.html)
2. [创建并连接到 MariaDB 数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.MariaDB.html)
3. [在实例前面创建网络负载均衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 MariaDB 实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。
4. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 MariaDB 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 MariaDB 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=80bbebd8f6b380cdff69f54f0d4f6819214dac1955aae8ea3cb5729ccd892803 url=/tableau/next/zh-cn/online/private_connect_setup_aws_mssql.md -->

[跳转到主要内容](#main-content)

# 适用于 Microsoft SQL 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 如果您的数据库托管在 RDS 中：[设置 Amazon RDS 环境](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SettingUp.html)
2. [创建并连接到 Microsoft SQL 数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.SQLServer.html)
3. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Microsoft SQL 实例位于不同的区域，请确保负载平衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
4. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Microsoft SQL 实例位于不同的区域中，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Microsoft SQL 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=f0b7260ecbfb35085129d26312efadc33e202e42a8c19e0e8365ac53ff21a940 url=/tableau/next/zh-cn/online/private_connect_setup_aws_mysql.md -->

[跳转到主要内容](#main-content)

# 适用于 MySQL 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 如果您的数据库托管在 RDS 中：[设置 Amazon RDS 环境](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SettingUp.html)
2. [创建并连接到 MySQL 数据库实例](http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.MySQL.html)
3. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 MySQL 实例位于不同的区域，请确保负载平衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
4. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 MySQL 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 MySQL 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=62f6d4d627b85ffaecf0e498656a78035125a8fe895cff1a786cd4e3e60dcd62 url=/tableau/next/zh-cn/online/private_connect_setup_aws_oracle.md -->

[跳转到主要内容](#main-content)

# 适用于 Oracle 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 如果您的数据库托管在 RDS 中：[设置 Amazon RDS 环境](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SettingUp.html)
2. [创建并连接到 Oracle 数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.Oracle.html)
3. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Oracle 实例位于不同的区域，请确保负载平衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
4. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Oracle 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Oracle 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=ebf72b191146da09dda1a3622d5d4e83711b26d8670bf38d49159ff81a4bbe3b url=/tableau/next/zh-cn/online/private_connect_setup_aws_palantir.md -->

[跳转到主要内容](#main-content)

# 适用于 Palantir 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

- **您可以联系 Palantir 代表**来了解 Palantir 配置任务。
- **您有一个 Palantir 的自定义域。**有关详细信息，请联系您的 Palantir 代表了解有关获取自定义域的信息，并参见 Palantir 的文档：[配置域和证书](https://www.palantir.com/docs/foundry/administration/configure-domains-and-certificates)。
- **自定义域路由在 Tableau Cloud 中配置。**若要启动自定义域路由，请将上一个先决条件中的自定义域提供给您的 Tableau 客户成功经理。Tableau 端设置取决于产品发布计划，需要 2 到 8 周时间，具体取决于距离下一次发布还有多长时间。

## 数据提供程序的 Tableau Cloud 信息

您的 Palantir 代表在 Palantir 这边处理专用连接设置。您需要知道 IAM ARN 和 Palantir 应添加到允许列表中的 Tableau AWS 帐号。您还需要在先决条件中建立的自定义域。

### IAM ARN

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

### 帐号

Palantir 需要允许特定的 AWS 帐号进行连接。（这不是 IAM ARN 中的账号。）请与您的 Tableau 客户成功经理联系以获取此帐号。

## Tableau Cloud 的数据提供程序信息

在 Palantir 这边完成设置后，您的 Palantir 代表将为您提供端点地址。使用端点地址作为 Tableau Cloud 的“创建专用连接”对话框中的“端点服务名称”。有关详细信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

<!-- document id=bca658512f9a3c9df21bc7788a82a4ae0eed663107c18ec11e899cccaf99e0f5 url=/tableau/next/zh-cn/online/private_connect_setup_aws_postgresql.md -->

[跳转到主要内容](#main-content)

# 适用于 PostgreSQL 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 如果您的数据库托管在 RDS 中：[设置 Amazon RDS 环境](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SettingUp.html)
2. [创建并连接到 PostgreSQL 数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html)
3. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 PostgreSQL 实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
4. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 PostgreSQL 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 PostgreSQL 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=05c4c54928f503ee4cd55b034e8f408c8064ba7a08983fce1793034c9b9397fe url=/tableau/next/zh-cn/online/private_connect_setup_aws_redshift.md -->

[跳转到主要内容](#main-content)

# 适用于 Redshift 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

注意：私人连接不支持 Redshift 管理的专用链接。

1. [在 VPC 的私有子网中创建 Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/getting-started-cluster-in-vpc.html)
2. [在实例前面创建网络负载平衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Redshift 实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。如果您的负载平衡器部署在多个 AWS 可用区中，请启用跨区域负载平衡。
3. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Redshift 实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Redshift 和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=a984a75fafdca2ad1ab01641b4e9828d9408904609a31723ab8752172136f4ec url=/tableau/next/zh-cn/online/private_connect_setup_aws_snowflake.md -->

[跳转到主要内容](#main-content)

# 适用于 Snowflake 的出站私人连接

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

- 您的 Snowflake 版本是 Business Critical Edition。
- 您的 Snowflake 帐户至少有一个仓库。
- 如果使用 OAuth，请使用外部 OAuth 提供程序，而不是 Snowflake OAuth。有关将外部 OAuth 提供程序与 Snowflake 结合使用的详细信息，请参见 [Snowflake 的外部 OAuth](https://help.tableau.com/current/pro/desktop/zh-cn/snowflake_oauth_idp.htm)。
- 可选但方便：您可以访问 Snowflake 帐户管理员用户来执行 Snowflake [SYSTEM$GET\_PRIVATELINK\_CONFIG 函数](https://docs.snowflake.com/en/sql-reference/functions/system_get_privatelink_config)。如果没有，您可以在需要时从 Snowflake 支持部门获取相关信息。

## 数据提供程序的 Tableau Cloud 信息

Snowflake 支持需要 IAM ARN 来启用 PrivateLink。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

获得 IAM ARN 后，开立一个 Snowflake 支持案例。要求启用 PrivateLink，并向他们提供 IAM ARN 以允许通过其进行连接。

## Tableau Cloud 的数据提供程序信息

以 Snowflake 帐户管理员身份调用 [SYSTEM$GET\_PRIVATELINK\_CONFIG 函数](https://docs.snowflake.com/en/sql-reference/functions/system_get_privatelink_config)，并从输出中获取以下值：

- privatelink-vpce-id
- privatelink-account-url

如果您无权访问 Snowflake 帐户管理员帐户，请使用您的 Snowflake 支持案例并询问 **privatelink-vpce-id** 和 **privatelink-account-url** 的值。

获得值后，在 Tableau Cloud 的“创建专用连接”对话框中输入它们：

- 在“端点服务名称”字段中输入 **privatelink-vpce-id** 的值。
- 在“自定义地址”字段中输入 **privatelink-account-url** 的值。

<!-- document id=9654214c5d30e3f8cf2de91df8389e04f16fcba436690b4469ff977a0d233dfc url=/tableau/next/zh-cn/online/private_connect_setup_aws_teradata_cloud.md -->

[跳转到主要内容](#main-content)

# 适用于 Teradata Vantage Cloud 的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 您可以访问 Teradata Vantage Cloud 数据库。
2. 您可以联系 Teradata 管理员。
3. 您的 Tableau Cloud 站点和 Teradata Vantage Cloud 数据库位于同一 AWS 区域。有关包含 Tableau Cloud pod 和关联区域的表，请参见 [Tableau Cloud 的 IP 地址](https://help.tableau.com/v0.0/online/zh-cn/to_keep_data_fresh.htm#ip-addresses-for-tableau-cloud)。
4. 您的 Teradata Cloud 管理员已执行 Teradata 文档的以下部分中的步骤：

- [为 AWS 设置 PrivateLink](https://docs.teradata.com/r/Lake-Getting-Started-with-VantageCloud-Lake/First-Sign-On-by-Organization-Admin-Create-an-Environment/Step-2-Set-the-Environment-Connection-Type/Set-Up-PrivateLink-for-AWS)（若要获取要添加到 “允许列表帐户”的帐号，请参见[数据提供程序的 Tableau Cloud 信息](#Tableau)。）
- [为 AWS 创建端点](https://docs.teradata.com/r/Lake-Getting-Started-with-VantageCloud-Lake/First-Sign-On-by-Organization-Admin-Create-an-Environment/Step-2-Set-the-Environment-Connection-Type/Set-Up-PrivateLink-for-AWS/Create-Endpoints-for-AWS)

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。您的 Teradata 管理员还需要适用于 AWS 区域的 Tableau 帐号。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

若要获取帐号，请执行以下操作：

1. 将 IAM ARN 粘贴到您可以看到所有内容的位置（如文本编辑器）。
2. 在 IAM ARN 中查找帐号。它是中间的一串数字。例如：

- ARN：`arn:aws:iam::012345678910:role/tab-private-connect`
- 帐号：`012345678910`

将帐号提供给 Teradata 管理员。

## Tableau Cloud 的数据提供程序信息

在您的 Teradata Cloud 管理员执行“先决条件”部分中的步骤后，他们可以为您提供端点地址。使用端点地址作为 Tableau Cloud 的“创建专用连接”对话框中的“端点服务名称”。

<!-- document id=ccd6bf6808b64daadd03e1b6996fc4ff4809ee0d214c791ebff64a5e36850d44 url=/tableau/next/zh-cn/online/private_connect_setup_aws_teradata_server.md -->

[跳转到主要内容](#main-content)

# 适用于 Teradata Vantage 本地部署的出站私人连接

> [!WARNING]
> 
> 自 2025 年 10 月 14 日起，Data Cloud 已更名为 Data 360。在此过渡期间，您可能会在我们的应用程序和文档中看到对 Data Cloud 的引用。虽然名称是新的，但功能和内容保持不变。

本主题介绍特定于数据提供程序的设置信息。有关设置专用连接的一般信息，请参见[出站私人连接](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_overview.htm)；有关设置 Tableau Cloud 端点的信息，请参见[出站专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)。

## 先决条件

1. 您在私有子网中有一个 AWS 托管的 Teradata Vantage 本地部署服务器。
2. [在实例前面创建网络负载均衡器](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancers.html)。如果您的 Tableau Cloud 站点和 Teradata 服务器实例位于不同的区域，请确保负载均衡器部署在多个 AWS 可用区中。
3. [为网络负载均衡器创建 VPC 端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。如果您的 Tableau Cloud 站点和 Teradata 服务器实例位于不同的区域，请确保您的 Tableau Cloud 站点的区域位于端点服务的“支持的区域”选项卡中。

## 数据提供程序的 Tableau Cloud 信息

需要将 IAM ARN 添加为 AWS 中端点服务上允许的主体。

若要获取 IAM ARN，请执行以下操作：

1. 登录 Tableau Cloud Manager (TCM)。
2. 转到“设置”。
3. 选择“私人连接”选项卡。
4. 展开“IAM 区域和 ARN”。
5. 查找您的 Tableau Cloud 站点的区域。
6. 在“操作”菜单 (...) 中，选择“复制 IAM ARN”。

复制 Tableau Cloud 的 IAM ARN 后，按照[配置端点服务](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#add-remove-permissions)中的说明允许它作为端点服务上的允许主体。

## Tableau Cloud 的数据提供程序信息

使用 AWS 管理控制台或 AWS CLI 获取 Tableau Cloud 的“创建专用连接”对话框所需的端点服务名称。

## 替代方法

作为“先决条件”和后续部分中高级步骤的替代方法，您可以使用[借助 Salesforce Data Cloud 和 Amazon Redshift 的私人连接增强 Agentforce 数据安全性 – 第 3 部分](https://aws.amazon.com/blogs/big-data/enhance-agentforce-data-security-with-private-connect-for-salesforce-data-cloud-and-amazon-redshift-part-3/)博客文章，了解有关配置 Redshift 和 Salesforce Data Cloud 之间的专用连接的信息。按如下所述调整说明以改用 Teradata Vantage 本地部署服务器和 Tableau Cloud。

在博客文章中，完全按照以下部分中的说明进行操作：

- 为网络负载均衡器创建安全组
- 创建目标组
- 创建负载均衡器

然后，从博客文章的“创建端点服务”部分：

- 不要使用步骤 9-12，而是使用上面的[数据提供程序的 Tableau Cloud 信息](#private-connect-info-for-data-provider)部分来获取 IAM ARN。
- 在步骤 14 中，将允许的主体添加到端点服务时，使用 IAM ARN 代替主体 ID。
- 在步骤 15 中，记下端点服务名称。
- 对于步骤 17 及之后的步骤，按照[专用连接设置：Tableau Cloud](https://help.tableau.com/v0.0/online/zh-cn/private_connect_setup_tableau_cloud.htm)在 Tableau Cloud 中设置专用连接。

<!-- document id=62461de0cd3b771d695ead3189d302597b6326b313e409e26ad39573924f87fc url=/tableau/next/zh-cn/online/data_connect_intro.md -->

[跳转到主要内容](#main-content)

# 适用于私有网络数据的 Data Connect

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

Data Connect 是面向 Tableau Cloud Enterprise 和 Tableau+ 客户的付费订阅服务。购买 Data Connect 后，站点管理员将能够在 Tableau Cloud 的设置页面中配置该服务。

Tableau Bridge 提供了一种访问位于公司防火墙后面或锁定在虚拟私有云内的私有网络数据的方法。与 Tableau Cloud 建立连接后，Bridge 会在请求到达时查询您的本地数据，并将私有结果发送回 Tableau Cloud。

与 Tableau Bridge 类似，Data Connect 提供对私有网络数据的访问，但提供远程管理、监控和简化的解决方案来连接您的本地数据。

![Data Connect 环境的各种组件以及管理这些组件的责任。](/tableau/next/zh-cn/online/zh-cn/Img/data_connect-security_656x447.png)

Data Connect 采用责任共担模式运行。使用此模式，您提供计算资源，这些资源由托管在您的环境中的 Data Connect Kubernetes 群集组成，而 Tableau 负责管理该群集。Tableau 通过远程管理、监控和维护 Kubernetes 群集来减少管理开销。由于能够执行补救措施以实现持续可用性，Tableau 无需监控流量和连接状态。此外，为了减少延迟和降低网络拥塞，Data Connect 允许您确定最符合您的性能要求的数据中心和边缘位置和环境。

## 此部分中的其他文章

<!-- document id=20d05b8a87f2943f781385e7b07312a9d1da6df72edeee53e87294b01a8b967f url=/tableau/next/zh-cn/online/data_stories_story_types.md -->

[跳转到主要内容](#main-content)

# 选择适用于您的 Tableau Desktop 数据故事的正确故事类型

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

当您[将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)时，为您的数据选择正确的故事类型很重要。您是否需要关于一段时间内的趋势的故事？或者您是否需要关于正在比较的两个值的故事？为了帮助您讲述正确的故事，本主题描述了不同类型的故事，包括每种故事类型的示例。

## 连续

连续故事最适合分析一段时间内的趋势或进展。

当您创建一个连续故事时，它包括性能、细分、波动和趋势线的内容。该故事还包括使用多个维度的故事的贡献分析和相关性。若要使用连续故事，您的工作表必须有：

- 具有 1-10 个度量的 1 个维度
- 2 个维度和最多 3 个度量

以下示例是具有单个维度和多个度量的折线图的连续故事：

![带有连续故事示例的三个折线图](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_continuous.png)

## 离散

离散故事最适合比较值和了解每个值中数据的分布。创建离散故事时，该故事包括有关数据分布和分组或群集的内容。这个故事包括对使用多个维度的工作表的贡献分析。

当您想要执行以下操作时，请考虑使用离散故事：

- 了解销售报告中关键绩效指标 (KPI) 的驱动因素。
- 在数据发现过程中快速识别和了解异常值。
- 识别在执行审计时不容易在视觉上观察到的趋势。
- 立即发现复杂的利用率洞察以进行地理分析。
- 识别并指出关键关系，例如销售额和利润之间的关系。

若要使用离散故事，您的工作表必须有：

- 具有 1-10 个度量的 1 个维度
- 2 个维度和最多 3 个度量

以下示例是具有单个维度和两个度量的条形图的离散故事：

![带有离散故事示例的条形图](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_discrete.png)

## 整体百分比

整个百分比故事的最适合饼图。若要使用整体百分比故事，您的工作表必须有：

- 1 个维度
- 1 个度量

以下示例是使用具有单个维度和单个度量的饼图的整体百分比故事：

![具有整体百分比故事示例的饼图](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_percent.png)

## 散点图

散点图故事最适合了解两个度量之间的关系。创建散点图故事时，该故事包含有关两个度量之间的关系（回归）的内容。故事包括关于数据中存在的组（群集）的内容。

当您想要执行以下操作时，请考虑使用散点图故事：

- 找出两个度量之间的关系以识别影响（回归分析）。
- 识别和了解高于或低于所定义阈值的异常值。
- 分析您的数据的分布方式。

若要使用散点图故事，您的工作表必须有：

- 1 个维度
- 2 或 3 个度量

**注意：**当您创建散点图故事时，您选择的第一个度量被视为自变量，第二个度量是因变量。

以下示例是一个散点图故事，它使用具有单个维度和两个度量的散点图：

![带有散点图故事示例的散点图](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_scatter.png)

<!-- document id=d64771ff239ce4f9014fe205c2727c10b1351e0c31fd401bcf35134418038805 url=/tableau/next/zh-cn/online/prep_conductor_subscribe_to_flow.md -->

[跳转到主要内容](#main-content)

# 通知用户流程运行成功

_在 Tableau Prep Builder 版本 2021.4.1 及更高版本以及 Tableau Server 和 Tableau Cloud 版本 2021.4 及更高版本中受支持。使用此功能需要 Data Management。_

流程所有者可以为自己、个人用户和组订阅电子邮件通知，以获取有关成功运行流程的计划任务的信息。电子邮件包含 Tableau 环境中数据的链接，并且在 Tableau Server 中，可以选择在附加的 Excel 和 CSV 文件中包含流程运行的详细信息。

流程订阅会添加到流程的计划任务中。您可以在创建新流程任务添加流程订阅，或将流程订阅添加到现有流程任务。计划任务成功完成时发送电子邮件通知。

## 配置流程订阅的站点设置

默认情况下，启用用于发送和接收电子邮件通知的“流程订阅”站点设置。

![“流程订阅”站点设置，显示已选中的发送和接收电子邮件通知复选框。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_site.png)

- “允许用户发送或接收包含流程输出数据的电子邮件”选项允许流程所有者接收，并为用户和组订阅流程成功运行通知。通过通知电子邮件，用户可以访问完整的数据源或从 Tableau 中查看流程详细信息。
- 仅限 Tableau Server（不推荐）：“附加 .csv 和 .xlsx 流程输出文件”选项允许流程所有者将文件附加到通知电子邮件。必须将电子邮件收件人添加到 Tableau 服务器，但是，这些文件包含数据源并且可能会在 Tableau 系统之外公开。此选项仅适用于本地环境。

## 发布流程

将流程输出发布为文件、数据库表或数据源。保存流程时请考虑以下事项：

- （仅限本地部署）发布时，您可以将输出另存为文件或数据库表，然后选择将 .csv 或 .xlsx 文件类型附加到电子邮件。
- 将输出发布并保存为已发布数据源时，电子邮件通知会提供指向 Tableau 中流程的链接。不能将文件附加到电子邮件。
- 选择另存为文件输出时，您必须使用网络共享，并且输出和输入位置必须包含在允许列表中。有关详细信息，请参见[步骤 4：允许列表输入和输出位置](https://help.tableau.com/current/server/zh-cn/prep_conductor_configure_network_shares.htm)。
- Windows 和 Linux 支持流程订阅。以下限制适用于 Linux 上的流程订阅：
    
    - 文件输出必须输出到 Windows 服务器。
    - 对于输出到文件的流程，请使用 UNC 格式的路径：\\\\服务器\\路径\\文件名。不要使用本地驱动器号。
    - 安装的路径必须安全列出。
- 将文件附加到电子邮件时，Tableau Cloud 的文件限制约为 25 MB。使用本地 Tableau Server 时，您可以配置附件文件的大小。

## 添加流程订阅

1. 作为流程的所有者，在 Tableau Server 或 Tableau Cloud 中选择您要为其添加电子邮件通知订阅的已发布流程。
2. 您可以向新任务或现有任务中添加订阅：
    - 如果您要向新任务中添加订阅：
        1. 单击“计划任务”\>“新建任务”。
        2. 在“新建任务”对话框中，从“选择计划”下拉列表中选择一个计划来运行流程。
        3. 启用“完成后发送电子邮件”

- 如果您要向现有任务中添加订阅：
    1. 单击“订阅”\>“订阅”。
    2. 在“添加流程订阅”对话框中，从“频率”下拉列表中选择一个计划。

4. 在“发送至”字段中，开始键入用户或组的名称以填充该字段。选择要向其发送通知的用户和组。
    
    用户和组必须由管理员添加到 Tableau 环境中。
5. （可选）若要包含在通知中，请选中“发送给我”框。
6. （可选）在“主题”字段中，自定义流程运行通知的默认电子邮件主题行。
7. （可选）在“电子邮件消息”文本框中添加有关流程运行的信息。
8. 单击“包括输出数据”并选择要包括在电子邮件中的输出类型。

- 在 Tableau Server 中，如果您将流程发布为文件或数据库表输出，您可以选择将包含数据源的 .csv 或 .xlsx 文件附加到电子邮件。不建议这样做，因为数据可能会暴露在 Tableau 系统之外。
![将流程输出发布为文件或数据库表时，用于将数据源作为附件包含在内的复选框。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_text_out.png)- 如果您将流程发布为数据源，您可以选择包含指向数据源的链接。不支持将文件附加到电子邮件。
![将流程输出发布为数据源时，用于包含指向数据源的链接的复选框。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_pub_data.png)

10. 如果要向现有任务添加订阅，请单击“订阅”。

## 取消订阅流程订阅

若要取消订阅电子邮件通知，请按以下步骤操作。

1. 单击订阅电子邮件底部的“取消订阅”。
2. 以流程所有者身份登录到 Tableau Server 或 Tableau Cloud。在页面的顶部，单击“通知”图标。
3. 展开“...”菜单，然后选择“移除通知”。

若要以流程所有者身份取消订阅和移除订阅，请按以下步骤操作。

1. 单击“订阅”。
2. 在 Tableau Server 或 Tableau Cloud 上打开已发布流程。
3. 从流程订阅列表中，单击要取消订阅的流程的选择框。
4. 选择“操作”\>“取消订阅”。

![“订阅”选项卡的“操作”菜单，显示“取消订阅”选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_unsbscribe.png)

## 查看订阅

您可以在 Tableau Server 或 Tableau Cloud 中查看您当前的流程订阅。

- 从流程的“概览”页面上的“订阅”选项卡中，您可以查看当前订阅的列表。
- 从“任务”页面上的“订阅”选项卡中，您可以查看订阅列表以及对工作簿的订阅。

## 恢复挂起的流程订阅

有时，订阅会因为流程问题而失败。如果订阅失败超过五次，您将会收到一封通知电子邮件，指明您的计划流程任务已挂起。

在流程“概览”页面中，您可以查看计划流程任务何时失败。

![流程“概览”页面，显示流程运行的详细信息，包括输出步骤、输出名称、状态、计划和错误。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_overview.png)

有几种方法可以恢复挂起的流程任务。如果您是流程所有者：

- 从 Tableau 网页的“我的内容”区域中，一个图标出现在“上次更新”列中，指明订阅已挂起。选择“...”\>“恢复计划任务”以进行恢复。
    
    ![用于恢复挂起的流程任务的菜单选项，其中突出显示“恢复计划任务”选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscription_resume.png)
- 从“计划任务”页面中，一个图标出现在“上次更新”列中，指明订阅已挂起。选择流程，然后单击“操作”\>“恢复”。![“计划任务”选项卡的“操作”菜单，显示“恢复”选项。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_resume_task.png)

## 从通知电子邮件中访问流程数据

根据流程通知的配置方式，您可以从通知电子邮件中访问数据源和文件附件。

- 单击“查看流程”以在 Tableau Server 或 Tableau Cloud 中打开流程。
- 单击附件文件可查看流程数据。

![确认流程成功执行的电子邮件通知。该电子邮件提供了有关流程、其数据源和发件人的详细信息。](/tableau/next/zh-cn/online/zh-cn/Img/prep_conductor_subscribe_email.png)

### 谁可以执行此操作

- 流程所有者可以为其拥有的流程创建流程通知订阅。
- 若要接收通知，管理员必须将用户和组添加到 Tableau 环境中。

有关详细信息，请查看以下文章：

- Windows：[设置用户的站点角色](https://help.tableau.com/current/server/zh-cn/users_site_roles.htm)以及[内容权限和所有权](https://help.tableau.com/current/server/zh-cn/permissions.htm)
- Linux：[设置用户的站点角色](https://help.tableau.com/current/server-linux/zh-cn/users_site_roles.htm)以及[内容权限和所有权](https://help.tableau.com/current/server-linux/zh-cn/permissions.htm)

<!-- document id=5658d2917905530fb7762510cec4ad503b3cbfd7194e3f4f1d4cd56c977cad90 url=/tableau/next/zh-cn/online/to_sync_signout_unlink.md -->

[跳转到主要内容](#main-content)

# 通过 Bridge 停止使数据保持最新

运行 Bridge 计划时，您可以停止通过 Tableau Bridge 刷新数据。

如果停止使用 Bridge，则依赖于 Bridge的数据源的视图将不再显示数据，而是会生成空白页面。

Bridge 旧版计划不支持虚拟连接的刷新。

## 更改刷新的连接类型以使用 Tableau Cloud

默认情况下，当已发布数据源具有多个数据连接时，Tableau Cloud 使用 Bridge。多种数据连接类型是至少具有一个公共云连接和一个本地连接的数据源。您可以编辑 Bridge 刷新计划的数据提取刷新连接类型，以使用 Tableau Cloud 而不是 Bridge。

若要更改连接类型，请执行以下操作：

1. 从数据源的“连接”选项卡中，单击“编辑连接”。
    
    ![名为 World Indicators 的数据源出现在数据连接列表中。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_network_edit.png)
2. 若要停止为网络连接类型使用 Bridge，请选择 **“Tableau Cloud”**。若要为连接类型使用 Bridge，请选择**“专用网络”**。
    
    **注意**：您必须将与数据源相关的所有数据连接更改为相同的连接类型。
    
    ![“编辑数据连接”对话框允许您编辑数据连接并在 Tableau Cloud 或专用网络之间、进行选择。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_network_edit_private.png)

## 此部分中的其他文章

<!-- document id=807f99e332a85d3463c75150b069bc41dfe93b36a1314b2bc5f8112e7d267c56 url=/tableau/next/zh-cn/online/data_connect_setup.md -->

[跳转到主要内容](#main-content)

# 部署 Data Connect

自 2025 年 9 月起，Tableau Data Connect 不再可用于新部署。我们建议现有客户将其 Data Connect 部署迁移到[私人连接](https://help.tableau.com/current/online/zh-cn/private_connect_migrate_from_bridge.htm)或 [Tableau Bridge](https://help.tableau.com/current/online/zh-cn/data_fresh_sync_section.htm)。Data Connect 将来将停用。

在您的组织中部署 Data Connect 之前，请验证您是否已满足先决条件：

- 负责部署 Data Connect 的个人或团队应该具有 Linux 操作系统、shell 脚本、Docker 和 Kubernetes 方面的经验。
- [规划您的 Data Connect 部署](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm)中指定的最低硬件要求。
- [规划您的 Data Connect 部署](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm)中指定的网络规格和数据库访问权限 。

## 步骤 1：设置群集

![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_setup_569x543.png)

验证以下连接和访问：

- Data Connect 基础设施、群集和容器需要通过网络访问业务流程提供程序服务（上图中的 #2）和 Tableau Cloud（仅出站，#5）。
- Data Connect 基础设施、群集、容器和代理需要通过网络访问您的数据库 (#6)。

请参见[网络规格](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm#Networki)。

### 部署和配置

在组织中想要运行 Kubernetes 群集的每台计算机上运行以下过程。

1. 验证您的辅助卷未格式化。在 Linux 节点上，运行以下命令：
    
    `lsblk -f`
    
    下面显示了群集节点上未格式化且 `FSTYPE` 为空的额外卷 `nvme1n1` 的示例：
    
    ![](/tableau/next/zh-cn/online/zh-cn/Img/data_connect_kub.png)
2. 在“Data Connect”选项卡上的“池”下，单击“新建池”。在“新池”窗口中，输入池名称，然后单击“创建”。
3. 在“数据连接”选项卡上的“群集和节点”下，单击“新建群集”。在“新建群集”对话框中，输入群集名称，然后单击“创建”。
4. 在刚刚创建的集群上，单击“操作”列，然后单击“新建节点”。在“添加新节点”窗口中，单击“下载文件”。
    
    _cluster.tar_ 文件将下载到 Downloads 文件夹。此文件包含您将在节点上运行的引导脚本。
5. 将群集 .tar 文件复制到计算机上。下面的示例显示如何复制 tar 文件、提取文件、将脚本更改为可执行文件，然后运行该脚本。该示例在 AWS 上下文中展示了这一点。更改您的环境的文件路径。
    
    以 root 或 sudo 用户身份运行以下命令，将 `<key-name>` 和 `<IP-address`\> 替换为您的值：
    
    `> scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/`
    
    `> ssh -i <key-name>.pem ex2-user@ip-<IP-address>.us-west-2compute.internal`
    
    `> tar -xvf cluster.tar`
    
    `> chmod +x onboard_node.sh preflight_check.sh`
    
    `> ./onboard_node.sh`
    
    **注意**：默认情况下，bzip2 不会随 Ubuntu 一起安装。若要安装它，请运行 `apt install bzip2 -y`。
    
    脚本成功运行后，您将在终端窗口中看到`Successfully performed all operations`，Tableau 团队将开始预置过程。
    
    如果遇到错误，请验证您的部署是否满足[规划您的 Data Connect 部署](https://help.tableau.com/v0.0/online/zh-cn/data_connect_get_started.htm)中指定的最低硬件要求和网络规格。
6. 在您站点的“Data Connect”选项卡上，在您在步骤 2 中创建的池中查找。在“操作”列下，单击“分配群集” ，然后选择您在步骤 3 中创建的群集。
7. 单击群集上的 V 形符号 (⌄) 以查看主机名和可用操作。如果没有显示该信息，您可能需要重新加载页面。确认主机名是目标节点后，单击“接受节点”，然后单击“确认”。
    
    然后，群集节点将转换为“正在预置”状态。预置节点可能需要一个小时或更长时间。
8. 当节点上的状态更改为“可用”时，导航到分配了群集的池并单击操作按钮（ ... ），然后单击“刷新令牌”。验证您正在刷新正确池的令牌，然后单击“确认”。
9. 等待令牌刷新完成。完成后，池状态设置为“可用”。导航回群集并单击 V 形符号 (⌄) 以折叠群集名称部分。单击群集的操作按钮 (...)，然后单击“获取容器注册表信息”。
    
    - 如果您在尝试此步骤时收到错误，则表示注册表尚未部署，并且预置过程可能仍在完成中。稍等几分钟，然后重试
    - 当显示注册表信息（服务器名称、用户名和密码）时，将其复制以进行下一步。

## 步骤 2：构建基础映像并发布

在此步骤中，您将构建包含所需驱动程序的基础映像，然后将映像发布到 Docker 容器注册表。开始之前：

- 请验证您是否拥有上一步中的 Docker 容器注册表信息。
- 每个池可以有自己独特的基础映像和一组驱动程序。
- 如果您计划使用 TDC 文件进行连接，则需要将此文件包含在基础映像中。系统用户 `tableau` 必须具有此文件的读取权限。有关如何创建和存储此文件的详细信息，请参见 Tableau Desktop 帮助主题[自定义和调整连接](https://help.tableau.com/current/pro/desktop/zh-cn/connect_customize.htm)。

**重要信息**：基础映像将根据不同的驱动程序和平台而有所不同。以下示例旨在说明构建基础映像的过程。您必须针对特定环境调整构建过程。

### 构建容器

以下过程显示了构建容器的示例。您可能需要安装软件包管理器工具或其他特定于您的部署的工具。请注意，您构建的 docker 映像必须来自 Red Hat，因为 Tableau Bridge 安装程序是 Red Hat 安装程序（\*.rpm 文件）。

1. 登录到 Data Connect 群集中的任何节点。将群集 .tar 文件复制到计算机上。下面的示例显示如何复制 tar 文件、提取文件、将脚本更改为可执行文件，然后运行该脚本。该示例在 AWS 上下文中展示了这一点。更改您的环境的文件路径。
    
    以 root 或 sudo 用户身份运行以下命令，将 <key-name> 和 <IP-address> 替换为您的值：
    
    scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/
    ssh -i <key-name>.pem ec2-user@ip-<IP-address>.us-west-2compute.internal
    tar -xvf clustertar.tar
    chmod +x onboard\_node.sh preflight\_check.sh
    ./onboard\_node.sh
2. 按要求安装 Docker 及支持工具：
    
    #RedHat
    sudo dnf install -y container-tools podman-docker
    #Ubuntu
    sudo apt-get update -y
    sudo apt-get install -y docker.io
3. 创建 Dockerfile：
    
    touch Dockerfile
4. 更新 Dockerfile 以包含支持连接的驱动程序。此 Dockerfile 中指定的命令将在构建基础映像时运行。例如：
    
    \# example base 
    FROM registry.access.redhat.com/ubi8
    RUN yum -y update
    WORKDIR /
    # Go to https://tableau.com/support/drivers
    # Follow the instructions to install your drivers for linux
    CMD \["/bin/bash"\]
    
    驱动程序文件的目标目录将会有所不同。请参见 [Tableau 驱动程序下载](https://www.tableau.com/zh-cn/support/drivers)以了解更多详细信息。
    
    **注意**：Data Connect 支持具有 Linux 驱动程序且标有“_通过 Bridge 与 Tableau Cloud 配合使用_”的 Exchange 连接器。有关详细信息，请参见 [Tableau Exchange 连接器](https://exchange.tableau.com/zh-CN/connectors)。
    
    公共 JDBC 驱动程序的示例 Dockerfile 行，使用 curl 命令下载驱动程序：
    
    RUN mkdir -p /opt/tableau/tableau\_driver/jdbc
    RUN curl --location --output /opt/tableau/tableau\_driver/jdbc/<file> <URL>
    				
    
    非公共 JDBC 驱动程序的示例 Dockerfile 行，使用复制：
    
    RUN mkdir -p /opt/tableau/tableau\_driver/jdbc
    COPY  <file> /opt/tableau/tableau\_driver/jdbc
    
    taco 驱动程序的示例 Dockerfile 行，使用复制：
    
    RUN mkdir -p /home/tableau/Documents/My\_Tableau\_Bridge\_Repository/Connectors
    COPY  <file> /home/tableau/Documents/My\_Tableau\_Bridge\_Repository/Connectors
5. 当您仍登录到 Kubernetes 群集节点时，使用池 ID 的值设置变量 POOL\_ID。若要显示池 ID 值，请打开“Data Connect”选项卡并单击池名称。
    
    - 将您复制的注册表值设置为相应的值。
        
        REGISTRY\_HOSTNAME=registry\_host\_name\_you\_copied
        REGISTRY\_USERNAME=registry\_user\_name\_you\_copied
        REGISTRY\_PASSWORD=registry\_password\_you\_copied
    - 设置池 ID 值：
        
        POOL\_ID=<pool\_id\_value>
6. 构建用作基础映像的容器。
    
    docker build -f <path\_to\_dockerfile> -t $REGISTRY\_HOSTNAME/bridge-base:$POOL\_ID .
7. 登录到您现有的 Kubernetes 节点并将映像推送到本地容器注册表。
    
    docker login --username $REGISTRY\_USERNAME $REGISTRY\_HOSTNAME
    docker push $REGISTRY\_HOSTNAME/bridge-base:$POOL\_ID
8. 在您正在配置的池下，单击操作按钮 (...)，然后单击“刷新基础映像”。此操作将使用基础映像启动部署，最多可能需要 10 分钟。
    
    **注意**：每当创建并刷新新的基础映像时，都会创建一个新的部署。用于先前基础映像的 Bridge 代理将作为未分配的资产保留。不要删除未分配的 Bridge 代理。

## 步骤 3：将域映射到池

您在允许列表中指定的域名是用于数据源连接的服务器名称。

1. 在“Data Connect”选项卡的池和私有网络允许列表部分下，选择您已分配的池，然后单击“操作”列中的“新建域”。
2. 在“域”文本框中，使用[允许列表注册表规则](https://help.tableau.com/current/online/zh-cn/to_enable_bridge_live_connections.htm)中描述的信息输入域的 URI。您指定的域 URI 仅限于您正在配置的池。
3. 在“域权限”下，确认选中“允许”单选按钮。
4. 完成后，单击“保存”。

### 连接错误故障排除

您必须配置网络基础设施，以便 Data Connect 可以访问您想要连接的所有必需的数据源。若要验证 Data Connect 是否可以访问您的数据源，请从将运行 Data Connect 的节点运行以下 curl 命令：

$ curl -v $DB\_HOSTNAME:$DB\_PORT

如果您已成功建立连接，您应该会看到一系列响应。这里显示了一些示例：

- `Host $DB_HOSTNAME:$DB_PORT was resolved`：确认 DNS 服务器成功解析主机名。
- `Connected to $DB_HOSTNAME`：确认节点有网络连接。
- `Empty reply from server. Closing connection`：这是预料之中的，因为 curl 不是数据库客户端。
- `Could not resolve host: $DB_HOSTNAME`：DNS 解析存在问题。
- `Trying $DB_IP_ADDRESS:$DB_PORT`：当此消息后面跟着挂起结果时，表示存在网络问题。

如果您使用第三方数据连接基础设施，请确保网络逻辑不会被第三方破坏。

## （可选）步骤 4：跨站点共享群集

默认情况下，Data Connect 群集及其对应的节点仅由最初创建它们的站点使用。但是 Data Connect 群集可以在 Tableau Cloud Manager 租户内的所有站点之间共享。共享群集允许租户内不同站点上的查询使用相同的节点基础设施。

为了确保跨站点的数据隐私，您的共享群集的任何数据都不会被您的租户上的任何其他站点获取。

**注意**：共享群集是一项永久性的操作。若要取消共享群集，您必须移除并重新安装群集。

群集仅在其创建的原始站点上成功接受后才能共享。

若要共享 Data Connect 群集，请执行以下操作：

- 导航到要共享的群集，单击操作省略号 (...)，然后单击“共享”。

共享群集后，租户内其他站点的站点管理员将能够将该群集与他们在其站点中创建的任何池一起使用。

## （可选）步骤 5：在共享群集上创建池作为群集接收者

在共享群集上将池创建为接收者之前，请验证以下事项：

- 共享群集与您的站点使用的数据库具有网络连接
- 您的站点中的数据库所需的所有数据库驱动程序都必须安装在群集上

若要开始使用共享群集作为群集接收者，您需要与群集所有者沟通，以将池的基础映像添加到群集：

1. 在“Data Connect”选项卡上的“池”下，单击“新建池”。
2. 在“新池”窗口中，输入池名称，然后单击“创建”。
3. 在新池中，单击“分配群集”，选择共享群集，单击操作省略号 (...)，然后单击“刷新令牌”。
4. 验证您正在刷新正确池的令牌，然后单击“确认”。
5. 当池状态设置为“可用”时，复制池的 Pool\_ID。若要显示 Pool\_ID 值，请单击池名称。
6. 为您的站点添加基础映像。请参见[步骤 2：构建基础映像并发布](#build-base)。
    
    在添加基础映像的过程中，具有群集访问权限的管理员需要使用 `Pool_ID` 值构建一个新容器。您还需要最初创建群集的站点上的注册表值，这些值可以由群集所有者提供。
7. 将基础映像发布到本地容器注册表后，导航到共享站点上的池，然后单击“刷新基础映像”。
8. 若要完成设置，请参见上面的[步骤 3：将域映射到池](#map-pool)。

## 从现有群集添加节点

1. 导航到群集并单击“新建节点”。
2. 按照上面[步骤 1：设置群集](#setup-cluster)程序中的步骤 4、5、7、8、9 进行操作。省略步骤 6，因为您不需要分配群集。
3. 刷新令牌步骤完成后，转到与群集关联的池并单击“刷新基础映像”。

**注意**：创建并刷新新的基础映像时，都会创建一个新的部署。用于先前基础映像的 Bridge 客户端将作为未分配的资产保留。不要删除未分配的 Bridge 客户端。

## 从现有群集中移除节点

从群集中移除节点后，Tableau Cloud 将无法再访问 Bridge 客户端。删除节点时在 Data Connect 上运行的任何作业都将失败。但是，系统不会将其他作业被路由到这些 Bridge 客户端。

若要移除节点，请导航到群集，单击操作省略号 (...) 并选择“删除”。

## 更新现有池的基础映像

如果您决定使用新的数据库或更新 Data Connect 群集将使用的驱动程序，则可以更改现有的基础映像以适应这些更改。为此，请按照[步骤 2：构建基础映像并发布](#build-base)中的说明使用更改来更新容器文件。更新容器文件后，单击**“刷新基础映像”**。部署新的基础映像最多可能需要 15 分钟。在新的基础映像成功部署之前，将使用您之前的基础映像。

## 数据库连接疑难解答

首先验证您的域是否遵守允许列表注册规则。请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。

接下来，确认已您必须配置网络基础设施，以便 Data Connect 可以访问您想要连接的所有必需的数据源。若要验证 Data Connect 是否可以访问您的数据源，请从将运行 Data Connect 的节点运行以下 curl 命令：

$ curl -v $DB\_HOSTNAME:$DB\_PORT

如果您已成功建立连接，您应该会看到一系列响应。这里显示了一些示例：

- `Host $DB_HOSTNAME:$DB_PORT was resolved`：确认 DNS 服务器成功解析主机名。
- `Connected to $DB_HOSTNAME`：确认节点有网络连接。
- `Empty reply from server. Closing connection`：这是预料之中的，因为 curl 不是数据库客户端。
- `Could not resolve host: $DB_HOSTNAME`：DNS 解析存在问题。
- `Trying $DB_IP_ADDRESS:$DB_PORT`：当此消息后面跟着挂起结果时，表示存在网络问题。

如果您使用第三方数据连接基础设施，请确保网络逻辑不会被第三方破坏。

<!-- document id=41560d6314dd1b5839982ce5a0e77cdade24b0d4ad06a66146750bf68ca832e4 url=/tableau/next/zh-cn/online/config_einstein_extensions.md -->

[跳转到主要内容](#main-content)

# 配置 Einstein Discovery 集成

从 2021 年 3 月开始，Tableau Cloud 支持与 Einstein Discovery 集成，使 Einstein Discovery 预测可供仪表板的作者和查看者使用。从版本 2021.2.0 开始，现在在 Web 上制作流程时也可以使用 Einstein Discovery 预测。

Tableau 中的 Einstein Discovery 由 [salesforce.com](http://salesforce.com/) 提供技术支持。有关适用条款，请查阅与 [salesforce.com](http://salesforce.com/) 的协议。

有关如何在 Tableau 中使用 Einstein Discovery 预测的详细信息，包括许可和权限要求，请参见 Tableau Desktop 和 Web 制作帮助中的[在 Tableau 中集成 Einstein Discovery 预测](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_predictions.htm)。有关在流程中添加预测的信息，请参见[将 Einstein Discovery 预测添加到流程](https://help.tableau.com/current/prep/zh-cn/prep_predictions.htm)。

## Einstein Discovery 仪表板扩展程序

Einstein Discovery 仪表板扩展程序允许工作簿作者在 Tableau 中显示实时预测。仪表板扩展使用 Tableau 工作簿中的源数据和 Salesforce 中部署的基于 Einstein Discovery 的模型，按需交互地提供预测。

默认情况下，Tableau Cloud 站点配置允许已保存的 Oauth 访问令牌，因此唯一必要的步骤是在托管 Einstein Discovery 的 Salesforce org 中配置跨域资源共享 (CORS)。这需要 Salesforce org 中的权限。有关必要的许可证和权限的详细信息，请参见[访问要求 - Einstein Discovery](https://help.tableau.com/current/pro/desktop/zh-cn/einstein_discovery_predictions.htm#Requirem)。有关在 Salesforce 中配置 CORS 的详细信息，请参见[在 Salesforce.com 中为 Tableau Cloud 中的 Einstein Discovery 集成配置 CORS](https://help.tableau.com/v0.0/online/zh-cn/config_cors_sfdc.htm)。

## Einstein Discovery 分析扩展程序

Einstein Discovery 分析扩展程序使您的用户能够将预测直接嵌入到 Tableau 计算字段中。表计算脚本通过传递与其关联的预测 ID 和模型所需的输入数据，向 Salesforce 中部署的模型请求预测。使用 Salesforce 中的 Model Manager 自动生成 Tableau 表计算脚本，然后将该脚本粘贴到计算字段中，以供在 Tableau 工作簿中使用。

默认情况下，Tableau Cloud 站点配置允许已保存的 Oauth 访问令牌，因此唯一必要的步骤是在托管 Einstein Discovery 的 Salesforce org 中配置跨域资源共享 (CORS)。这需要 Salesforce org 中的管理员权限。有关详细信息，请参见[在 Salesforce.com 中为 Tableau Cloud 中的 Einstein Discovery 集成配置 CORS](https://help.tableau.com/v0.0/online/zh-cn/config_cors_sfdc.htm)。

## Einstein Discovery Tableau Prep 扩展程序

_从版本 2021.2.0 开始在 Tableau Server 和 Tableau Cloud 中受支持_

Einstein Discovery Tableau Prep 扩展程序使用户能够在 Web 上制作流程时将 Einstein 预测直接嵌入到他们的流程中。

默认情况下，Tableau Cloud 站点配置允许保存的 OAuth 访问令牌，因此唯一需要的步骤是为服务器启用 Tableau Prep 扩展程序。这需要 Salesforce org 中的管理员权限。有关详细信息，请参见[启用 Tableau Prep 扩展程序](https://help.tableau.com/current/server/zh-cn/web_author_flows.htm)。

## 此部分中的其他文章

<!-- document id=437d2f6d3208b1de5a9540534792b59d8bf7ceeca336df740a88346acac3f0e5 url=/tableau/next/zh-cn/online/config_oauth_hana.md -->

[跳转到主要内容](#main-content)

# 配置 SAP HANA 的外部 OAuth

从 Tableau Cloud 的 Tableau 2024.3 开始，您可以使用 OAuth 2.0/OIDC 将外部身份提供程序的身份联合到 HANA。

根据身份提供程序的不同，配置集成需要执行不同的步骤。这是一个简略概述。

**注意**：使用 Tableau Bridge 与 Tableau Cloud 的 OAuth 连接不支持一次性刷新令牌（有时称为滚动刷新令牌或刷新令牌轮换）。我们计划在未来的版本中支持这些令牌。

## 在 HANA 上配置 IDP

有关在 HANA 上配置 IdP 的信息，请参见 SAP 帮助系统中的[使用 JSON Web 令牌进行单点登录](https://help.sap.com/docs/hana-cloud-database/sap-hana-cloud-sap-hana-database-security-guide/single-sign-on-using-json-web-tokens)。

以下是设置 IdP 的不同方法的一些示例：

- 使用 HANA Cockpit 的 Okta IdP：[使用 Okta 帐户连接到 SAP HANA Cloud](https://help.alteryx.com/current/en/designer/data-sources/sap-hana/connect-to-sap-hana-cloud-with-okta-account.html#connect-to-sap-hana-cloud-with-okta-account)
- 使用 HANA Studio 的 Azure IdP：[使用 OAuth 或 SSO 设置 SAP HANA 实例](https://www2.microstrategy.com/producthelp/Current/Gateway_Connections/WebHelp/Lang_1033/Content/sap_hana_instance_oauth_sso.htm)

## 配置 IDP

1. 在 IDP 上为 Tableau Desktop 和 Tableau Server 或 Tableau Cloud 创建 OAuth 客户端。Desktop 客户端应启用 [`PKCE`](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) 并使用 `http://localhost` 重定向。
2. 创建 Tableau OAuth 配置文件。有关如何执行此操作的详细信息，请参见 [GitHub](https://tableau.github.io/connector-plugin-sdk/docs/oauth "GitHub 上的 OAuth 文档") 上的 [OAuth 配置和使用](https://tableau.github.io/connector-plugin-sdk/docs/oauth)，以及[此处](https://github.com/tableau/connector-plugin-sdk/tree/master/samples/components/oauth "GitHub 上的 OAuth 示例。")的示例。我们欢迎提供其他 IDP 的示例。
    
    1. 请务必在 Tableau OAuth 配置 ID 前添加“`custom_`”前缀。
        
        **注意：**OAuth 配置 ID 的最大限制为 36 个字符。长于此长度的 ID 可能不会生成错误，但将不起作用。
    2. 如果您的 IDP 支持动态本地主机端口，则禁用 `OAUTH_CAP_FIXED_PORT_IN_CALLBACK_URL`。如果您的 IDP 不支持此功能，请确保将多个本地主机回调 URL 添加到配置文件和 IDP 上的允许列表中。
3. 在与桌面主机（Tableau Desktop、Tableau Prep Builder、Tableau Bridge）上的每个应用程序关联的 `OAuthConfigs` 文件夹中，以及在将通过站点设置页面使用 OAuth 的每个 Tableau Server 和 Tableau Cloud 站点上，安装新的 Tableau OAuth 配置文件。有关更多详细信息，请参见 [Desktop 上的自定义 OAuth 配置](https://tableau.github.io/connector-plugin-sdk/docs/oauth#site-level-oauth-clients)和[站点级别 OAuth 客户端](https://tableau.github.io/connector-plugin-sdk/docs/oauth#custom-oauth-configs-on-desktop)。

## 连接到 HANA

用户必须选择“使用 OAuth 登录”，然后选择之前安装的“OAuth 提供程序”。

![](/tableau/next/zh-cn/online/zh-cn/Img/hana_connect.png)

## Okta

如果使用 Okta，最好使用“自定义授权服务器”而不是“组织授权服务器”。自定义授权服务器更加灵活。默认创建一个自定义授权服务器，称为“默认”。授权 URL 应如下所示：

https://${yourOktaDomain}/oauth2/{authServerName}/v1/authorize

![](/tableau/next/zh-cn/online/zh-cn/Img/redshift_oauth_iam_okta_800x332.png)

<!-- document id=52dfc4c2174459a0b50043ef9f6a21aacd843c118b9985442a3387bcbdace5e1 url=/tableau/next/zh-cn/online/snowflake_key_pair_auth.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 进行 Snowflake 密钥对身份验证

若要将使用受密钥对身份验证保护的 Snowflake 数据源的工作簿或流程从 Tableau Desktop 或 Tableau Prep 发布到 Tableau Cloud 或 Tableau Server 站点，您还必须配置该站点以支持这些凭据。这涉及将 Snowflake 密钥对身份验证的新身份验证详细信息或更新的身份验证详细信息添加到“帐户设置”的“已保存的凭据”部分。

**说明**

- 为了支持使用密钥对身份验证以连接到 Snowflake，必须安装 Snowflake 提供的版本 3.4.0 或更高版本的 ODBC 驱动程序。
- 您需要使用 OpenSSL 3.x 或更新版本来创建此身份验证的密钥。
- 每个使用受密钥对身份验证保护的 Snowflake 数据的 Tableau Desktop 实例都将要求用户在连接数据时提供密钥文件。有关详细信息，请参见 [Snowflake](https://help.tableau.com/current/pro/desktop/zh-cn/examples_snowflake.htm)。
- 包含密钥对身份验证的工作簿、数据源和 Prep 流程必须从 Tableau Desktop 或 Tableau Prep Builder 发布到 Tableau Cloud 或 Tableau Server。
- 以下操作目前不支持密钥对身份验证：
    
    - 工作簿或数据源 Web 制作，包括在 Web 上编辑现有已发布工作簿或数据源
    - Prep Web 制作，包括在 Web 上编辑现有 Prep 流程
    - 虚拟连接 (VConns)

## 添加密钥对认证详细信息

1. 登录到 Tableau Cloud 或 Tableau Server，并导航到“我的帐户设置”页面。
2. 在“安全”部分，找到“保存的数据源凭据”。
3. 在“Snowflake”旁边，单击“添加”。
4. 在“添加新的已保存凭据”窗口中，选择“密钥对身份验证”，然后单击“添加”。
5. 在“添加密钥对身份验证凭据”窗口中，输入您的 Snowflake 服务器、角色（可选）以及与这些凭据关联的用户名。
    
    注意：“角色”和“用户名”区分大小写，并且必须与 Tableau Cloud 或 Tableau Server 上“我的帐户设置”\>“Snowflake 密钥对信息”下保存的内容匹配。
6. 对于“私钥文件”，单击“选择文件”并选择包含私钥的 .p8 文件。
7. （可选）如果该密钥有关联的密码或密码短语，请在“密码”字段中输入该密码或密码短语，然后单击“添加”。

您现在可以将受密钥对身份验证和流程保护的工作簿和流程从 Tableau Desktop 或 Tableau Prep Builder 共享到您的站点。

## 另请参见

- [Snowflake](https://help.tableau.com/current/pro/desktop/zh-cn/examples_snowflake.htm) - 了解如何建立与 Snowflake 的连接以检索和分析数据。

<!-- document id=e7fd9f0907a2513bc6a5c60463db48158678b0151305adb1e600c030509f2035 url=/tableau/next/zh-cn/online/lwc_tableau_pulse.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau Pulse Lightning Web 组件

Tableau Pulse Lightning Web 组件 (LWC) 允许 Salesforce 客户将嵌入的 Tableau Pulse 指标从 Tableau Cloud 拖放到 Salesforce Lightning 页面上。Tableau Pulse LWC 支持嵌入应用程序、主页和记录页面，以及 Experience Cloud 和 Salesforce Utility Bar。

有关打开 Tableau LWC、添加受信任 URL、设置无缝身份验证和主机映射以及将组件添加到 Lightning 页面的说明，请参见[配置 Tableau Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_seamless_auth.htm)。

将 Tableau Pulse LWC 添加到 Lightning 页面后，配置组件字段。

组件字段描述<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>组件字段</strong></td><td><strong>描述</strong></td></tr><tr><td>Tableau Pulse URL</td><td>此字段为必填项。输入要嵌入的 Tableau Pulse 页面或指标的 URL。</td></tr><tr><td>站点 ID</td><td>如果没有为<strong>“Tableau Pulse URL”</strong>字段中使用的 URL 指定主机映射，则无缝身份验证需要此字段。如果 Tableau 站点存在主机映射，则该字段的内容将被忽略。</td></tr><tr><td>高度</td><td>以像素为单位的高度。当设置为默认值 0 时，高度会自动调整以最好地适应所选的布局。</td></tr><tr><td>布局</td><td>确定显示的细节的大小和级别。从“完整”、“紧凑”或“迷你”中选择。</td></tr><tr><td>UAF 定义名称</td><td><p><strong>“应用程序”、“主页”和“记录”页面</strong></p><p>从 Tableau UAF 声明定义设置中配置的 UAF 声明定义中进行选择。</p><p>若要添加定义，请执行以下操作：</p><ol><li value="1"><p>选择<span class="uicontrol">“选择…”</span>。</p></li><li value="2"><p>使用箭头将可用的定义移动到<span class="uicontrol">“已选定”</span>字段。</p></li><li value="3"><p>选择<span class="uicontrol">“确定”</span>。</p></li></ol><p><strong>Experience Cloud 页面和 Salesforce Utility Bar</strong></p><p>输入以逗号分隔的 UAF 声明定义名称列表。若要复制定义名称，请从 Salesforce 应用程序中导航到<span class="uicontrol">“Tableau UAF Claims Definition”（Tableau UAF 声明定义）</span>设置页面，然后选择<span class="uicontrol">“Copy”（复制）</span>。</p></td></tr><tr><td>调试模式</td><td>选中该框以打开调试模式。</td></tr><tr><td>强制刷新切换</td><td>进行故障排除时，您可以切换此复选框以仅刷新此组件，而不是刷新整个 Lightning 应用程序生成器页面或 Lightning 页面上的所有组件。</td></tr><tr><td>设置组件可见性：筛选器</td><td><p>创建筛选器以决定何时显示组件。例如，您可以根据特定用户、权限或设备规格进行筛选。</p><p>添加筛选器：</p><ol><li value="1">选择<span class="uicontrol">“添加筛选器”</span>。</li><li value="2">选择<span class="uicontrol">“选择”</span>以选择要筛选的字段。</li><li value="3">完成您的选择，然后选择<span class="uicontrol">“完成”</span>。</li><li value="4">选择<span class="uicontrol">“完成”</span>保存筛选器。</li></ol><p><strong>重要信息</strong>：您必须输入数据源中定义的字段名称。例如，如果数据源是英文的，但数据源字段为用户翻译为日语，则用户必须输入原始的英文字段名称。</p></td></tr><tr><td>静态筛选器</td><td>向 Tableau Pulse 指标添加静态筛选器（例如，Region=North）。</td></tr></tbody></table>

### 仅在记录页面上可用的字段

通过以下字段，可以动态筛选最多两个字段。例如，您可以使用复选框筛选“帐户 ID”，使用高级筛选筛选滤“州/省/市/自治区”。

组件字段描述

<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>组件字段</strong></td><td><strong>描述</strong></td></tr><tr><td>按记录 ID 筛选</td><td>用于使用记录 ID 动态筛选视图。Pulse 指标数据源中的字段名称必须与“记录类型 Id”格式匹配并且区分大小写。例如，如果 Lightning 页面用于帐户记录，则 Pulse 指标中的字段必须命名为“帐户 ID”。</td></tr><tr><td>Tableau 动态筛选器名称</td><td>用于使用当前记录中的特定字段进行动态筛选。输入Pulse 指标数据源中的字段名称。</td></tr><tr><td>Salesforce 动态筛选器值</td><td>用于使用当前记录中的特定字段进行动态筛选。在 Salesforce 记录上选择相应的字段。</td></tr></tbody></table>

## Tableau Pulse 组件故障排除

从包含 Tableau Pulse Lightning Web 组件的页面中，选择齿轮图标，然后选择“编辑页面”。

1. 单击 Tableau Pulse Lightning Web 组件以打开属性编辑器。
2. 确认**“Tableau Pulse URL”**字段包含 Tableau Pulse 页面或指标的有效 URL。
3. 验证**“站点 ID”**字段是否已使用 Tableau 站点的站点 ID 填充。若要查找站点 ID，请从 Tableau 站点打开工作簿或视图的“共享”对话框。

有关其他 Tableau LWC 和无缝身份验证信息以及故障排除，请参见[配置 Tableau Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_seamless_auth.htm)。

<!-- document id=facfb0431b228f51cf9b660e6ab9844d68f5a3a17b013075b67599a8b723642f url=/tableau/next/zh-cn/online/data_stories_configure_edit.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事的设置

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

[将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)后，您可以配置和编辑您的 Tableau n故事，使其适合您的需求 - 使用特定于您的数据的语言，指定编写的分析内容，并自定义您的 Tableau 数据故事的显示方式。

## 此部分中的其他文章

<!-- document id=4fb0645225b59106df72ee1d015efd3df761490b0214531642597f3760dca722 url=/tableau/next/zh-cn/online/data_stories_relationships.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：关系

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

“关系”设置允许您在具有多个度量的 Tableau 数据故事中分配度量之间的关系。若要配置关系，您的故事必须具有一个维度和多个度量。有关详细信息，请参见[在 Tableau 数据故事中创建自定义度量关系](https://help.tableau.com/v0.0/online/zh-cn/data_stories_relationship_story.htm)。

有两种类型的关系：

- 实际与基准
- 当前/最近与上一期间

当您想知道自己的表现是高于还是低于绩效基准时，例如，在执行配额报告时，请使用“实际与基准”。这种类型的关系也有助于识别需要额外分析的数据点，因为它们明显高于或低于您的基准。若要使用“实际与基准”，您要比较的度量值必须具有相同的值类型。

当您想查看您的关键绩效指标 (KPI) 是否随时间增加、减少或保持一致时，请使用“当前/最近与上一期间”。若要使用“当前/最近与上一期间”，您必须使用离散故事类型。有关详细信息，请参见[选择适用于您的 Tableau Desktop 数据故事的正确故事类型](https://help.tableau.com/v0.0/online/zh-cn/data_stories_story_types.htm)。

此外，您可以同时使用“实际与基准”以及“当前/最近与上一期间”关系。可视化项中不属于已配置关系的度量将写在单独的段落中。

## 为连续或离散故事创建“实际与基准”关系

当一个度量是其他度量的基准时，使用“实际与基准”关系。例如，您可以将实际销售额与销售目标进行比较，这样您的故事就可以写出关于您的表现是否超出目标的见解。当您使用这种类型的关系时，故事会移除不必要的内容并关注最重要的内容 – 将指标与其相关基准进行比较。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“关系”选项卡。
4. 选中“实际与基准”框。
5. 首先，选择作为基准的度量。
6. 然后，选择要与基准进行比较的度量。
7. 单击“保存”。

## 创建“当前/最近与上一期间”关系

使用“当前/最近与上一期间”关系来比较两个度量在一段时间内的表现。例如，您可以比较两种产品，看看哪种产品在去年产生的收入最多。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“关系”选项卡。
4. 选中“当前/最近与上一期间”框。
5. 首先选择上一期间的度量。
6. 然后，选择当前期间的度量。
7. 输入您正在测量的期间的标签，例如年份。
8. 选择要测量的期间数。
9. 单击“保存”。

<!-- document id=4508a07173842df10f3dfd52afd05537c09901f78751291ef28fc333e2a1cefe url=/tableau/next/zh-cn/online/data_stories_analytics.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：分析

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

在您的 Tableau 数据故事中，您可以选择要撰写哪些分析以及何时撰写这些分析。根据您的故事类型以及您的故事有多少维度和度量，可以使用不同类型的分析。但是，散点图故事类型目前不支持分析。有关详细信息，请参见[选择适用于您的 Tableau Desktop 数据故事的正确故事类型](https://help.tableau.com/v0.0/online/zh-cn/data_stories_story_types.htm)。

## 为您的故事配置分析

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“分析”选项卡。
4. 单击开关以启用不同类型的分析。
5. 对于“细分”和“趋势线”，展开“设置”以设置执行这些分析的阈值。
6. 单击“保存”。

## 了解不同类型的分析

### 相关性

使用“相关性”来确定两个系列之间的真实统计相关性。如果您有两个以上的系列，则会分析所有组合的相关性。例如，您可以启用“相关性”以确定两种产品经常一起购买的时间。

### 聚类

使用“聚类”，通过单个统计分析来识别不同的数据点组（群集）。例如，您可以打开“聚类”以确定产品何时在特定地理区域非常受欢迎。

### 分布

使用“分布”，通过非统计观察（例如均值、中位数、偏斜等）对数据点进行相对排名。例如，您可以启用“例分布”来确定哪个产品的利润率最高。

### 细分

使用“细分”突出显示系列中数据点的显着变化。首先，设置要在细分中写出的最小变化百分比。低于您定义的阈值的变化不会被写出。举例来说，如果您将细分阈值设置为大于 60% 的变化，那么您的故事不会写出时间序列中下降了 30% 的低谷。

设置阈值后，选择是否应用格式设置，并设置要设置格式的最小变化百分比。

### 趋势线

使用“趋势线”计算线性最佳拟合线并确定处于定义置信百分比内的数据。与更一致的数据相比，具有高可变性的数据具有较低的置信水平，并且该置信水平会影响是否写出趋势线。您可以将趋势线用于具有一个维度和一个度量的故事，或者您可以在向下钻取中使用趋势线。有关向下钻取的详细信息，请参见[配置 Tableau 数据故事设置：叙述](https://help.tableau.com/v0.0/online/zh-cn/data_stories_narrative.htm)。

设置趋势线的最小置信百分比。如果您将阈值设置为 95%，但可以以 90% 的置信度绘制趋势线，那么您的故事就不会写出趋势线。设置阈值后，选择是否应用格式设置。然后设置要设置格式的最小变化百分比。

关于趋势线的 Tableau 数据故事传达了一段时间内的绝对变化。关于趋势线的故事会根据您为故事设置的详细程度而有所不同。如果您的故事使用高详细程度，那么您的故事会写出 R 平方值，这是一个统计概念，可以量化您的数据与趋势线的拟合程度。有关详细程度设置的详细信息，请参见[配置 Tableau 数据故事设置：叙述](https://help.tableau.com/v0.0/online/zh-cn/data_stories_narrative.htm)。

在“趋势线”设置中，您还可以选择您希望您的故事针对未来多少个期间写出预测。当您使用预测时，您的故事使用趋势线的斜率和截距来计算未来期间的预测值。预测的置信度为您为趋势线设置的置信度阈值添加上限和下限。当您的故事至少有 30 个线性数据点时，您可以使用预测。

### 波动率

使用“波动率”分析一段时间内的标准偏差。例如，当您希望故事写出超出数据平均范围的值时，请使用“波动率”。

## 分解分析如何用于生成故事

此时，您可能想知道不同故事类型的分析是如何工作的。让我们看一下每种故事类型的示例，并分解故事中的每个句子。

### 了解离散故事的分析

因为连续故事衡量一段时间内的趋势，因此 数据故事 会写出绩效、进展、平均值、总计、连续性、波动性、细分和预测。

以下连续故事示例讲述每月的销售额：

![一个示例故事，其中包含有关每月销售额的文本洞察。图像中的文本转录在下表中。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_continuous_analytics.png)

<table style="border-left-style: none;border-right-style: none;border-top-style: none;border-bottom-style: none;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>示例故事</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>故事分解</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>全部 <b>48</b> 个月的平均销售额为 <b>47,858 美元</b>。</li><li>最小值为 <b>4,520 美元</b>（2014 年 2 月），最大值为 <b>118,448 美元</b>（2017 年 11 月）。</li></ul></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"><ul><li>在整个系列过程中，销售额增长了 <b>489%</b>，但最终呈下降趋势，最后一个月下降。</li></ul></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"><ul><li>按百分比计算的最大单次增长发生在 2014 年 3 月 (<b>+1,132%</b>)。然而，最大的单次绝对涨幅发生在 2014 年 9 月（ <b>+53,868 美元</b>）。</li></ul></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"><ul><li>在<b>三个</b>系列中，最强的关系是公司和家庭办公室之间的关系，具有中等的正相关性，这表明随着一个（公司）的增加，另一个（家庭办公室）通常也会增加，反之亦然。</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">这个句子是一个<b>相关性</b>洞察。这种类型的分析洞察记录了数据中不同系列之间的显着相关性。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>销售有周期性，大约每 <b>12</b> 个月重复每个周期。还有一种较小的周期模式，大约每<b>三个</b>月重复一次。</li><li>销售额<b>在 2014 年 10 月（31,453 美元）和 2015 年 2 月（11,951 美元）之间出现了显着的正峰值，在 2014 年 11 月升至 78,629 美元</b>。</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">这个句子是一个<b>细分</b>洞察。这种类型的分析洞察写出一段时间内值得注意的增加和减少。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>该<b>系列的整体线性趋势每月上涨 902 美元</b>，在整个系列过程中绝对变化为 <b>42,394 美元</b>。如果这一趋势在接下来的一个月内持续下去，<b>预计销售额约为 69,958 美元</b>。</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">这个句子是一个<b>趋势线</b>洞察。这种类型的洞察记录了趋势在一定百分比的置信度下与您的数据的拟合程度，趋势线允许您根据历史趋势进行预测。</td></tr></tbody></table>

### 了解离散故事的分析

因为离散故事允许您比较值并了解数据的分布，所以故事会写出数据中的分布、平均值、总计以及分组或群集。

以下离散故事示例讲述按产品分类的销售额：

![一个示例故事，其中包含有关按产品分类的销售额的文本洞察。图像中的文本转录在下表中。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_discrete_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>示例故事</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>故事分解</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>全部 <b>17</b> 种产品的总销售额为 <b>230</b> 万美元。</li></ul></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"><ul><li><b>230</b> 万美元的销售额是由以下因素推动的 <u>手机</u> <b>330,007 美元</b>。 <u>椅子</u> <b>328,449 美元</b>，以及 <u>存储产品</u> <b>223,844 美元</b>。</li></ul></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"><ul><li>由于 <b>135,129 美元</b>的平均值高于 <b>114,880 美元</b>的中位数，因此分布呈正偏态。</li><li>销售额相对集中，<b>17</b> 种产品中的 <b>8</b> 种 (<b>47%</b>) 占总量的 <b>78%</b>。</li></ul></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"><ul><li>前<b>两种</b>产品合计占总销售额的四分之一以上 (<b>29%</b>)。</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">这个句子使用<span class="uicontrol">“聚类”</span>来写出于可分组的度量。这有助于确定数据中是否存在突出的不同组。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li><u>手机</u> （<b>330,007 美元</b>）是 <b>17</b> 种产品平均值的两倍多。</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">最后一个句子写出值得注意的异常值。</td></tr></tbody></table>

### 了解散点图故事的分析

散点图故事类型最适合了解两个度量之间的关系，因此，散点图故事需要 2-3 个度量。散点图分析写出两个度量之间的关系（回归），并写出数据中的组（群集）（如果存在）。

以下散点图故事示例讲述跨维度的利润和销售额：

![一个示例故事，其中包含有关利润和销售的文本洞察。图像中的文本转录在下表中。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_scatter_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>示例故事</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>故事分解</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li>随着数量的增加和利润的增加，根据提供的数据，销售额增加了。具体来说，当数量增加 <b>1</b> 时，销售额增加 <b>49.55 美元</b>，当利润增加 <b>1.00 美元</b>时，销售额增加 <b>1.20 美元</b>。</li><li>很少有客户偏离这种一般关系，表明非常适合。</li></ul></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"><ul><li>当组织成具有相似利润、数量和销售额骨值的组时，一个不同的组会脱颖而出。有 <b>651</b> 位客户的利润值在 <b>-6,626 美元</b>到 <b>1,488 美元</b>之间，数量在 <b>2</b> 到 <b>122</b> 之间，销售额在 <b>4.83 美元</b>到 <b>5,690 美元</b>之间。</li></ul></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"><ul><li><u>Tamara Chand</u>、 <u>Raymond Buch</u>和 <u>Sanjit Chand</u>，其中包括具有高利润和销售额值的异常值。Sean Miller 因为低利润和高销售额而突出显示。</li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">第四个句子写出异常值，即显着高于或低于平均值的值。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>利润的最小值为 <b>-6,626 美元</b> (<u>Cindy Stewart</u>)，最大值为 <b>8,981 美元</b> (<u>Tamara Chand</u>)，相差 <b>15,608 美元</b>。每位客户的平均利润为 <b>361 美元</b>，中位数为 <b>228 美元</b>。</li><li>数量的最小值是 <b>2</b> (<u>Anthony O'Donnell</u>)，最大值为 <b>150</b> (<u>Jonathan Doherty</u>)，相差 <b>148</b>。每个客户的平均数量为 <b>47.76</b>，中位数为 <b>44</b>。</li><li>销售额的分布范围为 <b>4.83 美元</b> (<u>Thais Sissman</u>) 至 <b>25,043 美元</b> (<u>Sean Miller</u>)，相差 <b>25,038 美元</b>。每个客户的平均销售额为 <b>2,897 美元</b>，中位数为 <b>2,256 美元</b>。</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">散点图故事的其余句子使用范围和平均分析来撰写洞察。</td></tr></tbody></table>

### 了解整体百分比故事的分析

整体百分比故事类型最适合了解维度或度量代表整体的哪一部分。

以下整体百分比故事示例讲述按细分市场划分的销售额：

![一个示例故事，其中包含有关按细分市场划分的销售额的文本洞察。图像中的文本转录在下表中。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_pie_analytics.png)

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"><col style="width: 50%;" class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><b>示例故事</b></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>故事分解</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><ul><li><p>所有三个实体的 SUM(Sales) 总计为 230 万。</p></li></ul></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"><ul><li><p>230 万的 SUM(Sales) 由消费者（120 万）、企业（706,146）和家庭办公室（429,653）推动。</p></li></ul></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">第二个句子写出驱动因素。在此示例中，驱动因素是对总销售额贡献最大的细分市场。</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><ul><li>最小值为 429,653（家庭办公室），最大值为 120 万（消费者），相差 731,748，平均值为 765,734。</li></ul></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">最后一个句子分析数据的分布。</td></tr></tbody></table>

<!-- document id=59609c900e258998a1eca3309e7626826e9bbba045195fa4cdac73a120cbdf53 url=/tableau/next/zh-cn/online/data_stories_narrative.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：叙述

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

您可以自定义 Tableau 数据故事的叙述设置。具体来说，您可以指定故事中分析细节的详细程度和级别，并且可以添加数据特有的术语。这些设置可帮助您编写使用正确语言的故事，并为您的仪表板提供正确的详细程度。

## 设置详细程度

详细程度指定故事中所写的长度和分析细节。如果您选择“高”，那么您的故事将具有更长的洞察力和更多的分析。如果您选择“低”，那么您的故事会更简洁，细节更少。

如果您允许查看者更改详细程度，则已发布仪表板的查看者可以更改“数据故事”对象中的详细程度。当您的仪表板被更广泛的受众群体使用时，这很有帮助，查看者希望从您的故事中获得不同程度的细节。

## 设置向下钻取

向下钻取包括两个维度，向下钻取描述与仪表板的每个维度关联的数字。

假设您有一个按产品类别列出每月销售额的仪表板。您的故事被配置为同时写入**“时间”**和**“类别”**维度。在这种情况下，这个故事包括对每个类别的洞察，描述了它在时间维度中和跨**时间**维度的表现。

通过设置向下钻取的最大数量，您可以控制故事中包含多少洞察。向下钻取洞察也根据分配给度量特征的含义进行排名。随着向下钻取次数的减少，性能最低的度量（被赋予不良含义的度量）将被淘汰。

## 添加维度术语

通过添加术语，您可以定义每个度量和维度在故事中的标记和引用方式。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“叙述”选项卡。
4. 展开维度以查看它将如何以单数和复数形式书写。
5. 单击“添加术语”为您的故事添加另一个变体以用于描述您的维度。
6. 单击“保存”。

您的故事（随机）使用您在编写维度相关内容时添加的术语。

## 管理度量标签

与维度类似，您可以管理故事中用于度量的标签。

1. 在“叙述”选项卡中，展开度量以查看其标签。
2. 输入要用于度量的新标签。
3. 单击“保存”。

<!-- document id=2100d8b529f1c3fd11f545005d01afa5ab270e16c4294b5c2a71c6a5de2f747d url=/tableau/next/zh-cn/online/data_stories_display.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：显示

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

您可以配置 Tableau 数据故事中文本的显示方式，例如字体颜色和大小。您还可以选择您的故事是使用项目符号列表还是段落。

## 为您的故事配置显示

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“显示”选项卡。
4. 选择您希望故事结构是“项目符号列表”还是“段落”。
5. 选择“字体大小”。
6. 选择颜色来代表好的和坏的变化（可用于连续的故事）。
7. 选择是否使用“动态排序”。
8. 选择是否使用“精简视图”。
9. 单击“保存”。

## 了解何时使用故事显示设置

若要使用颜色，您的故事必须是连续的。使用颜色时，您可以从调色板中选择颜色来表示好的变化和坏的变化。为了让您的故事知道变化是好是坏，您必须在“特征”选项卡中为较大的值分配意义。有关详细信息，请参见[配置 Tableau 数据故事设置：特征](https://help.tableau.com/v0.0/online/zh-cn/data_stories_characteristics.htm)。配置显示后，样式和颜色将根据趋势线或细分分析的阈值应用到您的故事中。

如果您打开“动态排序”，那么故事中度量的洞察将按从最好到最差的平均值动态排序。如果您已经有要保持的顺序，请关闭“动态排序”。

如果您打开“精简视图”，则会从您的故事中删除额外的空间。如果仪表板中没有太多额外空间或仪表板中有多个数据故事对象，这将很有帮助。

<!-- document id=ffc1b0947d1408af35a6f22ab6df88d0c0a6de67d24ecf921b297928204647ce url=/tableau/next/zh-cn/online/data_stories_characteristics.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：特征

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

在您的 Tableau 数据故事中，您可以配置特征设置来为您的数据提供上下文，从而获得更有洞察力的故事。例如，在您的故事中，您可以指定在销售情境中，数字越大越好。但在客户投诉情境中，更高的数字是不好的。

## 使用维度和度量特征

您的故事和数字格式会根据度量值进行调整。默认情况下，您的故事作者都以数字形式测量值，您的故事不会执行任何额外的计算或应用任何特殊的呈现规则。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“特征”选项卡。
4. 配置格式设置，例如数字类型、小数位和负值。
5. 单击“保存”。

## 了解有关度量特征的详细信息

### 格式设置

如果将值的格式设置为“百分比”，那么故事会写出百分比差异，而不是像故事中数字值那样的百分比变化。当您在“特征”选项卡中将数字格式设置为“百分比”时，数据故事会将数字的值乘以 100，以创建在您的故事中显示的百分比。

如果值的格式设置为“货币”，那么您可以指定您的首选货币。您还可以指定您希望如何设置大值（大于一百万的数字）的格式，例如“$1.3 million”而不是“$1,300,000.00”。

对于“数字”和“货币”，您可以指定您希望如何写出大值和负值。如果您选择将负值写在括号中，当负值写在括号中时，您可能会在故事中看到嵌套括号。

当您选择“数字”格式时，您还可以指定是否要在故事中拼写小于或等于 10 的数字（而不是使用数字）。

对于小数位，“动态”为默认选项。这意味着故事会根据数字的大小四舍五入到不同的小数位。如果百分比值小于 10，则该数字有两位小数。如果百分比值大于 10，则数字四舍五入到最接近的整数。您还可以指定要使用的小数位数，将在整个故事中一致地使用该小数位数。

### 内容

您可以为较大的值赋予意义。例如，较大的销售额值是好的，但较大的损失值是不好的。

此外，您可以选择如何按总和或平均值聚合值。最佳做法是选择您在可视化项中使用的相同聚合方法。对于比率度量，选择“平均值”，然后通过选择该比率度量的分量度量来定义比率。作为比率组成部分的度量必须是可累加的。

![“设置”菜单将打开到“特征”选项卡，聚合设置为平均值，比率打开，并为利润和销售创建一个比率。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_ratio.png)

对于累积度量（仅适用于连续故事），选择**“总和”**，然后指定度量已经是累积的。连续故事描述了整个系列的度量总计。

### 排序

若要对维度值进行排序，请单击向上/向下箭头图标以根据维度中最早或最新的时间值进行排序。

**注意：**维度值排序仅适用于连续故事。

<!-- document id=e038edbd3418e7ebed5da9b18f889e748a9b51610af4e277325cb48eca28ab68 url=/tableau/next/zh-cn/online/data_stories_drivers.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 数据故事设置：驱动因素

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

假设您的月环比销售额大幅增长。是什么推动了销售额的增长？什么可能会减损（抵消）这些增加的销售额？在您的数据故事中设置驱动因素可以回答这些问题。

在数据故事中，驱动因素会影响总值。偏移量会从总值中减去。您将在离散故事和连续故事中找到有关驱动因素和抵消因素的洞察。这些洞察使您可以轻松准确地了解数据中发生了什么以及原因。

## 设置维度驱动因素

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“驱动因素”选项卡。
4. 从“维度驱动因素”部分，选择对您的分析影响最大的驱动因素类型：  
    对于“计数”，设置促成因素和抵消因素的最大数量。  
    对于“个别百分比”，设置写出个别促成因素和抵消因素的阈值。  
    对于“累积百分比”，根据促成因素和抵消因素的集体价值设置写出这些因素的阈值。
5. 单击“保存”。

## 了解维度驱动因素类型

- “计数”指定故事中调用的实体（促成因素者和抵消因素）的数量。例如，使用“计数”查看数据中的前三个促成因素和抵消因素。
- “个别百分比”设置一个阈值，高于该阈值的值将包含在您的故事中。例如，使用“个别百分比”来指定您只想写出占总值超过 5% 的实体。
- “累积百分比”置包括的实体合计占总值的百分比阈值。例如，使用“累积百分比”来指定您想要写出至少贡献了该总值 90% 的实体。在此示例中，实体按数量级写入，直到这些实体的累积值占总值的 90%。

## 使用次要促成因素

若要使用次要促成因素，您必须有第二个不是时间的维度。当您使用次要促成因素时，写出的每个驱动因素也都有关于其次要促成因素的详细信息和驱动因素。举例来说，如果您正在分析商店销售，则次要促成因素将是部门内的一个类。次要促成因素允许进行更深入的分析。但次要促成因素也可以包含大量信息，以适合您故事中的一个句子。

## 设置指标驱动因素

对于由其他子类度量组成的度量，驱动因素分析可以解释每个度量对顶级值的影响。例如，材料成本和运营成本会影响总成本。

若要使用指标驱动因素，您必须有多个度量用于指标分析。然后，您可以指定每个度量之间的关系。

1. [将 Tableau 数据故事添加到仪表板](https://help.tableau.com/v0.0/online/zh-cn/data_stories_create.htm)。
2. 从仪表板中，单击“数据故事”对象左上角的“设置”图标。
3. 在“数据故事”对话框中，单击“驱动因素”选项卡。
4. 从“指标驱动因素”部分，首先选择作为另一个度量的子类的度量。
5. 然后，选择作为主要类别的度量。
6. 单击“保存”。

> [!TIP]
> 
> **提示：**详细程度也适用于驱动因素。通过更改故事的详细程度，您可以调整撰写洞察的方式。如果您使用高详细程度，那么您将在括号中看到更多信息。如果您使用低详细程度，那么您将获得关于驱动因素的更简洁的书面洞察。有关详细信息，请参见[配置 Tableau 数据故事设置：叙述](https://help.tableau.com/v0.0/online/zh-cn/data_stories_narrative.htm)。

![单击数据故事对象中的“设置”图标、设置维度驱动因素、设置指标驱动因素和保存的动画。](/tableau/next/zh-cn/online/zh-cn/Img/data_stories_drivers.gif)

<!-- document id=8e05a00380759418c6fdc3721cb30c7081c8baac3f21d4df6503e93cb7c72c93 url=/tableau/next/zh-cn/online/lwc_tableau_view.md -->

[跳转到主要内容](#main-content)

# 配置 Tableau 视图 Lightning Web 组件

Tableau 视图 Lightning Web 组件 (LWC) 允许 Salesforce 客户将嵌入的 Tableau 视图从 Tableau Cloud 或 Tableau Server 拖放到 Salesforce Lightning 页面上。Tableau 视图 LWC 支持嵌入应用程序、主页和记录页面以及 Experience Cloud 页面。

有关打开 Tableau LWC、添加受信任 URL、设置无缝身份验证和主机映射以及将组件添加到 Lightning 页面的说明，请参见[配置 Tableau Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_seamless_auth.htm)。

将 Tableau 视图 LWC 添加到 Lightning 页面后，配置组件字段。

组件字段描述<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>组件字段</strong></td><td><strong>描述</strong></td></tr><tr><td>Tableau 视图的 URL</td><td><p>此字段为必填项。输入要嵌入的 Tableau 视图的 URL。</p><p>若要查找 URL，请打开新选项卡并找到您要嵌入的 Tableau 视图。选择<span class="uicontrol">“共享”</span>，然后选择<span class="uicontrol">“复制连接”</span>。</p><p><strong>注意：</strong>该 URL 必须是视图的 URL，而不是工作簿的 URL。</p></td></tr><tr><td>启用单点登录</td><td>如果您使用基于令牌的身份验证，则需要选中此框。</td></tr><tr><td>站点 ID</td><td>如果没有为<span class="uicontrol">“Tableau 视图”</span>字段中使用的 URL 指定主机映射，则无缝身份验证需要此字段。如果 Tableau 站点存在主机映射，则该字段的内容将被忽略。</td></tr><tr><td>显示选项卡</td><td>如果您想显示选项卡，请选中该框。</td></tr><tr><td>显示工具栏</td><td>如果您想显示工具栏，请选中该框。</td></tr><tr><td>高度</td><td>以像素为单位的高度。</td></tr><tr><td>自定义查询参数</td><td>用于添加自定义参数和用于视图的静态筛选。输入 FieldName=FieldValue（例如，Manufacturer=3M 或 Region=North）。</td></tr><tr><td>UAF 定义名称</td><td><strong>“应用程序”、“主页”和“记录”页面</strong><p>从 Tableau UAF 声明定义设置中配置的 UAF 声明定义中进行选择。</p><p>若要添加定义，请执行以下操作：</p><ol><li value="1"><p>选择<span class="uicontrol">“选择…”</span>。</p></li><li value="2"><p>使用箭头将可用的定义移动到<span class="uicontrol">“已选定”</span>字段。</p></li><li value="3"><p>选择<span class="uicontrol">“确定”</span>。</p></li></ol><p><strong>Experience Cloud 页面</strong></p><p>输入以逗号分隔的 UAF 声明定义名称列表。若要复制定义名称，请从 Salesforce 应用程序中导航到<span class="uicontrol">“Tableau UAF Claims Definition”（Tableau UAF 声明定义）</span>设置页面，然后选择<span class="uicontrol">“Copy”（复制）</span>。</p></td></tr><tr><td>调试模式</td><td>选中该框以打开调试模式。</td></tr><tr><td>强制刷新切换</td><td>进行故障排除时，您可以切换此复选框以仅刷新此组件，而不是刷新整个 Lightning 应用程序生成器页面或 Lightning 页面上的所有组件。</td></tr><tr><td>设置组件可见性：筛选器</td><td><p>创建筛选器以决定何时显示组件。例如，您可以根据特定用户、权限或设备规格进行筛选。</p><p>添加筛选器：</p><ol><li value="1">选择<span class="uicontrol">“添加筛选器”</span>。</li><li value="2">选择<span class="uicontrol">“选择”</span>以选择要筛选的字段。</li><li value="3">完成您的选择，然后选择<span class="uicontrol">“完成”</span>。</li><li value="4">选择<span class="uicontrol">“完成”</span>保存筛选器。</li></ol><p><strong>重要信息</strong>：您必须输入数据源中定义的字段名称。例如，如果数据源是英文的，但数据源字段为用户翻译为日语，则用户必须输入原始的英文字段名称。</p></td></tr></tbody></table>

### 仅在记录页面上可用的字段

通过以下字段，可以动态筛选最多两个字段。例如，您可以使用复选框筛选“帐户 ID”，使用高级筛选筛选滤“州/省/市/自治区”。

组件字段描述

<table class="table--plain"><colgroup><col></colgroup><colgroup><col></colgroup><tbody><tr><td><strong>组件字段</strong></td><td><strong>描述</strong></td></tr><tr><td>按记录 ID 筛选</td><td>用于使用记录 ID 动态筛选视图。视图数据源中的字段名称必须与“记录类型 ID”格式匹配并且区分大小写。例如，如果 Lightning 页面用于帐户记录，则视图中的字段必须命名为“帐户 ID”。</td></tr><tr><td>Tableau 动态筛选器名称</td><td>用于使用当前记录中的特定字段进行动态筛选。输入视图数据源中的字段名称。</td></tr><tr><td>Salesforce 动态筛选器值</td><td>用于使用当前记录中的特定字段进行动态筛选。在 Salesforce 记录上选择相应的字段。</td></tr></tbody></table>

## Tableau 视图组件故障排除

从包含 Tableau 视图 Lightning Web 组件的页面中，选择齿轮图标，然后选择“编辑页面”。

1. 单击 Tableau 视图 Lightning Web 组件以打开属性编辑器。
2. 确认**“Tableau 视图字段的 URL”**包含 Tableau 视图（而不是工作簿）的有效 URL。打开 Tableau 视图的“共享”对话框，然后选择“复制链接” 。
3. 必须选中“启用单点登录”复选框。
4. 如果尚未为此站点保存主机映射，请验证“站点 ID”字段。**注意**：如果为站点定义了主机映射，则站点 ID 字段将被忽略。

- 对于 Tableau Cloud，必须使用从嵌入式 Tableau 视图共享对话框复制的站点 ID 填充该字段。
- 对于 Tableau Server，该字段必须为空。

有关其他 Tableau LWC 和无缝身份验证信息以及故障排除，请参见[配置 Tableau Lightning Web 组件](https://help.tableau.com/current/online/zh-cn/lwc_seamless_auth.htm)。

<!-- document id=0d86b5936ff242f50ae272a27b2dc165f77567c18212ee5416f375b3cda4bf15 url=/tableau/next/zh-cn/online/config_r_tabpy.md -->

[跳转到主要内容](#main-content)

# 配置与分析扩展程序的连接

分析扩展程序允许您使用 R 和 python 等语言，使用 Einstein Discovery，以及使用其他工具和平台在工作簿中扩展 Tableau 动态计算。这些设置端点使您能够在 Tableau Cloud 中的站点上配置分析扩展程序。有关详细信息，请参见[分析扩展程序 API](https://tableau.github.io/analytics-extensions-api/)。

有关用户方案以及在 Tableau Desktop 中配置分析连接或进行 Web 制作的详细信息，请参见 _Tableau Desktop 和 Web 制作帮助_中的[使用分析扩展程序传递表达式](https://help.tableau.com/current/pro/desktop/zh-cn/r_connection_manage.htm)。

**注意：**从 2021 年 6 月开始，您可以为一个站点创建多个分析扩展程序连接，包括为同一类型的扩展程序创建多个连接（目前仅限于每个站点的单个 Einstein Discovery 分析扩展程序）。有关详细信息，请参见[Tableau Cloud 发行说明](https://help.tableau.com/v0.0/online/zh-cn/whatsnew_online.htm#2021-2-multiple-analytics-ext-per-TOLsite)。

本主题介绍如何配置 Tableau Cloud 上的站点以使用分析扩展程序。

## 安全要求和配置

为了增强安全性，Tableau Cloud 需要加密通道和对用于分析扩展程序的外部服务的已验证访问权限。

### 证书

运行用于分析扩展程序的外部服务的服务器必须配置为使用来自受信任的第三方证书颁发机构 (CA) 的有效 TLS/SSL 证书。Tableau Cloud 不会与配置为使用自签名证书、来自专用 PKI 的证书或已建立的第三方 CA 不信任证书的外部服务器建立连接。

### 安全列表防火墙配置

许多组织部署的防火墙要求将网络外已知主机的例外放入安全列表。在这种情况下，您需要指定两个 Tableau Cloud IP 地址作为例外。用于连接到分析扩展程序服务器的 Tableau Cloud IP 地址为 `44.224.205.196` 和 `44.230.200.109`。

## 配置分析扩展程序设置

1. 以站点管理员身份登录到 Tableau Cloud。
2. 单击“设置”。
3. 在“设置”页面上，单击“扩展程序”选项卡，然后滚动到“分析扩展程序”。
4. 选择“为站点启用分析扩展程序”。
5. 单击“创建新连接”。
6. 在“新建连接”对话框中，单击要添加的连接类型，然后输入分析服务的配置设置：
    
    ![显示“新建连接”对话框，其中有四种连接类型选择选项：TabPy、Einstein Discovery、RServe 和 Analytics Extensions API。](/tableau/next/zh-cn/online/zh-cn/Img/analytics-extension-site-cx-type.png)
7. 您需要配置的选项取决于所选择的连接类型：
    
    - 对于 Einstein Discovery 连接，单击“启用”。
    - 对于 TabPy、Rserve 和分析扩展程序 API 连接，请输入以下信息：
        - 连接名称：指定要连接到的服务器类型。RSERVE 支持使用 Rserve 软件包连接到 R。TABPY 支持使用 TabPy 或其他分析扩展程序连接到 Python。
        - 要求 SSL：选择此选项以加密与分析服务的连接。如果在“主机名”字段中指定 `HTTPS` URL，则必须选择此选项。
        - 主机名：指定运行分析服务的计算机名称或 URL。此字段区分大小写。
        - 端口：指定服务的端口。
        - 使用用户名和密码登录：选择此选项以指定用于对分析服务进行身份验证的用户名和密码。
8. 单击“保存”。

### 编辑或删除分析扩展程序连接

若要编辑或删除配置，请导航到站点的“扩展程序”选项卡上的“分析扩展程序”。

![在“分析扩展程序”选项中突出显示的“编辑”和“删除”图标。](/tableau/next/zh-cn/online/zh-cn/Img/analytics-extension-edit-delete.png)

单击“编辑”或“删除”图标并按照提示操作来更改配置。

## 脚本错误

Tableau 无法验证使用分析扩展程序的工作簿在 Tableau Cloud 上能否正确呈现。可能存在这样的情形：需要的统计库在用户计算机上可用，但在 Tableau Cloud 使用的分析扩展程序实例上不可用。

如果工作簿包含使用分析扩展程序的视图，在发布工作簿时将显示警告。

此工作表包含外部服务脚本，除非管理员配置外部服务连接，否则无法在目标平台上查看这些脚本。

<!-- document id=36c741e7c75be7bd66bf39e6aabdd5af0a223531070802085f907b3f2244fc5f url=/tableau/next/zh-cn/online/to_enable_bridge_live_connections.md -->

[跳转到主要内容](#main-content)

# 配置池

本主题介绍站点管理员如何配置和管理 Bridge 客户端的池化。池化允许站点中的客户端对连接到私有网络数据的数据源或虚拟连接的数据新鲜度任务进行负载平衡。

池的目的是在池中的可用客户端之间分摊（或平衡）数据新鲜度任务的负载，该池的访问范围限于您私有网络中的域。池映射到域，使您能够通过限制对私有网络中受保护域的访问，将池专用于使特定数据保持最新和维护安全。

尽管池中用于执行数据新鲜度任务的客户端是随机选择的，但如果出于任何原因客户端无法再执行任务，则系统会自动该任务重新路由到池中的另一个可用客户端来处理该任务。客户端池的支持或和管理无需您或用户进行额外干预。

池优化用于使连接到一个或多个私有网络上的数据的数据源或虚拟连接保持最新。池化支持不会扩展到使用 Bridge（旧版）计划的数据源。

通常会针对以下情况对池化进行优化。

- **Bridge 被用作关键服务。**您的组织要求实时查询和计划刷新支持必须可用（即使在客户端变得不可用的情况下也是如此）。
- **客户端满负荷运行。**您的现有站点流量超出客户端的当前容量。
- **Tableau Cloud 管理的基于文件的数据源的计划。**从 Bridge 客户端版本 2021.4.3开始，Bridge 池为基于文件的数据源启用 Bridge 刷新计划。
- **在多个私有网络上使数据保持最新。**
- **虚拟连接。**（需要 Data Management）需要 Bridge 来刷新连接到私有网络数据的虚拟连接中的数据。有关虚拟连接的详细信息，请参见[关于虚拟连接和数据策略](https://help.tableau.com/v0.0/online/zh-cn/dm_vconn_overview.htm)。

### 在配置池化之前

在为站点配置客户端池之前，请查看以下内容：

- 客户端必须已安装并正在运行。有关软件和硬件的详细信息，请参见[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#system)。
- 客户端配置为以服务方式运行。有关详细信息，请参见[应用程序模式与服务模式](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm#mode)。
- 在客户端中经过身份验证的用户是 Tableau Cloud 站点管理员。有关部署 Bridge 的详细信息，请参见[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)。
- 为了使虚拟连接保持最新，请确保池中的所有客户端都运行 Bridge 2021.4（或更高版本）。
- 若要对基于文件的数据源进行负载平衡，请确保以下各项：
    - 池中的所有客户端都运行 Bridge 2021.4.3（或更高版本）。
    - 对文件数据的引用必须使用包含服务器名称或主机名的完整 UNC 路径。有关详细信息，请参见[关于 Bridge 客户端](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_client.htm)。
    - 基于文件的数据源仅限数据提取。

#### 有关用户角色的注释

只有站点管理员或者具有“站点管理员”或“站点管理员 Creator”角色的用户才能配置和维护池化客户端。无论在客户端中进行身份验证的用户类型如何，只有站点管理员才能添加新池、将客户端添加到池、从池中移除客户端，并监视池中的客户端。

#### 关于刷新作业的注意事项

“作业”页面可以显示使用 Bridge 刷新计划的已完成、正在进行、待定、已取消和挂起的所有 Bridge 刷新作业。这包括基于文件和非基于文件的数据源的刷新。有关详细信息，请参见[关于 Bridge 刷新作业](https://help.tableau.com/v0.0/online/zh-cn/server_backgrounder_job_management.htm#bridge)。有关监控 Bridge 活动的各种方法的详细信息，请参见[监视数据新鲜度任务](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_manage.htm#monitor)。

### 步骤 1：确保客户端可以连接到站点

为了使 Bridge 能够处理您的站点，您必须允许客户端向站点进行身份验证。

1. 使用站点管理员凭据登录到 Tableau Cloud，并转到“设置”页面。
2. 单击“身份验证”选项卡，并验证“连接的客户端”标题下的“**允许客户端自动连接到此 Tableau Cloud 站点**”复选框是否处于选中状态。有关此复选框的详细信息，请参见[从连接的客户端中访问站点](https://help.tableau.com/v0.0/online/zh-cn/to_connected_clients.htm)。
    
    **注意：**如果启用，则必须启用连接的客户端选项以支持包含 Tableau 身份验证的多重身份验证。如果为站点禁用了已连接客户端，则 Bridge 只能支持 Tableau 用户名和密码身份验证。

### 步骤 2：配置池

需要 Bridge 2021.4（或更高版本）客户端的池有助于将实时查询和数据提取刷新作业路由到适当的私有网络。使用池访问分布在多个私有网络中的数据，为基于文件的数据源启用数据提取刷新，并支持虚拟连接的数据新鲜度任务。

1. 在“Bridge”选项卡上的“池化”下，单击“添加新池”按钮。
2. 在对话框的“池”文本框中输入新池名称，然后单击“保存”。

在您至少配置了一个池后，Tableau Cloud 会在发布过程中自动将某些数据源或虚拟连接与 Bridge 和客户端池相关联。

### 步骤 3：为池指定域

每个新池都需要通过私有网络允许列表指定一个域。Bridge 需要此信息才能代表 Tableau Cloud 访问专用网络中的数据。

您的组织中的允许列表和池中的域总数不得超过 100 个。

使用私有网络允许列表，您必须指定要启用客户端访问权限的私有网络域。这些域应对应于您希望让 Bridge 代表 Tableau Cloud 访问的数据库和文件共享的私有网络位置。

#### 域名

您在允许列表中指定的域名是数据源连接或虚拟连接中使用的服务器名称。在某些情况下，您可以在 Tableau Cloud 的数据源页面的“连接”选项卡中找到列出的服务器名称。

**注意**：访问连接到已发布数据源的工作簿时，请不要在私有网络允许列表中使用 \*.tableau.com。域 \*.online.tableau.com 用于出站连接的代理筛选。请参见[可选的转发代理筛选](https://help.tableau.com/current/online/zh-cn/to_bridge_security.htm)。

例如，为了使“Starbucks”等数据源保持最新，您可以在允许列表中指定“mssql.myco.lan”和“oracle.myco.lan”或“\*.myco.lan”。

![“连接”选项卡列出了两个数据库的连接：Microsoft SQL Server 和 Oracle。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_online_server_name.png)

若要使“Fitness Challenge”等数据源保持最新状态，请在允许列表中指定“fitness-challenge”。

![Tableau Cloud 和 Server的“连接”选项卡。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_online_server_name_missing.png)

在其他情况下，“连接”选项卡可能不会列出服务器名称。如果未列出服务器名称，请考虑与内容所有者合作确定数据的托管位置，并在获得该信息后在允许列表中指定服务器名称。作为临时替代方案，您可以跳到[步骤 4：将客户端添加到池](#step4)以指定客户端改为使用默认池。

#### IP 地址

您可以在允许列表中指定 IPv4 地址，而不是域名。如果在数据源连接或虚拟连接中使用 IPv4 地址，我们建议您在允许列表中指定 IPv4 地址。考虑与您的内容所有者合作以获取此信息。如果您没有该信息，作为临时替代方案，您可以跳到[步骤 4：将客户端添加到池](#step4)以指定客户端改为使用默认池。

**注意：**

- 出于安全考虑，允许列表默认为空以防止 Tableau 访问。这可确保站点管理员指定可以使用 Bridge 将哪些数据发送到 Tableau Cloud。
- 您可以将 Fiddler 与 Tableau Desktop 结合使用来捕获连接到数据源时使用的 URI。有关详细信息，请参见 [Fiddler](https://www.telerik.com/fiddler)。
- 可以将一个或多个域分配给池。
- 如果您的站点在 Tableau 2021.4 之前设置为使用池化，则出于向后兼容性目的“默认池”会保留，但无法配置为访问特定私有网络。为减少此池的访问范围并启用更高级的调度功能，我们建议您创建新池并将其映射到特定域。

若要将域映射到池，请执行以下操作：

1. 在“Bridge”选项卡上的“私有网络允许列表”下，单击“添加新域”按钮。
2. 在“域”文本框中，使用[允许列表注册表规则](#allowlist_rules)中描述的信息输入域的 URI。
3. 在“域权限”下，确保选中“允许”单选按钮。
4. 在“池”下选择池，该池的访问范围应限制为您在步骤 2 中指定的 URI。
5. 为每个其他域重复步骤 1-4。
6. 完成后，单击“保存”。

#### 允许列表注册表规则

指定要启用 Bridge 访问的域时，请使用以下规则。这允许 Bridge 代表 Tableau Cloud 访问您私有网络上的数据以执行数据新鲜度任务。域使 Bridge 能够连接到托管在该域中的数据库和文件数据。

**注意：**

- 允许列表注册表中的池数加域数的总数不得超过 100。如果这些组合对象的数量超过 100 个，则无法添加新池。
- 在添加到允许列表、发布数据源或虚拟连接，或在配置刷新计划当时_不会_验证域。
- 由于未验证域名及其 IP 地址，因此将同一域添加到允许列表中导致重复。在这种情况下，如果一个池映射到域名，另一个池映射到 IP 地址，则数据源连接或虚拟连接中指定的格式决定了哪个池保持数据最新。
- 域必须可由 Bridge 访问。这意味着，池中的所有客户端都必须有权访问指定的域。
- 如果未指定域，Bridge 无法为针对 Bridge 刷新计划配置的数据源或虚拟连接运行数据新鲜度任务。**注意：**针对 Bridge 旧版计划配置的数据源将继续以相同方式运行。
- 域条目支持以下字符：
    - 字母：A–Z、a–z
    - 数字：0–9
    - 符号：-。\* / @# % & ( ) + = \[ \] { } ; : ", < >? |\\

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">方案</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">描述</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">示例</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">数据提取域名</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">可以是 FQDN 或 PQDN。不允许使用端口号。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>myco.com<br>marketing.myco.com<br>oracle.myco.com</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">域名范围</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><p>使用可选的前导通配符 (*) 以包含所有子域。* 后面必须直接跟一个句点 (.)。</p></td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">*.myco.com</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">确切的 IPv4 地址</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">使用 IPv4 文字（不允许使用缩写）。不允许使用 IPv6 地址。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><p>255.255.0.1<br>192.168.0.0</p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">IPv4 地址范围</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">使用子网掩码包括 IPv4 地址范围。</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">255.255.0.1/16</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">阻止域</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（仅限指定池）阻止 Bridge 与此域中主机连接。</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>在私有网络允许列表中添加或编辑域时，选择<span class="uicontrol">“阻止”</span>单选按钮选项。</p><p><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/bridge_pools_block.png" alt="“添加新域”对话框，其中包含允许或阻止域的选项。"></p></td></tr></tbody></table>

#### 允许列表注册表示例

**示例 1 - 数据库数据**

假设您希望 Bridge 执行以下操作：

- 对位于 **data.lan** 和 **sqlserver.myco.lan** 中的数据执行数据新鲜度任务。
- _阻止_位于 **oracle.myco.lan** 中的数据的数据新鲜度任务。

为了使 Bridge 能够支持这些方案，您可以将域映射到两个池（A 和 B）并阻止第三个域。

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" 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><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">如果指定...</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;">并映射到池...</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="font-weight: bold;">...数据在位置中刷新</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">*.lan</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">池 A</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">data.lan</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">sqlserver.myco.lan</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">池 B</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">sqlserver.myco.lan</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><p>*.myco.lan</p><p><b>注意：</b>尽管此域范围会阻止 oracle.myco.lan 上的数据新鲜度任务，但如果明确允许该域（例如 sqlserver.myco.lan），则被阻止的域范围可以解除对其中的特定域的阻止。</p></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">（已阻止）</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">-</td></tr></tbody></table>

**示例 2 - 文件数据**

假设您有位于 **fileserv.myco.lan**上的文件数据 C:\\Shared\\employees.csv。若要启用 Bridge 对此数据的访问，请将计算机的域映射到池。您可以为池指定以下域_之一_：

- 选项 #1：\*.lan
- 选项 #2：\*.myco.lan
- 选项 #3：fileserv.myco.lan

**注意：**主机计算机必须允许对“共享”文件夹的网络访问。

### 步骤 4：将客户端添加到池

按照以下步骤分配尚未分配到池的客户端。

**注意：**若要支持所有数据的数据新鲜度任务，请确保池中的客户端运行 Bridge 2021.4（或更高版本）。

1. 在 **“取消分配客户端”**表的“Bridge”选项卡上，导航到要分配给池的客户端，然后单击“分配”。
2. 在“池”下拉菜单中，选择要与客户端关联的池。
3. 为要分配给池的每个未分配客户端重复步骤 2。

## 池化疑难解答

**Bridge 刷新作业失败，并出现下列错误之一。**

可能会在“作业”页面和“非数据提取后台任务”管理视图上看到以下错误。

- “errorID=NO\_POOLED\_AGENTS\_ASSIGNED”
    
    此问题是默认池特有的，可能由于以下两种原因之一而发生： 
    
    - 当数据源的服务器地址或 IP 地址与专用网络允许列表中指定的域不匹配时。这会导致将刷新作业发送到没有分配客户端的默认池。
        
        若要解决此问题，请确保 1) 允许列表包含数据源使用的域（服务器地址或 IP 地址），以及 2) 至少一个池与这些域（服务器地址或 IP 地址）相关联。有关详细信息，请参见[步骤 3：为池指定域](#step3)。
    - 当默认池中没有客户端时。若要解决此问题，请至少向默认池中添加一个 Bridge 2020.2 （或更高版本）客户端。有关详细信息，请参见[步骤 4：将客户端添加到池](#step4)。
- "errorID=NO\_POOLED\_AGENTS\_ASSIGNED\_NAMED\_POOL"
    
    如果指定池中没有客户端，则可能会出现此问题。若要解决此问题，请至少向指定池中添加一个 Bridge 2021.4 （或更高版本）客户端。有关详细信息，请参见[步骤 4：将客户端添加到池](#step4)。
- “errorID=NO\_AGENT\_IN\_POOL\_SUPPORTS\_REMOTE\_EXTRACT\_REFRESH”
    
    当刷新作业尝试在池中没有至少一个 Bridge 2020.2（或更高版本）客户端的情况下运行时，可能会出现此问题。若要解决此问题，请至少向池中添加一个 Bridge 2020.2 （或更高版本）客户端。有关详细信息，请参见[步骤 3：为池指定域](#step3)。
- “errorID=NO\_POOLED\_AGENTS\_CONNECTED”
    
    当池中的任何客户端都无法运行数据新鲜度任务时，可能会出现此问题。有关详细信息，请参见上面的[配置池](#status)部分。
- 客户端中的“errorID=REMOTE\_EXTRACT\_REFRESH\_ALL\_AGENTS\_BUSY”或“errorMessage: Maximum concurrency reached”
    
    如果在给定时间运行的刷新作业数超过客户端池的容量，则可能会出现这些问题。为了帮助解决此问题，您可以执行以下操作： 
    
    - 将其他客户端添加到池中。有关详细信息，请参见[步骤 4：将客户端添加到池](#step4)。
    - 增加每个客户端上的 **connectionPool** 设置的大小。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#poolcapacity)。
- **“errorID= AGENTS\_IN\_POOL\_REQUIRE\_UPGRADE”**
    
    从 Tableau 2021.4 开始，当池中的客户端需要升级到 Bridge 2021.4（或更高版本）以运行数据新鲜度任务时，可能会出现此问题。有关升级客户端的详细信息，请参见[安装 Bridge](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_install.htm#upgrade-bridge)。

**Bridge 客户端被注销**

如果在同一 Windows 服务帐户下部署大量客户端，则可能发生此问题。当一个 Windows 服务帐户下运行的客户端超过 10 个时，帐户安全措施可能会导致客户端注销。有关详细信息，请参见[Windows 服务帐户](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#windows)。

**其他潜在的池化问题**

尝试诊断与池化相关的问题时，请考虑查看 Bridge 客户端计算机上客户端的以下日志文件：_tabbridgeclijob\_<进程 id>_、_jprotocolserver\_<进程 id_\>、_stdout\_jprotocolserver\_<进程 id>_。有关详细信息，请参见[更改 Bridge 客户端设置](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#log-config)。

**添加新池导致错误，发生内部系统错误**

如果您组织中的池总数与允许列表注册表中的域数量总和超过 100，则可能会出现此错误。

<!-- document id=de7f9a48dd754afa828955c3d5a0b65e06bf2ccf9768b922eef582511928ac8e url=/tableau/next/zh-cn/online/openid_auth_server_config.md -->

[跳转到主要内容](#main-content)

# 针对 OpenID Connect 配置 Tableau Cloud 或 TCM

本主题描述如何将 Tableau Cloud 或 Tableau Cloud Manager (TCM) 配置为使用 OpenID Connect (OIDC) 进行单点登录 (SSO)。这是由多个步骤组成的过程中的一步。以下主题提供有关配置以及将 OIDC 与 Tableau Cloud 或 TCM.一起使用的信息。

1. [OpenID Connect](https://help.tableau.com/v0.0/online/zh-cn/openid_auth.htm) 概述
2. [针对 OpenID Connect 配置身份提供程序](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_idp_config.htm)
3. 针对 OpenID Connect 配置 Tableau Cloud 或 TCM（此部分）

**注意：**

- 在执行此处介绍的步骤之前，您必须配置 OpenID 提供程序，如 [针对 OpenID Connect 配置身份提供程序](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_idp_config.htm) 中所述。需要单独的设置和应用程序集成才能为 Tableau Cloud 和 TCM 启用 OIDC 身份验证。
- 或者，您可以使用 Tableau REST API 通过 [OpenID Connect 方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_openid_connect.htm)为 Tableau Cloud 配置 OIDC 身份验证。**注意：**仅适用于 Tableau Cloud。
- 对于 Tableau Cloud，Tableau REST API 和 tabcmd 不支持 OIDC 单点登录 (SSO)。若要使用 [tabcmd](https://help.tableau.com/v0.0/online/zh-cn/tabcmd.htm) 或 [Tableau REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm "在新选项卡中打开 REST API 帮助。")，用户必须使用个人访问令牌 (PAT) 登录到 Tableau Cloud。
- 对于 TCM，Tableau Cloud Manager REST API 不支持 OIDC SSO。若要使用 [TCM REST API](https://help.tableau.com/current/api/cloud-manager/zh-cn/index.html "在新选项卡中打开 TCM REST API 帮助。")，用户必须使用 PAT 登录 TCM。

## 要求

### 参数

- **客户端 ID：**此值由 IdP 颁发，并指定已注册 Tableau Cloud 或 TCM 的标识符。这使得 IdP 能够知道身份验证请求来自哪里。
- **客户端密文：**这是 Tableau Cloud 或 TCM 用于验证来自 IdP 的响应的真实性的令牌。此值应妥善保管。
- **配置 URL：**此值指定对用户进行身份验证后 IdP 重定向到的 URL。URL 必须包括主机和协议（例如，`https://admin.okta.com/oauth2/default/.well-known/openid-configuration`），但 Tableau 会提供 URL 端点。此 URL 指定包含 OpenID 提供程序元数据的提供程序配置发现文档的位置。
    
    **注意：**如果您的 IdP 未提供配置 URL，请使用以 `.well-known/openid-configuration` 结尾的 URL。对于 Tableau Cloud，请考虑使用 Tableau REST API 中的 [OpenID Connect 身份验证方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_openid_connect.htm)配置 OIDC。

#### 可选参数

**注意：**仅适用于 Tableau Cloud。

可以使用 Tableau REST API 中的 [OpenID Connect 身份验证方法](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_openid_connect.htm)配置以下可选参数。

- **提示：**提示用户重新认证并同意。默认情况下，用户同意处于打开状态。
- **自定义范围：**用于查询 IdP 的自定义范围用户相关值。
- **客户端身份验证：**令牌端点身份验证方法。默认值为 `'client_secret_basic'`。支持值 `'client_secret_post'`。
- **基本 ACR 值：**用于身份验证的基本身份验证上下文参考类值的列表。
- **自愿 ACR 值：**用于身份验证的自愿身份验证上下文参考类值的列表。

### 声明

若要成功登录到 Tableau Cloud 或 TCM，必须在 OpenID Connect (OIDC) IdP 中预置给定用户，然后将其映射到 Tableau Cloud 或 TCM 上的用户帐户。OIDC 使用依赖于声明的方法与其他应用程序共享用户帐户属性。Tableau Cloud 或 TCM 依赖于 IdP 声明将 IdP 中的用户帐户映射到 Tableau Cloud 或 TCM 上托管的用户帐户。声明包括用户帐户属性，例如电子邮件、名字等。若要了解 Tableau Cloud 或 TCM 如何将 IdP 声明映射到用户帐户，请参见[身份验证概述](https://help.tableau.com/v0.0/online/zh-cn/openid_auth.htm#overview)。

**注意：**声明区分大小写。

- **用户名：**默认情况下，Tableau 期望 IdP 传递用户名声明。根据您的 IdP，您可能需要将 Tableau Cloud 配置为使用其他 IdP 声明。**注意：**Tableau 中的用户名是不可变的，无法随时更新。
- **姓名声明：**您可以指定姓名或姓氏来检索用户的 DisplayName。
- **电子邮件声明：**（可选）从 2025 年 7 月开始，您可以指定不同于用户名的电子邮件地址。电子邮件地址声明仅用于通知目的，不用于登录。

## 启用 OIDC 单点登录

### 步骤 1：配置 OpenID Connect

**对于 Tableau Cloud**

1. 以站点管理员身份登录到 Tableau Cloud 并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，单击“新配置”按钮，选择“OpenID Connect (OIDC)”，然后输入配置的名称。
3. 按照以下步骤，通过执行以下操作来配置 Tableau Cloud 以进行 OIDC 身份验证：
    
    1. 在步骤 1 中，输入 IdP 提供的所需信息，包括客户端 ID、客户端密文和配置 URL。
    2. 在步骤 2 中，复制将粘贴到 IdP 门户中的 Tableau Cloud 重定向 URL，以在用户进行身份验证后重定向用户。
    3. 在步骤 3 中，输入声明以确保用户用户名和显示名称的正确映射。
    4. 在步骤 4 中，如果您的 IdP 支持，可以选择启用单点注销 (SLO)。
    5. 在步骤 5 中，可以选择用户在访问嵌入视图时进行身份验证的方式：在单独的弹出窗口中或使用内联 iFrame。
        
        **注意：**您可以在“身份验证”页面上的“嵌入视图的默认身份验证类型”部分（位于 OIDC 配置步骤下方）下选择嵌入视图的身份验证类型。
4. 完成后，单击“保存更改”按钮。

**注意：**编辑 OIDC 配置时，客户端密文是隐藏的，需要重新输入才能保存任何更改。

**对于 TCM**

1. 以云端管理员身份登录到 TCM，并选择“设置”\>“身份验证”。
2. 在“身份验证”选项卡上，选中“启用其他身份验证方法”复选框。
3. 从下拉菜单中选择“OpenID Connect (OIDC)”，并单击“配置（必需）”下拉箭头。
4. 按照相关步骤，通过执行以下操作来配置 TCM 以进行 OIDC 身份验证：
    
    1. 在步骤 1 中，输入 IdP 提供的所需信息，包括客户端 ID、客户端密文和配置 URL。
    2. 在步骤 2 中，复制将粘贴到 IdP 门户中的 TCM 重定向 URL，以在用户进行身份验证后重定向用户。
    3. 在步骤 3 中，输入声明以确保用户用户名和显示名称的正确映射。
    4. 在步骤 4 中，如果您的 IdP 支持，可以选择启用单点注销 (SLO)。
5. 完成后，单击“保存更改”按钮。

**注意：**编辑 OIDC 配置时，客户端密文是隐藏的，需要重新输入才能保存任何更改。

### 步骤 2：测试配置

我们强烈建议您测试配置以避免任何锁定情况。测试配置有助于确保在将用户的身份验证类型更改为 OIDC 之前正确配置了 OIDC。为了成功测试配置，请确保至少有一个您可以登录的用户，该用户已在 IdP 中预置并添加到 Tableau Cloud 或 TCM 中，并配置了 OIDC 身份验证类型。

**注意：**如果您不确定声明是什么，请完成配置并测试配置。测试配置将生成一个新窗口，其中包含声明映射详细信息，包括用户名和显示名称声明。某些 IdP 可能会将电子邮件地址映射到 Tableau 用户名。

**对于 Tableau Cloud**

1. 在选择 OpenID Connect (OIDC) 的“身份验证”选项卡上，在步骤 6 下单击“测试配置”按钮。将显示一个新窗口，其中包含有关配置的详细信息。
2. 完成后，按照以下步骤将用户添加到您的站点，从而完成 OIDC 设置。

**对于 TCM**

1. 在选择 OpenID Connect (OIDC) 的“身份验证”选项卡上，在步骤 5 下单击“测试配置”按钮。将显示一个新窗口，其中包含有关配置的详细信息。
2. 完成后，按照以下步骤将用户添加到您的租户，从而完成 OIDC 设置。

### 步骤 3：将用户添加到启用 OpenID Connect 的 Tableau 站点 或 TCM

本部分中描述的步骤是在 Tableau Cloud 或 TCM 的“用户”页面上执行的。

1. 完成上述步骤后，返回 Tableau Cloud 站点或 TCM。
2. 从左侧窗格中，选择“用户”页面。
3. 按照以下主题之一中描述的步骤进行操作：
    
    - 对于 Tableau Cloud，请参见[向站点添加用户](https://help.tableau.com/v0.0/online/zh-cn/sites_addusers.htm)
    - 对于 TCM，请参见[使用 Tableau Cloud Manager 管理用户](https://help.tableau.com/v0.0/online/zh-cn/cloud_manager_users.htm)

### 疑难解答

使用以下部分在 Tableau Cloud 或 TCM 中排查 OpenID Connect (OIDC) 问题。

许多身份提供程序支持 OIDC 协议。OIDC 协议是一个开放和灵活的标准，因此，并非所有标准实现都是相同的。管理员在为 OIDC 配置 Tableau Cloud 或 TCM 时遇到的大多数问题是不同身份提供程序实现 OIDC 的结果。如果您在设置 OIDC 以及 Tableau 时遇到错误，我们建议您使用 IdP 来解决它们。

#### 从命令行登录

**对于 Tableau Cloud**

即使 Tableau Cloud 配置为使用 OIDC，但如果您使用 [tabcmd](https://help.tableau.com/v0.0/online/zh-cn/tabcmd.htm)、[Tableau REST API](https://help.tableau.com/current/api/rest_api/en-us/help.htm) 或 [Tableau 数据提取命令行实用工具](https://help.tableau.com/current/pro/online/zh-cn/help.htm)（随 Tableau Desktop 提供）登录 Tableau Cloud，也不会使用 OIDC 身份验证。

**对于 TCM**

同样，即使 TCM 配置为使用 OIDC，登录 [Tableau Cloud Manager REST API](https://help.tableau.com/current/api/cloud-manager/zh-cn/index.html "在新选项卡中打开 TCM REST API 帮助。") 时也不会使用 OIDC 身份验证。

#### 登录失败

在某些情况下，登录 Tableau Cloud 或 TCM 可能会失败并显示以下消息：

_Login failure: Identity Provider authentication unsuccessful for user <username\_from\_IdP>.Failed to find the user in Tableau Cloud.（登录失败：用户 <username\_from\_IdP> 的身份提供程序身份验证成功。未能在 Tableau Cloud 中找到用户。）_

此错误通常意味着 Tableau 中存储的用户名与 IdP 提供的用户名之间存在不匹配。为了解决此问题，请确保用户名值匹配。例如，如果 Jane Smith 的用户名在 IdP 中存储为“jsmith@example.com”，那么它在 Tableau Cloud 或 TCM 中也必须存储为“jsmith@example.com”。

## 使用用户属性自定义和控制数据访问

用户属性是组织定义的用户元数据。在典型的基于属性的访问控制 (ABAC) 授权模型中，用户属性可用于确定访问权限。用户属性可以是用户配置文件的任何方面，包括工作角色、部门成员身份、管理级别等。它们还可能与运行时用户上下文相关联，例如用户的登录位置或他们的语言首选项。

通过在工作流中包含用户属性，您可以通过数据访问和个性化来控制和自定义用户体验。

- **数据访问**：用户属性可用于实施数据安全策略。这可以确保用户只能看到他们有权查看的信息。
- **个性化**：通过传递位置和角色等用户属性，可以自定义内容以仅显示与访问内容的用户相关的信息，从而使他们能够更轻松地找到所需的信息。

**传递用户属性的步骤摘要**

在工作流中启用用户属性的过程总结为以下步骤：

1. 启用用户属性设置
2. 在断言中包括用户属性
3. 确保内容作者包括用户属性函数和相关筛选器
4. 查看内容

### 步骤 1：启用用户属性设置

出于安全目的，仅当站点管理员启用用户属性设置时，才会在身份验证工作流中验证用户属性。

1. 登录到 Tableau Cloud 并单击“设置”\>“身份验证”。
2. 在“控制身份验证工作流程中的用户访问”标题下，选中“在身份验证工作流中启用用户属性捕获”复选框。

有关站点设置的详细信息，请参见[在身份验证工作流程中控制用户访问](https://help.tableau.com/v0.0/online/zh-cn/sites_add.htm#user-attributes)。

### 步骤 2：在断言中包括用户属性

请确保断言包含用户属性。

**注意：**SAML 响应中的属性受 4096 个字符限制的约束，但 `scp` 或 `scope` 属性除外。如果响应中的属性（包括用户属性）超过此限制，Tableau 将移除这些属性并改为传递 `ExtraAttributesRemoved` 属性。然后，内容作者可以使用 `ExtraAttributesRemoved` 属性创建一个计算，以确定在检测到该属性后如何向用户显示内容。

**示例**

假设您有一名员工 Fred Suzuki，他是南部区域的经理。您需要确保，当 Fred 审阅报告时，他只能看到南部区域的数据。在这种情况下，您可能会在 SAML 响应中包括 Region 用户属性，如下例所示。

<saml:Assertion xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
	<saml;Issuer">https://myidp.okta.com/saml</saml:Issuer">
   <saml;Subject">
	  <saml:NameId Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"fsuzuki@example.com</saml:NameID">
   <saml:AttributeStatement xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
  		<saml:Attribute Name="Region" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">
  			<saml:AttributeValue">South</saml:AttributeValue">
    	</saml:Attribute">
   </saml:AttributeStatement">
</saml:Assertion">

### 步骤 3：确保内容作者包括属性函数

确保内容作者包括用户属性函数和相关筛选器，以控制哪些数据可以显示在其内容中。为了确保将用户属性断言传递给 Tableau，内容必须包含以下用户属性函数之一：

- `USERATTRIBUTE('attribute_name')`
- `USERATTRIBUTEINCLUDES('attribute_name', 'expected_value')`

内容作者使用的函数取决于用户属性是预期返回单个值还是多个值。有关这些函数及其示例的详细信息，请参见 Tableau 帮助中的[用户函数](https://help.tableau.com/current/pro/desktop/zh-cn/functions_functions_user.htm#user_attributes)。

**注意：**

- 在 Tableau Desktop 或 Tableau Cloud 中进行制作时，无法预览包含这些函数的内容。函数将返回 NULL 或 FALSE 。为确保用户函数按预期工作，我们建议作者在提供内容后查看函数。
- 为了确保内容按预期呈现，内容作者可以考虑包括一个使用 `ExtraAttributesRemoved` 执行以下操作的计算：1) 检查此属性，以及 2) 如果检查到该属性，则确定如何处理该内容，例如显示一条消息。Tableau 只会在 SAML XML 中的属性超过 4096 个字符时添加 `ExtraAttributesRemoved` 属性并移除所有其他属性（ `scp` 或 `scope` 除外）。这是为了确保最佳性能并遵守存储限制。

**示例**

继续上面的[步骤 2：在断言中包括用户属性](#step_pass_user_attribute)中介绍的示例，若要将“Region”用户属性断言传递给工作簿，作者可以包括 `USERATTRIBUTEINCLUDES`。例如，`USERATTRIBUTEINCLUDES('Region', [Region])`，其中“Region”是用户属性，\[Region\] 是数据中的一列。使用新计算，作者可以创建一个包含经理和销售额数据的表。添加计算后，工作簿将按预期返回“False”值。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_calc_view.png)

若要在嵌入式工作簿中仅显示与南部区域关联的数据，作者可以创建一个筛选器并对其进行自定义，以便在南部区域为“True”时显示值。应用筛选器后，工作簿将按预期变为空白，因为函数返回“False”值，并且筛选器自定义为仅显示“True”值。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_filter_view.png)

### 步骤 4：查看内容

查看和验证内容。

**示例**

为了结束上述[步骤 3：确保内容作者包括属性函数](#step_include_uaf)中的示例，您可以看到视图中的销售额数据是针对 Fred Suzuki 自定义的，因为他的用户上下文是南部区域。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_embedded_view_south.png)

工作簿中所代表区域的经理应会看到与其区域关联的值。例如，来自西部区域的 Sawdie Pawthorne 会看到特定于她所在区域的数据。

![](/tableau/next/zh-cn/online/zh-cn/Img/uaf_embedded_view_west.png)

工作簿中未显示其区域的经理将看到空白工作簿。

### 已知问题和限制

使用用户属性函数时应考虑一些已知问题和限制。

#### 使用 Tableau REST API 的空白图像

Tableau REST API 请求[“查询预览图像](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#query_view_with_preview)”、“[查询工作簿图像”](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#query_workbook_preview_image)和[“获取自定义视图图像”](https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_workbooks_and_views.htm#get_custom_view_image)会生成空白图像。

#### 限制

- 不支持已发布数据源 (.pds) 中的用户属性函数。
- 不支持 Tableau Bridge 工作流中的用户属性函数。

<!-- document id=37b5a138da0fd9bb4d02e7f1123f67bf781be6fa73f2afa7052522389418dde6 url=/tableau/next/zh-cn/online/openid_auth_idp_config.md -->

[跳转到主要内容](#main-content)

# 针对 OpenID Connect 配置身份提供程序

本主题提供有关配置身份提供程序 (IdP) 以将 OpenID Connect (OIDC) 与 Tableau Cloud 或 Tableau Cloud Manager (TCM) 一起使用的信息。这是由多个步骤组成的过程中的一步。以下主题提供有关配置以及将 OIDC 与 Tableau 一起使用的信息。

1. [OpenID Connect](https://help.tableau.com/v0.0/online/zh-cn/openid_auth.htm) 概述
2. 针对 OpenID Connect 配置身份提供程序（此部分）
3. [针对 OpenID Connect 配置 Tableau Cloud 或 TCM](https://help.tableau.com/v0.0/online/zh-cn/openid_auth_server_config.htm)

您必须具有身份提供程序 (IdP) 帐户以及包含 IdP 的项目或应用程序的帐户，然后才能将 OpenID Connect 与 Tableau Cloud 和 TCM 一起使用。在配置 Tableau Cloud 和 TCM 时，您将需要能够提供以下信息：

- **客户端 ID**：这是 IdP 分配给您的应用程序的标识符。
- **客户端密文：**这是 Tableau 用于验证来自 IdP 的响应的真实性的令牌。此值是密文，应妥善保管。
- **配置 URL：**这是包含 OpenID 提供程序元数据的提供程序配置发现文档的 URL。

**注意：**为 TCM 启用 OIDC 身份验证需要从 Tableau Cloud 进行单独设置和应用程序集成。

#### 重定向 URL

对于 Tableau Cloud 站点 或 TCM 租户，某些 IdP 将需要重定向 URL。

#### 签名算法

Tableau Cloud 支持 RS256（使用 SHA-256 的 RSA）。

<!-- document id=e494985a4d28e98f71c84e6bb78728e5f69a2dd2cc029ed43dfb86de6675cee3 url=/tableau/next/zh-cn/online/ask_data_optimize.md -->

[跳转到主要内容](#main-content)

# 针对“数据问答”（Ask Data）功能（Ask Data）优化数据

**“数据问答”(Ask Data) 功能和指标的重要变化**

Tableau 的“数据问答”(Ask Data) 和指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见 [Tableau AI 和 Tableau Pulse 如何重新构想数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-gpt)。

如果您管理和发布数据源，则以下提示可帮助您让“数据问答”（Ask Data）功能（Ask Data）的用户取得更大成功。通过在此过程上多花一点时间，您就可以向组织中更广泛的用户展示数据分析，从而帮助他们独立地回答问题和获取更深入的见解。

## 在“数据问答”(Ask Data) 功能中优化数据

在“数据问答”(Ask Data) 功能界面左侧的“数据”窗格中，数据源所有者可以为字段添加同义词，并排除不相关的值。

### 在数据源或镜头级别更改设置

在“数据问答”(Ask Data) 功能的“数据”窗格中更改设置时，请密切注意您是处于数据源级别还是镜头级别。（有关详细信息，请参见[创建针对特定受众聚焦“数据问答”(Ask Data) 功能的镜头](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_lenses.htm)。）

- 在数据源级别，您将在左上角看到圆柱形数据源图标。在这里，您在“数据”窗格中所做的更改默认情况下将应用于所有随后创建的镜头。
    
    **注意：**对于数据提取，将出现两个圆柱体。
    
    ![Super Store 仪表板，其中突出显示了数据源图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_edit_data_source.png)
- 对于单独的镜头，您会在左上角看到引用图标。在这里，您在“数据”窗格中所做的更改将仅应用于此镜头。
    
    ![Super Store 仪表板，其中突出显示了数据镜头图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_edit_data_lens.png)

### 添加字段名和值的同义词

人们可能不会使用数据源中找到的同一术语，因此数据源所有者和 Tableau 管理员可以[为特定数据字段名称和值添加同义词](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_synonyms.htm)。您输入的同义词在整个组织中可用，从而使每个人都能更快更轻松地进行数据分析。

### 从搜索结果中排除特定字段的值

为了提高“数据问答”(Ask Data) 功能中搜索结果的可用性，您可以将特定字段的值排除在索引之外。虽然“数据问答”(Ask Data) 功能没有在搜索结果中添加非索引值，但相关值仍显示在可视化项结果中。举例来说，如果您不为“Product”（产品）字段中的值建立索引，因为它们为搜索结果添加了不必要的详细信息，则“数据问答”(Ask Data) 功能仍然可以在生成的数据可视化项中显示诸如“iPhone 12”之类的值。用户可以通过将非索引值用引号括起来，手动将其添加到查询中（例如，"Sales for Product containing "iPhone 12"）。

**注意：**如果[数据源的值索引设置](https://help.tableau.com/current/pro/desktop/zh-cn/ask_data_enable.htm#Indexing)设置为“禁用”，则忽略此字段级别设置。将始终为字段名和相关同义词建立索引。

1. 转到适用于数据源或单独镜头的“数据问答”(Ask Data) 功能选项卡。
2. 将光标悬停在左侧的数据源字段上，并单击“编辑字段详细信息”图标（铅笔图标）。
    
    ![字段列表，其中某个值旁边带有编辑图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_synonyms.png)
3. 取消选择“为字段值建立索引”。

单击显示的文本框以立即为数据源重新编制索引，或者让它根据其常规索引计划重新编制索引。

## 优化数据源

若要为“数据问答”(Ask Data) 功能用户创造最佳体验，请优化原始数据源。

**注意**：“数据问答”(Ask Data) 功能不支持多维的多维数据集数据源，也不支持像 Google Analytics 这样的非关系数据源或者包含虚拟连接的数据源。

### 针对“数据问答”(Ask Data) 功能优化索引

数据源所有者可以更改针对“数据问答”(Ask Data) 功能为字段值编制索引的频率，从而优化系统性能。

1. 在数据源页面的顶部，单击“详细信息”图标：
    
    ![显示 World Indicators 数据源名称，并突出显示信息图标。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_datasource_details.png)
2. 在“数据问答”（Ask Data）部分，单击“编辑”。
3. 选择字段值的索引选项：
    
    - 自动：每 24 小时检查是否有更改，并分析数据源（如果数据源为实时数据源、刷新了数据提取或已重新发布）。为经常与“数据问答”（Ask Data）一起使用的数据源选择此选项，以便在用户查询之前准备好数据源。
    - 仅当 Tableau 创建者手动触发数据源页面上的索引编制时，“手动”才会对数据源进行分析。如果数据源频繁更改，但用户只是偶尔使用“数据问答”（Ask Data）来查询数据源，则选择此选项。
        
        若要触发手动索引编制，请转到数据源页面，单击左侧“数据”窗格中的带圆圈的“i”，然后单击“重建数据源索引”。
        
        ![“数据索引”部分显示数据上次索引的日期和时间，并提供重新索引数据源的按钮。](/tableau/next/zh-cn/online/zh-cn/Img/ask_data_reindex.png)
    - 禁用：只分析字段名称，而不分析值。
4. 单击“保存”

### 使用数据提取来提高性能

为了提高性能和实现对大型数据集的支持，请将“数据问答”功能与已发布数据提取（而不是实时数据源）结合使用。有关详细信息，请参见[“创建数据提取”](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_data.htm)。

### 确保用户可以访问数据源

若要使用“数据问答”（Ask Data）功能，用户必须具有连接到单个数据源的权限。如果数据源有行级别权限，这些权限将也适用于“数据问答”（Ask Data）功能，后者将不会识别安全值或做出相关的统计建议。

### 注意不受支持的数据源功能

“数据问答”(Ask Data) 功能支持除以下各项外的所有 Tableau 数据源功能。如果您的数据源包含这些功能，则“数据问答”(Ask Data) 用户将无法查询相关字段。

- 集
- 合并字段
- 参数

### 预测用户问题

预测用户将提出的问题的种类，然后使用以下方法，针对这些问题优化数据源：

- [在 Tableau Prep](https://help.tableau.com/current/prep/zh-cn/prep_clean.htm) 或类似工具中清理和调整数据。
- [联接数据](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm)以将用户可能提出相关问题的所有字段包括在一个表中，从而提升性能。
- 添加可回答常见用户问题的[计算字段。](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_calculatedfields.htm)
- 为用户可能想要以直方图或另一种分桶形式查看的定量变量创建[具有适当大小的数据桶](https://help.tableau.com/current/pro/desktop/zh-cn/calculations_bins.htm)。

### 简化数据

为了使用户和“数据问答”（Ask Data）功能（Ask Data）更容易理解数据，请在数据准备过程中尽可能简化数据源。

1. 移除任何不必要的字段以提高性能。
2. 为每个字段指定唯一而有意义的名称。
    - 举例来说，如果有五个以“Sales...”（销售额...）开头的字段名，最好对它们加以区分，以便“数据问答”（Ask Data）功能（Ask Data）能够正确地解读“sales”一词。
    - 将“Number of records”（记录数）重命名为更有意义的名称。例如，在每条记录都是一次地震的数据源中使用“Number of earthquakes”（地震次数）。
    - 避免使用数字值、日期值或布尔值（“true”或“false”）字段名。
    - 避免使用类似于分析表达式（例如“Sales in 2015”（2015 年销售额）或“Average Products Sold”（平均已售产品））的名称。
3. 创建有意义的[字段值别名](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_fieldproperties_aliases_ex1editing.htm)，反映人们将在对话中使用的词语。

### 设置适当的字段默认值

为了帮助“数据问答”（Ask Data）功能（Ask Data）正确地分析数据，请确保默认字段设置反映每个字段的内容。

- 为文本值、时间值、日期值、地理值和其他值[设置数据类型](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles_datatypes.htm)。
- [分配适当的数据角色](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles.htm)：维度或度量（连续或离散）。
- 对于每个度量，在 Tableau Desktop 中[分配适当的默认设置](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_fieldproperties.htm)，例如颜色、排序顺序、数字格式（百分比、货币等）和聚合函数。例如，SUM 可能适合于“Sales”（销售额），但 AVERAGE 可能是更加适合于“Test Score”（测试分数）的默认值。
    
    **提示：**为每个字段设置默认注释特别有用，因为当用户将鼠标指针悬停在“数据问答”（Ask Data）功能（Ask Data）中的字段上时，这些注释将显示为信息性说明。

### 为地理和分类字段创建分层结构

对于时间数据，Tableau 会自动创建分层结构，分层结构使用户能快速地在可视化项中上钻和下钻查询（例如，从天到周再到月）。但是，对于地理数据和分类数据，我们建议您[创建自定义分层结构](https://help.tableau.com/current/pro/desktop/zh-cn/qs_hierarchies.htm)来帮助“数据问答”（Ask Data）功能（Ask Data）生成可反映字段之间的关系的可视化项。请注意，“数据问答”（Ask Data）功能（Ask Data）不会在数据窗格中显示分层结构。

“数据问答”（Ask Data）功能（Ask Data）不会对分层结构名称编制索引，而只会为分层结构中字段的名称编制索引。举例来说，如果一个名为“Location”（位置）的地理分层结构包含“Country”（国家/地区）和“City”（城市）字段，则用户应在其“数据问答”（Ask Data）功能（Ask Data）问题中输入“Country”和“City”。

<!-- document id=1246e0681a7baa649972c576901822759b54cb8f14c2f4f0cd1d132e14e35eac url=/tableau/next/zh-cn/online/metrics_admin.md -->

[跳转到主要内容](#main-content)

# 针对指标进行设置

**旧版指标功能的停用**

Tableau 的旧版指标功能在 Tableau Cloud 2024 年 2 月版和 Tableau Server 版本 2024.2 中已停用。2023 年 10 月，Tableau 停用了将旧版指标嵌入到 Tableau Cloud 和 Tableau Server 版本 2023.3 的功能。借助 Tableau Pulse，我们开发了一种改进的体验来跟踪指标和询问数据问题。有关详细信息，请参见[使用 Tableau Pulse 创建指标](https://help.tableau.com/current/online/zh-cn/pulse_create_metrics.htm)以了解新体验，并参见[创建指标并排查其问题（已停用）](https://help.tableau.com/current/online/zh-cn/metrics_create.htm)了解已停用的功能 。

指标是一种 Tableau 内容类型，用于跟踪聚合度量（例如销售额总和）的值。由于指标经常刷新，并且以易于查看的格式显示其当前值，因此它们可用于监视数据。若要了解有关用户如何使用指标的方式，请参见[创建指标并排查其问题（已停用）](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm)。

## 确保用户可以创建指标

为站点启用指标后，具有 Creator 或 Explorer（可发布）站点角色的所有用户都可以创建指标（如果他们具有正确的权限）。

指标是依据 Tableau 站点上的现有视图创建的。为确保用户可以在视图上创建指标，请验证：

- 用户对视图所属的工作簿具有“创建/刷新指标”权限能力。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。
- 数据源的密码已嵌入（如果需要）。有关详细信息，请参见[编辑 Tableau Cloud 上的连接](https://help.tableau.com/v0.0/online/zh-cn/to_connections_modify.htm)。

## 为站点禁用指标

默认情况下，指标在所有站点上已启用。您可以按站点禁用指标。

1. 在要禁用指标的站点上，从导航面板中单击“设置”。
2. 在“指标内容类型”下，取消选中“启用指标”。
3. 单击“保存”。

禁用指标内容类型后，指标将不再出现在站点上。任何现有指标的数据将保留，但这些指标将不再刷新。如果重新启用指标，这些指标将重新出现并恢复刷新。

您还可以通过拒绝“创建/刷新指标”权限能力来禁用特定工作簿上的指标。有关详细信息，请参见[权限](https://help.tableau.com/v0.0/online/zh-cn/permissions.htm)。

## 管理指标

尽管指标是依据视图创建的，但它们不会像通知或订阅一样绑定到视图。这意味着您管理指标的方式与管理工作簿的方式类似，即通过重命名、移动、标记、删除指标或设置指标权限的方式进行管理。

通过在项目分层结构中导航或通过以下路径来查找要管理的指标。

- 若要查看站点上的所有指标：导航到“浏览”部分，然后选择“所有指标”。
- 若要查看依据工作簿中的所有视图创建的指标：导航到工作簿，然后选择“已连接指标”选项卡。
- 若要查看依据单一视图创建的指标：打开该视图，然后从工具栏中选择“观看”\>“指标”。

## 解决失败和挂起的指标刷新

由于以下原因之一，指标刷新可能会失败。

- 连接的视图已删除或修改。
- 连接r 视图的权限已更改。
- 数据源的密码不再嵌入或不再有效。
- 指标所有者没有刷新指标所需的站点角色。需要 Creator 或 Explorer（可发布）站点角色。
- 存在临时连接问题，该问题将自行解决。

**注意：**如果指标刷新因所有者没有刷新指标所需的站点角色而挂起，您将无法恢复刷新，除非您更改所有者。

有关指标刷新失败的原因以及用户可以采取哪些措施来修复它们的详细信息，请参见[修复失败的刷新](https://help.tableau.com/v0.0/online/zh-cn/metrics_create.htm#fix-failing-refreshes)。

如果已连接的视图已修改，导致刷新失败，但该视图仍然可用，则鼓励用户覆盖指标。用户可以通过在与现有指标相同的项目中创建具有相同名称的指标来覆盖指标。

### 恢复挂起的刷新

举例来说，如果已通过嵌入数据源的正确密码修复了失败原因，则可以恢复指标刷新。

1. 找到受影响的指标。具有挂起刷新的指标会在网格和列表视图中显示文本“刷新已挂起”，而不是上次刷新的时间。
2. 在警告消息上，单击“恢复刷新”。

Tableau 尝试执行刷新。如果此尝试成功，您将收到确认，并且刷新将按计划恢复。如果尝试失败，刷新将保持挂起状态。您或指标所有者可以删除或覆盖指标，或者保留该指标以引用历史数据。

## 使用管理视图监视指标活动

使用 Tableau Cloud 的管理视图监视指标活动。

监视指标刷新活动：

1. 从导航面板中，单击“站点状态”。
2. 选择“非数据提取后台任务”仪表板。
3. 针对任务“查找指标以更新”或“更新视图上的所有指标”进行筛选。有关详细信息，请参见[非数据提取后台任务](https://help.tableau.com/v0.0/online/zh-cn/adminview_backgrnd_nonextract.htm)。

若要监视更多指标事件，请使用“在线管理见解”创建自定义视图。连接到在线管理见解“**TS 事件**”数据源，并使用“**Event Name**”（事件名称）维度查看以下事件：“创建指标”、“删除指标”、“移动指标”、“将指标移动到”和“更新指标”。有关详细信息，请参见[使用“在线管理见解”创建自定义视图](https://help.tableau.com/v0.0/online/zh-cn/adminview_insights.htm)。

<!-- document id=c351b5723570e84861e2b1abbf66a152959d4c01e3be9dcdf0ade81f95dc16db url=/tableau/next/zh-cn/online/data_alerts_admin.md -->

[跳转到主要内容](#main-content)

# 针对数据驱动型通知进行设置

当数据达到重要业务阈值时，数据驱动型通知会自动向您指定的关键人员发送电子邮件通知。作为 Tableau Cloud 管理员，您设置数据驱动型通知的方式与设置订阅非常相似。有关用户如何创建和管理这些通知的信息，请参见 Tableau 用户帮助中的[发送数据驱动型通知](https://help.tableau.com/current/pro/desktop/zh-cn/help.htm#data_alerts.htm)。

## 管理站点中的所有数据驱动型通知

1. 在浏览器窗口的顶部，单击“任务”，然后单击“通知”。
2. 选择要更新的任何通知。
3. 从“动作”菜单中，执行以下任意操作：
    
    - 添加或移除自己的收件人身份。
    - 编辑通知以更改数据阈值、交付计划以及收件人完整列表。
    - 将通知所有权更改为其他用户，或者删除通知。

## 为站点禁用数据驱动型通知

所有站点默认情况下都支持数据驱动型通知，但管理员可以为特定站点禁用这些通知。

1. 查看站点时，单击左侧导航窗格中的“设置”。
2. 在“数据驱动型通知”下, 取消选中“允许用户创建通知和接收通知电子邮件”。
3. 单击“保存”。

## 挂起数据驱动型通知

### 恢复挂起的通知

如果通知失败足够的次数，您将会收到一封通知电子邮件，指明您的通知已挂起。管理员或通知所有者可以通过以下几种方法恢复挂起的通知：

- 从 Tableau 网页的“任务”>“通知”区域中，一个 ![挂起数据通知图标。](/tableau/next/zh-cn/online/zh-cn/Img/suspend.jpg) 图标出现在“上次检查”列中，指明通知已挂起。选择“...”\>“恢复通知”以恢复通知。
- 在通知电子邮件中单击“**恢复通知**”以恢复通知。该通知电子邮件将允许您恢复通知，或指示视图已更改，应删除通知。
- 从受影响的视图或工作簿的“通知”面板中。若要从视图或工作簿中恢复通知，请选择“**通知**”以打开“通知”面板。 挂起的通知旁边将显示一个图标。在受影响的通知上选择“操作”\>“恢复通知”以进行恢复。

通知恢复正常时，通知所有者将收到一封电子邮件通知。

## 确定和修复失败的通知

作为管理员，您可以主动确定用户可能未觉察到的失败通知。进行检查：

1. 在站点菜单中选择“状态”。
2. 选择“非数据提取后台任务”。
3. 从“任务”下拉菜单中，选择 “检查数据通知条件是否得到满足”。
4. 在最右侧，单击“错误”以查看失败通知的列表。
5. 将鼠标指针悬停在红色失败图标上可显示包含通知详细信息的工具提示。

若要确定通知所有者，请在 Tableau Cloud 存储库的 [data\_alerts 表](https://help.tableau.com/current/server/zh-cn/data_dictionary.htm#data_alerts_anchor)中查找通知 ID 号。（在站点的[通知管理](#Manage)区域中，您也可以查找跟在编号后面的通知名称，但请注意，多个不同的通知可能使用相同名称。）

**注意：**当通知失败十次时，将自动向通知所有者发送通知。管理员可以自定义通知所有者收到通知的时间。

![检查数据通知，其中突出显示了有关通知的信息和数据通知 ID。](/tableau/next/zh-cn/online/zh-cn/Img/alert_failure.png)

失败通知通常由 Tableau Cloud 上的内容更改所导致。如果发生如下更改，请鼓励用户重新创建通知：

- 移除或重命名了工作簿、视图或数据字段。
- 工作簿中嵌入的数据库凭据过期。
- 数据驱动型通知需要实时连接的嵌入式凭据，通知当前不支持使用 OAuth。
- 数据源变得不可访问。

<!-- document id=10fa915556be8215dbe0481994015c6fbda4728da54677bfe45d0151d89ea5ae url=/tableau/next/zh-cn/online/external_actions.md -->

[跳转到主要内容](#main-content)

# 集成 外部操作

**注意：**Tableau 中的外部操作依赖于 Salesforce Flow 提供的功能。该功能将您选择的数据发送到在单独的 Salesforce 基础设施上运行的 Salesforce Flow。Salesforce Flow 和其他 Salesforce 产品和服务的使用受您与 Salesforce 的协议约束。

在查看并了解 Tableau 中的数据后，下一步是什么？通常，从数据洞察中采取行动涉及从一个应用程序转向另一个应用程序，通常会复制和粘贴数据并在此过程中丢失上下文。借助 Tableau 外部操作 功能，您可以直接从 Tableau 仪表板创建数据驱动的工作流并与之交互，并使用 Salesforce Flow 自动执行后续步骤。

## 关于 Salesforce Flow

如果您不熟悉 [Salesforce Flow](https://help.salesforce.com/s/articleView?language=en_US&id=sf.flow_concepts.htm&type=5)，它是一种无代码工具，可提供省时的流程自动化。流程是 Salesforce Flow 的组件，用于收集数据并在您的 Salesforce 组织中执行操作。[Salesforce Flow 中有几种可用的流程类型](https://help.salesforce.com/s/articleView?id=sf.flow_concepts_type.htm&type=5)，但是 Tableau 中的 外部操作 工作流仅与自动启动的流程兼容。

**注意：**若要了解有关流程的详细信息，请查看在 Trailhead 上的 [使用 Flow Builder 构建流程](https://trailhead.salesforce.com/en/content/learn/trails/build-flows-with-flow-builder)。

## 外部操作 的工作方式

![带有已选中标记的仪表板和处于可用状态的工作流按钮，箭头指示将数据传输到 Salesforce Flow](/tableau/next/zh-cn/online/zh-cn/Img/workflow_overview_callouts.png)

针对 Tableau 仪表板上的可视化项配置 外部操作 工作流时，一个自定义按钮将出现在相应的可视化项上，处于不可用（灰显）状态。当您在可视化项 (1) 上选择相关标记时，该按钮变为可用。然后，当您单击按钮 (2) 时，所选标记中的数据将直接发送到在 [Salesforce Flow](https://help.salesforce.com/s/articleView?language=en_US&id=sf.flow_concepts.htm&type=5) (3) 中构建和配置的流程。

作为 外部操作 工作流的作者，您确定：

- 数据发送到哪个流程
- 数据来自哪个仪表板
- 触发工作流的仪表板按钮的文本和外观

**注意：**您可以将多个 外部操作 工作流添加到仪表板，但每个相应的流程必须部署在同一个 Salesforce 组织。

## 为何使用 外部操作 工作流

有很多种方法使用 外部操作 工作流以自动完成组织中的现有流程。例如，想象一下，让会计团队成员直接从他们用来跟踪未付订单的同一个仪表板发送客户发票的工作流节省了工作量。或者，也许您正在寻找简化支持团队案例管理的方法。允许支持团队成员直接从他们用来跟踪案例的仪表板升级案例的工作流可以显著节省时间。外部操作 工作流有助于将用户留工作流中，并使您的组织能够从提高的效率中受益。

创建 外部操作 工作流时，您实际上是在构建一座桥梁，将Tableau 中的任何类型的数据源与 Salesforce 中的流程连接起来。您的数据源不需要连接到 Salesforce 数据库，因为工作流本身会创建连接。当有多个组使用单独的数据源来完成同一流程的不同步骤时，这尤其有用。

例如，想一想当客户在电子商务网站下订单时涉及的不同的团队和工具。电子商务销售代表可能使用 Salesforce 来跟踪销售，而供应链经理则使用供应链管理工具来从整体产品库存中扣除购买的商品。帮助客户解决收到产品时出现的任何问题的支持团队可能会登录到 Salesforce 或在 Tableau 仪表板中进行分析。通过 外部操作 工作流，您可以连接来自每个团队的所有数据，以简化流程，甚至自动执行一些现有步骤。

## 外部操作 工作流作者的最佳实践

**重要信息：**使用 外部操作 功能将仪表板数据与 Salesforce Flow 中构建的流程连接的仪表板作者应与创建流程的 Salesforce 管理员和架构师密切合作。

Salesforce Flow 中内置的流程是复杂的业务自动化程序。尽管您的组织可以从这些自动化中获益良多，但在部署使用它们的 外部操作 工作流之前，了解流程如何工作是很重要的。确保完成 [Trailhead 上的 Salesforce Flow 培训](#https://trailhead.salesforce.com/content/learn/modules/business_process_automation)，并查看[流程文档](https://help.salesforce.com/s/articleView?id=sf.flow.htm)。在设计中考虑[流程最佳实践](https://help.salesforce.com/s/articleView?id=sf.flow_prep_bestpractices.htm&type=5&language=en_US)，并牢记[流程限制和注意事项](https://help.salesforce.com/s/articleView?id=sf.flow_considerations.htm&type=5)。

**注意：**Salesforce Flow 中有几种可用的[流程类型](https://help.salesforce.com/s/articleView?id=sf.flow_concepts_type.htm&type=5)，但是外部操作工作流仅与自动启动的流程兼容。

必须仔细实施 外部操作 工作流，以符合 Salesforce Flow 内置流程的架构约束。流程是强大的，但它们也可能是资源密集型和复杂的。需要考虑潜在的许可、执行限制和并发性问题，并且必须评估和测试数据库读/写限制。

还有一些与流程相关的重要安全注意事项。具有“管理流程”权限的用户可以查看和更改相应 Salesforce 组织中的所有数据和资源。具有“运行流程”权限的用户几乎可以运行 Salesforce 组织中的任何活动流程。若要将访问权限仅限于需要它的用户（例如仪表板作者和工作流用户），您的 Salesforce 管理员可以为流程启用覆盖默认行为设置。有关详细信息，请参见[流程安全性如何工作？](https://help.salesforce.com/s/articleView?id=sf.flow_distribute_security.htm&type=5)

创建 外部操作 工作流的仪表板作者应在实施工作流之前与其 Salesforce 管理员沟通，以防止出现意外结果。

## 创建工作流

在创建 外部操作 工作流之前，仪表板作者应与其 Salesforce 管理员协作，以找到或创建满足其需求的流程。例如，您的目标可能是帮助您的会计团队直接从未付款订单仪表板发送发票。为实现此目标，您需要一个可以从仪表板检索客户联系信息和订单详细信息并填充发票的流程。

在您决定使用哪个流程之后，下一步是确定要连接到哪个仪表板。很可能您的用户已经在与一个运行良好的现有仪表板进行交互了。但是，如有必要，您可以[创建新仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm)。

有了正确的流程和正确的仪表板，就该考虑仪表板中的数据类型与流程的必需输入字段（称为变量）的兼容性了。例如，您的未付款订单仪表板必须包含一个可视化项，其中包含发送客户发票所需的所有相关订单详细信息。这些详细信息可能包括订单日期、客户姓名和联系信息、项目描述和金额以及到期付款金额等信息。

当您的仪表板包含所有必需的组件时，添加工作流对象：

1. 在 Tableau 工作簿中，打开现有仪表板或[创建新仪表板](https://help.tableau.com/current/pro/desktop/zh-cn/dashboards_create.htm)。
2. 从“仪表板”窗格的“对象”部分，将“工作流”拖到仪表板中的可视化项。  
    ![仪表板窗格的“对象”部分，在“工作流”对象上带有一个聚光灯，向右箭头指示将对象拖至仪表板 ](/tableau/next/zh-cn/online/zh-cn/Img/workflow_object_arrow_spotlight_sm.png)
3. 出现提示时，输入与您的流程相关联的 Salesforce 组织的登录凭据。  
    
    **注意：**当用户访问您设置工作流的仪表板时，他们必须输入自己的 Salesforce 凭据。如果他们的 Salesforce 凭据在查看控制面板时过期，系统会提示他们重新进行身份验证。
4. 单击“配置工作流”。
5. 在“添加工作流”对话框中，按流程名称或流程作者搜索流程。
6. 选择一个流程以查看其详细信息，包括它需要来自可视化项的所需输入（Salesforce 变量）。单击“上一步”选择其他流程，或单击“下一步”继续。
7. 从“选择工作表”下拉列表中，选择包含用户将选择并发送到流程的标记的工作表（工作表、仪表板或文章）。  
    
    **注意：**请确保选择一个带有标记的工作表，这些标记带有要映射到流程的必需输入的编码字段。举例来说，如果要将流程中的 `forecast_revenue` 变量映射到 Tableau 中的 `SUM(Sales)` 字段，则必须选择带有 `Sum(Sales)` 字段编码标记的工作表。
8. 单击“下一步”。
9. 对于流程的每个必需输入（Salesforce 变量），从“选择工作表”步骤中所选的 Tableau 工作表中选取一个适当的字段。  
    
    **注意：**对于每个输入，Salesforce 变量和 Tableau 字段的数据类型必须匹配。
10. 单击“下一步”。
11. 配置用户将单击以触发 外部操作 工作流的按钮的外观。指定按钮标题、背景颜色和边框颜色。检查预览以确认按钮的外观。

**注意：**请记住，用户必须从您在“选择工作表”步骤中所选的可视化项中选取一个标记。在选择标记之前，该按钮不可用。考虑将指导文本添加到仪表板，以便用户确切地知道要与之交互的可视化项，以及单击按钮时会发生什么。

13. 单击“完成”以创建工作流并将相应的按钮添加到仪表板中的可视化项。

## 使用工作流

若要以工作流用户身份开始操作，请打开仪表板，仪表板作者已在其中添加了工作流。如果显示工作流按钮，您可以确认工作流可用。仪表板作者自定义按钮的名称和格式，并且它应该清楚地指示当您单击时触发的操作（例如“发送数据”或“更新记录”）。从仪表板的可视化项中选择一个相关标记，然后单击按钮启动工作流。

![GIF 动画，显示在 Tableau 仪表板中选择标记，然后单击工作流按钮，并以成功消息结束](/tableau/next/zh-cn/online/zh-cn/Img/workflow_dash_button_success.gif)

单击工作流按钮将触发数据传输，您选择的标记确定发送什么数据。因此，在您选择标记之前，该按钮不可用（灰显）。如果您选择了一个标记，但该按钮仍然不可用，请确认您已在工作流的有效可视化项上选择了一个标记。如果您不确定哪些可视化项有效，请咨询仪表板作者。

根据其配置，某些工作流可能是长时间运行的操作，不会立即完成。如果您无法确定您选择的工作流程是否按预期工作，请咨询仪表板作者或您的 Salesforce 管理员。

## 工作流故障排除

有关解决外部操作工作流问题的帮助，请参见以下故障排除指南。

### 访问权限问题

- **对于使用 Tableau Desktop 的仪表板作者：**如果工作流对象没有出现在“仪表板”窗格的“对象”部分，请确认您已登录到 Tableau Server 或 Tableau Cloud 站点。如果您没有登录，则无法访问工作流扩展程序。
- **对于仪表板作者：**如果工作流对象没有出现在“仪表板”窗格的“对象”部分，请咨询您的 Tableau 管理员以确保扩展程序已打开。
- **对于所有用户：**
    - 如果您的 Salesforce 管理员尚未创建已连接应用，外部操作 功能将不起作用。要求您的 Salesforce 管理员在 Salesforce 中为 Tableau Server [创建已连接应用](https://help.salesforce.com/s/articleView?id=sf.connected_app_create.htm&type=5)。
    - 如果您无法单击显示在仪表板上的工作流按钮，请确认您已经在工作流的有效可视化项上选择了一个标记。如果您不确定哪些可视化项有效，请咨询仪表板作者。

### 身份验证问题

- **对于 Tableau Cloud 或 Tableau Server 用户：**刷新浏览器中的仪表板。
- **对于所有用户：**确认您已登录到添加 外部操作 工作流的 Salesforce 组织。如有必要，请咨询您的仪表板作者以确认正确的 Salesforce 组织。

### 错误消息

| 错误消息 | 解释和解决方法 |
| --- | --- |
| 此站点上的工作流已关闭。有关详细信息，请与 Tableau 管理员联系。 | 您的 Tableau 管理员已关闭站点的工作流仪表板扩展程序，因此您无法使用它。请与您的 Tableau 管理员联系，讨论打开扩展程序访问权限的问题。 |
| Tableau Reader 不支持工作流 | 工作流仪表板扩展程序和 外部操作 功能只能用于向使用 [Tableau Cloud](https://www.tableau.com/zh-cn/products/cloud-bi)、[Tableau Desktop](https://www.tableau.com/zh-cn/products/desktop) 或 [Tableau Server](https://www.tableau.com/zh-cn/products/server) 版本 2022.3 及更高版本的流程发送数据。 |
| 流程包含一个或多个不支持的数据类型。请返回以选择不同的流程，或者联系您的 Salesforce Flow 管理员以从此流程中移除不支持的数据类型。 | 所选流程需要的数据类型输入在 Tableau 仪表板中不可用，或者与 外部操作 工作流不兼容。如果存在合适的替代流程，请选择其他流程，或咨询您的 Salesforce 管理员以了解后续步骤。 |
| 输入字段的映射中存在一个或多个数据类型不匹配。 | 映射到输入变量字段的一个或多个仪表板值的数据类型不相同。  
  
例如，流程可能需要一个数字变量来表示收入，但是来自仪表板的映射值是一个文本字符串。根据您的情况，您有两种选择来解决这个问题。您可以在 Tableau 中[更改“收入”字段的数据类型](https://help.tableau.com/current/pro/desktop/zh-cn/datafields_typesandroles_datatypes.htm)，从文本字符串更改为数值。或者，您可以编辑工作流配置，以映射仪表板中具有数字数据类型的不同字段。 |
| 无法将数据提交到 Salesforce Flow。 | 外部操作 工作流试图将数据从仪表板发送到流程时出现未知错误。请联系您的仪表板作者进行故障排除。 |
| 出现错误：<异常代码>。请与 Salesforce Flow 管理员联系。 | [流程采访](https://help.salesforce.com/s/articleView?id=sf.flow_interviews.htm&type=5)（流程的运行实例）失败。与您的 Salesforce 管理员共享异常代码，以便他们可以找到相应的[错误电子邮件](https://help.salesforce.com/s/articleView?id=sf.flow_troubleshoot_email.htm&type=5)并相应地进行故障排除。 |
| 工作流失败。请与 Salesforce Flow 管理员联系。 | 仪表板中所选标记的数据已发送至流程，但在将该数据转换至流程时出现问题。请联系您的 Salesforce 管理员进行故障排除。 |
| 无法将数据提交到流程。请联系您的工作流作者。 | 仪表板中所选标记的数据未发送到流程。请联系您的仪表板作者进行故障排除。 |

### 流程问题

- 某些流程是异步运行的，因此您可能不会立即知道作为 外部操作 工作流一部分的流程是否成功运行。有时，流程可能会失败，并且在没有立即提供详细反馈的情况下回滚更改。不过，当流程失败时，会向工作流用户、仪表板作者和 Salesforce 管理员发送详细的错误电子邮件。工作流用户在收到流程[错误电子邮件](https://help.salesforce.com/s/articleView?id=sf.flow_troubleshoot_email.htm&type=5)时，应联系其仪表板作者。然后，仪表板作者和 Salesforce 管理员可以一起排除故障并解决错误。有关排查流程问题的详细信息，请参见[对流程进行故障排除](https://help.salesforce.com/s/articleView?id=sf.flow_troubleshoot.htm&type=5)。

### 许可问题

- **对于仪表板作者：**在 Tableau 端，向仪表板添加工作流不需要特殊权限（只要为站点启用了外部操作）。在 Salesforce 端，您需要将[“管理流程”权限](https://help.salesforce.com/s/articleView?id=sf.retail_task_admin_permission_flow.htm&type=5)添加到您的 Salesforce 配置文件。
- **对于工作流用户：**在 Tableau 端，任何可以访问带有工作流的仪表板的用户都可以运行它。从 Salesforce 端，您需要将[“运行流程”权限](https://help.salesforce.com/s/articleView?id=sf.retail_task_admin_permission_flow.htm&type=5)添加到您的 Salesforce 配置文件。

## 开启或关闭 外部操作

在 Tableau 2022.3 及更高版本中，外部操作 功能默认情况已开启。有关 Tableau 管理员如何配置组织范围的 Tableau 外部操作 访问权限的详细信息，请参见[配置外部操作工作流集成](https://help.tableau.com/current/server/zh-cn/external_actions_admin.htm)。

<!-- document id=a5b338a60331b77eb948db1102f2905b7ed60242d76597dba91d1fbc106be529 url=/tableau/next/zh-cn/online/adminview_backgrnd_nonextract.md -->

[跳转到主要内容](#main-content)

# 非数据提取后台任务

“非数据提取后台任务”视图显示服务器运行的与独立 Online数据提取刷新不相关的任务。例如，Bridge 刷新作业、编辑的 OAuth 连接、订阅通知等。此视图显示过去 30 天内 Tableau Cloud 活动的快照。

一个表将列出在指定时间范围内运行的任务。单击“成功”或“错误”以根据状态筛选该表。在“此站点上任务成功或失败的次数”表中选择特定任务以更新所选任务的“此站点上运行的后台任务”图形。

任务的状态可以是成功或错误。有关任务的详细信息，请将鼠标指针悬停在成功或错误图标上。

<table class="table--plain"><thead><tr class="Head-Header1"><th>图标</th><th>描述</th></tr></thead><tbody><tr class="Body-Body1"><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/icon_adminview_error.png" alt="管理视图错误图标。"></td><td><b>错误</b>—服务器无法完成任务。</td></tr><tr class="Body-Body1"><td><img src="https://help.tableau.com/v0.0/online/zh-cn/Img/icon_adminview_success.png" alt="管理视图成功图标。"></td><td><b>成功</b>—服务器已完成任务。</td></tr></tbody></table>

您可以看到的任务相关详细信息包括任务的 ID、状态、优先级、创建时间、启动启动以及完成时间。您还可以查看其运行时：后台作业的总运行时间，其中包括作业加上后台作业开销（例如初始化和清理）的运行时间。您还可以查看作业正在哪个后台程序上运行。

<!-- document id=01e220276513472bc5a100617728e95fa932b64789920560ba65d5abbba96fb7 url=/tableau/next/zh-cn/online/segments.md -->

[跳转到主要内容](#main-content)

# 面向 Data 360 的可视细分创建

细分使数据分析师能够从 Tableau 中的分析中整理相关数据部分，并将其无缝传输到 [Salesforce Data 360](https://www.salesforce.com/products/data/)。进入 Data 360 后，营销专业人员可以使用各种平台（例如 [Data 360 for Marketing](https://www.salesforce.com/products/data-cloud-marketing/) ）快速采取高影响力的步骤，轻松推动营销活动。

## 关于细分

### 概述和示例

从 Tableau 开始的细分为分析师提供了一种直观地探索其受众（通常是客户）并将有关目标人群相关部分的数据发送到 Data 360 的方法。营销人员可以通过 Data 360 发布到其他 Salesforce 云或平台，以进行进一步分析和采取行动。

为了更好地理解细分的好处及其工作原理，让我们考虑一个可能的用例。一位数据分析师在 Tableau 中查看有关近期营销活动的数据分析，发现了一个参与度低于整个活动受众群体的细分受众群。数据分析师知道这是营销团队想要解决的总体数据的重要子集。因此，数据分析师将这个低参与度细分发送到 Data 360。

营销团队（或营销人员）的成员可以从 Data 360 访问该细分，以获取与低参与度群体相关的营销活动数据的筛选视图。通过整体数据的集中片段，营销人员可以更轻松地确定提高参与度所需采取的行动。

考虑到行动计划，营销人员在 Salesforce Marketing Cloud 或他们创建原始营销活动的类似平台上发布细分。

在此示例和类似场景中，数据分析师受益于 Tableau 强大的分析功能，同时高效地将其发现结果交给营销人员。营销人员可以从访问与他们相关的数据的目标视图中受益，他们可以管理这些数据并将其发送到他们已经使用的营销工具。最重要的是，客户可以从有效接触他们的营销活动中受益。

### 工作流程

通过细分，您可以简化在 Tableau 中工作的数据分析师与在 Data 360 和互联营销平台中工作的营销人员之间的协作。典型的工作流程如下所示：

1. 数据分析师使用 Tableau 中的可视化项来分析和识别对营销人员相关、有意义且可操作的客户数据子集。
2. 数据分析师从 Tableau 可视化项中创建受众数据的细分，并将其发送到 Data 360。
3. 营销人员从 Data 360 访问该细分。从那里，他们创建一个针对细分数据采取行动的计划，并将其发送到他们的激活目标。激活目标通常是营销团队用来管理营销活动的营销平台或工具，例如 [Data 360 for Marketing](https://www.salesforce.com/products/data-cloud-marketing/)。
4. 营销人员从激活目标发起营销活动，并从他们选择的平台分析活动结果。

### 了解更多信息

若要了解有关细分的更多信息，请查看这些有用的资源：

- [细分](https://help.salesforce.com/s/articleView?id=sf.c360_a_create_segments.htm&type=5)（Salesforce 帮助）- 全面查看 Data 360 上的细分和激活。
- [细分和激活模块](https://trailhead.salesforce.com/content/learn/modules/customer-360-audiences-segmentation?trailmix_creator_id=mcguide2&trailmix_slug=customer-360-audiences-and-the-ethical-use-of-data)(Trailhead) - 了解如何使用 Data 360 创建、筛选和激活营销细分。
- [细分筛选器示例](https://help.salesforce.com/s/articleView?id=sf.c360_a_examples_of_segmentation_filters.htm&type=5)（Salesforce 帮助）- 有关细分的常见用例，并获得创建您自己的细分的灵感。
- [Data 360 和数据 Trailmix 的道德使用](https://trailhead.salesforce.com/users/mcguide2/trailmixes/customer-360-audiences-and-the-ethical-use-of-data)(Trailhead) - 了解在 Data 360 中构建营销细分时如何使用道德实践。

## 细分要求

### 许可证要求

若要在 Tableau 中创建细分，数据分析师需要 Tableau Cloud 的 Creator 许可证。

若要在 Data 360 中发布细分，营销人员需要：

- Developer、Enterprise、Performance 或 Unlimited Salesforce 版本
- Data 360 的细分和激活加载项许可证（**注意：**自 2025 年 9 月起，不需要此加载项许可证。有关详细信息，请参见 [Data 360 许可证、积分和权限集变更（2025 年 9 月至 11 月](https://help.salesforce.com/s/articleView?id=005131350&type=1 "Salesforce Data 360 帮助的链接")）。
- 标准 Data 360 权限集和适当的特定于营销的权限（有关更多信息，请参见 [Data 360 标准权限集](https://help.salesforce.com/s/articleView?id=sf.c360_a_userpermissions.htm&type=5)）
- （推荐）[Data 360 for Marketing](https://www.salesforce.com/products/data-cloud-marketing/)，用于激活细分
- （可选）Data 360 的 Ad Audiences 加载项许可证，用于激活广告平台的细分

### 数据要求

#### 数据源和连接

若要创建细分，您的[数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_prepare.htm)必须使用[与实时数据的单个直接连接](https://www.tableau.com/zh-cn/blog/tableau-cloud-tips-extracts-live-connections-cloud-data)（无数据提取），并且您的可视化项必须使用单个数据源。不支持已发布数据源、多个连接和多个数据源。

#### 数据模型配置

在 Data 360 中配置数据模型时，请务必：

- 连接到配置文件 DMO，并将配置文件 DMO 设置为“数据源”选项卡中最左侧的表
- 仅使用一个[主键](https://help.salesforce.com/s/articleView?id=sf.c360_a_primary_key.htm&type=5)

在 Tableau 中配置数据模型时，请务必：

- 使用在数据源中仅使用过一次的表
- 逻辑层仅使用单个表（不支持多个逻辑表）
- 避免包含并集或自定义 SQL 表
- 仅在与现有 Data 360 关系匹配的 DMO 之间使用联接
- 在 DMO 之间使用线性联接，其中每个对象仅联接到单个对象（而不是将多个对象联接到同一个对象）  
      
    例如，请不要：  
    ![将多个表连接到同一对象的不兼容联接示例](/tableau/next/zh-cn/online/zh-cn/Img/segments_joins1.png)  
      
    执行以下操作：  
    ![兼容联接的示例由三个表组成，每个表仅联接到一个对象](/tableau/next/zh-cn/online/zh-cn/Img/segments_joins2.png)
- 使用仅包含字段的联接表达式（不支持单个表的计算和多个联接）和等于运算符（不支持其他运算符）

将 Tableau 中的数据模型连接到 Data 360 中的数据模型时，您可以使用 [Tableau 联接](https://help.tableau.com/current/pro/desktop/zh-cn/joining_tables.htm)重新创建模型的任何必要部分。

#### 身份验证

若要在 Tableau 中创建细分，您必须允许 Tableau 使用 Salesforc Data 360 连接器连接到 Data 360。如果您的 Tableau 站点上尚未配置 Data 360 连接器，[请按照以下步骤操作](https://help.tableau.com/current/server/zh-cn/config_oauth_sfdc_cdp.htm)。

在已连接应用中，添加以下范围：

- 对 Customer Data Platform 数据执行 ANSI SQL 查询 (cdp\_query\_api)
- 管理 Customer Data Platform 配置文件数据 (cdp\_profile\_api)
- 管理 Customer Data Platform 摄取 API 数据 (cdp\_ingest\_api)
- 对 Data 360 数据执行细分 (cdp\_segment\_api)

#### 用户权限要求

若要创建细分，请与您的 Salesforce 管理员合作，确认您有权访问以下应用程序编程接口 (API)：

- [创建细分 API](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_cdp_ssot_segments.htm) 的写入权限
- [Data 360 元数据 API](https://developer.salesforce.com/docs/atlas.en-us.c360a_api.meta/c360a_api/c360a_api_metadata_api.htm) 的读取访问权限

#### 字段要求

创建细分段，请在筛选器中使用现有数据库字段（而不是 Tableau 创建的字段）或[组](https://help.tableau.com/current/pro/desktop/zh-cn/sortgroup_groups_creating.htm)。转换为其他数据类型的字段可能会导致错误。

细分筛选器不支持以下类型的字段：

- 使用 MEDIAN、PERCENTILE 或 ATTR 聚合的度量
- 表计算
- 计算
- 数据桶
- 基于集、计算或组合字段的组
- Tableau 生成的字段，例如：
    
    - 元数据字段（度量名称/值）
    - 生成的地图相关字段（纬度和经度）
    - 表类型字段（对象或逻辑表的计数）
- 计算得出的见解
- 群集

#### 筛选器要求

创建细分时，会根据您的配置应用多个筛选器。细分筛选器可以包括数据源筛选器、上下文筛选器、视图筛选器和基于您的可视化项选择的筛选器的组合。

为以下各项使用定量筛选器：

- 度量（有或没有聚合）
- 日期范围

对选定了各个值的细分使用分类筛选器。

细分中不支持以下类型的筛选器：

- 带有前、通配符或条件筛选器的分类筛选器
- 下/最后 N 的相对于当前日期筛选器，包含除日期和年份以外的任何内容
- 相对于当前日期筛选器，包含除当前期间的日期、月份和年份以外的任何内容
- 日期筛选器（月/日/年）
- 带日期截断的日期筛选器
- 与另一个日期时间进行精确比较的日期筛选器

支持具有指定锚定日期的相对日期筛选器。

## 使用参与度数据创建细分

若要使用参与度数据创建从 Tableau 到 Data 360 的细分，您必须使用联接子句在 Tableau 中配置正确的建模。

在单个逻辑表中使用联接，并按照 Data 360 中“数据模型”选项卡中的关系中定义的相同字段进行联接。

例如，若要在 Tableau 中使用统一个体的电子邮件参与度数据创建细分，请配置数据模型并映射关系，如下所示。

![使用电子邮件参与数据和统一个体进行数据模型映射](/tableau/next/zh-cn/online/zh-cn/Img/UnifiedInd1.png)  
![使用电子邮件参与数据和统一个体进行数据模型映射](/tableau/next/zh-cn/online/zh-cn/Img/UnifiedInd2.png)  
![使用电子邮件参与数据和统一个体进行数据模型映射](/tableau/next/zh-cn/online/zh-cn/Img/UnifiedInd3.png) ![使用电子邮件参与数据和统一个体进行数据模型映射](/tableau/next/zh-cn/online/zh-cn/Img/UnifiedInd4.png)

**注意：**此示例仅用于说明目的。您的 Data 360 实例中的数据可能使用不同的关系。

## 在 Tableau 中创建细分

1. 在 Tableau 中，在可视化项中选择所需的数据部分，然后右键单击并选择“将细分发布到 Salesforce” 。
    
    ![选择了一部分数据并选择了将“细分发布到 Salesforce” 菜单选项的可视化项](/tableau/next/zh-cn/online/zh-cn/Img/TableauSegmentMenu.png)
2. 在“为 Data 360 创建细分”对话框中配置您的细分。
    
    “细分名称”为必填字段。名称必须以字母开头，并且只能包含字母数字字符和下划线。名称不能包含连续的下划线或以下划线结尾，并且不允许有空格。在 Data 360 中，细分名称显示为您在“细分名称”字段中指定的名称加上创建细分时的时间戳。
    
    当您在对话框中添加筛选器时，筛选器字段名称将显示在“规则”下。
    
    您可以将鼠标悬停在规则上以了解更多信息，例如依据其构建规则的筛选器或标记选择。多条规则可能会针对同一字段进行筛选，但了解更多有关规则来源的信息可以帮助您识别任何重复项。
    
    添加每个筛选器时，会显示细分总体计数。总体计数代表满足您的筛选条件的单个数据点（通常是客户）的计数。您可以使用总体计数来验证您的细分是否按预期工作，方法是确认 Tableau 和 Data 360 中的计数相同。Tableau 会对可视化项中的所有个体记录进行计数，但细分只会对不同的个体进行计数。若要查看 Tableau 可视化中项与细分计数匹配的不同个体，请使用 Count Distinct (COUNTD) 聚合函数。
    
    当您添加规则时， “描述”中会预先填充有关规则的详细信息。您可以根据需要编辑描述，但最多为 255 个字符。描述是可选的，但它可以更容易地在 Data 360 中找到细分。
3. 单击“创建”。创建细分后，会显示一条确认消息，其中包含用于在 Data 360 中查看细分的链接。
    
    ![显示细分已发布的确认消息，并带有可在 Data Cloud 中查看该细分的链接](/tableau/next/zh-cn/online/zh-cn/Img/SegmentToast.png)
    
    如果您在单击“创建”后收到错误，请确认您满足[发布到 Data 360 的要求](#Requirem)，并[检查组织的 Salesforce 实例的状态](https://help.salesforce.com/s/articleView?id=000384755&type=1)。
4. 在确认消息中，单击“在 Data 360中查看”。
    
    对于在 Tableau 中创建的细分，您可以在 Data 360 中修改“细分名称”、“描述”和“发布计划”。为此，请单击“编辑属性”。
    
    发布细分后，您将无法修改该细分的规则。相反，您必须[在 Data 360 中删除该细分](https://help.salesforce.com/s/articleView?id=sf.c360_a_delete_segment.htm&type=5)并在 Tableau 中创建一个新细分。
5. 从 Data 360 中，您的营销团队可以将[细分发布到适当的激活目标](https://help.salesforce.com/s/articleView?id=sf.c360_a_publish_segment.htm&type=5)。

<!-- document id=bacf0f872e084f66117cd9e7d9180a84d82ecd16e1c06ad4bffac0955f333ba4 url=/tableau/next/zh-cn/online/pulse_capabilities.md -->

[跳转到主要内容](#main-content)

# 高级 Tableau Pulse 功能

有限数量的 Tableau Pulse 功能仅作为 Tableau+ 的一部分提供。Tableau+ 是 Tableau Cloud 的许可版本，支持更大规模或更复杂的部署。若要了解详细信息，请参见[关于 Tableau+ Bundle](https://help.tableau.com/v0.0/online/zh-cn/to_tab_plus_features.htm)。

<table class="table--plain"><thead><tr><th width="25%">能力</th><th>描述</th></tr></thead><tbody><tr><td>Pulse 中的 Tableau Agent（以前称为增强型问答）</td><td><p>使用 Tableau Pulse 主页上的“Pulse 中的 Tableau Agent”来探索有关共享相同数据源、定义或时间范围的指标组的见解。在单个指标上，选择“提问”按钮，然后选择“Pulse 中的 Tableau Agent”问题，以获得由 Tableau 中的 AI 提供支持的答案。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_ask_discover_qa.htm" class="xref">在 Tableau Pulse 中提出问题并发现见解</a>。</p><p>您可以使用 Try AI 站点设置在现有 Tableau Cloud 站点上免费试用“Pulse 中的 Tableau Agent”。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/tableau_gai_trial.htm" class="xref">试用 Pulse 中的 Tableau Agent</a>。</p></td></tr><tr><td>相关指标</td><td>深入了解指标与已设置为相关性候选指标的其他指标的相似之处。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_create_metrics.htm#configure-insights" class="xref">配置见解</a>。</td></tr><tr><td>预测</td><td>查看对指标在剩余时间段内的预期表现的预测。预测显示在指标的见解探索页面上的概览图表中。有关详细信息，请参见<a href="https://help.tableau.com/v0.0/online/zh-cn/pulse_insights_platform_insight_types.htm#InsightTypesList" class="xref">Tableau Pulse 中的见解类型</a>。</td></tr></tbody></table>