tSchemaComplianceCheck Standard properties
These properties are used to configure tSchemaComplianceCheck running in the Standard Job framework.
The Standard tSchemaComplianceCheck component belongs to the Data Quality family.
The component in this framework is available in all Talend products.
Basic settings
| Properties | Description |
|---|---|
|
Base Schema and Edit schema |
A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. When you create a Spark Job, avoid the reserved word line when naming the fields. It describes the structure and nature of your data to be processed as it is. Used by both Basic Checks and Advanced JSON Schema modes. Built-In: You create and store the schema locally for this component only. Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs. |
|
Check all columns from schema |
Select this option to carry out all checks on all columns against the base schema. |
|
Custom defined |
Select this option to carry out particular checks on particular columns. When this option is selected, the Checked Columns table shows. |
|
Checked Columns |
In this table, define what checks are to be carried out on which columns.
This table appears when you select the Custom defined option.
|
|
Use another schema for compliance check |
In order to reject the non-compliant data, define a reference schema as you expect the data to be. It can be restrictive on data type, null values, and length. |
| Check columns from a JSON schema URI | This option is available from Talend Studio 8.0 R2026-05 onwards. Select this option to validate the data against a JSON schema.Enter the JSON schema URI in double quotes. |
|
Trim the excess content of column when length checking chosen and the length is greater than defined length |
Select this checkbox to truncate the data that exceeds the length specified rather than reject it. Information noteRestriction:
This option is applicable only on data of String type. This option is not available when Check columns from a JSON schema URI is selected. |
Advanced settings
The advanced settings depends on the Mode selected in the Basic settings.
| Properties | Description |
|---|---|
|
JSON schema draft version |
Select the draft version to use. For more information, see json-schema.org |
|
JSON schema file encoding |
Select the encoding of the schema file. |
| Properties | Description |
|---|---|
|
Use Fastest Date Check |
Select this checkbox to perform a fast date format check using the TalendDate.isDate() method of the Talend Date system routine if Date pattern is not defined. For more information about routines, see What are routines. |
|
Use Strict Data Check |
Select this checkbox to perform a strict data format check. When selected, the Use Fastest Data Check checkbox is hidden. |
|
Ignore TimeZone when Check Date |
Select this checkbox to ignore the time zone setup upon date check. This option is not available when Check all columns from schema is selected. |
|
Treat all empty string as NULL |
Select this checkbox to treat any empty fields in any columns as null values, instead of empty strings. By default, this checkbox is selected. When it is cleared, the Choose Column(s) table shows to let you select individual columns. |
|
Check string by byte length |
Select this checkbox to check the string column with byte length according to the charset set in the Charset text box. By default, this checkbox is not selected and only character length is checked. |
|
tStatCatcher Statistics |
Select this checkbox to collect log data at the component level. |
Global Variables
| Variables | Description |
|---|---|
|
Global Variables |
ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error checkbox is cleared, if the component has this checkbox. A Flow variable functions during the execution of a component while an After variable functions after the execution of the component. To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from it. For more information about variables, see Using contexts and variables. |
Schema violations output
When Check columns from a JSON schema URI is selected, the component validates data against a JSON schema with advanced constraints, invalid rows are sent to the Rejects flow with structured violation metadata.
| Information | Description |
|---|---|
| All input columns | Pass-through from input. All input column values are preserved unchanged in the Rejects flow. |
| ErrorType | Type of the error. |
|
ErrorCode |
Code identifying the type of schema violation encountered. |
|
ErrorMessage |
Error message summarizing the violation. |
Usage
| Usage guidance | Description |
|---|---|
|
Usage rule |
This component is an intermediary step in the flow allowing to exclude from the main flow the non-compliant data. This component cannot be a start component as it requires an input flow. It also requires at least one output component to gather the validated flow, and possibly a second output component for rejected data using Rejects link. For more information, see Rejects. |