共用方式為


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

適用於:Azure Data Factory Azure Synapse Analytics

提示

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

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

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

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

此螢幕擷取畫面顯示自我裝載整合執行階段用戶端中的版本。

此螢幕擷取畫面顯示 Azure Data Factory 入口網站中的版本。

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

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

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

啟用自動更新

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

檢查更新時間的螢幕擷取畫面

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

注意

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

自動更新版本與最新版本

為了確保自我裝載整合運行時間的穩定性,我們每月發行新版本,並使用前三個月的穩定版本,每隔三個月推送一次自動更新。 因此,您可能會發現自動更新的版本是實際最新版本的舊版。 如果您想要取得最新版本,可以移至下載中心並手動執行。 此外,自動更新至新的版本是在內部受控的。 您無法變更。

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

入口網站不提供日期選取專案。 這表示您只能選取時間,而日期是由後端系統決定。 一般而言,在自我裝載整合運行時間收到自動更新通知之後,日期會設定幾天,讓客戶有足夠的時間進行選擇。

顯示UI中自動更新日期的螢幕快照。

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

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

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

警告

自我裝載整合執行階段過期後,將會顯示為離線狀態,且無法再正常運作。

收到過期通知時,您可以使用下列 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