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

발행수정도구SQL DDL ➔ JSON 스키마 변환기

목차
  1. 1. SQL 타입은 JSON 스키마 타입으로 이렇게 매핑됩니다
  2. 2. DDL 문장을 실제로 이렇게 해석합니다
  3. 3. 자주 막히는 지점
  4. 정리
  5. 자주 묻는 질문

관계형 데이터베이스(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 문을 아래 순서로 읽으면 손으로도 같은 결과를 만들 수 있습니다.

  1. 주석 제거: /* ... */ 블록 주석과 -- 라인 주석을 먼저 지웁니다.
  2. 테이블명과 본문 분리: CREATE TABLE [IF NOT EXISTS] 테이블명 ( ... ) 형태에서 테이블명과 괄호 안 내용을 분리합니다.
  3. 컬럼 줄 나누기: 괄호 안 내용을 콤마 기준으로 나누되, DECIMAL(10,2)처럼 괄호 안에 있는 콤마는 무시합니다(괄호가 열리고 닫히는 깊이를 세어 판단합니다).
  4. 줄 종류 구분: 줄이 PRIMARY KEY, CONSTRAINT, FOREIGN KEY, UNIQUE, CHECK, INDEX로 시작하면 컬럼이 아니라 테이블 제약으로 보고, 이 중 PRIMARY KEY(컬럼1, 컬럼2) 형태만 required 배열에 반영합니다. 나머지 제약은 스키마에 반영되지 않습니다.
  5. 컬럼 줄 파싱: 나머지 줄은 공백 기준 첫 단어를 컬럼명, 두 번째 단어를 타입으로 읽습니다. 이어서 줄 전체에서 NOT NULL, DEFAULT 값, COMMENT '설명'을 각각 찾아 필수값 등록, default 필드, description 필드로 반영합니다.

저희 도구로 확인하기. 위 규칙을 컬럼 수만큼 손으로 반복하는 대신, SQL DDL을 붙여넣으면 같은 규칙으로 JSON 스키마를 즉시 만들어 줍니다.

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 DDL ➔ JSON 스키마 변환기

변환할 관계형 데이터베이스 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"]처럼 직접 추가합니다.

관련 글

  1. SQL 포맷터가 쿼리를 정렬하는 규칙한 줄로 붙은 SQL을 SQL 포맷터가 어떻게 정렬하는지 규칙을 그대로 설명합니다. 키워드만 대문자로 바뀌고 테이블·컬럼명은 유지되며, 절마다 줄바꿈되고 조건·서브쿼리는 들여써진다는 원리, 포매팅이 실행 결과를 바꾸지 않는 이유까지 정리했습니다.
  2. SQL 파라미터 바인딩, 값 대입 규칙 보기?, :id, @name 플레이스홀더에 실제 값이 어떻게 대입·이스케이프되어 완성 SQL이 되는지 규칙으로 정리했습니다. 숫자·NULL은 그대로, 문자열은 따옴표로 감싸며 주석·문자열 안 물음표는 왜 안 바뀌는지 결과로 확인하세요.
  3. 문자열 이스케이프, 무엇이 어떻게 바뀌나백슬래시·따옴표·줄바꿈·탭이 JSON·JS 문자열에서 각각 어떤 기호로 바뀌는지 표로 정리하고, 언이스케이프로 되돌리는 방향 차이와 자주 틀리는 지점까지 설명합니다.
  4. HTML 태그 제거로 본문 텍스트만 뽑아내기복사한 HTML에 섞인 태그와 & 같은 기호를 걷어내고 순수 본문 텍스트만 남기는 방법입니다. 정규식으로 직접 하는 법과 자바스크립트/CSS 제거·줄바꿈 보존·엔티티 변환 옵션이 각각 어떻게 동작하는지 예시로 확인합니다.
  5. 위첨자 변환기: x²·H₂O 복사해 쓰는 법x², H₂O 같은 위첨자·아래첨자를 폰트 서식이 아닌 실제 유니코드 문자로 바꿔 메신저·SNS·문서 어디에나 붙여넣는 방법을 정리했습니다. 변환 원리, 안 바뀌는 글자, 네모로 보이는 이유까지 사실 위주로 설명합니다.
  6. SVG path 좌표 추출, d 속성 숫자 읽는 법SVG path의 d 속성에서 M·L·C·Z 명령어와 숫자가 좌표를 어떻게 나타내는지 풀어보고, 이 값을 JSON·포인트 리스트·CSV로 뽑는 과정을 그대로 보여드립니다. 대문자·소문자 차이와 곡선 제어점까지 함께 잡히는 이유도 정리했습니다.

관련 도구