Conectar-se a fontes de dados locais de aplicativos lógicos do AzureConnect to on-premises data sources from Azure Logic Apps

Antes de poder acessar as fontes de dados locais de seus aplicativos lógicos, você precisará criar um recurso do Azure depois de instalar o Gateway de dados local em um computador local.Before you can access data sources on premises from your logic apps, you need to create an Azure resource after you install the on-premises data gateway on a local computer. Seus aplicativos lógicos usam esse recurso de gateway do Azure nos gatilhos e ações fornecidas pelos conectores locais que estão disponíveis para aplicativos lógicos do Azure.Your logic apps then use this Azure gateway resource in the triggers and actions provided by the on-premises connectors that are available for Azure Logic Apps.

Este artigo mostra como criar seu recurso de gateway do Azure para um Gateway instalado anteriormente no computador local.This article shows how to create your Azure gateway resource for a previously installed gateway on your local computer. Para obter mais informações sobre o gateway, consulte como funciona o gateway.For more information about the gateway, see How the gateway works.

Dica

Para se conectar às redes virtuais do Azure, considere criar um ambiente de serviço de integração em vez disso.To connect to Azure virtual networks, consider creating an integration service environment instead.

Para obter informações sobre como usar o gateway com outros serviços, consulte estes artigos:For information about how to use the gateway with other services, see these articles:

Origens de dados suportadasSupported data sources

Nos aplicativos lógicos do Azure, o gateway de dados local dá suporte aos conectores locais para essas fontes de dados:In Azure Logic Apps, the on-premises data gateway supports the on-premises connectors for these data sources:

  • BizTalk Server 2016BizTalk Server 2016
  • Sistema de FicheirosFile System
  • IBM DB2IBM DB2
  • IBM InformixIBM Informix
  • IBM MQIBM MQ
  • MySQLMySQL
  • Base de dados OracleOracle Database
  • PostgreSQLPostgreSQL
  • SAPSAP
  • SharePoint ServerSharePoint Server
  • SQL ServerSQL Server
  • TeradataTeradata

O aplicativo lógico do Azure dá suporte a operações de leitura e gravação por meio do gateway de dados.Azure Logic Apps supports read and write operations through the data gateway. No entanto, essas operações têm limites de seu tamanho de carga.However, these operations have limits on their payload size. Embora o próprio gateway não incorra em custos adicionais, o modelo de preços dos aplicativos lógicos se aplica a esses conectores e a outras operações nos aplicativos lógicos do Azure.Although the gateway itself doesn't incur additional costs, the Logic Apps pricing model applies to these connectors and other operations in Azure Logic Apps.

Pré-requisitosPrerequisites

  • Você já instalou o gateway de dados local em um computador local.You already installed the on-premises data gateway on a local computer.

  • Você está usando a mesma conta e assinatura do Azure que foi usada ao instalar o gateway de dados.You're using the same Azure account and subscription that was used when installing that data gateway. Essa conta do Azure deve pertencer a um único locatário ou diretório do Azure Active Directory (Azure AD).This Azure account must belong to a single Azure Active Directory (Azure AD) tenant or directory.

  • A instalação do gateway ainda não está registrada e reivindicada por outro recurso de gateway do Azure.Your gateway installation isn't already registered and claimed by another Azure gateway resource.

    Ao criar um recurso de gateway no portal do Azure, você seleciona uma instalação de gateway, que vincula o recurso de gateway e apenas esse recurso de gateway.When you create a gateway resource in the Azure portal, you select a gateway installation, which links to your gateway resource and only that gateway resource. Em aplicativos lógicos do Azure, gatilhos e ações locais usam o recurso de gateway para se conectar a fontes de dados locais.In Azure Logic Apps, on-premises triggers and actions then use the gateway resource for connecting to on-premises data sources. Nesses gatilhos e ações, você seleciona sua assinatura do Azure e o recurso de gateway associado que deseja usar.In these triggers and actions, you select your Azure subscription and the associated gateway resource that you want to use. Cada recurso de gateway vincula-se a apenas uma instalação de gateway, que é vinculada a apenas uma conta do Azure.Each gateway resource links to only one gateway installation, which links to only one Azure account.

Criar recurso de gateway do AzureCreate Azure gateway resource

Depois de instalar o gateway em um computador local, crie o recurso do Azure para seu gateway.After you install the gateway on a local computer, create the Azure resource for your gateway.

  1. Entre no portal do Azure com a mesma conta do Azure que foi usada para instalar o gateway.Sign in to the Azure portal with the same Azure account that was used to install the gateway.

  2. Na caixa de pesquisa portal do Azure, insira "gateway de dados local" e selecione gateways de dados locais.In the Azure portal search box, enter "on-premises data gateway", and select On-premises Data Gateways.

    Localizar "gateway de dados local"

  3. Em gateways de dados locais, selecione Adicionar.Under On-premises Data Gateways, select Add.

    Adicionar novo recurso do Azure para gateway de dados

  4. Em criar gateway de conexão, forneça essas informações para o recurso de gateway.Under Create connection gateway, provide this information for your gateway resource. Quando terminar, selecione Criar.When you're done, select Create.

    PropriedadeProperty DescriçãoDescription
    Nome do RecursoResource Name Forneça um nome para o recurso de gateway que contém apenas letras, números, hifens (-), sublinhados (_), parênteses ((, )) ou pontos (.).Provide a name for your gateway resource that contains only letters, numbers, hyphens (-), underscores (_), parentheses ((, )), or periods (.).
    SubscriçãoSubscription Selecione a assinatura do Azure para a conta do Azure que foi usada para a instalação do gateway.Select the Azure subscription for the Azure account that was used for the gateway installation. A assinatura padrão é baseada na conta do Azure que você usou para entrar.The default subscription is based on the Azure account that you used to sign in.
    Grupo de recursosResource group O grupo de recursos do Azure que você deseja usarThe Azure resource group that you want to use
    LocalizaçãoLocation A mesma região ou local que foi selecionado para o serviço de nuvem do gateway durante a instalação do gateway.The same region or location that was selected for the gateway cloud service during gateway installation. Caso contrário, a instalação do gateway não aparecerá na lista nome da instalação .Otherwise, your gateway installation won't appear in the Installation Name list. O local do aplicativo lógico pode ser diferente do local do recurso do gateway.Your logic app location can differ from your gateway resource location.
    Nome da instalaçãoInstallation Name Selecione uma instalação de gateway, que aparece na lista somente quando essas condições são atendidas:Select a gateway installation, which appears in the list only when these conditions are met:

    -A instalação do gateway usa a mesma região que o recurso de gateway que você deseja criar.- The gateway installation uses the same region as the gateway resource that you want to create.
    -A instalação do gateway não está vinculada a outro recurso de gateway do Azure.- The gateway installation isn't linked to another Azure gateway resource.
    -A instalação do gateway está vinculada à mesma conta do Azure que você está usando para criar o recurso de gateway.- The gateway installation is linked to the same Azure account that you're using to create the gateway resource.
    -Sua conta do Azure pertence a um único locatário ou diretório do Azure Active Directory (Azure AD) e é a mesma conta que foi usada para a instalação do gateway.- Your Azure account belongs to a single Azure Active Directory (Azure AD) tenant or directory and is the same account that was used for the gateway installation.

    Para obter mais informações, consulte a seção perguntas frequentes.For more information, see the Frequently asked questions section.

    Aqui está um exemplo que mostra uma instalação de gateway que está na mesma região que o recurso de gateway e está vinculado à mesma conta do Azure:Here is an example that shows a gateway installation that's in the same region as your gateway resource and is linked to the same Azure account:

    Fornecer detalhes para criar um recurso de gateway de dados

Ligar aos dados no localConnect to on-premises data

Depois de criar o recurso de gateway e associar sua assinatura do Azure a esse recurso, agora você pode criar uma conexão entre seu aplicativo lógico e sua fonte de dados local usando o gateway.After you create your gateway resource and associate your Azure subscription with this resource, you can now create a connection between your logic app and your on-premises data source by using the gateway.

  1. No portal do Azure, crie ou abra seu aplicativo lógico no designer de aplicativo lógico.In the Azure portal, create or open your logic app in the Logic App Designer.

  2. Adicione um conector que ofereça suporte a conexões locais, por exemplo, SQL Server.Add a connector that supports on-premises connections, for example, SQL Server.

  3. Selecione conectar por meio do gateway de dados local.Select Connect via on-premises data gateway.

  4. Em gateways, na lista assinaturas , selecione sua assinatura do Azure que tenha o recurso de gateway desejado.Under Gateways, from the Subscriptions list, select your Azure subscription that has the gateway resource you want.

  5. Na lista Gateway de conexão , que mostra os recursos de gateway disponíveis em sua assinatura selecionada, selecione o recurso de gateway desejado.From the Connection Gateway list, which shows the available gateway resources in your selected subscription, select the gateway resource that you want. Cada recurso de gateway é vinculado a uma única instalação de gateway.Each gateway resource is linked to a single gateway installation.

    Nota

    A lista de gateways inclui recursos de gateway em outras regiões porque o local do seu aplicativo lógico pode ser diferente do local do seu recurso de gateway.The gateways list includes gateway resources in other regions because your logic app's location can differ from your gateway resource's location.

  6. Forneça um nome de conexão exclusivo e outras informações necessárias, que dependem da conexão que você deseja criar.Provide a unique connection name and other required information, which depends on the connection that you want to create.

    Um nome de conexão exclusivo ajuda a localizar facilmente essa conexão mais tarde, especialmente se você criar várias conexões.A unique connection name helps you easily find that connection later, especially if you create multiple connections. Se aplicável, inclua também o domínio qualificado para seu nome de usuário.If applicable, also include the qualified domain for your username.

    Segue-se um exemplo:Here is an example:

    Criar conexão entre o aplicativo lógico e o gateway de dados

  7. Quando terminar, selecione Criar.When you're done, select Create.

Sua conexão de gateway agora está pronta para uso do seu aplicativo lógico.Your gateway connection is now ready for your logic app to use.

Editar conexãoEdit connection

Para atualizar as configurações de uma conexão de gateway, você pode editar sua conexão.To update the settings for a gateway connection, you can edit your connection.

  1. Para localizar todas as conexões de API apenas para seu aplicativo lógico, no menu do aplicativo lógico, em ferramentas de desenvolvimento, selecione conexões de API.To find all the API connections for just your logic app, on your logic app's menu, under Development Tools, select API connections.

    No menu do aplicativo lógico, selecione "conexões de API"

  2. Selecione a conexão de gateway desejada e, em seguida, selecione Editar conexão de API.Select the gateway connection you want, and then select Edit API connection.

    Dica

    Se as atualizações não entrarem em vigor, tente parar e reiniciar a conta de serviço do Windows de gateway para a instalação do gateway.If your updates don't take effect, try stopping and restarting the gateway Windows service account for your gateway installation.

Para localizar todas as conexões de API associadas à sua assinatura do Azure:To find all API connections associated with your Azure subscription:

  • No menu portal do Azure, selecione todos os serviços > conexões de APIde > Web .From the Azure portal menu, select All services > Web > API Connections.
  • Ou, no menu portal do Azure, selecione todos os recursos.Or, from the Azure portal menu, select All resources. Defina o filtro de tipo como conexão de API.Set the Type filter to API Connection.

Excluir recurso de gatewayDelete gateway resource

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, você pode excluir o recurso de gateway sem afetar a instalação do gateway.To create a different gateway resource, link your gateway installation to a different gateway resource, or remove the gateway resource, you can delete the gateway resource without affecting the gateway installation.

  1. No menu portal do Azure, selecione todos os recursosou pesquise e selecione todos os recursos em qualquer página.From the Azure portal menu, select All resources, or search for and select All resources from any page. Localize e selecione o recurso de gateway.Find and select your gateway resource.

  2. Se ainda não estiver selecionado, no menu de recursos do gateway, selecione Gateway de dados local.If not already selected, on your gateway resource menu, select On-premises Data Gateway. Na barra de ferramentas de recursos do gateway, selecione excluir.On the gateway resource toolbar, select Delete.

    Por exemplo:For example:

    Excluir recurso de gateway no Azure

Perguntas mais frequentesFrequently asked questions

P: por que minha instalação de gateway não aparece quando crio meu recurso de gateway no Azure?Q: Why doesn't my gateway installation appear when I create my gateway resource in Azure?
R: esse problema pode ocorrer por esses motivos:A: This issue can happen for these reasons:

  • Sua conta do Azure deve ser a mesma conta vinculada à instalação do gateway no computador local.Your Azure account must be the same account that's linked to the gateway installation on the local computer. Verifique se você está conectado ao portal do Azure com a mesma identidade vinculada à instalação do gateway.Check that you're signed in to the Azure portal with the same identity that's linked to the gateway installation. Além disso, verifique se sua conta do Azure pertence a um único locatário ou diretório do Azure ad e está definida para o mesmo diretório ou locatário do Azure AD que foi usado durante a instalação do gateway.Also, make sure that your Azure account belongs to a single Azure AD tenant or directory and is set to the same Azure AD tenant or directory that was used during gateway installation.

  • O recurso de gateway e a instalação do gateway precisam usar a mesma região.Your gateway resource and gateway installation have to use the same region. No entanto, o local do aplicativo lógico pode ser diferente do local do recurso do gateway.However, your logic app location can differ from your gateway resource location.

  • A instalação do gateway já está registrada e reivindicada por outro recurso de gateway.Your gateway installation is already registered and claimed by another gateway resource. Essas instalações não aparecerão na lista nome da instalação .These installations won't appear in the Installation Name list. Para examinar os registros de gateway no portal do Azure, encontre todos os recursos do Azure que têm o tipo de gateways de dados local em todas as suas assinaturas do Azure.To review your gateway registrations in the Azure portal, find all your Azure resources that have the On-premises Data Gateways type across all your Azure subscriptions. Para desvincular a instalação do gateway do outro recurso de gateway, consulte excluir recurso de gateway.To unlink the gateway installation from the other gateway resource, see Delete gateway resource.

P: por que o local para meu gateway existente foi alterado?Q: Why did the location for my existing gateway change?
R: os recursos de gateway criados antes de 3 de maio de 2017 foram movidos para os locais originais do locatário do Azure ad para a conta corporativa ou de estudante que criou esses gateways.A: Gateway resources created before May 3, 2017 were moved to the original locations of the Azure AD tenant for the work or school account that created those gateways. No entanto, essas alterações não devem afetar os aplicativos lógicos em execução no momento, o que deve continuar funcionando normalmente.However, these changes shouldn't affect currently running logic apps, which should continue working as usual. Com a disponibilidade geral do gateway em maio, os locais de recursos do gateway podem diferir dos locais dos aplicativos lógicos.With the gateway's general availability in May, gateway resource locations can differ from logic app locations.

Passos seguintesNext steps