Bien démarrer avec Qdrant Cloud

Vous avez déjà choisi Qdrant Managed Cloud. Si vous hésitez encore entre Cloud, Hybrid Cloud et l'auto-hébergement, consultez la skill de déploiement. Sur Cloud, chaque requête nécessite une clé API sur TLS, les nouvelles collections s'exécutent en mode strict, et les clusters gratuits sont suspendus en cas d'inactivité. Certains choix de cluster ne peuvent pas être annulés ultérieurement.

Choisir et créer un cluster

À utiliser pour : créer le premier cluster, ou choisir entre Free, Standard et Premium.

• Utilisez le cluster gratuit uniquement pour le prototypage : un seul nœud avec 1 GB de RAM et 4 GB de disque, pas de sauvegarde automatique, et il est suspendu après 1 semaine sans utilisation et supprimé après 4 semaines sauf réactivation Clusters gratuits
• Si un nœud manque de RAM, le système d'exploitation arrête le processus Qdrant ; sans haute disponibilité, attendez-vous à une interruption jusqu'à ce que le cluster soit redimensionné. S'il manque de disque, il ne peut pas stocker de nouveaux vecteurs, ce qui peut également causer une interruption. Redimensionnez le cluster avant que cela ne se produise ; sur le tier gratuit, cela signifie passer à Standard Alertes de cluster
• Dimensionnez un cluster Standard avant de le créer avec la skill de dimensionnement.
• Pour tout ce qui est destiné à la production, activez la Haute Disponibilité : 3 nœuds ou plus et facteur de réplication 2 ou plus. Sans cela, chaque shard n'a qu'un seul replica, donc les mises à niveau et le redimensionnement vertical causent des interruptions Cluster prêt pour la production
• Premium est un plan au niveau du compte avec une dépense minimale convenue avec l'équipe Qdrant. Il ajoute un SLA de disponibilité plus élevé, un support 24/7 pour les problèmes critiques, des clusters Multi-AZ, SSO, une connectivité réseau privée et des clés de chiffrement gérées par le client. Standard inclut déjà la mise à l'échelle, la haute disponibilité et les sauvegardes, donc envisagez Premium si vous avez besoin de l'une de ces fonctionnalités Tier Premium
• Décidez de Multi-AZ (Premium) à la création : cela ne peut pas être activé ultérieurement, et le nombre de nœuds doit être un multiple de 3 Cluster prêt pour la production
• Le disque ne peut pas être réduit. La mémoire peut l'être, mais pas en dessous de l'utilisation actuelle Redimensionnement vertical
• Payer via AWS, GCP ou Azure Marketplace limite la création de clusters aux clusters payants dans les régions du fournisseur. Pour exécuter des clusters dans d'autres régions ou chez d'autres fournisseurs, créez un compte séparé avec une méthode de paiement différente Facturation
• Utilisez des comptes séparés pour séparer les clusters entre équipes ou environnements, comme dev et prod : chaque compte a ses propres clusters, permissions et méthode de paiement Comptes
• Créez des clusters via la Cloud Console, ou via l'API Cloud, soit en l'appelant directement, soit via le CLI qcloud, Terraform ou Pulumi. Toutes les options d'API Cloud nécessitent une Cloud Management Key. Le provisionnement prend du temps ; le flag --wait de qcloud bloque jusqu'à ce que le cluster soit sain Console Cloud API qcloud Terraform Pulumi
• Pour une procédure pas à pas dans la Console, de l'inscription à un cluster gratuit, une première collection et une première recherche, consultez le démarrage rapide Cloud

Impossible de se connecter ou de s'authentifier

À utiliser pour : la première requête au cluster échoue, ou un SDK signale une erreur d'authentification ou TLS.

• Envoyez une clé API Database avec chaque requête REST et gRPC, en tant qu'en-tête api-key ou Authorization: Bearer. Chaque clé ne fonctionne que sur le cluster dans lequel elle a été créée. Elle est affichée une fois à la création ; si elle est perdue, créez-en une nouvelle Authentification Clés API Database
• N'utilisez pas une Cloud Management Key ici. Celles-ci autorisent l'API de la plateforme Cloud pour gérer les clusters et les sauvegardes, pas la base de données Cloud API
• Connectez-vous via HTTPS au point de terminaison du cluster : port 6333 ou 443 pour REST, 6334 pour gRPC. Pour un code de connexion fonctionnel dans chaque langage, utilisez la recherche de snippet de la skill clients-sdk Accès au cluster
• Testez l'accès avec une seule requête à l'URL racine du cluster avec la clé dans l'en-tête Test d'accès au cluster
• Les clés en lecture seule et limitées à une collection se voient refuser certaines actions, comme la création de collections. Vérifiez ce qu'une clé a obtenu comme autorisation Tableau d'accès
• Les clés expirent après 90 jours par défaut ; une expiration vide signifie aucune expiration Créer des clés API Database
• Si des restrictions d'IP sont configurées, les clients en dehors des plages autorisées ne peuvent pas atteindre le cluster Restrictions d'IP client

Requêtes filtrées rejetées sur Cloud

À utiliser pour : récupérer ou mettre à jour des points par un filtre est rejeté sur une collection Cloud.

• Les nouvelles collections Cloud s'exécutent en mode strict, qui rejette la récupération ou la mise à jour par un filtre sur un champ de payload sans index. Créez un index de payload pour chaque champ filtré plutôt que de désactiver le mode strict ; une collection Cloud peut avoir jusqu'à 100 index de payload Paramètres par défaut de Cloud Index de payload

Générer des embeddings sur Qdrant Cloud

À utiliser pour : l'utilisateur souhaite que Qdrant crée des embeddings (Cloud Inference) au lieu d'exécuter un modèle lui-même.

• Cloud Inference permet à Qdrant d'intégrer et de stocker ou de rechercher dans le même appel API. C'est activé par défaut pour les clusters créés après le 7 juillet 2025 ; l'activer sur un cluster plus ancien redémarre le cluster
• Utilisez un modèle hébergé par Qdrant, ou un fournisseur externe via Qdrant, qui nécessite votre propre clé API de ce fournisseur Modèles d'embedding
• Les modèles gratuits s'exécutent aux États-Unis, même pour les clusters de région EU. Avec des exigences de résidence des données UE, utilisez un modèle payant hébergé par Qdrant ou intégrez avant le téléchargement.

Avant de compter sur le cluster

À utiliser pour : passer d'un prototype à quelque chose sur lequel les utilisateurs ou d'autres services dépendent.

• Définissez un calendrier de sauvegarde (clusters Standard uniquement). La restauration dans le même cluster ramène également sa CPU, sa mémoire, son nombre de nœuds et sa version Qdrant, et le cluster n'est pas disponible pendant la restauration. Vous pouvez plutôt restaurer dans un nouveau cluster Sauvegardes
• L'ajout de nœuds ne change pas le facteur de réplication d'une collection. Après le passage à plus de nœuds, vérifiez chaque collection existante et définissez son facteur de réplication à 2 ou plus ; sur Cloud, ses shards sont alors répliqués ou supprimés automatiquement pour correspondre Réplication
• Créez des collections avec au moins deux fois plus de shards que de nœuds afin qu'ils puissent se propager à mesure que le cluster se développe ; consultez la skill de redimensionnement horizontal Cluster prêt pour la production
• Cloud limite un cluster à 1 000 collections. Pour de nombreux locataires, utilisez la skill de multitenancy à la place d'une collection par locataire Multitenancy
• Avant de mettre à niveau la version Qdrant du cluster, suivez la skill de mise à niveau de version
• Lors du retrait d'un utilisateur, révoquez les clés API Database et Cloud Management Keys qu'il a créées : les clés continuent à fonctionner après le départ de leur créateur Retrait d'un utilisateur
• Parcourez la Liste de contrôle de production avant le lancement.

Ce qu'il NE FAUT PAS faire

• Désactiver le mode strict pour laisser passer un filtre non indexé au lieu d'indexer le champ
• Restaurer une sauvegarde dans le cluster en direct sans vous attendre à ce que sa taille et sa version soient restaurées
• Envoyer du texte résident dans l'UE à un modèle d'inférence gratuit, qui s'exécute aux États-Unis
• Retirer un utilisateur sans révoquer les clés API qu'il a créées