Aggiornamento automatico e notifica di 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 completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .
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.
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, anche se vengono rilasciate due versioni, verrà eseguito il push di una sola versione ogni mese. A volte si scopre quindi che la versione aggiornata automaticamente è la versione precedente dell'ultima versione effettiva. Se vuoi ottenere la versione più recente, puoi 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 è l'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 sono presenti più nodi e per alcuni motivi alcuni di essi non vengono aggiornati automaticamente correttamente. Eseguire quindi il rollback di questi nodi 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 dell'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 scaduto 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