VastbaseE100

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 Vastbase E100 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;