Schemaänderungen
Feldänderungen planen und bestehende Dokumente mit Werten versorgen.
Gekürzte Übersetzung. Der Abschnitt Data auf Deutsch ist eine gekürzte Fassung der englischen Dokumentation, kein wortgetreuer Paritätstext.
Öffnen Sie Search → Schema in der Konsole. Planen Sie Änderungen vor dem
Anwenden. schema.plan und schema.apply sind Konsolenoperationen; daraus
folgen keine gleichnamigen öffentlichen REST-Endpunkte.
Plan prüfen
Kontrollieren Sie added, breaking, requiresReindex, findings,
fromVersion und toVersion. Additive Änderungen benötigen keinen vollständigen
Neuaufbau. Inkompatible Änderungen erfordern eine
Neuindexierung. Konfigurationsfehler blockieren das Anwenden.
Eine kürzere Feldliste entfernt keine ausgelassenen Felder. Eine Feldlöschung
ist eine eigene Migration; ein öffentlicher Übergabeweg für removeFields
wird hier nicht zugesichert.
Schema und Werte
Ein neues Feld füllt bestehende Dokumente nicht automatisch. Für eine Facette
brand muss der Payload jedes Dokuments einen entsprechenden Wert enthalten.
Aktualisieren Sie Zuordnung und Quelldaten. Ein Neuaufbau alter Payloads erzeugt
keine fehlenden Werte. Delta-Läufe schreiben nur geänderte Dokumente.
Feldnamen unterscheiden Groß- und Kleinschreibung: Color und color sind
verschiedene Attribute. Kategorienlisten benötigen string[] statt einer
Zeichenkette mit Kommas. Deklarieren Sie eingebaute Felder wie external_id,
title oder organization_id nicht erneut als eigene Felder.
Prüfen Sie nach dem Anwenden Version, Beispieldokument, Filter, Facette und Sortierung.
Neuaufbau über die Warteschlange
Eine inkompatible Konsolenänderung reiht den Neuaufbau ein und antwortet sofort.
REST PATCH /indexes/{indexSlug}/schema benötigt allow_reindex: true und
liefert 202 mit applied: false, migration_id und job_id. Das Zielschema
wird getrennt gespeichert; aktive Felder und Einstellungen bleiben verfügbar.
Die Migration bleibt geplant, bis die Veröffentlichung gelingt. Verfolgen Sie den Auftrag oder den Bereich Synchronisierung. Abbruch und Verarbeitungsfehler markieren die Migration als fehlgeschlagen. Geänderte Konfiguration oder widerrufene Veröffentlichungsrechte/API-Schlüssel stoppen einen veralteten Auftrag vor der Veröffentlichung. Prüfen und senden Sie das aktuelle Schema neu.