ALTER COLLATION name REFRESH VERSION

ALTER COLLATION name RENAME TO new_name
ALTER COLLATION name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER COLLATION name SET SCHEMA new_schema

描述

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语句。

另请参见

创建校对规则、删除校对规则