Atualização automática e notificação de expiração do tempo de execução da integração auto-hospedada

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Este artigo descreve como permitir que o tempo de execução de integração auto-hospedado atualize automaticamente para a versão mais recente e como o Azure Data Factory (ADF) gerencia as versões do tempo de execução de integração auto-hospedado.

Como verificar sua versão de tempo de execução de integração auto-hospedada

Você pode verificar a versão em seu cliente de tempo de execução de integração auto-hospedado ou no portal do ADF:

Atualização automática do tempo de execução da integração auto-hospedada

Geralmente, quando você instala um tempo de execução de integração auto-hospedado em sua máquina local ou uma Máquina Virtual do Azure, você tem duas opções para gerenciar a versão do tempo de execução de integração auto-hospedada: atualização automática ou manutenção manual. Normalmente, o ADF lança uma nova versão do tempo de execução de integração auto-hospedado todos os meses, que inclui novos recursos lançados, bugs corrigidos e aprimoramentos. Portanto, recomendamos que os usuários atualizem para a versão mais recente.

A maneira mais conveniente é habilitar a atualização automática quando você cria ou edita o tempo de execução de integração auto-hospedado. O tempo de execução de integração auto-hospedado é atualizado automaticamente para a versão mais recente. Você também pode agendar a atualização no intervalo de tempo mais adequado, como desejar.

Você pode verificar a data/hora da última atualização em seu cliente de tempo de execução de integração auto-hospedado.

Você pode usar esse comando do PowerShell para obter a versão de atualização automática.

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

Para garantir a estabilidade do tempo de execução da integração auto-hospedada, lançamos uma nova versão a cada mês e enviamos uma atualização automática a cada três meses, usando uma versão estável dos três meses anteriores. Portanto, você pode achar que a versão atualizada automaticamente é a versão anterior da versão mais recente real. Se você quiser obter a versão mais recente, você pode ir para o centro de download e fazê-lo manualmente. Além disso, a atualização automática para uma nova versão é gerenciada internamente. Não é possível alterá-lo.

A página de atualização automática do tempo de execução de integração auto-hospedado no portal do ADF mostra a versão mais recente se a versão atual for antiga. Quando seu tempo de execução de integração auto-hospedado está online, esta versão é a versão de atualização automática e atualiza automaticamente seu tempo de execução de integração auto-hospedado no tempo agendado. Mas se o tempo de execução de integração auto-hospedado 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 depois que o tempo de execução de integração auto-hospedado 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 alguns motivos que alguns deles não são atualizados automaticamente com êxito. Em seguida, esses nós revertem 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 tempo de execução da integração auto-hospedada

Se quiser controlar manualmente qual versão do tempo de execução de integração auto-hospedada, você pode desativar a configuração de atualização automática e instalá-la manualmente. Cada versão do tempo de execução de integração auto-hospedado expira em um ano. A mensagem de expiração é mostrada no portal do ADF e no cliente de tempo de execução de integração auto-hospedado 90 dias antes de expirar.

Ao receber a notificação expirada, você pode usar o seguinte comando do PowerShell para localizar todo o tempo de execução de integração auto-hospedado expirado e expirando em seu ambiente. Então você pode atualizá-los de acordo.

$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údos relacionados

• Analise os conceitos de tempo de execução de integração no Azure Data Factory.
• Saiba como criar um tempo de execução de integração auto-hospedado no portal do Azure.