使用資產和模型進行批量操作

若要處理大量資產或資產模型，請使用大量作業將資源大量匯入和匯出至其他位置。例如，您可以在 Amazon S3 儲存貯體中建立定義資產或資產模型的資料檔案，並使用大量匯入在中建立或更新資產模型 AWS IoT SiteWise。或者，如果您在中有大量資產或資產模型 AWS IoT SiteWise，則可以將它們匯出到 Amazon S3。

注意

您可以在中呼叫 AWS IoT TwinMaker API 中 AWS IoT SiteWise 的作業來執行大量作業。您可以在不設定 AWS IoT TwinMaker 或建立工作區的情況下執行此操 AWS IoT TwinMaker 作。您只需要一個 Amazon S3 儲存貯體，您就可以在其中放置 AWS IoT SiteWise 內容。

主題

• 關鍵概念和術語
• 受支援的功能
• 大量作業先決條
• 執行大量匯入工作
• 執行大量匯出工作
• 工作進度追蹤和錯誤處理
• 匯入中繼資料範
• 匯出元資料範例
• AWS IoT SiteWise 詮釋資料傳送工作綱

關鍵概念和術語

AWS IoT SiteWise 大量匯入和匯出功能依賴下列概念和術語：

• 匯入：將資產或資產模型從 Amazon S3 儲存貯體中的檔案移至 AWS IoT SiteWise.

• 匯出：將資產或資產模型從 Amazon S3 儲存貯體移 AWS IoT SiteWise 至 Amazon S3 儲存貯體的動作。

• 來源：您要移動內容的起始位置。

  例如，Amazon S3 儲存貯體是匯入來源，而且 AWS IoT SiteWise 是匯出來源。

• 目的地：您要將內容移至的所需位置。

  例如，Amazon S3 儲存貯體是匯出目的地， AWS IoT SiteWise 是匯入目的地。

• AWS IoT SiteWise 綱要：此綱要用於從中匯入和匯出中繼資料 AWS IoT SiteWise。

• 最上層資源：您可以個別建立或更新的 AWS IoT SiteWise 資源，例如資產或資產模型。

• 子資源：頂級 AWS IoT SiteWise 資源中的嵌套資源。範例包括性質、階層和複合模型。

• 中繼資料：成功匯入或匯出資源所需的關鍵資訊。中繼資料的範例是資產和資產模型的定義。

• metadataTransferJob：執行時建立的物件CreateMetadataTransferJob。

受支援的功能

本主題說明執行大量作業時可執行的動作。批次處理作業支援下列功能：

• 頂層資源建立：當您匯入未定義 ID 的資產或資產模型時，或其 ID 與現有 ID 不符合的資產或資產模型時，會將其建立為新資源。

• 頂層資源取代：當您匯入 ID 與已存在的資產或資產模型相符時，該資產或資產模型將會取代現有資源。

• 建立、取代或刪除子資源：當您匯入取代頂層資源 (例如資產或資產模型) 時，新定義會取代所有子資源，例如屬性、階層或複合模型。

  例如，如果您在大量匯入期間更新資產模型，而更新的版本定義了原始屬性上不存在的屬性，則會建立新屬性。如果它定義了一個已經存在的屬性，那麼現有的屬性將被更新。如果更新的資產模型忽略原始資產模型上存在的性質，則會刪除該性質。

• 不刪除頂層資源：批次作業不會刪除資產或資產模型。批次處理作業只會建立或更新它們。