Utiliser des paramètres dans les requêtes SQL

Cet article explique comment utiliser des paramètres lors de l’écriture d’exemples d’instructions SQL dans un espace Génie.

Pourquoi utiliser des paramètres ?

Les paramètres vous permettent d’écrire des exemples de requêtes avec des espaces réservés pour des valeurs spécifiques à remplacer au moment de l’exécution. Avec les paramètres, Genie peut prendre des entrées spécifiques des questions utilisateur et réutiliser la structure d’une requête d’exemple pour fournir des réponses vérifiées en tant que ressources approuvées. Par exemple, vous pouvez ajuster la requête SQL précédente pour inclure un paramètre qui filtre par la valeur o.forecastcategory, ce qui permet à la requête de répondre à des questions sur les opportunités marquées dans différentes catégories de prévision. Pour plus d’informations sur l’utilisation de requêtes paramétrables pour générer des réponses étiquetées en tant que ressources approuvées, consultez Utiliser des ressources approuvées dans les espaces AI/BI Genie.

L’exemple de requête suivant calcule le nombre total d’opportunités de vente de valeur de pipeline ouverte par région. Il inclut un paramètre pour la o.forecastcategory valeur. Les paramètres utilisent la même syntaxe que les marqueurs de paramètres nommés. Pour plus d’informations sur l’utilisation de paramètres dans un espace Genie, consultez Utiliser des paramètres de requête et des marqueurs de paramètres nommés.

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

Pour ajouter un paramètre à une requête :

1. Placez votre curseur à l’endroit où vous souhaitez placer le paramètre dans votre requête.

2. Cliquez sur Ajouter un paramètre pour insérer un nouveau paramètre.

   Cela crée un paramètre avec le nom par défaut parameter. Pour modifier le nom par défaut, remplacez-le dans l’éditeur de requête. Vous pouvez également ajouter des paramètres en tapant un signe deux-points suivi d’un nom de paramètre (:parameter_name) dans l’éditeur.

Modifier un paramètre de requête

Pour modifier un paramètre, procédez comme suit :

1. Cliquez sur À côté du nom du paramètre. Une boîte de dialogue Détails des paramètres apparaît et inclut les options de configuration suivantes :

   • mot clé: mot clé qui représente le paramètre dans la requête. Le mot clé ne peut être modifié qu’en mettant directement à jour le texte dans la requête.

   • Nom d’affichage : le nom facile à lire que Genie utilise dans l’expérience de conversation. Lorsque Genie génère une réponse à l’aide d’une requête paramétrable, elle inclut le nom complet et la valeur associée dans la réponse.

   • Type: les types pris en charge incluent String, Date, Date et Heureet Numérique.

     • Le type par défaut est string.
     • Le type de données numérique vous permet de spécifier entre un décimal et un entier . Le type numérique par défaut est Decimal.

     Remarque

     Si la valeur d’entrée réelle ne correspond pas au type de paramètre sélectionné, Genie traite la valeur d’entrée comme le type incorrect, ce qui peut entraîner des résultats incorrects.

2. Cliquez sur une autre partie de l’interface utilisateur pour fermer la boîte de dialogue.

Réponses de requête paramétrables

Lorsque le texte exact d’un paramètre est utilisé dans une réponse, la réponse est marquée comme approuvée. Cela signifie que Genie a identifié, en fonction du contexte de l’espace, que la question de l’utilisateur correspond à l’intention d’un exemple de question ou de requête.

L’étiquette approuvée permet aux utilisateurs d’espace de savoir que la réponse de Genie est basée sur une requête SQL approuvée. Ils peuvent voir les valeurs SQL et paramter générées utilisées dans la réponse.