数据仓库服务 GAUSSDB(DWS)-扫描残留文件函数:pgxc_archive_scan_residualfiles(query_flag)

时间:2024-11-28 17:39:02

pgxc_archive_scan_residualfiles(query_flag)

描述:pg_archive_scan_residualfiles()的CN统一执行函数。该函数为集群级函数,与当前所在的数据库相关,在CN实例上运行。

参数说明:query_flag。参数类型int,用于表示执行范围,1表示CN,2表示主DN,4表示备DN,通过或运算可以得到查询并集,如1|2=3表示CN+主DN,1|2|4=7表示CN+主DN+备DN,默认值是7。

返回类型:record

返回信息如下:

表6 返回字段

名称

类型

描述

nodename

name

节点名称。

instance_id

text

实例名称。

archive

text

残留文件归档路径。

count

bigint

归档的残留文件数量。

size

bigint

归档的残留文件总大小,单位为byte。

示例:

1
2
3
4
5
6
SELECT * FROM pgxc_archive_scan_residualfiles();
  node_name   | instance_id |                           archive                            | count | size  
--------------+-------------+--------------------------------------------------------------+-------+-------
 cn_5001      | cn_5001     | pg_residualfiles/archive/pgscrf_archive_20231027145050896440 |     1 | 40960
 dn_6007_6008 | dn_6008     | pg_residualfiles/archive/pgscrf_archive_20231027145051018138 |     1 | 24576
(2 rows)
  • 此函数只能归档当前登录的数据库中记录过的残留文件,归档时会记录中的残留文件进行相应的校验,校验结果分为以下三种情况:
    • 校验通过:校验通过后会对残留文件进行归档,并标记为已处理。
    • 校验失败:校验失败会跳过归档,并标记为已处理。
    • 延迟校验:延迟校验会跳过归档,通常表示当前未满足校验时机,延迟校验的情况通常和事务完成情况及备机REDO进度有关。
  • 实际归档目录与对应表空间在同一个文件系统下,删除表空间也会删除对应的残留文件归档。
  • 延迟DDL开启后,此函数无法使用。
  • 此函数为重载操作,不支持单节点并发使用,也不建议在业务繁忙和资源负载较高时使用。
support.huaweicloud.com/sqlreference-830-dws/dws_06_0373.html