ALTER COLLATION

ALTER COLLATION — 更改校对规则的定义

语法

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权限。（这些限制强制要求更改所有者不会执行通过删除和重新创建校对规则无法执行的操作。但是，超级用户无论如何都可以更改任何校对规则的所有权。）

参数

名称

现有排序规则的名称（可选，模式限定）。

new_name

排序规则的新名称。

new_owner

排序规则的新所有者。

new_schema

排序规则的新模式。

REFRESH VERSION

更新排序规则的版本。请参见下面的注释。

注释

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

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 库提供，并且可在所有平台上使用。

注意

使用 GNU C 库进行排序时，C 库的版本用作排序规则版本的代理。许多 Linux 发行版仅在升级 C 库时才更改排序规则定义，但这种方法并不完美，因为维护人员可以自由地将较新的排序规则定义反向移植到较旧的 C 库版本中。在 Windows 上使用排序规则时，版本信息仅适用于使用 BCP 47 语言标记（例如en-US）定义的排序规则。

对于数据库默认排序规则，有一个类似的命令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语句。

另请参阅

CREATE COLLATION，DROP COLLATION