描述

ALTER COLLATION 更改排序规则的定义。

您必须拥有该排序规则才能使用 ALTER COLLATION。要更改所有者，您必须能够 SET ROLE 为新的所有者角色，并且该角色必须对排序规则的模式具有 CREATE 权限。（这些限制强制执行更改所有者不会执行任何您无法通过删除并重新创建排序规则来执行的操作。但是，超级用户可以更改任何排序规则的所有权。）

参数

注释

创建排序规则对象时，排序规则的提供者特定版本会记录在系统目录中。当使用排序规则时，当前版本会与记录的版本进行比较，并且当存在不匹配时会发出警告，例如

WARNING:  collation "xx-x-icu" has version mismatch
DETAIL:  The collation in the database was created using version 1.2.3.4, but the operating system provides version 2.3.4.5.
HINT:  Rebuild all objects affected by this collation and run ALTER COLLATION pg_catalog."xx-x-icu" REFRESH VERSION, or build PostgreSQL with the right library version.

排序规则定义的更改可能会导致索引损坏和其他问题，因为数据库系统依赖于具有特定排序顺序的存储对象。通常，应避免这种情况，但在合法情况下可能会发生，例如将操作系统升级到新的主版本，或者使用 pg_upgrade 升级到链接到较新版本的 ICU 的服务器二进制文件时。发生这种情况时，应重建所有依赖于排序规则的对象，例如，使用 REINDEX。完成此操作后，可以使用命令 ALTER COLLATION ... REFRESH VERSION 刷新排序规则版本。这将更新系统目录以记录当前排序规则版本，并使警告消失。请注意，这实际上不会检查所有受影响的对象是否已正确重建。

当使用 libc 提供的排序规则时，版本信息会记录在使用 GNU C 库（大多数 Linux 系统）、FreeBSD 和 Windows 的系统上。当使用 ICU 提供的排序规则时，版本信息由 ICU 库提供，并且在所有平台上都可用。

对于数据库默认排序规则，有一个类似的命令 ALTER DATABASE ... REFRESH COLLATION VERSION。

以下查询可用于识别当前数据库中所有需要刷新的排序规则以及依赖于它们的对象的

SELECT pg_describe_object(refclassid, refobjid, refobjsubid) AS "Collation",
       pg_describe_object(classid, objid, objsubid) AS "Object"
  FROM pg_depend d JOIN pg_collation c
       ON refclassid = 'pg_collation'::regclass AND refobjid = c.oid
  WHERE c.collversion <> pg_collation_actual_version(c.oid)
  ORDER BY 1, 2;

示例

要将排序规则 de_DE 重命名为 german

ALTER COLLATION "de_DE" RENAME TO german;

要将排序规则 en_US 的所有者更改为 joe

ALTER COLLATION "en_US" OWNER TO joe;

兼容性

SQL 标准中没有 ALTER COLLATION 语句。

另请参阅