Configuração do conector com gateway

Para fazer atualização automática de dados dos dashboards no Power BI, é nevessário possuir uma máquina com gateway rodando.

A definição de gateway pelo site da Microsoft diz que “O gateway de dados local atua como uma ponte, fornecendo transferência de dados rápida e segura entre os dados locais (dados que não estão na nuvem) e vários serviços em nuvem da Microsoft. Esses serviços de nuvem incluem Power BI, Power Apps, Power Automate, Azure Analysis Services e Aplicativos Lógicos do Azure. Usando um gateway, as organizações podem manter os bancos de dados e outras fontes de dados em suas redes locais, ao mesmo tempo que usam esses dados locais em serviços em nuvem de forma segura.”

Se você deseja usar uma máquina da AWS para funcionar como gateway, aprenda a configurar nesta documentação.

Os primeiros passos da configuração, indicados no item 1, são similares ao uso do conector local.

​

1. Na máquina que está rodando o gateway

Acesse a máquina que está rodando o gateway e:

• Atualize o Power BI, que deve estar instalado, para a versão mais recente;
• Atualize o On-Premises Data Gateway, que também deve estar instalado, para a versão mais recente;
• Baixe e instale o driver Amazon Athena ODBC 2.x;
• Baixe o conector da Nekt (nekt.mez) e salve na pasta [Documents]\Power BI Desktop\Custom Connectors (ou similar, é preciso ver qual pasta a versão do Power BI que estão rodando no gateway);
• Abra o Power BI nessa máquina e nas configurações de Data Extensions, garanta que está permitido o uso de conectores externos;

Depois disso, será necessário configurar o On-premises data gateway em si.

​

2. Configurando o On-Premises Data Gateway

Garanta que o On-premises Data Gatweay está instalado - basta seguir os passos de instalação que se seguem após baixar e abrir o programa. No campo ‘Email address to use with this gateway’ deve ser o email usado no Power BI Service.

Utilize o acesso do Power BI Service para fazer login. Em seguida, para registrar o Gateway, selecione a opção ‘Register a new gateway on this computer’.

• dê um nome para o novo gateway (sugestão ‘aws-gateway’)
• defina uma recovery key para recuperar o gateway se necessário.
• clique em ‘Configure’ Depois desses passos, você deve receber uma mensagem de que o gateway está online e pronto para ser usado.

Na configuração do gateway criado para usar o conector da nekt, o primeiro passo é identificar qual o nome usuário o data gateway está usando na máquina Windows. O usuário padrão é NT SERVICE\PBIEgwService.

Para confirmar que usuário você está usando, basta abrir o On-Premises Data Gateway e navegar para o menu de Service Settings.

No exemplo ilustrado abaixo, fica explicito o usuário ali no final, dizendo: The gateway is currently running as NT SERVICE\PBIEgwService.

O próximo passo é dar acesso para esse usuário do On-Premises Data Gateway poder executar o conector. Você deverá fazer isso dessa forma:

• Abrir a pasta local onde estão salvos os conectores customizados (Custom Connectors) utilizados pelo gateway;
• Clicar com o botão direito e clicar em Properties;
• Ir para a aba Security (no exemplo abaixo, você vai notar que na seção Group or user names já existe o usuário PBIEgwService, mas no seu gate provavelmente esse usuário não estará nessa lista), e clicar em Edit;
• Uma nova janela irá abrir chamada Permissions for Custom Connectores. Nessa janela, clicar em Add para adicionar um novo usuário;
• Na seção Enter the object names to select, digitar NT SERVICE\PBIEgwService (ou o nome do seu usuário do gateway) e clicar em Check Names. Se o usuário for válido, ele irá substituir somente pela segunda parte do usuário PBIEgwService e ficará com um sublinhado, indicando que o Windows localizou esse usuário. Clicar em OK;
• Você voltará para a tela anterior, onde pode atribuir os direitos que esse usuário tem nessa pasta. Conceder os direitos de Read & execute, List folder contents, Read, clicar em Apply e em seguida em OK para finalizar o processo;

Uma vez concedidas essas permissões, você deve voltar ao app do On-Premisses Data Gateway, dessa vez no menu Connectors e indicar a pasta onde estão seus conectores customizados. Ao clicar em Apply, o gateway será reiniciado.

No exemplo abaixo, o conector da Nekt já aparece listado na parte superior, mas é possível que o seu gateway ainda não aparecerá nessa etapa.

Se for esse o caso, por favor, abra o menu Service Settings e reinicie o gateway. Volte para o menu Connectors e entre em contato caso o conector da Nekt não apareça na lista.

Depois, siga as instruções da plataforma para finalizar o processo.

​

3. Publicação de um modelo semântico

Após ter utilizado o conector da Nekt no Power BI e criado o modelo semântico desejado, se pode fazer sua publicação normalmente estando logado com a conta do Power BI Service.

Agora, para que se possa criar uma atualização automática a partir do gateway, é necessária configuração do On-Premise Data Gateway no PowerBI Service.

​

4. Configuração do On-Premise Data Gateway no Power BI Service

No Power BI service, acesse o menu Configurações e Gerenciar conexões e gateways. O gateway criado anteriormente deve estar listado na aba Gateways de dados locais.

Acesse as configurações do gateway criado e defina as seguintes configurações:

• Na seção Geral, marque a opção “Distribua solicitações em todos os gateways ativos neste cluster”
• Na seção Power BI, selecione as opções “Permita que as fontes de dados de nuvem do usuário seham atualizadas por meio deste cluster de gateway” e “Permita que os conectores de dados personalizados do usuário sejam atualizados por meio deste cluster de gateway”. Clique em Salvar.

​

5. Configuração do modelo semântico para utilização do Gateway

Acesse as configurações do Modelo semântico criado anteriormente.

Na seção Conexões de gateway e nuvem, o gateway criado se encontrará, inicialmente, desabilitado, com status “Não configurado corretamente”. Para corrigir isso, clique no ícone de play e, na caixa que abrir, em “Adicionar manualmente ao gateway”. Para cada modelo semântico criado no Power BI, esse processo (passos 5 e 6) deve ser repetido.

Para adicionar manualmente ao gateway, indique:

• Nome da conexão: para facilitar o entendimento, sugerimos que utilize o mesmo Visualization Identifier (power-bi-xxxx) aqui
• Visualization identifier: utilize o Visualization Identifier (power-bi-xxxx)
• Método de autenticação: Visualization Token
• Visualization token: selecione o token associado ao Visualization Identifier na Nekt

Clique em Criar.

De volta à seção de Conexões de Gateway e nuvem, a fonte de dados do modelo semântico deve estar com status de sucesso (em execução). No dropdown “Mapeia para:”, selecione o gateway associado ao modelo semântico. Clique em Aplicar. Uma mensagem de sucesso deve aparecer.

Você pode fazer uma atualização manual do modelo semântico para garantir que tudo está funcionando. Considerando que sim, já podemos criar uma atualização automática.

​

6. Criação de atualização automática

Nas configurações do modelo semântico em questão, vá até a seção Atualizar e configure o agendamento de atualização conforme suas necessidades e clique em Aplicar.

Com isso, o modelo semântico será atualizado conforme sua configuração e todos os relatórios que o utilizam serão atualizados também.