# tDataUnmasking properties for Apache Spark Batch These properties are used to configure tDataUnmasking running in the Spark Batch Job framework. The Spark Batch tDataUnmasking component belongs to the Data Quality family. ## Basic settings | 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.

Click Sync
columns to retrieve the schema from the previous component connected in the
Job.

Click Edit
schema to make changes to the schema. If the current schema is of the Repository type, three options are available:



The output schema of this component
contains one read-only column, *ORIGINAL\_MARK*. This column identifies by true or false if the record is an original record
or a substitute record respectively. | | --- | --- | | | 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. | | Modifications | Define in the table what fields to unmask and how to unmask them:


Input Column: Select the column from the input
flow that contains the data to be unmasked.

These modifications are based on the function you select in the Function
column.


Category: select a category of unmasking functions
from the list.


Function: Select the function that will unmask
data.

The functions you can select from the Function list depend on the data
type of the input column.


Method: From this list, select the
Format-Preserving Encryption (FPE) algorithm that was used to mask data,
FF1 with AES or FF1 with
SHA-2:

The FF1 with AES method is based on the Advanced
Encryption Standard in CBC mode. The FF1 with
SHA-2 method depends on the secure hash function
HMAC-256.

Java 8u161 is the minimum required version to use the FF1 with
AES method. To be able to use this FPE method with Java
versions earlier than 8u161, download the Java Cryptography Extension
(JCE) unlimited strength jurisdiction policy files from Oracle website.

To unmask data, the FF1 with AES and
FF1 with SHA-2 methods require the password
specified in the Password for FF1 methods field when the data was masked
with the tDataMasking component.

When using the Replace all, Replace characters between two positions,
Replace n first digits and Replace n last digits with FPE methods, you
can select an alphabet.

Select the alphabet used to mask data with the
tDataMasking component.


Extra Parameter: This field is used by some of the
functions, it will be disabled when not applicable. When applicable,
enter a number or a letter to decide the behavior of the function you
have selected.


Keep format: this function is only used on
Strings. Select this check box to keep the input format when using the
SSN Masking functions, Phone
Unmasking functions. That is to say, if there are
spaces, dots ('.'), hyphens ('-') or slashes ('/') in the input, those
characters are kept in the output. If you select this check box when
using Phone Masking functions, the characters
that are not numbers from the input are copied to the output as is. | ## Advanced settings | Password for FF1 methods | To unmask data, the FF1 with AES and FF1 with SHA-2 methods require the
password specified in the Password for FF1 methods field when the data
was masked with the tDataMasking component. | | --- | --- | | Output the original row | Select this check box to output masked data rows in addition to the
original data. Having both data rows can be useful in debug or test
processes. | | Should null input return null | This check box is selected by default. When selected, the component
outputs *null* when input values are null. Otherwise,
it returns the default value when the input is null, that is an empty
string for string values, *0* for numeric values and
the current date for date values. | | Should empty input return empty | When this check box is selected, the component returns the input values
if they are empty. Otherwise, the selected functions are applied to the
input data. | | tStat
Catcher
Statistics | Select this check box to gather the Job processing metadata at the Job
level as well as at each component level. | ## Usage | **Usage rule** | This component is used as an intermediate step.

This component, along with the Spark Batch component Palette it belongs to,
appears only when you are creating a Spark Batch Job.

Note that in this documentation, unless otherwise explicitly stated, a
scenario presents only Standard Jobs, that is to
say traditional
Talend
data integration Jobs. | | --- | --- | | Spark Connection | In the Spark
Configuration tab in the Run
view, define the connection to a given Spark cluster for the whole Job. In
addition, since the Job expects its dependent jar files for execution, you must
specify the directory in the file system to which these jar files are
transferred so that Spark can access these files:



This connection is effective on a per-Job basis. |