使用@azure/data-tables的TableClient按时间戳过滤返回空数组问题排查

问题核心在于系统属性的大小写匹配：Azure存储表的系统时间戳属性是Timestamp（首字母大写），而非你代码中使用的小写timestamp。OData查询对属性名大小写敏感，因此小写的timestamp无法匹配到系统内置字段，导致过滤无结果。

修改后的代码 #

将过滤条件中的字段名改为大写开头的Timestamp即可：

const page = await serviceClient
    .listEntities({
         queryOptions: {                             
            filter: `Timestamp ge datetime'2022-06-27T02:57:35.1831423Z'` // 修正字段名大小写
         }
     })
   .byPage({ maxPageSize: 1000, continuationToken })
   .next();   

额外注意事项 #

• Azure存储表的系统属性（如PartitionKey、RowKey、Timestamp）均为驼峰式首字母大写格式，查询时必须严格匹配大小写。
• 你使用的datetime格式是合规的，符合OData对datetime类型的要求（datetime'YYYY-MM-DDTHH:mm:ss.fffffffZ'）。
• 若表中存在自定义的timestamp字段（非系统内置字段），需确认字段名实际大小写是否与代码一致，但结合你描述的场景，此处明显是系统属性的大小写匹配问题。

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