エラー メッセージ

このドキュメントでは、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"
  }
}

認証エラー

OAuth トークン生成システムによってスローされたエラーは、次の JSON オブジェクトを返します。これは OAuth2 仕様で定義されています。

{"error" : "description_string"}

このエラーは HTTP 400 Bad Request エラーまたは HTTP 401 Unauthorized エラーを伴います。description_string は OAuth2 仕様で定義されたいずれかのエラーコードです。次に例を示します。

{"error":"invalid_client"}

エラーを確認する

ログ エクスプローラを使用すると、特定のジョブ、ユーザー、その他のスコープの認証エラーを表示できます。認証エラーを確認するために使用できるログ エクスプローラのフィルタの例をいくつか示します。

ポリシー拒否監査ログで、権限の問題がある失敗したジョブを検索します。

    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 コンソールで作業中に表示される可能性があるエラー メッセージを示します。