GaussDB-统计信息函数(上)

65 阅读47分钟

GaussDB-统计信息函数

统计信息函数根据访问对象分为两种类型:针对某个数据库进行访问的函数,以数据库中每个表或索引的OID作为参数,标识需要报告的数据库;针对某个服务器进行访问的函数,以一个服务器线程号为参数,其范围从1到当前活跃服务器的数目。

  • pg_stat_get_db_conflict_tablespace(oid)

    描述:由于恢复与数据库中删除的表空间发生冲突而取消的查询数。

    返回值类型:bigint。

  • pg_control_group_config()

    描述:在当前节点上打印cgroup配置。该函数需要SYSADMIN权限的用户才能够执行。

    返回值类型:record。

  • pg_stat_get_db_stat_reset_time(oid)

    描述:上次重置数据库统计信息的时间。首次连接到每个数据库期间初始化为系统时间。当您在数据库上调用pg_stat_reset以及针对其中的任何表或索引执行pg_stat_reset_single_table_counters时,重置时间都会更新。

    返回值类型:timestamptz。

  • pg_stat_get_function_total_time(oid)

    描述:该函数花费的总挂钟时间,以微秒为单位。包括花费在此函数调用其它函数上的时间。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_returned(oid)

    描述:当前事务中参数为表时通过顺序扫描读取的行数,或参数为索引时返回的索引条目数。

    返回值类型:bigint。

  • pg_stat_get_xact_numscans(oid)

    描述:当前事务中参数为表时执行的顺序扫描次数,或参数为索引时执行的索引扫描次数。

    返回值类型:bigint。

  • pg_stat_get_xact_blocks_fetched(oid)

    描述:当前事务中对表或索引的磁盘块获取请求数。

    返回值类型:bigint。

  • pg_stat_get_xact_blocks_hit(oid)

    描述:当前事务中对缓存中找到的表或索引的磁盘块获取请求数。

    返回值类型:bigint。

  • pg_stat_get_xact_function_calls(oid)

    描述:在当前事务中调用该函数的次数。

    返回值类型:bigint。

  • pg_stat_get_xact_function_self_time(oid)

    描述:在当前事务中仅花费在此函数上的时间。不包括花费在此函数内部调用其它函数上的时间。

    返回值类型:bigint。

  • pg_stat_get_xact_function_total_time(oid)

    描述:当前事务中该函数所花费的总挂钟时间(以微秒为单位)。包括花费在此函数内部调用其它函数上的时间。

    返回值类型:bigint。

  • pg_lock_status()

    描述:查询打开事务所持有的锁信息,所有用户均可执行该函数。

    返回值类型:返回字段可参考PG_LOCKS视图返回字段,该视图是通过查询本函数得到的结果。

  • bucket_lock_status()

    描述:查询打开事务所持有的bucket锁信息,所有用户均可执行该函数。

    返回值类型:返回字段可参考GS_BUCKET_LOCKS视图返回字段中除node_name之外的字段。

  • gs_bucket_lock_status()

    描述:查询所有节点中的打开事务所持有的bucket锁信息,所有用户均可执行该函数。

    返回值类型:返回字段可参考GS_BUCKET_LOCKS视图返回字段,该视图是通过查询本函数得到的结果。

  • gs_lwlock_status()

    描述:查询数据库系统内所有轻量级锁信息,包括等锁和持锁信息,所有用户均可执行该函数。

    返回值类型:setofrecord。

  • pg_stat_get_wal_senders()

    描述:在主机端查询walsender信息。

    返回值类型:setofrecord。

    返回字段说明如下:

    字段名称字段类型字段说明
    pidbigintwalsender的线程号。
    sender_pidintegerwalsender的pid相对的轻量级线程号。
    local_roletext主节点类型。
    peer_roletext备节点类型。
    peer_statetext备节点状态。
    statetextwalsender状态。
    catchup_starttimestamp with time zonecatchup启动时间。
    catchup_endtimestamp with time zonecatchup结束时间。
    sender_sent_locationtext主节点发送位置。
    sender_write_locationtext主节点落盘位置。
    sender_flush_locationtext主节点flush磁盘位置。
    sender_replay_locationtext主节点redo位置。
    receiver_received_locationtext备节点接收位置。
    receiver_write_locationtext备节点落盘位置。
    receiver_flush_locationtext备节点flush磁盘位置。
    receiver_replay_locationtext备节点redo磁盘位置。
    sync_percenttext同步百分比。
    sync_statetext同步状态。
    sync_grouptext同步复制的所属分组。
    sync_prioritytext同步复制的优先级。
    sync_most_availabletext最大可用模式设置。
    channeltextwalsender信道信息。
  • pgxc_get_senders_catchup_time()

    描述:在CN实例查询集群中是否存在处于日志追赶状态的备DN,以及追赶状态详情。

    返回值类型:setofrecord。

  • pg_stat_get_stream_replications()

    描述:查询主备复制状态。

    返回值类型:setofrecord。

    返回值说明如下表所示。

    返回参数返回参数类型返回参数说明
    local_roletext本地角色。
    static_connectionsinteger连接统计。
    db_statetext数据库状态。
    detail_informationtext详细信息。
  • pg_stat_get_db_numbackends(oid)

    描述:处理该数据库活跃的服务器线程数目。

    返回值类型:integer。

  • pg_stat_get_db_xact_commit(oid)

    描述:数据库中已提交事务的数量。

    返回值类型:bigint。

  • pg_stat_get_db_xact_rollback(oid)

    描述:数据库中回滚事务的数量。

    返回值类型:bigint。

  • pg_stat_get_db_blocks_fetched(oid)

    描述:数据库中磁盘块抓取请求的总数。

    返回值类型:bigint。

  • pg_stat_get_db_blocks_hit(oid)

    描述:数据库在缓冲区中找到的磁盘块抓取请求的总数。

    返回值类型:bigint。

  • pg_stat_get_db_tuples_returned(oid)

    描述:为数据库返回的Tuple数。

    返回值类型:bigint。

  • pg_stat_get_db_tuples_fetched(oid)

    描述:为数据库中获取的Tuple数。

    返回值类型:bigint。

  • pg_stat_get_db_tuples_inserted(oid)

    描述:在数据库中插入Tuple数。

    返回值类型:bigint。

  • pg_stat_get_db_tuples_updated(oid)

    描述:在数据库中更新的Tuple数。

    返回值类型:bigint。

  • pg_stat_get_db_tuples_deleted(oid)

    描述:数据库中删除Tuple数。

    返回值类型:bigint。

  • pg_stat_get_db_conflict_lock(oid)

    描述:数据库中锁冲突的数量。

    返回值类型:bigint。

  • pg_stat_get_db_deadlocks(oid)

    描述:数据库中死锁的数量。

    返回值类型:bigint。

  • pg_stat_get_numscans(oid)

    描述:如果参数是一个表,则顺序扫描读取的行数目。如果参数是一个索引,则返回索引行的数目。

    返回值类型:bigint。

  • pg_stat_get_role_name(oid)

    描述:根据用户oid获取用户名。仅SYSADMIN和MONADMIN用户可以访问。

    返回值类型:text。

    示例:

    gaussdb=# SELECT pg_stat_get_role_name(10);
     pg_stat_get_role_name
    -----------------------
     aabbcc
    (1 row)
    
  • pg_stat_get_tuples_returned(oid)

    描述:如果参数是一个表,则顺序扫描读取的行数目。如果参数是一个索引,则返回的索引行的数目。

    返回值类型:bigint。

  • pg_stat_get_tuples_fetched(oid)

    描述:如果参数是一个表,则位图扫描抓取的行数目。如果参数是一个索引,则用简单索引扫描在原表中抓取的行数目。

    返回值类型:bigint。

  • pg_stat_get_tuples_inserted(oid)

    描述:插入表中行的数量。

    返回值类型:bigint。

  • pg_stat_get_tuples_updated(oid)

    描述:在表中已更新行的数量。

    返回值类型:bigint。

  • pg_stat_get_tuples_deleted(oid)

    描述:从表中删除行的数量。

    返回值类型:bigint。

  • pg_stat_get_tuples_changed(oid)

    描述:该表上一次analyze或autoanalyze之后插入、更新、删除行的总数量。

    返回值类型:bigint。

  • pg_stat_get_tuples_hot_updated(oid)

    描述:表热更新的行数。

    返回值类型:bigint。

  • pg_stat_get_live_tuples(oid)

    描述:表活行数。

    返回值类型:bigint。

  • pg_stat_get_dead_tuples(oid)

    描述:表死行数。

    返回值类型:bigint。

  • pg_stat_get_blocks_fetched(oid)

    描述:表或者索引的磁盘块抓取请求的数量。

    返回值类型:bigint。

  • pg_stat_get_blocks_hit(oid)

    描述:在缓冲区中找到的表或者索引的磁盘块请求数目。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_fetched(oid)

    描述:事务中扫描的tuple行数。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_inserted(oid)

    描述:表相关的活跃子事务中插入的tuple数。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_deleted(oid)

    描述:表相关的活跃子事务中删除的tuple数。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_hot_updated(oid)

    描述:表相关的活跃子事务中热更新的tuple数。

    返回值类型:bigint。

  • pg_stat_get_xact_tuples_updated(oid)

    描述:表相关的活跃子事务中更新的tuple数。

    返回值类型:bigint。

  • pg_stat_get_last_vacuum_time(oid)

    描述:用户在该表上最后一次手动启动清理或者autovacuum线程启动清理的时间。

    返回值类型:timestamptz。

  • pg_stat_get_last_autovacuum_time(oid)

    描述:autovacuum守护线程在该表上最后一次启动清理的时间。

    返回值类型:timestamptz。

  • pg_stat_get_vacuum_count(oid)

    描述:用户在该表上启动清理的次数。

    返回值类型:bigint。

  • pg_stat_get_autovacuum_count(oid)

    描述:autovacuum守护线程在该表上启动清理的次数。

    返回值类型:bigint。

  • pg_stat_get_last_analyze_time(oid)

    描述:用户在该表上最后一次手动启动分析或者autovacuum线程启动分析的时间。

    返回值类型:timestamptz。

  • pg_stat_get_last_autoanalyze_time(oid)

    描述:autovacuum守护线程在该表上最后一次启动分析的时间。

    返回值类型:timestamptz。

  • pg_stat_get_analyze_count(oid)

    描述:用户在该表上启动分析的次数。

    返回值类型:bigint。

  • pg_stat_get_autoanalyze_count(oid)

    描述:autovacuum守护线程在该表上启动分析的次数。

    返回值类型:bigint。

  • pg_total_autovac_tuples(bool)

    描述:返回total autovac相关的tuple记录,如nodename、nspname、relname以及各类tuple的IUD信息,入参为:是否查询relation信息。

    返回值类型:setofrecord。

    返回参数说明如下。

    返回参数返回参数类型返回参数说明
    nodenamename节点名称。
    nspnamename名称空间名称。
    relnamename表、索引、视图等对象名称。
    partnamename分区名称。
    n_dead_tuplesbigint表分区内的死行数。
    n_live_tuplesbigint表分区内的活行数。
    changes_since_analyzebigintanalyze产生改变的数量。
  • pg_total_gsi_autovac_tuples(bool)

    描述:返回total autovac相关的tuple记录,如nodename、nspname、relname以及GSI自上次analyze之后发生变化的记录数,入参为:是否查询relation信息。该函数用于辅助autovacuum全局二级索引,不建议用户使用。

    返回值类型:setofrecord。

  • pg_autovac_status(oid)

    描述:返回和autovac状态相关的参数信息,如nodename、nspname、relname、analyze、vacuum设置,analyze/vacuum阈值,analyze/vacuum tuple数等。仅SYSADMIN可以使用该函数。

    返回值类型:setofrecord。

    返回值参数说明如下。

    返回参数返回参数类型返回参数说明
    nspnametext名称空间名称。
    relnametext表、索引、视图等对象名称。
    nodenametext节点名称。
    doanalyzeBoolean是否执行analyze。
    anltuplesbigintanalyze tuple数量。
    anlthreshbigintanalyze阈值。
    dovacuumBoolean是否执行vacuum。
    vactuplesbigintvacuum tuple数量。
    vacthreshbigintvacuum阈值。
  • pg_autovac_timeout(oid)

    描述:返回某个表做autovac连续超时的次数,表信息非法或node信息异常返回NULL。

    返回值类型:bigint。

  • pg_autovac_coordinator(oid)

    描述:返回对某个表做autovac的coordinator名称,表信息非法或node信息异常返回NULL。

    返回值类型:text。

  • pg_stat_get_last_data_changed_time(oid)

    描述:对于在表上的修改insert/update/delete/truncate和在表的分区(partition/subpartition)上的修改exchange/truncate/drop,在该表上最后一次操作的时间,PG_STAT_ALL_TABLES视图last_data_changed列的数据是通过该函数求值,在表数量很大的场景中,通过视图获取表数据最后修改时间的性能较差,建议直接使用该函数获取表数据的最后修改时间。入参是表的oid。

    返回值类型:timestamptz。

  • pg_stat_set_last_data_changed_time(oid)

    描述:手动设置该表上最后一次insert/update/delete, exchange/truncate/drop partition操作的时间。

    返回值类型:void。

  • pg_stat_get_last_updated(oid, text)

    描述:返回DBE_PERF.stat_all_tables, DBE_PERF.stat_all_indexes, DBE_PERF.statio_all_indexes, DBE_PERF.statio_all_tables视图中对各表各项监控指标字段更新的时间。入参1为表的oid,入参2为text类型,取值为"stat_table", "stat_index", "stat_io"。

    返回值类型:timestamptz。

  • pg_backend_pid()

    描述:当前会话的服务器线程的线程ID。

    返回值类型:integer。

  • pg_stat_get_activity(integer)

    描述:返回一个关于带有特殊PID的后台线程的记录信息,当参数为NULL时,则返回每个活动的后台线程的记录。返回结果不包含connection_info列。初始用户、系统管理员和MONADMIN可以查看所有的数据,普通用户只能查询自己的结果。

    示例:

    gaussdb=# SELECT * FROM pg_stat_get_activity(139881386280704);
     datid |       pid       | sessionid | usesysid | application_name | state  |                        query                         | waiting |          xact_start           |          query_start          |
        backend_start         |         state_change         | client_addr | client_hostname | client_port | enqueue |     query_id      |   srespool   | global_sessionid | unique_sql_id | trace_id
    -------+-----------------+-----------+----------+------------------+--------+------------------------------------------------------+---------+-------------------------------+-------------------------------+-----
    --------------------------+------------------------------+-------------+-----------------+-------------+---------+-------------------+--------------+------------------+---------------+----------
     16545 | 139881386280704 |        69 |       10 | gsql             | active | select * from pg_stat_get_activity(139881386280704); | f       | 2022-01-18 19:43:05.167718+08 | 2022-01-18 19:43:05.167718+08 | 2022
    -01-18 19:42:33.513507+08 | 2022-01-18 19:43:05.16773+08 |             |                 |          -1 |         | 72620543991624410 | default_pool | 1938253334#69#0  |    3751941862 |
    (1 row)
    

    返回值类型:setofrecord。

    返回参数说明如下。

    返回参数返回参数类型返回参数说明
    datidoid用户会话在后台连接到的数据库OID。
    pidbigint后台线程ID。
    sessionidbigint会话ID。
    usesysidoid登录该后台的用户OID。
    application_nametext连接到该后台的应用名。
    statetext该后台当前总体状态。
    querytext该后台的最新查询。如果state状态是active(活跃的),此字段显示当前正在执行的查询。所有其他情况表示上一个查询。
    waitingBoolean如果后台当前正等待锁则为true。
    xact_starttimestamp with time zone启动当前事务的时间,如果没有事务是活跃的,则为null。如果当前查询是首个事务,则这列等同于query_start列。
    query_starttimestamp with time zone开始当前活跃查询的时间,如果state的值不是active,则这个值是上一个查询的开始时间。
    backend_starttimestamp with time zone该过程开始的时间,即当客户端连接服务器时。
    state_changetimestamp with time zone上次状态改变的时间。
    client_addrinet连接到该后台的客户端的IP地址。如果此字段是null,它表明通过服务器机器上UNIX套接字连接客户端或者这是内部线程,如autovacuum。
    client_hostnametext客户端的主机名,这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。
    client_portinteger客户端用于与后台通讯的TCP端口号,如果使用Unix套接字,则为-1。
    enqueuetext该字段暂不支持。
    query_idbigint查询语句的ID。
    srespoolname资源池名字。
    global_sessionidtext全局会话id。
    unique_sql_idbigint语句的unique sql id。
    trace_idtext驱动传入的trace id,与应用的一次请求相关联。
  • pg_stat_get_activity_with_conninfo(integer)

    描述:返回一个关于带有特殊PID的后台线程的记录信息,当参数为NULL时,则返回每个活动的后台线程的记录。初始用户、系统管理员和MONADMIN可以查看所有的数据,普通用户只能查询自己的结果。

    返回值类型:setofrecord。

    返回值说明如下。

    返回值返回值类型返回值说明
    datidoid用户会话在后台连接到的数据库OID。
    pidbigint后台线程ID。
    sessionidbigint会话ID。
    usesysidoid登录该后台的用户OID。
    application_nametext连接到该后台的应用名。
    statetext该后台当前总体状态。
    querytext该后台的最新查询。如果state状态是active(活跃的),此字段显示当前正在执行的查询。所有其他情况表示上一个查询。
    waitingBoolean如果后台当前正等待锁则为true。
    xact_starttimestamp with time zone启动当前事务的时间,如果没有事务是活跃的,则为null。如果当前查询是首个事务,则这列等同于query_start列。
    query_starttimestamp with time zone开始当前活跃查询的时间,如果state的值不是active,则这个值是上一个查询的开始时间。
    backend_starttimestamp with time zone该过程开始的时间,即当客户端连接服务器时。
    state_changetimestamp with time zone上次状态改变的时间。
    client_addrinet连接到该后台的客户端的IP地址。如果此字段是null,它表明通过服务器机器上UNIX套接字连接客户端或者这是内部线程,如autovacuum。
    client_hostnametext客户端的主机名,这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。
    client_portinteger客户端用于与后台通讯的TCP端口号,如果使用Unix套接字,则为-1。
    enqueuetext该字段暂不支持。
    query_idbigint查询语句的ID。
    connection_infotextjson格式字符串,记录当前连接数据库的驱动类型、驱动版本号、当前驱动的部署路径、线程属主用户等信息。
    srespoolname资源池名字。
    global_sessionidtext全局会话ID。
    unique_sql_idbigint语句的unique sql id。
    trace_idtext驱动传入的trace id,与应用的一次请求相关联。
    top_xidxid事务的顶层事务ID。
    current_xidxid事务的当前事务ID。
    xlog_quantitybigint事务当前使用的XLOG量,单位为字节。
  • gs_get_explain(integer)

    描述:返回一个关于指定PID的后台线程的运行态计划,PID不能为空。该功能生效的必要条件是GUC参数track_activities为on,支持语句的范围为可以explain且其计划不包含STREAM算子的SQL。详细说明如下:

    • 若GUC参数plan_collect_thresh=-1,则该函数的返回结果一直为空。
    • 若GUC参数plan_collect_thresh=0,若当前SQL执行时间大于等于GUC参数log_min_duration_statement指定值,且计划中所有算子处理的tuple数量和大于等于10000时,开始收集运行态计划;且后续每当所有算子处理tuple数量的和的增量超过10000时,进行一次收集。
    • 若GUC参数plan_collect_thresh>0,会按照该参数指定的阈值进行增量收集运行态计划。
    • 另外,该函数只能看到在CN生成的计划,若查看在DN生成的计划,需要参考函数gs_get_dn_explain。

    返回值类型:text,具体各个字段的类型和含义如下:

    返回值返回值类型返回值说明
    运行态计划字符串text其中计划字符串中的A-rows是算子实时返回行数。
  • gs_get_dn_explain(text, bigint)

    描述:返回一个关于指定node name(来自pgxc_node系统表的node_name字段)和global session id的DN的后台线程的运行态计划,global session id不能为空。该功能生效的必要条件是GUC参数track_activities为on,支持语句的范围为可以explain且其计划不包含STREAM算子的SQL。详细说明如下:

    • 同函数gs_get_explain,其中global session id是由pg_stat_activity字段global_sessionid计算而来。global_sessionid格式如下:number1:{number1}:{number2}#{number3},样例为1938253334:1#0,那么gs_get_dn_explain函数的参数值应为number210000000000+{number2}*10000000000+{number1}。
    • 另外该函数需要ADMIN或MONADMIN权限才可执行。

    返回值类型:text,具体各个字段的类型和含义如下:

    返回值返回值类型返回值说明
    运行态计划字符串text其中计划字符串中的A-rows是算子实时返回行数。
  • pg_stat_get_activity_ng(integer)

    描述:返回一个关于带有特殊PID的活跃后台线程记录信息,当参数为NULL时,则返回每个活跃的后台线程的记录。系统管理员和MONADMIN可以查看所有的数据,普通用户只能查询自己的结果。

    返回值类型:setofrecord。

    函数返回字段说明如下:

    名称类型描述
    datidoid数据库oid。
    pidbigint后端线程的ID。
    sessionidbigint会话的id。
  • pg_stat_get_function_calls(oid)

    描述:函数已被调用次数。

    返回值类型:bigint。

  • pg_stat_get_function_self_time(oid)

    描述:只有在此函数所花费的时间。此函数嵌套调用其它函数所花费的时间被排除在外。

    返回值类型:bigint。

  • pg_stat_get_backend_idset()

    描述:设置当前活动的服务器线程数(从1到活动服务器线程的数量)。

    返回值类型:setofinteger。

  • pg_stat_get_backend_pid(integer)

    描述:给定的服务器线程的线程ID。

    返回值类型:bigint。

  • pg_stat_get_backend_dbid(integer)

    描述:给定服务器线程的数据库ID。

    返回值类型:oid。

  • pg_stat_get_backend_userid(integer)

    描述:给定服务器线程的用户ID,本函数仅系统管理员可调用。

    返回值类型:oid。

  • pg_stat_get_backend_activity(integer)

    描述:给定服务器线程的当前活动查询,仅在调用者是系统管理员或被查询会话的用户,并且打开track_activities的时候才能获得结果。

    返回值类型:text。

  • pg_stat_get_backend_waiting(integer)

    描述:如果给定服务器线程在等待某个锁,并且调用者是系统管理员或被查询会话的用户,并且打开track_activities的时候才返回真。

    返回值类型:Boolean。

  • pg_stat_get_backend_activity_start(integer)

    描述:给定服务器线程当前正在执行的查询的起始时间,仅在调用者是系统管理员或被查询会话的用户,并且打开track_activities的时候才能获得结果。

    返回值类型:timestampwithtimezone。

  • pg_stat_get_backend_xact_start(integer)

    描述:给定服务器线程当前正在执行的事务的开始时间,但只有当前用户是系统管理员或被查询会话的用户,并且打开track_activities的时候才能获得结果。

    返回值类型:timestampwithtimezone。

  • pg_stat_get_backend_start(integer)

    描述:给定服务器线程启动的时间,如果当前用户不是系统管理员或被查询的后端的用户,则返回NULL。

    返回值类型:timestampwithtimezone。

  • pg_stat_get_backend_client_addr(integer)

    描述:连接到给定客户端后端的IP地址。如果是通过Unix域套接字连接的则返回NULL;如果当前用户不是系统管理员或被查询会话的用户,也返回NULL。

    返回值类型:inet。

  • pg_stat_get_backend_client_port(integer)

    描述:连接到给定客户端后端的TCP端口。如果是通过Unix域套接字连接的则返回-1;如果当前用户不是系统管理员或被查询会话的用户,也返回NULL。

    返回值类型:integer。

  • pg_stat_get_bgwriter_timed_checkpoints()

    描述:后台写线程开启定时检查点的时间(因为checkpoint_timeout时间已经过期了)。

    返回值类型:bigint。

  • pg_stat_get_bgwriter_requested_checkpoints()

    描述:后台写线程开启基于后端请求的检查点的时间,因为已经超过了checkpoint_segments或因为已经执行了CHECKPOINT。

    返回值类型:bigint。

  • pg_stat_get_bgwriter_buf_written_checkpoints()

    描述:在检查点期间后台写线程写入的缓冲区数目。

    返回值类型:bigint。

  • pg_stat_get_bgwriter_buf_written_clean()

    描述:为日常清理脏块,后台写线程写入的缓冲区数目。

    返回值类型:bigint。

  • pg_stat_get_bgwriter_maxwritten_clean()

    描述:后台写线程停止清理扫描的时间,因为已经写入了更多的缓冲区(相比bgwriter_lru_maxpages参数声明的缓冲区数)。

    返回值类型:bigint。

  • pg_stat_get_buf_written_backend()

    描述:后端线程写入的缓冲区数,因为它们需要分配一个新的缓冲区。

    返回值类型:bigint。

  • pg_stat_get_buf_alloc()

    描述:分配的总缓冲区数。

    返回值类型:bigint。

  • pg_stat_clear_snapshot()

    描述:清理当前的统计快照。该函数仅SYSADMIN和MONADMIN可以执行。

    返回值类型:void。

  • pg_stat_reset()

    描述:为当前数据库重置统计计数器为0(需要系统管理员权限)。

    返回值类型:void。

  • gs_stat_reset()

    描述:将各节点上的为当前数据库重置统计计数器为0(需要系统管理员权限)。

    返回值类型:void。

  • pg_stat_reset_shared(text)

    描述:重置shared cluster每个节点当前数据统计计数器为0(需要系统管理员权限)。

    返回值类型:void。

  • pg_stat_reset_single_table_counters(oid)

    描述:为当前数据库中的一个表或索引重置统计为0(需要系统管理员权限)。

    返回值类型:void。

  • pg_stat_reset_single_function_counters(oid)

    描述:为当前数据库中的一个函数重置统计为0(需要系统管理员权限)。

    返回值类型:void。

  • pgxc_fenced_udf_process(integer)

    描述:查看UDF Master和Work线程数,仅SYSADMIN和MONADMIN用户有权限执行。入参为1时查看master线程数,入参为2时查看worker线程数,入参为3时终止所有worker线程。

    返回值类型:text。

  • fenced_udf_process(integer)

    描述:查看本地UDF Master和Work线程数。入参为1时查看master线程数,入参为2时查看worker线程数,入参为3时终止所有worker线程。

    返回值类型:text。

  • total_cpu()

    描述:获取当前节点使用的cpu时间,单位是jiffies。

    返回值类型:bigint。

  • total_memory()

    描述:获取当前节点使用的虚拟内存大小,单位KB。

    返回值类型:bigint。

  • pgxc_terminate_all_fenced_udf_process()

    描述:Kill所有的UDF Work线程,仅SYSADMIN和MONADMIN用户有权限执行。

    返回值类型:bool。

  • gs_get_nodegroup_tablecount(name)

    描述:得到一个节点组中所有数据库包含的用户表数目。

    返回值类型:integer。

  • gs_check_tables_distribution()

    描述: 检查当前系统中用户表的分布是否存在不一致,如果返回空记录,表示不存在不一致。该函数应该在非扩缩容重分布时调用。

    返回值类型:record。

  • pg_stat_bad_block(text, int, int, int, int, int, timestamp with time zone, timestamp with time zone)

    描述:获取当前节点自启动后,读取出现Page的损坏信息。

    返回值类型:record。

  • pgxc_stat_bad_block(text, int, int, int, int, int, timestamp with time zone, timestamp with time zone)

    描述:获取集群所有节点自启动后,读取出现Page的损坏信息。

    返回值类型:record。

  • pg_stat_bad_block_clear()

    描述:清理节点记录的读取出现的Page损坏信息(需要系统管理员权限)。

    返回值类型:void。

  • pgxc_stat_bad_block_clear

    描述:清理集群所有节点记录的读取出现的Page损坏信息(需要系统管理员权限)。

    返回值类型:void。

  • pgxc_log_comm_status(void)

    描述:当使用sctp(由于规格变更,当前版本已经不再支持本特性,请不要使用)通信模式时,PGXC系统视图将datanode的通信层状态输出到各个日志文件中。

    返回值类型:void。

  • gs_respool_exception_info(pool text)

    描述:查看某个资源池关联的查询规则信息。

    返回值类型:record。

  • gs_control_group_info(pool text)

    描述:查看资源池关联的控制组信息。该函数需要SYSADMIN权限的用户才能够执行。

    返回值类型:record。

    返回信息如下:

    属性属性值描述
    nameclass_a:workload_a1class和workload名称。
    classclass_aClass控制组名称。
    workloadworkload_a1Workload控制组名称。
    typeDEFWD控制组类型(Top、CLASS、BAKWD、DEFWD、TSWD)。
    gid87控制组id。
    shares30占父节点CPU资源的百分比。
    limits0占父节点CPU核数的百分比。
    rate0Timeshare中的分配比例。
    cpucores0-3CPU核心数。
  • gs_all_control_group_info()

    描述:查看数据库内所有的控制组信息。函数返回信息具体的字段16.3.48 GS_ALL_CONTROL_GROUP_INFO字段。

    返回值类型:record。

  • gs_get_control_group_info()

    描述:查看所有的控制组信息。函数返回信息具体的字段16.3.53 GS_GET_CONTROL_GROUP_INFO字段。该函数需要SYSADMIN权限的用户才能够执行。

    返回值类型:record。

  • get_instr_workload_info(integer)

    描述:获取当前CN节点上事务量信息,事务时间信息。

    返回值类型:record。

    属性属性值描述
    user_oid10用户id。
    commit_counter4前端事务commit数量。
    rollback_counter1前端事务rollback数量。
    resp_min949前端事务最小响应时间(单位:微秒)。
    resp_max201891前端事务最大响应时间(单位:微秒)。
    resp_avg43564前端事务平均响应时间(单位:微秒)。
    resp_total217822前端事务总响应时间(单位:微秒)。
    bg_commit_counter910后端事务commit数量。
    bg_rollback_counter0后端事务rollback数量。
    bg_resp_min97后端事务最小响应时间(单位:微秒)。
    bg_resp_max678080687后端事务最大响应时间(单位:微秒)。
    bg_resp_avg327847884后端事务平均响应时间(单位:微秒)。
    bg_resp_total298341575300后端事务总响应时间(单位:微秒)。
  • pv_instance_time()

    描述:获取当前节点上各个关键阶段的时间消耗。

    返回值类型:record。

    Stat_name属性属性值描述
    DB_TIME1062385所有线程端到端的墙上时间(WALL TIME)消耗总和(单位:微秒)。
    CPU_TIME311777所有线程CPU时间消耗总和(单位:微秒)。
    EXECUTION_TIME380037消耗在执行器上的时间总和(单位:微秒)。
    PARSE_TIME6033消耗在SQL解析上的时间总和(单位:微秒)。
    PLAN_TIME173356消耗在执行计划生成上的时间总和(单位:微秒)。
    REWRITE_TIME2274消耗在查询重写上的时间总和(单位:微秒)。
    PL_EXECUTION_TIME0消耗在plpgsql执行上的时间总和(单位:微秒)。
    PL_COMPILATION_TIME557消耗在SQL编译上的时间总和(单位:微秒)。
    NET_SEND_TIME1673消耗在网络发送上的时间总和(单位:微秒)。
    DATA_IO_TIME426622消耗在数据读写上的时间总和(单位:微秒)。
  • DBE_PERF.get_global_instance_time()

    描述:提供整个集群各个关键阶段的时间消耗,仅在CN上支持查询。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • get_instr_unique_sql()

    描述:获取当前节点的执行语句(归一化SQL)信息,查询该函数必须具有SYSADMIN权限或者MONADMIN权限。

    返回值类型:record。

  • get_instr_wait_event(integer)

    描述:获取当前节点event等待的统计信息。

    返回值类型:record。

  • get_instr_user_login()

    描述:获取当前节点的用户登录或者退出登录次数信息,查询该函数必须具有SYSADMIN或者MONADMIN权限。

    返回值类型:record。

  • get_instr_rt_percentile(integer)

    描述:获取CCN节点SQL 响应时间P80、P95分布信息,集群统一的信息在CCN节点上,其他节点查询为0。

    返回值类型:record。

  • get_node_stat_reset_time()

    描述:获取当前节点的统计信息重置(重启,主备倒换,数据库删除)时间。

    返回值类型:record。

  • gs_paxos_stat_replication()

    描述:在主机端查询备机信息。

    返回值类型:setofrecord。

    返回字段说明如下:

    字段名称字段类型字段说明
    local_roletext发送日志节点的角色。
    peer_roletext接收日志节点的角色。
    local_dcf_roletext发送日志节点的DCF角色。
    peer_dcf_roletext接收日志节点的DCF角色。
    peer_statetext接收日志节点的状态。
    sender_write_locationtext发送日志节点写到xlog buffer的位置。
    sender_commit_locationtext发送日志节点DCF日志达成一致性点。
    sender_flush_locationtext发送日志节点写到xlog disk的位置。
    sender_replay_locationtext发送日志节点replay的位置。
    receiver_write_locationtext接收日志节点写到xlog buffer的位置。
    receiver_commit_locationtext接收日志节点DCF日志达成一致性点。
    receiver_flush_locationtext接收日志节点写到xlog disk的位置。
    receiver_replay_locationtext接收日志节点重演xlog的位置。
    sync_percenttext同步百分比。
    dcf_run_modeint4DCF同步模式。
    channeltext信道信息。
  • get_paxos_replication_info()

    描述:查询Paxos模式下主机或备机的复制状态。

    返回值类型:setofrecord。

    返回字段说明如下:

    字段名称字段类型字段说明
    paxos_write_locationtext已经写入DCF的XLog位置。
    paxos_commit_locationtext已经在DCF中达成一致的XLog位置。
    local_write_locationtext节点的落盘位置。
    local_flush_locationtext节点的flush磁盘位置。
    local_replay_locationtext节点的redo磁盘位置。
    dcf_replication_infotext节点的DCF模块信息。
  • gs_wlm_get_user_info(int)

    描述:获取所有用户的相关信息,入参为int类型,可以为任意int值或NULL。该函数只有SYSADMIN权限的用户可以执行。

    返回值类型:record。

  • gs_wlm_readjust_user_space(oid)

    描述:修正所有用户的存储空间使用情况。该函数只有管理员用户可以执行。

    返回值类型:record。

  • gs_wlm_readjust_user_space_through_username(text name)

    描述:修正指定用户的存储空间使用情况。该函数普通用户只能修正自己的使用情况,只有管理员用户可以修正所有用户的使用情况。当name指定位“0000”,表示需要修正所有用户的使用情况。

    返回值类型:record。

  • gs_wlm_readjust_user_space_with_reset_flag(text name, boolean isfirst)

    描述:修正指定用户的存储空间使用情况。入参isfirst为true表示从0开始统计,否则从上一次结果继续统计。该函数普通用户只能修正自己的使用情况,只有管理员用户可以修正所有用户的使用情况。当name指定位“0000”,表示需要修正所有用户的使用情况。

    返回值类型:record。

  • gs_io_wait_status()

    描述:返回当前节点I/O管控的实时统计信息。

    返回值类型:setof record。

    名称类型描述
    node_nametext节点名称。
    device_nametext节点挂载的数据磁盘名称。
    read_per_secondfloat读完成每秒次数。
    write_per_secondfloat写完成每秒次数。
    write_ratiofloat写磁盘占总的I/O使用的比例。
    io_utilfloat每秒I/O所占CPU总时间的百分比。
    total_io_utilinteger过去三次I/O所占CPU总时间的等级(取值为0~6)。
    tick_countinteger更新磁盘IO信息的周期,固定为1秒,每次读取数据前都会被清零。
    io_wait_list_lenintegerI/O请求线程等待队列的大小,若为0,则表示当前没有I/O被管控。
  • gs_get_shared_memctx_detail(text)

    描述:返回指定内存上下文上的内存申请的详细信息,包含每一处内存申请所在的文件、行号和大小(同一文件同一行大小会做累加)。只支持查询通过pg_shared_memory_detail视图查询出来的内存上下文,入参为内存上下文名称(即pg_shared_memory_detail返回结果的contextname列)。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。

    返回值类型:setof record。

    名称类型描述
    filetext申请内存所在文件的文件名。
    lineint8申请内存所在文件的代码行号。
    sizeint8申请的内存大小,同一文件同一行多次申请会做累加。

    该视图不支持release版本小型化场景。

  • gs_get_session_memctx_detail(text)

    描述:返回指定内存上下文上的内存申请的详细信息,包含每一处内存申请所在的文件、行号和大小(同一文件同一行大小会做累加)。仅在线程池模式下生效。且只支持查询通过pv_session_memory_context视图查询出来的内存上下文,入参为内存上下文名称(即pv_session_memory_context返回结果的contextname列)。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。

    返回值类型:setof record。

    名称类型描述
    filetext申请内存所在文件的文件名。
    lineint8申请内存所在文件的代码行号。
    sizeint8申请的内存大小,单位为byte,同一文件同一行多次申请会做累加。

    该视图仅在线程池模式下生效,且该视图不支持release版本小型化场景。

  • gs_get_thread_memctx_detail(tid,text)

    描述:返回指定内存上下文上的内存申请的详细信息,包含每一处内存申请所在的文件、行号和大小(同一文件同一行大小会做累加)。只支持查询通过pv_thread_memory_context视图查询出来的内存上下文,第一个入参为线程id(即pv_thread_memory_context返回数据的tid列),第二个参数为内存上下文名称(即pv_thread_memory_context返回数据的contextname列)。查询该函数必须具有SYSADMIN权限或者MONADMIN权限。

    返回值类型:setof record。

    名称类型描述
    filetext申请内存所在文件的文件名。
    lineint8申请内存所在文件的代码行号。
    sizeint8申请的内存大小,单位为byte,同一文件同一行多次申请会做累加。

    该视图不支持release版本小型化场景。

  • gs_get_history_memory_detail(cstring)

    描述:查询历史内存快照信息,入参类型为cstring,取值为NULL或内存快照log文件名称:

    1. 若入参为NULL,则显示当前节点所有的内存快照log文件列表。
    2. 若入参为1查询到的列表中的内存快照log名称,则显示该log文件记录的内存快照详细信息。
    3. 若输入其他入参,则会提示入参错误或打开文件失败。

    查询该函数必须具有SYSADMIN权限或者MONADMIN权限。

    返回值类型:text。

    名称类型描述
    memory_infotext内存信息,如果函数入参为NULL,该列显示内存快照文件列表信息;入参为内存快照文件名称,则显示该文件的具体内容。
  • gs_stat_get_hotkeys_info()

    若GUC参数enable_hotkeys_collection = off, gs_stat_get_hotkeys_info、global_stat_get_hotkeys_info函数和global_stat_hotkeys_info视图无法正常查询。不影响gs_stat_clean_hotkeys和global_stat_clean_hotkeys清理接口的正常使用。

    描述:获取当前节点上热点key的统计情况。

    返回值类型:record。

    | ``` gaussdb=# SELECT * FROM gs_stat_get_hotkeys_info() order by count, hash_value; database_name | schema_name | table_name | key_value | hash_value | count ---------------+-------------+-------------------+-----------+------------+------- regression | public | hotkey_single_col | {22} | 1858004829 | 2 regression | public | hotkey_single_col | {11} | 2011968649 | 2 (2 rows)

    | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    
    | 名称            | 类型     | 描述                                     |
    | :------------ | :----- | :------------------------------------- |
    | database_name | text   | 热点key所在database名称。                     |
    | schema_name   | text   | 热点key所在schema名称。                       |
    | table_name    | text   | 热点key所在table名称。                        |
    | key_value     | text   | 热点key的value。                           |
    | hash_value    | bigint | 热点key在数据库中的哈希值,如果是List/Range分布表,该字段为0。 |
    | count         | bigint | 热点key被访问频次。                            |
    
    
  • gs_stat_clean_hotkeys()

    • 热点key检测是针对大并发大流量场景设计的特性,访问几次的场景,查询清理会存在一定误差。
    • 清理接口的设计上,只会清理LRU队列中的统计数据,而不会清理FIFO中的历史数据。因此如果清理完后,再访问一次FIFO中存在的历史键值,仍会被当做热点key处理。global_stat_clean_hotkeys同理。

    描述:清理当前节点上热点key的统计信息。

    返回值:boolean

    | ``` gaussdb=# SELECT * FROM gs_stat_clean_hotkeys(); gs_stat_clean_hotkeys ----------------------- t (1 row)

    | ------------------------------------------------------------------------------------------------------------------- |
    
    
  • global_stat_get_hotkeys_info()

    执行业务过程中,执行select * from global_stat_hotkeys_info minus select * from global_stat_get_hotkeys_info();因为存在时间差,可能出现不为0的情况。

    描述:获取整个集群中热点key的统计情况。

    返回值类型:record。

    | ``` gaussdb=# SELECT * FROM global_stat_get_hotkeys_info() order by count, hash_value; database_name | schema_name | table_name | key_value | hash_value | count ---------------+-------------+-------------------+-----------+------------+------- regression | public | hotkey_single_col | {22} | 1858004829 | 2 regression | public | hotkey_single_col | {11} | 2011968649 | 2 (2 rows)

    | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    
    
  • global_stat_clean_hotkeys()

    描述:清理整个集群中热点key的统计信息。

    返回值:boolean。

    | ``` gaussdb=# SELECT * FROM global_stat_clean_hotkeys(); global_stat_clean_hotkeys ----------------------- t (1 row)

    | --------------------------------------------------------------------------------------------------------------------------- |
    
    
  • global_comm_get_recv_stream()

    描述:获取所有DN节点上所有的通信库接收流状态。函数返回信息具体字段参考PG_COMM_RECV_STREAM字段。

    返回值类型:record。

  • global_comm_get_send_stream()

    描述:获取所有DN节点上所有的通信库发送流状态。函数返回信息具体字段参考PG_COMM_SEND_STREAM字段。

    返回值类型:record。

  • global_comm_get_status()

    描述:获取所有DN节点的通信库状态。函数返回信息具体字段参考PG_COMM_STATUS字段。

    返回值类型:record。

  • global_comm_client_info()

    描述:获取全局节点活跃的客户端连接信息。函数返回信息具体字段参考COMM_CLIENT_INFO字段。

    返回类型:record。

  • global_comm_get_client_info()

    描述:获取全局节点客户端连接信息。函数返回信息具体字段参考COMM_CLIENT_INFO字段。

    返回类型:record。

  • pgxc_stat_activity()

    描述:显示当前集群下所有CN的当前用户查询相关的信息,该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行,普通用户可查看本用户的相关信息。505.0.0版本新增三列信息,灰度升级观察期中执行会报错,需使用PG_STAT_ACTIVITY直连目标节点进行查询。

    返回值类型:record。

    名称类型描述
    coornametext当前集群下的CN名称。
    datidoid用户会话在后台连接到的数据库OID。
    datnametext用户会话在后台连接到的数据库名称。
    pidbigint后台线程ID。
    sessionidbigint会话ID。
    usesysidoid登录该后台的用户OID。
    usenametext登录该后台的用户名。
    application_nametext连接到该后台的应用名。
    client_addrinet连接到该后台的客户端的IP地址。如果此字段是null,它表明通过服务器机器上UNIX套接字连接客户端或者这是内部线程,如autovacuum。
    client_hostnametext客户端的主机名,这个字段是通过client_addr的反向DNS查找得到。这个字段只有在启动log_hostname且使用IP连接时才非空。
    client_portinteger客户端用于与后台通讯的TCP端口号,如果使用Unix套接字,则为-1。
    backend_starttimestamp with time zone该过程开始的时间,即当客户端连接服务器的时间。
    xact_starttimestamp with time zone启动当前事务的时间,如果没有事务是活跃的,则为null。如果当前查询是首个事务,则这列等同于query_start列。
    query_starttimestamp with time zone开始当前活跃查询的时间,如果state的值不是active,则这个值是上一个查询的开始时间。
    state_changetimestamp with time zone上次状态改变的时间。
    waitingboolean如果后台当前正等待锁则为true。
    enqueuetext语句当前排队状态。可能值是:- waiting in queue:表示语句在排队中。
    • 空:表示语句正在运行。 | | state | text | 该后台当前总体状态。可能值是:- active:后台正在执行一个查询。
    • idle:后台正在等待一个新的客户端命令。
    • idle in transaction:后台在事务中,但事务中没有语句在执行。
    • idle in transaction (aborted):后台在事务中,但事务中有语句执行失败。
    • fastpath function call:后台正在执行一个fast-path函数。
    • disabled:如果后台禁用track_activities,则报告这个状态。说明:只有系统管理员能查看到自己账户所对应的会话状态。其他账户的state信息为空。例如以judy用户连接数据库后,在pgxc_stat_activity中查看到的普通用户joe及初始用户omm的state信息为空:``` SELECT datname, usename, usesysid, state,pid FROM pgxc_stat_activity;
     datname  | usename | usesysid | state  |       pid ----------+---------+----------+--------+-----------------  testdb | omm     |       10 |        | 139968752121616  testdb | omm     |       10 |        | 139968903116560  db_tpcds | judy    |    16398 | active | 139968391403280  testdb | omm     |       10 |        | 139968643069712  testdb | omm     |       10 |        | 139968680818448  testdb | joe     |    16390 |        | 139968563377936 (6 rows)
    ``` |
    | resource_pool    | name                     | 用户使用的资源池。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
    | query_id         | bigint                   | 查询语句的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
    | query            | text                     | 该后台的最新查询。如果state状态是active(活跃的),此字段显示当前正在执行的查询。所有其他情况表示上一个查询。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
    | global_sessionid | text                     | 全局会话ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
    | unique_sql_id    | bigint                   | 语句的unique sql id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
    | trace_id         | text                     | 驱动传入的trace id,与应用的一次请求相关联。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
    | top_xid          | xid                      | 事务的顶层事务ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
    | current_xid      | xid                      | 事务的当前事务ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
    | xlog_quantity    | bigint                   | 事务当前使用的XLOG量,单位为字节。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
    
    
  • pgxc_stat_activity_with_conninfo()

    描述:显示当前集群下所有CN的当前用户查询相关的信息,返回值定义参考pgxc_stat_activity视图。该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行,普通用户只能查看本用户相关的信息。

    返回值类型:record。

  • pgxc_stat_all_tables()

    描述:显示各节点数据中每个表(包括TOAST表)的一行的统计信息,该函数仅具有SYSADMIN或者MONADMIN权限的用户可以执行。

    返回值类型:record。

  • pgxc_get_thread_wait_status()

    描述:查看集群各个节点上所有SQL语句产生的线程之间的调用层次关系,以及各个线程的阻塞等待状态。

    返回值类型:record。

  • pv_session_memory

    描述:统计Session级别的内存使用情况,包含执行作业在数据节点上GaussDB线程和Stream线程分配的所有内存。

    若GUC参数enable_memory_limit=off,该函数不能使用。

    返回值类型:record。

    名称类型描述
    sessidtext线程启动时间+线程标识。
    init_meminteger当前正在执行作业进入执行器前已分配的内存,单位MB。
    used_meminteger当前正在执行作业已分配的内存,单位MB。
    peak_meminteger当前正在执行作业已分配的内存峰值,单位MB。
  • DBE_PERF.gs_stat_activity_timeout(int)

    描述:获取当前节点上执行时间超过超时阈值的查询作业信息。需要GUC参数track_activities设置为on才能正确返回结果。超时阈值的取值范围是0~2147483。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:setof record。

    名称类型描述
    databasename用户会话连接的数据库名称。
    pidbigint后台线程ID。
    sessionidbigint会话ID。
    usesysidoid登录该后台的用户OID。
    application_nametext连接到该后台的应用名。
    querytext该后台正在执行的查询。
    xact_starttimestamptz启动当前事务的时间。
    query_starttimestamptz开始当前查询的时间。
    query_idbigint查询语句ID。
  • DBE_PERF.global_stat_activity_timeout(int)

    描述:获取当前系统(所有CN)中执行时间超过超时阈值的查询作业信息。需要GUC参数track_activities设置为on才能正确返回结果。超时阈值的取值范围是0~2147483。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:setof record。

    名称类型描述
    nodenametext用户会话连接的coordinate node的名称。
    databasename用户会话连接的数据库名称。
    pidbigint后台线程ID。
    sessionidbigint会话ID。
    usesysidoid登录该后台的用户OID。
    application_nametext连接到该后台的应用名。
    querytext该后台正在执行的查询。
    xact_starttimestamptz启动当前事务的时间。
    query_starttimestamptz开始当前查询的时间。
    query_idbigint查询语句ID。
  • DBE_PERF.get_global_active_session()

    描述:显示所有节点上的ACTIVE SESSION PROFILE内存中的样本的汇总。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。505.0版本新增event_start_time、current_xid、top_xid三个字段信息,由低于505.0版本升级至505.0或更高版本时,升级观察期无法查询。

    返回值类型:record。

  • DBE_PERF.get_global_os_runtime()

    描述:显示当前操作系统运行的状态信息,仅在CN上支持查询。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record

  • DBE_PERF.get_global_os_threads()

    描述:提供整个集群中所有正常节点下的线程状态信息,仅在CN上支持查询。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_os_threads()

    描述:提供整个集群中所有正常节点下的线程状态信息,仅在CN上支持查询。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_workload_sql_count()

    描述:提供整个集群中不同负载SELECT,UPDATE,INSERT,DELETE,DDL, DML,DCL计数信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_workload_sql_elapse_time()

    描述:提供整个集群中不同负载SELECT、UPDATE、INSERT和DELETE,响应时间信息(TOTAL、AVG、MIN、MAX)。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_workload_transaction()

    描述:获取集群内所有节点上的事务量信息,事务时间信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_session_stat()

    描述:获取集群内所有节点上的会话状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

    状态信息有如下14项,ommit,rollback,sql,table_scan,blocks_fetched,physical_read_operation,shared_blocks_dirtied,local_blocks_dirtied,shared_blocks_read,local_blocks_read,blocks_read_time,blocks_write_time,sort_imemory,sort_idisk。

  • DBE_PERF.get_global_session_time()

    描述:提供整个集群各节点各个关键阶段的时间消耗。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_session_memory()

    描述:汇聚各节点的Session级别的内存使用情况,包含执行作业在数据节点上gaussdb线程和Stream线程分配的所有内存,单位为MB。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_session_memory_detail()

    描述:汇聚各节点的线程的内存使用情况,以MemoryContext节点来统计。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_session_stat_activity()

    描述:汇聚集群内各节点上正在运行的线程相关的信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_thread_wait_status()

    描述:汇聚所有节点上工作线程(backend thread)以及辅助线程(auxiliary thread)的阻塞等待情况。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_ec_history()

    描述:汇聚当前用户在每个CN上EC算子的历史状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_ec_history_table()

    描述:汇聚当前用户在每个CN上EC算子的历史状态信息(持久化)。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_ec_runtime()

    描述:汇聚当前用户在每个CN上EC算子的实时状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_history_table()

    描述:汇聚当前用户所有CN上执行作业结束后的算子相关记录(持久化)。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_history()

    描述:汇聚当前用户所有CN上执行作业结束后的算子相关记录。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_operator_runtime()

    描述:汇聚当前用户所有CN上执行作业实时的算子相关记录。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statement_complex_history()

    描述:汇聚当前用户所有CN节点上复杂查询的历史记录。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statement_complex_history_table()

    描述:汇聚当前用户所有CN节点上复杂查询的历史记录(持久化)。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statement_complex_runtime()

    描述:汇聚当前用户所有CN节点上复杂查询的实时信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN和SYSADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_memory_node_detail()

    描述:汇聚某个数据库在所有节点上的内存使用情况。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_shared_memory_detail()

    描述:汇聚所有节点已产生的共享内存上下文的使用信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_comm_delay()

    描述:汇聚所有DN节点的通信库时延状态。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_comm_recv_stream()

    描述:汇聚所有DN节点的通信库接收流状态。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_comm_send_stream()

    描述:汇聚所有DN节点的通信库发送流状态。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_comm_status()

    描述:汇聚所有DN节点的通信库状态。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_all_indexes()

    描述:汇聚所有节点当前数据库中的索引信息及I/O统计量。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_local_toastname_and_toastindexname()

    描述:提供本地toast表的name和index和其关联表的对应关系。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_all_indexes()

    描述:统计所有节点当前数据库中的每个索引行,显示特定索引的I/O的统计。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_all_sequences()

    描述:提供命名空间中所有sequences的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_all_tables()

    描述:汇聚各节点的数据库中每个表I/O的统计。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_all_tables()

    描述:统计集群内数据库中每个表I/O的统计。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_local_toast_relation()

    描述:提供本地toast表的name和其关联表的对应关系。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_sys_indexes()

    描述:汇聚各节点的命名空间中所有系统表索引的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_sys_indexes()

    描述:统计各节点的命名空间中所有系统表索引的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_sys_sequences()

    描述:提供命名空间中所有系统表为sequences的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_sys_tables()

    描述:提供各节点的命名空间中所有系统表的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_sys_tables()

    描述:集群内汇聚命名空间中所有系统表的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_user_indexes()

    描述:各节点的命名空间中所有用户关系表索引的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_user_indexes()

    描述:集群内汇聚命名空间中所有用户关系表索引的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_user_sequences()

    描述:显示各节点的命名空间中所有用户的sequences的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_global_statio_user_tables()

    描述:显示各节点的命名空间中所有用户关系表的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

  • DBE_PERF.get_summary_statio_user_tables()

    描述:集群内汇聚命名空间中所有用户关系表的IO状态信息。集群创建后的默认情况下,查询该函数必须具有MONADMIN权限。

    返回值类型:record。

更多详情请参考GaussDB 文档中心:doc.hcs.huawei.com/db/zh-cn/ga…