Usar parâmetros para solicitar entrada durante a execução de uma consulta

Compreender a terminologia

Antes de entrar no passo a passo abaixo, é útil compreender estes termos:

• Parâmetro   Um parâmetro é uma informação que você fornece a uma consulta assim que a executa. Os parâmetros podem ser usados por eles mesmos ou como parte de uma expressão maior para formar um critério na consulta. Você pode adicionar parâmetros a qualquer um dos seguintes tipos de consultas:

  • Seleção

  • Tabela de Referência Cruzada

  • Acréscimo

  • Criação de tabela

  • Atualização

• Critérios    Os critérios são os "filtros" que adiciona a uma consulta para especificar que itens são devolvidos quando executa a consulta.

Para obter mais informações sobre os tipos de consulta mencionados acima, veja Introdução às consultas.

Criar uma consulta parâmetro

A criação de um parâmetro é similar à adição de um critério normal a uma consulta:

1. Crie uma consulta seleção e depois abra-a no modo de exibição Design.

2. Na linha Critérios do campo ao qual você deseja aplicar um parâmetro, digite o texto que você deseja exibir na caixa de diálogo, entre colchetes. Por exemplo: [Enter the start date:]

   

3. Repita a etapa 2 para cada campo ao qual você deseja adicionar parâmetros.

Quando você executar a consulta, o prompt aparecerá sem os colchetes.

Preencha o valor que procura e, em seguida, clique em OK.

Você pode usar vários parâmetros em um critério. Por exemplo, o Between [Enter the start date:] And [Enter the end date:] gera dois prompts quando você executa a consulta.

Especificar tipos de dados de parâmetro

Você pode definir o parâmetro para aceitar somente determinados tipos de dados. É especialmente importante especificar o tipo de dados numéricos, de moeda ou de data/hora, porque assim, os usuários visualizarão uma mensagem de erro mais útil se digitarem o tipo errado de dados, como digitar um texto quando se espera um valor de moeda.

Para especificar o tipo de dados para os parâmetros de uma consulta:

1. Com a consulta aberta na vista Estrutura, no separador Estrutura da Consulta , no grupo Mostrar/Ocultar , clique em Parâmetros.

2. Na caixa de diálogo Parâmetros da Consulta, na coluna Parâmetro, digite o prompt correspondente a cada parâmetro para o qual você deseja especificar o tipo de dados. Verifique se cada parâmetro corresponde ao prompt usado na linha Critérios da grade de design da consulta.

3. Na coluna Tipo de Dados, selecione o tipo de dados para cada parâmetro.

Adicionar um parâmetro a uma consulta união

Uma vez que não pode ver uma consulta união na grelha de estrutura da consulta, terá de fazer as coisas de forma um pouco diferente:

1. Abra a consulta união no modo SQL.

2. Adicione uma cláusula WHERE que contenha os campos aos quais você deseja adicionar parâmetros.

   Se uma cláusula WHERE já existir, verifique se os campos aos quais você deseja adicionar parâmetros já estão nessa cláusula. Se não estiverem, adicione-os.

3. Digite o prompt do parâmetro na cláusula Where, por exemplo, WHERE [StartDate] = [Enter the start date:]

   

   Observe que você precisa adicionar o mesmo filtro a cada seção da consulta. Na imagem acima, a consulta tem duas seções (separadas pela palavra-chave UNION), então o parâmetro precisa ser adicionado duas vezes. Quando você executa a consulta, entretanto, o prompt só aparece uma vez (supondo que você digitou o prompt exatamente da mesma forma em cada seção).

Para obter mais informações sobre consultas união, consulte Utilizar uma consulta união para combinar várias consultas num único resultado.

Combinar parâmetros com curingas para obter mais flexibilidade

Da mesma forma que com o critério normal, você pode combinar parâmetros com a palavra-chave Like e caracteres curinga para corresponder a um intervalo maior de itens. Por exemplo, você pode querer que a consulta solicite um país/região de origem, mas que corresponda a qualquer valor que contiver a cadeia de parâmetro. Para fazer isso:

1. Crie uma consulta seleção e depois abra-a no modo de exibição Design.

2. Na linha Critérios do campo ao qual você deseja adicionar um parâmetro, digite Like "*"&[, o texto que deseja usar como prompt e ]&"*".
   
   

Quando executa a consulta de parâmetros, o pedido é apresentado na caixa de diálogo sem parênteses retos e sem os carateres universais ou palavra-chave Like:

Depois que você inserir o parâmetro, a consulta retornará valores que contêm a cadeia de parâmetro. Por exemplo, a cadeia de parâmetro us retorna itens onde o campo do parâmetro tem um valor de Austrália e valor dos itens é EUA.

Para obter mais informações sobre carateres universais, veja Exemplos de carateres universais.

Devolver itens que não correspondem ao parâmetro

Em vez de fazer com que a consulta devolva itens que correspondam ao seu parâmetro, poderá querer que a consulta devolva itens que não correspondam ao mesmo. Por exemplo, você pode solicitar um ano e então retornar itens onde o ano seja posterior aquele que você inseriu. Para isso, digite um operador de comparação à esquerda do primeiro colchete que contém o prompt do parâmetro, por exemplo, >[Enter a year:].

Vídeo: Usar parâmetros em consultas

Usar um parâmetro em uma consulta é tão fácil como criar uma consulta que usa critérios. Você pode criar uma consulta para solicitar uma informação, como um número de peça, ou para mais de uma informação, como duas datas. Para cada parâmetro, uma consulta de parâmetro exibe uma caixa de diálogo separada que solicita um valor para esse parâmetro.

Assista a este vídeo para saber mais sobre a criação de parâmetros nas consultas.

Confira também

Usar parâmetros em consultas, formulários e relatórios