用途:在 Databricks 弃用旧版 Hive Metastore 前,端到端试点 HMS→Unity Catalog 迁移。资料称 2026-09-30 为规划截止日,届时 hive_metastore 目录转为只读,所有写入 HMS 的任务、DLT 管道、仪表盘和外部 BI 都需改指向 UC 表。
主要能力:按顺序执行四件事。检测:scripts/audit-hms-readiness.py 按存储 URI 将每张 HMS 表分类为 READY、BLOCKED 或 ORPHAN,判定由脚本负责。规划:migration-planner 子代理把就绪 CSV 转为按依赖排序的逐表计划(SYNC / DEEP CLONE / 重写 / 跳过),视图排在其基表之后。追踪:uc-permission-tracer 子代理遍历 UC 两级权限模型,回答某用户为何无法读取。隔离:/uc-env-pattern-picker 在单区域单 metastore 限制下推荐四种 dev/test/prod 隔离模式之一。
使用方式:流程为验证角色链→检测就绪→规划→迁移→追踪访问→隔离环境,Step 1 是硬性门槛。需 account-admin 启用 UC 系统模式、metastore-admin 执行授权与外部位置、云 IAM 只读访问,以及已认证的 Databricks CLI、jq 和运行中的 SQL 仓库(DATABRICKS_WAREHOUSE_ID)。认证全部来自环境变量,不硬编码密钥。
适用场景:迁移前审计、排查迁移后权限拒绝、选择 UC 环境隔离模式。
限制:资料未提供具体收费、价格或效果数据;弃用日期与范围需以工作区当前公告为准。SYNC 仅适用于云原生 Delta 外部表;旧存储方案或 DBFS 根路径的表需先物理迁移;浅克隆会丢失 Delta 历史,应使用 DEEP CLONE;基于 DENY 的 ACL 无法自动映射到 UC 的仅允许模型,需重写授权。