IDAAS 扩展属性唯一性约束

本文介绍如何使用 IDAAS 平台的扩展属性唯一性约束功能，帮助管理员确保上游系统唯一字段在 IDAAS 中的数据一致性。

概述

扩展属性唯一性约束功能提供预设的扩展唯一字段，允许管理员将上游系统的唯一属性映射到这些字段，系统通过数据库唯一索引保证字段值全局唯一。

💡

核心场景：当上游系统（如网易邮箱的 ems 字段）要求某属性全局唯一时，可将其映射到 IDAAS 的扩展唯一字段，由数据库层面保障唯一性约束。

前提条件

已拥有 IDAAS 平台管理员权限

已了解上游系统中需要保证唯一性的字段

功能说明

技术背景

属性类型	存储方式	唯一性支持
内置属性（如用户名、邮箱）	SQL 物理字段	支持（数据库唯一索引）
普通扩展属性	JSON 字段	不支持
扩展唯一字段（新增）	SQL 物理字段	支持（数据库唯一索引）

系统预设 3 个扩展唯一字段（ext_unique_1~3），每个字段均配置数据库唯一索引。

字段规格

属性	说明
字段数量	3 个（ext_unique_1、ext_unique_2、ext_unique_3）
字段类型	VARCHAR(256)
唯一约束	数据库级别唯一索引
存储位置	用户表物理字段（非 JSON）

操作步骤

步骤 1：进入属性管理

进入 用户中心 → 属性管理

步骤 2：配置扩展唯一字段映射

在属性映射配置中，将上游系统的唯一属性关联到预设的扩展唯一字段：

配置项	说明	填写指南
上游系统属性	选择上游系统中需要保证唯一的字段	如网易邮箱的 `ems` 字段
IDAAS 映射字段	选择目标扩展唯一字段	从 ext_unique_1~3 中选择一个未使用的字段

重要：每个扩展唯一字段只能映射一个上游属性。系统最多支持 3 个扩展唯一字段，请合理规划使用。

步骤 3：验证唯一性约束

配置完成后，可通过以下方式验证：

触发一次数据同步

尝试同步一条与已有数据重复的记录

系统应拒绝创建并提示唯一性冲突错误

验证与测试

验证项	验证方法	预期结果
唯一值写入	同步一条唯一的新数据	同步成功，字段值正确写入
重复值拦截	同步一条与已有数据相同的记录	同步失败，提示唯一性冲突
空值处理	同步时该字段为空	允许写入（空值不参与唯一校验）

典型场景

场景：网易邮箱用户同步

常见问题

Q：3 个扩展唯一字段不够用怎么办？

Q：已有数据存在重复值，开启唯一约束后会怎样？

Q：扩展唯一字段和普通扩展属性有什么区别？

IDAAS 扩展物理字段使用说明

IDAAS 扩展属性唯一性约束#

概述#

前提条件#

功能说明#

技术背景#

字段规格#

操作步骤#

验证与测试#

典型场景#

常见问题#