ValidateRecord 2025.10.2.19¶
Pacote¶
org.apache.nifi | nifi-standard-nar
Descrição¶
Valida os registros de um FlowFile recebido em relação a um determinado esquema. Todos os registros que aderem ao esquema são encaminhados para o relacionamento “valid”, enquanto os registros que não aderem ao esquema são encaminhados para o relacionamento “invalid”. Portanto, é possível que um único FlowFile recebido seja dividido em dois FlowFiles individuais se alguns registros forem válidos de acordo com o esquema e outros não. Qualquer FlowFile roteado para o relacionamento “invalid” emitirá um evento de procedência ROUTE com o campo Detalhes preenchido explicando porque os registros eram inválidos. Além disso, para ter mais explicações do motivo pelo qual os registros eram inválidos, o registro em log em nível de DEBUG pode ser habilitado para o registrador “org.apache.nifi.processors.standard. ValidateRecord”.
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 habilitado, o processador aplicará a coerção de cada campo para o tipo especificado no esquema do leitor. Se o valor de um campo não puder ser forçado para o tipo, o campo será ignorado (não será lido a partir dos dados de entrada), portanto não aparecerá na saída. Se não estiver habilitado, todos os campos aparecerão na saída, mas seus tipos podem ser diferentes do que está especificado no esquema. Para obter mais 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 |