4D v14.3

SET INDEX

Página Inicial

 
4D v14.3
SET INDEX

SET INDEX 


 

SET INDEX ( campo ; indice {; modo} {; *} )  
campo  Campo in campo para o qual criar ou apagar o índice
indice  Booleano, Inteiro in True = criar índice, False = apagar índice, ou Criar um índice do tipo: -1=palavras chaves, 0= por padrão, 1=B-Tree padrão, 3=B-Tree cluster
modo  Inteiro longo in obsoleto (parâmetro ignorado)
in Índice assincrônico se * for passado

O comando  SET INDEX aceita duas sintaxes:

  • Se passa um booleano no parâmetro índice, o comando cria ou apaga o índice de campo.
  • Se passa um inteiro no parâmetro índice, o comando cria um índice do tipo especificado.

índice = Booleano
Para indexar o campo, passe True em índice. O comando cria um índice do tipo "por padrão". Se o índice já existir, o comando não faz nada.
Se passar False em índice, o comando apagará todos os índices (não-compostos e não-palavras-chaves) associados ao campo. Se o índice não existir, o comando não faz nada.

índice = Inteiro
Nesse caso, o comando cria um índice do tipo especificado por Campo. Pode passar uma das seguintes constantes, que são encontradas no tema “Tipo de Índice” :

Constante Tipo Valor
Cluster BTree Index Inteiro longo 3
Default Index Type Inteiro longo 0
Keywords Index Inteiro longo -1
Standard BTree Index Inteiro longo 1

Nota: um índice B-Tree associado a um campo de tipo texto armazena como máximo os primeiros 1024 caracteres do campo. Portanto, nesse contexto, as pesquisas nas strings que contenham mais de 1024 caracteres falharão.

SET INDEX  não indexará registros bloqueados; o comando esperará que o registro seja desbloqueado.

A partir da versão 11, o parâmetro Modo não tem mais função,  e se for passado, será ignorado.

O parâmetro opcional * indica uma indexação asincrônica (simultânea). Uma indexação assincrônica permite ao método chamante continuar sua execução imediatamente depois da chamada, não importa se a indexação tenha terminado ou não. Entretanto, a execução será interrompida se um comando requerer a indexação.

Notas:
  • Os índices criados por este comando não têm nomes. Não podem ser apagados pelo comando DELETE INDEX utilizando a sintaxe baseada no nome.
  • Este comando não permite criar ou apagar índices compostos.
  • Este comando não permite  apagar um índice de palavras chaves criado pelo comando CREATE INDEX

O exemplo abaixo indexa o campo [Clientes]ID:

 UNLOAD RECORD([Clientes])
 SET INDEX([Clientes]ID;True)

Suponha que queira indexar o campo [Clientes]Nome em modo assincrônico:

 SET INDEX([Clientes]Nome;True;*)

O exemplo abaixo indexa o campo [Clientes]Num:

 UNLOAD RECORD([Clientes])
 SET INDEX([Clientes]Num;True)

 
PROPRIEDADES 

Produto: 4D
Tema: Acesso a Estrutura
Número 344

 
HISTÓRIA 

Modificado: 4D v11 SQL

 
VER TAMBÉM 

CREATE INDEX
DELETE INDEX
GET FIELD PROPERTIES
ORDER BY
QUERY

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)

Parent of : SET INDEX ( 4D v12.4)