SQL DDL에서 JSON 스키마 변환 공식과 데이터 타입 매핑 규칙

관계형 데이터베이스(RDB)의 CREATE TABLE 구문과 API·문서형 데이터베이스에서 널리 쓰는 JSON 스키마(JSON Schema Draft-07)는 표현 방식이 달라서, 컬럼 하나하나를 사람이 눈으로 대조해 옮기다 보면 타입이나 필수값 처리를 놓치기 쉽습니다. 어떤 SQL 타입이 어떤 JSON 타입으로 바뀌는지, NOT NULL과 UNIQUE는 각각 어떻게 처리되는지를 규칙으로 정리하면 이런 실수를 줄일 수 있습니다.
요약 ① SQL 타입은 정수·실수·불리언·날짜·JSON 등 몇 갈래로 나뉘어 JSON 스키마 타입에 매핑됩니다. ②
NOT NULL과PRIMARY KEY컬럼만required배열에 자동으로 들어가고,UNIQUE는 들어가지 않습니다. ③VARCHAR의 길이(maxLength)와ENUM목록은 자동 변환되지 않아 직접 추가해야 합니다.
1. SQL 타입은 JSON 스키마 타입으로 이렇게 매핑됩니다
SQL DDL에 쓰인 데이터 타입은 다음 기준으로 JSON 스키마 Draft-07의 type 속성으로 바뀝니다.
- 정수:
INT,INTEGER,TINYINT,SMALLINT,MEDIUMINT,BIGINT,SERIAL,BIGSERIAL→{ "type": "integer" } - 실수:
DECIMAL,NUMERIC,FLOAT,DOUBLE,REAL→{ "type": "number" } - 불리언:
BOOLEAN,BOOL→{ "type": "boolean" } - 날짜:
DATE→{ "type": "string", "format": "date" }/TIMESTAMP,DATETIME→{ "type": "string", "format": "date-time" } - JSON 계열:
JSON,JSONB→{ "type": "object" } - 그 외 문자열 계열:
VARCHAR,CHAR,TEXT등은 전부{ "type": "string" }로 처리됩니다.VARCHAR(50)처럼 길이가 붙어 있어도maxLength는 자동으로 추가되지 않습니다.
필수값 여부는 타입과 별개로 처리됩니다. NOT NULL이 붙은 컬럼과 PRIMARY KEY로 지정된 컬럼만 최상위 required 배열에 자동으로 등록됩니다. UNIQUE 제약은 값의 중복만 막을 뿐 값의 존재를 강제하지 않으므로 required 배열에 자동으로 들어가지 않습니다. '선택적 컬럼의 타입을 null과 유니온 타입으로 설정' 옵션을 켜면, required에 없는 컬럼의 타입이 ["string", "null"]처럼 null과의 유니온으로 바뀝니다.
2. DDL 문장을 실제로 이렇게 해석합니다
SQL CREATE TABLE 문을 아래 순서로 읽으면 손으로도 같은 결과를 만들 수 있습니다.
- 주석 제거:
/* ... */블록 주석과--라인 주석을 먼저 지웁니다. - 테이블명과 본문 분리:
CREATE TABLE [IF NOT EXISTS] 테이블명 ( ... )형태에서 테이블명과 괄호 안 내용을 분리합니다. - 컬럼 줄 나누기: 괄호 안 내용을 콤마 기준으로 나누되,
DECIMAL(10,2)처럼 괄호 안에 있는 콤마는 무시합니다(괄호가 열리고 닫히는 깊이를 세어 판단합니다). - 줄 종류 구분: 줄이
PRIMARY KEY,CONSTRAINT,FOREIGN KEY,UNIQUE,CHECK,INDEX로 시작하면 컬럼이 아니라 테이블 제약으로 보고, 이 중PRIMARY KEY(컬럼1, 컬럼2)형태만required배열에 반영합니다. 나머지 제약은 스키마에 반영되지 않습니다. - 컬럼 줄 파싱: 나머지 줄은 공백 기준 첫 단어를 컬럼명, 두 번째 단어를 타입으로 읽습니다. 이어서 줄 전체에서
NOT NULL,DEFAULT 값,COMMENT '설명'을 각각 찾아 필수값 등록,default필드,description필드로 반영합니다.
저희 도구로 확인하기. 위 규칙을 컬럼 수만큼 손으로 반복하는 대신, SQL DDL을 붙여넣으면 같은 규칙으로 JSON 스키마를 즉시 만들어 줍니다.
변환할 관계형 데이터베이스 SQL CREATE TABLE DDL 구문을 기입하여 최신 표준 JSON 스키마 검증 객체 소스 코드를 간편하게 자동 생성해 보세요.

3. 자주 막히는 지점
| 상황 | 실제 동작 |
|---|---|
VARCHAR(50)처럼 길이 지정 | 타입은 string으로 변환되지만 maxLength는 자동으로 붙지 않습니다. |
UNIQUE 제약 | PRIMARY KEY와 달리 required 배열에 자동으로 들어가지 않습니다. |
ENUM('a','b') | 목록을 읽어 enum 배열을 만들지 않고 string 타입으로만 변환됩니다. |
COMMENT '설명' | description 필드로 자동 반영됩니다. |
DEFAULT 값 | NULL, CURRENT_TIMESTAMP류를 제외하면 default 필드로 반영됩니다. |
정리
- 정수·실수·불리언·JSON 계열은 타입 이름만으로 바로 매핑됩니다.
- 날짜류는
DATE와TIMESTAMP/DATETIME이 서로 다른format값을 받습니다. required배열은NOT NULL과PRIMARY KEY컬럼만 자동으로 채우고,UNIQUE는 포함하지 않습니다.VARCHAR길이(maxLength)와ENUM목록은 자동 변환 대상이 아니므로, 필요하면 변환 결과를 받은 뒤 직접 추가합니다.
변환할 관계형 데이터베이스 SQL CREATE TABLE DDL 구문을 기입하여 최신 표준 JSON 스키마 검증 객체 소스 코드를 간편하게 자동 생성해 보세요.
자주 묻는 질문
VARCHAR 길이가 JSON 스키마의 maxLength로 자동 변환되나요?
아니요. 현재 변환기는 타입만 매핑하며 길이 제약은 넣지 않습니다. 필요하면 변환된 JSON에서 해당 필드에 "maxLength": 50처럼 직접 추가합니다.
UNIQUE 제약이 있는 컬럼도 required 배열에 자동으로 들어가나요?
아니요. required 배열에는 NOT NULL 컬럼과 PRIMARY KEY 컬럼만 들어갑니다. UNIQUE는 중복을 막는 제약이지 값의 존재를 강제하는 제약이 아니므로 별도로 처리되지 않습니다. 필수값으로 만들고 싶다면 변환 후 required 배열에 직접 추가해야 합니다.
ENUM 타입은 어떻게 처리되나요?
현재 버전은 ENUM 목록을 자동으로 읽어 enum 배열을 만들지 않고, 문자열(string) 타입으로만 변환합니다. 선택 가능한 값을 제한하려면 변환된 JSON에 "enum": ["active", "inactive"]처럼 직접 추가합니다.