Für ähnliche Funktionen wie Amazon Timestream für sollten Sie Amazon Timestream for LiveAnalytics InfluxDB in Betracht ziehen. Es bietet eine vereinfachte Datenaufnahme und Antwortzeiten im einstelligen Millisekundenbereich für Analysen in Echtzeit. [Erfahren](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) Sie hier mehr. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # WriteRecords Ermöglicht es Ihnen, Ihre Zeitreihendaten in Timestream zu schreiben. Sie können einen einzelnen Datenpunkt oder einen Stapel von Datenpunkten angeben, die in das System eingefügt werden sollen. Timestream bietet Ihnen ein flexibles Schema, das die Spaltennamen und Datentypen für Ihre Timestream-Tabellen auto anhand der Dimensionsnamen und Datentypen der Datenpunkte erkennt, die Sie beim Aufrufen von Schreibvorgängen in die Datenbank angeben. Timestream unterstützt die Lesesemantik mit eventueller Konsistenz. Das bedeutet, dass, wenn Sie Daten unmittelbar nach dem Schreiben eines Datenstapels in Timestream abfragen, die Abfrageergebnisse möglicherweise nicht die Ergebnisse eines kürzlich abgeschlossenen Schreibvorgangs widerspiegeln. Die Ergebnisse können auch einige veraltete Daten enthalten. Wenn Sie die Abfrageanforderung nach kurzer Zeit wiederholen, sollten die Ergebnisse die neuesten Daten zurückgeben. [Hier gelten Servicekontingente.](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) Einzelheiten finden Sie unter [Codebeispiel](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html). **Ärgernisse** Sie können den `Version` Parameter in einer `WriteRecords` Anfrage verwenden, um Datenpunkte zu aktualisieren. Timestream verfolgt mit jedem Datensatz eine Versionsnummer. `Version`wird standardmäßig verwendet, `1` wenn sie nicht für den Datensatz in der Anfrage angegeben ist. Timestream aktualisiert den Messwert eines vorhandenen Datensatzes zusammen mit dem Wert, `Version` wenn er eine Schreibanforderung erhält, mit einer höheren `Version` Zahl für diesen Datensatz. Wenn es eine Aktualisierungsanfrage erhält, bei der der Messwert mit dem des vorhandenen Datensatzes identisch ist, aktualisiert Timestream trotzdem`Version`, wenn er größer als der bestehende Wert von ist. `Version` Sie können einen Datenpunkt beliebig oft aktualisieren, solange der Wert von `Version` kontinuierlich steigt. Nehmen wir beispielsweise an, Sie schreiben einen neuen Datensatz, ohne dies `Version` in der Anfrage anzugeben. Timestream speichert diesen Datensatz und ist `Version` auf `1` eingestellt. Nehmen wir nun an, Sie versuchen, diesen Datensatz mit einer `WriteRecords` Anforderung für denselben Datensatz mit einem anderen Messwert zu aktualisieren, geben `Version` ihn aber wie zuvor nicht an. In diesem Fall lehnt Timestream diese Aktualisierung mit einem ab, `RejectedRecordsException` da die Version des aktualisierten Datensatzes nicht höher ist als der bestehende Wert von Version. Wenn Sie die Aktualisierungsanforderung jedoch erneut mit der `Version` Einstellung auf senden würden`2`, würde Timestream den Wert des Datensatzes erfolgreich aktualisieren, und der `Version` wäre auf gesetzt. `2` Nehmen wir als Nächstes an, Sie haben eine `WriteRecords` Anfrage mit demselben Datensatz und einem identischen Messwert gesendet, aber mit der `Version` Einstellung auf. `3` In diesem Fall würde Timestream nur `Version` auf `3` aktualisieren. Bei allen weiteren Updates müsste eine Versionsnummer gesendet werden, die größer als ist`3`, oder die Aktualisierungsanforderungen müssten eine `RejectedRecordsException` erhalten. ## Anforderungssyntax ``` { "CommonAttributes": { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number }, "DatabaseName": "string", "Records": [ { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number } ], "TableName": "string" } ``` ## Anforderungsparameter Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [CommonAttributes](#API_WriteRecords_RequestSyntax) ** Ein Datensatz, der die gemeinsamen Maß-, Dimensions-, Zeit- und Versionsattribute enthält, die von allen Datensätzen in der Anfrage gemeinsam genutzt werden. Die angegebenen Maß- und Dimensionsattribute werden mit den Kennzahl- und Dimensionsattributen im Datensatzobjekt zusammengeführt, wenn die Daten in Timestream geschrieben werden. Dimensionen dürfen sich nicht überlappen, sonst `ValidationException` wird eine ausgelöst. Mit anderen Worten, ein Datensatz muss Dimensionen mit eindeutigen Namen enthalten. Typ: [Record](API_Record.md) Objekt Erforderlich: Nein ** [DatabaseName](#API_WriteRecords_RequestSyntax) ** Der Name der Timestream-Datenbank. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 256 Zeichen. Erforderlich: Ja ** [Records](#API_WriteRecords_RequestSyntax) ** Eine Reihe von Datensätzen, die die eindeutigen Maß-, Dimension-, Zeit- und Versionsattribute für jeden Zeitreihendatenpunkt enthalten. Typ: Array von [Record](API_Record.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 100 Elemente. Erforderlich: Ja ** [TableName](#API_WriteRecords_RequestSyntax) ** Der Name der Timestream-Tabelle. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 256 Zeichen. Erforderlich: Ja ## Antwortsyntax ``` { "RecordsIngested": { "MagneticStore": number, "MemoryStore": number, "Total": number } } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) ** Informationen zu den Datensätzen, die durch diese Anfrage aufgenommen wurden. Typ: [RecordsIngested](API_RecordsIngested.md) Objekt ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md). ** AccessDeniedException ** Sie sind nicht berechtigt, diese Aktion durchzuführen. HTTP-Statuscode: 400 ** InternalServerException ** Timestream konnte diese Anfrage aufgrund eines internen Serverfehlers nicht vollständig verarbeiten. HTTP Status Code: 500 ** InvalidEndpointException ** Der angeforderte Endpunkt war nicht gültig. HTTP-Statuscode: 400 ** RejectedRecordsException ** WriteRecords würde diese Ausnahme in den folgenden Fällen auslösen: + Datensätze mit doppelten Daten, bei denen es mehrere Datensätze mit denselben Dimensionen, Zeitstempeln und Kennzahlnamen gibt, aber: + Die Kennzahlwerte sind unterschiedlich + Version ist in der Anfrage nicht vorhanden, *oder* der Wert der Version im neuen Datensatz ist gleich oder niedriger als der vorhandene Wert Wenn Timestream in diesem Fall Daten ablehnt, gibt das `ExistingVersion` Feld in der `RejectedRecords` Antwort die Version des aktuellen Datensatzes an. Um eine Aktualisierung zu erzwingen, können Sie die Anfrage erneut senden, wobei eine Version für den Datensatz auf einen Wert gesetzt ist, der größer als der ist. `ExistingVersion` + Datensätze mit Zeitstempeln, die außerhalb der Aufbewahrungsdauer des Speicherspeichers liegen. + Datensätze mit Dimensionen oder Kennzahlen, die die von Timestream definierten Grenzwerte überschreiten. Weitere Informationen finden Sie unter [Kontingente](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) im Amazon Timestream Developer Guide. ** RejectedRecords ** HTTP-Statuscode: 400 ** ResourceNotFoundException ** Der Vorgang hat versucht, auf eine nicht existierende Ressource zuzugreifen. Die Ressource wurde möglicherweise nicht richtig angegeben, oder ihr Status ist möglicherweise nicht AKTIV. HTTP-Statuscode: 400 ** ThrottlingException ** Ein Benutzer hat zu viele Anfragen gestellt und sie haben die Dienstkontingente überschritten. Die Anforderung wurde gedrosselt. HTTP-Statuscode: 400 ** ValidationException ** Eine ungültige oder falsch formatierte Anfrage. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords)