跳到主要内容

读取数据

假设我们已有一个集合 todos，其中包含以下格式记录：

[  {    "_id": "todo-identifiant-aleatoire",    "due": Date("2018-09-01"),    "style": {      "color": "white"    },    "tags": ["cloud", "database"],    "process": 20,    "done": false  },  {    "_id": "todo-identifiant-aleatoire-2",    "due": Date("2018-12-25"),    "tags": ["cloud", "database"],    "style": {      "color": "yellow"    },    "process": 50,    "done": false  }  // more...]

获取一个记录的数据#

const cloudbase = require("@cloudbase/js-sdk");
const app = cloudbase.init({  env: "xxxx"});// 1. 获取数据库引用var db = app.database();db.collection("todos")  .doc("todo-identifiant-aleatoire")  .get()  .then((res) => {    // res.data 包含该记录的数据    console.log(res.data);  });
提示

由于数据库权限，用户端可能会读不到指定 _id 的数据，需要把数据库权限设定为 仅创建者可写，所有人可读 或 仅管理端可写，所有人可读，具体可以参考 数据库权限。

获取多个记录的数据#

我们也可以一次性获取多条记录。通过调用集合上的 where 方法可以指定查询条件，再调用 get 方法即可只返回满足指定查询条件的记录，例如获取所有未完成的待办事项。示例代码如下：

const cloudbase = require("@cloudbase/js-sdk");
const app = cloudbase.init({  env: "xxxx"});// 1. 获取数据库引用var db = app.database();
db.collection("todos")  .where({    done: false  })  .get()  .then((res) => {    // res.data 是包含以上定义的两条记录的数组    console.log(res.data);  });

where 方法接收一个对象参数，该对象中每个字段和它的值构成一个需满足的匹配条件，各个字段间的关系是 "与" 的关系，即需同时满足这些匹配条件，在这个例子中，就是查询出 done 等于 false 的记录。

查询嵌套字段#

在查询条件中我们也可以指定匹配一个嵌套字段的值，例如找出标为黄色的待办事项：

const cloudbase = require("@cloudbase/node-sdk");
const app = cloudbase.init({  env: "xxxx"});// 1. 获取数据库引用var db = app.database();
db.collection("todos")  .where({    style: {      color: "yellow"    }  })  .get()  .then((res) => {    console.log(res.data);  });

使用 "点表示法" 表示嵌套字段：

const cloudbase = require("@cloudbase/js-sdk");
const app = cloudbase.init({  env: "xxxx"});// 1. 获取数据库引用var db = app.database();
db.collection("todos")  .where({    "style.color": "yellow"  })  .get()  .then((res) => {    console.log(res.data);  });

获取一个集合的数据#

如果要获取一个集合的数据，例如获取 todos 集合上的所有记录，可以在集合上调用 get 方法获取，但通常不建议这么使用，在客户端中我们需要尽量避免一次性获取过量的数据，只应获取必要的数据。为了防止误操作以及保护用户体验，在获取集合数据时，小程序端请求时，服务器默认且最多返回 20 条记录，Web 端及云函数端 SDK 请求时最多返回 1000 条，默认 100 条。

const cloudbase = require("@cloudbase/js-sdk");
const app = cloudbase.init({  env: "xxxx"});// 1. 获取数据库引用var db = app.database();
db.collection("todos")  .get()  .then((res) => {    // res.data 是一个包含集合中有权限访问的所有记录的数据    console.log(res.data);  });