Gemini CSV 데이터 품질 검수 프롬프트: 표본 오류와 전체 집계 구분

입력값 가이드

CSV 데이터 품질 검수는 형식이 읽히는지 확인한 뒤, 열의 의미를 검사하고, 마지막에 집계 범위를 제한하는 작업입니다. 분석 전에 내보낸 주문 파일을 점검하는 운영·분석 담당자에게 적합합니다. Gemini의 텍스트 대화에 표본을 붙여 넣는 방식이며 파일 업로드, 코드 실행, 전체 파일 접근을 전제로 하지 않습니다.

원본의 복사본과 열 정의가 필요합니다. 고객 이름이나 연락처는 제거하되, 중복 여부를 확인할 수 있도록 같은 고객에는 같은 가명 키를 사용하세요. 처음 몇 줄만 고르면 특정 날짜나 정상 주문만 포함될 수 있으므로 표본을 어떻게 골랐는지도 적습니다.

상세 입력 예시

다음은 설명을 위해 만든 가상 주문 표본입니다. amount는 필수 숫자 필드이며 결측을 허용하지 않습니다. 빈 필드를 결측으로 판정하고, 0은 정상 금액으로 허용합니다. 날짜는 YYYY-MM-DD로 표기된 실제 달력 날짜여야 합니다. unit은 KRW만 허용하지만 원본 값은 바꾸지 않습니다.

order_id,ordered_on,amount,unit,note
A101,2026-09-01,12000,KRW,"정상, 첫 주문"
A102,2026-09-02,,KRW,금액 확인 필요
A103,2026-09-03,12,천원,이관 자료
A103,2026-09-03,12000,KRW,중복 여부 확인
A105,2026-02-30,0,KRW,날짜 확인 필요

헤더 다음을 데이터 레코드 1로 셉니다. 첫 레코드의 "정상, 첫 주문"은 하나의 필드이므로 쉼표로 단순 분할해서 열이 늘었다고 판단하면 안 됩니다. 줄바꿈을 포함하는 필드가 있는 실제 파일에서는 물리적 줄 번호와 레코드 번호도 달라질 수 있습니다.

CSV 검수 진행 순서

1. 파싱 계약을 고정합니다. 구분자와 인용부호가 맞는지, 모든 레코드가 같은 열 수로 읽히는지 확인합니다. 이 단계가 실패하면 금액 합계를 계산하지 않습니다.
2. 스키마를 적용합니다. 표본 안에서 날짜 유효성, 필수값, 단위, 키 중복을 각각 검사합니다. 음수를 허용하지 않는다는 규칙처럼 업무가 결정하는 조건은 반드시 입력으로 명시합니다.
3. 오류와 수정안을 분리합니다. 12,천원을 12000,KRW로 바꾸는 것은 가능한 수정 후보입니다. 하지만 이관 규칙을 확인하기 전에는 승인된 수정이 아닙니다.
4. 원본 도구에서 전체 검사를 실행합니다. CSV 파서나 데이터베이스로 같은 조건을 전체 파일에 적용하고, 실패 레코드 목록과 전체 레코드 수를 저장합니다. 대화 답변은 그 실행을 대신하지 않습니다.

설명용 출력 예시

아래는 작성자가 구성한 검수 예시이며 실제 Gemini 실행 결과가 아닙니다.

표본 5개 레코드 중 금액 결측은 1개입니다. 문제에 관련된 고유 레코드는 2·3·4·5의 4개이며, 중복 키 그룹은 1개입니다. 이 값은 전체 파일의 품질 지표가 아닙니다. 레코드 5의 금액 0은 주어진 규칙상 오류가 아닙니다.

전체 검사 명세에는 “파싱 성공 레코드를 분모로 하는 금액 결측 수”와 “파싱 실패 레코드 수”를 별도로 둡니다. 파싱 실패를 조용히 제외하면 품질이 좋아 보일 수 있습니다. 중복 키 검사도 중복 그룹 수와 해당 레코드 수 중 무엇을 보고하는지 정해야 합니다.

실패 및 검증 체크리스트

• 원문을 CSV 파서로 읽어 첫 레코드가 정확히 5개 필드인지 확인했나요?
• 결측값과 0을 구분하고, 문자열 공백 처리 규칙을 명시했나요?
• 단위 충돌을 값 오류와 구분했으며 환산을 승인 없이 적용하지 않았나요?
• 중복 키 두 레코드를 같은 위치로 합쳐 버리지 않았나요?
• 표본 집계의 분모와 전체 파일 미검수 상태가 보이나요?
• 수정 후 같은 검사를 다시 실행하고 원본 대비 변경 레코드를 대조했나요?

잘못된 값이 하나도 보이지 않아도 “전체 데이터 정상”이라고 결론 내리지 않습니다. CSV 검수의 종료 기준은 표본에서 찾은 규칙이 전체 검사로 이어지고, 확인되지 않은 수정이 남김없이 분리된 상태입니다.

후속 프롬프트

앞선 CSV 검수표와 아래 전체 검사 결과를 대조하세요.
검수표: {{기존_검수표}}
실제 실행한 검사 조건과 결과: {{전체_검사_결과}}
승인된 보정 규칙: {{승인_규칙}}
표본에서만 보인 문제, 전체에서도 재현된 문제, 아직 확인하지 못한 문제를 나누세요.
전후 건수의 분모가 다르면 변화율을 계산하지 마세요.
원본 보존 여부와 보정 후 다시 실행할 검사만 제시하고 직접 수정했다고 말하지 마세요.

출처와 편집 기준

• RFC 4180 CSV 형식 설명: 쉼표·줄바꿈을 포함한 필드의 인용과 이중 인용부호 처리 근거입니다. 모든 CSV 구현을 강제하는 표준이라는 뜻은 아닙니다.
• Google의 프롬프트 설계 지침: 목표, 맥락, 제약, 출력 형식과 반복 검증을 분리하는 구성의 근거입니다.

레코드별 검수표, 수정 승인 절차, 표본과 전체 집계의 분리는 이 가이드의 편집상 권고입니다. 공식 문서가 이 예제의 검수 성능을 보장하지 않습니다.