Show Menu
TOPICS×

Create a Amazon S3 source connector in the UI

Source connectors in Adobe Experience Platform provide the ability to ingest externally sourced data on a scheduled basis. This tutorial provides steps for creating an Amazon S3 (hereinafter referred to as "S3") source connector using the Platform user interface.

Getting started

This tutorial requires a working understanding of the following components of Adobe Experience Platform:
If you already have a valid S3 connection, you may skip the remainder of this document and proceed to the tutorial on configuring a dataflow .

Supported file formats

Experience Platform supports the following file formats to be ingested from external storages:
  • Delimiter-separated values (DSV): Support for DSV formatted data files is currently limited to comma-separated values. The value of field headers within DSV formatted files must only consist of alphanumeric characters and underscores. Support for general DSV files will be provided in the future.
  • JavaScript Object Notation (JSON): JSON formatted data files must be XDM compliant.
  • Apache Parquet: Parquet formatted data files must be XDM compliant.

Gather required credentials

In order to access your S3 bucket on Platform, you need to provide valid values for the following credentials:
Credential
Description
s3AccessKey
The access key ID for your S3 storage.
s3SecretKey
The secret key ID for your S3 storage.
For more information on getting started, visit this AWS document .

Connect your S3 account

Once you have gathered your required credentials, you can follow the steps below to link your S3 account to Platform.
Log in to Adobe Experience Platform and then select Sources from the left navigation bar to access the Sources workspace. The Catalog screen displays a variety of sources for which you can create an account with.
You can select the appropriate category from the catalog on the left-hand side of your screen. Alternatively, you can find the specific source you wish to work with using the search option.
Under the Databases category, select Amazon S3 . If this is your first time using this connector, select Configure . Otherwise, select Add data to create a new S3 connector.
The Connect to Amazon S3 page appears. On this page, you can either use new credentials or existing credentials.

New account

If you are using new credentials, select New account . On the input form that appears, provide a name, an optional description, and your S3 credentials. When finished, select Connect and then allow some time for the new connection to establish.

Existing account

To connect an existing account, select the S3 account you want to connect with, then select Next to proceed.

Next steps and additional resources

By following this tutorial, you have established a connection to your S3 account. You can now continue on to the next tutorial and configure a dataflow to bring data from your cloud storage into Platform .