跳到主要内容

新增数据

初始化 SDK​

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env-id", // 替换为您的环境id
});

const db = app.rdb();

// 或指定实例和数据库
// const db = app.rdb({
//   instance: "<instance>",
//   database: "<database>"
// });

新增数据​

通过 insert() 方法向表中插入数据，支持单行和批量插入。

db.from(tableName).insert(values, options)
  • tableName：表名称
  • values：要插入的数据
  • options：插入选项配置

参数说明​

参数类型必填说明
valuesobject | Array是要插入的值。传递对象以插入单行，或传递数组以插入多行。
optionsobject否插入选项配置

options 参数说明​

参数类型必填说明
countstring否计数算法，可选值："exact" - 底层执行 COUNT(*)

代码示例​

创建记录​

// 向 articles 表中插入一条记录
const { error } = await db
  .from("articles")
  .insert({ title: "新文章标题", content: "文章内容" });

console.log('插入结果:', error ? '失败' : '成功');

创建记录并返回数据​

// 插入记录并返回插入的数据
const { data, error } = await db
  .from("articles")
  .insert({ title: "新文章标题", content: "文章内容" })
  .select();

console.log('插入结果:', data);

💡 注意：仅当表中只有一个主键，且该主键为自增类型时，.select() 方法才会返回插入的行。

批量创建记录​

// 一次性插入多条记录
const { error } = await db.from("articles").insert([
  { title: "第一篇文章", content: "第一篇文章内容" },
  { title: "第二篇文章", content: "第二篇文章内容" },
]);

console.log('批量插入结果:', error ? '失败' : '成功');