작동 방식

갱신 2026-10-30

ERDism 의 프로젝트가 어떤 모양인지, 처음 만나는 순서대로 설명합니다.

1. 워크스페이스가 프로젝트를 담습니다

가입하면 워크스페이스가 생깁니다. 워크스페이스는 프로젝트를 담고, 프로젝트는 다이어그램을 담습니다. 멤버는 워크스페이스에 초대되어 그곳에서 역할을 가지므로, 접근 권한은 프로젝트마다가 아니라 한 번에 정해집니다.

2. 프로젝트 하나가 스키마 하나입니다

프로젝트 안에서 편집기를 엽니다. 캔버스가 다이어그램이고, 그 아래 패널이 SQL 이며, 옆 패널은 속성을 편집하고 타임라인을 읽고 이슈를 보는 인스펙터입니다. 이 셋은 하나의 모델을 보는 세 화면이라, 어느 곳에서 바꾸어도 나머지 두 곳에 나타납니다.

한 프로젝트에 같은 테이블을 보는 다이어그램을 여러 개 둘 수 있습니다. 테이블은 프로젝트에 한 번만 존재하고 원하는 만큼 여러 다이어그램에 배치할 수 있어, 팀마다 자기가 맡은 부분의 보기를 따로 둘 수 있습니다.

3. 운영 중인 스키마를 가져오거나, 새로 그립니다

가져오기는 SQL 을 붙여 넣거나 파일을 올리는 것입니다. 가져오기는 세 단계로 진행됩니다. 분석 단계는 SQL 이 무엇을 말하는지, 어떤 테이블을 추가하거나 바꾸게 되는지 알려 줍니다. 확인 단계에서는 어느 테이블을 어느 다이어그램에 둘지 고르고, 가져오기가 제거하게 될 것에 동의합니다. 가져오기 단계에서 실제로 적용합니다. ERDism 이 모델로 다루지 않는 구문은 쓰인 그대로 보존됩니다.

그리기는 캔버스에 테이블을 놓고, 컬럼과 키를 추가하고, 테이블 사이에 관계를 긋는 것입니다. 그러는 동안 ERDism 이 테이블마다 CREATE TABLE 을 씁니다.

4. 설명을 붙입니다

테이블마다 Markdown 으로 쓰는 문서 페이지가 있습니다. 문서는 테이블과 함께 있으므로, 다음에 그 테이블을 여는 사람이 컬럼 바로 옆에서 설명을 읽습니다.

5. 모든 변경이 기록됩니다

타임라인은 변경마다 누가 언제 했는지를 기록합니다. 테이블과 컬럼의 추가 · 수정 · 삭제 · 복원, 그리고 SQL 블록의 승인 · 거부 · 발행이 모두 남습니다. 실행 취소와 다시 실행은 내가 한 변경에만 적용되고, 다이어그램 하나씩이 아니라 프로젝트의 모든 다이어그램에 걸쳐 동작합니다.

6. 변경은 승인을 거칩니다

테이블을 편집하면 초안이 생깁니다. 초안은 저장할 때 저장되고, 각 SQL 블록은 동료가 승인하거나 거부할 때까지 승인 상태를 가집니다. 서버는 프로젝트가 겨냥하는 데이터베이스와 버전에 맞춰 스키마를 검사하고, 그 버전이 지원하지 않는 것은 이슈로 나타납니다.

7. 발행하고, 내보냅니다

발행은 승인된 SQL 을 모아 발행된 버전으로 기록하는 것입니다. 발행하려면 스키마가 준비되어 있어야 합니다. 블록이 승인되어 있고, 풀리지 않은 관계가 없고, 지원하는 방언이어야 합니다. 발행한 뒤에는 SQL 을 파일로 내보낼 수 있습니다. 지금은 전체 스키마이며, ERDism 은 아직 두 버전 사이의 ALTER 문을 만들지 않습니다.

다른 사람이 같은 프로젝트에 있을 때

누군가 테이블이나 SQL 블록을 선택하거나 편집하면 다른 사람들에게는 그것이 사용 중으로 표시되고, 풀릴 때까지 그 사람들에게는 읽기 전용입니다. 이것은 병합이 아니라 상호 배제입니다. 2명이 같은 테이블을 동시에 편집하는 일은 없습니다.