Requêtes StableNet
Cette section s'applique uniquement aux systèmes intégrés avec StableNet®
Les données StableNet® peuvent être interrogées à partir d'un jeu de données agrégées sur une base de données SKOOR locale ainsi qu'en temps réel depuis l'API StableNet®. Les recommandations suivantes permettent de combiner et d'optimiser ces deux méthodes.
Préparer une requête de données matérialisée pour les équipements et les mesures
L'exemple de requête suivant fournit des données de base utilisables avec un widget FilterMatrix (par exemple pour filtrer des équipements ou des mesures) ainsi que pour joindre des données de mesure provenant de l'API StableNet® ou de la table de données agrégées. La source de données doit être définie sur une source de type StableNet.
-- Data query example "device_measurement" SELECT std.id AS device_id, std.display_name AS device_name, sm.id as measurement_id, sm.name as measurement_name FROM stablenet_taggable_device std JOIN stablenet_measurement sm ON std.id = sm.dest_device_id
Étant donné que les données des équipements et des mesures ne changent pas très souvent, cette requête doit être matérialisée. Les performances seront considérablement améliorées.
Définissez l'intervalle d'actualisation sur daily et créez des index pour tous les attributs :
Joindre une table distante pour les données en temps réel
En plus de la requête de données matérialisée préparée, les données de l'API StableNet® peuvent être jointes à l'aide d'une table distante.
Dans l'exemple suivant, le mot-clé FROM pointe vers la requête matérialisée préparée ci-dessus.
SELECT
dm.device_id,
dm.device_name,
dm.measurement_name,
dm.measurement_id,
sma.metric_key,
sma.metric_name,
sma.interval,
sma.min,
sma.max,
sma.avg,
sma.timestamp
FROM device_measurement dm
JOIN stablenet_measurement_data sma
ON dm.measurement_id = sma.measurement_id
WHERE sma.start = ${begin}::timestamptz
AND sma."end" = ${end}::timestamptz
AND sma.bucket_size = EXTRACT(
EPOCH FROM ('1 ' || ${bucket_size})::interval
)::integer
AND sma.metric_name = ${metric_name}
Dans le tableau de bord ou l'aperçu des données, les attributs suivants doivent être définis pour cet exemple de requête :
begin/end : horodatage ISO 8601, par ex. 2024-05-01T00:00:00Z
bucket_size : intervalle de temps en toutes lettres tel que hour, day, month, etc.
metric_name : un nom de métrique StableNet® valide tel que Round Trip Time
Au lieu de metric_name, utilisez l'attribut metric_key dans la clause WHERE pour sélectionner une métrique spécifique si plusieurs sont disponibles
Joindre la table de données agrégées
Si les performances sont plus importantes que les données en temps réel, la table de données agrégées doit être privilégiée par rapport aux tables distantes.
Dans l'exemple suivant, le mot-clé FROM pointe vers la requête matérialisée préparée ci-dessus.
SELECT
dm.device_id,
dm.device_name,
dm.measurement_name,
dm.measurement_id,
sma.metric_key,
sma.metric_name,
sma.interval,
sma.min,
sma.max,
sma.avg,
sma.timestamp
FROM device_measurement dm
JOIN stablenet_measurement_data_aggregated sma
ON dm.measurement_id = sma.measurement_id
WHERE sma.timestamp BETWEEN ${begin}::timestamptz AND ${end}::timestamptz
AND sma.metric_name = ${metric_name}
Dans le tableau de bord ou l'aperçu des données, les attributs suivants doivent être définis pour cet exemple de requête :
begin/end : horodatage ISO 8601, par ex. 2024-05-01T00:00:00Z
metric_name : un nom de métrique StableNet® valide tel que Round Trip Time
Au lieu de metric_name, utilisez l'attribut metric_key dans la clause WHERE pour sélectionner une métrique spécifique si plusieurs sont disponibles
Tables distantes
Nom | Champs | Qualificatifs |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Bien que measurement_id et metric_key soient facultatifs, il n'est pas recommandé d'exécuter des requêtes sans eux. Cela lit les données de toutes les mesures et de toutes les métriques, ce qui peut prendre beaucoup de temps et exerce une charge importante sur le server StableNet. Cela n'est conseillé que pour de très courtes plages de temps < 1h. Si plusieurs mesures et métriques sont nécessaires, la table stablenet_measurement_data_aggregated doit être utilisée.
Données de mesure agrégées
Agrégées par heure, mises à jour automatiquement chaque heure. Peuvent être utilisées pour exécuter des requêtes d'analyse sur un large éventail de mesures et sur de grandes plages de temps.
Il s'agit essentiellement d'une hypertable Timescale (https://docs.timescale.com/ ). La taille des chunks est de 7 jours ; les chunks sont compressés après 7 jours.
Nom | Champs |
|---|---|
|
|
stablenet_measurement_data_aggregated contient uniquement des données pour les clés de métrique configurées.


