Auf Wert-Stream-Daten mit Diensten zugreifen
Die folgenden Wert-Stream-Dienste sind über ein Ding oder eine Dingvorlage verfügbar. Die Daten müssen über das Ding zugänglich sein, das den Wert-Stream verwendet.
Sie können Wert-Stream-Einträge in einer Vielzahl von Arten und Weisen mit den bereitgestellten Diensten abrufen. Beispielsweise können Einträge von einer bestimmten protokollierten Eigenschaft (QueryBooleanPropertyHistory), (QueryDateTimePropertyHistory), einem Satz protokollierter Eigenschaften (QueryNamedPropertyHistory) oder allen protokollierten Eigenschaften (QueryPropertyHistory) abgerufen werden.
Wenn Sie mehrere Eigenschaften abrufen, führt ThingWorx einen speziellen Algorithmus aus, um sicherzustellen, dass eine vollständige synchrone Tabelle ohne Nullen zurückgegeben wird. Wenn eine Eigenschaft beispielsweise häufiger als eine andere Eigenschaft protokolliert wird, füllt ThingWorx die Leerstellen, wenn beide Eigenschaften gleichzeitig abgerufen werden.
Wert-Stream-Daten werden nicht gelöscht, es sei denn, das Ding, das die Daten erstellt hat, löscht die Daten explizit, oder der Wert-Stream wird gelöscht. Daten bleiben intakt, wenn das ursprüngliche Ding oder die ursprüngliche Eigenschaft gelöscht wird.
 |
Wenn Sie den Persistenzanbieter eines Wert-Streams wechseln (beispielsweise von ThingworxPersistenceProvider zu PostgreSQL oder InfluxDB), muss jedes Ding, das einen Wert-Stream implementiert, den Dienst RestartThing aufrufen, um in den neuen Persistenzanbieter geschriebene Einträge abrufen zu können. Wenn die Dinge nicht neu gestartet werden, werden die Einträge eventuell in die Datenbank geschrieben; sie werden jedoch erst abgerufen, wenn das Ding neu gestartet wurde.
|
|
|
Beim Filtern von Stream-Daten aus DSE-Wert-Streams, ist das Enddatum nicht inklusive. Wenn Sie beispielsweise Einträge abfragen und das Enddatum auf den genauen Zeitstempel des letzten Eintrags festlegen, ist der letzte Eintrag nicht in den Ergebnissen enthalten.
|
Wert-Stream-Dienste
• GetLoggedProperties
Gibt eine Liste der Eigenschaften des Dings zurück, die für die Wert-Stream-Protokollierung markiert sind.
• GetNumericLoggedProperties
Gibt eine Liste der Eigenschaften für einen angegebenen numerischen Basistyp zurück.
• GetPropertyLogging
Legt fest, ob eine Eigenschaft protokolliert wird.
• GetValueStream
Gibt den Namen des Wert-Streams zurück, der dem Ding zugewiesen ist.
• PurgePropertyHistory
Löscht alle Wert-Stream-Einträge für eine Eigenschaft innerhalb des angegebenen Datumsbereichs.
• QueryBooleanPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Booleschen Eigenschaftswerte innerhalb eines Datumsbereichs für das Ding ab.
• QueryDateTimePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen DateTime-Eigenschaftswerte des Dings ab.
• QueryImagePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Image-Eigenschaftswerte des Dings ab.
• QueryInfoTablePropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Infotable-Eigenschaftswerte innerhalb eines Datumsbereichs für das Ding ab.
• QueryIntegerPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Integer-Eigenschaftswerte des Dings ab.
• QueryLocationPropertyHistory
Fragt die Wert-Stream-Einträge für die angegebenen Location-Eigenschaftswerte innerhalb eines angegebenen Zeitbereichs für das Ding ab.
• QueryNamedPropertyHistory
Fragt die Wert-Stream-Einträge für einen angegebenen protokollierten Eigenschaftswert zusammen mit Filter- und Sortierkriterien ab und normalisiert den Datensatz, um Ergebnisse für einen bestimmten Zeitbereich anzuzeigen.
• QueryNumberPropertyHistory
Fragt den Wert-Stream für protokollierte Eigenschaftswerte zusammen mit Filter- und Sortierkriterien ab und normalisiert den Datensatz, um Ergebnisse für einen bestimmten Zeitbereich anzuzeigen.
Fragt den Wert-Stream für jeden protokollierten Eigenschaftswert innerhalb eines angegebenen Zeitbereichs für das Ding ab.
• QueryStringPropertyHistory
Fragt den Wert-Stream für die angegebenen String-Eigenschaftswerte innerhalb eines angegebenen Zeitbereichs für das Ding ab.
• SetPropertyLogging
Aktiviert/deaktiviert die Protokollierung für eine angegebene Eigenschaft.
• SetValueStream
Legt den Wert-Stream für das Ding fest.