前提條件

select version();

背景信息

在PostgreSQL中，增加分區表varchar列長度時，會自動重建被修改列相關的索引，導致ALTER TABLE執行效率很低。此外，ALTER TABLE需要持有ACCESS EXCLUSIVE鎖，會長時間阻塞其他連接對該表的訪問。

PolarDB PostgreSQL版支持polar_ddl_manager插件，提供了一些函數用于優化增加分區表varchar列長度的執行效率。

使用方法

安裝插件

CREATE EXTENSION polar_ddl_manager;

相關函數

• polar_ddl_manager.alter_varchar_column_length_cmd

  該函數能獲取增長varchar列長度的ALTER TABLE命令列表，可用于在執行DDL命令前檢查命令是否正確。參數說明如下：

  參數	說明
  parent_table_name	分區表的名稱。
  parent_table_schema	分區表所在的schema。
  column_name	需要增長的列名。
  target_len	增長后的目標長度。
  novalidate	是否要跳過分區約束檢查，取值如下： true（默認）：跳過分區約束檢查。 false：不跳過分區約束檢查。

• polar_ddl_manager.alter_varchar_column_length

  該函數會通過polar_ddl_manager.alter_varchar_column_length_cmd函數獲取DDL命令并自動執行，完成分區表varchar列的增長。其主要流程如下：

  1. 對分區表及其子表加鎖，并完成合法性檢查。

  2. DETACH所有子分區。

  3. 修改分區表及其子表的varchar列長度。

  4. ATTACH所有子分區。

使用示例

CREATE TABLE t(a int, b varchar(10), c char(128)) PARTITION BY HASH (a);
CREATE TABLE t_p1 PARTITION OF t FOR VALUES WITH (MODULUS 2, REMAINDER 0);
CREATE TABLE t_p2 PARTITION OF t FOR VALUES WITH (MODULUS 2, REMAINDER 1);
CREATE index ON t(b);
INSERT INTO t SELECT i, i FROM generate_series(1, 1000000) i;
-- 增加b列的長度，不跳過分區約束的檢查
SELECT polar_ddl_manager.alter_varchar_column_length('t', 'public', 'b', 15, false);
-- 增加b列的長度，跳過分區約束的檢查
SELECT polar_ddl_manager.alter_varchar_column_length('t', 'public', 'b', 20);

卸載插件

DROP EXTENSION polar_ddl_manager;

ALTER TABLE [ IF EXISTS ] name
    ATTACH PARTITION partition_name { FOR VALUES partition_bound_spec | DEFAULT } [NOCHECK_CONSTRAINT]

性能對比

測試所用到的表結構如下所示：

CREATE TABLE t(a int, b varchar(10), c char(128)) PARTITION BY HASH (a);
CREATE TABLE t_p1 PARTITION OF t FOR VALUES WITH (MODULUS 2, REMAINDER 0);
CREATE TABLE t_p2 PARTITION OF t FOR VALUES WITH (MODULUS 2, REMAINDER 1);

分別測試在不同數據量、有無索引的場景下的執行時間（單位為 ms），測試結果如下：