自我裝載整合執行階段自動更新及過期通知

適用於：Azure Data Factory Azure Synapse Analytics

提示

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

本文說明如何讓自我裝載整合執行階段自動更新至最新版本，以及 Azure Data Factory (ADF) 如何管理自我裝載整合執行階段的版本。

如何檢查自我裝載整合執行階段版本

您可以在自我裝載整合執行階段用戶端或 ADF 入口網站中檢查版本：

自我裝載整合執行階段自動更新

一般而言，當您在本機計算機或 Azure 虛擬機中安裝自我裝載整合運行時間時，有兩個選項可管理自我裝載整合運行時間的版本：自動更新或手動維護。 ADF 通常會每月發行兩個新版本的自我裝載整合執行階段，其中包含新功能發行版本、錯誤修正和增強功能。 因此，我們建議使用者更新至最新版本。

最方便的方式是在建立或編輯自我裝載整合執行階段時啟用自動更新。 自我裝載整合執行階段會自動更新至較新版本。 您也可以視需要，在最適合的時間段安排更新。

您可以在自我裝載整合執行階段用戶端中檢查上次更新日期時間。

您可以使用此 PowerShell 命令來取得自動更新版本。

注意

如果您有多個自我裝載整合執行階段節點，則在自動更新期間不會停機。 自動更新會在其他節點處理工作時，在一個節點上先進行。 當第一個節點完成更新時，當其他節點正在更新時，它會接管剩餘的工作。 如果您只有一個自我裝載整合執行階段，則在自動更新期間會有一些停機時間。

自動更新版本與最新版本

為了確保自我裝載整合執行階段的穩定性，雖然我們發行了兩個版本，但每個月只會發送一個版本。 因此，有時你會發現自動更新的版本是實際最新版本的上一個版本。 如果您想要取得最新版本，可以移至下載中心並手動執行。 此外，自動更新至新的版本是在內部受控的。 您無法變更。

如果目前版本較舊，ADF 入口網站中的自我裝載整合執行階段自動更新頁面會顯示較新版本。 當您的自我裝載整合運行時間在在線時，此版本為自動更新版本，並在排程時間自動更新自我裝載整合運行時間。 但是，如果您的自我裝載整合執行階段為離線狀態，頁面只會顯示最新版本。

如果您有多個節點，但基於某些原因，其中某些節點沒有自動更新成功。 那麼，這些節點會復原到自動更新之前所有節點都相同的版本。

自我裝載整合執行階段到期通知

如果您想要手動控制特定一個版本的自我裝載整合執行階段，您可以停用自動更新的設定，並將其加以手動安裝。 每一個自我裝載整合執行階段版本都會在一年內到期。 到期訊息會顯示在ADF入口網站和自我裝載整合運行時間用戶端 90天前 到期。

警告

如果自我裝載整合運行時間過期，它會顯示離線狀態，且無法再正常運作。

當您收到過期通知時，您可以使用下列 PowerShell 命令，在您的環境中尋找所有已過期和過期的自我裝載整合運行時間。 然後您可以據以升級它們。

$upperVersion = "<expiring version>" # the format is [major].[minor]. For example: 5.25
$subscription = "<subscription id>"
 
az login
az account set --subscription "$subscription"
 
$factories = az datafactory list | ConvertFrom-Json
 
$results = @();
for ($i = 0; $i -lt $factories.Count; $i++) {
    $factory = $factories[$i]
    Write-Progress -Activity "Checking data factory '$($factory.name)'" -PercentComplete $($i * 100.0 / $factories.Count)
    $shirs = az datafactory integration-runtime list --factory-name $factory.name --resource-group $factory.resourceGroup | ConvertFrom-Json | Where-Object {$_.properties.type -eq "SelfHosted"}
    for ($j = 0; $j -lt $shirs.Count; $j++) {
        $shir = $shirs[$j]
        Write-Progress -Activity "Checking data factory '$($factory.name)', checking integration runtime '$($shir.name)'" -PercentComplete $($i * 100.0 / $factories.Count + (100.0 * $j / ($factories.Count * $shirs.Count)))
        $status = az datafactory integration-runtime get-status --factory-name $factory.name --resource-group $factory.resourceGroup --integration-runtime-name $shir.name | ConvertFrom-Json
        $shirVersion = $status.properties.version
        $result = @{
            subscription = $subscription
            resourceGroup = $factory.resourceGroup
            factory = $factory.name
            integrationRuntime = $shir.name
            integrationRuntimeVersion = $shirVersion
            expiring_or_expired = (-not [string]::IsNullOrWhiteSpace($shirVersion) -and ((([Version]$shirVersion) -lt ([Version]"$($upperVersion).0.0")) -or $shirVersion.StartsWith("$($upperVersion).")))
        }
        $result | Format-Table -AutoSize
        $results += [PSCustomObject]$result
    }
}
 
Write-Host "Expiring or expired Self-Hosted Integration Runtime includes: "
$results | Where-Object {$_.expiring_or_expired -eq $true} | Select-Object -Property subscription,resourceGroup,factory,integrationRuntime,integrationRuntimeVersion | Format-Table -AutoSize

相關內容

• 檢閱 Azure Data Factory 中的整合執行階段概念。
• 了解如何在 Azure 入口網站中建立自我裝載整合執行階段。