Łączenie się z bazami danych Oracle z przepływów pracy w Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

Gdy przepływy pracy muszą pracować z danymi Oracle, połącz się z bazą danych Oracle przy użyciu łącznika Oracle Database w Azure Logic Apps. Można uzyskać dostęp do baz danych hostowanych lokalnie lub na maszynie wirtualnej w Azure.

Łącznik bazy danych Oracle ułatwia rozwiązywanie typowych zadań integracji danych, takich jak:

• Dodaj rekordy klientów do bazy danych.
• Aktualizowanie rekordów zamówień w bazie danych.
• Pobieranie, wstawianie lub usuwanie wierszy tabeli w ramach przepływu pracy.

Obsługiwane wersje bazy danych Oracle

W poniższej tabeli wymieniono obsługiwane wersje bazy danych Oracle DB obsługiwane przez każdy łącznik:

Connector	Aplikacja logiki	Obsługiwane wersje bazy danych Oracle DB
Managed	-Zużycie -Norma	— Oracle 9 i nowsze — Oracle Data Access Client (ODAC) 11.2 lub nowszy
Wbudowane (wersja próbna)	Standard	Baza danych Oracle Database 11 lub nowsza

Dokumentacja techniczna łącznika

Łącznik bazy danych Oracle ma różne wersje na podstawie typu przepływu pracy aplikacji logiki i środowiska hosta.

Aplikacja logiki	Środowisko	Wersja łącznika
Zużycie	Wielotenancyjna usługa Azure Logic Apps	Łącznik zarządzany, który jest wyświetlany w galerii łączników w obszarze filtra Udostępniony. Aby uzyskać więcej informacji, zobacz Dokumentacja łącznika zarządzanego usługi Oracle Database.
Standard	Azure Logic Apps w jednym dzierżawcy, App Service Environment v3 (tylko plany Windows) i środowisko hybrydowe	Łącznik zarządzany, który jest wyświetlany w galerii łączników w obszarze Filtr udostępniony i wbudowany łącznik (publiczna wersja zapoznawcza), który jest wyświetlany w galerii łączników w obszarze Filtr wbudowany. Wbudowana wersja jest uruchamiana w procesie przy użyciu środowiska uruchomieniowego Azure Logic Apps i nie wymaga lokalnej bramy danych, ponieważ środowisko uruchomieniowe może uzyskać dostęp do punktu końcowego Oracle za pośrednictwem sieci. Aby uzyskać więcej informacji, zobacz: - Referencja łącznika zarządzanego Oracle Database - Dokumentacja wbudowanego łącznika

Operacje wbudowanego łącznika (wersja zapoznawcza)

Wbudowany łącznik obsługuje obecnie następujące akcje:

Name	Parameters	Description	Zwroty
Wykonywanie zapytania (executeQuery)	- Zapytanie (query): wymagane z typem string . Zapytanie SQL, które należy uruchomić. - Parametry zapytania (queryParameters): opcjonalne z typem object . Parametry zapytania do uwzględnienia.	Uruchamia zapytanie SQL.	Wynik zapytania SQL jako array.
Wykonaj procedurę składowaną (executeStoredProcedure)	- Nazwa procedury składowanej (storedProcedure): jest wymagana dla typu string . Nazwa procedury składowanej do uruchomienia. - Parametry procedury składowanej (storedProcedureParameters): opcjonalne z typem object . Parametry procedury składowanej do uwzględnienia.	Uruchamia procedurę składowaną i zwraca zestawy wyników i parametry wyjściowe.	- Zestawy wyników (resultSets) z typem string . Lista zestawów wyników zwracanych przez procedurę składowaną. - Parametry wyjściowe (outputParmaters) z typem string . Wartości parametrów wyjściowych zwracane przez procedurę składowaną.
Pobierz wiersze (getRows)	- Nazwa tabeli (tableName): wymagane z typem string. Nazwa tabeli źródłowej. - Warunek (columnValuesForWhereCondition): opcjonalnie z typem object. Para klucz-wartość kolumn identyfikujących wiersze do pobrania. - Przesunięcie dla opcji Pobierz wiersze (skipCount): opcjonalne z typem string . Liczba wpisów do pominięcia. Wartość domyślna to 0. - Maksymalna liczba wierszy (maxcount): opcjonalne z typem string . Maksymalna liczba wierszy do pobrania. Wartość domyślna to 0. - Kolumna porządkowania (orderBy): opcjonalnie z typem string . Nazwa kolumny do użycia do porządkowania wyniku zapytania. - Wybierz kolumny (filterBy): opcjonalne dla typu string. Wartość kolumny do pobrania z tabeli lub widoku.	Pobiera jeden lub więcej wierszy na podstawie określonego warunku.	Pobrane wiersze jako array.
Pobieranie tabel (getTables)	Zwracaj tylko tabele należące do bieżącego użytkownika (ownedTables): opcjonalne z typem string . Zwraca tylko tabele, w których właściciel jest podanym użytkownikiem.	Pobiera listę tabel.	Lista tabel jako array.
Wstaw wiersz (insertRow)	- Nazwa tabeli (tableName): wymagane z typem string. Nazwa tabeli. - Ustaw kolumny (setColumns): opcjonalnie z typem object . Wartości pól wiersza.	Wstawia wiersz.	Wstawiony wiersz o object typie.

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Uzyskaj bezpłatne konto platformy Azure.

• Zasób aplikacji logiki i przepływ pracy, z którego można nawiązać połączenie z bazą danych Oracle.

  Ten łącznik udostępnia tylko akcje, a nie wyzwalacze. Możesz użyć dowolnego wyzwalacza, aby uruchomić przepływ pracy. Aby utworzyć zasób i przepływ pracy aplikacji logiki, a następnie dodać wyzwalacz, zobacz:

  • Utwórz przepływy pracy aplikacji logiki zużycia w Azure, w Azure Logic Apps.
  • Tworzenie standardowych przepływów pracy w Azure Logic Apps
  • Dodaj wyzwalacz do przepływu pracy

Wymagania wstępne dotyczące łącznika zarządzanego (Konsumpcyjne i Standardowe)

• Pobierz i zainstaluj lokalną bramę danych lokalnych.

  Ta brama działa jako mostek i zapewnia bezpieczny transfer danych między danymi lokalnymi a aplikacją lub klientem. Możesz użyć tej samej instalacji bramy z wieloma usługami i źródłami danych, co oznacza, że może być konieczne zainstalowanie bramy tylko raz.

• Zainstaluj klienta Oracle na komputerze, na którym zainstalowano lokalną bramę danych. W przeciwnym razie podczas próby utworzenia lub użycia połączenia wystąpi błąd.

• Utwórz zasób bramy dla platformy Azure na potrzeby instalacji bramy.

Wymagania wstępne dotyczące wbudowanego łącznika (Standardowa, wersja zapoznawcza)

• Upewnij się, że przepływ pracy w aplikacji logicznej warstwy Standard może nawiązywać połączenie z punktem końcowym Oracle, w tym z dowolnym hostem, portem, rozpoznawaniem nazw DNS i regułami zapory.

• Podczas tworzenia połączenia z bazą danych Oracle potrzebne są następujące wartości:

  • Adres IP serwera bazy danych Oracle
  • Nazwa użytkownika
  • Hasło

  Dla adresu IP serwera określ tę wartość w następujących formatach:

  Forma	Składnia	Example
  Easy Connect (bez protokołu SSL)	< host>:<port>/<database-service-name>	localhost:1522/XE
  Deskryptor Transparent Network Substrate (TNS) (SSL): pełny deskryptor źródła danych Oracle	(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)))

• W przypadku akcji Pobierz wiersz użyty w tym przykładzie musisz znać identyfikator tabeli, aby uzyskać dostęp.

  Jeśli nie znasz tych informacji, skontaktuj się z administratorem usługi Oracle Database lub pobierz dane wyjściowe z następującej instrukcji: select * from <table-name>.

Znane problemy i ograniczenia

Bieżące wersje łącznika nie obsługują wyzwalaczy. Użyj dowolnego wyzwalacza, który pasuje do twojego scenariusza, aby uruchomić przepływ pracy, a następnie dodaj akcje Oracle.

Connector	Limitations
Managed	Tabele z kluczami złożonymi - Tabele z zagnieżdżonymi typami obiektów — Funkcje bazy danych z wartościami niepodskalarnymi
Wbudowane	— Brak dedykowanych akcji aktualizacji ani usuwania. W przypadku scenariuszy aktualizacji i usuwania użyj akcji Wykonaj zapytanie lub Wykonaj procedurę składowaną . — Niektóre problemy z połączeniem mogą występować tylko w czasie wykonywania przepływu pracy, a nie w czasie tworzenia połączenia.

Dodawanie akcji

Kroki dodawania i używania akcji Oracle różnią się w zależności od tego, czy używasz wbudowanego łącznika, czy łącznika zarządzanego.

Dodaj wbudowaną akcję łącznika (Standard, wersja zapoznawcza)

1. W Azure portal otwórz zasób aplikacji logicznych standardowych.

2. W edytorze otwórz przepływ pracy.

3. Postępuj zgodnie z ogólnymi krokami , aby dodać akcję Oracle Database , którą chcesz wykonać w przepływie pracy.

   W tym przykładzie kontynuowana jest akcja Pobierz wiersze.

4. W okienku informacji o połączeniu wprowadź wymagane informacje, takie jak nazwa połączenia, adres IP serwera bazy danych Oracle, nazwa użytkownika i hasło, na przykład:

   

5. Po zakończeniu wybierz pozycję Utwórz nową.

6. W okienku informacji o akcji wprowadź wartości parametrów wymagane dla wybranej akcji.

   Jeśli na przykład wybierzesz akcję Pobierz wiersze , wprowadź nazwę tabeli:

   

7. Dodaj inne akcje niezbędne do zakończenia przepływu pracy.

8. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Dodaj akcję zarządzanego łącznika (Typ zużycia i standardowy)

1. W portalu Azure otwórz zasób aplikacji logiki typu Zużycie lub Standard.

2. W edytorze otwórz przepływ pracy.

3. Postępuj zgodnie z ogólnymi krokami , aby dodać akcję Oracle Database , którą chcesz wykonać w przepływie pracy.

   W tym przykładzie kontynuowana jest akcja Pobierz wiersz.

4. W okienku informacji o połączeniu wprowadź wymagane informacje o połączeniu.

5. Dla właściwości Brama wybierz subskrypcję platformy Azure i zasób bramy Azure do wykorzystania.

6. Po zakończeniu połączenia z listy Nazwa tabeli wybierz tabelę.

7. W przypadku właściwości Identyfikator wiersza wprowadź identyfikator wiersza, który chcesz umieścić w tabeli.

   W poniższym przykładzie dane dotyczące pracy są zwracane z bazy danych zasobów ludzkich:

   

8. Dodaj inne akcje niezbędne do zakończenia przepływu pracy.

9. Zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Rozwiązywanie problemów z połączeniem z bazą danych Oracle

Błąd: Nie można nawiązać połączenia z bramą

Przyczyna: Lokalna brama danych nie może nawiązać połączenia z chmurą.

Środki zaradcze: upewnij się, że brama działa na komputerze lokalnym, na którym zainstalowano bramę, i że ma łączność z Internetem. Unikaj instalowania bramy na komputerze, który może zostać wyłączony lub uśpić się. Możesz również spróbować ponownie uruchomić lokalną usługę bramy danych (PBIEgwService).

Błąd: Używany dostawca jest przestarzały: "System.Data.OracleClient wymaga oprogramowania klienckiego Oracle w wersji 8.1.7 lub nowszej". Aby zainstalować oficjalnego dostawcę, zobacz https://go.microsoft.com/fwlink/p/?LinkID=272376.

Przyczyna: zestaw SDK klienta Oracle nie jest zainstalowany na komputerze, na którym jest uruchomiona lokalna brama danych.

Rozwiązanie: pobierz i zainstaluj zestaw SDK klienta Oracle na tym samym komputerze co lokalna brama danych.

Błąd: Tabela "[Tablename]" nie definiuje żadnych kolumn kluczy

Przyczyna: tabela nie ma klucza podstawowego.

Rozwiązanie: Łącznik bazy danych Oracle wymaga użycia tabeli z kolumną klucza podstawowego.

Powiązana zawartość

• Łączniki zarządzane dla usługi Azure Logic Apps
• Wbudowane łączniki dla usługi Azure Logic Apps