调用bigquery.jobs.insert失败提示Dataset未找到问题咨询

执行Apps Script导入Google Drive CSV到BigQuery流程，调用bigquery.jobs.insert接口提交作业时返回以下报错，自感已配置正确数据集ID：

API call to bigquery.jobs.insert failed: Not Found: Dataset

• 数据集引用缺省项目ID：BigQuery数据集的唯一标识为项目ID.数据集ID，仅填写数据集短ID时，接口会默认在Apps Script关联的默认GCP项目下查找数据集，若数据集存放在其他自定义项目中，就会触发找不到资源的报错。
• 作业区域与数据集区域不匹配：BigQuery数据集绑定固定存储区域（单区域/多区域），提交作业时未显式指定区域参数时，接口默认在US区域检索资源，若数据集部署在非US区域，会直接返回数据集不存在，不会提示区域不匹配。
• 运行身份无数据集访问权限：BigQuery接口对无权限访问的数据集会统一返回“不存在”响应（避免未授权用户枚举资源），不会直接返回权限不足提示。若脚本执行身份（当前登录用户/绑定的服务账号）没有目标数据集的bigquery.datasets.get、bigquery.tables.create权限，也会触发该报错。
• 数据集ID拼写错误：BigQuery数据集ID仅支持小写字母、数字和下划线，若传参时混入大写字符、多余空格、错误连接符，肉眼排查容易遗漏，实际传值和真实ID不匹配。

1. 显式配置全路径数据集引用
   提交作业的配置项中，不要省略projectId字段，禁止仅传数据集短ID，参考配置写法：

   const loadJobConfig = {
     configuration: {
       load: {
         destinationTable: {
           projectId: "目标数据集所属的GCP项目ID", // 必须手动指定，不依赖默认值
           datasetId: "目标数据集ID", // 全小写，无前后空格
           tableId: "导入后的目标表名"
         },
         sourceFormat: "CSV",
         skipLeadingRows: 1, // CSV跳过表头行，按实际需求配置
         autodetect: true // 自动识别字段类型，按实际需求配置
       }
     }
   }
   

2. 显式匹配数据集区域
   先到BigQuery控制台查看目标数据集的所属区域（例如US、EU、asia-east1），调用插入作业接口时把区域作为参数传入，不要使用默认区域配置，参考调用写法：

   const projectId = "目标数据集所属的GCP项目ID";
   const location = "目标数据集的所属区域，和控制台显示完全一致";
   const job = BigQuery.Jobs.insert(loadJobConfig, projectId, {location: location});
   

3. 校验运行身份权限
   • 手动执行脚本的场景：确认当前登录的Google账号在BigQuery对应项目中至少拥有BigQuery 数据编辑者角色，能在BigQuery控制台正常打开、浏览目标数据集。
   • 服务账号执行脚本的场景：确认服务账号已被添加到目标数据集/项目的权限列表中，拥有对应读写权限，未被VPC服务控制规则拦截。
4. 最小化调用校验配置正确性
   在导入逻辑前添加一行数据集查询测试代码，提前验证项目ID、数据集ID、权限、区域配置是否正确，不用走到导入作业环节再排查：

   // 排查阶段临时添加，验证通过可删除
   const datasetMeta = BigQuery.Datasets.get(
     "目标数据集所属的GCP项目ID",
     "目标数据集ID"
   );
   console.log("数据集区域校验通过：", datasetMeta.location);
   

   若该调用成功返回数据集元数据，说明基础配置无问题，再检查导入作业的其他参数即可。

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