스키마 가져오기
JSON Schema 파일에서 데이터 구조를 가져오기
2 min read
이미 정의된 데이터 구조가 JSON Schema 형태로 있다면, 직접 만들 필요 없이 가져올 수 있습니다.
지원 형식
- JSON Schema Draft-07 / 2019-09 / 2020-12
- JSON 또는 YAML 파일
가져오는 방법
Data Scheme 탭의 추가 메뉴에서 Import JSON Schema… 를 선택하고 파일을 지정합니다. 가져온 내용은 한 번의 작업으로 추가되며, 필요하면 되돌리기(Undo)도 됩니다.
가져오는 것
- Data Schema — 정의된 객체 구조.
$defs,definitions등에 정의된 명명된 타입을 가져오고,$ref참조와allOf/oneOf/anyOf도 적절히 합쳐 처리합니다. - Data Enum — 문자열·정수 열거형. 같은 값 묶음은 중복 없이 정리됩니다.
- 필드 메타데이터 — 설명(description), 필수 여부(required), 기본값(default), 검증 제약(최소/최대 길이, 최소/최대값, 패턴, 형식 등)을 함께 가져와 보존합니다.
가져온 검증 제약과 설명은 문서용 정보로 보존됩니다. 필드 편집기에서 필수 항목 표시(*)와 설명·제약 요약·기본값을 읽기 전용으로 보여 주며, 실행 시점에 강제로 검증하지는 않습니다.
서버 API 의 스펙이 있다면 JSON Schema 대신 OpenAPI / Swagger 가져오기를 사용하세요. 데이터 구조뿐 아니라 API 엔드포인트까지 한 번에 만들어 줍니다.