빠른 시작
회원가입부터 프로젝트 생성까지, NeoSQL을 처음 사용하는 분들을 위한 단계별 가이드입니다.
회원가입
NeoSQL의 모든 기능은 무료 계정으로 바로 시작할 수 있습니다. 이메일·비밀번호 또는 Google, Kakao, GitHub 등 소셜 계정으로 가입할 수 있으며, 회원가입 절차는 모두 웹사이트에서 진행됩니다. 데스크톱 앱에서 "계정 만들기"를 누르면 기본 브라우저로 웹사이트의 회원가입 페이지가 자동으로 열립니다.
가입 페이지 접속
NeoSQL 웹사이트 우측 상단의 "로그인" 버튼을 누른 뒤 화면 하단의 "회원가입" 링크로 이동하거나, 데스크톱 앱의 시작 화면에서 "회원가입"을 선택합니다. 가입 화면에서는 소셜 가입 버튼과 이메일 가입 폼을 자유롭게 전환할 수 있습니다.
가입 방식 선택
두 가지 방식 중 편한 쪽을 선택합니다. 이메일 가입은 이메일 주소와 비밀번호를 직접 입력해 진행하며, 가입 후 메일로 발송되는 인증 링크를 1회 클릭해 본인 확인을 완료해야 합니다. 소셜 가입(Google, Kakao, GitHub 등)은 해당 서비스의 OAuth 인증만 거치면 별도 정보 입력이나 이메일 인증 없이 가입과 로그인이 동시에 처리됩니다.
이메일 인증 (이메일 가입자만 해당)
이메일로 가입한 경우 입력한 주소로 인증 메일이 발송됩니다. 메일의 인증 링크를 누르면 가입이 최종 완료되고 자동으로 가입 완료 페이지가 열립니다. 인증 링크가 만료되었거나 메일이 보이지 않는다면 가입을 진행하던 창으로 돌아가 "인증 메일 다시 보내기" 버튼으로 메일을 재발송할 수 있습니다.
가입 방식별 화면 흐름, 이메일 인증 재발송, 가입 완료 후 동작 등 자세한 안내는 회원가입 가이드 가이드를 참고하세요.
로그인
가입한 계정 정보로 NeoSQL에 로그인합니다. 로그인 절차는 모두 웹사이트에서 진행되며, 데스크톱 앱에서 "브라우저로 로그인"을 누르면 기본 브라우저로 웹사이트의 로그인 페이지가 자동으로 열립니다. 이메일 가입자는 이메일 인증을 마친 뒤 로그인 화면에서 직접 로그인하고, 소셜 가입자는 가입 직후부터 자동 로그인된 상태로 사용할 수 있습니다.
5분 만에 첫 ERD 만들기
회원가입 없이도 갤러리에서 다른 사람이 발행한 ERD를 둘러보며 NeoSQL의 캔버스를 미리 체험할 수 있습니다. 본격적으로 직접 그려보려면 로그인 후 샘플 ERD가 포함된 프로젝트를 만드는 것이 가장 빠른 길입니다.
갤러리에서 샘플 ERD 둘러보기 (로그인 없이)
공개 ERD 갤러리에서 공개된 ERD를 클릭하면 회원가입 없이도 캔버스 뷰어를 열어 테이블·관계·인덱스가 어떻게 표현되는지 확인할 수 있습니다. 마음에 드는 디자인이 있다면 어떤 도메인을 어떤 패턴으로 표현했는지 미리 익혀두세요.
직접 그려보려면 — 샘플 ERD 옵션으로 프로젝트 시작
샘플 ERD 옵션으로 프로젝트를 만들면 빈 캔버스 대신 컬럼 · 키 · 관계 · 그룹이 모두 갖춰진 ERD 가 곧바로 열려, NeoSQL 의 ERD 작성 방식을 가장 빠르게 익힐 수 있습니다. 흐름은 다음과 같습니다.
- 대시보드에서 "새 프로젝트" 를 클릭해 프로젝트 생성 다이얼로그를 엽니다.
- 프로젝트 이름과 사용할 데이터베이스(MariaDB · MySQL · PostgreSQL · Oracle 등)를 선택합니다.
- "샘플 ERD 생성" 옵션을 체크하고 "SAVE" 버튼을 클릭하면 'Organization', 'Sales & Orders', 'Products & Inventory' 세 그룹으로 묶인 샘플 테이블과 그 사이 관계선이 자동으로 그려진 ERD 가 곧바로 열립니다.
샘플 테이블을 클릭해 컬럼 · PK / FK · 관계 패턴이 어떻게 표현되는지 살펴보고 부분적으로 변형해 보세요. 프로젝트 이름 · DBMS · 샘플 옵션 외 추가 설정 항목과 생성 이후의 수정 · 삭제 흐름은 프로젝트 생성/수정/삭제 가이드에서 자세히 다룹니다.
캔버스에서 첫 테이블·컬럼·관계 만들기
다음 흐름으로 5분 안에 첫 ERD를 완성할 수 있습니다.
- 좌측 도구 모음의 "테이블 추가" 아이콘을 클릭하고, 캔버스의 원하는 위치를 클릭하면 그 자리에 새 테이블 노드가 만들어집니다.
- 테이블 노드를 클릭하면 컬럼 그리드가 활성화됩니다. 컬럼 그리드 헤더 가장 오른쪽 끝의 + 아이콘을 누르거나, 그리드에 포커스가 있을 때 Cmd / Ctrl + Enter 단축키로 새 컬럼을 추가하고 이름 · 타입 · PK · N/N 을 입력합니다.
- 다른 테이블과 관계를 맺으려면 도구 모음의 관계선 도구를 사용하거나, 한 테이블의 컬럼을 다른 테이블로 드래그해 FK를 자동 생성합니다.
테이블 노드를 추가하고 컬럼 · 키 · 제약을 편집하는 방법은 테이블 노드 다루기 가이드에서, 캔버스 이동·확대·정렬 등 ERD 화면 전반의 사용법은 캔버스 기본 조작 가이드에서 자세히 다룹니다.
첫 데이터베이스 연결하기 (MySQL/PostgreSQL 예제)
ERD만 그릴 때는 커넥션이 필요 없지만, 기존 데이터베이스의 스키마를 가져오거나(Reverse Engineering) ERD 변경 사항을 실제 DB에 반영하려면(Forward Engineering) 커넥션 설정이 필요합니다.
MySQL · PostgreSQL · Oracle · SQL Server · MariaDB · SQLite · H2 등 지원 DB 별 호스트·포트·계정 정보 입력 방법과 SSH 터널, 사설 모드 설정은 DB 커넥션 만들기 가이드에서 자세히 다룹니다.
첫 SQL 실행 & 결과 살펴보기
커넥션이 연결된 뒤에는 SQL Editor에서 직접 쿼리를 작성하고 결과를 표 형태로 확인할 수 있습니다. NeoSQL은 자동완성, 다중 결과 탭, 쿼리 히스토리, JSON · CSV 내보내기를 기본으로 제공합니다.
SQL Editor 열기, 쿼리 실행 단축키(Cmd/Ctrl + Enter), 결과 그리드 활용, 운영 DB 실수 방지를 위한 위험 SQL 가드 등 사용법은 SQL Editor 시작하기 가이드에서 안내합니다.
첫 테이블을 ERD 로 가져오기 (Reverse Engineering)
이미 운영 중인 데이터베이스가 있다면, 그 스키마를 그대로 ERD로 끌어와서 빠르게 시각화하고 문서화할 수 있습니다. 별도의 "리버스 엔지니어링" 버튼 없이, 사이드바에 표시된 테이블을 ERD 캔버스로 드래그 & 드롭하기만 하면 끝나는 흐름이 NeoSQL의 특징입니다.
커넥션 트리에서 가져올 테이블 탐색
좌측 사이드바에서 연결된 커넥션을 펼치면 스키마 → 테이블 트리가 표시됩니다. 원하는 스키마를 펼쳐 가져올 테이블을 확인하세요. 사이드바 상단의 검색창에 테이블 이름 일부를 입력하면 즉시 필터링되어 빠르게 찾을 수 있습니다.
테이블을 ERD 캔버스로 드래그 & 드롭
테이블을 잡아 캔버스로 끌어다 놓으면 해당 테이블의 컬럼·PK·FK·인덱스·제약조건이 모두 그대로 가져와집니다. 단일 테이블은 그대로 드래그하면 되고, 여러 테이블을 한 번에 가져오려면 사이드바에서 Ctrl(Cmd) + 클릭으로 다중 선택한 뒤 캔버스로 끌어 놓으세요. 함께 가져온 테이블 사이의 FK는 관계선으로 자동 표시됩니다. 드래그가 어렵다면 사이드바에서 테이블을 우클릭하고 "ERD에 추가"를 선택해 현재 뷰포트 중앙에 배치할 수도 있습니다.
필요한 테이블만 선택적으로 가져오기
전체 스키마를 한 번에 가져오는 대신 도메인 단위로 잘게 나누어 가져오는 것을 권장합니다. 여러 테이블을 한 번에 드롭하면 세로 방향으로 자동 배치되고, 이미 ERD에 포함된 테이블은 중복으로 들어가지 않으므로 안심하고 추가할 수 있습니다. 단, 하나의 ERD에는 같은 커넥션 · 같은 스키마의 테이블만 추가할 수 있다는 점에 유의하세요.
스키마 단위 일괄 가져오기, 가져온 후 자동 정렬(Auto Layout) 활용, 가져온 ERD를 그룹별로 분리하는 방법 등은 ERD 가져오기 (Reverse Engineering) 가이드에서 자세히 다룹니다.
갤러리에 발행하기
완성된 ERD를 공개 갤러리에 게시하면 누구나 열어볼 수 있어, 포트폴리오나 학습 자료로 공유하기에 좋습니다.
ERD 작업 화면 우측의 ERD 정보 패널 상단에 있는 "더보기" 드롭다운에서 "전체 공개"를 선택하면 ERD에 제목·설명·태그 등을 붙여 공개 갤러리에 올릴 수 있습니다. 발행된 ERD는 로그인 없는 사용자도 열람할 수 있어 포트폴리오로 활용하거나 학습 자료로 공유할 때 유용합니다. 발행한 뒤에는 같은 메뉴가 "갤러리 업데이트"(현재 ERD 내용을 다시 반영)와 "게시 중지"(갤러리에서 내림)로 바뀌어, 언제든지 수정하거나 발행을 철회할 수 있습니다.
다음으로 무엇을 볼까
여기까지 따라했다면 NeoSQL의 핵심 흐름은 모두 경험한 셈입니다. 다음은 작업 스타일과 관심사에 맞춰 가이드를 골라보세요.