↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1
历史版本。 PostgreSQL 11 已结束支持。 2023-11-09. 请参阅 当前版本手册.

ALTER COLLATION

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

大纲

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

刷新排序规则版本。参阅下面的注解。

注解

使用 ICU 库提供的排序规则时,创建排序规则对象会在系统目录中记录 ICU 给出的排序器版本。使用该排序规则时,会将当前版本与记录的版本进行比较;如果二者不匹配,就会发出警告,例如:

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.