PrepareQuery - Amazon Timestream
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

PrepareQuery

Ein synchroner Vorgang, mit dem Sie eine Abfrage mit Parametern senden können, die von Timestream für die spätere Ausführung gespeichert werden sollen. Timestream unterstützt nur die Verwendung dieses Vorgangs mit ValidateOnly der Einstellung auf. true

Anforderungssyntax

{
   "QueryString": "string",
   "ValidateOnly": boolean
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

QueryString

Die Timestream-Abfragezeichenfolge, die Sie als vorbereitete Anweisung verwenden möchten. Parameternamen können in der Abfragezeichenfolge @ Zeichen gefolgt von einer Kennung angegeben werden.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.

Erforderlich: Ja

ValidateOnly

Wenn Sie diesen Wert auf setzentrue, überprüft Timestream nur, ob es sich bei der Abfragezeichenfolge um eine gültige Timestream-Abfrage handelt, und speichert die vorbereitete Abfrage nicht für die spätere Verwendung.

Typ: Boolesch

Erforderlich: Nein

Antwortsyntax

{
   "Columns": [ 
      { 
         "Aliased": boolean,
         "DatabaseName": "string",
         "Name": "string",
         "TableName": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "Parameters": [ 
      { 
         "Name": "string",
         "Type": { 
            "ArrayColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            },
            "RowColumnInfo": [ 
               { 
                  "Name": "string",
                  "Type": "Type"
               }
            ],
            "ScalarType": "string",
            "TimeSeriesMeasureValueColumnInfo": { 
               "Name": "string",
               "Type": "Type"
            }
         }
      }
   ],
   "QueryString": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

Columns

Eine Liste von SELECT Klauselspalten der übermittelten Abfragezeichenfolge.

Typ: Array von SelectColumn-Objekten

Parameters

Eine Liste von Parametern, die in der übermittelten Abfragezeichenfolge verwendet wurden.

Typ: Array von ParameterMapping-Objekten

QueryString

Die Abfragezeichenfolge, die Sie vorbereiten möchten.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 262144.

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

AccessDeniedException

Sie sind nicht berechtigt, diese Aktion auszuführen.

HTTPStatuscode: 400

InternalServerException

Der Dienst konnte diese Anfrage aufgrund eines internen Serverfehlers nicht vollständig verarbeiten.

HTTPStatuscode: 400

InvalidEndpointException

Der angeforderte Endpunkt war nicht gültig.

HTTPStatuscode: 400

ThrottlingException

Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.

HTTPStatuscode: 400

ValidationException

Ungültige oder falsch formatierte Anfrage.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: