Qdrant Cloud 빠른 시작
Qdrant Cloud 빠른 시작 (cloud-quickstart)
Qdrant Cloud를 설정하고 첫 번째 시맨틱 검색을 몇 분 만에 수행하는 방법을 배워볼게요. 여기서는 sentence-transformers/all-MiniLM-L6-v2 모델로 임베딩한 샘플 메뉴 데이터를 Cloud Inference를 통해 사용할 거예요. 이 모델은 Qdrant Cloud에서 무료로 제공되는 임베딩 모델 중 하나예요. 제공되는 무료·유료 모델 목록은 Qdrant Cloud Console의 클러스터 상세 페이지에서 Inference 탭을 보면 확인할 수 있어요.
1. Cloud 클러스터 만들기
- 이메일, Google 또는 Github 자격 증명으로 Cloud 계정에 가입해요.
- Create a Free Cluster에서 클러스터 이름을 입력하고 원하는 클라우드 제공자와 리전을 선택한 뒤 Create Free Cluster를 눌러요.
- 안내가 나오면 API key를 복사해요. 연결할 때 필요하니 안전한 곳에 저장해 두세요. 다시 표시되지 않을 거예요.
클러스터 설정에 대한 자세한 내용은 Cloud 문서를 참고하면 돼요.
2. Qdrant 클라이언트 설치하기
클러스터가 준비되면 가장 빠르게 시작하는 방법은 공식 SDK를 사용하는 거예요. 선호하는 프로그래밍 언어로 Qdrant를 다룰 수 있는 편리한 인터페이스를 제공해 줘요.
pip install qdrant-client # for Python projects
# cargo add qdrant-client # for Rust projects
# npm install @qdrant/js-client-rest # for Node.js projects
# dotnet add package Qdrant.Client # for .NET projects
# go get github.com/qdrant/go-client # for Go projects
3. Qdrant Cloud에 연결하기
qdrant 클라이언트를 import 하고, 클러스터 URL과 API 키를 사용해 Qdrant Cloud 클러스터에 연결해 보세요.
from qdrant_client import QdrantClient
from qdrant_client.models import Distance, VectorParams, PointStruct, Document
# connect to Qdrant Cloud
client = QdrantClient(
url="https://xyz-example.eu-central.aws.cloud.qdrant.io",
api_key="your-api-key",
cloud_inference=True
)
use qdrant_client::{Qdrant, Payload};
use qdrant_client::qdrant::{CreateCollectionBuilder, Distance, VectorParamsBuilder, PointStruct, DocumentBuilder, UpsertPointsBuilder, QueryPointsBuilder, Query};
use serde_json::json;
// connect to Qdrant Cloud
let client = Qdrant::from_url("https://xyz-example.eu-central.aws.cloud.qdrant.io:6334")
.api_key("your-api-key")
.build()?;
import { QdrantClient } from "@qdrant/js-client-rest";
const client = new QdrantClient({
url: "https://xyz-example.eu-central.aws.cloud.qdrant.io",
apiKey: "your-api-key",
});
import static io.qdrant.client.PointIdFactory.id;
import static io.qdrant.client.QueryFactory.nearest;
import static io.qdrant.client.ValueFactory.value;
import static io.qdrant.client.VectorsFactory.vectors;
import io.qdrant.client.QdrantClient;
import io.qdrant.client.QdrantGrpcClient;
import io.qdrant.client.grpc.Points.Document;
import io.qdrant.client.grpc.Points.PointStruct;
import io.qdrant.client.grpc.Points.QueryPoints;
import io.qdrant.client.
출처: Qdrant 공식문서