Comando INDEX

Cria um índice para uma tabela do Analytics que permite acessar os registros em uma ordem sequencial em vez de na ordem física.

Sintaxe

INDEX <ON> {campo_chave <D> <...n>|ALL} TO nome_arquivo <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <OPEN> <ISOLOCALE código_local>

Parâmetros

Nome Descrição
ON campo_chave D <...n> | ALL

O campo ou campos-chave, ou a expressão, que devem ser utilizados para a indexação.

Você pode indexar por qualquer tipo de campo, incluindo campos calculados e expressões ad hoc, independentemente do tipo de dados.

  • campo_chave use o campo ou os campos especificados

    Se você indexar por mais de um campo, criará uma indexação aninhada na tabela. A ordem do aninhamento seguirá a ordem em que os campos são especificados.

    Inclua D para indexar o campo-chave em ordem decrescente. A ordem de indexação padrão é crescente.

  • ALL usar todos os campos na tabela

    Se você indexar por todos os campos em uma tabela, criará uma indexação aninhada. A ordem do aninhamento seguirá a ordem em que os campos aparecem no layout da tabela.

    Uma ordem de indexação crescente é a única opção para ALL.

TO nome_arquivo

O nome do índice e o arquivo de índice associado. O arquivo de índice é criado com uma extensão .INX.

Nota

Na interface do usuário do Analytics, os nomes de índice são limitados a 64 caracteres alfanuméricos. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

IF teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição.

Nota

O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).

WHILE teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado.

Nota

Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.

FIRST intervalo | NEXT intervalo

opcional

O número de registros a ser processado:

  • FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado
  • NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado

Use intervalo para especificar o número de registros a serem processados.

Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.

OPEN

opcional

Abre a tabela e aplica o índice à tabela.

ISOLOCALE código_local

opcional

Nota

Aplicável apenas à edição Unicode do Analytics.

A localidade do sistema no formato idioma_país. Por exemplo, para usar francês canadense, insira fr_ca.

Use os códigos a seguir:

  • idioma código de idioma padrão ISO 639
  • país código de país padrão ISO 3166

    Se você não especificar um código de país, será usado o país padrão do idioma.

Se você não usar ISOLOCALE, a localidade do sistema padrão será usada.

Exemplos

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Criar um índice e abrir a tabela

Na tabela Fornecedor, você cria um índice no campo Cidade_Fornecedor e abre a tabela:

OPEN Fornecedor 
INDEX ON Cidade_Fornecedor TO "ÍndiceCidade" OPEN

Criar um índice e aplicá-lo à tabela

Na tabela Fornecedor, você cria um índice no campo Cidade_Fornecedor. Depois, você aplica o índice à tabela:

OPEN Fornecedor 
INDEX ON Cidade_Fornecedor TO "ÍndiceCidade"
,
,
,
SET INDEX TO "ÍndiceCidade"