Sdílet prostřednictvím

Oracle Database

Oracle Database je systém pro správu relačních databází vyvinutý společností Oracle. Připojte se k místní databázi Oracle a proveďte různé akce, jako je vytvoření, aktualizace, získání a odstranění řádků v tabulce.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps
Power Automate Premium Všechny oblasti Power Automate
Kontakt
Název Microsoft
URL Podpora Microsoft LogicApps
Podpora microsoft Power Automate
Podpora Microsoft Power Apps
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://www.oracle.com/database/
Zásady ochrany osobních údajů https://www.oracle.com/legal/privacy/

Tento článek popisuje operace pro konektor Oracle Database, který je k dispozici pro Azure Logic Apps, Microsoft Power Apps a Microsoft Power Automate. Tento konektor můžete použít k připojení k místní databázi Oracle nebo k virtuálnímu počítači Azure s nainstalovanou službou Oracle Database.

Co je nového

Následující tabulka popisuje nové aktualizace a možnosti pro oracle Databaseconnector:

Update Description
2018. říjen Podporuje uloženou proceduru Oracle.
Leden 2018 Podporuje zobrazení Oracle jako tabulku jen pro čtení.

Požadavky

  • Podporované verze Oracle:

    • Oracle 9 a novější
    • Oracle Data Access Client (ODAC) 11.2 a novější

  • Pokud se chcete připojit k místní databázi Oracle nebo virtuálnímu počítači Azure s nainstalovanou službou Oracle Database, musíte nainstalovat místní bránu dat.

    Tato brána funguje jako most a zajišťuje zabezpečený přenos dat mezi místními daty a vaší aplikací nebo klientem. Stejnou instalaci brány můžete použít s více službami a zdroji dat, což znamená, že bránu budete muset nainstalovat jenom jednou.

  • Nainstalujte klienta Oracle do počítače, na kterém jste nainstalovali místní bránu dat. Ujistěte se, že nainstalujete 64bitového zprostředkovatele dat Oracle pro .NET z Oracle a vyberete verzi instalační služby systému Windows, protože xcopy verze nefunguje s místní bránou dat: 64bitová verze ODAC 12c Release 4 (12.1.0.2.4) pro Windows x64. Instalaci můžete ověřit spuštěním následujícího příkazu PowerShellu: [System.Data.Common.DbProviderFactories]::GetFactoryClasses(). Pokud je nainstalovaný klient Oracle, měli byste ve výsledcích vidět "OracleClient Data Provider".

    Poznámka:

    Pokud klient Oracle není nainstalovaný, při pokusu o vytvoření nebo použití připojení dojde k chybě. Další informace najdete v části Běžné chyby připojení.

  • Před spuštěním jakýchkoli operací konektoru nastavte v klientovi Oracle proměnnou prostředí s názvem ORA_NCHAR_LITERAL_REPLACE na HODNOTU TRUE.

    Toto nastavení umožňuje nahrazení řetězcového literálu NCHAR, což zabraňuje ztrátě dat, pokud řetězcové literály obsahující znaky nad rámec databázové znakové sady se vloží do sloupce typu NCHAR/NVARCHAR/NCLOB . Když se příkaz spustí, řetězcové literály se převedou do interního formátu a pak se správně dekódují do unicode.

Známé problémy a omezení

Následující seznam popisuje některá známá omezení konektoru Oracle Datbase:

  • Nepodporuje se:

    • Libovolná tabulka se složenými klíči
    • Vnořené typy objektů v tabulkách
    • Databázové funkce s nes skalárními hodnotami
    • Funkce Oracle, takže nejsou uvedené v uživatelském rozhraní.

  • Při vyvolání uložené procedury na serveru Oracle platí následující omezení:

    • Parametry OUT nejsou podporovány.
    • Vrácená hodnota není dostupná, protože uložená procedura nevrací žádné výsledky.

  • Limit velikosti odpovědi je 8 MB.

  • Limit velikosti požadavku je 2 MB.

  • Nativní dotaz Oracle se podporuje s následujícími omezeními:

    • Vyžaduje bránu verze 3000.63.4 (verze z října) nebo novější.
    • RefCursor se nepodporuje.
    • Parametry OUT nejsou podporovány.
    • Lze vrátit pouze jednu sadu výsledků.

  • Následující datové typy nelze použít jako predikáty možností dotazu:

    • DATE
    • ČASOVÁ ZNAČKA
    • TIMESTAMP s časovým pásmem
    • TIMESTAMP s místním časovým pásmem

  • Pokud nějaký dotaz Oracle nebo doba provádění uložené procedury překročí 110 sekund, vyprší časový limit akce.

  • Vložení a aktualizace tabulky nevrací celou položku. Vrátí pouze vstupní vlastnosti operace.

  • Pokud chcete získat deterministické stránkovací výsledky pro operaci Získat řádky , je vyžadován primární klíč.

  • Operace Vložit řádek vyžaduje, abyste zadali explicitní hodnotu pro sloupec primárního klíče, i když je definována výchozí/automatická hodnota.

  • Kvůli omezením součástí uživatelského rozhraní nemůže seznam tabulek vykreslovaných během návrhu zobrazit více než 2 048 prvků, což je výchozí velikost stránky pro operaci Získat tabulky , například:

    • Seznam tabulek pro parametr akce Získat řádky s názvem Název tabulky
    • Seznam tabulek pro tok Vytvořit připojení/Zvolit tabulku v návrháři Power Apps

  • Pokud při práci s databází Oracle zaznamenáte latenci, nainstalujte na počítač brány nebo na každý počítač brány nejnovější 64bitové komponenty Oracle Data Access Components (ODAC), pokud se jedná o cluster.

  • Pokud vytvoření připojení Oracle selže s vypršením časového limitu, zkuste použít přihlašovací údaje Oracle s minimálním oprávněním. Tímto způsobem je připojení jednodušší, což vám může pomoct vyhnout se vypršení časového limitu během vytváření připojení.

Běžné chyby připojení

Chyba: Nejde se spojit s bránou

Příčina: Místní brána dat se nemůže připojit ke cloudu.

Zmírnění rizik: Ujistěte se, že brána běží na místním počítači, na kterém jste bránu nainstalovali, a že má připojení k internetu. Vyhněte se instalaci brány do počítače, který může být vypnutý nebo přejít do režimu spánku. Můžete také zkusit restartovat místní službu brány dat (PBIEgwService).

Chyba: Použitý zprostředkovatel je zastaralý: System.Data.OracleClient vyžaduje klientský software Oracle verze 8.1.7 nebo vyšší. Podívejte https://go.microsoft.com/fwlink/p/?LinkID=272376 se, jak nainstalovat oficiálního poskytovatele.

Příčina: Klientská sada SDK Oracle není nainstalovaná na počítači, na kterém je spuštěná místní brána dat.

Řešení: Stáhněte a nainstalujte klientskou sadu SDK Oracle do stejného počítače jako místní bránu dat.

Chyba: Tabulka [Název_tabulky] nedefinuje žádné klíčové sloupce.

Příčina: Tabulka nemá primární klíč.

Řešení: Konektor Oracle Database vyžaduje, abyste použili tabulku se sloupcem primárního klíče.

Obecné limity

Název Hodnota
Maximální počet žádostí zpracovávaných konektorem současně na připojení 200
Maximální počet megabajtů přenášených přes konektor souběžně na připojení 30

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Sdíletelný

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Název Typ Description Povinné
počítačový server řetězec Zadejte Oracle Server. Pokud se vyžaduje port nebo identifikátor SID, zadejte ho ve formátu ServerName:Port/SID. Pravdivé
Typ ověřování [Vybrat základní] řetězec Typ ověřování pro připojení k databázi
Uživatelské jméno securestring Přihlašovací údaje uživatelského jména Pravdivé
Heslo securestring Přihlašovací údaje hesla Pravdivé
Gateway gatewaySetting Místní brána (další podrobnosti najdete v tématu https://docs.microsoft.com/data-integration/gateway . Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 1500 60 sekund

Akce

Aktualizovat řádek

Tato operace aktualizuje existující řádek v tabulce.
Odstranit řádek

Tato operace odstraní řádek z tabulky.
Provedení dotazu Oracle

Provedení dotazu Oracle
Spustit uloženou proceduru

Tato operace spustí uloženou proceduru.
Vložit řádek

Tato operace vloží nový řádek do tabulky.
Získání tabulek

Tato operace získává tabulky z databáze.
Získání řádku

Tato operace získá řádek z tabulky.
Získání řádků

Tato operace získá řádky z tabulky.

Aktualizovat řádek

ID operace:
PatchItem

Tato operace aktualizuje existující řádek v tabulce.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky
ID řádku
 id True string

Jedinečný identifikátor řádku, který se má aktualizovat
Row
 item True dynamic

Řádek s aktualizovanými hodnotami

Návraty

Výstupy této operace jsou dynamické.

Odstranit řádek

ID operace:
DeleteItem

Tato operace odstraní řádek z tabulky.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky
ID řádku
 id True string

Jedinečný identifikátor řádku, který chcete odstranit

Provedení dotazu Oracle

ID operace:
ExecutePassThroughNativeQuery

Provedení dotazu Oracle

Parametry

Name Klíč Vyžadováno Typ Description
Query
 query True dynamic

Text dotazu

Návraty

Výstupy této operace jsou dynamické.

Spustit uloženou proceduru

ID operace:
ExecuteProcedure

Tato operace spustí uloženou proceduru.

Parametry

Name Klíč Vyžadováno Typ Description
Název procedury
 procedure True string

Název uložené procedury
Seznam parametrů
 parameters True dynamic

Vstupní parametry uložené procedury

Návraty

Výstupy této operace jsou dynamické.

Vložit řádek

ID operace:
PostItem

Tato operace vloží nový řádek do tabulky.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky
Row
 item True dynamic

Řádek pro vložení do zadané tabulky

Návraty

Výstupy této operace jsou dynamické.

Získání tabulek

ID operace:
GetTables

Tato operace získává tabulky z databáze.

Návraty

Představuje seznam tabulek.

Body
TablesList

Získání řádku

ID operace:
GetItem

Tato operace získá řádek z tabulky.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky Oracle
ID řádku
 id True string

Jedinečný identifikátor řádku, který se má načíst

Návraty

Výstupy této operace jsou dynamické.

Získání řádků

ID operace:
GetItems

Tato operace získá řádky z tabulky.

Parametry

Name Klíč Vyžadováno Typ Description
Název tabulky
 table True string

Název tabulky Oracle
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek.
Nejvyšší počet
 $top integer

Celkový počet položek, které se mají načíst (výchozí = vše).
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu
 $select string

Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Definice

Table

Představuje tabulku.

Name Cesta Typ Description
Název
 Name string

Název tabulky. Název se používá za běhu.
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název tabulky.
DynamicProperties
 DynamicProperties object

Další vlastnosti tabulky poskytované konektorem klientům

TablesList

Představuje seznam tabulek.

Name Cesta Typ Description
value
 value array of Table

Seznam tabulek