13년차의 서버실

서버, 인프라, 홈랩 기술 블로그

[태그:] Qdrant

  • [AI] 벡터 데이터베이스 비교: Qdrant vs ChromaDB 선택 가이드

    [AI] 벡터 데이터베이스 비교: Qdrant vs ChromaDB 선택 가이드

    [AI] 벡터 데이터베이스 비교: Qdrant vs ChromaDB 선택 가이드

    RAG를 붙일 때 많은 분이 처음엔 임베딩 품질이나 프롬프트부터 만지십니다. 그런데 실무에선 장애가 저장소 계층에서 먼저 터지는 경우가 꽤 많더라고요. 벡터 데이터베이스 비교를 대충 하고 들어가면, 나중에 검색 필터가 느려지거나 재기동 뒤 데이터가 비어 보이거나 팀이 늘면서 컬렉션 규칙이 꼬이기 시작합니다.

    이번 글은 기능 목록을 나열하는 비교가 아닙니다. Qdrant와 ChromaDB를 어디서 갈라 써야 덜 갈아엎는지, 그리고 어떤 실수에서 실제 비용이 커지는지를 중심으로 보겠습니다. 하루 만에 PoC를 띄우는 문제와 6개월 뒤 운영팀이 덜 고생하는 구조를 고르는 문제는 꽤 다르거든요.

    벡터 데이터베이스 비교를 위한 Qdrant와 ChromaDB 아키텍처 개요 이미지

    RAG 파이프라인에서 임베딩 생성기, 벡터 저장소, 검색 API가 어떻게 연결되는지 한눈에 보여주는 개요 이미지입니다.

    벡터 데이터베이스 비교에서 왜 Qdrant와 ChromaDB가 자주 같이 언급될까

    둘 다 임베딩을 저장하고 유사한 벡터를 찾는다는 점은 같습니다. 다만 실무에서 중요한 건 저장 방식보다 운영 계약입니다. 같은 검색 저장소라도 애플리케이션이 기대하는 규칙이 다르면, 나중에 갈아타기 비용이 확 커집니다.

    • Qdrant는 서버 중심 구조라 컬렉션, 거리 함수, 필터, 인덱스, 헬스체크 같은 운영 요소가 비교적 명시적입니다.
    • ChromaDB는 개발 속도를 우선하는 경험이 강합니다. 로컬 실험이나 Python 중심 워크플로에 바로 넣기 편합니다.
    • 둘 다 메타데이터를 함께 저장해 RAG에 연결하기 좋지만, 필터를 얼마나 진지하게 다뤄야 하는지에서 체감 차이가 크게 납니다.

    제가 실제로는 이렇게 나눕니다. 한 프로세스가 실험용으로 쓰는가, 여러 서비스가 동시에 접근하는가. 이 질문에 답하면 절반은 이미 정리됩니다.

    이 비교에서 먼저 봐야 할 핵심 포인트

    벡터 DB를 고를 때 성능 숫자부터 찾기 쉬운데, 초기에 더 큰 차이를 만드는 건 아래 네 가지였습니다.

    1. 접근 모델: 같은 프로세스 안에서 쓰는지, HTTP나 gRPC로 외부에서 붙는지
    2. 필터 비중: 유사도 검색만 하는지, tenant/team/date/service 필터가 늘 붙는지
    3. 스키마 통제: 컬렉션 규칙을 코드로 강제하는지, 팀 규약에 맡기는지
    4. 운영 책임: 백업, 재시작, health check, 접근 제어를 누가 챙길지

    이걸 무시하고 간단해 보여서 고르면 나중에 삽질 포인트가 비슷합니다. 검색 품질 문제가 아니라, 저장 규칙과 조회 규칙이 분리되어 있지 않아서 생기는 문제인 경우가 많거든요.

    Qdrant vs ChromaDB, 실무에서 체감되는 차이

    비교 항목 Qdrant ChromaDB
    기본 성격 서버형 벡터 검색 엔진에 가깝습니다. 로컬 개발과 빠른 실험에 강한 벡터 데이터베이스입니다.
    처음 붙이는 속도 컬렉션 규칙을 먼저 생각해야 해서 초반 인지 부하가 있습니다. Python에서 바로 컬렉션 만들고 넣어보기가 쉽습니다.
    멀티앱 접근 여러 서비스가 API로 붙는 구성이 자연스럽습니다. 가능하지만 운영 원칙을 애플리케이션 쪽에서 더 엄격히 잡아야 편합니다.
    필터 중심 검색 payload filter와 payload index 전략을 세우기 좋습니다. where 필터는 편하지만 운영 규칙까지 자동으로 대신해주진 않습니다.
    구성 명시성 거리 함수, 인덱스, 헬스체크, 보안 경계가 비교적 분명합니다. 개발 경험은 가볍지만 구조적 제약은 덜 강합니다.
    어울리는 시점 서비스화가 보이거나 필터가 핵심인 RAG 노트북 실험, 내부 도구 MVP, 데이터 흐름 검증
    피해야 할 경우 오늘 안에 실험값만 확인하면 되는 초경량 테스트 여러 팀이 동시에 붙고 운영 경계가 분명해야 하는 환경

    현업에서 자주 보는 오판도 비슷합니다. ChromaDB를 간단하니 일단 운영까지 가보자로 시작했다가, 나중에 운영 규칙을 보강하느라 구조 비용을 뒤늦게 치르는 경우가 많습니다. 반대로 처음부터 Qdrant를 넣고도 실제로는 단일 Python 작업 하나만 돌리면서 서버 운영 부담만 떠안는 경우도 있고요.

    핵심 개념은 정의보다 실패 모드로 이해하는 편이 빠릅니다

    임베딩 차원은 설정값이 아니라 저장 계약입니다

    초보 때는 임베딩 차원을 모델 속성 정도로 넘기기 쉽습니다. 그런데 운영에서는 거의 스키마 역할을 합니다. 384차원으로 만든 컬렉션에 768차원 질의를 보내면, 그 순간 문제는 검색 품질이 아니라 저장 계약 위반입니다.

    • 컬렉션 생성 시 차원을 고정합니다.
    • 임베딩 모델 교체는 새 컬렉션 생성으로 보는 편이 안전합니다.
    • 질의 임베딩과 적재 임베딩의 생성 경로를 분리해두면 언젠가 꼭 사고가 납니다.

    저는 보통 <code>embedding_model, embedding_dimension, distance_metric를 같은 설정 파일이나 환경 변수 묶음에서 읽게 합니다. 모델만 바꾸고 컬렉션은 그대로 쓰는 실수, 이거 생각보다 자주 나옵니다.

    필터는 부가 기능이 아니라 RAG 품질 제어 장치입니다

    RAG에서 벡터 검색 결과가 이상하다는 말의 절반은 임베딩 성능 문제가 아닙니다. 검색 범위를 제어하지 않은 채 서로 다른 문서군을 한 컬렉션에 섞어 넣은 경우가 많습니다. 예를 들어 운영 런북과 제품 FAQ를 같은 컬렉션에 넣고 service나 source 필터 없이 질의하면, 유사도 상위권에 엉뚱한 문서가 뜨는 게 오히려 자연스럽습니다.

    이럴 때 중요한 건 top-k 숫자를 바꾸는 게 아니라 후보 집합을 먼저 줄이는 것입니다. 이 관점에 익숙해지면 Qdrant의 payload index가 왜 자주 언급되는지 바로 감이 옵니다.

    실전 구현: 같은 데이터를 Qdrant와 ChromaDB에 넣어보면

    여기서는 4차원 더미 벡터를 쓰겠습니다. 숫자는 단순하지만 컬렉션 정의 방식과 필터 흐름 차이는 그대로 드러납니다. 실제 프로젝트에선 여기에 임베딩 모델과 청킹 전략만 얹으면 됩니다. RAG 청킹 전략이나 LLM 임베딩 선택 글과 함께 보면 더 입체적으로 보이실 거예요.

    1. Docker로 두 저장소를 분리해서 띄우기

    이 단계부터 운영 감각이 드러납니다. 테스트라도 데이터 디렉터리와 헬스체크를 분리해서 보는 편이 좋습니다. 나중에 검색이 이상할 때 애플리케이션 오류인지 저장소 상태 문제인지 빨리 분리할 수 있거든요.

    services:
      qdrant:
        image: qdrant/qdrant
        container_name: qdrant
        ports:
          - "6333:6333"
          - "6334:6334"
        volumes:
          - ./qdrant_storage:/qdrant/storage
        healthcheck:
          test: ["CMD", "curl", "-f", "http://localhost:6333/healthz"]
          interval: 30s
          timeout: 10s
          retries: 3
    
      chroma:
        image: chromadb/chroma:1.5.9
        container_name: chroma
        environment:
          - IS_PERSISTENT=TRUE
        ports:
          - "8000:8000"
        volumes:
          - ./chroma_data:/data
        healthcheck:
          test: ["CMD", "curl", "-f", "http://localhost:8000/api/v2/heartbeat"]
          interval: 30s
          timeout: 10s
          retries: 3

    올릴 때는 이렇게 확인하시면 됩니다.

    docker compose up -d
    
    docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
    curl -f http://localhost:6333/healthz
    curl -f http://localhost:8000/api/v2/heartbeat

    여기서 제가 보는 포인트는 세 가지입니다.

    • 컨테이너가 Started인지보다 health check 통과 여부를 먼저 봅니다.
    • Qdrant는 6333이 REST, 6334가 gRPC라서 클라이언트 종류에 따라 포트를 명확히 나눠야 합니다.
    • ChromaDB는 Docker에서 /data 볼륨만 마운트한다고 끝이 아닙니다. 영속 모드 설정까지 확인해야 재기동 후 데이터가 남습니다.
    벡터 데이터베이스 비교 실습을 위한 Qdrant와 ChromaDB 홈랩 구성 이미지

    개발 PC 또는 홈랩 서버에서 두 컨테이너가 각각 다른 포트와 볼륨을 사용하는 모습을 보여주는 구성 이미지입니다.

    2. Qdrant는 컬렉션 규칙을 먼저 명시하는 편이 낫습니다

    Qdrant의 장점은 처음부터 규칙을 분명히 적게 만든다는 점입니다. 초반엔 조금 번거롭지만, 나중에 누가 봐도 이 컬렉션이 어떤 가정 위에 만들어졌는지가 남습니다. 운영 단계에 들어가면 이 차이가 꽤 크게 느껴집니다.

    from qdrant_client import QdrantClient, models
    
    client = QdrantClient(url="http://localhost:6333")
    
    client.create_collection(
        collection_name="docs",
        vectors_config=models.VectorParams(
            size=4,
            distance=models.Distance.COSINE,
        ),
    )
    
    client.create_payload_index(
        collection_name="docs",
        field_name="service",
        field_schema=models.PayloadSchemaType.KEYWORD,
    )
    
    client.upsert(
        collection_name="docs",
        wait=True,
        points=[
            models.PointStruct(
                id=1,
                vector=[0.12, 0.45, 0.33, 0.91],
                payload={"source": "runbook", "service": "nginx", "env": "prod"},
            ),
            models.PointStruct(
                id=2,
                vector=[0.10, 0.40, 0.30, 0.88],
                payload={"source": "wiki", "service": "kubernetes", "env": "dev"},
            ),
        ],
    )
    
    result = client.query_points(
        collection_name="docs",
        query=[0.11, 0.44, 0.31, 0.90],
        query_filter=models.Filter(
            must=[
                models.FieldCondition(
                    key="service",
                    match=models.MatchValue(value="nginx"),
                )
            ]
        ),
        with_payload=True,
        limit=2,
    )
    
    for point in result.points:
        print(point.id, point.score, point.payload)

    여기서 중요한 건 검색 API 호출 자체보다, 필터에 자주 쓸 필드를 별도로 인덱싱하는 사고방식입니다. Qdrant는 이 지점이 분명해서 service나 env 같은 운영 규칙을 코드로 남기기 좋습니다.

    3. ChromaDB는 시작 속도가 정말 빠릅니다

    ChromaDB의 강점은 여기서 딱 드러납니다. 코드가 가볍고 Python 워크플로 안에 자연스럽게 들어옵니다. 노트북에서 문서 검색 아이디어를 검증할 때는 이거 진짜 편하더라고요.

    다만 Docker로 서버를 띄웠다면 클라이언트도 그에 맞게 HttpClient로 붙이는 게 맞습니다. 로컬 디스크를 직접 쓰는 PersistentClient 예제와 서버 모드 예제를 섞으면 저장 위치를 헷갈리기 쉽습니다.

    import chromadb
    
    client = chromadb.HttpClient(host="localhost", port=8000)
    collection = client.get_or_create_collection(name="docs")
    
    collection.upsert(
        ids=["1", "2"],
        embeddings=[
            [0.12, 0.45, 0.33, 0.91],
            [0.10, 0.40, 0.30, 0.88],
        ],
        metadatas=[
            {"source": "runbook", "service": "nginx", "env": "prod"},
            {"source": "wiki", "service": "kubernetes", "env": "dev"},
        ],
        documents=[
            "Nginx timeout troubleshooting guide",
            "Kubernetes deployment checklist",
        ],
    )
    
    results = collection.query(
        query_embeddings=[[0.11, 0.44, 0.31, 0.90]],
        n_results=2,
        where={"service": "nginx"},
        include=["documents", "metadatas", "distances"],
    )
    
    print(results)

    제가 계속 강조하는 건 하나입니다. 개발이 쉽다는 것과 운영 계약이 강하다는 것은 다르다는 점입니다. ChromaDB는 빠르게 붙일 수 있지만, 팀이 커질수록 어떤 metadata를 반드시 넣어야 하는지, 컬렉션 이름 규칙은 뭔지, 서버 모드 접속은 어디까지 허용할지 같은 규칙을 애플리케이션 계층에서 더 엄격히 정해야 편해집니다.

    4. Qdrant는 필터가 늘어날수록 차이가 커집니다

    RAG를 운영하다 보면 질문 자체보다 조회 범위 제약이 더 중요해지는 순간이 옵니다. 예를 들어 테넌트별 격리, 운영/개발 문서 분리, 날짜 기반 문서 제한이 붙기 시작하면 벡터만 가까우면 된다는 가정이 금방 무너집니다.

    curl -X PUT 'http://localhost:6333/collections/docs' \
      -H 'Content-Type: application/json' \
      --data '{
        "vectors": {
          "size": 4,
          "distance": "Cosine"
        }
      }'
    
    curl -X PUT 'http://localhost:6333/collections/docs/index?wait=true' \
      -H 'Content-Type: application/json' \
      --data '{
        "field_name": "service",
        "field_schema": "keyword"
      }'
    
    curl -X POST 'http://localhost:6333/collections/docs/points/query' \
      -H 'Content-Type: application/json' \
      --data '{
        "query": [0.11, 0.44, 0.31, 0.90],
        "filter": {
          "must": [
            {
              "key": "service",
              "match": {"value": "nginx"}
            }
          ]
        },
        "with_payload": true,
        "limit": 2
      }'

    실무적으로는 이 차이가 꽤 큽니다. 단순 유사도 검색만 할 때는 둘 다 큰 불편 없이 갈 수 있지만, 필터가 검색 품질의 일부가 되는 순간 Qdrant 쪽이 구조를 유지하기 더 쉽습니다.

    Qdrant와 ChromaDB의 벡터 데이터베이스 비교 흐름도 이미지

    필터 조건이 붙은 검색 요청이 각각 어떤 경로로 처리되는지 비교하는 다이어그램입니다.

    성능보다 먼저 봐야 하는 결정 포인트

    판단 질문 Qdrant 쪽으로 기울 때 ChromaDB 쪽으로 기울 때
    누가 붙나요? 여러 앱, 여러 컨테이너, 별도 API 서버 Python 작업 하나, 내부 분석 스크립트, 개인 실험
    필터가 중요한가요? tenant, service, env, date 같은 조건이 자주 붙음 대부분 의미 기반 검색만 하고 필터는 단순함
    데이터 계약을 강하게 가져갈 건가요? 컬렉션 규칙과 인덱스 전략을 문서화하고 유지해야 함 빠르게 만들고 버려도 되는 실험 비중이 큼
    운영 장애를 누가 받나요? 서비스 운영팀, SRE, 플랫폼 팀이 관여함 개발자 본인이 로컬 혹은 소규모 앱을 직접 돌림
    마이그레이션 비용을 감수할 수 있나요? 초기부터 안정된 구조가 필요함 일단 검증 후 나중에 옮겨도 괜찮음

    추천하는 사고방식은 단순합니다. 지금 필요한 단순함과 나중에 치를 복잡도를 따로 계산하셔야 합니다. ChromaDB는 지금 당장 단순하고, Qdrant는 나중 복잡도를 미리 줄여줍니다.

    흔한 실패 모드와 근본 원인

    1. 임베딩 차원 불일치

    이건 단순 실수라기보다 설정 분리의 결과입니다. 문서 적재 코드와 질의 코드가 서로 다른 임베딩 모델 설정을 읽고 있으면 언젠가 반드시 터집니다. 특히 배치 적재 스크립트와 API 서버가 따로 배포될 때 자주 나옵니다.

    근본 원인은 하나입니다. 임베딩 모델 계약이 코드 여러 군데에 흩어져 있는 것입니다.

    1. 컬렉션 생성 시 차원과 거리 함수를 명시합니다.
    2. 애플리케이션 시작 시점에 임베딩 차원 검증을 넣습니다.
    3. 모델 교체는 기존 컬렉션 수정이 아니라 새 컬렉션 생성과 재색인으로 처리합니다.

    2. 컨테이너는 멀쩡한데 데이터가 안 남습니다

    이건 벡터 DB 문제처럼 보이지만, 실제로는 저장 경로나 영속 모드 설정 문제인 경우가 많습니다. 특히 팀원이 HttpClient 기반 서버 모드와 PersistentClient 기반 로컬 모드를 섞어 쓰면 어제 넣은 데이터가 왜 오늘 안 보이지 하는 상황이 바로 생깁니다.

    근본 원인은 저장 위치와 실행 모드가 실행 방식마다 다르다는 사실을 팀이 공유하지 않는 것입니다.

    docker inspect qdrant --format '{{json .Mounts}}'
    docker inspect chroma --format '{{json .Mounts}}'
    docker logs qdrant --tail 100
    docker logs chroma --tail 100

    이때 제가 보는 기준은 아래 세 가지입니다.

    • Mounts에 기대한 호스트 경로가 잡혀 있는지
    • 컨테이너 내부 경로가 Qdrant는 /qdrant/storage, Chroma는 /data로 맞는지
    • Chroma 서버가 영속 모드로 떠 있는지, 재기동 후 같은 디렉터리의 데이터가 유지되는지

    3. 필터가 없어서 검색 품질이 망가집니다

    운영 가이드를 예로 들어보겠습니다. service=nginx인 문서와 service=kubernetes인 문서를 한 컬렉션에 넣고, 사용자가 배포 후 응답 지연이라고 묻는 상황을 떠올려보세요. 메타데이터 필터가 없으면 벡터 상으로 비슷한 쿠버네티스 배포 체크리스트가 먼저 튈 수 있습니다. 이건 DB가 잘못한 게 아니라 검색 범위를 제어하지 않은 겁니다.

    근본 원인은 벡터 검색을 전체 문서군에 대한 만능 검색으로 오해하는 것입니다.

    • 출처가 다르면 source를 반드시 넣습니다.
    • 서비스 경계가 있으면 service나 tenant를 필수 메타데이터로 강제합니다.
    • 질문이 특정 문서군 전용이면 유사도 검색 전에 필터로 후보군을 줄입니다.

    4. 느린 건 벡터 연산보다 필터 설계인 경우가 많습니다

    특히 Qdrant에서는 필터에 자주 쓰는 payload field를 인덱싱하지 않은 채 왜 검색이 무겁지로 가는 경우가 꽤 많습니다. 반대로 모든 필드를 무작정 인덱싱하는 것도 메모리와 디스크 비용을 늘립니다. 결국 핵심은 많이 쓰는 필드가 아니라 결과 집합을 가장 강하게 줄이는 필드를 먼저 고르는 것입니다.

    예를 들어 color처럼 값 종류가 몇 개 안 되는 필드보다, tenant_id나 document_type처럼 검색 공간을 크게 좁히는 필드가 인덱스 우선순위가 높습니다. 이건 문서만 읽을 때보다 운영에 들어가면 더 강하게 체감됩니다.

    검증: 무엇을 보면 잘 붙었다고 판단할까

    저는 벡터 저장소를 붙이고 나면 벤치마크보다 먼저 아래 네 단계를 확인합니다. 이걸 통과하지 못하면 성능 수치는 큰 의미가 없습니다.

    1. 재조회 가능성: 넣은 id나 문서가 같은 컬렉션에서 다시 조회되는지
    2. 필터 정확성: service=nginx 같은 조건이 틀리지 않고 적용되는지
    3. 재기동 내구성: 컨테이너 재시작 후 데이터가 그대로 남는지
    4. 질의 일관성: 비슷한 표현을 바꿔도 같은 문서군이 안정적으로 상위에 오는지

    여기서 작은 재현 시나리오 하나를 권합니다. 운영 런북 5개, 개발 위키 5개를 넣고 아래처럼 질의를 세 번 바꿔보세요.

    • nginx timeout 원인
    • reverse proxy 지연
    • 응답이 늦을 때 점검 순서

    세 질의 모두 nginx 런북 군집 안에서 놀아야 정상입니다. 결과가 매번 다른 문서군으로 튄다면 저장소 자체보다도 청킹, 메타데이터 설계, 필터 적용 순서를 먼저 의심하셔야 합니다.

    벡터 데이터베이스 비교 검증을 위한 검색 결과 대시보드 이미지

    질의별 상위 결과, score, source/service 메타데이터를 함께 검토하는 검증 화면을 묘사한 이미지입니다.

    언제 Qdrant를 고르고, 언제 ChromaDB를 고를까

    여기서는 애매하게 말하지 않겠습니다.

    • Qdrant를 고르세요: 여러 애플리케이션이 같은 저장소를 공유한다, 메타데이터 필터가 검색 품질의 핵심이다, 운영 환경에서 health check와 접근 경계를 분명히 해야 한다, 컬렉션 규칙을 코드와 설정으로 남기고 싶다.
    • ChromaDB를 고르세요: Python 중심으로 빠르게 검증해야 한다, 혼자 혹은 작은 팀이 로컬/내부 도구를 먼저 만들어야 한다, 구조보다 속도가 우선이다, 나중에 서버형 구조로 옮길 가능성을 감수할 수 있다.

    현실적인 흐름도 있습니다.

    1. 아이디어 검증은 ChromaDB로 짧게 가져갑니다.
    2. 필터와 멀티서비스 요구가 보이면 Qdrant 이전 비용을 계산합니다.
    3. 처음부터 운영형 RAG라면 굳이 돌아가지 말고 바로 Qdrant로 갑니다.

    반대로 말하면 이렇습니다. ChromaDB를 오래 운영하려면 애플리케이션이 질서를 대신 만들어야 하고, Qdrant를 가볍게 쓰려면 서버 운영 부담을 감수해야 합니다. 둘 중 어느 비용을 지금 낼지 정하는 문제입니다.

    자주 묻는 질문

    ChromaDB도 서버처럼 쓸 수 있나요?

    가능합니다. 공식 문서 기준으로 Docker 컨테이너와 HttpClient 조합이 지원됩니다. 다만 서버 모드로 가는 순간부터는 편한 로컬 도구가 아니라 운영 대상이 되니, 접근 제어와 저장 경로, 영속 모드까지 같이 챙기셔야 합니다.

    Qdrant는 너무 무거운 선택 아닌가요?

    단일 프로세스 실험만 할 거라면 과할 수 있습니다. 하지만 필터가 중요한 RAG, 여러 서비스가 붙는 구조, 운영팀이 관여하는 환경에서는 초반에 규칙을 명시해두는 편이 오히려 나중 비용을 줄여줍니다.

    둘 다 알아야 하나요?

    짧게라도 둘 다 만져보시는 편이 좋습니다. 같은 데이터셋으로 두 저장소를 각각 붙여보면 내 프로젝트가 진짜 원하는 게 개발 속도인지, 운영 계약인지 감이 꽤 빨리 옵니다.

    벡터 데이터베이스 비교와 선택 기준을 정리한 Qdrant 대 ChromaDB 인포그래픽

    프로토타입, 사내 도구, 운영 서비스, 복잡한 필터링 등 상황별 추천 선택지를 요약한 이미지입니다.

    마무리

    벡터 데이터베이스 비교에서 중요한 건 누가 더 유명한지가 아니라, 내 검색 시스템이 어디서 깨질 가능성이 높은가입니다. 혼자 빠르게 RAG를 검증하는 단계라면 ChromaDB가 훨씬 민첩합니다. 반대로 필터와 운영이 본격적으로 중요해지는 순간부터는 Qdrant가 구조를 잡기 수월합니다.

    제 판단을 한 줄로 압축하면 이렇습니다. 오늘 바로 실험해야 하면 ChromaDB, 내일 운영팀이 붙을 게 보이면 Qdrant. 이 기준으로 가시면 초반 속도와 이후 유지비 사이에서 덜 후회할 가능성이 큽니다.

  • [AI] 벡터 DB Qdrant vs Chroma: 1년 사용 후기 및 마이그레이션 고려사항

    [AI] 벡터 DB Qdrant vs Chroma: 1년 사용 후기 및 마이그레이션 고려사항

    [AI] 벡터 DB Qdrant vs Chroma: 1년 사용 후기 및 마이그레이션 고려사항

    벡터 DB 비교를 진지하게 해야 하는 시점이 생각보다 빨리 오더라고요. 처음엔 RAG(Retrieval-Augmented Generation, 검색 증강 생성) PoC(개념 검증)만 돌리면 끝날 줄 알았는데, 문서 수가 늘고 메타데이터 필터가 복잡해지고 운영 환경이 붙기 시작하면 이야기가 달라집니다. 저도 홈랩과 업무성 PoC에서 Qdrant와 Chroma를 번갈아 써보면서, “둘 다 벡터 데이터베이스인데 왜 이렇게 운영 감각이 다르지?” 싶었던 순간이 꽤 많았습니다. 특히 1년 정도 굴려보니 단순 기능 비교보다, 마이그레이션과 운영 난이도에서 체감 차이가 더 크게 오더라고요.

    이번 글은 Qdrant, Chroma를 실제 운영 관점에서 어떻게 봐야 하는지 정리한 글입니다. 성능 수치 뻥튀기나 벤치마크 놀이는 일부러 뺐습니다. 대신 어떤 팀에 어떤 선택이 맞는지, 그리고 나중에 옮길 때 어디서 삽질하기 쉬운지 중심으로 적어보겠습니다. 혹시 지금 “일단 Chroma로 시작하고 나중에 Qdrant로 옮기면 되겠지” 혹은 반대로 “Qdrant가 더 본격적이니 무조건 그게 답 아닌가?” 고민하고 계시면 꽤 현실적인 판단 기준이 되실 겁니다.

    벡터 DB 비교를 위한 Qdrant와 Chroma 아키텍처 개요 이미지

    Qdrant와 Chroma가 애플리케이션, 임베딩 모델, 메타데이터 필터, 저장소 계층에서 어떻게 연결되는지 한눈에 보여주는 개요도입니다.

    1. 벡터 데이터베이스, 쉽게 말해 뭐가 다른 걸까요?

    쉽게 말해 벡터 데이터베이스(Vector Database, 벡터 유사도 검색용 저장소)는 텍스트나 이미지에서 뽑아낸 임베딩(Embedding, 의미를 숫자 배열로 바꾼 값)을 저장하고, 비슷한 의미를 가진 데이터를 빠르게 찾는 데 특화된 저장소입니다. 일반 RDBMS(관계형 데이터베이스)로도 못 하는 건 아니지만, 문서 수가 늘어나고 의미 기반 검색이 들어가면 관리 포인트가 확 늘어납니다.

    근데 여기서 중요한 포인트가 있습니다. 벡터 검색만 되면 끝이 아니거든요. 실제 서비스에서는 메타데이터 필터링, 컬렉션 설계, 백업, 복구, 멀티테넌시(Multitenancy, 여러 고객/조직을 분리 운영하는 구조), 클라이언트 연결 방식까지 같이 봐야 합니다. 제가 처음엔 이걸 가볍게 봤다가 나중에 마이그레이션에서 삽질 좀 했습니다 ㅎㅎ

    Qdrant와 Chroma의 결 차이

    항목 Qdrant Chroma
    기본 인상 운영형 벡터 데이터베이스에 가깝습니다 개발 친화적인 검색 스토어 느낌이 강합니다
    실행 방식 독립 서비스로 띄워서 REST/gRPC로 붙는 흐름이 자연스럽습니다 인메모리, PersistentClient, HTTP 서버 모드까지 시작 진입장벽이 낮습니다
    필터링 payload 기반 필터가 강력하고 인덱스 전략까지 같이 봅니다 metadata filtering 문법이 직관적이라 빠르게 붙이기 좋습니다
    운영 기능 snapshot, migration tool, quantization, multitenancy 같은 운영 기능이 잘 보입니다 빠른 로컬 실험과 애플리케이션 내장형 흐름이 편합니다
    확장 관점 서비스화할수록 장점이 커집니다 작게 시작할 때 속도가 좋습니다
    마이그레이션 포인트 컬렉션 설정과 필터 인덱스를 미리 설계하면 안정적입니다 버전별 동작 차이와 저장 방식 변화 체크가 중요합니다

    제 경험상 정리하면 이렇습니다. Chroma는 시작이 빠르고, Qdrant는 운영이 길어질수록 편해집니다. 물론 예외는 있습니다. 데이터가 작고 단일 앱 내부에서만 쓰는 경우엔 Chroma가 정말 편합니다. 반대로 여러 워커가 붙고 백업과 복구를 신경 써야 하면 Qdrant 쪽이 마음이 놓이더라고요.

    2. Qdrant vs Chroma를 나눠보는 기준

    벡터 DB 비교를 할 때 제가 실제로 보는 기준은 딱 다섯 가지입니다.

    • 데이터 영속성(Persistence, 디스크에 안전하게 남는가)
    • 필터링 모델(메타데이터 검색이 얼마나 자연스러운가)
    • 운영 기능(백업, 복구, 재배치, 멀티테넌시)
    • 클라이언트 연결 방식(앱 안에서 바로 쓰는지, 서버를 두는지)
    • 마이그레이션 비용(나중에 옮길 때 고생하는 포인트가 뭔지)

    Qdrant는 컬렉션(Collection, 벡터를 담는 논리 단위)과 포인트(Point, 벡터+메타데이터 단위) 개념이 비교적 명확하고, payload(페이로드, 메타데이터) 필터를 중심으로 운영 설계를 하게 됩니다. 문서상으로도 필터링, 하이브리드 쿼리(Hybrid Queries, 벡터 검색과 다른 검색 조건 결합), 스냅샷, 데이터 마이그레이션이 잘 드러납니다. 반면 Chroma는 클라이언트 관점이 더 앞에 나옵니다. `Client()`, `PersistentClient()`, `HttpClient()` 흐름이 명확해서 개발자가 바로 붙이기 편합니다.

    이 차이가 실제론 꽤 큽니다. 개발 초기엔 Chroma가 “드디어 됐다!” 싶은 속도를 주고, 운영 단계에선 Qdrant가 “이거 복구 시나리오까지 생각해놨네” 하는 안정감을 줍니다.

    3. 실전 구현: 둘 다 같은 조건으로 빠르게 띄워보기

    말로만 비교하면 감이 잘 안 오니까, 가장 단순한 방식으로 둘 다 띄워보겠습니다. 제가 실험할 때도 항상 같은 문서 샘플, 같은 메타데이터 구조로 먼저 맞춰봅니다. 그래야 나중에 마이그레이션 판단이 쉬워지거든요.

    3-1. Qdrant 실행

    docker pull qdrant/qdrant
    
    docker run -p 6333:6333 -p 6334:6334 \
      -v "$(pwd)/qdrant_storage:/qdrant/storage:z" \
      qdrant/qdrant

    Qdrant는 이렇게 독립 서비스로 띄우는 흐름이 자연스럽습니다. REST API는 `6333`, gRPC는 `6334`를 기본으로 씁니다. 운영 생각이 조금이라도 있으면 저는 처음부터 볼륨 마운트를 잡아둡니다. 안 그러면 테스트는 쉬운데 나중에 데이터 보존 흐름이 꼬이더라고요.

    3-2. Chroma 실행

    docker pull chromadb/chroma
    
    docker run -p 8000:8000 chromadb/chroma

    Chroma는 서버 모드도 가능하지만, 로컬 실험에서는 Python `Client()`나 `PersistentClient()`로 바로 붙는 맛이 좋습니다. 빠르게 아이디어 검증할 때 이 장점이 꽤 큽니다.

    3-3. Docker Compose로 같이 올리기

    services:
      qdrant:
        image: qdrant/qdrant
        ports:
          - "6333:6333"
          - "6334:6334"
        volumes:
          - ./qdrant_storage:/qdrant/storage
    
      chroma:
        image: chromadb/chroma
        ports:
          - "8000:8000"

    처음엔 각각 따로 띄웠었는데, 나중엔 결국 이렇게 같이 올려놓고 같은 데이터셋으로 비교하게 되더라고요. 벡터 DB 비교는 이 습관이 정말 중요합니다.

    로컬 홈랩 환경에서 Qdrant와 Chroma를 나란히 띄우고 같은 샘플 데이터를 넣는 실습 구성을 표현한 이미지입니다.

    4. 같은 데이터를 넣어보면 차이가 더 선명합니다

    아래 예시는 기능을 뽐내기보다는, 실제 마이그레이션 전 체크해야 하는 최소 단위를 보여주기 위한 코드입니다. 핵심은 문서, ID, 메타데이터 키 구조를 처음부터 고정하는 겁니다.

    4-1. Chroma 예시

    import chromadb
    
    client = chromadb.PersistentClient(path="./chroma_data")
    collection = client.get_or_create_collection(name="docs")
    
    collection.add(
        ids=["doc-1", "doc-2"],
        documents=[
            "nginx ingress timeout troubleshooting",
            "qdrant payload filtering notes"
        ],
        metadatas=[
            {"service": "ingress", "env": "lab"},
            {"service": "vector-db", "env": "lab"}
        ]
    )
    
    result = collection.query(
        query_texts=["vector database filter"],
        n_results=2,
        where={"env": "lab"}
    )
    
    print(result)

    Chroma는 여기까지 오는 속도가 정말 빠릅니다. `PersistentClient`만 써도 디스크에 저장되고, 메타데이터 필터 문법도 직관적입니다. 제가 처음 RAG 프로토타입 만들 때는 솔직히 이 편의성이 꽤 크게 느껴졌습니다.

    4-2. Qdrant 예시

    from qdrant_client import QdrantClient
    from qdrant_client.models import Distance, VectorParams
    
    client = QdrantClient(url="http://localhost:6333")
    
    client.create_collection(
        collection_name="docs",
        vectors_config=VectorParams(size=4, distance=Distance.COSINE)
    )
    curl -X PUT http://localhost:6333/collections/docs/points \
      -H 'Content-Type: application/json' \
      -d '{
        "points": [
          {
            "id": 1,
            "vector": [0.05, 0.61, 0.76, 0.74],
            "payload": {"service": "ingress", "env": "lab"}
          },
          {
            "id": 2,
            "vector": [0.19, 0.81, 0.75, 0.11],
            "payload": {"service": "vector-db", "env": "lab"}
          }
        ]
      }'

    Qdrant는 시작이 조금 더 “DB를 세팅한다”는 느낌입니다. 대신 구조가 또렷합니다. payload 필터, 컬렉션 설정, 나중에 붙일 인덱스 전략까지 그림이 잘 나옵니다. 실제로 써보니까 검색 품질보다도 운영 설계를 앞당겨 생각하게 만드는 쪽은 Qdrant였습니다.

    4-3. 필터링 관점 차이

    Chroma는 `where` 문법이 친숙하고, OR 조건이나 배열 포함 조건도 비교적 읽기 쉽습니다. Qdrant는 `must`, `should`, `match`, `range` 중심의 필터 모델이라 처음엔 약간 더 장비 만지는 느낌이 납니다. 근데 조건이 복잡해질수록 저는 Qdrant 쪽이 더 예측 가능하더라고요.

    특히 Qdrant는 필터링 성능을 위해 payload index를 고려하라는 흐름이 명확합니다. 이건 운영 단계에서 꽤 중요합니다. 개발할 땐 그냥 되면 됐지 싶었는데, 데이터가 쌓이면 이 차이가 바로 체감됩니다.

    5. 마이그레이션 고려사항: 여기서 진짜 차이가 납니다

    이 섹션이 사실 핵심입니다. 벡터 데이터베이스를 바꾼다는 건 단순 dump/import가 아니더라고요. 임베딩 모델, ID 체계, 메타데이터 스키마, 필터 문법, 컬렉션 설정이 다 얽혀 있습니다.

    1. 임베딩 차원 수를 먼저 확인하세요. Qdrant는 컬렉션 생성 시 벡터 크기를 정하게 되고, 다른 차원의 임베딩을 넣으면 바로 문제가 납니다. 마이그레이션 전에 현재 임베딩 모델의 차원 수를 먼저 고정해두는 게 좋습니다.
    2. ID 전략을 통일하세요. 숫자 ID인지 문자열 ID인지, 외부 문서 ID를 그대로 쓸지 내부 생성 ID를 쓸지 먼저 정해야 합니다. 나중에 재색인(reindex)할 때 이게 꼬이면 검증이 매우 힘들어집니다.
    3. 메타데이터 키를 평평하게 유지하세요. `service`, `env`, `owner`, `source`처럼 자주 쓰는 키를 정규화해두면 Chroma에서 Qdrant로 옮길 때도 덜 아픕니다.
    4. 필터 의미가 같은지 꼭 재검증하세요. 같은 조건처럼 보여도 결과가 미묘하게 다를 수 있습니다. Chroma는 버전 변화로 `where` 동작이 바뀐 항목들이 있었고, Qdrant는 필터 구조가 더 명시적이라 쿼리 변환 시 검증이 필요합니다.
    5. 백업 방식과 이전 방식은 구분해서 보세요. Qdrant는 snapshot 기반 복구가 강하고, 별도 migration tool은 스트리밍 전송과 재개(resume)에 강점이 있습니다. 목적이 같아 보이지만 실제 용도는 꽤 다릅니다.

    여기서 제가 가장 많이 놓쳤던 건 필터 문법보다 필터 의미였습니다. 예를 들어 Chroma 쪽은 버전에 따라 `where`의 일부 연산자 동작이 바뀐 적이 있습니다. 또 오래된 저장 구조를 쓰던 환경에서는 `chroma-migrate`로 데이터 레이아웃을 올려야 하는 케이스도 있었습니다. 예전 방식에서 `duckdb`/`clickhouse` 기반 메타데이터 저장을 쓰다가 `sqlite` 기반으로 넘어가는 변화가 있었기 때문에, 오래된 로컬 데이터면 이 부분을 꼭 체크하셔야 합니다.

    pip install chroma-migrate
    chroma-migrate

    이거 저도 처음엔 “에이, 그냥 패키지 업그레이드면 끝나겠지” 했었는데 아니더라고요. 버전 점프가 큰 환경은 특히 조심하셔야 합니다.

    반대로 Qdrant 쪽은 마이그레이션 관점 문서가 꽤 명확합니다. 같은 클러스터 복구나 로컬 백업이면 snapshot이 맞고, 다른 환경으로 옮기거나 중간에 끊겨도 다시 이어가야 하는 흐름이면 migration tool 쪽이 더 자연스럽습니다. 컬렉션 설정을 바꾸면서 옮길 수 있다는 점도 운영에서는 꽤 실용적입니다.

    6. ⚠️ 실제로 겪었던 문제와 해결법

    6-1. Chroma는 빠른데, 버전 변화 체크를 안 하면 발목을 잡습니다

    Chroma는 진입 속도가 빠른 대신, 오래 유지된 로컬 테스트 환경을 운영 비슷하게 끌고 가면 예상 못 한 차이를 만날 수 있습니다. 예를 들어 `get_or_create_collection`의 동작이나, `where` 관련 연산자의 의미가 버전에 따라 바뀐 부분은 꼭 확인하셔야 합니다. 특히 빈 딕셔너리나 빈 리스트 필터를 관성적으로 넘기던 코드가 나중에 깨질 수 있습니다.

    해결 팁은 간단합니다. 업그레이드 전후로 샘플 질의를 고정해두고, 결과 ID 집합이 같은지 비교하세요. 사람 눈으로 보면 비슷한데 실제 검색 결과가 달라지는 케이스가 있거든요.

    6-2. Qdrant는 필터 인덱스를 늦게 보면 운영 때 아쉽습니다

    Qdrant는 payload 필터를 많이 쓸 예정이라면, 어떤 필드를 자주 거를지 초기에 정하는 게 좋습니다. 저도 처음엔 벡터 검색만 잘 되면 된다고 생각했는데, 실제로는 `env=prod`, `service=api`, `tenant=team-a` 같은 필터가 계속 붙더라고요. 그때서야 필드 전략을 다시 손보면 좀 번거롭습니다.

    해결 팁은 검색 패턴을 먼저 적는 겁니다. 어떤 메타데이터 조합을 가장 자주 쓰는지 적고 시작하면 payload 설계가 훨씬 안정적입니다.

    6-3. 마이그레이션은 데이터보다 검증이 더 오래 걸립니다

    이건 진짜입니다. 데이터 옮기는 명령어 자체보다, 옮긴 뒤에 “제대로 됐는지” 확인하는 시간이 더 깁니다. 총 문서 수, ID 누락, 대표 질의 결과, 메타데이터 필터 결과를 전부 비교해야 하거든요. 처음엔 이게 뭔가 싶었는데, 한 번만 대충 하고 나면 꼭 나중에 후회합니다.

    벡터 DB 비교에서 중요한 마이그레이션 검증 흐름 이미지

    컬렉션 설계, 메타데이터 키 정리, 필터 의미 검증, 백업과 이전 전략 분리를 한 장에 정리한 마이그레이션 흐름도입니다.

    7. 검증과 결과: 어떤 상황에서 무엇이 더 편했나

    제가 실제로 써보니까 결론은 꽤 선명했습니다.

    • 빠른 PoC와 로컬 실험: Chroma가 더 편했습니다
    • 장기 운영과 복구 시나리오: Qdrant가 더 편했습니다
    • 앱 코드 안에서 바로 돌려보기: Chroma가 부담이 적었습니다
    • 서비스로 분리하고 운영 규칙을 붙이기: Qdrant가 잘 맞았습니다

    Chroma는 `PersistentClient` 하나로 시작할 수 있어서 개발 속도가 정말 좋습니다. 문서 몇천 개 수준에서 빠르게 실험하고, 애플리케이션 코드 안에서 검색 레이어를 붙이는 경험은 상당히 부드럽습니다. 반면 Qdrant는 처음부터 서비스 경계가 뚜렷해서, 팀이 붙고 환경이 나뉘고 복구 전략이 필요해질수록 강점이 살아납니다.

    그리고 벡터 DB 비교에서 자주 놓치는 포인트가 하나 더 있습니다. 지금 편한 도구와 나중에 덜 아픈 도구가 다를 수 있다는 겁니다. 이 차이를 미리 받아들이면 선택이 훨씬 쉬워집니다.

    벡터 DB 비교 결과를 보여주는 Qdrant와 Chroma 대시보드 이미지

    문서 수, 필터 사용 빈도, 운영 편의성, 마이그레이션 리스크를 비교하는 대시보드 스타일의 결과 시각화입니다.

    8. 자주 묻는 질문 정리

    Q. Chroma로 시작했다가 나중에 Qdrant로 옮겨도 될까요?

    네, 충분히 가능합니다. 다만 임베딩 차원, ID 체계, 메타데이터 키 구조를 초기에 잘 잡아두셔야 합니다. 이걸 대충 두면 나중에 옮기는 비용이 확 올라갑니다.

    Q. Qdrant가 무조건 더 좋은가요?

    그건 아닙니다. 운영형 요구사항이 아직 없고, 개발 생산성이 더 중요하면 Chroma가 오히려 더 좋은 선택일 수 있습니다. 특히 로컬 실험과 앱 내장형 흐름은 Chroma가 꽤 강합니다.

    Q. 백업은 어떻게 생각하면 좋을까요?

    Qdrant는 snapshot 관점이 분명해서 백업/복구 시나리오를 잡기 좋습니다. Chroma는 사용 모드에 따라 로컬 저장 경로와 업그레이드 절차를 더 꼼꼼히 봐야 합니다.

    Q. 이전 글이나 다음 글과 연결해서 보면 좋은 주제는요?

    이전 글에서 다뤘던 Docker Compose 운영 패턴과 같이 보시면 이해가 빠릅니다. 다음 글에서는 RAG 파이프라인에서 재색인 전략과 임베딩 교체 시 주의점을 따로 다뤄볼 예정입니다.

    PoC, 운영, 백업, 필터링, 마이그레이션 기준으로 Qdrant와 Chroma 선택 포인트를 요약한 인포그래픽입니다.

    9. 마무리: 결국 중요한 건 지금의 편의성과 미래의 운영 비용 균형입니다

    정리해보면 이렇습니다. Chroma는 시작이 빠르고, Qdrant는 운영이 길어질수록 강합니다. 제가 직접 해보니 둘 중 하나가 절대적으로 우월하다기보다는, 팀의 현재 단계가 어디냐에 따라 답이 달라졌습니다. 혼자 혹은 소규모로 빠르게 실험할 때는 Chroma가 진짜 편하더라고요. 반대로 운영 환경 냄새가 나기 시작하면 Qdrant 쪽이 훨씬 안심됐습니다.

    혹시 지금 벡터 DB 비교 때문에 머리가 복잡하시면, 먼저 스스로에게 이렇게 물어보시면 됩니다. “나는 지금 빠르게 검증해야 하나, 아니면 나중에 덜 아파야 하나?” 이 질문에 답이 나오면 선택도 꽤 선명해집니다. 그리고 무엇을 고르든, 메타데이터 스키마와 검증 시나리오부터 잡아두는 것, 이건 진짜 강력 추천드립니다.

    다음 글에서는 Qdrant와 Chroma 위에 RAG 파이프라인을 얹을 때, 재색인 전략과 문서 chunking(청킹, 문서를 작은 단위로 나누는 방식)이 검색 품질에 어떤 차이를 만드는지 이어서 정리해보겠습니다.