Automatisch bijwerken en verlopen van zelf-hostende Integration Runtime

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u automatische updates van zelf-hostende Integration Runtime kunt uitvoeren naar de nieuwste versie en hoe Azure Data Factory (ADF) de versies van zelf-hostende Integration Runtime beheert.

Uw zelf-hostende Integration Runtime-versie controleren

U kunt de versie controleren in uw zelf-hostende Integration Runtime-client of in de ADF-portal:

Automatisch bijwerken van zelf-hostende Integration Runtime

Over het algemeen hebt u, wanneer u een zelf-hostende Integration Runtime installeert op uw lokale computer of een virtuele Azure-machine, twee opties om de versie van zelf-hostende Integration Runtime te beheren: automatisch bijwerken of handmatig onderhouden. Normaal gesproken brengt ADF elke maand één nieuwe versie van zelf-hostende Integration Runtime uit, waaronder nieuwe functies die zijn uitgebracht, bugs zijn opgelost en verbeteringen. Daarom raden we gebruikers aan om bij te werken naar de nieuwste versie.

De handigste manier is om automatisch bijwerken in te schakelen wanneer u zelf-hostende Integration Runtime maakt of bewerkt. De zelf-hostende Integration Runtime wordt automatisch bijgewerkt naar een nieuwere versie. U kunt de update ook plannen op de meest geschikte tijdsperiode zoals u wilt.

U kunt de datum/tijd van de laatste update controleren in uw zelf-hostende Integration Runtime-client.

U kunt deze PowerShell-opdracht gebruiken om de autoupdate-versie op te halen.

Notitie

Als u meerdere zelf-hostende Integration Runtime-knooppunten hebt, is er geen downtime tijdens het automatisch bijwerken. De automatische update vindt eerst plaats in het ene knooppunt terwijl anderen aan taken werken. Wanneer het eerste knooppunt de update heeft voltooid, worden de resterende taken overgenomen wanneer andere knooppunten worden bijgewerkt. Als u slechts één zelf-hostende Integration Runtime hebt, heeft deze enige downtime tijdens de automatische update.

AutoUpdate-versie versus nieuwste versie

Om de stabiliteit van zelf-hostende Integration Runtime te garanderen, brengen we elke maand een nieuwe versie uit en pushen we elke drie maanden een automatische update met behulp van een stabiele versie van de voorgaande drie maanden. U kunt dus merken dat de autoupdated-versie de vorige versie is van de werkelijke meest recente versie. Als u de nieuwste versie wilt downloaden, kunt u naar het downloadcentrum gaan en dit handmatig doen. Daarnaast wordt automatisch bijwerken naar een nieuwe versie intern beheerd. Je kunt het niet wijzigen.

Op de zelf-hostende pagina voor automatisch bijwerken van Integration Runtime in de ADF-portal wordt de nieuwere versie weergegeven als de huidige versie oud is. Wanneer uw zelf-hostende Integration Runtime online is, is deze versie automatisch bijgewerkt en wordt uw zelf-hostende Integration Runtime automatisch bijgewerkt op de geplande tijd. Maar als uw zelf-hostende Integration Runtime offline is, wordt alleen de nieuwste versie weergegeven op de pagina.

De portal biedt geen datumselectie. Dit betekent dat u alleen de tijd kunt selecteren, terwijl de datum wordt bepaald door het back-endsysteem. Normaal gesproken wordt de datum een paar dagen nadat de zelf-hostende Integration Runtime de melding voor automatisch bijwerken ontvangt, zodat klanten voldoende tijd hebben om hun selectie te maken.

Als u meerdere knooppunten hebt en om sommige redenen niet automatisch worden bijgewerkt. Vervolgens worden deze knooppunten teruggezet naar de versie, die hetzelfde was op alle knooppunten vóór de autoupdate.

Melding over verlopen van zelf-hostende Integration Runtime

Als u handmatig wilt bepalen welke versie van zelf-hostende Integration Runtime, kunt u de instelling van autoupdate uitschakelen en handmatig installeren. Elke versie van zelf-hostende Integration Runtime verloopt over één jaar. Het verlopende bericht wordt 90 dagen voor verlopen weergegeven in de ADF-portal en zelf-hostende Integration Runtime-client.

Waarschuwing

Als de zelf-hostende Integration Runtime is verlopen, wordt er een offlinestatus weergegeven en werkt deze niet meer goed.

Wanneer u de verlopen melding ontvangt, kunt u de volgende PowerShell-opdracht gebruiken om alle verlopen en verlopende integratieruntime in uw omgeving te vinden. Vervolgens kunt u ze dienovereenkomstig upgraden.

$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

Gerelateerde inhoud

• Bekijk de concepten van integratieruntime in Azure Data Factory.
• Meer informatie over het maken van een zelf-hostende Integration Runtime in Azure Portal.