LookupRecord 2025.5.31.15

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Extrai um ou mais campos de um registro e procura um valor para esses campos em LookupService. Se um resultado for retornado pelo LookupService, esse resultado será opcionalmente adicionado ao registro. Nesse caso, o processador funciona como um processador de enriquecimento. Independentemente disso, o registro é então roteado para a relação “matched” ou para a relação “unmatched” (se a propriedade “Estratégia de roteamento” estiver configurada para isso), indicando se um resultado foi ou não retornado pelo LookupService, permitindo que o processador também funcione como um processador de roteamento. As “coordenadas” a serem usadas para procurar um valor no serviço de pesquisa são definidas pela adição de uma propriedade definida pelo usuário. Cada propriedade adicionada terá uma entrada adicionada a um mapa, em que o nome da propriedade se torna a chave do mapa e o valor retornado por RecordPath se torna o valor dessa chave. Se vários valores forem retornados pelo RecordPath, o registro será encaminhado para a relação “unmatched” (ou “success”, dependendo da configuração da propriedade “Estratégia de roteamento”). Se um ou mais campos corresponderem ao RecordPath do resultado, todos os campos correspondentes serão atualizados. Se não houver correspondência no LookupService configurado, nenhum campo será atualizado. Ou seja, ele não substituirá um valor existente no registro por um valor nulo. Observe, no entanto, que se os resultados retornados por LookupService não forem contabilizados em seu esquema (especificamente, o esquema configurado para o Record Writer), os campos não serão gravados no FlowFile.

Tags

avro, convert, csv, database, db, enrichment, filter, json, logs, lookup, record, route

Requisito de entrada

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Caminho do registro raiz

Um RecordPath que aponta para um registro filho dentro de cada um dos registros de nível superior no FlowFile. Se especificado, as propriedades adicionais do RecordPath serão avaliadas em relação a esse registro filho em vez do registro de nível superior. Isso permite realizar o enriquecimento em vários registros filho dentro de um único registro de nível superior.

lookup-service

O serviço de pesquisa a ser usado para procurar um valor em cada registro

record-path-lookup-miss-result-cache-size

Define quantos valores/registros de pesquisa devem ser armazenados em cache. Definir essa propriedade como zero significa que nenhum armazenamento em cache será feito e a tabela será consultada para cada valor de pesquisa em cada registro. Se a tabela de pesquisa for alterada com frequência ou se os dados mais recentes precisarem ser recuperados, não use o cache.

record-reader

Especifica o Controller Service a ser usado para ler os dados recebidos

record-update-strategy

Essa propriedade define a estratégia a ser usada ao atualizar o registro com o valor retornado pelo serviço de pesquisa.

record-writer

Especifica o Controller Service a ser usado para gravar os registros

result-contents

Quando é obtido um resultado que contém um registro, essa propriedade determina se o próprio registro é inserido no caminho configurado ou se o conteúdo do registro (ou seja, os subcampos) será inserido no caminho configurado.

result-record-path

Um RecordPath que aponta para o campo cujo valor deve ser atualizado com qualquer valor retornado do serviço de pesquisa. Se não for especificado, o valor retornado do serviço de pesquisa será ignorado, exceto para determinar se o FlowFile deve ser encaminhado à relação “matched” ou “unmatched”.

routing-strategy

Especifica como encaminhar os registros após a conclusão de uma pesquisa

Relações

Nome

Descrição

failure

Se um FlowFile não puder ser enriquecido, o FlowFile inalterado será encaminhado para essa relação

success

Todos os registros serão enviados para essa relação, se configurados para isso, a menos que ocorra uma falha

Grava atributos

Nome

Descrição

mime.type

Define o atributo mime.type para o tipo MIME especificado pelo Record Writer

record.count

O número de registros no FlowFile

Consulte também