全局共享级计划缓存管控

前提条件

• 开启PBE查询和存储过程中语句的执行计划进行缓存共享，将enable_global_plancache参数设置为on，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 查询规划 > 其他优化器选项”章节。
• 启用逻辑内存管理模块，将enable_memory_limit参数设置为on，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 资源消耗 > 内存”章节。设置成功后，重启数据库集群。
• 开启GPC内存管控。

  将GUC参数global_plancache_memory_ratio设置为大于0的值，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 负载管理”章节。

语法

通过gsql创建PREPARE语句，或通过JDBC创建PREPARE语句。

• 通过gsql创建：

  PREPARE name [ ( data_type [, ...] ) ] AS statement;

• 通过JDBC创建：

  PreparedStatement pstmt = connection.prepareStatement(sql);

注意事项

1. GPC计划缓存存在并发访问，因此无法保证淘汰策略成功。
2. 达到管控上限后且GPC计划淘汰失败时，再次创建的计划将退化为会话级。

操作步骤

1. 打开逻辑内存管理和会话级计划缓存管控，将enable_memory_limit参数设置为on，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 资源消耗 > 内存”章节。设置成功后，重启数据库集群。
2. 将global_plancache_memory_ratio参数设置为30，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 负载管理”章节。

3. 创建大量PREPARE语句。
4. 观察内存视图，在计划缓存大小达到阈值后不再增长。

示例

将global_plancache_memory_ratio参数设置为30，具体设置请参见《参考》中“数据库运行参数说明 > GUC参数说明 > 负载管理”章节。

gsql连接数据库：

gaussdb=# CREATE TABLE plancache_memctl_tbl (col1 int, col2 varchar(10));
NOTICE:  The 'DISTRIBUTE BY' clause is not specified. Using 'col1' as the distribution column by default.
HINT:  Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.
CREATE TABLE
gaussdb=# INSERT INTO plancache_memctl_tbl (col1, col2) VALUES (1, 'test');
INSERT 0 1
gaussdb=# SET plan_cache_mode=force_generic_plan;
SET
gaussdb=# PREPARE p1 AS SELECT * FROM plancache_memctl_tbl WHERE col1=$1;execute p1(1);
PREPARE
 col1 | col2 
------+------
    1 | test
(1 row)

gaussdb=# PREPARE p2 AS SELECT * FROM plancache_memctl_tbl WHERE col1=$1;execute p2(1);
PREPARE
 col1 | col2 
------+------
    1 | test
(1 row)

-- 创建大量计划缓存（根据业务实际进行创建，示例中不做展示）。
 
-- GPC计划内存大小。
gaussdb=# SELECT sum(size) FROM DBE_PERF.GLOBAL_PLANCACHE_STATUS;
  sum   
--------
 159744
(1 row)

gaussdb=# DROP TABLE plancache_memctl_tbl ;
DROP TABLE