Flat File External Source Settings

DataSync allows you to connect to local and remote CSV resources. Refer to the sections below to set the URI parameter to the CSV resource location, in addition to any other parameters necessary to connect to your data source.

Basic Authentication

  Local HTTP or HTTPS SharePoint Online SOAP FTP or FTPS SFTP
URI Formats

localPath

file://localPath

http://remoteStream https://remoteStream

sp://remotePath

ftp://server:port/remotePath ftps://server:port/remotepath

sftp://server:port/remotePath

User  

OPTIONAL

REQUIRED

REQUIRED

OPTIONAL

Password  

OPTIONAL

REQUIRED

REQUIRED

OPTIONAL

AuthScheme  

OPTIONAL

     

Connecting to Local Files

Set the URI to a folder containing CSV files.

Below is an example connection string:

URI=C:\folder1;

You can also connect to multiple CSV files that share the same schema. Below is an example of connection string:

URI=C:\folder; AggregateFiles=True;

If you would prefer to expose all of the individual CSV files as tables instead, leave this property at False.

URI=C:\folder; AggregateFiles=False;

Connecting to HTTP

Set the URI to the HTTP or HTTPS URL of the CSV resource you want to access as a table. For example:

URI=http://www.host1.com/streamname1;

To authenticate, set AuthScheme and the corresponding properties. Specify additional headers in CustomHeaders to modify the query string, set CustomUrlParams.

To query the CSV stream, reference streamedtable as the table name.

SELECT * FROM streamedtable

Connecting to SharePoint Online SOAP

Set the URI to a document library containing CSV files. To authenticate, specify the user name, password and SharePoint URL.

For example:

URI=sp://Documents/folder1; User=user1; Password=password1; SharepointUrl=https://subdomain.sharepoint.com;

Connecting to FTP

Set the URI to the address of the server followed by the path to the folder to be used as the root folder. To authenticate, specify the user name and password.

For example:

URI=ftps://localhost:990/folder1; User=user1; Password=password1;

Amazon

  Amazon S3
URI Formats

s3://remotePath

AWSAccessKey

REQUIRED (your AccessKey)

AWSSecretKey

REQUIRED (your SecretKey)

AWSRegion

OPTIONAL

Connecting to Amazon S3

Set the URI to the bucket and folder. Additionally, set the following properties to authenticate:

  • AWSAccessKey: Set this parameter to an Amazon Web Services Access Key (a user name).

  • AWSSecretKey: Set this parameter to an Amazon Web Services Secret Key.

For example:

URI=s3://bucket1/folder1; AWSAccessKey=token1; AWSSecretKey=secret1; AWSRegion=OHIO;

Optionally, you can also specify the AWSRegion.

Note  

It is also possible to connect to S3-compatible services by specifying its base URL. For example, if the URL connection property is set to http://s3.%region%.myservice.com and Region is region-1, we will generate request URLs similar to https://s3.region-1.myservice.com/bucket/... (or similar to https://bucket.s3.region-1.myservice.com/... , if the UseVirtualHosting property is set to True).

Azure

  Azure Blob Storage Azure Data Lake Store Gen1 Azure Data Lake Store Gen2 Azure Data Lake Store Gen2 with SSL
URI Formats

azureblob://mycontainer/myblob/

adl://remotePath

adl://Account.azuredatalakestore.net@remotePath

abfs://myfilesystem/remotePath

abfss://myfilesystem/remotePath

InitiateOAuth  

REQUIRED

   
OAuthClientId  

OPTIONAL

   
OAuthClientSecret  

OPTIONAL

   
OAuthAccessToken  

OPTIONAL

   
AuthScheme  

REQUIRED

   
AzureAccount REQUIRED

REQUIRED

REQUIRED

REQUIRED

AzureAccessKey REQUIRED (your AccessKey)  

REQUIRED (your AccessKey)

REQUIRED (your AccessKey)

Connect to Azure Blob Storage

Set the URI to the name of your container and the name of the blob. Additionally, set the following properties to authenticate:

  • AzureAccount: Set this parameter to the account associated with Azure Blob Storage.

  • AzureAccessKey: Set this parameter to the access key associated with Azure Blob Storage.

For example:

URI=azureblob://mycontainer/myblob/; AzureAccount=myAccount; AzureAccessKey=myKey;

Connect to Azure Data Lake Store Gen 2

Set the URI to the name of the file system and the name of the folder which contains your CSV files. Additionally, set the following properties to authenticate:

  • AzureAccount: Set this parameter to the account associated with Azure Data Lake Store.

  • AzureAccessKey: Set this parameter to the access key associated with Azure Data Lake Store.

For example:

URI=abfs://myfilesystem/folder1; AzureAccount=myAccount; AzureAccessKey=myKey;

URI=abfss://myfilesystem/folder1; AzureAccount=myAccount; AzureAccessKey=myKey;

Wasabi

  Wasabi
URI Formats

wasabi://bucket1/remotePath;

AccessKey

REQUIRED (your AccessKey)

SecretKey

REQUIRED (your SecretKey)

Region

OPTIONAL

OracleNamespace  

Connecting to Wasabi

Set the URI to the bucket and folder. Additionally, set the following properties to authenticate:

  • AWSAccessKey: Set this parameter to a Wasabi access key (a user name).

  • AWSSecretKey: Set this parameter to a Wasabi secret key.

Optionally, you can also specify the AWSRegion.

For example:

URI=wasabi://bucket1/folder1; AWSAccessKey=token1; AWSSecretKey=secret1; AWSRegion=OHIO;

Oracle Cloud

  Oracle Cloud Storage
URI Formats os://bucket/remotePath;
AccessKey

REQUIRED (your AccessKey)

SecretKey

REQUIRED (your SecretKey)

Region

OPTIONAL

OracleNamespace

REQUIRED

Connecting to Oracle Cloud Storage

Set the URI to the bucket and folder. Additionally, set the following properties to authenticate:

  • AccessKey: Set this parameter to an Oracle Cloud access key.

  • SecretKey: Set this parameter to an Oracle Cloud secret key.

  • OracleNamespace: Set this parameter to an Oracle Cloud namespace.

For example:

URI=os://bucket/remotePath/; AccessKey=token1; SecretKey=secret1; OracleNamespace=myNamespace; Region=us-ashburn-1;

Optionally, you can also specify the Region.