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

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

この記事では、Azure Data Factory および Azure Synapse Analytics でのコネクタに関するトラブルシューティングを行う方法について説明します。

コネクタ固有の問題

各コネクタのトラブルシューティングのページでは、そのコネクタに特有の問題点と、その原因の説明、および解決するための推奨事項が紹介されています。

一般的な Copy アクティビティのエラー

以下は、Copy アクティビティに関する一般的なエラーで、どのコネクタでも発生する可能性があります。

エラー コード: 20000

  • メッセージ: Java Runtime Environment cannot be found on the Self-hosted Integration Runtime machine. It is required for parsing or writing to Parquet/ORC files. Make sure Java Runtime Environment has been installed on the Self-hosted Integration Runtime machine.

  • 原因:セルフホステッド IR は、Java ランタイムを見つけることができません。 Java ランタイムは、特定のソースを読み取るために必要です。

  • 推奨事項: 統合ランタイム環境を確認するには、「セルフホステッド統合ランタイムの使用」を参照してください。

エラー コード: 20002

  • メッセージ: An error occurred when invoking Java Native Interface.

  • 原因: エラー メッセージに "Cannot create JVM: JNI return code [-6] [JNI call failed: Invalid arguments.]"\(JVM を作成できません: JNI リターン コード [-6] [JNI 呼び出しが失敗しました: 無効な引数です。]\) が含まれている場合、一部の無効な (グローバル) 引数が設定されているため、JVM を作成できない可能性があります。

  • 推奨事項: セルフホステッド統合ランタイムの各ノードをホストするマシンにサインインします。 次のように、システム変数が正しく設定されていることを確認します_JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G。 すべての統合ランタイム ノードを再起動してから、パイプラインを再実行します。

エラー コード: 20020

  • メッセージ: Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

  • 原因:シンク データセットでは、ワイルドカード値はサポートされません。

  • 推奨事項: シンク データセットを確認し、ワイルドカード値を使用せずにパスを書き直します。

FIPS の問題

  • 現象:次のエラー メッセージが表示された FIPS 対応のセルフホステッド IR コンピューターでは、Copy アクティビティが失敗します: This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

  • 原因:このエラーは、Azure BLOB、SFTP などのコネクタを使用してデータをコピーするときに発生する可能性があります。 Federal Information Processing Standards (FIPS) では、使用が許可される暗号化アルゴリズムの特定のセットを定義します。 マシンで FIPS モードが有効になっている場合、一部のシナリオでは、コピー アクティビティが依存する一部の暗号化クラスがブロックされます。

  • 解決方法: 現在は "FIPS モード" の使用を推奨していない理由と、セルフホステッド IR コンピューターで FIPS を無効にできるかどうかを評価する方法について参照してください。

    または、FIPS をバイパスしてアクティビティを正常に実行できるようにするだけの場合は、次の手順を実行します。

    1. セルフホステッド IR がインストールされているフォルダーを開きます。 パスは通常、C:\Program Files\Microsoft Integration Runtime <IR version>\Shared です。

    2. diawp.exe.config ファイルを開き、<runtime> セクションの最後で、次のように <enforceFIPSPolicy enabled="false"/> を追加します。

      FIPS が無効になっていることを示す、diawp.exe.config ファイルのセクションのスクリーンショット。

    3. ファイルを保存し、セルフホステッド IR コンピューターを再起動します。

エラー コード: 20150

  • メッセージ: Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • 原因: クライアント ID またはクライアント シークレットが無効なため、承認サーバーで認証に失敗しました。

  • 推奨事項: 承認サーバーのすべての OAuth2 クライアント資格情報フロー設定を修正します。

エラー コード: 20151

  • メッセージ: Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • 原因: OAuth2 クライアント資格情報フロー設定が無効です。

  • 推奨事項: 承認サーバーのすべての OAuth2 クライアント資格情報フロー設定を修正します。

エラー コード: 20152

  • メッセージ: The token type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

  • 原因: お使いの承認サーバーはサポートされていません。

  • 推奨事項: サポートされているトークンの種類のトークンを返すことができる承認サーバーを使用します。

エラー コード: 20153

  • メッセージ: The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

  • 原因: クライアント ID に無効な文字であるコロン (:) が含まれています。

  • 推奨事項: 有効なクライアント ID を使用してください。

エラー コード: 20523

  • メッセージ: Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 推奨事項: サポートされているバージョンを確認し、統合ランタイムを新しいバージョンにアップグレードします。

エラー コード: 20551

  • メッセージ: The format settings are missing in dataset %dataSetName;.

  • 原因: データセットの型が Binary で、これはサポートされていません。

  • 推奨事項: DelimitedText、Json、Avro、Orc、または Parquet のデータセットを代わりに使用してください。

  • 原因: ファイル ストレージについて、データセットにフォーマット設定がありません。

  • 推奨事項: データセットの "バイナリ コピー" の選択を解除し、正しいフォーマット設定を設定します。

エラー コード: 20552

  • メッセージ: The command behavior "%behavior;" is not supported.

  • 推奨事項: コマンド動作をプレビューまたは GetSchema API 要求 URL のパラメーターとして追加しないでください。

エラー コード: 20701

  • メッセージ: Failed to retrieve source file ('%name;') metadata to validate data consistency.

  • 原因: シンク データ ストアに一時的な問題があるか、シンク データ ストアからのメタデータの取得が許可されていません。

エラー コード: 20703

  • メッセージ: Failed to retrieve sink file ('%name;') metadata to validate data consistency.

  • 原因: シンク データ ストアに一時的な問題があるか、シンク データ ストアからのメタデータの取得が許可されていません。

エラー コード: 20704

  • メッセージ: Data consistency validation is not supported in current copy activity settings.

  • 原因: データ整合性の検証は、ダイレクト バイナリ コピー シナリオでのみサポートされています。

  • 推奨事項: コピー アクティビティ ペイロードの 'validateDataConsistency' プロパティを削除します。

エラー コード: 20705

  • メッセージ: 'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 推奨事項: サポートされている統合ランタイム バージョンを確認し、それを上位バージョンにアップグレードするか、コピー アクティビティから 'validateDataConsistency' プロパティを削除します。

エラー コード: 20741

  • メッセージ: Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'fileMissing' を削除します。

エラー コード: 20742

  • メッセージ: Skip inconsistency is not supported in current copy activity settings, it's only supported with direct binary copy when validateDataConsistency is true.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'dataInconsistency' を削除します。

エラー コード: 20743

  • メッセージ: Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'fileForbidden' を削除します。

エラー コード: 20744

  • メッセージ: Skip forbidden file is not supported for this connector: ('%connectorName;').

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'fileForbidden' を削除します。

エラー コード: 20745

  • メッセージ: Skip invalid file name is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'invalidFileName' を削除します。

エラー コード: 20746

  • メッセージ: Skip invalid file name is not supported for '%connectorName;' source.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'invalidFileName' を削除します。

エラー コード: 20747

  • メッセージ: Skip invalid file name is not supported for '%connectorName;' sink.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'invalidFileName' を削除します。

エラー コード: 20748

  • メッセージ: Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

  • 推奨事項: コピー アクティビティ ペイロードの skipErrorFile 設定の 'allErrorFile' を削除します。

エラー コード: 20771

  • メッセージ: 'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

  • 推奨事項: 'deleteFilesAfterCompletion' 設定を削除するか、ダイレクト バイナリ コピーを使用してください。

エラー コード: 20772

  • メッセージ: 'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

  • 推奨事項: コピー アクティビティ ペイロードの 'deleteFilesAfterCompletion' 設定を削除してください。

エラー コード: 27002

  • メッセージ: Failed to download custom plugins.

  • 原因: ダウンロード リンクが無効であるか、一時的な接続の問題が発生しています。

  • 推奨事項: 一時的な問題であることをメッセージが示す場合は、再試行します。 問題が解決しない場合は、サポート チームにお問い合わせください。

一般的なコネクタのエラー

エラー コード: 9611

  • メッセージ: The following ODBC Query is not valid: '%'.

  • 原因: 間違ったクエリまたは無効なクエリを指定して、データ/スキーマをフェッチしています。

  • 推奨事項: クエリが有効で、データ/スキーマを返すことができるかどうかを確認します。 クエリ以外のスクリプトを実行し、データ ストアがサポートされている場合は、スクリプト アクティビティを使用します。 あるいは、ダミーの結果を返すストアド プロシージャを使って、クエリ以外のスクリプトを実行することを検討してください。

エラー コード: 11775

  • メッセージ: Failed to connect to your instance of Azure Database for PostgreSQL flexible server. '%'

  • 原因: '%' で返されるテキストによって、正確な原因は異なります。 操作がタイムアウトになった場合、PostgreSQL のインスタンスが停止しているか、インスタンス用に構成されたネットワーク接続方法で選択された Integration Runtime からの接続が許可されていないことが原因である可能性があります。 指定されたユーザーまたはパスワードが正しくありません。 28P01: ユーザー "youruser" のパスワード認証に失敗しましたの場合は、指定されたユーザーがインスタンスに存在しないか、パスワードが正しくないことを意味します。<> 28000: no pg_hba.conf entry for host "###.###.###.###", user "youruser", database "yourdatabase", no encryption の場合、選択された暗号化方法がサーバーの構成と互換性がないことを意味します。<><>

  • 推奨事項: 指定されたユーザーが PostgreSQL のインスタンスに存在することと、パスワードがそのユーザーに現在割り当てられているパスワードに対応していることを確認します。 選択した暗号化方法が、現在の構成に基づいて PostgreSQL のインスタンスによって受け入れられることを確認します。 インスタンスのネットワーク接続方法がプライベート アクセス (仮想ネットワーク統合) 用に構成されている場合は、セルフホステッド統合ランタイム (IR) を使用して接続します。 パブリック アクセス (許可された IP アドレス) 用に構成されている場合は、マネージド仮想ネットワークで Azure IR を使用し、インスタンスに接続するためにマネージド プライベート エンドポイントを展開することをお勧めします。 パブリック アクセス (許可された IP アドレス) 用に構成されているときにあまりお勧めしない方法としては、使用している Azure IR が使用する IP アドレスからの送信トラフィックを許可するファイアウォール規則をインスタンスに作成する方法があります。

関連するコンテンツ

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