View a markdown version of this page

建立資料分割區 - AWS IoT FleetWise

AWS IoT FleetWise 不再向新客戶開放。現有的 AWS IoT FleetWise 客戶可以繼續使用 服務。上的連線行動性指南 AWS提供如何為連線行動解決方案開發和部署模組化服務的指引，這些解決方案可用於實現與 AWS IoT FleetWise 同等的功能。

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

建立資料分割區

重要

對特定 AWS IoT FleetWise 功能的存取目前受到鎖定。如需詳細資訊，請參閱AWS AWS IoT FleetWise 中的區域和功能可用性。

行銷活動中的資料分割區會暫時存放訊號資料。您可以設定將資料轉送至雲端的時間和方式。

資料分割區的運作方式是先dataPartitionId為行銷活動使用 來指定特定資料集。然後，您可以進一步定義分割區儲存選項，例如大小上限、保持資料分割區即時的最短時間 （在磁碟上），以及在 Edge 上存放資料的位置。您可以使用 來判斷車輛上的儲存位置storageLocation。儲存位置會決定行銷活動儲存資料夾下資料分割區的資料夾名稱。行銷活動儲存資料夾位於 Edge 組態檔案中定義的持久性路徑下，名為 車輛名稱的資料夾下。這是儲存位置的絕對路徑：{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}。

多工緩衝處理模式設定為TO_DISK指定分割的資料應儲存至車輛的磁碟。資料分割區的資料儲存體會以 FIFO （先進先出） 為基礎運作。如果您刪除行銷活動，也會刪除相關聯資料分割區中的資料。如果您未指定連線開/關使用案例的資料分割區， AWS IoT FleetWise 仍會在沒有連線時將資料存放在車輛的環形緩衝區中。當連線恢復時， AWS IoT FleetWise 會將資料上傳至雲端。此行為可在 Edge Agent for AWS IoT FleetWise 軟體中設定。

重要

如果您的資料分割區超過設定的最大儲存限制，則較新的資料會在分割區達到大小上限時覆寫較舊的資料。Edge 上遺失的資料無法復原。儲存大小取決於您的 Edge 儲存限制。

當資料上傳到雲端時，可以在最短存留時間過後移除。將最短時間設定為適當運作，以避免意外刪除。

上傳選項會決定變數表達式和條件語言。如果指定了上傳選項，您還必須指定儲存選項。您也可以請求將資料分割區中的訊號上傳到雲端。如需詳細資訊，請參閱上傳行銷活動資料。

定義資料分割區條件之後， signalsToCollect有助於指定要在資料分割區中考慮的訊號。您可以為資料分割區指定 IDs，或將 dataPartitionId default 設定為使用建立的預設資料分割區。沒有指定 的訊號dataPartitionId將與預設 相關聯dataPartition。

建立資料分割區

使用下列範例，建立具有資料分割區儲存條件的行銷活動。此範例行銷活動設定為將車輛資料存放在 Amazon Timestream 中。

  1. 將 campaign-name 取代為您建立的行銷活動名稱。

  2. （選用） 提供描述。

  3. 將 role-arn 取代為任務執行角色的 Amazon Resource Name (ARN)，授予 AWS IoT FleetWise 將資料交付至 Timestream 資料表的許可。

  4. 將 table-arn 取代為 Timestream 資料表的 ARN。

  5. 將 signal-catalog-arn 取代為訊號目錄的 ARN。

  6. 將 dataPartitions ID 和 的 data-partition-id 都取代為要與 建立關聯的 IDsignalsToCollect。首先，取代要在訊號中使用的資料分割區 ID。對於 signalsToCollect，ID 必須符合 中提供的其中一個 IDsdataPartitions。

    注意

    使用 default做為 ID，為行銷活動建立預設資料分割區。

  7. 將 target-arn 取代為您建立的機群或車輛的 ARN。

{
    "name": "campaign-name",
    "description": "Measurement of SOC, SOH, thermal, and power optimization for Fleet 2704",
    "targetArn": "target-arn",
    "collectionScheme": {
        "conditionBasedCollectionScheme": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.BMS` > 50",
            "minimumTriggerIntervalMs": 1000,
            "triggerMode": "ALWAYS"
        }
    },
    "compression": "SNAPPY",
    "dataDestinationConfigs": [{
        "timestreamConfig": {
            "executionRoleArn": "role-arn",
            "timestreamTableArn": "table-arn"
        }
    }],
    "dataPartitions": [{
        "id": "data-partition-id",
        "storageOptions": {
            "maximumSize": {
                "unit": "GB",
                "value": 1024
            },
            "minimumTimeToLive": {
                "unit": "WEEKS",
                "value": 6
            },
            "storageLocation": "string"
        },
        "uploadOptions": {
            "conditionLanguageVersion": 1,
            "expression": "$variable.`Vehicle.BMS.PowerOptimization` > 90"
        }
    }],
    "signalCatalogArn": "signal-catalog-arn",
    "signalsToCollect": [{
        "dataPartitionId": "data-partition-id",
        "maxSampleCount": 50000,
        "minimumSamplingIntervalMs": 100,
        "name": "Below-90-percent"
    }],
    "spoolingMode": "TO_DISK",
    "tags": [{
        "Key": "BMS",
        "Value": "Under-90"
    }]
}

符合所有指定條件後，分割的資料會轉送至雲端，以便收集和儲存新的分割訊號。

接下來，您將呼叫 UpdateCampaign API，將其部署到 Edge Agent for AWS IoT FleetWise 軟體。如需詳細資訊，請參閱上傳行銷活動資料。