database namespace

פונקציות

פוּנקצִיָה תיאור
instance (instance) רושם פונקציה שמפעילה אירועים ממופע ספציפי של Firebase Realtime Database.
ref(נתיב) רושם פונקציה שמפעילה אירועי כתיבה של Firebase Realtime Database.

שיעורים

מעמד תיאור
תמונת נתונים ממשק המייצג תמונת מצב של נתונים של מסד נתונים של Firebase בזמן אמת.
InstanceBuilder ממשק בונה המופעים של Firebase Realtime Database. גישה דרך [ database.instance() ](providers_database_.html#instance).
RefBuilder ממשק בונה הפניות של Firebase Realtime Database. גישה דרך [ functions.database.ref() ](functions.database#.ref).

database.instance()

רושם פונקציה שמפעילה אירועים ממופע ספציפי של Firebase Realtime Database.

השתמש בשיטה זו יחד עם 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 Database.

database.ref()

רושם פונקציה שמפעילה אירועי כתיבה של Firebase Realtime Database.

שיטה זו מתנהגת באופן דומה מאוד לשיטה בעלת אותו שם ב-client ו-Admin Firebase SDK. כל שינוי במסד הנתונים שמשפיע על הנתונים path המסופק או מתחתיו יפעיל אירוע ב-Cloud Functions.

ישנם שלושה הבדלים חשובים בין האזנה לאירוע Realtime Database ב-Cloud Functions לבין שימוש במסד הנתונים בזמן אמת ב-SDK של הלקוח וה-Admin:

  1. Cloud Functions מאפשר תווים כלליים בשם path . כל רכיב path בסוגריים מסולסלים ( {} ) הוא תו כללי שמתאים לכל המחרוזות. הערך שתאם הפעלה מסוימת של פונקציית ענן מוחזר כחלק מה-[ EventContext.params ](cloud_functions_eventcontext.html#params אובייקט. לדוגמה, ref("messages/{messageId}") מתאים לשינויים ב- /messages/message1 או /messages/message2 , וכתוצאה מכך event.params.messageId מוגדר ל- "message1" או "message2" , בהתאמה.

  2. פונקציות ענן אינן מפעילות אירוע עבור נתונים שכבר היו קיימים לפני פריסת פונקציית הענן.

  3. לאירועי Cloud Function יש גישה למידע נוסף, כולל תמונת מצב של נתוני האירועים הקודמים ומידע על המשתמש שהפעיל את פונקציית הענן.

חֲתִימָה:

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

פרמטרים

פָּרָמֶטֶר סוּג תיאור
נָתִיב רפ הנתיב בתוך מסד הנתונים לצפייה באירועי כתיבה.

החזרות:

RefBuilder <Ref>

ממשק בונה מסדי נתונים של Firebase בזמן אמת.