定义
别名(Alias) 是向量数据库中 Collection(集合) 或 CollectionView(集合视图) 的逻辑概念,其核心价值在于解耦应用程序与底层数据结构的直接依赖,通过动态映射规则将用户自定义的直观名称与物理存储的集合关联。开发者无需感知集合的真实名称,即可通过别名访问目标数据,从而实现业务逻辑与存储细节的隔离,提升系统的灵活性与可维护性。
适用场景
别名的典型使用场景主要集中在实现业务无感的数据集合切换。例如,在发布新版本(如测试环境上线)时,通过将别名从原生产集合动态指向新集合,实现零停机平滑迁移;若新版本异常,则可通过别名快速回滚至旧集合,保障业务连续性。
使用限制
别名数量:单个 Collection 或 CollectionView 可绑定1个或多个别名,支持多业务视角的灵活映射。
唯一性约束:同一实例内,别名需全局唯一,不可重复。
别名级联依赖:若对数据库(DB)、集合(Collection)或集合视图(CollectionView)执行 DROP 操作,其关联的所有别名将同步被删除。
访问层级限制:
Document 与 DocumentSet 层级:支持通过别名直接访问(如 db.alias_name.get_document(id=123)),系统会优先解析别名指向的真实集合。
其他层级操作:对数据库、集合或集合视图的管理操作(如创建、删除、修改 Schema)仅支持使用原始名称,别名无法替代。
命名规则
别名可以是一个简短的字符串,方便标识和访问对应的集合。命名规则,如下所示。
说明:
集合或集合视图的别名可以和名称重复,一个集合或集合视图的多个别名之间不能重复。
字符范围:仅支持英文字母、数字、下划线(_)、中划线(-)。
首字符:必须以英文字母开头(如 data_2023 合法,2023_data 非法)。
长度限制:字符串长度需在 [1, 128] 字符之间。