新增数据

对表执行 INSERT 操作。

默认情况下，插入的行不会被返回。要返回插入的数据，请使用 .select() 链式调用。

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

参数

参数	类型	必需	说明
values	object | Array	必需	要插入的值。传递对象以插入单行，或传递数组以插入多行。
options	object	可选	插入选项配置

options 详细配置

参数	类型	必需	说明
count	string	可选	计数算法，可选值： "exact" - 底层执行 COUNT(*)
defaultToNull	boolean	可选	使缺失的字段默认为 null。否则，使用列的默认值。仅适用于批量插入。

代码示例

const app = cloudbase.init({
  ...
});

const db = app.mysql();

基础插入

创建记录

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

创建记录并返回数据

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

批量插入

批量创建记录

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