Truthound · 스키마와 타입 계약 · 5/6
필드 이름·타입·키의 의미를 버전 사이에서 보존합니다.
119 편
Polars is_in pushdown: NULL과 음의 0에서 필터 의미가 달라질 때
백엔드 간 필터 동치를 확인할 때 값 목록만이 아니라 원시 행별 포함 여부를 비교한다.
Polars Map 중복 키: 조회와 사전 변환의 승자가 다를 때
Map을 읽는 방법에 따라 값이 바뀌지 않도록 부모 행 안의 키 유일성과 중복 처리 정책을 먼저 정한다.
Polars CPU·GPU CSV 비교: 빈 문자열과 NULL을 구분하는 검사
같은 String 타입이어도 빈 문자열이 부재 상태로 바뀌면 데이터 계약은 달라진다.
Polars Array에서 NULL 부모의 값이 0으로 보일 때
중첩 값의 유효성은 자식 버퍼만으로 판단할 수 없다. 추출 전 부모 validity를 보존한다.
Iceberg partition spec 변경 후 upsert: 이전 키의 갱신과 삭제를 검사하기
새 파티션에 쓰기가 성공해도 이전 spec에서 기록한 행이 남아 있을 수 있다.
Iceberg Evaluator와 SQL의 NULL 필터를 비교할 때 먼저 정할 것
두 API가 다른 NULL 의미를 의도한다면 단순 결과 차이를 모두 오류로 셀 수는 없다.
DuckDB UNION 변경 전에 숫자 문자열의 표기 계약을 확인하자
UNION과 UNION ALL의 차이가 중복 개수에만 머문다고 가정하면 직렬화되는 숫자 표현을 놓칠 수 있다.
DuckDB WITH RECURSIVE와 NULL 분기: Boolean 스키마를 명시하는 이유
NULL만 반환하는 분기에서도 이후 소비자가 받을 타입은 분명해야 한다.
Doris rowset ID의 대문자 hex: 파싱 성공보다 충돌 여부를 확인하자
비어 있는 rowset에서 발견한 식별자 오류를 데이터 유실로 과장하지 않으면서도 ID 계약은 검증할 수 있다.
DataFusion Parquet Variant 병합 후 NULL 증가: layout별 존재율을 확인하자
원본 필드의 부재와 reader가 표현을 해석하지 못해 만든 NULL은 구분해야 한다.
DataFusion UNION ALL: 계획 schema와 실제 batch 타입을 따로 검증하기
미리 확인한 schema가 실행 후 수신한 batch의 schema와 같은지 export 경계에서 확인해야 한다.
DataFusion Decimal 비교 전에 precision−scale의 정수 자릿수를 확인하자
큰 precision 숫자만 보고 안전한 공통 타입이라고 판단하면 필요한 정수 부분이 사라질 수 있다.
ClickHouse·Iceberg 열 이름 재사용: field ID로 필터 결과를 대조하기
이름이 같다는 이유로 과거 파일의 다른 열 통계를 현재 열에 적용하면 정상 행이 빠질 수 있다.
Iceberg binary truncate는 문자 수가 아니다: ClickHouse prefix 검증
UTF-8처럼 보이는 바이트도 binary 파티션에서는 바이트 길이로 잘라야 한다.
Pydantic validate_call Unpack: 사라진 오타 옵션과 기본값 실행
옵션 값뿐 아니라 요청한 옵션 집합과 실제 수용한 집합을 공유해야 설정 누락을 정상 실행으로 오해하지 않는다.
Pydantic TypeAdapter union: 선택한 분기의 출력 경로를 검증하기
타입 선언만으로 필드 투영이 완료됐다고 믿지 말고 어떤 분기를 선택했고 무엇을 공개했는지 확인해야 한다.
Pydantic exclude_none: 필수 nullable 키와 누락 키를 구별하기
필수 여부는 키의 존재 조건이고 nullable은 값의 허용 조건이므로 팀의 인수표도 둘을 분리해야 한다.
Pydantic MISSING union 직렬화: 부모 타입 밖 필드의 노출 검사
공개할 필드 집합은 런타임 객체가 가진 정보와 별개로 검증해야 이용자가 제공한 정보의 노출 범위를 지킬 수 있다.
Pydantic strict Literal: 정규화된 값과 원시 숫자 토큰 종류
프로토콜이 원래 숫자 타입을 구별한다면 coercion 이후 값만으로 수신 계약을 검증할 수 없다.
Pydantic 정수 Enum JSON 키: 문자열 왕복과 상태 의미 보존
메모리 안의 키 타입과 JSON wire 키는 다르므로 명시적인 양방향 코드 대응표가 필요하다.
