Azure Data Factory と Synapse パイプラインのトラブルシューティング

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

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

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

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.

  • 推奨事項:リンクされたサービスの定義を確認してください。


  • メッセージ: 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 サービスへのネットワーク接続が中断されました。

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

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

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

    Screenshot of the Databricks pipeline.

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

    Screenshot of the difference in the output.

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

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

Azure Data Lake Analytics

次の表は、U-SQL について記載したものです。

エラー コード:2709

  • メッセージ: The access token is from the wrong tenant.

  • 原因: Microsoft Entra テナントが正しくありません。

  • 推奨事項: Microsoft Entra テナントが正しくありません。


  • メッセージ: We cannot accept your job at this moment. The maximum number of queued jobs for your account is 200.

  • 原因:このエラーは、Data Lake Analytics のスロットリングに起因しています。

  • 推奨事項:Data Lake Analytics に送信されるジョブの数を減らします。 アクティビティに対するトリガーとコンカレンシーの設定を変更するか、Data Lake Analytics の上限を引き上げます。


  • メッセージ: This job was rejected because it requires 24 AUs. This account's administrator-defined policy prevents a job from using more than 5 AUs.

  • 原因:このエラーは、Data Lake Analytics のスロットリングに起因しています。

  • 推奨事項:Data Lake Analytics に送信されるジョブの数を減らします。 アクティビティに対するトリガーとコンカレンシーの設定を変更するか、Data Lake Analytics の上限を引き上げます。

エラー コード:2705

  • メッセージ: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • 原因:サービス プリンシパルまたは証明書には、ストレージ内のファイルへのアクセス権がありません。

  • 推奨事項:Data Lake Analytics ジョブ用にユーザーが指定したサービス プリンシパルまたは証明書が、Data Lake Analytics アカウントと、ルート フォルダーからの既定の Data Lake Storage インスタンスの両方にアクセスできることを確認します。

エラー コード:2711

  • メッセージ: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • 原因:サービス プリンシパルまたは証明書には、ストレージ内のファイルへのアクセス権がありません。

  • 推奨事項:Data Lake Analytics ジョブ用にユーザーが指定したサービス プリンシパルまたは証明書が、Data Lake Analytics アカウントと、ルート フォルダーからの既定の Data Lake Storage インスタンスの両方にアクセスできることを確認します。


  • メッセージ: Cannot find the 'Azure Data Lake Store' file or folder.

  • 原因:U-SQL ファイルのパスが間違っているか、リンクされたサービスの資格情報がアクセス権を持っていません。

  • 推奨事項:パスと、リンクされたサービスに指定された資格情報を確認してください。

エラー コード:2704

  • メッセージ: Forbidden. ACL verification failed. Either the resource does not exist or the user is not authorized to perform the requested operation.<br/> <br/> User is not able to access Data Lake Store. <br/> <br/> User is not authorized to use Data Lake Analytics.

  • 原因:サービス プリンシパルまたは証明書には、ストレージ内のファイルへのアクセス権がありません。

  • 推奨事項:Data Lake Analytics ジョブ用にユーザーが指定したサービス プリンシパルまたは証明書が、Data Lake Analytics アカウントと、ルート フォルダーからの既定の Data Lake Storage インスタンスの両方にアクセスできることを確認します。

エラー コード:2707

  • メッセージ: Cannot resolve the account of AzureDataLakeAnalytics. Please check 'AccountName' and 'DataLakeAnalyticsUri'.

  • 原因:リンクされたサービスの Data Lake Analytics アカウントに誤りがあります。

  • 推奨事項:正しいアカウントが指定されていることを確認してください。

エラー コード:2703

  • メッセージ: Error Id: E_CQO_SYSTEM_INTERNAL_ERROR (or any error that starts with "Error Id:").

  • 原因:Data Lake Analytics からのエラーです。

  • 推奨事項:Data Lake Analytics にジョブが送信され、そこでスクリプトとジョブの両方が失敗しました。 Data Lake Analytics 内を調査してください。 ポータルから Data Lake Analytics アカウントに移動し、Data Factory のアクティビティの実行 ID を使用して該当するジョブを探します (パイプラインの実行 ID は使用しません)。 見つかったジョブから、エラーに関する詳細な情報を入手し、トラブルシューティングに役立てることができます。

    解決方法が明確でない場合は、Data Lake Analytics サポート チームに連絡し、お使いのアカウント名とジョブ ID を含むジョブの Universal Resource Locator (URL) を伝えてください。

Azure 関数

エラー コード:3602

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

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

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

エラー コード:3603

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

  • 原因:呼び出した Azure 関数の応答で JSON ペイロードが返されませんでした。 Azure 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 linked service 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 パイプラインを修正します。

Azure Synapse Analytics

エラー コード: 3250

  • メッセージ: There are not enough resources available in the workspace, details: '%errorMessage;'

  • 原因: リソース不足

  • 推奨事項: ワークスペースで実行中のジョブを終了し、要求された仮想コアの数を減らすか、ワークスペース クォータを増やすか、別のワークスペースを使用してみてください。

エラー コード: 3251

  • メッセージ: There are not enough resources available in the pool, details: '%errorMessage;'

  • 原因: リソース不足

  • 推奨事項: プールで実行中のジョブを終了し、要求された仮想コアの数を減らし、プールの最大数を増やすか、別のプールを使用してみてください。

エラー コード: 3252

  • メッセージ: There are not enough vcores available for your spark job, details: '%errorMessage;'

  • 原因: 仮想コアが不足しています

  • 推奨事項: 要求された仮想コアの数を減らすか、仮想コア クォータを増やしてみてください。 詳細については、Apache Sparkの中心概念 に関するページをご覧ください。

エラー コード: 3253

  • メッセージ: There are substantial concurrent MappingDataflow executions which is causing failures due to throttling under the Integration Runtime used for ActivityId: '%activityId;'.

  • 原因: 調整のしきい値に達しました。

  • 推奨事項: 待機期間後に要求を再試行します。

エラー コード: 3254

  • メッセージ: AzureSynapseArtifacts linked service has invalid value for property '%propertyName;'.

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

  • 推奨事項:リンクされたサービスのプロパティ '%propertyName;' が正しいデータで定義されていることを確認してください。

共通

エラー コード: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 linked service type '%linkedServiceType;' is not supported for '%executorType;' activities.

  • 原因:アクティビティに指定されているリンクされたサービスが正しくありません。

  • 推奨事項:リンクされたサービスの種類がアクティビティでサポートされているいずれかの種類であることを確認します。 たとえば、HDI アクティビティの場合、リンクされたサービスの種類は HDInsight または HDInsightOnDemand になります。

エラー コード: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 からストレージ用のものを決定できませんでした。

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

Custom

次の表は、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'.

  • 原因:カスタム アクティビティの 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.

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

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

エラー コード:2507

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

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

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

エラー コード:2508

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

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

  • 推奨事項:カスタム アクティビティでは、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 を確認してください。

HDInsight

エラー コード:206

  • メッセージ: The batch ID for Spark job is invalid. Please retry your job.

  • 原因:このエラーの原因となったサービスに内部的な問題がありました。

  • 推奨事項:この問題は一時的なものである可能性があります。 しばらくしてから、ジョブを再試行してください。

エラー コード:207

  • メッセージ: Could not determine the region from the provided storage account. Please try using another primary storage account for the on demand HDI.

  • 原因:プライマリ ストレージ アカウントからリージョンを特定しているときに内部エラーが発生しました。

  • 推奨事項:別のストレージを試してください。

エラー コード:208

  • メッセージ: Service Principal or the MSI authenticator are not instantiated. Please consider providing a Service Principal in the HDI on demand linked service which has permissions to create an HDInsight cluster in the provided subscription and try again.

  • 原因:サービス プリンシパルを読み取ろうとしたときか MSI 認証をインスタンス化しようとしたとき、内部エラーが発生しました。

  • 推奨事項:指定のサブスクリプションで HDInsight クラスターを作成するアクセス許可を持っているサービス プリンシパルの指定を検討し、再試行します。 管理 ID が正しく設定されていることを確認します。

エラー コード:2300

  • メッセージ: Failed to submit the job '%jobId;' to the cluster '%cluster;'. Error: %errorMessage;.

  • 原因:エラー メッセージに The remote name could not be resolved. のようなメッセージが含まれています。 指定されたクラスター URI が無効である可能性があります。

  • 推奨事項:クラスターが削除されていないこと、および指定した URI が正しいことを確認します。 ブラウザーでこの URI を開くと、Ambari UI が表示されます。 クラスターが仮想ネットワークに存在する場合、この URI はプライベート URI になります。 それを開くには、同じ仮想ネットワークに属している仮想マシン (VM) を使用します。

    詳細については、「Apache Hadoop サービスへの直接接続」を参照してください。


  • 原因:エラー メッセージに A task was canceled. のようなメッセージが含まれている場合は、ジョブの送信がタイムアウトしました。

  • 推奨事項:一般的な HDInsight の接続またはネットワーク接続の問題が考えられます。 まず、HDInsight Ambari UI がどのブラウザーからも使用可能であることを確認します。 次に、ご自分の資格情報がまだ有効であることを確認してください。

    セルフホステッド統合ランタイム (IR) を使用している場合は、セルフホステッド IR がインストールされている VM またはマシンからこの手順を実行します。 その後、再びジョブの送信を試してください。

    詳細については、「Ambari Web UI」を参照してください。


  • 原因:エラー メッセージに User admin is locked out in Ambari や Unauthorized: Ambari user name or password is incorrect のようなメッセージが含まれている場合は、HDInsight の資格情報が正しくないか、期限切れになっています。

  • 推奨事項:資格情報を訂正して、リンクされたサービスを再デプロイしてください。 任意のブラウザーでクラスター URI を開いてサインインを試行することで、まず HDInsight で資格情報が機能することを確認します。 資格情報が機能しない場合は、Azure portal からリセットできます。

    ESP クラスターでは、セルフ サービスのパスワード リセットを使用してパスワードをリセットすることができます。


  • 原因:エラー メッセージに 502 - Web server received an invalid response while acting as a gateway or proxy server のようなメッセージが含まれている場合、このエラーは HDInsight サービスによって返されています。

  • 推奨事項:502 エラーは、多くの場合、Ambari サーバー プロセスがシャットダウンされたときに発生します。 ヘッド ノードを再起動することで、Ambari サービスを再起動できます。

    1. SSH を使用して、HDInsight 上のいずれかのノードに接続します。

    2. ping headnodehost を実行して、アクティブなヘッド ノード ホストを特定します。

    3. Ambari サーバーはアクティブなヘッド ノード上に配置されるため、SSH を使用してアクティブなヘッド ノードに接続します。

    4. アクティブなヘッド ノードを再起動します。

      詳細については、Azure HDInsight のトラブルシューティングに関するドキュメントを参照してください。 次に例を示します。


  • 原因:エラー メッセージに Unable to service the submit job request as templeton service is busy with too many submit job requests や Queue root.joblauncher already has 500 applications, cannot accept submission of application のようなメッセージが含まれている場合は、同時に HDInsight に送信されているジョブの数が多すぎます。

  • 推奨事項:HDInsight に送信されるコンカレント ジョブの数を制限します。 ジョブが同じアクティビティによって送信されている場合は、アクティビティのコンカレンシーを参照してください。 同時実行のパイプラインが時間を分散して実行されるようにトリガーを変更してください。

    HDInsight のドキュメントを参照し、エラーの提案に従って templeton.parallellism.job.submit を調整してください。

エラー コード:2301

  • メッセージ: Could not get the status of the application '%physicalJobId;' from the HDInsight service. Received the following error: %message;. Please refer to HDInsight troubleshooting documentation or contact their support for further assistance.

  • 原因:HDInsight のクラスターまたはサービスに問題があります。

  • 推奨事項: このエラーは、実行中のジョブの状態を要求しようとしたときに、サービスが HDInsight クラスターから応答を受信しない場合に発生します。 この問題はクラスター自体に存在する可能性があります。または、HDInsight サービスが停止している可能性があります。

    HDInsight のトラブルシューティング ドキュメントを参照するか、Microsoft サポートに問い合わせてさらに支援を求めてください。

エラー コード:2302

  • メッセージ: Hadoop job failed with exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Contact HDInsight team for further support.

  • 原因:ジョブは HDI クラスターに送信されましたが、そこでエラーが発生しました。

  • 推奨事項:

  1. Ambari UI を確認します。
    1. すべてのサービスがまだ実行されていることを確認します。
    2. Ambari UI で、ダッシュボードのアラート セクションを確認します。
      1. アラートとアラートの解決方法の詳細については、「クラスターの管理と監視」を参照してください。
    3. YARN メモリを確認します。 YARN メモリの量が多い場合は、ジョブの処理が遅れている可能性があります。 Spark アプリケーション/ジョブに対応できるだけの十分なリソースがない場合は、クラスターに十分なメモリとコアが確保されるようにクラスターをスケールアップしてください。
  2. サンプル テスト ジョブを実行します。
    1. HDInsight バックエンドで同じジョブを実行する場合は、ジョブが成功したことを確認します。 サンプル実行の例については、「HDInsight に含まれる MapReduce サンプルを実行する」を参照してください
  3. ジョブが引き続き HDInsight で失敗している場合は、アプリケーションのログと情報を確認して、サポートに提供します。
    1. ジョブが YARN に送信されたかどうかを確認します。 ジョブが yarn に送信されていない場合は、--master yarn を使用します。
    2. アプリケーションの実行が終了している場合は、YARN アプリケーションの開始時刻と終了時刻を収集します。 アプリケーションの実行が完了しなかった場合は、開始時刻または起動時刻を収集します。
    3. yarn logs -applicationId <Insert_Your_Application_ID> を使用して、アプリケーション ログを確認し、収集します。
    4. /var/log/hadoop-yarn/yarn ディレクトリの下の yarn Resource Manager ログを確認し、収集します。
    5. これらの手順が問題を解決するのに十分でない場合は、Azure HDInsight チームにサポートを依頼し、上記のログとタイムスタンプを提供してください。

エラー コード:2303

  • メッセージ: Hadoop job failed with transient exit code '%exitCode;'. See '%logPath;/stderr' for more details. Alternatively, open the Ambari UI on the HDI cluster and find the logs for the job '%jobId;'. Try again or contact HDInsight team for further support.

  • 原因:ジョブは HDI クラスターに送信されましたが、そこでエラーが発生しました。

  • 推奨事項:

  1. Ambari UI を確認します。
    1. すべてのサービスがまだ実行されていることを確認します。
    2. Ambari UI で、ダッシュボードのアラート セクションを確認します。
      1. アラートとアラートの解決方法の詳細については、「クラスターの管理と監視」を参照してください。
    3. YARN メモリを確認します。 YARN メモリの量が多い場合は、ジョブの処理が遅れている可能性があります。 Spark アプリケーション/ジョブに対応できるだけの十分なリソースがない場合は、クラスターに十分なメモリとコアが確保されるようにクラスターをスケールアップしてください。
  2. サンプル テスト ジョブを実行します。
    1. HDInsight バックエンドで同じジョブを実行する場合は、ジョブが成功したことを確認します。 サンプル実行の例については、「HDInsight に含まれる MapReduce サンプルを実行する」を参照してください
  3. ジョブが引き続き HDInsight で失敗している場合は、アプリケーションのログと情報を確認して、サポートに提供します。
    1. ジョブが YARN に送信されたかどうかを確認します。 ジョブが yarn に送信されていない場合は、--master yarn を使用します。
    2. アプリケーションの実行が終了している場合は、YARN アプリケーションの開始時刻と終了時刻を収集します。 アプリケーションの実行が完了しなかった場合は、開始時刻または起動時刻を収集します。
    3. yarn logs -applicationId <Insert_Your_Application_ID> を使用して、アプリケーション ログを確認し、収集します。
    4. /var/log/hadoop-yarn/yarn ディレクトリの下の yarn Resource Manager ログを確認し、収集します。
    5. これらの手順が問題を解決するのに十分でない場合は、Azure HDInsight チームにサポートを依頼し、上記のログとタイムスタンプを提供してください。

エラー コード:2304

  • メッセージ: MSI authentication is not supported on storages for HDI activities.

  • 原因:HDInsight (HDI) のリンクされたサービスまたは HDI のアクティビティで使用されているストレージのリンクされたサービスが、サポートされていない MSI 認証を使用して構成されています。

  • 推奨事項:HDI のリンクされたサービスまたは HDI のアクティビティで使用されているストレージ アカウントの完全接続文字列を指定します。

エラー コード:2305

  • メッセージ: Failed to initialize the HDInsight client for the cluster '%cluster;'. Error: '%message;'

  • 原因: HDI クラスターの接続情報が間違っているか、指定されたユーザーに必要なアクションを実行するアクセス許可がないか、HDInsight サービスに問題があり、サービスからの要求に応答できなかったことが原因です。

  • 推奨事項:ユーザー情報が正しいことを確認します。さらに、HDI クラスターの Ambari UI を、IR がインストールされている VM からブラウザーで開くことができること (セルフホステッド IR の場合)、または任意のマシンから開くことができること (Azure IR の場合) を確認します。

エラー コード:2306

  • メッセージ: An invalid json is provided for script action '%scriptActionName;'. Error: '%message;'

  • 原因:スクリプト アクションに指定された JSON が無効です。

  • 推奨事項:エラー メッセージは、問題の特定に役立ちます。 json 構成を修正し、再試行します。

    詳細については、「Azure HDInsight のオンデマンドのリンクされたサービス」を参照してください。

エラー コード:2310

  • メッセージ: Failed to submit Spark job. Error: '%message;'

  • 原因: サービスで、Livy API (livy/batch) を使用して Spark クラスターにバッチを作成しようとしましたが、エラーが表示されました。

  • 推奨事項:エラー メッセージに従い、問題を解決します。 これを解決できる十分な情報がない場合、HDI チームに連絡し、バッチ ID とジョブ ID を伝えてください。ID はサービスの [監視] ページのアクティビティの実行の [出力] で見つかります。 さらにトラブルシューティングを行うには、バッチ ジョブの完全なログを収集します。

    完全なログを収集する方法の詳細については、「バッチ ジョブの完全なログを取得する」を参照してください。

エラー コード:2312

  • メッセージ: Spark job failed, batch id:%batchId;. Please follow the links in the activity run Output from the service Monitoring page to troubleshoot the run on HDInsight Spark cluster. Please contact HDInsight support team for further assistance.

  • 原因:HDInsight Spark クラスターでジョブが失敗しました。

  • 推奨事項: サービスの [監視] ページのアクティビティの実行の [出力] にあるリンクにアクセスし、HDInsight Spark クラスターでの実行をトラブルシューティングします。 さらに支援が必要であれば、HDInsight サポート チームにお問い合わせください。

    完全なログを収集する方法の詳細については、「バッチ ジョブの完全なログを取得する」を参照してください。

エラー コード:2313

  • メッセージ: The batch with ID '%batchId;' was not found on Spark cluster. Open the Spark History UI and try to find it there. Contact HDInsight support for further assistance.

  • 原因:HDInsight Spark クラスターでバッチが削除されました。

  • 推奨事項:HDInsight Spark クラスターでのバッチをトラブルシューティングしてください。 さらに支援が必要であれば、HDInsight サポートにお問い合わせください。

    完全なログを収集する方法の詳細については、「バッチ ジョブの完全なログを取得する」を参照してください。完全なログを HDInsight サポートと共有して、さらに支援を求めてください。

エラー コード:2328

  • メッセージ: Failed to create the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • 原因:エラー メッセージに、発生した問題の詳細が表示されているはずです。

  • 推奨事項:エラー メッセージは、問題の解決に役立ちます。

エラー コード:2329

  • メッセージ: Failed to delete the on demand HDI cluster. Cluster or linked service name: '%clusterName;', error: '%message;'

  • 原因:エラー メッセージに、発生した問題の詳細が表示されているはずです。

  • 推奨事項:エラー メッセージは、問題の解決に役立ちます。

エラー コード:2331

  • メッセージ: The file path should not be null or empty.

  • 原因:指定されたファイル パスが空です。

  • 推奨事項:存在するファイルのパスを指定します。

エラー コード:2340

  • メッセージ: HDInsightOnDemand linked service does not support execution via SelfHosted IR. Your IR name is '%IRName;'. Please select an Azure IR instead.

  • 原因:HDInsightOnDemand のリンクされたサービスでは、セルフホステッド IR 経由の実行がサポートされていません。

  • 推奨事項:Azure IR を選択してから、再試行します。

エラー コード:2341

  • メッセージ: HDInsight cluster URL '%clusterUrl;' is incorrect, it must be in URI format and the scheme must be 'https'.

  • 原因:指定した URL の形式が正しくありません。

  • 推奨事項:クラスター URL を修正し、再試行します。

エラー コード:2342

  • メッセージ: Failed to connect to HDInsight cluster: '%errorMessage;'.

  • 原因:クラスターに指定された資格情報が間違っているか、ネットワークの構成または接続に問題があるか、または IR とクラスターの接続に問題があります。

  • 推奨事項:

    1. ブラウザーで HDInsight クラスターの Ambari UI を開いて、資格情報が正しいことを確認します。

    2. クラスターが Virtual Network (VNet) 内にあり、セルフホステッド IR が使用されている場合、HDI URL は VNet のプライベート URL である必要があり、クラスター名の後に -int が指定されている必要があります。

      たとえば、https://mycluster.azurehdinsight.net/ を https://mycluster-int.azurehdinsight.net/ に変更します。 -int は mycluster の後かつ .azurehdinsight.net の前にあることに注意してください

    3. クラスターが VNet 内にあり、セルフホステッド IR を使用し、プライベート URL を使用しても接続に失敗する場合は、IR がインストールされている VM に、HDI に接続できない問題があります。

      IR がインストールされている VM に接続し、ブラウザーで Ambari UI を開きます。 クラスターにプライベート URL を使用します。 この接続はブラウザーから動作するはずです。 動作しない場合、HDInsight サポートにお問い合わせください。

    4. セルフホステッド IR が使用されていない場合、HDI クラスターにパブリック アクセスできるはずです。 ブラウザーで Ambari UI を開き、それが開くことを確認します。 クラスターやクラスター上のサービスに問題がある場合、HDInsight サポート チームに連絡して支援を求めてください。

      テスト接続に合格し、実行が機能するには、リンク サービスで使用されている HDI クラスター URL に IR (セルフホステッドまたは Azure) でアクセスできる必要があります。 この状態は、VM または任意のパブリック マシンでブラウザーからその URL を開くことで確認できます。

エラー コード:2343

  • メッセージ: User name and password cannot be null or empty to connect to the HDInsight cluster.

  • 原因:ユーザー名またはパスワードが空です。

  • 推奨事項:HDI に接続するための正しい資格情報を指定し、再試行します。

エラー コード:2345

  • メッセージ: Failed to read the content of the hive script. Error: '%message;'

  • 原因: スクリプト ファイルが存在しないか、サービスでスクリプトの場所に接続できませんでした。

  • 推奨事項:スクリプトが存在し、関連するリンクされたサービスに接続のための適切な資格情報があることを確認します。

エラー コード:2346

  • メッセージ: Failed to create ODBC connection to the HDI cluster with error message '%message;'.

  • 原因: サービスで HDI クラスターへの Open Database Connectivity (ODBC) 接続を確立しようとしましたが、エラーが発生して失敗しました。

  • 推奨事項:

    1. ODBC または Java Database Connectivity (JDBC) 接続が正しく設定されていることを確認します。
      1. JDBC の場合、同じ仮想ネットワークを使用しているときは、以下からこの接続を取得できます。
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. 適切な JDBC が設定されていることを確認するには、「HDInsight 上で JDBC ドライバーを使用して Apache Hive のクエリを実行する」を参照してください。
      3. Open Database (ODB) の場合は、「チュートリアル: ODBC と PowerShell による Apache Hive のクエリの実行」を参照して、設定が正しいことを確認します。
    2. Hiveserver2、Hive メタストア、および Hiveserver2 Interactive がアクティブで動作していることを確認します。
    3. Ambari ユーザー インターフェイス (UI) を確認します。
      1. すべてのサービスがまだ実行されていることを確認します。
      2. Ambari UI で、ダッシュボードのアラート セクションを確認します。
        1. アラートとアラートの解決方法の詳細については、「クラスターの管理と監視」を参照してください。
    4. これらの手順が問題を解決するのに十分でない場合は、Azure HDInsight チームにお問い合わせください。

エラー コード:2347

  • メッセージ: Hive execution through ODBC failed with error message '%message;'.

  • 原因: サービスから ODBC 接続経由で HDI クラスターに実行のための Hive スクリプトが送信され、そのスクリプトが HDI 上で失敗しました。

  • 推奨事項:

    1. ODBC または Java Database Connectivity (JDBC) 接続が正しく設定されていることを確認します。
      1. JDBC の場合、同じ仮想ネットワークを使用しているときは、以下からこの接続を取得できます。
        Hive -> Summary -> HIVESERVER2 JDBC URL
      2. 適切な JDBC が設定されていることを確認するには、「HDInsight 上で JDBC ドライバーを使用して Apache Hive のクエリを実行する」を参照してください。
      3. Open Database (ODB) の場合は、「チュートリアル: ODBC と PowerShell による Apache Hive のクエリの実行」を参照して、設定が正しいことを確認します。
    2. Hiveserver2、Hive メタストア、および Hiveserver2 Interactive がアクティブで動作していることを確認します。
    3. Ambari ユーザー インターフェイス (UI) を確認します。
      1. すべてのサービスがまだ実行されていることを確認します。
      2. Ambari UI で、ダッシュボードのアラート セクションを確認します。
        1. アラートとアラートの解決方法の詳細については、「クラスターの管理と監視」を参照してください。
    4. これらの手順が問題を解決するのに十分でない場合は、Azure HDInsight チームにお問い合わせください。

エラー コード:2348

  • メッセージ: The main storage has not been initialized. Please check the properties of the storage linked service in the HDI linked service.

  • 原因:ストレージのリンクされたサービスのプロパティが正しく設定されていません。

  • 推奨事項:HDI アクティビティのメイン ストレージのリンクされたサービスでは、完全接続文字列のみサポートされています。 MSI 認証またはアプリケーションを使用していないことを確認します。

エラー コード:2350

  • メッセージ: Failed to prepare the files for the run '%jobId;'. HDI cluster: '%cluster;', Error: '%errorMessage;'

  • 原因:ファイルがあるはずのストレージに接続するための資格情報が間違っているか、ファイルがそこにありません。

  • 推奨事項: このエラーは、サービスが HDI アクティビティに備えて、ジョブを HDI に送信する前にファイルをメイン ストレージにコピーしようとしたときに発生します。 指定の場所にファイルが存在すること、およびストレージ接続が正しいことを確認します。 HDI アクティビティでは、HDI アクティビティに関連付けられているストレージ アカウントの MSI 認証がサポートされていません。そのため、これらのリンク サービスに完全なキーが指定されていること、または Azure Key Vault が使用されていることを確認します。

エラー コード:2351

  • メッセージ: Could not open the file '%filePath;' in container/fileSystem '%container;'.

  • 原因:指定されたパスにファイルが存在しません。

  • 推奨事項:ファイルが実際に存在するかどうかを確認し、このファイルを指す接続情報を含むリンクされたサービスに正しい資格情報が指定されていることを確認します。

エラー コード:2352

  • メッセージ: The file storage has not been initialized. Please check the properties of the file storage linked service in the HDI activity.

  • 原因:ファイル ストレージのリンクされたサービスのプロパティが正しく設定されていません。

  • 推奨事項:ファイル ストレージのリンクされたサービスのプロパティが正しく構成されていることを確認します。

エラー コード:2353

  • メッセージ: The script storage has not been initialized. Please check the properties of the script storage linked service in the HDI activity.

  • 原因:スクリプト ストレージのリンクされたサービスのプロパティが正しく設定されていません。

  • 推奨事項:スクリプト ストレージのリンクされたサービスのプロパティが正しく構成されていることを確認します。

エラー コード:2354

  • メッセージ: The storage linked service type '%linkedServiceType;' is not supported for '%executorType;' activities for property '%linkedServicePropertyName;'.

  • 原因:ストレージのリンクされたサービスの種類は、このアクティビティではサポートされていません。

  • 推奨事項:選択したリンクされたサービスがアクティビティでサポートされているいずれかの種類であることを確認します。 HDI アクティビティでは、AzureBlobStorage と AzureBlobFSStorage のリンクされたサービスがサポートされています。

    詳細については、「Azure HDInsight クラスターで使用するストレージ オプションを比較する」を参照してください

エラー コード:2355

  • メッセージ: The '%value' provided for commandEnvironment is incorrect. The expected value should be an array of strings where each string has the format CmdEnvVarName=CmdEnvVarValue.

  • 原因:commandEnvironment に指定された値が正しくありません。

  • 推奨事項:指定された値が次のようになっていることを確認します。

    \"variableName=variableValue\"
]

    また、各変数が一覧内で 1 回だけ出現することを確認します。

エラー コード:2356

  • メッセージ: The commandEnvironment already contains a variable named '%variableName;'.

  • 原因:commandEnvironment に指定された値が正しくありません。

  • 推奨事項:指定された値が次のようになっていることを確認します。

    \"variableName=variableValue\"
]

    また、各変数が一覧内で 1 回だけ出現することを確認します。

エラー コード:2357

  • メッセージ: The certificate or password is wrong for ADLS Gen 1 storage.

  • 原因:指定された資格情報が間違っています。

  • 推奨事項:ADLS Gen 1 の接続情報がサービスにリンクされていることを確認し、テスト接続に成功することを確認します。

エラー コード:2358

  • メッセージ: The value '%value;' for the required property 'TimeToLive' in the on demand HDInsight linked service '%linkedServiceName;' has invalid format. It should be a timespan between '00:05:00' and '24:00:00'.

  • 原因:必須プロパティ TimeToLive に指定された値の形式が無効です。

  • 推奨事項:値を推奨される範囲に更新し、再試行します。

エラー コード:2359

  • メッセージ: The value '%value;' for the property 'roles' is invalid. Expected types are 'zookeeper', 'headnode', and 'workernode'.

  • 原因:プロパティ roles に指定された値が無効です。

  • 推奨事項:値をいずれかの推奨値に変更し、再試行します。

エラー コード:2360

  • メッセージ: The connection string in HCatalogLinkedService is invalid. Encountered an error while trying to parse: '%message;'.

  • 原因:HCatalogLinkedService に指定された接続文字列が無効です。

  • 推奨事項:値を正しい Azure SQL 接続文字列に更新し、再試行します。

エラー コード:2361

  • メッセージ: Failed to create on demand HDI cluster. Cluster name is '%clusterName;'.

  • 原因: クラスター作成に失敗したが、サービスには HDInsight サービスからエラーが返されませんでした。

  • 推奨事項:Azure portal を開き、指定された名前の HDI リソースを見つけて、プロビジョニング状態を確認します。 さらに支援が必要であれば、HDInsight サポート チームにお問い合わせください。

エラー コード:2362

  • メッセージ: Only Azure Blob storage accounts are supported as additional storages for HDInsight on demand linked service.

  • 原因:指定された追加のストレージは Azure Blob Storage ではありませんでした。

  • 推奨事項:HDInsight オンデマンドのリンクされたサービスの追加ストレージとして Azure Blob Storage アカウントを指定します。

HDInsight ESP クラスターを使用しているリンク サービスで SSL エラーが発生しました

  • メッセージ: Failed to connect to HDInsight cluster: 'ERROR [HY000] [Microsoft][DriverSupport] (1100) SSL certificate verification failed because the certificate is missing or incorrect.'

  • 原因:この問題は、システムの信頼ストアに関連している可能性が最も高いです。

  • 解決方法:パス Microsoft Integration Runtime\4.0\Shared\ODBC Drivers\Microsoft Hive ODBC Driver\lib に移動し、DriverConfiguration64.exe を開いて設定を変更できます。

    Uncheck Use System Trust Store

クラスターの準備中に HDI アクティビティがスタックする

クラスターの準備中に HDI アクティビティがスタックした場合は、次のガイドラインに従います。

  1. 以下に示す値よりタイムアウト値が大きいことを確認し、実行が完了するまで、またはタイムアウトするまで待ち、Time To Live (TTL) 時間が経過するまで待ってから、新しいジョブを送信します。

    クラスターのスピンアップにかかる既定の時間は最大 2 時間ですが、init スクリプトがある場合は、さらに 2 時間かかります。

  2. ストレージと HDI が、同じリージョンでプロビジョニングされていることを確認します。

  3. HDI クラスターへのアクセスに使用されるサービス プリンシパルが有効であることを確認します。

  4. 問題が解決しない場合は、回避策として HDI のリンク サービスを削除し、新しい名前で再作成します。

Web アクティビティ

エラー コード: 2001

エラー コード: 2002

  • メッセージ: The payload including configurations on activity/dataSet/linked service 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.

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

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

エラー コード: 2010

  • メッセージ: The Self-hosted Integration Runtime ‘<SHIR name>’ is offline

  • 原因: セルフホステッド統合ランタイムがオフラインであるか、または Azure 統合ランタイムが期限切れになっているか登録されていません。

  • 推奨事項: セルフホステッド統合ランタイムが稼働していることを確認します。 詳細については、セルフホステッド統合ランタイムのトラブルシューティングに関するページを参照してください。

エラー コード: 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 integration runtime is valid and retry. Localhost URLs are allowed only with SelfHosted Integration Runtime'

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

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


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

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

  • 推奨事項: Fiddler、Postman、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 options

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

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

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

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

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

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

エラー メッセージ: The payload including configurations on activity/dataSet/linked service 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" のアルゴリズムによって圧縮されていますが、Azure Data Factory の内部 zip ライブラリでは "deflate" のみがサポートされています。 zip ファイルが Windows システムによって圧縮され、ファイル全体のサイズが特定の数値を超える場合、Windows では既定で "deflate64" が使用され、これは Azure Data Factory でサポートされていません。 一方、ファイル サイズが小さいか、または圧縮アルゴリズムの指定をサポートする何らかのサードパーティ製の zip ツールを使用している場合、Windows では既定で "deflate" が使用されます。

ヒント

実際に、「Azure Data Factory と Synapse Analytics でのバイナリ形式」と「Azure Data Factory および Azure Synapse Analytics での区切りテキスト形式」の両方で、"deflate64" 形式は Azure 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.

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

Screenshot showing the parameters of the Execute Pipeline activity.

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

Screenshot showing the input type string.

推奨事項: この問題を解決するために、次の画像に示すように配列の作成関数を利用できます。

Screenshot showing how to use the create array function.

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

Screenshot showing input type array.

関連するコンテンツ

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