Descripción

REINDEX reconstruye un índice utilizando los datos almacenados en la tabla del índice, reemplazando la copia antigua del índice. Existen varios escenarios en los que se debe usar REINDEX:

Parámetros

Notas

Si sospechas que hay corrupción en un índice de una tabla de usuario, puedes simplemente reconstruir ese índice, o todos los índices de la tabla, utilizando REINDEX INDEX o REINDEX TABLE.

Las cosas son más difíciles si necesitas recuperarte de la corrupción de un índice en una tabla del sistema. En este caso es importante que el sistema no haya utilizado ninguno de los índices sospechosos. (De hecho, en este tipo de escenario podrías encontrar que los procesos del servidor se caen inmediatamente al iniciarse, debido a la dependencia de los índices corrompidos). Para recuperarse de forma segura, el servidor debe iniciarse con la opción -P, que le impide utilizar los índices para las búsquedas en los catálogos del sistema.

Una forma de hacer esto es detener el servidor e iniciar un servidor PostgreSQL en modo monousuario con la opción -P incluida en su línea de comandos. Luego, se puede ejecutar REINDEX DATABASE, REINDEX SYSTEM, REINDEX TABLE o REINDEX INDEX, dependiendo de cuánto quieras reconstruir. En caso de duda, utiliza REINDEX SYSTEM para seleccionar la reconstrucción de todos los índices del sistema en la base de datos. A continuación, sal de la sesión del servidor en modo monousuario y reinicia el servidor regular. Consulta la página de referencia de postgres para obtener más información sobre cómo interactuar con la interfaz del servidor en modo monousuario.

Alternativamente, se puede iniciar una sesión de servidor regular con -P incluido en sus opciones de línea de comandos. El método para hacer esto varía según el cliente, pero en todos los clientes basados en libpq, es posible establecer la variable de entorno PGOPTIONS en -P antes de iniciar el cliente. Ten en cuenta que aunque este método no requiere bloquear a otros clientes, podría ser aconsejable evitar que otros usuarios se conecten a la base de datos dañada hasta que se hayan completado las reparaciones.

REINDEX es similar a eliminar y recrear el índice, en el sentido de que los contenidos del índice se reconstruyen desde cero. Sin embargo, las consideraciones de bloqueo son bastante diferentes. REINDEX bloquea las escrituras pero no las lecturas de la tabla padre del índice. También adquiere un bloqueo ACCESS EXCLUSIVE en el índice específico que se está procesando, lo que bloqueará las lecturas que intenten utilizar ese índice. En particular, el planificador de consultas intenta adquirir un bloqueo ACCESS SHARE en cada índice de la tabla, independientemente de la consulta, por lo que REINDEX bloquea prácticamente cualquier consulta excepto algunas consultas preparadas cuyo plan ha sido almacenado en caché y que no utilizan este índice. En contraste, DROP INDEX adquiere momentáneamente un bloqueo ACCESS EXCLUSIVE en la tabla padre, bloqueando tanto las escrituras como las lecturas. El subsiguiente CREATE INDEX bloquea las escrituras pero no las lecturas; dado que el índice no está allí, ninguna lectura intentará utilizarlo, lo que significa que no habrá bloqueo, pero las lecturas podrían verse forzadas a realizar costosos escaneos secuenciales.

Mientras se ejecuta REINDEX, la variable de entorno search_path se cambia temporalmente a pg_catalog, pg_temp.

Reindexar un único índice o tabla requiere tener el privilegio MAINTAIN en la tabla. Ten en cuenta que aunque REINDEX en un índice o tabla particionada requiere tener el privilegio MAINTAIN en la tabla particionada, dichos comandos omiten las comprobaciones de privilegios al procesar las particiones individuales. Reindexar un esquema o base de datos requiere ser el propietario de ese esquema o base de datos o tener los privilegios del rol pg_maintain. Ten en cuenta específicamente que por lo tanto es posible para los usuarios que no son superusuarios reconstruir índices de tablas que pertenecen a otros usuarios. Sin embargo, como excepción especial, REINDEX DATABASE, REINDEX SCHEMA y REINDEX SYSTEM omitirán los índices en los catálogos compartidos a menos que el usuario tenga el privilegio MAINTAIN en el catálogo.

La reindexación de índices particionados o tablas particionadas es compatible con REINDEX INDEX o REINDEX TABLE, respectivamente. Cada partición de la relación particionada especificada se reindexa en una transacción independiente. Esos comandos no se pueden utilizar dentro de un bloque de transacción cuando se trabaja en una tabla o índice particionado.

Cuando se utiliza la cláusula TABLESPACE con REINDEX en un índice o tabla particionada, solo se actualizan las referencias de tablespace de las particiones hoja. Como los índices particionados no se actualizan, se recomienda utilizar por separado ALTER TABLE ONLY en ellos para que las nuevas particiones asociadas hereden el nuevo tablespace. En caso de fallo, es posible que no se hayan movido todos los índices al nuevo tablespace. Volver a ejecutar el comando reconstruirá todas las particiones hoja y moverá los índices previamente no procesados al nuevo tablespace.

Si se utiliza SCHEMA, DATABASE o SYSTEM con TABLESPACE, se omiten las relaciones del sistema y se generará una única advertencia (WARNING). Los índices en las tablas TOAST se reconstruyen, pero no se mueven al nuevo tablespace.

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

Ejemplos

Reconstruye un único índice:

REINDEX INDEX my_index;

Reconstruye todos los índices de la tabla my_table:

REINDEX TABLE my_table;

Reconstruye todos los índices en una base de datos en particular, sin confiar en que los índices del sistema ya sean válidos:

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

Reconstruye los índices para una tabla, sin bloquear las operaciones de lectura y escritura en las relaciones involucradas mientras la reindexación está en progreso:

REINDEX TABLE CONCURRENTLY my_broken_table;

Compatibilidad

No existe el comando REINDEX en el estándar SQL.

Véase también