Descrição

O comando REINDEX reconstrói o índice usando os dados armazenados na tabela do índice, substituindo a cópia antiga do índice. Existem vários cenários nos quais usar REINDEX:

Parâmetros

Notas

Havendo suspeita de corrupção de um índice em uma tabela de usuário, pode-se simplesmente reconstruir este índice, ou todos os índices da tabela, usando os comandos REINDEX INDEX, ou REINDEX TABLE.

As coisas são mais difíceis quando é necessário se recuperar da corrupção de um índice em uma tabela do sistema. Neste caso, é importante que o próprio sistema não tenha utilizado nenhum dos índices suspeitos. (De fato, neste tipo de cenário, pode-se descobrir que os processos do servidor estão travando imediatamente na inicialização, devido à dependência de índices corrompidos.) Para recuperar com segurança, o servidor deve ser iniciado com a opção -P, que impede o uso de índices para procuras nos catálogos do sistema.

Uma maneira de fazer isto é parar o servidor, e iniciar o servidor PostgreSQL de usuário único com a opção -P incluída na linha de comando. Então, pode ser executado REINDEX DATABASE, REINDEX SYSTEM, REINDEX TABLE, ou REINDEX INDEX, dependendo de quanto se deseja reconstruir. Em caso de dúvida, deve ser usado REINDEX SYSTEM para selecionar a reconstrução de todos os índices do sistema no banco de dados. Em seguida, sair da sessão de servidor de usuário único, e reiniciar o servidor normalmente. Veja a página de referência do postgres para obter mais informações sobre como interagir com a interface de servidor de usuário único.

Como alternativa, pode ser iniciada uma sessão normal do servidor com a opção -P incluída em suas opções de linha de comando. O método para fazer isto varia entre clientes, mas em todos os clientes baseados na libpq é possível definir a variável de ambiente PGOPTIONS como -P antes de iniciar o cliente. Note que, embora este método não exija o bloqueio de outros clientes, ainda pode ser prudente impedir que outros usuários conectem ao banco de dados danificado até que os reparos sejam concluídos.

O comando REINDEX é semelhante a excluir e recriar o índice, onde o conteúdo do índice é reconstruído a partir do zero. Entretanto, as considerações de bloqueio são bastante diferentes. O comando REINDEX bloqueia escritas, mas não leituras da tabela associada do índice. Ele também requer um bloqueio ACCESS EXCLUSIVE no índice específico que está sendo processado, o que irá bloquear as leituras que tentarem usar este índice. Em particular, o planejador de consultas tenta obter um bloqueio ACCESS SHARE em todos os índices da tabela, independentemente da consulta e, portanto, o comando REINDEX bloqueia praticamente todas as consultas, exceto algumas consultas preparadas cujo plano foi armazenado em cache e que não usam este índice específico. Em contraste, o comando DROP INDEX obtém momentaneamente um bloqueio ACCESS EXCLUSIVE na tabela associada, bloqueando escritas e leituras. O comando CREATE INDEX subsequente bloqueia as escritas, mas não as leituras; como o índice ainda não existe, nenhuma leitura tentará usá-lo, significando que não haverá bloqueio, mas as leituras podem ser forçadas a realizar varreduras sequenciais dispendiosas.

Enquanto o comando REINDEX estiver em execução, o search_path será temporariamente mudado para pg_catalog, pg_temp.

A reindexação de um único índice ou tabela requer o privilégio MAINTAIN na tabela. Note que o comando REINDEX em um índice ou tabela particionada requer o privilégio MAINTAIN na tabela particionada, ignorando as verificações de privilégios ao processar as partições individuais. Reindexar um esquema ou banco de dados requer ser o dono desse esquema ou banco de dados, ou ter privilégios de função de banco de dados pg_maintain. Note especificamente que, dessa forma, é possível que usuários sem privilégios de superusuário reconstruam índices de tabelas pertencentes a outros usuários. Entretanto, como uma exceção especial, REINDEX DATABASE, REINDEX SCHEMA, e REINDEX SYSTEM irão pular os índices nos catálogos compartilhados, a menos que o usuário tenha o privilégio MAINTAIN no catálogo.

A reindexação de índices particionados, ou tabelas particionadas, tem suporte com REINDEX INDEX ou REINDEX TABLE, respectivamente. Cada partição da relação particionada especificada é reindexada em uma transação separada. Estes comandos não podem ser usados dentro de um bloco de transação ao trabalhar em uma tabela ou índice particionado.

Ao usar a cláusula TABLESPACE com o comando REINDEX em um índice ou tabela particionada, apenas as referências a espaço de tabelas das partições folha são atualizadas. Como os índices particionados não são atualizados, se recomenda usar neles ALTER TABLE ONLY em separado, para que quaisquer novas partições anexadas herdem o novo espaço de tabelas. Em caso de falha, pode não ter sido movido todos os índices para o novo espaço de tabelas. Executar novamente o comando reconstruirá todas as partições folha e moverá os índices não processados anteriormente para o novo espaço de tabelas.

Se for usado SCHEMA, DATABASE ou SYSTEM com TABLESPACE, as relações do sistema serão ignoradas, e será gerado um único WARNING. Os índices nas tabelas TOAST são reconstruídos, mas não são movidos para o novo espaço de tabelas.

postgres=# \d tab
       Table "public.tab"
 Column |  Type   | Modifiers
--------+---------+-----------
 col    | integer |
Indexes:
    "idx" btree (col)
    "idx_ccnew" btree (col) INVALID

Exemplos

Reconstruir um único índice:

REINDEX INDEX my_index;

Reconstruir todos os índices na tabela my_table:

REINDEX TABLE my_table;

Reconstruir todos os índices em um banco de dados específico, sem confiar que os índices do sistema já estejam válidos:

$ export PGOPTIONS="-P"
$ psql broken_db
...
broken_db=> REINDEX DATABASE broken_db;
broken_db=> \q

Reconstruir índices para uma tabela, sem bloquear as operações de leitura e escrita nas relações envolvidas enquanto a reindexação está em andamento:

REINDEX TABLE CONCURRENTLY my_broken_table;

Conformidade

Não existe o comando REINDEX no padrão SQL.

Veja também