Verbinding maken met SQL-databases vanuit werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Deze handleiding laat zien hoe u toegang krijgt tot uw SQL-database vanuit een werkstroom in Azure Logic Apps met behulp van de SQL Server-connector. Vervolgens kunt u geautomatiseerde werkstromen maken die worden uitgevoerd wanneer ze worden geactiveerd door gebeurtenissen in uw SQL-database of in andere systemen, en acties uitvoeren om uw SQL-gegevens en -resources te beheren.

Uw werkstroom kan bijvoorbeeld acties uitvoeren waarmee gegevens worden opgehaald, ingevoegd en verwijderd of waarmee SQL-query's en opgeslagen procedures kunnen worden uitgevoerd. Uw werkstroom kan controleren op nieuwe records in een niet-SQL-database, enige verwerkingswerkzaamheden uitvoeren, de resultaten gebruiken om nieuwe records in uw SQL-database te maken en e-mailwaarschuwingen over de nieuwe records verzenden.

Zie de volgende artikelen om aan de slag te gaan als u nieuw bent bij Azure Logic Apps.

• Wat is Azure Logic Apps?
• Quickstart: Een voorbeeld van een werkstroom voor logische verbruiks-apps maken met behulp van de Azure-portal
• Een voorbeeld van een standaardwerkstroom voor logische apps maken met behulp van Azure Portal

Ondersteunde SQL-edities

De SQL Server-connector ondersteunt de volgende SQL-edities:

• SQL Server
• Azure SQL-database
• Azure SQL Managed Instance

Technische naslaginformatie over connectoren

De SQL Server-connector heeft verschillende versies, op basis van het type logische app en de hostomgeving.

Beperkingen

Raadpleeg de naslaginformatie voor de beheerde SQL Server-connector of de naslaginformatie over de ingebouwde SQL Server-connector voor meer informatie.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.

• SQL Server-database, Azure SQL Database of SQL Managed Instance.

  De SQL Server-connector vereist dat uw tabellen gegevens bevatten, zodat de connectorbewerkingen resultaten kunnen retourneren wanneer ze worden aangeroepen. Als u bijvoorbeeld Azure SQL Database gebruikt, kunt u de opgenomen voorbeelddatabases gebruiken om de bewerkingen van de SQL Server-connector uit te voeren.

• De informatie die nodig is om een SQL-databaseverbinding te maken, zoals uw SQL-server en databasenaam. Als u Windows-verificatie of SQL Server-verificatie gebruikt om toegang te verifiëren, hebt u ook uw gebruikersnaam en wachtwoord nodig. U kunt deze informatie meestal vinden in de verbindingsreeks.

  Belangrijk

  Als u een SQL Server-verbindingsreeks gebruikt die u rechtstreeks vanuit Azure Portal hebt gekopieerd, moet u uw wachtwoord handmatig toevoegen aan de verbindingsreeks. Voor gevoelige informatie, zoals deze tekenreeks, moet u de veiligste verificatiestroom gebruiken die beschikbaar is. Microsoft raadt u aan om de toegang tot Azure-resources te verifiëren met een beheerde identiteit , indien mogelijk, en een rol toe te wijzen met de minimale bevoegdheid die nodig is.

  Als deze mogelijkheid niet beschikbaar is, moet u verbindingsreeks beveiligen via andere metingen, zoals Azure Key Vault, die u kunt gebruiken met app-instellingen in Standaardwerkstromen. U kunt vervolgens rechtstreeks verwijzen naar beveiligde tekenreeksen, zoals verbindingsreeks s en sleutels. Net als bij ARM-sjablonen, waar u omgevingsvariabelen tijdens de implementatie kunt definiëren, kunt u app-instellingen definiëren binnen de werkstroomdefinitie van uw standaard logische app. Vervolgens kunt u dynamisch gegenereerde infrastructuurwaarden vastleggen, zoals verbindingseindpunten, opslagreeksen en meer. Zie Toepassingstypen voor het Microsoft Identity Platform voor meer informatie.

  • Voor een SQL-database in Azure heeft de verbindingsreeks de volgende indeling:

    Server=tcp:{your-server-name}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

    1. Als u deze tekenreeks wilt vinden in Azure Portal, opent u uw database.

    2. Selecteer verbindingsreeksen in het databasemenu onder Eigenschappen.

  • Voor een on-premises SQL-server heeft de verbindingsreeks de volgende indeling:

    Server={your-server-address};Database={your-database-name};User Id={your-user-name};Password={your-password};

• Als u in Standaardwerkstromen de ingebouwde SQL-triggers wilt gebruiken, moet u het bijhouden van wijzigingen inschakelen in de tabel waarin u de trigger wilt gebruiken. Zie Wijzigingen bijhouden in- en uitschakelen voor meer informatie.

• De werkstroom van de logische app waar u toegang wilt krijgen tot uw SQL-database. Als u uw werkstroom wilt starten met een SQL Server-trigger, moet u beginnen met een lege werkstroom. Als u een SQL Server-actie wilt gebruiken, start u uw werkstroom met een trigger.

• Als u verbinding wilt maken met een on-premises SQL-server, zijn de volgende extra vereisten van toepassing op basis van het feit of u een werkstroom voor logische apps voor Verbruik of Standard hebt.

  • Werkstroom verbruik:

    In multitenant Azure Logic Apps hebt u de on-premises gegevensgateway nodig die is geïnstalleerd op een lokale computer en een gegevensgatewayresource die al is gemaakt in Azure.

  • Standaardwerkstroom:

    U kunt de ingebouwde SQL Server-connector of beheerde connector gebruiken.

    • Als u Microsoft Entra-verificatie of beheerde identiteitsverificatie met uw logische app wilt gebruiken, moet u uw SQL Server instellen voor gebruik met deze verificatietypen. Zie Verificatie - naslaginformatie over beheerde SQL Server-connectors voor meer informatie.

    • Als u de ingebouwde connector wilt gebruiken, kunt u uw verbinding verifiëren met een beheerde identiteit, Microsoft Entra-id of een verbindingsreeks. U kunt groepsgewijze verbindingen aanpassen door parameters op te geven in de verbindingsreeks. Raadpleeg de groepsgewijze verbindingen voor meer informatie.

    • Als u de beheerde SQL Server-connector wilt gebruiken, volgt u dezelfde vereisten als een werkstroom voor logische apps voor verbruik in Azure Logic Apps met meerdere tenants. Raadpleeg de naslaginformatie over de beheerde SQL Server-connector voor andere connectorvereisten.

Een SQL Server-trigger toevoegen

In de volgende stappen wordt Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te maken:

• Werkstromen voor verbruik: Visual Studio Code
• Standaardwerkstromen: Visual Studio Code

Wanneer u uw werkstroom opslaat, publiceert deze stap automatisch uw updates naar uw geïmplementeerde logische app, die live is in Azure. Met slechts een trigger controleert uw werkstroom alleen de SQL-database op basis van uw opgegeven planning. U moet een actie toevoegen die reageert op de trigger.

Een SQL Server-actie toevoegen

In de volgende stappen wordt Azure Portal gebruikt, maar met de juiste Azure Logic Apps-extensie kunt u ook de volgende hulpprogramma's gebruiken om werkstromen voor logische apps te bouwen:

• Werkstromen voor verbruik: Visual Studio Code
• Standaardwerkstromen: Visual Studio Code

In dit voorbeeld begint de werkstroom van de logische app met de Herhaling trigger, en wordt er een actie uitgevoerd waarbij een rij uit een SQL-database wordt opgehaald.

Verbinding maken met uw database

Wanneer u een trigger of actie toevoegt die verbinding maakt met een service of systeem en u geen bestaande of actieve verbinding hebt, wordt u door Azure Logic Apps gevraagd om de verbindingsgegevens op te geven, die variëren op basis van het verbindingstype, bijvoorbeeld:

• Uw accountreferenties
• Een naam die moet worden gebruikt voor de verbinding
• De naam voor de server of het systeem
• Het te gebruiken verificatietype
• Een verbindingsreeks

Nadat u deze informatie hebt opgegeven, gaat u verder met de volgende stappen op basis van uw doeldatabase:

• Verbinding maken met azure SQL Database of SQL Managed Instance in de cloud
• Verbinding maken met on-premises SQL Server

Verbinding maken met Azure SQL Database of SQL Managed Instance

Als u toegang wilt krijgen tot een met SQL beheerd exemplaar zonder de on-premises gegevensgateway te gebruiken, moet u openbare eindpunten configureren in Azure SQL Managed Instance. Het openbare eindpunt maakt gebruik van poort 3342, dus zorg ervoor dat u dit poortnummer opgeeft wanneer u de verbinding maakt vanuit uw logische app.

Voer in het vak verbindingsgegevens de volgende stappen uit:

1. Geef voor de verbindingsnaam een naam op die u voor uw verbinding wilt gebruiken.

2. Selecteer voor verificatietype de verificatie die vereist is en ingeschakeld voor uw database in Azure SQL Database of SQL Managed Instance:

   Verificatie	Beschrijving
   Verbindingsreeks	Alleen ondersteund in Standard-werkstromen met de ingebouwde SQL Server-connector. Vereist de verbindingsreeks voor uw SQL-server en -database.
   Active Directory OAuth	Alleen ondersteund in Standard-werkstromen met de ingebouwde SQL Server-connector. Zie de volgende documentatie voor meer informatie: - Verificatie voor SQL Server-connector - OAuth 2.0 inschakelen met Microsoft Entra-id
   Beheerde identiteit van Logic Apps	Ondersteund met de beheerde SQL Server-connector. In standaardwerkstromen is dit verificatietype beschikbaar voor de ingebouwde SQL Server-connector, maar in plaats daarvan wordt de optie Beheerde identiteit genoemd. Hiervoor zijn de volgende items vereist: - Een geldige beheerde identiteit die is ingeschakeld voor uw logische app-resource en toegang heeft tot uw database. - Toegang tot de ROL SQL DB-inzender voor de SQL Server-resource --- Inzendertoegang tot de resourcegroep die de SQL Server-resource bevat. Zie de volgende documentatie voor meer informatie: - Verificatie van beheerde identiteit voor SQL Server-connector - Server-Level Rollen
   Service-principal (Microsoft Entra-toepassing)	Ondersteund met de beheerde SQL Server-connector. Hiervoor zijn een Microsoft Entra-toepassing en een service-principalaccount vereist. Zie Een Microsoft Entra-toepassing en service-principal maken die toegang heeft tot resources via Azure Portal voor meer informatie.
   Microsoft Entra geïntegreerd	Ondersteund met de beheerde SQL Server-connector. Vereist een geldige beheerde identiteit in Microsoft Entra die is ingeschakeld voor uw logische app-resource en die toegang heeft tot uw database. Zie de volgende artikelen voor meer informatie: - Overzicht van Azure SQL-beveiliging - Verificatie - Databasetoegang tot Azure SQL autoriseren - Verificatie en autorisatie - Microsoft Entra-verificatie voor Azure SQL
   SQL Server-verificatie	Ondersteund met de beheerde SQL Server-connector. Hiervoor zijn de volgende items vereist: - Een gegevensgateway die eerder in Azure is gemaakt voor het koppelen van uw verbinding, ongeacht of uw logische app zich in de multitenante Azure Logic Apps omgeving bevindt. - Een geldige gebruikersnaam en sterk wachtwoord die zijn gemaakt en opgeslagen in uw SQL Server-database. Zie de volgende artikelen voor meer informatie: - Overzicht van Azure SQL-beveiliging - Verificatie - Databasetoegang tot Azure SQL autoriseren - Verificatie en autorisatie

   In het volgende voorbeeld ziet u hoe het verbindingsinformatievak kan worden weergegeven als u de beheerde SQL Server-connector gebruikt en geïntegreerde Microsoft Entra-verificatie selecteert:

   

3. Nadat u Microsoft Entra geïntegreerd hebt geselecteerd, selecteert u Aanmelden. Selecteer uw gebruikersreferenties voor verificatie op basis van of u Azure SQL Database of SQL Managed Instance gebruikt.

4. Selecteer deze waarden voor uw database:

   Eigenschappen	Vereist	Beschrijving
   Servernaam	Ja	Het adres voor uw SQL-server, bijvoorbeeld Fabrikam-Azure-SQL.database.windows.net
   Databasenaam	Ja	De naam voor uw SQL-database, bijvoorbeeld Fabrikam-Azure-SQL-DB
   Tabelnaam	Ja	De tabel die u wilt gebruiken, bijvoorbeeld SalesLT.Customer

   Aanbeveling

   Als u uw database- en tabelgegevens wilt opgeven, hebt u de volgende opties:

   • Zoek deze informatie in de verbindingsreeks van uw database. Zoek en open bijvoorbeeld uw database in Azure Portal. Selecteer in het databasemenu verbindingsreeksen of eigenschappen, waar u de volgende tekenreeks kunt vinden:

     Server=tcp:{your-server-address}.database.windows.net,1433;Initial Catalog={your-database-name};Persist Security Info=False;User ID={your-user-name};Password={your-password};MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;

   • Tabellen in systeemdatabases worden standaard uitgefilterd, zodat ze mogelijk niet automatisch worden weergegeven wanneer u een systeemdatabase selecteert. Als alternatief kunt u de tabelnaam handmatig invoeren nadat u aangepaste waarde in de databaselijst hebt geselecteerd.

   Dit databaseinformatievak ziet er ongeveer als volgt uit:

   

5. Ga nu verder met de stappen die u nog niet hebt voltooid in het toevoegen van een SQL-trigger of een SQL-actie toevoegen.

Verbinding maken met on-premises SQL Server

Voer in het vak verbindingsgegevens de volgende stappen uit:

1. Zorg ervoor dat u aan deze vereisten voldoet voor verbindingen met uw on-premises SQL-server waarvoor de on-premises gegevensgateway is vereist.

   Anders wordt uw gegevensgatewayresource niet weergegeven in de lijst verbindingsgateway wanneer u de verbinding maakt.

2. Selecteer voor verificatietype de verificatie die vereist is en ingeschakeld op uw SQL Server:

   Verificatie	Beschrijving
   SQL Server-verificatie	Ondersteund met de beheerde SQL Server-connector en de ingebouwde SQL Server-connector. Hiervoor zijn de volgende items vereist: - Een gegevensgateway die eerder in Azure is gemaakt voor het koppelen van uw verbinding, ongeacht of uw logische app zich in de multitenante Azure Logic Apps omgeving bevindt. - Een geldige gebruikersnaam en sterk wachtwoord die zijn gemaakt en opgeslagen in uw SQL Server. Zie SQL Server-verificatie voor meer informatie.
   Windows-verificatie	Ondersteund met de beheerde SQL Server-connector. Hiervoor zijn de volgende items vereist: - Een gegevensgateway die eerder in Azure is gemaakt voor het koppelen van uw verbinding, ongeacht of uw logische app zich in de multitenante Azure Logic Apps omgeving bevindt. - Een geldige Windows-gebruikersnaam en -wachtwoord om uw identiteit te bevestigen via uw Windows-account. Zie Windows-verificatie voor meer informatie.

3. Selecteer of geef de volgende waarden op voor uw SQL-database:

   Eigenschappen	Vereist	Beschrijving
   SQL-servernaam	Ja	Het adres voor uw SQL-server, bijvoorbeeld Fabrikam-Azure-SQL.database.windows.net
   SQL-databasenaam	Ja	De naam voor uw SQL Server-database, bijvoorbeeld Fabrikam-Azure-SQL-DB
   Gebruikersnaam	Ja	Uw gebruikersnaam voor de SQL-server en -database
   Wachtwoord	Ja	Uw wachtwoord voor de SQL-server en -database
   Abonnement	Ja, voor Windows-verificatie	Het Azure-abonnement voor de gegevensgatewayresource die u eerder in Azure hebt gemaakt
   Verbindingsgateway	Ja, voor Windows-verificatie	De naam voor de gegevensgatewayresource die u eerder hebt gemaakt in Azure Tip: Als uw gateway niet wordt weergegeven in de lijst, controleert u of u de gateway juist hebt ingesteld.

   Aanbeveling

   U vindt deze informatie in de verbindingsreeks van uw database:

   • Server={your-server-address}
   • Database={your-database-name}
   • User ID={your-user-name}
   • Password={your-password}

   In het volgende voorbeeld ziet u hoe het vak verbindingsgegevens kan worden weergegeven als u Windows-verificatie selecteert.

   

4. Wanneer u klaar bent, selecteert u Maken.

5. Ga verder met de stappen die u nog niet hebt voltooid in een SQL-trigger toevoegen of een SQL-actie toevoegen.

Bulkgegevens verwerken

Soms werkt u met resultatensets zo groot dat de connector niet alle resultaten tegelijk retourneert. Of u wilt meer controle over de grootte en structuur van uw resultatensets. De volgende lijst bevat enkele manieren waarop u dergelijke grote resultatensets kunt verwerken:

• Schakel paginering in om u te helpen bij het beheren van resultaten als kleinere sets. Zie Meer gegevens, items of records ophalen met behulp van paginering in Azure Logic Apps voor meer informatie. Zie SQL-paginering voor bulkgegevensoverdracht met Logic Apps voor meer informatie.

• Maak een opgeslagen procedure waarmee de resultaten op de gewenste manier worden ingedeeld. De SQL Server-connector biedt veel back-endfuncties die u kunt openen met behulp van Azure Logic Apps, zodat u eenvoudiger zakelijke taken kunt automatiseren die met SQL-databasetabellen werken.

  Wanneer een SQL-actie meerdere rijen ophaalt of invoegt, kan de werkstroom van uw logische app deze rijen herhalen met behulp van een until-lus binnen deze limieten. Wanneer uw logische app echter moet werken met recordsets die zo groot zijn, bijvoorbeeld duizenden of miljoenen rijen, wilt u de kosten minimaliseren die het gevolg zijn van aanroepen naar de database.

  Als u de gewenste resultaten wilt ordenen, kunt u een opgeslagen procedure maken die wordt uitgevoerd in uw SQL-exemplaar en de SELECT - ORDER BY instructie gebruikt. Met deze oplossing hebt u meer controle over de grootte en structuur van uw resultaten. Uw logische app roept de opgeslagen procedure aan met behulp van de actie Opgeslagen procedure uitvoeren van de SQL Server-connector. Zie SELECT - ORDER BY-component voor meer informatie.

  Notitie

  De SQL Server-connector heeft een time-outlimiet voor opgeslagen procedures die minder dan 2 minuten duurt. Sommige opgeslagen procedures kunnen langer duren dan deze limiet, waardoor er een 504 Timeout fout optreedt. U kunt dit probleem omzeilen met behulp van een SQL-voltooiingstrigger, systeemeigen SQL Pass Through-query, een statustabel en taken aan de serverzijde.

  Voor deze taak kunt u de Azure Elastic Job Agent voor Azure SQL Database gebruiken. Voor SQL Server on-premises en SQL Managed Instance kunt u de SQL Server Agent gebruiken. Zie Langlopende opgeslagen proceduretime-outs verwerken in de SQL Server-connector voor Azure Logic Apps voor meer informatie.

Dynamische bulkgegevens verwerken

Wanneer u een opgeslagen procedure aanroept met behulp van de SQL Server-connector, is de geretourneerde uitvoer soms dynamisch. Voer in dit scenario de volgende stappen uit:

1. Open uw logische app en werkstroom in Azure Portal in de ontwerpfunctie.

2. Bekijk de uitvoerindeling door een testuitvoering uit te voeren. Kopieer en sla de voorbeelduitvoer op.

3. Voeg in de ontwerpfunctie, onder de actie waar u de opgeslagen procedure aanroept, de ingebouwde actie met de naam JSON parseren toe.

4. Selecteer in de actie JSON parseren voorbeeldpayload gebruiken om een schema te genereren.

5. Plak in het vak Een voorbeeld van een JSON-nettolading invoeren of plakken de voorbeelduitvoer en selecteer Gereed.

   Notitie

   Als er een foutbericht wordt weergegeven dat Azure Logic Apps geen schema kan genereren, controleert u of de syntaxis van de voorbeelduitvoer juist is opgemaakt. Als u het schema nog steeds niet kunt genereren, voert u in het vak Schema het schema handmatig in.

6. Sla uw werkstroom op als u gereed bent.

7. Volg deze stappen om te verwijzen naar de eigenschappen van de JSON-inhoud:

   1. Selecteer in de bewerkingsvakken waar u naar de JSON-eigenschappen wilt verwijzen.
   2. Selecteer het bliksempictogram om de lijst met dynamische inhoud te openen.
   3. Selecteer in de lijst in de sectie JSON Parseren de gegevenstokens voor de gewenste JSON-inhoudseigenschappen.

Verwante inhoud

• Beheerde connectors voor Azure Logic Apps
• Ingebouwde connectors in Azure Logic Apps