鸿蒙待办清单做增量同步,游标只记时间会漏哪条

举报
yd_49100212 发表于 2026/11/19 00:11:50 2026/11/19
【摘要】 从华为云鸿蒙待办清单案例出发,用两条时间戳相同的记录说明增量同步如何分页,以及另一部手机如何收到删除和断线后的变更。

鸿蒙待办清单做增量同步,游标只记时间会漏哪条

两部手机都打开同一份待办清单。在一部手机上改完截止日期,另一部手机过一会儿也能看到。华为云鸿蒙开发实践中心的“云同步待办清单”案例用 ArkTS 写端侧,经过 APIG 调用 FunctionGraph,再到 RDS for MySQL 读写任务。案例里,端侧每 30 秒拉一次完整清单。任务少的时候,这个办法就够用:一轮请求拿到当前列表,直接刷新页面。想把它改成只拉变化的任务,得先想清楚一件事:上次到底读到了哪一条?

两条记录同一时间更新,下一页从哪里接

假设任务 101 和 102 的更新时间都是 09:30:00,接口每页只返回一条。第一页拿到任务 101,客户端只保存了时间 09:30:00。下一页加上条件 updated_at > 09:30:00,任务 102 就永远跨不过这道门槛。改成大于等于也有问题:按原来的顺序取第一页,接口还可能继续返回任务 101。

可以把时间和任务 ID 一起放进游标。查询先按更新时间排序,同一时间内再按 ID 排序。如果上次读到的是任务 101,就接着取时间更晚的记录,以及时间相同但 ID 排在 101 后面的记录。下面是这个想法对应的查询形状,id 代表任务表的唯一键:

SELECT id, updated_at, deleted
FROM tasks
WHERE user_id = :user_id
  AND (updated_at > :ts OR (updated_at = :ts AND id > :id))
ORDER BY updated_at, id
LIMIT :page_size;

服务端先从登录会话确定用户,再在该用户的任务范围内应用游标。游标里的时间应保留数据库的精度,不要转成页面上显示的“09:30”再发回去。如果拉取频繁,可以考虑用 (user_id, updated_at, id) 索引配合查询,并用 EXPLAIN 看实际走的是哪条路径。

删除也要送到另一部手机

全量拉取时,任务不在新列表里,端侧就能看出它消失了。做增量拉取以后,没收到某个任务通常只说明它没更新。案例里的软删除可以用来表达这个变化:删除时更新标记和更新时间,拉取接口仍返回该任务的 ID 和删除标记,另一部手机收到后再移除本地记录。

游标可以在本地应用完一页之后推进。如果手机收到响应就先记下新游标,写入本地前却退出了应用,下次会从新位置继续,刚才那页就丢了。把应用变更和保存游标放在同一个本地事务里,失败时就能重拉同一页;按任务 ID 更新本地记录,也能让重复拉取保持同样的结果。

用一页一条的设置试一遍

测试时可以临时把每页条数设成 1,准备两条更新时间完全相同的记录。确认第一页返回第一条,第二页还能拿到另一条。再用一部手机删除第二条,检查另一部手机能否在下一轮把它移出列表。最后在写入本地前模拟一次中断,重开应用,看刚才收到的那页能不能重拉。

时间加 ID 解决的是同一时间戳下的分页问题。还有一种情况要单独考虑:两笔事务可能先后写入更新时间,却按相反顺序提交。如果较晚时间的事务先被客户端看到,游标就可能越过尚未提交的记录。待办量小、改动少时可以先保留全量拉取;需要严格保证每次变更都能送达时,应使用有提交顺序保证的变更流,或给增量同步加定期全量对账。

参考:华为云鸿蒙开发实践中心《云同步待办清单:鸿蒙端云一体实战》。本文的分页查询和测试步骤是基于案例给出的改造示例。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。