User Guide

10.5.1
- 10.5.7
- 10.5.4
- 10.5.2
- 10.5
- 10.4.1
- 10.4.0
- 10.2.2 Service Pack 1
- 10.2.2
- 10.2.1

Back Next

Mapping Configurations for Hadoop

To configure a mapping for Hadoop, configure the connection and run-time properties for the mapping.

The following image shows the Hadoop mapping and run-time properties: The image describes the Hadoop mapping and run-time properties.

When you configure the mapping, configure the following properties:

Validation environment: The environment that validates the mapping. Select Hadoop in the validation environment and select the Spark engine. The Data Integration Service pushes the mapping logic to the Spark engine.

Execution environment: The environment that runs the mapping. Select Hadoop as the execution environment.

Hadoop: Specify the following properties for the Spark engine:
Connection. The connection to the Spark engine used for pushdown of processing. Select
Connection
and browse for a connection or select a connection parameter.
Runtime Properties. An optional list of configuration parameters to apply to the Spark engine. You can change the default Spark configuration properties values, such as
spark.executor.memory
,
spark.sql.shuffle.partitions
, or
spark.driver.cores
.
Use the following format:
<property1>=<value>

<property1> is a Spark configuration property.
<value> is the value of the property.

To enter multiple properties, separate each name-value pair with the following text:
&:

To use a JMS source or Amazon Kinesis Streams source in the mapping, configure two or more executors for the mapping. For example, use the following configuration:

spark.executor.instances=2 &: spark.executor.cores=2 &: spark.driver.cores=1

To use an AWS credential profile, configure the following properties for the mapping:
spark.yarn.appMasterEnv.AWS_CREDENTIAL_PROFILES_FILE=<absolute path to the credentials file>/credentials

spark.executorEnv.AWS_CREDENTIAL_PROFILES_FILE=<absolute path to the credentials file>/credentials

spark.driverEnv.AWS_CREDENTIAL_PROFILES_FILE=<absolute path to the credentials file>/credentials

To maintain global sort order in a streaming mapping that contains a Sorter transformation, you must set the
infaspark.sort.global
property to true and ensure that the Maintain Row Order property is disabled on the target.

When you use an Amazon S3 target in the mapping to write large amount of data and specify a higher gigabyte value for the
rolloverSize
property, ensure that you add the
spark.hadoop.fs.s3a.connection.maximum
property and set the value of the property to
500
or higher.

When you use a Google Cloud Storage target in a streaming mapping, you can configure size-based rollover and time-based rollover while creating the mapping.

If you enable high-precision in a streaming mapping, the Spark engine runs the mapping in low-precision mode.

Source configuration: Specify the following properties to configure how the data is processed:
Maximum Rows Read. Specify the maximum number of rows that are read before the mapping stops running. Default is
Read All Rows
.
Maximum Runtime Interval. Specify the maximum time to run the mapping before it stops. If you set values for this property and the Maximum Rows Read property, the mapping stops running after one of the criteria is met. Default is
Run Indefinitely
. A value of
Run Indefinitely
enables the mapping to run without stopping.
State Store. Specify the HDFS location on the cluster to store information about the state of the Spark Job. Default is
<Home Directory>/stateStore

You can configure the state store as part of the configuration of execution options for the Data Integration Service.; You can use these properties to test the mapping.
Streaming properties: Specify the following streaming properties:
Batch interval. The Spark engine processes the streaming data from sources and publishes the data in batches. The batch interval is number of seconds after which a batch is submitted for processing.
Cache refresh interval. You can cache a large lookup source or small lookup tables. When you cache the lookup source, the Data Integration Service queries the lookup cache instead of querying the lookup source for each input row. You can configure the interval for refreshing the cache used in a relational Lookup transformation.
When you run a streaming mapping, if the hive lookup table is in ORC or Parquet format, the minimum value for the cache refresh interval property is 1.

State Store Connection. You can select an external storage connection for the state store. Default external storage connection is HDFS. You can browse the state store connection property to select Amazon S3, Microsoft Azure Data Lake Stroage Gen1, or Microsoft Azure Data Lake Storage Gen2 as the external storage. You can also have a parameterized connection.
Checkpoint Directory. You can specify a checkpoint directory to enable a mapping to start reading data from the point of failure when the mapping fails or from the point in which a cluster is deleted. The directory you specify is created within the directory you specify in the State Store property.
Run configurations: The Developer tool applies configuration properties when you run streaming mappings. Set configuration properties for streaming mappings in the
Run
dialog box.
Configure the following source properties:
Read all rows. Reads all rows from the source.
Read up to how many rows. The maximum number of rows to read from the source if you do not read all rows.
Maximum runtime interval. The maximum time to run the mapping before it stops. If you set values for this property and the
Maximum Rows Read
property, the mapping stops running after one of the criteria is met.; When you run the mapping, the Data Integration Service converts the mapping to a Scala program and package it in a JAR file and sends it to the Hadoop cluster. You can view the details in the Spark execution plan in the Developer tool or Administrator tool.

Rename Saved Search

Table of Contents

User Guide

User Guide

Mapping Configurations for Hadoop

Mapping Configurations for Hadoop