Snowflake外部表手动刷新失败求助：UNREGISTER_FAILED错误排查

问题描述 #

尝试手动刷新Snowflake外部表失败，因无固定周期无法设置自动刷新。操作步骤如下：

1. 创建外部表（已验证可正常加载数据）：

CREATE OR REPLACE EXTERNAL TABLE  DB.PUBLIC.TABLE_1( <columns goes here> ) LOCATION = @S3_stage/table_1/ FILE_FORMAT = ( FORMAT_NAME = 'parquet' );

2. 执行刷新指定路径语句失败：

ALTER EXTERNAL TABLE DB.PUBLIC.TABLE_1 REFRESH @S3_stage/table_1/date_year=2024/date_month=5/;

3. 尝试移除该路径文件时同样失败，返回错误UNREGISTER_FAILED，描述为File unregistration failed: No such file.，但结果中显示的路径table_1/date_year=2024/date_month=5/是正确的。

问题原因与解决方法 #

• 路径格式错误：
  使用REFRESH或REMOVE FILES时，无需包含stage前缀（@S3_stage/），也不能以斜杠结尾。外部表的LOCATION已指定@S3_stage/table_1/，后续操作只需传入相对于该根路径的子路径。
• 操作对象错误：
  Snowflake的外部表刷新/移除操作针对具体数据文件而非目录。直接指定目录路径会报错，因为系统找不到对应的文件条目。

正确操作示例 #

1. 刷新指定子路径下的所有文件：

ALTER EXTERNAL TABLE DB.PUBLIC.TABLE_1 REFRESH 'date_year=2024/date_month=5';

2. 移除指定子路径下的所有文件（用通配符匹配）：

ALTER EXTERNAL TABLE DB.PUBLIC.TABLE_1 REMOVE FILES ('date_year=2024/date_month=5/*');

额外验证步骤 #

• 执行LIST @S3_stage/table_1/date_year=2024/date_month=5/确认该路径下存在具体的Parquet文件，确保路径和文件都真实存在。
• 若使用分区外部表，检查分区键定义是否正确，避免因分区映射问题导致路径匹配失败。

内容的提问来源于stack exchange，提问作者Valentina Flores