Pinecone veröffentlicht Leitfaden für den Umzug von Chroma Cloud vor der Abschaltung

Zwei Stichtage für Nutzer von Chroma Cloud

Der Beitrag von Pinecone, verfasst von Aaron Kao und auf den 26. Oktober 2026 datiert, fasst den Zeitplan aus der Mitteilung von Chroma zusammen. Am 22. November 2026 wird Chroma Cloud schreibgeschützt, es sind dann weder Erstellen, Aktualisieren noch Löschen möglich. Am 22. Dezember 2026 beantwortet der Dienst keine Abfragen mehr.

Chroma empfiehlt, vor dem 22. November mit dem Export und der Validierung der Daten zu beginnen und den Export vor dem 22. Dezember abzuschließen. Das Open-Source-Projekt Chroma ist laut dem Beitrag nicht betroffen und bleibt unter Apache 2.0 verfügbar.

Für Teams, die einen verwalteten Dienst dem Eigenbetrieb von Chroma vorziehen, verweist Pinecone darauf, dass seine Database serverlos und vollständig verwaltet sei: Es gebe keine Cluster zu betreiben und keinen Index, den man vor dem Laden der Daten dimensionieren oder bereitstellen müsse. Nutzer von Chroma Cloud können mit einer dreiwöchigen Testphase von Pinecone Standard starten, die 300 US-Dollar Guthaben enthält.

Was das Migrations-Toolkit leistet

Der Leitfaden behandelt den Umzug einer einzelnen Chroma-Cloud-Collection, die bereits Dense Embeddings, Dokumenttext und Metadaten enthält, in einen serverlosen Pinecone-Index. Vorhandene Vektoren werden wiederverwendet, es wird nichts neu eingebettet. Vorausgesetzt wird eine geplante Schreibpause, in der die App während des Umschaltfensters schreibgeschützt ist. Mehrere Collections lassen sich umziehen, indem man den Vorgang für jede wiederholt.

Der Ablauf stützt sich auf ein Toolkit aus sechs Python-Skripten: Preflight, Index erstellen, Export, Konvertierung, Laden und Validierung. Das Toolkit liegt unter pinecone-field/chromacloud-migration. Pinecone erklärt, es werde as-is und ohne Garantien bereitgestellt, und rät Nutzern, die Skripte auf ihren eigenen Daten auszuführen, jeden Befund zu prüfen und zu bestätigen, dass die Validierung zu ihrer App passt, bevor sie den Produktivverkehr umschalten.

Der Beitrag ordnet Chroma-Konzepte den Pinecone-Entsprechungen zu. Ein Chroma-Tenant samt Datenbank entspricht einer Pinecone-Organisation und einem Projekt. Eine Collection wird zu einem Index, oder zu einem Namespace in einem gemeinsamen Index, wenn Collections Dimension und Metrik teilen. Die Distanzeinstellungen l2, cosine und ip entsprechen euclidean, cosine und dotproduct. Metadaten werden zu Feldern des Dokuments auf oberster Ebene, die automatisch filterbar sind.

Nicht alles lässt sich direkt übernehmen. Chroma-Abfragen mit where_document sowie $contains- oder $not_contains-Filter auf Schlüsseln, die keine Arrays sind, haben in Pinecone keine Entsprechung und müssen neu konzipiert werden. Auch einige Daten ändern sich unterwegs, darunter neu zugeordnete IDs und umbenannte Metadatenschlüssel.

Die Abfolge in zehn Schritten

Pinecone beschreibt zehn Schritte: Probelauf und Dimensionierung des Zeitfensters, Index erstellen und einen Schalter für Lesen und Schreiben ausliefern, Schreibzugriffe pausieren, Anzahl festhalten und exportieren, in einen frischen Namespace konvertieren und laden, validieren, eine Entscheidung treffen, Lesen und Schreiben gemeinsam umschalten, nach dem Cutover überwachen und Chroma Cloud abschalten.

• Preflight: durchsucht die Collection und meldet Anzahl, Embedding-Dimension, Distanzraum, Metadatenschlüssel und -typen, leere Dokumente und IDs, die Pinecone ablehnen würde. Die Befunde werden als BLOCKING, TRANSFORM, WARNING oder INFO gekennzeichnet und in preflight.json gespeichert. Zu den blockierenden Problemen zählen Nullvektoren, gemischte Dimensionen, Metadaten über 40 KB, nicht unterstützte Typen sowie numerische oder boolesche Arrays.
• Index erstellen: liest Dimension und Metrik aus preflight.json und legt standardmäßig einen Dokumentindex in AWS us-east-1 an. Eine Variante mit Volltextsuche steht zur Verfügung, falls Dokumente größer als etwa 40 KB sind.
• Export: hält die Anzahl der Collection fest und streamt Seiten nach export.jsonl. Das Skript beendet sich nur dann mit 0, wenn die Zahl der eindeutigen exportierten IDs der Anzahl entspricht, keine ID doppelt vorkommt und sich die Anzahl nicht geändert hat. Der Beitrag warnt, dass diese Prüfung ein Update, das die Anzahl unverändert lässt, nicht erkennen kann. Die Schreibpause müsse daher in der App durchgesetzt werden.
• Konvertierung: erzeugt documents.jsonl, field_map.json, id_map.jsonl und transforms.jsonl. IDs, die Pinecone ablehnt, werden zu chroma-sha256-Werten, das Original wird in chroma_id gespeichert.

Pinecone nennt keine Zeiten und erklärt, ein Probelauf mit einer Kopie oder einer kleinen Collection sei der einzig verlässliche Weg, das Fenster für die Schreibpause zu bemessen.

Was das für Nutzer von Chroma Cloud bedeutet

Da die Schreibzugriffe am 22. November enden, bleibt Teams mit Chroma Cloud nur ein begrenztes Zeitfenster, um einen Umzug zu proben, Schreibzugriffe zu pausieren und die Daten zu validieren. Der Leitfaden bietet denjenigen, die sich für Pinecone entscheiden, einen konkreten Weg, während der Haftungsausschluss (as-is) bedeutet, dass die Überprüfung in der Verantwortung der Nutzer bleibt. Wer bei Chroma bleiben möchte, kann die Open-Source-Version nutzen, die laut dem Beitrag nicht betroffen ist.