Dela via

Oracle Database

Oracle Database är ett relationsdatabashanteringssystem som utvecklats av Oracle. Anslut till lokal Oracle Database för att utföra olika åtgärder, till exempel skapa, uppdatera, hämta och ta bort på rader i en tabell.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Premie Alla Power Automate-regioner
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     - US Department of Defense (DoD)
Power Apps Premie Alla Power Apps-regioner
Power Automate Premie Alla Power Automate-regioner
Kontakt
Namn Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate-support
Microsoft Power Apps Support
Metadata för anslutningsprogram
Utgivare Microsoft
Webbplats https://www.oracle.com/database/
Sekretesspolicy https://www.oracle.com/legal/privacy/

Den här artikeln beskriver åtgärderna för Oracle Database-anslutningsappen, som är tillgänglig för Azure Logic Apps, Microsoft Power Apps och Microsoft Power Automate. Du kan använda den här anslutningsappen för att ansluta till en lokal Oracle Database eller en virtuell Azure-dator med Oracle Database installerat.

Vad är nytt

I följande tabell beskrivs de nya uppdateringarna och funktionerna för Oracle Databaseconnector:

Update Description
Oktober 2018 Stöder oracle-lagrad procedur.
Januari 2018 Stöder Oracle-vyn som skrivskyddad tabell.

Förutsättningar

  • Oracle-versioner som stöds:

    • Oracle 9 och senare
    • Oracle Data Access Client (ODAC) 11.2 och senare

  • Om du vill ansluta till en lokal Oracle-databas eller en virtuell Azure-dator med Oracle Database installerat måste du 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. Kontrollera att du installerar 64-bitars Oracle-dataprovidern för .NET från Oracle och välj windowsinstallationsversionen eftersom xcopy versionen inte fungerar med den lokala datagatewayen: 64-bitars ODAC 12c Version 4 (12.1.0.2.4) för Windows x64. Du kan verifiera installationen genom att köra följande PowerShell-kommando: [System.Data.Common.DbProviderFactories]::GetFactoryClasses(). Om en Oracle-klient är installerad bör du se "OracleClient Data Provider" i resultatet.

    Anmärkning

    Om Oracle-klienten inte är installerad uppstår ett fel när du försöker skapa eller använda anslutningen. Mer information finns i avsnittet Vanliga anslutningsfel.

  • Innan du kör några anslutningsåtgärder på Oracle-klienten anger du miljövariabeln med namnet ORA_NCHAR_LITERAL_REPLACE till TRUE.

    Den här inställningen aktiverar NCHAR-strängliteral ersättning, vilket förhindrar dataförlust när strängliteraler som innehåller tecken utanför databasteckenuppsättningen infogas i kolumnen NCHAR/NVARCHAR/NCLOB-typ . När instruktionen körs konverteras strängliteraler till ett internt format och avkodas sedan korrekt till Unicode.

Kända problem och begränsningar

I följande lista beskrivs några kända begränsningar för Oracle Datbase-anslutningsappen:

  • Stöds inte:

    • Valfri tabell med sammansatta nycklar
    • Kapslade objekttyper i tabeller
    • Databasfunktioner med icke-skalära värden
    • Oracle Functions så att de inte visas i användargränssnittet.

  • När du anropar en lagrad procedur på en Oracle-server gäller följande begränsningar:

    • OUT-parametrar stöds inte.
    • Returvärdet är inte tillgängligt eftersom den lagrade proceduren inte returnerar några resultat.

  • Svarsstorleksgränsen är 8 MB.

  • Storleksgränsen för begäran är 2 MB.

  • Oracle-intern fråga stöds med följande begränsningar:

    • Kräver gatewayversion 3000.63.4 (oktoberversion) eller senare.
    • RefCursor stöds inte.
    • OUT-parametrar stöds inte.
    • Endast en resultatuppsättning kan returneras.

  • Följande datatyper kan inte användas som frågealternativpredikat:

    • DATE
    • TIMESTAMP
    • TIDSSTÄMPEL med tidszon
    • TIMESTAMP med lokal tidszon

  • Om körningstiden för Oracle-frågor eller lagrad procedur överskrider 110 sekunder överskrider åtgärden tidsgränsen.

  • Infoga och uppdatera till en tabell returnerar inte det fullständiga objektet. De returnerar endast indataegenskaperna för åtgärden.

  • För att få deterministiska växlingsresultat för åtgärden Hämta rader krävs en primärnyckel.

  • Åtgärden Infoga rad kräver att du anger ett explicit värde för kolumnen Primärnyckel, även om standard-/autoincrement-värdet har definierats.

  • På grund av begränsningar i användargränssnittskomponenten kan listan över tabeller som återges under designtiden inte visa fler än 2 048 element, vilket är standardsidans storlek för åtgärden Hämta tabeller , till exempel:

    • Lista över tabeller för åtgärdsparametern Hämta rader med namnet "Tabellnamn".
    • Lista över tabeller för flödet "Skapa anslutning/välj en tabell" i Power Apps-designern.

  • Om du ser svarstiden när du arbetar med Oracle-databasen installerar du de senaste 64-bitars Oracle Data Access-komponenterna (ODAC) på gatewaydatorn eller varje gatewaydator, om gatewayen är ett kluster.

  • Om Det inte går att skapa Oracle-anslutningen med en tidsgräns kan du prova att använda en Oracle-autentiseringsuppgift med minimal behörighet. På så sätt är anslutningen enklare, vilket kan hjälpa dig att undvika tidsgränsen när anslutningen skapas.

Vanliga anslutningsfel

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 som 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.". Se https://go.microsoft.com/fwlink/p/?LinkID=272376 installera den officiella providern.

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.

Allmänna gränser

Namn Värde
Maximalt antal begäranden som bearbetas av anslutningsappen samtidigt per anslutning 200
Maximalt antal megabyte som överförs via anslutningsappen samtidigt per anslutning 30

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:
Standardinställning Parametrar för att skapa anslutning. Alla regioner Shareable

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs

Namn Typ Description Krävs
Server snöre Ange Oracle Server. Om en port eller SID krävs anger du i form av ServerName:Port/SID. Sann
Autentiseringstyp [Välj grundläggande] snöre Autentiseringstyp för att ansluta till databasen
Användarnamn securestring Autentiseringsuppgifter för användarnamn Sann
Lösenord securestring Lösenordsautentiseringsuppgifter Sann
Gateway gatewaySetting Lokal gateway (se https://docs.microsoft.com/data-integration/gateway mer information Sann

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 1500 60 sekunder

Åtgärder

Hämta rad

Den här åtgärden hämtar en rad från en tabell.
Hämta rader

Den här åtgärden hämtar rader från en tabell.
Hämta tabeller

Den här åtgärden hämtar tabeller från en databas.
Infoga rad

Den här åtgärden infogar en ny rad i en tabell.
Kör lagrad procedur

Den här åtgärden kör en lagrad procedur.
Köra en Oracle-fråga

Köra en Oracle-fråga
Ta bort rad

Den här åtgärden tar bort en rad från en tabell.
Uppdatera rad

Den här åtgärden uppdaterar en befintlig rad i en tabell.

Hämta rad

Åtgärds-ID:
GetItem

Den här åtgärden hämtar en rad från en tabell.

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på Oracle-tabell
Rad-ID
 id True string

Unik identifierare för raden som ska hämtas

Returer

Utdata för den här åtgärden är dynamiska.

Hämta rader

Åtgärds-ID:
GetItems

Den här åtgärden hämtar rader från en tabell.

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på Oracle-tabell
Filtrera fråga
 $filter string

En ODATA-filterfråga för att begränsa de returnerade posterna (t.ex. stringColumn eq 'string' OR numberColumn lt 123).
Sortera efter
 $orderby string

En ODATA orderBy-fråga för att ange ordningen på poster.
Högsta antal
 $top integer

Totalt antal poster som ska hämtas (standard = alla).
Hoppa över antal
 $skip integer

Antalet poster som ska hoppa över (standard = 0).
Välj fråga
 $select string

Specifika fält som ska hämtas från poster (standard = alla).

Returer

Utdata för den här åtgärden är dynamiska.

Hämta tabeller

Åtgärds-ID:
GetTables

Den här åtgärden hämtar tabeller från en databas.

Returer

Representerar en lista över tabeller.

Body
TablesList

Infoga rad

Åtgärds-ID:
PostItem

Den här åtgärden infogar en ny rad i en tabell.

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på tabell
Row
 item True dynamic

Rad som ska infogas i den angivna tabellen

Returer

Utdata för den här åtgärden är dynamiska.

Kör lagrad procedur

Åtgärds-ID:
ExecuteProcedure

Den här åtgärden kör en lagrad procedur.

Parametrar

Name Nyckel Obligatorisk Typ Description
Procedurnamn
 procedure True string

Namn på lagrad procedur
Lista över parametrar
 parameters True dynamic

Indataparametrar till den lagrade proceduren

Returer

Utdata för den här åtgärden är dynamiska.

Köra en Oracle-fråga

Åtgärds-ID:
ExecutePassThroughNativeQuery

Köra en Oracle-fråga

Parametrar

Name Nyckel Obligatorisk Typ Description
Query
 query True dynamic

frågetext

Returer

Utdata för den här åtgärden är dynamiska.

Ta bort rad

Åtgärds-ID:
DeleteItem

Den här åtgärden tar bort en rad från en tabell.

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på tabell
Rad-ID
 id True string

Unik identifierare för raden som ska tas bort

Uppdatera rad

Åtgärds-ID:
PatchItem

Den här åtgärden uppdaterar en befintlig rad i en tabell.

Parametrar

Name Nyckel Obligatorisk Typ Description
Tabellnamn
 table True string

Namn på tabell
Rad-ID
 id True string

Unik identifierare för raden som ska uppdateras
Row
 item True dynamic

Rad med uppdaterade värden

Returer

Utdata för den här åtgärden är dynamiska.

Definitioner

Tabell

Representerar en tabell.

Name Sökväg Typ Description
Namn
 Name string

Tabellens namn. Namnet används vid körning.
visningsnamn
 DisplayName string

Tabellens visningsnamn.
DynamicProperties
 DynamicProperties object

Ytterligare tabellegenskaper som tillhandahålls av anslutningsappen till klienterna.

TablesList

Representerar en lista över tabeller.

Name Sökväg Typ Description
värde
 value array of Table

Lista över tabeller