{"id":48851,"date":"2024-07-24T11:38:55","date_gmt":"2024-07-24T09:38:55","guid":{"rendered":"https:\/\/community.simplifier.io\/doc\/sql-konnektor\/aufrufe-von-sql-connectors\/"},"modified":"2026-06-03T01:02:16","modified_gmt":"2026-06-02T23:02:16","slug":"aufrufe-von-sql-connectors","status":"publish","type":"manual_documentation","link":"https:\/\/community.simplifier.io\/de\/doc\/current-release\/integrate\/connectors\/sql-connector-details\/sql-connector-calls\/","title":{"rendered":"SQL-Konnektor-Aufrufe"},"content":{"rendered":"

[vc_row row_content_display=”in_grid” row_content_display_align=”left” row_type=”row” stretch_row_type=”yes”][vc_column][vc_tta_tabs][vc_tta_section title=”Konnektor-Assistent” tab_id=”1677248933174-c1b0564b-def8″][vc_column_text]<\/p>\n

Konnektor-Assistent<\/h2>\n

In der \u00dcbersicht \u00fcber Connector-Anrufe finden Sie den Connector Wizard<\/strong> in der oberen rechten Ecke.<\/p>\n

Mit dem SQL-Assistenten ist es einfach, neue Konnektor-Aufrufe basierend auf SQL-Konnektoren f\u00fcr MySQL und Oracle zu konfigurieren.<\/p>\n

Beim \u00d6ffnen des Assistenten werden alle f\u00fcr das Schema verf\u00fcgbaren Tabellen angezeigt.[\/vc_column_text][vc_single_image image=”72349″ img_size=”full” onclick=”link_image”][vc_column_text]Schritt 1: Abfragen ausw\u00e4hlen<\/strong><\/p>\n

Im ersten Schritt k\u00f6nnen Sie nach der Tabelle suchen und dann unter “Aktionen” ausw\u00e4hlen, ob Sie alle Spalten (rechtes Symbol) oder nur bestimmte (linkes Symbol) ausw\u00e4hlen m\u00f6chten.[\/vc_column_text][vc_single_image image=”72350″ img_size=”full” onclick=”link_image”][vc_column_text]Wenn Sie nur bestimmte ausw\u00e4hlen m\u00f6chten, klicken Sie auf das linke Symbol. Ein neues Popup-Fenster \u00f6ffnet sich, in dem Sie die gew\u00fcnschten Spalten ausw\u00e4hlen k\u00f6nnen. Klicken Sie dann auf OK.[\/vc_column_text][vc_single_image image=”72351″ img_size=”full” onclick=”link_image”][vc_column_text]Schritt 2: Konfigurieren Sie die Konnektor-Aufrufe<\/strong><\/p>\n

Nachdem Sie die gew\u00fcnschten Tabellen und ggf. deren Spalten ausgew\u00e4hlt haben, k\u00f6nnen Sie die Konnektor-Aufrufe bearbeiten, indem Sie auf “Konnektor-Aufrufe bearbeiten” klicken.<\/p>\n

Wenn Sie die Aufrufe bearbeitet haben, klicken Sie auf “Konnektor-Aufrufe erstellen”.[\/vc_column_text][vc_single_image image=”72352″ img_size=”full” onclick=”link_image”][\/vc_tta_section][vc_tta_section title=”Manuelle Konfiguration” tab_id=”1627394640010-253e1329-1def”][vc_column_text]<\/p>\n

Manuelle Konfiguration<\/h2>\n

Wenn Sie einen SQL-Konnektor-Aufruf manuell erstellen, sehen Sie zwei Registerkarten: ‘Allgemein’ und ‘Eingabeparameter’.[\/vc_column_text][vc_separator][vc_column_text css=””]<\/p>\n

Allgemein<\/h3>\n

Hier k\u00f6nnen Sie die grundlegenden Eigenschaften f\u00fcr Ihren Connector-Aufruf konfigurieren.<\/p>\n

Modus<\/h4>\n\n\n\n\n\n\n\n\n
Parametermodus<\/strong><\/td>\nBeschreibung<\/strong><\/td>\n<\/tr>\n
simple<\/td>\nEinfache SQL-Abfrage ohne Variablen oder dynamische Parameter<\/td>\n<\/tr>\n
query<\/td>\nParametrisierte SQL-Abfrage<\/td>\n<\/tr>\n
execute<\/td>\nInsert- oder Update-Anweisungen ohne R\u00fcckgabe<\/td>\n<\/tr>\n
transaction<\/td>\nSQL-Transaktionen mit Rollback bei Fehler<\/td>\n<\/tr>\n
repeatable statement<\/td>\nWiederholbare SQL-Anweisungen f\u00fcr Insert- oder Update-Abfragen f\u00fcr Massen-Inserts, Aktualisierung<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Dynamische WHERE-Klausel verwenden<\/h4>\n

Nur auf “true” setzen, wenn Sie eine dynamische WHERE-Klausel verwenden m\u00f6chten. Weitere Informationen finden Sie im Dokumentationsabschnitt ‘Modus: query<\/a>‘.[\/vc_column_text][vc_column_text css=””]<\/p>\n

Abfrage<\/h4>\n

Geben Sie die SQL-Anweisung f\u00fcr diesen Konnektor-Aufruf ein.<\/p>\n

Um einen Verweis auf einen Eingabeparameter zu erstellen, setzen Sie den Eingabeparameternamen in Doppelpunkte, zum Beispiel:<\/p>\n

SELECT id, name, city FROM person WHERE id = :personalId:;<\/code><\/p>\n

Code-Vervollst\u00e4ndigung f\u00fcr Eingabe- und Ausgabeparameter (:<\/em>) ist verf\u00fcgbar[\/vc_column_text][vc_column_text css=””]<\/p>\n

Ausgabe<\/h4>\n

Definieren Sie den Datentyp des Ausgabeparameters.[\/vc_column_text][vc_separator][vc_column_text]<\/p>\n

Eingabeparameter<\/h3>\n

Auf dieser Registerkarte k\u00f6nnen Sie die Eingabeparameter f\u00fcr Ihren Konnektor-Aufruf und deren Datentyp definieren. Wenn Sie in Ihrer SQL-Anweisung bereits einen Eingabeparameter erw\u00e4hnt haben, wird automatisch ein Eintrag auf der Registerkarte Eingabeparameter hinzugef\u00fcgt.[\/vc_column_text][vc_separator][vc_column_text]<\/p>\n

Fortgeschritten<\/h3>\n

Setzen Sie den Schalter “Erweitert” in der oberen rechten Ecke des Dialogs auf “true”, um weitere Konfigurationsoptionen f\u00fcr die Eingangs- und Ausgangsparameter anzuzeigen.<\/p>\n

Sie k\u00f6nnen zum Beispiel festlegen, ob die Parameter erforderlich oder optional sind oder ob sie einen konstanten Wert haben sollen.[\/vc_column_text][vc_column_text][\/vc_column_text][\/vc_tta_section][vc_tta_section title=”Modus: Simple” tab_id=”1627394640060-6591fc79-9b7e”][vc_message message_box_color=”danger” css=””]Der Simple-Modus ist veraltet und sollte nicht mehr verwendet werden. Bitte \u00e4ndere deine Modi auf Query oder Execute.[\/vc_message][vc_column_text]<\/p>\n

Modus: Simple<\/h2>\n

Der ‘Simple Call’ entspricht einem nicht parametrisierten SQL-Aufruf.<\/p>\n

Die SQL-Anfrage wird durch einen ‘String’ ohne Variablensubstitution definiert.<\/span><\/p>\n

Um die Ausgabe der SQL-Anfrage verarbeiten zu k\u00f6nnen, muss sie im Ausgabeparameter des Konnektor-Aufrufs definiert werden. <\/span><\/p>\n

Derzeit k\u00f6nnen Sie das gesamte JSON-Ergebnis noch einem einzelnen Parameter zuordnen.
\nDies ist m\u00f6glich, indem Sie ein ‘\/’ als Parameternamen und den Datentyp ‘String’ in den Ausgabeparametern angeben.[\/vc_column_text][vc_single_image image=”72353″ img_size=”full” alignment=”center” style=”vc_box_border” onclick=”link_image”][vc_single_image image=”72354″ img_size=”full” alignment=”center” style=”vc_box_border” onclick=”link_image”][\/vc_tta_section][vc_tta_section title=”Modus: Query” tab_id=”1627395837619-f6c636cb-1a0b”][vc_column_text]<\/p>\n

Modus: Query<\/h2>\n

Der ‘Query Call’ wird verwendet, um das Ergebnis einer SQL-Anweisung an den Simplifier zu \u00fcbertragen.
\n(Normalerweise haben SELECT-Anweisungen ein Ergebnis)<\/span><\/p>\n

Die SQL-Anfrage des ‘Query Call’ ist parametrisiert (im Gegensatz zum ‘Simple Call’).<\/span><\/p>\n

[\/vc_column_text][vc_column_text]<\/p>\n

Definition des konstanten Werts f\u00fcr den Anfrageparameter<\/h2>\n

Der Eingabewert des Anfrageparameters wird durch einen Namen und einen Simplifier-Datentyp dargestellt. In unserem Beispiel haben wir den Namen ‘mail’ und den Datentyp ‘String’ verwendet.
\nEine Parameterdefinition wird mit einem Doppelpunkt eingeleitet und beendet. Zwischen den Doppelpunkten befindet sich ein Wertepaar, das ebenfalls durch einen Doppelpunkt getrennt ist und den Namen und den Typ des Parameters darstellt.
\nIn einer parametrisierten SQL-Anfrage: <\/p>\n

SELECT * FROM user_data WHERE email LIKE :mail:<\/code><\/p>\n

Wenn Sie mehr Werte in einer SQL-Anweisung verwenden, m\u00fcssen Sie eine durch Komma getrennte Syntax verwenden, z. B. VALUES (:id:,:mail:)..[\/vc_column_text][vc_single_image image=”72355″ img_size=”full” alignment=”center” style=”vc_box_border” onclick=”link_image”][vc_single_image image=”72356″ img_size=”full” alignment=”center” style=”vc_box_border” onclick=”link_image”][vc_separator][vc_column_text]<\/p>\n

Dynamische WHERE-Klausel<\/h2>\n

F\u00fcr die Ausf\u00fchrung dynamisch erstellter WHERE-Klauseln – lesen Sie bitte die folgenden Zeilen:<\/p>\n

Sehen wir uns an, wie wir unseren Konnektor-Aufruf konfigurieren m\u00fcssen, um diese Funktion zu nutzen.[\/vc_column_text][vc_message message_box_color=”warning” icon_fontawesome=”fas fa-exclamation-triangle”]Die dynamische WHERE-Klausel kann nur verwendet werden<\/strong> in den Modi simple<\/a>, query<\/a> & execute<\/a>.[\/vc_message][vc_message message_box_color=”warning” icon_fontawesome=”fas fa-exclamation-triangle”]Wenn Sie eine dynamische WHERE-Klausel verwenden, stellen Sie sicher, dass Ihre regul\u00e4re SQL-Anweisung nicht mit einem Semikolon endet.[\/vc_message][vc_single_image image=”72357″ img_size=”full” alignment=”center” style=”vc_box_shadow” onclick=”link_image”][vc_column_text]Hier k\u00f6nnen Sie sehen, dass Sie nur Ihre regul\u00e4re SQL-Anweisung ohne die WHERE-Klausel danach auf der Registerkarte ‘SQL’ des Konnektor-Aufrufs schreiben m\u00fcssen.[\/vc_column_text][vc_single_image image=”72358″ img_size=”full” alignment=”center” style=”vc_box_shadow” onclick=”link_image”][vc_column_text]In der Eingabe-Zuordnung m\u00fcssen wir einen neuen Parameter namens ‘where’ angeben, der als Platzhalter f\u00fcr Ihre WHERE-Klausel dient, die Sie an die SQL-Anweisung anh\u00e4ngen m\u00f6chten.<\/p>\n

So sieht unser Ergebnis aus, wenn wir verschiedene Werte f\u00fcr den Parameter ‘where’ verwenden und den Konnektor-Aufruf in der Simplifier-UI testen:[\/vc_column_text][vc_single_image image=”72359″ img_size=”full” alignment=”center” style=”vc_box_shadow” onclick=”link_image”][vc_single_image image=”72360″ img_size=”full” alignment=”center” style=”vc_box_shadow” onclick=”link_image”][vc_column_text]Und dies ist eine Demonstration des oben erw\u00e4hnten Bad-Word-Filters, wenn Sie versuchen, reservierte W\u00f6rter aus der Liste (siehe unten) an den Parameter ‘where’ zu \u00fcbergeben.[\/vc_column_text][vc_single_image image=”72361″ img_size=”full” alignment=”center” style=”vc_box_shadow” onclick=”link_image”][vc_column_text]Aus Sicherheitsgr\u00fcnden filtern wir schlechte Befehle heraus, die zu einer Ablehnung des Aufrufs f\u00fchren:<\/p>\n