드라이버 추상화
- 다양한 그래프 백엔드에 대한 공통 인터페이스(
execute_query,session,delete_all_indexes등) 제공합니다.
graphiti_core/driver/driver.py(58:90)
class GraphDriver(ABC):
provider: GraphProvider
fulltext_syntax: str = (
'' # Neo4j (default) syntax does not require a prefix for fulltext queries
)
_database: str
@abstractmethod
def execute_query(self, cypher_query_: str, **kwargs: Any) -> Coroutine: ...
@abstractmethod
def session(self, database: str | None = None) -> GraphDriverSession: ...
@abstractmethod
def close(self): ...
@abstractmethod
def delete_all_indexes(self) -> Coroutine: ...
def with_database(self, database: str) -> 'GraphDriver':
cloned = copy.copy(self)
cloned._database = database
return clonedv0.30.x 운영 함정 (Neo4j · FalkorDB)
출처: Graphiti v0.30.0, v0.30.2.
-
Neo4j
execute_queryDB 라우팅 (0.30.0+)- 이전: 세션 쓰기는
driver._database를 따르지만execute_query(검색 포함)는 서버 home DB로 나갈 수 있었음. - 이후: 설정된 DB(기본
neo4j)로 라우팅. 호출별 오버라이드execute_query(..., database_="name"). - 영향 범위: Neo4j Enterprise 멀티-DB에서 home ≠
neo4j이거나 커스텀 DB를 쓰던 셀프호스트. Community/기본neo4j만 쓰면 무동작 변경. - 마이그레이션: 구버전
execute_query로 home에 쌓인 데이터가 있으면 명시적 DB로 이전하거나database=를 홈 이름에 맞춤.
- 이전: 세션 쓰기는
-
FalkorDB fulltext (0.30.2+)
edge_fulltext_search가 히트마다:Entity전체 스캔하던 경로를 제거. 대규모 엣지 풀텍스트 부하 전 ≥0.30.2 권장.
-
멀티
group_id동시성 (0.30.2+)- 요청 스코프 드라이버로 concurrent multi-
group_id격리.group_ids클리어 시 Saga 노드 포함.
- 요청 스코프 드라이버로 concurrent multi-
v0.31.x 드라이버 (2026-10-14···20)
- Neptune fulltext
group필터 (0.31.2+)- fulltext 검색에 group 필터를 적용하고 list 파라미터를 바인딩(#2031). 멀티테넌트 Neptune에서 그룹 미필터 히트를 가정하지 말 것.
- FalkorDB 6.x 노드 fulltext DDL (0.31.0+)
- 노드 fulltext 인덱스를 DDL 형으로 생성(#1963). FalkorDB 6와 구 인덱스 문법을 섞지 말 것.
관련: Graphiti-MCP.md, Graphiti-Overview.md, GraphRAG-vs-LightRAG-2026.md.