table_compare_v0.21 (표 비교 프로그램)

Excel Compare Tool (v0.21) 사용자 설명서

본 프로그램은 두 개의 엑셀 파일 또는 동일 엑셀 파일 내의 서로 다른 시트를 비교하여 추가, 삭제, 변경, 동일 항목을 정밀하게 추출하고 시각화해 주는 엑셀 데이터 비교 분석 도구입니다.

이번 v0.21 업그레이드를 통해 헤더(머리글) 미포함 비교 기능, 중복 데이터 감지 경고 시스템, 중복 정보 기록 기능, 동일 파일 내 시트 비교 시 파일 추가 간편화 기능이 추가되었습니다.

📌 목차
1. 화면 인터페이스 구성
2. 단계별 사용 가이드
- Step 1: 상단 기본 옵션 설정
- Step 2: 파일 및 시트 선택
- Step 3: 비교 기준 컬럼(Key) 지정
- Step 4: 비교 실행 및 데이터 검증
- Step 5: 결과 미리보기 확인
- Step 6: 서식 포함 엑셀 결과 저장
3. 비교 결과 상태 및 색상 구분 안내
4. 결과 엑셀 시트 구성
5. 실전 활용 시나리오
6. 자주 묻는 질문 (FAQ) 및 문제 해결

1. 화면 인터페이스 구성

+-----------------------------------------------------------------------------------+
| ⚙️ 비교 대상 설정: (o) 다른 파일 간 비교 ( ) 동일 파일 내 시트 비교            |
| ⚙️ 헤더(머리글) 설정: (o) 헤더 포함 ( ) 헤더 미포함                                   |
+-----------------------------------------------------------------------------------+
| [1번 파일 설정]                                                                                          |
| [ 파일 경로 입력란 ....................... ] [ 파일 선택 ]                                        |
| 시트 선택: [ Sheet1 v ] | 머리글 행 번호: [ 1 ] | 비교 행 수: [ 제한 없음 (0) ] |
| 비교 기준 컬럼 1: [ 사번 / ID v ] |
+-----------------------------------------------------------------------------------+
| [2번 파일 설정]                                                                                          |
| [ 파일 경로 입력란 ....................... ] [ 파일 선택 ]                                        |
| 시트 선택: [ Sheet1 v ] | 머리글 행 번호: [ 1 ] | 비교 행 수: [ 제한 없음 (0) ] |
| 비교 기준 컬럼 1: [ 사원번호 v ] |
+-----------------------------------------------------------------------------------+
| [ ➕ 비교 기준 컬럼 추가 ] [ ➖ 최근 추가된 컬럼 삭제 ] |
| [ ▶️ 비교 실행 ] [ 💾 결과 저장 ]                                                               |
| 상태: [ 대기 중 / 진행률 바 ........................... ]                                            |
+-----------------------------------------------------------------------------------+
| 📋 결과 미리보기 테이블 (상위 50행 색상 강조 출력)                                   |
+-----------------------------------------------------------------------------------+

2. 단계별 사용 가이드

Step 1: 상단 기본 옵션 설정
- 비교 대상 설정
• 다른 파일 간 시트 비교 (기본값): 서로 다른 두 개의 엑셀 파일(.xlsx, .xls, .xlsm)을 비교할 때 선택합니다.
• 동일 파일 내 시트 비교: 하나의 엑셀 파일 내에 있는 두 시트(예: '1월실적'과 '2월실적')를 비교할 때 선택합니다. 1번 파일을 불러오면 2번 파일 경로가 자동으로 연동됩니다.

- 헤더(머리글) 설정
• 헤더 포함 (첫 행을 열 이름으로 사용) (기본값): 엑셀 표의 첫 행(또는 지정 행)에 컬럼명이 존재하는 일반적인 경우 선택합니다.
• 헤더 미포함 (열 번호 자동 생성): 머리글이 없는 원시 데이터일 때 선택하며, 컬럼명이 1열 (A), 2열 (B) 형태로 자동 생성됩니다.

Step 2: 파일 및 시트 선택
- 1번 파일 / 2번 파일 로드: 파일 선택 버튼을 클릭하여 비교할 엑셀 파일을 불러옵니다.
- 시트 선택: 드롭다운 목록에서 비교 대상 시트를 선택합니다.
- 머리글 행 번호 (또는 데이터 시작행): 엑셀 파일 상단에 제목/빈 행 등이 있어 실제 컬럼명이 2행 또는 3행부터 시작하는 경우, 해당 행 번호를 지정합니다.
- 비교 행 수 (행 제한): 대용량 파일에서 상위 N개 행만 빠르게 테스트 비교하고 싶을 때 숫자를 지정합니다. (기본값 0은 전체 행 비교)

Step 3: 비교 기준 컬럼(Key) 지정
데이터를 매칭할 고유 식별 기준(Primary Key / Composite Key)을 선택합니다.
- 기본 기준 선택: 1번 파일과 2번 파일의 드롭다운에서 서로 매칭할 기준 컬럼(예: 식별키, 사번, 고객코드, 주문번호 등)을 선택합니다. 1번 파일의 컬럼명과 2번 파일의 컬럼명이 달라도 위치나 의미가 같으면 매핑 가능합니다.
- 다중 기준 컬럼(복합키) 추가: 단일 컬럼만으로 행을 식별하기 어려운 경우(예: 부서 + 이름 조합), '➕ 비교 기준 컬럼 추가' 버튼을 클릭하여 2개 이상의 기준 컬럼 쌍을 지정할 수 있습니다. 필요 없는 경우 '➖ 최근 추가된 컬럼 삭제' 버튼으로 제거합니다. (최소 1개 유지)

Step 4: 비교 실행 및 데이터 검증
- '비교 실행' 버튼을 클릭합니다.
- 중복 데이터 감지 알림창: 선택한 기준 컬럼에 동일한 키 값이 2개 이상 존재하는 경우 경고창이 나타납니다. 예(Yes)를 클릭하면 프로그램이 중복 순번(_seq_id_)을 부여하여 순차 매칭(1번째 중복은 1번째끼리, 2번째 중복은 2번째끼리)으로 비교를 계속 진행합니다. 결과 파일의 1번파일_중복여부, 2번파일_중복여부 열에 중복(0), 중복(1) 등으로 명시됩니다.

Step 5: 결과 미리보기 확인
- 비교가 완료되면 하단 테이블에 상위 50건의 결과가 미리보기 형태로 출력됩니다.
- 행의 상태(추가/삭제/변경)에 따라 배경색과 글자색이 자동으로 적용되어 한눈에 차이점을 파악할 수 있습니다.
- 원본 엑셀에서의 실제 행 번호(1번파일_행번호, 2번파일_행번호)가 함께 표기되어 원본 파일 추적이 용이합니다.

Step 6: 서식 포함 엑셀 결과 저장
- '결과 저장' 버튼을 누릅니다.
- 저장할 파일명(예: compare_result.xlsx)과 경로를 지정합니다.
- 저장 완료 알림과 함께 윈도우 파일 탐색기가 열리며 생성된 엑셀 파일이 자동 선택됩니다.

3. 비교 결과 상태 및 색상 구분 안내

[상태 (Status)] | [화면/엑셀 색상] | [설명]
----------------+-------------------------------+---------------------------------------------------------------------------------
File_1_Only | 🟢 연한 녹색 배경 / 진녹색 글씨 | 1번 파일에만 존재하고 2번 파일에는 없는 데이터 (삭제/누락 항목)
File_2_Only | 🔴 연한 분홍 배경 / 진붉은 글씨 | 2번 파일에만 새로 추가된 데이터 (신규 추가 항목)
변경 | 🔵 연한 파란색 행 배경 | 기준 컬럼은 일치하지만 다른 세부 열의 데이터가 수정된 행
└ 변경된 셀 | 🟠 주황색 배경 / 흰색 굵은 글씨 | 변경된 행 내에서 실제 값이 달라진 해당 컬럼 셀을 즉시 식별하도록 강조
동일 | ⚪ 흰색 배경 / 검정 글씨 | 모든 열의 데이터가 완전히 일치하는 항목

4. 결과 엑셀 시트 구성

저장된 엑셀 파일(.xlsx)은 용도별로 쉽게 필터링하여 볼 수 있도록 총 5개의 시트로 분리되어 생성됩니다.
- 비교결과 시트: 전체 데이터가 통합되어 있으며, 원본 행 번호, 중복 여부, 변경 사항이 색상 서식과 함께 표시됩니다.
- File_1_Only 시트: 1번 파일에만 있는 데이터만 모아둔 시트
- File_2_Only 시트: 2번 파일에 새로 추가된 데이터만 모아둔 시트
- 변경 시트: 값이 변경된 데이터와 변경된 셀(주황색)만 모아둔 시트
- 동일 시트: 변경 없이 동일한 데이터 목록

5. 실전 활용 시나리오 (인사 정보 + 급여 정보 테이블 합치기)
입력 데이터:
*1번 파일: [사원번호, 이름, 부서]
*2번 파일: [사원번호, 급여, 은행계좌]
작업 방식: 사원번호를 🔑 키값으로 잡고 실행합니다.
결과: 중복사항이 표시되고, 퇴사자 및 신규 입사자 정보까지 누적/통합된 완벽한 인사-급여 마스터 표가 구축됩니다.

6. 자주 묻는 질문 (FAQ) 및 문제 해결

Q1. "모든 항목을 설정하세요" 또는 "비교 기준 컬럼의 개수가 서로 다릅니다" 경고가 뜹니다.
A: 파일, 시트, 비교 기준 컬럼이 모두 빠짐없이 선택되었는지 확인해 주세요. 1번 파일 기준 컬럼 개수와 2번 파일 기준 컬럼 개수가 동일해야 합니다.

Q2. 컬럼명이 제대로 로드되지 않고 데이터 내용이 컬럼명으로 들어옵니다.
A: 엑셀 파일 상단에 타이틀이나 빈 행이 있는 경우입니다. 머리글 행 번호 스핀박스를 조정하여 실제 컬럼명이 위치한 행 번호(예: 2 또는 3)를 입력하세요.

Q3. "해당 파일이 이미 엑셀 등 다른 프로그램에서 열려 있습니다" 오류가 발생합니다.
A: 저장하려는 경로에 동일한 이름의 엑셀 파일이 열려있어 윈도우 파일 잠금이 걸린 상태입니다. 엑셀을 닫고 다시 저장을 시도하세요.

Q4. .xls 확장자 파일도 비교할 수 있나요?
A: 네, xlrd 라이브러리가 내장 엔진으로 동작하여 구버전 .xls 파일도 완벽하게 지원합니다.