Переиндексация
Пересборка коллекции, наблюдение за задачей и ограничения отката.
Сокращённый перевод. Раздел Data на русском — абриджированная версия английской документации, не пословный паритет с EN.
Переиндексация пересобирает коллекцию из сохранённых документов. Она нужна при изменениях схемы, которые нельзя применить к действующей коллекции. Обычные обновления данных проходят через дельта-синхронизацию.
Запуск
AAC_API — базовый URL с /api/v1; AAC_KEY — серверный ключ.
curl -sS -X POST "$AAC_API/indexes/products/reindex" \
-H "Authorization: Bearer $AAC_KEY"Ответ 202 содержит job_id. Проверяйте задачу до конечного состояния:
curl -sS "$AAC_API/jobs/JOB_ID" -H "Authorization: Bearer $AAC_KEY"Нужны scope settings:write и доступная функция тарифа reindex.
Конкурирующая пересборка или восстановление снимка возвращает 409 JOB_CONFLICT.
Подробности задач: справочник.
Что происходит
Рабочий процесс создаёт новую коллекцию, переносит документы, синонимы и
curations, затем переключает alias. Фазы задачи: queued, loading, copying,
swapping, done. Отмена через DELETE /jobs/{jobId} возможна до переключения.
При ошибке старая коллекция продолжает обслуживать запросы.
Источник пересборки — сохранённый payload, а не повторное чтение CMS. Новое поле не получит значения, которых нет в сохранённых данных: сначала обновите маппинг и передайте соответствующие документы.
Проверка и откат
После завершения проверьте количество документов, контрольные запросы, ACL, фасеты и сортировки. Сохранение старой коллекции не означает наличия публичного REST-метода отката: автоматический откат здесь не обещается. До производственного запуска проверьте доступность снимка и процедуру восстановления.