Microsoft Fabric Data Factory REST API分页配置问题求助

核心配置检查与修正 #

1. 校准分页规则的关键映射 #

你的API是基于page参数递增的分页模式，且响应返回total_pages，必须确保分页规则的触发逻辑完全匹配API结构：

• 在Copy Data活动的REST源配置中，进入分页规则：
  • 分页规则类型选页码分页
  • 当前页码参数名填page（严格匹配API的参数名，注意大小写）
  • 总页数路径填写响应中total_pages的JSON绝对路径，比如响应是顶级字段就写$.total_pages，有嵌套则补全层级（如$.meta.total_pages）
  • 起始页码设为1，页码增量设为1
  • 终止条件选择当当前页码大于总页数时停止

2. 修正URL与参数配置 #

• 基础绝对URL只保留https://api.somecompany.com/data，不要把page参数写进基础URL
• 在查询参数列表中手动添加start、end、limit：前两个绑定你的日期循环变量，limit固定设为200；不要手动添加page参数，分页规则会自动动态生成并递增该参数

3. 验证响应解析正确性 #

• 开启源配置的预览数据功能，确认能正确读取到total_pages的数值
• 若响应的有效数据在result数组中，需在源配置的高级选项里，把数据集的路径设为$.result，确保Data Factory能识别有效数据，同时不影响分页参数的读取

日期循环场景适配 #

因为Copy Data已处于日期范围循环内，无需嵌套循环，只要上述配置正确，Data Factory会在每次循环的日期区间内自动完成全量分页拉取：

• 确认startdatetime和enddatetime变量的输出格式与API要求一致（比如ISO 8601格式）
• 验证数据量超过200条时（即total_pages>1），是否会自动发起后续页面的请求

排障技巧 #

• 开启Copy Data活动的详细日志，运行后查看请求URL，确认page参数是否按预期递增
• 若page始终为1，检查分页规则中“当前页码参数名”是否与API的page完全一致
• 可补充设置空响应终止规则，作为total_pages判断的补充，避免API最后一页返回空数组时无法终止

内容的提问来源于stack exchange，提问作者Jazza