Oracle Integration Cloud (Gen3): FTP 트리거를 사용한 파일 폴링

Source: Dev.to

맞춤 스케줄러 없이 파일 기반 통합 자동화 (OIC Gen3 24.10+)

파일 기반 통합은 여전히 매우 흔합니다—일일 CSV 추출, 레거시 시스템에서 내려오는 XML, 혹은 FTP/SFTP를 통한 배치 파트너 피드 등.

Oracle Integration Cloud (OIC) Gen3 24.10 이전에는 파일이 도착했을 때 통합을 트리거하려면 다음이 필요했습니다:

• 스케줄된 통합
• 외부 스크립트
• 맞춤 폴링 로직

Gen3에서는 네이티브 파일‑폴링 트리거가 도입되어 모든 것이 간단해졌습니다.

언제 파일 폴링을 사용해야 할까요?

다음 상황에 이 기능을 사용하세요:

• 파일 크기가 작거나 중간 정도일 때
• 파일 도착 즉시 트리거하고 싶을 때
• 별도의 파일 다운로드 로직이 필요 없을 때
• 저코드, 네이티브 OIC 패턴을 선호할 때

전형적인 사용 사례:

• 일일 CSV 또는 XML 보고서
• 경량 배치 통합
• 파트너 파일 드롭
• 스테이징 기반 데이터 수집

OIC Gen3 24.10+에서 새로 나온 기능

FTP 파일‑폴링 트리거를 사용하면 다음을 할 수 있습니다:

• 파일이 도착하면 자동으로 통합을 트리거
• 파일명 패턴으로 파일 매칭
• 파일 내용을 바로 페이로드로 로드
• 아카이브, 삭제, 거부 동작 제어
• 추가 어댑터나 스크립트 없이 구현

단계별 가이드: OIC에서 파일 폴링 설정하기

1. OIC 버전 확인

인스턴스가 Oracle Integration Cloud Gen3 – 24.10 이상인지 확인하세요.
파일 폴링은 이전 Gen3 빌드에서는 제공되지 않습니다.

2. FTP / SFTP 연결 구성

Trigger & Invoke 역할을 가진 FTP 어댑터 연결을 새로 만들거나 기존 연결을 재사용합니다:

• 호스트, 포트, 인증 정보
• 소스 디렉터리 권한
• 선택적 아카이브/거부 디렉터리

진행하기 전에 연결을 테스트합니다.

3. 파일‑폴링 트리거 사용

통합을 만들 때:

1. 트리거로 FTP 어댑터를 선택합니다.
2. 트리거 유형으로 File Polling을 선택합니다.

구성 항목:

• 폴링 빈도(예: 5분마다)
• 소스 디렉터리
• 파일명 패턴(예: *.csv)
• 스키마 유형(CSV / XML)

스키마 생성을 위해 샘플 파일을 업로드할 수 있어 별도의 파일‑서버 읽기 단계가 필요 없습니다.

4. 파일 처리 동작 설정

파일을 읽은 후 수행할 작업을 정의합니다:

• 📦 Archive(아카이브) 파일
• 🗑️ Delete(삭제) 성공적으로 읽은 후
• 🚫 Reject(거부) 잘못된 파일
• ⚠️ Ignore delete errors(삭제 오류 무시)하여 재시도 방지

이 옵션들은 멱등성 유지와 정리 작업에 도움이 됩니다.

5. 통합 흐름 설계

트리거 이후:

• 생성된 스키마를 사용해 파일 내용 파싱
• 데이터를 다운스트림 시스템으로 라우팅
• 검증 및 변환 적용
• 거부 로직으로 오류 처리

파일 내용이 이미 페이로드로 제공되므로 수동 스트리밍이 필요 없습니다.

6. 개념 증명(POC) 테스트

프로덕션 적용 전:

• 패턴에 맞는 테스트 파일을 드롭합니다.
• 통합이 즉시 트리거되는지 확인합니다.

검증 항목:

• 파일 이동(아카이브/삭제) 여부
• 페이로드 파싱 결과
• 오류 처리 동작

7. 배포 및 모니터링

검증이 끝나면:

• 통합을 활성화합니다.
• 파일 실행에 대한 트래킹을 모니터링합니다.
• 필요 시 폴링 빈도나 파일 규칙을 조정합니다.