객체 관리 (CRUD)

객체 관리 (CRUD)

데이터를 벡터 DB에 넣고 빼는 일은 어떤 검색 시스템에서든 가장 기본이에요. Weaviate 객체(오브젝트)의 생성·조회·수정·삭제를 다루는 절차를 이 문서에서 정리해요. 객체는 컬렉션 안에 저장되고, 개별 추가부터 배치 임포트·전체 조회·부분 수정까지 다양한 작업을 지원하죠.

출처: Weaviate 공식 문서 - Manage objects

본문

객체는 Weaviate에서 실제로 저장하는 데이터 단위예요. 각 객체는 컬렉션(스키마의 클래스)에 속하고 프로퍼티 값을 가집니다. 객체 작업은 크게 다섯 갈래로 나뉘어요.

  • 생성(Create) — 컬렉션에 객체를 하나씩 추가해요.
  • 배치 임포트(Batch import) — 여러 객체를 한 번에 효율적으로 넣어요.
  • 조회(Read) — ID나 벡터로 특정 객체를 가져와요.
  • 수정(Update) — 기존 객체를 전체 또는 부분 수정해요.
  • 삭제(Delete) — 특정 객체를 컬렉션에서 제거해요.

각 작업은 하위 가이드 문서로 연결되어 있어서, 필요한 단계만 골라서 보면 돼요. 개별 추가·배치 임포트처럼 넣는 방식이 다르고, 조회도 ID 기준과 전체 조회(페이지네이션 포함)가 별도로 나뉘어 있어요. 처음엔 생성부터 시작해서 임포트·조회·수정·삭제 순으로 익히면 자연스러워요.

더 알아보기