GraphDB Generation
2025년 10월 17일· 47 min read
목차
- Graphiti를 위한 JSON 데이터 설계 완벽 가이드
- 목차
- 1. 왜 JSON 구조가 중요한가?
- Graphiti의 작동 원리
- 현실적인 예시
- 2. Graphiti의 데이터 처리 방식 이해하기
- 2.1 엔티티(Entity) 추출
- 2.2 관계(Relationship) 추출
- 2.3 프롬프트에서 확인한 추출 규칙
- 3. 좋은 JSON 설계의 5가지 원칙
- 원칙 1: 명시적 필드 명명 (Explicit Field Naming)
- 원칙 2: 의미 있는 계층 구조 (Meaningful Hierarchy)
- 원칙 3: 관계 지향 설계 (Relationship-Oriented Design)
- 원칙 4: 일관된 데이터 타입 (Consistent Data Types)
- 원칙 5: 풍부한 메타데이터 (Rich Metadata)
- 4. 실전 설계 가이드
- 단계별 JSON 설계 프로세스
- Step 1: 핵심 엔티티 식별
- Step 2: 엔티티 간 관계 정의
- Step 3: JSON 구조 설계
- Step 4: 속성 추가
- 복잡한 관계 표현하기
- 다대다 관계
- 시간적 관계
- 조건부 관계
- 5. 도메인별 설계 패턴
- 5.1 전자상거래 (E-commerce)
- 5.2 대화/채팅 (Conversational)
- 5.3 지식 베이스 (Knowledge Base)
- 5.4 IoT/센서 데이터
- 6. 안티패턴과 해결책
- 안티패턴 1: "Kitchen Sink" (모든 것을 담은 거대한 객체)
- 안티패턴 2: "Cryptic Keys" (암호 같은 키 이름)
- 안티패턴 3: "Stringly Typed" (모두 문자열로 설정)
- 안티패턴 4: "Magic Numbers" (설명 없는 숫자/코드)
- 안티패턴 5: "Sparse Arrays" (희소 배열)
- 안티패턴 6: "Inconsistent Structures" (일관성 없는 구조)
- 7. 품질 검증 체크리스트
- ✅ 구조 (Structure)
- ✅ 명명 (Naming)
- ✅ 엔티티 (Entities)
- ✅ 데이터 타입 (Data Types)
- ✅ 메타데이터 (Metadata)
- ✅ 관계 (Relationships)
- ✅ 실용성 (Practicality)
- 결론
- 핵심 요약