ERD란 무엇인가

ERD(Entity Relationship Diagram)는 데이터베이스를 구성하는 테이블, 컬럼, 키, 인덱스, 제약조건, 관계를 시각적으로 정리한 설계도입니다. ERD를 보면 데이터가 어디에 저장되고, 어떤 규칙으로 보호되며, 테이블 사이에서 어떻게 참조되는지 한눈에 검토할 수 있습니다.

논리 모델과 물리 모델

데이터 모델은 보통 두 단계로 나눠 설명합니다. 논리 모델은 업무 용어로 무엇을 저장할지 정리한 것이고, 물리 모델은 그것을 특정 DBMS 의 테이블 · 컬럼 · 타입으로 확정한 것입니다.

NeoSQL 은 모델을 하나만 둡니다

NeoSQL 에는 논리 모델 캔버스와 물리 모델 캔버스가 따로 없습니다. ERD 는 언제나 물리 모델 하나이고, 테이블과 컬럼에 논리명을 메타데이터로 함께 적습니다. 보이는 이름은 우측 정보 패널의 표시 모드로 바꿉니다 — 논리 모드는 논리명을, 물리 모드는 물리명을 노드에 그립니다.

모델을 둘로 나누면 한쪽을 고칠 때마다 다른 쪽을 맞춰야 하고, 그 동기화는 대개 깨진 채로 방치됩니다. 하나의 모델에서 이름만 바꿔 보여 주면 현업 리뷰용 그림과 개발용 그림이 같은 원본에서 나옵니다. 표시 모드는 이미지 내보내기 · 임베드 뷰어 · 공유 스냅샷에도 그대로 적용됩니다.

논리 모드 — 노드에 논리명이 보입니다

물리 모드 — 노드에 물리명이 보입니다

세 가지 사용 방식

같은 ERD 화면을 세 가지 깊이로 쓸 수 있습니다. 아래로 갈수록 손으로 적을 것이 줄고 이름 · 타입 표준이 강해집니다. 깊이는 커넥션 설정에서 올리거나 내릴 수 있고, 바꿀 때 ERD 를 다시 그리지 않습니다.

① 물리 모델만

도메인도 사전도 지정하지 않은 커넥션의 기본 상태입니다. 테이블을 추가하고 컬럼명과 타입을 직접 적습니다. 컬럼 표시 설정에서 Domain 칸은 숨겨지고, 논리명은 적어 둘 수 있지만 물리명을 만들어 주지는 않습니다. 기존 DB 를 Reverse 로 가져와 구조를 확인하거나 문서화하는 작업은 이 상태로 충분합니다.

② 도메인 연결

커넥션 설정의 데이터 사전 탭에서 도메인 자산과 버전을 지정하면 컬럼에 Domain 칸이 생깁니다. "금액" 도메인을 고르면 DECIMAL(15,2) 과 NULL 허용, 기본값이 컬럼에 그대로 써집니다. 도메인 값은 컬럼으로 복사되므로 나중에 자산을 열 수 없는 상태여도 ERD 렌더링과 DDL 생성은 그대로 동작합니다. 도메인이 지배하는 값을 손으로 고치면 그 컬럼의 도메인 지정이 풀립니다.

③ 데이터 사전까지 연결

사전까지 지정하면 논리명이 입력 수단이 됩니다. 컬럼 논리명에 "주문일시" 라고 적으면 사전에 등록된 약어를 이어 붙여 ord_dtm 을 만들고, 끝 단어 "일시" 에 연결된 도메인이 타입과 길이까지 채웁니다. 읽지 못한 구간이나 현재 물리명과의 불일치는 논리명 셀의 검토 필요에 모여 사람이 확인합니다. 테이블 논리명도 같은 방식으로 동작합니다.

NeoSQL이 다루는 범위

NeoSQL의 ERD는 단순한 그림 도구가 아니라, 실제 데이터베이스 스키마와 연결되는 설계·검토·반영 도구입니다. 화면에서 배치한 테이블과 속성은 이후 DDL 생성, Reverse/Forward Engineering, 변경 추적 흐름의 기준이 됩니다.

핵심 포인트

NeoSQL ERD를 이해할 때 먼저 구분해두면 좋은 개념입니다.

화면 주요 영역

NeoSQL ERD 화면은 좌측 탐색 패널, 중앙 캔버스, 도구 모음, 미니맵, 우측 상세 패널로 나뉩니다.

이 가이드에서 다루는 기능

ERD 문서는 화면 조작부터 DB 적용까지 이어지는 작업 흐름을 기준으로 나뉩니다.