Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
PrepareQuery
Opération synchrone qui vous permet de soumettre une requête avec des paramètres à stocker par Timestream pour une exécution ultérieure. Timestream ne prend en charge l'utilisation de cette opération que si elle est ValidateOnly définie sur. true
Syntaxe de la requête
{
"QueryString": "string",
"ValidateOnly": boolean
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
La demande accepte les données suivantes au JSON format suivant.
- QueryString
-
Chaîne de requête Timestream que vous souhaitez utiliser comme instruction préparée. Les noms de paramètres peuvent être spécifiés dans le caractère
@de la chaîne de requête suivi d'un identifiant.Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Obligatoire : oui
- ValidateOnly
-
En définissant cette valeur sur
true, Timestream validera uniquement que la chaîne de requête est une requête Timestream valide, et ne stockera pas la requête préparée pour une utilisation ultérieure.Type : booléen
Obligatoire : non
Syntaxe de la réponse
{
"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"
}Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées sous JSON forme formatée par le service.
- Columns
-
Liste des colonnes de SELECT clauses de la chaîne de requête soumise.
Type : tableau d’objets SelectColumn
- Parameters
-
Liste des paramètres utilisés dans la chaîne de requête soumise.
Type : tableau d’objets ParameterMapping
- QueryString
-
Chaîne de requête que vous souhaitez préparer.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- AccessDeniedException
-
Vous n'êtes pas autorisé à effectuer cette action.
HTTPCode de statut : 400
- InternalServerException
-
Le service n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.
HTTPCode de statut : 400
- InvalidEndpointException
-
Le point de terminaison demandé n'était pas valide.
HTTPCode de statut : 400
- ThrottlingException
-
La demande a été refusée suite à une limitation des demandes.
HTTPCode de statut : 400
- ValidationException
-
Demande non valide ou mal formée.
HTTPCode de statut : 400
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
