針對 Azure Data Factory 和 Azure Synapse Analytics 連接器進行疑難排解

  • 發行項

適用於：Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告等所有項目。 了解如何免費啟動新的試用版！

本文說明如何針對 Azure Data Factory 和 Azure Synapse Analytics 中的連接器進行疑難解答。

連線 或特定問題

您可以參考每個連接器的疑難解答頁面，以查看其原因及解決其原因和建議的特定問題。

一般複製活動錯誤

下列錯誤一般適用於複製活動，而且可能會與任何連接器一起發生。

錯誤碼：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 執行時間。

  • 建議：檢查整合運行時間環境，請參閱 使用自我裝載整合運行時間。

錯誤碼：通配符PathSinkNotSupported

  • 訊息：Wildcard in path is not supported in sink dataset. Fix the path: '%setting;'.

  • 原因：接收數據集不支援通配符值。

  • 建議：檢查接收數據集，並重寫路徑而不使用通配符值。

FIPS 問題

  • 徵兆：#D540E0F13F37140A999AE0A289B9AB718 在已啟用 FIPS 的自我裝載 IR 計算機上失敗，並出現下列錯誤訊息：This implementation is not part of the Windows Platform FIPS validated cryptographic algorithms.

  • 原因：當您使用 Azure Blob、SFTP 等連接器複製數據時，可能會發生此錯誤。 聯邦資訊處理標準 （FIPS） 定義一組允許使用的特定密碼編譯演算法。 在機器上啟用 FIPS 模式時，某些複製活動相依的密碼編譯類別在某些情況下會遭到封鎖。

  • 解決方案：瞭解 為什麼我們不再建議「FIPS 模式」，並評估您是否可以在自我裝載 IR 計算機上停用 FIPS。

    或者，如果您只想要略過 FIPS 並讓活動執行成功，請執行下列動作：

    1. 開啟安裝自我裝載 IR 的資料夾。 路徑通常是 C：\Program Files\Microsoft Integration Runtime <IR 版本>\Shared。

    2. 開啟 diawp.exe.config 檔案，然後在 區段結尾<runtime>新增 <enforceFIPSPolicy enabled="false"/>，如下所示：

      Screenshot of a section of the diawp.exe.config file showing FIPS disabled.

    3. 儲存盤案，然後重新啟動自我裝載 IR 機器。

錯誤碼：JniException

  • 訊息：An error occurred when invoking Java Native Interface.

  • 原因：如果錯誤訊息包含「無法建立 JVM：JNI 傳回碼 [-6][JNI 呼叫失敗：無效的自變數。]“，可能的原因是無法建立 JVM，因為已設定一些不合法的 （global） 自變數。

  • 建議：登入 裝載自我裝載整合運行時間每個節點 的計算機。 檢查以確定系統變數已正確設定，如下所示： _JAVA_OPTIONS "-Xms256m -Xmx16g" with memory bigger than 8G。 重新啟動所有整合運行時間節點，然後重新執行管線。

錯誤碼：GetOAuth2AccessTokenErrorResponse

  • 訊息：Failed to get access token from your token endpoint. Error returned from your authorization server: %errorResponse;.

  • 原因：您的用戶端識別碼或客戶端密碼無效，且您的授權伺服器驗證失敗。

  • 建議：更正授權伺服器的所有 OAuth2 用戶端認證流程設定。

錯誤碼：FailedToGetOAuth2AccessToken

  • 訊息：Failed to get access token from your token endpoint. Error message: %errorMessage;.

  • 原因：OAuth2 用戶端認證流程設定無效。

  • 建議：更正授權伺服器的所有 OAuth2 用戶端認證流程設定。

錯誤碼：OAuth2AccessTokenTypeNotSupported

  • 訊息：The toke type '%tokenType;' from your authorization server is not supported, supported types: '%tokenTypes;'.

  • 原因：不支援您的授權伺服器。

  • 建議：使用可傳回具有支援令牌類型的令牌的授權伺服器。

錯誤碼：OAuth2ClientIdColonNotAllowed

  • 訊息：The character colon(:) is not allowed in clientId for OAuth2ClientCredential authentication.

  • 原因：您的用戶端識別碼包含無效的字元冒號 （:）。

  • 建議：使用有效的用戶端標識碼。

錯誤碼：ManagedIdentityCredentialObjectNotSupported

  • 訊息：Managed identity credential is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 建議：檢查支援的版本，並將整合運行時間升級至更高版本。

錯誤碼：QueryMissingFormat 設定 InDataset

  • 訊息：The format settings are missing in dataset %dataSetName;.

  • 原因：數據集類型為二進位，不受支援。

  • 建議：請改用 DelimitedText、Json、Avro、Orc 或 Parquet 數據集。

  • 原因：針對檔案記憶體，數據集中遺漏格式設定。

  • 建議：取消選取數據集中的「二進位複本」，並設定正確的格式設定。

錯誤碼：QueryUnsupportedCommandBehavior

  • 訊息：The command behavior "%behavior;" is not supported.

  • 建議：請勿將命令行為新增為預覽或 GetSchema API 要求 URL 的參數。

錯誤碼：DataConsistencyFailedToGetSourceFileMetadata

  • 訊息：Failed to retrieve source file ('%name;') metadata to validate data consistency.

  • 原因：接收數據存放區發生暫時性問題，或不允許從接收數據存放區擷取元數據。

錯誤碼：DataConsistencyFailedToGetSinkFileMetadata

  • 訊息：Failed to retrieve sink file ('%name;') metadata to validate data consistency.

  • 原因：接收數據存放區發生暫時性問題，或不允許從接收數據存放區擷取元數據。

錯誤碼：DataConsistencyValidationNotSupportedForNonDirectBinaryCopy

  • 訊息：Data consistency validation is not supported in current copy activity settings.

  • 原因：只有直接二進制複製案例才支持數據一致性驗證。

  • 建議：移除複製活動承載中的 'validateDataConsistency' 屬性。

錯誤碼：DataConsistencyValidationNotSupportedForLowVersionSelfHostedIntegrationRuntime

  • 訊息：'validateDataConsistency' is not supported in this version ('%version;') of Self Hosted Integration Runtime.

  • 建議：檢查支援的整合運行時間版本，並將其升級至較高版本，或從複製活動中移除 『validateDataConsistency』 屬性。

錯誤碼：SkipMissingFileNotSupportedForNonDirectBinaryCopy

  • 訊息：Skip missing file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 建議：移除複製活動承載中skipErrorFile 設定的 『fileMissing』。

錯誤碼：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'。

錯誤碼：SkipForbiddenFileNotSupportedForNonDirectBinaryCopy

  • 訊息：Skip forbidden file is not supported in current copy activity settings, it's only supported with direct binary copy with folder.

  • 建議：移除複製活動承載中 skipErrorFile 設定的 'fileForbidden'。

錯誤碼：SkipForbiddenFileNotSupportedForThis 連線 or

  • 訊息：Skip forbidden file is not supported for this connector: ('%connectorName;').

  • 建議：移除複製活動承載中 skipErrorFile 設定的 'fileForbidden'。

錯誤碼：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'。

錯誤碼：SkipInvalidFileNameNotSupportedForSource

  • 訊息：Skip invalid file name is not supported for '%connectorName;' source.

  • 建議：移除複製活動承載中 skipErrorFile 設定的 'invalidFileName'。

錯誤碼：SkipInvalidFileNameNotSupportedForSink

  • 訊息：Skip invalid file name is not supported for '%connectorName;' sink.

  • 建議：移除複製活動承載中 skipErrorFile 設定的 'invalidFileName'。

錯誤碼：SkipAllErrorFileNotSupportedForNonBinaryCopy

  • 訊息：Skip all error file is not supported in current copy activity settings, it's only supported with binary copy with folder.

  • 建議：移除複製活動承載中 skipErrorFile 設定中的 'allErrorFile'。

錯誤碼：DeleteFilesAfterCompletionNotSupportedForNonDirectBinaryCopy

  • 訊息：'deleteFilesAfterCompletion' is not support in current copy activity settings, it's only supported with direct binary copy.

  • 建議：移除 'deleteFilesAfterCompletion' 設定或使用直接二進位複本。

錯誤碼：DeleteFilesAfterCompletionNotSupportedForThis 連線 or

  • 訊息：'deleteFilesAfterCompletion' is not supported for this connector: ('%connectorName;').

  • 建議：移除複製活動承載中的 'deleteFilesAfterCompletion' 設定。

錯誤碼：FailedToDownloadCustomPlugins

  • 訊息：Failed to download custom plugins.

  • 原因：下載鏈接或暫時性連線問題無效。

  • 建議：如果訊息顯示這是暫時性問題，請重試。 如果問題持續發生，請連絡支援小組。

一般連接器錯誤

錯誤碼：UserErrorOdbcInvalidQueryString

  • 訊息：The following ODBC Query is not valid: '%'.

  • 原因：您提供錯誤或無效的查詢來擷取數據/架構。

  • 建議：確認您的查詢有效，而且可以傳回數據/架構。 如果您想要執行非查詢文本，且支援資料存放區，請使用 腳本活動 。 或者，請考慮使用會傳回虛擬結果的預存程式來執行非查詢腳本。

錯誤碼：FailToResolveParametersInExploratoryController

  • 訊息：The parameters and expression cannot be resolved for schema operations. …The template function 'linkedService' is not defined or not valid.

  • 原因：服務有限制可支持連結服務，此服務會參考另一個連結服務與測試連線或預覽數據的參數。 例如，將參數從 金鑰保存庫 傳遞至連結服務可能會發生此問題。 

  • 建議：移除所參考鏈接服務中的參數，以排除錯誤。 否則，請執行管線，而不需要測試連線或預覽數據。 

相關內容

如需更多疑難排解的協助，請嘗試下列資源：