云開發(fā)-數據庫
數據庫 API 分為小程序端和服務端兩部分,小程序端 API 擁有嚴格的調用權限控制兔魂,開發(fā)者可在小程序內直接調用 API? 進行非敏感數據的操作剩岳。對于有更高安全要求的數據,可在云函數內通過服務端 API? 進行操作入热。云函數的環(huán)境是與客戶端完全隔離的拍棕,在云函數上可以私密且安全的操作數據庫。
數據庫 API 包含增刪改查的能力勺良,使用 API 操作數據庫只需三步:獲取數據庫引用绰播、構造查詢/更新條件、發(fā)出請求尚困。
1. 獲取數據庫引用
2. 構造查詢語句
? ?? collection 方法獲取一個集合的引用
? ? where 方法傳入一個對象蠢箩,數據庫返回集合中字段等于指定值的 JSON 文檔。API 也支持高級的查詢條件(比如大于、小于谬泌、in 等)滔韵,具體見文檔查看支持列表
3. 初始化
在開始使用數據庫 API 進行增刪改查操作之前,需要先獲取數據庫的引用掌实。以下調用獲取默認環(huán)境的數據庫的引用:
如需獲取其他環(huán)境的數據庫引用陪蜻,可以在調用時傳入一個對象參數,在其中通過 env 字段指定要使用的環(huán)境。
要操作一個集合,需先獲取它的引用赖欣。在獲取了數據庫的引用后,就可以通過數據庫引用上的 collection 方法獲取一個集合的引用
4. 數據庫操作
4.1 插入數據
可以通過在集合對象上調用 add 方法往集合中插入一條記錄症昏。 可以通過在集合對象上調用 add 方法往集合中插入一條記錄。
4.2 讀取數據
在記錄和集合上都有提供 get 方法用于獲取單個記錄或集合中多個記錄的數據父丰。
獲取一個數據的數據
獲取多個記錄的數據
如果要獲取一個集合的數據肝谭,比如獲取 books 集合上的所有記錄,可以在集合上調用 get 方法獲取
4.3 構建查詢條件
使用數據庫 API 提供的 where 方法我們可以構造復雜的查詢條件完成復雜的查詢任務
假設我們需要查詢進度大于 30% 的待辦事項蛾扇,那么傳入對象表示全等匹配的方式就無法滿足了分苇,這時就需要用到查詢指令。數據庫 API 提供了大于屁桑、小于等多種查詢指令医寿,這些指令都暴露在 db.command 對象上
查詢指令
查詢指令說明
邏輯指令
4.4 更新數據
API說明
除了用指定值更新字段外,數據庫 API 還提供了一系列的更新指令用于執(zhí)行更復雜的更新操作蘑斧,更新指令可以通過 db.command 取得
更新指令說明
比如我們可以將一個待辦事項的進度 +10%: