tencent cloud

云开发 CloudBase

数据模型 SDK

Download
聚焦模式
字号
最后更新时间: 2026-05-13 11:35:43

查询数据

初始化 SDK

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

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

const models = app.models;

单条查询

通过指定条件查询单条记录。
models.modelName.get(options);
modelName: 数据模型名称
options: 查询参数

options 参数说明

具体查询参数说明请参考 查询参数详解 文档。
参数
类型
必填
说明
filter.where
object
查询条件
select
object
指定返回字段

代码示例

// 查询 todo数据模型 _id 为 todo-id-123 的记录
const todo = await models.todo.get({
filter: {
where: {
_id: {
$eq: "todo-id-123",
},
},
},
select: {
$master: true, // 返回所有字段
},
});

console.log("查询结果:", todo.data);

返回结果

{
data: {
records: [{
_id: "todo-id-123",
title: "服务端任务",
completed: false,
// ... 其他字段
}],
total: 1
}
}

多条查询

查询多条记录,支持条件筛选、排序、分页等
models.modelName.list(options);
modelName: 数据模型名称
options: 查询参数

options 参数说明

具体查询参数说明请参考 查询参数详解 文档。
参数
类型
必填
说明
filter.where
object
查询条件
select
object
指定返回字段

代码示例

// 查询 todo数据模型 completed 为 false 的记录
const todos = await models.todo.list({
filter: {
where: {
completed: {
$eq: false
},
},
},
});

console.log("查询结果:", todos.data);

返回结果

{
data: {
records: [{
_id: "todo-id-1",
title: "任务1",
completed: false
},
{
_id: "todo-id-2",
title: "任务2",
completed: false
}
],
total: 2
}
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈