Firebase中Primary Key与Foreign Key使用方法及VS Code代码示例咨询

Firebase的数据库（Realtime Database/Firestore）属于NoSQL体系，和传统SQL的主键/外键逻辑略有区别：

• 主键：Realtime Database中是每个节点的唯一key；Firestore中是文档的唯一ID（可自动生成或自定义）
• 外键：通过存储另一个节点/文档的主键ID，关联不同数据集，实现类似SQL的关系关联

一、Firebase Realtime Database 实现示例 #

数据结构设计 #

以博客系统为例，users节点存储用户（主键为用户ID），posts节点存储文章，用userId作为外键关联用户：

{
  "users": {
    "user_1": {
      "name": "张三",
      "email": "zhangsan@example.com"
    },
    "user_2": {
      "name": "李四",
      "email": "lisi@example.com"
    }
  },
  "posts": {
    "post_1": {
      "title": "Firebase入门",
      "content": "这是一篇Firebase教程",
      "userId": "user_1" // 外键，关联users节点的user_1主键
    },
    "post_2": {
      "title": "NoSQL最佳实践",
      "content": "分享NoSQL使用技巧",
      "userId": "user_2"
    }
  }
}

VS Code 代码实现（JavaScript） #

// 导入Firebase模块
import { initializeApp } from "firebase/app";
import { getDatabase, ref, set, get, child } from "firebase/database";

// 替换为你的Firebase项目配置
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  databaseURL: "YOUR_DATABASE_URL",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_STORAGE_BUCKET",
  messagingSenderId: "YOUR_SENDER_ID",
  appId: "YOUR_APP_ID"
};

// 初始化App和数据库
const app = initializeApp(firebaseConfig);
const db = getDatabase(app);

// 1. 写入用户（自定义主键，也可用push()自动生成）
async function addUser(userData) {
  const userRef = ref(db, 'users/' + Date.now()); 
  await set(userRef, userData);
  console.log("用户写入成功，主键：", userRef.key);
}

// 2. 写入文章并关联用户（使用userId作为外键）
async function addPost(postData, userId) {
  const postRef = ref(db, 'posts/' + Date.now());
  await set(postRef, { ...postData, userId });
  console.log("文章写入成功");
}

// 3. 查询文章并关联用户信息
async function getPostWithUser(postId) {
  const dbRef = ref(db);
  const postSnapshot = await get(child(dbRef, `posts/${postId}`));
  
  if (postSnapshot.exists()) {
    const post = postSnapshot.val();
    const userSnapshot = await get(child(dbRef, `users/${post.userId}`));
    
    if (userSnapshot.exists()) {
      const user = userSnapshot.val();
      console.log("文章及关联用户：", { ...post, author: user });
    }
  } else {
    console.log("未找到该文章");
  }
}

// 调用示例
addUser({ name: "张三", email: "zhangsan@example.com" });
addPost({ title: "Firebase入门", content: "这是一篇教程" }, "user_1");
getPostWithUser("post_1");

VS Code 代码编写截图 #

二、Firestore 实现示例 #

Firestore是文档型数据库，主键为文档ID，外键可存储其他文档ID或直接使用DocumentReference类型关联。

VS Code 代码实现（JavaScript） #

import { initializeApp } from "firebase/app";
import { getFirestore, doc, setDoc, getDoc, collection, addDoc } from "firebase/firestore";

// 替换为你的Firebase项目配置
const firebaseConfig = {
  // 你的配置内容
};

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

// 1. 添加用户（自定义主键）
async function addFirestoreUser(userData, userId) {
  await setDoc(doc(db, "users", userId), userData);
  console.log("用户添加成功，主键：", userId);
}

// 2. 添加文章并关联用户（userId作为外键）
async function addFirestorePost(postData, userId) {
  const postRef = await addDoc(collection(db, "posts"), {
    ...postData,
    userId: userId // 外键，关联users集合的文档ID
  });
  console.log("文章添加成功，主键：", postRef.id);
}

// 3. 查询文章并获取关联用户信息
async function getPostWithAuthor(postId) {
  const postDoc = doc(db, "posts", postId);
  const postSnapshot = await getDoc(postDoc);
  
  if (postSnapshot.exists()) {
    const post = postSnapshot.data();
    const userDoc = doc(db, "users", post.userId);
    const userSnapshot = await getDoc(userDoc);
    
    if (userSnapshot.exists()) {
      const user = userSnapshot.data();
      console.log("文章及作者信息：", { ...post, author: user, postId: postSnapshot.id });
    }
  } else {
    console.log("未找到该文章");
  }
}

// 调用示例
addFirestoreUser({ name: "李四", email: "lisi@example.com" }, "user_2");
addFirestorePost({ title: "NoSQL最佳实践", content: "分享技巧" }, "user_2");
getPostWithAuthor("POST_DOC_ID");

关键注意事项 #

• Realtime Database中可用push()自动生成唯一主键，也可自定义（比如用户UID）
• Firestore中若需强关联，建议使用DocumentReference类型而非纯字符串ID，可直接获取关联文档
• Firebase不支持SQL式JOIN，查询关联数据需手动执行两次查询；大量关联数据场景下，建议采用数据扁平化或子集合优化性能

内容的提问来源于stack exchange，提问作者Cookie