# tDataEncrypt properties for Apache Spark Batch

These properties are used to configure tDataEncrypt running in the Spark Batch Job framework.

The Standard tDataEncrypt component belongs to the Data Quality family.

The component in this framework is available in Talend Data Management Platform, Talend Big Data Platform, Talend Real Time Big Data Platform, Talend Data Services Platform, and in Talend Data Fabric.

## Basic settings

| Schema and Edit Schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br>Click Sync<br>columns to retrieve the schema from the previous component connected in the<br>Job.<br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion. If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> |
| --- | --- |
|  | Built-In: You create and store the schema locally for this component<br>only. |
|  | Repository: You have already created the schema and stored it in the<br>Repository. You can reuse it in various projects and Job designs. |
| Password | This value must be enclosed in double<br>quotes.<br><br>When using an existing cryptographic<br>file, enter the password required to use this file.<br><br>When generating a cryptographic file,<br>enter the password used to encrypt this file.<br><br>This password is required to decrypt<br>back data using the tDataDecrypt<br>component. |
| Cryptographic file path | When using an existing cryptographic file, enter the<br>path to the cryptographic file. It must be enclosed in double<br>quotes.<br><br>When generating a cryptographic file, enter the destination file path.<br>You can enter different types of values:<br><br><ul> <li>A context: <kbd>context.mycontext</kbd> </li> <li>To generate the file in local, enclose the path in double quotes:                              <kbd>"C:/user/cryptofiles/mycryptofile"</kbd> </li> <li>To generate the file on a cluster, enclose the HDFS path in double                           quotes:                              <kbd>"hdfs://repository/cryptofiles/mycryptofile"</kbd> </li> </ul><br><br>This cryptographic file is encrypted<br>using AES-GCM.<br><br>This cryptographic file is required to<br>decrypt back data using the tDataDecrypt<br>component.<br><br>For more information about the cryptographic file, see<br>the [data<br>encryption process](https://help.qlik.com/talend/en-US/components/7.3/data-privacy/tdataencrypt). |
| Generate cryptographic file<br><br>![](https://help.qlik.com/talend/en-US/components/7.3/Resources/images/tdataencrypt_generate_icon.png) | Click this button to generate the<br>cryptographic file.<br><br>In the dialog box, select the<br>cryptographic method used to encrypt the input data:<br><br><ul> <li> <span>AES</span>,                                        which is a 128-bit block cipher standardized by the National                                        Institute of Standards and Technology (NIST).</li> <li> <span>Blowfish</span>,                                        which is a 64-bit unpatented block cipher developed by Bruce                                        Schneier.</li> </ul> |
| Encryption | Select the corresponding Encrypt check boxes to encrypt input<br>columns.<br><br>You can encrypt all column data<br>types, except Dynamic, but the output<br>encrypted data is of String type.<br><br>Configure the output schema of the<br>component to set the type of the columns to be encrypted to String.<br><br>The columns that are not selected<br>will not be encrypted and be returned as-is by the component. |

## Advanced settings

| tStat Catcher Statistics | Select this check box to gather the Job processing metadata at the Job level<br>as well as at each component level. |
| --- | --- |

## Usage

| **Usage rule** | This component is usually used as an intermediate component, and it requires an<br>input component and an output component. |
| --- | --- |
| Spark Connection | In the Spark<br>Configuration tab in the Run<br>view, define the connection to a given Spark cluster for the whole Job. In<br>addition, since the Job expects its dependent jar files for execution, you must<br>specify the directory in the file system to which these jar files are<br>transferred so that Spark can access these files:<br><br><ul> <li> <div> <span>Yarn mode</span> (Yarn client or Yarn cluster):<ul> <li> <p>When using Google Dataproc, specify a bucket in the                                            <span>Google Storage staging bucket</span>                                        field in the <span>Spark configuration</span>                                        tab.</p> </li> <li> <p>When using HDInsight, specify the blob to be used for Job                                        deployment in the <span>Windows Azure Storage                                            configuration</span> area in the <span>Spark                                            configuration</span> tab.</p> </li> <li>When using Altus, specify the S3 bucket or the Azure                                    Data Lake Storage for Job deployment in the <span>Spark                                        configuration</span> tab.</li> <li>When using Qubole, add a                                        <span>tS3Configuration</span> to your Job to write                                    your actual business data in the S3 system with Qubole. Without                                        <span>tS3Configuration</span>, this business data is                                    written in the Qubole HDFS system and destroyed once you shut                                    down your cluster.</li> <li> <p>When using on-premises distributions, use the configuration component                                        corresponding to the file system your cluster is using.                                        Typically, this system is HDFS and so use <a href="https://help.qlik.com/talend/r/en-US/7.3/components/hdfs/thdfsconfiguration">tHDFSConfiguration</a>.</p> </li> </ul> </div> </li> <li> <p> <span>Standalone mode</span>: use the                            configuration component corresponding to the file system your cluster is                            using, such as <a href="https://help.qlik.com/talend/r/en-US/7.3/components/hdfs/thdfsconfiguration-properties-for-apache-spark-batch">tHDFSConfiguration Apache Spark Batch</a> or <a href="https://help.qlik.com/talend/r/en-US/7.3/components/amazon-s3/ts3configuration-properties-for-apache-spark-batch">tS3Configuration Apache Spark Batch</a>.</p> <p>If you are using Databricks without any configuration component present                            in your Job, your business data is written directly in DBFS (Databricks                            Filesystem).</p> </li> </ul><br><br>This connection is effective on a per-Job basis. |