ReplaceText 2025.5.31.15¶
Pacote¶
org.apache.nifi | nifi-standard-nar
Descrição¶
Atualiza o conteúdo de um FlowFile pesquisando algum valor textual no conteúdo do FlowFile (por meio de expressão regular/regex ou valor literal) e substituindo a seção do conteúdo correspondente por algum valor alternativo. Ele também pode ser usado para acrescentar ou prefixar texto ao conteúdo de um FlowFile.
Requisito de entrada¶
REQUIRED
Oferece suporte a propriedades dinâmicas confidenciais¶
falso
Propriedades¶
Propriedade |
Descrição |
---|---|
Conjunto de caracteres |
O conjunto de caracteres no qual o arquivo está codificado |
Modo de avaliação |
Execute a “Estratégia de substituição” em cada linha separadamente (linha por linha) ou armazene o arquivo inteiro na memória (Texto inteiro) e execute-o. |
Modo de avaliação linha por linha |
Execute a “Estratégia de substituição” em cada linha separadamente (linha por linha) para todas as linhas no FlowFile, somente a primeira linha (cabeçalho), somente a última linha (rodapé), exceto a primeira linha (cabeçalho) ou exceto a última linha (rodapé). |
Tamanho máximo do buffer |
Especifica a quantidade máxima de dados a serem armazenados em buffer (por arquivo ou por linha, dependendo do modo de avaliação) para aplicar a substituição. Se “Texto inteiro” (no Modo de avaliação) for selecionado e o FlowFile for maior que esse valor, o FlowFile será encaminhado para “failure”. No modo “Linha por linha”, se uma única linha for maior que esse valor, o FlowFile será roteado para “failure”. Um valor padrão de 1 MB é fornecido, principalmente para o modo “Texto inteiro”. No modo “Linha por linha”, sugere-se um valor como 8 KB ou 16 KB. Esse valor será ignorado se a propriedade <Replacement Strategy> estiver definida como uma das seguintes opções: Append, Prepend, Always Replace |
Expressão regular |
O valor de pesquisa a ser buscado no conteúdo do FlowFile. Usado apenas para as estratégias de correspondência “Substituição literal” e “Substituição por expressão regular” |
Estratégia de substituição |
A estratégia de como e o que substituir no conteúdo de texto do FlowFile. |
Valor de substituição |
O valor a ser inserido usando a “Estratégia de substituição”. O uso de referências anteriores “Substituição por expressão regular” para grupos de captura de expressões regulares é compatível, mas as referências anteriores que fazem referência a grupos de captura que não existem na expressão regular serão tratadas como valor literal. As referências anteriores também podem ser referenciadas usando a linguagem de expressão, como “$1”, “$2” etc. As aspas simples devem ser incluídas, pois essas variáveis não são nomes de atributos “padrão” (os nomes de atributos devem ser colocados entre aspas, a menos que contenham apenas números, letras e _). |
Texto a ser anexado no fim |
O texto a ser anexado ao fim do FlowFile, ou a cada linha, dependendo do valor configurado da propriedade Modo de avaliação |
Texto a ser anexado no início |
O texto a ser anexado ao início do FlowFile, ou a cada linha, dependendo do valor configurado da propriedade Modo de avaliação |
Relações¶
Nome |
Descrição |
---|---|
failure |
FlowFiles que não puderam ser atualizados são encaminhados para essa relação |
success |
FlowFiles que foram processadas com sucesso são encaminhados para essa relação. Isso inclui tanto os FlowFiles que tiveram o texto substituído quanto os que não tiveram. |
Casos de uso¶
Anexar texto ao fim de cada linha em um FlowFile |
Anexar texto ao início de cada linha em um FlowFile |
Substitua cada ocorrência de uma cadeia de caracteres literal no FlowFile por um valor diferente |
Transforme cada ocorrência de uma cadeia de caracteres literal em um FlowFile |
Substitua completamente o conteúdo de um FlowFile por um texto específico |