SFTP Setup Guide
Follow our setup guide to sync files from your SSH server to your destination using SFTP.
To set up the Fivetran SFTP connector, you need:
- An account on an SSH server containing files with supported filetypes and encodings
- The ability to log into this account using either a password or key pair
In the top right corner of your Fivetran dashboard, click on + Connector.
Select the SFTP connector to launch the setup form.
Choose the destination schema and table names for your destination.
If you use a keypair for logging into your SFTP server, set the Login with keypair? toggle to ON. Make a note of the automatically generated public key and proceed to the next section.
If you do not use a keypair for logging into your SFTP server, proceed to the final section.
In Text Editor
This step is only required if your SSH user account uses key pairs to log in. Accounts using standard password login may skip this section.
Using your favorite text editor, add the public ssh key from the Fivetran setup form to the authorized_keys file. The key must be all on one line. Make sure no line breaks are introduced when cutting and pasting.
Add the Fivetran public key to the /.ssh/Authorized_keys file on any SSH account you wish to use.
Fill in information on the setup form:
- Password (not required for key pair login)
Choose your configuration options. Using these configuration options, you can select subsets of your folders, certain types of files, and more to sync only the files you need in your destination. Setting up multiple SFTP connectors targeted at the same file system, but with different options, can allow you to slice and dice a file system any way you'd like.
Folder Path This folder path is used to specify a portion of the file system in which you'd like Fivetran to look for files. Any files under the specified folder and all of its nested subfolders will be examined for files we can upload. If no prefix is supplied, we'll look through the entire file system for files to sync.
File Pattern The file pattern is a regular expression that we use to decide whether or not to sync certain files. It applies to everything under the prefix. For instance, suppose under the prefix
logsyou had three folders:
errors. Using the pattern
\d\d\d\d/.*, you could exclude all the files in the
\d\d\d\dapplies to any folders whose names consist of four consecutive digits (ie,
.*applies to the files under them. If you're not sure what regular expression to use, you can leave this field blank, and we'll sync everything under the prefix. If you're feeling particularly bold, you can learn to write your own regex here.
Archive Folder Pattern If there are multiple files within archive (TAR or ZIP) folders, you can use the archive folder pattern to filter those as well. For example, the archive folder pattern
.*jsonwill sync from an archive folder only those files that end in a .json file extension.
File Type The file type is used to let Fivetran know that even files without a file extension ought to be parsed as this file type. For example, if you have an automated CSV output system that saves files without a .csv extension, you can specify the CSV type and we will sync them correctly as CSVs. Selecting "infer" will let Fivetran infer from a file's extension (
.log) what to sync. If you do choose a file type, every file we examine will be interpreted as the file type you select, so make sure everything Fivetran syncs has the same file type!
Compression The compression format is used to let Fivetran know that even files without a compression extension should be decompressed using the selected compression format. 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. The integration will then decompress every file that it examines using GZIP. If all of your compressed files are correctly marked with a matching compression extension (
.zip), you can select "infer".
Error Handling Selecting skip ignores any improperly formatted data within a file, allowing you to sync only valid data. Choosing fail enables you to prevent a file from syncing if any improperly formatted data is detected. With either option you will receive a notification on your dashboard if errors are encountered.
Modified File Merge When a previously synced file is modified, should the rows in the destination be replaced or should the new rows be appended to the table.
upsert_fileoption will replace records in destination, using the filename and line number as the primary key.
append_fileoption will append records.
Escape Character (Optional) CSVs have a special rule for escaping quotation marks as opposed 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 other characters like backslash for escaping. Only use this field if you are sure your CSVs have a different escape character.
Null Sequence (Optional) CSVs have no native notion of a null character. However, some CSV generators have created one, using characters such as
\Nto represent null. Note: text is un-escaped before the null sequence is matched, so don't use the escape character in your null sequence. Only use this field if you are sure your CSVs have a null sequence.
Delimiter (Optional) The delimiter is a character used in CSV files to separate one field from the next. If this is left blank, Fivetran will infer the delimiter for each file, and files of many different types of delimiters can be stored in the same folder with no problems. If this is not left blank, then all CSV files in your search path will be parsed with this delimiter.
Click Save & Test. Fivetran will take it from here.