SHOW RESTORE STATUS

功能概述

SHOW RESTORE STATUS

SHOW RESTORE STATUS

用于查看

RESTORE TABLE

RESTORE TABLE

归档文件取回任务的状态。由于归档文件取回是异步操作，提交

RESTORE TABLE

RESTORE TABLE

后，必须使用本命令确认文件已经从

RESTORING

RESTORING

变为

RESTORED

RESTORED

，再读取或导入文件。

SHOW RESTORE STATUS [<namespace>.]<table_name> SUBDIRECTORY '<path>';

参数	说明
`<namespace>` <namespace>	可选。表所属的 schema 名称。省略时使用当前 schema。
`<table_name>` <table_name>	执行过 `RESTORE TABLE` RESTORE TABLE 的表名称。
`SUBDIRECTORY '<path>'` SUBDIRECTORY '<path>'	指定要查询的归档文件子目录，应与 `RESTORE TABLE` RESTORE TABLE 使用的目录一致。

SHOW RESTORE STATUS public.doc_archive_orders SUBDIRECTORY 'archive/20260829/';

取回进行中时，返回结果示例：

file	state
`archive/20260829/part00001` archive/20260829/part00001	`{"status":"RESTORING"}` {"status":"RESTORING"}

再次执行相同查询，直到状态变为

RESTORED

RESTORED

：

SHOW RESTORE STATUS public.doc_archive_orders SUBDIRECTORY 'archive/20260829/';

file	state
`archive/20260829/part00001` archive/20260829/part00001	`{"status":"RESTORED"}` {"status":"RESTORED"}

只有

RESTORED

RESTORED

状态的文件才可以作为可读数据使用。当前版本返回

file

file

和

state

state

两列，其中

state

state

是包含状态信息的 JSON 字符串。