Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op: Azure Logic Apps (Verbruik + Standard)
Wanneer je geautomatiseerde integratieworkflow moet werken met bronnen in je DB2-database, gebruik dan een DB2-connector om bewerkingen op je database uit te voeren. Je workflow kan bijvoorbeeld tabellen of rijen weergeven, rijen toevoegen, rijen bijwerken, rijen verwijderen, queries uitvoeren en opgeslagen procedures uitvoeren. Met deze acties kunnen gegevens uit uw database worden geretourneerd voor andere acties in uw werkstroom die u kunt gebruiken.
Azure Logic Apps biedt de volgende DB2-connectorversies aan:
- Managed connector: Beschikbaar voor consumptie- en standaardworkflows. Voor een on-premises DB2-server vereist deze connector de on-premises datagateway.
- Ingebouwde connector: Alleen beschikbaar voor standaardworkflows. Deze connector draait in-process met de runtime van Azure Logic Apps en maakt direct verbinding met DB2 via TCP/IP zonder de on-premises datagateway.
Beide versies communiceren met externe DB2-servers via een TCP/IP-netwerk. Je kunt beide versies gebruiken om toegang te krijgen tot clouddatabases zoals IBM DB2 voor Windows die draait in Azure-virtualisatie.
Important
Voor missiekritische systemen die gebruikmaken van standaardworkflows, gebruik de ingebouwde connector. De ingebouwde connector voorkomt de extra gateway-afhankelijkheid en biedt de prestatie- en doorvoervoordelen van het in-proces draaien met de Azure Logic Apps-runtime. Gebruik de managed connector wanneer je de specifieke bewerkingen nodig hebt of wanneer je een Consumption-workflow gebruikt.
Deze handleiding beschrijft de werking en de aansluiting voor beide connectorversies.
Ondersteunde platforms en versies
De DB2-connector ondersteunt de volgende IBM DB2-platformen en -versies, samen met IBM DB2-compatibele producten die ondersteuning bieden voor Distributed Relational Database Architecture (DRDA) en SQL Access Manager (SQLAM) versie 10 en 11.
| Platform | Versie |
|---|---|
| IBM DB2 voor z/OS | 12, 11.1, 10.1 |
| IBM DB2 voor i | 7.4, 7.3, 7.2, 7.1 |
| IBM DB2 voor LUW | 11.5, 11.1, 10.5 |
Technische naslaggids voor connector
De DB2-connector heeft verschillende versies, afhankelijk van het type logische app en de hostomgeving.
| Logic App | Environment | Verbindingsversie |
|---|---|---|
| Verbruik | Multi-tenant Azure Logic Apps | Beheerde connector, die wordt weergegeven in de connectorgalerij onder het gedeelde filter. Deze connector biedt alleen acties, geen triggers. Voor een on-premises DB2-server vereist de beheerde connector de on-premises datagateway. Zie de volgende documentatie voor meer informatie: - Naslaginformatie voor DB2-beheerde connector - Beheerde connectors in Azure Logic Apps |
| Standard | Workflow Service Plan, App Service Environment v3 (ASE v3 met alleen Windows-plannen), en hybride deployment op Azure Arc-enabled Kubernetes | Beheerde connector, die in de connectorengalerie onder het filter Gedeeld verschijnt, en ingebouwde connector, die in de connectorengalerie onder het filter Ingebouwd verschijnt en is gebaseerd op serviceproviders. Beide versies bieden alleen acties, geen triggers. Voor missiekritische workloads gebruik je de ingebouwde connector, die in-process draait met de Azure Logic Apps runtime en direct verbinding maakt met DB2 via TCP/IP zonder de on-premises datagateway. Zie de volgende documentatie voor meer informatie: - Referentie van de beheerde DB2-connector - Naslaginformatie over de ingebouwde DB2-connector - Ingebouwde connectors in Azure Logic Apps |
Beheerde connectorbewerkingen
De DB2 managed connector ondersteunt de volgende databasebewerkingen, die worden gekoppeld aan de bijbehorende acties in de connector:
| Databasebewerking | Verbindingslijnactie |
|---|---|
| Databasetabellen weergeven | Tabellen ophalen |
| Eén rij lezen met SELECT | Rij ophalen |
| Alle rijen lezen met SELECT | Rijen ophalen |
| Eén rij toevoegen met INSERT | Rij invoegen |
| Eén rij bewerken met UPDATE | Rij bijwerken |
| Eén rij verwijderen met DELETE | Rij verwijderen |
Voor meer informatie over de beheerde connector en deze acties, raadpleeg naslaginformatie over de beheerde DB2-connector.
Ingebouwde connectoroperaties
De ingebouwde DB2-connector ondersteunt de volgende acties:
| Action | Beschrijving |
|---|---|
| DB2-tabellen | Geef tabellen terug in een DB2-schema. |
| Rij verwijderen | Verwijder één of meer rijen. |
| Een opgeslagen procedure uitvoeren | Voer een opgeslagen procedure uit en geef de output terug. |
| Voer non-query uit | Voer een SQL-instructie uit die geen resultaatset teruggeeft. |
| Query uitvoeren | Voer een SQL-query uit en geef de resultaatset terug. |
| Rij invoegen | Voeg een rij in in een DB2-tabel. |
| Rijen bijwerken | Werk één of meer rijen bij in een DB2-tabel. |
Voor meer informatie over de ingebouwde connector en deze acties raadpleegt u Naslaginformatie voor de ingebouwde DB2-connector.
Vereisten
Een Azure-account en -abonnement. Ontvang een gratis Azure-account.
Een IBM DB2-database, in de cloud of on-premises.
De resource en werkstroom van de logische app van waaruit u toegang wilt krijgen tot uw DB2-database.
De DB2-connector biedt alleen acties. Als u een lege werkstroom hebt, moet u eerst een trigger toevoegen die het beste werkt voor uw scenario.
In de voorbeelden in deze handleiding wordt de trigger Recurrence gebruikt.
Voor meer informatie, zie:
De aansluitingsvereisten hangen af van de connectorversie:
Managed connector: Om verbinding te maken met een on-premises DB2-database, installeer en configureer je eerst de on-premises gegevensgateway. De gateway is niet nodig wanneer de DB2-server openbaar beschikbaar is of toegankelijk is in Azure.
Ingebouwde connector: De lokale gegevensgateway is niet nodig. De standaard logica-app hostingomgeving heeft netwerktoegang nodig tot de DB2-server en poort.
Voeg een DB2 managed connector-actie toe
Het volgende voorbeeld gebruikt de DB2 managed connector en laat zien hoe je de Get Tables actie toevoegt. Om de ingebouwde connector met een standaardworkflow te gebruiken, kies je Ingebouwd in de connectorgalerij en selecteer je vervolgens een ingebouwde DB2-actie, zoals DB2-tabellen.
Opmerking
De stappen voor het toevoegen van een andere DB2-actie zijn vergelijkbaar, met uitzondering van de parameters en waarden van de actie die u opgeeft.
Open in de Azure-portal uw logic app-resource en werkstroom in de ontwerper.
Volg de algemene stappen om de DB2-actie met de naam Tabellen ophalen toe te voegen.
Het deelvenster verbindingsgegevens wordt geopend, zodat u details kunt opgeven om verbinding te maken met uw DB2-database.
Volg de stappen om een verbinding te maken voor een clouddatabase of on-premises database en ga vervolgens terug om door te gaan.
Nadat u de verbinding hebt gemaakt, wordt het deelvenster Actiegegevens van tabellen ophalen weergegeven en wordt aangegeven dat er geen andere informatie nodig is:
Ga door naar Uw werkstroom testen en uitvoertabellen weergeven.
Stel een verbinding op voor de DB2 managed connector
Volg de stappen op basis van of u een cloud- of on-premises DB2-database hebt. Nadat u de benodigde verbindingsgegevens hebt opgegeven, selecteert u Nieuwe maken en gaat u terug naar de vorige stappen.
Voordat je een managed connector-verbinding maakt naar een on-premises database, zorg ervoor dat je de on-premises datagateway installeert en opzet. Deze gateway-eis geldt niet voor de ingebouwde connector.
| Eigenschap | Vereist | Beschrijving |
|---|---|---|
| Verbinding maken via on-premises gateway | Nee | Alleen van toepassing op on-premises verbindingen. |
| Naam verbinding | Ja | De naam voor uw verbinding, bijvoorbeeld DB2-connection. |
| Server | Ja | Het adres of alias en poortnummer van je DB2-server bijvoorbeeld myDB2server.example.com:50000. Opmerking: Deze waarde is een tekenreeks die een TCP/IP-adres of alias vertegenwoordigt, ofwel in IPv4- of IPv6-indeling, gevolgd door een dubbele punt en een TCP/IP-poortnummer. |
| Database | Ja | De naam voor uw database. Opmerking: Deze waarde is een tekenreeks die een DRDA Relationele databasenaam (RDBNAM) vertegenwoordigt: - DB2 voor z/OS accepteert een tekenreeks van 16 bytes waarbij de database bekend staat als een IBM DB2 voor z/OS-locatie . - DB2 voor i accepteert een tekenreeks van 18 bytes, waarbij de database bekend staat als een IBM DB2 voor i relationele database. - DB2 voor LUW accepteert een tekenreeks van 8 bytes. |
| Gebruikersnaam | Ja | Uw gebruikersnaam voor de database. Opmerking: Deze waarde is een tekenreeks waarvan de lengte is gebaseerd op de specifieke database: - DB2 voor z/OS accepteert een tekenreeks van 8 bytes. - DB2 voor i accepteert een tekenreeks van 10 bytes. - DB2 voor Linux of UNIX accepteert een tekenreeks van 8 bytes. - DB2 voor Windows accepteert een tekenreeks van 30 bytes. |
| Wachtwoord | Ja | Uw wachtwoord voor de database. |
Voorbeeld:
Stel een verbinding op voor de ingebouwde DB2-connector
Voor missiekritische Standard-workflows gebruik je de ingebouwde connector. De ingebouwde connector verbindt direct vanuit de Azure Logic Apps-runtime met je DB2-server via TCP/IP en gebruikt niet de on-premises datagateway. Zorg ervoor dat de Standard logic app hostingomgeving netwerktoegang heeft tot de DB2-server en poort.
Selecteer in de workflow-designer Ingebouwd, selecteer de DB2-actie die je wilt en maak een verbinding. Geef de volgende informatie die van toepassing is op uw DB2-omgeving:
| Eigenschap | Beschrijving |
|---|---|
| Naam verbinding | De naam voor de verbinding. |
| servernaam | De naam van de DB2-server. |
| Poortnummer | Het databasepoortnummer op de DB2-server. |
| Database | De databasenaam op de DB2-server. |
| Gebruikersnaam | De gebruikersnaam voor toegang tot de DB2-server. |
| Wachtwoord | Het wachtwoord voor de DB2-gebruikersnaam. |
| Pakketverzameling | De pakketinzaaming. Gebruikt standaard de gebruikersnaam als dit veld leeg is. |
| Standaardschema | Het standaardschema voor schemaoproepen wordt, indien leeg, standaard ingesteld op de gebruikersnaam. |
| Host-CCSID | De host-gecodeerde tekensetidentificatie (CCSID) voor de DB2-database staat standaard op 1208 als deze leeg is. |
| PC-codetabel | De pc-codepagina voor de DB2-verbinding staat standaard op 1208 als deze leeg is. |
| Aanvullende sleutelwoorden voor verbindingsreeksen | Optionele verbindingsreeks-sleutelwoorden, gescheiden door puntkomma's. |
| Verbindingsstring | De DB2-verbindingsreeks; als deze niet leeg is, worden de overige eigenschappen genegeerd. |
Uw werkstroom testen en uitvoertabellen weergeven
Het volgende voorbeeld toont output van de Get Tables-actie van de beheerde connector. Je kunt een workflow testen die een ingebouwde connectoractie gebruikt, op dezelfde manier. Als u uw werkstroom handmatig wilt uitvoeren, selecteert u in de lijst Uitvoeren op de werkbalk van de ontwerper de optie Uitvoeren. Nadat de werkstroom is voltooid, kunt u de uitvoer van de uitvoering bekijken.
Als de pagina met uitvoeringsdetails niet wordt geopend, volgt u deze stappen op basis van uw logische app:
Verbruik: Selecteer in de zijbalk van de logische app onder Ontwikkelhulpprogramma's de ontwerpfunctie voor logische apps.
Standaard: Selecteer op de zijbalk van de werkstroom de optie Uitvoeringsgeschiedenis.
Selecteer in de lijst Uitvoeringsgeschiedenis de meest recente werkstroomuitvoering, bijvoorbeeld:
Verbruik
Standard
Controleer op de pagina met uitvoeringsdetails de status voor elke stap in uw werkstroom. Als u de invoer en uitvoer voor elke stap wilt weergeven, selecteert u die stap, bijvoorbeeld:
Als u de invoer in JSON wilt weergeven, selecteert u Onbewerkte invoer weergeven.
Als u de uitvoer in JSON wilt weergeven, selecteert u Onbewerkte uitvoer weergeven.
De uitvoer bevat een lijst met tabellen, bijvoorbeeld:
