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”.
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 |