qdrant-migration-tool — скилл для Claude Code
Скилл qdrant-migration-tool для Claude Code переносит векторные данные и метаданные в Qdrant из других баз данных. Инструмент управляет процессом миграции, включая возобновление прерванных операций.
Apache-2.0 137 установок ★ 271 обновлён 2026-10-23
npx skills add qdrant/skills --skill qdrant-migration-tool -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/qdrant-migration-tool/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qdrant-migration-tool/
1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-migration-tool -a codex2Вручную: положить файлы
.agents/skills/qdrant-migration-tool/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-migration-tool -a cursor2Вручную: положить файлы
.cursor/skills/qdrant-migration-tool/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install qdrant/skills skills/qdrant-migration-tool2Вручную: положить файлы
.github/skills/qdrant-migration-tool/SKILL.md1Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-migration-tool -a gemini-cli2Командой платформы
gemini skills install https://github.com/qdrant/skills --path skills/qdrant-migration-toolВручную: положить файлы
.devin/skills/qdrant-migration-tool/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add qdrant/skills --skill qdrant-migration-tool -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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