解决服务账户通过BigQuery外部表访问Google Sheets的文件未找到错误

遇到这种情况，我建议你从以下几个方向排查，这些都是我处理类似问题时常用的解决步骤：

1. 确认Google Drive API已启用 #

BigQuery访问Google Sheets依赖Google Drive API，即便你已经给服务账户共享了Sheets，如果Drive API没启用，还是会出现找不到文件的错误。

• 登录Google Cloud Console，进入你的项目
• 搜索并进入API和服务 > 库
• 查找「Google Drive API」，确保它的状态是「已启用」；如果未启用，点击「启用」按钮

2. 核对外部表的数据源URI正确性 #

错误的URI是这类问题的常见原因，你需要确认外部表定义里的路径完全匹配目标Sheets：

• 目标Sheets的正确ID是浏览器地址栏中docs.google.com/spreadsheets/d/后面的那串字符
• 检查BigQuery外部表的数据源URI格式，正确格式应为：gsheets://docs.google.com/spreadsheets/d/<SPREADSHEET_ID>/（如果指定了工作表，后面可以加sheets/<SHEET_NAME>）
• 确认URI里的ID和Sheets的实际ID完全一致，没有多余的字符或拼写错误

3. 验证服务账户对Sheets文件的实际访问权限 #

虽然你已经共享了Sheets给服务账户，但有时候可能存在共享配置的疏漏，你可以通过代码验证：

• 使用你的服务账户密钥，在Node.js里调用Drive API的files.get方法，传入Sheets的ID，尝试获取文件信息：

  const {google} = require('googleapis');
  const auth = new google.auth.GoogleAuth({
    keyFile: 'path/to/your/service-account-key.json',
    scopes: ['https://www.googleapis.com/auth/drive.readonly'],
  });
  
  async function checkSheetAccess() {
    const drive = google.drive({version: 'v3', auth});
    try {
      const response = await drive.files.get({fileId: 'YOUR_SHEET_ID'});
      console.log('Successfully accessed sheet:', response.data.name);
    } catch (err) {
      console.error('Failed to access sheet:', err.message);
    }
  }
  checkSheetAccess();
  

• 如果这个调用失败，说明共享权限有问题：检查共享时是否输入了正确的服务账户邮箱，或者是否给了「查看者」及以上的权限；如果Sheets在某个文件夹下，还要确保文件夹也共享给了该服务账户

4. 检查服务账户的OAuth权限范围 #

确保你的服务账户在访问BigQuery时，包含了必要的Drive权限范围：

• 如果你是通过代码初始化BigQuery客户端，确认scopes里包含了https://www.googleapis.com/auth/drive.readonly或https://www.googleapis.com/auth/drive（根据需求选择）：

  const {BigQuery} = require('@google-cloud/bigquery');
  const bigquery = new BigQuery({
    keyFilename: 'path/to/your/service-account-key.json',
    scopes: [
      'https://www.googleapis.com/auth/bigquery',
      'https://www.googleapis.com/auth/drive.readonly'
    ],
  });
  

• 如果是通过Cloud IAM配置的默认权限，确保服务账户的权限集合里包含Drive相关的权限（比如roles/drive.reader）

5. 排查BigQuery外部表的数据集权限 #

虽然你提到服务账户访问其他表正常，但还是要确认外部表所在的数据集是否给了服务账户正确的权限：

• 进入BigQuery控制台，找到外部表所在的数据集
• 检查数据集的权限列表，确认服务账户拥有BigQuery Data Editor或BigQuery Data Viewer权限（Data Editor权限足够）

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