Amazon S3 Setup Guide

Follow our setup guide to connect your Amazon S3 bucket to Fivetran.

Prerequisites

To connect your Amazon S3 bucket to Fivetran, you need:

An S3 bucket containing files with supported file types and encodings
For private or encrypted buckets, an AWS account with the ability to grant Fivetran permission and to read from the bucket

Setup instructions

We recommend disabling Access Control Lists (ACLs) on each S3 bucket so that the bucket contents are controlled by the bucket's access control settings and not the original file owner's settings. For more information about disabling ACLs for your bucket, see .

Begin Fivetran configuration

In the , enter the Destination schema and Destination table name of your choice.
Enter your S3 Bucket name.
IMPORTANT: If you are using an access point, enter the Access Point alias if you already have it or create one using our .
(Optional) In the Access approach drop-down menu, select one of the following options:
- IAM Role (most secure): .
- Access Key and Secret: . You may need to use this method if you don’t own the bucket and its access methods are limited.
- Public Bucket: Give Fivetran access through a public bucket. Your AWS account does not need special permissions to sync public buckets. Skip to the .
  NOTE: You can use the to find out if your S3 bucket has public or shared access.

Create IAM policy

IMPORTANT: You must create an IAM policy for both the IAM Role and Access Key and Secret approaches.

NOTE: For encrypted buckets, follow to modify the AWS KMS key's policy to grant Fivetran permissions to download files from your encrypted bucket.

Open your .
Go to Policies, then click Create Policy.
Go to the JSON tab.

Copy the following policy and paste it into the visual editor. Replace {your-bucket-name} with the name of your S3 bucket. After that, click Next: Tags.

{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
                "s3:GetBucketLocation",
                "s3:GetObject",
                "s3:ListBucket",

        ],
        "Resource": [
                "arn:aws:s3:::{your-bucket-name}/*",
                "arn:aws:s3:::{your-bucket-name}"
        ]
        }
    ]
}
content_copy

(Optional) If you use a customer-managed KMS key, add the following policy to the Action section of the IAM policy to provide read access to the encrypted files.
```
     "Action": [
         "kms:Decrypt",
         "kms:GenerateDataKey"
     ]     
content_copy
```
In the Add tags step, you can optionally add custom tags that will be associated with your bucket. Click Next: Review.
In the Review policy step, specify the name of your policy, for example "Fivetran-S3-Access", then click Create policy.

(Optional) Access using IAM role

Find External ID

In the connector setup form, find the automatically-generated External ID and make a note of it. You will need it to create an IAM role in AWS.

NOTE: The automatically-generated External ID is tied to your account. If you close and re-open the setup form, the ID will remain the same. You can keep the tab open in the background while you configure your source for convenience.

Create IAM role

Go to Roles, then click Create role.
Select AWS account, then enter Fivetran’s AWS VPC Account ID, 834469178297, in the Account ID field.
Select the Require external ID checkbox and enter the External ID you found above, then click Next.
In the Add permissions step, select the "Fivetran-S3-Access" policy , then click Next.
In the Name, review, and create step, specify the role name, for example "Fivetran", then click Create role at the bottom of the page.
Click the Fivetran role you created.
On the Summary page for the role, find the ARN and make a note of it. You will need it to configure Fivetran.

NOTE: If you want to re-use an existing IAM role created for Fivetran account, you need to edit the trust policy for the same role. You can then add another external ID to the JSON policy or copy the following policy and paste it in your JSON tab:

    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Effect": "Allow",
                "Principal": {
                    "AWS" : "arn:aws:iam::834469178297:user/gcp_donkey"  
                },
                "Action": "sts:AssumeRole",
                "Condition": {
                    "StringEquals": {
                        "sts:ExternalId": [
                            "external-id-1",
                            "external-id-2"
                        ]
                    }
                }
            }
        ]
    }
content_copy

(Optional) Set permissions

You can specify permissions for the Role ARN that you designate for Fivetran. Giving selective permissions to this role will allow Fivetran to only sync what it has permissions to see.

Skip to the .

(Optional) Access using key and secret

NOTE: You can skip this step if you already have an access key and secret.

Create user

NOTE: You can skip this step if you already have a user having access to the bucket.

Open your .
Go to Users, then click Add users.
Enter the User name, then click Next.
Select the Attach policies directly option, then select the "Fivetran-S3-Access" policy .
Click Next, then click Create user.

Generate access key and secret

In the Users tab, open the User .
Go to Security credentials tab and navigate to the Access keys section.
Click Create access key.
From the Use Case options, select the Third-party service option and then click Next.
Enter a Description tag value and then click Create access key.
Copy the Access key and Secret access key values. You will need them to configure Fivetran.

(Optional) Configure AWS PrivateLink

IMPORTANT: You must have a Business Critical plan to use AWS PrivateLink.

AWS PrivateLink allows VPCs and AWS-hosted or on-premises services to communicate with one another without exposing traffic to the public internet. PrivateLink is the most secure connection method. Learn more in .

Follow to configure PrivateLink for your S3 bucket.

NOTE: There are two ways in which you can provide Fivetran access to your data, using to control access to S3 buckets(recommended) or using .

(Optional) Configure access point

Create access point

to provide Fivetran access to your S3 bucket.
Open your .
On the left navigation pane, click Access Points.
Select the access point.
Go to the Properties tab. Make a note of the Access Point alias. You will need it to configure Fivetran.

To provide your bucket access to the access point, copy the following into the bucket policy . Replace {account-number} with your AWS account number, {role-name} with the role name that you created, {your-bucket-name} with the S3 bucket name which you used to configure the access point, {access-point-region}with the AWS region in which you created the access point, and {your-access-point}with the name of the access point you created.

{
 "Version": "2012-10-17",
 "Statement": [
    {
        "Effect": "Allow",
        "Principal": {
            "AWS": "arn:aws:iam::{account-number}:role/{role-name}"
        },
        "Action": [
            "s3:GetObject",
            "s3:ListBucket"
        ],
        "Resource": [
            "arn:aws:s3:::{your-bucket-name}",
            "arn:aws:s3:::{your-bucket-name}/*"
        ],
        "Condition": {
            "StringLike": {
                "s3:DataAccessPointArn": "arn:aws:s3:{access-point-region}:{account-number}:accesspoint/{your-access-point}"
            }
        }
    }
]
}
content_copy

Create an IAM policy for access point

. Copy the following policy and paste it in the JSON tab. Replace {access-point-region} with the region in which you created the access point, {account-number} with your account number, and {your-access-point} with the name of the access point you created.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                 "s3:GetObject",
                 "s3:ListBucket"
            ],
            "Resource": [
                 "arn:aws:s3:{access-point-region}:{account-number}:accesspoint/{your-access-point}",
                 "arn:aws:s3:{access-point-region}:{account-number}:accesspoint/{your-access-point}/*"
            ]
        }
    ]
}
content_copy

Finish Fivetran configuration

Depending on your Access approach, do the following:
- If you selected IAM Role, enter the Role ARN .
- If you selected Access Key and Secret, enter the Access Key ID and Access Key Secret .
Choose your configuration options. Using these configuration options, you can select subsets of your folders, specific types of files, and more to sync only the files you need in your destination. In addition, setting up multiple connectors targeted at the same container but with different options allows you to slice and dice a container any way you'd like.
You can use the following configuration options:
- (Optional) Folder Path - Use the folder path to specify a portion of the container in which you'd like Fivetran to look for files. We examine files under the specified folder and all of its nested subfolders for files we can sync. If you don't provide a prefix, we'll look through the entire container for files to sync.
- (Optional) File Pattern - Use a regular expression as the file pattern to decide whether or not to sync specific files. The pattern applies to everything under the prefix (folder path). If you're unsure what regular expression to use, you can leave this field blank, and we'll sync everything under the prefix.
  For example, if under the prefix logs, you have three folders: 2017, 2016, and errors. Using the pattern \d\d\d\d/.*, you can exclude all the files in the errors folder because:
  - \d\d\d\d only applies to the folders whose name consists of four consecutive digits, and
  - .* after / applies to any files in these folders
  TIP: You can learn to and .
- File Type - Use the file type to choose the parsing strategy for files without file extensions. If you save your files with improper extensions, you can force them to be synced as the selected file type.
  - If you select infer, we infer the type from a file's extension (.csv, .tsv, .json, .avro, or .log).
    NOTE: If you have XML files, don't select infer. We sync XML files only when you select the file type as xml. For more information about the file size, see .
    NOTE: If you have PGP encrypted files, do not select infer.
  - If you choose a file type, we interpret every file we examine as the file type you select, so make sure everything we sync has the same file type.
    For example, if you have an automated CSV output system that saves files without a .csv extension, you can specify the type as csv, and we will sync them correctly as CSVs.
  - If you select xml, we load your XML data into the _data column without flattening it.
- (Optional) JSON Delivery Mode - Available when JSON or JSONL is selected in File Type. Use this option to choose how Fivetran should handle your JSON data.
  - If you select Packed, we load all your JSON data into the _data column without flattening it.
  - If you select Unpacked, we flatten one level of columns and infer their data types.
- Compression - Use the compression option to choose the compression strategy to decompress files without compression extensions. If your files are compressed but do not have extensions indicating the compression method, you can decompress them according to the selected compression algorithm.
  - If all of your compressed files are correctly marked with a matching compression extension (.bz2, .gz, .gzip, .tar, or .zip), you can select infer.
  - If you select uncompressed, we do not decompress the files and sync the uncompressed files.
  - If you choose a compression format, we decompress every file using the format you select.
    For example, if you have an automated CSV output system that GZIPs files to save space but saves them without a .gzip extension, you can set this field to gzip. We will decompress every file that we examine using GZIP.
  NOTE: For PGP encrypted files, we only support .zip and uncompressed compression options. If the encrypted files are not archived, select uncompressed. If the encrypted files are in a .zip file, select zip.
- Error Handling - Use the error handling option to choose how to handle errors in your files. If you know that your files contain some errors, you can choose to skip poorly formatted lines.
  - If you select skip, we ignore improperly formatted data within a file, allowing you to sync only valid data.
  - If you select fail, we do not sync a file if we detect improperly formatted data in the file.
    TIP: We recommend that you select fail unless you are sure that you have undesirable, malformed data.
  You will receive a notification on your Fivetran dashboard if we encounter errors.
(Optional) To use the advanced configuration options, set the Enable Advanced Options toggle to ON.
You can use the following configuration options for specific use cases:
- Modified File Merge - Use this option to let Fivetran know how to update files in the destination. When you modify a previously synced file, should we replace the rows in the destination table or append the new rows to the table:
  - upsert_file replaces records in destination, using the filename and line number as the primary key.
  - append_file appends records.
- (Optional) Archive Folder Pattern - Use a regular expression to filter and sync files from archived folders. We sync the files in compressed archives with filenames matching the specified pattern. If there are multiple files within archive (TAR or ZIP) folders, you can use the archive folder pattern to filter file types.
  For example, if you specify the archive folder pattern as .*json, we will sync only the files that end in a .json file extension from the archive folder.
- (Optional) Null Sequence - Specify the value indicating null if your CSVs use a special value indicating null.
  Only use this field if you are sure your CSVs have a null sequence. CSVs have no native notion of a null character. However, some CSV generators have created one, using characters such as \N to represent null.
  TIP: The text is un-escaped before the null sequence is matched, so don't use the escape character in your null sequence.
- (Optional) Delimiter - Specify the delimiter. The delimiter is a character used in files to separate one field from the next. Fivetran tries to infer the delimiter, but in some cases, this is impossible. If your files sync with the wrong number of columns or uses a unique delimiter, consider setting this value. For example, if you have tab-delimited files, you must enter \t, and if you have pipe-delimited files, enter |.
  - If you leave this field blank, we infer the delimiter for each file. You can store files of many types of delimiters in the same folder with no problems.
  - If you specify a delimiter, we parse all the CSV, TSV, and TXT files in your folder path with this delimiter.
  NOTE: You can also specify a multi-character delimiter in this field. A custom multi-character delimiter (excluding "\t" and "\s") should be mentioned only if the source contains only csv files, else it might lead to data integrity issues for other files. The length of custom multi-character delimiter should not exceed 15 characters.
- (Optional) Escape Character - Set the escape character if your CSV generator follows non-standard rules for escaping quotation marks.
  Only use this field if you are sure your CSVs have a different escape character. CSVs have a special rule for escaping quotation marks compared to other characters; they require two consecutive double quotes to represent an escaped double quote. However, some CSV generators do not follow this rule and use different characters like backslash for escaping.
- (Optional) Skip Header Lines - Use this option to skip over fixed-length headers at the beginning of your CSV files. Set the toggle to ON, and then in the Number of skipped header lines field, specify the number of header lines you want to skip.
  Some CSV-generating programs include additional header lines or empty lines at the top of the file. The header consists of a few lines that do not match the format of the rest of the rows in the file. These header rows can cause undesired behavior because we attempt to parse them as if they were records in your CSV.
- (Optional) Skip Footer Lines - Use this option to skip over fixed-length footers at the end of your CSV files. Set the toggle to ON, and then in the Number of skipped footer lines field, specify the number of footer lines you want to skip.
  Some CSV-generating programs include a footer at the bottom of the file. The footer consists of a few lines that do not match the format of the rest of the rows in the file. These footer rows can cause undesired behavior because we attempt to parse them as if they were records in your CSV.
- (Optional) Headerless Files - Set the toggle to ON if your CSV-generating software doesn't provide a header line for the documents. Fivetran can generate the generic column names and sync data rows with them.
  Some CSV-generating programs do not include column name headers for the files; they only contain data rows. When you set the toggle to ON, we generate generic column names following the convention of column_0, column_1, ... column_n to map the rows.
- (Optional) Line Separator - Specify the custom line separator for your CSV files. The line separator is used in files to separate one row from the next.
  - If you leave this field blank, we use the new line character \n as the line separator by default.
  - If you specify a line separator, we parse all the CSV files in your folder path with this line separator.
- (Optional) PGP Encryption Options - Use this option to sync PGP encrypted files. Set the toggle to ON and specify the following:
  - PGP Private Key - Upload the PGP secret key as an attachment.
  - Passphrase - Enter the passphrase you used to generate the key.
- (Optional) List Strategy - Select the listing strategy you want to use:
  - complete_listing - The default option, where we list all the new and modified files from the bucket.
  - time_based_pattern_listing - You can opt to use this strategy if your files are named based on the date or time they are added to the bucket. If you add new files in lexicographic order to the bucket, in each sync, we try to identify a time-based pattern. We only list and sync the files that are lexicographically greater than the last file synced in the previous sync.
    NOTE: If we are unable to identify a time-based pattern, we use the default option.
- (Optional) To always connect using AWS PrivateLink, set the Require PrivateLink toggle to ON.
  NOTE: By default, we use PrivateLink to connect if your S3 bucket and destination are in the same region. Enabling this option ensures that we always use PrivateLink to connect. If the regions are different, Fivetran won't create the connection.
Click Save & Test. Fivetran will take it from here and sync your data from your Amazon S3 bucket.

Amazon S3 Setup Guide

Amazon S3 Setup Guide

Prerequisites

Setup instructions

Begin Fivetran configuration

Create IAM policy

(Optional) Access using IAM role

Find External ID

Create IAM role

(Optional) Set permissions

(Optional) Access using key and secret

Create user

Generate access key and secret

(Optional) Configure AWS PrivateLink

(Optional) Configure access point

Create access point

Create an IAM policy for access point

Finish Fivetran configuration

Related articles

Comments

Related articles

Use a Fivetran-Managed Destination

How to Sync Data from Non-Native Sources

Can I Select a Specific Region to Process My Data with Fivetran?