Qdrant Edge

Qdrant Edge (edge)

벡터 검색을 서버에서만 할 수 있는 건 아니에요. 로봇, 키오스크, 홈 어시스턴트, 모바일처럼 연결이 제한적이거나 간헐적인 환경에서 저지연 벡터 검색이 필요하다면 Qdrant Edge를 살펴보면 좋아요. Qdrant Edge는 프로세스 안에서(in-process) 동작하는 경량 임베디드 벡터 검색 엔진으로, 메모리 사용량이 아주 작고 백그라운드 서비스가 없어요.

출처: Qdrant 공식 문서 — edge

Qdrant Edge란 무엇인가요? (What Is Qdrant Edge?)

Qdrant Server가 클라이언트-서버 아키텍처를 쓰는 것과 달리, Qdrant Edge는 애플리케이션 프로세스 안에서 실행돼요. SQLite를 벡터 검색용으로 만든 것이라고 생각하면 이해가 빨라요. 데이터는 로컬에 저장되고 로컬에서 쿼리되므로, 외부 서버로 데이터를 전송할 필요가 없어서 저지연 접근과 향상된 프라이버시를 얻을 수 있어요.

그렇다고 완전히 고립된 건 아니에요. Qdrant Edge는 데이터를 Qdrant 서버와 동기화하는 API를 제공해요. 이를 통해 인덱싱 같은 무거운 연산을 더 강력한 서버 인스턴스에 오프로드하고, 데이터를 백업·복원하며, 여러 엣지 기기에서 중앙으로 데이터를 모을 수 있어요.

Qdrant Edge Shard

Qdrant Edge는 Edge Shard라는 개념을 중심으로 설계돼요. Edge Shard는 독립적으로 동작할 수 있는 자체 완결형(self-contained) 저장 단위예요. 각 Edge Shard는 벡터와 페이로드 저장을 포함한 자신의 데이터를 관리하고, 로컬 검색·조회 작업을 수행할 수 있어요.

Edge Shard를 다루려면 Python Bindings for Qdrant Edge 패키지나 qdrant-edge Rust 크레이트를 사용하면 돼요. 둘 다 데이터를 관리하고, 쿼리하고, 스냅샷을 복원하는 메서드를 가진 EdgeShard 타입을 제공해요. 사용 가능한 메서드에 대한 자세한 내용은 Edge API 페이지를 참고하세요.

Qdrant Edge 사용하기 (Using Qdrant Edge)

유형 가이드 배우게 될 내용
초급 Qdrant Edge Quickstart Qdrant Edge 시작하기, 데이터 관리와 쿼리의 기초
초급 On-Device Embeddings FastEmbed로 엣지 기기에서 직접 벡터 임베딩 생성
초급 On-Device BM25 키워드 검색용 BM25 희소 임베딩을 기기에서 생성
레퍼런스 Data Synchronization Patterns Edge Shard와 Qdrant 서버 컬렉션 간 데이터 동기화 패턴 개요
고급 Synchronize with a Server Edge Shard를 Qdrant 서버 컬렉션과 동기화해 인덱싱 오프로드 및 기기 간 데이터 동기화
레퍼런스 Edge API Python과 Rust에서 사용 가능한 EdgeShard 메서드와 파라미터·반환값 레퍼런스

더 많은 예시는 Qdrant GitHub 리포지토리에서 Python과 Rust로 작성된 Qdrant Edge API 사용 예제를 확인할 수 있어요.

더 알아보기 (Learn more)