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

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 duas novas versões 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.

Versão de atualização automática versus versão mais recente

Para garantir a estabilidade do runtime de integração auto-hospedada, embora sejam lançadas duas versões, o atualizamos automaticamente uma vez por mês. Às vezes, você descobre 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.

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.

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

Conteúdo relacionado

• Revise os conceitos de runtime de integração no Azure Data Factory.
• Saiba como criar um runtime de integração auto-hospedada no portal do Azure.