К основному содержанию
скилл CX Codex

qdrant-migration-tool — скилл для Claude Code

Скилл qdrant-migration-tool для Claude Code переносит векторные данные и метаданные в Qdrant из других баз данных. Инструмент управляет процессом миграции, включая возобновление прерванных операций.

Apache-2.0 137 установок ★ 271 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add qdrant/skills --skill qdrant-migration-tool -a claude-code
Открыть на GitHub

Что делает qdrant-migration-tool

Скилл использует Docker-контейнер для потоковой передачи данных. Он не является библиотекой для импорта, поэтому все команды выполняются через вызов этого контейнера. Инструмент автоматически отслеживает прогресс через специальную коллекцию _migration_offsets в Qdrant, что позволяет автоматически возобновлять процесс после сбоев вместо запуска с начала.

Для работы с локальными экземплярами баз данных добавляйте --net=host в команду запуска docker run, иначе контейнер не разрешит localhost. При миграции из Weaviate, Redis, MongoDB или Solr целевую коллекцию требуется создать заранее, так как эти источники не передают параметры вектора. Если соединение защищено самоподписанным сертификатом, примонтируйте его через SSL_CERT_FILE.

Скорость передачи настраивается через --migration.batch-size для крупных датасетов. По умолчанию используется значение 50, но для ускорения его можно поднять до 256 или 512. Для Postgres и Qdrant доступен флаг --migration.num-workers для распараллеливания нагрузки.

Какие задачи решает

  • перенести данные из Pinecone или MongoDB в Qdrant
  • возобновить прерванную миграцию без дублирования записей
  • настроить скорость передачи данных через batch-size
  • проверить целостность данных после переноса

Примеры запросов агенту

  • Помоги перенести мою базу данных из Pinecone в Qdrant
  • Как возобновить прерванную миграцию в Qdrant?
  • Почему миграция в Qdrant работает слишком медленно и как это исправить?

Как установить qdrant-migration-tool

1Через Skills CLI (Vercel)

npx skills add qdrant/skills --skill qdrant-migration-tool -a claude-code

2Вручную: положить файлы

~/.claude/skills/qdrant-migration-tool/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/qdrant-migration-tool/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о qdrant-migration-tool

Как установить qdrant-migration-tool в Claude Code?

Выполните в терминале npx skills add qdrant/skills --skill qdrant-migration-tool -a claude-code.

Что делает qdrant-migration-tool?

Этот скилл автоматизирует перенос векторов, метаданных и разреженных эмбеддингов из различных систем в Qdrant, управляя очередями и возобновлением процесса.

Что нужно для работы qdrant-migration-tool?

Для работы необходим Docker, так как инструмент запускается как контейнер registry.cloud.qdrant.io/library/qdrant-migration.

Исходный текст

SKILL.md · Apache-2.0
---
name: qdrant-migration-tool
description: "Guides use of the Qdrant Migration Tool CLI to move vectors, metadata, and sparse embeddings from another vector database into Qdrant. Use when someone asks 'how do I migrate from Pinecone/Weaviate/Milvus/Elasticsearch/OpenSearch/pgvector/s3/Azure/DynamoDB/Turbopuffer/Chroma/Redis/MongoDB/FAISS/Solr to Qdrant', 'move my vector database to Qdrant', 'is there a migration tool for Qdrant', 'my migration got interrupted, how do I resume it', 'migration is too slow', or 'collection wasn't created after migration'. Also use when picking migration batch size, deciding on `--net=host`, or verifying data after a migration."
---

# Qdrant Migration Tool

The tool is a Docker container (`registry.cloud.qdrant.io/library/qdrant-migration`), not a library you import. It streams data in batches through the machine it runs on rather than connecting source and target directly, and it resumes by default rather than restarting from scratch. [Migrate to Qdrant](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/)

## Picking the Right Subcommand

Use when: starting a new migration and choosing the source-specific CLI subcommand.

- Each source has its own subcommand, listed in the [Supported Sources](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/?s=supported-sources) table; most are named after the source, the non-obvious ones are `pg` (pgvector), `s3` (S3 Vectors), and `azure` (Azure AI Search).
- Weaviate, Redis, MongoDB, and Apache Solr do not auto-create the target collection; create it in Qdrant first with matching vector size and distance metric before running the migration. All other sources auto-create it.
- Read the source's guide (linked from the same table) before running the migration: credentials and concept mapping (namespaces, indexes, metadata fields) are source-specific.
- Source not listed? Point to the GitHub issue tracker rather than improvising a custom pipeline. [Open an issue](https://github.com/qdrant/migration/issues)

## Running Against Local Instances

Use when: either the source or target database runs on the same machine as the migration container.

- Add `--net=host` to the `docker run` command; without it, the container cannot resolve `localhost` on the host machine. [Migrate to Qdrant](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/)
- Run the container on a machine with low latency to both databases. Direct source-target connectivity is not required since the tool streams through wherever it runs, but round trips from the migration host to each database still add up.

## Migration Was Interrupted

Use when: a migration stopped partway through and needs to continue, or needs to be re-run from zero.

- Re-run the exact same command. Progress is tracked in the `_migration_offsets` collection in Qdrant, so it resumes automatically rather than re-copying already-migrated points.
- Pass `--migration.restart` to discard saved progress and start over, e.g. after fixing a bad source-side filter or changing collection schema mid-migration.
- Custom offsets-collection name only matters if you're running multiple concurrent migrations into the same Qdrant instance; otherwise leave `--migration.offsets-collection` at its default to avoid tracking state you'll forget to look for later.

## Migration Is Too Slow

Use when: throughput is too low for the size of the source dataset.

- Raise `--migration.batch-size` from the default of 50 to 256 or 512 for large migrations; small batches under-use each upsert round trip.
- `--migration.num-workers` only exists for the `pg` and `qdrant` subcommands; other sources have no parallel-worker flag, so throughput there is bounded by batch size and network proximity alone.
- `--migration.batch-delay` defaults to 0; only raise it deliberately to throttle load on a source database that can't absorb full-speed reads, not as a default tuning knob.

## After Migration

Use when: the migration command finished and data needs to be trusted before cutting over traffic.

- Run through the verification framework rather than spot-checking a few points: it covers pre-migration baselines, data integrity checks, and search-quality validation, not just point counts. [Migration Verification Guide](https://skills.qdrant.tech/md/documentation/migration-guidance/)
- If Postgres/pgvector stays live alongside Qdrant post-migration, set up an ongoing sync strategy (event-driven, batch, or dual-write) instead of treating the migration as a one-time cutover. [Keeping Postgres in Sync](https://skills.qdrant.tech/md/documentation/data-synchronization/)

## What NOT to Do

- Assume Weaviate, Redis, MongoDB, or Solr auto-create the target collection; these sources don't expose vector dimensions or distance metric to the tool, so the collection must be created manually first with settings that exactly match the source. [Migrate to Qdrant](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/)
- Point the `faiss` subcommand at a quantized FAISS index; only `IndexFlatL2`, `IndexFlatIP`, `IndexHNSWFlat`, and `IndexIVFFlat` are supported, since quantized indexes don't retain the original vectors. [FAISS](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/from-faiss/)
- Assume every Pinecone index can be migrated; only serverless indexes support the list operation the tool needs to enumerate vectors.[Pinecone](https://skills.qdrant.tech/md/documentation/migrate-to-qdrant/from-pinecone/)
- Run a `qdrant`-to-`qdrant` migration into an existing target collection without checking its vector size first; source and target dimensions must match exactly, only replication and shard settings are allowed to differ.
- Connect over TLS to a source or target signed by a private or self-signed CA without mounting it via `SSL_CERT_FILE`; the migration fails on certificate verification instead of degrading gracefully, and `--skip-tls-verification` should be a deliberate override, not a default fix. 
- Pass `--migration.restart` out of caution on a healthy resume; it discards saved progress and re-streams data that already migrated.
- Treat a completed migration run as verified without running data integrity and search quality checks.

© qdrant · Apache-2.0 · qdrant/skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
azure-database-migration MicrosoftDocs Помогает планировать миграции через Azure Database Migration Service и разбирать сбои, ограничения и вопросы безопасности. Охватывает перенос баз данных и пакетов SSIS. CX Codex +1 177установок qdrant-model-migration официальный github Скилл qdrant-model-migration помогает менять embedding-модель в Qdrant без остановки поиска. Он пригодится при смене провайдера, размерности векторов или переходе на hybrid search. CX Codex +1 61установок database-testing kindlmann Скилл database-testing для Claude Code проверяет миграции баз данных вперёд и назад, ограничения схемы, seed-данные и планы запросов. Выявляет потерю данных при успешной миграции. CX Codex +1 1 500установок databases mrgoonie Скилл databases с единым справочником по MongoDB и PostgreSQL: схемы, запросы, индексы, миграции, бэкапы и администрирование. CX Codex +1 447установок database-designer borghei Скилл database-designer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode проверяет SQL-схемы, подбирает индексы и создаёт миграции. Используйте его при ревью DDL, настройке индексов или сравнении версий схемы. CX Codex +1 176установок reviewing-oracle-to-postgres-migration официальный github Скилл reviewing-oracle-to-postgres-migration проверяет риски миграции с Oracle на PostgreSQL и помогает сверить миграционные артефакты с интеграционными тестами. CX Codex +1 1 800установок

Из того же набора12

Весь набор →
qdrant-version-upgrade Скилл qdrant-version-upgrade для Claude Code помогает спланировать обновление Qdrant и SDK с учётом совместимости версий. Он разбирает переходы между версиями, порядок действий и изменения после обновления. CX Codex +1 1 400установок qdrant-performance-optimization Скилл qdrant-performance-optimization для Claude Code сопоставляет симптомы при настройке Qdrant с под-скиллами по скорости поиска, индексации и памяти. CX Codex +1 1 700установок qdrant-advisor Скилл qdrant-advisor подтягивает официальные инструкции из skills.qdrant.tech для решения сбоев кластера, утечек памяти и замедления индексов Qdrant. CX Codex +1 782установок qdrant-edge Помогает разрабатывать приложения на Qdrant Edge. Разбирает синхронизацию локального шарда, поиск BM25 и обслуживание индексов. CX Codex +1 328установок qdrant-multitenancy Скилл qdrant-multitenancy для Claude Code, Codex и Cursor. Направляет выбор архитектуры изоляции данных нескольких клиентов в векторной базе Qdrant. CX Codex +1 298установок qdrant-sizing Скилл qdrant-sizing рассчитывает оперативную память, диск, процессоры и число узлов кластера Qdrant под заданный объём векторов и требования к задержкам. CX Codex +1 222установок qdrant-hybrid-cloud-setup Скилл qdrant-hybrid-cloud-setup для Claude Code помогает развернуть Qdrant Hybrid Cloud в собственном Kubernetes-кластере. Подключается при настройке агента и оператора, хранилища, резервных копий или доступа к кластеру. CX Codex +1 121установок qdrant-skills Набор скиллов помогает агенту принимать решения по векторному поиску Qdrant: от масштабирования и качества выдачи до миграции моделей. ★ 271звёзд репо

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой