Power BI中Web API（如JIRA API）增量刷新实现可行性咨询

完全可以实现你要的两个增量刷新需求，Power BI Pro自带的增量刷新功能原生支持追加新增行、更新变更旧行的逻辑，只要你的JIRA API支持按最后更新时间字段过滤查询即可。

前置条件确认 #

• 确认JIRA API支持updated（最后更新时间）字段作为查询参数，可返回指定时间点之后所有新增/变更的工单数据，JIRA原生REST API默认支持该过滤参数，无需额外改造数据源。
• 在Power Query中已经将返回的最后更新时间字段转换为标准日期/时间格式，建议统一转为UTC时间，避免时区差导致刷新边界数据遗漏。

具体实现步骤 #

1. Power Query创建时间范围参数 #

首先创建2个日期/时间类型的Power Query参数，这两个参数后续会被Power BI的增量刷新机制自动赋值，无需手动维护：

• RangeStart：默认值设置为你历史数据的最早时间，比如2014-01-01T00:00:00Z
• RangeEnd：默认值设置为当前UTC时间即可

2. 改造API查询逻辑增加过滤条件 #

修改原有的JIRA API查询语句，增加最后更新时间的过滤规则，仅拉取最后更新时间 >= RangeStart 且 < RangeEnd的数据，示例代码参考：

let
    // 替换为你的JIRA域名，jql参数中加入updated的时间过滤规则
    源 = Json.Document(Web.Contents("https://<你的JIRA域名>/rest/api/3/search?jql=updated>=" & DateTime.ToText(RangeStart, "yyyy-MM-dd'T'HH:mm:ss'Z'") & "%20AND%20updated<" & DateTime.ToText(RangeEnd, "yyyy-MM-dd'T'HH:mm:ss'Z'") & "&maxResults=1000")),
    // 后续的字段展开、类型转换逻辑保持你原有写法不变
    展开数据 = Table.ExpandListColumn(源, "issues"),
    // ...其余原有逻辑
in
    展开数据

注意：需将该查询的隐私级别设置为公共，或在数据源设置中开启忽略隐私级别检查，避免动态URL调用报错。

3. 配置增量刷新策略 #

在Power BI Desktop右侧字段面板，右键点击JIRA对应事实表，选择「增量刷新」，按如下规则配置：

• 存档行时间范围：选择10年，对应你需要保留的全部历史数据时长
• 增量刷新行时间范围：按你的刷新周期设置，天级刷新选1天，小时级刷新选对应时长即可
• 勾选检测数据更改选项，下拉选择你的最后更新时间字段：该选项就是用来实现更新旧行的需求，Power BI每次刷新会拉取增量周期内所有最后更新时间变动的行，自动覆盖更新数据集中的旧数据
• 可选配置「在刷新时多获取过去的N小时/天」：建议设置1小时，规避API数据延迟、时区差导致的边界数据丢失问题

4. 发布与计划刷新配置 #

• 配置完成后先在Power BI Desktop执行一次全量加载，确认10年历史数据全部导入正常后，发布到Power BI服务
• 发布后在工作区的数据集设置中开启计划刷新，按你需要的频率设置即可，后续每次刷新都会自动执行增量逻辑，无需全量拉取10年数据

常见注意事项 #

• 如果你的JIRA单次查询返回结果有数量上限，需要在Power Query中补充翻页逻辑，避免增量刷新时只拉取到第一页数据
• 每次修改Power Query的查询逻辑重新发布后，需要执行一次全量刷新，新的增量策略才会生效
• 如需全量重刷所有数据，在Power BI服务的数据集设置中选择「刷新所有数据」即可

内容的提问来源于stack exchange，提问作者J.B.