如何修改Firestore导出命令仅备份指定顶级集合的直接子集合？

当前使用的gcloud firestore export命令中，--collection-ids参数会匹配Firestore中所有同名的集合，无论它们的层级位置，因此会同时导出blueprints和copies下的plans、instructions子集合——这是工具的设计限制，无法直接通过修改现有命令参数实现仅导出blueprints下的子集合。以下是几种可行的解决方法：

方法1：通过Admin SDK编写自定义导出脚本 #

使用Firebase Admin SDK编写脚本，精准遍历并导出blueprints下的层级数据，步骤如下：

• 初始化Admin SDK连接到Firestore
• 遍历blueprints集合的所有文档
• 对每个blueprints文档，读取其下的plans子集合数据
• 再遍历每个plans文档，读取其下的instructions子集合数据
• 将读取到的数据导出为JSON文件或直接上传到GCS存储桶

示例Node.js代码片段：

const admin = require('firebase-admin');
const fs = require('fs');

admin.initializeApp();
const db = admin.firestore();

async function exportBlueprintsData() {
  const blueprintsSnapshot = await db.collection('blueprints').get();
  const exportData = { blueprints: [] };

  for (const blueprintDoc of blueprintsSnapshot.docs) {
    const blueprintData = { id: blueprintDoc.id, ...blueprintDoc.data(), plans: [] };
    const plansSnapshot = await blueprintDoc.ref.collection('plans').get();
    
    for (const planDoc of plansSnapshot.docs) {
      const planData = { id: planDoc.id, ...planDoc.data(), instructions: [] };
      const instructionsSnapshot = await planDoc.ref.collection('instructions').get();
      
      instructionsSnapshot.docs.forEach(instrDoc => {
        planData.instructions.push({ id: instrDoc.id, ...instrDoc.data() });
      });
      
      blueprintData.plans.push(planData);
    }
    
    exportData.blueprints.push(blueprintData);
  }

  fs.writeFileSync('bluebacks_export.json', JSON.stringify(exportData, null, 2));
  console.log('导出完成');
}

exportBlueprintsData();

方法2：使用Dataflow自定义作业导出 #

对于大数据量场景，可利用Google Cloud Dataflow构建自定义作业：

• 创建Dataflow作业，使用Firestore读取连接器
• 通过配置查询条件，仅读取blueprints集合及其子集合的路径（如blueprints/{docId}/plans/{planId}）
• 将过滤后的数据写入GCS存储桶，实现精准导出

方法3：临时重命名不需要的集合（适合一次性操作） #

如果是临时导出需求，可通过以下步骤快速实现：

1. 在Firestore控制台或使用Admin SDK将copies集合重命名为临时名称（如copies_temp）
2. 执行原导出命令：gcloud firestore export gs://<projectId>.appspot.com/backup/default/2025_03_11_DEV --collection-ids=blueprints,plans,instructions
3. 导出完成后，将临时名称改回copies

注意：此方法需确保重命名期间没有针对copies集合的写入操作，避免数据丢失或不一致。

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