Zoomdata Version

Connecting to Solr

The Solr connector allows users to visualize data stored in Solr databases. The Zoomdata server supports Solr v4.4.0 - v5.3.0 .

PREREQUISITES

If you use Solr version earlier than 5.2, increase the value of the formdataUploadLimitInKB setting in the solrconfig.xml to allow the expected number of data points the users need when grouping on a time field.
  • The table below lists information on the features that are supported in different Solr versions:
Supports Distinct Count? Yes (v4.8+)
Supports Live Mode/ Playback? No
SparkIt Capable? No
Supports Group-by Time? Yes (v4.8+)
Supports Multi Group-by Charts? Yes (v5.2+)
Supports Histogram? Yes
Supports Box Plot? Yes (v5.2+)
Custom SQL Capable? No
Supports Last Value? No
Supports Partition? No

CONFIGURING THE CONNECTION

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:

Start

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


Figure 1

  1. Click the Solr connector icon.

General Page

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


Figure 2

  1. Click Next to continue to the next setup page.

Connection Page

This page defines the connection source for Zoomdata to be able to access the data source. If this is the first time setting up a connection, then you need to input the necessary credentials. If a validated connection already exists, you are given the option to use it.

  1. To create a new connection, select the Input New Credentials option.
  2. Select the hosting type (Standalone or Cloud)
  3. Specify a Solr Base URL.
  4. Specify the version of the Solr source that you are going to connect to in the following format: major.minor.patch . This field is optional.
    While connecting to Solr, as a first step Zoomdata checks its version. If the version is not available, Zoomdata checks the version, that you have specified in this field and attempts to connect in the context of this version.
  5. If authentication has been set up, provide the User Name and Password.
    If you use Solr version earlier than 5.2, increase the value of the formdataUploadLimitInKB setting in the solrconfig.xml to allow the expected number of data points the users need when grouping on a time field.
  6. Click Validate .
    If successfully validated, the connection is saved.


Figure 3

Tables Page

The Tables page lets you select the schema and collection to connect with and provides a preview of the selected collection. In addition, caching options and toggling the availability of the fields can be done on this page.

  1. Select the schema, if available, and then select the desired collection to connect to Zoomdata.


Figure 4

  1. Apply the request handler if needed.
  2. Toggle the caching and lookup values options, as needed.
  3. Toggle the availability of the fields, as needed.
  4. Click Next to continue.

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.
When you create a data source, the specific number of distinct values for the attribute fields are saved in Zoomdata depending on the data sample from your data set. You can filter the data on your chart by these values. While editing a data source, if you want to use all distinct values in the filter (that is from whole data source), click the Refresh button in the Statistics column.
  1. For the Type column, you have the option to edit the field type (although usually you won't need to do this).
  2. 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
  3. Select fields for Distinct Counts as needed.
  4. Refresh the connection to a particular field, as desired.
  5. Configure Filter Display settings for fields.
  6. If you want to perform a search by a word or phrase on your chart, select a checkbox in the Faceted filter for the corresponding field. Otherwise, leave it blank.
  7. Select the checkbox in the Parent field column to mark the field as parent .
  8. Edit the Volume Metric settings, as needed.
  9. 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.
  10. Click Next to continue.


Figure 5

Refresh Page

The Refresh page lets you schedule asynchronous jobs to update the source metadata. For guidance to set up a refresh schedule, refer to the article Using the Zoomdata Scheduler .

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.


Figure 6

Learn more about how to customize a chart .

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

After you have created the Bars chart, you can search for a specific word or phrase via the search box. The Facets tab displays a list of columns you created. Click the items on the list to see your charts on the dashboard instantly updated.

Figure 7

SUPPORT OF SOLR VERSIONS PRIOR TO 5.2

If you work with a time period and select high granularity on your time bar (for example, minutes), an error can occur while processing the request. To avoid this, increase the formdataUploadLimitInKB value in Solr config.