테이블과 컬럼
테이블은 스키마의 핵심 단위입니다. AI-ERD에서는 캔버스에서 테이블을 배치하고, 편집 패널에서 컬럼과 인덱스, 외래 키를 함께 관리합니다.
테이블 만들기
테이블은 다음 방법으로 만들 수 있습니다.
- Tables 사이드바에서 + New Table 클릭
- 빈 캔버스 우클릭 → New table
- AI 또는 SQL import 결과로 자동 생성
새 테이블은 캔버스에 추가되고 편집 패널이 열립니다.
테이블 속성
| 속성 | 설명 |
|---|---|
| Name | 테이블명 |
| Schema | 선택적 schema name 예: public, billing |
| Alias | 관계 표시 등에 쓰는 짧은 별칭 |
| Note | 테이블 설명 |
| Header color | 캔버스에서 보이는 테이블 헤더 색상 |
테이블명은 같은 schema 안에서 고유해야 합니다.
컬럼 추가와 편집
편집 패널의 Columns 섹션에서 컬럼을 관리합니다.
| 속성 | 설명 |
|---|---|
| Name | 컬럼명 |
| Type | SQL 타입 예: bigint, varchar(255), timestamp |
| PK | Primary key 여부 |
| Unique | Unique 제약 |
| Not Null | Null 허용 여부 |
| Increment | Auto-increment 여부 |
| Default | 기본값 |
| Note | 컬럼 설명 |
컬럼은 드래그해 순서를 바꿀 수 있습니다. 표시 순서는 export와 명세서에도 반영됩니다.
컬럼 badge
편집 패널과 캔버스의 컬럼 목록은 시각 badge를 표시합니다.
| Badge | 의미 |
|---|---|
| PK | primary key 컬럼 |
| FK | 외래 키 관계에 사용되는 컬럼 |
Badge는 전체 컬럼 편집기를 열지 않아도 핵심 컬럼을 빠르게 식별하게 해 줍니다.
테이블 삭제
테이블 삭제 방법은 두 가지입니다.
- Keyboard: 캔버스에서 테이블 선택 후 Delete 또는 Backspace
- Edit panel: 테이블 편집 패널 하단의 Delete 버튼
주의
테이블을 삭제하면 연결된 모든 관계(외래 키)도 함께 제거됩니다. 버전 기록을 통한 복원을 제외하면 되돌릴 수 없습니다.
저장 모델
테이블, 컬럼, 인덱스, FK 변경은 관련 변경을 함께 저장하도록 묶입니다. 특히 FK는 pending 상태로 모였다가 Save 시 한 번에 커밋됩니다.
이 방식은 컬럼 변경과 관계 변경이 서로 어긋나는 partial save를 줄입니다.
팁
billing.invoices,auth.sessions처럼 schema prefix로 도메인을 정리하세요.- 모듈별로 다른 header color를 쓰면 큰 다이어그램을 빠르게 훑을 수 있습니다.
- note 필드는 설계 결정, 제약, migration 메모를 테이블과 함께 보존하는 문서화 공간입니다.
- 컬럼 순서는 가독성에 중요합니다. 보통 primary key, foreign key, 도메인 필드, timestamp 순서가 읽기 좋습니다.