catalog.schema.object 的三段式路径唯一标识。三级命名空间为跨工作空间共享、细粒度授权和资产检索提供统一的引用方式。└── Schema(中层命名空间,类似 Database)└── 资产对象(Table / View / Volume / Model )└── 字段 / 文件(仅特定资产类型有四级层次)
层级 | 类比 | 职责 |
Catalog | 数据库实例 / 数据仓库 | 顶层命名空间,决定底层存储位置与资产类型 |
Schema | 数据库(Database) | 按业务主题、项目或环境划分对象;相当于 SQL 中的 DATABASE |
对象 | 表、视图、卷、模型 | 实际承载数据或元数据的资产 |
/Volumes/ 为前缀的路径:/Volumes/<catalog>/<schema>/<volume>/<directory>/<file>
/Volumes/ops_catalog/raw_logs/access_log/2026-06-06/access.log
models:/<catalog>.<schema>.<model_name>/<version>models:/<catalog>.<schema>.<model_name>@<alias>
models:/ml_catalog.recsys.deepfm_model/3models:/ml_catalog.recsys.deepfm_model@champion
元素 | 规则 |
Catalog 名称 | 在同一 MetaLake 内全局唯一; default 为系统保留名,不可创建或修改 |
Schema 名称 | 在同一 Catalog 内唯一; information_schema 与 default 为系统在创建 Catalog 时自动创建的 Schema |
对象名称(表 / 视图 / 卷 / 模型) | 在同一 Schema 内唯一 |
字符集 | 详细命名约束(长度、合法字符、大小写敏感性)由底层引擎决定 |
default 是系统保留 Catalog 名,您无法创建同名 Catalog;information_schema 与 default 是 Catalog 创建后自动生成的 Schema 名,您也无法手工创建或重命名。default 和 system 两个内置 Catalog。information_schema 与 default 两个 Schema。default Schema 的内容初始为空。catalog.schema.object。全名是跨工作空间引用对象的标准形式:引用场景 | 推荐写法 |
跨工作空间查询 | <catalog>.<schema>.<table> |
单工作空间且指定了上下文 | <table> 或 <schema>.<table> |
在告警 / 文档中描述资产位置 | 使用三段式全名,便于检索 |
API / SDK 调用 | 使用三段式全名作为标识参数 |
限制项 | 说明 |
系统保留名 | information_schema / default 不可作为 Schema 名 |
跨 Catalog 联表 | 跨 Catalog 联表查询能力依赖底层计算引擎;DLC Spark 已支持基础的跨 Catalog 联表查询 |
模型对象层级 | 模型在三级命名空间之上还有版本与别名两层,详见 模型 Catalog |
marketing_catalog、finance_catalog),每条业务线内部再按主题划分 Schema,避免命名冲突;同时便于按 Catalog 维度做权限批量授权。catalog.schema.object 三段式语法在 DLC Spark SQL 中已支持;执行前请确认当前计算资源对目标 Catalog 拥有 use catalog 与 use schema 权限。文档反馈