浏览 OpenIM Guides
Guides

数据迁移

评估从现有云 IM 或自研系统迁移到 OpenIM 的接入路径。

复制

在 OpenIMSDK 系统中,一般会涉及以下几个关键数据存储:

  • 用户信息
  • 好友关系
  • 黑名单
  • 群组
  • 消息
  • 会话(通常可通过消息进行重建)

若你正准备从其他 IM 云服务迁移至 OpenIMSDK,或需要将低版本的 OpenIMSDK 升级到更高版本(如从 3.3 升级到 3.8),可参照以下操作步骤进行数据导入与同步。

1. 导入用户

  • 接口说明用户注册/导入
  • 操作目的:将外部或历史系统中的用户信息导入到 OpenIMSDK。

2. 导入好友关系

3. 导入黑名单

  • 接口说明添加到黑名单
  • 操作目的:将外部或历史系统中的黑名单导入 OpenIMSDK。

4. 创建群组

  • 接口说明创建群组
  • 操作目的:将外部或历史系统中的群组导入 OpenIMSDK。

5. 导入群成员

  • 接口说明邀请用户进群
  • 操作目的:将外部或历史系统中的群成员导入 OpenIMSDK。

6. 导入消息

  • 接口说明发送消息接口
  • 重点关注sendTime 字段
  • 操作目的:将外部或历史系统中的历史消息导入 OpenIMSDK。 如果对 OpenIMSDK 升级,需要自己解析历史消息,再通过此接口导入。

7. 设置会话状态

  • 接口说明设置会话接口
  • 操作目的:将外部或历史系统中的会话状态导入 OpenIMSDK。

以上操作完成后,OpenIMSDK 系统就会拥有完整的用户信息、好友关系、黑名单、群组、消息以及会话状态,客户端 SDK 升级到对应的版本即可完成迁移。 如需要同步好友备注,群组设置等,调用对应的 REST API 即可。