Usando um gateway de dados instalado localmente em fluxos de dados da Power Platform
Instale um gateway de dados local para transferir dados de forma rápida e segura entre um fluxo de dados da Power Platform e uma fonte de dados que não esteja na nuvem, como um banco de dados SQL Server local ou um site do SharePoint local. Você pode exibir todos os gateways para os quais tem permissões administrativas e gerenciar permissões e conexões para esses gateways.
Pré-requisitos
Serviço do Power BI
Você deve ter um gateway atualmente suportado instalado para usar com Dataflows. A versão mínima que funciona com o fluxo de dados do Power BI é 3000.214.8.
Uma licença do Power BI Pro ou uma licença PPU. Não tem um? Inscreva-se por 60 diasgratuitos.
Para criar um fluxo de dados que consulta uma fonte de dados local, você precisa de uma das seguintes opções:
- Permissões de administrador em um gateway.
- Permissões de criador de conexão no gateway.
- Uma conexão de gateway para a(s) fonte(s) de dados que você pretende usar já criada no gateway do qual você é usuário.
Aplicações Power
Você deve ter um gateway atualmente suportado instalado para usar com Dataflows. A versão mínima que funciona com o Power Apps Dataflow é 3000.214.8.
Uma conta do Power Apps. Não tem um? Inscreva-se por 30 dias grátis.
Permissões administrativas num gateway. Essas permissões são fornecidas por padrão para gateways instalados. Os administradores podem conceder permissões a outras pessoas para gateways.
Uma licença que oferece suporte ao acesso a dados locais usando um gateway local. Para obter mais informações: linha "Conectar-se aos seus dados" da tabela "Explorar planos do Power Apps" na página de preços do Power Apps.
Instalar um gateway
Você pode instalar um gateway de dados local diretamente do serviço online.
Observação
- É uma boa prática geral certificar-se de que está a utilizar uma versão suportada do gateway de dados local. Lançamos uma nova atualização do gateway de dados local todos os meses. Atualmente, a Microsoft oferece suporte ativo apenas às últimas seis versões do gateway de dados local.
- A partir de abril de 2022, a versão mínima exigida do gateway será fevereiro de 2021. Os fluxos de dados que são atualizados usando uma versão anterior do gateway podem parar de ser atualizados.
Instalar um gateway a partir do serviço Power BI
Para instalar um gateway a partir do serviço do Power BI:
Selecione o botão de downloads no canto superior direito do serviço do Power BI e escolha Data Gateway.
Instale o gateway usando as instruções fornecidas em Instalar um gateway de dados local.
Instalar um gateway a partir do Power Apps
Para instalar um gateway a partir do Power Apps:
No painel de navegação esquerdo do powerapps.com, selecione Data>Gateways.
Selecione Novo gateway.
Na seção Gateway de Dados Local, selecione Download.
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 obter instruções sobre como criar um novo fluxo de dados, vá para Criar um fluxo de dados a partir de uma fonte de dados.
Selecione uma fonte de dados local na lista de fontes de dados.
Forneça os detalhes de conexão para o gateway corporativo que será usado para acessar os dados locais. Você deve selecionar o gateway em si e fornecer credenciais para o gateway selecionado. Somente gateways dos quais você é administrador aparecem na lista.
Você pode alterar o gateway corporativo usado para um determinado fluxo de dados e alterar 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 não for possível fazer isso, 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 do gateway do serviço Power BI
Selecione o botão de configuração no canto superior direito do serviço Power BI, escolha Gerenciar gatewayse, em seguida, selecione o gateway desejado.
Para adicionar um usuário ao gateway, selecione a tabela Administradores e insira o endereço de e-mail do usuário que você deseja adicionar como administrador. Criar ou modificar fontes de dados em fluxos de dados requer permissões de administrador para o gateway. Os administradores 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 detetarmos que uma fonte de dados existente está disponível para o gateway selecionado, os campos Nome de usuário e de senha serão preenchidos previamente.
Se você selecionar Próximo neste momento, considera-se que está usando essa fonte de dados existente e, portanto, só precisa ter permissões para essa fonte de dados.
Se editar qualquer um dos campos de credenciais e selecionar Avançar, considera-se que está a editar essa mesma fonte de dados existente, ponto no qual precisará ter privilégios de administrador do gateway.
Se não detetarmos que uma fonte de dados existente está disponível para o gateway selecionado, os campos Nome de usuário e de senha ficarão em branco e, se você editar os campos de credenciais e selecionar Avançar, será considerado que está criando uma nova fonte de dados no gateway, momento em que precisará ser um administrador do gateway.
Se você tiver apenas permissão de usuário de fonte de dados no gateway, 1.b e 2 não poderão ser alcançados e o fluxo de dados não poderá ser criado.
Permissões do gateway do Power Apps
No painel de navegação esquerdo do powerapps.com, selecione Gateways e, em seguida, 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 novas fontes de dados com um gateway em fluxos de dados requer a permissão de administrador no gateway. Os administradores 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 gerir as conexões do gateway
Conexões de gateway de serviço do Power BI
Selecione o botão de configuração no canto superior direito do serviço Power BI, escolha Gerenciar gatewayse, em seguida, selecione o gateway desejado.
Execute a ação desejada:
- Para exibir detalhes e editar as configurações, selecione Configurações do Cluster de Gateway.
- Para adicionar usuários como administradores do gateway, selecione Administradores.
- Para adicionar uma fonte de dados ao gateway, selecione Adicionar Fonte de Dados, insira um nome de fonte de dados e escolha o tipo de fonte de dados em Configurações da Fonte de Dadose, em seguida, digite o endereço de email da pessoa que usará a fonte de dados.
- Para excluir um gateway, clique nas reticências à direita do nome do gateway e selecione Remover.
Conexões de gateway do Power Apps
Na barra de navegação esquerda do powerapps.com, selecione Gatewayse, em seguida, escolha o gateway desejado.
Execute a ação desejada:
Para ver detalhes, editar as definições ou eliminar um gateway, selecione Ligaçõese, em seguida, selecione uma ligação.
Para partilhar uma ligação, selecione Partilhar e, em seguida, adicione ou remova utilizadores.
Observação
Você só pode compartilhar alguns tipos de conexões, como uma conexão do SQL Server. Para obter mais informações, consulte Partilhar recursos de aplicações canvas no Power Apps.
Para obter mais informações sobre como gerir uma ligação, consulte Gerir ligações de aplicações canvas no Power Apps.
Limitações
Há algumas limitações conhecidas ao usar gateways corporativos e fluxos de dados.
A atualização do fluxo de dados pode falhar se um gateway de dados desatualizado for usado. A partir de abril de 2022, a versão mínima necessária do gateway de dados é fevereiro de 2021.
Cada fluxo de dados pode usar apenas um gateway. Como tal, todas as consultas devem ser configuradas usando 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 gateway). Em seguida, use os recursos de computação ou referência de tabela para unificar os dados.
Os fluxos de dados só são suportados usando gateways corporativos. Os gateways pessoais não estarão disponíveis para seleção nas listas suspensas e nos ecrãs de configurações.
A criação de novas fontes de dados com um gateway em fluxos de dados só é suportada para utilizadores com permissões de Admins.
Os utilizadores com permissões podem usar, enquanto aqueles com permissões podem usar e partilhar, aproveitando as ligações existentes ao criar fluxos de dados.
Os seguintes conectores são suportados:
Solução de problemas
Quando você tenta usar uma fonte de dados local para publicar um fluxo de dados, você pode se deparar com o seguinte erro MashupException:
AzureDataLakeStorage failed to get the response:
'The underlying connection was closed: An unexpected error occurred on a send.'
Esse erro geralmente ocorre porque você está tentando se conectar a um ponto de extremidade do Armazenamento do Azure Data Lake por meio de um proxy, mas não configurou corretamente as configurações de proxy para o gateway de dados local. Para saber mais sobre como definir essas configurações de proxy, vá para Configurar configurações de proxy para o gateway de dados local.
Para obter mais informações sobre como solucionar problemas com gateways ou configurar o serviço de gateway para a sua rede, vá para a Documentação do gateway de dados local.
Se você estiver enfrentando problemas com a versão do gateway que está usando, tente atualizar para a versão mais recente, pois o problema pode ter sido resolvido na versão mais recente. Para obter mais informações sobre como atualizar o seu gateway, vá para Atualizar um gateway de dados local.