Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Gäller för: Azure Logic Apps (Förbrukning + Standard)
När dina arbetsflöden behöver arbeta med Oracle-data ansluter du till Oracle-databasen med hjälp av Oracle Database-anslutningsappen i Azure Logic Apps. Du kan komma åt databaser som finns lokalt eller på en Azure virtuell dator.
Oracle Database-anslutningsappen hjälper dig att lösa vanliga dataintegreringsuppgifter, till exempel:
- Lägg till kundposter i databasen.
- Uppdatera orderposter i din databas.
- Hämta, infoga eller ta bort tabellrader som en del av arbetsflödet.
Oracle Database-versioner som stöds
I följande tabell visas de Oracle DB-versioner som varje anslutning stöder:
| Connector | Logikapp | Oracle DB-versioner som stöds |
|---|---|---|
| Managed | -Konsumtion -Standard |
– Oracle 9 och senare – Oracle Data Access Client (ODAC) 11.2 och senare |
| Inbyggd (förhandsversion) | Norm | Oracle Database 11 och senare |
Teknisk referens för kopplingsdel
Oracle Database-anslutningsappen har olika versioner, baserat på logikappens arbetsflödestyp och värdmiljö.
| Logikapp | Miljö | Anslutningsversion |
|---|---|---|
| Förbrukning | Multitenant Azure Logic Apps | Hantera anslutning, som visas i anslutningsgalleriet under filtret Delad. Mer information finns i Referens för Oracle Database-hanterad anslutning. |
| Standard | Azure Logic Apps med en klientorganisation, App Service Environment v3 (endast Windows planer) och Hybrid | Hanterad anslutning, som visas i anslutningsgalleriet under det delade filtret och den inbyggda anslutningen (offentlig förhandsversion), som visas i anslutningsgalleriet under det inbyggda filtret. Den inbyggda versionen körs i Azure Logic Apps-runtime och kräver inte den lokala datagatewayen eftersom runtime kan nå Oracle-slutpunkten via nätverket. Mer information finns i: - Referens för hanterad Oracle Database-kontakt - Inbyggd anslutningsreferens |
Inbyggda anslutningsåtgärder (förhandsversion)
Den inbyggda anslutningen stöder för närvarande följande åtgärder:
| Name | Parameterar | Description | Returns |
|---|---|---|---|
Kör fråga (executeQuery) |
-
Fråga (query): Krävs med string typ. SQL-frågan som ska köras. - Frågeparametrar ( queryParameters): Valfritt med object typ. Frågeparametrarna som ska inkluderas. |
Kör en SQL-fråga. | SQL-frågeresultatet som en array. |
Kör lagrad procedur (executeStoredProcedure) |
-
Namn på lagrad procedur (storedProcedure): Krävs med string typ. Namnet på den lagrade proceduren som ska köras. - Parametrar för lagrad procedur ( storedProcedureParameters): Valfritt med object typ. Parametrarna för lagrad procedur som ska inkluderas. |
Kör en lagrad procedur och returnerar resultatuppsättningar och utdataparametrar. |
-
Resultatuppsättningar (resultSets) med string typ. Listan över resultatuppsättningar som returneras av den lagrade proceduren. - Utdataparametrar ( outputParmaters) av string typen. Utdataparametervärdena som returneras av den lagrade proceduren. |
Hämta rader (getRows) |
-
Tabellnamn (tableName): Krävs med string typ. Namnet på källtabellen. - Var villkor ( columnValuesForWhereCondition): Valfritt med object typ. Nyckel/värde-paret med kolumner som identifierar de rader som ska hämtas. - Förskjutning för Hämta rader ( skipCount): Valfritt med string typ. Antalet poster att hoppa över. Standardvärdet är 0. - Maximalt antal rader ( maxcount): Valfritt med string typ. Maximalt antal rader att hämta. Standardvärdet är 0. - Beställningskolumn ( orderBy): Valfritt med string typ. Kolumnnamnet som ska användas för att ordna frågeresultatet. - Välj Kolumner ( filterBy): Valfritt med string typ. Kolumnvärdet som ska hämtas från tabellen eller vyn. |
Hämtar en eller flera rader utifrån det angivna villkoret. | De hämtade raderna som en array. |
Hämta tabeller (getTables) |
Returnera endast tabeller som ägs av den aktuella användaren (ownedTables): Valfritt med string typ. Returnerar endast tabeller där ägaren är den angivna användaren. |
Hämtar en lista över tabeller. | Listan över tabeller som en array. |
Infoga rad (insertRow) |
-
Tabellnamn (tableName): Krävs med string typ. Tabellens namn. - Ange kolumner ( setColumns): Valfritt med object typ. Radfältens värden. |
Infogar en rad. | Den infogade raden av typen object. |
Förutsättningar
Ett Azure konto och en prenumeration. Skaffa ett kostnadsfritt Azure-konto.
Logikappresursen och arbetsflödet från vilka du ansluter till din Oracle-databas.
Den här anslutningen innehåller endast åtgärder, inte utlösare. Du kan använda vilken trigger som helst för att starta ditt arbetsflöde. Information om hur du skapar logikappens resurs och arbetsflöde och sedan lägger till en utlösare finns i:
Förutsättningar för hanterad anslutning (förbrukning och standard)
Ladda ned och installera den lokala datagatewayen.
Den här gatewayen fungerar som en brygga och tillhandahåller en säker dataöverföring mellan lokala data och din app eller klient. Du kan använda samma gatewayinstallation med flera tjänster och datakällor, vilket innebär att du kanske bara behöver installera gatewayen en gång.
Installera Oracle-klienten på den dator där du installerade den lokala datagatewayen. Annars uppstår ett fel när du försöker skapa eller använda anslutningen.
Krav för inbyggd anslutning (standard, förhandsversion)
Kontrollera att arbetsflödet för standardlogikappen kan nå Oracle-slutpunkten, inklusive valfri värd, port, DNS-matchning och brandväggsregler.
När du skapar Oracle-databasanslutningen behöver du följande värden:
- Ip-adress för Oracle-databasserver
- Användarnamn
- Lösenord
För serverns IP-adress anger du det här värdet i följande format:
Format Syntax Example Easy Connect (icke-SSL) < host>:<port>/<database-service-name> localhost:1522/XETransparent Network Substrate (TNS)-beskrivning (SSL): Den fullständiga beskrivningen av Oracle Datasource (description=(retry_count=<retries>)(retry_delay=<delay-duration>)(address=(protocol=tcps)(port=<port-number>)(host=<host>))(connect_data=(service_name=<service-name>)))(security=(ssl_server_dn_match=yes))) (description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=localhost))(connect_data=(service_name=XE))(security=(ssl_server_dn_match=yes))) För åtgärden Hämta rad som används i det här exemplet måste du känna till identifieraren för tabellen för åtkomst.
Om du inte känner till den här informationen kontaktar du Oracle Database-administratören eller hämtar utdata från följande instruktion:
select * from <table-name>.
Kända problem och begränsningar
De aktuella anslutningsversionerna stöder inte utlösare. Använd alla utlösare som passar ditt scenario för att starta arbetsflödet och lägg sedan till Oracle-åtgärder.
| Connector | Limitations |
|---|---|
| Managed | – Tabeller med sammansatta nycklar – Tabeller med kapslade objekttyper – Databasfunktioner med icke-skalära värden |
| Inbyggd | – Inga dedikerade åtgärder för uppdatering eller borttagning. För uppdaterings- och borttagningsscenarier använder du åtgärderna Kör fråga eller Kör lagrad procedur . – Vissa anslutningsproblem kan bara visas vid arbetsflödeskörning i stället för när anslutningen skapas. |
Lägga till en åtgärd
Stegen för att lägga till och använda en Oracle-åtgärd skiljer sig åt beroende på om du använder den inbyggda anslutningsappen eller den hanterade anslutningsappen.
Lägga till en inbyggd anslutningsåtgärd (standard, förhandsversion)
Öppna din standard-logikappresurs i Azure-portalen.
Öppna arbetsflödet i designern.
Följ de allmänna stegen för att lägga till den Oracle Database-åtgärd som du vill använda i arbetsflödet.
Det här exemplet fortsätter med åtgärden Hämta rader .
I fönstret anslutningsinformation anger du nödvändig information, till exempel det anslutningsnamn du vill använda, Oracle-databasserverns IP-adress, användarnamn och lösenord, till exempel:
När du är klar väljer du Skapa ny.
I åtgärdsinformationsfönstret anger du de parametervärden som krävs för den valda åtgärden.
Om du till exempel väljer åtgärden Hämta rader anger du tabellnamnet:
Lägg till andra åtgärder som krävs för att slutföra arbetsflödet.
Spara arbetsflödet. I verktygsfältet för designern väljer du Spara.
Lägg till en hanterad anslutningsåtgärd (Förbrukning och Standard)
I Azure-portalen öppnar du förbruknings- eller standardlogikappresursen.
Öppna arbetsflödet i designern.
Följ de allmänna stegen för att lägga till den Oracle Database-åtgärd som du vill använda i arbetsflödet.
Det här exemplet fortsätter med åtgärden Hämta rad.
I fönstret anslutningsinformation anger du nödvändig anslutningsinformation.
För gatewayegenskapen väljer du den Azure-prenumeration och Azure Gateway-resurs som ska användas.
När du har slutfört anslutningen väljer du en tabell i listan Tabellnamn .
För egenskapen Rad-ID anger du det rad-ID som du vill använda i tabellen.
I följande exempel returneras jobbdata från en personaldatabas:
Lägg till andra åtgärder som krävs för att slutföra arbetsflödet.
Spara arbetsflödet. I verktygsfältet för designern väljer du Spara.
Felsöka problem med Oracle-databasanslutning
Fel: Det går inte att nå gatewayen
Orsak: Den lokala datagatewayen kan inte ansluta till molnet.
Åtgärd: Kontrollera att din gateway körs på den lokala datorn där du installerade gatewayen och har internetanslutning. Undvik att installera gatewayen på en dator som kan vara avstängd eller går i viloläge. Du kan också prova att starta om den lokala datagatewaytjänsten (PBIEgwService).
Fel: Providern som används är inaktuell: "System.Data.OracleClient kräver Oracle-klientprogramvara version 8.1.7 eller senare." Information om hur du installerar den officiella providern finns i https://go.microsoft.com/fwlink/p/?LinkID=272376.
Orsak: Oracle-klient-SDK är inte installerat på datorn där den lokala datagatewayen körs.
Lösning: Ladda ned och installera Oracle-klient-SDK:t på samma dator som den lokala datagatewayen.
Fel: Tabellen "[Tablename]" definierar inga nyckelkolumner
Orsak: Tabellen har ingen primärnyckel.
Lösning: Oracle Database-anslutningsappen kräver att du använder en tabell med en primär nyckelkolumn.