Ein Dataset stellt einen Projektionscontainer für Datenpunkte dar. Sie enthalten keine eigenen Informationen. Datasets stellen eine Reihe von Datenpunkten aus einer bestimmten Datenquelle dar. Ein Datenpunkt ist in mehreren Datasets enthalten.
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, die die Punkte in diesem Dataset erstellt hat. | |
maxEndTimeNs |
long |
Die größte Endzeit aller Datenpunkte in dieser möglicherweise unvollständigen Darstellung des Datasets. Die Zeit ist in Nanosekunden ab der UNIX-Epoche. Dieser sollte auch mit dem zweiten Teil der Dataset-ID übereinstimmen. | |
minStartTimeNs |
long |
Die kleinste Startzeit aller Datenpunkte in dieser möglicherweise unvollständigen Darstellung des Datasets. Die Zeit ist in Nanosekunden ab der UNIX-Epoche. Er 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 das Dataset zu groß für eine einzelne Antwort ist. Geben Sie diesen Wert in einer nachfolgenden GET-Anfrage an, um die nächste Seite der Datenpunkte in diesem Dataset zurückzugeben. | |
point[] |
list |
Eine unvollständige Liste von Datenpunkten im Dataset, sortiert nach endTimeNanos. Diese Liste gilt als vollständig, wenn ein kleines Dataset abgerufen und unvollständig wird, wenn ein Dataset gepatcht oder ein Dataset abgerufen wird, das zu groß für eine einzelne Antwort ist. | |
point[].computationTimeMillis |
long |
DIESES FELD NICHT VERWENDEN. Sie 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, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche. | |
point[].modifiedTimeMillis |
long |
Gibt an, wann dieser Datenpunkt zuletzt geändert wurde. Dies ist nur in Kontexten nützlich, in denen wir die Datenänderungen auflisten, anstatt den aktuellen Status der Daten darzustellen. | |
point[].originDataSourceId |
string |
Wenn der Datenpunkt in einem Dataset für eine abgeleitete Datenquelle enthalten ist, wird dieses Feld mit der ID des Datenquellenstreams gefüllt, der den Datenpunkt ursprünglich erstellt hat. ACHTUNG: Verwenden Sie dieses Feld nur für die Fehlerbehebung. Der Wert dieses Feldes, sofern es dafür festgelegt ist, ist ein Implementierungsdetail und garantiert nicht, dass er konsistent bleibt. |
|
point[].rawTimestampNanos |
long |
Der unbearbeitete Zeitstempel aus dem ursprünglichen SensorEvent. | |
point[].startTimeNanos |
long |
Die Startzeit des Intervalls, das durch diesen Datenpunkt dargestellt wird, in Nanosekunden seit der Epoche. | |
point[].value[] |
list |
Werte der einzelnen Datentypfelder für den Datenpunkt. Es wird erwartet, dass jeder Wert, der einem Datentypfeld entspricht, in derselben Reihenfolge auftritt, in der das Feld im Datentyp einer Datenquelle aufgeführt ist. Es wird nur eines der Felder „Ganzzahl“ und „Gleitkommazahl“ ausgefüllt, je nach Aufzählungsformat im Typfeld der Datenquelle. |
|
point[].value[].fpVal |
double |
Gleitkommawert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden. | |
point[].value[].intVal |
integer |
Ganzzahlwert. Ist dies festgelegt, 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 als Teil der Datentypdefinition dokumentiert werden. Schlüssel sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Schlüsseln und hoher Datenhäufigkeit können Daten reduziert werden. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Gleitkommawert. | |
point[].value[].stringVal |
string |
Stringwert. Ist dies festgelegt, dürfen keine anderen Werte festgelegt werden. Strings sollten nach Möglichkeit klein gehalten werden. Für Datenstreams mit großen Stringwerten und hoher Datenhäufigkeit kann es zu Stichprobefehlern kommen. |
Methoden
- Delete
- Führt einen inklusiven Löschvorgang aller Datenpunkte durch, deren Start- und Endzeiten sich mit dem Zeitraum überschneiden, der durch die Dataset-ID angegeben ist. Bei den meisten Datentypen wird der gesamte Datenpunkt gelöscht. Bei Datentypen, bei denen der Zeitraum einen konsistenten Wert darstellt (z. B.
com.google.activity.segment
) und sich ein Datenpunkt über einen beliebigen Endpunkt des Datasets erstreckt, wird nur der überlappende Teil des Datenpunkts gelöscht. - Holen Sie sich
- Gibt ein Dataset zurück, das alle Datenpunkte enthält, deren Start- und Endzeiten sich mit dem angegebenen Bereich der minimalen und maximalen Endzeit des Datasets überschneiden. Genauer gesagt: Jeder Datenpunkt, dessen Startzeit kleiner oder gleich der Dataset-Endzeit ist und dessen Endzeit größer oder gleich der Dataset-Startzeit 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 bereitgestellten Datenpunkte werden nur eingefügt und keine vorhandenen Daten ersetzt.