エラーメッセージ

このドキュメントでは、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 ツールのトラブルシューティングの詳細については、デバッグをご覧ください。

エラーメッセージ	HTTP コード	説明	トラブルシューティング
accessDenied	403	このエラーは、アクセス権限のないリソース（データセット、テーブル、ビュー、ジョブなど）にアクセスしようとしたときに返されます。また、読み取り専用オブジェクトを変更しようとしたときにも返されます。	リソースのオーナーに連絡し、エラーの監査ログの `principalEmail` 値で特定されるユーザーに対してリソースへのアクセス権を付与するようリクエストします。
backendError	500 または 503	このエラーは、一時的なサーバー障害（ネットワーク接続の問題、サーバーの過負荷など）が発生したときに返されます。	通常、しばらくしてからもう一度試します。問題が繰り返し発生する場合は、指数バックオフで再試行してください。ただし `jobs.get` 呼び出しと `jobs.insert` 呼び出しは特殊なケースで、トラブルシューティング手法が異なります。 `jobs.get` 呼び出し `jobs.get` のポーリング中に 503 エラーを受け取った場合は、数秒待ってから再度ポーリングします。ジョブが完了しても `backendError` を含むエラーオブジェクトが含まれる場合、ジョブは失敗しています。データ整合性の問題を心配することなく、ジョブを再試行できます。 `jobs.insert` 呼び出し `jobs.insert` 呼び出しの実行中にこのエラーを受け取った場合、ジョブが成功しているかどうかは不明です。この場合は、ジョブを再試行する必要があります。
badRequest	400	`'UPDATE or DELETE statement over table <project.dataset.table> would affect rows in the streaming buffer, which is not supported'` エラーは、最近ストリーミングされたテーブル内の行の一部が DML オペレーション（`DELETE`、`UPDATE`、`MERGE`）で使用できない場合に発生することがあります。使用できない状態となるのは通常は数分ほどですが、まれに 90 分ほど続く場合があります。詳細については、ストリーミングデータの可用性と DML の制限事項をご覧ください。	テーブルの DML オペレーションでデータを使用できるかどうかを調べるには、`tables.get` レスポンスで streamingBuffer セクションの有無を確認します。streamingBuffer セクションが存在しない場合、テーブルデータは DML オペレーションで使用できます。`streamingBuffer.oldestEntryTime` フィールドを使用して、ストリーミングバッファ内のレコードの経過時間を特定することもできます。
billingNotEnabled	403	プロジェクトで課金が有効になっていないときに返されます。	Google Cloud コンソールでプロジェクトの課金を有効にします。
billingTierLimitExceeded	400	このエラーは、オンデマンドジョブの `statistics.query.billingTier` の値が 100 を超えると返されます。これは、スキャンされたデータの量と比べてオンデマンドクエリが使用する CPU が多すぎる場合に発生します。ジョブ統計情報を調べる方法については、ジョブの管理をご覧ください。	このエラーは多くの場合、厳密でない結合条件などにより、非効率なクロス結合が明示的または暗黙的に実行されたことが原因で発生します。この種のクエリはリソースの消費量が多いため、オンデマンド料金の使用には適していません。また、適切にスケーリングされない可能性があります。このエラーを解決するには、クエリを最適化するか、容量ベース（スロット）料金モデルに切り替えます。クエリの最適化については、SQL アンチパターンの回避をご覧ください。
blocked	403	このエラーは、実行しようとしたオペレーションが BigQuery で一時的に拒否リストに追加されているとき（通常、サービスの停止を防ぐためなどに行われます）に返されます。	詳細をサポートにお問い合わせください。
duplicate	409	すでに存在するジョブ、データセット、テーブルを作成しようとしたときに返されます。また、ジョブの `writeDisposition` プロパティが `WRITE_EMPTY` に設定されていて、ジョブがアクセスする書き込み先のテーブルがすでに存在するときにも返されます。	作成しようとしているリソースの名前を変更するか、ジョブの `writeDisposition` 値を変更します。
internalError	500	BigQuery で内部エラーが発生したときに返されます。	BigQuery サービスレベル契約に記載されているバックオフ要件に沿って待機した後、オペレーションを再試行してください。エラーが続く場合は、サポートに問い合わせるか、BigQuery Issue Tracker を使用してバグを報告してください。また、予約を使用することでこのエラーの頻度を低減できます。
invalid	400	このエラーは、無効なクエリ以外のなんらかの無効な入力（必須フィールドの欠落、無効なテーブルスキーマなど）があると返されます。無効なクエリは `invalidQuery` エラーを返します。
invalidQuery	400	このエラーは、無効なクエリを実行しようとしたときに返されます。	クエリに構文エラーがないか確認してください。クエリリファレンスに、有効なクエリの作成方法についての説明と例があります。
invalidUser	400	無効なユーザー認証情報でクエリをスケジュールしようとしたときに返されます。	クエリのスケジューリングの説明に従ってユーザー認証情報を更新してください。
jobBackendError	400	このエラーは、ジョブが正常に作成されたものの、内部エラーで失敗したときに返されます。このエラーは、`jobs.query` または `jobs.getQueryResults` で表示される場合があります。	新しい `jobId` でジョブを再試行します。エラーが引き続き発生する場合は、サポートにお問い合わせください。
jobInternalError	400	このエラーは、ジョブが正常に作成されたものの、内部エラーで失敗したときに返されます。このエラーは、`jobs.query` または `jobs.getQueryResults` で表示される場合があります。	新しい `jobId` でジョブを再試行します。エラーが引き続き発生する場合は、サポートにお問い合わせください。
notFound	404	このエラーは、存在しないリソース（データセット、テーブル、またはジョブ）を参照した場合、またはリクエストのロケーションがリソースのロケーション（たとえば、ジョブが実行されているロケーション）と一致しない場合に返されます。また、最近ストリーミングされて削除されたテーブルをテーブルデコレータで参照する場合にも発生することがあります。	リソース名を修正するか、正しいロケーションを指定してください。または、ストリーミング後 6 時間以上経過してから、削除されたテーブルのクエリを実行してください。
notImplemented	501	このジョブエラーは、実装されていない機能にアクセスしようとしたときに返されます。	詳細をサポートにお問い合わせください。
quotaExceeded	403	プロジェクトが BigQuery の割り当てまたはカスタム割り当てを超過したか、課金の設定なしでクエリの無料枠を超過したときに返されます。	超過した割り当ての詳細をエラーオブジェクトの `message` プロパティで確認します。BigQuery の割り当てをリセットしたり増やしたりするには、サポートにお問い合わせください。カスタム割り当てを変更するには、Google Cloud コンソールからリクエストを送信します。このエラーが BigQuery サンドボックスの使用時に発生した場合は、サンドボックスからアップグレードできます。詳細については、BigQuery 割り当てエラーのトラブルシューティングをご覧ください。
rateLimitExceeded	403	プロジェクトで多数のリクエストを短時間で送信して、短期のレート上限を超過した場合にこのエラーが返されます。たとえば、クエリジョブのレート制限と API リクエストのレート制限をご覧ください。	リクエストのレートを下げます。プロジェクトがどの制限も超過していないと思われる場合は、サポートにお問い合わせください。詳細については、BigQuery 割り当てエラーのトラブルシューティングをご覧ください。
resourceInUse	400	テーブルを含むデータセットを削除しようとしたとき、または現在実行中のジョブを削除しようとしたときに返されます。	データセットを空にしてから削除するか、ジョブが完了するのを待ってから削除します。
resourcesExceeded	400	このエラーは、ジョブで使用するリソースの数が多すぎるときに返されます。	このエラーは、ジョブで使用するリソースの数が多すぎるときに返されます。トラブルシューティング情報については、リソース超過エラーのトラブルシューティングをご覧ください。
responseTooLarge	403	クエリの結果が最大レスポンスサイズよりも大きいときに返されます。クエリによっては複数のステージで実行されますが、このエラーは、いずれかのステージで返されるレスポンスサイズが大きすぎるときに返されます（最終的な結果が最大レスポンスサイズより小さい場合でもエラーとなります）。このエラーは、クエリで `ORDER BY` 句を使用しているときによく返されます。	`LIMIT` 句を追加するとエラーが解消されることがあります。または `ORDER BY` 句を削除します。サイズの大きい結果を返せるようにする場合は、`allowLargeResults` プロパティを `true` に設定し、宛先テーブルを指定します。詳細については、サイズの大きいクエリ結果の書き込みをご覧ください。
stopped	200	このステータスコードは、ジョブがキャンセルされた場合に返されます。
tableUnavailable	400	一部の BigQuery テーブルでは、他の Google プロダクトチームによって管理されているデータが使用されます。このエラーは、そのようなテーブルのいずれか 1 つが使用不可であることを示します。	このエラーメッセージが出た場合は、リクエストを再試行する（internalError のトラブルシューティングヒントを参照）か、データへのアクセス権を付与した Google プロダクトチームに問い合わせてください。
timeout	400	ジョブがタイムアウトしました。	操作によって実行される作業量を減らし、設定された制限内に収まるようにしてください。割り当てと上限をご覧ください。

エラーレスポンスの例

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 を呼び出したときに、断続的な接続の問題が原因で表示される可能性のあるエラーメッセージを示します。

エラーメッセージ	クライアントライブラリまたは API	トラブルシューティング
接続がシャットダウンされました: javax.net.ssl.SSLException: java.net.SocketException: com.google.cloud.bigquery.spi.v2.HttpBigQueryRpc.translate(HttpBigQueryRpc.java:115) で接続がリセットされました	Java	再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
javax.net.ssl.SSLHandshakeException: リモートホストがハンドシェイクを終了しました	Java	再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
接続が中断されました。RemoteDisconnected('リモートエンドが応答なしで接続を閉じました'	Python	タイムアウト値を大きくして設定します。
TaskCanceledException: タスクがキャンセルされました	.NET ライブラリ	クライアント側のタイムアウト値を大きくします。

Google Cloud コンソールのエラーメッセージ

次の表に、Google Cloud コンソールで作業中に表示される可能性があるエラーメッセージを示します。

エラーメッセージ	説明	トラブルシューティング
サーバーから不明なエラーレスポンスが返されました。	このエラーは、Google Cloud コンソールがサーバーから不明なエラーを受け取った場合に発生します。たとえば、データセットや他のタイプのリンクをクリックしてもページが表示されない場合に発生します。	ブラウザのシークレットモード（非公開モード）に切り替えて、エラーの原因となった操作を繰り返してください。シークレットモードでエラーが発生しない場合は、広告ブロッカーなどのブラウザ拡張機能が原因である可能性があります。通常モードでブラウザの拡張機能を無効にして、問題が解決するかどうか確認してください。

エラー メッセージ