Usare i parametri nelle query SQL

Questo articolo illustra come usare i parametri quando si scrivono istruzioni SQL di esempio in uno spazio Genie.

Perché usare i parametri?

I parametri consentono di scrivere query di esempio con segnaposto per sostituire valori specifici in fase di esecuzione. Grazie ai parametri, Genie può accettare input specifici dalle domande dell'utente e riutilizzare la struttura di una domanda di esempio per fornire risposte verificate come risorse affidabili. Ad esempio, è possibile modificare la query SQL precedente in modo da includere un parametro che filtra in base al valore o.forecastcategory, consentendo alla query di risolvere le domande sulle opportunità contrassegnate in categorie di previsione diverse. Per ulteriori informazioni su come utilizzare query parametrizzate per generare risposte etichettate come asset attendibili, consultare Usare asset attendibili negli spazi AI/BI Genie.

La seguente query di esempio calcola il valore totale delle opportunità di vendita nella pipeline aperta per regione. Include un parametro per il o.forecastcategory valore. I parametri usano la stessa sintassi dei marcatori di parametro denominati. Per altre indicazioni sull'uso dei parametri in uno spazio Genie, vedere Usare parametri di query e marcatori di parametro denominati.

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

Per aggiungere un parametro a una query:

1. Posiziona il cursore nel punto in cui desideri inserire il parametro nella query.

2. Fare clic su Aggiungi parametro per inserire un nuovo parametro.

   Verrà creato un nuovo parametro con il nome predefinito parameter. Per modificare il nome predefinito, sostituisci il nome predefinito nell'editor di query. È anche possibile aggiungere parametri digitando due punti seguiti da un nome di parametro (:parameter_name) nell'editor.

Modificare un parametro di query

Per modificare un parametro, eseguire le operazioni seguenti:

1. Fare clic al nome del parametro. Viene visualizzata una finestra di dialogo dettagli parametro e include le seguenti opzioni di configurazione:

   • Parola chiave: parola chiave che rappresenta il parametro nella query. La parola chiave può essere modificata solo aggiornando direttamente il testo nella query.

   • Nome visualizzato: nome leggibile usato da Genie nell'esperienza di chat. Quando Genie genera una risposta utilizzando una query parametrizzata, include il nome da visualizzare e il valore associato nella risposta.

   • Type: i tipi supportati includono String, Date, data e orae numerico.

     • Il tipo predefinito è String.
     • Il tipo di dati numerico consente di specificare tra decimale e intero . Il tipo numerico predefinito è Decimal.

     Nota

     Se il valore di input effettivo non corrisponde al tipo di parametro selezionato, Genie considera il valore di input come tipo non corretto, che può causare risultati imprecisi.

2. Fare clic su un'altra parte dell'interfaccia utente per chiudere la finestra di dialogo.

Risposte alle query con parametri

Quando il testo esatto di un parametro viene usato in una risposta, la risposta viene contrassegnata come attendibile. Ciò significa che Genie ha identificato, in base al contesto dello spazio, la domanda dell'utente corrispondeva alla finalità di una domanda o di una query di esempio.

L'etichetta Attendibile informa gli utenti che la risposta di Genie si basa su una query SQL verificata. Possono visualizzare l'SQL generato e i valori dei parametri usati nella risposta.