ExecuteScheduledQuery - Amazon Timestream
Sintaksis PermintaanParameter PermintaanElemen ResponsKesalahanContohLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

ExecuteScheduledQuery

Anda dapat menggunakan ini API untuk menjalankan kueri terjadwal secara manual.

Jika Anda mengaktifkanQueryInsights, ini API juga menampilkan wawasan dan metrik yang terkait dengan kueri yang Anda jalankan sebagai bagian dari notifikasi AmazonSNS. QueryInsightsmembantu penyetelan kinerja kueri Anda. Untuk informasi selengkapnyaQueryInsights, lihat Menggunakan wawasan kueri untuk mengoptimalkan kueri di Amazon Timestream.

Sintaksis Permintaan

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

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam JSON format.

ClientToken

Tidak digunakan.

Tipe: String

Kendala Panjang: Panjang minimum 32. Panjang maksimum 128.

Wajib: Tidak

InvocationTime

Stempel waktu masuk. UTC Kueri akan dijalankan seolah-olah dipanggil pada stempel waktu ini.

Tipe: Timestamp

Wajib: Ya

QueryInsights

Merangkum pengaturan untuk mengaktifkan. QueryInsights

Mengaktifkan QueryInsights mengembalikan wawasan dan metrik sebagai bagian dari SNS notifikasi Amazon untuk kueri yang Anda jalankan. Anda dapat menggunakan QueryInsights untuk menyetel kinerja dan biaya kueri Anda.

Tipe: Objek ScheduledQueryInsights

Wajib: Tidak

ScheduledQueryArn

ARNdari query yang dijadwalkan.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.

Wajib: Ya

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan HTTP tubuh kosong.

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AccessDeniedException

Anda tidak berwenang untuk melakukan tindakan ini.

HTTPKode Status: 400

InternalServerException

Layanan tidak dapat sepenuhnya memproses permintaan ini karena kesalahan server internal.

HTTPKode Status: 400

InvalidEndpointException

Endpoint yang diminta tidak valid.

HTTPKode Status: 400

ResourceNotFoundException

Sumber daya yang diminta tidak dapat ditemukan.

HTTPKode Status: 400

ThrottlingException

Permintaan ditolak karena throttling permintaan.

HTTPKode Status: 400

ValidationException

Permintaan tidak valid atau cacat.

HTTPKode Status: 400

Contoh

Pesan pemberitahuan kueri terjadwal untuk CONTROL mode ENABLED WITH _ RATE _ _

Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk ENABLED_WITH_RATE_CONTROL mode QueryInsights parameter.

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

Pesan pemberitahuan kueri terjadwal untuk DISABLED mode

Contoh berikut menunjukkan pesan notifikasi kueri terjadwal yang berhasil untuk DISABLED mode QueryInsights parameter.

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

Pesan pemberitahuan kegagalan untuk CONTROL mode ENABLED WITH _ RATE _ _

Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk ENABLED_WITH_RATE_CONTROL mode QueryInsights parameter.

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

Pesan pemberitahuan kegagalan untuk DISABLED mode

Contoh berikut menunjukkan pesan pemberitahuan kueri terjadwal gagal untuk DISABLED mode QueryInsights parameter.

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

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: