Conectar-se a fontes de dados locais dos Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Às vezes, seu fluxo de trabalho deve se conectar a uma fonte de dados local e pode usar apenas conectores que fornecem esse acesso por meio de um gateway de dados local. Para configurar esse gateway de dados local, você precisa concluir as seguintes tarefas: instalar o gateway de dados local e criar um recurso de gateway de dados local no Azure para o gateway de dados local. Ao adicionar um gatilho ou uma ação ao fluxo de trabalho a partir de um conector que requer o gateway de dados, você pode selecionar o recurso de gateway de dados a ser usado com a conexão.

Em Fluxos de trabalho de aplicativo lógico de consumo, você pode se conectar a fontes de dados locais usando apenas conectores que fornecem acesso por meio do gateway de dados local. Em fluxos de trabalho de aplicativo lógico padrão, você pode acessar diretamente recursos locais em redes virtuais do Azure ou usar conectores internos de provedor de serviços que não precisam do gateway de dados para acessar sua fonte de dados local. Em vez disso, você fornece informações que autenticam sua identidade e autorizam o acesso à fonte de dados. No entanto, se um conector de provedor de serviços interno não estiver disponível para sua fonte de dados, mas um conector gerenciado estiver disponível, você precisará usar o gateway de dados local.

Este guia mostra como criar o recurso de gateway de dados do Azure depois de instalar o gateway local no computador local.

Para saber mais, confira a seguinte documentação:

Para obter informações sobre como usar um gateway com outros serviços, consulte a documentação a seguir:

Fontes de dados com suporte

Nos Aplicativos Lógicos do Azure, o gateway de dados local oferece suporte a conectores locais para as seguintes fontes de dados:

Você também pode criar Conectores Personalizados que se conectam a fontes de dados por HTTP ou HTTPS usando REST ou SOAP. Embora um gateway não incorra em custos adicionais, o modelo de preços dos Aplicativos Lógicos do Azure se aplica a conectores e outras operações dos Aplicativos Lógicos do Azure.

Limitações

Os Aplicativos Lógicos do Azure dão suporte a operações de leitura e gravação por meio do gateway de dados, mas essas operações têm limites no tamanho de conteúdo.

Pré-requisitos

  • Você já instalou um gateway de dados local em um computador local. Essa instalação de gateway de dados deve existir para que você possa criar um recurso de gateway de dados vinculado a essa instalação. Você pode instalar somente um gateway de dados por computador local.

  • Você tem a mesma conta e assinatura do Azure que usou para a instalação do gateway. Essa conta do Azure deve pertencer apenas a um único locatário ou diretório do Microsoft Entra. Já que apenas o administrador de gateway pode criar o recurso de gateway no Azure, você precisa usar a mesma conta e assinatura do Azure para criá-lo. Atualmente, não há suporte para entidades de serviço.

    • Ao criar um recurso de gateway de dados no Azure, você seleciona uma instalação de gateway de dados para vincular ao seu recurso de gateway e somente a esse recurso de gateway. Cada recurso de gateway pode ser vinculado a apenas uma instalação de gateway. Você não pode selecionar uma instalação de gateway que já esteja associada a outro recurso de gateway.

    • Seu recurso de aplicativo lógico e recurso de gateway não precisam existir na mesma assinatura do Azure. Em gatilhos e ações em que você usa o recurso de gateway, você pode selecionar uma assinatura diferente do Azure que tenha um recurso de gateway, mas somente se essa assinatura existir no mesmo locatário ou diretório do Microsoft Entra que seu recurso de aplicativo lógico. Você também precisa ter permissões de administrador no gateway, que outro administrador pode configurar para você. Para obter mais informações, confira Gateway de dados: automação usando o PowerShell – Parte 1 e PowerShell: Gateway de Dados – Add-DataGatewayClusterUser.

      Observação

      Atualmente, você não pode compartilhar um recurso de gateway de dados ou instalação em várias assinaturas. Para enviar comentários sobre o produto, confira o Fórum de Comentários do Microsoft Azure.

Criar um recurso de gateway do Azure

Depois de instalar o gateway de dados em um computador local, crie o recurso do Azure para seu gateway de dados.

  1. Entre no portal do Azure com a mesma conta do Azure que você usou para instalar o gateway.

  2. Na caixa de pesquisa do portal do Azure, insira gateway de dados local e selecione Gateways de dados locais.

    Screenshot shows Azure portal search box with the words, on-premises data gateway. The results list shows the selected option, On-premises data gateways.

  3. Em Gateways de dados locais, selecione Criar.

    Screenshot shows the page for On-premises data gateways with the selected option for Create.

  4. Em Criar um gateway, forneça as informações a seguir para o recurso de gateway. Quando terminar, selecione Review + create.

    Propriedade Descrição
    Assinatura Selecione a assinatura do Azure para a conta do Azure que você usou para a instalação do gateway. A assinatura padrão baseia-se na conta do Azure utilizada para entrar.
    Grupo de recursos Selecione o grupo de recursos do Azure que você deseja usar.
    Nome Insira um nome para o recurso de gateway que contenha apenas letras, números, hifens (-), sublinhados (_), parênteses ((, )) ou pontos (.).
    Região Selecione a mesma região ou local selecionada para o serviço de nuvem do gateway durante a instalação do gateway. Caso contrário, a instalação do gateway não aparece na lista Nome da Instalação. O local do recurso do aplicativo lógico pode ser diferente do local do recurso do gateway.
    Nome de Instalação Selecione uma instalação de gateway, que aparece na lista somente quando essas condições são atendidas:

    – A instalação do gateway usa a mesma região que o recurso de gateway que você deseja criar.
    – A instalação do gateway não está vinculada a outro recurso de gateway do Azure.
    – A instalação do gateway está vinculada à mesma conta do Azure que você está usando para criar o recurso de gateway.
    - Sua conta do Azure pertence a um único locatário ou diretório do Microsoft Entra e é a mesma conta que você usou para a instalação do gateway.

    Confira mais informações nas Perguntas frequentes.

    O exemplo a seguir mostra uma instalação de gateway que está na mesma região que o recurso de gateway e está vinculado à mesma conta do Azure:

    Screenshot shows the page for Create a gateway. The Name, Region, and other boxes contain values. The button, Review + create, appears selected.

  5. Na página de validação que aparecer, confirme todas as informações que você forneceu e selecione Criar.

Conectar-se a dados locais

Após criar o recurso de gateway e associar a assinatura do Azure a esse recurso, é possível criar uma conexão entre o fluxo de trabalho do aplicativo lógico e a fonte de dados local usando o gateway.

  1. No portal do Azure, crie ou abra o fluxo de trabalho do aplicativo lógico no designer.

  2. Adicione um gatilho ou ação de um conector que ofereça suporte a conexões locais por meio do gateway de dados.

    Observação

    Em fluxos de trabalho de aplicativo lógico de Consumo, se um conector tiver uma versão gerenciada e uma versão interna, use a versão gerenciada, pois ela inclui a funcionalidade de seleção de gateway. Nos fluxos de trabalho do aplicativo lógico Standard, os conectores internos que se conectam a fontes de dados locais não precisam usar o gateway.

  3. Para o gatilho ou ação, forneça as seguintes informações:

    1. Se existir uma opção para se conectar por meio de um gateway de dados local, selecione essa opção.

    2. Em Gateway, na lista Assinatura, selecione a assinatura do Azure que tem o recurso de gateway desejado.

      Seu recurso de aplicativo lógico e recurso de gateway não precisam existir na mesma assinatura do Azure. Você pode selecionar entre outras assinaturas do Azure que têm um recurso de gateway, mas somente se:

      • Essas assinaturas existem no mesmo locatário ou diretório do Microsoft Entra que seu recurso de aplicativo lógico.
      • Você tiver permissões de administrador no gateway, que outro administrador pode configurar para você.

      Para obter mais informações, confira Gateway de dados: automação usando o PowerShell – Parte 1 e PowerShell: Gateway de Dados – Add-DataGatewayClusterUser.

    3. Na lista Gateway de conexão, selecione o recurso do gateway que você deseja usar. Essa lista mostra os recursos de gateway disponíveis na assinatura selecionada. Cada recurso de gateway é vinculado a apenas uma instalação de gateway.

      Observação

      A lista de Gateways de conexão inclui recursos de gateway em outras regiões porque o local do recurso do aplicativo lógico pode ser diferente do local do recurso de gateway.

    4. Forneça um nome de conexão exclusivo e outras informações necessárias, que dependem da conexão que você deseja criar.

      Um nome de conexão exclusivo ajuda a identificar a conexão mais tarde com facilidade, especialmente se você criar várias conexões. Se aplicável, também inclua o domínio qualificado para seu nome de usuário.

      O exemplo a seguir para um fluxo de trabalho de Consumo mostra informações de exemplo para uma conexão do SQL Server:

      Screenshot of a SQL Server connector. The 'Subscription,' 'Connection Gateway,' 'Connection name,' and other boxes have values.

  4. Quando terminar, selecione Criar.

A conexão de gateway agora está pronta para o uso do fluxo de trabalho do aplicativo lógico.

Editar conexão

Para atualizar as configurações de uma conexão de gateway, você pode editar a conexão. Esta seção continua usando um fluxo de trabalho de Consumo como o exemplo.

  1. Para localizar todas as conexões de API para o recurso de aplicativo lógico, no menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Conexões de API.

    Screenshot of a logic app resource in the Azure portal. On the logic app navigation menu, 'API connections' is highlighted.

  2. Selecione a conexão de gateway que você deseja editar e, em seguida, selecione Editar conexão de API.

    Dica

    Se suas atualizações não entrarem em vigor, tente interromper e reiniciar o serviço Windows do gateway para a instalação de gateway.

Para localizar todas as conexões de API associadas à sua assinatura do Azure, use uma das seguintes opções:

  • Na caixa de pesquisa do portal do Azure, insira conexões de api e selecione Conexões de API.
  • No menu do portal do Azure, selecione Todos os recursos. Defina o filtro de Tipo como Conexão de API.

Excluir recurso de gateway

Para criar um recurso de gateway diferente, vincule a instalação do gateway a um recurso de gateway diferente ou remova o recurso de gateway. É possível excluir o recurso de gateway sem afetar a instalação do gateway.

  1. No portal do Azure, abra o recurso do gateway.

  2. Na barra de ferramentas do recurso de gateway, selecione Excluir.

    Screenshot shows on-premises data gateway resource in the Azure portal. On the toolbar, Delete is selected.

Perguntas frequentes

P: Por que a minha instalação não aparece quando eu crio o recurso de gateway no Azure?
R: Esse problema pode ocorrer pelos seguintes motivos:

  • A sua conta do Azure não é a mesma conta que você usou para a instalação do gateway no computador local. Verifique se você entrou no portal do Azure com a mesma identidade que usou para a instalação do gateway. Somente o administrador de gateway pode criar o recurso de gateway no Azure. Atualmente, não há suporte para entidades de serviço.

  • Sua conta do Azure não pertence a apenas um único locatário ou diretório do Microsoft Entra. Verifique se você está usando o mesmo locatário ou diretório do Microsoft Entra que você usou durante a instalação do gateway.

  • O recurso de gateway e a instalação do gateway não existem na mesma região. Certifique-se de que a instalação do gateway use a mesma região em que você deseja criar o recurso de gateway no Azure. No entanto, o local do recurso do aplicativo lógico pode ser diferente do local do recurso de gateway.

  • A instalação de gateway não está associada a outro recurso de gateway. Cada recurso de gateway pode ser vinculado a apenas uma instalação de gateway, que pode ser vinculada a apenas uma conta do Azure e uma assinatura. Portanto, você não pode selecionar uma instalação de gateway que já esteja associada a outro recurso de gateway. Essas instalações não aparecem na lista Nome da Instalação.

    Para verificar os registros de gateway no portal do Azure, examine todos os seus recursos do Azure com o tipo Gateways de dados locais em todas as suas assinaturas do Azure. Para desvincular uma instalação do gateway de um recurso de gateway diferente, confira Excluir recurso de gateway.

P: por que o local de meu gateway existente foi alterado?
R: Os recursos de gateway criados antes de 3 de maio de 2017 foram movidos para os locais originais do locatário do Microsoft Entra para a conta corporativa ou de estudante que criou esses gateways. No entanto, essas alterações não devem afetar aplicativos lógicos em execução no momento, os quais devem continuar funcionando normalmente. Com a disponibilidade geral do gateway em maio, os locais de recursos de gateway podem ser diferentes dos locais de aplicativos lógicos.

Próximas etapas