> ## Documentation Index
> Fetch the complete documentation index at: https://www.domo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV Advanced Connector

## Intro

A character-separated values (CSV) file stores tabular data in plain text form. The Domo CSV Advanced connector allows you to access CSV files that you have uploaded to an SFTP server. You can also import files via HTTPS calls.

<Note>
  **Note:** Due to security concerns, Domo no longer permits uploading data using FTP. If necessary, please update your server settings to support SFTP instead of FTP.
</Note>

You connect to CSV files in the Data Center. This topic discusses the fields and menus that are specific to the CSV Advanced connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:201;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Use this connector to access CSV files from an SFTP server. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> N/A </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Analysts </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 1 hour </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 4 </p></td></tr></tbody></table>

## Best Practices

If you are using SFTP, make sure your credentials are ready and verified via your SSH key. The accepted formats for the key are either DES or RSA. If you are using HTTPS, you only need to verify that your resource is protected.

## Prerequisites

If you plan to access CSV files by connecting to an SFTP server, you must have a username and password to authenticate to that server. If you plan to access CSV files over HTTPS, credentials are required only if the resource is protected.

You need the username and password associated with your CSV file. You also your SSH key and the passphrase for your ssh key.

<Note>
  **Note: Domo does not support the SSH keys generated using ssh-keygen. The SSH keys need to be the DES or RSA keys (in PEM format) generated by OpenSSL.**
</Note>

## Connecting to CSV Files

This section enumerates the options in the **Credentials**, **Details**, and **Advanced** panes in the CSV Advanced Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Credentials Pane

In this pane you may need to enter a username and password, depending on what protocol you are using to access CSV data and whether the data is protected. If you plan to access CSV files by connecting to an SFTP server, you must enter the credentials for that server here (username, password, and host name). If you plan to access files over HTTPS, you only need to enter credentials if the resource is protected. You must also whitelist the IP addresses from the following article on the server: [Whitelisting IP Addresses for Connectors](https://domo-support.domo.com/s/article/360043439173?language=en_US "Whitelisting IP Addresses").

In either case, once you click **Next**, this CSV account is saved and you can use the same account any time you go to create a new CSV Advanced DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](https://domo-support.domo.com/s/article/360042926054?language=en_US "Managing User Accounts for Connectors").

You may also have the option to import the CSV file from a URL. If this is the case, you need the URL and potentially a username and password, depending on whether the source requires them.

## Details Pane

In this pane you choose a protocol (HTTP request or SFTP file transfer) then fill in the details for that protocol. This pane includes the following fields and menus:

<Note>
  **Note:** Due to security concerns, Domo no longer permits uploading data using FTP. If necessary, please update your server settings to support SFTP instead of FTP.
</Note>

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Select the Protocol to access the CSV File </p></td><td colspan="1" rowspan="1"><p> Select a protocol for accessing the CSV file. </p><p> Use SFTP to access a CSV file located on an SFTP server. </p><p> Use HTTP Request to access a CSV file using an HTTP GET request. The request is triggered by the use of a unique URL parameter defined by the service providing the CSV file. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Enter the URL to your CSV file </p></td><td colspan="1" rowspan="1"><p> Enter the URL for the CSV file. </p><p><span> If using the File Transfer protocol, enter the URL to the folder containing the CSV file. For example: s <a href="ftp://hostname/home/test" rel="noopener" target="_blank"> ftp\://hostname/home/test </a>. You'll also have to include the port in the URL if the SFTP server is not configured to run on the standard port 22. The 1234 port specific URL would look like s <a href="ftp://hostname:1234/home/test" rel="noopener" target="_blank"> ftp\://hostname:1234/home/test </a></span></p> <Note><div class="info-box-wrapper"><div class="info-box-icon-container" /><div class="info-box-content-container"><div class="info-box-content"><b> Note: </b> Due to security concerns, Domo no longer permits uploading data using FTP. If necessary, please update your server settings to support SFTP instead of FTP. </div></div></div> </Note><p> If using the HTTP Request protocol, enter the full URL for the CSV file. You must provide the URL as well as the fully qualified path, including the filename. For example: <span class="nowiki"><span class="mt-font-courier-new"><a href="http://www.ferc.gov/docs-filing/eqr/...v/contract.txt" rel="noopener" target="_blank"> [http://www.ferc.gov/docs-filing/eqr/...v/contract.txt](http://www.ferc.gov/docs-filing/eqr/...v/contract.txt) </a></span></span></p><p> If you are using the SFTP protocol, you can request a file for a specific date. You need to name your file using the format <span class="mt-font-courier-new"> `file_[yyyyMMdd]_suffix.csv` </span>. You can also select the most recent file using the format <span class="mt-font-courier-new"> filenameprefix\_\[latest] </span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Would you like to enter a file name to search for or select a file to retrieve every time </p></td><td colspan="1" rowspan="1"><p> Select whether you want to select a specific file from the specified directory or search for a file name. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Enter File Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the file to import into Domo. To import the most recently modified file, add \[latest] to the file name prefix.<br />
<b>Example:</b> Enter <i>myfile\[latest]</i> to import the most recently modified file with the prefix myfile.
</p></td></tr><tr><td colspan="1" rowspan="1"><p> File Name Match Type </p></td><td colspan="1" rowspan="1"><p> Select the file name match type.<br />
<Note>**Note:**: If you select **File Name Contains String** or **File Name Starts With String**, the most recently uploaded file is retrieved. </Note>
</p></td></tr><tr><td colspan="1" rowspan="1"><p> Select a file from the above directory </p></td><td colspan="1" rowspan="1"><p> Select a file from the specified directory. You can select a CSV, TXT or GZ file to parse or a ZIP file to unzip. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select a file type </p></td><td colspan="1" rowspan="1"><p> Select the file type for the file you want to access. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Enter the CSV file from the zip archive </p></td><td colspan="1" rowspan="1"><p> Enter the CSV file to parse from the zip file. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select a file from the Zip archive </p></td><td colspan="1" rowspan="1"><p> Select a CSV file to parse from the unzip folder. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Enter a filename from inside the Zip archive </p></td><td colspan="1" rowspan="1"><p> Enter the name of the file to parse from the ZIP archive. If you leave this field blank, the first file found is processed. </p></td></tr><tr><td colspan="1" rowspan="1"><p> HTTP Headers </p></td><td colspan="1" rowspan="1"><p> Enter additional headers for your HTTP/HTTPS CSV URL, if necessary. Use the format <span class="mt-font-courier-new"> header Name1 = 'headerValue1' </span> and <span class="mt-font-courier-new"> headerName2 = 'headerValue2' </span>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> HTTP Body </p></td><td colspan="1" rowspan="1"><p> Enter additional request body for your HTTPS CSV URL, if necessary. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Date Format </p></td><td colspan="1" rowspan="1"><p> Select the required date format. Use this option to correct incorrectly formatted dates. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Add file name column </p></td><td colspan="1" rowspan="1"><p> Adds the retrieved file name to the dataset in the <b>*BATCH\_FILE\_NAME*</b> column. If you select this option, only columns in the header row are used. Data without a column name in the header row is excluded. A blank column name is considered a column name. </p></td></tr><tr><td colspan="1" rowspan="1"> Convert Double type to Decimal </td><td colspan="1" rowspan="1"> Select this checkbox to convert Double to Decimal. </td></tr><tr><td colspan="1" rowspan="1"> Update only if the source file is modified </td><td colspan="1" rowspan="1"> Choose whether to retrieve and update data only if the source file has changed since the last execution. </td></tr><tr><td colspan="1" rowspan="1"> Cast Columns to String Datatype </td><td colspan="1" rowspan="1"> Enter a comma separated list of fields that need to be treated as <b> STRING </b> in Domo. </td></tr></tbody></table>

## Advanced Pane

In this pane you select the delimiter for your CSV file.

<table border="1" cellpadding="1" cellspacing="1" class="mt-responsive-table" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Delimiter Character </p></td><td colspan="1" rowspan="1"><p> Select the delimiter character used to separate columns in your CSV file. </p></td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Data Connector").

## Troubleshooting

* Verify that your credentials are correct.
* If you cannot connect using SFTP, check your firewall settings.

## FAQ

<AccordionGroup>
  <Accordion title="Does the connector support connecting to an FTPS server?">
    Yes, the connector supports FTPS server.
  </Accordion>

  <Accordion title="How frequently will my data update?">
    Data will update every hour.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    No.
  </Accordion>

  <Accordion title="Can I use the same CSV Advanced account for multiple datasets?">
    Yes.
  </Accordion>

  <Accordion title="What do I do if I cannot connect using SFTP?">
    If you cannot connect using SFTP, check your firewall settings.
  </Accordion>
</AccordionGroup>
