如何配置Azure Functions CosmosDB触发器单实例处理文档数量上限？

完全可以通过配置限制CosmosDB触发器每个实例单次处理的文档数量，结合消费计划的自动扩缩容特性，就能把大量变更分散到多个实例并行处理，避免单实例因执行超时被终止。

核心配置方法 #

在Function的host.json文件中，针对CosmosDB触发器调整以下关键参数：

1. maxItemsPerInvocation #

直接设置单触发器调用（即单实例单次执行）允许处理的最大文档数量，比如你想要的50：

{
  "version": "2.0",
  "extensions": {
    "cosmosDB": {
      "trigger": {
        "maxItemsPerInvocation": 50
      }
    }
  }
}

这个参数会强制触发器每次调用最多拉取指定数量的变更文档，超出部分会留待其他实例或后续调用处理。

2. feedPollDelay（可选优化） #

调整触发器轮询CosmosDB变更 feed 的间隔，默认是5000毫秒（5秒）。如果变更量极大，可以适当缩短间隔，让新启动的实例更快获取待处理任务：

{
  "version": "2.0",
  "extensions": {
    "cosmosDB": {
      "trigger": {
        "maxItemsPerInvocation": 50,
        "feedPollDelay": 2000
      }
    }
  }
}

配合消费计划的自动扩缩容 #

消费计划会根据触发器的待处理任务量自动增加实例数。比如有1000个变更时，每个实例处理50个，系统会自动启动20个实例并行执行，只要单实例处理50个文档的耗时不超过10分钟，就能避免超时问题。

额外注意事项 #

• 确认你的CosmosDB容器已开启变更 feed（默认开启，无需额外配置）。
• 如果单实例处理50个文档仍接近超时，可以进一步降低maxItemsPerInvocation的值，比如设为20或30。
• 隔离模式下的Function完全支持这些配置，无需调整运行时模式。

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