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

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

pg_archive_scan_residualfiles()

描述：用于归档当前节点所连接数据库上所有扫描到的残留文件记录。该函数为实例级函数，与当前所在的数据库相关，可以在任意实例上运行。

返回类型：record

返回信息如下：

表5 返回字段
名称	类型	描述
archive	text	归档后的本地文件夹路径。OBS路径的残留文件归档在对应OBS数据库目录下。
count	bigint	归档的残留文件数量。
size	bigint	归档的残留文件总大小，单位为byte。

示例：

  
       SELECT * FROM pg_archive_scan_residualfiles();
                           archive                            | count | size  
--------------------------------------------------------------+-------+-------
 pg_residualfiles/archive/pgscrf_archive_20231027144613791801 |     4 | 81920
(1 row)

此函数只能归档当前登录的数据库中记录过的残留文件，归档时会记录中的残留文件进行相应的校验，校验结果分为以下三种情况：
- 校验通过：校验通过后会对残留文件进行归档，并标记为已处理。
- 校验失败：校验失败会跳过归档，并标记为已处理。
- 延迟校验：延迟校验会跳过归档，通常表示当前未满足校验时机，延迟校验的情况通常和事务完成情况及备机REDO进度有关。
实际归档目录与对应表空间在同一个文件系统下，删除表空间也会删除对应的残留文件归档。
延迟DDL开启后，此函数无法使用。
此函数为重载操作，不支持单节点并发使用，也不建议在业务繁忙和资源负载较高时使用。