따라 하면 데스크톱 앱에서 계정 없이 프로젝트를 하나 만들고, 데모 상점의 고객(customer)과 주문(orders) 테이블을 ERD 로 설계해 실제 데이터베이스에 만들게 됩니다. 15분쯤 걸리고, 준비물은 설치한 데스크톱 앱 하나입니다. DB 서버를 따로 띄우지 않도록 파일 하나가 곧 DB 인 SQLite 를 사용합니다.
SQLite 예제는 데스크톱 앱에서 따라 합니다. 웹 앱이나 다른 DBMS 로 따라 하려면 커넥션 만들기와 수정 에서 사용할 DB 의 접속 정보를 넣고, 나머지는 같게 하세요.
준비
- 데스크톱 앱을 설치합니다(설치와 업데이트). 처음 열면 로그인 없이 홈이 보입니다(처음 실행하기).
- SQLite 파일을 둘 폴더를 정해 둡니다. 다른 DBMS 를 사용한다면 테이블을 만들 권한이 있는 연습용 DB 를 사용하세요. 마지막 단계는 실제로
CREATE TABLE을 실행합니다. - ERD 에서 변경한 내용이 저장, DB 반영의 두 단계를 거친다는 것을 알아 두면 흐름이 쉽습니다(ERD 와 실제 DB).
로컬 프로젝트 만들기
- 홈의 새 데이터베이스 프로젝트 카드를 클릭합니다. 결과: 새 프로젝트 창이 열립니다.
- 프로젝트 이름 칸(2)에
데모 상점을 적습니다. - 샘플 ERD 생성 (classicmodels) 항목(3)은 선택하지 않고 생성 버튼(5)을 클릭합니다. 결과: 커넥션이 없는 빈 프로젝트가 기기에만 저장되는 로컬 프로젝트로 만들어지고, 프로젝트 화면이 열립니다(로그인과 프로젝트 종류).
샘플 ERD 를 선택하면 예제 테이블이 든 ERD 로 시작하고, 선택하지 않으면 빈 프로젝트가 만들어집니다. 이 순서에서는 테이블을 직접 만듭니다.
커넥션 만들기
ERD 의 설계를 DB 에 만들려면 접속할 커넥션이 있어야 합니다. 그래서 ERD 보다 커넥션을 먼저 만듭니다.
- 왼쪽 탐색기 가운데의 새 커넥션 만들기 버튼을 클릭합니다. 결과: 커넥션 창이 열립니다.
- 연결 이름 칸에
shop-db를 적고, DBMS 칸(3)에서 SQLite 를 선택합니다. - DB에 연결 버튼을 클릭합니다. 결과: 접속 칸(5)이 나옵니다.
- 데이터베이스 파일 칸에 새로 만들 파일의 전체 경로를 적습니다(예: 정해 둔 폴더의
shop.db). 이미 있는 파일을 사용하려면 찾아보기... 버튼으로 선택합니다. 결과: JDBC URL 칸(6)이 따라 변경됩니다. - 연결 테스트 버튼(7)을 클릭합니다. 결과: 연결에 성공했습니다. 알림이 표시됩니다. 적은 경로에 파일이 없으면 이때 SQLite 드라이버가 빈 DB 파일을 만듭니다.
- 저장 버튼(9)을 클릭합니다. 결과: 탐색기에
shop-db커넥션과main스키마가 생깁니다. 아직 테이블은 없습니다.
칸마다의 뜻과 다른 DBMS 의 접속 칸은 커넥션 만들기와 수정 에서 설명합니다.
ERD 만들기
- 왼쪽 아래 ERD, SQL 목록의 ERD 버튼을 클릭합니다. 결과: ERD 생성 창이 열립니다.
- ERD 제목 칸(1)에
주문 관리를 적습니다. - Connection 칸(2)은
shop-db그대로 두고, Schema 칸(3)에서main을 선택합니다. - 확인 버튼(4)을 클릭합니다. 결과:
shop-db의main스키마에 묶인 빈 ERD 가 만들어지고 ERD 탭이 열립니다. 새로 놓는 테이블은main스키마의 테이블로 설계됩니다(ERD 와 SQL 목록).
테이블 두 개 그리기
- 도구 모음의 새 테이블 추가 버튼(3)을 클릭하고 캔버스의 빈 곳을 클릭합니다. 결과:
table1테이블이 생깁니다. 아직 DB 에 없는 가상 테이블이고, 커넥션의 템플릿에 든 기본 키 컬럼id가 처음부터 들어 있습니다. - 테이블을 클릭해 선택하고, 머리의 테이블 이름을
customer로 수정합니다. 컬럼 그리드에서id의 이름을customer_id로 수정합니다. - 그리드 머리의 + 버튼으로 컬럼을 더해
email(VARCHAR(200)),name(VARCHAR(100))을 만들고 N/N 칸을 활성화합니다. 결과: 새 컬럼은 초록색으로 보입니다. - 1~3 단계를 되풀이해
orders테이블을 만듭니다. 기본 키는order_id로 수정하고,status(VARCHAR(20)),ordered_at(TIMESTAMP)을 더합니다. 결과: 두 테이블의 설계는 프로젝트 안에만 있고shop.db는 그대로입니다.
칸마다의 뜻, 기본값, 컬럼 순서 변경하기는 테이블 노드 에서 설명합니다.
관계 긋기
주문은 고객 한 명에게 속하므로 orders 가 customer 를 참조하는 외래 키를 둡니다. 관계는 DB 에 처음 반영하기 전에 그어 두세요. 그러면 외래 키가 CREATE TABLE 문 안에 함께 들어갑니다. SQLite 는 이미 만든 테이블에 외래 키를 ALTER TABLE 로 더할 수 없어서, 나중에 그으면 NeoSQL 이 DDL 을 만들지 못하고 안내 주석만 남깁니다.
- 도구 모음의 비식별 관계 버튼(4)을 클릭합니다.
- 부모인
customer를 클릭하고, 자식인orders를 클릭합니다. 결과: Foreign Key 추가 창이 열립니다. orders에customer_id컬럼이 없으므로 New Column 스위치가 활성화되어 있고, 새 컬럼 이름에customer_id가 들어 있습니다. 그대로 두고 Foreign Key 추가 버튼을 클릭합니다. 결과:orders의 설계에customer_id컬럼과 외래 키가 더해지고, 두 테이블 사이에 관계선이 생깁니다. 관계선이 곧 외래 키입니다.
저장하기
- 정보 패널의 저장 버튼(2)을 클릭하거나
Ctrl+S(macOS 는Cmd+S)를 누릅니다. 결과: ERD 의 배치와 두 테이블의 설계가 프로젝트에 저장됩니다. DB 는 아직 변경되지 않았으므로 초록색(1)은 그대로 남습니다.
DB 에 반영하기
정보 패널에서 반영하면 ERD 에서 변경된 테이블이 모두 한 창에 들어오고, 참조되는 customer 가 orders 보다 먼저 만들어집니다. orders 의 도구 모음에서 하나만 반영하면 참조할 테이블이 아직 없어 참조 테이블 미생성 창이 먼저 묻습니다.
- 정보 패널의 변경사항 DB 반영... 버튼을 클릭합니다. 결과: 변경사항 미리보기 및 실행 창이 열립니다.
- 테이블 목록(3)에
customer와orders가CREATE표시와 함께 들어 있는지 봅니다. - DDL 미리보기(4)에서 두
CREATE TABLE문과orders의FOREIGN KEY를 확인합니다. - DDL 실행 버튼(6)을 클릭하고, 확인 창에서 확인합니다. 결과: 선택한 DDL 이
shop.db에서 실행되어 두 테이블이 실제로 만들어집니다. NeoSQL 은 만든 테이블을 DB 에서 다시 읽어 설계에 저장하므로 초록색이 사라집니다.
창의 옵션과 실행 중 오류가 났을 때 선택하는 방법은 DB 반영 에서 설명합니다.
결과 확인하기
- 탐색기에서
main스키마의 새로고침 버튼을 클릭하고 Tables 묶음을 펼칩니다. 결과: 탐색기가 DB 에서 목록을 다시 읽어, 방금 만든customer와orders가 실제 DB 에 있는 것이 보입니다. 이름이 초록이 아니라 보통 색이면 DB 와 설계가 같다는 뜻입니다. orders를 펼쳐customer_id컬럼이 있는지 봅니다. 두 번 클릭하면 테이블 탭 에서 외래 키까지 볼 수 있습니다.
다음에 할 일
- 첫 쿼리를 실행하고 결과 수정하기: 방금 만든 테이블에 SQL 편집기로 데이터를 넣고 조회합니다.
- 기존 DB 를 ERD 로 문서화하기: 이미 있는 DB 의 테이블을 ERD 로 가져와 정리합니다.
- 데이터 사전으로 표준 이름 사용하기: 논리명을 적어 표준 이름과 타입으로 컬럼을 만듭니다.
- ERD 캔버스: 메모, 그룹, 자동 정렬, 이미지 내보내기... 도구 같은 캔버스의 다른 도구입니다.