Skip to main content

The Nexalis Table Schema defines how the data within the tables is structured into columns.

Column Groups

Most columns are shared across both tables avg_std and hf_std, but there are some differences. Presence below is indicated as both, avg_std, or hf_std.

Device metadata

  • siteNameboth; site where the device is located
  • deviceModelboth; manufacturer and model
  • deviceIDboth; unique identifier of the device
  • subDeviceIDboth; distinguishes devices when connected via proxy/gateway
  • assetNameboth; concatenation of deviceID + subDeviceID
  • protocolboth; communication protocol used

Standardization fields

  • assetTypeboth; standardized device type (e.g., Solar inverter, Storage inverter, Meteo station, Meter, Wind turbine, etc.)
  • logicalNodeboth; standardized function type (e.g., MMDC: DC Measurements)
  • dataObjectboth; standardized tag (e.g., PhV: phase voltage)
  • subDataObjectboth; finer breakdown (e.g., phsA: phase A)
  • engUnitsboth; standardized engineering units
  • measurementTypeboth; Analog type vs Discrete type
These fields reference the Nexalis Ontology Data Model which is an ontology that provides the standardized vocabulary for classification (asset types, logical nodes, data objects, etc.). It is provided as a template and is customizable by users to match their operational context. It provides a standardized ontology data model for accessing and analyzing industrial data across different asset types.

Data values

  • dataPointboth; device‑specific identifier (e.g., Modbus register, OPC UA tag)
  • valueboth;
    • in avg_std: averaged value per interval
    • in hf_std: raw high‑frequency reading
  • min, max, countavg_std; aggregated statistics for each X‑minute interval
  • descriptionboth; manufacturer‑provided description
  • qualitySourceboth; quality indicator
  • triggerTypeboth; Nexalis Agent configuration for when to send data
  • metaDataboth; additional protocol parameters (settings, buffering info)

Timestamps

  • tsConnectorboth; epoch (ms) when collected
  • dtConnectorboth; human‑readable equivalent
  • tsReceptionboth; when sent to cloud
  • tsSourceboth; timestamp directly from device

Unique identifier

  • uniqueTagIDboth; concatenation of key fields → globally unique datapoint ID

Notes

  • Unstandardized tags → standardization columns remain empty (assetType, logicalNode, dataObject, subDataObject, engUnits, measurementType).
  • Filter standardized only → use query: dataObject != null.
  • gold_<user_name>_avg_std → interval configurable per‑agent. Best for trend analysis but does not include booleans/enumerations.
  • gold_<user_name>_hf_std → includes booleans/enumerations. Best for real‑time monitoring and troubleshooting.