Wie man eine SQL-Connector-Funktion schreibt
  • 31 Oct 2023
  • 2 Minuten zu lesen
  • Mitwirkende

Wie man eine SQL-Connector-Funktion schreibt


Article Summary

Wie man eine SQL-Connector-Funktion schreibt

Verwenden Sie diese Anleitung, um Ihre Tulip-Anwendung mit einer SQL-Datenbank zu verbinden.

Hier ist ein Beispiel, wie Sie die Connectors-Funktion von Tulip verwenden, um eine Verbindung zu einer SQL-Datenbank herzustellen.

Um einen neuen SQL-Connector hinzuzufügen:

1- Gehen Sie auf die Seite Connectors, indem Sie den Cursor über Apps in der Menüleiste platzieren und Connectors aus dem Dropdown-Menü wählen.

2- Klicken Sie oben rechts auf dem Bildschirm auf "Connector hinzufügen", geben Sie Ihrem Connector einen Namen und wählen Sie "SQL" als Connector-Typ.

3- Wählen Sie auf der Registerkarte Umgebungen des neuen Connectors "Verbindungsdetails hinzufügen".

4- Füllen Sie die entsprechenden Details aus, um eine Verbindung zur Datenbank herzustellen:

  • Ausführen auf ("Cloud Connector Host", es sei denn, Sie haben eine andere Einstellung vorgenommen)
  • Typ
  • Server
  • Anschluss
  • SSL (ja oder nein)
  • Datenbank
  • Benutzername
  • Kennwort

5- Klicken Sie auf die Schaltfläche "Test", um ein Testsignal auszuführen. Wenn er erfolgreich ist, klicken Sie auf "Speichern".

6- Vergewissern Sie sich, dass der Connector-Host Zugriff auf die Datenbank hat (angezeigt durch das grüne Etikett "Online" neben dem Server auf der Seite "Connectors")

Nachdem Sie erfolgreich einen neuen Connector eingerichtet haben, können Sie nun Connector-Funktionen erstellen, um Daten aus der externen Datenbank zu senden oder abzurufen. Eine Connector-Funktion muss in der entsprechenden Sprache der Zieldatenbank geschrieben sein.

So richten Sie eine neue SQL-Connector-Funktion ein:

1- Klicken Sie auf der Registerkarte Funktionen auf die Schaltfläche "Neue Funktion hinzufügen".

2- Benennen Sie die neue Funktion (so können Sie die spezifische Konnektor-Funktion in Triggers auswählen).

  1. Konfigurieren Sie die Eingänge und Ausgänge der Funktion

Im obigen Beispiel:

Eingänge

  • Konfiguration (Text)

Ausgänge

  • Unterkonfiguration_1
  • subconfig_2
  • subconfig_3

Abfrage

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

Eine Funktion kann mehrere Eingänge und Ausgänge haben. Sie benötigen mindestens einen Eingang oder Ausgang, um Daten von einer Tulip App zu senden/empfangen.

  • Klicken Sie auf Hinzufügen, um einen neuen Eingang oder Ausgang hinzuzufügen
  • Geben Sie dem Feld einen erkennbaren Namen
  • Wählen Sie den Datentyp (z.B. Text, Boolean, Integer, etc.)
  • Fügen Sie eine gültige SQL-Anweisung in das Feld Abfrage ein. Beachten Sie, dass die Namen der Eingabevariablen in $ eingeschlossen sein sollten. Beispiel:
    $Eingabe$.
  • Testen Sie die Funktion
  • Wenn die Funktion Eingaben hat, geben Sie gültige Werte ein
  • Klicken Sie oben rechts auf "Testen".
  • Sehen Sie sich die Testergebnisse oder Fehlermeldungen im Abschnitt " Testergebnisse" an.

  1. In einigen Fällen möchten Sie vielleicht mehrere Zeilen aus einer SQL-Tabelle zurückgeben. Aktivieren Sie dazu das Kästchen neben "Mehrere Zeilen zurückgeben". Dadurch wird ein Array mit Objekten zurückgegeben, wobei jedes Objekt Werte aus einer Zeile der SQL-Tabelle enthält.

Abfrage

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

(im obigen Beispiel ist die Zahl eine Eingabe)

Wenn Sie dann Ihre Eingaben hinzufügen und auf "Test" klicken, sollten Sie alle erwarteten Zeilen unter "Testergebnisse" sehen.

Diese können in einer Variablen als Array voller Objekte im Trigger-Editor gespeichert werden.

7- Klicken Sie auf "Speichern", wenn Sie fertig sind.

:::(Warning) (HINWEIS) Eingänge und Ausgänge können nach dem Speichern einer Funktion nicht mehr geändert werden. Dies dient dazu, Unterbrechungen von Anwendungen zu vermeiden, die möglicherweise eine Verbindungsfunktion verwenden.
:::

Wenn Sie neue Eingänge/Ausgänge hinzufügen müssen, können Sie die Funktion kopieren und die Änderungen in der neuen Funktion vornehmen.

Weitere Informationen über das Schreiben einiger häufig verwendeter SQL-Funktionen finden Sie unter"Allgemeine SQL-Connector-Funktionen".

Weitere Lektüre


Haben Sie gefunden, wonach Sie gesucht haben?

Sie können auch auf community.tulip.co Ihre Frage stellen oder sehen, ob andere mit einer ähnlichen Frage konfrontiert wurden!


War dieser Artikel hilfreich?