ValidateRecord 2025.5.31.15

Pacote

org.apache.nifi | nifi-standard-nar

Descrição

Valida os registros de um FlowFile de entrada em relação a um determinado esquema. Todos os registros que aderem ao esquema são encaminhados para a relação “valid”, enquanto os registros que não aderem ao esquema são encaminhados para a relação “invalid”. Portanto, é possível que um único FlowFile de entrada seja dividido em dois FlowFiles individuais se alguns registros forem válidos de acordo com o esquema e outros não. Qualquer FlowFile que seja encaminhado à relação “invalid” emitirá um evento de procedência ROUTE com o campo Details preenchido para explicar por que os registros eram inválidos. Além disso, para obter mais explicações sobre por que os registros eram inválidos, o registro em nível DEBUG pode ser ativado para o agente de log “org.apache.nifi.processors.standard.ValidateRecord”.

Tags

record, schema, validate

Requisito de entrada

REQUIRED

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

allow-extra-fields

Se os dados de entrada tiverem campos que não estão presentes no esquema, essa propriedade determinará se o registro é válido ou não. Se verdadeiro, o registro ainda é válido. Se falso, o registro será inválido devido aos campos extras.

coerce-types

Se estiver ativado, o processador forçará cada campo ao tipo especificado no esquema do leitor. Se o valor de um campo não puder ser coercitivo com o tipo, o campo será ignorado (não será lido dos dados de entrada) e, portanto, não aparecerá na saída. Se não estiver ativado, todos os campos aparecerão na saída, mas seus tipos podem ser diferentes dos especificados no esquema. Para obter detalhes, consulte a página Detalhes adicionais da Ajuda do processador. Essa propriedade controla como os dados são lidos pelo Record Reader especificado.

invalid-record-writer

Se especificado, esse Controller Service será usado para gravar todos os registros inválidos. Se não for especificado, o gravador especificado pela propriedade “Record Writer” será usado com o esquema usado para ler os registros de entrada. Isso é útil, por exemplo, quando o Record Writer configurado não pode gravar dados que não aderem ao seu esquema (como é o caso do Avro) ou quando é desejável manter registros inválidos em seu formato original enquanto converte registros válidos para outro formato.

maximum-validation-details-length

Especifica o número máximo de caracteres que o valor dos detalhes de validação pode ter. Todos os caracteres além do máximo serão truncados. Essa propriedade só é usada se a opção “Nome de atributo dos detalhes de validação” estiver definida

record-reader

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

record-writer

Especifica o Controller Service a ser usado para gravar registros. Independentemente da configuração de acesso ao esquema do Controller Service, o esquema usado para validar o registro é usado para gravar os resultados válidos.

schema-access-strategy

Especifica como obter o esquema que deve ser usado para validar registros

schema-branch

Especifica o nome da ramificação a ser usada ao procurar o esquema na propriedade do registro de esquema. Se a propriedade do registro de esquema escolhida não for compatível com a ramificação, esse valor será ignorado.

schema-name

Especifica o nome do esquema a ser pesquisado na propriedade do registro de esquema

schema-registry

Especifica o Controller Service a ser usado para o registro de esquema

schema-text

O texto de um esquema formatado por Avro

schema-version

Especifica a versão do esquema a ser pesquisada no registro de esquema. Se não for especificada, será recuperada a versão mais recente do esquema.

strict-type-checking

Se os dados de entrada tiverem um registro em que um campo não seja do tipo correto, essa propriedade determinará como tratar o registro. Se for verdadeiro, o registro será considerado inválido. Se falso, o registro será considerado válido e o campo será convertido no tipo correto (se possível, de acordo com a coerção de tipo compatível com o Record Writer). Essa propriedade controla como os dados são validados em relação ao esquema de validação.

validation-details-attribute-name

Se especificado, quando ocorrer um erro de validação, esse nome de atributo será usado para deixar os detalhes. O número de caracteres será limitado pela propriedade “Comprimento máximo dos detalhes de validação”.

Relações

Nome

Descrição

failure

Se os registros não puderem ser lidos, validados ou gravados, por qualquer motivo, o FlowFile original será encaminhado para essa relação

invalid

Os registros que não forem válidos de acordo com o esquema serão encaminhados para essa relação

valid

Os registros que forem válidos de acordo com o esquema serão encaminhados para essa relação

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 roteados para uma relação