Uso de parámetros en consultas SQL

En este artículo se explica cómo usar parámetros al escribir instrucciones SQL de ejemplo en un espacio de Genie.

¿Por qué usar parámetros?

Los parámetros permiten escribir consultas de ejemplo con marcadores de posición para que se sustituyan valores específicos en tiempo de ejecución. Con los parámetros, Genie puede tomar entradas específicas de preguntas del usuario y reutilizar la estructura de una consulta de ejemplo para proporcionar respuestas comprobadas como recursos de confianza. Por ejemplo, podría ajustar la consulta SQL anterior para incluir un parámetro que filtre por el valor de o.forecastcategory, lo que permite a la consulta abordar preguntas sobre las oportunidades etiquetadas en diferentes categorías de previsión. Para obtener más información sobre cómo usar consultas con parámetros para generar respuestas etiquetadas como recursos de confianza, consulte Uso de recursos de confianza en espacios de AI/BI Genie.

En la siguiente consulta de ejemplo se calcula el valor total de oportunidades de venta en canalización abierta por región. Incluye un parámetro para el o.forecastcategory valor. Los parámetros usan la misma sintaxis que los marcadores de parámetro con nombre. Para obtener más instrucciones sobre el uso de parámetros en un espacio de Genie, consulte Trabajar con parámetros de consulta y marcadores de parámetros con nombre.

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

Para agregar un parámetro a una consulta:

1. Coloque el cursor donde quiera colocar el parámetro en la consulta.

2. Haga clic en Agregar parámetro para insertar un nuevo parámetro.

   Esto crea un nuevo parámetro con el nombre predeterminado parameter. Para cambiar el nombre predeterminado, reemplácelo en el editor de consultas. También puede agregar parámetros escribiendo dos puntos seguidos de un nombre de parámetro (:parameter_name) en el editor.

Edición de un parámetro de consulta

Para editar un parámetro, haga lo siguiente:

1. Haga clic en Junto al nombre del parámetro. Aparece un cuadro de diálogo Detalles del parámetro e incluye las siguientes opciones de configuración:

   • Palabra clave: palabra clave que representa el parámetro de la consulta. La palabra clave solo se puede cambiar actualizando directamente el texto de la consulta.

   • Nombre para mostrar: el nombre legible que usa Genie en la experiencia de chat. Cuando Genie genera una respuesta mediante una consulta con parámetros, incluye el nombre para mostrar y el valor asociado en la respuesta.

   • tipo: los tipos admitidos incluyen cadena, fecha, fecha y horay numérico.

     • El tipo predeterminado es String.
     • El tipo de datos Numeric permite especificar entre Decimal y Entero. El tipo numérico predeterminado es decimal.

     Nota:

     Si el valor de entrada real no coincide con el tipo de parámetro seleccionado, Genie trata el valor de entrada como el tipo incorrecto, lo que puede provocar resultados inexactos.

2. Haga clic en otra parte de la interfaz de usuario para cerrar el cuadro de diálogo.

Respuestas de consulta con parámetros

Cuando se usa el texto exacto de un parámetro en una respuesta, la respuesta se marca como de confianza. Esto significa que, en función del contexto del espacio, Genie identificó que la pregunta del usuario coincide con la intención de una pregunta o consulta de ejemplo.

La etiqueta De confianza permite a los usuarios saber que la respuesta de Genie se basa en una consulta SQL examinada. Pueden ver los valores SQL y paramter generados que se usan en la respuesta.