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에서 이슈를 가져와요. 두 가지 검색 모드를 제공해요:

  1. Simple Search — 프로젝트 이름, 상태 카테고리, 생성/수정 날짜로 필터링
  2. 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 명령문 타입

See also

더 알아보기 (Learn more)