微信小程序云開發(fā) 數(shù)據(jù)庫API

2018-11-12 14:48 更新

小程序·云開發(fā)提供了豐富的數(shù)據(jù)庫操作 API,此處是數(shù)據(jù)庫小程序端的 API 參考文檔。

數(shù)據(jù)庫 API 都是懶執(zhí)行的,這意味著只有真實(shí)需要網(wǎng)絡(luò)請求的 API 調(diào)用才會(huì)發(fā)起網(wǎng)絡(luò)請求,其余如獲取數(shù)據(jù)庫、集合、記錄的引用、在集合上構(gòu)造查詢條件等都是不會(huì)觸發(fā)網(wǎng)絡(luò)請求的。觸發(fā)網(wǎng)絡(luò)請求的 API 有如下幾個(gè):

API說明
get獲取集合 / 記錄數(shù)據(jù)
add在集合上新增記錄
update更新集合 / 記錄數(shù)據(jù)
set替換更新一個(gè)記錄
remove刪除記錄
count統(tǒng)計(jì)查詢語句對應(yīng)的記錄條數(shù)

獲取引用的 API 有如下幾個(gè):

API說明
database獲取數(shù)據(jù)庫引用,返回 Database 對象
collection獲取集合引用,返回 Collection 對象
doc獲取對一個(gè)記錄的引用,返回 Document 對象

在數(shù)據(jù)庫 (Database) 對象上有如下字段:

字段說明
command獲取數(shù)據(jù)庫查詢及更新指令,返回 Command
serverDate構(gòu)造服務(wù)端時(shí)間
Geo獲取地理位置操作對象,返回 Geo 對象

在集合 (Collection) 對象上有如下 API:

API說明
doc獲取對一個(gè)記錄的引用,返回 Document 對象
add在集合上新增記錄
where構(gòu)建一個(gè)在當(dāng)前集合上的查詢條件,返回 Query,查詢條件中可使用查詢指令
orderBy指定查詢數(shù)據(jù)的排序方式
limit指定返回?cái)?shù)據(jù)的數(shù)量上限
skip指定查詢時(shí)從命中的記錄列表中的第幾項(xiàng)之后開始返回
field指定返回結(jié)果中每條記錄應(yīng)包含的字段

在記錄 (Document) 對象上有如下 API:

API說明
get獲取記錄數(shù)據(jù)
update局部更新數(shù)據(jù)
set替換更新記錄
remove刪除記錄
field指定返回結(jié)果中記錄應(yīng)包含的字段

Command (db.command) 對象上有如下查詢指令:

API說明
eq字段是否等于指定值
neq字段是否不等于指定值
lt字段是否小于指定值
lte字段是否小于或等于指定值
gt字段是否大于指定值
gte字段是否大于或等于指定值
in字段值是否在指定數(shù)組中
nin字段值是否不在指定數(shù)組中
and條件與,表示需同時(shí)滿足另一個(gè)條件
or條件或,表示如果滿足另一個(gè)條件也匹配

Command (db.command) 對象上有如下更新指令:

API說明
set設(shè)置字段為指定值
remove刪除字段
inc原子自增字段值
mul原子自乘字段值
push如字段值為數(shù)組,往數(shù)組尾部增加指定值
pop如字段值為數(shù)組,從數(shù)組尾部刪除一個(gè)元素
shift如字段值為數(shù)組,從數(shù)組頭部刪除一個(gè)元素
unshift如字段值為數(shù)組,往數(shù)組頭部增加指定值
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)