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