DELETE INDEX
DELETE INDEX ( pontCampo|nomeIndice {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| pontCampo|nomeIndice | Ponteiro, String | 🡒 | Ponteiro ao campo cujos índices serão apagados ou Nome do Índice que será apagado. |
| * | Operador | 🡒 | Se passado = operação assincrônica |
Descrição
O comando DELETE INDEX é utilizado para apagar um ou mais índices existentes no banco.
Pode passar tanto um ponteiro a um campo ou o nome de um índice no parâmetro:
- Se passar um ponteiro a um campo (pontCampo), todos os índices associados ao campo serão apagados. Pode ser relativo a índices de palavras chaves ou de índices padrão. Entretanto, se o campo estiver incluido em um ou mais índices compostos, não serão apagados (deve passar um nome de índice).
- Se passar o nome de um índice (nomIndice), apenas se apagará o índice determinado. Pode se tratar de índices de palavras chaves, índices padrão ou índices compostos. O parâmetro opcional *, quando for passado, permite realizar a desindexação em modo assincrônico. Nesse modo, o método de origem continua sua execução depois da chamada ao comando, sem importar se a eliminação do índice terminou ou não.
Se não existir um índice correspondente a PontCampo ou nomIndice, o comando não faz nada.
Nota para lançamento
Dado que este comando modifica a estrutura do banco de dados, não pode ser utilizado no contexto de uma aplicação empacotada de apenas leitura (arquivo .4dc instalado na pasta Arquivos de programa ou arquivo .4dz).
Exemplo
Este exemplo ilustra as duas sintaxes do comando:
//Eliminação de todos os índices relacionados com o campo Sobrenome
DELETE INDEX(->[Clientes]Sobrenome)
//Eliminação do índice chamado “CPCidade”
DELETE INDEX("CPCidade")