次の方法で共有

Azure Data Factory と Azure Synapse での REST コネクタのトラブルシューティング

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

この記事では、Azure Data Factory と Azure Synapse での REST コネクタに関する一般的な問題のトラブルシューティングのための提案を示します。

エラー コード:RestSinkCallFailed

  • メッセージ: Rest Endpoint responded with Failure from server. Check the error from server:%message;

  • 原因: このエラーは、データ ファクトリまたは Synapse のパイプラインが HTTP プロトコル経由で REST エンドポイントと通信し、要求操作が失敗した場合に発生します。

  • 推奨事項: エラー メッセージの HTTP 状態コードまたはメッセージを確認し、リモート サーバーの問題を修正します。

エラー コード: RestSourceCallFailed

  • メッセージ: The HttpStatusCode %statusCode; indicates failure.
Request URL: %requestUri;
Response payload:%payload;

  • 原因:このエラーは Azure Data Factory が HTTP プロトコル経由で REST エンドポイントと通信し、要求操作が失敗した場合に発生します。

  • 推奨事項: エラー メッセージの HTTP 状態コード、要求 URL、または応答ペイロードを確認し、リモート サーバーの問題を修正します。

エラー コード: RestSinkUNSupportedCompressionType

  • メッセージ: User Configured CompressionType is Not Supported By Azure Data Factory：%message;

  • 推奨事項: REST シンクでサポートされている圧縮の種類を確認します。

REST コネクタからの予期しないネットワーク応答

  • 現象:エンドポイントは、REST コネクタから予期しない応答 (400、401、403、500) を受け取ることがあります。

  • 原因:REST ソース コネクタは、HTTP 要求を構築するときに、リンク サービス/データセット/コピー元からの URL および HTTP メソッド、ヘッダー、本文をパラメーターとして使用します。 この問題は、指定された 1 つ以上のパラメーターにおける何らかの誤りが原因で発生している可能性があります。

  • 解決方法:

    • コマンド プロンプト ウィンドウで "curl" を使用して、パラメーターが原因であるかどうかを確認します (Accept ヘッダーと User-Agent ヘッダーを常に含める必要があります)。

      curl -i -X <HTTP method> -H <HTTP header1> -H <HTTP header2> -H "Accept: application/json" -H "User-Agent: azure-data-factory/2.0" -d '<HTTP body>' <URL>

      コマンドが同じ予期しない応答を返す場合は、予期される応答を返すまで、"curl" を使って上記のパラメーターを修正してください。

      "curl--help" を使用して、より高度な方法でコマンドを使用することもできます。

    • REST コネクタのみが予期しない応答を返す場合、詳細なトラブルシューティングについて、Microsoft サポートにお問い合わせください。

    • "curl" は SSL 証明書の検証問題を再現するのに適さない場合があることに注意してください。 一部のシナリオでは、SSL 証明書の検証に問題が発生せず、"curl" コマンドが正常に実行されました。 ただし、同じ URL をブラウザーで実行すると、クライアントがサーバーとの信頼関係を確立するための SSL 証明書は実際には返されません。

      上記のケースに対しては Fiddler などのツールが推奨されます。

Azure Key Vault のサービス プリンシパル証明書が正しくありません

  • メッセージ: "Failed to create certificate from certificate raw data and password. Cannot find the requested object."
  • 原因: Rest コネクタのサービス プリンシパル証明書認証で base64 文字列サービス プリンシパル証明書のみをサポートします。
  • 推奨事項: こちらのセクションに従ってサービス プリンシパル証明書を Azure Key Vault に正しく保存してください。

関連するコンテンツ

トラブルシューティングのその他のヘルプについては、次のリソースを参照してください。