Share via

Utilizar um gateway de dados no local no fluxo de dados do Power Platform

  • Artigo

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 Power BI

  • Uma licença do Power BI Pro ou uma licença PPU. Não tem um? Inscreva-se gratuitamente por 60 dias.

  • 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.

Power Apps

  • Uma conta do Power Apps Não tem um? Inscreva-se gratuitamente por 30 dias.

  • 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 suporta o acesso a dados no local utilizando 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.

Nota

  • É 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:

  1. Selecione o botão de downloads no canto superior direito do serviço do Power BI e escolha Data Gateway.

    Imagem mostrando a seleção do gateway de dados no serviço Power Bi.

  2. 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:

  1. No painel de navegação esquerdo do powerapps.com, selecione Gateways de Dados>.

    Gateways na barra de navegação esquerda.

  2. Selecione Novo gateway.

    Imagem mostrando o novo botão de gateway no Power Apps.

  3. Na seção Gateway de Dados Local, selecione Download.

  4. 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

  1. 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.

  2. Selecione uma fonte de dados local na lista de fontes de dados.

    Escolha uma fonte de dados local.

  3. 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.

    Forneça detalhes da conexão.

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.

Nota

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.

Ver e gerir permissões de gateway

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

  1. Selecione o botão de configuração no canto superior direito do serviço do Power BI, escolha Gerenciar gateways e selecione o gateway desejado.

    Imagem mostrando a seleção de gateways de gerenciamento no serviço do Power BI.

  2. Para adicionar um usuário ao gateway, selecione a tabela Administradores e digite 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:

  1. Se detetarmos que uma fonte de dados existente está disponível para o gateway selecionado, os campos Nome de usuário e Senha serão pré-preenchidos.

    1. Se você selecionar Avançar neste momento, será considerado que está usando essa fonte de dados existente e, portanto, só precisará ter permissões para essa fonte de dados.

    2. Se você editar qualquer um dos campos de credenciais e selecionar Avançar, será considerado que está editando essa fonte de dados existente, momento em que precisará ser um administrador do gateway.

  2. Se não detetarmos 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 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 de gateway do Power Apps

  1. No painel de navegação esquerdo do powerapps.com, selecione Gateways e, em seguida, selecione o gateway desejado.

  2. 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. A criação de novas fontes de dados com um gateway em fluxos de dados requer 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.

Ver e gerir ligações de gateway

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

  1. Selecione o botão de configuração no canto superior direito do serviço do Power BI, escolha Gerenciar gateways e selecione o gateway desejado.

  2. Execute a ação desejada:

    • Para exibir detalhes e editar as configurações, selecione Configurações de 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 Dados e insira o endereço de email da pessoa que usará a fonte de dados.
    • Para excluir um gateway, selecione as reticências à direita do nome do gateway e selecione Remover.

Conexões de gateway do Power Apps

  1. Na barra de navegação esquerda do powerapps.com, selecione Gateways e escolha o gateway desejado.

  2. Execute a ação desejada:

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 nas telas de configurações.

  • A criação de novas fontes de dados com um gateway em fluxos de dados só é suportada para pessoas com permissões de administradores.

  • Os usuários com permissões Pode Usar ou Pode Usar + Compartilhar podem usar conexões existentes ao criar fluxos de dados.

  • Os seguintes conectores são suportados:

Resoluçã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 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 seu gateway, vá para Atualizar um gateway de dados local.

Próximos passos