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.
# ExecuteScheduledQuery
Vous pouvez utiliser cette API pour exécuter une requête planifiée manuellement.
Si vous l'avez activée`QueryInsights`, cette API renvoie également des informations et des statistiques relatives à la requête que vous avez exécutée dans le cadre d'une notification Amazon SNS. `QueryInsights`aide à optimiser les performances de votre requête. Pour en savoir plus`QueryInsights`, consultez la section [Utilisation des informations relatives aux requêtes pour optimiser les requêtes dans Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html).
## Syntaxe de la requête
```
{
"ClientToken": "string",
"InvocationTime": number,
"QueryInsights": {
"Mode": "string"
},
"ScheduledQueryArn": "string"
}
```
## 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.
** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Non utilisé.
Type : Chaîne
Contraintes de longueur : longueur minimale de 32. Longueur maximale de 128.
Obligatoire : non
** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Horodatage en UTC. La requête sera exécutée comme si elle avait été invoquée à cet horodatage.
Type : Timestamp
Obligatoire : oui
** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) **
Encapsule les paramètres à activer`QueryInsights`.
Activation des informations et des statistiques sur les `QueryInsights` retours dans le cadre de la notification Amazon SNS pour la requête que vous avez exécutée. Vous pouvez l'utiliser `QueryInsights` pour ajuster les performances et le coût de vos requêtes.
Type : objet [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md)
Obligatoire : non
** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) **
ARN de la requête planifiée.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.
Obligatoire : oui
## Éléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](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
** ResourceNotFoundException **
La ressource demandée est introuvable.
** ScheduledQueryArn **
L'ARN de la requête planifiée.
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
## Exemples
### Message de notification de requête planifiée pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
L'exemple suivant montre un message de notification de requête planifiée réussie pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.
```
"SuccessNotificationMessage": {
"type": "MANUAL_TRIGGER_SUCCESS",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1723710546,
"triggerTimeMillis": 1723710547490,
"runStatus": "MANUAL_TRIGGER_SUCCESS",
"executionStats": {
"executionTimeInMillis": 17343,
"dataWrites": 1024,
"bytesMetered": 0,
"cumulativeBytesScanned": 600,
"recordsIngested": 1,
"queryResultRows": 1
},
"queryInsightsResponse": {
"querySpatialCoverage": {
"max": {
"value": 1.0,
"tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable",
"partitionKey": [
"measure_name"
]
}
},
"queryTemporalRange": {
"max": {
"value": 2399999999999,
"tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable"
}
},
"queryTableCount": 1,
"outputRows": 1,
"outputBytes": 59
}
}
}
```
### Message de notification de requête planifiée pour le mode DISABLED
L'exemple suivant montre un message de notification de requête planifiée réussie pour le `DISABLED` mode du `QueryInsights` paramètre.
```
"SuccessNotificationMessage": {
"type": "MANUAL_TRIGGER_SUCCESS",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1723711401,
"triggerTimeMillis": 1723711402144,
"runStatus": "MANUAL_TRIGGER_SUCCESS",
"executionStats": {
"executionTimeInMillis": 17992,
"dataWrites": 1024,
"bytesMetered": 0,
"cumulativeBytesScanned": 600,
"recordsIngested": 1,
"queryResultRows": 1
}
}
}
```
### Message de notification d'échec pour le mode ENABLED\$1WITH\$1RATE\$1CONTROL
L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `ENABLED_WITH_RATE_CONTROL` mode du `QueryInsights` paramètre.
```
"FailureNotificationMessage": {
"type": "MANUAL_TRIGGER_FAILURE",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1727915513,
"triggerTimeMillis": 1727915513894,
"runStatus": "MANUAL_TRIGGER_FAILURE",
"executionStats": {
"executionTimeInMillis": 10777,
"dataWrites": 0,
"bytesMetered": 0,
"cumulativeBytesScanned": 0,
"recordsIngested": 0,
"queryResultRows": 4
},
"errorReportLocation": {
"s3ReportLocation": {
"bucketName": "amzn-s3-demo-bucket",
"objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae"
}
},
"failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
}
}
```
### Message de notification d'échec pour le mode DISABLED
L'exemple suivant montre un message de notification de requête planifiée ayant échoué pour le `DISABLED` mode du `QueryInsights` paramètre.
```
"FailureNotificationMessage": {
"type": "MANUAL_TRIGGER_FAILURE",
"arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d",
"scheduledQueryRunSummary": {
"invocationEpochSecond": 1727915194,
"triggerTimeMillis": 1727915195119,
"runStatus": "MANUAL_TRIGGER_FAILURE",
"executionStats": {
"executionTimeInMillis": 10777,
"dataWrites": 0,
"bytesMetered": 0,
"cumulativeBytesScanned": 0,
"recordsIngested": 0,
"queryResultRows": 4
},
"errorReportLocation": {
"s3ReportLocation": {
"bucketName": "amzn-s3-demo-bucket",
"objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98"
}
},
"failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details"
}
}
```
## 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/ExecuteScheduledQuery)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery)