To store object model data reported by devices, the object model data storage feature is available. By default, the data storage's time series feature is activated for object model data storage, automatically writing object model data into the time series storage space. However, you can manually deactivate the time series data storage service for certain or all object models within a specific product. This topic outlines the steps to enable or disable object model data storage for a particular product.
Limits
Ensure that the current instance is a medium or premium enterprise edition instance and that the necessary time series data storage IOPS and time series data storage space have been acquired. For detailed instructions, see Purchase an enterprise edition instance.
Scenarios
To retrieve device data, utilize the API for querying. If object model data storage is deactivated, queries will be unavailable.
Custom topic data
For querying time series data: QueryDevicesHotStorageData.
For querying snapshot data: QueryDevicesHotStorageDataStatus.
Object model data
For all property snapshots of devices or IoT twin nodes: QueryDevicePropertyStatus.
For original properties reported by devices (verified and unverified by the object model) snapshots: QueryDeviceOriginalPropertyStatus.
For original properties reported by devices (verified and unverified by the object model) records: QueryDeviceOriginalPropertyData.
For original events reported by devices (verified and unverified by the object model) records: QueryDeviceOriginalEventData.
For original services invoked by devices (verified and unverified by the object model) records: QueryDeviceOriginalServiceData.
For long-term storage of device data, cost reduction, or further processing such as data analysis or data API integration, consider enabling device data backup. Once product data backup is enabled, the corresponding product's Offline Storage will automatically generate a Time Series/snapshot Table, which includes the Product Property Time Series Table, Product Property Snapshot Table, and Product Event Table.
Prerequisites
Ensure the object model is configured.
Procedure
Note that disabling object model data storage will prevent subsequent data reported by the corresponding device from being stored in the time series data storage space.
Access the IoT Platform console.
Navigate to the Instance Overview tab, locate the desired enterprise edition instance, and click on the instance card to proceed to the Instance Details page.
In the left-side navigation pane, go to Data Service > Data Storage.
Under the Time Series Storage tab, within the Storage Rules tab, you can toggle Object Model Data Storage or activate Product Data Backup.
To enable or disable object model data storage:
Click on the TSL Data Storage Rule in the Operation column to View.
On the Rule Details page, in the Object Model Storage section, use the dropdown list next to Product to select the desired product and object model Module.
Toggle the Time Series Storage switch in the object model list to enable or disable object model data storage for individual models.
Use the switch icon at the top right of the object model list to Enable All or Disable All object model data storage.
Optional: To preserve object model data for extended periods, activate Product Data Backup. On the Time Series Storage tab, under the Storage Rules tab, select Object Model Data Storage Rules and then click Data Backup in the Jump To Enable column. This will take you to the page, where you can manually enable the product's data backup and opt for the more economical offline storage.
What to do next
To configure the storage duration and IOPS ratio for object model data, refer to Manage time series storage configuration.