RetryFlowFile
RetryFlowFile
FlowFile의 'Retry Attribute' 값을 구성된 'Maximum Retries' 값과 비교해, 한도 내면 재시도 관계로, 초과하면 재시도 초과 관계로 보내는 프로세서예요. 제한된 재시도 피드백 루프를 만드는 데 써요.
출처: Snowflake 문서
본문
번들 (Bundle)
org.apache.nifi | nifi-standard-nar
설명 (Description)
이 Processor에 전달된 FlowFile은 구성된 'Maximum Retries' 값에 대해 'Retry Attribute' 값이 확인됩니다. 현재 속성 값이 구성된 최댓값보다 낮으면 FlowFile은 retry 관계로 전달됩니다. 해당 조건에서 FlowFile은 페널티를 받을 수도 있고 받지 않을 수도 있습니다. FlowFile의 속성 값이 구성된 최댓값을 초과하면 FlowFile은 'retries_exceeded' 관계로 전달됩니다. 경고: 들어오는 FlowFile이 구성된 'Retry Attribute' 속성에 숫자가 아닌 값을 가지고 있으면 '1'로 재설정됩니다. 재설정 대신 FlowFile을 실패 처리하도록 선택할 수도 있습니다. 'retries_exceeded'로 전송되는 FlowFiles에 추가하려는 모든 속성에 대해 추가 동적 속성을 정의할 수 있습니다. 이러한 속성은 속성 표현 언어(attribute expression language)를 지원합니다.
태그 (Tags)
FlowFile, Retry
입력 요구사항 (Input Requirement)
REQUIRED
민감 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false
속성 (Properties)
| 속성 (Property) | 설명 (Description) |
|---|---|
| Fail on Non-numerical Overwrite | FlowFile이 이미 'Retry Attribute'에 정의된, 숫자가 아닌 속성을 가지고 있다면 그 값을 '1'로 재설정하는 대신 FlowFile을 실패 처리합니다. |
| maximum-retries | FlowFile이 'retries_exceeded' 관계로 전달되기 전에 재시도할 수 있는 최대 횟수입니다. |
| penalize-retries | 'true'로 설정하면 이 Processor는 FlowFile을 'retry' 관계로 전달하기 전에 입력 FlowFile에 페널티를 부여합니다. 이는 'retries_exceeded' 관계에는 적용되지 않습니다. |
| retry-attribute | FlowFile의 현재 재시도 횟수를 담고 있는 속성의 이름입니다. 경고: 이름이 FlowFile에 이미 있는 숫자가 아닌 속성과 일치하면, 프로세서는 구성에 따라 해당 속성을 '1'로 덮어쓰거나 실패 처리합니다. |
| reuse-mode | 재시도 FlowFile이 FlowFile을 받은 인스턴스와 다른 재시도 UUID를 가질 때 프로세서가 어떻게 동작할지 정의합니다. 이는 일반적으로 이 프로세서의 이전 인스턴스에서 성공적으로 재시도된 후 속성이 재설정되지 않았다는 뜻입니다. |
관계 (Relationships)
| 이름 (Name) | 설명 (Description) |
|---|---|
| failure | 프로세서가 'Retry Attribute'의 숫자가 아닌 값에 대해 재설정 대신 실패가 발생하도록 구성된 경우입니다. 이는 제한된 피드백 루프를 즉시 종료합니다. 'Maximum Retries'가 Integer로 해석되지 않는 속성 표현 언어를 포함하는 경우도 여기에 해당할 수 있습니다. |
| retries_exceeded | 입력 FlowFile이 구성된 최대 재시도 횟수를 초과했습니다. 제한된 피드백 루프를 종료하려면 이 관계를 입력 Processor로 다시 전달하지 마세요. |
| retry | 입력 FlowFile이 구성된 최대 재시도 횟수를 초과하지 않았습니다. 제한된 피드백 루프를 만들기 위해 이 관계를 입력 Processor로 다시 전달하세요. |
쓰는 속성 (Writes attributes)
| 이름 (Name) | 설명 (Description) |
|---|---|
| Retry Attribute | 사용자 정의 재시도 속성이 현재 재시도 횟수로 갱신됩니다. |
| Retry Attribute .uuid | 마지막으로 FlowFile을 재시도한 프로세서를 결정하는 .uuid가 붙은 사용자 정의 재시도 속성입니다. |