Usar parâmetros em consultas SQL

Este artigo explica como usar parâmetros ao escrever instruções SQL de exemplo em um espaço do Genie.

Por que usar parâmetros?

Os parâmetros permitem que você escreva consultas de exemplo com espaços reservados para que valores específicos sejam substituídos durante o tempo de execução. Com parâmetros, o Genie pode usar entradas específicas de perguntas do usuário e reutilizar a estrutura de uma consulta de exemplo para fornecer respostas verificadas como ativos confiáveis. Por exemplo, você pode ajustar a consulta SQL anterior para incluir um parâmetro filtrado pelo valor o.forecastcategory, permitindo que a consulta resolva perguntas sobre oportunidades marcadas em diferentes categorias de previsão. Para obter mais informações sobre como usar consultas parametrizadas para gerar respostas rotuladas como ativos confiáveis, consulte Usar ativos confiáveis em espaços Genie de IA/BI.

A consulta de exemplo a seguir calcula o valor total das oportunidades de vendas em aberto, por região. Ele inclui um parâmetro para o o.forecastcategory valor. Os parâmetros usam a mesma sintaxe que marcadores de parâmetro nomeados. Para obter mais diretrizes sobre como usar parâmetros em um espaço do Genie, consulte os tópicos Trabalhar com parâmetros de consulta e Marcadores de parâmetros nomeados.

-- 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 adicionar um parâmetro a uma consulta:

1. Coloque o cursor onde você deseja colocar o parâmetro em sua consulta.

2. Clique em Adicionar parâmetro para inserir um novo parâmetro.

   Isso cria um novo parâmetro com o nome padrão parameter. Para alterar o nome padrão, substitua-o no editor de consultas. Você também pode adicionar parâmetros digitando dois pontos seguidos por um nome de parâmetro (:parameter_name) no editor.

Editar um parâmetro de consulta

Para editar um parâmetro, faça o seguinte:

1. Clique no Ao lado do nome do parâmetro. Uma caixa de diálogo de detalhes do parâmetro é exibida e inclui as seguintes opções de configuração:

   • palavra-chave: a palavra-chave que representa o parâmetro na consulta. A palavra-chave só pode ser alterada atualizando diretamente o texto na consulta.

   • Nome de exibição: o nome legível por humanos que o Genie usa na experiência de chat. Quando o Genie gera uma resposta usando uma consulta parametrizada, ela inclui o nome de exibição e o valor associado na resposta.

   • Tipo: os tipos com suporte incluem String, Date, Date and Timee Numeric.

     • O tipo padrão é String.
     • O tipo de dados Numérico permite que você especifique entre Decimal e Inteiro. O tipo numérico padrão é Decimal .

     Observação

     Se o valor de entrada real não corresponder ao tipo de parâmetro selecionado, o Genie tratará o valor de entrada como o tipo incorreto, o que pode levar a resultados imprecisos.

2. Clique em outra parte da interface do usuário para fechar a caixa de diálogo.

Respostas de consulta parametrizadas

Quando o texto exato de um parâmetro é usado em uma resposta, a resposta é marcada como confiável. Isso significa que o Genie identificou, com base no contexto do espaço, que a pergunta do usuário correspondia à intenção de uma pergunta ou consulta de exemplo.

O rótulo Confiável informa aos usuários do espaço que a resposta do Genie é baseada em uma consulta SQL verificada. Eles podem ver os valores de SQL e de parâmetro gerados que são usados na resposta.