Partilhar via


Atualizar um gateway de dados no local

Lançamos uma atualização todos os meses para gateways de dados locais. Cada uma dessas atualizações inclui novos recursos, juntamente com o Mashup Engine mais recente.

Nota

Atualmente, a Microsoft oferece suporte ativo apenas às últimas seis versões do gateway de dados local. Lançamos uma nova atualização para gateways de dados todos os meses.

Recomendamos que você atualize os membros do gateway um após o outro em tempo hábil. Esse processo reduz falhas esporádicas, pois uma consulta pode ser bem-sucedida em um membro do gateway, mas não no outro, com base na disparidade de recursos em diferentes versões.

Use as seguintes etapas ao atualizar um cluster de gateway com dois ou mais membros:

  1. Desative um membro do gateway.
  2. Aguarde a conclusão dos trabalhos em curso. Um período de espera de 30 minutos é suficiente para a maioria das cargas de trabalho. No entanto, os clusters que executam frequentemente trabalhos críticos de longa duração podem exigir mais tempo para que as solicitações sejam concluídas.
  3. Atualize o membro do gateway.
  4. Habilite o membro do gateway atualizado.
  5. Repita as etapas 1 a 4 até que todos os membros do gateway sejam atualizados.

A desativação de um gateway garante que o balanceador de carga não tente executar consultas no membro que você está atualizando, reduzindo atrasos e falhas.

Nota

A permissão de administrador do gateway é necessária para a atualização do gateway.

Atualizar um gateway

Para atualizar um gateway:

  1. Baixe o gateway de modo padrão ou o gateway de modo pessoal mais recente e execute o programa de instalação. Se a versão que está a tentar instalar não for mais recente do que a versão já instalada, receberá uma das seguintes mensagens de erro. Para rever as atualizações recentes, consulte as atualizações mensais suportadas atualmente.

    A captura de tela da versão de atualização é a mesma que a mensagem da versão instalada.

    A captura de tela da versão de atualização é mais antiga do que a mensagem da versão instalada.

  2. Se instalar uma versão mais recente, ser-lhe-á pedido para atualizar. Selecione Atualizar para iniciar a atualização.

    Captura de ecrã da janela Preparando-se para atualizar.

  3. Após a conclusão da instalação, selecione Entrar.

    Captura de ecrã da janela de configuração do gateway onde inicia sessão.

A atualização do gateway agora está concluída.

Captura de tela do aplicativo de gateway após a conclusão da atualização do gateway.

Atualize gateways a partir da UI (pré-visualização)

Você pode acionar a atualização na interface do usuário quando uma versão mais recente estiver disponível:

  1. Abra a seção Gerenciar Gateways no portal Fabric ou Power BI.

  2. Ativa a flag de funcionalidade ManualUpdateGatewayClusterWithVersionSelection e desativa a flag de funcionalidade ManualUpdateGatewayCluster.

    Captura de ecrã do sinalizador de atualização manual do gateway.

Nota

O sinalizador de funcionalidade ManualUpdateGatewayCluster será removido muito em breve.

  1. Selecione a guia Gateways de dados locais.

  2. Selecione o gateway que deseja atualizar.

  3. Se uma nova versão estiver disponível, um indicador de atualização será exibido.

    Captura de ecrã da atualização manual do gateway da interface de utilizador.

  4. Selecione Atualizar.

  5. Atualize o status do gateway após a conclusão da instalação.

Nota

Você precisa primeiro instalar ou atualizar o gateway para a versão base de novembro de 2025 (ou posterior).

Nota

É necessário um mínimo de 10 GB de espaço disponível no disco rígido para executar atualizações de gateway.

Atualização programática (pré-visualização)

Juntamente com o controle da interface do usuário, os gatilhos programáticos permitem fluxos de trabalho de atualização automatizados ou em escala. Você pode executar o comando Update-DataGatewayClusterMember PowerShell para atualizar seus gateways para a versão mais recente.

Update-DataGatewayClusterMember -GatewayClusterId <Guid> [-MemberGatewayId <Guid>] [-CheckStatus]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

Nota

Você precisa primeiro instalar ou atualizar o gateway para a versão base de novembro de 2025 (ou posterior).