Azure SDK for .NET 中 Azure.Data.Tables 12.10.0 版本发布解析

Azure.Data.Tables 是微软 Azure SDK for .NET 中的一个重要组件，它为开发者提供了与 Azure Table Storage 服务交互的能力。Azure Table Storage 是一种 NoSQL 数据存储服务，适合存储结构化、非关系型数据，具有高可用性和可扩展性等特点。

重大变更：字符串比较过滤器的严格校验

本次 12.10.0 版本引入了一个重要的行为变更，涉及查询过滤器中字符串比较的处理方式。在之前的版本中，当开发者使用 TableClient.Query、TableClient.QueryAsync 或 TableClient.CreateQueryFilter 方法时，如果过滤表达式使用了 string.Equals 或 string.Compare 并带有 StringComparison 参数，系统会默默地忽略 StringComparison 参数。

这种行为实际上是一个潜在的问题，因为 Azure Table 服务本身并不支持这些带有 StringComparison 参数的方法。在之前的版本中，这种不匹配被静默处理，可能导致开发者难以察觉的查询逻辑错误。

在 12.10.0 版本中，SDK 团队决定改变这一行为，现在当检测到这种用法时，会直接抛出异常，强制开发者意识到这个问题。这一变更虽然可能影响现有代码，但从长远来看有助于提高代码的可靠性和可预测性。

兼容性选项

考虑到这一变更可能影响现有应用程序，SDK 提供了回退机制。开发者可以通过以下方式之一恢复之前的行为：

1. 设置 AppContext 开关 "Azure.Data.Tables.DisableThrowOnStringComparisonFilter" 为 true
2. 设置环境变量 "AZURE_DATA_TABLES_DISABLE_THROWONSTRINGCOMPARISONFILTER" 为 "true"

对于 .NET 项目，还可以通过项目配置文件来设置这个开关：

<ItemGroup>
    <RuntimeHostConfigurationOption Include="Azure.Data.Tables.DisableThrowOnStringComparisonFilter" Value="true" />
</ItemGroup>

性能优化

除了上述重大变更外，12.10.0 版本还包含了一个性能改进：

• 优化了 TableServiceClient.GetTableClient() 方法的性能

这一优化使得获取表客户端实例的操作更加高效，对于频繁创建表客户端实例的应用场景将带来明显的性能提升。

升级建议

对于正在使用 Azure.Data.Tables 的开发者，建议在升级到 12.10.0 版本前：

1. 检查代码中是否使用了带有 StringComparison 参数的字符串比较方法作为查询过滤器
2. 如果确实使用了这些方法，考虑修改查询逻辑以避免依赖 StringComparison 参数
3. 如果暂时无法修改代码，可以使用提供的兼容性选项暂时恢复旧行为
4. 测试应用程序在性能敏感路径上是否频繁调用 GetTableClient() 方法，评估性能改进带来的好处

这一版本的变更体现了 Azure SDK 团队对产品质量和开发者体验的持续关注，通过更严格的校验帮助开发者编写更可靠的代码，同时通过性能优化提升运行时效率。