SET QUERY LIMIT
SET QUERY LIMIT ( limite : Integer )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| limite | Integer | → | Número de registros, ou 0 se não houver limite |
Histórico
| Versão | Alterações |
|---|---|
| 11 SQL | Modificado |
| <6 | Criado |
Descrição
SET QUERY LIMIT permite pedir a 4D deter todas as pesquisas posteriores no processo atual logo que encontre o número de registros definido em limite.
Se por exemplo, limite for igual a 1, as pesquisas param logo que um registro coincida com as condições de pesquisa.
Para que as pesquisas sejam ilimitadas de novo, chame SET QUERY LIMIT novamente com limite igual a 0.
Advertência: SET QUERY LIMIT afeta todas as pesquisas posteriores no processo atual. LEMBRE sempre associar uma chamada a SET QUERY LIMIT(limite) (onde limite>0) com uma chamada a SET QUERY LIMIT(0) para restabelecer as pesquisas ilimitadas.
SET QUERY LIMIT muda o comportamento dos comandos de pesquisa:
- QUERY
- QUERY SELECTION
- QUERY BY EXAMPLE
- QUERY BY FORMULA
- QUERY BY SQL
- QUERY SELECTION BY FORMULA
- QUERY SELECTION WITH ARRAY
- QUERY WITH ARRAY
- QUERY BY ATTRIBUTE
- QUERY SELECTION BY ATTRIBUTE
Por outro lado, SET QUERY LIMIT não afeta os outros comandos que possam modificar a seleção atual de uma tabela como ALL RECORDS, RELATE MANY, etc.
Exemplo 1
Para realizar uma pesquisa que corresponda à fórmula “...encontrar dez clientes cujas vendas sejam superiores a $1 M...”, escreva o seguinte código:
SET QUERY LIMIT(10)
QUERY([Clientes];[Clientes]Vendas>1000000)
SET QUERY LIMIT(0)
Exemplo 2
Ver o segundo exemplo do comando SET QUERY DESTINATION.
Ver também
Get query limit
QUERY
QUERY BY EXAMPLE
QUERY BY FORMULA
QUERY BY SQL
QUERY SELECTION
QUERY SELECTION BY FORMULA
QUERY WITH ARRAY
SET QUERY DESTINATION
Propriedades
| Número do comando | 395 |
| Thread-seguro | yes |