错误消息

本文档介绍使用 BigQuery 时可能会遇到的错误消息，包括 HTTP 错误代码和建议的问题排查步骤。

如需详细了解查询错误，请参阅排查查询错误。

如需详细了解流式插入错误，请参阅排查流式插入问题。

错误表

BigQuery API 的响应在响应正文中包含 HTTP 错误代码和错误对象。错误对象通常是以下各项之一：

• errors 对象，包含一个 ErrorProto 对象数组。
• 一个 errorResults 对象，其中包含一个 ErrorProto 对象。

下表中的错误消息列会映射到 ErrorProto 对象中的 reason 属性。

下表并未包含所有可能的 HTTP 错误或其他网络错误。因此，请勿假设 BigQuery 的每个错误响应中都存在错误对象。此外，如果您使用适用于 BigQuery API 的 Cloud 客户端库，您可能会收到不同的错误或错误对象。如需了解详情，请参阅 BigQuery API 客户端库。

如果收到的 HTTP 响应代码未显示在下表中，则该响应代码表示该 HTTP 请求存在问题或结果符合预期。5xx 范围内的响应代码表示服务器端错误。如果您收到 5xx 响应代码，则请稍后重试请求。在某些情况下，中间服务器（如代理）可能会返回 5xx 响应代码。检查响应正文和响应标头以详细了解错误。如需查看 HTTP 响应代码的完整列表，请参阅 HTTP 响应代码。

如果使用 bq 命令行工具检查作业状态，则默认情况下不会返回错误对象。如需查看映射到下表的错误对象以及相应的 reason 属性，请使用 --format=prettyjson 标志。例如 bq --format=prettyjson show -j <job id>。如需查看 bq 工具的详细日志记录，请使用 --apilog=stdout。如需详细了解如何对 bq 工具进行问题排查，请参阅调试。

错误响应示例

GET https://bigquery.googleapis.com/bigquery/v2/projects/12345/datasets/foo
Response:
[404]
{
  "error": {
  "errors": [
  {
    "domain": "global",
    "reason": "notFound",
    "message": "Not Found: Dataset myproject:foo"
  }],
  "code": 404,
  "message": "Not Found: Dataset myproject:foo"
  }
}

身份验证错误

如 OAuth2 规范所定义，OAuth 令牌生成系统引发的错误会返回以下 JSON 对象。

{"error" : "description_string"}

此错误会伴随着 HTTP 400 Bad Request 错误或 HTTP 401 Unauthorized 错误。description_string 是由 OAuth2 规范定义的其中一个错误代码。例如：

{"error":"invalid_client"}

查看错误

您可以使用 Logs Explorer 查看特定作业、用户或其他范围的身份验证错误。下面列举了一些 Logs Explorer 过滤条件示例，您可以使用这些过滤条件查看身份验证错误。

在“政策拒绝”审核日志中搜索存在权限问题的失败作业：

    resource.type="bigquery_resource"
    protoPayload.status.message=~"Access Denied"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access"
  

搜索用于身份验证的特定用户或服务账号：

    resource.type="bigquery_resource"
    protoPayload.authenticationInfo.principalEmail="EMAIL"
  

将 EMAIL 替换为用户或服务账号的电子邮件地址。

在“管理员活动”审核日志中搜索 IAM 政策更改：

    protoPayload.methodName=~"SetIamPolicy"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
  

在“数据访问”审核日志中搜索对特定 BigQuery 数据集所做的更改：

    resource.type="bigquery_resource"
    protoPayload.resourceName="projects/PROJECT_ID/datasets/DATASET_ID"
    logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
  

替换以下内容：

• PROJECT_ID：资源所在项目的 ID
• DATASET_ID：资源所在数据集的 ID

连接错误消息

下表列出了在使用客户端库或从代码调用 BigQuery API 时，由于间歇性连接问题而可能会看到的错误消息：

Google Cloud 控制台错误消息

下表列出了使用 Google Cloud 控制台时可能会看到的错误消息。