Pular para o conteúdo principal

Usar parâmetros em consultas SQL

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

Por que usar parâmetros?​

Os parâmetros permitem que você escreva exemplos de consultas com espaços reservados para valores específicos a serem substituídos em tempo de execução. Com parâmetros, o Genie pode receber entradas específicas de perguntas de usuários e reutilizar a estrutura de um exemplo de consulta para fornecer respostas verificadas como ativo confiável. Por exemplo, o senhor poderia ajustar a consulta SQL anterior para incluir um parâmetro que filtra pelo valor o.forecastcategory, permitindo que a consulta aborde perguntas sobre oportunidades marcadas em diferentes categorias de previsão. Para obter mais informações sobre como usar consultas parametrizadas para gerar respostas como ativo confiável, consulte Use trusted ativo in AI/BI Genie spaces .

O exemplo de consulta a seguir calcula o total de oportunidades abertas de pipeline value ventas por região. Ele inclui um parâmetro para o valor o.forecastcategory. Os parâmetros usam a mesma sintaxe dos marcadores de parâmetros nomeados. Para obter mais orientações sobre o uso de parâmetros em um espaço Genie, consulte Trabalhar com parâmetros de consulta e Marcadores de parâmetros nomeados.

SQL
-- 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 default parameter. Para alterar o nome default, 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 ícone de engrenagem 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 para humanos que o Genie usa na experiência de bate-papo. Quando o Genie gera uma resposta usando uma consulta parametrizada, ele inclui o nome de exibição e o valor associado na resposta.

    • Type (Tipo ): Os tipos suportados incluem cadeias de caracteres, data , data e hora e numérico .

      • O tipo de default é strings .

      • O tipo de dados numérico permite especificar entre decimal e inteiro. O tipo numérico do site default é Decimal .

nota

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.

  1. 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 Trusted permite que os usuários do espaço saibam que a resposta do Genie se baseia em uma consulta SQL verificada. Eles podem ver o SQL gerado e os valores dos parâmetros que são usados na resposta.

Última atualização em