database namespace

المهام

وظيفة وصف
مثيل (مثال) يسجل وظيفة يتم تشغيلها على الأحداث من مثيل قاعدة بيانات Firebase Realtime محدد.
المرجع (المسار) يسجل وظيفة يتم تشغيلها في أحداث كتابة قاعدة بيانات Firebase Realtime.

الطبقات

فصل وصف
لقطة بيانات واجهة تمثل لقطة بيانات قاعدة بيانات Firebase Realtime.
InstanceBuilder واجهة منشئ مثيل قاعدة بيانات Firebase Realtime. الوصول عبر [ database.instance() ](providers_database_.html#instance).
RefBuilder واجهة إنشاء مرجع قاعدة بيانات Firebase Realtime. الوصول عبر [ functions.database.ref() ](functions.database#.ref).

قاعدة البيانات.مثيل()

يسجل وظيفة يتم تشغيلها على الأحداث من مثيل قاعدة بيانات Firebase Realtime محدد.

استخدم هذه الطريقة مع ref لتحديد المثيل الذي تريد مراقبة أحداث قاعدة البيانات عليه. على سبيل المثال: firebase.database.instance('my-app-db-2').ref('/foo/bar')

لاحظ أن functions.database.ref المستخدم بدون instance يشاهد المثيل *الافتراضي* للأحداث.

إمضاء:

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

حدود

معامل يكتب وصف
مثال خيط اسم المثيل لمثيل قاعدة البيانات المطلوب مراقبته لأحداث الكتابة.

عائدات:

InstanceBuilder

واجهة منشئ مثيل قاعدة بيانات Firebase Realtime.

قاعدة البيانات.المرجع()

يسجل وظيفة يتم تشغيلها في أحداث كتابة قاعدة بيانات Firebase Realtime.

تتصرف هذه الطريقة بشكل مشابه جدًا للطريقة التي تحمل الاسم نفسه في العميل وAdmin Firebase SDK. سيؤدي أي تغيير في قاعدة البيانات يؤثر على البيانات الموجودة في path المقدم أو أسفله إلى إطلاق حدث في Cloud Functions.

هناك ثلاثة اختلافات مهمة بين الاستماع إلى حدث قاعدة بيانات Realtime في Cloud Functions واستخدام قاعدة بيانات Realtime في العميل وحزم SDK للمسؤول:

  1. تسمح وظائف السحابة بأحرف البدل في اسم path . أي مكون path بين قوسين متعرجين ( {} ) هو حرف بدل يطابق جميع السلاسل. يتم إرجاع القيمة المطابقة لاستدعاء معين لوظيفة السحابة كجزء من [ EventContext.params ](cloud_functions_eventcontext.html#params object. على سبيل المثال، ref("messages/{messageId}") يطابق التغييرات في /messages/message1 أو /messages/message2 ، مما يؤدي إلى تعيين event.params.messageId على "message1" أو "message2" ، على التوالى.

  2. لا تطلق وظائف السحابة حدثًا للبيانات الموجودة بالفعل قبل نشر وظيفة السحابة.

  3. تتمتع أحداث وظيفة السحابة بإمكانية الوصول إلى مزيد من المعلومات، بما في ذلك لقطة من بيانات الحدث السابق ومعلومات حول المستخدم الذي قام بتشغيل وظيفة السحابة.

إمضاء:

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

حدود

معامل يكتب وصف
طريق المرجع المسار داخل قاعدة البيانات لمشاهدة أحداث الكتابة.

عائدات:

RefBuilder <المرجع>

واجهة منشئ قاعدة بيانات Firebase Realtime.