Изменение схемы
Планирование изменений полей и заполнение существующих документов.
Сокращённый перевод. Раздел Data на русском — абриджированная версия английской документации, не пословный паритет с EN.
Откройте Search → Schema в консоли. Сначала выполните планирование изменений,
затем применение. Это операции консоли schema.plan и schema.apply, а не
обещание одноимённых публичных REST-методов.
Проверка плана
План сравнивает желаемые поля с действующей коллекцией. Проверьте added,
breaking, requiresReindex, findings, fromVersion и toVersion.
Аддитивные изменения применяются без полной пересборки; несовместимые требуют
переиндексации. Ошибки проверки конфигурации блокируют применение.
Не считайте короткий список полей командой удаления остальных: непереданные
поля сохраняются. Удаление поля — отдельная миграция; публичный способ передачи
removeFields здесь не заявляется.
Схема и данные
Добавление поля не заполняет его в старых документах. Для фасета brand нужны
значения brand в payload каждого документа. Обновите маппинг и импортируйте
данные. Пересборка старого payload сама по себе отсутствующие значения не создаст.
Дельта-синхронизация записывает только изменённые документы.
Имена полей чувствительны к регистру: Color и color — разные атрибуты.
Массив категорий передавайте как string[], а не строку с запятыми.
Встроенные поля, включая external_id, title и organization_id, не
переобъявляйте как пользовательские.
После применения проверьте версию, тестовый документ, фильтр, фасет и сортировку.
Пересборка через очередь
Несовместимое изменение из консоли ставит пересборку в очередь и сразу возвращает
управление. REST PATCH /indexes/{indexSlug}/schema требует allow_reindex: true
и возвращает 202 с applied: false, migration_id и job_id. Целевая схема
хранится отдельно: действующие поля и настройки сохраняются во время обработки.
Миграция остаётся запланированной до успешного переключения. Проверяйте задание или раздел синхронизации. Отмена и ошибка обработки отмечают миграцию как неуспешную, не выдавая постановку в очередь за применённую схему. Изменение конфигурации или отзыв права публикации/ключа API останавливают устаревший запрос перед публикацией; проверьте и отправьте текущую схему заново.