Udostępnij przez

Używanie parametrów w zapytaniach SQL

W tym artykule wyjaśniono, jak używać parametrów podczas pisania przykładowych instrukcji SQL w obszarze Genie.

Dlaczego warto używać parametrów?

Parametry umożliwiają pisanie przykładowych zapytań z symbolami zastępczymi dla określonych wartości, które mają być zastępowane w czasie wykonywania. Dzięki parametrom usługa Genie może pobierać określone dane wejściowe od pytań użytkownika i ponownie używać struktury przykładowego zapytania w celu dostarczenia zweryfikowanych odpowiedzi jako zaufanych zasobów. Można na przykład dostosować poprzednie zapytanie SQL, aby uwzględnić parametr filtrujący według wartości o.forecastcategory, umożliwiając zapytaniu odpowiadanie na pytania dotyczące możliwości oznaczonych w różnych kategoriach prognozy. Aby uzyskać więcej informacji na temat używania sparametryzowanych zapytań do generowania odpowiedzi oznaczonych jako zaufane zasoby, zobacz Use trusted assets in AI/BI Genie spaces (Używanie zaufanych zasobów w przestrzeniach AI/BI Genie).

Poniższe przykładowe zapytanie oblicza łączną wartość otwartych możliwości sprzedażowych w ramach lejka sprzedażowego w podziale na regiony. Zawiera parametr dla o.forecastcategory wartości. Parametry używają tej samej składni co znaczniki nazwanych parametrów. Aby uzyskać więcej wskazówek dotyczących używania parametrów w przestrzeni Genie, zobacz Praca z parametrami zapytania i znacznikami nazwanych parametrów.

-- 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;

Aby dodać parametr do zapytania:

  1. Umieść kursor, w którym chcesz umieścić parametr w zapytaniu.

  2. Kliknij Dodaj parametr, aby wstawić nowy parametr.

    Spowoduje to utworzenie nowego parametru o nazwie domyślnej parameter. Aby zmienić nazwę domyślną, zastąp ją w edytorze zapytań. Parametry można również dodać, wpisując dwukropek, po którym następuje nazwa parametru (:parameter_name) w edytorze.

Edytowanie parametru zapytania

Aby edytować parametr, wykonaj następujące czynności:

  1. Kliknij ikonę koła zębatego obok nazwy parametru. Pojawi się okno dialogowe Szczegóły parametru, które zawiera następujące opcje konfiguracji:

    • słowo kluczowe: słowo kluczowe reprezentujące parametr w zapytaniu. Słowo kluczowe można zmienić tylko przez bezpośrednie zaktualizowanie tekstu w zapytaniu.

    • Nazwa wyświetlana: zrozumiała dla użytkownika nazwa używana przez Genie w interfejsie czatu. Gdy Genie generuje odpowiedź przy użyciu zapytania sparametryzowanego, w odpowiedzi zawiera nazwę wyświetlaną oraz skojarzoną wartość.

    • Typ: Obsługiwane typy obejmują Ciąg, Data, Data i Godzinaoraz Numer.

      • Domyślnym typem jest Ciąg.
      • Typ danych liczbowy umożliwia wybór pomiędzy liczbą dziesiętną a liczbą całkowitą. Domyślnym typem liczbowym jest dziesiętna.

      Uwaga

      Jeśli rzeczywista wartość wejściowa nie jest zgodna z wybranym typem parametru, Genie traktuje wartość wejściową jako nieprawidłowy typ, co może prowadzić do niedokładnych wyników.

  2. Kliknij inną część interfejsu użytkownika, aby zamknąć okno dialogowe.

Sparametryzowane odpowiedzi zapytań

Gdy dokładny tekst parametru jest używany w odpowiedzi, odpowiedź jest oznaczona jako zaufana. Oznacza to, że Genie zidentyfikował, na podstawie kontekstu danego środowiska, że pytanie użytkownika jest zgodne z intencją przykładowego pytania lub zapytania.

Etykieta Zaufana informuje użytkowników o tym, że odpowiedź Genie jest oparta na zweryfikowanym zapytaniu SQL. Widzą wygenerowane wartości SQL i paramter, które są używane w odpowiedzi.

  • Last updated on