在微信小程序云开发中,数据库 API 提供了一系列方法,用于实现对云数据库的操作,包括增、删、改、查等。以下是一些常用的数据库 API,主要涉及到数据库的初始化、集合的操作、文档的操作等。

1. 数据库初始化

在小程序的页面或组件中,可以通过 wx.cloud.database() 方法获取数据库引用,从而进行数据库操作。
const db = wx.cloud.database();

2. 集合的操作

2.1. 获取集合引用

使用 collection 方法获取集合引用,用于后续的操作。
const collection = db.collection('myCollection');

3. 文档的操作

3.1. 添加数据

使用 add 方法向集合中添加数据。
collection.add({
  data: {
    name: 'John Doe',
    age: 25,
    email: 'john@example.com'
  },
  success: res => {
    console.log(res);
  },
  fail: err => {
    console.error(err);
  }
});

3.2. 查询数据

使用 where 方法设置查询条件,最后使用 get 方法执行查询。
collection.where({
  age: 25
}).get({
  success: res => {
    console.log(res.data);
  },
  fail: err => {
    console.error(err);
  }
});

3.3. 更新数据

使用 doc 方法获取文档引用,最后使用 update 方法更新数据。
const docId = 'xxxx'; // 替换为实际文档的 ID
collection.doc(docId).update({
  data: {
    age: 26
  },
  success: res => {
    console.log(res);
  },
  fail: err => {
    console.error(err);
  }
});

3.4. 删除数据

使用 doc 方法获取文档引用,最后使用 remove 方法删除数据。
const docId = 'xxxx'; // 替换为实际文档的 ID
collection.doc(docId).remove({
  success: res => {
    console.log(res);
  },
  fail: err => {
    console.error(err);
  }
});

4. 实时数据变化

使用 watch 方法订阅实时数据变化,可以在数据变化时执行回调函数。
const watcher = collection.watch({
  onChange: snapshot => {
    console.log('数据变化:', snapshot);
  },
  onError: err => {
    console.error('监听错误:', err);
  }
});

// 取消监听
// watcher.close();

以上是一些基本的数据库 API 操作,更详细的文档可以在[微信官方文档 - 云开发数据库](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/database.html)中找到。


转载请注明出处:http://www.zyzy.cn/article/detail/1159/微信小程序