ValidateRecord 2025.10.2.19¶
Pacote¶
org.apache.nifi | nifi-standard-nar
Descrição¶
Validates the Records of an incoming FlowFile against a given schema. All records that adhere to the schema are routed to the «valid» relationship while records that do not adhere to the schema are routed to the «invalid» relationship. It is therefore possible for a single incoming FlowFile to be split into two individual FlowFiles if some records are valid according to the schema and others are not. Any FlowFile that is routed to the «invalid» relationship will emit a ROUTE Provenance Event with the Details field populated to explain why records were invalid. In addition, to gain further explanation of why records were invalid, DEBUG-level logging can be enabled for the «org.apache.nifi.processors.standard. ValidateRecord» logger.
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 |
If enabled, the processor will coerce every field to the type specified in the Reader “s schema. If the value of a field cannot be coerced to the type, the field will be skipped (will not be read from the input data), thus will not appear in the output. If not enabled, then every field will appear in the output but their types may differ from what is specified in the schema. For details please see the Additional Details page of the processor’s Help. This property controls how the data is read by the specified Record Reader. |
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 |