セルフホステッド統合ランタイムの自動更新と期限切れ通知

適用対象: Azure Data Factory Azure Synapse Analytics

この記事では、セルフホステッド統合ランタイムを最新バージョンに自動更新する方法と、Azure Data Factory (ADF) がセルフホステッド統合ランタイムのバージョンを管理する方法について説明します。

セルフホステッド統合ランタイムのバージョンを確認する方法

バージョンは、セルフホステッド統合ランタイム クライアントまたは ADF ポータルで確認できます。

セルフホステッド統合ランタイムの自動更新

一般に、ローカル コンピューターまたは Azure 仮想マシンにセルフホステッド統合ランタイムをインストールする場合、セルフホステッド統合ランタイムのバージョンを管理するためのオプションには自動更新と手動での管理の 2 つがあります。 通常、ADF は、1 つの新しいバージョンのセルフホステッド統合ランタイムを毎月リリースします。これには、リリースされた新機能、修正されたバグ、拡張機能が含まれます。 そのため、ユーザーは最新バージョンに更新することをお勧めします。

最も便利な方法は、セルフホステッド統合ランタイムを作成または編集するときに自動更新を有効にすることです。 セルフホステッド統合ランタイムは、自動的に新しいバージョンに更新されます。 また、希望する最も適した時間スロットに更新をスケジュールすることもできます。

セルフホステッド統合ランタイム クライアントで最終更新の日付と時刻を確認できます。

この PowerShell コマンドを使用して、自動更新バージョンを取得できます。

自動更新バージョンと最新バージョン

セルフホステッド統合ランタイムの安定性を確保するために、新しいバージョンが毎月リリースされ、、前の 3 か月の安定したバージョンを使用して自動更新が 3 か月ごとにプッシュされます。 そのため、自動更新されたバージョンが実際の最新バージョンの前のバージョンである場合があります。 最新バージョンを取得する場合は、ダウンロード センターに移動して、手動で取得できます。 また、新しいバージョンへの自動更新は内部で管理されます。 これは変更できません。

ADF ポータルのセルフホステッド統合ランタイムの [自動更新] ページには、現在のバージョンが古い場合、新しいバージョンが表示されます。 セルフホステッド統合ランタイムがオンラインの場合、このバージョンは自動更新バージョンであり、スケジュールされた時間にセルフホステッド統合ランタイムを自動的に更新します。 ただし、セルフホステッド統合ランタイムがオフラインの場合、ページには最新版のみが表示されます。

ポータルでは、日付の選択は提供されません。 つまり、時刻のみを選択でき、日付はバックエンド システムによって決定されますが、 通常、この日付は、セルフホステッド統合ランタイムが自動更新通知を受け取ってから数日間設定され、顧客には選択に十分な時間が与えられます。

複数のノードがあり、何らかの理由でそのうちのいくつかが正常に自動更新されなかった場合、 これらのノードは、自動更新前のすべてのノードで同一だったバージョンにロールバックされます。

セルフホステッド統合ランタイムの期限切れ通知

セルフホステッド統合ランタイムのバージョンを手動で制御する場合は、自動更新の設定を無効にして手動でインストールすることができます。 セルフホステッド統合ランタイムの各バージョンは、1 年で期限切れになります。 有効期限切れのメッセージは、有効期限の 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

関連するコンテンツ

• Azure Data Factory の統合ランタイムの概念を確認します。
• Azure portal でセルフホステッド統合ランタイムを作成する方法を調べます。