GS_INSTR_UNIQUE_SQL视图 GS_INSTR_UNIQUE_SQL视图显示当前节点收集的Unique SQL的执行信息，主要包括以下内容： Unique SQL ID以及归一化后的SQL文本字符串，归一化后的SQL文本如示例中所示。通常对于DML语句，在计算Unique SQL ID的过程中会忽略常量值。但对于DDL、DCL以及设置参数等语句，常量值不可以忽略。 执行次数（成功执行的次数），响应时间（数据库内部的SQL执行时间，包括最大、最小和总时间）。 Cache/IO信息，包含block的物理读、逻辑读次数，仅统计执行成功的SQL在各DN节点上的相关信息。该统计值与查询执行当时所处理的数据量、所使用的内存、是否多次执行、内存管理策略、是否有其他并发查询等因素相关，反映整个查询执行过程中的buffer块物理读和逻辑读次数，不同时间执行可能统计值不同。 行活动，包含SELECT语句的结果集返回行数、更新行、插入行、删除行、顺序扫描行、随机扫描行等信息。除结果集返回行数与该SELECT语句的结果集行数一致、且仅在CN上记录外，其他行活动信息均在DN上记录，且统计数值反应的是整个查询执行过程中的行活动，包括对相关系统表、元数据表、数据表等做必要的扫描和修改，与对应数据量以及相关参数设置相关，即统计数值将会大于等于对实际数据表的扫描和修改。 时间分布，包含：DB_TIME/CPU_TIME/EXECUTION_TIME/PARSE_TIME/PLAN_TIME/REWRITE_TIME/PL_EXECUTION_TIME/PL_COMPILATION_TIME/NET_SEND_TIME/DATA_IO_TIME，相关定义见表1。该信息在CN和DN节点均有统计，视图查询时将汇总展示。 软硬解析次数，包含软解析（缓存计划）、硬解析（生成计划）的次数，即如果本次执行的是之前缓存的计划，软解析次数+1，如果本次执行的计划是重新生成的，则硬解析次数+1。该次数在CN和DN节点上都会统计，视图查询时将汇总展示。 Unique SQL收集功能存在以下约束： 只有执行成功的SQL才会显示其详细的统计信息，否则可能只记录query、node、user等信息。 如果开启Unique SQL收集功能，CN节点将对所有接收到的查询进行统计收集，包括工具和用户的查询等。 若一条SQL语句内部包含执行多条SQL语句、类似存储过程执行等场景，仅会对最外层SQL生成一条Unique SQL，所有子SQL的统计信息都会汇总到该Unique SQL记录上。 Unique SQL的响应时间统计中不完全包含NET_SEND_TIME阶段的时间，所以EXECUTION_TIME和elapse_time等时间之间不存在大小比较关系。 对于类似begin;...;commit;等形式的事务块，当前不支持统计子句的解析时间（parse_time）。 普通用户访问GS_INSTR_UNIQUE_SQL视图，只能看到该用户相关的Unique SQL信息，管理员用户可以看到当前节点所有的Unique SQL信息。CN和DN上均可查询GS_INSTR_UNIQUE_SQL视图，DN上显示的是本节点内的Unique SQL统计信息，CN上显示的是本节点Unique SQL完整统计信息，即该CN节点会收集其他CN和DN上对应该CN的Unique SQL的执行信息，进行汇总展示。通过查询GS_INSTR_UNIQUE_SQL视图，能够定位由于消耗不同资源导致的Top SQL，为集群性能调优和维护提供依据。 GUC参数instr_unique_sql_timeout设置了Unique SQL的超时时间，单位是小时。后台线程每隔1小时检查一次所有的Unique SQL，将last_time在instr_unique_sql_timeout小时之前的Unique SQL删除。

ALL_CONSTRAINTS ALL_CONSTRAINTS视图存储当前用户可访问的约束的信息。 表1 ALL_CONSTRAINTS字段 名称 类型 描述 constraint_name vcharacter varying(64) 约束名。 constraint_type text 约束类型。 c表示检查约束。 f表示外键约束。 p表示主键约束。 u表示唯一约束。 table_name character varying(64) 约束相关的表名。 index_owner character varying(64) 约束相关的索引的所有者（只针对唯一约束和主键约束）。 index_name character varying(64) 约束相关的索引名（只针对唯一约束和主键约束）。 父主题： 系统视图

系统表和系统视图概述 系统表是 GaussDB (DWS)存放结构元数据，是GaussDB(DWS)数据库系统运行控制信息的来源，也是数据库系统的核心组成部分。系统表包含集群安装信息以及GaussDB(DWS)上运行的各种查询和进程的信息。可以通过查询系统表来收集有关数据库的信息。 系统视图提供了查询系统表和访问数据库内部状态的方法。当用户对数据库中的一张或者多张表的某些字段的组合感兴趣，而又不想每次键入这些查询时，用户就可以定义一个视图来解决这个问题。视图与基本表不同，不是物理上实际存在的，是一个虚表。数据库中仅存放视图的定义，而不存放视图对应的数据，这些数据仍存放在原来的基本表中。若基本表中的数据发生变化，从视图中查询出的数据也随之改变。从这个意义上讲，视图就像一个窗口，透过它可以看到数据库中用户感兴趣的数据及变化。视图每次被引用的时候都会运行一次。 三权分立下，非管理员无权查看系统表和视图。非三权分立下，系统表和系统视图要么只对管理员可见，要么对所有用户可见。下面的系统表和视图有些标识了需要管理员权限，这些系统表和视图只有管理员可以查询。 禁止对系统表或系统视图进行增删改等操作，手动对系统表或系统视图的修改或破坏可能会导致系统信息不一致，造成系统控制异常甚至出现集群不可用的情况。 系统表不支持toast，无法跨页存储，一个页面大小为8K，系统表各个字段长度需小于8K。 父主题： GaussDB(DWS)系统表和系统视图

GV_SESSION GV_SESSION视图存储当前会话的所有会话信息。该视图只有管理员可以访问，普通用户需要授权才能访问，该视图同时存在于PG_CATA LOG 和SYS Schema下。 表1 GV_SESSION字段 名称 类型 描述 inst_id numeric 暂不支持，值为NULL。 saddr raw 暂不支持，值为NULL。 sid bigint 会话ID。 serial# integer 当前活动的后台线程的序号。 audsid numeric 暂不支持，值为NULL。 paddr raw 暂不支持，值为NULL。 schema# numeric 暂不支持，值为NULL。 schemaname name 登录该后台的用户名。 user# oid 登录此后台线程的用户的OID。oid 为0表示此后台线程为全局辅助线程(auxiliary)。 username name 登录此后台线程的用户名。username为空表示此后台线程为全局辅助线程(auxiliary)。 command numeric 暂不支持，值为NULL。 ownerid numeric 暂不支持，值为NULL。 taddr character varying(16) 暂不支持，值为NULL。 lockwait character varying(16) 暂不支持，值为NULL。 machine text 客户端的主机名，这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。 sql_id bigint sql的oid。 client_info text 客户端信息。 event text 语句当前排队状态。可能值是： waiting in queue：表示语句在排队中。 空：表示语句正在运行。 sql_exec_start timestamp with time zone sql执行开始时间。 program text 连接到该后台的应用名。 status text 该后台当前总体状态。可能值是： active：后台正在执行一个查询。 idle：后台正在等待一个新的客户端命令。 idle in transaction：后台在事务中，但事务中没有语句在执行。 idle in transaction (aborted)：后台在事务中，但事务中有语句执行失败。 fastpath function call：后台正在执行一个fast-path函数。 disabled：如果后台禁用track_activities，则报告这个状态。 server character varying(9) 暂不支持，值为NULL。 pdml_status character varying(8) 当前会话是否启用DML的并行执行。 port numeric 当前会话的端口号。 process character varying(24) 当前会话的进程号。 logon_time timestamp(0) without time zone 当前会话的登录时间。 last_call_et integer 当前会话上次状态发生改变的时长。 osuser character varying(128) 暂不支持，值为NULL。 terminal character varying(30) 暂不支持，值为NULL。 type character varying(10) 暂不支持，值为NULL。 sql_address raw 暂不支持，值为NULL。 sql_hash_value numeric 暂不支持，值为NULL。 sql_child_number numeric 暂不支持，值为NULL。 sql_exec_id numeric 暂不支持，值为NULL。 prev_sql_addr raw 暂不支持，值为NULL。 prev_hash_value numeric 暂不支持，值为NULL。 prev_sql_id character varying(13) 暂不支持，值为NULL。 prev_child_number numeric 暂不支持，值为NULL。 prev_exec_start timestamp(0) without time zone 暂不支持，值为NULL。 prev_exec_id numeric 暂不支持，值为NULL。 plsql_entry_object_id numeric 暂不支持，值为NULL。 plsql_entry_subprogram_id numeric 暂不支持，值为NULL。 plsql_object_id numeric 暂不支持，值为NULL。 plsql_subprogram_id numeric 暂不支持，值为NULL。 module character varying(64) 暂不支持，值为NULL。 module_hash numeric 暂不支持，值为NULL。 action character varying(64) 暂不支持，值为NULL。 action_hash numeric 暂不支持，值为NULL。 fixed_table_sequence numeric 暂不支持，值为NULL。 row_wait_obj# numeric 暂不支持，值为NULL。 row_wait_file# numeric 暂不支持，值为NULL。 row_wait_block# numeric 暂不支持，值为NULL。 row_wait_row# numeric 暂不支持，值为NULL。 top_level_call# numeric 暂不支持，值为NULL。 pdml_enabled character varying(3) 暂不支持，值为NULL。 failover_type character varying(13) 暂不支持，值为NULL。 failover_method character varying(10) 暂不支持，值为NULL。 failed_over character varying(3) 暂不支持，值为NULL。 resource_consumer_group character varying(32) 暂不支持，值为NULL。 pddl_status character varying(8) 暂不支持，值为NULL。 pq_status character varying(8) 暂不支持，值为NULL。 current_queue_duration numeric 暂不支持，值为NULL。 client_identifier character varying(64) 暂不支持，值为NULL。 blocking_session_status character varying(11) 暂不支持，值为NULL。 blocking_instance numeric 暂不支持，值为NULL。 blocking_session numeric 暂不支持，值为NULL。 final_blocking_session_status character varying(11) 暂不支持，值为NULL。 final_blocking_instance numeric 暂不支持，值为NULL。 final_blocking_session numeric 暂不支持，值为NULL。 seq# numeric 暂不支持，值为NULL。 event# numeric 暂不支持，值为NULL。 p1text character varying(64) 暂不支持，值为NULL。 p1 numeric 暂不支持，值为NULL。 p1raw raw 暂不支持，值为NULL。 p2text character varying(64) 暂不支持，值为NULL。 p2 numeric 暂不支持，值为NULL。 p2raw raw 暂不支持，值为NULL。 p3text character varying(64) 暂不支持，值为NULL。 p3 numeric 暂不支持，值为NULL。 p3raw raw 暂不支持，值为NULL。 wait_class_id numeric 暂不支持，值为NULL。 wait_class# numeric 暂不支持，值为NULL。 wait_class character varying(64) 暂不支持，值为NULL。 wait_time numeric 暂不支持，值为NULL。 seconds_in_wait numeric 暂不支持，值为NULL。 state character varying(19) 暂不支持，值为NULL。 wait_time_micro numeric 暂不支持，值为NULL。 time_remaining_micro numeric 暂不支持，值为NULL。 time_since_last_wait_micro numeric 暂不支持，值为NULL。 service_name character varying(64) 暂不支持，值为NULL。 sql_trace character varying(8) 暂不支持，值为NULL。 sql_trace_waits character varying(5) 暂不支持，值为NULL。 sql_trace_binds character varying(5) 暂不支持，值为NULL。 sql_trace_plan_stats character varying(10) 暂不支持，值为NULL。 session_edition_id numeric 暂不支持，值为NULL。 creator_addr raw 暂不支持，值为NULL。 creator_serial# numeric 暂不支持，值为NULL。 ecid character varying(64) 暂不支持，值为NULL。 sql_translation_profile_id numeric 暂不支持，值为NULL。 pga_tunable_mem numeric 暂不支持，值为NULL。 shard_ddl_status character varying(8) 暂不支持，值为NULL。 con_id numeric 暂不支持，值为NULL。 external_name character varying(1024) 暂不支持，值为NULL。 plsql_debugger_connected character varying(5) 暂不支持，值为NULL。 父主题： 系统视图

MY_IND_EXPRESSIONS MY_IND_EXPRESSIONS视图显示当前用户下基于函数的表达式索引的信息。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 MY_IND_EXPRESSIONS字段 名称 类型 描述 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 column_expression text 定义列的基于函数的索引表达式。 column_position smallint 索引中列的位置。 父主题： 系统视图

GV_SESSION GV_SESSION视图显示当前会话的所有会话信息。 表1 GV_SESSION字段 名称 类型 描述 sid bigint 热点key所在database名称。 serial# integer 热点key所在schema名称。 schemaname name 热点key所在table名称。 user# oid 热点key的value。 username name 热点key在数据库中的哈希值，如果是List/Range分布表，该字段为0。 machine text 热点key被访问频次。 sql_id bigint sql的oid。 client_info text 客户端信息。 event text 语句当前排队状态。可能值是： waiting in queue：表示语句在排队中。 空：表示语句正在运行。 sql_exec_start timestamp sql执行开始时间。 program text 连接到该后台的应用名。 status text 该后台当前总体状态。可能值是： active：后台正在执行一个查询。 idle：后台正在等待一个新的客户端命令。 idle in transaction：后台在事务中，但事务中没有语句在执行。 idle in transaction (aborted)：后台在事务中，但事务中有语句执行失败。 fastpath function call：后台正在执行一个fast-path函数。 disabled：如果后台禁用track_activities，则报告这个状态。 父主题： 系统视图

系统表和系统视图概述 系统表是GaussDB存放结构元数据的地方，它是 GaussDB数据库 系统运行控制信息的来源，是数据库系统的核心组成部分。 系统视图提供了查询系统表和访问数据库内部状态的方法。 系统表和系统视图要么只对管理员可见，要么对所有用户可见。下面的系统表和视图有些标识了需要管理员权限，这些系统表和视图只有管理员可以查询。 用户可以删除后重新创建这些表、增加列、插入和更新数值，但是用户修改系统表会导致系统信息的不一致，从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图，或者手工重命名系统表或系统视图所在的模式，而是由SQL语句关联的系统表操作自动维护系统表信息。 不建议用户修改系统表和系统视图的权限。 用户应该禁止对系统表进行增删改等操作，人为对系统表的修改或破坏可能会导致系统各种异常情况甚至数据库不可用。 系统表和系统视图中的字段类型详见数据类型章节介绍。 父主题： 系统表和系统视图

PG_STAT_DATABASE PG_STAT_DATABASE视图将包含GaussDB中每个数据库的数据库统计信息。 表1 PG_STAT_DATABASE字段 名称 类型 描述 datid oid 数据库的OID。 datname name 数据库的名称。 numbackends integer 当前连接到该数据库的后端数。 这是该视图中唯一一个返回当前状态值的字段，其他字段返回的都是自上次重置之后的累计值。 xact_commit bigint 该数据库中已经提交的事务数。 xact_rollback bigint 该数据库中已经回滚的事务数。 blks_read bigint 在该数据库中读取的磁盘块的数量。 blks_hit bigint 已在缓冲区缓存中找到磁盘块的次数，因此不需要读取（只统计在缓冲区缓存找到的，不包括在操作系统的文件系统缓存中找到的）。 tup_returned bigint 通过数据库查询返回的行数。 tup_fetched bigint 通过数据库查询抓取的行数。 tup_inserted bigint 通过数据库查询插入的行数。 tup_updated bigint 通过数据库查询更新的行数。 tup_deleted bigint 通过数据库查询删除的行数。 conflicts bigint 由于数据库恢复冲突取消的查询数量（只在备用服务器发生的冲突）。请参见PG_STAT_DATABASE_CONFLI CTS 获取更多信息。 temp_files bigint 通过数据库查询创建的临时文件数量。计算所有临时文件， 无论该临时文件为什么创建（比如排序或者哈希），也不管log_temp_files参数如何设置。 temp_bytes bigint 通过数据库查询写入临时文件的数据总量。计算所有临时文件，无论该临时文件为什么创建，而且不管log_temp_files设置。 deadlocks bigint 该数据库中检测到的自上次重置统计信息以来所有的死锁数。 blk_read_time double precision 通过数据库后端读取数据文件块花费的时间，以毫秒计算。 blk_write_time double precision 通过数据库后端写入数据文件块花费的时间，以毫秒计算。 stats_reset timestamp with time zone 当前状态统计被重置的时间。 父主题： 系统视图

GS_MATVIEWS GS_MATVIEWS视图显示数据库中每一个物化视图的信息。 表1 GS_MATVIEWS字段 名称 类型 引用 描述 schemaname name PG_NAMESPACE.nspname 物化视图的模式名。 matviewname name PG_CLASS.relname 物化视图名。 matviewowner name PG_AUTHID.rolname 物化视图的所有者。 tablespace name PG_TABLESPACE.spcname 物化视图的表空间名（如果使用数据库默认表空间则为空）。 hasindexes boolean - 如果物化视图有（或者最近有过）任何索引，则此列为真。 definition text - 物化视图的定义（一个重构的SELECT查询）。 父主题： 系统视图

PG_STATIO_ALL_INDEXES PG_STATIO_ALL_INDEXES视图可用来查询当前数据库中的每个索引行的信息，显示特定索引的I/O的统计信息。 表1 PG_STATIO_ALL_INDEXES字段 名称 类型 描述 relid oid 索引的表的OID。 indexrelid oid 该索引的OID。 schemaname name 该索引的模式名。 relname name 该索引的表名。 indexrelname name 索引名称。 idx_blks_read bigint 从索引中读取的磁盘块数。 idx_blks_hit bigint 索引命中缓存数。 父主题： 系统视图

系统表和系统视图概述 系统表是GaussDB存放结构元数据的地方，是GaussDB数据库系统运行控制信息的来源，是数据库系统的核心组成部分。 系统视图提供了查询系统表和访问数据库内部状态的方法。 系统表和系统视图要么只对管理员可见，要么对所有用户可见。下面的系统表和视图有些标识了需要管理员权限，这些系统表和视图只有管理员可以查询。 用户可以删除后重新创建这些表、增加列、插入和更新数值，但是用户修改系统表会导致系统信息的不一致，从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图，或者手工重命名系统表或系统视图所在的模式，而是由SQL语句关联的系统表操作自动维护系统表信息。 不建议用户修改系统表和系统视图的权限。 用户应该禁止对系统表进行增删改等操作，人为对系统表的修改或破坏可能会导致系统各种异常情况甚至集群不可用。 gs_package系统表在分布式场景下能够查询到但是无意义。 系统表和系统视图中与外键相关的字段暂不支持。 系统表和系统视图中的字段类型详见数据类型章节介绍。 父主题： 系统表和系统视图

ADM_PART_TABLES ADM_PART_TABLES视图显示数据中所有分区表的信息。默认只有系统管理员权限才可以访问此系统视图，普通用户需要授权才可以访问。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 ADM_PART_TABLES字段 名称 类型 描述 table_owner character varying(64) 分区表的所有者名称。 table_name character varying(64) 分区表的名称。 partitioning_type text 分区表的分区策略。 说明： 当前分区表策略仅支持范围分区（Range Partitioning）。 partition_count bigint 分区表的分区个数。 partitioning_key_count integer 分区表的分区键个数。 def_tablespace_name name 分区表的表空间名称。 schema character varying(64) 分区表的模式。 父主题： 系统视图

MY_TRIGGERS MY_TRIGGERS视图显示当前用户拥有的触发器的信息。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 MY_TRIGGERS字段 名称 类型 描述 trigger_name character varying(64) 触发器名称。 table_name character varying(64) 关系表名称。 table_owner character varying(64) 角色名称。 status character varying(64) 触发器的状态。 O：触发器在“origin”和“local”模式下触发。 D：触发器被禁用。 R：触发器在“replica”模式下触发。 A：触发器始终触发。 父主题： 系统视图

ADM_HIST_SNAPSHOT ADM_HIST_SNAPSHOT视图记录当前系统中存储的WDR快照数据的索引信息、开始时间。默认只有系统管理员权限才可以访问此系统视图，普通用户需要授权才可以访问。 表1 ADM_HIST_SNAPSHOT字段 名称 类型 描述 snap_id bigint WDR快照序号。 begin_interval_time timestamp WDR快照的开始时间。 父主题： 系统视图

PG_STATIO_USER_INDEXES PG_STATIO_USER_INDEXES视图显示命名空间中所有用户关系表索引的I/O状态信息。 表1 PG_STATIO_USER_INDEXES字段 名称 类型 描述 relid oid 该索引所在的表的OID。 indexrelid oid 该索引的OID。 schemaname name 该索引的模式名。 relname name 该索引的表名. indexrelname name 索引名称。 idx_blks_read bigint 从索引中读取的磁盘块数。 idx_blks_hit bigint 索引命中缓存数。 父主题： 系统视图