Como usar gateway de dados no Power BI: passo a passo

O relatório atualiza na sua máquina mas quebra no Power BI Service#

Esse é o roteiro clássico. Você conecta o Power BI Desktop a um SQL Server que roda dentro da rede da empresa, monta o modelo, publica no Service, agenda a atualização e, na manhã seguinte, recebe o e-mail de falha: "não foi possível conectar à fonte de dados". O dado está lá, a credencial está certa, o relatório funciona perfeitamente na sua máquina. O que falta é justamente o gateway de dados Power BI, a peça que permite ao serviço na nuvem alcançar uma fonte que vive atrás do firewall da sua empresa.

O gateway não é opcional nem um detalhe de configuração. Para qualquer fonte que não seja pública ou já esteja na nuvem com autenticação direta, ele é a ponte obrigatória entre o Power BI Service e os seus bancos, planilhas em rede, ERPs e APIs internas. Este guia mostra o que ele faz, qual versão escolher, como instalar e configurar passo a passo, os erros que mais aparecem no dia a dia e as boas práticas que separam um ambiente estável de um que vive dando falha de refresh.

O gateway existe porque a nuvem não enxerga a sua rede interna#

Quando você publica um relatório, o modelo e os dados importados sobem para o Power BI Service. Mas a atualização agendada precisa voltar até a fonte original para buscar dados novos. Se essa fonte está na internet pública (um banco no Azure, uma API aberta, um dataset online), o Service chega nela sozinho. Se a fonte está dentro da sua rede corporativa, o Service não tem rota até ela, e não deveria ter, por segurança.

O gateway resolve isso invertendo a direção da conexão. Você instala um software leve em um servidor dentro da rede, e é esse software que faz uma conexão de saída, sempre iniciada de dentro para fora, até o Azure Service Bus. O Power BI Service coloca as solicitações de atualização nessa fila, o gateway as busca, executa a consulta contra a fonte interna, criptografa o resultado e devolve. Nenhuma porta de entrada precisa ser aberta no firewall. Esse desenho é o que torna o gateway seguro e o que explica por que ele precisa de conectividade de saída estável.

Vale entender o que trafega. O gateway não guarda cópia dos seus dados. Ele transporta consultas e resultados, com as credenciais da fonte armazenadas de forma criptografada e uma chave de recuperação que só você tem. Se governança e proteção de dado é sensível no seu contexto, vale ler nosso material sobre governança de dados no Power BI e LGPD em paralelo a este.

Existem dois tipos de gateway, e escolher errado custa caro depois#

Antes de instalar qualquer coisa, decida qual gateway você precisa. A Microsoft oferece dois modos, e a diferença é estrutural.

Característica	Gateway padrão (standard mode)	Gateway pessoal (personal mode)
Uso pretendido	Corporativo, compartilhado	Individual, testes rápidos
Vários usuários e relatórios	Sim, centralizado	Não, amarrado a uma conta
Serviços suportados	Power BI, Power Apps, Power Automate, Azure Analysis Services	Apenas Power BI
Instalação recomendada	Servidor dedicado sempre ligado	Máquina do próprio usuário
Administração de fontes	Centralizada, com controle de acesso	Não há, cada um cuida do seu
Escala	Alta, suporta clustering	Baixa

Na prática, o gateway pessoal serve para um analista testar uma atualização sozinho ou para uma prova de conceito. Ele roda na máquina do usuário, o que significa que, se o notebook desligar ou a pessoa sair de férias, a atualização morre. Para qualquer ambiente que mais de uma pessoa vá depender, a resposta é o gateway padrão, instalado em um servidor que fica ligado e que a área de TI administra. Começar no pessoal e migrar depois dá retrabalho, então decida certo na largada.

Instalar o gateway padrão leva menos de quinze minutos#

O download vem do site oficial da Microsoft (procure por "on-premises data gateway"). Instale sempre em um servidor que fique ligado, de preferência dedicado ou com folga de recurso, e não na máquina de trabalho de alguém. O passo a passo é direto.

1. Baixe o instalador e execute no servidor escolhido. Aceite os termos e mantenha o modo padrão, não o pessoal.
2. Entre com a conta organizacional que vai administrar o gateway. Essa conta precisa ter permissão no Power BI e, idealmente, ser uma conta de serviço, não a conta pessoal de um funcionário.
3. Escolha "registrar um novo gateway nesse computador". Dê um nome claro, algo como GTW-PROD-FINANCEIRO, e defina a chave de recuperação. Guarde essa chave em um cofre de senhas, ela é insubstituível e é o que permite recuperar ou migrar o gateway depois.
4. Finalize. O gateway aparece online no portal de administração do Power BI, em Configurações, Gerenciar gateways.

Depois de instalado, o software roda como um serviço do Windows sob uma conta chamada NT SERVICE\PBIEgwService por padrão. Anote isso, porque em ambientes com proxy ou políticas de rede rígidas essa conta pode precisar de ajustes para conseguir a conexão de saída. Se a instalação envolve infraestrutura complexa, banco pesado ou vários ambientes, faz sentido apoiar com quem já fez isso muitas vezes, e é aí que entra o time de engenharia de dados.

Configurar a fonte de dados é onde o refresh realmente passa a funcionar#

Instalar o gateway não basta. Você precisa registrar dentro dele cada fonte que os relatórios usam, com as credenciais que ele vai usar para conectar. Sem essa etapa, a atualização continua falhando mesmo com o gateway online.

No portal do Power BI, vá em Configurações, Gerenciar conexões e gateways, selecione o seu gateway e adicione uma nova fonte de dados. Aqui está o ponto que trava muita gente: os parâmetros de conexão precisam bater exatamente com o que você usou no Power BI Desktop. Se no Desktop o servidor foi digitado como SRV-SQL01, no gateway também tem que ser SRV-SQL01, não o IP nem o nome completo de domínio. Qualquer divergência faz o Service não reconhecer que aquela fonte pertence àquele gateway.

Preencha o tipo de fonte, o servidor, o banco e o método de autenticação. Para SQL Server, normalmente você usa uma credencial do Windows ou do próprio SQL com permissão de leitura. Uma vez salva, teste a conexão ali mesmo. Se passar, volte ao dataset publicado, edite as credenciais em Configurações do conjunto de dados, aponte para o gateway e agende a atualização.

Etapa	Onde fazer	O que verificar
Instalar gateway	Servidor interno	Serviço online no portal
Registrar fonte	Portal, gerenciar gateways	Nome do servidor idêntico ao Desktop
Testar conexão	Portal, na própria fonte	Credencial com permissão de leitura
Vincular dataset	Configurações do conjunto de dados	Gateway aparece disponível
Agendar atualização	Configurações do conjunto de dados	Janela e frequência definidas
Validar	Atualizar agora	Refresh conclui sem erro

Se você trabalha com muitas fontes e vários relatórios, considere centralizar a transformação em dataflows ou em um modelo semântico compartilhado, o que reduz o número de conexões que o gateway precisa manter e simplifica a manutenção.

Os erros mais comuns quase sempre têm a mesma raiz#

Depois de acompanhar dezenas de ambientes, a maioria das falhas de gateway cai em um punhado de causas conhecidas. Vale ter esta lista à mão antes de abrir chamado.

Nome do servidor diferente entre Desktop e gateway. É o campeão. O Service casa a fonte pelo texto exato da conexão. Padronize o nome desde o Desktop e replique idêntico no gateway.

Credencial sem permissão ou expirada. A conta que o gateway usa precisa de leitura na fonte. Senhas que expiram por política de domínio derrubam a atualização silenciosamente. Prefira contas de serviço com senha gerenciada.

Servidor do gateway desligado ou sem internet de saída. Se a máquina reinicia e o serviço não sobe, ou se o proxy corporativo bloqueia a saída para o Azure Service Bus, o gateway fica offline. Configure o serviço para iniciar automaticamente e libere as portas de saída necessárias.

Gateway atualizado para uma versão nova que quebrou algo, ou versão velha demais. A Microsoft libera atualizações mensais e depreca versões antigas. Rodar uma versão muito defasada pode parar de funcionar sem aviso. Mantenha uma cadência de atualização controlada, testando antes em homologação quando possível.

Timeout em consultas pesadas. Uma atualização que puxa milhões de linhas pode estourar o tempo limite. A solução raramente é mexer no gateway, e sim reduzir o volume com atualização incremental ou melhorar a modelagem, assunto que tratamos em boas práticas de modelagem e DAX.

Falta de recurso na máquina do gateway. CPU e memória insuficientes durante várias atualizações simultâneas geram falhas intermitentes, as piores de diagnosticar. Monitore o consumo e dimensione o servidor para o pico, não para a média.

Boas práticas separam um ambiente estável de um que vive caindo#

Instalar o gateway é fácil. Mantê-lo confiável por anos exige disciplina. Estas são as práticas que recomendamos em todo projeto de sustentação.

Use conta de serviço dedicada, nunca a conta pessoal de um colaborador. Quando a pessoa sai da empresa e a conta é desativada, tudo que dependia dela para autenticar para de funcionar de uma vez.

Instale em servidor dedicado e sempre ligado. Gateway em máquina de usuário é dívida técnica esperando para cobrar. Se a operação é crítica, monte um cluster de gateway com dois ou mais nós, o que dá alta disponibilidade e balanceamento de carga automático.

Documente tudo: nome do gateway, servidor onde roda, conta de serviço, chave de recuperação guardada em cofre, fontes registradas e quem são os administradores. Ambiente de gateway sem documentação é uma bomba-relógio para quem assumir depois.

Separe gateways por ambiente ou por criticidade quando fizer sentido. Misturar produção e testes no mesmo gateway faz um refresh pesado de teste atrapalhar a atualização de um relatório de diretoria.

Monitore proativamente. O portal de administração mostra status e histórico, e você pode configurar alertas de falha. Descobrir que o gateway caiu porque um diretor reclamou é o pior jeito de descobrir. Se a sua equipe não tem fôlego para isso, esse é exatamente o tipo de trabalho que cobrimos em sustentação de BI.

Planeje as atualizações. Espalhe os horários de refresh ao longo do dia em vez de concentrar tudo às 6h da manhã, o que evita fila e disputa de recurso no gateway. E lembre que o número de atualizações agendadas por dia depende do tipo de licença, tema que se conecta ao trabalho maior de Power BI bem estruturado.

Perguntas frequentes#

Preciso de gateway se meus dados já estão no Azure ou em um banco na nuvem? Depende de como o Power BI se conecta. Se a fonte está na internet e o Service consegue autenticar diretamente nela, não precisa de gateway. Se a fonte na nuvem está dentro de uma rede virtual privada sem exposição pública, ou se você usa DirectQuery contra ela, o gateway volta a ser necessário. Na dúvida, publique e teste a atualização: se falhar por conectividade, é gateway.

O gateway pessoal serve para produção? Não é recomendado. Ele roda amarrado a uma conta de usuário e normalmente na máquina dessa pessoa, então qualquer relatório importante fica refém de um notebook ligado e de uma conta que pode ser desativada. Use o gateway pessoal só para testes rápidos ou provas de conceito e migre para o padrão assim que o relatório passar a ser usado por outras pessoas.

Um gateway aguenta quantas fontes e relatórios? Não há um número mágico. Um único gateway padrão pode atender muitas fontes e datasets, e o limite prático é o recurso do servidor onde ele roda: CPU, memória e a capacidade da rede. O que derruba um gateway costuma ser volume de dados e concorrência de atualizações, não a quantidade de fontes registradas. Monitore o consumo e cresça para cluster quando o pico apertar.

Perdi a chave de recuperação. E agora? A chave de recuperação é o que permite restaurar, migrar ou adicionar um novo nó ao gateway. Sem ela, você não consegue recuperar a instância existente e precisa registrar um gateway novo e reconfigurar todas as fontes e credenciais do zero. Por isso ela deve viver em um cofre de senhas desde o dia da instalação, nunca num bloco de notas na área de trabalho.

Com que frequência devo atualizar o software do gateway? A Microsoft lança atualizações mensais com correções e melhorias, e versões muito antigas eventualmente param de ser suportadas. O ideal é manter uma cadência regular, aplicando as atualizações depois de validar em um ambiente de homologação quando você tem essa possibilidade. Deixar defasar por anos é convite para uma parada inesperada.

O gateway guarda uma cópia dos meus dados? Não. Ele transporta as consultas do Power BI Service até a fonte e devolve os resultados criptografados, sem armazenar o conteúdo. As credenciais das fontes ficam guardadas de forma criptografada, e você mantém a chave de recuperação. Esse desenho é justamente o que sustenta o modelo de segurança do gateway.

Fechamento#

O gateway de dados Power BI é uma daquelas peças que ninguém percebe quando funciona e todo mundo cobra quando cai. Instalar leva minutos, mas manter um ambiente estável depende de escolhas certas: gateway padrão em servidor dedicado, conta de serviço, chave de recuperação guardada, nomes de fonte padronizados e monitoramento ativo. Acerte esses pontos e a atualização deixa de ser fonte de dor de cabeça.

Se você quer montar essa estrutura do jeito certo desde o começo, ou resgatar um ambiente que vive dando falha de refresh, fale com a gente e a Fynx ajuda a deixar o seu Power BI confiável de ponta a ponta.