ExecuteStreamCommand 2025.5.31.15¶
번들¶
org.apache.nifi | nifi-standard-nar
설명¶
ExecuteStreamCommand 프로세서는 외부 명령과 스크립트를 NiFi 데이터 플로우에 유연하게 통합할 수 있는 방법을 제공합니다. ExecuteStreamCommand 는 수신 FlowFile 의 내용을 명령에 전달하여 파이핑이 작동하는 방식과 유사하게 실행할 수 있습니다.
입력 요구 사항¶
REQUIRED
민감한 동적 속성 지원¶
true
속성¶
속성 |
설명 |
|---|---|
인자 구분 기호 |
명령의 인자를 구분하는 데 사용할 구분 기호 [기본값: ;] 단일 문자이어야 합니다 |
명령 인자 |
실행 파일에 제공할 인자는 ‘;’ 문자로 구분됩니다. |
명령 경로 |
실행할 명령을 지정합니다. 실행 파일 이름만 제공된 경우, 해당 파일은 사용자의 환경 PATH 에 있어야 합니다. |
Ignore STDIN |
true이면, 수신 flowfile의 내용이 실행 중인 명령에 전달되지 않습니다 |
Max Attribute Length |
스트림 명령의 출력을 특성으로 라우팅하는 경우 특성 값에 넣는 문자 수는 최대 이 정도입니다. 이는 특성이 메모리에 보관되고 특성이 크면 메모리 부족 문제가 빠르게 발생하기 때문에 중요합니다. 출력이 이 값보다 길어지면 출력 길이에 맞게 잘립니다. 가능하면 더 작게 생성하는 것이 좋습니다. |
Output Destination Attribute |
설정하면 스트림 명령의 출력이 별도의 FlowFile 대신 원본 FlowFile 의 특성에 저장됩니다. ‘output stream’ 또는 ‘nonzero status’에 대한 관계는 더 이상 존재하지 않습니다. 이 속성의 값은 출력 특성의 키가 됩니다. |
Output MIME Type |
“mime.type” 특성에 설정할 값을 지정합니다. 이 속성은 ‘Output Destination Attribute’가 설정된 경우 무시됩니다. |
작업 디렉터리 |
명령을 실행할 때 현재 작업 디렉터리로 사용할 디렉터리입니다 |
argumentsStrategy |
명령에 제공할 인자를 구성하는 전략입니다. |
제한 사항¶
필수 권한 |
설명 |
|---|---|
코드 실행 |
NiFi 가 가진 모든 권한을 가정하여 임의의 코드를 실행할 수 있는 기능을 연산자 제공합니다. |
관계¶
이름 |
설명 |
|---|---|
nonzero status |
반환된 상태 코드가 0이 아닌 경우 명령의 출력에서 생성된 플로우 파일의 대상 경로입니다. 이 관계로 라우팅되는 모든 플로우 파일은 불이익을 받게 됩니다. |
원본 |
원본 FlowFile 이 라우팅됩니다. 스크립트 실행 결과를 자세히 설명하는 새로운 특성이 추가됩니다. |
output stream |
반환된 상태 코드가 0인 경우 명령의 출력에서 생성된 플로우 파일의 대상 경로입니다. |
Writes 특성¶
이름 |
설명 |
|---|---|
execution.command |
실행된 명령의 이름입니다 |
execution.command.args |
세미콜론으로 구분된 인자 목록입니다. 민감한 속성은 마스킹됩니다 |
execution.status |
명령을 실행한 후 반환된 종료 상태 코드입니다 |
execution.error |
명령 실행 후 반환된 오류 메시지 |
mime.type |
‘Output MIME Type’ 속성이 설정되어 있고 ‘Output Destination Attribute’가 설정되어 있지 않은 경우 출력의 MIME 유형을 설정합니다 |