Query Data Node
Eine Datenquelle durchsuchen und passende Ergebnisse abrufen.
Überblick
Der Query Data Node durchsucht eine Datenquelle und gibt passende Ergebnisse zurück. Er unterstützt zwei Suchmodi — Semantisch und Strukturiert — und bietet damit Flexibilität zwischen natürlichsprachlichen Abfragen und präziser spaltenbasierter Filterung. Ergebnisse können in verschiedenen Ausgabeformaten zurückgegeben werden, um die Integration mit nachfolgenden Nodes zu erleichtern.
Datenquellen umfassen Ubex Tables. Jede Tabelle, die Sie unter „My Data" erstellen, steht hier als Datenquelle zur Verfügung. Sie können integrierte Ubex-Tabellen abfragen, ohne eine externe Datenbank einrichten zu müssen. Weitere Informationen zum Erstellen von Tabellen finden Sie in der My Data Dokumentation.
Konfiguration
| Feld | Beschreibung | Erforderlich |
|---|---|---|
Select Source |
Die Datenquelle, gegen die abgefragt wird | Ja |
Search Mode |
Umschalten zwischen Semantischer oder Strukturierter Suche | Ja |
Select output format |
Wie Ergebnisse zurückgegeben werden (Zeilenliste, Einzelne Zeile, Schlüssel-Wert-Wörterbuch) | Ja |
Output Variable |
Variablenname zum Speichern der Ergebnisse | Ja |
Suchmodi
Semantisch
Durchsucht alle durchsuchbaren Spalten mithilfe KI-gestützter semantischer Zuordnung. Ideal für natürlichsprachliche Abfragen, bei denen Sie Ergebnisse nach Bedeutung statt nach exakten Werten finden möchten.
| Feld | Beschreibung | Erforderlich |
|---|---|---|
Search Query |
Freitext-Sucheingabe. Unterstützt Variablen über die Schaltfläche Insert Variable. | Ja |
Erweiterte Optionen (nur Semantisch)
| Einstellung | Typ | Bereich | Standard | Beschreibung |
|---|---|---|---|---|
Number of Results |
Schieberegler | 1–20 | 5 | Maximale Anzahl zurückgegebener Treffer |
Relevance Threshold |
Schieberegler | 0–1 | 0.7 | Minimaler Ähnlichkeitswert für die Aufnahme (0 = beliebiger Treffer, 1 = exakte Übereinstimmung) |
Strukturiert
Abfrage Ihrer Datenquelle mit präziser Kontrolle über Spalten, Filter, Sortierung und Paginierung. Am besten geeignet, wenn Sie die genaue Form der benötigten Daten kennen.
| Feld | Beschreibung | Erforderlich |
|---|---|---|
Columns to Return |
Wählen Sie die Spalten aus, die in den Ergebnissen enthalten sein sollen. Verwenden Sie die Schnellauswahl All oder None. | Ja |
Filters |
Bedingungen hinzufügen, um Ergebnisse einzugrenzen | Nein |
Sort By |
Ergebnisse nach einer oder mehreren Spalten sortieren | Nein |
Limit |
Maximale Anzahl zurückgegebener Zeilen (Standard: 100) |
Nein |
Offset |
Anzahl der zu überspringenden Zeilen vom Anfang (Standard: 0) |
Nein |
Ausgabeformat wählen
Steuern Sie, wie Ergebnisse geformt werden, bevor sie an den nächsten Node weitergegeben werden.
| Format | Beschreibung |
|---|---|
List of Rows |
Gibt alle passenden Ergebnisse als Array von Objekten zurück (Standard) |
Single Row (First) |
Gibt nur das erste passende Ergebnis als einzelnes Objekt zurück |
Key-Value Dictionary |
Gibt Ergebnisse als Schlüssel-Wert-Zuordnung für direkten Eigenschaftszugriff zurück |
Beispiel: Semantische Wissensdatenbank-Suche
Eine Wissensdatenbank mit der Frage eines Benutzers abfragen:
Select Source: product-docs
Mode: Semantic
Search Query: {{user_question}}
Number of Results: 5
Relevance Threshold: 0.7
Output Format: List of Rows
Output Variable: searchResults
Übergeben Sie dann {{searchResults}} an einen Model Node zur Antwortgenerierung.
Beispiel: Strukturierte Datenabfrage
Bestimmte Spalten mit Filterung und Paginierung abrufen:
Select Source: contact_rate_limits
Mode: Structured
Columns to Return: email, attempt_count, window_start
Filters: attempt_count > 5
Sort By: window_start DESC
Limit: 100
Offset: 0
Output Format: List of Rows
Output Variable: rateLimitData
Beispiel: Einzelnen Datensatz abrufen
Nur die erste passende Zeile für eine schnelle Abfrage erhalten:
Select Source: users
Mode: Structured
Columns to Return: email, name, role
Filters: email == {{input_email}}
Output Format: Single Row (First)
Output Variable: currentUser
Greifen Sie direkt auf Felder zu: {{currentUser.name}}, {{currentUser.role}}.
Beispiel: Schlüssel-Wert-Wörterbuch
Ergebnisse als Wörterbuch für direkten Eigenschaftszugriff zurückgeben:
Select Source: app_settings
Mode: Structured
Columns to Return: All
Output Format: Key-Value Dictionary
Output Variable: settings
Variablen verwenden
Dynamische Abfragen aus vorherigen Nodes übergeben:
{{user_input}}
{{extracted_keywords}}
{{model_generated_query}}
Verwenden Sie die Schaltfläche Insert Variable im Semantischen Modus, um verfügbare Variablen zu durchsuchen und einzufügen.
Best Practices
- Verwenden Sie den Semantischen Modus für natürlichsprachliche Abfragen und RAG-Workflows
- Verwenden Sie den Strukturierten Modus, wenn Sie präzise Kontrolle über Spalten, Filter und Sortierung benötigen
- Wählen Sie Single Row (First), wenn Sie nur ein Ergebnis benötigen, um unnötige Daten zu vermeiden
- Verwenden Sie Key-Value Dictionary, wenn nachfolgende Nodes direkten Eigenschaftszugriff benötigen
- Setzen Sie im Strukturierten Modus geeignete Limit- und Offset-Werte für die Paginierung
- Senken Sie den Relevanzschwellenwert im Semantischen Modus, wenn Sie zu wenige Ergebnisse erhalten