Ein Dataset ist ein Projektionscontainer für Datenpunkte. Sie enthalten keine eigenen Informationen. Datasets stellen einen Satz von Datenpunkten aus einer bestimmten Datenquelle dar. Ein Datenpunkt kann in mehreren Datasets gefunden werden.
Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
dataSourceId |
string |
Die Datenstream-ID der Datenquelle, von der die Punkte in diesem Dataset erstellt wurden. | |
maxEndTimeNs |
long |
Die längste Endzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datensatzes. Die Zeit wird in Nanosekunden der Epoche angegeben. Dieser sollte auch mit dem zweiten Teil der Dataset-ID übereinstimmen. | |
minStartTimeNs |
long |
Die kleinste Startzeit aller Datenpunkte in dieser möglicherweise Teildarstellung des Datasets. Die Zeit wird in Nanosekunden der Epoche angegeben. Dieser sollte auch mit dem ersten Teil der Dataset-ID übereinstimmen. | |
nextPageToken |
string |
Dieses Token wird festgelegt, wenn ein Dataset als Antwort auf eine GET-Anfrage empfangen wird und zu groß ist, um in eine einzelne Antwort aufgenommen zu werden. Geben Sie diesen Wert in einer nachfolgenden GET-Anfrage an, um die nächste Seite mit Datenpunkten in diesem Datensatz zurückzugeben. | |
point[] |
list |
Eine unvollständige Liste der im Dataset enthaltenen Datenpunkte, sortiert nach endTimeNanos. Diese Liste gilt als vollständig, wenn ein kleines Dataset abgerufen wird, und als unvollständig, wenn ein Dataset gepatcht oder ein Dataset abgerufen wird, das zu groß ist, um in eine einzelne Antwort aufgenommen zu werden. | |
point[].computationTimeMillis |
long |
VERWENDE DIESES FELD NICHT. Er wird ignoriert und nicht gespeichert. | |
point[].dataTypeName |
string |
Der Datentyp, der das Format der Werte in diesem Datenpunkt definiert. | |
point[].endTimeNanos |
long |
Die Endzeit des Intervalls, dargestellt durch diesen Datenpunkt, in Nanosekunden seit der Epoche. | |
point[].modifiedTimeMillis |
long |
Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Sie ist nur in Kontexten hilfreich, in denen die Datenänderungen aufgelistet und nicht der aktuelle Status der Daten dargestellt wird. | |
point[].originDataSourceId |
string |
Wenn der Datenpunkt in einem Dataset für eine abgeleitete Datenquelle enthalten ist, wird dieses Feld mit der Stream-ID der Datenquelle gefüllt, mit der der Datenpunkt ursprünglich erstellt wurde. ACHTUNG: Verlassen Sie sich ausschließlich zur Fehlerbehebung auf dieses Feld. Wenn der Wert dieses Felds überhaupt festgelegt ist, handelt es sich um ein Implementierungsdetail, dessen Konsistenz nicht garantiert ist. |
|
point[].rawTimestampNanos |
long |
Der Rohzeitstempel des ursprünglichen SensorEvent-Objekts. | |
point[].startTimeNanos |
long |
Startzeit des Intervalls, dargestellt durch diesen Datenpunkt, in Nanosekunden seit der Epoche. | |
point[].value[] |
list |
Werte jedes Datentypfelds für den Datenpunkt. Es wird erwartet, dass jeder Wert, der einem Datentypfeld entspricht, in derselben Reihenfolge auftritt, in der das Feld im Datentyp aufgelistet ist, der in einer Datenquelle angegeben ist. Abhängig vom Format „enum“ im Feld „Typ“ der Datenquelle wird nur eines der Felder „Ganzzahl“ und „Gleitkommazahl“ ausgefüllt. |
|
point[].value[].fpVal |
double |
Gleitkommawert. Wenn dieser festgelegt ist, dürfen keine anderen Werte festgelegt werden. | |
point[].value[].intVal |
integer |
Ganzzahlwert. Wenn dieser festgelegt ist, dürfen keine anderen Werte festgelegt werden. | |
point[].value[].mapVal[] |
list |
Kartenwert. Der gültige Schlüsselbereich und die gültigen Einheiten für den entsprechenden Wert jedes Eintrags sollten in der Datentypdefinition dokumentiert sein. Schlüssel sollten nach Möglichkeit klein gehalten werden. Bei Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit kann es zu Downsampling-Stichproben kommen. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Gleitkommawert. | |
point[].value[].stringVal |
string |
Stringwert. Wenn dieser festgelegt ist, dürfen keine anderen Werte festgelegt werden. Strings sollten nach Möglichkeit klein gehalten werden. Bei Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu Downsampling-Stichproben kommen. |
Methoden
- delete
- Führt ein inklusives Löschen aller Datenpunkte durch, deren Start- und Endzeit sich mit dem durch die Dataset-ID angegebenen Zeitraum überschneiden. Bei den meisten Datentypen wird der gesamte Datenpunkt gelöscht. Bei Datentypen, bei denen die Zeitspanne einen konsistenten Wert darstellt (z. B.
com.google.activity.segment
), und ein Datenpunkt auf einem der Endpunkte des Datasets liegt, wird nur der sich überschneidende Teil des Datenpunkts gelöscht. - get
- Gibt ein Dataset zurück, das alle Datenpunkte enthält, deren Start- und Endzeit sich mit dem angegebenen Bereich der minimalen und maximalen Endzeit des Datasets überschneiden. Insbesondere Datenpunkte, deren Startzeit kleiner oder gleich der Endzeit des Datasets ist und deren Endzeit größer oder gleich der Startzeit des Datasets ist.
- patch
- Fügt einem Dataset Datenpunkte hinzu. Das Dataset muss nicht zuvor erstellt werden.
Alle Punkte innerhalb des angegebenen Datasets werden mit nachfolgenden Aufrufen zum Abrufen dieses Datasets zurückgegeben. Datenpunkte können zu mehr als einem Dataset gehören.
Diese Methode verwendet keine Patch-Semantik: Die angegebenen Datenpunkte werden nur eingefügt, ohne vorhandene Daten zu ersetzen.