前言

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 支持的字段类型

二、总结

ValuesBucket 是键值对数据容器，用于 relationalStore 的 insert 操作。

核心要点：

• ValuesBucket 的 key 为数据库字段名
• store.insert(table, bucket) 返回新行 ID
• 支持 string/number/boolean 类型

下一篇预告：第 138 篇将深入 orderByDesc——排序与分页查询。

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• ValuesBucket API
• 开源鸿蒙跨平台社区
• 第 136 篇：RdbPredicates
• 第 138 篇：orderBy