Jak napisać funkcję konektora SQL
  • 31 Oct 2023
  • 2 Minuty do przeczytania
  • Współtwórcy

Jak napisać funkcję konektora SQL


Article Summary

Jak napisać funkcję konektora SQL

Skorzystaj z tego przewodnika, aby połączyć aplikację Tulip z bazą danych SQL.

Oto przykład, jak używać funkcji konektorów Tulip do łączenia się z bazą danych SQL.

Aby dodać nowy konektor SQL:

1- Przejdź do strony Konektory, umieszczając kursor nad aplikacjami na pasku menu i wybierając Konektory z listy rozwijanej.

2- Kliknij "Dodaj konektor" w prawym górnym rogu ekranu, nadaj nazwę konektorowi i wybierz "SQL" jako typ konektora.

3- Na karcie Środowiska nowego konektora wybierz "Dodaj szczegóły połączenia".

4- Wypełnij odpowiednie dane, aby połączyć się z bazą danych:

  • Running On ("Cloud Connector Host", chyba że skonfigurowano inne ustawienie)
  • Typ
  • Serwer
  • Port
  • SSL (tak lub nie)
  • Baza danych
  • Nazwa użytkownika
  • Hasło

5- Kliknij przycisk Test, aby uruchomić sygnał testowy. Jeśli się powiedzie, kliknij "Zapisz".

6- Upewnij się, że host konektora ma dostęp do bazy danych (wskazuje na to zielona etykieta "Online" obok serwera na stronie Konektory).

Po pomyślnym skonfigurowaniu nowego konektora można teraz utworzyć funkcje konektora do wysyłania lub pobierania danych z zewnętrznej bazy danych. Funkcja konektora musi być napisana w odpowiednim języku docelowej bazy danych.

Aby skonfigurować nową funkcję konektora SQL:

1- Kliknij przycisk "Dodaj nową funkcję" na karcie Funkcje.

2- Nazwij nową funkcję (pozwoli to wybrać konkretną funkcję konektora w Triggerach).

  1. Skonfiguruj wejścia i wyjścia funkcji

W powyższym przykładzie:

Wejścia

  • konfiguracja (tekst)

Wyjścia

  • subconfig_1
  • subconfig_2
  • subconfig_3

Zapytanie

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM webinar database WHERE configuration = $configuration$ order by id desc limit 1````

Funkcja może mieć wiele wejść i wyjść. Będziesz potrzebował co najmniej jednego wejścia lub wyjścia, aby wysyłać/odbierać dane z aplikacji Tulip.

  • Kliknij Add, aby dodać nowe wejście lub wyjście
  • Nadaj polu rozpoznawalną nazwę
  • Wybierz typ danych (np. Text, Boolean, Integer itp.).
  • Dodaj prawidłową instrukcję SQL w polu Query. Należy pamiętać, że nazwy zmiennych wejściowych powinny być zawijane w $. Przykład:
    $input$.
  • Przetestuj funkcję
  • Jeśli funkcja ma dane wejściowe, wprowadź prawidłowe wartości
  • Kliknij "Test" w prawym górnym rogu.
  • Wyświetl wyniki testu lub komunikaty o błędach w sekcji Wyniki testu

  1. W niektórych przypadkach możesz chcieć zwrócić wiele wierszy z tabeli SQL. Aby to zrobić, zaznacz pole obok "Return Multiple Rows". Spowoduje to zwrócenie tablicy pełnej obiektów, gdzie każdy obiekt zawiera wartości z jednego wiersza w tabeli SQL.

Zapytanie

SELECT name, num from numbers where num > $number$

(w powyższym przykładzie liczba jest wartością wejściową)

Następnie, po dodaniu danych wejściowych i kliknięciu przycisku "Test", wszystkie oczekiwane wiersze powinny zostać zwrócone w sekcji "Wyniki testu".

Mogą one być przechowywane w zmiennej jako tablica pełna obiektów w edytorze wyzwalaczy.

7- Po zakończeniu naciśnij "Zapisz".

:::(Warning) (UWAGA) Wejścia i wyjścia nie mogą być zmieniane po zapisaniu funkcji. Ma to na celu zapobieganie zakłóceniom w aplikacjach, które mogą korzystać z funkcji łącznika.
:::

Jeśli zajdzie potrzeba dodania nowych wejść/wyjść, można skopiować funkcję i wprowadzić zmiany w nowej funkcji.

Więcej informacji na temat pisania niektórych często używanych funkcji SQL można znaleźć w sekcji"Typowe funkcje konektora SQL".

Więcej informacji


Czy znalazłeś to, czego szukałeś?

Możesz również udać się na stronę community.tulip.co, aby opublikować swoje pytanie lub sprawdzić, czy inni mieli do czynienia z podobnym pytaniem!


Czy ten artykuł był pomocny?