

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

# 使用資產和模型進行大量操作
<a name="bulk-operations-assets-and-models"></a>

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

**注意**  
您可以透過在 AWS IoT TwinMakerAPI 中AWS IoT SiteWise呼叫 操作，在 中執行大量操作。您可以這樣做，而無需設定AWS IoT TwinMaker或建立AWS IoT TwinMaker工作區。您只需要一個 Amazon S3 儲存貯體，您可以在其中放置AWS IoT SiteWise內容。  


**Topics**
+ [重要概念和術語](#bulk-operations-terminology)
+ [受支援的功能](#bulk-operations-functionality)
+ [大量操作先決條件](bulk-operations-prereqs.md)
+ [執行大量匯入任務](running-bulk-operations-import.md)
+ [執行大量匯出任務](running-bulk-operations-export.md)
+ [任務進度追蹤和錯誤處理](jobs-progress-error-handling.md)
+ [匯入中繼資料範例](bulk-operations-import-metadata-example.md)
+ [匯出中繼資料範例](bulk-operations-export-filter-examples.md)
+ [AWS IoT SiteWise中繼資料傳輸任務結構描述](bulk-operations-schema.md)

## 重要概念和術語
<a name="bulk-operations-terminology"></a>

AWS IoT SiteWise大量匯入和匯出功能依賴下列概念和術語：
+ **匯入**：將資產或資產模型從 Amazon S3 儲存貯體中的檔案移至 的動作AWS IoT SiteWise。
+ **匯出**：將資產或資產模型從 移至 Amazon S3 儲存貯AWS IoT SiteWise體的動作。
+ **來源**：您要從中移動內容的起始位置。

  例如，Amazon S3 儲存貯體是匯入來源，AWS IoT SiteWise也是匯出來源。
+ **目的地**：您要將內容移至其中的所需位置。

  例如，Amazon S3 儲存貯體是匯出目的地，而 AWS IoT SiteWise是匯入目的地。
+ **AWS IoT SiteWise結構描述**：此結構描述用於從中匯入和匯出中繼資料AWS IoT SiteWise。
+ **最上層資源：**您可以個別建立或更新AWS IoT SiteWise的資源，例如資產或資產模型。
+ **子資源：**頂層AWS IoT SiteWise資源中的巢狀資源。範例包括屬性、階層和複合模型。
+ **中繼資料**：成功匯入或匯出資源所需的金鑰資訊。中繼資料的範例是資產和資產模型的定義。
+ **metadataTransferJob**：執行 時建立的物件`CreateMetadataTransferJob`。

## 受支援的功能
<a name="bulk-operations-functionality"></a>

本主題說明執行大量操作時可以執行的操作。大量操作支援下列功能：
+ **最上層資源建立：**當您匯入的資產或資產模型未定義 ID，或其 ID 與現有資源的 ID 不相符時，將會建立新的資源。
+ **最上層資源取代：**當您匯入 ID 與已存在的資產或資產模型相符時，它會取代現有的資源。
+ **子資源建立、取代或刪除：**當您的匯入取代資產或資產模型等頂層資源時，新定義會取代所有子資源，例如屬性、階層或複合模型。

  例如，如果您在大量匯入期間更新資產模型，且更新版本定義了原始屬性上不存在的屬性，則會建立新的屬性。如果定義已存在的屬性，則會更新現有的屬性。如果更新的資產模型省略存在於原始的 屬性，則會刪除 屬性。
+ **不刪除頂層資源：**大量操作不會刪除資產或資產模型。大量操作只會建立或更新它們。