ExecuteScheduledQuery - Amazon Timestream
AnforderungssyntaxAnforderungsparameterAntwortelementeFehlerBeispieleWeitere 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.

ExecuteScheduledQuery

Sie können dies verwendenAPI, um eine geplante Abfrage manuell auszuführen.

Wenn Sie diese Option aktiviert habenQueryInsights, werden API auch Einblicke und Metriken zu der Abfrage zurückgegeben, die Sie als Teil einer SNS Amazon-Benachrichtigung ausgeführt haben. QueryInsightshilft bei der Leistungsoptimierung Ihrer Abfrage. Weitere Informationen QueryInsights dazu finden Sie unter Verwenden von Abfrageerkenntnissen zur Optimierung von Abfragen in Amazon Timestream.

Anforderungssyntax

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

Anforderungsparameter

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

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

ClientToken

Nicht verwendet

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 32. Maximale Länge beträgt 128 Zeichen.

Erforderlich: Nein

InvocationTime

Der Zeitstempel inUTC. Die Abfrage wird so ausgeführt, als ob sie zu diesem Zeitstempel aufgerufen worden wäre.

Typ: Zeitstempel

Erforderlich: Ja

QueryInsights

Kapselt Einstellungen für die Aktivierung. QueryInsights

Wenn Sie Einblicke und Kennzahlen zu QueryInsights Rücksendungen als Teil der SNS Amazon-Benachrichtigung für die von Ihnen ausgeführte Abfrage aktivieren. Sie können QueryInsights es verwenden, um die Leistung und die Kosten Ihrer Abfrage zu optimieren.

Typ: ScheduledQueryInsights Objekt

Erforderlich: Nein

ScheduledQueryArn

ARNder geplanten Abfrage.

Typ: Zeichenfolge

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

Erforderlich: Ja

Antwortelemente

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

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

ResourceNotFoundException

Die angeforderte Ressource wurde nicht gefunden.

HTTPStatuscode: 400

ThrottlingException

Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.

HTTPStatuscode: 400

ValidationException

Ungültige oder falsch formatierte Anfrage.

HTTPStatuscode: 400

Beispiele

Geplante Abfragebenachrichtigung für den CONTROL Modus ENABLED WITH _ RATE _ _

Das folgende Beispiel zeigt eine erfolgreiche Benachrichtigung über eine geplante Abfrage für den ENABLED_WITH_RATE_CONTROL Modus des QueryInsights Parameters.

"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
        }
    }
}

Benachrichtigung über eine geplante Abfrage für den DISABLED Modus

Das folgende Beispiel zeigt eine erfolgreiche Benachrichtigung über eine geplante Abfrage für den DISABLED Modus des QueryInsights Parameters.

"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
        }
    }
}

Fehlerbenachrichtigung für den CONTROL Modus ENABLED WITH _ RATE _ _

Das folgende Beispiel zeigt eine Benachrichtigung über eine fehlgeschlagene geplante Abfrage für den ENABLED_WITH_RATE_CONTROL Modus des QueryInsights Parameters.

"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"
    }
}

Meldung zur Benachrichtigung über einen Fehler für den DISABLED Modus

Das folgende Beispiel zeigt eine Benachrichtigung über eine fehlgeschlagene geplante Abfrage für den DISABLED Modus des QueryInsights Parameters.

"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"
    }
}

Weitere Informationen finden Sie unter:

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