Npgsql.EntityFrameworkCore.PostgreSQL 中自定义排序规则的使用注意事项

在使用Npgsql.EntityFrameworkCore.PostgreSQL时，开发者可能会遇到自定义排序规则（Collation）在迁移过程中出现命名问题的情况。本文将深入分析这一问题的成因，并提供解决方案。

问题现象

当开发者在EF Core模型中定义自定义排序规则并应用到列上时，生成的迁移脚本可能会出现排序规则名称不正确的问题。具体表现为：

1. 在创建表时，列定义的排序规则名称缺少schema前缀
2. 手动修正后，排序规则名称被错误地整体包裹在双引号中

根本原因

这个问题源于EF Core PostgreSQL提供程序对非默认schema中的排序规则支持不完善。具体来说：

1. 当排序规则定义在非默认schema中时，迁移生成器未能正确处理schema限定名称
2. 对于带schema的标识符，正确的处理方式应当是将schema和名称分别用双引号包裹（如"schema"."name"），但当前实现将它们作为一个整体包裹（如"schema.name"）

解决方案

目前开发者可以采取以下临时解决方案：

1. 将自定义排序规则创建在默认的public schema中
2. 如果需要使用特定schema，可以手动修改生成的迁移文件，确保：
   • 创建排序规则时指定正确的schema
   • 在表列定义中使用完整的schema限定名称
   • 确保引号使用正确（分别包裹schema和名称）

技术背景

PostgreSQL中的排序规则定义了字符串比较和排序的规则。EF Core通过HasCollation和UseCollation方法支持自定义排序规则，特别是支持使用ICU提供程序创建更强大的排序规则。

在数据库迁移过程中，EF Core需要正确处理标识符的schema限定和引用规则。PostgreSQL要求：

• 保留大小写的标识符需要用双引号包裹
• 带schema的标识符应当分别引用schema和对象名

最佳实践

在使用自定义排序规则时，建议：

1. 优先考虑使用public schema
2. 仔细检查生成的迁移脚本
3. 考虑在应用启动时通过原始SQL确保排序规则存在
4. 关注EF Core PostgreSQL的更新，等待官方修复此问题

总结

虽然当前存在对非默认schema中排序规则支持的限制，但通过理解PostgreSQL的标识符处理规则和EF Core的迁移机制，开发者可以找到合适的解决方案。随着EF Core PostgreSQL的持续发展，这类问题有望在未来的版本中得到完善解决。