sys_spacequota 扩展插件介绍

插件sys_spacequota简介

sys_spacequota可以对指定表空间的大小进行限额，一旦大于该限额，例如对此表空间里的数据进行insert, update, copy to,

select into, create index操作将会被警告或终止（默认为0表示警告，警告或者终止可以通过GUC参数spacequota.fullwarningtype = 0/1来配置）。

表空间限额基本语法

查询限额信息：

select * from sys_space_quota;

检查表空间的限额：

space_quota_check();

设置或更改表空间限额, 可调用 set_space_quota(oid, quota)方法，quota的单位为字节。

set_space_quota(oid, quota)

参数

oid：表空间的oid值。

quota：设置的表空间限额值。

删除表空间限额, 可调用 remove_space_quota(oid)方法。

remove_space_quota(oid)

参数

oid：表空间的oid值。

插件使用说明

测试环境：V008R006C007B0012

[](javascript:void(0)

需要创建扩展
create extension sys_spacequota;
CREATE EXTENSION

开关：创建扩展后，再开启参数开关，限额功能生效
alter system set spacequota.enable = on ;
ALTER SYSTEM

TEST=# call sys_reload_conf();
 sys_reload_conf
-----------------
 t
(1 row)

创建测试使用的限额表空间
TEST=# CREATE TABLESPACE ttspace location '/home/kingbase7/tbl_user';
CREATE TABLESPACE    

TEST=# select spcname,oid from sys_tablespace;
   spcname   |  oid
-------------+-------
 sys_default |  1663
 sys_global  |  1664
 sysaudit    |  1986
 ttspace     | 27158

设置表空间限额
TEST=# select set_space_quota(27158,100);
 set_space_quota
-----------------

(1 row)

在设置限额的表空间上创建表
TEST=# create table ttw (id int) tablespace ttspace;
CREATE TABLE

[](javascript:void(0)

1.spacequota.fullwarningtype参数默认设置为0，插入数据有警告，但是数据插入成功。

[](javascript:void(0)

TEST=# show spacequota.fullwarningtype;
 spacequota.fullwarningtype
----------------------------
 0
(1 row)

TEST=# insert into ttw select generate_series(1,10000);
WARNING:  user's disk space quota exceeded
INSERT 0 10000
TEST=#
TEST=# select count(*) from ttw;
 count
-------
 10000
(1 row)

尝试多次插入数据均有警告，但是数据插入成功了。
TEST=# insert into ttw select generate_series(1,10000);
WARNING:  user's disk space quota exceeded
INSERT 0 10000
TEST=#
TEST=# select count(*) from ttw;
 count
-------
 20000
(1 row)

TEST=# insert into ttw select generate_series(1,10000);
WARNING:  user's disk space quota exceeded
INSERT 0 10000
TEST=# select count(*) from ttw;
 count
-------
 30000
(1 row)

TEST=# insert into ttw select generate_series(1,10000);
WARNING:  user's disk space quota exceeded
INSERT 0 10000
TEST=# select count(*) from ttw;
 count
-------
 40000
(1 row)

[](javascript:void(0)

2.spacequota.fullwarningtype参数设置为1时，需要手工执行space_quota_check()检查表空间限额，如果sys_space_quota视图中current_size超出quota值，则再次插入报错，禁止插入数据

[](javascript:void(0)

TEST=# alter system set spacequota.fullwarningtype=1;
ALTER SYSTEM

TEST=# call sys_reload_conf();
 sys_reload_conf
-----------------
 t
(1 row)

查看此参数已经设置为1，1的含义不是警告，而是报错
TEST=# show spacequota.fullwarningtype;
 spacequota.fullwarningtype
----------------------------
 1s
(1 row)

检查表空间限额，判断是否full
TEST=# call space_quota_check();

可以看到is_full字段是t，表示检查限额后，系统识别表空间已满
TEST=#  select * from sys_space_quota;
 spcname | quota | current_size | is_full
---------+-------+--------------+---------
 ttspace |   100 |         8210 | t
(1 row)
检查表空间限额后，再次插入数据报错，禁止插入
TEST=# insert into ttw select generate_series(1,100);
ERROR:  user's disk space quota exceeded

truncate 表后再检查限额
TEST=# truncate  ttw;
TRUNCATE TABLE

call space_quota_check();

查看表空间限额配置,current_size空间已经释放
TEST=# select * from sys_space_quota;
 spcname | quota | current_size | is_full
---------+-------+--------------+---------
 ttspace |   120 |           30 | f
(1 row)

[](javascript:void(0)

从以下结果中我们能看出，当执行完 space_quota_check(),检查空间后，再次插入数据触发表空间限额上限，才会告警，

当spacequota.fullwarningtype设置为1后，提示error，禁止插入，数据没有插入到表中。

[](javascript:void(0)

TEST=# insert into ttw select generate_series(1,100);
INSERT 0 100
TEST=# insert into ttw select generate_series(1,100);
INSERT 0 100
插入数据库数据，查询表空间限额不变
TEST=# select * from sys_space_quota;
 spcname | quota | current_size | is_full
---------+-------+--------------+---------
 ttspace |   100 |           30 | f
(1 row)

执行检查表空间限额函数后，再次查询视图，current_size有变化
TEST=# call space_quota_check();
CALL
TEST=# select * from sys_space_quota;
 spcname | quota | current_size | is_full
---------+-------+--------------+---------
 ttspace |   100 |         8210 | t
(1 row)

此时，再次insert数据报错
TEST=# insert into ttw select generate_series(1,100);
ERROR:  user's disk space quota exceeded

[](javascript:void(0)