Database

云开发 SDK 数据库实例

属性

Command command

数据库操作符

Geo Geo

数据库地理位置结构

方法

Database.collection(name: string): Collection

获取集合的引用。方法接受一个 name 参数,指定需引用的集合名称。

Database.createCollection(collectionName: string): Promise<Object>

创建集合,如果集合已经存在会创建失败

Database.serverDate(options: Object): ServerDate

构造一个服务端时间的引用。可用于查询条件、更新字段值或新增记录时的字段值。

Database.runTransaction(callback: function, times: number): Promise<any>

发起事务。仅可在云函数中使用。

Database.startTransaction(): Promise<Transaction>

开始事务,另一个同样可以使用的发起事务的 API 是 runTransaction。仅可在云函数中使用。

小程序端示例

以下调用获取默认环境的数据库的引用:

  1. const db = wx.cloud.database()

假设有一个环境名为 test-123,用做测试环境,那么可以如下获取测试环境数据库:

  1. const testDB = wx.cloud.database({
  2. env: 'test-123'
  3. })

云函数端示例

以下调用获取和云函数当前所在环境相同的数据库的引用:

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: cloud.DYNAMIC_CURRENT_ENV
  4. })
  5. const db = cloud.database()

假设有一个环境名为 test,用做测试环境,那么可以如下获取测试环境数据库:

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: cloud.DYNAMIC_CURRENT_ENV
  4. })
  5. const testDB = cloud.database({
  6. env: 'test'
  7. })

也可以通过 init 传入默认环境的方式使得获取数据库时默认是默认环境数据库:

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3. env: 'test'
  4. })
  5. const testDB = cloud.database()