Aggiornamento automatico e scadenza del runtime di integrazione self-hosted

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Questo articolo descrive come consentire l'aggiornamento automatico del runtime di integrazione self-hosted alla versione più recente e il modo in cui Azure Data Factory (ADF) gestisce le versioni del runtime di integrazione self-hosted.

Come controllare la versione del runtime di integrazione self-hosted

È possibile controllare la versione nel client di runtime di integrazione self-hosted o nel portale di Azure Data Factory:

Aggiornamento automatico del runtime di integrazione self-hosted

In genere, quando si installa un runtime di integrazione self-hosted nel computer locale o in una macchina virtuale di Azure, sono disponibili due opzioni per gestire la versione del runtime di integrazione self-hosted: aggiornamento automatico o manutenzione manuale. In genere, ADF rilascia due nuove versioni del runtime di integrazione self-hosted ogni mese, che include nuove funzionalità rilasciate, bug risolti e miglioramenti. È quindi consigliabile aggiornare gli utenti alla versione più recente.

Il modo più pratico consiste nell'abilitare l'aggiornamento automatico quando si crea o si modifica il runtime di integrazione self-hosted. Il runtime di integrazione self-hosted viene aggiornato automaticamente alla versione più recente. È anche possibile pianificare l'aggiornamento nella fascia oraria più adatta desiderata.

È possibile controllare l'ultimo aggiornamento datetime nel client del runtime di integrazione self-hosted.

È possibile usare questo comando di PowerShell per ottenere la versione di aggiornamento automatico.

Versione di aggiornamento automatico e versione più recente

Per garantire la stabilità del runtime di integrazione self-hosted, anche se vengono rilasciate due versioni, viene eseguito il push di una sola versione ogni mese. A volte si scopre quindi che la versione di aggiornamento automatico è la versione precedente dell'ultima versione effettiva. Se si vuole ottenere la versione più recente, è possibile accedere all'area download e farlo manualmente. Inoltre, l'aggiornamento automatico a una nuova versione viene gestito internamente. Non è possibile modificarlo.

La pagina di aggiornamento automatico del runtime di integrazione self-hosted nel portale di Azure Data Factory mostra la versione più recente se la versione corrente è precedente. Quando il runtime di integrazione self-hosted è online, questa versione è di aggiornamento automatico e aggiorna automaticamente il runtime di integrazione self-hosted nell'ora pianificata. Ma se il runtime di integrazione self-hosted è offline, la pagina mostra solo la versione più recente.

Se hai più nodi e per qualche motivo alcuni di essi non vengono aggiornati automaticamente correttamente. Quindi, questi nodi tornano alla versione, che era la stessa in tutti i nodi prima dell'aggiornamento automatico.

Notifica di scadenza del runtime di integrazione self-hosted

Se si vuole controllare manualmente la versione del runtime di integrazione self-hosted, è possibile disabilitare l'impostazione di aggiornamento automatico e installarla manualmente. Ogni versione del runtime di integrazione self-hosted scade in un anno. Il messaggio di scadenza viene visualizzato nel portale di Azure Data Factory e nel client del runtime di integrazione self-hosted 90 giorni prima della scadenza.

Quando si riceve la notifica scaduta, è possibile usare il comando di PowerShell seguente per trovare tutto il runtime di integrazione self-hosted scaduto e in scadenza nell'ambiente. È quindi possibile aggiornarli di conseguenza.

$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

Contenuto correlato

• Vedere Concetti relativi al runtime di integrazione in Azure Data Factory.
• Informazioni su come creare un runtime di integrazione self-hosted nel portale di Azure.