database namespace

ฟังก์ชั่น

การทำงาน คำอธิบาย
อินสแตนซ์ (อินสแตนซ์) ลงทะเบียนฟังก์ชันที่ทริกเกอร์เหตุการณ์จากอินสแตนซ์ Firebase Realtime Database เฉพาะ
อ้างอิง (เส้นทาง) ลงทะเบียนฟังก์ชันที่ทริกเกอร์เหตุการณ์การเขียนฐานข้อมูลเรียลไทม์ของ Firebase

ชั้นเรียน

ระดับ คำอธิบาย
DataSnapshot อินเทอร์เฟซที่แสดงสแนปช็อตข้อมูลฐานข้อมูล Firebase Realtime
ตัวสร้างอินสแตนซ์ อินเทอร์เฟซตัวสร้างอินสแตนซ์ฐานข้อมูล Firebase Realtime เข้าถึงผ่าน [ database.instance() ](providers_database_.html#instance)
RefBuilder อินเทอร์เฟซตัวสร้างอ้างอิงฐานข้อมูล Firebase Realtime เข้าถึงผ่าน [ functions.database.ref() ](functions.database#.ref)

ฐานข้อมูล.อินสแตนซ์()

ลงทะเบียนฟังก์ชันที่ทริกเกอร์เหตุการณ์จากอินสแตนซ์ Firebase Realtime Database เฉพาะ

ใช้วิธีนี้ร่วมกับ ref เพื่อระบุอินสแตนซ์ที่จะเฝ้าดูเหตุการณ์ฐานข้อมูล ตัวอย่างเช่น: firebase.database.instance('my-app-db-2').ref('/foo/bar')

โปรดทราบว่า functions.database.ref ที่ใช้โดยไม่มี instance จะเฝ้าดูอินสแตนซ์ *default* สำหรับเหตุการณ์

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ พิมพ์ คำอธิบาย
ตัวอย่าง เชือก ชื่ออินสแตนซ์ของอินสแตนซ์ฐานข้อมูลเพื่อดูเหตุการณ์การเขียน

ผลตอบแทน:

ตัวสร้างอินสแตนซ์

อินเทอร์เฟซตัวสร้างอินสแตนซ์ฐานข้อมูล Firebase Realtime

ฐานข้อมูล.ref()

ลงทะเบียนฟังก์ชันที่ทริกเกอร์เหตุการณ์การเขียนฐานข้อมูลเรียลไทม์ของ Firebase

วิธีนี้มีการทำงานคล้ายกันมากกับวิธีการที่มีชื่อเดียวกันในไคลเอนต์และ Admin Firebase SDK การเปลี่ยนแปลงใดๆ ในฐานข้อมูลที่ส่งผลต่อข้อมูลที่อยู่ที่หรือต่ำกว่า path ที่ให้ไว้จะทำให้เกิดเหตุการณ์ใน Cloud Functions

มีความแตกต่างที่สำคัญสามประการระหว่างการฟังเหตุการณ์ Realtime Database ใน Cloud Functions และการใช้ Realtime Database ในไคลเอนต์และ Admin SDK:

  1. Cloud Functions อนุญาตให้ใช้ไวด์การ์ดในชื่อ path ส่วนประกอบ path ใด ๆ ในวงเล็บปีกกา ( {} ) คือไวด์การ์ดที่ตรงกับสตริงทั้งหมด ค่าที่ตรงกับการเรียกใช้ฟังก์ชันคลาวด์บางอย่างจะถูกส่งกลับโดยเป็นส่วนหนึ่งของ [ EventContext.params ](cloud_functions_eventcontext.html#params object ตัวอย่างเช่น ref("messages/{messageId}") จะจับคู่การเปลี่ยนแปลงที่ /messages/message1 หรือ /messages/message2 ส่งผลให้ event.params.messageId ถูกตั้งค่าเป็น "message1" หรือ "message2" ตามลำดับ

  2. ฟังก์ชันคลาวด์จะไม่เริ่มเหตุการณ์สำหรับข้อมูลที่มีอยู่แล้วก่อนที่จะปรับใช้ฟังก์ชันคลาวด์

  3. กิจกรรม Cloud Function มีสิทธิ์เข้าถึงข้อมูลเพิ่มเติม รวมถึงภาพรวมของข้อมูลเหตุการณ์ก่อนหน้าและข้อมูลเกี่ยวกับผู้ใช้ที่เรียกใช้ Cloud Function

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ พิมพ์ คำอธิบาย
เส้นทาง อ้างอิง เส้นทางภายในฐานข้อมูลเพื่อดูเหตุการณ์การเขียน

ผลตอบแทน:

RefBuilder <อ้างอิง>

อินเทอร์เฟซตัวสร้างฐานข้อมูล Firebase Realtime