Amazon S3 Connector > Mappings and Mapping Tasks with Amazon S3 > Amazon S3 Objects in Mapping Tasks
  

Amazon S3 Objects in Mapping Tasks

When you configure a mapping task, you can configure advanced properties for Amazon S3 sources and targets.

Amazon S3 Sources in Mapping Tasks

For Amazon S3 source connections used in mapping tasks, you can configure advanced properties in the Sources page of the Mapping Task wizard.
You can configure the following advanced properties:
Property
Description
Enable Downloading S3 File in Multiple Parts
Downloads large Amazon S3 objects in multiple parts.
The Secure Agent downloads the object in multiple parts from Amazon S3.
When the file size of an Amazon S3 object is greater than 5 MB, you can choose to download the object in multiple parts in parallel.
Header Line Number
Amazon S3 Connector does not honor this property.
Read Data From Line
Specify the line number from where you want the Secure Agent to read data.
Default is 1.
Note: To read data from the header, the value of the Header Line Number and the Read Data From Line fields should be the same.
Staging File Location
Amazon S3 staging directory.
When you run a task in Secure Agent runtime environment, specify a directory path that is available on the corresponding Secure Agent machine in the runtime environment.
When you specify the directory path, the Secure Agent create folders depending on the number of partitions that you specify in the following format: InfaS3Staging<00/11><timestamp>_<partition number> where, 00 represents read operation and 11 represents write operation.
For example, InfaS3Staging000703115851268912800_0
Note: The temporary files are created within the new directory.
When you specify a directory name, if a folder with same name already exists, the Secure Agent deletes the contents of the folder. You must have the write permission for the specified location.
If you do not specify a directory path, the Secure Agent uses a temporary directory as the staging file location.
When you run a task in Hosted Agent runtime environment, leave the staging directory location blank. The Hosted Agent creates a directory at a temporary location.
Part Size
Specifies the part size of an object. Default is 5 MB.
Tracing Level
Sets the amount of detail that appears in the log file.
You can choose terse, normal, verbose initialization or verbose data. Default is normal.

Amazon S3 Targets in Mapping Tasks

For Amazon S3 target connections used in mapping tasks, you can configure advanced properties in the Targets page of the Mapping Task wizard.
You can configure the following advanced properties:
Property
Description
Encryption Type
Method you want to use to encrypt data. Select one of the following values:
  • - None. The data is not encrypted.
  • - Client Side Encryption.
    • - The Secure Agent encrypts data while uploading the delimited files to Amazon buckets.
    • - You must select client-side encryption in the advanced properties if you specify a master symmetric key or customer master key ID in the Amazon S3 connection properties.
  • - Server Side Encryption.
    • - You must select server-side encryption in the advanced properties if you specify a customer master key ID in the Amazon S3 connection properties.
    • - If you select the server-side encryption in the advanced properties and do not specify the customer master key ID in the connection properties, Amazon S3-managed encryption keys are used to encrypt data.
Folder Path
The complete path to the Amazon S3 objects and must include the bucket name and any folder name.
Ensure that you do not use a forward slash at the end of the folder path.
For example, <bucket name>/<my folder name>
The folder path specified at run time overrides the path specified while creating a connection.
Compression Type
Compress the data in GZIP format when you write the data to Amazon S3.
The target file in Amazon S3 will have .gz extension. The Secure Agent compresses the data and then sends the data to Amazon S3 bucket.
Default is None.
Part Size
Specifies the part size of an object.
Default is 5 MB.
TransferManager Thread Pool Size
Specifies the number of the threads to write data in parallel.
Amazon S3 Connector uses the AWS TransferManager API to upload a large object in multiple parts to Amazon S3.
When the file size is more than 5 MB, you can configure multipart upload to upload object in multiple parts in parallel. If you set the value of the TransferManager Thread Pool Size to greater than 50, the value reverts to 50.
Default is 10.
Merge Partition Files
Not applicable.
Distribution Column
Specify the name of the column to create multiple target files during run time.
Staging File Location
Amazon S3 staging directory.
When you run a task in Secure Agent runtime environment, specify a directory path that is available on the corresponding Secure Agent machine in the runtime environment.
When you specify the directory path, the Secure Agent create folders depending on the number of partitions that you specify in the following format: InfaS3Staging<00/11><timestamp>_<partition number> where, 00 represents read operation and 11 represents write operation.
For example, InfaS3Staging000703115851268912800_0
Note: The temporary files are created within the new directory.
When you specify a directory name, if a folder with same name already exists, the Secure Agent deletes the contents of the folder. You must have the write permission for the specified location.
If you do not specify a directory path, the Secure Agent uses a temporary directory as the staging file location.
When you run a task in Hosted Agent runtime environment, leave the staging directory location blank. The Hosted Agent creates a directory at a temporary location.
Object Tags
You can add single or multiple tags to the objects stored on the Amazon S3 bucket.
You can either enter the key value pairs or specify the file path that contains the key value pairs.
For more information, see Object Tag.
Success File Directory
Not applicable.
Error File Directory
Not applicable.

Specifying a Target

You can use an existing target or create a target to hold the results of a mapping. If you choose to create the target, the agent creates the target when you run the task.
To specify the target properties, follow these steps:
    1. Select the Target transformation in the mapping.
    2. On the Incoming Fields tab, configure field rules to specify the fields to include in the target.
    3. To specify the target, click the Target tab.
    4. Select the target connection.
    5. For the target type, choose Single Object or Parameter.
    6. Specify the target object or parameter. You must specify a .csv target file name.
    7. Click Formatting Options if you want to configure the formatting options for the file, and click OK.
    8. Click Select and choose a target object. You can select an existing target object or create a new target object at run time and specify the object name.
    The following image shows the Target Object box:
    The following image shows the Target Object box where you can select an existing target object or create a new target object at the runtime.
    9. Specify Advanced properties for the target, if needed.