ExecuteStreamCommand 2025.5.31.15¶
Pacote¶
org.apache.nifi | nifi-standard-nar
Descrição¶
O processador ExecuteStreamCommand oferece uma maneira flexível de integrar comandos e scripts externos aos fluxos de dados do NiFi. ExecuteStreamCommand pode passar o conteúdo do FlowFile de entrada para o comando que ele executa de forma semelhante ao funcionamento do piping.
Requisito de entrada¶
REQUIRED
Oferece suporte a propriedades dinâmicas confidenciais¶
true
Propriedades¶
Propriedade |
Descrição |
---|---|
Delimitador de argumentos |
Delimitador a ser usado para separar os argumentos de um comando [padrão: ;]. Deve ser um único caractere |
Argumentos de comando |
Os argumentos a serem fornecidos ao executável, delimitados pelo caractere “;”. |
Caminho do comando |
Especifica o comando a ser executado; se apenas o nome de um executável for fornecido, ele deverá estar no PATH de ambiente do usuário. |
Ignore o STDIN |
Se for verdadeiro, o conteúdo do FlowFile de entrada não será passado ao comando em execução |
Comprimento máximo do atributo |
Se você rotear a saída do comando de fluxo a um atributo, o número de caracteres colocados no valor do atributo será, no máximo, essa quantidade. Isso é importante porque os atributos são mantidos na memória e atributos grandes causarão rapidamente problemas de falta de memória. Se a saída for maior que esse valor, ela será truncada para caber. Se possível, considere diminuir o tamanho. |
Atributo de destino de saída |
Se definido, a saída do comando de fluxo será colocada em um atributo do FlowFile original em vez de em um FlowFile separado. Não haverá mais uma relação para “fluxo de saída” ou “status diferente de zero”. O valor dessa propriedade será a chave do atributo de saída. |
Tipo MIME de saída |
Especifica o valor a ser definido para o atributo “mime.type”. Essa propriedade é ignorada se “Atributo de destino de saída” estiver definido. |
Diretório de trabalho |
O diretório a ser usado como o diretório de trabalho atual ao executar o comando |
argumentsStrategy |
Estratégia para configurar os argumentos a serem fornecidos ao comando. |
Restrições¶
Permissão necessária |
Explicação |
---|---|
executar código |
Fornece ao operador a capacidade de executar código arbitrário assumindo todas as permissões que o NiFi possui. |
Relações¶
Nome |
Descrição |
---|---|
nonzero status |
O caminho de destino do FlowFile criado a partir da saída do comando, se o código de status retornado for diferente de zero. Todos os FlowFiles encaminhados para essa relação serão penalizados. |
original |
O FlowFile original será roteado. Ele terá novos atributos que detalham o resultado da execução do script. |
output stream |
O caminho de destino do FlowFile criado a partir da saída do comando, se o código de status retornado for zero. |
Grava atributos¶
Nome |
Descrição |
---|---|
execution.command |
O nome do comando executado |
execution.command.args |
A lista de argumentos delimitada por ponto e vírgula. As propriedades sensíveis serão mascaradas |
execution.status |
O código de status de saída retornado da execução do comando |
execution.error |
Todas as mensagens de erro retornadas pela execução do comando |
mime.type |
Define o tipo MIME da saída se a propriedade “Tipo MIME de saída” estiver definida e “Atributo de destino de saída” não estiver definida |