Power Automate 予期 しない エラー failed to fetch

エラー メッセージ

このドキュメントでは、HTTP エラーコード、ジョブエラー、Google Cloud コンソール エラー メッセージなど、BigQuery の使用時に発生するエラー メッセージについて説明します。ジョブエラーは、jobs.get を呼び出したときに status オブジェクト内に示されます。

エラーの表

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>

エラー レスポンスの例

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"}

トップへ戻る

ストリーミング挿入に関するトラブルシューティング

以下のセクションでは、BigQuery にデータをストリーミングする際に発生したエラーの解決方法について説明します。 ストリーミング挿入の割り当てエラーを解決する方法について詳しくは、ストリーミング挿入の割り当てエラーをご覧ください。

失敗 HTTP レスポンス コード

ネットワーク エラーなどの失敗 HTTP レスポンス コードが返された場合、ストリーミング挿入が成功したかどうかを確認する方法はありません。リクエストを単に再送信しようとすると、テーブル内に重複行が発生する可能性があります。テーブルを重複から保護するには、リクエストの送信時に insertId プロパティを設定します。insertId プロパティは BigQuery によって重複排除に使用されます。

権限エラー、無効なテーブル名エラー、または割り当て超過エラーが返された場合、行は挿入されず、リクエスト全体が失敗します。

成功 HTTP レスポンス コード

成功 HTTP レスポンス コードが返された場合でも、BigQuery による行の挿入が部分的にしか成功しなかった可能性があるため、レスポンスの insertErrors プロパティをチェックして、行の挿入が成功したかどうかを確認する必要があります。次のシナリオのいずれかが発生することがあります。

• すべての行が正常に挿入されました。insertErrors プロパティが空のリストになっている場合は、すべての行が正常に挿入されています。
• 一部の行が正常に挿入されました。いずれかの行にスキーマの不一致がある場合を除き、insertErrors プロパティで示された行が挿入されておらず、その他すべての行は正常に挿入されています。errors プロパティには、行の挿入が失敗した理由に関する詳細情報が含まれます。index プロパティは、エラーに該当するリクエストの 0 ベースの行インデックスを示します。
• 正常に挿入された行はありません。 BigQuery がリクエスト内で個別行のスキーマ不一致に遭遇した場合は、いずれの行も挿入されず、スキーマ不一致がなかった行も含めて、各行の insertErrors エントリが返されます。スキーマ不一致がなかった行は、エラーの reason プロパティが stopped に設定され、そのまま再送信できます。失敗した行には、スキーマ不一致に関する詳細情報が含まれます。各 BigQuery データ型でサポートされるプロトコル バッファタイプについては、データ型の変換をご覧ください。

ストリーミング挿入のメタデータ エラー

BigQuery のストリーミング API はインサート率が高くなるように設計されているため、ストリーミング システムを操作する際、基盤となるテーブルのメタデータの変更は結果整合が保たれます。ほとんどの場合、メタデータの変更は数分以内にプロパゲートされますが、その間は API レスポンスで、対象テーブルの不整合な状態が反映されることがあります。

次のようなシナリオがあります。

• スキーマの変更。スキーマの変更がストリーミング システムにすぐに反映されない場合があるため、ストリーミング挿入を最近受け取ったテーブルのスキーマを変更すると、スキーマの不一致エラーが発生することがあります。
• テーブルの作成 / 削除。存在しないテーブルへのストリーミングによって、notFound レスポンスのバリエーションが返されます。レスポンスで作成されたテーブルは、後続のストリーミング挿入ですぐには認識されない可能性があります。同様に、テーブルを削除または、再作成すると、古いテーブルにストリーミング挿入が実質的に配信される期間が生じることがあります。このストリーミング挿入は新しいテーブルには存在しない可能性があります。
• テーブルの切り捨て - （WRITE_TRUNCATE の writeDisposition を使用するクエリジョブによって）テーブルのデータを切り捨てる場合も同様に、整合性期間中の後続の挿入が破棄されることがあります。

欠損 / 利用不可能なデータ

ストリーミング挿入は一時的に書き込み最適化ストレージに存在します。このストレージは、マネージド ストレージとは異なる可用性の特性を持ちます。BigQuery でのテーブルコピーのジョブや tabledata.list のような API メソッドなどの一部のオペレーションでは、書き込み最適化ストレージとやり取りしません。最新のストリーミング データが宛先テーブルまたは出力に存在しません。

トップへ戻る

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

トップへ戻る