← Cloudflare Vectorize / vectorize / best-practices

Список векторов

Операция list-vectors позволяет перечислить все идентификаторы векторов в индексе Vectorize с помощью запросов с пагинацией. В этом руководстве описаны рекомендации по эффективному использованию этой операции.

Используйте list-vectors для:

• Массовые операции: для обработки всех векторов в индексе
• Аудит: для проверки содержимого индекса или формирования отчётов
• Миграция данных: для перемещения векторов между индексами или системами
• Операции очистки: для выявления и удаления устаревших векторов

Операция list-vectors использует пагинацию на основе курсора с важными гарантиями согласованности данных:

Возвращаемые идентификаторы векторов относятся к снимку индекса, созданному в момент первого запроса list-vectors. Это обеспечивает согласованную пагинацию, даже если индекс изменяется в процессе итерации:

• Новые векторы: векторы, добавленные после первоначального запроса, не будут отображаться в последующих результатах пагинации
• Удалённые векторы: векторы, удалённые после первоначального запроса, будут по-прежнему появляться в оставшихся ответах до завершения пагинации

Чтобы увидеть недавно добавленные или удалённые векторы, необходимо начать новую последовательность запросов list-vectors (без курсора). Это фиксирует новый снимок состояния индекса.

Каждый ответ включает:

• count: количество векторов, возвращённых в этом ответе
• totalCount: общее количество векторов в индексе
• isTruncated: показывает, доступны ли ещё векторы
• nextCursor: курсор для следующей страницы (null, если результатов больше нет)
• cursorExpirationTimestamp: временная метка истечения срока действия курсора
• vectors: массив идентификаторов векторов

У курсоров есть метка времени истечения срока действия. Если срок действия курсора истёк, для продолжения постраничной навигации потребуется начать новую последовательность запросов list-vectors.

Обеспечьте достаточный интервал между последовательными запросами, чтобы не столкнуться с ограничением частоты запросов.

Ниже приведён типичный алгоритм обработки всех векторов в индексе:

# 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