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

適用対象: Azure Data Factory Azure Synapse Analytics

この記事では、Azure Data Factory および Azure Synapse Analytics でのコネクタに関するトラブルシューティングを行う方法について説明します。 ここに特定のエラー メッセージが表示されない場合は、次の手順を実行できます。

1. 完全なエラー メッセージを確認します。 一部のエラー メッセージは、問題を解決するためのガイダンスを提供します。
2. 詳細については 、コネクタのトラブルシューティング ページ を参照してください。
3. 問題のトラブルシューティングを行うには、サポート付きのチケットを開きます。

コネクタ固有の問題

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

• Azure Blob Storage
• Azure Cosmos DB (Azure Cosmos DB for NoSQL コネクタを含む)
• Azure Data Lake (Gen1 および Gen2)
• Azure Database for PostgreSQL
• Azure Files ストレージ
• Azure Synapse Analytics、Azure SQL Database、および SQL Server
• DB2
• 区切りテキスト形式
• Dynamics 365、Dataverse (Common Data Service)、Dynamics CRM
• FTP、SFTP、HTTP
• ハイブ
• オラクル
• ORC 形式
• Parquet 形式
• REST（レスト）
• Salesforce と Salesforce Service Cloud
• SharePoint Online リスト
• XML 形式

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

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

エラー コード: 2200 - UserErrorOdbcOperationFailed

• メッセージ: The underlying connection was closed: An unexpected error occurred on a send.

• 原因: これは通常、データ転送操作中の認証エラーを示します。 これは、リモート パーティがトランスポート ストリームを閉じるときに発生する可能性があります。

• 推奨事項:

  • ソース接続を確認し、正しく機能していることを確認するためにテストします。
  • 接続に使用された認証方法を確認します。
  • Azure Cosmos DB のファイアウォール構成設定を確認して、必要なトラフィックが許可されていることを確認します。

エラー コード: 20000 - JreNotFound

• メッセージ: 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 - JniException

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

• 原因: エラー メッセージに "JVM を作成できません: JNI リターン コード [-6][JNI 呼び出しに失敗しました: 無効な引数]" が含まれている場合、一部の無効な (グローバル) 引数が設定されているため、JVM を作成できないことが考えられます。

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

エラー コード: 20020 - WildcardPathSinkNotSupported

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

• 原因: シンク データセットはワイルドカード値をサポートしていません。

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

FIPS の問題

• 現象: FIPS 対応のセルフホステッド IR マシンでコピー アクティビティが失敗し、次のエラー メッセージが表示されます。 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 バージョン>\Shared です。

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

     

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

エラー コード: 20150 - GetOAuth2AccessTokenErrorResponse

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

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

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

エラー コード: 20151 - FailedToGetOAuth2AccessToken

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

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

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

エラー コード: 20152 - OAuth2AccessTokenTypeNotSupported

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

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

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

エラー コード: 20153 - OAuth2ClientIdColonNotAllowed

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

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

• 推奨事項: 有効なクライアント ID を使用します。

エラー コード: 20523 - ManagedIdentityCredentialObjectNotSupported

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

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

エラー コード: 20551 - QueryMissingFormatSettingsInDataset

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

• 原因: データセットの種類はバイナリであり、サポートされていません。

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

• 原因: ファイル ストレージの場合、データセットに形式設定がありません。

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

エラー コード: 20552 - QueryUnsupportedCommandBehavior

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

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

エラー コード: 20701 - DataConsistencyFailedToGetSourceFileMetadata

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

• 原因: シンク データ ストアに一時的な問題があるか、シンク データ ストアからメタデータを取得することはできません。

エラー コード: 20703 - DataConsistencyFailedToGetSinkFileMetadata

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

• 原因: シンク データ ストアに一時的な問題があるか、シンク データ ストアからメタデータを取得することはできません。

エラー コード: 20704 - DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

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

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

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

エラー コード: 20705 - DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

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

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

エラー コード: 20741 - SkipMissingFileNotSupportedForNonDirectBinaryCopy

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

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

エラー コード: 20742 - SkipInconsistencyDataNotSupportedForNonDirectBinaryCopy

• メッセージ: 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 - SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

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

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

エラー コード: 20744 - SkipForbiddenFileNotSupportedForThisConnector

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

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

エラー コード: 20745 - SkipInvalidFileNameNotSupportedForNonDirectBinaryCopy

• メッセージ: 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 - SkipInvalidFileNameNotSupportedForSource

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

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

エラー コード: 20747 - SkipInvalidFileNameNotSupportedForSink

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

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

エラー コード: 20748 - SkipAllErrorFileNotSupportedForNonBinaryCopy

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

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

エラー コード: 20771 - DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

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

• 推奨事項: 'deleteFilesAfterCompletion' 設定を削除するか、直接バイナリ コピーを使用します。

エラー コード: 20772 - DeleteFilesAfterCompletionNotSupportedForThisConnector

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

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

エラー コード: 27002 - FailedToDownloadCustomPlugins

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

• 原因: 無効なダウンロード リンクまたは一時的な接続の問題。

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

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

エラー コード: 9611 - UserErrorOdbcInvalidQueryString

• メッセージ: 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: ホスト "###.###.###.###"、ユーザー "<youruser>"、データベース "<yourdatabase>" のための pg_hba.conf エントリがなく、暗号化なしということは、選択した暗号化方法がサーバーの構成と互換性がないことを意味します。

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

私のエラーはここにありません

ここに特定のエラー メッセージが表示されない場合は、コネクタ固有のエラーである可能性があるため、次の手順に従います。

1. 完全なエラー メッセージを確認します。 一部のエラー メッセージは、問題を解決するためのガイダンスを提供します。
2. 詳細については 、コネクタのトラブルシューティング ページ を参照してください。
3. 問題のトラブルシューティングを行うには、サポート付きのチケットを開きます。

関連コンテンツ

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

• Data Factory ブログ
• Data Factory 機能の要求
• Azure のビデオ
• Microsoft Q&A ページ
• Data Factory の Stack Overflow フォーラム
• Data Factory に関する X 情報