2024年9月26日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本: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

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

注释

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

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

提交更正

如果您在文档中看到任何不正确的内容,与您对特定功能的体验不符,或者需要进一步澄清,请使用 此表单 报告文档问题。