30

Neo4j 환경 설정: Docker & Aura Cloud

Neo4j & Cypher

학습 목표

Neo4j Docker 환경을 설정한다 Neo4j Aura (클라우드) 무료 인스턴스를 생성한다 Neo4j Browser 접속 및 기본 조작법을 익힌다 Python neo4j 드라이버 설치 및 연결을 확인한다

Neo4j 환경 설정

왜 Neo4j인가?

[그래프 데이터베이스 비교]

| DB | 특징 | 적합한 용도 |
|----|------|-----------|
| Neo4j | 가장 성숙, 커뮤니티 최대 | 제조 KG, 추천, 사기 탐지 |
| Amazon Neptune | AWS 통합 | 클라우드 네이티브 |
| TigerGraph | 분산 처리 | 대규모 그래프 분석 |
| ArangoDB | 멀티 모델 | 문서+그래프 혼합 |

→ 제조 KG 실습에는 Neo4j가 가장 적합:
  - Cypher 쿼리가 직관적
  - 시각화 도구 내장
  - Python 연동 간편
  - 무료 커뮤니티 에디션 충분

방법 1: Docker로 설치 (추천)

# Neo4j 컨테이너 실행
docker run \
  --name neo4j-mfg \
  -p 7474:7474 \
  -p 7687:7687 \
  -e NEO4J_AUTH=neo4j/manufacturing2026 \
  -e NEO4J_PLUGINS='["apoc", "graph-data-science"]' \
  -v neo4j_data:/data \
  -v neo4j_logs:/logs \
  -d neo4j:5.15-community

# 확인
docker logs neo4j-mfg
# "Started." 메시지 확인

접속 정보:

항목
Browserhttp://localhost:7474
Boltbolt://localhost:7687
Usernameneo4j
Passwordmanufacturing2026

방법 2: Neo4j Aura (클라우드 무료)

[설정 절차]

1. https://neo4j.com/cloud/aura/ 접속
2. "Start Free" 클릭
3. Google/GitHub 계정으로 가입
4. "Create a Free Instance" 클릭
5. Database name: "mfg-kg"
6. Region: "Asia Pacific (Singapore)" 선택
7. "Create Instance" 클릭
8. ⚠️ 비밀번호 반드시 저장! (한 번만 표시됨)

무료 티어 제한:
- 노드: 200,000개
- 관계: 400,000개
- → 제조 KG 실습에 충분!

Python 드라이버 설치 및 연결

pip install neo4j
from neo4j import GraphDatabase

# Docker 연결
driver = GraphDatabase.driver(
    "bolt://localhost:7687",
    auth=("neo4j", "manufacturing2026")
)

# 연결 확인
with driver.session() as session:
    result = session.run("RETURN 'Hello, Manufacturing KG!' AS message")
    record = result.single()
    print(record["message"])
    # 출력: Hello, Manufacturing KG!

driver.close()

Neo4j Browser 기본 조작

[브라우저 접속 후]

1. 상단 쿼리 입력창에 Cypher 입력
2. 실행: Ctrl+Enter (또는 실행 버튼)
3. 결과 보기: Graph / Table / Text 탭 전환
4. 노드 클릭: 속성 확인, 관계 탐색
5. 더블 클릭: 연결된 노드 확장

유용한 명령어:
:help                     도움말
:server status            서버 상태
:schema                   스키마 확인
CALL db.schema.visualization()  스키마 시각화
AI로 학습하기 — 꿀팁
🤖Neo4j Docker 설정 스크립트 생성AI 학습 팁

AI에게 Neo4j Docker 설정과 초기 데이터 로딩까지 실행 가능한 셸 스크립트를 생성하게 요청하세요.

Neo4j 5.x를 Docker로 실행하고 제조 설비 샘플 데이터(설비 3개, 부품 5개, 고장이력 2건)를 Cypher로 초기 로딩하는 전체 설정 스크립트를 작성해줘. docker-compose.yml + 초기화 Cypher 파일 + 실행 순서를 포함한 README 형식으로 출력해줘.
이 팁이 도움이 됐나요?
핵심 포인트
  • Docker 또는 Neo4j Aura로 환경 설정 가능
  • Bolt 프로토콜(7687)로 애플리케이션 연결, HTTP(7474)로 브라우저 접속
  • Python neo4j 드라이버로 프로그래밍 방식 접근
  • APOC 플러그인은 확장 기능 제공 (나중에 활용)