Índice

 

A cláusula PARAMETERS

Uma forma de se criar consultas SQL que podem ter valores variáveis para os seus critérios de pesquisa é introduzir uma cláusula PARAMETERS no texto da consulta. Ao introduzir este tipo de cláusula no texto de uma consulta, o CashPreview analisará a cláusula PARAMETERS e solicitará ao usuário que informe os valores para cada parâmetro definido sempre que for comandada a execução da consulta.

Se presente, a cláusula PARAMETERS deve ser a primeira cláusula no texto da consulta precedendo a cláusula SELECT e terminando com o caractere de ";". Seu formato é conforme mostrado abaixo:

PARAMETERS [nome parâmetro] tipo de dados, [nome parâmetro] tipo de dados, ...;

Conforme o esquema acima, o nome do parâmetro é sempre envolvido por chaves e seguido do tipo de dados. Os tipos de dados aceitos nas consultas criadas no CashPreview podem ser um dos tipos indicados na tabela abaixo:

TEXT

Para pesquisa em campos do tipo texto.

BYTE

Para valores inteiros de 0 a 255.

SHORT

Para valores inteiros entre  - 32,768 e 32,767.

LONG

Para valores inteiros entre - 2,147,483,648 e 2,147,483,647.

SINGLE

Para valores com precisão entre - 3.402823E38 a  - 1.401298E-45 para valores negativos, 1.401298E-45 a 3.402823E38 para valores positivos, e 0.

DOUBLE

Para valores com precisão dupla entre - 1.79769313486232E308 a  - 4.94065645841247E-324 para valores negativos, 4.94065645841247E-324 a 1.79769313486232E308 para valores positivos, e 0.

CURRENCY

Para valores monetários entre  - 922.337.203.685.477,58 e 922.337.203.685.477,58.

DATETIME

Para valores de datas com ou sem informação de hora.

BIT

Para valores do tipo verdadeiro (TRUE) ou falso (FALSE).

Exemplos de uso da cláusula PARAMETERS:

PARAMETERS [DataInicio] DATETIME, [DataFim] DATETIME, [Realizacao] TEXT;

SELECT * FROM Lancamentos WHERE Data BETWEEN [DataInicio] AND [DataFim] AND Realizado=[Realizacao];

A consulta acima retorna todos os lançamentos com data entre os valores informados para os parâmetros [DataInicio] e [DataFim] e que tenham sido baixados ou estejam pendentes conforme o valor informado para o parâmetro [Realizacao] na ocasião de execução da consulta.

PARAMETERS [CodigoConta] TEXT, [Ativa] BIT;

SELECT * FROM Contas WHERE CODIGO LIKE [CodigoConta] & '*' AND Ativa = [Ativa];

A consulta acima retorna todas as informações da conta de código informado para o parâmetro [CodigoConta] e de suas subcontas que estejam ativas.

Veja mais sobre a linguagem SQL em "SQL Linguagem Estruturada de Consultas".