ExecuteScheduledQuery - Amazon Timestream
Sintassi della richiestaParametri della richiestaElementi di rispostaErroriEsempiVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ExecuteScheduledQuery

È possibile utilizzarlo API per eseguire manualmente una query pianificata.

Se abilitatoQueryInsights, restituisce API anche informazioni e metriche relative alla query che hai eseguito come parte di una SNS notifica Amazon. QueryInsightsaiuta a ottimizzare le prestazioni della tua query. Per ulteriori informazioni suQueryInsights, consulta Usare le informazioni sulle query per ottimizzare le query in Amazon Timestream.

Sintassi della richiesta

{
   "ClientToken": "string",
   "InvocationTime": number,
   "QueryInsights": { 
      "Mode": "string"
   },
   "ScheduledQueryArn": "string"
}

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati nel formato. JSON

ClientToken

Non utilizzato.

Tipo: stringa

Vincoli di lunghezza: lunghezza minima di 32. La lunghezza massima è 128 caratteri.

Campo obbligatorio: no

InvocationTime

Il timestamp in. UTC La query verrà eseguita come se fosse stata richiamata in questo timestamp.

Tipo: Timestamp

Campo obbligatorio: sì

QueryInsights

Incapsula le impostazioni per l'attivazione. QueryInsights

Attivazione di approfondimenti e metriche sui QueryInsights resi come parte della SNS notifica Amazon per la query che hai eseguito. Puoi utilizzarla QueryInsights per ottimizzare le prestazioni e i costi delle query.

Tipo: oggetto ScheduledQueryInsights

Campo obbligatorio: no

ScheduledQueryArn

ARNdella query pianificata.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

Campo obbligatorio: sì

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200 con un HTTP corpo vuoto.

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

Non sei autorizzato a eseguire questa azione.

HTTPCodice di stato: 400

InternalServerException

Il servizio non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.

HTTPCodice di stato: 400

InvalidEndpointException

L'endpoint richiesto non era valido.

HTTPCodice di stato: 400

ResourceNotFoundException

Impossibile trovare la risorsa richiesta.

HTTPCodice di stato: 400

ThrottlingException

La richiesta è stata negata a causa del throttling della richiesta.

HTTPCodice di stato: 400

ValidationException

Richiesta non valida o non valida.

HTTPCodice di stato: 400

Esempi

Messaggio di notifica di interrogazione pianificata per la CONTROL modalità ENABLED WITH _ RATE _ _

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata riuscita per la ENABLED_WITH_RATE_CONTROL modalità del QueryInsights parametro.

"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>: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:<Region>:<Account>:database/BaseDb/table/BaseTable",
                    "partitionKey": [
                        "measure_name"
                    ]
                }
            },
            "queryTemporalRange": {
                "max": {
                    "value": 2399999999999,
                    "tableArn": "arn:aws:timestream:<Region>:<Account>:database/BaseDb/table/BaseTable"
                }
            },
            "queryTableCount": 1,
            "outputRows": 1,
            "outputBytes": 59
        }
    }
}

Messaggio di notifica delle interrogazioni pianificate per la DISABLED modalità

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata riuscita per la DISABLED modalità del QueryInsights parametro.

"SuccessNotificationMessage": {
    "type": "MANUAL_TRIGGER_SUCCESS",
    "arn": "arn:aws:timestream:<Region>:<Account>: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
        }
    }
}

Messaggio di notifica di errore per la CONTROL modalità ENABLED WITH _ RATE _ _

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata non riuscita per la ENABLED_WITH_RATE_CONTROL modalità del QueryInsights parametro.

"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>: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": "my-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"
    }
}

Messaggio di notifica di errore per la DISABLED modalità

L'esempio seguente mostra un messaggio di notifica di interrogazione pianificata non riuscita per la DISABLED modalità del QueryInsights parametro.

"FailureNotificationMessage": {
    "type": "MANUAL_TRIGGER_FAILURE",
    "arn": "arn:aws:timestream:<Region>:<Account>: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": "my-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"
    }
}

Vedi anche

Per ulteriori informazioni sull'utilizzo di questo API codice in una delle lingue specifiche AWS SDKs, consultate quanto segue: