其它函数

• pgxc_pool_check()

  描述：检查连接池中缓存的连接数据是否与pgxc_node一致。

  返回值类型：Boolean

• pgxc_pool_reload()

  描述：更新连接池中缓存的连接信息。

  返回值类型：Boolean

• pgxc_lock_for_backup()

  描述：为备份操作给openGauss加锁，这些备份是为在新增节点上做恢复。

  返回值类型：Boolean

• plan_seed()

  描述：获取前一次查询语句的seed值（内部使用）。

  返回值类型：int

• pg_stat_get_env()

  描述：提供获取当前节点的环境变量信息。

  返回值类型：record

• pg_stat_get_thread()

  描述：提供当前节点下所有线程的状态信息。

  返回值类型：record

• pg_stat_get_sql_count()

  描述：提供当前节点中所有用户执行的SELECT/UPDATE/INSERT/DELETE/MERGE INTO语句的计数结果。

  返回值类型：record

• copy_error_log_create()

  描述：创建COPY FROM容错机制所需要的错误表（public.pgxc_copy_error_log）。

  返回值类型：Boolean

  说明：
  - 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见表1。
  - 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。
  - 由于尝试创建的public.pgxc_copy_error_log定义是一张行存表，因此openGauss上必须支持行存表的创建才能够正常运行此函数，并使用后续的COPY容错功能。需要特别注意的是，enable_hadoop_env这个GUC参数开启后会禁止在openGauss内创建行存表（openGauss默认为off）。
  - 此函数自身权限为Sysadmin及以上（与错误表、COPY权限一致）。
  - 若创建前public.pgxc_copy_error_log表已存在或者copy_error_log_relname_idx索引已存在，则此函数会报错回滚。

  表 1 错误表public.pgxc_copy_error_log信息

  列名称	类型	描述
  relname	varchar	表名称。以模式名.表名形式显示。
  begintime	timestamp with time zone	出现数据格式错误的时间。
  filename	character varying	出现数据格式错误的数据源文件名。
  rownum	bigint	在数据源文件中，出现数据格式错误的行号。
  rawrecord	text	在数据源文件中，出现数据格式错误的原始记录。
  detail	text	详细错误信息。

• pg_stat_get_data_senders()

  描述：提供当前活跃的数据复制发送线程的详细信息。

  返回值类型：record

• generate_wdr_report(begin_snap_id Oid, end_snap_id Oid, int report_type, int report_scope, int node_name)

  描述：基于两个snapshot生成系统诊断报告。

  返回值类型：record

  表 2 generate_wdr_report 参数说明

  参数	说明	取值范围
  begin_snap_id	生成某段时间内性能诊断报告的开始snapshotid。	-
  end_snap_id	结束snapshot的id，默认end_snap_id大于begin_snap_id。	-
  report_type	指定生成report的类型。	summary detail all，即同时包含summary 和 detail。
  report_scope	指定生成report的范围。	node：openGauss中的节点。
  node_name	在“report_scope”指定为“node”时，需要把该参数指定为对应节点的名称。	-

• create_wdr_snapshot(stat text, dbid Oid)

  描述：手工生成系统诊断快照。

  返回值类型：record

  表 3 create_wdr_snapshot参数说明

  参数	描述
  stat	表示每次snapshot时节点的名称，默认为收集所有节点的状态信息。
  dbid	表示数据库的ID，收集指定数据库的状态信息。

• wdr_xdb_query(db_name_str text, query text)

  描述：提供本地跨数据库执行query的能力。例如: 在连接到postgres库时, 访问test库下的表。

  select col1 from wdr_xdb_query('dbname=test','select col1 from t1') as dd(col1 int);

  返回值类型：record

• pg_wlm_jump_queue(pid int)

  描述：调整任务到数据库主节点队列的最前端。

  返回值类型：boolean

  • true：成功。
  • false：失败。

• gs_wlm_switch_cgroup(pid int, cgroup text)

  描述：调整作业的优先级到新控制组。

  返回值类型：boolean

  • true：成功。
  • false：失败。

• pv_session_memctx_detail(threadid tid, MemoryContextName text)

  描述：将线程tid的MemoryContextName内存上下文信息记录到“/tmp/dumpmem”目录下的“threadid_timestamp.log”文件中。其中threadid可通过表PV_SESSION_MEMORY_DETAIL中的sessid后获得。当MemoryContextName为 “ 时，会记录所有的内存上下文信息。

  返回值类型：boolean

  • true：成功。
  • false：失败。

• pg_shared_memctx_detail(MemoryContextName text)

  描述：将MemoryContextName内存上下文信息记录到“/tmp/dumpmem”目录下的“threadid_timestamp.log”文件中。

  返回值类型：boolean

  • true：成功。
  • false：失败。

说明：
pgxc_lock_for_backup是在使用gs_dump或gs_dumpall工具备份openGauss前，用来给openGauss加锁的。当给openGauss加锁后，不允许有改变系统结构的操作。该函数不影响DML语句。