ALTER INDEX

Nome

ALTER INDEX -- altera a definição de um índice

Sinopse

ALTER INDEX nome RENAME TO novo_nome
ALTER INDEX nome SET TABLESPACE nome_do_espaço_de_tabelas
ALTER INDEX nome SET ( parâmetro_de_armazenamento = valor [, ... ] )
ALTER INDEX nome RESET ( parâmetro_de_armazenamento [, ... ] )

Descrição

O comando ALTER INDEX altera a definição de um índice existente. Existem diversas subformas:

RENAME

A forma RENAME muda o nome do índice. Não há efeito sobre os dados armazenados.

SET TABLESPACE

Esta forma muda o espaço de tabelas do índice para o espaço de tabelas especificado, movendo os arquivos de dados associados ao índice para o novo espaço de tabelas. Consulte também CREATE TABLESPACE.

SET ( parâmetro_de_armazenamento = valor [, ... ] )

Esta forma altera um ou mais parâmetros de armazenamento específico do método do índice. Para obter mais informações sobre os parâmetros disponíveis consulte CREATE INDEX. Deve ser observado que o conteúdo do índice não será modificado imediatamente por este comando; dependendo do parâmetro, poderá ser necessário reconstruir o índice utilizando REINDEX para obter os efeitos desejados.

RESET ( parâmetro_de_armazenamento [, ... ] )

Esta forma redefine um ou mais parâmetros de armazenamento específicos do método do índice para o seu valor padrão. Da mesma forma que no SET, poderá ser necessário utilizar REINDEX para atualizar todo o índice.

Parâmetros

nome

O nome (opcionalmente qualificado pelo esquema) do índice existente a ser alterado.

novo_nome

O novo nome do índice.

nome_do_espaço_de_tabelas

O espaço de tabelas para o qual o índice será movido.

parâmetro_de_armazenamento

O nome de um parâmetro de armazenamento específico do método do índice.

valor

O novo valor do parâmetro de armazenamento específico do método do índice. Deve ser um número ou um nome, dependendo do parâmetro.

Observações

Estas operações também podem ser feitas utilizando ALTER TABLE. O comando ALTER INDEX é, na verdade, apenas um sinônimo para as formas de ALTER TABLE aplicáveis aos índices.

Existia anteriormente a variante ALTER INDEX OWNER, mas agora esta variante é ignorada (com advertência). O índice não pode ter um dono diferente do dono da tabela. Alterar o dono da tabela altera também automaticamente o índice.

Não é permitido alterar qualquer parte de um índice dos catálogos do sistema.

Exemplos

Para mudar o nome de um índice existente:

ALTER INDEX distribuidores RENAME TO fornecedores;

Para mover um índice para outro espaço de tabelas:

ALTER INDEX distribuidores SET TABLESPACE espaco_de_tabelas_rapido;

Para mudar o fator de preenchimento do índice (assumindo que o método do índice permite isto):

ALTER INDEX distribuidores SET (fillfactor = 75);
REINDEX INDEX distribuidores;

Compatibilidade

O comando ALTER INDEX é uma extensão do PostgreSQL.

Consulte também

CREATE INDEX, REINDEX
SourceForge.net Logo CSS válido!