mirror of
https://github.com/qdrant/landing_page.git
synced 2026-10-06 11:28:31 +02:00
1a40961d62
* initial commit; fixed anchor links on internal docs pages * add back in absolute paths for links in code comments * fix: update linkchecker include filter to match server port 1314 PR #1629 changed the Hugo server to port 1314 but forgot to update the --include filter, which still matched port 1313. This caused all links to be excluded, making the checker a no-op (0 checked, 82277 excluded). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Fix url rewrite regex so images are not impacted * Fix links from non-documentation pages * Fix broken links * more broken links * more broken links * broken link * Add srcset width descriptor to .lycheeignore * Ignore URLs that contain a % character * Anchor regex so it matches the entire URL --------- Co-authored-by: kanungle <neil.kanungo@gmail.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
87 lines
3.8 KiB
Markdown
87 lines
3.8 KiB
Markdown
---
|
|
title: From Weaviate
|
|
weight: 10
|
|
partition: ecosystem
|
|
---
|
|
|
|
# Migrate from Weaviate to Qdrant
|
|
|
|
## What You Need from Weaviate
|
|
|
|
- **Host URL** — the Weaviate instance address
|
|
- **Class name** — the class to migrate
|
|
- **Authentication** — API key, username/password, or bearer token depending on your setup
|
|
- **Vector dimensions** — Weaviate does not expose vector dimensions through its API, so you must know this value
|
|
|
|
<aside role="alert"><strong>Important:</strong> Because Weaviate does not expose vector dimensions, the migration tool cannot auto-create the Qdrant collection. You must create the collection manually before running the migration.</aside>
|
|
|
|
## Pre-Create Your Qdrant Collection
|
|
|
|
```bash
|
|
curl -X PUT 'https://your-instance.cloud.qdrant.io:6333/collections/your-collection' \
|
|
-H 'api-key: your-qdrant-api-key' \
|
|
-H 'Content-Type: application/json' \
|
|
-d '{
|
|
"vectors": {
|
|
"size": 384,
|
|
"distance": "Cosine"
|
|
}
|
|
}'
|
|
```
|
|
|
|
Replace `384` with your actual vector dimensions. Set the distance metric to match your Weaviate configuration.
|
|
|
|
## Concept Mapping
|
|
|
|
| Weaviate | Qdrant | Notes |
|
|
| :--- | :--- | :--- |
|
|
| Class | Collection | One-to-one mapping |
|
|
| Properties | Payload | Direct mapping |
|
|
| `cosine` | `Cosine` | Direct mapping |
|
|
| `l2-squared` | `Euclid` | Qdrant uses L2, not L2-squared; scores differ in magnitude but ranking is identical |
|
|
| `dot` | `Dot` | Direct mapping |
|
|
| Cross-references | Payload fields | Store referenced IDs as payload fields and rebuild linking in your application |
|
|
| Tenants | Payload field or separate collections | Use `--weaviate.tenant` to migrate a specific tenant |
|
|
|
|
## Run the Migration
|
|
|
|
```bash
|
|
docker run --net=host --rm -it registry.cloud.qdrant.io/library/qdrant-migration weaviate \
|
|
--weaviate.host 'your-weaviate-host.example.com' \
|
|
--weaviate.scheme https \
|
|
--weaviate.class-name 'YourClass' \
|
|
--weaviate.auth-type apiKey \
|
|
--weaviate.api-key 'your-weaviate-api-key' \
|
|
--qdrant.url 'https://your-instance.cloud.qdrant.io:6334' \
|
|
--qdrant.api-key 'your-qdrant-api-key' \
|
|
--qdrant.collection 'your-collection'
|
|
```
|
|
|
|
### All Weaviate-Specific Flags
|
|
|
|
| Flag | Required | Description |
|
|
| :--- | :--- | :--- |
|
|
| `--weaviate.host` | Yes | Weaviate host address |
|
|
| `--weaviate.scheme` | No | `http` or `https` (default: `http`) |
|
|
| `--weaviate.class-name` | Yes | Weaviate class to migrate |
|
|
| `--weaviate.auth-type` | No | `none`, `apiKey`, `password`, `client`, or `bearer` |
|
|
| `--weaviate.api-key` | No | API key (when auth-type is `apiKey`) |
|
|
| `--weaviate.username` | No | Username (when auth-type is `password`) |
|
|
| `--weaviate.password` | No | Password (when auth-type is `password`) |
|
|
| `--weaviate.tenant` | No | Specific tenant to migrate |
|
|
| `--weaviate.scopes` | No | Scopes (when auth-type is `password` or `client`) |
|
|
| `--weaviate.client-secret` | No | Client secret (when auth-type is `client`) |
|
|
| `--weaviate.token` | No | Token (when auth-type is `bearer`) |
|
|
| `--weaviate.refresh-token` | No | Refresh token (when auth-type is `bearer`) |
|
|
| `--weaviate.expires-in` | No | Token expiry in seconds (when auth-type is `bearer`) |
|
|
|
|
## Gotchas
|
|
|
|
- **Vector dimensions not exposed:** Always pre-create the Qdrant collection. If you don't know your dimensions, check a sample vector from Weaviate or your embedding model's documentation.
|
|
- **Cross-references:** Weaviate cross-references don't have a direct equivalent in Qdrant. Store referenced IDs as payload fields and rebuild the linking in your application layer.
|
|
- **Module dependencies:** If you used Weaviate vectorizer modules (e.g., `text2vec-openai`), ensure you exported the actual vectors, not just the source text.
|
|
|
|
## Next Steps
|
|
|
|
After migration, verify your data arrived correctly with the [Migration Verification Guide](/documentation/migration-guidance/).
|