database namespace

功能

功能描述
實例(實例)註冊一個在特定 Firebase 即時資料庫實例的事件上觸發的函數。
參考(路徑)註冊一個在 Firebase 即時資料庫寫入事件上觸發的函數。

課程

班級描述
數據快照表示 Firebase 即時資料庫資料快照的介面。
實例產生器Firebase 即時資料庫執行個體建構器介面。透過[ database.instance() ](providers_database_.html#instance)存取。
參考生成器Firebase 即時資料庫參考建構器介面。透過[ functions.database.ref() ](functions.database#.ref)存取。

資料庫.實例()

註冊一個在特定 Firebase 即時資料庫實例的事件上觸發的函數。

將此方法與ref一起使用來指定要監視資料庫事件的實例。例如: firebase.database.instance('my-app-db-2').ref('/foo/bar')

請注意,在沒有instance下使用functions.database.ref會監視*default* 實例的事件。

簽名:

export declare function instance(instance: string): InstanceBuilder;

參數

範圍類型描述
實例細繩要監視寫入事件的資料庫實例的實例名稱。

返回:

實例產生器

Firebase 即時資料庫執行個體建構器介面。

資料庫.ref()

註冊一個在 Firebase 即時資料庫寫入事件上觸發的函數。

此方法的行為與客戶端和管理 Firebase SDK 中的同名方法非常相似。對資料庫的任何變更會影響所提供path處或以下的數據,都會在 Cloud Functions 中觸發事件。

在 Cloud Functions 中偵聽即時資料庫事件與在客戶端和管理 SDK 中使用即時資料庫之間有三個重要差異:

  1. Cloud Functions 允許在path名稱中使用萬用字元。大括號 ( {}中的任何path組件) 是符合所有字串的通配符。與 Cloud Function 的特定呼叫相符的值會作為 [ EventContext.params的一部分傳回](cloud_functions_eventcontext.html#params 物件。例如, ref("messages/{messageId}")匹配/messages/message1/messages/message2處的更改,導致event.params.messageId設定為"message1""message2" , 分別。

  2. Cloud Functions 不會針對部署 Cloud Function 之前已存在的資料觸發事件。

  3. 雲函數事件可以存取更多信息,包括先前事件數據的快照以及觸發雲函數的用戶資訊。

簽名:

export declare function ref<Ref extends string>(path: Ref): RefBuilder<Ref>;

參數

範圍類型描述
小路參考號資料庫中用於監視寫入事件的路徑。

返回:

參考生成器<參考>

Firebase 即時資料庫建構器介面。