Data connector for AWS S3 Cross-Account

The data connector for S3 Cross-Account enables you to directly import a dataset from an AWS S3 Account bucket using cross-account authentication.

It can be used to import delimiter separated value files to InfoSum Platform, such as data exported from AWS Redshift. You can split rows in your data into multiple files with the same structure and merge them to a single dataset. You can import files in many formats, including compressed GZIP files.

Before starting, you will need the following information to hand:

  • User ARN
  • Session Name
  • Bucket
  • Import file name(s) 

To configure a connection, log in to the Platform if you haven't already done so and either create a dataset or access the bunker of an existing dataset. Once you're in the bunker, select Import a dataset or use the Import tab, and locate the S3 Cross-Account connector. 

Click Connect and enter your credentials as shown below.

The above form contains the following fields:

  1. Principal: Customer needs to authorise the ARN in this field to assume the User Role that is supplied in step 3 below
  2. External ID: Infosum generated ID per user email domain. Customers should use this external ID, along with the Principal for an extra validation when allowing the assumption of their user role
  3. User ARN: Customer needs to create a User Role that has a Permissions Policy that allows reading from their S3 bucket
  4. Session Name: User defined session
  5. Bucket Name: Specify the bucket name (no leading s3 identifier, e.g. "bucket-name" not "s3://bucket-name")
  6. Prefix: Optionally add extra path in this box [SubFolder/NextFolder/]

When you entered all required fields, click Connect.

The above form shows all the files available within the selected S3 bucket and contains the following fields:

  1. Key: File name(s) within the S3 bucket separated by the key delimiter specified in 2 below
  2. Key Delimiter: Delimiter used to separate files names in 1 above
  3. File is GZIP compressed:  Select this field if you are importing compressed GZIP (.gz) files. When you click Download, the bunker will decompress the files. You can ignore this field if you are not importing compressed GZIP files
  4. Field Delimiter: Delimiter used to separate values in the file(s)

Working with multiple files

  • You can specify any number of files.
  • All files must have the same structure.
  • Clicking on a filename overwrites it to the Object field. For this reason, we recommend listing multiple files in a text editor and cutting and pasting them to the Object field.  

Copy the file names into the Key field and click Download, then Connect

A subset of the data will then appear as a preview. You can perform some minor manipulations at this point, such as selecting which columns to import, enabling multi-value columns, renaming columns and excluding rows.

When you're happy with the preview, accept the settings and select a blank import configuration, then you'll be taken to the Import Wizard. This will show how our Platform has understood your dataset and mapped columns into our Global Schema.

If this looks correct, accept the Wizard Settings, otherwise untick the boxes so they can be correctly mapped during the later normalisation phase.