PurgeAllPropertyHistory
Beschreibung
Wenn protokollierte Eigenschaften aktualisiert werden, werden ihre Daten in einen Wert-Stream geschrieben, der dem Ding zugeordnet ist. Sie können den Dienst PurgeAllPropertyHistory verwenden, um die historischen Daten aus allen protokollierten Eigenschaften eines Dings für einen angegebenen Zeitbereich zu bereinigen.
Der Eigenschaftsverlauf des Dings, in dem der Dienst aufgerufen wird, wird bereinigt. Wenn Sie Daten für mehrere Dinge bereinigen möchten, müssen Sie den Dienst für jedes Ding aufrufen.
Eingaben
|
Parametername
|
Beschreibung
|
Basistyp
|
|
startDate
|
Das Startdatum, einschließlich des angegebenen Datums, ab dem die historischen Daten bereinigt werden sollen.
|
DATETIME
|
|
endDate
|
Das Enddatum, einschließlich des angegebenen Datums, bis zu dem die historischen Daten bereinigt werden sollen.
|
DATETIME
|
Ausgabe
Keine.
Beispiel
Im folgenden Beispiel hat das Ding die beiden protokollierten Eigenschaften propertyA-Logged und propertyB-Logged, die mehrmals aktualisiert wurden. Die historischen Daten beider Eigenschaften können zusammen mit diesem Dienst bereinigt werden.
Die Eingabeparameter können inline oder wie unten gezeigt übergeben werden:
// Purging historical data of all logged properties between the given start and end dates
Things["TestThing"].PurgeAllPropertyHistory({
startDate: '2024-05-12T16:58:28.000Z' /* DATETIME */,
endDate: Date.now() /* DATETIME */
});
Alternativ können Sie eine Infotable konstruieren:
// Params for purging historical data from the past year
var purgeAllPropertyHistoryParams = {
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now()
};
Things["TestThing"].PurgeAllPropertyHistory(purgeAllPropertyHistoryParams);