01
어떤 데이터가 이동하는지 정하기
기본은 옛 생산자→새 소비자입니다. 옛 소비자가 새 데이터를 읽는 배포라면 반대 방향을 선택하세요.
스키마와 타입
JSON 스키마 비교변경이 영향을 주는 방향까지
두 버전의 JSON Schema를 입력하거나 예시를 불러온 뒤 생산자와 소비자의 방향을 선택하세요.
JSON 스키마 비교
이전 JSON Schema
새 JSON Schema
두 스키마는 브라우저에서 처리됩니다. 입력을 업로드하거나 참조 URL을 요청하지 않습니다.
수동 검증을 실행할 수 있습니다.
차이 결과
저장된 레코드는 옛 계약을 따르지만 읽는 서비스만 먼저 업데이트될 수 있습니다. JSON 스키마 비교는 텍스트 차이보다 실제 제약의 변화를 찾는 데 맞습니다.
새 생산자가 만든 데이터를 오래된 소비자가 읽어야 할 때는 방향을 뒤집으세요. JSON 스키마 비교에서는 선택 필드와 필수 필드의 추가를 같은 변화로 취급하지 않습니다.
JSON 스키마 비교가 필요한 이유
하나의 변경도 데이터 흐름에 따라 다른 위험이 됩니다.
생산자와 소비자를 분리
기본값은 옛 데이터가 새 Schema를 통과하는 방향입니다. 반대로 바꾸면 새 데이터가 옛 소비자에서 거절될 수 있는 부분을 따로 보여 줍니다.
모르는 규칙은 검토로 남김
JSON 스키마 비교는 $ref와 조합 규칙의 경로를 따로 표시합니다. 해석하지 못한 제약을 안전하다고 선언하지 않습니다.
방향을 정하고 경로를 읽기
02
변경된 제약 찾기
필수 이름은 /required 아래에, 타입 변화는 /properties 경로에 표시됩니다. 위험 필터에서도 검토 항목은 숨기지 않습니다.
03
새 결과로 내보내기
입력이나 방향을 바꾸면 복사와 다운로드가 중지됩니다. Ctrl/Cmd+Enter로 다시 실행한 결과만 내보낼 수 있습니다.
버전 사이의 제약 신호
필수 필드와 타입
스키마 호환성 검사는 required 추가와 타입 집합 축소를 데이터 방향에 맞춰 표시합니다. 필수 필드 변경이 옛 레코드에 미치는 영향을 확인하세요.
enum과 범위
JSON 스키마 차이 보고서는 enum 값의 순서를 무시하고 구성원을 비교하며 숫자, 길이, 개수 제한의 강화 방향을 찾습니다.
다운로드 가능한 이력
하위 호환성 검토에 필요한 이전 값과 새 값, JSON Pointer, 위험 수준을 한 줄씩 남깁니다. 구조화된 JSON 보고서를 저장할 수 있습니다.
판정하지 않는 부분
- 완전한 호환성 증명은 아님
- JSON 스키마 비교에서 위험이 없다는 표시는 지원한 규칙에만 해당합니다. 모든 문서와 애플리케이션 동작을 증명하지 않습니다.
- 참조는 가져오지 않음
- $ref나 oneOf를 확장하지 않고 검토 대상으로 둡니다. 외부 주소를 요청하거나 로컬 참조 순환을 분석하지 않습니다.
- 속성 정의는 필수 선언과 다름
- properties에 새 필드가 생겨도 required에 없다면 필수는 아닙니다. additionalProperties 같은 규칙이 있어 추가 자체는 검토 대상입니다.
JSON 스키마 비교 자주 묻는 질문
이 JSON 스키마 검사기는 어떤 차이 모드를 지원하나요?
옛 계약과 새 계약에서 구조와 제약을 비교하고 데이터 방향별 위험을 표시합니다. 텍스트 diff 모드는 없습니다.
정규화된 모드가 스키마 키 순서를 무시하나요?
네. 객체 키 순서와 required·enum 값의 순서만 바뀌었다면 구조 변화로 세지 않습니다.
$ref가 많은 스키마에도 도움이 되나요?
$ref 경로는 보여 주지만 참조 대상을 해석하지는 않습니다. 외부 URL도 호출하지 않습니다.
JSON 비교와 일반 텍스트 비교는 무엇이 다른가요?
JSON 비교는 값의 구조를, 일반 텍스트 비교는 문자 위치를 봅니다. 이 도구는 일부 스키마 제약의 방향도 설명합니다.
데이터가 업로드되나요? 얼마나 큰 파일까지 비교할 수 있나요?
업로드하지 않습니다. 각 입력은 최대 50만 자, 합계는 100만 자이며 초과하면 부분 판정을 내지 않습니다.
함께 확인할 스키마 사례가 있나요?
지금 JSON 스키마 비교하기
두 버전을 놓고 데이터 흐름을 지정한 뒤 결과 경로를 확인하세요. JSON 스키마 비교 보고서를 배포 기록과 함께 보관할 수 있습니다.