Verwenden von Parametern in SQL-Abfragen

In diesem Artikel wird erläutert, wie Parameter beim Schreiben von BEISPIEL-SQL-Anweisungen in einem Genie-Raum verwendet werden.

Warum Parameter verwenden?

Mit Parametern können Sie Beispielabfragen mit Platzhaltern erstellen, die zur Laufzeit durch spezifische Werte ersetzt werden. Mit Parametern kann Genie bestimmte Eingaben von Benutzerfragen annehmen und die Struktur einer Beispielabfrage wiederverwenden, um überprüfte Antworten als vertrauenswürdige Ressourcen bereitzustellen. Sie können z. B. die vorherige SQL-Abfrage so anpassen, dass sie einen Parameter enthält, der nach dem o.forecastcategory-Wert filtert, sodass die Abfrage Fragen zu Chancen behandeln kann, die in verschiedenen Prognosekategorien kategorisiert sind. Weitere Informationen zur Verwendung parametrisierter Abfragen zum Generieren von Antworten, die als vertrauenswürdige Ressourcen bezeichnet werden, finden Sie unter Verwenden von vertrauenswürdigen Ressourcen in AI/BI Genie Spaces.

Die folgende Beispielabfrage berechnet die Gesamtsumme der Verkaufschancen für offene Pipelinewerte nach Region. Er enthält einen Parameter für den o.forecastcategory Wert. Parameter verwenden dieselbe Syntax wie benannte Parametermarkierungen. Weitere Anleitungen zur Verwendung von Parametern in einem Genie-Bereich finden Sie unter Arbeiten mit Abfrageparametern und benannten Parametermarkern.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

So fügen Sie einer Abfrage einen Parameter hinzu:

1. Platzieren Sie den Cursor an der Stelle, an der Sie den Parameter in Ihrer Abfrage platzieren möchten.

2. Klicken Sie auf Parameter hinzufügen, um einen neuen Parameter einzufügen.

   Dadurch wird ein neuer Parameter mit dem Standardnamen parametererstellt. Um den Standardnamen zu ändern, ersetzen Sie ihn im Abfrage-Editor. Sie können auch Parameter hinzufügen, indem Sie einen Doppelpunkt gefolgt von einem Parameternamen (:parameter_name) in den Editor eingeben.

Bearbeiten eines Abfrageparameters

Gehen Sie wie folgt vor, um einen Parameter zu bearbeiten:

1. Klicken Sie auf Neben dem Parameternamen. Das Dialogfeld Parameterdetails mit den folgenden Konfigurationsoptionen wird angezeigt:

   • Schlüsselwort-: Das Schlüsselwort, das den Parameter in der Abfrage darstellt. Das Schlüsselwort kann nur geändert werden, indem der Text in der Abfrage direkt aktualisiert wird.

   • Anzeigename: Der lesbare Name, den Genie im Chat-Erlebnis verwendet. Wenn Genie eine Antwort mithilfe einer parametrisierten Abfrage generiert, enthält sie den Anzeigenamen und den zugeordneten Wert in der Antwort.

   • Typ-: Unterstützte Typen umfassen Zeichenkette, Datum, Datum und Uhrzeitund Zahl.

     • Der Standardtyp ist String.
     • Mit dem Datentyp Numerisch können Sie Dezimalzahl und Ganzzahl unterscheiden. Der standardmäßige numerische Typ ist Dezimal-.

     Hinweis

     Wenn der tatsächliche Eingabewert nicht mit dem ausgewählten Parametertyp übereinstimmt, behandelt Genie den Eingabewert als falschen Typ, was zu ungenauen Ergebnissen führen kann.

2. Klicken Sie auf einen anderen Teil der Benutzeroberfläche, um das Dialogfeld zu schließen.

Parametrisierte Abfrageantworten

Wenn der genaue Text eines Parameters in einer Antwort verwendet wird, wird die Antwort als vertrauenswürdig markiert. Dies bedeutet, dass Genie basierend auf dem Kontext des Raums erkannte, dass die Benutzerfrage mit der Absicht einer Beispiel- oder Abfragefrage übereinstimmte.

Mit der Bezeichnung "Vertrauenswürdig" können Benutzer wissen, dass die Antwort von Genie auf einer überprüften SQL-Abfrage basiert. Sie können die generierten SQL- und Paramterwerte sehen, die in der Antwort verwendet werden.