Skip to content

IoT Time Series Bulk Service

Idea

The IoT Time Series Bulk Service is a variant to the IoT Time Series Service, which is designed for importing high frequency simulation data into MindSphere. It can be used together with simulation assets to import the data into a suitable aspect structure. Its capabilities for handling simulation data will be extended in the future.

Access

For accessing this service you need to have the respective roles listed in IoT Time Series Service roles and scopes.

Basics

The IoT Time Series Bulk Service is very similar to the IoT Time Series Service.
The main difference is that the ingest of the data happens in a batch mode and the IoT Time Series Bulk Service is not limited to only return a maximum of 2,000 items per response when reading the data back. Instead, it returns as many items as possible until size and time limitations on the MindSphere Gateway are exceeded. If it cannot return all requested data in a single response, a link to the next data set is added to the response body. The URL of the link is automatically generated based on the already returned data: The start time is set to the timestamp of the last returned record and the maximum number of records is reduced by the number of already returned records.

A single import job of the IoT Time Series Bulk Service can take up to 10 input files that contain up to one hour of data, with start and end at the top of an hour.

Features

The IoT Time Series Bulk Service exposes its API for realizing the following tasks:

  • Import high frequency time series data for a given asset/aspect
  • Read high frequency time series data

Limitations

  • Currently, only the IoT File Service is supported as data source.
  • The maximum volume of time series data for one hour cannot exceed 50 MB.

Example Scenario

A company is already collecting data for an existing field device. They want to correlate this with simulation data created during the engineering or testing process in order to derive relevant KPIs. The company uploads the simulation data using the IoT File Service and triggers the import with the IoT Time Series Bulk Service. After the importing the data can be consumed via this service to be used by an application that also has access to the Time Series data of the field device.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.