PapaParse unparse의 첫 행 헤더 추론: 뒤늦은 선택 필드 보존
CSV 내보내기 실험은 첫 행의 대표성보다 명시된 전체 필드 계약을 기준으로 설계해야 한다.
PapaParse unparse의 첫 행 헤더 추론: 뒤늦은 선택 필드 보존
객체 배열의 첫 행에 없는 필드도 승인한 내보내기 스키마에는 포함될 수 있다. 첫 행만 보고 열을 정하면 뒤쪽의 선택 정보가 파일에서 사라져도 초기 미리보기는 정상처럼 보인다. 선택 필드가 처음 등장하는 위치와 공개 승인 목록을 분리해 관리해야 한다. [1, 2, 3]
공개 원문이 보여 준 범위
PapaParse unparse가 객체 배열 첫 행의 키로 헤더를 만들면서 후속 행에만 있는 키를 출력에서 제외한다는 보고다. 키 누락 행의 빈 셀과 뒤늦게 등장한 추가 키 손실은 다른 경우다. [1]
입력과 출력에서 확인할 관계
선택 필드가 뒤쪽 행에서 처음 나타나는 입력을 준비한다. 명시적으로 선언한 필드 목록을 사용한 결과와 기본 내보내기를 비교하여 승인 필드가 빠졌는지 확인한다. declared_field, first_seen_row, exported_header를 남기면 그럴듯한 첫 줄이 임의의 스키마 결정으로 굳어지는 일을 막을 수 있다. [1, 3]
승인 기준과 실패 사례
설명용 첫 행에는 a와 b가 있고 다음 행에는 a, b, c가 있다. 승인한 내보내기 계약에 c가 포함된다면 머리글 상태는 present여야 하며 absent이면 실패다. 첫 행에 없었다는 사실은 제외 권한이 아니다. 반대로 원천에서 발견한 모든 키를 자동 공개하지 말고 승인 목록을 기준으로 삼아야 내부 필드의 노출을 피할 수 있다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 ColumnExistsValidator는 실제로 읽어 온 출력 CSV 표에 c 열이 존재하는지 검사할 수 있다. discovered key 전체를 자동 공개하지 말고 승인한 필드 목록을 expected schema로 관리한다. 열 존재가 확인된 뒤에는 각 행의 c 값 보존도 따로 대사한다. [1, 2, 3]
다른 선택이 필요한 조건
모든 발견 키를 자동 공개하면 내부 필드까지 내보낼 수 있으므로 무조건 union을 공개 정책으로 삼지 않는다. 승인된 필드 목록을 명시하고 새로운 키는 스키마 변경 검토로 보낸다. 승인된 내보내기 스키마가 a·b뿐이면 c 제외는 손실이 아니라 의도한 투영이다. [1, 3]
적용 조건
declared_field, first_seen_row, exported_header 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
승인된 필드 목록을 명시하고 새로운 키는 스키마 변경 검토로 보낸다.
한계
모든 발견 키를 자동 공개하면 내부 필드까지 내보낼 수 있으므로 무조건 union을 공개 정책으로 삼지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
