如何在Azure复制活动中实现API偏移分页的动态终止

步骤1：获取API总页数（last_page） #

• 添加一个Lookup活动，命名为GetFirstPage，源选择你的REST API链接。
• 在Lookup的Query Parameters里设置第一页的参数（比如page=1，根据你的API实际要求调整），确保能返回包含pagination字段的完整响应。
• 不需要勾选“First row only”，让Lookup返回整个API响应内容。

步骤2：存储总页数到变量 #

• 在管道的变量面板创建一个整数类型的变量，命名为totalPages。
• 添加一个Set Variable活动，变量选择totalPages，值填写表达式：

  @int(activity('GetFirstPage').output.pagination.last_page)
  

  这里用int()转换是因为Range需要整数类型的参数。

步骤3：配置复制活动的动态Range参数 #

• 打开你的复制活动，在源的Query Parameters里，找到Range参数，把硬编码的结束值替换为变量：

  Range(1, @variables('totalPages'), 1)
  

  这样复制活动会自动从第1页循环到API返回的最后一页。

步骤4：设置正确的自动终止条件（可选但推荐） #

• 之前的EndCondition写法错误，ADF的表达式必须以@开头，且判断空值要用empty()函数。在复制活动的分页设置里，把EndCondition改为：

  @empty(activity('Copy Data').output.data.ws_fin_out_header)
  

  这个条件会在当前页返回的ws_fin_out_header数据为空时自动终止循环，作为动态Range的额外保险，防止API返回的last_page不准确导致无效请求。

注意事项 #

• 确保你的REST API在返回最后一页后，下一页（如果存在）会返回空数据，这样EndCondition才能触发。
• 测试时可以先把totalPages设为小数值（比如3），验证分页逻辑正常后再用动态值。

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