选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

ALTER COLLATION

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

Synopsis

ALTER COLLATION name REFRESH VERSION

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

描述

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

要使用ALTER COLLATION,必须拥有该排序规则。要更改所有者,还必须是新所有者角色的直接或间接成员,并且该角色必须在排序规则所在模式上拥有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刷新排序规则 版本。这样会更新系统目录,使其记录当前的排序规则版本,并让该警告消 失。请注意,这实际上并不会检查所有受影响对象是否都已被正确重建。

可以使用以下查询找出当前数据库中所有需要刷新的排序规则,以及依赖这些排序规则的对象:

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