테이블 노드
테이블 노드는 데이터를 저장하는 표입니다. 엑셀 시트 하나를 만든다고 생각하면 됩니다. 모든 앱은 테이블 노드에서 시작합니다.
소개
업무용 앱을 만들 때 가장 먼저 해야 할 일은 "어떤 데이터를 저장할 것인가?"를 결정하는 것입니다. 테이블 노드는 바로 이 데이터 저장소를 만드는 노드입니다.
예를 들어 "품목 관리" 앱을 만든다면, 먼저 "품목" 테이블을 만들고, 그 안에 "품목코드", "품목명", "단가" 같은 컬럼을 추가합니다.
이렇게 보입니다
캔버스에서의 모습
캔버스에 배치된 테이블 노드입니다. 테이블 이름과 컬럼 목록이 표시됩니다.
캔버스에서 테이블 노드는 사각형 카드 형태로 보입니다. 상단에 테이블 이름, 그 아래에 컬럼 목록이 표시됩니다.
속성 패널
테이블 노드를 클릭하면 오른쪽에 속성 패널이 열립니다. 여기서 테이블 이름과 설명을 설정합니다.
컬 럼 설정 화면
속성 패널의 컬럼 탭에서 컬럼을 추가하고 타입을 설정합니다.
테이블 만들기 - 단계별 가이드
1단계: 테이블 노드 배치
- 왼쪽 팔레트에서 데이터 카테고리를 펼칩니다
- 테이블 노드를 캔버스로 드래그합니다
- 빈 테이블 노드가 캔버스에 배치됩니다
2단계: 테이블 이름 설정
- 배치된 테이블 노드를 클릭합니다
- 오른쪽 속성 패널에서 테이블 이름을 입력합니다
- 예:
품목마스터,작업지시,입고전표
- 예:
- 필요하면 설명도 입력합니다
테이블 이름은 한글로 지정할 수 있습니다. 실제 데이터베이스에는 영문으로 자동 변환되므로 걱정하지 마세요.
3단계: 컬럼 추가
- 속성 패널에서 "컬럼 추가" 버튼을 클릭합니다
- 컬럼 이름과 타입을 설정합니다
| 설정 항목 | 설명 | 예시 |
|---|---|---|
| 컬럼 이름 | 데이터 항목의 이름 | 품목코드, 품목명, 단가 |
| 컬럼 타입 | 데이터의 종류 | VARCHAR(텍스트), INT(숫자), DATE(날짜) |
| 필수 여부 | 반드시 입력해야 하는지 | NOT NULL 체크 |
| 기본값 | 입력하지 않을 때의 값 | 기본 단가: 0 |
id 컬럼(UUID 타입)은 자동으로 생성됩니다. 별도로 추가할 필요가 없습니다. 이 컬럼은 각 행을 구분하는 고유 식별자입니다.
4단계: 배포
- 컬럼 추가가 끝나면 상단 "배포" 버튼을 클릭합니다
- 실제 데이터베이스에 테이블이 생성됩니다
배포가 완료되면 테이블 노드에 배포 완료 표시가 나타납니다.
배포 후에는:
- 데이터를 입력할 수 있습니다
- 화면 노드를 연결하여 목록/양식 화면을 만들 수 있습니다
- 다른 테이블과 관계를 설정할 수 있습니다
테이블 설계 팁
좋은 테이블 설계의 원칙
| 원칙 | 설명 | 좋은 예 | 나쁜 예 |
|---|---|---|---|
| 한 테이블 = 한 주제 | 하나의 테이블에는 한 가지 주제만 | 품목 테이블, 거래처 테이블 | 품목+거래처 테이블 |
| 반복 데이터 분리 | 반복되는 항목은 별도 테이블로 | 발주서 + 발주품목 | 발주서에 품목1, 품목2, 품목3 |
| 명확한 이름 | 누가 봐도 알 수 있는 이름 | 품목코드, 납품일자 | code1, date1 |
자주 사용하는 테이블 구조
품목 마스터 테이블
| 컬럼명 | 타입 | 설명 |
|---|---|---|
| 품목코드 | VARCHAR | 고유 품목 코드 |
| 품목명 | VARCHAR | 품목 이름 |
| 분류 | ENUM | 원자재/반제품/완제품 |
| 단위 | VARCHAR | EA, KG, M 등 |
| 단가 | DECIMAL | 기준 단가 |
| 사용여부 | BOOLEAN | 사용/미사용 |
거래처 마스터 테이블
| 컬럼명 | 타입 | 설명 |
|---|---|---|
| 거래처코드 | VARCHAR | 고유 거래처 코드 |
| 거래처명 | VARCHAR | 거래처 이름 |
| 사업자번호 | VARCHAR | 10자리 사업자등록번호 |
| 대표자명 | VARCHAR | 대표자 이름 |
| 연락처 | VARCHAR | 전화번호 |
| 거래구분 | ENUM | 매입처/매출처/겸용 |
실무 예시
상황: ERP 시스템의 구매 모듈을 만들고 있습니다.
필요한 테이블:
- 마스터 테이블 먼저 만듭니다 (거래처, 품목, 창고)
- 전표 테이블 을 만듭니다 (발주서, 입고전표)
- 라인아이템 테이블을 만듭니다 (발주품목)
- 테이블 간 관계를 연결합니다
자주 묻는 질문
Q: 배포 후에 컬럼을 추가할 수 있나요? A: 네, 컬럼 추가는 배포 후에도 자유롭게 가능합니다. 추가 후 다시 배포하면 됩니다.
Q: 배포 후에 컬럼을 삭제할 수 있나요? A: 가능하지만, 해당 컬럼에 이미 데이터가 있다면 데이터가 함께 삭제됩니다. 신중하게 결정하세요.
Q: 컬럼 타입을 잘못 설정했어요. 변경할 수 있나요? A: 배포 전이라면 자유롭게 변경 가능합니다. 배포 후에는 데이터 호환성에 따라 제한될 수 있습니다.
Q: 테이블은 최대 몇 개까지 만들 수 있나요? A: 솔루션당 제한은 없으나, 관리 편의를 위해 논리적으로 그룹화하는 것을 권장합니다.