Firebase 实时数据库是一种托管在云端的数据库。数据以 JSON 格式存储并实时同步到所连接的每个客户端。当您使用我们的 Android、Apple 平台和 JavaScript SDK 构建跨平台应用时,所有的客户端共享一个 Realtime Database 实例,并自动接收包含最新数据的更新。
前提条件
如果您尚未安装 Firebase JS SDK 并初始化 Firebase,请先安装并进行初始化。
创建数据库
前往 Firebase 控制台的 Realtime Database 部分。系统将会提示您选择一个现有的 Firebase 项目。按照数据库创建工作流操作。
为您的 Firebase Security Rules选择一个初始模式:
- 测试模式
此模式适合刚开始使用移动和 Web 客户端库的开发者,但会允许任何人读取和覆盖您的数据。测试完成后,请务必查看了解 Firebase Realtime Database 规则部分。
如果是刚开始使用 Web、Apple 或 Android SDK,请选择测试模式。
- 锁定模式
拒绝来自移动和 Web 客户端的所有读写操作。经过身份验证的应用服务器仍然可以访问您的数据库。
为数据库选择位置。
新数据库的网址将采用下列格式之一,具体取决于数据库的位置:
(位于DATABASE_NAME.firebaseio.com
us-central1
的数据库) (位于所有其他位置的数据库)DATABASE_NAME.REGION.firebasedatabase.app
点击完成。
启用 Realtime Database 时,也会在 Cloud API 管理器中启用相应 API。
配置 Realtime Database Security Rules
Realtime Database 提供了声明式规则语言,可用于定义数据的结构、将数据编入索引的方式,以及何时可以在其中读取和写入数据。
添加 Realtime Database JS SDK 并初始化 Realtime Database
在初始化 JavaScript SDK 时,您必须指定您的 Realtime Database 网址。
您可以在 Firebase 控制台的 Realtime Database 部分中找到您的 Realtime Database 网址。数据库网址将采用下列格式之一,具体取决于数据库的位置:
(位于https://DATABASE_NAME.firebaseio.com
us-central1
的数据库) (适用于所有其他位置的数据库)https://DATABASE_NAME.REGION.firebasedatabase.app
使用以下这段代码初始化您的 SDK:
Web
import { initializeApp } from "firebase/app"; import { getDatabase } from "firebase/database"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... // The value of `databaseURL` depends on the location of the database databaseURL: "https://DATABASE_NAME.firebaseio.com", }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Realtime Database and get a reference to the service const database = getDatabase(app);
Web
import firebase from "firebase/app"; import "firebase/compat/database"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... // The value of `databaseURL` depends on the location of the database databaseURL: "https://DATABASE_NAME.firebaseio.com", }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Realtime Database and get a reference to the service const database = firebase.database();
现在可以开始使用 Firebase Realtime Database 了!
后续步骤
了解如何为 Realtime Database 设计数据结构。
准备启动您的应用:
启用 App Check,以帮助确保只有您的应用可以访问您的数据库。
在 Google Cloud 控制台中为您的项目设置预算提醒。
在 Firebase 控制台中监控“用量和结算”信息中心,以全面了解您的项目在多个 Firebase 服务中的用量信息。您还可以访问 Realtime Database 使用量信息中心,以了解更详细的使用情况信息。
查看 Firebase 发布核对清单。