ALTER COLLATION — 更改排序规则的定义
ALTER COLLATIONname
REFRESH VERSION ALTER COLLATIONname
RENAME TOnew_name
ALTER COLLATIONname
OWNER TO {new_owner
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER COLLATIONname
SET SCHEMAnew_schema
ALTER COLLATION
更改排序规则的定义。
要使用 ALTER COLLATION
,您必须拥有该排序规则。要更改所有者,您必须能够 SET ROLE
到新的所有者角色,并且该角色必须对排序规则的模式具有 CREATE
权限。(这些限制确保更改所有者不会执行您无法通过删除并重新创建排序规则来完成的操作。但是,超级用户可以更改任何排序规则的所有权。)
name
现有的排序规则的名称(可以选择模式限定)。
new_name
排序规则的新名称。
new_owner
排序规则的新所有者。
new_schema
排序规则的新模式。
REFRESH VERSION
更新排序规则的版本。请参阅下面的 Notes。
当创建排序规则对象时,特定提供程序的排序规则版本会记录在系统目录中。当使用排序规则时,当前版本会与记录的版本进行检查,如果存在不匹配,则会发出警告,例如:
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
语句。
如果您在文档中发现任何不正确、与您的实际体验不符或需要进一步解释的内容,请使用 此表单 报告文档问题。