On this page
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
Description
ALTER COLLATION
更改排序规则的定义。
您必须拥有排序规则才能使用ALTER COLLATION
。要更改所有者,您还必须是新拥有角色的直接或间接成员,并且该角色必须在归类的架构上具有CREATE
特权。 (这些限制规定,更改所有者不会通过删除并重新创建归类来完成您无法做的任何事情.但是,超级用户仍然可以更改任何归类的所有权.)
Parameters
name
- 现有排序规则的名称(可选,由模式限定)。
new_name
- 排序规则的新名称。
new_owner
- 排序规则的新所有者。
new_schema
- 排序规则的新架构。
REFRESH VERSION
- 更新排序规则的版本。请参阅下面的Notes。
Notes
使用 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.
归类定义的更改可能导致索引损坏和其他问题,因为数据库系统依赖于具有特定排序 Sequences 的存储对象。通常,应该避免这种情况,但是在合理的情况下可能会发生,例如,使用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;
Examples
要将排序规则de_DE
重命名为german
:
ALTER COLLATION "de_DE" RENAME TO german;
要将排序规则en_US
的所有者更改为joe
:
ALTER COLLATION "en_US" OWNER TO joe;
Compatibility
SQL 标准中没有ALTER COLLATION
语句。