前言ValuesBucket是 relationalStore 中用于封装插入数据的键值对容器通过insert方法将数据写入 SQLite 表。本文以「猫猫大作战」的游戏结束写入战绩为锚点讲解 ValuesBucket 的使用。提示本系列不讲 ArkTS 基础语法与环境搭建假设你已跟完第 1–136 篇。本篇是阶段四第 137 篇。一、ValuesBucket 使用1.1 插入战绩async function insertRecord(store: relationalStore.RdbStore, record: GameRecord) { const bucket: relationalStore.ValuesBucket { player_name: record.playerName, score: record.score, max_combo: record.maxCombo, merge_count: record.mergeCount, highest_level: record.highestLevel, game_date: new Date().toISOString() }; const rowId await store.insert(GAME_RECORD, bucket); console.info(插入成功行号: ${rowId}); }1.2 支持的字段类型ArkTS 类型SQLite 类型示例stringTEXT猫猫侠numberINTEGER/REAL88888booleanINTEGERtrue二、总结ValuesBucket 是键值对数据容器用于 relationalStore 的 insert 操作。核心要点ValuesBucket的 key 为数据库字段名store.insert(table, bucket)返回新行 ID支持 string/number/boolean 类型下一篇预告第 138 篇将深入 orderByDesc——排序与分页查询。如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源ValuesBucket API开源鸿蒙跨平台社区第 136 篇RdbPredicates第 138 篇orderBy