Usando um gateway de dados local em fluxos de dados do Power Platform

Artigo
01/17/2024

Instale um gateway de dados local para transferir dados de maneira rápida e segura entre o fluxo de dados do Power Platform e uma fonte de dados que não esteja na nuvem, como um banco de dados SQL Server local ou um site local do SharePoint. É possível exibir todos os gateways para os quais você tem permissões administrativas e gerenciar permissões e conexões com eles.

Pré-requisitos

Serviço do Power BI

Uma licença do Power BI Pro ou PPU. Não tem uma? Inscreva-se gratuitamente por 60 dias.
Para criar um fluxo de dados que consulta uma fonte de dados local, você precisa de um dos seguintes:
- Permissões de administrador em um gateway.
- Permissões de criador de conexão no gateway.
- Uma conexão de gateway para as fontes de dados que você pretende usar já criadas no gateway do qual você é um usuário.

Power Apps

Uma conta do Power Apps. Não tem uma? Inscreva-se gratuitamente por 30 dias.
Permissões administrativas em um gateway. Essas permissões são fornecidas por padrão para os gateways instalados. Os administradores podem conceder permissões para os gateways a outras pessoas.
Uma licença que suporta acesso de dados no local usando um gateway no local. Para saber mais sobre a linha "Conectar-se aos seus dados" da tabela "Explorar planos do Power Apps", visite a página Preços do Power Apps.

Instalar um gateway

É possível instalar um gateway de dados local diretamente do serviço online.

Observação

É uma boa prática geral garantir que você esteja usando uma versão com suporte do gateway de dados local. Lançamos novas atualizações do gateway de dados local todos os meses. Atualmente, a Microsoft dá suporte ativo apenas às últimas seis versões do gateway de dados local.
A partir de abril de 2022, a versão mínima necessária do gateway será a de fevereiro de 2021. Os fluxos de dados que são atualizados usando uma versão anterior do gateway podem ter falhas na atualização.

Instalar um gateway por meio do serviço do Power BI

Para instalar um gateway por meio do serviço do Power BI:

Clique no botão “Downloads” no canto superior direito do serviço do Power BI e escolha Gateway de Dados.
Instale o gateway usando as instruções fornecidas em Instalar um gateway de dados local.

Instalar um gateway por meio do Power Apps

Para instalar um gateway por meio do Power Apps:

No painel de navegação esquerdo de powerapps.com, selecione Dados>Gateways.
Selecione Novo gateway.
Na seção Gateway de dados local, selecione Baixar.
Instale o gateway usando as instruções fornecidas em Instalar um gateway de dados local.

Usar uma fonte de dados local em um fluxo de dados

Para saber como criar um fluxo de dados, acesse Criar um fluxo de dados com base em uma fonte de dados.
Selecione uma fonte de dados local na lista de fontes de dados.
Forneça os detalhes de conexão do gateway corporativo que será usado para acessar os dados locais. Você deve selecionar o próprio gateway e fornecer credenciais para o gateway selecionado. Somente os gateways dos quais você é um administrador aparecerão na lista.

É possível alterar o gateway corporativo usado para um determinado fluxo de dados e o gateway atribuído a todas as suas consultas usando a ferramenta de criação de fluxo de dados.

Observação

O fluxo de dados tentará localizar ou criar as fontes de dados necessárias usando o novo gateway. Se isso não for possível, você não poderá alterar o gateway até que todos os fluxos de dados necessários estejam disponíveis no gateway selecionado.

Exibir e gerenciar permissões de gateway

Permissões de gateway do serviço do Power BI

Clique no botão de instalação no canto superior direito do serviço do Power BI, escolha Gerenciar gateways e selecione o gateway desejado.
Para adicionar um usuário ao gateway, selecione a tabela Administradores e insira o endereço de email do usuário que você deseja adicionar como administrador. A criação ou modificação de fontes de dados em fluxos de dados requer permissões de administrador do gateway. Os administradores que têm controle total do gateway, incluindo a adição de usuários, a definição de permissões, a criação de conexões com todas as fontes de dados disponíveis e a exclusão do gateway.

As seguintes condições se aplicam ao adicionar um usuário ao gateway:

Se for detectado que uma fonte de dados existente está disponível para o gateway selecionado, os campos Nome de usuário e Senha serão preenchidos previamente.
1. Neste momento, se você selecionar Avançar, será considerado que você está usando essa fonte de dados existente e, portanto, só precisa ter permissões para ela.
2. Se você editar qualquer um dos campos de credencial e clicar em Avançar, será considerado que você está editando essa fonte de dados existente, o que exige que você seja um administrador do gateway.
Se não detectarmos que uma fonte de dados existente está disponível para o gateway selecionado, os campos Nome de usuário e Senha ficarão em branco e, se você editar os campos de credencial e clicar em Avançar, será considerado que você está criando uma fonte de dados no gateway, o que exige que você seja um administrador do gateway.

Se você só tiver permissão de usuário de fonte de dados no gateway, 1.b e 2 não poderão ser realizados e o fluxo de dados não poderá ser criado.

Permissões de gateway do Power Apps

No painel de navegação esquerdo de powerapps.com, clique em Gateways e selecione o gateway desejado.
Para adicionar um usuário a um gateway, selecione Usuários, especifique um usuário ou grupo e especifique um nível de permissão. Criar fontes de dados com um gateway em fluxos de dados requer a permissão de administrador no gateway. Os administradores que têm controle total do gateway, incluindo a adição de usuários, a definição de permissões, a criação de conexões com todas as fontes de dados disponíveis e a exclusão do gateway.

Exibir e gerenciar conexões de gateway

Conexões de gateway do serviço do Power BI

Clique no botão de instalação no canto superior direito do serviço do Power BI, escolha Gerenciar gateways e selecione o gateway desejado.
Para realizar a ação desejada:
- Para exibir detalhes e editar as configurações, clique em Configurações do cluster de gateway.
- Para adicionar usuários como administradores do gateway, clique em Administradores.
- Para adicionar uma fonte de dados ao gateway, selecione Adicionar fonte de dados, insira um nome para ela e escolha o tipo respectivo nas Configurações da fonte de dados e insira o endereço de email da pessoa que a usará.
- Para excluir um gateway, clique nas reticências à direita do nome do gateway e selecione Remover.

Conexões de gateway do Power Apps

No painel de navegação à esquerda em powerapps.com, clique em Gateways e selecione o gateway desejado.
Para realizar a ação desejada:
- Para exibir detalhes, editar as configurações ou excluir um gateway, clique em Conexões e selecione uma conexão.
- Para compartilhar uma conexão, clique em Compartilhar e adicione ou remova usuários.
  
  Observação
  
  É possível compartilhar apenas alguns tipos de conexões, como a do SQL Server. Para saber mais, confira Compartilhar recursos de aplicativo de tela no Power Apps.
  
  Para saber como gerenciar uma conexão, confira Gerenciar conexões de aplicativo de tela no Power Apps.

Limitações

Há algumas limitações conhecidas ao usar fluxos de dados e gateways corporativos.

A atualização do fluxo de dados poderá falhar se um gateway de dados desatualizado for usado. Desde abril de 2022, a versão mínima necessária do gateway de dados é a de fevereiro de 2021.
Cada fluxo de dados pode usar apenas um gateway. Dessa forma, todas as consultas devem ser configuradas usando-se o mesmo gateway.
A alteração do gateway afeta todo o fluxo de dados.
Se forem necessários vários gateways, a prática recomendada é criar vários fluxos de dados (um para cada). Em seguida, use os recursos de referência de tabela ou computação para unificar os dados.
Só há suporte para os fluxos de dados quando os gateways corporativos são usados. Os gateways pessoais não estarão disponíveis para seleção nas telas de listas suspensas e configurações.
A criação de fontes de dados com um gateway em fluxos de dados só tem suporte para pessoas com permissões de Administrador.
Os usuários com permissões Uso Permitido ou Uso Permitido + Compartilhamento podem usar conexões existentes ao criar fluxos de dados.
Os seguintes conectores têm suporte:

Solução de problemas

Ao tentar usar uma fonte de dados local para publicar um fluxo de dados, é possível que você se depare com o seguinte erro MashupException:

AzureDataLakeStorage failed to get the response:
'The underlying connection was closed: An unexpected error occurred on a send.'

Geralmente, esse erro ocorre porque você está tentando se conectar a um ponto de extremidade do Azure Data Lake Storage por meio de um proxy, mas não definiu corretamente as configurações de proxy para o gateway de dados local. Para saber como definir essas configurações de proxy, confira Definir as configurações de proxy para o gateway de dados local.

Para saber mais sobre a solução de problemas de gateways ou a configuração do serviço de gateway para sua rede, confira a Documentação do gateway de dados local.

Em caso de problemas com a versão do gateway sendo usada, tente atualizar para a versão mais recente, pois seu problema pode ter sido resolvido nela. Para saber como atualizar seu gateway, acesse Atualizar um gateway de dados local.