Airflow · A03

스케줄과 시간대, 백필

"매일 오전 9시"라고 적었는데 저녁 6시에 돌았다면 시간대 문제입니다. 스케줄 적는 법, 시간대를 정하는 법, 지나간 날짜를 다시 돌리는 백필을 실제 화면으로 확인합니다.


스케줄은 cron 문자열로 적습니다

schedule 값뜻
"0 9 * * *"매일 9시 0분
"0 * * * *"매시 정각
"@daily"매일 0시
None정해진 시간 없이, 누를 때만 실행
[Asset(...)]다른 DAG가 데이터를 갱신하면 실행 (A06장)

시간대를 정하지 않으면 UTC로 돕니다

처음에 start_date=datetime(2026, 11, 1)로 만들었을 때 화면의 다음 실행은 18:00이었습니다. Airflow의 기본 시간대는 UTC라서 "9시"가 UTC 9시, 즉 한국 시간 저녁 6시로 잡힌 것입니다. A02장의 파일처럼 pendulum.datetime(..., tz="Asia/Seoul")로 바꾸자 다음 실행이 09:00으로 바뀌었습니다.

DAG 버전 비교 화면에서 timezone이 UTC에서 Asia/Seoul로 바뀐 기록
Airflow 3는 DAG 파일이 바뀔 때마다 버전을 남깁니다. 버전 탭에서 v1과 v2를 비교하면 /dag/timezone이 UTC에서 Asia/Seoul로 바뀐 것이 보입니다.

catchup과 백필

catchup=False는 DAG를 켤 때 start_date부터 지금까지 밀린 실행을 한꺼번에 만들지 않게 합니다. Airflow 3에서는 기본값이 False입니다. 지나간 날짜를 일부러 다시 돌리고 싶을 때는 백필을 씁니다. 먼저 --dry-run으로 어떤 날짜가 만들어지는지 확인하고 실행합니다.

airflow backfill create --dag-id hello_airflow \
  --from-date 2026-11-15 --to-date 2026-11-18 --dry-run   # 만들어질 날짜만 확인
airflow backfill create --dag-id hello_airflow \
  --from-date 2026-11-15 --to-date 2026-11-18

저희 실행에서는 15·16·17일 세 번이 만들어졌습니다. 18일 실행 시각은 범위 끝(18일 0시)보다 뒤라 빠졌습니다. 끝 날짜가 포함되는지 헷갈리면 dry-run 결과를 보고 정합니다. 백필은 화면의 백필 탭에서도 만들고, 멈추고, 진행 상황을 볼 수 있습니다.

백필 탭에서 진행 중인 백필
백필 탭: 범위·재처리 동작·진행 상태가 한 줄로 남습니다.
이것만 기억하세요

start_date에 tz="Asia/Seoul"을 넣지 않으면 스케줄은 UTC 기준입니다. 지난 날짜는 backfill create --dry-run으로 먼저 확인하고 돌립니다.

다음
A04. 실패와 재시도
이어보기 →