Herstellen einer Verbindung mit lokalen Datenquellen in Azure Logic AppsConnect to on-premises data sources from Azure Logic Apps

Nachdem Sie das lokale Datengateway auf einem lokalen Computer installiert haben, müssen Sie für Ihre Gatewayinstallation eine Gatewayressource in Azure erstellen, um aus Ihren Logik-Apps lokal auf Datenquellen zugreifen zu können.After you install the on-premises data gateway on a local computer and before you can access data sources on premises from your logic apps, you need to create a gateway resource in Azure for your gateway installation. Anschließend können Sie diese Gatewayressource in den Triggern und Aktionen auswählen, die Sie für die lokalen Connectors verwenden möchten, die in Azure Logic Apps verfügbar sind.You can then select this gateway resource in the triggers and actions that you want to use for the on-premises connectors available in Azure Logic Apps. Azure Logic Apps unterstützt Lese- und Schreibvorgänge über das Datengateway.Azure Logic Apps supports read and write operations through the data gateway. Allerdings besitzen diese Vorgänge Limits hinsichtlich Ihrer Nutzlastgröße.However, these operations have limits on their payload size.

In diesem Artikel wird gezeigt, wie Sie Ihre Azure-Gatewayressource für ein zuvor installiertes Gateway auf Ihren lokalen Computer erstellen.This article shows how to create your Azure gateway resource for a previously installed gateway on your local computer. Weitere Informationen zum Gateway finden Sie unter So funktioniert das Gateway.For more information about the gateway, see How the gateway works.

Tipp

Wenn direkt auf lokale Ressourcen in virtuellen Azure-Netzwerken zugegriffen werden soll, ohne das Gateway verwenden zu müssen, können Sie stattdessen eine Integrationsdienstumgebung in Betracht ziehen.To directly access on-premises resources in Azure virtual networks without having to use the gateway, consider creating an integration service environment instead.

Informationen zum Verwenden des Gateways mit anderen Diensten finden Sie in den folgenden Artikeln:For information about how to use the gateway with other services, see these articles:

Unterstützte DatenquellenSupported data sources

In Azure Logic Apps unterstützt das lokale Datengateway lokale Connectors für die folgenden Datenquellen:In Azure Logic Apps, the on-premises data gateway supports the on-premises connectors for these data sources:

  • BizTalk Server 2016BizTalk Server 2016
  • DateisystemFile System
  • IBM DB2IBM DB2
  • IBM InformixIBM Informix
  • IBM MQIBM MQ
  • MySQLMySQL
  • Oracle-DatenbankOracle Database
  • PostgreSQLPostgreSQL
  • SAPSAP
  • SharePoint ServerSharePoint Server
  • SQL ServerSQL Server
  • TeradataTeradata

Sie können auch benutzerdefinierte Connectors erstellen, die mithilfe von REST oder SOAP über HTTP oder HTTPS eine Verbindung mit Datenquellen herstellen.You can also create custom connectors that connect to data sources over HTTP or HTTPS by using REST or SOAP. Obwohl das Gateway selbst keine zusätzlichen Kosten verursacht, gilt das Logic Apps-Preismodell für diese Connectors und andere Vorgänge in Azure Logic Apps.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.

VoraussetzungenPrerequisites

  • Sie haben das lokale Datengateway bereits auf einem lokalen Computer installiert.You already installed the on-premises data gateway on a local computer. Diese Gatewayinstallation muss vorhanden sein, bevor Sie eine Gatewayressource erstellen können, die mit dieser Installation verknüpft ist.This gateway installation must exist before you can create a gateway resource that links to this installation.

  • Sie verfügen über dasselbe Azure-Konto und Abonnement, das Sie für Ihre Gatewayinstallation verwendet haben.You have the same Azure account and subscription that you used for your gateway installation. Dieses Azure-Konto muss zu einem einzigen Azure Active Directory-Mandanten oder -Verzeichnis (Azure AD) gehören.This Azure account must belong only to a single Azure Active Directory (Azure AD) tenant or directory. Dasselbe Azure-Konto und Abonnement muss zum Erstellen Ihrer Gatewayressource in Azure verwendet werden. Der Grund dafür ist, dass nur der Gatewayadministrator die Gatewayressource in Azure erstellen kann.You need to use the same Azure account and subscription to create your gateway resource in Azure because only the gateway administrator can create the gateway resource in Azure. Dienstprinzipale werden aktuell nicht unterstützt.Service principals currently aren't supported.

    • Wenn Sie in Azure eine Gatewayressource erstellen, wählen Sie eine Gatewayinstallation aus, die ausschließlich mit Ihrer Gatewayressource verknüpft wird.When you create a gateway resource in Azure, you select a gateway installation to link with your gateway resource and only that gateway resource. Eine Gatewayressource kann nur mit einer einzigen Gatewayinstallation verknüpft sein.Each gateway resource can link to only one gateway installation. Gatewayinstallationen, die bereits anderen Gatewayressourcen zugeordnet sind, können nicht ausgewählt werden.You can't select a gateway installation that's already associated with another gateway resource.

    • Ihre Logik-App und Gatewayressource müssen nicht zum selben Azure-Abonnement gehören.Your logic app and gateway resource don't have to exist in the same Azure subscription. Sofern Sie über Abonnementzugriff verfügen, können Sie in Triggern und Aktionen, die auf lokale Datenquellen zugreifen können, andere Azure-Abonnements mit Gatewayressourcen auswählen.Provided that you have subscription access, in triggers and actions that can access on-premises data sources, you can select other Azure subscriptions that have gateway resources.

Erstellen einer Azure-GatewayressourceCreate Azure gateway resource

Nachdem Sie das Gateway auf einem lokalen Computer installiert haben, erstellen Sie eine Azure-Ressource für Ihr Gateway.After you install the gateway on a local computer, create the Azure resource for your gateway.

  1. Melden Sie sich am Azure-Portal mit dem gleichen Azure-Konto an, das beim Installieren des Gateways verwendet wurde.Sign in to the Azure portal with the same Azure account that was used to install the gateway.

  2. Geben Sie im Suchfeld des Azure-Portals den Begriff „lokales Datengateway“ ein, und wählen Sie dann Lokale Datengateways aus.In the Azure portal search box, enter "on-premises data gateway", and select On-premises Data Gateways.

    Nach „Lokales Datengateway“ suchen

  3. Wählen Sie unter Lokale Datengateways die Option Hinzufügen aus.Under On-premises Data Gateways, select Add.

    Hinzufügen neuer Azure-Ressource für das Datengateway

  4. Geben Sie unter Verbindungsgateway erstellen die folgenden Informationen für Ihre Gatewayressource an.Under Create connection gateway, provide this information for your gateway resource. Wählen Sie Erstellen, wenn Sie fertig sind.When you're done, select Create.

    EigenschaftProperty BESCHREIBUNGDescription
    RessourcennameResource Name Geben Sie einen Namen für Ihre Gatewayressource an, der nur Buchstaben, Ziffern, Bindestriche (-), Unterstriche (_), Klammern ((, )) und Punkte (.) enthalten darf.Provide a name for your gateway resource that contains only letters, numbers, hyphens (-), underscores (_), parentheses ((, )), or periods (.).
    AbonnementSubscription Wählen Sie das Azure-Abonnement für das Azure-Konto aus, das für die Gatewayinstallation verwendet wurde.Select the Azure subscription for the Azure account that was used for the gateway installation. Das standardmäßige Abonnement basiert auf dem Azure-Konto, das Sie zum Anmelden verwendet haben.The default subscription is based on the Azure account that you used to sign in.
    RessourcengruppeResource group Die Azure-Ressourcengruppe, die Sie verwenden möchten.The Azure resource group that you want to use
    LocationLocation Die gleiche Region oder der gleiche Standort, der während der Gatewayinstallation für den Gatewayclouddienst ausgewählt wurde.The same region or location that was selected for the gateway cloud service during gateway installation. Andernfalls wird Ihre Gatewayinstallation nicht in der Liste Installationsname angezeigt.Otherwise, your gateway installation won't appear in the Installation Name list. Der Standort Ihrer Logik-App kann sich vom Standort Ihrer Gatewayressource unterscheiden.Your logic app location can differ from your gateway resource location.
    InstallationsnameInstallation Name Wählen Sie eine Gatewayinstallation aus, die in der Liste nur angezeigt wird, wenn die folgenden Bedingungen erfüllt sind:Select a gateway installation, which appears in the list only when these conditions are met:

    – Die Gatewayinstallation verwendet dieselbe Region wie die Gatewayressource, die Sie erstellen möchten.- The gateway installation uses the same region as the gateway resource that you want to create.
    – Die Gatewayinstallation ist nicht mit einer anderen Azure-Gatewayressource verknüpft.- The gateway installation isn't linked to another Azure gateway resource.
    – Die Gatewayinstallation ist mit demselben Azure-Konto verknüpft, das Sie zum Erstellen der Gatewayressource verwenden.- The gateway installation is linked to the same Azure account that you're using to create the gateway resource.
    – Ihr Azure-Konto gehört zu einem einzigen Azure Active Directory-Mandanten oder -Verzeichnis (Azure AD) und ist dasselbe Konto, das für die Gatewayinstallation verwendet wurde.- Your Azure account belongs to a single Azure Active Directory (Azure AD) tenant or directory and is the same account that you used for the gateway installation.

    Weitere Informationen finden Sie im Abschnitt Häufig gestellte Fragen.For more information, see the Frequently asked questions section.

    Im folgenden Beispiel wird eine Gatewayinstallation gezeigt, die sich in derselben Region wie die Gatewayressource befindet und mit demselben Azure-Konto verknüpft ist: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:

    Angeben von Details zum Erstellen der Datengatewayressource

Herstellen einer Verbindung mit lokalen DatenConnect to on-premises data

Nachdem Sie die Gatewayressource erstellt und Ihr Azure-Abonnement mit dieser Ressource verknüpft haben, können Sie jetzt mit dem Gateway eine Verbindung zwischen Ihrer Logik-App und Ihrer lokalen Datenquelle herstellen.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. Erstellen oder öffnen Sie im Azure-Portal Ihre Logik-App im Logik-App-Designer.In the Azure portal, create or open your logic app in the Logic App Designer.

  2. Fügen Sie einen Connector hinzu, der lokale Verbindungen unterstützt, z.B. SQL Server.Add a connector that supports on-premises connections, for example, SQL Server.

  3. Wählen Sie Verbinden über lokales Datengateway.Select Connect via on-premises data gateway.

  4. Wählen Sie unter Gateways in der Liste Abonnements Ihr Azure-Abonnement aus, das über die gewünschte Gatewayressource verfügt.Under Gateways, from the Subscriptions list, select your Azure subscription that has the gateway resource you want.

    Sofern Sie über Abonnementzugriff verfügen, können Sie aus unterschiedlichen Azure-Abonnements auswählen, die jeweils einer anderen Gatewayressource zugeordnet sind.Provided that you have subscription access, you can select from different Azure subscriptions that are each associated with a different gateway resource. Ihre Logik-App und Gatewayressource müssen nicht zum selben Azure-Abonnement gehören.Your logic app and gateway resource don't have to exist in the same Azure subscription.

  5. Wählen Sie in der Liste Verbindungsgateway, in der die verfügbaren Gatewayressourcen in Ihrem ausgewählten Abonnement angezeigt werden, die gewünschte Gatewayressource aus.From the Connection Gateway list, which shows the available gateway resources in your selected subscription, select the gateway resource that you want. Jede Gatewayressource ist mit einer einzelnen Gatewayinstallation verknüpft.Each gateway resource is linked to a single gateway installation.

    Hinweis

    Die Liste der Gateways enthält Gatewayressourcen in anderen Regionen, da sich der Standort Ihrer Logik-App vom Standort Ihrer Gatewayressource unterscheiden kann.The gateways list includes gateway resources in other regions because your logic app's location can differ from your gateway resource's location.

  6. Geben Sie einen eindeutigen Verbindungsnamen und andere erforderliche Informationen an, die von der zu erstellenden Verbindung abhängig sind.Provide a unique connection name and other required information, which depends on the connection that you want to create.

    Ein eindeutiger Verbindungsname vereinfacht später das Identifizieren dieser Verbindung. Dies gilt insbesondere dann, wenn Sie mehrere Verbindungen erstellen.A unique connection name helps you easily find that connection later, especially if you create multiple connections. Sofern erforderlich, geben Sie auch die qualifizierte Domäne für Ihren Benutzernamen an.If applicable, also include the qualified domain for your username.

    Beispiel:Here is an example:

    Erstellen der Verbindung zwischen der Logik-App und dem Datengateway

  7. Wählen Sie Erstellen, wenn Sie fertig sind.When you're done, select Create.

Die Gatewayverbindung kann nun für Ihre Logik-App verwendet werden.Your gateway connection is now ready for your logic app to use.

Bearbeiten der VerbindungEdit connection

Zum Aktualisieren der Einstellungen für eine Gatewayverbindung können Sie die Verbindung bearbeiten.To update the settings for a gateway connection, you can edit your connection.

  1. Um alle API-Verbindungen nur für Ihre Logik-App zu suchen, wählen Sie im Menü Ihrer Logik-App unter Entwicklungstools die Option API-Verbindungen aus.To find all the API connections for just your logic app, on your logic app's menu, under Development Tools, select API connections.

    Wählen Sie im Menü Ihrer Logik-App „API-Verbindungen“ aus.

  2. Wählen Sie die gewünschte Gatewayverbindung und dann API-Verbindung bearbeiten aus.Select the gateway connection you want, and then select Edit API connection.

    Tipp

    Sollten Ihre Aktualisierungen nicht wirksam werden, beenden Sie das Gateway-Windows-Dienstkonto für Ihre Gatewayinstallation, und starten Sie es dann neu.If your updates don't take effect, try stopping and restarting the gateway Windows service account for your gateway installation.

So suchen Sie alle API-Verbindungen, die mit Ihrem Azure-Abonnement verknüpft sind:To find all API connections associated with your Azure subscription:

  • Wählen Sie im Menü des Azure-Portals Alle Dienste > Web > API-Verbindungen aus.From the Azure portal menu, select All services > Web > API Connections.
  • Sie können im Menü des Azure-Portals auch Alle Ressourcen auswählen.Or, from the Azure portal menu, select All resources. Legen Sie Filter Typ auf API-Verbindung fest.Set the Type filter to API Connection.

Löschen der GatewayressourceDelete gateway resource

Um eine andere Gatewayressource zu erstellen, Ihre Gatewayinstallation mit einer anderen Gatewayressource zu verknüpfen oder die Gatewayressource zu entfernen, können Sie die Gatewayressource löschen, ohne dass sich dies auf die Gatewayinstallation auswirkt.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. Wählen Sie im Menü des Azure-Portals die Option Alle Ressourcen aus, oder suchen Sie Alle Ressourcen auf einer beliebigen Seite, und wählen Sie die Option aus.From the Azure portal menu, select All resources, or search for and select All resources from any page. Suchen Sie Ihre Gatewayressource, und wählen Sie sie aus.Find and select your gateway resource.

  2. Wenn nicht bereits ausgewählt, wählen Sie in Ihrem Gatewayressourcenmenü Lokales Datengateway aus.If not already selected, on your gateway resource menu, select On-premises Data Gateway. Wählen Sie auf der Gatewayressourcen-Symbolleiste die Option Löschen aus.On the gateway resource toolbar, select Delete.

    Beispiel:For example:

    Löschen der Gatewayressource in Azure

Häufig gestellte FragenFrequently asked questions

F: Warum wird meine Gatewayinstallation nicht angezeigt, wenn ich die Gatewayressource in Azure erstelle?Q: Why doesn't my gateway installation appear when I create my gateway resource in Azure?
A: Dieses Problem kann folgende Ursachen haben:A: This issue can happen for these reasons:

  • Bei Ihrem Azure-Konto handelt es sich nicht um dasselbe Konto, das für die Gatewayinstallation auf Ihrem lokalen Computer verwendet wurde.Your Azure account isn't the same account that you used for the gateway installation on your local computer. Überprüfen Sie, ob Sie mit derselben Identität beim Azure-Portal angemeldet sind, die für die Gatewayinstallation verwendet wurde.Check that you signed in to the Azure portal with the same identity that you used for the gateway installation. Nur der Gatewayadministrator kann die Gatewayressource in Azure erstellen.Only the gateway administrator can create the gateway resource in Azure. Dienstprinzipale werden aktuell nicht unterstützt.Service principals currently aren't supported.

  • Ihr Azure-Konto gehört nicht zu einem einzigen Azure AD-Mandanten oder -Verzeichnis.Your Azure account doesn't belong to only a single Azure AD tenant or directory. Überprüfen Sie, ob Sie denselben Azure AD-Mandanten oder dasselbe Azure AD-Verzeichnis verwenden, den bzw. das Sie während der Gatewayinstallation verwendet haben.Check that you're using the same Azure AD tenant or directory that you used during gateway installation.

  • Ihre Gatewayressource und die Gatewayinstallation befinden sich nicht in derselben Region.Your gateway resource and gateway installation don't exist in the same region. Der Standort Ihrer Logik-App kann jedoch vom Standort Ihrer Gatewayressource abweichen.However, your logic app's location can differ from your gateway resource location.

  • Ihre Gatewayinstallation ist bereits einer anderen Gatewayressource zugeordnet.Your gateway installation is already associated with another gateway resource. Jede Gatewayressource kann nur mit einer Gatewayinstallation verknüpft sein, die wiederum nur mit einem Azure-Konto und einem Abonnement verknüpft ist.Each gateway resource can link to only one gateway installation, which can link to only one Azure account and subscription. Gatewayinstallationen, die bereits anderen Gatewayressourcen zugeordnet sind, können also nicht ausgewählt werden.So, you can't select a gateway installation that's already associated with another gateway resource. Diese Installationen werden nicht in der Liste Installationsname angezeigt.These installations won't appear in the Installation Name list.

    Sehen Sie sich zum Überprüfen der Gatewayregistrierungen im Azure-Portal alle Azure-Ressourcen mit dem Ressourcentyp Lokale Datengateways für alle Ihre Azure-Abonnements an.To review your gateway registrations in the Azure portal, find all your Azure resources that have the On-premises Data Gateways resource type across all your Azure subscriptions. Informationen zum Aufheben der Verknüpfung der Gatewayinstallation mit der anderen Gatewayressource finden Sie unter Löschen der Gatewayressource.To unlink the gateway installation from the other gateway resource, see Delete gateway resource.

F: Warum hat sich der Standort für mein vorhandenes Gateway geändert?Q: Why did the location for my existing gateway change?
A: Vor dem 3. Mai 2017 erstellte Gatewayressourcen wurden an die ursprünglichen Standorte des Azure AD-Mandanten für das Geschäfts-, Schul- oder Unikonto verschoben, das diese Gateways erstellt hat.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. Diese Änderungen sollten jedoch keine Auswirkung auf derzeit ausgeführte Logik-Apps haben, und diese werden in der Regel weiterhin wie gewohnt ausgeführt.However, these changes shouldn't affect currently running logic apps, which should continue working as usual. Aufgrund der allgemeinen Verfügbarkeit des Gateways im Mai können sich die Standorte der Gatewayressourcen von den Standorten der Logik-Apps unterscheiden.With the gateway's general availability in May, gateway resource locations can differ from logic app locations.

Nächste SchritteNext steps