操作场景

本文档指导您如何通过在集合对象上调用 add 方法往集合中插入一条记录。例如，在集合 'todos' 中新增一个待办事项。

• 插入数据时，若集合不存在，则会报错。
• 创建集合请参见 创建第一个集合 (opens new window)。

操作步骤

客户端

小程序端

小程序端相关API集成至小程序SDK中。示例代码如下：

const db = wx.cloud.database();
db.collection("todos")
  .add({
    // data 字段表示需新增的 JSON 数据
    data: {
      // _id: 'todo-identifiant-aleatoire', // 可选自定义 _id，在此处场景下用数据库自动分配的就可以了
      description: "learn cloud database",
      due: new Date("2018-09-01"),
      tags: ["cloud", "database"],
      // 为待办事项添加一个地理位置
      location: new db.Geo.Point(23, 113),
      done: false
    }
  })
  .then(res => {
    console.log(res);
  })
  .catch(console.error);

网页端（Web 端）

示例代码如下：

tcb.init({
  env: "xxxx"
});
const db = tcb.database();
db.collection("todos").add(
  {
    // data 字段表示需新增的 JSON 数据
    data: {
      // _id: 'todo-identifiant-aleatoire', // 可选自定义 _id，在此处场景下用数据库自动分配的就可以了
      description: "learn cloud database",
      due: new Date("2018-09-01"),
      tags: ["cloud", "database"],
      // 为待办事项添加一个地理位置
      location: new db.Geo.Point(23, 113),
      done: false
    }
  },
  function(err, res) {}
);

服务端

示例代码如下：

const app = require("tcb-admin-node");
app.init();
const db = app.database();

db.collection("todos")
  .add({
    // data 字段表示需新增的 JSON 数据
    data: {
      // _id: 'todo-identifiant-aleatoire', // 可选自定义 _id，在此处场景下用数据库自动分配的就可以了
      description: "learn cloud database",
      due: new Date("2018-09-01"),
      tags: ["cloud", "database"],
      // 为待办事项添加一个地理位置
      location: new db.Geo.Point(23, 113),
      done: false
    }
  })
  .then(res => {
    console.log(res);
  })
  .catch(console.error);

在创建成功之后，我们可以在控制台中查看到刚新增的数据。