Upload CSV data

To analyze data in Sigma that is not in your data warehouse, you can upload a CSV file.

User requirements

The ability to upload CSV data requires the following:

Limitations

The maximum file size for uploading a CSV-formatted file is 200MB.

Where's my data stored?

When a CSV file is uploaded to Sigma, the data in the file is automatically written to your data warehouse as a new table. If your organization has multiple data warehouses with write access enabled, you can choose which data warehouse to write the data to.

If you upload a CSV file to a workbook, the data in your file is only accessible from the Sigma workbook that uses the CSV file. You cannot see the table created from the CSV upload when browsing the tables in the connection's data catalog. If you delete the workbook, the data from the CSV file is no longer accessible.

💡

To reuse a CSV file in other workbooks, create a data model instead. You can also create a data model from a workbook table element if you already uploaded the file to a workbook.

Create a workbook from a CSV file

  1. Click Add element Create New in the left navigation panel, then select Upload CSV.

    The Upload CSV page opens.

  2. Select a Connection from the drop-down menu to specify the cloud data warehouse to upload your file to.
    If only one data warehouse has write access enabled, it is selected by default.
    Upload CSV page shown with the Sigma Docs Database connection selected in the Connections drop-down menu.

  3. Upload your CSV file by dragging and dropping it into the Upload CSV section, or click Browse.

    A preview of your data appears.

  4. While previewing your data, you can address any warnings or errors and make other adjustments:

    • [optional] On the left side of the page, deselect the checkboxes for any columns you want to exclude from the upload.
    • [optional] Customize the parsing options under Parsing Options.

    CSV file preview page, with a list of columns showing in the File Upload section with checkboxes that you can select or deselect, a Parsing Options section where you can specify whether the file contains headers, the delimiter used, whether the file uses single or double quotes, and the escape character to use. Your data as it will upload displays in the Results tab, and Warnings and Raw tabs are also visible.

  5. Click Explore in the top right corner of the page to open the data in a workbook.

Add a CSV file to an existing workbook

If you have an existing workbook, you can add a CSV file as a data element to the workbook.

Before you start: This action is only available in edit mode. To begin editing, click Edit in the top right corner of the page; see Workbook lifecycle.

  1. From within a workbook, select Add element to open the workbook's Add new element panel.

  2. Under Data elements, select the type of element you want to add: Table, Visualization, or Pivot table.

  3. As your data source for the element, select CSV to upload a CSV-formatted file.

  4. Select a Connection from the drop-down menu to specify the cloud data warehouse to upload your file to.
    If only one data warehouse has write access enabled, it is selected by default.
    Upload CSV page shown with the Sigma Docs Database connection selected in the Connections drop-down menu.

  5. Upload your CSV file by dragging and dropping it into the File Upload section, or click Browse.

    A preview of your data appears.

  6. While previewing your data, you can address any warnings or errors and optionally customize the parsing options in the Parsing Options section.

    CSV file preview page, with a list of columns showing in the File Upload section with checkboxes that you can select or deselect, a Parsing Options section where you can specify whether the file contains headers, the delimiter used, whether the file uses single or double quotes, and the escape character to use. Your data as it will upload displays in the Results tab, and Warnings and Raw tabs are also visible.

  7. Click Done.

    Your new element appears on the page, and the editor panel opens to the specific element’s configuration view.


Related resources