如何在Databricks Unity Catalog中将Schema内的表迁移至Volume？

直接用dbutils.fs.mv移动UC表的底层存储路径行不通，原因有两个：

• UC对托管/外部表的存储路径有严格的元数据绑定，手动移动文件会导致元数据与实际存储位置脱节，破坏表的可用性
• LOCATION_OVERLAP错误说明你操作的源路径（表的底层存储）和目标Volume路径可能同属一个存储容器，UC的存储规则禁止这种直接的跨路径移动操作

正确的迁移方案 #

根据表的类型，选择对应的方法：

1. 通用方案：通过CTAS创建Volume内的新表

这是最安全的方式，不管是托管表还是外部表都适用：

-- 在目标Volume下创建新表，同时复制原表数据
CREATE TABLE my_schema.my_table_in_volume
LOCATION '/Volumes/usr/my_schema/my_volume/my_table'
AS SELECT * FROM my_schema.my_table;

-- 验证数据无误后，可删除原表（按需操作）
DROP TABLE my_schema.my_table;

-- 可选：将新表重命名为原表名
ALTER TABLE my_schema.my_table_in_volume RENAME TO my_schema.my_table;

2. 外部表专属方案：删除原表后重新绑定Volume路径

如果原表是外部表（删除表不会删除底层数据），可以先解绑原表元数据，再将数据关联到Volume：

-- 删除原表（仅删除元数据，保留底层数据）
DROP TABLE my_schema.my_table;

-- 在Volume路径下重新创建外部表，复用原表结构
CREATE TABLE my_schema.my_table
LOCATION '/Volumes/usr/my_schema/my_volume/my_table'
LIKE my_schema.my_table_old; -- 若原表已删，需提前备份表结构或手动定义字段

-- 刷新表元数据，确保数据可见
REFRESH TABLE my_schema.my_table;

关键注意事项 #

• 迁移前务必备份原表，避免数据丢失
• 确保你对目标Volume拥有WRITE权限
• 分区表使用CTAS会自动同步分区结构，无需额外处理
• 永远不要直接操作UC托管表的底层存储路径，所有表操作优先通过SQL完成，保证元数据与存储的一致性

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