Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
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](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [QueryString](#API_query_PrepareQuery_RequestSyntax) **
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 : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 262 144.
Obligatoire : oui
** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) **
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 au format JSON par le service.
** [Columns](#API_query_PrepareQuery_ResponseSyntax) **
Liste des colonnes de clause SELECT de la chaîne de requête soumise.
Type : tableau d’objets [SelectColumn](API_query_SelectColumn.md)
** [Parameters](#API_query_PrepareQuery_ResponseSyntax) **
Liste des paramètres utilisés dans la chaîne de requête soumise.
Type : tableau d’objets [ParameterMapping](API_query_ParameterMapping.md)
** [QueryString](#API_query_PrepareQuery_ResponseSyntax) **
Chaîne de requête que vous souhaitez préparer.
Type : Chaîne
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 [Types d'erreurs courants](CommonErrors.md).
** AccessDeniedException **
Vous ne disposez pas des autorisations nécessaires pour accéder aux paramètres du compte.
Code d’état HTTP : 400
** InternalServerException **
Une erreur interne du serveur s'est produite lors du traitement de la demande.
Code d’état HTTP : 400
** InvalidEndpointException **
Le point de terminaison demandé n'est pas valide.
Code d’état HTTP : 400
** ThrottlingException **
La demande a été limitée en raison d'un nombre excessif de demandes.
Code d’état HTTP : 400
** ValidationException **
Demande non valide ou mal formée.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery)