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

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

若要使用大量資產或資產模型，請使用大量操作來大量匯入和匯出資源到不同的位置。例如，您可以建立資料檔案來定義 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 內容。  


**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 與已存在的資產或資產模型相符時，它會取代現有的資源。
+ **子資源建立、取代或刪除：**當您的匯入取代資產或資產模型等頂層資源時，新定義會取代所有子資源，例如屬性、階層或複合模型。

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