laf/docs/guide/db/add.md

title
新增数据

{{ $frontmatter.title }}

Laf 云函数库中，新增数据非常简单，正规说法为插入文档。以下是插入单个文档和批量插入文档的写法。

同时 Laf 云数据库是 Schema Free 的，意味着你可以插入任意的字段和数据类型。

::: tip 使用 cloud.database()新增数据的方法无法自定义 id，所有新增的数据，都会自动生成 id，生成的 id 类型为为 string

使用 mongodb 原生写法 ，可以自定义 id，也可以自动生成 id，生成的 id 类型为 ObjectId :::

插入单个文档

下例向 user 集合中添加了一条记录。

import cloud from '@lafjs/cloud'
const db = cloud.database()

export default async function (ctx: FunctionContext) {
  // 向 user 集合中添加一条记录
  const res = await db.collection('user').add({ name: "jack" })
  console.log(res)
}

批量新增文档

当然我们也可以批量添加多条记录，只需要多传入一个对象{ multi: true }即可。

const list = [
  { name: "jack" },
  { name: "rose" }
]
// 向 user 集合中加入多条记录
const res = await db.collection('user').add(list, { multi: true })
console.log(res)

mongodb 原生写法

import cloud from '@lafjs/cloud'
const db = cloud.mongo.db

export async function main(ctx: FunctionContext) {
  // 向 user 集合中插入单个文档
  const result1 = await db.collection('user').insertOne({ name: "jack" })
  console.log(result1)
  // 向 user 集合中批量插入文档
  const documents = [
    { name: "Jane Doe", age: 25 },
    { name: "Bob Smith", age: 40 }
  ];
  const result2 = await db.collection('user').insertMany(documents);
  console.log(result2)
}