針對 Azure Data Factory 和 Azure Synapse Analytics 連接器進行疑難排解
適用於:Azure Data Factory Azure Synapse Analytics
提示
試用 Microsoft Fabric 中的 Data Factory,這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告等所有項目。 了解如何免費啟動新的試用版!
本文說明如何針對 Azure Data Factory 和 Azure Synapse Analytics 中的連接器進行疑難解答。
連線 或特定問題
您可以參考每個連接器的疑難解答頁面,以查看其原因及解決其原因和建議的特定問題。
- Azure Blob 儲存體
- Azure Cosmos DB (包括適用於 NoSQL 的 Azure Cosmos DB 連接器)
- Azure Data Lake (Gen1 和 Gen2)
- 適用於 PostgreSQL 的 Azure 資料庫
- Azure 檔案儲存體記憶體
- Azure Synapse Analytics、Azure SQL 資料庫 和 SQL Server
- DB2
- 分隔符號文字格式
- Dynamics 365、Dataverse (Common Data Service) 和 Dynamics CRM
- FTP、SFTP 和 HTTP
- Hive
- Oracle
- ORC 格式
- Parquet 格式
- REST
- Salesforce 和 Salesforce Service Cloud
- SharePoint Online 列表
- XML 格式
一般複製活動錯誤
下列錯誤一般適用於複製活動,而且可能會與任何連接器一起發生。
錯誤碼: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 並讓活動執行成功,請執行下列動作:
開啟安裝自我裝載 IR 的資料夾。 路徑通常是 C:\Program Files\Microsoft Integration Runtime <IR 版本>\Shared。
開啟 diawp.exe.config 檔案,然後在 區段結尾
<runtime>
新增<enforceFIPSPolicy enabled="false"/>
,如下所示:儲存盤案,然後重新啟動自我裝載 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.
原因:服務有限制可支持連結服務,此服務會參考另一個連結服務與測試連線或預覽數據的參數。 例如,將參數從 金鑰保存庫 傳遞至連結服務可能會發生此問題。
建議:移除所參考鏈接服務中的參數,以排除錯誤。 否則,請執行管線,而不需要測試連線或預覽數據。
相關內容
如需更多疑難排解的協助,請嘗試下列資源: