Aggiornamento automatico e scadenza del runtime di integrazione self-hosted
SI APPLICA A: 
Azure Data Factory Azure Synapse Analytics
Suggerimento
Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!
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 una nuova versione 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.
Nota
Se sono presenti più nodi del runtime di integrazione self-hosted, non si verifica alcun tempo di inattività durante l'aggiornamento automatico. L'aggiornamento automatico avviene prima in un nodo mentre altri lavorano sulle attività. Al termine dell'aggiornamento, il primo nodo assumerà le attività rimaste quando altri nodi vengono aggiornati. Se si dispone di un solo runtime di integrazione self-hosted, si verifica un tempo di inattività durante l'aggiornamento automatico.
Versione di aggiornamento automatico e versione più recente
Per garantire la stabilità del runtime di integrazione self-hosted, viene rilasciata una nuova versione ogni mese ed è stato eseguito il push di un aggiornamento automatico ogni tre mesi, usando una versione stabile dei tre mesi precedenti. È quindi possibile che la versione aggiornata automaticamente sia 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.
Il portale non offre la selezione della data. Ciò significa che è possibile selezionare solo l'ora, mentre la data è determinata dal sistema back-end. In genere, la data verrà impostata per alcuni giorni dopo che il runtime di integrazione self-hosted riceve la notifica di aggiornamento automatico, dando ai clienti tempo sufficiente per effettuare la selezione.
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.
Avviso
Se il runtime di integrazione self-hosted diventa scaduto, visualizzerà uno stato offline e non funzionerà più correttamente.
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