使用Azure.Data.Tables的TableClient.Query如何限制查询返回结果

旧版WindowsAzure.Storage SDK中通过链式Take()方法限制查询返回条数的逻辑，在新版Azure.Data.Tables中没有以同名扩展方法的形式保留，对应功能可以通过SDK原生支持的两种方式实现，底层都是给表查询请求设置OData $top参数，和旧版Take()行为完全一致，不会出现内存截断的性能问题。

实现方式1：LINQ查询场景 #

使用LINQ表达式写查询过滤逻辑时，直接调用System.Linq下的标准Take()方法即可，SDK会自动识别该方法，将传入的条数转换为请求层面的返回数量限制，不需要额外配置。
示例代码：

using Azure.Data.Tables;
using System.Linq;

// 初始化表客户端
TableClient tableClient = new TableClient("<你的存储连接字符串>", "<目标表名>");

// 最多返回10条匹配分区键的实体，等价于旧版Take(10)的效果
Pageable<TableEntity> result = tableClient.Query<TableEntity>(ent => ent.PartitionKey == "指定分区键")
                                          .Take(10);

// 遍历获取结果，取到足够数量后直接break即可终止后续请求
foreach (var entity in result)
{
    // 业务处理逻辑
}

实现方式2：原生OData过滤器查询场景 #

如果使用传入OData过滤字符串的Query方法重载，不需要写LINQ逻辑，直接给方法的maxPerPage参数传入要限制的条数即可，直接在请求层面生效。
示例代码：

Pageable<TableEntity> result = tableClient.Query<TableEntity>(
    filter: "PartitionKey eq '指定分区键'",
    maxPerPage: 10 // 单次请求最多返回10条结果
);

foreach (var entity in result)
{
    // 业务处理逻辑
}

注意事项 #

• 上述两种方式设置的数量限制是单次REST请求的最大返回条目数，如果匹配结果总数超过设置值，Pageable迭代器默认会自动发起后续分页请求拉取剩余数据。如果只需要取前N条结果，在遍历到第N条时直接跳出循环即可，SDK不会发起多余的后续请求。
• 禁止对无数量限制的全量查询结果在内存中做Take()截断，会导致全量拉取表数据，产生不必要的流量开销和性能损耗。

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