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

时间：2025-02-26 16:12:43

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	归档后的本地文件夹路径。OBS路径的残留文件归档在对应OBS数据库目录下。
count	bigint	归档的残留文件数量。
size	bigint	归档的残留文件总大小，单位为byte。

示例：

  
       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开启后，此函数无法使用。
此函数为重载操作，不支持单节点并发使用，也不建议在业务繁忙和资源负载较高时使用。