Benachrichtigung zur automatischen Aktualisierung und zum Ablauf der selbstgehosteten Integration Runtime

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie die selbstgehostete Integration Runtime automatisch auf die neueste Version aktualisiert wird und wie die Versionen der selbstgehosteten Integration Runtime in Azure Data Factory (ADF) verwaltet werden.

Überprüfen der Version Ihrer selbstgehosteten Integration Runtime

Sie können die Version entweder im Client für die selbstgehostete Integration Runtime oder im ADF-Portal überprüfen:

Automatische Aktualisierung der selbstgehosteten Integration Runtime

Wenn Sie eine selbstgehostete Integration Runtime auf Ihrem lokalen Computer oder einem virtuellen Azure-Computer installieren, haben Sie in der Regel zwei Möglichkeiten, die Version der selbstgehosteten Integration Runtime zu verwalten: durch automatische Aktualisierung oder durch manuelle Wartung. Normalerweise werden in ADF monatlich zwei neue Versionen der selbstgehosteten Integration Runtime veröffentlicht, die neue Featurereleases, Fehlerbehebungen und Verbesserungen beinhalten. Daher wird Benutzer*innen empfohlen, auf die neueste Version zu aktualisieren.

Die einfachste Möglichkeit besteht darin, beim Erstellen oder Bearbeiten der selbstgehosteten Integration Runtime die automatische Aktualisierung zu aktivieren. Es wird ein automatisches Update der selbstgehosteten Integration Runtime auf die neuere Version durchgeführt. Sie können das Update auch für den am besten geeigneten Zeitraum planen.

Sie können Datum und Uhrzeit der letzten Aktualisierung auf dem Client der selbstgehosteten Integration Runtime überprüfen.

Sie können diesen PowerShell-Befehl nutzen, um die Version mit automatischem Update zu erhalten.

Hinweis

Wenn Sie über mehrere selbstgehostete Integration Runtime-Knoten verfügen, kommt es während dem automatischen Update nicht zu Ausfallzeiten. Das automatische Update erfolgt zuerst auf einem Knoten, während andere an Aufgaben arbeiten. Wenn der erste Knoten das Update abgeschlossen hat, übernimmt er die übrigen Aufgaben, wenn andere Knoten aktualisiert werden. Wenn Sie nur über eine selbstgehostete Integration Runtime verfügen, kommt es während des automatischen Updates zu Ausfallzeiten.

Version mit automatischem Update im Vergleich zu neuester Version

Obwohl wir jeden Monat zwei Versionen veröffentlichen, wird pro Monat nur eine Version gepusht, um die Stabilität der selbstgehosteten Integration Runtime zu gewährleisten. Gelegentlich werden Sie daher feststellen, dass es sich bei der automatisch aktualisierten Version nicht um die aktuelle, sondern um die vorherige Version handelt. Wenn Sie die neueste Version erhalten möchten, wechseln Sie zum Download Center, und laden Sie sie manuell herunter. Darüber hinaus wird die automatische Aktualisierung auf eine neue Version intern verwaltet. Sie können diese Einstellung nicht ändern.

Die Seite Automatische Aktualisierung der selbstgehosteten Integration Runtime im ADF-Portal zeigt die neuere Version an, wenn die aktuelle Version veraltet ist. Wenn Ihre selbstgehostete Integration Runtime online ist, handelt es sich bei dieser Version um eine Version mit automatischem Update, und Ihre selbstgehostete Integration Runtime wird automatisch zur geplanten Zeit aktualisiert. Wenn Ihre selbstgehostete Integration Runtime jedoch offline ist, wird auf der Seite nur die neueste Version angezeigt.

Wenn Sie über mehrere Knoten verfügen und einige davon aus bestimmten Gründen nicht automatisch aktualisiert werden, wird für diese Knoten ein Rollback auf die Version ausgeführt, die vor dem automatischen Update auf allen Knoten identisch war.

Benachrichtigung zum Ablauf der selbstgehosteten Integration Runtime

Wenn Sie die Version der selbstgehosteten Integration Runtime manuell steuern möchten, können Sie die Einstellung zur automatischen Aktualisierung deaktivieren und die Integration Runtime manuell installieren. Jede Version der selbstgehosteten Integration Runtime läuft nach einem Jahr ab. Die Ablaufnachricht wird im ADF-Portal und auf dem Client der selbstgehosteten Integration Runtime 90 Tage vor dem Ablaufdatum angezeigt.

Warnung

Wenn die selbstgehostete Integration Runtime abgelaufen ist, wird ein Offlinestatus angezeigt, und sie funktioniert nicht mehr ordnungsgemäß.

Wenn Sie die Ablaufbenachrichtigung erhalten, können Sie den nachstehenden PowerShell-Befehl verwenden, um alle abgelaufenen und ablaufenden selbstgehosteten Integration Runtimes in Ihrer Umgebung zu suchen. Anschließend können Sie sie entsprechend aktualisieren.

$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

Zugehöriger Inhalt

• Lesen Sie Integration Runtime-Konzepte in Azure Data Factory.
• Informieren Sie sich über das Erstellen einer selbstgehosteten Integration Runtime im Azure-Portal.