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.

Tags

command, command execution, execute, stream

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