컬럼 타입 가이드
VEXPLOR Logic Studio는 11가지 컬럼 타입을 제공합니다. 각 타입에 따라 양식(Form)에서 입력하는 모습과 목록(List)에서 표시되는 모습이 달라집니다.
소개
테이블에 컬럼을 추가할 때, 저장할 데이터의 성격에 맞는 타입을 선택해야 합니다. 타입을 올바르게 선택하면 입력 화면에서 적절한 입력 도구(텍스트 박스, 달력, 토글 등)가 자동으로 제공됩니다.
전체 컬럼 타입 비교표
| 타입 | 저장 데이터 | 양식(Form)에서 모습 | 목록(List)에서 모습 | 실무 예시 |
|---|---|---|---|---|
| UUID | 고유 식별자 | 자동 생성 (입력 불가) | 표시 안 함 (보통) | 행 고유 ID |
| VARCHAR | 짧은 텍스트 | 한 줄 텍스트 입력 | 텍스트 표시 | 품목코드, 이름 |
| TEXT | 긴 텍스트 | 여러 줄 텍스트 입력 | 요약 표시 | 비고, 설명 |
| INT / BIGINT | 정수 | 숫자 입력 | 숫자 표시 | 수량, 순번 |
| DECIMAL | 소수 | 소수점 숫자 입력 | 소수 표시 | 단가, 금액 |
| BOOLEAN | 참/거짓 | 토글 스위치 | 체크 아이콘 | 사용여부, 승인여부 |
| DATE | 날짜 | 달력 선택기 | 날짜 텍스트 | 납품일, 입사일 |
| TIMESTAMP | 날짜+시간 | 날짜+시간 선택기 | 날짜시간 텍스트 | 등록일시, 수정일시 |
| ENUM | 선택 목록 | 드롭다운 선택 | 태그/텍스트 | 상태, 분류 |
| JSON / JSONB | 구조화 데이터 | JSON 편집기 | 축약 표시 | 메타데이터, 설정값 |
| FILE | 파일 첨부 | 파일 업로드 | 파일명 링크 | 도면, 사진 |
타입별 상세 가이드
UUID
용도: 각 행을 구분하는 고유 식별자
- 테이블 생성 시
id컬럼이 자동으로 추가됩니다 - 사용자가 직접 입력하거나 수정할 수 없습니다
550e8400-e29b-41d4-a716-446655440000같은 형태의 값이 자동 생성됩니다
UUID 컬럼은 보통 화면에 표시하지 않습니다. 시스템이 내부적으로 사용하는 값이므로 신경 쓰지 않아도 됩니다.
VARCHAR (짧은 텍스트)
용도: 이름, 코드, 전화번호 등 짧은 텍스트 데이터
양식(Form)에서 VARCHAR 컬럼은 한 줄 텍스트 입력 필드로 나타납니다.
목록(List)에서 VARCHAR 컬럼은 텍스트로 표시됩니다.
| 설정 | 설명 |
|---|---|
| 최대 길이 | 입력 가능한 최대 글자 수 (기본 255) |
| 기본값 | 미입력 시 자동으로 채워질 값 |
실무 활용:
- 품목코드:
ITEM-001 - 거래처명:
(주)삼성전자 - 전화번호:
02-1234-5678
TEXT (긴 텍스트)
용도: 설명, 비고, 특이사항 등 길이가 긴 텍스트
양식에서는 여러 줄 텍스트 영역(textarea)으로 표시되어 긴 내용을 작성할 수 있습니다. 목록에서는 처음 몇 글자만 요약 표시됩니다.
실무 활용:
- 품질 검사 소견
- 작업 지시 상세 내용
- 클레임 내용
INT / BIGINT (정수)
용도: 수량, 순번 등 소수점이 필요 없는 숫자
양식에서는 숫자 전용 입력 필드로 나타나며, 위/아래 화살표로 값을 조절할 수 있습니다.
| 타입 | 범위 | 용도 |
|---|---|---|
| INT | -21억 ~ 21억 | 일반적인 수량, 순번 |
| BIGINT | 매우 큰 범위 | 대용량 일련번호 |
실무 활용:
- 주문 수량:
100 - 재고 수량:
5000 - 순번:
1, 2, 3...
DECIMAL (소수)
용도: 단가, 금액, 중량 등 소수점이 필요한 숫자
양식에서 DECIMAL 컬럼은 소수점 입력이 가능한 숫자 필드로 나타납니다.
| 설정 | 설명 | 예시 |
|---|---|---|
| 전체 자릿수 | 전체 숫자 자릿수 | 10 |
| 소수 자릿수 | 소수점 이하 자릿수 | 2 |
실무 활용:
- 단가:
15,000.50 - 금액:
1,500,050.00 - 중량:
25.75(kg) - 불량률:
3.25(%)
BOOLEAN (참/거짓)
용도: 사용여부, 승인여부 등 예/아니오 값
양식에서 BOOLEAN 컬럼은 토글 스위치로 나타납니다. 클릭하면 ON/OFF가 전환됩니다.
목록에서는 체크 표시(체크/미체크) 아이콘으로 표시됩니다.
실무 활용:
- 사용여부: ON / OFF
- 승인여부: 승인됨 / 미승인
- 긴급여부: 긴급 / 일반
DATE (날짜)
용도: 날짜 정보 (시간 제외)
양식에서 DATE 컬럼은 달력 선택기(Date Picker)로 나타납니다. 클릭하면 달력이 펼쳐집니다.
목록에서는 2025-03-15와 같은 형태로 표시됩니다.
실무 활용:
- 납품일자:
2025-04-01 - 입사일:
2024-01-15 - 검사일:
2025-03-20
TIMESTAMP (날짜+시간)
용도: 날짜와 시간을 함께 기록
양식에서는 날짜 선택기 + 시간 선택기가 함께 나타납니다. 등록일시, 수정일시 등 시스템이 자동으로 기록하는 용도로 많이 사용됩니다.
실무 활용:
- 등록일시:
2025-03-15 09:30:00 - 작업시작시각:
2025-03-15 08:00:00 - 최종수정일시:
2025-03-15 17:45:30
ENUM (선택 목록)
용도: 미리 정해진 값 중에서 선택
양식에서 ENUM 컬럼은 드롭다운 선택 목록으로 나타납니다.
목록에서 ENUM 값은 색상이 있는 태그(뱃지)로 표시됩니다.
ENUM 설정 방법:
- 컬럼 타입을 ENUM으로 선택합니다
- 선택 항목을 하나씩 추가합니다
- 각 항목에 표시 이름과 색상을 지정할 수 있습니다
| 설정 | 설명 |
|---|---|
| 항목 값 | 저장되는 실제 값 |
| 표시 이름 | 화면에 보여지는 이름 |
| 색상 | 목록에서 태그 색상 |
실무 활용:
- 품목분류: 원자재 / 반제품 / 완제품
- 주문상태: 작성 / 승인요청 / 승인완료 / 반려
- 우선순위: 긴급 / 높음 / 보통 / 낮음
- 거래구분: 매입 / 매출 / 겸용
JSON / JSONB (구조화 데이터)
용도: 복잡한 구조의 데이터를 유연하게 저장
양식에서 JSON 컬럼은 JSON 편집기로 나타납니다.
JSON 타입은 초보자에게는 다소 어려울 수 있습니다. 특별한 경우가 아니라면 일반 컬럼 타입을 사용하는 것을 권장합니다.
실무 활용:
- 장비 메타데이터: 센서 값, 파라미터 설정
- 유연한 속성: 품목별로 서로 다른 스펙 정보
FILE (파일 첨부)
용도: 이미지, 문서, 도면 등 파일 첨부
양식에서 FILE 컬럼은 파일 업로드 영역으로 나타납니다. 드래그 앤 드롭 또는 클릭으로 파일을 첨부합니다.
목록에서 FILE 컬럼은 파일명 링크로 표시되며, 클릭하면 다운로드됩니다.
| 설정 | 설명 |
|---|---|
| 허용 파일 형식 | 업로드 가능한 파일 확장자 |
| 최대 파일 크기 | 허용되는 파일 크기 상한 |
| 다중 파일 | 여러 파일 첨부 허용 여부 |
실무 활용:
- 도면 첨부: PDF, DWG
- 검사 사진: JPG, PNG
- 수입 서류: PDF, Excel
타입 선택 가이드
어떤 타입을 선택해야 할지 헷갈린다면 아래 흐름을 따라가세요:
자주 묻는 질문
Q: VARCHAR와 TEXT의 차이가 뭔가요? A: VARCHAR는 짧은 텍스트(이름, 코드 등), TEXT는 긴 텍스트(설명, 비고 등)에 사용합니다. 양식에서 VARCHAR는 한 줄, TEXT는 여러 줄 입력 필드로 나타납니다.
Q: INT와 DECIMAL 중 어떤 것을 선택해야 하나요? A: 소수점이 필요하면 DECIMAL, 정수만 필요하면 INT를 사용하세요. 금액과 단가는 반드시 DECIMAL을 사용하세요.
Q: ENUM에 항목을 나중에 추가할 수 있나요? A: 네, 배포 후에도 ENUM 항목을 추가할 수 있습니다.
Q: 컬럼 타입을 잘못 지정했어요. 배포 전에 변경할 수 있나요? A: 배포 전이라면 자유롭게 변경 가능합니다.