Notificação de expiração e atualização automática do runtime de integração auto-hospedada
APLICA-SE A:
Azure Data Factory Azure Synapse Analytics
Dica
Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange desde movimentação de dados até ciência de dados, análise em tempo real, business intelligence e relatórios. Saiba como iniciar uma avaliação gratuita!
Este artigo descreve como permitir a atualização automática do runtime de integração auto-hospedada para a versão mais recente e como o ADF (Azure Data Factory) gerencia as versões do runtime de integração auto-hospedada.
Como verificar sua versão do runtime de integração auto-hospedado
Você pode verificar a versão em seu cliente de runtime de integração auto-hospedado ou no portal do ADF:
Atualização automática do runtime de integração auto-hospedada
Geralmente, quando você instala um runtime de integração auto-hospedada no computador local ou em uma VM do Azure, você tem duas opções para gerenciar a versão do runtime de integração auto-hospedada: atualizar automaticamente ou fazer manutenção manual. Normalmente, o ADF lança uma nova versão do runtime de integração auto-hospedada todos os meses, o que inclui a nova versão do recurso, correção de bugs ou aprimoramentos. É recomendável que os usuários atualizem par a versão mais recente.
A maneira mais prática é habilitar a atualização automática quando você cria ou edita o runtime de integração auto-hospedada. O runtime de integração auto-hospedada é atualizado automaticamente para a versão mais recente. Você também pode agendar a atualização no horário mais adequado, como desejar.
Você pode verificar o datetime da última atualização no cliente de runtime de integração auto-hospedada.
Você pode usar esse comando PowerShell para obter a versão de atualização automática.
Observação
Se você tiver vários nós de runtime de integração auto-hospedada, não haverá tempo de inatividade durante a atualização automática. A atualização automática ocorre primeiro em um nó, enquanto outras estão trabalhando em tarefas. Quando o primeiro nó concluir a atualização, ele assumirá as tarefas restantes quando outros nós estiverem sendo atualizados. Se você tiver apenas um runtime de integração auto-hospedada, terá um tempo de inatividade durante a atualização automática.
Versão de atualização automática versus versão mais recente
Para garantir a estabilidade do runtime de integração auto-hospedada, lançamos uma nova versão a cada mês e enviamos por push uma atualização automática a cada três meses, usando uma versão estável dos três meses anteriores. Às vezes, você pode descobrir que a versão atualizada automaticamente é a versão anterior da versão atual mais recente. Se você quiser obter a versão mais recente, poderá ir para o centro de download e fazer isso manualmente. Além disso, a atualização automática para uma nova versão é gerenciada internamente. Não é possível alterar isso.
A página Atualização automática do runtime de integração auto-hospedada no portal de ADF (Azure Data Factory) mostra a versão mais recente se a versão atual for anterior. Quando o runtime de integração auto-hospedada estiver online, essa versão será de atualização automática e atualizará automaticamente seu runtime de integração auto-hospedada no horário agendado. Mas se o runtime de integração auto-hospedada estiver offline, a página mostrará apenas a versão mais recente.
O portal não oferece seleção de data. Isso significa que você só pode selecionar a hora, enquanto a data é determinada pelo sistema de back-end. Normalmente, a data será definida por alguns dias após o runtime de integração auto-hospedada receber a notificação de atualização automática, dando aos clientes tempo suficiente para fazer sua seleção.
Se você tiver vários nós e por algum motivo alguns deles não são atualizados automaticamente com êxito. Esses nós então são revertidos para a versão que era a mesma em todos os nós antes da atualização automática.
Notificação de expiração do runtime de integração auto-hospedada
Se você quiser controlar manualmente a versão do runtime de integração auto-hospedada, desabilite a configuração de atualização automática e instale-a manualmente. Cada versão do runtime de integração auto-hospedada expira em um ano. A mensagem de expiração é mostrada no portal do ADF e no cliente do runtime de integração auto-hospedada 90 dias antes da expiração.
Aviso
Se o runtime de integração auto-hospedada expirar, ele exibirá um status offline e não funcionará mais corretamente.
Ao receber a notificação expirada, você pode usar o comando do PowerShell a seguir para encontrar todo o runtime de integração auto-hospedada expirado e expirado em seu ambiente. Em seguida, você pode atualizá-los adequadamente.
$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