AWS S3 connector as a destination

The ETL pipeline, to transfer customer data from a Langstack entity to a csv file on AWS S3, is created as follows.

To see step-by-step instructions of how to create an ETL pipeline, click here.

• An ETL pipeline named “TestEntitytoS3” is created.

• To connect to the data source, the necessary information is added in the Data source section:

  1. The “Entity” tab is selected.

  2. The entity “CustomersData” is selected from the drop-down menu.

• To connect to the data source, the necessary information is added as follows:

  1. The “Connector” tab is selected.

  2. For this example, “TestS3Connector” is selected from the drop-down menu. The connector can be added by selecting a connector from the drop-down menu or a new connector can be created by clicking the [+] button.

  3. To go to the settings, click the “Edit the settings” arrow.

• To disallow multiple simultaneous runs of the ETL pipeline, the toggle button is left enabled for “skip execution while in progress”. Enabling this toggle button defines that the execution of this ETL pipeline will be skipped when there is one already in progress.

• The default selection for ETL pipeline execution is “Immediate”.

• To align the source fields with destination fields, the settings for the reader and writer format are defined in the “Data Format” tab. The “Reader” tab is selected by default.

• For this example, the fields are added as per the image below.

• To update the settings for how the data should be written, select the “Writer” tab.

  1. The writer stream is “CSV Stream.”

  2. To add the table name, click on the “Edit the settings” arrow.

• To add details necessary to write the records, the settings in this section “AWS S3 CSV format details:” are defined as follows:

  1. In the field “File path or File URL or Folder path or Folder URL” the Object URL is copied for the file.

  2. The “File name” is left blank as it is included in the Object URL.

  3. The “CharacterSet” is selected as “Unicode(UTF-8)”.

  4. The “Language” is selected as “English”.

  5. The “Start reading CSV from line” is defined as “1”.

  6. The “separator” is selected as “Comma”.

• In the “Sample data”, the column names of the source file are pasted: “Customer_ID,Name,Age”.

• Once the sample data is added, the writer fields are displayed:

  1. The column names are copied to Field Mapping by clicking “Copy to Field Mapping”.

  2. Click on "Accept & Collapse" to save the information.

• The “Writer” mode is “Append”.

• In the Field Mapping section, all the “Mapped Fields” are aligned.

• When the ETL pipeline is executed (after Save and Publish), the records will be added to the destination. The changes can be checked by downloading the file from the S3 bucket.