---
schema_version: "1"
id: 076bb6aa553d24dbf491c941ef47de67d5051714da7c92225f999540b0648213
title: 为 Tableau Pulse 设置数据
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/online/pulse_data_source_requirements.md
canonical_url: https://help.tableau.com/v0.0/online/zh-cn/pulse_data_source_requirements.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 14176a9c8e344ddea7bb2ef9bc5445875a8a2a9db4ff8ab02dfef492db8c9c70
description: Data source requirements for creating metric definitions in Tableau Pulse.
---
[跳转到主要内容](#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 |  |