Truthound · 스키마와 타입 계약 · 1/6
필드 이름·타입·키의 의미를 버전 사이에서 보존합니다.
119 편
AppLocker hash 뒤의 이웃 필드: hex 형식과 byte 경계를 따로 검사하기
hex 문자 모양과 필드 경계는 다르다. 승인된 hash 길이와 원본 bytes를 확인하기 전에는 이웃 필드가 섞인 값을 식별자로 사용하지 않는다.
upb JSON nanos: Timestamp의 -1과 Duration의 음수를 다르게 안내하기
같은 nanos 필드도 메시지 종류에 따라 허용 범위가 다르다. encode 전에 각 타입의 범위·부호 계약을 확인해야 한다.
Debezium PostgreSQL TOAST 배열: 빠진 필드를 빈 배열로 덮어쓰지 않기
제공되지 않은 TOAST 배열과 실제 빈 배열 변경을 구별하고, sink의 덮어쓰기 결정을 검사한다.
ProtoJSON quoted 숫자의 언어별 차이: raw token에서 교환 규칙 정하기
언어별 숫자 수용과 교환 입력 계약을 분리해야 한다. 수신 경계에서 승인한 ASCII 숫자 정책을 적용하고 원문은 별도로 보존한다.
ProtoJSON 객체 재사용: merge와 전체 교체를 다른 시연으로 보기
파서의 merge 계약과 화면의 전체 교체 의도를 먼저 구별해야 한다. 새 입력에 없는 필드가 이전 출력 객체에서 남는 경우에는 객체 수명과 초기화 경로를 확인해야 한다.
Java ProtoJSON extension: short name 대신 승인한 qualified key 확인하기
extension의 완전한 정체성과 짧은 표시 이름을 구별해야 한다. 소비자가 해석할 qualified JSON key를 승인한 뒤 출력한다.
PostgreSQL publication 열이 어긋났다면: 재시작 전 구간까지 대사하기
재시작이 증상을 없애도 snapshot 시작부터 재시작 전까지의 값 배치가 옳았다는 증거는 아니다. Relation의 공개 열 순서와 refresh 후 해석 순서를 비교해야 한다.
Osquery live query의 빈 화면: 정정된 space_id 전달 경로부터 확인하기
결과 부재와 space 정보의 전달 실패를 구별해야 한다. 초기 수정 설명보다 후속 정정을 따라 action에서 결과까지 실제 space가 보존되는지 확인한다.
OpenSearch snapshot failure의 index_uuid: 이름과 세대를 나눠 설명하기
자체 왕복 일치와 실제 index 세대 식별은 다르다. 실패 응답의 UUID는 snapshot 당시 metadata의 UUID와 대조해야 한다.
MySQL 정수 default: 맞는 raw row가 잘못된 schema를 가릴 때
raw row와 schema default를 별도로 대사해야 한다. 기본값을 채우는 소비는 원천의 정수 변환 결과와 schema 값이 맞은 뒤 승인한다.
httpjson Degraded 표시: optional rate-limit header와 실제 polling 실패 구분하기
옵션 헤더 부재와 실제 polling 실패는 다르다. 상태 표시는 서비스가 약속한 헤더 계약과 실제 요청 결과를 함께 반영해야 한다.
GCS CSV의 같은 두 행: payload 중복과 record 정체성 구별하기
객체의 정체성과 객체 안 레코드의 정체성을 분리해야 한다. 내용이 같은 두 행도 서로 다른 관측이라면 payload fingerprint만으로 하나로 합쳐서는 안 된다.
FieldMask JSON hop: 사용자가 고른 path를 다른 경로로 바꾸지 않기
마스크 문자열의 전송 성공보다 선택한 필드 경로의 보존을 확인해야 한다. 비정규 경로를 조용히 다른 경로로 정규화해 승인하지 않는다.
Protobuf enum option {}: wrapper와 string presence를 따로 시험하기
option wrapper의 존재와 string 필드의 존재를 구별해야 한다. string을 생략한 {}는 승인된 fallback 이름을 유지해야 한다.
DynamicMessage map 중복 제보의 정정: repeated KV와 업무 map을 구별하기
wire의 repeated KV 표현과 map으로 관측한 마지막 값 선택을 구별해야 한다. 표현 차이를 곧바로 parser 결함으로 부르지 않는다.
BigQuery 거절 행의 TIMESTAMP: 실패 원장까지 읽을 수 있어야 복구한다
정상 쓰기와 거절 행 인계는 서로 다른 경로다. timestamp 문자열이 실제 failed-row consumer의 해석 계약까지 통과하는지 확인해야 한다.
Beam Reshuffle 뒤 tuple key가 list가 된다면: 값과 컨테이너를 따로 검사하기
tuple의 값 목록과 hashable 컨테이너 계약을 따로 검사해야 한다. schema 경계 뒤 list가 되면 dict key를 요구하는 단계에 그대로 넘기지 않는다.
Go INT32 음수의 10-byte varint: 양수 시험으로 가려지는 교환 경계
부호별 wire 폭과 실제 readback을 구분해야 한다. 양수 성공을 근거로 음수 sentinel이나 측정값을 교환 가능하다고 승인하지 않는다.
Beam Go INT16 wire 변경: 999의 바이트와 기존 저장 행을 함께 보기
새 cross-SDK wire 계약과 기존 Go 저장 바이트의 migration을 함께 검사해야 한다. 자체 round-trip 성공만으로 서로 다른 coder의 호환성을 승인하지 않는다.
Trino timestamp 상한 근처의 precision cast는 날짜까지 확인한다
timestamp 상한 부근의 precision 변환은 전체 연도와 소수초를 보존한 기준으로 검사한다. 검사 도구의 날짜 범위에 먼저 맞추면 조사하려던 이동 자체가 사라질 수 있다.
