콘텐츠로 이동
bluetape4k
Graph 문서0.5
릴리스0.5.1 ↗

Bluetape4k Graph 0.5 매뉴얼

최신 안정판 Graph 0.5.1 릴리스 기준

이 매뉴얼은 커밋 3e0fa7cb9e3bc70c2743aeebda2487f3e45e4907에서 출시한 안정 버전 0.5.1을 설명한다. 공통 모델, 동기·코루틴 API, 지원 백엔드 다섯 개, graph-io, 프레임워크 연동이 범위다. Amazon Neptune은 0.5.1에서 지원하지 않는다. 백로그 이슈도 현재 기능으로 다루지 않는다.

핵심 기능

섹션 제목: “핵심 기능”
  • 백엔드 독립 그래프 모델: 핵심 모델에서 모든 백엔드가 같은 vertex, edge, path, element ID 규칙을 사용합니다.
  • 동기·코루틴 API: 대응 API가 저장소, 순회, 배치, merge, 트랜잭션 연산을 블로킹 실행과 일시 중단 실행에서 같은 구조로 제공합니다.
  • 다섯 가지 데이터베이스 백엔드: 백엔드 선택 가이드에서 Neo4j, Memgraph, Apache AGE, TinkerPop/TinkerGraph, FalkorDB를 쿼리 언어, 트랜잭션 동작, 운영 조건으로 비교합니다.
  • 스키마·순회·트랜잭션: 스키마와 트랜잭션에서 label, index, constraint, merge, path, 소유권 경계를 설명합니다.
  • 그래프 가져오기와 내보내기: graph-io 형식, 실행 모델, OkIO 보안으로 CSV, NDJSON, GraphML, 압축, 인증 암호화를 다룹니다.
  • 애플리케이션 연동과 예제: Spring Boot, Ktor, 학습 경로가 공통 API를 실행 가능한 도메인 예제와 운영 검증으로 연결합니다.

무엇부터 결정할까

섹션 제목: “무엇부터 결정할까”
  1. 시작하기에서 생태계 BOM을 불러오고 첫 연산을 실행한다.
  2. 드라이버를 고르기 전에 백엔드 선택 가이드를 읽는다.
  3. 핵심 모델, 동기·코루틴 API, 트랜잭션 경계를 익힌다.
  4. 학습 경로를 따라가고, 운영 전에 테스트와 운영 가이드를 적용한다.

저장소 학습 지도

API의 중심은 GraphOperations와 GraphSuspendOperations다. 두 API 모두 graph-core의 공통 모델을 반환한다.

매뉴얼 지도

섹션 제목: “매뉴얼 지도”
  • 아키텍처: 저장소 구성, 모델, API 조합, 스키마, merge·batch, 순회, 트랜잭션
  • 백엔드: Neo4j, Memgraph, Apache AGE, TinkerPop/TinkerGraph, FalkorDB
  • graph-io: 파일 경계, 실행 모델, OkIO 압축과 인증 암호화
  • 프레임워크: Ktor 플러그인과 Spring Boot 자동 설정의 생명주기
  • 가이드: 단계별 학습, 테스트, 운영, 취소, benchmark 해석

소비자가 선택할 버전은 개별 graph 라이브러리나 graph BOM 버전이 아니라 bluetape4k-dependencies 버전 하나다. 이 매뉴얼의 의존성 예제는 생태계 BOM을 불러오고 모듈 좌표에는 버전을 쓰지 않는다.

가이드와 핵심 개념

섹션 제목: “가이드와 핵심 개념”

배포 라이브러리

섹션 제목: “배포 라이브러리”

예제

섹션 제목: “예제”

벤치마크

섹션 제목: “벤치마크”