跳到主要内容

新增数据

初始化 SDK

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

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

const models = app.models

单条新增

向数据模型中添加一条新记录。

models.modelName.add(options)
  • modelName: 数据模型名称
  • options: 新增参数

options 参数说明

参数类型必填说明
dataobject要新增的数据对象

代码示例

// 创建单条记录
const todo = await models.todo.create({
data: {
title: "客户端任务",
description: "使用 js-sdk 创建的任务",
priority: "high",
completed: false,
createdAt: new Date(),
createdBy: "system",
metadata: {
source: "api",
version: "1.0"
}
}
})

console.log('创建成功:', todo)

批量新增

一次性向数据模型中添加多条记录。

⚠️ 注意:暂不支持批量新增关联关系字段

models.modelName.createMany(options)
  • modelName: 数据模型名称
  • options: 新增参数

options 参数说明

参数类型必填说明
dataarray包含多个数据对象的数组

代码示例

// 批量创建多条记录
const todos = await models.todo.createMany({
data: [{
title: "批量任务1",
priority: "high"
},
{
title: "批量任务2",
priority: "medium"
},
{
title: "批量任务3",
priority: "low"
}
]
})

console.log('批量创建成功:', todos)