終止支援通知：在 2025 年 12 月 15 日， AWS 將終止對 的支援 AWS IoT Analytics。2025 年 12 月 15 日之後，您將無法再存取 AWS IoT Analytics 主控台或 AWS IoT Analytics 資源。如需詳細資訊，請參閱AWS IoT Analytics 終止支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

透過 Amazon CloudWatch Events 取得延遲資料通知

當您使用來自指定時間範圍的資料建立資料集內容時，某些資料可能無法及時送達進行處理。若要允許延遲，您可以在建立資料集QueryFilter時套用 queryAction(SQL 查詢） 來指定 的deltaTime位移。 AWS IoT Analytics 仍會處理在差異時間內抵達的資料，而且您的資料集內容會有時間延遲。延遲資料通知功能可讓 在資料於差異時間後送達時，透過 Amazon CloudWatch Events AWS IoT Analytics 傳送通知。

您可以使用 AWS IoT Analytics 主控台、API、AWS Command Line Interface (AWS CLI) 或 AWS SDK 來指定資料集的延遲資料規則。

在 AWS IoT Analytics API 中， LateDataRuleConfiguration 物件代表資料集的延遲資料規則設定。此物件是與 CreateDataset和 UpdateDataset API 操作相關聯的Dataset物件的一部分。

參數

當您使用 建立資料集的延遲資料規則時 AWS IoT Analytics，您必須指定下列資訊：

設定延遲資料規則 （主控台）

下列程序說明如何在 AWS IoT Analytics 主控台中設定資料集的延遲資料規則。

設定延遲資料規則 (CLI)

在 AWS IoT Analytics API 中， LateDataRuleConfiguration 物件代表資料集的延遲資料規則設定。此物件是與 CreateDataset和 相關聯的Dataset物件的一部分UpdateDataset。您可以使用 APIAWS CLI、 或 AWS SDK 來指定資料集的延遲資料規則。下列為使用 AWS CLI的範例。

若要使用指定的延遲資料規則建立資料集，請執行下列命令。命令假設dataset.json檔案位於目前的目錄中。

aws iotanalytics create-dataset --cli-input-json file://dataset.json

dataset.json 檔案應包含下列項目：

{
    "datasetName": "demo_dataset",
    "actions": [
        {
            "actionName": "myDatasetAction",
            "queryAction": {
                "filters": [
                    {
                        "deltaTime": {
                            "offsetSeconds": -180,
                            "timeExpression": "from_unixtime(time)"
                        }
                    }
                ],
                "sqlQuery": "SELECT * FROM demo_datastore"
            }
        }
    ],
    "retentionPeriod": {
        "unlimited": false,
        "numberOfDays": 90
    },
    "lateDataRules": [
        {
            "ruleConfiguration": {
                "deltaTimeSessionWindowConfiguration": {
                    "timeoutInMinutes": timeout
                }
            },
            "ruleName": "demo_rule"
        }
    ]
}

訂閱以接收延遲資料通知

您可以在 CloudWatch Events 中建立規則，以定義如何處理從 傳送的延遲資料通知 AWS IoT Analytics。當 CloudWatch Events 收到通知時，它會叫用規則中定義的指定目標動作。

建立 CloudWatch Events 規則的先決條件

為 建立 CloudWatch Events 規則之前 AWS IoT Analytics，您應該執行下列動作：

如需詳細資訊，請參閱《Amazon CloudWatch Events 使用者指南》中的什麼是 CloudWatch Events？和 Amazon CloudWatch Events 入門。 Amazon CloudWatch

延遲資料通知事件

延遲資料通知的事件使用以下格式。

{
	"version": "0",
	"id": "7f51dfa7-ffef-97a5-c625-abddbac5eadd",
	"detail-type": "IoT Analytics Dataset Lifecycle Notification",
	"source": "aws.iotanalytics",
	"account": "123456789012",
	"time": "2020-05-14T02:38:46Z",
	"region": "us-east-2",
	"resources": ["arn:aws:iotanalytics:us-east-2:123456789012:dataset/demo_dataset"],
	"detail": {
		"event-detail-version": "1.0",
		"dataset-name": "demo_dataset",
		"late-data-rule-name": "demo_rule",
		"version-ids": ["78244852-8737-4650-aa4d-3071a01338fa"],
		"message": null
	}
}

建立 CloudWatch Events 規則以接收延遲資料通知

下列程序說明如何建立將 AWS IoT Analytics 延遲資料通知傳送至 Amazon SQS 佇列的規則。