Gateway de dados do Power BI: configure e diagnostique

Gateway de dados do Power BI conecta o serviço a fontes locais ou redes privadas que não estão acessíveis diretamente pela nuvem. Uma instalação funcional depende de rede, versão, credenciais e mapeamento correto. Este roteiro ajuda a operar a conexão e localizar a camada responsável por uma falha.

Quando o gateway de dados do Power BI é necessário

O serviço precisa de gateway quando deve alcançar uma fonte em uma rede local ou ambiente privado sem acesso direto. Fontes já disponíveis em nuvem podem ter um conector próprio e dispensar o gateway. Identifique localização, método de autenticação, modo de consulta e política de segurança antes de instalar.

Exemplo hipotético: o relatório de expedição consulta um banco no centro de distribuição. O serviço na nuvem não enxerga esse endereço privado, então o gateway cria uma ponte autorizada. Se a fonte mudar para serviço gerenciado acessível na nuvem, revise se a ponte continua necessária.

Escolha o modo e o responsável pela operação

A documentação distingue tipos de gateway e cenários de uso, como modo padrão e pessoal. O modo adequado depende de compartilhamento, administração central e recursos exigidos. Prefira uma instalação administrada quando a atualização precisa continuar funcionando independentemente de um computador individual.

Defina titular técnico e substituto, conta do serviço, janela de atualização e caminho de escalonamento. Não deixe a recuperação depender de uma única pessoa. O grupo que gerencia o gateway deve conhecer os conjuntos associados e os responsáveis pelas fontes de dados.

Planeje rede e instalação com segurança

O gateway estabelece comunicação de saída para os serviços necessários; a arquitetura documentada não exige abrir uma porta de entrada irrestrita para a internet. Confirme domínios, proxy, firewall e requisitos de rede com a equipe de infraestrutura conforme a documentação vigente.

Instale em máquina apropriada, estável e sob manutenção. Evite notebooks pessoais e hosts sujeitos a desligamento frequente. A instalação deve ter versão suportada e acesso controlado. Antes de entrar em produção, teste conectividade com a fonte usando o mesmo contexto de rede do gateway.

Cadastre a fonte e associe o conjunto

O nome do servidor e do banco cadastrados no serviço precisam corresponder aos valores que o modelo usa. Uma diferença sutil, como alias, instância, domínio ou porta, pode impedir o mapeamento. Compare a configuração de origem no modelo com a fonte definida no gateway.

Insira credenciais pelo fluxo autorizado e limite permissões ao necessário. Não grave senha em documento, script compartilhado ou anotação de projeto. Associe o conjunto à fonte correta e execute teste de conexão; depois confirme uma atualização manual antes de restaurar a agenda.

Diagnostique falhas por camada

Comece pelo histórico de atualização: anote horário, mensagem completa, duração e conjunto afetado. Depois verifique se o gateway aparece online, se a máquina acessa a fonte, se credenciais estão válidas e se servidor e banco coincidem. Essa sequência evita trocar uma senha sem evidência.

Se vários conjuntos falham juntos, procure mudança de rede, serviço ou certificado. Se apenas um falha, revise seu mapeamento, consulta e permissões. Atualize o gateway conforme a orientação oficial e consulte os logs locais quando a mensagem do serviço não indicar a causa.

Distinga credencial, rede e consulta

Falha de autenticação aponta para usuário, senha, domínio ou método de autenticação; falha de conexão sugere rede, host ou serviço fora do ar. Uma consulta que excede limites pode indicar volume ou complexidade, mesmo com conexão válida. Reproduza a consulta da fonte e compare o horário do erro.

Registre os testes e altere uma variável por vez. Se a fonte aceita autenticação integrada, verifique qual identidade o gateway utiliza. Uma consulta que funciona no computador do desenvolvedor não prova que funciona sob a conta de serviço da instalação.

Evite interrupções e credenciais órfãs

Documente dependências, renovações de senha, certificados e atualizações. Programe manutenção em janela conhecida e informe as áreas dependentes. Para alta disponibilidade, avalie opções suportadas e requisitos de instalação em cluster na documentação, em vez de copiar configurações sem validar.

Revise quem pode administrar fontes e compartilhar o gateway. Remova acessos obsoletos e mantenha o inventário sincronizado com as equipes de dados. A função de workspace não substitui as permissões de gateway nem as permissões da fonte; as camadas precisam ser auditadas separadamente.

Observe atualizações e comunique impacto

Não acompanhe apenas a mensagem de sucesso. Registre a última atualização válida, duração e janela prevista. Se o painel é usado em operação, defina quando um atraso deixa de ser aceitável e quem avisa os usuários. O histórico ajuda a distinguir incidente pontual de degradação repetida.

Exemplo hipotético: uma atualização de estoque falha depois de uma mudança de senha. O operador registra o impacto, corrige a credencial no cadastro autorizado, testa a conexão e executa atualização controlada. Só então confirma recuperação e ajusta a escala prevista, se necessário.

Faça a mudança passar por controle

Atualização de gateway, mudança de host e rotação de credenciais podem afetar vários relatórios. Avalie o escopo, teste uma conexão representativa e planeje retorno. A equipe responsável por dados deve confirmar que os conjuntos continuam atualizando após a mudança.

Use o pipeline de implantação para controlar alterações e o guia de funções de workspace para revisar acesso. O modelo de Logística ilustra um painel operacional; conecte-o somente a fontes autorizadas.

Use um roteiro de incidente reproduzível

Um runbook curto deve indicar onde consultar o histórico, como identificar o nó do gateway, qual fonte foi afetada e quem autoriza credenciais. Inclua comandos ou telas aprovados pela infraestrutura, sem registrar segredos. Registre o horário do incidente e associe o evento a mudanças recentes de rede ou sistema.

Depois da recuperação, execute uma atualização de teste, confira o conteúdo e registre a causa. Se a falha se repetir, encaminhe evidências ao time responsável pela origem, em vez de aumentar tentativas sem critério. Esse procedimento reduz o tempo de diagnóstico e protege a confiança no painel.

Quando o serviço mostra “gateway offline”, confira primeiro energia, rede, conta de serviço e estado da aplicação. Se apenas uma origem falha, examine o mapeamento e a autenticação antes de reiniciar a máquina. Uma coleta disciplinada evita interrupções desnecessárias e preserva evidências úteis para a equipe que mantém a fonte.

Fontes técnicas: visão geral do gateway local e solução de problemas, Microsoft Learn. Consultado em 25/10/2026.