database namespace

ฟังก์ชัน

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

ชั้นเรียน

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

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

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

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

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

ลายเซ็น:

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

พารามิเตอร์

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

การคืนสินค้า:

InstanceBuilder

อินเทอร์เฟซเครื่องมือสร้างอินสแตนซ์ฐานข้อมูลเรียลไทม์ของ Firebase

Database.ref()

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

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

การฟังเหตุการณ์ Realtime Database ใน Cloud Functions กับการใช้ Realtime Database ใน SDK ของไคลเอ็นต์และผู้ดูแลระบบมีข้อแตกต่างที่สำคัญ 3 ประการดังนี้

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. เหตุการณ์ของ Cloud Function มีสิทธิ์เข้าถึงข้อมูลเพิ่มเติม รวมถึงภาพรวมของข้อมูลเหตุการณ์ก่อนหน้าและข้อมูลเกี่ยวกับผู้ใช้ที่ทริกเกอร์ Cloud Function

ลายเซ็น:

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

พารามิเตอร์

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

การคืนสินค้า:

RefBuilder<อ้างอิง>

อินเทอร์เฟซเครื่องมือสร้างฐานข้อมูลเรียลไทม์ของ Firebase