Consultas de parâmetros (Visual Database Tools)

Aplica-se: SQL Server

Em alguns casos, talvez você queira criar uma consulta que possa ser utilizada muitas vezes, mas com um valor diferente a cada vez. Por exemplo, pode ser que você execute com frequência uma consulta para localizar todos os title_ids escritos por um autor. Você pode executar a mesma consulta para cada solicitação, exceto se a ID ou o nome do autor forem diferentes.

Você utilizará parâmetros na consulta para criar uma consulta que possa ter valores diferentes a cada momento. Um parâmetro é um espaço reservado para um valor fornecido quando a consulta é executada. Uma instrução SQL com um parâmetro pode ser semelhante à seguinte, em que "?" representa o parâmetro para o ID do autor:

SELECT title_id  
FROM titleauthor  
WHERE (au_id = ?)  

Onde você pode utilizar parâmetros

Você pode usar parâmetros como espaços reservados para valores literais – tanto para valores de texto quanto numéricos. Mais comumente, os parâmetros são usados como espaços reservados em condições de pesquisa para linhas individuais ou para grupos (ou seja, nas cláusulas WHERE ou HAVING de uma instrução SQL).

Você pode utilizar parâmetros como espaços reservados em expressões. Por exemplo, você pode querer calcular preços com desconto fornecendo um valor de desconto diferente a cada vez que executar uma consulta. Para fazer isso, você poderá especificar a seguinte expressão:

(price * ?)  

Especificando parâmetros com e sem-nome

Você pode especificar dois tipos de parâmetros: com e sem-nome. Um parâmetro sem nome é um ponto de interrogação (?) que você coloca em qualquer lugar na consulta em que queira solicitar ou substituir um valor literal. Por exemplo, se você utilizar um parâmetro sem nome para pesquisar a ID de um autor na tabela titleauthor , a instrução resultante no Painel SQL poderá se parecer com:

SELECT title_id  
FROM titleauthor  
WHERE (au_id = ?)  

Quando você executa uma consulta no Designer de Consulta e Exibição, a caixa de diálogo Parâmetros da Consulta é exibida com "?" como o nome do parâmetro.

Como alternativa, você pode atribuir um nome a um parâmetro. Os parâmetros com nome são muito úteis se você tiver diversos parâmetros em uma consulta. Por exemplo, se você utilizar um parâmetro com nome para pesquisar o nome e o sobrenome de um autor na tabela authors , a instrução resultante no painel SQL poderia se parecer com:

SELECT au_id  
FROM authors  
WHERE au_fname = %first name% AND  
      au_lname = %last name%  

Dica

Você deve definir caracteres de prefixo e de sufixo antes de criar uma consulta de parâmetro com nome.

Quando você executa uma consulta no Designer de Consulta e Exibição, a caixa de diálogo Parâmetros de Consulta é exibida com uma lista de parâmetros com nome.

Consulte Também

Consultar com parâmetros (Ferramentas de Banco de Dados Visual)
Tipos de consulta permitidos (Visual Database Tools)
Tópicos de instruções de como criar consultas e exibições (Ferramentas de Banco de Dados Visual)