2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1

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 权限。(这些限制确保更改所有者不会执行您无法通过删除并重新创建排序规则来完成的操作。但是,超级用户可以更改任何排序规则的所有权。)

参数

name

现有的排序规则的名称(可以选择模式限定)。

new_name

排序规则的新名称。

new_owner

排序规则的新所有者。

new_schema

排序规则的新模式。

REFRESH VERSION

更新排序规则的版本。请参阅下面的 Notes

注释

当创建排序规则对象时,特定提供程序的排序规则版本会记录在系统目录中。当使用排序规则时,当前版本会与记录的版本进行检查,如果存在不匹配,则会发出警告,例如:

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

提交更正

如果您在文档中发现任何不正确、与您的实际体验不符或需要进一步解释的内容,请使用 此表单 报告文档问题。