IoT Time Series Bulk Service¶
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.
For accessing this service you need to have the respective roles listed in IoT Time Series Service roles and scopes.
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 accepts up to 10 input files, where the hour part of all timestamps within these files must be equal. The service also provides the capability to issue multiple import requests for the same hour. Using separate jobs it is possible to import files with overlapping time periods. Previously stored time series data is overwritten when uploading new data for the same time period.
This service does not process data from multiple import requests for the same hour in parallel. Import requests for a specific hour are handled sequentially in the order they are received.
Previously stored time series data is overwritten when uploading new data for the same time period.
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
- Currently, only the IoT File Service is supported as data source.
- The maximum volume of time series data for one hour cannot exceed 350 MB.
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?
Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.