Zoomdata Version

Uploading a Flat File into Zoomdata

Zoomdata can visualize data from flat files including CSV, JSON, and TSV files. Note the following:

  • Maximum supported file size is 500 MB
  • Data from the flat file is stored in a PostgreSQL database

The table below lists information on the features that are supported for a flat file upload:

Supports Distinct Count? Yes
Supports Group-by Time? Yes
Supports Multi Group-by Charts? Yes
Supports Histogram? Yes
Supports Box Plot? Yes
Supports Derived Fields? Yes
Custom SQL Capable? No
Live Mode & Playback Yes
Supports Last Value? Yes


For details about what is provided on each page of the connection process, review the article Source Connection Workflow. Depending on your needs, you can either follow the steps in order from start to finish or jump to a specific section in the connection process:


  1. Log into Zoomdata.
  2. Click the Sources menu item.

    Figure 1
  3. Click the Flat File connector icon.

General Page


  1. Specify the name of your source and add a description (if desired).
  1. Specify the name of your source and add a description (if desired).

Data Page

  1. On the Data page, click Choose File and select a CSV, JSON, or TSV file to upload. Prior to uploading the file, make sure that the selected file meets the requirements listed on the page.

Fields Page

The Fields page lets you (1) configure attribute options, (2) create custom labels for the fields in your data source (that will be displayed in the charts), (3) manage the Volume metric, and (4) work with Calculations.

  1. Determine whether the field should be visible or not to the user.
  2. Create unique label names, as needed, for each Label field.
  3. For the Type column, you have the option to edit the field type (although usually you won't need to do this).
  4. For the Configure column, numeric and time-based fields may be edited:
    • Numeric types including Money, Number and Integer - ability to select a default aggregation function
    • Time fields - ability to define the default time pattern and granularity; if the time field provides granularities of hour, minute and second, then a time zone label may be applied
  5. Select fields for Distinct Counts as needed.
  6. Refresh the connection to a particular field, as desired.
  7. Configure filter settings for fields.
  8. Edit the Volume Metric settings, as needed.
  1. Work with Calculations , if available and as needed.
    If you are setting up a new connection, the Calculations section will not be available until after the connection is saved.
  2. Click Next to continue.

Charts Page

On the Charts page, you can:

  1. Edit Global Default Settings .
  2. Select the Standard and, if available, Custom chart styles to be used with the data source.
  3. Set default parameters (group, sub-group, colors, sorting, and so on) for each chart style.

Click Finish to save your changes. Once your data connection has been established, it is listed under the My Data Sources section of the page.

Was this topic helpful?