共用方式為

針對 SSIS Integration Runtime 管理進行疑難排解

  • 發行項

適用於：Azure Data Factory Azure Synapse Analytics

提示

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

本文提供 Azure-SQL Server Integration Services （SSIS） Integration Runtime （IR） 中管理問題的疑難解答指引，也稱為 SSIS IR。

概觀

如果您在布建或取消布建 SSIS IR 時遇到任何問題，您會在 Microsoft Azure Data Factory 入口網站中看到錯誤訊息，或從 PowerShell Cmdlet 傳回的錯誤。 錯誤一律會以錯誤碼的格式出現，並顯示詳細的錯誤訊息。

如果錯誤碼是 InternalServerError，則服務有暫時性問題，您應該稍後再重試作業。 如果重試沒有説明，請連絡 Azure Data Factory 支援小組。

否則，三個主要的外部相依性可能會造成錯誤：Azure SQL 資料庫 或 Azure SQL 受控執行個體、自定義設定腳本和虛擬網路組態。

SQL 資料庫 或 SQL 受管理執行個體 問題

如果您要使用 SSIS 目錄資料庫布建 SSIS IR，則需要 SQL 資料庫 或 SQL 受管理執行個體。 SSIS IR 必須能夠存取 SQL 資料庫 或 SQL 受管理執行個體。 此外，SQL 資料庫 或 SQL 受管理執行個體的登入賬戶必須具有建立 SSIS 目錄資料庫 （SSISDB） 的許可權。 如果發生錯誤，Data Factory 入口網站中會顯示具有詳細 SQL 例外狀況訊息的錯誤碼。 使用下列清單中的資訊，針對錯誤碼進行疑難解答。

AzureSqlConnectionFailure

布建新的 SSIS IR 或 IR 執行時，您可能會看到此問題。 如果您在 IR 布建期間遇到此錯誤，您可能會在錯誤訊息中收到詳細的 SqlException 訊息，指出下列其中一個問題：

  • 網路連線問題。 檢查是否可以存取 SQL 資料庫 或 SQL 受管理執行個體 的主機名。 也請確認沒有防火牆或網路安全性群組 (NSG) 封鎖 SSIS IR 對伺服器的存取。
  • SQL 驗證期間登入失敗。 所提供的帳戶無法登入 SQL Server 資料庫。 請確定您提供正確的用戶帳戶。
  • 登入在Microsoft Entra ID 驗證期間失敗（受控識別）。 將處理站的受控識別新增至 Microsoft Entra 群組，並確定受控識別具有目錄資料庫伺服器的訪問許可權。
  • 連線逾時。 此錯誤一律是由安全性相關設定所造成的。 我們建議您：
    1. 建立新的 VM。
    2. 如果 IR 位於虛擬網路中，則將 VM 加入相同Microsoft Azure 虛擬網絡 IR。
    3. 安裝 SSMS 並檢查 SQL 資料庫 或 SQL 受管理執行個體 狀態。

針對其他問題，請修正詳細的 SQL 例外狀況錯誤訊息中顯示的問題。 如果您仍然遇到問題，請連絡 SQL 資料庫 或 SQL 受管理執行個體 支援小組。

如果您在 IR 執行時看到錯誤，網路安全組或防火牆變更可能會防止 SSIS IR 背景工作節點存取 SQL 資料庫 或 SQL 受管理執行個體。 解除封鎖 SSIS IR 背景工作節點，使其可以存取 SQL 資料庫 或 SQL 受管理執行個體。

CatalogCapacityLimitError

以下是這類錯誤訊息的外觀：「資料庫 』SSISDB' 已達到其大小配額。 分割或刪除數據、卸除索引，或參閱檔以取得可能的解決方案。」

可能的解決方案包括：

  • 增加 SSISDB 的配額大小。
  • 變更 SSISDB 的設定，以透過下列方式減少大小：
    • 減少保留期間和專案版本數目。
    • 減少記錄的保留期間。
    • 變更記錄的預設層級。

CatalogDbBelongsToAnotherIR

此錯誤表示 SQL 資料庫 或 SQL 受管理執行個體 已經有 SSISDB，而且它正由另一個 IR 使用。 您必須提供不同的 SQL 資料庫 或 SQL 受管理執行個體，否則請刪除現有的 SSISDB，然後重新啟動新的 IR。

CatalogDbCreationFailure

此錯誤可能會因為下列其中一個原因而發生：

  • 針對 SSIS IR 設定的使用者帳戶沒有可建立資料庫的權限。 您可以授與使用者建立資料庫的許可權。
  • 資料庫建立期間發生逾時，例如執行逾時或 DB 作業逾時。 您應該稍後再重試作業。 如果重試無法運作，請連絡 SQL 資料庫 或 SQL 受管理執行個體 支援小組。

若為其他問題，請查看 SQL 例外狀況錯誤訊息，並修正錯誤詳細資料中所述的問題。 如果您仍然遇到問題，請連絡 SQL 資料庫 或 SQL 受管理執行個體 支援小組。

InvalidCatalogDb

這種錯誤訊息看起來像這樣：「無效的物件名稱 」catalog.catalog_properties。在此情況下，您已有名為 SSISDB 但不是由 SSIS IR 所建立的資料庫，或資料庫處於無效狀態，因為上次 SSIS IR 布建時發生錯誤。 您可以使用 SSISDB 名稱卸除現有的資料庫，也可以為 IR 設定新的 SQL 資料庫 或 SQL 受管理執行個體。

自訂安裝問題

自訂設定所提供的介面可讓您自行新增在佈建或重新設定 SSIS IR 期間的設定步驟。 如需詳細資訊，請參閱 自定義 Azure-SSIS Integration Runtime 的設定。

請確定您的容器只包含必要的自訂設定檔案；容器中的所有檔案都會下載到 SSIS IR 背景工作角色節點。 建議您在本機電腦上測試自訂設定指令碼，先修正任何指令碼執行問題，再於 SSIS IR 中執行指令碼。

SSIS IR 會定期更新，因此系統會在 IR 正在執行時檢查自訂設定指令碼容器。 此更新作業需要存取容器才能下載自訂設定指令碼並重新安裝。 此程序也會檢查容器是否可供存取，以及 main.cmd 檔案是否存在。

針對牽涉到自定義設定的任何錯誤，您會看到 CustomSetupScriptFailure 錯誤碼，其子程式代碼如 CustomSetupScriptBlobContainerInaccessible 或 CustomSetupScriptNotFound。

CustomSetupScriptBlobContainerInaccessible

此錯誤表示 SSIS IR 無法存取 Azure Blob 容器以取得自訂設定。 請確定容器的 SAS URI 可供連線且未過期。

如果 IR 正在執行，請使用新的自訂設定容器 SAS URI 重新設定 IR，然後重新啟動 IR。

CustomSetupScriptNotFound

此錯誤表示 SSIS IR 無法在 Blob 容器中找到自訂設定指令碼 (main.cmd)。 請確定 main.cmd 存在於容器中，這是自訂設定安裝的進入點。

CustomSetupScriptExecutionFailure

此錯誤表示自訂設定指令碼 (main.cmd) 執行失敗。 請先在本機電腦上嘗試該指令碼，或檢查 Blob 容器上的自訂設定執行記錄。

CustomSetupScriptTimeout

此錯誤表示自訂設定指令碼執行逾時。 請確定您的文稿可以無訊息執行，而且不需要互動式輸入，並確定您的 Blob 容器只包含必要的自定義安裝程式檔案。 建議您先在本機計算機上測試腳本。 您也應該檢查 Blob 容器中的自訂安裝執行記錄。 自訂設定的最大期限為 45 分鐘後才會逾時，而最長期限包含從容器下載所有檔案並安裝在 SSIS IR 上的時間。 如果您需要較長的期限，請提出支援票證。

CustomSetupScriptLogUploadFailure

此錯誤表示將自訂設定執行記錄上傳至 Blob 容器的嘗試失敗。 發生此問題的原因可能是 SSIS IR 沒有 Blob 容器的寫入許可權，或因為記憶體或網路問題。 如果自定義設定成功，此錯誤不會影響任何 SSIS 函式，但記錄將會遺失。 如果自訂設定失敗並發生其他錯誤，而且記錄未上傳，我們會先回報此錯誤，以便上傳記錄以供分析。 此外，此問題解決之後，我們將回報任何更具體的問題。 如果重試後未解決此問題，請連絡 Azure Data Factory 支援小組。

虛擬網路設定

當您將 SSIS IR 加入 Azure 虛擬網路時，SSIS IR 會使用位於使用者訂用帳戶下的虛擬網路。 如需詳細資訊，請參閱 將 Azure-SSIS Integration Runtime 加入虛擬網路。 成功啟動 SSIS IR 之後，如果您遇到網路連線問題，您可以嘗試使用 診斷連線工具來 自行診斷問題。 發生虛擬網路相關的問題時，您會看到下列其中一個錯誤。

InvalidVnetConfiguration

此錯誤可能會因為各種原因而發生。 若要進行疑難排解，請參閱禁止、InvalidPropertyValue 和 MisconfiguredDnsServerOrNsgSettings 等節。

禁止

這類錯誤可能類似於：「目前帳戶未啟用 SubnetId。 Microsoft.Batch 資源提供者未在 VNet 的相同訂用帳戶下註冊。

這些詳細資料表示 Azure Batch 無法存取您的虛擬網路。 請將 Microsoft.Batch 資源提供者註冊到與虛擬網路相同的訂用帳戶下。

InvalidPropertyValue

這類錯誤可能會像下列其中之一：

  • 「指定的 VNet 不存在，或 Batch 服務無法存取它。」
  • 「指定的子網 xxx 不存在。」

這些錯誤表示虛擬網路不存在、Azure Batch 服務無法存取該虛擬網路，或提供的子網路不存在。 請確定虛擬網路和子網路存在，而且 Azure Batch 可以存取兩者。

MisconfiguredDnsServerOrNsgSettings

這類錯誤訊息可能如下所示：「無法在 VNet 中布建 Integration Runtime。 如果已設定 DNS 伺服器或 NSG 設定，請確定 DNS 伺服器可供存取，且 NSG 已正確設定。」

在此情況下，您可能會有 DNS 伺服器或 NSG 設定的自訂設定，但這會導致系統無法解析或存取 SSIS IR 所需的 Azure 伺服器名稱。 如需詳細資訊，請參閱 SSIS IR 虛擬網路設定。 如果您仍然遇到問題，請連絡 Azure Data Factory 支援小組。

VNetResourceGroupLockedDuringUpgrade

SSIS IR 會定期自動更新。 升級期間會建立新的 Azure Batch 集區，並刪除舊的 Azure Batch 集區。 此外，系統還會刪除舊集區的虛擬網路相關資源，並在您的訂用帳戶下建立新的虛擬網路相關資源。 此錯誤表示在刪除舊集區的虛擬網路相關資源時失敗，原因是訂用帳戶或資源群組層級有刪除鎖定。 因為刪除鎖定是由客戶控制和設定的，所以在這種情況下，其必須移除刪除鎖定。

VNetResourceGroupLockedDuringStart

如果 SSIS IR 佈建失敗，則系統會刪除所有已建立的資源。 不過，如果訂用帳戶或資源群組層級有資源刪除鎖定，則系統無法如預期地刪除虛擬網路資源。 若要修正此錯誤，請移除刪除鎖定，然後重新啟動 IR。

VNetResourceGroupLockedDuringStop/VNetDeleteLock

當您停止 SSIS IR 時，系統會刪除與虛擬網路相關的所有資源。 但如果訂用帳戶或資源群組層級有資源刪除鎖定，則刪除作業會失敗。 在此情況下，刪除鎖定同樣是由客戶控制和設定的。 因此，其必須移除刪除鎖定，然後再次停止 SSIS IR。

NodeUnavailable

當 IR 正在執行時會發生此錯誤，這表示 IR 已變得狀況不良。 此錯誤一律是由 DNS 伺服器或 NSG 組態中的變更所造成，而 NSG 組態會封鎖 SSIS IR 連線到必要的服務。 由於 DNS 伺服器和 NSG 的設定是由客戶所控制，因此客戶必須修正其端上的封鎖問題。 如需詳細資訊，請參閱 SSIS IR 虛擬網路設定。 如果您仍然遇到問題，請連絡 Azure Data Factory 支援小組。

靜態公用IP位址組態

當您將 Azure-SSIS IR 加入 Azure 虛擬網絡 時，您也可以攜帶自己的 IR 靜態公用 IP 位址，讓 IR 可以存取限制特定 IP 位址存取的數據源。 如需詳細資訊，請參閱 將 Azure-SSIS Integration Runtime 加入虛擬網路。

除了上述虛擬網路問題，您也可以遇到靜態公用IP位址相關問題。 請檢查下列錯誤以取得協助。

InvalidPublicIPSpecified

當您啟動 Azure-SSIS IR 時，可能會因為各種原因而發生此錯誤：

錯誤訊息 解決方案
提供的靜態公用IP位址已使用，請為您的 Azure-SSIS Integration Runtime 提供兩個未使用的IP位址。 您應該選取兩個未使用的靜態公用IP位址，或移除指定公用IP位址的目前參考，然後重新啟動 Azure-SSIS IR。
提供的靜態公用IP位址沒有 DNS 名稱，請為您的 Azure-SSIS Integration Runtime 提供其中兩個 DNS 名稱。 您可以在 Azure 入口網站 中設定公用IP位址的 DNS 名稱，如下圖所示。 特定步驟如下：（1） 開啟 Azure 入口網站 並移至此公用IP地址的資源頁面：（2） 選取 [組態] 區段並設定 DNS 名稱，然後按下 [儲存] 按鈕：（3） 重新啟動您的 Azure-SSIS IR。
Azure-SSIS Integration Runtime 所提供的 VNet 和靜態公用 IP 位址必須位於相同的位置。 根據 Azure 網路的需求，靜態公用 IP 位址和虛擬網路應位於相同的位置和訂用帳戶中。 請提供兩個有效的靜態公用IP位址，然後重新啟動 Azure-SSIS IR。
提供的靜態公用IP位址是基本IP位址，請為您的 Azure-SSIS Integration Runtime 提供兩個標準 IP 位址。 如需說明，請參閱公用IP位址的SKU。

Azure-SSIS IR

PublicIPResourceGroupLockedDuringStart

如果 Azure-SSIS IR 布建失敗，則會刪除所有已建立的資源。 不過，如果訂用帳戶或資源群組有資源刪除鎖定（其中包含靜態公用IP位址）層級，網路資源就不會如預期般刪除。 若要修正錯誤，請移除刪除鎖定並重新啟動 IR。

PublicIPResourceGroupLockedDuringStop

當您停止 Azure-SSIS IR 時，將會刪除在包含公用 IP 位址的資源群組中建立的所有網路資源。 但是，如果訂用帳戶或資源群組有資源刪除鎖定（包含靜態公用IP位址）層級，則刪除可能會失敗。 拿掉刪除鎖定並重新啟動 IR。

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR 會定期自動更新。 升級期間會建立新的 IR 節點，而且將會刪除舊的節點。 此外，會刪除舊節點的已建立網路資源（例如負載平衡器和網路安全組），並在您的訂用帳戶下建立新的網路資源。 此錯誤表示刪除舊節點的網路資源失敗，因為訂用帳戶或資源群組的刪除鎖定（其中包含靜態公用IP位址）層級。 移除刪除鎖定，以便我們可以清除舊的節點，並釋放舊節點的靜態公用IP位址。 否則無法釋放靜態公用IP位址，我們無法進一步升級IR。

PublicIPNotUsableDuringUpgrade

當您想要攜帶自己的靜態公用IP位址時，應該提供兩個公用IP位址。 其中一個將用來立即建立 IR 節點，另一個將在 IR 升級期間使用。 當其他公用IP位址在升級期間無法使用時，就會發生此錯誤。 如需可能的原因，請參閱 InvalidPublicIPSpecified。

資源管理

資源標籤未更新

您可以將標籤套用至 Azure 資源，以邏輯方式將它們組織成分類法。 當 SSIS IR 正在執行時，SSIS IR 父數據處理站標籤的變更在重新啟動 SSIS IR 之前將不會生效。