← Cloudflare Vectorize / vectorize / reference

Přechod ze starších indexů Vectorize

Starší indexy Vectorize (V1) jsou od 15. srpna 2024 na cestě k ukončení podpory. Váš index Vectorize může být starším indexem, pokud splňuje některé z následujících kritérií:

1. Byl vytvořen s verzí Wrangleru nižší než v3.71.0.
2. Byl vytvořen s povoleným příznakem "--deprecated-v1".
3. Byl vytvořen pomocí starší verze REST API.

Tento dokument popisuje kroky přechodu, které mohou být potřeba k opuštění starších indexů Vectorize.

Starší indexy Vectorize (V1) jsou na cestě k ukončení podpory. Podpora těchto indexů bude omezená a jejich použití se nedoporučuje pro žádné produkční pracovní zátěže.

Od prosince 2024 navíc nebude možné vytvářet nové starší indexy Vectorize. Ostatní operace zůstanou beze změny a budou nadále fungovat.

Nové indexy Vectorize (V2) navíc dokážou pracovat ve výrazně větším měřítku (s kapacitou pro miliony vektorů) a nabízejí vyšší výkon. Přečtěte si prosím Limity k pochopení nejnovějších možností, které Vectorize podporuje.

Kromě podpory výrazně větších indexů s miliony vektorů a vyššího výkonu je třeba při přechodu ze starších indexů Vectorize zvážit i tyto změny:

1. Nové indexy Vectorize (V2) nyní podporují asynchronní mutace. Projevení jakéhokoli vložení nebo smazání vektoru a vytvoření nebo smazání metadatového indexu může trvat několik sekund.

2. Vectorize (V2) podporuje filtrování podle metadat a namespace u mnohem větších indexů s výrazně nižší latencí. Pole, podle kterých lze metadata filtrovat, je však nutné určit ještě před vložením vektorů. Viz vytváření metadatových indexů pro další podrobnosti.

3. Vectorize (V2) dotazovací operace nyní podporuje vyhledávání a vrácení až 100 nejpodobnějších vektorů.

4. Operace dotazování ve Vectorize (V2) poskytují podrobnější kontrolu nad dotazováním metadat spolu s vektory. Viz dotazovací operace pro další podrobnosti.

5. Vectorize (V2) rozšiřuje možnosti Vectorize dostupné přes Wrangler (od verze Wrangler > v3.71.0).

1. Wrangler nyní ve výchozím nastavení podporuje operace nad novou verzí indexů Vectorize (V2). Pro použití příkazů Wrangleru se staršími indexy (V1) je nutné --deprecated-v1 příznak musí být povolený. Upozorňujeme, že tento příznak je podporován pouze pro vytváření, získávání, výpis a mazání indexů a pro vkládání vektorů.

2. Viz REST API pro podrobnosti o cestách a typech datového obsahu pro nové indexy Vectorize (V2).

3. Chcete-li ve Workers používat novou verzi indexů Vectorize, musí být binding prostředí definován jako Vectorize rozhraní.

   export interface Env {
   	// This makes your vector index methods available on env.VECTORIZE.*
   	// For example, env.VECTORIZE.insert() or query()
   	VECTORIZE: Vectorize;
   }

   Vectorize rozhraní zahrnuje změny typů a funkce podporované novými indexy Vectorize (V2).

   U starších indexů Vectorize (V1) použijte VectorizeIndex rozhraní.

   export interface Env {
   	// This makes your vector index methods available on env.VECTORIZE.*
   	// For example, env.VECTORIZE.insert() or query()
   	VECTORIZE: VectorizeIndex;
   }

4. S novou verzí Vectorize (V2) returnMetadata možnost pro dotazovací operace nyní očekává buď all, indexed nebo none textové hodnoty. U staršího Vectorize (V1) returnMetadata možnost byla booleovské pole.

5. U nových indexů Vectorize (V2) jsou všechny mutace indexu i vektorů asynchronní a vracejí mutationId v odpovědi jako jedinečný identifikátor dané mutační operace.

   Mezi tyto operace mutace patří: Vkládání vektorů, Upsert vektorů, Mazání vektorů, Vytvoření indexu metadat, Odstranění indexu metadat.

   Chcete-li zkontrolovat identifikátor a časové razítko poslední zpracované mutace, použijte Vectorize Příkaz info.