次の方法で共有

Microsoft Fabric の Data Factory のパイプラインのトラブルシューティング

この記事では、Microsoft Fabric の Data Factory における外部の制御アクティビティの一般的なトラブルシューティング方法について説明します。

コネクタとコピー アクティビティ

Copy アクティビティの使用時にエラーが発生したなど、コネクタに関する問題については、「コネクタのトラブルシューティング」を参照してください。

Azure Databricks

エラー コード:3200

  • メッセージ:エラー 403。

  • 原因: The Databricks access token has expired.

  • 推奨事項:既定では、Azure Databricks のアクセス トークンは 90 日間有効です。 新しいトークンを作成し、接続を更新します。

エラー コード:3201

  • メッセージ: Missing required field: settings.task.notebook_task.notebook_path.

  • 原因: Bad authoring: Notebook path not specified correctly.

  • 推奨事項:Databricks アクティビティに Notebook のパスを指定してください。


  • メッセージ: Cluster... does not exist.

  • 原因: Authoring error: Databricks cluster does not exist or has been deleted.

  • 推奨事項:Databricks クラスターが存在することを確認してください。


  • メッセージ: Invalid Python file URI... Please visit Databricks user guide for supported URI schemes.

  • 原因: Bad authoring.

  • 推奨事項:ワークスペース アドレス指定スキームの絶対パス (Databricks ファイル システム (DFS) に格納されているファイルの場合は dbfs:/folder/subfolder/foo.py) を指定します。


  • メッセージ: {0} LinkedService should have domain and accessToken as required properties.

  • 原因: Bad authoring.

  • 推奨事項: 接続定義を確認します。


  • メッセージ: {0} LinkedService should specify either existing cluster ID or new cluster information for creation.

  • 原因: Bad authoring.

  • 推奨事項: [接続定義]/azure/data-factory/compute-linked-services#azure-databricks-linked-service を確認します。


  • メッセージ: Node type Standard_D16S_v3 is not supported. Supported node types: Standard_DS3_v2, Standard_DS4_v2, Standard_DS5_v2, Standard_D8s_v3, Standard_D16s_v3, Standard_D32s_v3, Standard_D64s_v3, Standard_D3_v2, Standard_D8_v3, Standard_D16_v3, Standard_D32_v3, Standard_D64_v3, Standard_D12_v2, Standard_D13_v2, Standard_D14_v2, Standard_D15_v2, Standard_DS12_v2, Standard_DS13_v2, Standard_DS14_v2, Standard_DS15_v2, Standard_E8s_v3, Standard_E16s_v3, Standard_E32s_v3, Standard_E64s_v3, Standard_L4s, Standard_L8s, Standard_L16s, Standard_L32s, Standard_F4s, Standard_F8s, Standard_F16s, Standard_H16, Standard_F4s_v2, Standard_F8s_v2, Standard_F16s_v2, Standard_F32s_v2, Standard_F64s_v2, Standard_F72s_v2, Standard_NC12, Standard_NC24, Standard_NC6s_v3, Standard_NC12s_v3, Standard_NC24s_v3, Standard_L8s_v2, Standard_L16s_v2, Standard_L32s_v2, Standard_L64s_v2, Standard_L80s_v2.

  • 原因: Bad authoring.

  • 推奨事項:エラー メッセージを参照してください。


エラー コード:3202

  • メッセージ: There were already 1000 jobs created in past 3600 seconds, exceeding rate limit: 1000 job creations per 3600 seconds.

  • 原因: Too many Databricks runs in an hour.

  • 推奨事項:この Databricks ワークスペースを使用しているすべてのパイプラインでジョブの作成速度を確認します。 パイプラインで起動された Databricks の実行数が全体として多すぎる場合は、一部のパイプラインを新しいワークスペースに移行してください。


  • メッセージ: Could not parse request object: Expected 'key' and 'value' to be set for JSON map field base_parameters, got 'key: "..."' instead.

  • 原因: Authoring error: No value provided for the parameter.

  • 推奨事項:パイプラインの JSON を検査して、baseParameters ノートブックのすべてのパラメーターに空以外の値が指定されていることを確認してください。


  • メッセージ:User: SimpleUserContext{userId=..., name=user@company.com, orgId=...} is not authorized to access cluster.

  • 原因: アクセス トークンを生成したユーザーは、接続で指定された Databricks クラスターへのアクセスを許可されていません。

  • 推奨事項:ワークスペースで必要なアクセス許可がユーザーにあることを確認します。


  • メッセージ: Job is not fully initialized yet. Please retry later.

  • 原因: ジョブが初期化されていません。

  • 推奨: しばらく待ってから、後でもう一度お試しください。

エラー コード:3203

  • メッセージ: The cluster is in Terminated state, not available to receive jobs. Please fix the cluster or retry later.

  • 原因:クラスターは終了されました。 対話型クラスターの場合、この問題は競合状態である可能性があります。

  • 推奨事項:このエラーを回避するには、ジョブ クラスターを使用します。

エラー コード:3204

  • メッセージ: Job execution failed.

  • 原因:エラー メッセージは、予期しないクラスター状態や特定のアクティビティなど、さまざまな問題を示します。 多くの場合、エラー メッセージは表示されません。

  • 推奨事項:該当なし

エラー コード:3208

  • メッセージ: An error occurred while sending the request.

  • 原因:Databricks サービスへのネットワーク接続が中断されました。

  • 推奨事項: セルフホステッド Data Factory ランタイムを使用している場合は、Data Factory ランタイム ノードからのネットワーク接続が信頼できることを確認します。 Azure Data Factory ランタイムを使用している場合、通常は、再試行すると機能します。

ブール値の実行出力が、予期される int ではなく文字列として開始される

  • 現象: ブール値の実行出力が、予期される int ("0" や "1" など) ではなく、文字列 (0 や 1 など) として開始されます。

    Databricks パイプラインのスクリーン ショット。

    この出力に依存するパイプラインが失敗し始めた 2021 年 9 月 28 日の午前 9 時頃に、この変更に気付きました。 パイプラインで変更は行われておらず、障害の前まで、ブール値出力データは予想通り受信されていました。

    出力の違いのスクリーンショット。

  • 原因: この問題は、最近の変更 (設計による) が原因で発生します。 変更後、結果が 0 で始まる数値の場合、Data Factory によって数値が 8 進数に変換されますが、これはバグです。 この数値は常に 0 か 1 で、変更前に問題が発生したことはありません。 そのため、8 進数の変換を修正するには、文字列出力を Notebook の実行からそのまま渡します。

  • 推奨事項: if 条件を if(value=="0") などに変更します。

関数

エラー コード:3602

  • メッセージ: Invalid HttpMethod: '%method;'.

  • 原因:アクティビティのペイロードに指定された Httpmethod が Azure 関数アクティビティでサポートされていません。

  • 推奨事項:サポートされている Httpmethod は次のとおりです: PUT、POST、GET、DELETE、OPTIONS、HEAD、および TRACE。

エラー コード:3603

  • メッセージ: Response Content is not a valid JObject.

  • 原因:呼び出した Azure 関数の応答で JSON ペイロードが返されませんでした。 Data Factory と Synapse パイプラインの Azure 関数アクティビティでは、JSON 応答コンテンツのみがサポートされます。

  • 推奨事項: 有効な JSON ペイロードを返すように Azure 関数を更新します (C# 関数は (ActionResult)new OkObjectResult("{\"Id\":\"123\"}"); を返す、など)

エラー コード:3606

  • メッセージ:Azure 関数アクティビティに関数キーがありません。

  • 原因:Azure 関数アクティビティの定義が完全ではありません。

  • 推奨事項:入力 Azure 関数アクティビティの JSON 定義に、functionKey という名前のプロパティがあることを確認します。

エラー コード:3607

  • メッセージ: Azure function activity missing function name.

  • 原因:Azure 関数アクティビティの定義が完全ではありません。

  • 推奨事項:入力 Azure 関数アクティビティの JSON 定義に、functionName という名前のプロパティがあることを確認します。

エラー コード:3608

  • メッセージ: Call to provided Azure function '%FunctionName;' failed with status-'%statusCode;' and message - '%message;'.

  • 原因: アクティビティ定義における Azure 関数の詳細が正しくない可能性があります。

  • 推奨事項:Azure 関数の詳細を修正してから、再試行します。

エラー コード:3609

  • メッセージ: Azure function activity missing functionAppUrl.

  • 原因:Azure 関数アクティビティの定義が完全ではありません。

  • 推奨事項:入力 Azure 関数アクティビティの JSON 定義に、functionAppUrl という名前のプロパティがあることを確認します。

エラー コード:3610

  • メッセージ: There was an error while calling endpoint.

  • 原因: 関数の URL が正しくない可能性があります。

  • 推奨事項:アクティビティ JSON の functionAppUrl の値が正しいことを確認してから、再試行します。

エラー コード:3611

  • メッセージ: Azure function activity missing Method in JSON.

  • 原因:Azure 関数アクティビティの定義が完全ではありません。

  • 推奨事項:入力 Azure 関数アクティビティの JSON 定義に、method という名前のプロパティがあることを確認します。

エラー コード:3612

  • メッセージ: Azure function activity missing LinkedService definition in JSON.

  • 原因:Azure 関数アクティビティの定義が完全ではありません。

  • 推奨事項: 入力 Azure 関数アクティビティの JSON 定義に、接続の詳細があることを確認します。

Azure Machine Learning

エラー コード:4101

  • メッセージ: AzureMLExecutePipeline activity '%activityName;' has invalid value for property '%propertyName;'.

  • 原因:プロパティ %propertyName; の形式が正しくないか、定義がありません。

  • 推奨事項:アクティビティ %activityName; に適切なデータが定義されたプロパティ %propertyName; があるかどうかを確認します。

エラー コード:4110

  • メッセージ: AzureMLExecutePipeline activity missing LinkedService definition in JSON.

  • 原因:AzureMLExecutePipeline アクティビティの定義が完全ではありません。

  • 推奨事項: 入力 AzureMLExecutePipeline アクティビティの JSON 定義に、接続の詳細が正しく含まれていることを確認します。

エラー コード:4111

  • メッセージ: AzureMLExecutePipeline activity has wrong LinkedService type in JSON. Expected LinkedService type: '%expectedLinkedServiceType;', current LinkedService type: Expected LinkedService type: '%currentLinkedServiceType;'.

  • 原因:アクティビティの定義が正しくありません。

  • 推奨事項: 入力 AzureMLExecutePipeline アクティビティの JSON 定義に、接続の詳細が正しく含まれていることを確認します。

エラー コード:4112

  • メッセージ: AzureMLService connection has invalid value for property '%propertyName;'.

  • 原因:プロパティ '%propertyName;' の形式が正しくないか、定義がありません。

  • 推奨事項: 接続に、適切なデータが定義されたプロパティ %propertyName; があるかどうかを確認します。

エラー コード:4121

  • メッセージ: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • 原因:Azure Machine Learning へのアクセスに使用された資格情報の有効期限が切れています。

  • 推奨事項:資格情報が有効であることを確認してから、再試行します。

エラー コード:4122

  • メッセージ: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • 原因: Azure Machine Learning の接続で指定された資格情報が無効であるか、操作に対するアクセス許可がありません。

  • 推奨事項: 接続の資格情報が有効で、Azure Machine Learning にアクセスするためのアクセス許可があることを確認します。

エラー コード:4123

  • メッセージ: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • 原因:Azure Machine Learning (ML) パイプラインには、pipelineParameters などのアクティビティのプロパティは無効です。

  • 推奨事項: アクティビティのプロパティの値が、接続で指定されている公開済みの Azure Machine Learning パイプラインの予想されるペイロードと一致することを確認します。

エラー コード:4124

  • メッセージ: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • 原因: 公開された Azure Machine Learning パイプライン エンドポイントが存在しません。

  • 推奨事項: 接続で指定された公開済みの Azure Machine Learning パイプライン エンドポイントが、Azure Machine Learning に存在することを確認します。

エラー コード:4125

  • メッセージ: Request sent to Azure Machine Learning for operation '%operation;' failed with http status code '%statusCode;'. Error message from Azure Machine Learning: '%externalMessage;'.

  • 原因: Azure Machine Learning でサーバー エラーが発生しています。

  • 推奨事項:後で再試行してください。 問題が解決しない場合は、Azure Machine Learning チームにお問い合わせください。

エラー コード:4126

  • メッセージ: Azure ML pipeline run failed with status: '%amlPipelineRunStatus;'. Azure ML pipeline run Id: '%amlPipelineRunId;'. Please check in Azure Machine Learning for more error logs.

  • 原因: Azure Machine Learning のパイプライン実行が失敗しました。

  • 推奨事項:Azure Machine Learning でその他のエラー ログを確認し、ML パイプラインを修正します。

共通

エラー コード:2103

  • メッセージ: Please provide value for the required property '%propertyName;'.

  • 原因: プロパティに必要な値が指定されていません。

  • 推奨事項:メッセージの値を指定してから、再試行してください。

エラー コード:2104

  • メッセージ: The type of the property '%propertyName;' is incorrect.

  • 原因:指定されたプロパティの型が正しくありません。

  • 推奨事項:プロパティの型を修正してから、再試行します。

エラー コード:2105

  • メッセージ: An invalid json is provided for property '%propertyName;'. Encountered an error while trying to parse: '%message;'.

  • 原因:プロパティの値が無効であるか、正しい形式ではありません。

  • 推奨事項:プロパティのドキュメントを参照して、指定された値の形式と型が正しいことを確認します。

エラー コード:2106

  • メッセージ: The storage connection string is invalid. %errorMessage;

  • 原因:ストレージの接続文字列が無効であるか、その形式が間違っています。

  • 推奨事項: Azure portal にアクセスし、お使いのストレージを見つけ、接続文字列をコピーして接続に貼り付けてから再試行します。

エラー コード:2110

  • メッセージ: The connection type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • 原因: アクティビティに指定されている接続が正しくありません。

  • 推奨事項: 接続の種類が、アクティビティでサポートされているいずれかの種類であることを確認します。

エラー コード:2111

  • メッセージ: The type of the property '%propertyName;' is incorrect. The expected type is %expectedType;.

  • 原因:指定されたプロパティの型が正しくありません。

  • 推奨事項:プロパティの型を修正してから、再試行します。

エラー コード:2112

  • メッセージ: The cloud type is unsupported or could not be determined for storage from the EndpointSuffix '%endpointSuffix;'.

  • 原因:クラウドの種類がサポートされていないか、EndpointSuffix からストレージ用のものを決定できませんでした。

  • 推奨事項:別のクラウドのストレージを使用し、再試行します。

Azure Batch

次の表は、Azure Batch に当てはまります。

エラー コード:2500

  • メッセージ: Hit unexpected exception and execution failed.

  • 原因: Can't launch command, or the program returned an error code.

  • 推奨事項:実行可能ファイルが存在することを確認してください。 プログラムが起動している場合は、stdout.txt と stderr.txt がストレージ アカウントにアップロードされていることを確認します。 デバッグのためにコードにログを含めることをお勧めします。

エラー コード:2501

  • メッセージ: Cannot access user batch account; please check batch account settings.

  • 原因:Batch アクセス キーまたはプール名が正しくありません。

  • 推奨事項: 接続でプール名と Batch アクセス キーを確認します。

エラー コード:2502

  • メッセージ: Cannot access user storage account; please check storage account settings.

  • 原因:ストレージ アカウント名またはアクセス キーが正しくありません。

  • 推奨事項: 接続でストレージ アカウント名とアクセス キーを確認します。

エラー コード:2504

  • メッセージ: Operation returned an invalid status code 'BadRequest'.

  • 原因: Azure アクティビティの folderPath 内のファイルが多すぎます。 resourceFiles の合計サイズが 32,768 文字を超えることはできません。

  • 推奨事項:不要なファイルを削除するか、それらを zip 圧縮したうえで、展開するための解凍コマンドを追加します。

    たとえば、powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe を使用します

エラー コード:2505

  • メッセージ: Cannot create Shared Access Signature unless Account Key credentials are used.

  • 原因: Azure Batch アクティビティでは、アクセス キーを使用するストレージ アカウントのみがサポートされます。

  • 推奨事項:エラーの説明を参照してください。

エラー コード:2507

  • メッセージ: The folder path does not exist or is empty: ...

  • 原因:指定されたパスのストレージ アカウントにファイルがありません。

  • 推奨事項:このフォルダー パスには、実行したい実行可能ファイルが含まれている必要があります。

エラー コード:2508

  • メッセージ: There are duplicate files in the resource folder.

  • 原因:folderPath の異なるサブフォルダーに、同じ名前のファイルが複数あります。

  • 推奨事項: Azure Batch アクティビティによって、folderPath 下のフォルダー構造がフラット化されます。 フォルダー構造を維持する必要がある場合は、ファイルを zip 圧縮し、Azure Batch で解凍コマンドを使用してそれらを展開します。

    たとえば、powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory($zipFile, $folder); }" ; $folder\yourProgram.exe を使用します

エラー コード:2509

  • メッセージ: Batch url ... is invalid; it must be in Uri format.

  • 原因:Batch URL は次のようになります: https://mybatchaccount.eastus.batch.azure.com

  • 推奨事項:エラーの説明を参照してください。

エラー コード:2510

  • メッセージ: An error occurred while sending the request.

  • 原因:Batch URL が無効です。

  • 推奨事項:Batch URL を確認してください。

Web アクティビティ

エラー コード: 2001

  • メッセージ: The length of execution output is over limit (around 4MB currently).

  • 原因: 実行出力のサイズが 4 MB を超えていますが、出力応答ペイロードのサポートされている最大サイズは 4 MB です。

  • 推奨事項: 実行出力のサイズが 4 MB を超えないようにしてください。 詳細については、「Data Factory を使用して移動するデータのサイズをスケールアウトする方法」を参照してください。

エラー コード: 2002

  • メッセージ: The payload including configurations on activity/data/connection is too large. Please check if you have settings with very large value and try to reduce its size.

  • 原因: 送信しようとしているペイロードが大きすぎます。

  • 推奨事項: 「ペイロードが大きすぎます」を参照してください。

エラー コード: 2003

  • メッセージ: There are substantial concurrent external activity executions which is causing failures due to throttling under subscription <subscription id>, region <region code> and limitation <current limit>. Please reduce the concurrent executions. For limits, refer https://aka.ms/adflimits.

  • 原因: 同時に実行されているアクティビティが多すぎます。 これは、一度にトリガーされるパイプラインが多すぎる場合に発生すると考えられます。

  • 推奨事項: 同時に実行されるパイプラインを減らします。 パイプラインのトリガー時間の分散が必要になる可能性があります。

エラー コード: 2105

  • メッセージ: The value type '<provided data type>', in key '<key name>' is not expected type '<expected data type>'

  • 原因: 動的コンテンツ式で生成されたデータがキーと一致せず、JSON 解析エラーの原因となっています。

  • 推奨事項: キー フィールドを確認し、動的コンテンツ定義を修正します。

エラー コード:2108

  • メッセージ: Error calling the endpoint '<URL>'. Response status code: 'NA - Unknown'. More details: Exception message: 'NA - Unknown [ClientSideException] Invalid Url: <URL>. Please verify Url or Data Factory runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Data Factory runtime'

  • 原因: 指定された URL に到達できません。 これは、ネットワーク接続の問題が発生した場合、URL を解決できなかった場合、または Azure Data Factory ランタイムで localhost URL が使用されていた場合に発生する可能性があります。

  • 推奨事項: 指定された URL にアクセスできることを確認します。


  • メッセージ: Error calling the endpoint '%url;'. Response status code: '%code;'

  • 原因:ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。

  • 推奨事項: Fiddler、Netmon、または Wireshark を使用して要求を検証してください。

    Fiddler を使用する場合

    Fiddler を使用して監視対象 Web アプリケーションの HTTP セッションを作成するには:

    1. Fiddler をダウンロードし、インストールして開きます。

    2. Web アプリケーションで HTTPS が使用されている場合は、 [Tools](ツール)>[Fiddler Options](Fiddler オプション)>[HTTPS] の順に選択します。

      1. [HTTPS] タブで、 [Capture HTTPS CONNECTs](HTTPS 接続をキャプチャする) と [Decrypt HTTPS traffic](HTTPS トラフィックの暗号化を解除する) の両方をオンにします。

        Fiddler オプションのスクリーンショット

    3. お使いのアプリケーションで TLS/SSL 証明書が使用されている場合は、Fiddler の証明書をデバイスに追加します。

      参照先: [Tools](ツール)>[Fiddler Options](Fiddler オプション)>[HTTPS]>[Actions](アクション)>[Export Root Certificate to Desktop](ルート証明書をデスクトップにエクスポート) 。

    4. [File](ファイル)>[Capture Traffic](トラフィックのキャプチャ) に移動して、キャプチャをオフにします。 または F12 キーを押します。

    5. キャッシュされたすべての項目が削除されて、再ダウンロードが必要になるように、ブラウザーのキャッシュをクリアします。

    6. 要求を作成します。

    7. [Composer](コンポーザー) タブを選択します。

      1. HTTP メソッドと URL を設定します。

      2. 必要に応じて、ヘッダーと要求本文を追加します。

      3. [実行] を選択します。

    8. トラフィックのキャプチャを再び有効にし、ページで問題のあるトランザクションを完了します。

    9. 参照先: [File](ファイル)>[Save](保存)>[All Sessions](すべてのセッション) 。

    詳細については、「Fiddler の基本」を参照してください。

エラー コード: 2113

  • メッセージ: ExtractAuthorizationCertificate: Unable to generate a certificate from a Base64 string/password combination

  • 原因: Base64 文字列とパスワードの組み合わせから証明書を生成できません。

  • 推奨事項: 使用している Base64 エンコード PFX 証明書とパスワードの組み合わせが正しく入力されていることを確認します。

エラー コード: 2403

  • メッセージ: Get access token from MSI failed for Datafactory <DF mname>, region <region code>. Please verify resource url is valid and retry.

  • 原因: 指定されたリソース URL からアクセス トークンを取得できません。

  • 推奨事項: マネージド ID に正しいリソース URL を指定したことを確認します。

全般

REST 継続トークンの NULL エラー

エラー メッセージ: {"token":null,"range":{"min":..}

原因: 複数のパーティション/ページ間でクエリを実行すると、バックエンド サービスは、token、min および max キー範囲の 3 つのプロパティを持つ JObject 形式の後続トークン (たとえば、{"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}}) を返します。 ソース データによっては、フェッチするデータがまだあるにもかかわらず、クエリの結果が 0 となり、トークンの欠落を示す場合があります。

推奨事項: continuationToken が null 以外の場合は、文字列 {"token":null,"range":{"min":"05C1E9AB0DAD76","max":"05C1E9CD673398"}} のように、前の応答からの後続トークンを使用して queryActivityRuns API を再度呼び出す必要があります。 クエリ API に完全な文字列を再度渡す必要があります。 アクティビティは、クエリ結果に対する後続のページで返されます。 このページに空の配列があることは無視してください。continuationToken 値が null である限り、クエリを続行する必要があります。 詳細については、 「パイプライン実行クエリのREST API 」を参照してください。

アクティビティの停止に関する問題

アクティビティが通常の実行時間を超えて実行され、ほとんど進行していない場合、そのアクティビティは停止している可能性があります。 取り消しを試みた後、再試行して問題が解決するかどうかを確認できます。 コピー アクティビティの場合は、パフォーマンスの監視とトラブルシューティングの詳細について「コピーアクティビティのパフォーマンスのトラブルシューティング」を参照してください。データ フローの場合は、マッピング データ フローのパフォーマンスとチューニング ガイドに関するページを参照してください。

ペイロードが大きすぎます

エラー メッセージ: The payload including configurations on activity/data/connection is too large. Please check if you have settings with very large value and try to reduce its size.

原因: 各アクティビティの実行のペイロードには、アクティビティの構成、関連付けられているデータ、接続の構成 (ある場合)、およびアクティビティの種類ごとに生成されるシステム プロパティの一部が含まれます。 このようなペイロード サイズの制限は、Data Factory および Azure Synapse Analytics の Azure の制限のドキュメントで説明されているように 896 KB です。

推奨事項: アップストリーム アクティビティの出力または外部から 1 つ以上の大きなパラメーター値を渡す場合、特に制御フロー内のアクティビティ間で実際のデータを渡す場合、この制限に達する可能性があります。 大きなパラメーター値のサイズを減らせるかどうかを確認するか、パイプライン ロジックを調整して、アクティビティ間で値が渡されずにアクティビティ内で処理されるようにします。

サポートされていない圧縮によりファイルが破損する

現象: BLOB コンテナーに格納されているファイルを解凍しようとします。 パイプライン内の 1 つのコピー アクティビティに、圧縮の種類が "deflate64" (または任意のサポートされていない種類) に設定されたソースがあります。 このアクティビティは正常に実行され、zip ファイルに格納されたテキスト ファイルが生成されます。 ただし、ファイル内のテキストに問題があり、このファイルは破損しているように見えます。 このファイルをローカルで解凍すると、問題ありません。

原因: zip ファイルは "deflate64" のアルゴリズムで圧縮されていますが、Data Factory の内部 zip ライブラリは "deflate" のみをサポートしています。zip ファイルが Windows システムによって圧縮され、ファイル全体のサイズが特定の数値を超える場合、Windows では既定で "deflate64" が使用されますが、これは Data Factory ではサポートされていません。 一方、ファイル サイズが小さい場合、または圧縮アルゴリズムの指定をサポートする何らかのサードパーティ製の zip ツールを使用している場合、Windows では既定で "deflate" が使用されます。

ヒント

実際に、Azure Data Factory と Synapse Analytics でのバイナリ形式に関するページと「Data Factory および Azure Synapse Analytics での区切りテキスト形式に関するページの両方で、"deflate64" 形式は Data Factory でサポートされていないことが明記されています。

パイプラインの実行により、配列パラメーターが文字列として子パイプラインに渡されます

エラー メッセージ: Operation on target ForEach1 failed: The execution of template action 'MainForEach1' failed: the result of the evaluation of 'foreach' expression '@pipeline().parameters.<parameterName>' is of type 'String'. The result must be a valid array.

原因: 次の画像に示すように、パイプラインの実行で配列型のパラメーターを作成した場合でも、パイプラインは失敗します。

Execute Pipeline アクティビティのパラメーターを示すスクリーンショット。

これは、ペイロードが親パイプラインから子に文字列として渡されるためです。 子パイプラインに渡された入力を確認すると、それを確認できます。

入力型の文字列を示すスクリーンショット。

推奨事項: この問題を解決するには、次の画像に示すように配列の作成関数を適用します。

配列の作成関数の使用方法を示すスクリーンショット。

その後、パイプラインは成功します。 入力ボックスでは、渡されたパラメーターが配列であることがわかります。

入力型の配列を示すスクリーンショット。

関連するコンテンツ

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