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

时间:2024-12-06 15:12:47

pg_archive_scan_residualfiles()

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

返回类型:record

返回信息如下:

表5 返回字段

名称

类型

描述

archive

text

归档后的本地文件夹路径。OBS路径的残留文件归档在对应OBS数据库目录下。

count

bigint

归档的残留文件数量。

size

bigint

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

示例:

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