Azure 函数：如何将 http 触发器函数的查询字符串参数绑定到 Cosmos DB 的 SQL 查询

Question

我正在尝试使用 Cosmos DB 输入绑定运行 http 触发 Azure 函数。我希望 http 触发器的 url 在查询字符串中包含几个参数，这些参数绑定到输入 Cosmos DB 绑定的 SQL 查询。我正在function.json 中尝试以下绑定，但它不起作用（该函数甚至没有被触发）：

{
  "direction": "in",
  "type": "httpTrigger",
  "authLevel": "anonymous",
  "name": "req",
  "methods": [ "get" ],
  "route": "users/{age=age?}/{gender=gender?}"
},
{
  "direction": "in",
  "type": "documentDB",
  "name": "users",
  "databaseName": "Database",
  "collectionName": "Users",
  "sqlQuery": "SELECT * FROM x where x.age = {age} and x.gender = {gender}",
  "connection": "COSMOSDB_CONNECTION_STRING"
},

根据answer，路由约束users/{age=age?}/{gender=gender?} 对Web API 有效，并且根据documentation您可以使用任何Web API 路由约束与您的参数。最终，我想向 Azure 函数发出一个类似于 api/users?age=30&gender=male 的 GET 请求。那应该怎么做呢？

Answer 1

您可以将查询值绑定到 CosmosDB 输入绑定：
Azure Cosmos DB input binding for Azure Functions 2.x and higher

[FunctionName("DocByIdFromQueryString")]
public static IActionResult Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)]
        HttpRequest req,
    [CosmosDB(
        databaseName: "ToDoItems",
        collectionName: "Items",
        ConnectionStringSetting = "CosmosDBConnection",
        Id = "{Query.id}",
        PartitionKey = "{Query.partitionKey}")] ToDoItem toDoItem,
    ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    if (toDoItem == null)
    {
        log.LogInformation($"ToDo item not found");
    }
    else
    {
        log.LogInformation($"Found ToDo item, Description={toDoItem.Description}");
    }
    return new OkResult();
}

Answer 2

GET 和 POST 参数将被绑定，因此它们可以在 sqlQuery 内部使用，无需任何额外配置。试试看，这在过去肯定改变了

Answer 3

我认为您不能将 Cosmos DB 绑定配置到查询参数中定义的值，例如?age=30。至少我在函数文档中没有看到任何类似的例子。

但是您可以将它们绑定到路由参数以实现相同的结果，您已经完成了很多工作。

保持users/{age}/{gender} 的路由，然后您的 Cosmos SqlQuery 将在对http://yourfunctionhost/yourfunction/users/30/male 调用 GET 时获取这些路由参数