Avro 스키마 호환성 검사기

Avro 스키마 호환성 검사기

새 독자가 이전 스키마로 작성한 데이터를 읽는지, 이전 독자가 새 데이터를 읽는지를 각각 확인합니다. Apache Avro 1.12의 작성자·독자 해석 규칙을 제한된 범위에서 실제 적용하고 가능한 모든 작성자 유니언 분기·enum 심볼을 검사합니다. 승격·기본값·별칭·불일치마다 경로와 근거를 보여줍니다.

Avro 1.12 제한 프로필: 기본형·레코드/enum/fixed·배열/map·유니언·이전 정의 이름 참조·유효한 기본값·독자 측 별칭. 논리 타입은 거부합니다. 스키마당 48 KB·노드 180개·필드 120개·유니언 분기 24개까지입니다. 판정은 스키마용이며 실제 파일 디코딩이나 구현체별 동작은 다루지 않습니다.

이전·새 Avro 스키마 JSON

스키마를 입력하고 분석하세요.

스키마를 업로드하지 않습니다. JSON 보고서에는 붙여 넣은 스키마가 들어갑니다.

댓글과 질문

Avro 스키마 호환성 검사기

새 독자가 이전 스키마로 작성한 데이터를 읽는지, 이전 독자가 새 데이터를 읽는지를 각각 확인합니다. Apache Avro 1.12의 작성자·독자 해석 규칙을 제한된 범위에서 실제 적용하고 가능한 모든 작성자 유니언 분기·enum 심볼을 검사합니다. 승격·기본값·별칭·불일치마다 경로와 근거를 보여줍니다.

주요 기능

  • 이전 작성자→새 독자와 새 작성자→이전 독자를 독립적으로 분석
  • 레코드·enum·fixed·배열·map·유니언·이전 정의 이름 참조를 해석
  • 독자 기본값·작성자 전용 필드·타입 승격·독자 별칭을 표시
  • 모든 작성자 유니언 분기와 enum 심볼의 해석 여부 검사
  • 잘못된 기본값과 미지원 논리 타입을 추측하지 않고 거부
  • 로컬 분석 후 버전이 붙은 JSON 보고서 저장

사용 방법

  1. Account 예제를 불러오거나 이전·새 Avro 스키마 JSON을 입력합니다.
  2. 호환성 분석을 눌러 명시된 제한 범위에서 두 스키마를 해석합니다.
  3. 양방향 판정과 각 규칙·경로를 확인한 뒤 출시 순서를 검토합니다.
  4. 검토 자료가 필요하면 JSON 보고서를 다운로드합니다.

활용 예시

  • 새 소비자가 저장된 이전 레코드를 읽는지 검사
  • 기존 소비자와 새 생산자의 출시 순서 검토
  • 이름을 바꾼 필드에 독자 별칭이 필요한 이유 확인
  • 유니언 분기와 enum 대체값 변경 검토

자주 묻는 질문

필드를 추가하면 항상 이전 데이터가 깨지나요?

새 독자가 작성자에게 없는 필드를 채우려면 그 독자 필드의 유효한 기본값이 필요합니다. 반대 방향도 따로 계산합니다.

별칭은 방향성이 있나요?

예. 이 도구는 독자 스키마가 선언한 타입·필드 별칭을 작성자 이름에 적용합니다.

유니언 분기 하나만 맞아도 호환되나요?

아니요. 모든 가능한 작성자 분기가 독자 분기 중 하나와 맞아야 전체 데이터에 대한 호환 판정입니다.

Avro 파일 디코딩이나 논리 타입도 지원하나요?

아니요. 제한된 스키마 계약을 비교하며 실제 바이너리/JSON 레코드와 논리 타입은 범위 밖입니다.

호환 판정만으로 운영 배포를 승인할 수 있나요?

아니요. 실제 생산자·소비자 구현, 저장된 작성자 스키마와 대표 데이터를 별도로 검증하세요.

개인정보 안내

스키마 텍스트는 브라우저에서 분석하며 도구 API로 전송하거나 자동 저장하지 않습니다. 다운로드 보고서에는 입력 스키마가 포함되므로 프로젝트 자료로 취급하세요.

참고 자료

관련 도구

JSON Schema 검증기스키마 기반 입력 폼 생성기OpenAPI 계약 검사기WebAssembly 모듈 검사기다국어 연결 행렬 검사기구문 트리 질의 실험실컨테이너 빌드 단계 분석기의존성 그래프 탐색기버전 제약 충돌 분석기작업 스케줄 충돌 검사기패치 검토 작업대소스맵 탐색기다국어 카탈로그 검사기구조화 데이터 대조기HTTP 아카이브 분석기웹훅 서명 실험실Protobuf 스키마 작업대GraphQL 스키마 실험실로컬 SQL 데이터 작업대3D 메쉬 검사·복구기관망 유량·압력 실험실로봇팔 운동학 실험열저항 회로 실험실보 휨 실험실기어열 배치 실험공차 누적 실험실센서 교정 곡선 맞추기PCB 적층 비교 설계기디지털 필터 설계기도로망 도달 범위 지도태양 그림자 배치 실험GPS 오차 시뮬레이터디지털 논리 회로 실험아날로그 회로 실험실링크 기구 운동 실험해석용 메쉬 생성기DB 스키마 변경 계획기수식 차원 검사기트러스 힘 실험실논리식 최소화 실험실제어계 응답 실험실대기행렬 시뮬레이터위치 구역 출입 이벤트 실험실좌표계 변환 실험실측량 폐합 검산 실험실위성·래스터 구간 분류단계구분도 설계기지도 인쇄 편집기GeoTIFF 래스터 재투영고도 등고선 생성기지형 가시영역 실험실지형 유역 탐색기오프라인 지도 타일 패키저텍스트 파일 인코딩 작업대파일 경로 호환성 검사기SBOM 라이선스 탐색기파일 형식 위장 검사기npm 잠금 파일 충돌 해결기소스 비밀값 점검기오프라인 웹 자료 패키저인증서 체인 검사기토렌트 메타정보 검사기파일 분할 전송 패키저로컬 파일 암호 금고동일 파일 찾기압축 파일 작업대디자인 토큰 관리기반응형 간격 체계 설계기반응형 타이포 시스템 설계기포장 전개도 설계기SVG 아이콘 스프라이트 묶기Flexbox 배치 설계기CSS Grid 배치 설계기정규 언어 동치 검사기Markdown 문서 묶음 검사기로그 패턴 추출기반응형 HTML 레이아웃 검사기메일 HTML 렌더 검토기내부 링크 구조 분석기상태 전이 모델 테스트 생성기페트리넷 흐름 실험Git 이력 그래프 탐색기HTTP 요청 명령 설계기바이너리 프로토콜 설계기바이너리 Hex 편집기바이너리 차이 패치 만들기파일 전자서명 작업대API 모의 응답 실험실데이터 열 매핑 설계기이벤트 로그 세션 분석기데이터베이스 관계도 설계기시계열 누락 검사기학습 데이터 분할기데이터 흐름 계보 작성기결정트리 학습 실험실데이터 비식별 처리기데이터 계약 규칙 검사기항목 동시출현 분석기robots 규칙 시뮬레이터HTML 검색 기본 검사기접근성 구조 검사기RSS·Atom 피드 작성기IndexNow 배포 알림 준비기검색 로봇 로그 분석기CSP 정책 검토기검색 실적 CSV 분석기CSV 수식 위험 검사기CORS 응답 시뮬레이터HTTP 캐시 동작 실험실쿠키 속성 검사기성능 추적 파일 분석기사이트맵 구조 검사기파일 일괄 이름 바꾸기파일 묶음 무결성 검증기폴더 용량 지도폴더 차이 검토기방문 순서 최적화GeoJSON 지도 편집기지도 영역 중첩 분석기지도 라벨 배치기공간 속성 결합기GeoJSON 공간 위상 검사기GPS 이동 기록 분석기이동 기록 위치 가림표 관계 결합기피벗 테이블 작업대데이터 품질 프로파일러표 데이터 정제 작업대기록 대사 도구데이터 사전 작성기canonical 관계 검사기리다이렉트 계획 검증기HTTP 응답 속도·핑 참고 테스트내 브라우저·시스템 정보JSON ↔ YAML 변환기XML ↔ JSON 변환기HTML 포맷터JavaScript 압축기목 데이터 생성기.gitignore 생성기라이선스 생성기User-Agent 분석기비밀번호 강도 검사코드 이미지 만들기XML 포맷터HTTP 상태 코드 찾기MIME 타입 찾기JS·SQL 문자열 이스케이프CSS 박스 그림자 생성기CSS 그라데이션 생성기들여쓰기 변환기진법 변환기유니코드 이스케이프 변환기유니코드 문자 분석기JSON 구조 비교기Markdown 표 생성기Base64 인코더JSON 포맷터URL 인코더SQL 포맷터Cron 표현식 생성기정규식 테스터UUID 생성기해시 생성기타임스탬프 변환기JWT 디코더HTML 엔티티 변환기Markdown 미리보기CSS Minifier메타태그·OG 생성기JSON CSV 변환대소문자·케이스 변환이미지 Base64 변환
개발 도구 도구 전체 보기 →이미지/미디어 →텍스트/변환 →생활/재미 →