跳到主要内容

新增数据

对表执行 INSERT 操作。

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

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

参数​

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

options 详细配置​

参数类型必需说明
countstring可选计数算法，可选值：
"exact" - 底层执行 COUNT(*)
defaultToNullboolean可选使缺失的字段默认为 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: "第二篇文章内容" },
]);