华为云用户手册

USER_IND_EXPRESSIONS USER_IND_EXPRESSIONS视图存储当前用户下基于函数的表达式索引的信息。 名称 类型 描述 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 column_expression text 定义列的基于函数的索引表达式。 column_position smallint 索引中列的位置。 父主题： 系统视图

USER_OBJE CTS USER_OBJECTS视图描述了当前用户拥有的数据库对象。 名称 类型 描述 owner name 对象的所有者。 object_name name 对象的名称。 object_id oid 对象的OID。 object_type name 对象的类型。 namespace oid 对象所在的命名空间。 created timestamp with time zone 对象的创建时间。 last_ddl_time timestamp with time zone 对象的最后修改时间。 created和last_ddl_time支持的范围参见PG_OBJECT中的记录范围。 父主题： 系统视图

PV_SESSION_STAT PV_SESSION_STAT视图以会话线程或AutoVacuum线程为单位，统计会话状态信息。 表1 PV_SESSION_STAT字段 名称 类型 描述 sessid text 线程标识+线程启动时间。 statid integer 统计编号。 statname text 统计会话名称。 statunit text 统计会话单位。 value bigint 统计会话值。 父主题： 系统视图

PG_JOB PG_JOB视图存储用户创建的定时任务的任务详细信息。 PG_JOB视图用于代替历史版本的PG_JOB系统表，提供对之前版本的前向兼容。原PG_JOB系统表已经变更为PG_JOBS系统表，关于PG_JOBS系统表的描述详见PG_JOBS。 表1 PG_JOB字段 名字 类型 描述 job_id bigint 作业ID。 current_postgres_pid bigint 如果当前任务已被执行，那么此处记录运行此任务的postgres线程ID。默认为-1，表示此任务未被执行过。 log_user name 创建者的UserName。 priv_user name 作业执行者的UserName。 dbname name 标识作业执行的数据库名。 node_name name 标识当前作业是在哪个CN上创建和执行。 job_status text 当前任务的执行状态，取值范围：('r', 's', 'f', 'd')，默认为's'，取值含义： r=running s=successfully finished f=job failed d=disable 当job连续执行失败16次，会将job_status自动设置为失效状态'd'，后续不再执行该job。 说明： 当用户将定时任务关闭（即job_queue_processes为0时），由于监控job执行的线程不会启动，所以job_status不会根据job的实时状态进行设置，用户不需要关注job_status。 只有当开启定时任务功能（job_queue_processes为非0时），系统才会根据当前job的实时状态刷新job_status的值。 start_date timestamp without time zone 作业第一次开始执行时间，时间精确到毫秒。 next_run_date timestamp without time zone 下次定时执行任务的时间，时间精确到毫秒。 failure_count smallint 失败计数，作业连续执行失败16次，不再继续执行。 interval text 作业执行的重复时间间隔。 last_start_date timestamp without time zone 上次运行开始时间，时间精确到毫秒。 last_end_date timestamp without time zone 上次运行的结束时间，时间精确到毫秒。 last_suc_date timestamp without time zone 上次成功运行的开始时间，时间精确到毫秒。 this_run_date timestamp without time zone 正在运行任务的开始时间，时间精确到毫秒。 nspname name 作业运行时所在的命名空间的名称。 what text 作业内容。 父主题： 系统视图

内存监控 GaussDB (DWS)提供了监控整个集群内存使用状态的视图： 查询pgxc_total_memory_detail视图，必须具有sysadmin权限。 1 SELECT * FROM pgxc_total_memory_detail; 如果查询该视图时出现以下错误，请开启内存管理功能。 1 2 3 SELECT * FROM pgxc_total_memory_detail; ERROR: unsupported view for memory protection feature is disabled. CONTEXT: PL/pgSQL function pgxc_total_memory_detail() line 12 at FOR over EXECUTE statement 用户可通过GaussDB(DWS) 控制台设置enable_memory_limit和max_process_memory参数来开启内存管理功能，方法如下： 登录GaussDB(DWS) 管理控制台。 在左侧导航栏中，单击“集群管理”。 在集群列表中找到所需要的集群，单击集群名称，进入集群“基本信息”页面。 单击“参数修改”页签，修改参数“enable_memory_limit”的值为on，然后单击“保存”。 修改参数“max_process_memory”的值为合适的值，修改建议请参见max_process_memory，然后单击“保存”。 在“修改预览”窗口，确认修改无误后，单击“保存”。修改完成后需要重启集群，参数才会生效。

DBA_IND_EXPRESSIONS DBA_IND_EXPRESSIONS视图存储了数据库中的表达式索引的信息。需要有系统管理员权限才可以访问。 名称 类型 描述 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 column_expression text 定义列的基于函数的索引表达式。 column_position smallint 索引中列的位置。 父主题： 系统视图

DBA_OBJECTS DBA_OBJECTS视图存储了数据库中所有数据库对象。需要有系统管理员权限才可以访问。 名称 类型 描述 owner name 对象的所有者。 object_name name 对象的名称。 object_id oid 对象的OID。 object_type name 对象的类型。 namespace oid 对象所在的命名空间。 created timestamp with time zone 对象的创建时间。 last_ddl_time timestamp with time zone 对象的最后修改时间。 created和last_ddl_time支持的范围参见PG_OBJECT中的记录范围。 父主题： 系统视图

PV_OS_RUN_INFO PV_OS_RUN_INFO视图显示当前操作系统运行的状态信息。 表1 PV_OS_RUN_INFO字段 名称 类型 描述 id integer 编号。 name text 操作系统运行状态名称。 value numeric 操作系统运行状态值。 comments text 操作系统运行状态注释。 cumulative boolean 操作系统运行状态的值是否为累加值。 父主题： 系统视图

PG_CONVERSION PG_CONVERSION系统表描述编码转换信息。 表1 PG_CONVERSION字段 名字 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 conname name - 转换名（在一个命名空间里唯一）。 connamespace oid PG_NAMESPACE.oid 包含此转换的命名空间的OID。 conowner oid PG_AUTHID.oid 编码转换的属主。 conforencoding integer - 源编码ID。 contoencoding integer - 目的编码ID。 conproc regproc PG_PROC.oid 转换过程。 condefault boolean - 如果为缺省转换则为真。 父主题： 系统表

PG_COLLATION PG_COLLATION系统表描述可用的排序规则，本质上从一个SQL名字映射到操作系统本地类别。 表1 PG_COLLATION字段 名字 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 collname name - 排序规则名（每个命名空间和编码唯一）。 collnamespace oid PG_NAMESPACE.oid 包含该排序规则的命名空间的OID。 collowner oid PG_AUTHID.oid 排序规则的所有者。 collencoding integer - 排序规则可用的编码，如果适用于任意编码为-1。 说明： 使用函数pg_encoding_to_char()可以将编号转换为对应的编码名称。 collcollate name - 排序规则对象的LC_COLLATE。 collctype name - 排序规则对象的LC_CTYPE。 父主题： 系统表

vacuum_cost_delay 参数说明：指定开销超过vacuum_cost_limit的值时进程将进入休眠的时间长度。 参数类型：USERSET 取值范围：整型，0~100，单位为毫秒（ms）。正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 默认值：0 许多系统上，休眠的有效分辨率是10毫秒。因此把vacuum_cost_delay设置为一个不是10的整数倍的数值与将它设置为10的整数倍作用相同。 此参数一般设置较小，常见的设置是10或20毫秒。

PG_SETTINGS PG_SETTINGS视图显示数据库运行时参数的相关信息。 表1 PG_SETTINGS字段 名称 类型 描述 name text 参数名称。 setting text 参数当前值。 unit text 参数的隐式结构。 category text 参数的逻辑组。 short_desc text 参数的简单描述。 extra_desc text 参数的详细描述。 context text 设置参数值的上下文，包括：internal，postmaster，sighup，backend，superuser和user。 vartype text 参数类型，包括bool，enum，integer，real和string。 source text 参数的赋值方式。 min_val text 参数最小值。如果参数类型不是数值型，那么该字段值为null。 max_val text 参数最大值。如果参数类型不是数值型，那么该字段值为null。 enumvals text[] enum类型参数合法值。如果参数类型不是enum型，那么该字段值为null。 boot_val text 数据库启动时参数默认值。 reset_val text 数据库重置时参数默认值。 sourcefile text 设置参数值的配置文件。如果参数不是通过配置文件赋值，那么该字段值为null。 sourceline integer 设置参数值的配置文件的行号。如果参数不是通过配置文件赋值，那么该字段值为null。 父主题： 系统视图

PG_AVAILABLE_EXTENSION_VERSIONS PG_AVAILABLE_EXTENSION_VERSIONS视图显示数据库中某些特性的扩展版本信息。 表1 PG_AVAILABLE_EXTENSION_VERSIONS字段 名称 类型 描述 name name 扩展名。 version text 版本名。 installed boolean 如果此扩展的版本当前已经安装，则为真。 superuser boolean 如果只允许系统管理员安装此扩展，则为真。 relocatable boolean 如果扩展可以重新加载到另一个模式，则为真。 schema name 扩展必须安装到的模式名，如果部分或全部可重新定位，则为NULL。 requires name[] 必备扩展的名称，如果没有则为NULL。 comment text 扩展的控制文件的注释字符串。 父主题： 系统视图

PG_OPERATOR PG_OPERATOR系统表存储有关操作符的信息。 表1 PG_OPERATOR字段 名字 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 oprname name - 操作符的名称。 oprnamespace oid PG_NAMESPACE.oid 包含此操作符的命名空间的OID。 oprowner oid PG_AUTHID.oid 操作符所有者。 oprkind "char" - b=infix =中缀（两边）。 l=前缀（左边）。 r=后缀（右边）。 oprcanmerge boolean - 该操作符是否支持合并连接。 oprcanhash boolean - 该操作符是否支持Hash连接。 oprleft oid PG_TYPE.oid 左操作数的类型。 oprright oid PG_TYPE.oid 右操作数的类型。 oprresult oid PG_TYPE.oid 结果类型。 oprcom oid PG_OPERATOR.oid 此操作符的交换符（如果存在）。 oprnegate oid PG_OPERATOR.oid 此操作符的反转器（如果存在）。 oprcode regproc PG_PROC.oid 实现该操作符的函数。 oprrest regproc PG_PROC.oid 此操作符的约束选择性计算函数。 oprjoin regproc PG_PROC.oid 此操作符的连接选择性计算函数。 父主题： 系统表

DBA_COL_COMMENTS DBA_COL_COMMENTS视图存储关于数据库中表和视图中字段的注释信息。需要有系统管理员权限才可以访问。 名称 类型 描述 column_name character varying(64) 列名。 table_name character varying(64) 表名或视图名。 owner character varying(64) 表或视图的所有者。 comments text 注释。 父主题： 系统视图

DBA_IND_COLUMNS DBA_IND_COLUMNS视图存储关于数据库中所有索引的字段信息。需要有系统管理员权限才可以访问。 名称 类型 描述 index_owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_owner character varying(64) 表的所有者。 table_name character varying(64) 表名。 column_name name 列名。 column_position smallint 索引中列的位置。 父主题： 系统视图

PG_RANGE PG_RANGE系统表存储关于范围类型的信息。 除了PG_TYPE里类型的记录。 表1 PG_RANGE字段 名字 类型 引用 描述 rngtypid oid PG_TYPE.oid 范围类型的OID。 rngsubtype oid PG_TYPE.oid 范围类型的元素类型（子类型）的OID。 rngcollation oid PG_COLLATION.oid 用于范围比较的排序规则的OID，如果没有则为0。 rngsubopc oid PG_OPCLASS.oid 用于范围比较的子类型的操作符类的OID。 rngsubopc（如果元素类型是可排序的，则加上rngcollation）决定用于范围类型的排序顺序。使用rngcanonical用于离散类型的元素类型。 rngcanonical regproc PG_PROC.oid 转换范围类型为规范格式的函数的OID，如果没有则为0。 rngsubdiff regproc PG_PROC.oid 返回两个double precision元素值的不同的函数的OID，如果没有则为0。 父主题： 系统表

DBA_INDEXES DBA_INDEXES视图存储关于数据库下的所有索引信息。需要有系统管理员权限才可以访问。 名称 类型 描述 owner character varying(64) 索引的所有者。 index_name character varying(64) 索引名。 table_name character varying(64) 索引对应的表名。 uniqueness text 表示索引是否为唯一索引。 generated character varying(1) 表示索引名称是否为系统生成。 partitioned character(3) 表示索引是否具有分区表的性质。 父主题： 系统视图

DBA_PART_TABLES DBA_PART_TABLES视图存储数据中所有分区表的信息。需要有系统管理员权限才可以访问。 名称 类型 描述 table_owner character varying(64) 分区表的所有者名称。 schema character varying(64) 分区表的模式。 table_name character varying(64) 分区表的名称。 partitioning_type text 分区表的分区策略。 说明： 当前分区表策略仅支持范围分区（Range Partitioning）和列表分区（List Partitioning）。 partition_count bigint 分区表的分区个数。 def_tablespace_name name 分区表的表空间名称。 partitioning_key_count integer 分区表的分区键个数。 父主题： 系统视图

GS_WORKLOAD_SQL_ELAPSE_TIME GS_WORKLOAD_SQL_ELAPSE_TIME视图显示当前节点上Workload控制组内SQL语句执行的响应时间的统计信息，包括SELECT、UPDATE、INSERT、DELETE语句的最大、最小、平均以及总响应时间，单位为微秒。 表1 GS_WORKLOAD_SQL_ELAPSE_TIME字段 名称 类型 描述 workload name Workload控制组名称。 total_select_elapse bigint SELECT总响应时间。 max_select_elapse bigint SELECT最大响应时间。 min_select_elapse bigint SELECT最小响应时间。 avg_select_elapse bigint SELECT平均响应时间。 total_update_elapse bigint UPDATE总响应时间。 max_update_elapse bigint UPDATE最大响应时间。 min_update_elapse bigint UPDATE最小响应时间。 avg_update_elapse bigint UPDATE平均响应时间。 total_insert_elapse bigint INSERT总响应时间。 max_insert_elapse bigint INSERT最大响应时间。 min_insert_elapse bigint INSERT最小响应时间。 avg_insert_elapse bigint INSERT平均响应时间。 total_delete_elapse bigint DELETE总响应时间。 max_delete_elapse bigint DELETE最大响应时间。 min_delete_elapse bigint DELETE最小响应时间。 avg_delete_elapse bigint DELETE平均响应时间。 父主题： 系统视图

PG_STAT_REPLICATION PG_STAT_REPLICATION视图用于描述日志同步状态信息，如发起端发送日志位置，接收端接收日志位置等。 表1 PG_STAT_REPLICATION字段 名称 类型 描述 pid bigint 线程的PID。 usesysid oid 用户系统ID。 usename name 用户名。 application_name text 程序名称。 client_addr inet 客户端地址。 client_hostname text 客户端名。 client_port integer 客户端端口号。 backend_start timestamp with time zone 程序启动时间。 state text 日志复制的状态（追赶状态，还是一致的流状态）。 sender_sent_location text 发送端发送日志位置。 receiver_write_location text 接收端write日志位置。 receiver_flush_location text 接收端flush日志位置。 receiver_replay_location text 接收端replay日志位置。 sync_priority integer 同步复制的优先级（0表示异步）。 sync_state text 同步状态（异步复制，同步复制，还是潜在同步）。 父主题： 系统视图

PG_AVAILABLE_EXTENSIONS PG_AVAILABLE_EXTENSIONS视图显示数据库中某些特性的扩展信息。 表1 PG_AVAILABLE_EXTENSIONS字段 名称 类型 描述 name name 扩展名。 default_version text 缺省版本名，如果没有指定则为NULL。 installed_version text 当前安装的扩展版本，如果未安装则为NULL。 comment text 扩展控制文件的注释字符串。 父主题： 系统视图

PG_AUTH_HISTORY PG_AUTH_HISTORY系统表记录了角色的认证历史。需要有系统管理员权限才可以访问此系统表。 表1 PG_AUTH_HISTORY字段 名称 类型 描述 roloid oid 角色标识。 passwordtime timestamp with time zone 创建和修改密码的时间。 rolpassword text 角色密码，使用MD5、SHA256加密或者不加密。 父主题： 系统表

PG_TS_TEMPLATE PG_TS_TEMPLATE系统表包含定义文本搜索模板的项。模板是文本搜索字典的类的实现框架。因为模板必须通过C语言级别的函数实现，索引新模板的创建必须由数据库系统管理员创建。 表1 PG_TS_TEMPLATE字段 名字 类型 引用 描述 oid oid - 行标识符（隐藏属性，必须明确选择才会显示）。 tmplname name - 文本搜索模板名。 tmplnamespace oid PG_NAMESPACE.oid 模板所属的命名空间的OID。 tmplinit regproc PG_PROC.oid 模板的初始化函数的OID。 tmpllexize regproc PG_PROC.oid 模板的lexize函数的OID。 父主题： 系统表

PG_STAT_USER_FUNCTIONS PG_STAT_USER_FUNCTIONS视图显示命名空间中用户自定义函数（函数语言为非内部语言）的状态信息。 表1 PG_STAT_USER_FUNCTIONS字段 名称 类型 描述 funcid oid 函数OID。 schemaname name 模式名。 funcname name 函数名。 calls bigint 函数被调用的次数。 total_time double precision 函数的总执行时长。 self_time double precision 当前线程调用函数的总的时长。 父主题： 系统视图

PG_STATIO_ALL_TABLES PG_STATIO_ALL_TABLES视图显示当前数据库中所有表的I/O的统计信息（包括TOAST表）。 表1 PG_STATIO_ALL_TABLES字段 名称 类型 描述 relid oid 表OID。 schemaname name 表的模式名。 relname name 表名。 heap_blks_read bigint 从此表中读取的磁盘块数。 heap_blks_hit bigint 此表缓冲区命中数。 idx_blks_read bigint 从表中所有索引读取的磁盘块数。 idx_blks_hit bigint 表中所有索引命中缓冲区数。 toast_blks_read bigint 此表的TOAST表读取的磁盘块数（如果存在）。 toast_blks_hit bigint 此表的TOAST表命中缓冲区数（如果存在）。 tidx_blks_read bigint 此表的TOAST表索引读取的磁盘块数（如果存在）。 tidx_blks_hit bigint 此表的TOAST表索引命中缓冲区数（如果存在）。 父主题： 系统视图

USER_PART_INDEXES USER_PART_INDEXES视图存储当前用户下分区表索引的信息。 名称 类型 描述 index_owner character varying(64) 分区表索引的所有者名称。 schema character varying(64) 分区表索引的模式。 index_name character varying(64) 分区表索引的名称。 table_name character varying(64) 分区表索引所属的分区表名称。 partitioning_type text 分区表的分区策略。 说明： 当前分区表策略仅支持范围分区（Range Partitioning）和列表分区（List Partitioning）。 partition_count bigint 分区表索引的索引分区的个数。 def_tablespace_name name 分区表索引的表空间名称。 partitioning_key_count integer 分区表的分区键个数。 父主题： 系统视图

GS_TABLE_STAT GS_TABLE_STAT视图显示当前数据库中所有表格（不包括外表）在当前节点上的统计信息。除live_tuples和dead_tuples为当前实时值外，其余各统计字段为实例启动以来的累计值。 表1 GS_TABLE_STAT字段 名称 类型 描述 schemaname name 表的命名空间。 relname name 表的名称。 seq_scan bigint 顺序扫描的次数。只统计行存表。如果是分区表，显示各个分区扫描次数的和。 seq_tuple_read bigint 顺序扫描的行数。只统计行存表。 index_scan bigint 索引扫描的次数。只统计行存表。 index_tuple_read bigint 索引扫描的行数。只统计行存表。 tuple_inserted bigint 插入的行数。 tuple_updated bigint 更新的行数。 tuple_deleted bigint 删除的行数。 tuple_hot_updated bigint 热更新的行数。 live_tuples bigint 活元组数量。CN上查询该视图，analyze后显示该表格总的活元组数量，未analyze的情况下显示0。只适用行存表。 dead_tuples bigint 死元组数量。CN上查询该视图，analyze后显示该表格总的死元组数量，未analyze的情况下显示0。只适用行存表。 父主题： 系统视图

配置集群参数 查询TopSQL资源监控信息之前，需要先配置相关的GUC参数，以便能查询到作业的资源监控历史信息或归档信息。步骤如下： 登录GaussDB(DWS)管理控制台。 在“集群管理”页面，找到所需要的集群，单击集群名称，进入集群详情页面。 单击“参数修改”标签页，可以看到当前集群的参数值。 修改参数resource_track_duration值为合适的值，单击“保存”按钮进行保存。 enable_resource_record开关打开后，会引起存储空间膨胀及轻微性能影响，不用时请关闭。 返回集群管理页面，单击右上角的刷新按钮，等待集群参数配置完成。

DBA_PROCEDURES DBA_PROCEDURES视图存储关于数据库下的所有存储过程或函数信息。需要有系统管理员权限才可以访问。 名称 类型 描述 owner character varying(64) 存储过程或函数的所有者。 object_name character varying(64) 存储过程或函数名称。 argument_number smallint 存储过程入参个数。 父主题： 系统视图