Zoomdata Version

Fields Tab

Use the Fields tab in the data source configuration wizard to configure settings for fields within the data source table you selected on the Tables/Indices Tab. You can also add derived fields or aggregated (calculated) fields to the data using this tab. The tailored and defined fields on this tab are then used as attributes and metrics for charts that use the data source configuration.

You must be logged in as an administrator to see the Fields tab of the data source configuration wizard.

The Fields tab is split into four tables.

When you are finished reviewing and modifying these tables (as needed), click Next to proceed to the Refresh Tab in the data source configuration wizard. Click Back to return to the Tables/Indices Tab.

The Field Table

The field table is the top table on the Fields tab. It lists all of the fields in the records of the data source collection or table you selected on the Tables/Indices Tab and allows you to configure them. To define the field metadata, 1,000 records are sampled.

The following table describes the settings you can alter for your data fields. The Field ID column shows the ID of the data field in the data record. If you click the associated with a data field, the date and time of the last refresh for that field display. To refresh your metadata, select Refresh Fields at the bottom of the field table.

Setting Description
Visible By default, all the fields are selected and are visible. This means that you can visualize the data from these fields on your charts. If you do not want to use specific fields, clear the corresponding checkboxes.
Field ID The name of the field in the data from the data store. Note that Zoomdata supports only underscores and dashes in data store field names. No other special characters or white space are supported. If your data store uses special characters other than underscores and dashes in field names, please remove them and then try to create this data source configuration again.

By default, the names of the fields from your data source are used as labels on your charts. Change the labels in this column as needed.


The type for each field is defined, by default, by Zoomdata. The default data types are displayed in the Type column. You can change them by selecting another option from the drop-down list.

You can set the maximum character length of attribute fields. By default, it is limited to 200 characters and the field is recognized as an Attribute. If this limit is exceeded, the field will be recognized as a Text field. Add or modify the FieldsTypeDetector​ property in the zoomdata.properties file as required.
If you want to use a field in row-level expressions, do not change its original field type. Changing the field type of the original field may generate errors for the row-level expressions. Instead, change the field type in a derived field created from the original field and then use the new derived field in your row-level expressions.
Partition If you are using Cloudera Impala, Apache Drill, Hive, or Spark SQL as your data source, the Partitioned column shows if fields within your source are partitioned.

The Configure column allows you to configure each field.

  • For metrics, you can define the default aggregation function: SUM, AVG, MAX, MIN, or (for some data sources) LAST_VALUE. See Available Metric Functions.
  • For number fields, you can define the number format used. Click on the format to display the Format dialog and use the dialog to define the number format. You can select the Apply to all number fields in <data source> checkbox to apply the number format to all of the number fields in this data source definition. Click Apply to apply your number format changes.
  • For time fields, you can set the time pattern, granularity and time zone. Time patterns are either Default or Custom. If you select Custom, custom time patterns are specified in YYYY-MM-DD format.

    Granularity can be set to Second, Minute, Hour, Day, Week, Month or Year.

    If you click on the time zone, the Time Zone dialog appears, allowing you to select the time zone from a drop-down list. You can also select the Apply to all time fields in <data source> checkbox to apply the selected time zone to all of the time fields included in this data source definition. Click Apply to apply your time zone changes.

Distinct Count Select or deselect the checkbox in the Distinct Count column to enable or disable the distinct count metric in the list of field aggregation functions. See Enabling Distinct Counts.

Select the refresh button in this column to refresh the statistics of the field. This forces Zoomdata to run profiling queries and refresh the statistics (such as minimum, maximum, and unique values) for the field. The data is used by filter panels in the UI.

This column is available for all data source types except upload API and flat file data sources.

Filter Display

Use the Filter Display column to set the range of data available in the filters for all data types.

  • For attribute fields, select the Only Allow Custom Values checkbox if you want to enter the names of attributes manually when working in the Filters dialog, since the list of attributes is not displayed.
  • For integer, money, and number fields, expand Custom Range to specify minimum and maximum values for the fields. The Custom Range dialog displays when Custom Range is expanded
  • For time fields, expand Custom Range to specify to and from dates and times for the fields. The Custom Range dialog displays when Custom Range is expanded

The Derived Fields Table

The Derived Fields table lists derived fields you have defined for the data and allows you to add others. See About Derived Fields.

The Volume Metric Table

The Volume Metric table allows you to rename or hide the Volume field used in charts of the data. You can only alter this field if it has not already been used by a chart.

The Custom Metrics Table

The Custom Metrics table lists custom metrics you have defined for the data and allows you to define others. See About Custom Metrics.

Was this topic helpful?