반복 보고서에 새 데이터를 누적하려는데 기존 엑셀 내용이 사라질까 걱정되시나요? 기존 파일의 복사본에서 append 모드와 overlay를 사용하고, 실제 값이 있는 마지막 행과 열 순서를 확인한 뒤 시작 행과 헤더를 지정해야 합니다. 저장한 뒤에는 이전 값과 추가된 값, 다른 시트까지 확인하고 원본에 적용할지 결정하는 편이 안전합니다.
append와 overlay의 역할
ExcelWriter의 기본 쓰기 모드로 같은 이름의 파일을 열면 기존 파일을 덮어쓸 수 있습니다. mode="a"는 기존 통합 문서를 여는 선택이고, if_sheet_exists="overlay"는 대상 시트를 먼저 지우지 않고 지정한 위치에 쓰는 선택입니다. overlay 자체가 빈 행을 찾아 주지는 않으며, 시작 위치를 잘못 지정하면 기존 셀 위에 쓸 수 있습니다. 자세한 내용은 pandas ExcelWriter 공식 문서와 DataFrame.to_excel 공식 문서를 참고하세요.
쓰기 전 데이터 끝과 열을 확인하기
먼저 원본을 복사하고 대상 파일과 시트가 있는지 확인합니다. 파일이 없다면 새 파일을 만들지 별도로 결정하고, 시트가 없다면 이름을 확인한 뒤 새 시트를 만들지 판단하세요.
max_row는 값이 있는 마지막 행을 보장하지 않습니다. openpyxl은 등록된 셀의 좌표를 기준으로 최대 행을 계산하므로 값이 비어 있는 셀도 범위에 영향을 줄 수 있습니다. 서식만 남은 행의 영향은 파일마다 확인해야 합니다. 아래 예제는 등록된 범위에서 실제 값이 있는 마지막 행을 찾습니다. 데이터 아래에 메모나 다른 표가 있는 시트라면 그 내용도 데이터 끝으로 취급하므로, 먼저 표의 범위를 별도로 정해야 합니다. 근거는 openpyxl 워크시트 구현에서 확인할 수 있습니다.
예제는 첫 행이 열 이름이고 나머지는 단일 표인 통합 문서를 가정합니다. 새 데이터의 열 이름과 순서가 기존 헤더와 정확히 다르면 중단합니다. 빈 열이나 중복 헤더, 별도의 표가 있다면 구조에 맞는 검증을 먼저 마련하세요. 가상 입력을 사용한 예제이며 실제 파일에서 실행한 결과는 아닙니다.
from pathlib import Path
from shutil import copy2
import pandas as pd
from openpyxl import load_workbook
source = Path("report.xlsx")
working = Path("report_copy.xlsx")
sheet_name = "Data"
new_data = pd.DataFrame({"name": ["example"], "status": ["ready"]})
if not source.is_file():
raise FileNotFoundError(source)
if working.exists():
raise FileExistsError(working)
if new_data.empty:
raise ValueError("추가할 데이터가 없습니다")
copy2(source, working)
book = load_workbook(working)
try:
if sheet_name not in book.sheetnames:
raise ValueError("대상 시트가 없습니다")
sheet = book[sheet_name]
rows = list(sheet.iter_rows(values_only=True))
last_row = next(
(i for i in range(len(rows), 0, -1)
if any(value is not None for value in rows[i - 1])), 0
)
if not last_row:
raise ValueError("기존 헤더가 없습니다")
header = list(rows[0])
while header and header[-1] is None:
header.pop()
if not header or any(v is None for v in header) or len(set(header)) != len(header):
raise ValueError("헤더에 빈 값이나 중복이 있습니다")
if list(new_data.columns) != header:
raise ValueError("열 이름 또는 순서가 다릅니다")
before = rows[:last_row]
other_sheets = [name for name in book.sheetnames if name != sheet_name]
finally:
book.close()
with pd.ExcelWriter(working, mode="a", engine="openpyxl",
if_sheet_exists="overlay") as writer:
new_data.to_excel(writer, sheet_name=sheet_name, startrow=last_row,
header=False, index=False)
check = load_workbook(working)
try:
saved = list(check[sheet_name].iter_rows(values_only=True))
expected = list(new_data.itertuples(index=False, name=None))
if saved[:last_row] != before:
raise ValueError("기존 값이 달라졌습니다")
if saved[last_row:last_row + len(expected)] != expected:
raise ValueError("추가된 값이 예상과 다릅니다")
if any(name not in check.sheetnames for name in other_sheets):
raise ValueError("다른 시트가 누락됐습니다")
finally:
check.close()
startrow는 출력의 시작 행을 지정하며 기본값은 0입니다. 엑셀에서 확인한 마지막 데이터 행 번호를 이 인자에 넣으면 그 다음 행부터 쓰게 됩니다. 기존 헤더가 있으므로 header=False로 열 이름을 다시 쓰지 않고, index=False로 데이터프레임의 인덱스 열을 추가하지 않습니다.
저장 후 무엇을 비교할까
예제는 대상 시트의 기존 값과 추가된 값을 다시 읽어 비교하고 다른 시트의 이름이 남았는지 확인합니다. 이것만으로 다른 시트의 내용이나 서식이 보존됐다고 판단할 수는 없습니다. 원본과 복사본을 엑셀에서도 열어 다른 시트의 값과 중요한 서식을 비교한 뒤 적용 여부를 결정하세요. openpyxl은 엑셀 파일의 모든 요소를 읽지는 못하므로 열고 저장하는 과정에서 일부 요소가 보존되지 않을 수 있습니다(openpyxl 공식 튜토리얼). 중요한 서식이나 개체가 있는 파일이라면 복사본에서 결과를 확인하기 전까지 원본을 교체하지 않는 편이 좋습니다.
같은 데이터를 다시 실행하면 중복 행이 생기지 않을까요? 이 예제는 중복을 판별하지 않으므로 업무에 맞는 식별 기준과 재실행 정책을 먼저 정해야 합니다. 열 순서가 달라졌다면 자동으로 맞춰 쓰기보다 헤더의 의미를 확인하고 작업을 중단하세요. 저장 결과가 예상과 다르거나 복잡한 서식 보존을 확인할 수 없다면 복사본을 적용하지 말고 별도의 처리 방법을 검토하는 것이 좋습니다.