使用redis-om获取Redis数据时，如何获取其自动生成的UID？

一、自定义UID的实现方式 #

Redis-OM完全支持自定义实体ID，不需要依赖框架自动生成的UID。你只需要在创建实体时直接指定id字段，保存后就可以用这个自定义ID直接查询数据，完全适配生产环境的业务逻辑。

示例代码：

// 定义用户实体与Schema
class User extends Entity {}
const userSchema = new Schema(User, {
  username: { type: 'string' },
  email: { type: 'string' },
  avatar: { type: 'string' }
})

// 创建仓库
const userRepository = client.fetchRepository(userSchema)

// 保存带自定义ID的用户数据
const user = userRepository.createEntity({
  id: 'user_1001', // 这里用业务系统的唯一用户标识，比如自增ID、UUID或手机号
  username: 'Omilight',
  email: 'user@example.com',
  avatar: '/avatar/1001.png'
})
await userRepository.save(user)

// 后续通过自定义ID直接获取数据
const targetUser = await userRepository.fetch('user_1001')

二、生产环境数据获取逻辑 #

在生产环境中，你不需要依赖Redis Insight查看自动生成的UID——因为自定义ID本身就是业务中已知的标识：

• 比如用户登录后，前端可以拿到当前用户的业务ID（如user_1001）；
• 页面加载时，前端将该ID传给后端，后端直接用userRepository.fetch(自定义ID)获取对应数据即可，流程和传统数据库通过主键查询完全一致。

三、关于Redis Search的必要性 #

如果你的场景只是通过唯一ID获取单条数据，完全不需要使用Redis Search。因为Redis-OM的fetch方法是直接操作Redis的Hash类型，通过主键（ID）读取数据是O(1)的高效原生操作，不需要额外创建搜索索引。

只有当你需要实现多条件查询、模糊匹配、范围筛选等复杂查询场景时，才需要启用Redis Search并为对应的字段创建索引。

最佳实践 #

• 自定义ID必须保证全局唯一：建议复用业务系统中已有的唯一标识（如用户UUID、手机号、系统自增ID），避免重复；
• 遵守Redis键名规范：ID中尽量避免特殊字符、空格，可使用下划线_或短横线-分隔，保证键名的合法性和可读性；
• 与业务逻辑对齐：自定义ID最好和业务系统的用户ID保持一致，减少前后端交互的复杂度，避免额外的ID映射逻辑。

内容的提问来源于stack exchange，提问作者Omilight