Zoomdata Version

Configuring Source Refresh Rates

Starting with version 2.2.5, Zoomdata provides the ability to modify source refresh rates using its Administrative Framework REST APIs. Only live data sources have refresh rates. Consequently, you can only modify the refresh rate of a live data source. For more information about live refresh rates or configuring them using the Zoomdata client application, see Configuring the Refresh Rate Settings for Live Data Sources . For more information about global default settings, including refresh rates, see Global Default Settings (v2.4) .

Identifying Current Refresh Rates

You can identify whether a data source is live and, if so, what its current refresh rate is using curl or another HTTP utility or library to make the following call:

curl --user name : password -X GET 'https:// yourserver/path /api/sources/ 123456789 ' -H "Content-Type: application/vnd.zoomdata.v1+json;"

in which

  • name and password are the name and password with authorization to request information about the source
  • yourserver/path is the DNS and path for your Zoomdata server
  • 123456789 is replaced with the sourceID that contains the source that you wish to inspect

The source configuration object returned by this method includes the follow keys:

"live": true
"liveRefreshRate": 1
"name": "SOURCE_NAME",
"sourceParameters": {
"PARAM": "PARAMVAL"
},

The live key indicates whether the data source is live (also known as streaming or real-time).

The liveRefreshRate key indicates the refresh frequency of the data source. Note that this frequency is unitless. The units are supplied by the granularity of the source's data. For example, if granularity is hour , then a refresh rate of 3 indicates a refresh every three hours.

Make note of the name and sourceParameters keys because they must be included in the PUT method used to modify the refresh rate.

Modifying a Source's REFRESH RATE

You can modify a live data source's refresh rate using curl or another HTTP utility or library to make the following call:

curl --user name : password -X PUT -d '{"liveRefreshRate": 2 , "name": " NAME ", "sourceParameters": {" PARAM ": " PARAMVAL "}}' 'https:// yourserver / path /api/sources/ 123456789 ' -H "Content-Type: application/vnd.zoomdata.v1+json;"

in which

  • name and password are the name and password with authorization to modify the source
  • 2 is replaced with the refresh rate that you wish to use for the source
  • yourserver/path is the DNS and path for your Zoomdata server
  • 123456789 is replaced with the sourceID that contains the source that you wish to inspect
  • name is replaced with the name of the data source as discovered in the GET method detailed above
  • {"PARAM": "PARAMVAL"} is replaced with the actual value of sourceParameters as discovered in the GET method detailed above

The method returns the updated source object or an error message if the operation fails.

Was this topic helpful?