openGauss SQL参考—函数和操作符：其它函数（5）

• get_prepared_pending_xid

  描述：当恢复完成时，返回nextxid。

  参数：nan

  返回值类型：text

• pg_clean_region_info

  描述：清理regionmap。

  参数：nan

  返回值类型：character varying

• pg_get_delta_info

  描述：从单个dn获取delta info。

  参数：rel text、 schema_name text

  返回值类型：part_name text、 live_tuple bigint、 data_size bigint、 blocknum bigint

• pg_get_replication_slot_name

  描述：获取slot name。

  参数：nan

  返回值类型：text

• pg_get_running_xacts

  描述：获取运行中的xact。

  参数：nan

  返回值类型：handle integer、 gxid xid、 state tinyint、 node text、 xmin xid、 vacuum boolean、 timeline bigint、 prepare_xid xid、 pid bigint、 next_xid xid

• pg_get_variable_info

  描述：获取共享内存变量cache。

  参数：nan

  返回值类型：node_name text、 nextOid oid、 nextXid xid、 oldestXid xid、 xidVacLimit xid、 oldestXidDB oid、 lastExtendCSNLogpage xid、 startExtendCSNLogpage xid、 nextCommitSeqNo xid、 latestCompletedXid xid、 startupMaxXid xid

• pg_get_xidlimit

  描述：从共享内存获取事物id信息。

  参数：nan

  返回值类型：nextXid xid、 oldestXid xid、 xidVacLimit xid、 xidWarnLimit xid、 xidStopLimit xid、 xidWrapLimit xid、 oldestXidDB oid

• get_global_user_transaction()

  描述：返回所有节点上各用户的事务相关信息。

  返回值类型：node_name name、 usename name、 commit_counter bigint、 rollback_counter bigint、 resp_min bigint、 resp_max bigint、 resp_avg bigint、 resp_total bigint、 bg_commit_counter bigint、 bg_rollback_counter bigint、 bg_resp_min bigint、 bg_resp_max bigint、 bg_resp_avg bigint、 bg_resp_total bigint

• pg_collation_for

  描述：返回入参字符串对应的排序规则。

  参数：any（如果是常量必须进行显式类型转换）

  返回值类型：text

• pgxc_unlock_for_sp_database(name Name)

  描述：释放指定数据库锁。

  参数：数据库名

  返回值类型：布尔

• pgxc_lock_for_sp_database(name Name)

  描述：对指定的数据库加锁。

  参数：数据库名

  返回值类型：布尔

• copy_error_log_create()

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

  返回值类型：Boolean

   说明：

  • 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见表6。

  • 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。

  • 由于尝试创建的public.pgxc_copy_error_log定义是一张行存表，因此数据库实例上必须支持行存表的创建才能够正常运行此函数，并使用后续的COPY容错功能。需要特别注意的是，enable_hadoop_env这个GUC参数开启后会禁止在数据库实例内创建行存表（openGauss默认为off）。

  • 此函数自身权限为Sysadmin及以上（与错误表、COPY权限一致）。

  • 若创建前public.pgxc_copy_error_log表已存在或者copy_error_log_relname_idx索引已存在，则此函数会报错回滚。

  表 9 错误表public.pgxc_copy_error_log信息

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

• dynamic_func_control(scope text, function_name text, action text, “{params}” text[])

  描述：动态开启内置的功能，当前仅支持动态开启全量SQL。

  返回值类型：record

  表 10 dynamic_func_control参数说明

  参数	类型	描述
  scope	text	动态开启功能的范围，当前仅支持'LOCAL'。
  function_name	text	功能的名称，当前仅支持'STMT'。
  action	text	当function_name为'STMT'时，action仅支持TRACK/UNTRACK/LIST/CLEAN： TRACK - 开始记录归一化SQL的全量SQL信息。 UNTRACK - 取消记录归一化SQL的全量SQL信息。 LIST - 列取当前TRACK的归一化SQL的信息。 CLEAN - 清理记录当前归一化SQL的信息。
  params	text[]	当function_name为'STMT'时，对应不同的action时，对应的params设置如下： TRACK - '{"归一化SQLID", "L0/L1/L2"}' UNTRACK - '{"归一化SQLID"}' LIST - '{}' CLEAN - '{}'