Hantera en vektorlagring

Öppna Vektorlagring i sidomenyn och välj vektorlagringen. Dess rubrik visar statusen och, medan den är Running, Starta om och Stoppa; medan den är Stopped, Starta. Flikarna är Översikt, Konfiguration (visas för den som får ändra vektorlagringen), Access Control, Revisioner, Operations, Aktivitet och Riskzon (visas för den som får ta bort den). Ändringar kräver qdrantcluster/write; att rotera API-nyckeln kräver även qdrantcluster/writeSecrets.

Översikten

Körmiljö

Konfiguration → Körmiljö har tre inställningar; välj Spara för att tillämpa dem.

• Version — taggen för avbildningen qdrant/qdrant som servrarna kör, till exempel v1.13.2. Den måste börja med ett versionsnummer (v1.13.2 eller 1.13.2). Plattformen har ingen lista över versioner: välj en tagg bland Qdrants releaser. När du sparar en ny version ersätts servrarna med servrar som kör den.
• Beräkningsplan — ett byte ger varje server planens CPU och minne, och sätter antalet repliker till planens, om du inte ändrar Repliker i samma sparning. Servrarna ersätts för att få de nya resurserna. Lagringsstorleken förblir densamma.
• Repliker — se nedan.

Ändra antalet repliker

Repliker tar 1 till 5. Med CLI:t gör stsh qdrant scale samma sak och kräver qdrantcluster/scale.

• Fler repliker startar fler servrar, som ansluter till klustret tomma. Qdrant flyttar inte befintliga shards till dem; samlingar som skapas därefter sprids över alla servrar. Använd Qdrants kluster-API för att flytta shards om befintliga samlingar ska använda de nya servrarna.
• Färre repliker stoppar servrarna med högst nummer utan att först flytta bort deras shards. En samling med shards på de servrarna och inga kopior på andra håll förlorar åtkomsten till den delen av sin data. Flytta bort shards från de servrarna med Qdrants kluster-API innan du skalar ned.

Hur shards och kopior fungerar förklaras i Repliker och sharding.

Nätverk och API-nyckeln

Konfiguration → Nätverk & säkerhet har tre delar. Välj Spara när du har ändrat något i de två första.

Extern åtkomst

• Aktivera lastbalanserare — ger vektorlagringen en adress utanför Kubernetes-klustret som betjänar REST- (6333) och gRPC-porten (6334), utan TLS. Extern slutpunkt visar http://<address>:6333 när adressen har tilldelats, och Väntar på en lastbalanseraradress… till dess.
• Aktivera HTTPS-ingress — betjänar REST-API:t och instrumentpanelen över HTTPS på ett värdnamn, med ett hanterat certifikat. Värdnamn är värdnamnet som används; lämna det tomt för plattformens värdnamn, och töm ett eget värdnamn för att gå tillbaka till det. Ett eget värdnamn kräver en DNS-post som pekar det mot plattformens ingress.
• Tillåtna CIDR-block — en kommaseparerad lista som 10.0.0.0/16, 203.0.113.0/24. Den begränsar lastbalanseraren till de avsändaradresserna, och även HTTPS-ingressen på installationer vars ingress-kontroller är NGINX. Tom tillåter alla avsändare. Den gäller bara medan lastbalanseraren eller HTTPS-ingressen är på.

Båda reglagen är inaktiverade medan API-nyckelautentisering är av, och plattformen vägrar spara någon av exponeringarna utan den. Att slå på HTTPS-ingressen avvisas också när installationen saknar en certifikatutfärdare för den, eller när Värdnamn är tomt och installationen saknar en Qdrant-domän.

API-nyckelautentisering

Aktivera API-nyckelautentisering avgör om klienter måste skicka API-nyckeln. Att stänga av den avvisas medan lastbalanseraren eller HTTPS-ingressen är på. När den är av kan varje arbetslast som når vektorlagringen läsa, ändra och radera dess data.

Rotera API-nyckeln

API-nyckelrotation, längst ned under Konfiguration → Nätverk & säkerhet, har Rotera API-nyckel medan API-nyckelautentisering är på. Det kräver qdrantcluster/writeSecrets och qdrantcluster/write.

1. Välj Rotera API-nyckel. Den nya nyckeln visas i sektionen; kopiera den. Du kan också visa den senare på Översikt.
2. Plattformen startar om servrarna så att de använder den nya nyckeln. En server godtar den gamla nyckeln tills den har startats om, och en vektorlagring med en replik är otillgänglig medan dess server startas om.
3. Lägg in den nya nyckeln där klienterna förvarar den — för arbetslaster i valvets hemlighet — och starta om de arbetslasterna.

Sektionens egen text säger att rotationen sker utan driftavbrott, att den gamla nyckeln slutar fungera direkt och att den nya nyckeln inte visas igen. Stegen ovan beskriver vad som sker i stället.

Prestandainställningar

Konfiguration → Prestanda visar fält för HNSW-indexet, optimeraren, kvantisering och write-ahead-loggen.

Varning

Fälten tillämpas inte. När du sparar dem rapporteras det som lyckat men ingenting ändras på servrarna, och fälten är tomma igen när du öppnar sektionen på nytt. Ange de här parametrarna per samling med Qdrants API i stället, när du skapar eller uppdaterar samlingen.

Stoppa, starta och starta om

• Stoppa kommer ihåg antalet repliker och stoppar alla servrar. Volymerna och deras data finns kvar; vektorlagringen visas som Stopped och kan inte nås.
• Starta tar tillbaka det ihågkomna antalet servrar, eller en om inget finns att komma ihåg.
• Starta om slutförs utan att någon server ersätts, så den startar inte om vektorlagringen. För att starta om servrarna väljer du Stoppa och sedan Starta.

Säkerhetskopiera en samling

Plattformen sparar inga säkerhetskopior av en vektorlagring. Qdrants API för ögonblicksbilder skapar en fil av en samling som du kan ladda ned och spara:

curl -X POST -H "api-key: $QDRANT_API_KEY" https://<hostname>/collections/<collection>/snapshots
curl -H "api-key: $QDRANT_API_KEY" -o <collection>.snapshot \
  https://<hostname>/collections/<collection>/snapshots/<snapshot-name>

Det första anropet returnerar ögonblicksbildens namn. Ladda ned den direkt: servrarna förvarar ögonblicksbilder på tillfällig lagring som töms när en server startas om. På en vektorlagring med mer än en replik tar Qdrant ögonblicksbilder på varje server för sig, och vektorlagringens slutpunkter låter dig inte välja server, så det här fångar en hel samling bara på en vektorlagring med en replik.

Ta bort en vektorlagring

Välj Ta bort på fliken Riskzon och skriv vektorlagringens namn för att bekräfta. Det kräver qdrantcluster/delete, som ingår i qdrantcluster/write. Servrarna, slutpunkterna och API-nyckeln tas bort.

Viktigt

Servrarnas volymer tas inte bort. De ligger kvar i resursgruppen, med sin data, tills resursgruppen tas bort, och en ny vektorlagring med samma namn i samma resursgrupp tar över dem — datan inräknad.

Med CLI:t

stsh qdrant get my-vectors -g my-resource-group
stsh qdrant update my-vectors -g my-resource-group --set qdrantVersion=v1.14.0
stsh qdrant scale my-vectors -g my-resource-group --replicas 3
stsh qdrant stop my-vectors -g my-resource-group
stsh qdrant start my-vectors -g my-resource-group
stsh qdrant delete my-vectors -g my-resource-group

API-nyckeln roteras via API:t:

stsh api POST /boundaries/<boundary-id>/resourcegroups/<resource-group>/resources/qdrantclusters/<name>/apikey/rotate