Описание

REINDEX перестраивает индекс, используя данные, хранящиеся в таблице индекса, заменяя старую копию индекса. Существует несколько сценариев, в которых следует использовать REINDEX:

Параметры

Примечания

Если вы подозреваете повреждение индекса на пользовательской таблице, вы можете просто перестроить этот индекс или все индексы на таблице, используя REINDEX INDEX или REINDEX TABLE.

Вещи становятся более сложными, если вам нужно восстановиться после повреждения индекса в системной таблице. В этом случае важно, чтобы система сама не использовала ни одного из подозрительных индексов. (Действительно, в таком сценарии вы можете обнаружить, что серверные процессы немедленно вылетают при запуске из-за зависимости от поврежденных индексов). Чтобы безопасно восстановиться, сервер должен быть запущен с опцией -P, которая предотвращает использование индексов для поиска в системном каталоге.

Один из способов сделать это - выключить сервер и запустить однопользовательский сервер Tantor SE-1C с опцией -P включенной в его командной строке. Затем можно выполнить команды REINDEX DATABASE, REINDEX SYSTEM, REINDEX TABLE или REINDEX INDEX, в зависимости от того, сколько нужно восстановить. Если сомневаетесь, используйте REINDEX SYSTEM для выбора восстановления всех системных индексов в базе данных. Затем завершите сессию однопользовательского сервера и перезапустите обычный сервер. Дополнительную информацию о взаимодействии с интерфейсом однопользовательского сервера см. на странице postgres.

Альтернативно, обычная сессия сервера можно запустить с опцией -P включенной в командной строке. Метод для этого различается в разных клиентах, но во всех клиентах, основанных на libpq, можно установить переменную окружения PGOPTIONS в значение -P перед запуском клиента. Обратите внимание, что хотя этот метод не требует блокировки других клиентов, все же может быть разумно предотвратить подключение других пользователей к поврежденной базе данных до завершения ремонтных работ.

REINDEX похож на удаление и повторное создание индекса, поскольку содержимое индекса перестраивается с нуля. Однако, блокировка учитывается по-другому. REINDEX блокирует записи, но не чтение родительской таблицы индекса. Он также берет эксклюзивную блокировку ACCESS EXCLUSIVE на обрабатываемый индекс, что блокирует чтение, пытающееся использовать этот индекс. В частности, планировщик запросов пытается взять блокировку ACCESS SHARE на каждый индекс таблицы, независимо от запроса, поэтому REINDEX блокирует практически любые запросы, кроме некоторых подготовленных запросов, план которых был закеширован и которые не используют этот самый индекс. В отличие от этого, DROP INDEX мгновенно берет эксклюзивную блокировку ACCESS EXCLUSIVE на родительскую таблицу, блокируя как запись, так и чтение. Последующий CREATE INDEX блокирует записи, но не чтение; поскольку индекса нет, ни одно чтение не будет пытаться его использовать, что означает, что блокировки не будет, но чтение может быть принудительно переведено в дорогостоящие последовательные сканирования.

Для переиндексации отдельного индекса или таблицы необходимо быть владельцем этого индекса или таблицы. Для переиндексации схемы или базы данных необходимо быть владельцем этой схемы или базы данных. Обратите внимание, что это означает, что непривилегированные пользователи могут перестраивать индексы таблиц, принадлежащих другим пользователям. Однако, как особое исключение, когда непривилегированный пользователь выполняет команду REINDEX DATABASE, REINDEX SCHEMA или REINDEX SYSTEM, индексы на общих каталогах будут прне указаны, если пользователь не является владельцем каталога (что обычно не будет иметь место). Конечно, суперпользователи всегда могут переиндексировать что угодно.

Переиндексация секционированных индексов или секционированных таблиц поддерживается с помощью команды REINDEX INDEX или REINDEX TABLE соответственно. Каждая секция указанного секционированного отношения переиндексируется в отдельной транзакции. Эти команды не могут использоваться внутри блока транзакции при работе с секционированной таблицей или индексом.

При использовании ключевого слова TABLESPACE с командой REINDEX для индекса или таблицы с секционированием, обновляются только ссылки на табличное пространство листовых секций. Поскольку секционированные индексы не обновляются, рекомендуется отдельно использовать команду ALTER TABLE ONLY для них, чтобы новые присоединенные секции наследовали новое табличное пространство. В случае сбоя, возможно, не все индексы будут перемещены в новое табличное пространство. Повторное выполнение команды перестроит все листовые секции и переместит ранее необработанные индексы в новое табличное пространство.

Если используется SCHEMA, DATABASE или SYSTEM с TABLESPACE, системные отношения будут прне указаны и будет сгенерировано одно WARNING. Индексы на TOAST-таблицах будут перестроены, но не перемещены в новое табличнoe пространствo.

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

Примеры

Перестроить один индекс:

REINDEX INDEX my_index;

Перестроить все индексы на таблице my_table:

REINDEX TABLE my_table;

Перестроить все индексы в определенной базе данных, не доверяя системным индексам, которые уже могут быть действительными:

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

Перестроить индексы для таблицы без блокировки операций чтения и записи на связанных отношениях во время выполнения переиндексации:

REINDEX TABLE CONCURRENTLY my_broken_table;

Совместимость

В стандарте SQL нет команды REINDEX.

См. также