このページは Cloud Translation API によって翻訳されました。

エラーメッセージ

このドキュメントでは、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` 値で特定されるユーザーに対してリソースへのアクセス権を付与するようリクエストします。
attributeError	400	このエラーは、ユーザーコードから存在しないオブジェクト属性が呼び出された場合に返されます。	対象のオブジェクトに、アクセスしようとしている属性があることを確認します。このエラーの詳細については、AttributeError をご覧ください。
backendError	500、503、または 504	このエラーは、サービスが現在利用できないことを示します。これは、次のような一時的な問題が原因で発生する可能性があります。サービス需要の急増: 使用量のピーク時など、需要が急増すると、すべての BigQuery ユーザーのサービス品質を保護するために負荷制限が発生する可能性があります。システムが過負荷にならないように、BigQuery はリクエストの一部に対して 500 または 503 エラーを返すことがあります。ネットワークの問題: BigQuery は分散型であるため、システム内のさまざまなコンポーネントやマシン間でデータが転送されることがよくあります。断続的なネットワーク接続の問題が原因で、BigQuery が 5xx エラーを返すことがあります。たとえば、SSL handshake の失敗や、ユーザーとGoogle Cloudの間のネットワークインフラストラクチャの問題などです。リソースの枯渇: BigQuery には、単一のユーザーまたは単一のジョブが過剰なリソースを消費しないように、サービス全体のパフォーマンスを保護するためのさまざまな内部リソース制限が設けられています。BigQuery は、リソースの枯渇に対処するために負荷制限を実装します。バックエンドエラー: まれに、BigQuery コンポーネントのいずれかで内部的な問題が発生し、クライアントに 500 または 503 エラーが返されることがあります。	5xx エラーはサービス側の問題であり、クライアントが修正または制御することはできません。クライアント側では、5xx エラーの影響を軽減するために、切り捨て型指数バックオフを使用してリクエストを再試行する必要があります。指数バックオフについて詳しくは、指数バックオフをご覧ください。ただし `jobs.get` 呼び出しと `jobs.insert` 呼び出しは特殊なケースで、トラブルシューティング手法が異なります。 `jobs.get` 呼び出し `jobs.get` のポーリング中に 503 エラーを受け取った場合は、数秒待ってから再度ポーリングします。ジョブが完了しても `backendError` を含むエラーオブジェクトが含まれる場合、ジョブは失敗しています。データ整合性の問題を心配することなく、ジョブを再試行できます。 `jobs.insert` 呼び出し `jobs.insert` 呼び出しの実行中にこのエラーを受け取った場合、ジョブが成功しているかどうかは不明です。この場合は、ジョブを再試行する必要があります。再試行が効果的でなく、問題が解決しない場合は、リクエストの失敗率を計算して、サポートにお問い合わせください。また、複数のワークフロー再起動試行で指数バックオフを使用して再試行しても、BigQuery への特定のリクエストが 5xx エラーで継続的に失敗する場合は、全体的なエラー率に関係なく、サポートにエスカレーションして、BigQuery 側から問題をトラブルシューティングする必要があります。問題が適切に優先順位付けされるように、ビジネスへの影響を明確に伝えてください。
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` フィールドを使用して、ストリーミングバッファ内のレコードの経過時間を特定することもできます。別の方法として、この制限がない BigQuery Storage Write API を使用してデータをストリーミングすることも検討できます。
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` でジョブを再試行します。エラーが引き続き発生する場合は、サポートにお問い合わせください。
jobRateLimitExceeded	400	このエラーは、ジョブが正常に作成されたものの、rateLimitExceeded エラーで失敗したときに返されます。このエラーは、`jobs.query` または `jobs.getQueryResults` で表示される場合があります。	指数バックオフを使用してリクエストレートを減らし、新しい `jobId` でジョブを再試行します。
notFound	404	このエラーは、存在しないリソース（データセット、テーブル、またはジョブ）を参照した場合、またはリクエストのロケーションがリソースのロケーション（たとえば、ジョブが実行されているロケーション）と一致しない場合に返されます。また、最近ストリーミングされて削除されたテーブルをテーブルデコレータで参照する場合にも発生することがあります。	リソース名を修正するか、正しいロケーションを指定してください。または、ストリーミング後 6 時間以上経過してから、削除されたテーブルのクエリを実行してください。
notImplemented	501	このジョブエラーは、実装されていない機能にアクセスしようとしたときに返されます。	詳細をサポートにお問い合わせください。
proxyAuthenticationRequired	407	このエラーは、リクエストにプロキシサーバーの有効な認証情報がない場合に、クライアント環境とプロキシサーバー間で返されます。詳細については、407 プロキシ認証が必要ですをご覧ください。	トラブルシューティングは環境によって異なります。Java で作業中にこのエラーが発生した場合は、等号の後に値を指定せずに `jdk.http.auth.tunneling.disabledSchemes=` プロパティと `jdk.http.auth.proxying.disabledSchemes=` プロパティの両方を設定していることを確認してください。
quotaExceeded	403	プロジェクトが BigQuery の割り当てまたはカスタム割り当てを超過したか、課金の設定なしでクエリの無料枠を超過したときに返されます。	超過した割り当ての詳細をエラーオブジェクトの `message` プロパティで確認します。BigQuery の割り当てをリセットしたり増やしたりするには、サポートにお問い合わせください。カスタム割り当てを変更するには、[割り当て] ページからリクエストを送信します。このエラーが 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"
  }
}

失敗したリクエストの割合と稼働時間を計算する

500 エラーと 503 エラーのほとんどは、指数バックオフを使用して再試行することで解決できます。500 エラーと 503 エラーが引き続き発生する場合は、リクエストの失敗率と対応する稼働率を計算して、BigQuery サービスレベル契約（SLA）と比較することで、サービスが想定どおりに動作しているかどうかを判断できます。

過去 30 日間のリクエストの失敗率を計算するには、過去 30 日間の特定 API 呼び出しまたはメソッドのリクエストの失敗数を、過去 30 日間のその API 呼び出しまたはメソッドのリクエストの合計数で割ります。この値に 100 を掛けると、30 日間のリクエスト失敗率の平均値が得られます。

たとえば、Cloud Logging データをクエリして、jobs.insert リクエストの合計数と失敗した jobs.insert リクエストの数を取得し、計算します。エラー率の値は、API ダッシュボードまたは Cloud Monitoring の Metrics Explorer を使用して取得することもできます。これらのオプションには、クライアントと BigQuery の間で発生したネットワーキングやルーティングの問題に関するデータは含まれません。そのため、より正確な障害率を計算するには、クライアントサイドのロギングとレポートシステムを使用することをおすすめします。

まず、100% からリクエストの失敗率を引きます。この値が BigQuery SLA に記載されている値以上の場合、稼働時間も BigQuery SLA を満たしています。ただし、この値が SLA に記載されている値を下回っている場合は、稼働時間を手動で計算します。

稼働時間を計算するには、サービスのダウンタイムと見なされる時間（分単位）を知る必要があります。サービスのダウンタイムとは、SLA の定義に従って計算されたエラー率が 10% を超える 1 分間の期間を意味します。稼働率を計算するには、過去 30 日間の合計時間（分）からサービスのダウンタイムの合計時間（分）を差し引きます。残りの時間を過去 30 日間の合計時間で割り、この値に 100 を掛けて、30 日間の稼働率を求めます。SLA に関連する定義と計算の詳細については、BigQuery サービスレベル契約（SLA）をご覧ください。

月間稼働率が BigQuery SLA に記載されている値以上の場合、エラーは一時的な問題が原因である可能性が高いため、指数バックオフを使用して再試行を続行できます。

稼働時間が SLA に示されている値を下回っている場合は、サポートにお問い合わせください。その際、観測された全体的なエラー率と稼働時間の計算結果をお知らせください。

認証エラー

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"
```
PROJECT_ID は、リソースを含むプロジェクトの ID に置き換えます。
認証に使用されている特定のユーザーまたはサービスアカウントを検索します。
```
resource.type="bigquery_resource"
protoPayload.authenticationInfo.principalEmail="EMAIL"
```
EMAIL は、ユーザーまたはサービスアカウントのメールアドレスに置き換えます。
管理アクティビティ監査ログで Identity and Access Management ポリシーの変更を検索します。
```
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
```
DATASET_ID は、リソースを含むデータセットの ID に置き換えます。

接続エラーメッセージ

次の表に、クライアントライブラリの使用時や、コードから BigQuery API を呼び出したときに、断続的な接続の問題が原因で表示される可能性のあるエラーメッセージを示します。

エラーメッセージ	クライアントライブラリまたは API	トラブルシューティング
com.google.cloud.bigquery.BigQueryException: 読み取りがタイムアウトしました	Java	タイムアウト値を大きくして設定します。
接続がシャットダウンされました: javax.net.ssl.SSLException: java.net.SocketException: com.google.cloud.bigquery.spi.v2.HttpBigQueryRpc.translate(HttpBigQueryRpc.java:115) で接続がリセットされました	Java	再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
javax.net.ssl.SSLHandshakeException: リモートホストがハンドシェイクを終了しました	Java	再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
BrokenPipeError: [Errno 32] パイプが無効です	Python	再試行メカニズムを実装します。このエラーの詳細については、BrokenPipeError をご覧ください。
接続が中断されました。RemoteDisconnected('リモートエンドが応答なしで接続を閉じました'	Python	タイムアウト値を大きくして設定します。
SSLEOFError（プロトコルに違反して EOF が発生した）	Python	このエラーは、413（`ENTITY_TOO_LARGE`）HTTP エラーの代わりに返されます。リクエストのサイズを小さくします。
TaskCanceledException: タスクがキャンセルされました	.NET ライブラリ	クライアント側のタイムアウト値を大きくします。
google.api_core.exceptions.PreconditionFailed: 412 PATCH	Python	このエラーは、HTTP リクエストを使用してテーブルリソースを更新しようとしたときに返されます。HTTP ヘッダーの ETag が古くなっていないことを確認します。テーブルまたはデータセットレベルのオペレーションの場合は、リソースが最後にインスタンス化されてから変更されていないことを確認します。必要に応じてオブジェクトを再作成します。
新しい接続を確立できませんでした: [Errno 110] 接続がタイムアウトしました	クライアントライブラリ	このエラーは、BigQuery からデータをストリーミングまたは読み取るときに、このリクエストがファイルの末尾（EOF）に達したときに返されます。再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
socks.ProxyConnectionError: HTTP プロキシ :8080 への接続中にエラーが発生しました: [Errno 110] 接続がタイムアウトしました	クライアントライブラリ	プロキシのステータスと設定のトラブルシューティングを行います。再試行メカニズムを実装し、タイムアウト値を大きくして設定します。
トランスポートストリームから予期しない EOF または 0 バイトを受信した	クライアントライブラリ	再試行メカニズムを実装し、タイムアウト値を大きくして設定します。

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

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

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

エラー メッセージ