BigQuery API の HTTP ステータス コードとエラーコード

このページでは、BigQuery API から返される HTTP ステータス コードとエラー メッセージについて説明します。これらのコードを使用して、リクエスト エラーのトラブルシューティングと解決、API の動作の確認を行うことができます。

API 以外のエラー、クライアント ライブラリの接続エラー、 Cloud de Confiance コンソール エラーの詳細については、エラー メッセージをご覧ください。

クエリエラーの詳細については、クエリに関する問題のトラブルシューティングをご覧ください。

ストリーミング挿入エラーの詳細については、ストリーミング挿入のトラブルシューティングをご覧ください。

エラー レスポンスの形式

BigQuery は、API に標準の HTTP エラー レポート形式を使用します。リクエストが成功すると、2xx の範囲の HTTP ステータス コードが返されます。失敗したリクエストは、4xx と 5xx の範囲のステータス コードを返します。リダイレクトが必要なリクエストは、3xx 範囲のステータス コードを返します。エラー レスポンスの本文には通常、JSON ドキュメントが含まれます。このドキュメントには、エラーに関する情報を含むエラー オブジェクトが含まれています。

BigQuery API レスポンスでは、エラー オブジェクトは通常、次のいずれかになります。

このページのステータス コード表の「理由」列は、ErrorProto オブジェクトの reason プロパティに対応しています。bq コマンドライン ツールを使用してジョブ ステータスを確認する場合は、--format=prettyjson フラグ(bq --format=prettyjson show -j <var>JOB_ID</var> など)または --apilog=stdout を使用して、エラー オブジェクトとその reason プロパティを表示します。

次の表に、エラーのレスポンス本文に表示される要素を示します。フィールドを組み合わせて使用することで、問題の特定に役立ちます。また、次の表のサンプル値は説明用であり、使用可能なすべての値の完全なリストではありません。

要素 説明
code HTTP ステータス コードの値。テキストによる説明は含まれません。

値の例としては、400(Bad Request)、403(Forbidden)、404(Not Found)などがあります。
error エラー情報のコンテナ。
errors エラーの詳細を含むコンテナ。
エラー。domain エラーの範囲。値の例としては、global、usageLimits などがあります。
エラー。location エラーの原因となった locationType 内の特定のアイテム。たとえば、パラメータに無効な値を指定した場合、location はパラメータの名前になります。

値の例としては、Authorization や project などがあります。
エラー。locationType エラーの原因となったリクエストの場所または部分。location と組み合わせて使用すると、エラーを特定できます。

値の例としては、header や parameter などがあります。
エラー。message エラーの説明。

値の例としては、Invalid argument、Access Denied、Not Found: Dataset myproject:foo などがあります。
エラー。reason エラーの原因の固有識別子。

値の例としては、invalid、accessDenied、notFound などがあります。
message エラーの説明。errors.message と同じです。

HTTP ステータス コードとエラーコード

このセクションでは、BigQuery API の HTTP ステータス コードとエラーコードの一部を示します。1xx 情報コードと 2xx 成功コードは省略されています。詳細については、RFC 7231 §6、RFC 7232 §4、RFC 7233 §4、RFC 7235 §3、RFC 6585 のレスポンス ステータス コードをご覧ください。

400 - 不正なリクエスト

理由 HTTP ステータス コード 説明 トラブルシューティング
badRequest 400

DML ステートメントは、以前の tabledata.insertAll API で最近ストリーミングされ、テーブルのストリーミング バッファに残っている行を変更しようとします。エラーが返されます: UPDATE or DELETE statement over table project.dataset.table would affect rows in the streaming buffer, which is not supported。

BigQuery Storage Write API(gRPC)に移行し、ストリーミング バッファがフラッシュされるまで数分待つか、ステートメントをフィルタして最近ストリーミングされた行を除外します。詳細については、ストリーミング バッファを含むテーブルに対する DML ステートメントをご覧ください。

invalid 400

リクエストに、無効なクエリ以外の無効な入力が含まれています。たとえば、次のような場合です。

  • スキーマの不一致(Provided Schema does not match Table table)。
  • 15 レベルのネストの上限(Schema nested too deeply)を超える RECORD 列、ファイル、またはルーティン。
  • ジョブ中に削除または期限切れになった宛先テーブル(Destination deleted/expired during operation)。

指定されたスキーマが既存の列とモードに一致していることを確認し、15 レベルを超えるネスト構造をフラット化(または JSON として保存)し、実行中のジョブよりも長く存続するように宛先テーブルの有効期限を設定します。サブタイプごとの手順については、無効な入力エラーとスキーマエラーのトラブルシューティングをご覧ください。

invalidQuery 400

SQL クエリの検証または実行チェックが失敗する理由は次のいずれかです。

  • 無効な SQL 構文、識別子、またはデータ型。
  • 機能オプションまたは必要なパーティション フィルタが満たされていません。
  • ビューのネストまたはパーティション出力の上限を超えました。
  • 同時実行 DML トランザクションの競合(Concurrent conflicting update to details など)。

[line:column] の場所で GoogleSQL 構文または型の不一致を確認し、必要な OPTIONS またはパーティション フィルタを満たすか、停止したセッションをロールバックして、競合する DML ジョブを再試行します。詳細については、無効なクエリエラーと同時更新によるトランザクションの中止をご覧ください。

jobBackendError 400

jobs.query または jobs.getQueryResults で、ジョブが作成され、実行中に backendError で失敗しました。エラーは The job encountered an error during execution. Retrying the job may solve the problem. を返します。

切り捨て型指数バックオフを使用して、新しい jobId でジョブを再試行します。クライアントの再試行ロジックが 5xx コードに加えて HTTP 400 レスポンスを処理するようにします。詳細については、jobBackendError エラーと jobInternalError エラーのトラブルシューティングをご覧ください。

jobInternalError 400

jobs.query または jobs.getQueryResults で、ジョブが作成され、実行中に内部エラーで失敗しました。エラーは The job encountered an internal error during execution and was unable to complete. を返します。

切り捨て型指数バックオフを使用して、新しい jobId でジョブを再試行します。詳細については、jobBackendError エラーと jobInternalError エラーのトラブルシューティングをご覧ください。

preconditionFailed 400

リクエストの前提条件が満たされていません。たとえば、次のような場合です。

  • メタデータの更新中に If-Match ETag の不一致が発生した。
  • 組織のポリシーで必須の CMEK 暗号鍵がありません。
  • Standard エディションでサポートされていない機能。
  • Enterprise Plus プライマリ予約外のフェイルオーバー データセットへの書き込み。
  • 保留中の upsert がある CDC ベーステーブルに対するマテリアライズド ビュークエリ。

再試行する前に現在のリソース etag を取得し、必要な Cloud Key Management Service 鍵を指定して、Enterprise または Enterprise Plus の予約でワークロードを実行するか、保留中の CDC upsert が適用されるまで数分待ちます。サブタイプごとの手順については、リクエストの前提条件が失敗したをご覧ください。

resourceInUse 400

削除リクエストの対象が、まだアクティブなリソースまたはデータが入力されているリソースである。

  • テーブル、ビュー、ルーティンがまだ含まれているデータセット。
  • 保留中または実行中のジョブ。

エラーが返されます: resource_type resource_id is still in use。

データセットを削除する前に空にするか(または deleteContents=true を設定するか、bq rm -r -f -d を実行するか、DROP SCHEMA IF EXISTS dataset_name CASCADE を実行する)、ジョブ メタデータを削除する前にアクティブなジョブが完了するのを待つか、キャンセルします。詳細については、リソースがまだ使用されているをご覧ください。

resourcesExceeded 400

ジョブが次のいずれかの領域で実行リソースの上限を超えている。

  • テーブルごとの DML 同時実行キューまたはセッション同時実行の上限。
  • ワーカー、UDF、シャッフル、ML モデルのメモリ予算。
  • テーブル パーティション(10,000 パーティション)または出力列の上限。
  • Cloud Key Management Service CMEK のリクエスト率、ストリーミング読み取り、クロスリージョン データ転送。
  • クエリプランの複雑さの上限。

エラーが返されます: Resources exceeded during query execution: details。

クエリを簡素化する、DML オペレーションをバッチ処理する、スキャンされる列またはパーティションを減らす、同じセッションで同時実行ジョブを回避する、シャッフルが多いワークロードに専用のスロット容量をプロビジョニングする。サブタイプごとの手順については、リソース超過に関する問題のトラブルシューティングとクエリがメモリリソースを超過するをご覧ください。

storageUnusable 400

サービス側のストレージの問題により、テーブルのデータを保持する内部 BigQuery ストレージが一時的に使用できなくなっています。エラーは次のとおりです。 Storage of resource_id is unusable because reason.

切り捨て型指数バックオフを使用してジョブを再試行します。詳細については、テーブル ストレージが使用できないをご覧ください。

streamingDataUnavailable 400

書き込みが最適化されたストレージに最近ストリーミングされたデータは、読み取りジョブで一時的に使用できなくなります。エラーは Job failed because streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem. を返します。

切り捨て型指数バックオフを使用して、新しい jobId でジョブを再試行します。クライアントの再試行ロジックが HTTP 400 レスポンスを処理するようにします。詳細については、ストリーミング データが一時的に利用できないをご覧ください。

tableUnavailable 400

BigQuery は、次のようなデータが管理されていないテーブルを読み取ることができません。

  • Apache Iceberg テーブル スキーマまたは Delta Lake テーブル スキーマの取得がタイムアウトする。
  • Hive パーティション分割された外部テーブルにパーティション キーがない。
  • Google が管理するバッキング テーブルが一時的に利用できない。

指数バックオフ(切り捨て)を使用して、スキーマの取得またはバッキング テーブルのタイムアウトを再試行します。または、key=value Cloud Storage URI パスを確認し、少なくとも 1 つのパーティション キーを使用して Hive パーティション分割外部テーブルを再作成します。詳細については、外部テーブルまたはバッキング テーブルが使用できないをご覧ください。

userOwnedResourceError 400

所有している外部リソースに BigQuery からアクセスすると、エラーが返されます。エラーが返されます: Error when accessing a user-owned external resource_type resource resource_name. The resource provided error: external_error。

エラー メッセージの resource_type と resource_name を調べて外部リソースを特定し、external_error で報告された根本的なエラーを解決します。詳細については、ユーザー所有の外部リソースエラーをご覧ください。

vortexDataUnavailable 400

BigQuery Storage Write API(gRPC)を使用して書き込み最適化ストレージに最近ストリーミングされたデータは、クエリで一時的に使用できません。エラーは Job failed because vortex streaming data from table_source is temporarily unavailable. Retrying the job may solve the problem. を返します。

切り捨て型指数バックオフを使用して、新しい jobId でクエリジョブを再試行します。クライアントの再試行ロジックが HTTP 400 レスポンスを処理するようにします。詳細については、ストリーミング データが一時的に利用できないをご覧ください。

billingTierLimitExceeded 400

オンデマンド クエリが、スキャンされたデータあたりの最大 CPU 使用量の上限を超えている。エラーは Query exceeded resource limits. This query used cpu_seconds_used CPU seconds but would charge only analysis_megabytes_billed M Analysis bytes... cpu_seconds_used CPU seconds were used, and this query must use less than cpu_seconds_limit CPU seconds. を返します。

SQL をリファクタリングして、意図しないデカルト積、不正確な結合、パーティション分割されていないウィンドウ関数、重い JavaScript UDF を削除するか、容量ベース(スロット)の料金に切り替えます。詳細については、クエリが CPU リソースを超過すると SQL アンチパターンを回避するをご覧ください。

bytesBilledLimitExceeded 400

クエリの実行前のバイト数の上限の見積もりが、実行開始前に maximumBytesBilled を超えています。エラーは Query exceeded limit for bytes billed: limit_bytes. required_bytes or higher required. を返します。

ドライランで推定バイト数をプレビューし、必要な列のみを選択して、パーティション分割された列をフィルタしてデータ処理を削減するか、maximumBytesBilled を required_bytes 以上に引き上げます。詳細については、クエリが課金される最大バイト数の上限を超えているをご覧ください。

jobRateLimitExceeded 400

jobs.query または jobs.getQueryResults で、次のいずれかの理由によりジョブが失敗します。

  • 実行中にジョブがレート制限を超えた(Job exceeded rate limits: Your scope exceeded quota for quota_metric...)。
  • クエリキューの同時実行数または継続的クエリのスロット上限に達したため、クエリが承認されません(例: Query was not admitted as the maximum concurrency has been reached...)。

同時送信を減らし(または、継続的クエリにバッチ優先度またはスロットの自動スケーリングを使用し)、切り捨て指数バックオフを使用して新しい jobId でジョブを再試行します。詳細については、ジョブがレート制限を超えたとクエリの承認が拒否されたをご覧ください。

timeout 400

オペレーションが実行時間の上限を超えている。たとえば、次のような場合です。

  • クエリまたはドライランが 6 時間の実行上限を超えている。
  • マルチステートメント クエリ内の子ジョブがタイムアウトする。
  • 外部テーブル スキーマの自動検出がタイムアウトする。

パーティション分割された列またはクラスタ化された列をフィルタリングし、複雑なクエリまたはマルチステートメント クエリを小さなステージに分割します。または、外部テーブルを作成するときに、明示的なスキーマとより狭いソース URI を指定します。詳細については、クエリが実行時間の上限を超えていると割り当てと上限のエラーのトラブルシューティングをご覧ください。

invalidUser 400

スケジュールされたクエリが無効なユーザー認証情報で構成されている。

スケジュールされたクエリのユーザー認証情報を更新します。詳細については、クエリのスケジュール設定をご覧ください。

required 400

実行前に必要な入力がありません。

  • API リクエストのペイロードまたは URL の必須項目が指定されていません。
  • クライアント ライブラリの必須構成オブジェクトが空であるか、割り当てられていません。

エラーが返されます: Required parameter is missing: parameter_name。

BigQuery API リファレンスまたはクライアント ライブラリのドキュメントで、必要なリクエスト本文とクエリ パラメータを確認し、API を呼び出す前に構成オブジェクトを検査します。詳細については、必要なパラメータがありませんをご覧ください。

401 - Unauthorized

リクエストに有効な認証情報がない場合に返されるエラー レスポンスの例を次に示します。

401 Unauthorized

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "unauthenticated",
        "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential."
      }
    ],
    "code": 401,
    "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential.",
    "status": "UNAUTHENTICATED"
  }
}
理由 HTTP ステータス コード 説明 トラブルシューティング
unauthenticated 401

次のいずれかの理由でリクエストの認証が失敗します。

  • リクエストに有効な認証情報がないか、期限切れの OAuth 2.0 アクセス トークンが使用されています。
  • エンドユーザーの認証情報またはサービス アカウントの権限借用の権限がありません。
  • 呼び出し元のユーザー アカウントが制限されているか、削除されています。

OAuth またはアプリケーションのデフォルト認証情報を更新するか、サービス アカウントで実行またはサービス アカウントの権限を借用するときに roles/iam.serviceAccountUser または roles/iam.serviceAccountTokenCreator を付与するか、制限付きアカウントを復元するよう管理者に連絡してください。詳細については、未認証エラーのトラブルシューティングをご覧ください。

403 - Forbidden

リクエストされたリソースにアクセスする権限がない場合に返されるエラー レスポンスの例を次に示します。

403 Forbidden

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "accessDenied",
        "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
      }
    ],
    "code": 403,
    "message": "Access Denied: Dataset myproject:mydataset: User does not have bigquery.datasets.get permission in project myproject."
  }
}
理由 HTTP ステータス コード 説明 トラブルシューティング
responseTooLarge 403

クエリまたはテーブルの読み取りレスポンスが、次のいずれかの方法でサイズ上限を超えている。

エラーが返されます: Response too large to return. details。

宛先テーブルを指定し(レガシー SQL の場合は configuration.query.allowLargeResults を true に設定)、ORDER BY を削除するか LIMIT を追加するか、BigQuery Storage Read API または EXPORT DATA を使用して大きな行を読み取ります。詳細については、クエリ レスポンスが大きすぎると単一行のレスポンス サイズの上限を超えているをご覧ください。

apiLimitExceeded 403

リクエストが次のいずれかの API またはメタデータの上限を超えている。

  • 1 分あたりの API リクエスト率の上限。
  • テーブルまたはポリシーのメタデータ評価の割り当て。
  • クロスリージョン データセット レプリカの作成上限(Cannot add more than limit replicas for a region within window day(s))。

エラーが返されます: API limit exceeded: details。

切り捨て指数バックオフ、バッチ読み込み、読み取りを使用して失敗したリクエストを再試行し、テーブルごとのきめ細かい IAM ポリシーまたは行レベルのセキュリティ ポリシーを簡素化し、ローリング ウィンドウを待ってからデータセット レプリカを追加します。詳細については、API レートとメタデータ評価の上限エラーとクロスリージョン データセット レプリカの作成上限エラーをご覧ください。

quotaExceeded 403

プロジェクトが次のいずれかの使用量割り当てを超えている。

エラーが返されます: Quota exceeded: Your scope exceeded quota for quota_metric. For more information, see https://cloud.google.com/bigquery/docs/troubleshoot-quotas。

エラー message を調べて、超過した割り当てを特定し、スキャン量の多いクエリを最適化するか、サンドボックスからアップグレードするか、[割り当て] ページでカスタム割り当てを調整します。詳細については、カスタムの 1 日あたりのクエリ割り当てエラーをご覧ください。

rateLimitExceeded 403

リクエストは、次のいずれかのレート制限または同時実行制限のために拒否されます。

  • 短期の API またはクエリジョブのレート制限(Exceeded rate limits: too many quota_metric for this scope...)。
  • クエリキューの同時実行数または継続的クエリの予約スロットの上限(例: Query was not admitted as the maximum concurrency has been reached...)。

リクエスト率を下げて、切り捨て型指数バックオフを使用して再試行するか、バッチ優先度で緊急性の低いクエリを実行して、予約の同時実行数またはスロットの自動スケーリングを調整します。詳細については、割り当てと上限のエラーのトラブルシューティングとクエリの承認が拒否されたをご覧ください。

accessDenied 403

次のいずれかの理由により、BigQuery リソースへのアクセスが拒否されます。

  • プリンシパルに、ターゲット プロジェクト、データセット、またはテーブルに必要な IAM 権限がありません。
  • 承認済みビュー、行レベルのアクセス ポリシー、または列レベルのポリシー タグによってアクセスが制限されている。
  • Cloud Key Management Service の CMEK 権限または外部データソースの権限がありません。

エラーが返されます: Access Denied: resource_type resource_id: details。

Cloud Audit Logs(protoPayload.authorizationInfo)と Policy Analyzer を調べて、不足している権限を特定し、最小権限の事前定義された BigQuery ロールを付与します。詳細については、一般的なアクセス拒否シナリオのトラブルシューティングをご覧ください。

policyViolation 403

セキュリティ境界または組織のポリシーによってリクエストがブロックされている。

  • VPC Service Controls の境界により、アクセスが制限されます(Google ドライブのエクスポートや VPC-SC プロジェクトの外部テーブルなど)。
  • constraints/gcp.resourceLocations などの組織のポリシーの制約により、オペレーションが許可されていません。

ログ エクスプローラを vpcServiceControlsUniqueIdentifier でフィルタし、Violation Analyzer を確認するか、境界内の Cloud Storage バケットを使用してデータをエクスポートまたは読み込むか、組織のポリシーの制約で許可されているリージョンを選択します。詳細については、ポリシー違反エラーのトラブルシューティングをご覧ください。

billingNotEnabled 403

リクエストされたオペレーションに対して、プロジェクトで有効な課金が設定されていません。

  • プロジェクトで課金が有効になっていない。
  • プロジェクトは BigQuery サンドボックスで実行されます。テーブル、ビュー、パーティションは 60 日(expiration time must be less than 60 days)後に期限切れになります。

エラーが返されます: Billing has not been enabled for this project. Enable billing at https://console.cloud.s3nscloud.fr/billing. details。

Cloud de Confiance コンソールでプロジェクトの課金を有効にして BigQuery サンドボックスからアップグレードし、テーブル、ビュー、パーティションのデフォルトの有効期限を更新します。詳細については、プロジェクトで課金が有効になっていないをご覧ください。

blocked 403

BigQuery は、サービス停止を防ぐために、試行されたオペレーションを一時的に拒否リストに追加しました。エラーは Request was blocked to protect the system's operation. Please contact support at https://cloud.google.com/support. を返します。

正確なタイムスタンプ、プロジェクト ID、BigQuery ジョブ ID を添えて Cloud カスタマーケアにお問い合わせください。管理上の緩和ルールを調査します。詳細については、システム オペレーションを保護するためにリクエストがブロックされたをご覧ください。

termsOfServiceNotAccepted 403

プロジェクトが BigQuery の利用規約に同意していません。エラーは BigQuery Terms of Service have not been accepted を返します。

Cloud de Confiance コンソールにログインし、プロンプトが表示されたら、スタートページで国を選択して利用規約のチェックボックスをオンにし、[同意して続行] をクリックします。詳細については、BigQuery 利用規約が承認されていないをご覧ください。

404 - 見つかりません

存在しないデータセットまたはリソースを取得しようとしたときに返されるエラー レスポンスの例を次に示します。

404 Not Found

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "Not Found: Dataset myproject:foo"
      }
    ],
    "code": 404,
    "message": "Not Found: Dataset myproject:foo"
  }
}
理由 HTTP ステータス コード 説明 トラブルシューティング
notFound 404

リクエストされたリソースが見つからない理由は次のいずれかです。

  • ターゲットのデータセット、テーブル、またはジョブが存在しないか、有効期限が切れています。
  • 外部の Cloud Storage または Google ドライブのファイル URI が存在しません。
  • リクエストのロケーションがデータセットまたはジョブのロケーションと一致しません。

エラーが返されます: Not found: resource_type resource_id。

大文字と小文字を区別するプロジェクト、データセット、テーブルの識別子とロケーションを正確に確認し、タイムトラベル ウィンドウ内で削除されたテーブルを復元します。キャッシュに保存された結果テーブルの有効期限が切れたクエリを再実行するか、外部の Cloud Storage または Google ドライブのファイルが存在することを確認します。詳細については、テーブルが見つからない、ロケーションが見つからない、ジョブが見つからないをご覧ください。

409 - Conflict

次の例は、すでに存在するリソースを作成しようとした場合に返されるエラー レスポンスです。

409 Conflict

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "duplicate",
        "message": "Already Exists: Dataset myproject:mydataset"
      }
    ],
    "code": 409,
    "message": "Already Exists: Dataset myproject:mydataset"
  }
}
理由 HTTP ステータス コード 説明 トラブルシューティング
abortd 409

同時変更または競合が原因でオペレーションが停止します(理由 abortd が返されます)。

競合するオペレーションが切り捨て型指数バックオフを使用して終了した後にオペレーションを再試行するか、停止したマルチステートメント トランザクションをロールバックしてから再試行します。詳細については、オペレーションが中止されたをご覧ください。

duplicate 409

リクエストが既存のリソースと競合するのは、次のいずれかの場合です。

  • すでに存在するデータセット、テーブル、ジョブリソースを作成しようとした。
  • 宛先テーブルがすでに存在する場合に、writeDisposition を WRITE_EMPTY に設定してジョブを実行する。

エラーが返されます: Already Exists: resource_type resource_id。

別のリソース名を使用するか、DDL ステートメントで IF NOT EXISTS または CREATE OR REPLACE を使用するか、writeDisposition を WRITE_APPEND または WRITE_TRUNCATE に変更するか、BigQuery でランダムな jobId を生成します。サブタイプごとの手順については、リソースがすでに存在するをご覧ください。

499 - クライアントがリクエストを閉じました

理由 HTTP ステータス コード 説明 トラブルシューティング
stopped 499

ジョブは、次のいずれかの理由で完了前に停止します(jobs.get のポーリングで reason: stopped を含む HTTP 200 が返されます)。

  • 呼び出し元がジョブを明示的にキャンセルした(User requested cancellation)。
  • ジョブが、構成された実行タイムアウトまたはキュー タイムアウト(Job timed out after duration または Job timed out in the queue after duration)を超えている。

エラーが返されます: Job execution was cancelled: details。

configuration.jobTimeoutMs またはプロジェクトのキュー タイムアウト オプションを増やす(またはクエリのランタイムと同時実行を最適化する)か、Cloud Audit Logs で jobservice.cancel 呼び出しを確認します。サブタイプごとの手順については、ジョブの実行がキャンセルされたをご覧ください。

500 - 内部サーバーエラー

理由 HTTP ステータス コード 説明 トラブルシューティング
internalError 500

BigQuery で内部エラーが発生しました。エラーは次のとおりです。 An internal error occurred and the request could not be completed.

BigQuery サービスレベル契約のバックオフ要件に沿って待機し、切り捨て指数バックオフを使用して再試行するか、予約を使用して一時的なエラーの頻度を減らします。詳細については、internalError エラーのトラブルシューティングをご覧ください。

501 - 未実装

理由 HTTP ステータス コード 説明 トラブルシューティング
notImplemented 501

リクエストが、ターゲット リソースに対して実装されていない機能またはオペレーションを使用しようとしています。次に例を示します。

  • マネージド以外のストレージ タイプを持つテーブルをコピーする。
  • サポートされていない ALTER SEARCH INDEX オプションを実行している。

エラーが返されます: Not Implemented: details。

CREATE TABLE destination_table AS SELECT * FROM source_table を使用して、サポートされていないテーブルコピー ソースをマテリアライズするか、DROP SEARCH INDEX と CREATE SEARCH INDEX を使用して検索インデックスを削除して再作成します。サブタイプごとの手順については、機能またはオペレーションが実装されていないをご覧ください。

503 - サービス利用不可

理由 HTTP ステータス コード 説明 トラブルシューティング
backendError 503

次のいずれかの理由により、サービスが一時的に利用できなくなっています。

  • サービス需要の急増(負荷制限)または内部リソースの枯渇。
  • ネットワーク接続が断続的に切れる問題。
  • バックエンド コンポーネントの一時的な問題。

エラーは Error encountered during execution. Retrying may solve the problem. を返します。

切り捨て型指数バックオフを使用してリクエストを再試行し、失敗したジョブを新しい jobId で再試行します。再試行してもエラーが解消されない場合は、30 日間の失敗率を BigQuery SLA と比較し、Cloud カスタマーケアにお問い合わせください。backendError エラーのトラブルシューティングをご覧ください。