华为云用户手册

get_mtd_user() 描述：按照DB和User维度显示所有用户信息；多租场景下，non-PDB调用该函数时返回全部信息，PDB调用该函数时仅返回该PDB相关信息。 返回值类型：setof record 名称 类型 描述 dbid oid 数据库标识。 usename name 用户名。 usesysid oid 用户的ID。 usecreatedb boolean 用户是否可以创建数据库。 t（true）：表示是。 f（false）：表示否。 usesuper boolean 用户是否是拥有最高权限的初始系统管理员。 t（true）：表示是。 f（false）：表示否。 usecatupd boolean 用户是否可以直接更新系统表。只有usesysid=10的初始系统管理员拥有此权限。其他用户无法获得此权限。 t（true）：表示是。 f（false）：表示否。 userepl boolean 用户是否可以复制数据流。 t（true）：表示是。 f（false）：表示否。 passwd text 密文存储后的用户密码，始终为********。 valbegin timestamp with time zone 账户的有效开始时间；如果没有设置有效开始时间，则为NULL。 valuntil timestamp with time zone 账户的有效结束时间；如果没有设置有效结束时间，则为NULL。 respool name 用户所在的资源池。 parent oid 父用户OID。 spacelimit text 永久表存储空间限额，单位KB。 useconfig text 运行时配置项的默认值。参考PG_DB_ROLE_SETTING.setconfig。 nodegroup name 用户关联的逻辑数据库名称，如果该用户没有管理逻辑数据库，则该字段为空。 tempspacelimit text 临时表存储空间限额，单位KB。 spillspacelimit text 算子落盘空间限额，单位KB。 usemonitoradmin boolean 用户是否是监控管理员。 t（true）：表示是。 f（false）：表示否。 useoperatoradmin boolean 用户是否是运维管理员。 t（true）：表示是。 f（false）：表示否。 usepolicyadmin boolean 用户是否是安全策略管理员。 t（true）：表示是。 f（false）：表示否。

gs_get_pdb_tablespace_location(pdb_id oid in, tablespace_oid oid in) 描述：给定pdbid和表空间oid，返回对应的表空间路径。 入参说明： 名称 类型 输入/输出 取值范围 描述 pdb_id oid 输入 [1, 4095] PDB的id tablespace_oid oid 输入 [0, 4294967295] 表空间的oid 返回值类型：text 该函数现阶段不建议客户使用，仅供内核功能实现使用。当pdb_id入参不在范围内，会返回NULL；如果传入的pdb_id参数是其他PDB的pdbid，返回空字符串；当执行用户不是superuser/sysdba，返回空字符串；若查询的PDB下没有对应的表空间，则会报错。

gs_resplan_stat_info(view_type integer) 描述：返回当前CDB下资源计划的实时数据的统计结果，包含CPU、内存、I/O指标。可以获取包含实时数据、最近一分钟的统计数据以及每分钟的统计数据历史明细（最长一小时）。 CDB可查看所有数据，而PDB只能看本PDB范围内的数据。函数备机执行会报错。 当发生资源变更的时候，会存在used_shared_memory统计的共享缓存从0开始重新计数。随着业务运行，业务申请新的共享缓存used_shared_memory增加，统计恢复正常，期间对性能无影响。 入参说明： 名称 类型 输入/输出 取值范围 描述 view_type integer 输入 [0,1,2] 0：返回实时统计数据。 1：返回最近一次的统计数据。 2：返回最近1小时的统计数据历史。 返回值类型：setof record 名称 类型 描述 plan_name text end_time时刻正在生效的资源计划的名称。 pdb_name name 如果是CDB显示"cdb"，如果是PDB显示PDB的name。 begin_time timestamp with time zone 采集开始时间，实时统计时，返回空。 end_time timestamp with time zone 采集结束时间，实时统计时，返回now。 interval_msec integer 此条统计的间隔时间，单位是毫秒（ms）。 cpu_consumed_time bigint 此段时间内的CPU使用时间，多个核的使用时间累加，单位是毫秒（ms）。 avg_cpu_utilization double precision CPU使用率，计算公式为：cpu_consumed_time / interval_msec / CDB的CPU核数。 iops double precision 此段时间内的iops，实时统计时返回上一秒的iops，周期统计时返回周期内的iops。 used_dynamic_memory integer end_time时刻使用的动态内存，单位kB。 used_shared_memory integer end_time时刻使用的共享缓存，单位kB。 used_connections integer 当前时刻使用的连接数。 logical_decoder_used_memory integer end_time时刻逻辑解码任务使用的动态内存，单位kB。 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 gaussdb=# SELECT * FROM gs_resplan_stat_info(0); plan_name | pdb_name | begin_time | end_time | interval_msec | cpu_consumed_time | avg_cpu_utilization | iops | used_dynamic_memory | used_shared_memory | used_connections | logical_decoder_used_memory -----------------------+----------+------------+------------------------------+---------------+-------------------+---------------------+------+---------------------+--------------------+------------------+----------------------------- default_resource_plan | cdb | | 2024-11-11 18:03:05.37086+08 | | 50632 | | 0 | 8192 | 7368 | 1 | 0 (1 row) gaussdb=# SELECT * FROM gs_resplan_stat_info(1); plan_name | pdb_name | begin_time | end_time | interval_msec | cpu_consumed_time | avg_cpu_utilization | iops | used_dynamic_memory | used_shared_memory | used_connections | logical_d ecoder_used_memory -----------------------+----------+-------------------------------+-------------------------------+---------------+-------------------+---------------------+------+---------------------+--------------------+------------------+---------- ------------------- default_resource_plan | cdb | 2024-11-11 18:02:50.335556+08 | 2024-11-11 18:03:00.339938+08 | 10005 | 421 | .262993503248376 | 0 | 7168 | 7368 | 1 | 0 (1 row) gaussdb=# SELECT * FROM gs_resplan_stat_info(2); plan_name | pdb_name | begin_time | end_time | interval_msec | cpu_consumed_time | avg_cpu_utilization | iops | used_dynamic_memory | used_shared_memory | used_connections | logical_d ecoder_used_memory -----------------------+----------+-------------------------------+-------------------------------+---------------+-------------------+---------------------+------+---------------------+--------------------+------------------+---------- ------------------- default_resource_plan | cdb | 2024-11-11 17:53:00.138608+08 | 2024-11-11 17:53:10.141111+08 | 10003 | 428 | .26741977406778 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:53:10.141111+08 | 2024-11-11 17:53:20.144848+08 | 10004 | 448 | .279888044782087 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:53:20.144848+08 | 2024-11-11 17:53:30.147538+08 | 10003 | 519 | .324277716684994 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:53:30.147538+08 | 2024-11-11 17:53:40.150645+08 | 10004 | 435 | .271766293482607 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:53:40.150645+08 | 2024-11-11 17:53:50.152916+08 | 10003 | 458 | .286164150754774 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:53:50.152916+08 | 2024-11-11 17:54:00.155912+08 | 10003 | 420 | .262421273617915 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:00.155912+08 | 2024-11-11 17:54:10.159175+08 | 10004 | 419 | .261770291883247 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:10.159175+08 | 2024-11-11 17:54:20.16135+08 | 10003 | 458 | .286164150754774 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:20.16135+08 | 2024-11-11 17:54:30.163531+08 | 10003 | 520 | .324902529241228 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:30.163531+08 | 2024-11-11 17:54:40.165763+08 | 10003 | 563 | .351769469159252 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:40.165763+08 | 2024-11-11 17:54:50.168769+08 | 10004 | 421 | .263019792083167 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:54:50.168769+08 | 2024-11-11 17:55:00.171637+08 | 10003 | 458 | .286164150754774 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:00.171637+08 | 2024-11-11 17:55:10.174908+08 | 10004 | 425 | .265518792483007 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:10.174908+08 | 2024-11-11 17:55:20.179252+08 | 10005 | 428 | .267366316841579 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:20.179252+08 | 2024-11-11 17:55:30.183558+08 | 10005 | 545 | .340454772613693 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:30.183558+08 | 2024-11-11 17:55:40.18557+08 | 10003 | 436 | .272418274517645 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:40.18557+08 | 2024-11-11 17:55:50.189828+08 | 10005 | 412 | .257371314342829 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:55:50.189828+08 | 2024-11-11 17:56:00.193059+08 | 10004 | 432 | .269892043182727 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:00.193059+08 | 2024-11-11 17:56:10.195868+08 | 10003 | 504 | .314905528341498 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:10.195868+08 | 2024-11-11 17:56:20.199766+08 | 10004 | 434 | .271141543382647 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:20.199766+08 | 2024-11-11 17:56:30.203198+08 | 10004 | 514 | .321121551379448 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:30.203198+08 | 2024-11-11 17:56:40.205889+08 | 10003 | 486 | .303658902329301 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:40.205889+08 | 2024-11-11 17:56:50.207217+08 | 10002 | 425 | .265571885622875 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:56:50.207217+08 | 2024-11-11 17:57:00.210596+08 | 10004 | 417 | .260520791683327 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:00.210596+08 | 2024-11-11 17:57:10.215004+08 | 10005 | 446 | .278610694652674 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:10.215004+08 | 2024-11-11 17:57:20.219176+08 | 10005 | 418 | .26111944027986 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:20.219176+08 | 2024-11-11 17:57:30.222697+08 | 10004 | 499 | .311750299880048 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:30.222697+08 | 2024-11-11 17:57:40.226854+08 | 10005 | 439 | .27423788105947 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:40.226854+08 | 2024-11-11 17:57:50.2311+08 | 10005 | 452 | .282358820589705 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:57:50.2311+08 | 2024-11-11 17:58:00.235139+08 | 10005 | 417 | .260494752623688 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:00.235139+08 | 2024-11-11 17:58:10.235896+08 | 10001 | 424 | .264973502649735 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:10.235896+08 | 2024-11-11 17:58:20.239277+08 | 10004 | 458 | .286135545781687 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:20.239277+08 | 2024-11-11 17:58:30.242792+08 | 10004 | 510 | .318622550979608 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:30.242792+08 | 2024-11-11 17:58:40.246556+08 | 10004 | 434 | .271141543382647 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:40.246556+08 | 2024-11-11 17:58:50.249977+08 | 10004 | 449 | .280512794882047 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:58:50.249977+08 | 2024-11-11 17:59:00.253508+08 | 10004 | 430 | .268642542982807 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:00.253508+08 | 2024-11-11 17:59:10.257666+08 | 10005 | 415 | .259245377311344 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:10.257666+08 | 2024-11-11 17:59:20.261004+08 | 10004 | 424 | .264894042383047 | 0 | 5120 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:20.261004+08 | 2024-11-11 17:59:30.265189+08 | 10005 | 1267 | .791479260369815 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:30.265189+08 | 2024-11-11 17:59:40.26769+08 | 10003 | 2676 | 1.67199840047986 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:40.26769+08 | 2024-11-11 17:59:50.270465+08 | 10003 | 441 | .27554233729881 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 17:59:50.270465+08 | 2024-11-11 18:00:00.274369+08 | 10004 | 469 | .293007796881248 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:00.274369+08 | 2024-11-11 18:00:10.277781+08 | 10004 | 437 | .273015793682527 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:10.277781+08 | 2024-11-11 18:00:20.28173+08 | 10004 | 432 | .269892043182727 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:20.28173+08 | 2024-11-11 18:00:30.286008+08 | 10005 | 521 | .325462268865567 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:30.286008+08 | 2024-11-11 18:00:40.287632+08 | 10002 | 465 | .290566886622675 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:40.287632+08 | 2024-11-11 18:00:50.292495+08 | 10005 | 409 | .255497251374313 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:00:50.292495+08 | 2024-11-11 18:01:00.294311+08 | 10002 | 419 | .261822635472905 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:00.294311+08 | 2024-11-11 18:01:10.298553+08 | 10005 | 467 | .291729135432284 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:10.298553+08 | 2024-11-11 18:01:20.301856+08 | 10004 | 434 | .271141543382647 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:20.301856+08 | 2024-11-11 18:01:30.306115+08 | 10005 | 531 | .331709145427286 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:30.306115+08 | 2024-11-11 18:01:40.3094+08 | 10004 | 478 | .298630547780888 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:40.3094+08 | 2024-11-11 18:01:50.313554+08 | 10005 | 422 | .263618190904548 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:01:50.313554+08 | 2024-11-11 18:02:00.316731+08 | 10004 | 415 | .259271291483407 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:00.316731+08 | 2024-11-11 18:02:10.320966+08 | 10005 | 414 | .258620689655172 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:10.320966+08 | 2024-11-11 18:02:20.325226+08 | 10005 | 449 | .280484757621189 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:20.325226+08 | 2024-11-11 18:02:30.328873+08 | 10004 | 503 | .314249300279888 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:30.328873+08 | 2024-11-11 18:02:40.332684+08 | 10004 | 445 | .278013794482207 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:40.332684+08 | 2024-11-11 18:02:50.335556+08 | 10003 | 479 | .299285214435669 | 0 | 7168 | 7368 | 1 | 0 default_resource_plan | cdb | 2024-11-11 18:02:50.335556+08 | 2024-11-11 18:03:00.339938+08 | 10005 | 421 | .262993503248376 | 0 | 7168 | 7368 | 1 | 0 (60 rows)

gs_resplan_cgroup_info() 描述：功能等同于gs_cgroup -p，返回多租CGroup的架构与份额明细。CDB查看所有数据，PDB只能看本PDB范围内的数据。该返回在主机返回CGroup框架的CGroup（DefaultClass、DefaultBackend、Vacuum等）与PDB的Class_xxx控制组，函数备机执行会报错。 返回值类型：setof record 名称 类型 描述 cgroup_name text 控制组的名称。 shares bigint 控制组分配的CPU资源配额。 quota bigint 控制组可以使用CPU资源的最大值。 cpuset text CPU限额分配。 cpu_usage real 控制组CPU使用总时间。 relpath text 控制组的相对路径。 task_num bigint 控制组的线程数。 group_id bigint 线程组ID。 is_disable boolean 控制组是否不可用。 示例： 1 2 3 4 5 6 7 8 gaussdb=# select * FROM GS_RESPLAN_CGROUP_INFO(); cgroup_name | shares | quota | cpuset | cpu_usage | relpath | task_num | group_id | is_disable ------------------------+--------+-------+--------+-----------+--------------------------------+----------+----------+------------ Default_Class | 2048 | -1 | 0-15 | 0 | CDB:omm/Default_Class | 17 | 0 | f Backend | 12288 | -1 | 0-15 | 4.90895 | CDB:omm/Backend | 0 | 0 | f Backend/DefaultBackend | 81920 | -1 | 0-15 | 4.91018 | CDB:omm/Backend/DefaultBackend | 44 | 0 | f Backend/Vacuum | 20480 | -1 | 0-15 | 0 | CDB:omm/Backend/Vacuum | 0 | 0 | f (4 rows)

delimiter_name 参数说明：保存一个delimiter分隔符名称。 gsql客户端识别到分隔符的时候，会立即将输入的一条或多条SQL语句发送到服务端执行。该用法可以用在输入语句较多，并且语句中存在分号时，指定一个特殊的符号作为结束符。 参数类型：字符串 参数单位：无 取值范围：长度大于0的字符串。 默认值：";" 设置方式：该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。此参数只提供在gsql客户端设置，可以通过DELIMITER命令配置。 设置建议：推荐使用默认值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

用户自定义子类型 PL/SQL中使用SUBTYPE可以创建自己的子类型，其基类型可以是任何基础类型或用户自定义类型。子类型可以提供数据类型的兼容性，显示该类型数据项的预期用途，检测超出范围的值。 SUBTYPE基础定义语法： SUBTYPE subtype_name IS base_type [ { ( precision [, scale ] ) | RANGE low_value .. high_value } ] [ NOT NULL ] 参数说明： SUBTYPE：SUBTYPE关键字。 subtype_name：需要定义的SUBTYPE子类型名。 base_type：基类型，创建subtype类型所依据的基础类型或者自定义类型。 precision [, scale ]：可添加的typmod约束。 RANGE low_value .. high_value：可添加的RANGE约束。 NOT NULL：可添加的NOT NULL约束。 base_type支持基础类型，也支持自定义数据类型以及SUBTYPE类型。 如果指定了typmod约束，则对SUBTYPE类型变量进行赋值时会校验该值是否符合typmod约束，是否支持指定typmod约束与基类型保持一致。 仅int类型支持指定RANGE约束，其中包括TINYINT/SMALLINT/MEDIUMINT/INTEGER/BINARY_INTEGER/BIGINT/INT。如果指定了RANGE约束，则对SUBTYPE类型变量进行赋值时会校验该值是否在指定的范围内。 RANGE的上下限不能超过INT64。 暂不支持创建变量的时候使用RANGE约束。 嵌套SUBTYPE类型和创建SUBTYPE类型变量时更新约束情况。 如果指定了NOT NULL，则使用SUBTYPE类型定义变量时必须初始化，且不能赋NULL值。 支持使用SUBTYPE类型作为存储过程出入参类型。 支持SUBTYPE类型变量使用%type和%rowtype，其中%type支持所有基类型，%rowtype支持表、不支持集合类型。 SUBTYPE支持使用基类型的类型构造器。 不支持指定字符集。 仅A兼容模式下支持使用。 数据库从不支持SUBTYPE的版本升级到支持SUBTYPE的版本，在升级未提交状态，不支持使用SUBTYPE。 示例1：无约束子类型。 gaussdb=# DECLARE SUBTYPE sint IS INT; a sint := 2147483647; BEGIN DBE_OUTPUT.PUT_LINE('a = ' || a); END; / a = 2147483647 ANONYMOUS BLOCK EXECUTE 示例2：SUBTYPE支持typmod、RANGE和NOT NULL约束。 --typmod约束 gaussdb=# DECLARE SUBTYPE sdec IS DECIMAL(3,2) NOT NULL; a sdec := 1.1; b sdec(5,2) := 322.1; BEGIN DBE_OUTPUT.PUT_LINE('a = ' || a); DBE_OUTPUT.PUT_LINE('b = ' || b); END; / a = 1.10 b = 322.10 ANONYMOUS BLOCK EXECUTE --NOT NULL约束 gaussdb=# DECLARE SUBTYPE sint IS INT NOT NULL; a sint; BEGIN NULL; END; / ERROR: variables declared as NOT NULL must have a default value. CONTEXT: compilation of PL/pgSQL function "inline_code_block" near line 2 gaussdb=# DECLARE SUBTYPE age IS BINARY_INTEGER RANGE 0..100 NOT NULL; a age := 18; b age := 20; BEGIN DBE_OUTPUT.PUT_LINE('a的年龄为：' || a); DBE_OUTPUT.PUT_LINE('b的年龄为：' || b); END; / a的年龄为：18 b的年龄为：20 ANONYMOUS BLOCK EXECUTE 示例3：SUBTYPE嵌套自定义数据类型使用基类型类型构造器。 gaussdb=# DECLARE TYPE arrint IS VARRAY(10) OF INTEGER; SUBTYPE sarrint IS arrint; --a sarrint := sarrint(1,2,3,4);报错，仅支持基类型的类型构造器 a sarrint := arrint(1,2,3,4); BEGIN FOR i IN 1..4 LOOP DBE_OUTPUT.PUT_LINE(a(i)); END LOOP; END; / 1 2 3 4 ANONYMOUS BLOCK EXECUTE 示例4：支持SUBTYPE嵌套SUBTYPE类型，并更新约束条件。 --range约束 gaussdb=# DECLARE SUBTYPE sint IS INTEGER RANGE 10..99; SUBTYPE ssint IS sint RANGE 0..9; a sint := 50; b ssint := 5; BEGIN DBE_OUTPUT.PUT_LINE('a = ' || a); DBE_OUTPUT.PUT_LINE('b = ' || b); END; / a = 50 b = 5 ANONYMOUS BLOCK EXECUTE --typmod约束 gaussdb=# DECLARE SUBTYPE word IS VARCHAR2(5); SUBTYPE sentence IS word(50); a word := 'Tom'; b sentence := 'Tom and Jerry'; c sentence(8) := 'Mountain'; BEGIN DBE_OUTPUT.PUT_LINE('a = ' || a); DBE_OUTPUT.PUT_LINE('b = ' || b); DBE_OUTPUT.PUT_LINE('c = ' || c); END; / a = Tom b = Tom and Jerry c = Mountain ANONYMOUS BLOCK EXECUTE 示例5：支持自定义数据类型嵌套SUBTYPE类型。 gaussdb=# DECLARE SUBTYPE sint IS BINARY_INTEGER RANGE 0..99; TYPE tabint IS TABLE OF sint; a tabint := tabint(); BEGIN a.EXTEND(10); a(1) := 50; END; / ANONYMOUS BLOCK EXECUTE 父主题： 数据类型

global_streaming_hadr_rto_and_rpo_stat global_streaming_hadr_rto_and_rpo_stat视图显示流式容灾的主数据库实例和备数据库实例日志流控信息（只可在主数据库实例的主DN使用，备DN以及备数据库实例上均不可获取到统计信息），如表1所示。 表1 global_streaming_hadr_rto_and_rpo_stat参数说明 参数 类型 描述 hadr_sender_node_name text 节点的名称，包含主数据库实例和备数据库实例首备。 hadr_receiver_node_name text 备数据库实例首备名称。 current_rto int 流控的信息，当前主备数据库实例的日志rto时间（单位：秒）。-1标识灾备集群多数派异常。 target_rto int 流控的信息，目标主备数据库实例间的rto时间（单位：秒）。 current_rpo int 流控的信息，当前主备数据库实例的日志rpo时间（单位：秒）。-1标识灾备集群多数派异常。 target_rpo int 流控的信息，目标主备数据库实例间的rpo时间（单位：秒）。 rto_sleep_time int RTO流控信息，为了达到目标rto，预期主机walsender所需要的睡眠时间（单位：微秒）。 rpo_sleep_time int RPO流控信息，为了达到目标rpo，预期主机xlogInsert所需要的睡眠时间（单位：微秒）。 父主题： RTO & RPO

Hint使用准备 为了方便了解hint的使用场景，手册提供了所有查询改写hint的应用示例（请参见Hint使用说明），相关建表语句和环境准备如下： 会话设置： SET client_encoding = 'UTF8'; CREATE SCHEMA rewrite_rule_test; SET current_schema = rewrite_rule_test; SET enable_codegen= off; 建表语句： CREATE TABLE rewrite_rule_hint_t1 (a INT, b INT, c INT, d INT); CREATE TABLE rewrite_rule_hint_t2 (a INT, b INT, c INT, d INT); CREATE TABLE rewrite_rule_hint_t3 (a INT, b INT, c INT, d INT); CREATE TABLE rewrite_rule_hint_t4 (a INT NOT NULL, b INT, c INT, d INT); CREATE TABLE rewrite_rule_hint_t5 (slot INTEGER NOT NULL,cid BIGINT NOT NULL,name CHARACTER VARYING NOT NULL) WITH (ORIENTATION = row); INSERT INTO rewrite_rule_hint_t5 (slot, cid, name) values(generate_series(1, 10),generate_series(1, 10),'records.storage.state'); ANALYZE rewrite_rule_hint_t5; CREATE TABLE rewrite_rule_hint_customer ( c_custkey INTEGER NOT NULL, c_name CHARACTER VARYING(25) NOT NULL, c_address CHARACTER VARYING(40) NOT NULL, c_nationkey INTEGER NOT NULL, c_phone CHARACTER(15) NOT NULL, c_acctbal NUMERIC(15, 2) NOT NULL, c_mktsegment CHARACTER(10) NOT NULL, c_comment CHARACTER VARYING(117) NOT NULL ); CREATE TABLE rewrite_rule_hint_orders ( o_orderkey INTEGER NOT NULL, o_custkey INTEGER NOT NULL, o_orderstatus CHARACTER(1) NOT NULL, o_totalprice NUMERIC(15, 2) NOT NULL, o_orderdate DATE NOT NULL, o_orderpriority CHARACTER(15) NOT NULL, o_clerk CHARACTER(15) NOT NULL, o_shippriority INTEGER NOT NULL, o_comment CHARACTER VARYING(79) NOT NULL );

查询改写Hint列表 表1 查询改写支持的hint列表 序号 hint名称 描述 1 EXPAND_SUBLINK_HAVING 允许HAVING子句中的子链接提升。 2 NO_EXPAND_SUBLINK_HAVING 禁止HAVING子句中的子链接提升。 3 EXPAND_SUBLINK 允许对ANY/EXISTS类型子链接进行提升。 4 NO_EXPAND_SUBLINK 禁止对ANY/EXISTS类型子链接进行提升。 5 EXPAND_SUBLINK_TARGET 允许对TargetList中的子链接进行提升。 6 NO_EXPAND_SUBLINK_TARGET 禁止对TargetList中的子链接进行提升。 7 USE_MAGIC_SET 从主查询下推条件到子查询，先针对子查询的关联字段进行分组聚集，再和主查询进行关联，减少相关子链接的重复扫描，提升查询效率。 8 NO_USE_MAGIC_SET 禁止从主查询下推条件到子查询，将带有聚集算子的子查询提前和主查询进行关联。 9 EXPAND_SUBLINK_UNIQUE_CHECK 允许对无agg的子链接进行提升，子链接提升需要保证对于每个条件只有一行输出。 10 NO_EXPAND_SUBLINK_UNIQUE_CHECK 禁止对无agg的子链接进行提升。 11 NO_SUBLINK_DISABLE_REPLICATED 允许带有复制表的fast query shipping或者Stream场景的表达式子链接提升。 12 SUBLINK_DISABLE_REPLICATED 禁止带有复制表的fast query shipping或者Stream场景的表达式子链接提升。 13 NO_SUBLINK_DISABLE_EXPR 允许对表达式类型的子链接进行提升。 14 SUBLINK_DISABLE_EXPR 禁止对表达式类型的子链接进行提升。 15 ENABLE_SUBLINK_ENHANCED 允许子链接提升增强，支持对OR表达式等相关或非相关子链接提升。 16 NO_ENABLE_SUBLINK_ENHANCED 禁用子链接提升增强，禁止对OR表达式等相关或非相关子链接提升。 17 PARTIAL_PUSH Stream场景支持对listagg和arrayagg添加gather算子。 18 NO_PARTIAL_PUSH Stream场景禁止对listagg和arrayagg添加gather算子。 19 REDUCE_ORDER_BY 消减冗余的ORDER BY，外层查询对内层查询结果无排序要求时，可以减少不必要的ORDER BY提升查询效率。 20 NO_REDUCE_ORDER_BY 禁止消减不必要的ORDER BY。 21 REMOVE_NOT_NULL 消减不必要的NOT NULL条件，当列属性为NOT NULL时，可以消减查询条件中的IS NOT NULL判断。 22 NO_REMOVE_NOT_NULL 禁止消减IS NOT NULL条件判断。 23 LAZY_AGG 子查询与外层查询存在同样的GROUP BY条件，两层聚集运算可能导致查询效率低下，消除子查询中的聚集运算，以此提高查询效率。 24 NO_LAZY_AGG 禁用消除子查询中的聚集运算规则。 25 EXPAND_SUBQUERY 子查询提升，将子查询提升与上层做JOIN连接，优化查询效率。 26 NO_EXPAND_SUBQUERY 禁用子查询提升。 27 PUSHDOWN_HAVING 下推HAVING条件表达式。 28 NO_PUSHDOWN_HAVING 禁止下推HAVING表达式。 29 INLIST_TO_JOIN 控制使用inlist-to-join对SQL进行改写。 30 NO_INLIST_TO_JOIN 控制禁止使用inlist-to-join对SQL进行改写。 31 ROWNUM_PUSHDOWN 允许行号下推。 32 NO_ROWNUM_PUSHDOWN 禁止行号下推。 33 WINDOWAGG_PUSHDOWN 允许父查询中窗口函数的过滤条件下推到子查询。 34 NO_WINDOWAGG_PUSHDOWN 禁止父查询中窗口函数的过滤条件下推到子查询。 35 CS E_REWRITE_OPT 允许使用公共子表达式CSE查询重写将having公共子查询重写为窗口聚集函数。 36 NO_CSE_REWRITE_OPT 禁止使用公共子表达式CSE查询重写将having公共子查询重写为窗口聚集函数。 37 GROUPBY_PUSHDOWN_SUBQUERY 允许使用groupby-pushdown-subquery查询重写将groupby聚集函数下推到子查询。 38 NO_GROUPBY_PUSHDOWN_SUBQUERY 禁止使用groupby-pushdown-subquery查询重写将groupby聚集函数下推到子查询。

功能描述 优化器支持一系列查询改写规则，可以对SQL语句进行等价的逻辑改写，从而生成更好的执行计划。但在一些场景下，用户并不希望改写SQL语句、或者优化器的改写会导致计划跳变，对于这些特定的场景，需要能够使用hint对改写规则进行控制，让优化器按照特定的方式进行改写。目前数据库支持对ANY/EXISTS的子链接、简单子查询、消减ORDER BY、HAVING子句下推、延迟聚合等多种场景的SQL进行hint控制，具体请参见：Hint使用说明。 部分查询改写规则同时受查询改写的hint和GUC参数控制，通常查询改写的hint优先级高于GUC参数控制，涉及到受GUC参数控制的改写规则会在Hint使用说明相关章节进行描述。 每条查询改写规则受一对互斥的hint控制，如：子查询展开的规则同时受EXPAND_SUBQUERY和NO_EXPAND_SUBQUERY控制，其中，EXPAND_SUBQUERY Hint表示允许应用该规则对SQL进行改写，NO_EXPAND_SUBQUERY表示禁止使用该规则对SQL进行改写。且当同一个查询块（queryblock）中同时存在两个互斥的hint时，以获取的首个hint为准，例如：/*+ EXPAND_SUBQUERY NO_EXPAND_SUBQUERY */，则EXPAND_SUBQUERY Hint生效。 查询改写的hint允许重复，但对于重复的hint数据库只会使用第一个，对于其他未使用的hint则会报"unused hint" Warning提示。例如：/*+ EXPAND_SUBLINK EXPAND_SUBLINK */，由于数据库只使用第一个EXPAND_SUBLINK hint，所以仍然会报"unused hint" Warning提示。

cluster_name 参数说明：标识当前数据库实例的实例名称。 数据库实例名称cluster_name不可设置为“invalid_cluster_uuid”。 参数类型：字符串 参数单位：无 取值范围：合法的实例名称。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：该参数在容灾流程使用，容灾数据库实例依赖该参数进行数据库实例识别，用户可读，不建议用户修改。 设置不当的风险与影响：手动修改可能造成容灾功能异常。

hadr_primary_cluster_name 参数说明：标识容灾中当前主数据库实例的实例名称。用于1个主数据库实例连接两个备数据库实例的异地流式容灾部署下的主数据库实例识别。 当流式容灾备数据库实例的首备的hadr_primary_cluster_name配置为“invalid_cluster_uuid”时，将不再启动与主数据库实例的日志同步，备数据库实例将持续处于断连状态。 参数类型：字符串 参数单位：无 取值范围：合法的实例名称。 默认值："" 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：容灾数据库实例的识别参数，容灾流程使用，用户可读，不建议用户修改。 设置不当的风险与影响：手动修改可能造成容灾功能异常。

enable_roach_standby_cluster 参数说明：设置双数据库实例中备数据库实例的各个实例是否为只读模式，仅sysadmin用户可以访问。 参数类型：布尔型 参数单位：无 取值范围： on：表示备数据库实例开启只读模式。 off：表示备数据库实例关闭只读模式。此情况下，备数据库实例可读可写。 默认值：off 设置方式：该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。 设置建议：备份恢复使用，不建议用户修改。 设置不当的风险与影响：修改该参数取值可能导致数据库出现意料之外的结果，请保持默认值。

RepOriginId 参数说明：该参数是一个会话级别的GUC参数，在双向逻辑复制的场景下，为避免数据循环复制，需要设置为一个非0的值。 参数类型：整型 参数单位：无 取值范围：0 ~ 2147483647‬ 默认值：0 设置方式：该参数属于USERSET类型参数，请参考表2中的方式三进行设置。 设置建议：在双向逻辑复制的场景下，需要设置为一个非0的值。 设置不当的风险与影响：请在充分理解参数含义，并经过测试验证后进行修改。

stream_cluster_run_mode 参数说明：流式容灾双实例容灾场景，标识DN节点属于主实例还是备实例。 参数类型：枚举类型 参数单位：无 取值范围： cluster_primary：表示节点是主实例的节点。 cluster_standby：表示节点是备实例的节点。 默认值：cluster_primary 设置方式：该参数属于POSTMASTER类型参数，请参考表表1中对应设置方法进行设置。 设置建议：此参数为容灾实例的状态参数，内部流程使用，用户可读，不建议用户修改。 设置不当的风险与影响：手动修改会造成灾备数据库实例异常。

hadr_process_type 参数说明：基于流式复制异地容灾解决方案、同城双中心高可用方案或者同城双中心高可用支持基于流式复制异地容灾解决方案中的流程标识。 参数类型：枚举类型 参数单位：无 取值范围： none：表示当前无流程。 failover：表示当前处于灾备数据库实例升主流程。 switchover_promote：表示基于流式复制异地容灾解决方案主备数据库实例倒换流程中灾备数据库实例升主流程。 switchover_demote：表示基于流式复制异地容灾解决方案主备数据库实例倒换流程中主数据库实例降为灾备数据库实例流程。 dorado_failover：表示同城双中心高可用方案灾备数据库实例升主流程。 dorado_switchover_demote：表示同城双中心高可用方案主备数据库实例倒换流程中主数据库实例降为灾备数据库实例流程。 dorado_failover_abnormal：表示同城双中心高可用方案主数据库实例共享盘故障时，灾备数据库实例升主流程。 dorado_failover_in_standby_stream：表示同城双中心高可用支持基于流式复制异地容灾解决方案中异地数据库实例为异地容灾主数据库实例时，同城双中心备数据库实例升为同城双中心主数据库实例（同时为异地容灾-灾备数据库实例）流程。 dorado_failover_abnormal_in_standby_stream：表示同城双中心高可用支持基于流式复制异地容灾解决方案中异地数据库实例为异地容灾主数据库实例且同城双中心主数据库实例（同时为异地容灾-灾备数据库实例）共享盘故障时，同城双中心备数据库实例升为同城双中心主数据库实例（同时为异地容灾-灾备数据库实例）流程。 hadr_process_recovery_pause：表示投产模式下备数据库实例进入投产模式后暂停回放的状态，仅投产模式下适用。 hadr_process_force_truncate：表示投产失败时，灾备数据库实例日志TRUNCATE时的状态，仅投产失败升主场景下适用，此时备数据库实例日志仍处于不回放状态。 默认值：none 设置方式：该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。 设置建议：此参数为容灾数据库实例的状态参数，内部流程使用，用户可读，不建议用户修改。 设置不当的风险与影响：手动修改会造成灾备数据库实例异常。

示例 --设置如下参数： SET ddl_invalid_mode='invalid'; SET CREATE TYPE type1 AS (f1 int, f2 text); CREATE TYPE CREATE OR REPLACE FUNCTION func1(var type1) RETURN varchar IS BEGIN RETURN NULL; END; / CREATE FUNCTION SELECT proname,valid FROM pg_object obj JOIN pg_proc proc ON obj.object_oid = proc.oid AND proname = 'func1' AND propackageid = 0; proname | valid ---------+------- func1 | t (1 row) DROP TYPE type1; DROP TYPE -- 查询状态。 SELECT proname,valid FROM pg_object obj JOIN pg_proc proc ON obj.object_oid = proc.oid AND proname = 'func1' AND propackageid = 0; proname | valid ---------+------- func1 | f (1 row) -- 函数未被删除，函数依然存在。 SELECT proname FROM pg_proc WHERE proname = 'func1' AND propackageid = 0; proname --------- func1 (1 row) -- 删除已创建的对象。 DROP FUNCTION func1; DROP FUNCTION

ADM_SEGMENTS ADM_SEGMENTS视图显示数据库中所有段分配的存储空间。同时存在于PG_CATA LOG 和SYS Schema下。仅系统管理员可访问。Astore支持段页式，但信息无法通过系统表获取。 表1 ADM_SEGMENTS字段 名称 类型 描述 owner character varying(128) 暂不支持，值为NULL。 segment_name character varying(128) 暂不支持，值为NULL。 partition_name character varying(128) 暂不支持，值为NULL。 segment_type character varying(18) 暂不支持，值为NULL。 segment_subtype character varying(10) 暂不支持，值为NULL。 tablespace_name character varying(30) 暂不支持，值为NULL。 header_file numeric 暂不支持，值为NULL。 header_block numeric 暂不支持，值为NULL。 bytes numeric 暂不支持，值为NULL。 blocks numeric 暂不支持，值为NULL。 extents numeric 暂不支持，值为NULL。 initial_extent numeric 暂不支持，值为NULL。 next_extent numeric 暂不支持，值为NULL。 min_extents numeric 暂不支持，值为NULL。 max_extents numeric 暂不支持，值为NULL。 max_size numeric 暂不支持，值为NULL。 retention character varying(7) 暂不支持，值为NULL。 minretention numeric 暂不支持，值为NULL。 pct_increase numeric 暂不支持，值为NULL。 freelists numeric 暂不支持，值为NULL。 freelist_groups numeric 暂不支持，值为NULL。 relative_fno numeric 暂不支持，值为NULL。 buffer_pool character varying(7) 暂不支持，值为NULL。 flash_cache character varying(7) 暂不支持，值为NULL。 cell_flash_cache character varying(7) 暂不支持，值为NULL。 inmemory character varying(8) 暂不支持，值为NULL。 inmemory_priority character varying(8) 暂不支持，值为NULL。 inmemory_distribute character varying(15) 暂不支持，值为NULL。 inmemory_duplicate character varying(13) 暂不支持，值为NULL。 inmemory_compression character varying(17) 暂不支持，值为NULL。 cellmemory character varying(24) 暂不支持，值为NULL。 父主题： 其他系统视图

GS_TOTAL_MEMORY_DETAIL GS_TOTAL_MEMORY_DETAIL视图显示当前数据库节点的内存使用情况，单位为MB。当GUC参数enable_memory_limit的值为off时，本视图不可用。在多租场景下，在PDB下返回空。 表1 GS_TOTAL_MEMORY_DETAIL字段 名称 类型 描述 nodename text 节点名称。 memorytype text 内存类型，包括以下几种： max_process_memory： GaussDB 实例所占用的内存大小。 process_used_memory：GaussDB进程所使用的内存大小。 max_dynamic_memory：最大动态内存。 dynamic_used_memory：已使用的动态内存。 dynamic_peak_memory：内存的动态峰值。 dynamic_used_shrctx：最大动态共享内存上下文。 dynamic_peak_shrctx：共享内存上下文的动态峰值。 max_backend_memory：使用HA端口执行业务可使用的最大内存上限。 backend_used_memory：使用HA端口执行业务已使用的内存。 max_shared_memory：最大共享内存。 shared_used_memory：已使用的共享内存。 max_sctpcomm_memory：通信库所允许使用的最大内存。 sctpcomm_used_memory：通信库已使用的内存大小。 sctpcomm_peak_memory：通信库的内存峰值。 other_used_memory：其他已使用的内存大小。 llvm_used_memory：当前系统中 Codegen 执行生成的且查询未释放的表达式 IR 所占用内存大小。 memorymbytes integer 内存类型分配内存的大小。 父主题： 其他系统视图

简单查询 简单查询是指从一个或多个表或视图中检索一个或多个列数据的操作。 以下示例作为一个典型的简单查询，展示在指定的表中查询部分信息和全部信息的操作。 --建表并插入数据。 gaussdb=# CREATE TABLE student( sid INT PRIMARY KEY, class INT, name VARCHAR(50), sex INT CHECK(sex = 0 OR sex = 1) --性别，1为男，0为女 ); gaussdb=# INSERT INTO student (sid, class, name, sex) VALUES (1, 1, 'michael', 0); gaussdb=# INSERT INTO student (sid, class, name, sex) VALUES (2, 2, 'bob', 1); gaussdb=# INSERT INTO student (sid, class, name, sex) VALUES (3, 2, 'gary', 0); --查询部分列。 gaussdb=# SELECT sid, name FROM student; sid | name -----+--------- 1 | michael 2 | bob 3 | gary (3 rows) --查询所有列。 gaussdb=# SELECT * FROM student; sid | class | name | sex -----+-------+---------+----- 1 | 1 | michael | 0 2 | 2 | bob | 1 3 | 2 | gary | 0 (3 rows) --给列取别名。 gaussdb=# SELECT sid student_id, name FROM student; student_id | name ------------+--------- 1 | michael 2 | bob 3 | gary (3 rows) --删除。 gaussdb=# DROP TABLE student; 父主题： SELECT

参数说明 role_name 现有角色名。 取值范围：已存在的角色名，如果角色名中包含大写字母则需要使用双引号括起来。 IN DATABASE database_name 表示修改角色在指定数据库上的参数。 SET configuration_parameter {{ TO | = } { value | DEFAULT } | FROM CURRENT} 设置角色的参数。ALTER ROLE中修改的会话参数只针对指定的角色，且在下一次该角色启动的会话中有效。 取值范围： configuration_parameter和value的取值请参见SET。 DEFAULT：表示清除configuration_parameter参数的值，configuration_parameter参数的值将继承本角色新产生的SESSION的默认值。 FROM CURRENT：取当前会话中的值设置为configuration_parameter参数的值。 RESET {configuration_parameter|ALL} 清除configuration_parameter参数的值。与SET configuration_parameter TO DEFAULT的效果相同。 取值范围：ALL表示清除所有参数的值。 ACCOUNT LOCK | ACCOUNT UNLOCK ACCOUNT LOCK：锁定账户，禁止登录数据库。 ACCOUNT UNLOCK：解锁账户，允许登录数据库。 PGUSER 当前版本不允许修改角色的PGUSER属性。 {PASSWORD|IDENTIFIED BY} 'password' 重置或修改用户密码。除了初始用户外其他管理员或普通用户修改自己的密码需要输入正确的旧密码。只有初始用户、三权分立关闭时的系统管理员（sysadmin）或拥有创建用户（CREATEROLE）权限的用户才可以重置普通用户密码，无需输入旧密码。初始用户可以重置系统管理员的密码，系统管理员不允许重置其他系统管理员的密码。应当使用单引号将用户密码括起来。 EXPIRED 设置密码失效。只有初始用户、系统管理员（sysadmin）或拥有创建用户（CREATEROLE）权限的用户才可以设置用户密码失效，其中系统管理员只有在三权分立关闭时，才可以设置自己或其他系统管理员密码失效。不允许设置初始用户密码失效。 密码失效的用户可以登录数据库但不能执行查询操作，只有修改密码或由管理员重置密码后才可以恢复正常查询操作。 其他参数请参见CREATE ROLE的参数说明。

语法格式 修改角色的权限。 ALTER ROLE role_name [ [ WITH ] option [ ... ] ]; 其中权限项子句option为： {CREATEDB | NOCREATEDB} | {CREATEROLE | NOCREATEROLE} | {INHERIT | NOINHERIT} | {AUDITADMIN | NOAUDITADMIN} | {SYSADMIN | NOSYSADMIN} | {MONADMIN | NOMONADMIN} | {OPRADMIN | NOOPRADMIN} | {POLADMIN | NOPOLADMIN} | {USEFT | NOUSEFT} | {LOGIN | NOLOGIN} | {REPLICATION | NOREPLICATION} | {PERSISTENCE | NOPERSISTENCE} | CONNECTION LIMIT connlimit | [ ENCRYPTED | UNENCRYPTED ] PASSWORD { 'password' [EXPIRED] | DISABLE | EXPIRED } | [ ENCRYPTED | UNENCRYPTED ] IDENTIFIED BY { 'password' [ REPLACE 'old_password' | EXPIRED ] | DISABLE } | VALID BEGIN 'timestamp' | VALID UNTIL 'timestamp' | RESOURCE POOL 'respool' | USER GROUP 'groupuser' | PERM SPACE 'spacelimit' | TEMP SPACE 'tmpspacelimit' | SPILL SPACE 'spillspacelimit' | NODE GROUP logic_cluster_name | ACCOUNT { LOCK | UNLOCK } | PGUSER 修改角色的名称。 ALTER ROLE role_name RENAME TO new_name; 锁定或解锁。 ALTER ROLE role_name ACCOUNT { LOCK | UNLOCK }; 设置角色的配置参数。 ALTER ROLE role_name [ IN DATABASE database_name ] SET configuration_parameter {{ TO | = } { value | DEFAULT } | FROM CURRENT}; 重置角色的配置参数。 ALTER ROLE role_name [ IN DATABASE database_name ] RESET {configuration_parameter|ALL};

示例 --创建角色test_role。 gaussdb=# CREATE ROLE test_role PASSWORD '********'; --设置角色test_role可以登录数据库。 gaussdb=# ALTER ROLE test_role WITH LOGIN; --创建数据库。 gaussdb=# CREATE DATABASE testdb1; --设置角色配置参数configuration_parameter为DEFAULT。 gaussdb=# ALTER ROLE test_role IN DATABASE testdb1 SET configuration_parameter = DEFAULT; --重置角色配置参数。 gaussdb=# ALTER ROLE test_role IN DATABASE testdb1 RESET configuration_parameter; --锁定角色test_role。 gaussdb=# ALTER ROLE test_role ACCOUNT LOCK; --给锁定锁定的角色解锁。 gaussdb=# ALTER ROLE test_role ACCOUNT UNLOCK; --修改角色test_role密码。 gaussdb=# ALTER ROLE test_role PASSWORD '********'; --将角色test_role重命名为test_role2。 gaussdb=# ALTER ROLE test_role RENAME TO test_role2; --修改角色test_role2为系统管理员。 gaussdb=# ALTER ROLE test_role2 SYSADMIN; --删除。 gaussdb=# DROP ROLE test_role2; gaussdb=# DROP DATABASE testdb1;

GS_SEG_EXTENTS GS_SEG_EXTENTS查看所有表空间的扩展信息。该视图输出用户段对象的所有扩展，包含1号文件中的segment head、fork head、level1 page，2~5号文件中的data extent。只支持管理员权限用户查询。 表1 GS_SEG_EXTENTS字段 名称 类型 描述 node_name text 节点名称。 tablespace_name name 段对象所属的表空间。 bucketnode integer 0~1023表示hashbucket表的bucketnode。 1024表示段页式普通表的bucketnode。 1025表示段页式全局临时表的bucketnode。 1026表示段页式unlogged表的bucketnode。 1027表示段页式本地临时表的bucketnode。 head_block_id bigint 段头页面号。 extent_id integer 逻辑扩展号。 file_id integer 扩展所在的数据文件标识。取值范围：[1,5]的int4值。 forknum integer 段对象的分支类型。取值范围： 0表示main fork。 1表示fsm fork。 2表示vm fork。 block_id bigint 扩展所在的数据文件中的起始页面号。 blocks integer 扩展大小。取值范围：1、8、128、1024、4096。 usage_type text 扩展的使用类型。取值范围： segment head表示段头。 fork head表示分支头。 level1 page表示level页面。 data extent表示数据扩展。 父主题： 段页式存储

FILE_IOSTAT 通过对数据文件I/O的统计，反映数据的I/O性能，用以发现I/O操作异常等性能问题，如表1所示。多租场景下，non-PDB访问该视图时返回全部信息，PDB访问该视图时仅返回该PDB相关信息。在PDB中通过该视图查询到的I/O统计信息是未持久化的，数据库重启后清零。 表1 FILE_IOSTAT字段 名称 类型 描述 filenum oid 文件标识。 dbid oid 数据库标识。 spcid oid 表空间标识。 phyrds bigint 读物理文件的数目。 phywrts bigint 写物理文件的数目。 phyblkrd bigint 读物理文件块的数目。 phyblkwrt bigint 写物理文件块的数目。 readtim bigint 读文件的总时长（单位：微秒）。 writetim bigint 写文件的总时长（单位：微秒）。 avgiotim bigint 读写文件的平均时长（单位：微秒）。 lstiotim bigint 最后一次读文件时长（单位：微秒）。 miniotim bigint 读写文件的最小时长（单位：微秒）。 maxiowtm bigint 读写文件的最大时长（单位：微秒）。 父主题： File

GS_DB_LINKS GS_DB_LINKS系统视图显示DATABASE LINK对象的相关信息，用户可以查看属于自己和PUBLIC级别的DATABASE LINK信息。 表1 GS_DB_LINKS字段 名称 类型 描述 dblinkid oid 当前DATABASE LINK对象的OID。 dlname name 当前DATABASE LINK对象的名称。 dlowner oid 当前DATABASE LINK对象拥有者的ID。对象拥有者为public时值为0。 dlownername name 当前DATABASE LINK对象拥有者的名称。 options text[] 当前DATABASE LINK对象的连接信息，使用“keyword=value”格式的字符串。 useroptions text 当前DATABASE LINK对象连接的远端用户信息。 heterogeneous text 暂不支持，值为NULL。 protocol text 暂不支持，值为NULL。 opencursors text 暂不支持，值为NULL。 intransaction boolean 当前DATABASE LINK对象是否在事务中。 updatasent boolean 当前DATABASE LINK对象是否使用了更新数据的语句。 父主题： DATABASE LINK

GS_COLUMN_KEYS_ARGS GS_COLUMN_KEYS_ARGS系统表记录密态等值特性中，客户端加密主密钥相关元数据信息，每条记录对应客户端加密主密钥的一个键值对信息。 表1 GS_COLUMN_KEYS_ARGS字段 名称 类型 描述 oid oid 行标识符（隐含字段）。 column_key_id oid 列加密密钥（cek）oid。 function_name name 值为encryption。 key name 列加密密钥（cek）的元数据信息对应的名称。 value bytea 列加密密钥（cek）的元数据信息名称的值。 父主题： 密态等值查询

SUMMARY_STAT_SYS_TABLES 显示数据库各节点pg_catalog、information_schema以及pg_toast模式下所有系统表的状态信息的汇总求和结果（对每个节点下系统表的状态信息汇总求和，其中timestamp类型字段不进行求和，仅取所有节点该字段的最新值），如表1所示。 表1 SUMMARY_STAT_SYS_TABLES字段 名称 类型 描述 schemaname name 此表所在的Schema名。 relname name 表名。 seq_scan numeric 此表发起的顺序扫描数。 seq_tup_read numeric 顺序扫描抓取的活跃行数。 idx_scan numeric 此表发起的索引扫描数。 idx_tup_fetch numeric 索引扫描抓取的活跃行数。 n_tup_ins numeric 插入行数。 n_tup_upd numeric 更新行数。 n_tup_del numeric 删除行数。 n_tup_hot_upd numeric HOT更新行数（即没有更新索引列的行数）。 n_live_tup numeric 估计活跃行数。 n_dead_tup numeric 估计不活跃行数。在Ustore表中仅代表不活跃行指针数量。 last_vacuum timestamp with time zone 最后一次此表是手动清理的（不计算VACUUM FULL）时间。 last_autovacuum timestamp with time zone 上次被autovacuum守护线程清理的时间。 last_analyze timestamp with time zone 上次手动分析这个表的时间。 last_autoanalyze timestamp with time zone 上次被autovacuum守护线程分析的时间。 vacuum_count numeric 这个表被手动清理的次数（不计算VACUUM FULL）。 autovacuum_count numeric 这个表被autovacuum清理的次数。 analyze_count numeric 这个表被手动分析的次数。 autoanalyze_count numeric 这个表被autovacuum守护线程分析的次数。 父主题： Object

返回值 PQresultStatus：命令执行结果的枚举，包括： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 PQresultStatus可以返回下面数值之一： PGRES_EMPTY_QUERY 发送给服务器的字串是空的。 PGRES_COMMAND_OK 成功完成一个不返回数据的命令。 PGRES_TUPLES_OK 成功执行一个返回数据的查询（比如SELECT或者SHOW）。 PGRES_COPY_OUT （从服务器）Copy Out （复制出）数据传输开始。 PGRES_COPY_IN Copy In（复制入）（到服务器）数据传输开始。 PGRES_BAD_RESPONSE 服务器的响应无法理解。 PGRES_NONFATAL_ERROR 发生了一个非致命错误（通知或者警告）。 PGRES_FATAL_ERROR 发生了一个致命错误。 PGRES_COPY_BOTH 复制入/出（到和从服务器）数据传输开始。这个特性当前只用于流复制， 所以这个状态不会在普通应用中发生。 PGRES_SINGLE_TUPLE PGresult包含一个来自当前命令的结果元组。 这个状态只在查询选择了单行模式时发生。

DB_TAB_PARTITIONS DB_TAB_PARTITIONS视图显示当前用户所能访问的一级分区信息（包括二级分区表）。所有用户都可以访问。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 DB_TAB_PARTITIONS字段 名称 类型 描述 table_owner character varying(64) 表的所有者。 table_name character varying(64) 关系表名称。 partition_name character varying(64) 分区名称。 high_value text 分区的边界值。 对于范围分区和间隔分区，显示各分区的上边界值。 对于列表分区，显示各分区的取值列表。 对于哈希分区，显示各分区的编号。 tablespace_name name 分区表的表空间名称。 schema character varying(64) 名称空间的名称。 subpartition_count bigint 二级分区的个数。 high_value_length integer 分区边界值表达式的长度。 composite character varying(3) 表是否为二级分区表。 partition_position numeric 分区在表中的位置。 pct_free numeric 块中可用空间的最小百分比。 pct_used numeric 暂不支持，值为NULL。 ini_trans numeric 初始事务数，默认值为4，非USTORE分区表时为NULL。 max_trans numeric 最大事务数，默认值为128，非USTORE分区表时为NULL。 initial_extent numeric 暂不支持，值为NULL。 next_extent numeric 暂不支持，值为NULL。 min_extent numeric 暂不支持，值为NULL。 max_extent numeric 暂不支持，值为NULL。 max_size numeric 暂不支持，值为NULL。 pct_increase numeric 暂不支持，值为NULL。 freelists numeric 暂不支持，值为NULL。 freelist_groups numeric 暂不支持，值为NULL。 logging character varying(7) 是否记录对表的更改。 compression character varying(8) 表分区的实际压缩属性。 compress_for character varying(30) 暂不支持，值为NULL。 num_rows numeric 分区中的行数。 blocks numeric 暂不支持，值为NULL。 empty_blocks numeric 暂不支持，值为NULL。 avg_space numeric 暂不支持，值为NULL。 chain_cnt numeric 暂不支持，值为NULL。 avg_row_len numeric 暂不支持，值为NULL。 sample_size numeric 暂不支持，值为NULL。 last_analyzed timestamp with time zone 最近分析此分区的日期。 buffer_pool character varying(7) 用于分区块的缓冲池。 flash_cache character varying(7) 暂不支持，值为NULL。 cell_flash_cache character varying(7) 暂不支持，值为NULL。 global_stats character varying(3) 暂不支持，值为NULL。 user_stats character varying(3) 暂不支持，值为NULL。 is_nested character varying(3) 这是否是嵌套表分区。 parent_table_partition character varying(128) 暂不支持，值为NULL。 interval character varying(3) 分区是否在间隔分区表的间隔节中。 segment_created character varying(4) 表分区是否创建了段。 indexing character varying(4) 暂不支持，值为NULL。 read_only character varying(4) 暂不支持，值为NULL。 inmemory character varying(8) 暂不支持，值为NULL。 inmemory_priority character varying(8) 暂不支持，值为NULL。 inmemory_distribute character varying(15) 暂不支持，值为NULL。 inmemory_compression character varying(17) 暂不支持，值为NULL。 inmemory_duplicate character varying(13) 暂不支持，值为NULL。 cellmemory character varying(24) 暂不支持，值为NULL。 inmemory_service character varying(12) 暂不支持，值为NULL。 inmemory_service_name character varying(100) 暂不支持，值为NULL。 memoptimize_read character varying(8) 暂不支持，值为NULL。 memoptimize_write character varying(8) 暂不支持，值为NULL。 父主题： 分区表