Łączenie z zasobami IBM DB2 przez przepływy pracy w Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

Gdy Twój zautomatyzowany proces integracji musi pracować z zasobami w bazie DB2, użyj konektora DB2 do wykonywania operacji nad bazą danych. Na przykład Twój workflow może wymieniać tabele lub wiersze, dodawać wiersze, aktualizować wiersze, usuwać wiersze, uruchamiać zapytania i uruchamiać procedury przechowywane. Te działania mogą zwracać dane z bazy danych, aby inne działania w przepływie pracy mogły je wykorzystać.

Azure Logic Apps oferuje następujące wersje łącznika DB2:

  • Zarządzany łącznik: Dostępny dla przepływów pracy w warstwie Zużycie i Standard. Dla serwera DB2 lokalnego ten łącznik wymaga bramki danych lokalnej.
  • Wbudowany konektor: Dostępny tylko dla standardowych przepływów pracy. Ten łącznik działa w tym samym procesie co środowisko uruchomieniowe usługi Azure Logic Apps i łączy się bezpośrednio z bazą danych DB2 przez protokół TCP/IP, bez użycia lokalnej bramy danych.

Obie wersje komunikują się z odległymi serwerami DB2 w sieci TCP/IP. Możesz użyć dowolnej wersji do dostępu do baz danych w chmurze, takich jak IBM DB2 for Windows działająca w wirtualizacji Azure.

Important

W przypadku systemów o krytycznym znaczeniu, które korzystają z przepływów pracy w warstwie Standard, należy użyć wbudowanego łącznika. Wbudowany łącznik eliminuje potrzebę korzystania z dodatkowej bramy oraz zapewnia większą wydajność i przepustowość dzięki działaniu w tym samym procesie co środowisko uruchomieniowe Azure Logic Apps. Używaj złącza zarządzanego, gdy potrzebujesz jego specyficznych operacji lub gdy korzystasz z workflow Consumption.

Ten przewodnik opisuje działania i konfigurację połączenia dla obu wersji złącza.

Obsługiwane platformy i wersje

Łącznik DB2 obsługuje następujące platformy i wersje IBM DB2 wraz z produktami zgodnymi z usługą IBM DB2, które obsługują architekturę rozproszonej relacyjnej bazy danych (DRDA) SQL Access Manager (SQLAM) w wersji 10 i 11:

Platforma Wersja
IBM DB2 dla z/OS 12, 11.1, 10.1
IBM DB2 for i 7.4, 7.3, 7.2, 7.1
IBM DB2 dla LUW 11,5, 11,1, 10,5

Dokumentacja techniczna łącznika

Złącze DB2 ma różne wersje, zależne od typu aplikacji logicznej i środowiska hosta.

Aplikacja logiki Environment Wersja połączenia
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. Ten łącznik udostępnia tylko akcje, a nie wyzwalacze. Dla serwera DB2 działającego lokalnie, złącze zarządzane wymaga bramki danych lokalnej.

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Referencja do zarządzanego złącza DB2
- Łączniki zarządzane w usłudze Azure Logic Apps
Standard Plan obsługi przepływu pracy, App Service Environment v3 (ASE v3 tylko z planami Windows) oraz hybrydowe wdrożenie na Kubernetes z Azure Arc Łącznik zarządzany, który jest wyświetlany w galerii łączników w obszarze filtru udostępniony, i wbudowany łącznik, który jest wyświetlany w galerii łączników w obszarze filtru wbudowany i opiera się na dostawcy usług. Obie wersje oferują tylko akcje, a nie wyzwalacze. W przypadku obciążeń o krytycznym znaczeniu użyj wbudowanego łącznika, który działa w tym samym procesie co środowisko uruchomieniowe Azure Logic Apps i łączy się bezpośrednio z usługą DB2 przez protokół TCP/IP bez użycia bramy danych lokalnych.

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

- Referencja do zarządzanego złącza DB2
- Informacje referencyjne dotyczące wbudowanego konektora DB2
- Wbudowane łączniki w usłudze Azure Logic Apps

Operacje łącznika zarządzanego

Zarządzane złącze DB2 obsługuje następujące operacje na bazie danych, które odpowiadają odpowiednim działaniom w złączu:

Operacja bazy danych Akcja łącznika
Wyświetl listę tabel bazy danych Pobieranie tabel
Odczytywanie jednego wiersza przy użyciu polecenia SELECT Pobierz wiersz
Odczytywanie wszystkich wierszy przy użyciu polecenia SELECT Pobierz wiersze
Dodawanie jednego wiersza przy użyciu polecenia INSERT Wstaw wiersz
Edytowanie jednego wiersza przy użyciu aktualizacji Aktualizuj wiersz
Usuwanie jednego wiersza przy użyciu polecenia DELETE Usuń wiersz

Aby uzyskać więcej informacji na temat zarządzanego złącza i tych akcji, zobacz informacje referencyjne dotyczące zarządzanego złącza DB2.

Operacje złącza wbudowanego

Wbudowane złącze DB2 obsługuje następujące działania:

Action Opis
Tabele DB2 Zwracaj tabele w schemacie DB2.
Usuń wiersz Usuń jeden lub więcej wierszy.
Wykonaj procedurę składowaną Uruchom procedurę składowaną i zwróć dane wyjściowe.
Wykonaj polecenie inne niż zapytanie Uruchom polecenie SQL, które nie zwraca zbioru wyników.
Wykonaj zapytanie Wykonaj zapytanie SQL i zwróć zbiór wyników.
Wstaw wiersz Wstaw wiersz do tabeli DB2.
Zaktualizuj wiersze Zaktualizuj jeden lub więcej wierszy w tabeli DB2.

Więcej informacji o wbudowanym złączu i tych działaniach można znaleźć w odniesieniu do wbudowanego złącza DB2.

Wymagania wstępne

Dodaj akcję zarządzanego złącza DB2

Poniższy przykład wykorzystuje zarządzany konektor DB2 i pokazuje, jak dodać akcję Get tables . Aby użyć wbudowanego złącza ze standardowym przepływem pracy, wybierz w galerii złączy pozycję Wbudowane, a następnie wybierz wbudowaną akcję DB2, taką jak Tabele DB2.

Uwaga / Notatka

Kroki dodawania dowolnej innej akcji DB2 są podobne, z wyjątkiem podanych parametrów i wartości akcji.

  1. W portalu Azure otwórz zasób aplikacji logiki oraz przepływ pracy w projektancie.

  2. Wykonaj ogólne kroki , aby dodać akcję DB2 o nazwie Pobierz tabele.

    Zostanie otwarte okienko informacji o połączeniu, dzięki czemu można podać szczegółowe informacje dotyczące łączenia bazy danych DB2.

  3. Wykonaj kroki tworzenia połączenia dla bazy danych w chmurze lub lokalnej bazy danych, a następnie wróć tutaj, aby kontynuować.

  4. Po pomyślnym utworzeniu połączenia zostanie wyświetlone okienko akcji Pobierz tabele i pokazuje, że żadne inne informacje nie są niezbędne:

    Zrzut ekranu przedstawia projektanta, przepływ pracy i akcję

  5. Kontynuuj testowanie przepływu pracy i wyświetlanie tabel wyjściowych.

Ustaw połączenie dla zarządzanego złącza DB2

Wykonaj kroki na podstawie tego, czy masz bazę danych w chmurze, czy lokalną bazę danych DB2. Po podaniu niezbędnych szczegółów połączenia wybierz pozycję Utwórz nową i wróć do poprzednich kroków.

Zanim utworzysz połączenie zarządzanego łącznika z bazą danych lokalnie, upewnij się, że zainstalowałeś i skonfigurowałeś bramę danych lokalną. Ten wymóg bramy nie dotyczy wbudowanego złącza.

Właściwości Wymagane Opis
Nawiązywanie połączenia za pośrednictwem bramy lokalnej Nie. Dotyczy tylko połączeń lokalnych.
Nazwa połączenia Tak Nazwa połączenia, na przykład DB2-connection.
Serwer Tak Adres, alias i numer portu dla serwera DB2, na przykład, myDB2server.example.com:50000.

Uwaga: Ta wartość jest ciągiem reprezentującym adres TCP/IP lub alias w formacie IPv4 lub IPv6, po którym następuje dwukropek i numer portu TCP/IP.
Baza danych Tak Nazwa bazy danych.

Uwaga: Ta wartość jest ciągiem reprezentującym nazwę relacyjnej bazy danych DRDA (RDBNAM):

- DB2 for z/OS akceptuje 16-bajtowy ciąg, w którym baza danych jest znana jako IBM DB2 dla z/OS.

— Db2 for i akceptuje 18-bajtowy ciąg, w którym baza danych jest znana jako relacyjna baza danych IBM DB2 for i.

- DB2 for LUW akceptuje ciąg 8-bajtowy.
Nazwa użytkownika Tak Nazwa użytkownika bazy danych.

Uwaga: Ta wartość jest ciągiem, którego długość jest oparta na określonej bazie danych:

- DB2 for z/OS akceptuje ciąg 8-bajtowy.

- DB2 for i akceptuje ciąg 10-bajtowy.

- DB2 dla systemu Linux lub UNIX akceptuje ciąg 8-bajtowy.

- DB2 dla systemu Windows akceptuje ciąg 30-bajtowy.
Hasło Tak Hasło bazy danych.

Na przykład:

Zrzut ekranu przedstawiający okienko połączenia dla baz danych opartych na chmurze.

Ustaw połączenie z wbudowanym złączem DB2

W przypadku kluczowych standardowych przepływów pracy należy użyć wbudowanego złącza. Wbudowany łącznik łączy się bezpośrednio ze środowiska uruchomieniowego Azure Logic Apps z serwerem DB2 przez protokół TCP/IP i nie korzysta z lokalnej bramy danych. Upewnij się, że środowisko hostingowe aplikacji logicznych Standard ma dostęp sieciowy do serwera DB2 i portu.

W projektantze workflow wybierz Wbudowane, wybierz pożądaną akcję DB2 i utwórz połączenie. Podaj następujące informacje dotyczące Twojego środowiska DB2:

Właściwości Opis
Nazwa połączenia Nazwa połączenia.
Nazwa serwera Nazwa serwera DB2.
Numer portu Numer portu bazy danych na serwerze DB2.
Baza danych Nazwa bazy danych na serwerze DB2.
Nazwa użytkownika Nazwa użytkownika do dostępu do serwera DB2.
Hasło Hasło do nazwy użytkownika DB2.
Kolekcja pakietów Kolekcja paczek. Jeśli pole jest puste, domyślnie przyjmuje nazwę użytkownika.
domyślny schemat Domyślny schemat wywołań schematu domyślnie przyjmuje nazwę użytkownika, jeśli jest pusta.
Gospodarz CCSID Identyfikator zestawu znaków kodowany przez hosta (CCSID) dla bazy DB2 domyślnie przyjmuje 1208, jeśli jest pusty.
Strona kodowa PC Strona kodowa PC dla połączenia DB2 domyślnie pokazuje 1208, jeśli jest pusta.
Dodatkowe słowa kluczowe parametrów połączenia Opcjonalne słowa kluczowe parametrów połączenia, oddzielone średnikami.
Łańcuch połączenia Parametr połączenia DB2, który, jeśli nie jest pusty, powoduje zignorowanie pozostałych właściwości.

Testowanie przepływu pracy i wyświetlanie tabel wyjściowych

Poniższy przykład pokazuje dane wyjściowe z akcji Get tables zarządzanego konektora. Możesz w ten sam sposób przetestować przepływ pracy, który używa wbudowanej akcji łącznika. Aby ręcznie uruchomić przepływ pracy, na pasku narzędzi projektanta z listy Uruchom wybierz pozycję Uruchom. Po zakończeniu przepływu pracy możesz wyświetlić dane wyjściowe z przebiegu.

  1. Jeśli strona szczegółów przebiegu nie zostanie otwarta, wykonaj następujące kroki w oparciu o aplikację logiki:

    • Użycie: na pasku bocznym aplikacji Logic Apps, w sekcji Narzędzia programistyczne, wybierz pozycję Projektant Logic Apps.

    • Standard: na pasku bocznym przepływu pracy wybierz pozycję Historia uruchamiania.

  2. Na liście Historia przebiegów wybierz najnowszy przebieg przepływu pracy, na przykład:

    • Zużycie

      Zrzut ekranu przedstawia listę historii uruchomień dla przepływu pracy o nazwie

    • Standard

      Zrzut ekranu przedstawia listę historii uruchomień dla standardowego przepływu pracy.

  3. Na stronie szczegółów przebiegu przejrzyj stan każdego kroku w przepływie pracy. Aby wyświetlić dane wejściowe i wyjściowe dla każdego kroku, wybierz ten krok, na przykład:

    Zrzut ekranu przedstawia dane wejściowe i wyjściowe akcji Pobierz tabele.

    1. Aby wyświetlić dane wejściowe w formacie JSON, wybierz pozycję Pokaż nieprzetworzone dane wejściowe.

    2. Aby wyświetlić dane wyjściowe w formacie JSON, wybierz pozycję Pokaż nieprzetworzone dane wyjściowe.

      Dane wyjściowe zawierają listę tabel, na przykład:

      Zrzut ekranu przedstawia dane wyjściowe z akcji Pobierz tabele.