database namespace

الدوال

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

صفوف

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

data.instance()

لتسجيل دالة تعمل على الأحداث من مثيل معيّن لقاعدة بيانات Firebase في الوقت الفعلي.

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

يُرجى العلم أنّ functions.database.ref المستخدَم بدون instance يراقب المثيل *التلقائي* للأحداث.

Signature:

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

المَعلمات

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

المرتجعات:

InstanceBuilder

واجهة أداة إنشاء مثيلات قاعدة بيانات Firebase في الوقت الفعلي.

data.ref()

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

تعمل هذه الطريقة بشكل مشابه جدًا للطريقة التي تحمل الاسم نفسه في حِزم تطوير البرامج (SDK) لمنصة Firebase الخاصة بالعميل والمشرف. سيؤدي أي تغيير في قاعدة البيانات يؤثِّر في البيانات المتوفّرة في path أو أسفله إلى تنشيط حدث في دوال السحابة.

هناك ثلاثة اختلافات مهمة بين الاستماع إلى حدث قاعدة بيانات في الوقت الفعلي في Cloud Functions واستخدام "قاعدة البيانات في الوقت الفعلي" في البرنامج وحِزم SDK للمشرف:

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

2. لا تعمل دوال السحابة الإلكترونية على تنشيط حدث للبيانات التي كانت متوفّرة قبل تفعيل دالة Cloud.

3. يمكن لأحداث Cloud Function الوصول إلى مزيد من المعلومات، بما في ذلك نبذة عن بيانات الأحداث السابقة ومعلومات عن المستخدم الذي فعّل دالة Cloud.

Signature:

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

المَعلمات

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

المرتجعات:

refBuilder< ref>

واجهة أداة إنشاء قاعدة بيانات Firebase في الوقت الفعلي.