1、用户空间管控简介

    在语句运行过程中，需要使用到资源有计算资源cpu和网络，存储资源磁盘空间，网络资源等，在集群中同时有多个用户同时运行作业，如果其中有个用户的作业将使用大量的cpu和内存资源，那么这部分语句运行起来后，其他作业将不能再运行，甚至导致集群不可用。因此资源管理引入了用户空间管控，GaussDB(DWS)通过在创建用户时指定存储空间的大小实现对存储资源的管理，包括指定：永久表存储空间（PREM SPACE）、临时表存储空间（TEMP SPACE）及算子落盘空间（SPILL SPACE）。

2、用户空间管控模型

    GaussDB for DWS 用两层用户架构组织租户。一个父租户下有多个子租户，一个子租户只能属于一个父租户。我们通过给父租户分配资源配额，同时限定附属于该父租户的子租户的资源使用。其中，子租户也可以分配父租户分配到的资源。 主要涉及的资源有以下几种：1）计算资源：CPU资源、内存资源。2）存储资源：磁盘空间。

用户的双层模型与资源池的双层模型的对应关系：

    组资源池支持划分成多个业务资源池，提供了更为灵活的资源隔离策略，支持细粒度的资源划分方案。实际应用过程中，为了便于理解，将模型进行了简化：默认情况下组资源池与业务资源池是一对一的关系，且只对用户展示业务资源池。综上，DWS支持双层用户模型，可选择性的控制单一用户或一类用户的空间使用，客户可以总和业务场景选择行使用双层用户模型，功能示例：

# 创建class与workload控制组
gs_ssh -c "gs_cgroup -c -S classg -N v3_logic_write"
gs_ssh -c "gs_cgroup -c -S classg -G wg1 -N v3_logic_write"

# 创建组资源池和业务资源池
create resource pool poolg with (control_group='classg',nodegroup='v3_logic_write',mem_percent=50);
create resource pool poolg1 with (control_group='classg:wg1',nodegroup='v3_logic_write',mem_percent=50);

# 创建组用户和业务用户
create user userg with resource pool 'poolg' password 'Gauss_234'  node group v3_logic_write;
create user userg1 with resource pool 'poolg1' password 'Gauss_234' user group 'userg'  node group v3_logic_write;

    通常来说，对于单个部门的用户而言，自己的数据需要自己创建记录。此时，将用户关联到业务资源池后，进行创建表的操作即可，此时用户拥有自己创建表的增删改全部操作权限。然而，当用户需要访问其他部门的作业时，我们需要其他部门的管理员对该用户进行赋权操作。

    当我们需要普通用户访问某个表时，可使用grant语法对用户赋权限或者收回权限，该操作需要拥有sysadmin权限的用户进行，举个例子，user_1是A部门员工，lineitem是B部门建的表，此时user_1需要跨部门访问lineitem表。此时可使用下面语句对user_1进行赋权操作。

# 将public表空间下的lineitem表的查询权限赋给user_1：
grant select on public.lineitem to user_1;
# 回收user_1的public表空间下的lineitem表的查询权限：
Revoke select on public.lineitem from user_1;

    注意：用户资源监控是基于用户操作来的，但是由于用户可访问非自己创建的表，所以，用户资源监控在数据统计时，表空间的增加会累计到表的创建者上，而用户对表操作时的语句执行信息，比如算子下盘量，临时空间占用等信息会累计到表的操作者身上。

    查询用户信息常用视图：

select * from pg_user;     # PG_USER视图提供了访问数据库用户的信息
select * from pg_authid;   # PG_AUTHID系统表存储有关数据库认证标识符（角色）的信息。角色把“用户”的概念包含在内。
select * from pg_roles;    # PG_ROLES视图提供访问数据库角色的相关信息

3、相关guc参数与视图

    用户空间管控的相关GUC参数如下所示：

如果用户无需关注用户和资源池历史资源监控信息，可关闭参数：
gs_guc reload -Z coordinator -Z datanode -N all -I all -c "enable_user_metric_persistent=off"
gs_guc reload -Z coordinator -Z datanode -N all -I all -c "user_metric_retention_time=0"

4、用户空间效果演示

    首先对三类空间类型进行介绍：①永久表：该表在pg_class中的relpersistence字段为p。②临时表：改表在pg_class中的relpersistence字段为t。③临时文件：语句执行过程中的结果集下盘文件。

# 修改用户“userg1”永久表空间限额为10M
ALTER USER userg1  PERM SPACE '10M';
# 修改用户“userg1”临时表空间限额为10M
ALTER USER userg1  TEMP SPACE '10M';
# 修改用户“userg1”算子落盘空间限额为10M
ALTER USER userg1  SPILL SPACE '10M';

 注意在管控面设置的用户空间属于总空间，单dn的空间管控需要除以dnNum

 永久表空间超限：

  临时表空间超限：

  算子下盘空间超限：

其他用户空间管控常用语句：

业务用户空间查询：
select username,used_space,total_space,used_temp_space,used_spill_space,total_spill_space from pg_total_user_resource_info;
组用户空间查询:
select rolname,used_space,total_space,used_temp_space,total_temp_space,used_spill_space,total_spill_space from pg_total_user_resource_info_oid left join pg_authid on userid=pg_authid.oid where rolrespool='poolg';
用户空间校准：
select pgxc_wlm_readjust_relfilenode_size_table(4);

5、参考文献

GaussDB(DWS) 监控工具指南【汇总版】-云社区-华为云 (huaweicloud.com)

GaussDB(DWS)的用户监控视图-云社区-华为云 (huaweicloud.com)