使用資產和模型進行批量操作 - AWS IoT SiteWise
關鍵概念和術語受支援的功能

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

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

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

注意

AWS IoT SiteWise 透過呼叫中的作業，可以在中執行大量作業 AWS IoT TwinMaker API。您可以在不設定 AWS IoT TwinMaker 或建立工作區的情況下執行此操 AWS IoT TwinMaker 作。您只需要一個 Amazon S3 儲存貯體，您就可以在其中放置 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 與已存在的資產或資產模型相符時，該資產或資產模型將會取代現有資源。

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

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

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