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. # Query `Query`ist ein synchroner Vorgang, mit dem Sie eine Abfrage für Ihre Amazon Timestream Timestream-Daten ausführen können. Wenn Sie diese API aktiviert haben`QueryInsights`, gibt sie auch Erkenntnisse und Metriken zurück, die sich auf die von Ihnen ausgeführte Abfrage beziehen. `QueryInsights`hilft bei der Leistungsoptimierung Ihrer Abfrage. Weitere Informationen `QueryInsights` dazu finden Sie unter [Verwenden von Abfrageerkenntnissen zur Optimierung von Abfragen in Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html). **Anmerkung** Die maximale Anzahl von `Query` API-Anfragen, die Sie bei `QueryInsights` aktivierter Option stellen dürfen, beträgt 1 Abfrage pro Sekunde (QPS). Wenn Sie diese Abfragerate überschreiten, kann dies zu einer Drosselung führen. `Query`wird nach 60 Sekunden ein Timeout ausgelöst. Sie müssen das Standard-Timeout im SDK so aktualisieren, dass es ein Timeout von 60 Sekunden unterstützt. Einzelheiten finden Sie im [Codebeispiel](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html). Ihre Abfrageanfrage schlägt in den folgenden Fällen fehl: + Wenn Sie eine `Query` Anfrage mit demselben Client-Token außerhalb des 5-minütigen Idempotenzfensters einreichen. + Wenn Sie innerhalb des 5-minütigen Idempotenzfensters eine `Query` Anfrage mit demselben Client-Token einreichen, aber andere Parameter ändern. + Wenn die Größe der Zeile (einschließlich der Abfrage-Metadaten) 1 MB überschreitet, schlägt die Abfrage fehl und die folgende Fehlermeldung wird angezeigt: `Query aborted as max page response size has been exceeded by the output result row` + Wenn der IAM-Prinzipal des Abfrageinitiators und des Ergebnislesers nicht identisch sind, and/or der Abfrageinitiator und der Ergebnisleser nicht dieselbe Abfragezeichenfolge in den Abfrageanforderungen haben, schlägt die Abfrage mit einem Fehler fehl. `Invalid pagination token` ## Anforderungssyntax ``` { "ClientToken": "string", "MaxRows": number, "NextToken": "string", "QueryInsights": { "Mode": "string" }, "QueryString": "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. ** [ClientToken](#API_query_Query_RequestSyntax) ** Eindeutige Zeichenfolge mit bis zu 64 ASCII-Zeichen, bei der Groß- und Kleinschreibung berücksichtigt wird, wenn eine Anfrage gestellt wird. `Query` *Die Angabe von a `ClientToken` macht den Aufruf idempotent. `Query`* Das bedeutet, dass das wiederholte Ausführen derselben Abfrage zum gleichen Ergebnis führt. Mit anderen Worten, das Stellen mehrerer identischer `Query` Anfragen hat den gleichen Effekt wie das Stellen einer einzelnen Anfrage. Beachten Sie `ClientToken` bei der Verwendung in einer Abfrage Folgendes: + Wenn die Abfrage-API ohne a instanziiert wird`ClientToken`, generiert das Query-SDK in `ClientToken` Ihrem Namen eine. + Wenn der `Query` Aufruf nur die, `ClientToken` aber keine enthält, wird davon ausgegangen`NextToken`, dass es sich bei diesem Aufruf von um einen neuen Abfragelauf `Query` handelt. + Wenn der Aufruf Folgendes enthält`NextToken`, wird davon ausgegangen, dass es sich bei diesem speziellen Aufruf um einen nachfolgenden Aufruf eines vorherigen Aufrufs der Abfrage-API handelt, und es wird eine Ergebnismenge zurückgegeben. + Nach 4 Stunden `ClientToken` wird jede Anfrage mit demselben Inhalt wie eine neue Anfrage behandelt. Typ: Zeichenfolge Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen. Erforderlich: Nein ** [MaxRows](#API_query_Query_RequestSyntax) ** Die Gesamtzahl der Zeilen, die in der `Query` Ausgabe zurückgegeben werden sollen. Bei der ersten Ausführung von `Query` mit einem angegebenen `MaxRows` Wert wird in zwei Fällen die Ergebnismenge der Abfrage zurückgegeben: + Die Größe des Ergebnisses ist kleiner als`1MB`. + Die Anzahl der Zeilen in der Ergebnismenge ist geringer als der Wert von`maxRows`. Andernfalls gibt der erste Aufruf von `Query` only a zurück`NextToken`, das dann in nachfolgenden Aufrufen zum Abrufen der Ergebnismenge verwendet werden kann. Um die Paginierung fortzusetzen, geben Sie den `NextToken` Wert im nachfolgenden Befehl ein. Wenn die Zeilengröße groß ist (z. B. eine Zeile hat viele Spalten), gibt Timestream möglicherweise weniger Zeilen zurück, um zu verhindern, dass die Antwortgröße die Grenze von 1 MB überschreitet. Wenn nicht `MaxRows` angegeben, sendet Timestream die erforderliche Anzahl von Zeilen, um das Limit von 1 MB einzuhalten. Typ: Ganzzahl Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000. Erforderlich: Nein ** [NextToken](#API_query_Query_RequestSyntax) ** Ein Paginierungstoken, das verwendet wird, um eine Reihe von Ergebnissen zurückzugeben. Wenn die `Query` API mit aufgerufen wird, wird davon ausgegangen`NextToken`, dass es sich bei diesem bestimmten Aufruf um einen nachfolgenden Aufruf eines vorherigen Aufrufs von handelt`Query`, und es wird eine Ergebnismenge zurückgegeben. Wenn der `Query` Aufruf jedoch nur den enthält, `Query` wird davon ausgegangen`ClientToken`, dass es sich bei diesem Aufruf von um einen neuen Abfragelauf handelt. Beachten Sie bei der Verwendung NextToken in einer Abfrage Folgendes: + Ein Paginierungstoken kann für bis zu fünf `Query` Aufrufe ODER für eine Dauer von bis zu 1 Stunde verwendet werden — je nachdem, was zuerst eintritt. + Wenn Sie dasselbe verwenden, `NextToken` wird derselbe Satz von Datensätzen zurückgegeben. Um die Ergebnismenge weiterhin paginieren zu können, müssen Sie die neueste Version verwenden. `nextToken` + Angenommen, ein `Query` Aufruf gibt zwei `NextToken` Werte zurück, und. `TokenA` `TokenB` Wenn in einem nachfolgenden `Query` Aufruf verwendet `TokenB` wird, `TokenA` ist es ungültig und kann nicht wiederverwendet werden. + Um nach Beginn der Paginierung eine vorherige Ergebnismenge aus einer Abfrage anzufordern, müssen Sie die Abfrage-API erneut aufrufen. + Die neueste Version `NextToken` sollte verwendet werden, um zu paginieren, bis sie zurückgegeben `null` wird. Ab diesem Zeitpunkt sollte eine neue `NextToken` Version verwendet werden. + Wenn der IAM-Prinzipal des Abfrageinitiators und des Ergebnislesers nicht identisch sind, and/or der Abfrageinitiator und der Ergebnisleser nicht dieselbe Abfragezeichenfolge in den Abfrageanforderungen haben, schlägt die Abfrage mit einem Fehler fehl. `Invalid pagination token` Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen. Erforderlich: Nein ** [QueryInsights](#API_query_Query_RequestSyntax) ** Kapselt Einstellungen für die Aktivierung. `QueryInsights` Durch die Aktivierung werden zusätzlich zu den Abfrageergebnissen für die von Ihnen ausgeführte Abfrage auch Erkenntnisse und Metriken `QueryInsights` zurückgegeben. Sie können es verwenden`QueryInsights`, um Ihre Abfrageleistung zu optimieren. Typ: [QueryInsights](API_query_QueryInsights.md) Objekt Erforderlich: Nein ** [QueryString](#API_query_Query_RequestSyntax) ** Die Abfrage, die von Timestream ausgeführt werden soll. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144. Erforderlich: Ja ## Antwortsyntax ``` { "ColumnInfo": [ { "Name": "string", "Type": { "ArrayColumnInfo": "ColumnInfo", "RowColumnInfo": [ "ColumnInfo" ], "ScalarType": "string", "TimeSeriesMeasureValueColumnInfo": "ColumnInfo" } } ], "NextToken": "string", "QueryId": "string", "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } }, "UnloadPartitionCount": number, "UnloadWrittenBytes": number, "UnloadWrittenRows": number }, "QueryStatus": { "CumulativeBytesMetered": number, "CumulativeBytesScanned": number, "ProgressPercentage": number }, "Rows": [ { "Data": [ { "ArrayValue": [ "Datum" ], "NullValue": boolean, "RowValue": "Row", "ScalarValue": "string", "TimeSeriesValue": [ { "Time": "string", "Value": "Datum" } ] } ] } ] } ``` ## 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. ** [ColumnInfo](#API_query_Query_ResponseSyntax) ** Die Spaltendatentypen der zurückgegebenen Ergebnismenge. Typ: Array von [ColumnInfo](API_query_ColumnInfo.md)-Objekten ** [NextToken](#API_query_Query_ResponseSyntax) ** Ein Paginierungstoken, das bei einem `Query` Aufruf erneut verwendet werden kann, um die nächsten Ergebnisse abzurufen. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen. ** [QueryId](#API_query_Query_ResponseSyntax) ** Eine eindeutige ID für die angegebene Abfrage. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen. Pattern: `[a-zA-Z0-9]+` ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) ** Kapselt, `QueryInsights` die Erkenntnisse und Metriken zu der von Ihnen ausgeführten Abfrage enthalten. Typ: [QueryInsightsResponse](API_query_QueryInsightsResponse.md) Objekt ** [QueryStatus](#API_query_Query_ResponseSyntax) ** Informationen zum Status der Abfrage, einschließlich des Fortschritts und der gescannten Byte. Typ: [QueryStatus](API_query_QueryStatus.md) Objekt ** [Rows](#API_query_Query_ResponseSyntax) ** Die von der Abfrage zurückgegebenen Ergebnismengenzeilen. Typ: Array von [Row](API_query_Row.md)-Objekten ## Fehler Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md). ** AccessDeniedException ** Sie verfügen nicht über die erforderlichen Berechtigungen, um auf die Kontoeinstellungen zuzugreifen. HTTP-Statuscode: 400 ** ConflictException ** Die Ergebnisse für eine stornierte Abfrage konnten nicht abgefragt werden. HTTP-Statuscode: 400 ** InternalServerException ** Bei der Verarbeitung der Anfrage ist ein interner Serverfehler aufgetreten. HTTP-Statuscode: 400 ** InvalidEndpointException ** Der angeforderte Endpunkt ist ungültig. HTTP-Statuscode: 400 ** QueryExecutionException ** Timestream konnte die Abfrage nicht erfolgreich ausführen. HTTP-Statuscode: 400 ** ThrottlingException ** Die Anfrage wurde aufgrund übermäßiger Anfragen gedrosselt. HTTP-Statuscode: 400 ** ValidationException ** 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-query-2018-11-01/Query) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query)