云数据库 GAUSSDB-Global Plsql Cache特性函数

时间：2024-11-02 18:50:31

云数据库 GAUSSDB

Global Plsql Cache特性函数

invalidate_plsql_object()，invalidate_plsql_object(schema, objname, objtype);

描述：将Global Plsql Cache全局缓存中的对象失效掉，仅在enable_global_plsqlcache = on时可用。调用该函数的用户需要具有SYSADMIN权限。

参数：该函数为重载函数。当无入参时，将所有database内的所有全局缓存对象失效。

当指定(schema, objname, objtype)三个参数时可将当前database内的指定全局缓存对象失效，其中：schema为对象所属的schema名称；objname为对象名称；objtype为对象类型，对象为package类型时值为'package'，对象为函数或存储过程时值为'function'。

示例:

该函数不返回失效结果，可通过gs_glc_memory_detail视图查询，对象未被失效时可在视图中查找到对应的valid状态的行，失效后则没有对应的valid状态行（对象为package时，valid状态后会显示缓存对象为包头或者包体）。

invalidate_plsql_object所属的schema为pg_catalog，但不指定schema也可调用该函数。

--如在视图中可查到函数f3的缓存信息，状态为valid。
gaussdb=# SELECT * FROM gs_glc_memory_detail WHERE type='func';
 contextname | database | schema  | type | status  |        location        |   env    | usedsize
-------------+----------+---------+------+---------+------------------------+----------+----------
 f3          | testdb   | public  | func | valid   | in_global_hash_table   |        0 |    47584
gaussdb=# SELECT * FROM gs_glc_memory_detail WHERE type='pkg';
 contextname | database | schema  | type |      status     |        location        |   env    | usedsize
-------------+----------+---------+------+-----------------+------------------------+----------+----------
 pkg1        | testdb   | public  | pkg  | valid:spec/body | in_global_hash_table   |        0 |   184176

--调用函数，指定schema、函数名、类型即可将f3失效，再次查询视图，则f3没有对应的valid状态行。
gaussdb=# SELECT invalidate_plsql_object('public','f3','function');
 invalidate_plsql_object
-------------------------
(1 row)
--如要失效package类型，参数如下所示。
gaussdb=# call pg_catalog.invalidate_plsql_object('public','pkg1','package');
 invalidate_plsql_object
-------------------------
(1 row)

--调用时没有入参，则将失效所有缓存对象。
gaussdb=# SELECT invalidate_plsql_object();
 invalidate_plsql_object
-------------------------
(1 row)

父主题： 函数和操作符

上一篇：云数据库 GAUSSDB-废弃函数

下一篇：云数据库 GAUSSDB-Global SysCache特性函数