FetchJiraIssues 2025.10.9.21 — Jira 이슈 가져오기 프로세서
FetchJiraIssues 2025.10.9.21 — Jira 이슈 가져오기 프로세서
FetchJiraIssues 프로세서는 구성 가능한 검색 옵션과 함께 REST API v3을 사용해 Jira Cloud에서 이슈를 가져와요. 프로젝트/상태/날짜로 거르는 Simple Search와 사용자 정의 JQL을 쓰는 Advanced Search 두 가지 검색 모드를 제공해요.
출처: Snowflake 문서
본문
기능 — 일반 공개 (Generally Available)
Openflow Snowflake 배포는 AWS, Azure, GCP의 상용 리전에서 모든 계정에 제공돼요.
Openflow BYOC 배포는 AWS의 상용 리전에서 모든 계정에 제공돼요.
Bundle
com.snowflake.openflow.runtime | runtime-atlassian-processors-nar
Description
구성 가능한 검색 옵션과 함께 REST API v3을 사용해 Jira Cloud에서 이슈를 가져와요. 두 가지 검색 모드를 제공해요:
- Simple Search — 프로젝트 이름, 상태 카테고리, 생성/수정 날짜로 필터링
- Advanced Search — 사용자 정의 JQL (Jira Query Language) 표현식 사용
주요 기능:
- 자동 상태 관리가 포함된 스마트 페이지네이션 처리
- 프로세서 실행 사이 타임스탬프를 사용한 증분 동기화(incremental sync) 기능
- Jira 사용자의 시간대를 사용하는 시간대 인지 날짜 처리
- 구성 가능한 이슈 필드 가져오기
- FlowFile에 메타데이터 추가: 소스 URL (jira.source.url), 쿼리 (jira.query.jql), 명령문 타입 (statement.type)
- 다운스트림 처리를 위한 insert, upsert 속성 추가
이 프로세서는 재시작 후 작업을 재개하기 위해 클러스터 상태를 유지해요. 인증은 Jira 이메일/API 토큰 자격 증명을 사용한 기본 인증(basic auth)으로 처리돼요. 현재 지원되는 유일한 방법이에요.
제한 사항:
- Jira 이슈 삭제는 감지되지 않아요.
Tags
api, atlassian, fetch, jira, rest
Input Requirement
ALLOWED
Supports Sensitive Dynamic Properties
false
Properties
| Property | Description |
|---|---|
| API Token | 인증을 위한 Jira API 토큰 |
| Authorization Method | Jira Cloud API에 대한 인증 방법 |
| Created After | 지정된 날짜/시간 이후에 생성된 이슈만 필터링 (선택 사항, 형식: yyyy-MM-dd) |
| Environment URL | Atlassian Jira 환경의 URL |
| Issue Fields | 각 이슈에 대해 반환할 필드 목록이에요. 이 속성은 쉼표로 구분된 목록을 허용해요 |
| JQL Query | JQL 쿼리 문자열 (JQL 쿼리 타입을 사용할 때 필수) |
| Jira Email | Jira 계정과 연결된 이메일 주소 |
| Maximum Page Size | Maximum Page Size 값은 50에서 1000 사이여야 해요 |
| Project Names | Simple search를 위한 쉼표로 구분된 프로젝트 이름 목록 |
| Request Rate Manager | Atlassian API의 속도 제한을 추적하는 컨트롤러 서비스 |
| Search Type | 수행할 검색의 타입 |
| Status Category | Simple search를 위한 상태 카테고리 필터 (선택 사항) |
| Updated After | 지정된 날짜/시간 이후에 수정된 이슈만 필터링 (선택 사항, 형식: yyyy-MM-dd) |
| Web Client Service | Jira에 대한 HTTP 연결을 관리하는 컨트롤러 서비스 |
State management
| Scopes | Description |
|---|---|
| CLUSTER | 재시작 사이에 위치를 유지하기 위해 페이지네이션 상태를 저장해요. 수집 구성이 변경되면 초기화돼요 |
Relationships
| Name | Description |
|---|---|
| retry | 재시도 가능한 실패가 발생했어요 (예: 속도 제한) |
| success | Jira 이슈를 성공적으로 가져왔어요 |
Writes attributes
| Name | Description |
|---|---|
| mime.type | application/json |
| jira.query.jql | 이 가져오기에 사용된 JQL 쿼리 |
| jira.source.url | Jira 소스의 URL |
| statement.type | INSERT, UPSERT 명령문 타입 |