← Cloudflare Vectorize / vectorize / best-practices

Seznam vektorů

Operace list-vectors umožňuje vypsat všechny identifikátory vektorů v indexu Vectorize pomocí stránkovaných požadavků. Tento návod popisuje osvědčené postupy pro efektivní využití této operace.

Operaci list-vectors použijte pro:

• Hromadné operace: Ke zpracování všech vektorů v indexu
• Auditování: K ověření obsahu indexu nebo generování reportů
• Migrace dat: K přesunu vektorů mezi indexy nebo systémy
• Operace čištění: K identifikaci a odstranění zastaralých vektorů

Operace list-vectors používá stránkování na základě kurzoru s důležitými zárukami konzistence:

Vrácené identifikátory vektorů patří ke snímku indexu pořízenému v okamžiku prvního požadavku list-vectors. Díky tomu zůstává stránkování konzistentní, i když se index během iterace mění:

• Nové vektory: Vektory vložené po odeslání počátečního požadavku se v následujících stránkovaných výsledcích nezobrazí
• Odstraněné vektory: Vektory smazané po odeslání počátečního požadavku se budou nadále zobrazovat ve zbývajících odpovědích, dokud nebude stránkování dokončeno

Chcete-li vidět nedávno přidané nebo odebrané vektory, musíte zahájit novou sekvenci požadavků list-vectors (bez kurzoru). Tím se pořídí aktuální snímek indexu.

Každá odpověď obsahuje:

• count: Počet vektorů vrácených v této odpovědi
• totalCount: Celkový počet vektorů v indexu
• isTruncated: Zda jsou k dispozici další vektory
• nextCursor: Kurzor pro další stránku (null, pokud nejsou žádné další výsledky)
• cursorExpirationTimestamp: Časové razítko vypršení platnosti kurzoru
• vectors: Pole identifikátorů vektorů

Kurzory mají časové razítko vypršení platnosti. Pokud kurzor vyprší, budete muset zahájit novou sekvenci požadavků list-vectors, abyste mohli pokračovat ve stránkování.

Dbejte na dostatečnou prodlevu mezi jednotlivými požadavky, abyste nenarazili na rate limity.

Typický postup pro zpracování všech vektorů v indexu vypadá takto:

# Start iteration
wrangler vectorize list-vectors my-index --count=1000

# Continue with cursor from response
wrangler vectorize list-vectors my-index --count=1000 --cursor="<cursor-from-response>"

# Repeat until no more results