登录 免费开始
Calendar 第 0 天

Qdrant云设置


在几分钟内启动生产级的向量搜索。Qdrant 云为您提供一个托管端点，具备 TLS、自动备份、高可用性选项和简洁的 API。

创建您的集群

  1. 使用电子邮件、Google 或 GitHub 注册 cloud.qdrant.io。
  2. 打开集群 → 创建免费集群。免费套餐足以完成本课程。

Create cluster

  1. 选择一个离您的用户或应用程序近的区域。
  2. 当集群准备就绪后，复制 API 密钥并妥善保管。您稍后可以从集群页面上的API 密钥创建新密钥。

Get API key

访问 Web UI

  1. 点击集群页面右上角的集群 UI，打开仪表板。

Access dashboard

您可以在 Web UI 中做什么

使用 Web UI 管理集合、检查数据和调试搜索性能。

控制台：在浏览器中运行 REST 调用。测试端点、检查响应和调试查询，无需编写代码。方便探索完整的 API。

集合：查看和管理所有集合。创建集合、上传快照，并一目了然地跟踪状态、大小和配置。

教程：按照交互式演练操作示例数据。创建一个集合，添加向量，并运行语义搜索以获取实时结果。

Interactive tutorial

数据集：将预配置的公共数据集批量加载到您的集群中。

集合内部

当您点击集合名称打开它时，

Select collection

您将看到一个包含以下选项卡的详细视图

Collection points

  • 点选项卡：检查、搜索和管理单个点。使用搜索栏按 ID 查找或按负载字段（例如，colony: "Mars"）过滤。对于每个点，您可以

    • 查看其负载和向量。
    • 点击查找相似以运行即时相似性搜索。
    • 点击打开图以跳转到其 HNSW 连接的图视图。

  • 信息选项卡：获取集合健康状况、配置和统计信息的完整概览。关键字段

    • status：green 表示健康。
    • points_count：活动点的数量。
    • indexed_vectors_count：当前在 HNSW 索引中的点。如果这滞后于 points_count，则后台索引仍在运行。
    • config：所有参数的 JSON 视图，从向量设置到优化器选项。

  • 集群选项卡：查看分片如何分布在节点上。用它来监控健康状况、查找热点，并验证分布式设置中的分片放置。

  • 搜索质量选项卡：根据真实情况评估和基准测试检索精度。调整参数并测量对准确性的影响。

  • 快照选项卡：管理此集合的备份。创建快照，稍后恢复它，或将其迁移到另一个集群。

  • 可视化选项卡：使用交互式 2D 投影探索您的向量空间。查看簇、发现异常值，并建立对嵌入的直觉。

  • 图选项卡：交互式探索 HNSW 图。从任何点开始，跟随最近的邻居，并查看图结构如何为快速搜索提供动力。

从 Python 连接

将凭据存储在工作目录根目录或 Colab 中的 .env 文件中

QDRANT_URL=https://YOUR-CLUSTER.cloud.qdrant.io:6333
QDRANT_API_KEY=YOUR_API_KEY

从环境中加载凭据并创建 Qdrant 客户端

from qdrant_client import QdrantClient, models
import os

client = QdrantClient(url=os.getenv("QDRANT_URL"), api_key=os.getenv("QDRANT_API_KEY"))

# For Colab:
# from google.colab import userdata
# client = QdrantClient(url=userdata.get("QDRANT_URL"), api_key=userdata.get("QDRANT_API_KEY"))

# Quick health check
collections = client.get_collections()
print(f"Connected to Qdrant Cloud: {len(collections.collections)} collections")

其他连接方式

您还可以将密钥放在 Authorization 标头中发送

# Using api-key header
curl -X GET https://xyz-example.eu-central.aws.cloud.qdrant.io:6333/collections \
  --header 'api-key: <your-api-key>'

# Using Authorization header  
curl -X GET https://xyz-example.eu-central.aws.cloud.qdrant.io:6333/collections \
  --header 'Authorization: Bearer <your-api-key>'

快速验证

检查基本连通性

# Service health
curl -s "$QDRANT_URL/healthz" -H "api-key: $QDRANT_API_KEY"

# List collections
curl -s "$QDRANT_URL/collections" -H "api-key: $QDRANT_API_KEY"

良好实践

  • 将秘密保密；使用环境变量或秘密管理器。
  • 使用 IP 允许列表或专用网络限制访问。
  • 定期从集群访问选项卡轮换 API 密钥。
  • 只使用 HTTPS；在向不受信任的客户端公开端点时，启用 RBAC 和严格限制。

常见问题

  • 身份验证错误：重新检查 API 密钥和 api-key 标头。
  • 连接错误：确认集群状态和区域 URL；某些公司代理会阻止出站 TLS。

Qdrant 云推理

Qdrant 云还提供 云推理——用于文本和图像的托管嵌入生成。无需运行自己的嵌入模型；在 Qdrant 云中创建向量，并直接将它们写入您的集合。

从您的管道中减少步骤：将原始文本或图像发送到 Qdrant，通过一次 API 调用获取向量和搜索结果。这通过消除单独的嵌入基础设施层，帮助原型和生产系统。

了解更多：Qdrant 云推理

继续下一步

本页内容