共用方式為

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

  • 發行項

適用於：Azure Data Factory Azure Synapse Analytics

提示

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

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

連接器特有的問題

您可以參考每個連接器的疑難排解頁面，查看其特有的問題，並了解原因說明和解決方式建議。

一般複製活動錯誤

下列錯誤是複製活動的一般錯誤，且可能透過任何連接器發生。

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

  • 原因：如果錯誤訊息包含 "Can't 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 機器上失敗，並出現下列錯誤訊息：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"/>，如下所示：

      螢幕擷取畫面：diawp.exe.config 檔案的區段顯示 FIPS 已停用。

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

錯誤碼：20150

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

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

  • 建議：更正授權伺服器的所有 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.

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

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

錯誤碼：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;.

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

  • 建議：請改用 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: password authentication failed for user <youruser> (28P01: 使用者 的密碼驗證失敗)，這表示提供的使用者不存在於執行個體中，或密碼不正確。 如果是 28000: no pg_hba.conf entry for host "###.###.###.###", user "<youruser>", database "<yourdatabase>", no encryption (28000: 主機 "###.###.###.###"、使用者 ""、資料庫 "yourdatabase" 沒有 pg_hba.conf 項目，不需加密)，這表示選取的加密方法與伺服器的設定不相容。

  • 建議：確認所提供的使用者存在於 PostgreSQL 執行個體中，且密碼對應於目前指派給該使用者的密碼。 請確定 PostgreSQL 的執行個體會根據其目前設定接受選取的加密方法。 如果執行個體的網路連線方法已設定為私人存取 (虛擬網路整合)，請使用自我裝載整合執行階段 (IR) 來進行連線。 如果其設定為公用存取 (允許的 IP 位址)，建議使用 Azure IR 搭配受控虛擬網路，並部署受控私人端點以連線到您的執行個體。 當其設定為公用存取 (允許的 IP 位址) 時，較不建議的替代方案是在執行個體中建立防火牆規則，以允許源自您 Azure IR 所用 IP 位址的流量。

相關內容

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