> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/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> Protocol </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> URL </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> File Location Method </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> File Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the file to search for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Directory File </p></td><td colspan="1" rowspan="1"><p> Select a file from the specified directory. You can select a CSV or GZ file to parse or a ZIP file to unzip. </p></td></tr><tr><td colspan="1" rowspan="1"><p> 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> 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"> 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"> 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>
