ALTER COLLATION

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

简介

你必须拥有要对其使用ALTER COLLATION的排序规则。要更改拥有者,你必须是新的拥有角色的直接或者间接成员,并且该角色必须在排序规则的模式上具有CREATE特权(这些限制强制要求拥有者不能通过丢弃并重建该排序规则来做任何你不能做的事情。不过,一个超级用户可以更改任何排序规则的所有权)。

语法

    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

参数

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 PolarDB with the right library version.

排序规则定义的更改会导致索引损坏和其他问题,因为数据库系统依赖于具有特定排序顺序的存储对象。 通常,应该避免这种情况,但它可以在合法的情况下发生,例如使用pg_upgrade 升级到与更新版本的 ICU 链接的服务器二进制文件。发生这种情况时, 应该重建所有依赖于该排序规则的对象,例如,使用REINDEX。 完成后,使用命令ALTER COLLATION ... REFRESH VERSION可以刷新排序规则版本。 这将更新系统目录以记录当前的排序规则版本,并会使警告消失。请注意, 这实际上并不检查是否所有受影响的对象都已正确重建。

使用 libc 提供的排序规则,并且 PolarDB 是使用 GNU C 库构建的,则将 C 库的版本用作排序规则版本。由于排序规则定义通常仅随 GNU C 库发行版而更改, 因此可以提供一些防止损坏的防御措施,但它并不是完全可靠的。

当前,没有针对数据库默认排序规则的版本跟踪。

以下查询可用于识别当前数据库中需要刷新的所有排序规则以及依赖它们的对象:

    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;