Styxis
Company
Knowledge

Beam Go INT16 wire 변경: 999의 바이트와 기존 저장 행을 함께 보기

새 cross-SDK wire 계약과 기존 Go 저장 바이트의 migration을 함께 검사해야 한다. 자체 round-trip 성공만으로 서로 다른 coder의 호환성을 승인하지 않는다.

새 호환성과 기존 자료

새 cross-SDK wire 계약과 기존 Go 저장 바이트의 migration을 함께 검사해야 한다. 자체 round-trip 성공만으로 서로 다른 coder의 호환성을 승인하지 않는다. Truthound에는 writer 판본·원시 바이트·reader 결과를 함께 전달해야 migration 대상이 드러난다. 새 reader의 성공으로 기존 파일까지 모두 호환된다고 안내하지 않는다. [1, 2, 3]

같은 길이의 다른 바이트

Beam #40151은 Go reflection row coder가 INT16에 varint를 쓰지만 Java·Python은 2-byte big endian을 써 교환되지 않는 코드 보고다. 수정은 기존 저장 Go 행에 wire 호환성 변경을 만든다. 같은 숫자 999를 양쪽이 서로 다른 두 바이트로 내보내는 점이 핵심이다. 값이 작아도 byte 수가 같다는 이유로 동일 encoding이라고 판단하지 않는다. [1]

writer 세대별 읽기 대조

값 999의 raw bytes와 Go·Java·Python readback을 대조하고, 기존 저장 행은 writer 세대별로 나눠 전환한다. row header와 값 바이트를 분리하고 signed·unsigned 선언을 남긴다. writer 세대별로 기존 자료를 구분한 뒤 서로 다른 reader의 readback을 수집한다. [1, 3]

999를 직접 분해하기

설명용 INT16 값 999는 3×256+231이므로 2-byte big endian 기대 hex는 03e7이다. e707은 이 계약과 다르다. row header를 제외한 값 바이트만 비교한다. 03e7은 이 값 바이트 조건을 충족하고 e707은 실패다. 전체 row header를 포함한 문자열을 이 두 바이트에 직접 비교해서는 안 된다. [1, 3]

framing 뒤의 비교

Truthound Core Python SDK 3.3.2의 ColumnPairValidator로 canonical_int16_hex와 encoded_value_hex를 relationship="=="로 비교한다. 운영자가 framing을 해독하고 동일 값의 정규 hex 문자열을 준비해야 한다. SDK는 Beam coder를 패치하거나 기존 wire를 자동 변환하지 않는다. [1, 2, 3]

migration에서 더 볼 항목

기존 포맷 reader를 분리한 migration과 수정 writer의 교차 시험을 함께 진행한다. 값 바이트뿐 아니라 전체 schema·null 표시·후속 필드도 대사한다. 저장 자료가 없다면 migration 범위는 작아질 수 있지만 다른 SDK와의 실제 교환 시험은 여전히 필요하다. [1, 3]

적용 조건

wire framing과 값 바이트를 분리하고 signed·unsigned 선언 및 기존 writer 버전을 기록한다.

대안

기존 Go 포맷을 읽는 migration 단계를 분리한 뒤 수정 writer와 복수 SDK reader를 교차 시험한다.

한계

  • Truthound는 Beam coder를 패치하거나 기존 바이트를 자동 변환하지 않는다. 값 바이트 일치만으로 전체 schema 호환성을 증명하지 않는다.

근거

사건 확인일
대상 확인일
수정일