← Cloudflare Vectorize / vectorize / reference

Переход с устаревших индексов Vectorize

Устаревшие индексы Vectorize (V1) выводятся из эксплуатации начиная с 15 августа 2024 года. Ваш индекс Vectorize может относиться к устаревшим, если выполняется одно из следующих условий:

Был создан с использованием версии Wrangler ниже v3.71.0.
Был создан с включённым флагом «--deprecated-v1».
Был создан с использованием устаревшего REST API.

В этом документе описаны шаги перехода, которые могут понадобиться для отказа от устаревших индексов Vectorize.

Зачем переходить?

Устаревшие индексы Vectorize (V1) выводятся из эксплуатации. Поддержка таких индексов будет ограниченной, и их не рекомендуется использовать в производственных средах.

Кроме того, начиная с декабря 2024 года создать устаревшие индексы Vectorize будет невозможно. Остальные операции это не затронет, они останутся доступны.

Кроме того, новые индексы Vectorize (V2) способны работать в значительно большем масштабе (с поддержкой множества миллионов векторов) и обеспечивают более высокую производительность. Ознакомьтесь с Лимиты чтобы узнать о последних возможностях, поддерживаемых Vectorize.

Основные изменения

Помимо поддержки значительно более крупных индексов с миллионами векторов и более высокой производительности, при переходе от устаревших индексов Vectorize стоит учитывать следующие изменения:

Новые индексы Vectorize (V2) теперь поддерживают асинхронные мутации. Вставка или удаление векторов, а также создание или удаление индекса метаданных могут отражаться в индексе с задержкой в несколько секунд.
Vectorize (V2) поддерживает фильтрацию по метаданным и пространствам имён для значительно более крупных индексов с заметно меньшей задержкой. При этом поля, по которым допускается фильтрация по метаданным, необходимо указать до вставки векторов. См. создание индекса метаданных для получения дополнительных сведений.
Vectorize (V2) операция запроса теперь поддерживает поиск и возврат до 100 наиболее похожих векторов.
Операции запросов Vectorize (V2) обеспечивают более детальный контроль при запросе метаданных вместе с векторами. См. операция запроса для получения дополнительных сведений.
Vectorize (V2) расширяет возможности Vectorize, доступные через Wrangler (начиная с версии Wrangler > v3.71.0).

Переход

Теперь Wrangler по умолчанию поддерживает операции с индексами новой версии Vectorize (V2). Чтобы использовать команды Wrangler для устаревших индексов (V1), --deprecated-v1 флаг должен быть включён. Обратите внимание, что этот флаг поддерживается только для операций создания, чтения, получения списка и удаления индексов, а также вставки векторов.
См. REST API для получения подробной информации о маршрутах и типах полезной нагрузки для новых индексов Vectorize (V2).
Чтобы использовать новую версию индексов Vectorize в Workers, привязка окружения должна быть определена как Vectorize интерфейс.
```
export interface Env {
	// This makes your vector index methods available on env.VECTORIZE.*
	// For example, env.VECTORIZE.insert() or query()
	VECTORIZE: Vectorize;
}
```
Vectorize интерфейс включает изменения типов и возможности, поддерживаемые новыми индексами Vectorize (V2).

Для устаревших индексов Vectorize (V1) используйте VectorizeIndex интерфейс.
```
export interface Env {
	// This makes your vector index methods available on env.VECTORIZE.*
	// For example, env.VECTORIZE.insert() or query()
	VECTORIZE: VectorizeIndex;
}
```
В новой версии Vectorize (V2) returnMetadata параметр для операция запроса теперь ожидает либо all, indexed или none строковых значений. Для устаревшей версии Vectorize (V1) returnMetadata параметр был логическим полем.
В новых индексах Vectorize (V2) все операции изменения индекса и векторов выполняются асинхронно и возвращают mutationId в ответе в качестве уникального идентификатора этой операции мутации.

Такими операциями мутации являются: Вставка векторов, Upsert векторов, Удаление векторов, Metadata Index Creation, Metadata Index Deletion.

Чтобы проверить идентификатор и время последней обработанной мутации, используйте Vectorize Команда info.